Show assessment snapshot provenance and clarify save actions

Merged
SI
1mo ago
+470-19

Records can reopen an assessment in web and MCP, but the web viewer hid the version references needed to compare the exact saved evidence. The existing viewer now has a read-only “Snapshot and source details” disclosure showing the returned snapshot, request, compiler, document/result/subject and source-version references, including superseded and missing-provenance states.

Guest “Keep song details” claims the existing preview request; “Save assessment snapshot” freezes the server-compiled summary using existing Context actions. An uncertain network/503 save can be retried with the same key; duplicate clicks are suppressed. Access failures clear previously displayed evidence and provenance. No new store or owner-check bypass.

Refs #2116, #2140. Hosted acceptance remains tracked by recoupable/mono#361.

Validation:

  • 52 app tests across 16 release/Context suites pass; TypeScript passes; repository lint has no errors (existing warnings only), changed-file lint is clean.
  • 20 existing API Context fixture tests pass at e4d9b690, including membership recheck/revocation and snapshot operations. Database and credential boundaries are fixtures.
  • Local synthetic browser preview verified save/reopen, keyboard disclosure and narrow layout with no horizontal overflow. No connected account or hosted endpoint was used by the preview.

Limits: Recoup database migration/function/grant inspection remains unavailable. The disposable SQL fixture server was unavailable. No hosted write, live cross-company/revocation test, manual deployment, credential rotation or merge was performed. The owning verification handoff is lib/releases/assessment-verification.md; repeat the existing Records snapshot comparison after an approved release.


Summary by cubic

Adds a read-only "Snapshot and source details" disclosure to the assessment viewer so users can compare the exact saved evidence. It shows snapshot ID, creation time, compiler/method, request IDs, and document/result/subject/source-version references from the returned snapshot, never the currently selected release. Older briefs without a manifest report missing provenance explicitly, and 401/403/404 responses clear previously displayed evidence.

Renames the guest save action to "Keep song details" to separate request claiming from "Save assessment snapshot", which freezes the server-compiled summary. An uncertain network/503 save can be retried with its original idempotency key; duplicate clicks are suppressed. Adds lib/releases/assessment-verification.md documenting the manual hosted acceptance steps that remain outstanding.

Validation

  • 52 app tests across 16 release/Context suites pass; TypeScript and repository lint pass with existing warnings only.
  • 20 existing API Context fixture tests pass, including membership recheck/revocation and snapshot operations; database and credential boundaries are fixtures.
  • Recoup database migration/function/grant inspection and hosted write, revocation, and cross-company tests remain outstanding.

Refs #2116, #2140. No new store or owner-check bypass.