Skip to content

Record missing audit events for 13 authorization lifecycle transitions #876

Open

Description

@samjulien

PR #872 removes a source-scanning audit ledger that recorded known gaps but did not prove events fired. This issue preserves its 13 debt entries, as requested in review. These are existing gaps, not new regressions from the test cleanup.

Source ledger: pending-authorization-audit-ledger.test.ts at c19d0653. Most transitions are in server/src/plugins/route-groups/connections.ts; store writes are in server/src/plugins/plugin-store.

Dusty confirmed all 13 gaps are still current. The three items marked Priority below should be addressed first: consent can remain live at the vendor with only a console line as the record.

Missing lifecycle audit coverage

  • Claim (claimAuthorizationAttempt, B5e): record who started which consent attempt.
  • Expiry overwrite/re-claim (same call, B5e): record the previous attempt's ending before ON CONFLICT replaces it.
  • Discard after vendor mint refusal (arcade-refused-attempt-not-cleared, B5e): record the refusal/ending, not only cleanup-failure logging.
  • Priority — Discard after successful mint cannot be recorded (arcade-mint-not-recorded, B5e): record that a consent flow may remain live at the vendor.
  • Mint recorded (recordAuthorizationMint, authId: minted.authorizationId, B5e): audit the attempt being bound to a vendor authorization without exposing its secret identifiers.
  • Vendor reports failed consent (failAuthorizationAttempt, settled.status === "failed", B5e): record the terminal verdict.
  • Completed consent has the wrong identity (failAuthorizationAttempt, settled.userId !== attempt.vendorUserId, B5e): record the attribution refusal.
  • Context changed and vendor withdrew retired grant (markAuthorizationWithdrawn, B5e): audit the attempt's verdict; account-disconnection rows alone do not describe it.
  • Priority — Person no longer permitted to act; grant not withdrawn (markAuthorizationUnreconciled, arcade-completion-not-permitted, B5e): record the closed attempt and potentially live vendor consent.
  • Priority — Context changed and withdrawal unconfirmed (markAuthorizationUnreconciled, B5e): record the unresolved grant rather than only a console line.
  • App/server removal cascade (pending_authorizations_server_id_mcp_servers_id_fk, B5e): identify affected in-flight attempts; configuration-change rows currently describe released grants only.
  • Actor removal cascade (pending_authorizations_actor_id_users_id_fk, B5e): identify attempts that die with the actor, including potentially live vendor consent.
  • Cancel loses race to completion (That authorization finished before it could be cancelled, B2c): audit the refused cancellation (409) even though no pending row is deleted.

Acceptance

Exercise each transition through behavior tests and assert the persisted audit event, actor, attempt correlation, and safe payload. Do not log bearer consent URLs or live authorization IDs. Keep the existing successful completion and cancellation events; avoid duplicate attempt-ending events when a cancelled attempt is encountered by a late mint/completion. The original ledger waived those two late-return branches because cancellation had already been audited.

Re-check each gap against current code when implementing; the list preserves the historical findings rather than claiming a new runtime reproduction of all 13.

Activity

  1. dustywusty commented on Oct 28, 2026

    @dustywusty
    Collaborator

    I checked this against the ledger at c19d0653. All 13 debt entries are here: 10 lifecycle transitions, 2 FK cascades and the B2c cancel race. The two waived late-return branches are left out, and the acceptance criteria explain why. Every ledger anchor still exists in connections.ts on current main, and no attempt-lifecycle audit events have been added since, so all 13 gaps are still current.

    One suggestion: mark three items as priority. In each, consent can stay live at the vendor with only a console line as the record:

    • Discard after successful mint cannot be recorded. The ledger called this "the strongest case for an event".
    • Person no longer permitted to act; grant not withdrawn.
    • Context changed and withdrawal unconfirmed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions