Skip to content

Add durable audit provenance for Guided Setup analysis and acceptance #184

Closed

Description

@Jumpstile

Follow-up to #175 and PR #182. Durable auditability was explicitly deferred from PR #182; this work must remain separate and must not widen that PR or change its immutable acceptance boundary. Define durable, verifiable records linking proposal analysis and source/binding lineage to explicit acceptance. Capture the proposal/candidate identity, source and binding revisions, scoped/ALL/unbound binding decisions, analysis/review outcome, explicit acknowledgement, and prior/result accepted-generation identities or hashes. Proposal analysis must remain read-only with respect to accepted state. Do not retain raw source payloads or secret-bearing/tokenized URLs. Acceptance criteria: a fresh disposable analysis with two playlists and three guides (News→News, Sports→Sports, one unbound) reports 2 exact matches, 0 review, 0 unmatched playlists, and 1 unbound guide without changing accepted state; explicit acknowledgement creates a correlated acceptance record; restart/recovery preserves record integrity; no unacknowledged analysis is represented as accepted.

Activity

  1. Jumpstile commented on Nov 17, 2026

    @Jumpstile
    OwnerAuthor

    Done and merged on main (Milestone 1). Four PRs: #266 (audit record writer, reader and schema guided-setup/audit/v1), #267 (acceptance writes the record after publish; response gains Audit = RECORDED or NOT_RECORDED; an audit failure never blocks or rolls back acceptance), #268 (single-source v1 acceptance test), #269 (developer guide section).

    What it does: one hashes-only record per accepted generation under state\guided-setup-audit, never replaced; reader reports AUDIT_OK, AUDIT_MISSING, AUDIT_INVALID or AUDIT_MISMATCH and never repairs or changes accepted state; analysis never writes records. Frozen contracts and accepted-state code untouched.

    Tested (pwsh 7, Pester): audit, web server, enrollment and schema tests all passed with 0 failures at each PR. Not tested: Windows PowerShell 5.1, GUI tests, the full suite outside CI. Hosted checks (quality-gates, secret-scan) passed on each PR before merge.

    https://claude.ai/code/session_01NzHAcjThVoUGWWfXrYWsNh

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

    Projects

    No projects

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions