Skip to content

Add durable audit record writer and reader for Guided Setup (#184 slice 1) - #266

Merged
Jumpstile merged 1 commit into
mainfrom
feat/guided-setup-audit-record
Nov 17, 2026
Merged

Jumpstile merged 1 commit into
mainfrom
feat/guided-setup-audit-record

Conversation

@Jumpstile

Copy link
Copy Markdown
Owner

Part of #184 (slice 1 of 3, Milestone 1). Design: contract first, no behavior change yet.

  • New record guided-setup/audit/v1 (schema + writer + reader + verify) under state\guided-setup-audit, one file per accepted generation named by its manifest hash. Hashes only; no raw source data, URLs, labels, tokens or private paths.
  • Writer never replaces an existing record. Reader reports AUDIT_OK / AUDIT_MISSING / AUDIT_INVALID / AUDIT_MISMATCH and never repairs or touches accepted state.
  • Shared atomic writer: opt-in -NoReplace switch (6 lines); all existing callers unchanged.
  • Frozen contracts and accepted-state code untouched. Not wired into acceptance yet (slice 2), docs in slice 3.
  • Tests: 7 new plus existing source enrollment, web server and schema tests; all passed, 0 failed (pwsh). Not tested: full suite, Windows PowerShell 5.1, other code that scans state\ (one repo-wide scan search found only the generation folder file list).

🤖 Generated with Claude Code

https://claude.ai/code/session_01NzHAcjThVoUGWWfXrYWsNh

#184 slice 1)

New record guided-setup/audit/v1 under state\guided-setup-audit\, one per accepted generation, keyed by the result generation manifest hash. Hashes only: no source text, URLs, labels, tokens or private paths. The writer never replaces an existing record. The reader verifies the record and reports AUDIT_OK, AUDIT_MISSING, AUDIT_INVALID or AUDIT_MISMATCH without repairing or changing accepted state. The shared atomic writer gets an opt-in -NoReplace switch; existing callers are unchanged. No caller is wired yet (slice 2).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NzHAcjThVoUGWWfXrYWsNh
@Jumpstile
Jumpstile merged commit f503323 into main Nov 17, 2026
11 checks passed
@Jumpstile
Jumpstile deleted the feat/guided-setup-audit-record branch November 17, 2026 06:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant