[Story-736] ADR-068 invitation doctrine cleanup

Story 736 Epic 683🎯 Multi-Front OperationsFirm Operations41 files · +366/−675

PR #80 · pramaan-io/pramaan-docs · merged 2026-05-20

How it flows

sequenceDiagram
  autonumber
  participant adr as ADR
  participant canon as Canonical doc
  participant stale as Stale docs
  participant reg as Registry
  adr->>adr: ADR-068 drafted
  adr->>canon: doctrine propagates
  canon->>canon: invitation-and-signin rewritten
  stale->>stale: primer deleted (−364)
  stale->>stale: stale warnings added
  reg->>reg: row + JSON entry
  adr->>reg: Investigation v2 linked

After this PR, these don't happen:

no identity.invitations queries
no /invitations bridge calls
no invite-time firm_memberships('invited') rows
stale docs still trick readers

Pending invite = Clerk

Accepted membership = PRAMAAN

Audit = ops.audit_log only

Read ADR-068 first

Trust canonical doc, not primers

Files changed (41)

File	±
`docs/decisions/adrs/ADR-024-invitation-system.md`	+4 −2
`docs/decisions/adrs/ADR-068-invitation-lifecycle-clerk-owned.md` ★	+143
`docs/decisions/adrs/ADR-REGISTRY.md`	+1
`docs/decisions/adrs/adr-registry.json` ★	+16
`docs/diagrams/admin-flows/firm-creation.md`	+2
`docs/diagrams/admin-flows/invite-flow.md`	+2
`docs/diagrams/invitation-refactor/205-clerk-webhook-sync.md`	+2
`docs/diagrams/invitation-refactor/206-clerk-invitation-delegation.md`	+2
`docs/diagrams/invitation-refactor/admin-invite-cleanup.md`	+2
`docs/diagrams/invitation-refactor/app-invite-cleanup.md`	+2
`docs/diagrams/user-flows/firm-onboarding.md`	+2
`docs/investigations/2026-05-20-invitation-architecture-v2.md`	+2
`docs/investigations/2026-05-20-invitation-lifecycle.md`	+2
`docs/plans/sankalp-admin.md`	+2
`docs/primers/technical/authentication/guided-file-reading.md`	+2
`docs/primers/technical/authentication/index.md`	+1 −1
`docs/primers/technical/authentication/invitation-architecture.md`	+0 −364
`docs/primers/technical/authentication/user-authentication-and-creation-flow.md`	+3 −1
`docs/primers/technical/bridge-utilities/auth.md`	+2
`docs/primers/technical/bridge-utilities/roles.md`	+2
`docs/primers/technical/bridge-utilities/token.md`	+2
`docs/primers/technical/clerk-auth-patterns.md`	+2
`docs/primers/technical/clerk-in-pramaan.md`	+2
`docs/primers/technical/frontend-utilities/invite-flow.md`	+2
`docs/roadmap/schema-build.md`	+2
`docs/roadmap/slice-1-iam.md`	+2
`docs/sprints/sankalp/auth-identity.md`	+2
`docs/sprints/sankalp/firm-admin.md`	+2
`docs/sprints/sankalp/firm-team.md`	+2
`docs/sprints/sankalp/staff-admin.md`	+2
`docs/system/architecture.md`	+2
`docs/system/auth/SVP-REVIEW.md`	+2
`docs/system/auth/firm-creation.md`	+7 −7
`docs/system/auth/invitation-and-signin.md` ★	+126 −299
`docs/system/auth/member-lifecycle.md`	+3 −1
`docs/system/data-flow-map.md`	+2
`docs/system/data-model/principles.md`	+2
`docs/system/database-schema.md`	+2
`docs/system/multi-tenant-architecture.md`	+2
`docs/workflows/auth.md`	+2
`docs/workflows/firm-onboarding.md`	+2