naftiko: 1.0.0-alpha2
info:
  label: Clerk User Lifecycle Workflow
  description: 'End-to-end user lifecycle workflow composition: create user, send invitation, verify email/phone, manage sessions, deactivate. Composes Users, Invitations, Email Addresses, Phone Numbers, and Sessions capabilities.'
  tags:
  - Clerk
  - Workflow
  - User Management
  - Lifecycle
  created: '2026-05-22'
  modified: '2026-05-22'
binds:
- namespace: env
  keys:
    CLERK_SECRET_KEY: CLERK_SECRET_KEY
imports:
- ./clerk-backend-api-users.yaml
- ./clerk-backend-api-invitations.yaml
- ./clerk-backend-api-email-addresses.yaml
- ./clerk-backend-api-phone-numbers.yaml
- ./clerk-backend-api-sessions.yaml
capability:
  description: |
    Composes the canonical onboarding-to-offboarding flow for an end user in Clerk:
      1. createUser or createInvitation to bootstrap an identity.
      2. createEmailAddress + verifyEmailAddress to attach a verified primary email.
      3. createPhoneNumber + verifyPhoneNumber for SMS MFA.
      4. listSessions / revokeSession to manage active devices.
      5. updateUser → banUser → deleteUser to offboard.