A record from the Factory repository, docs/prevention-register-recording-draft.json, shown as committed except that its local paths appear as placeholders in angle brackets, such as <local evidence archive>, standing for files that are not published. Every hash, date and count is as recorded. The build review says what the Factory's receipts support.
{
"schema": "software-factory-prevention-register-draft/1",
"disposition": "implemented-awaiting-independent-review",
"packet": "W2-10-PREVENTION-RECORDING (roadmap FB-H7r; bet module M3, increment 2): durable results, owner exemptions and a visibility read",
"scope": "Write-once journal records of register results (keyed by asOf and the Products covered; the command carries the input's identity digest, never the result, so a retry after a catalogue change replays) and owner exemptions (keyed by Product, template and template digest) under derived IDs, in a caller-supplied CommandJournal: a repeat replays, other content under the same key is refused CONFLICT, stored records are re-checked on every read (CORRUPT, never repaired). Repository visibility read through branch health's GET-only gh reader (readVisibility, one GET of repos/<owner>/<name>), so the runner template can leave 'unknown: visibility unread'. No rollout, grant, live read, schedule, Portfolio mirror or package entry.",
"source": {
"base": "fd3528c",
"branch": "claude/w2-10-prevention-recording",
"note": "Hashes are of the working tree when this draft was written, before the commit that carries these bytes. docs/prevention-register-draft.json (increment 1) is left unchanged as history.",
"branchHealthChange": "src/branch-health-github.ts gains readVisibility, githubPaths.repository, VisibilityRead and RepositoryVisibility, and its path grammar now accepts the bare repos/<owner>/<name>. readProduct (the poll's read plan) is unchanged and never calls it. Branch health's acceptance receipts cover the module before this change; this addition needs its own independent review.",
"revision": "Review round 1: a result's command now carries the input's identity digest (checkRegisterInput) and at, not the evaluated result, so an identical retry after a catalogue change replays the result recorded then instead of CONFLICT; the input is evaluated only for a new record. Re-run after the fix: typecheck, the combined command, and prevention-register-records, prevention-register, observability-catalogue, module-graph, intelligence, docs-site, design-tokens, documentation, style-lint and journal one at a time; the other rows above are from the first draft. Review round 2: recordExemption now reads back the stored exemption on every call, fresh or replayed, and refuses CORRUPT when the record is missing, fails its checks, has moved past version 1, or does not hold the exemption and at its receipt names, as result recording already did; a replay with a damaged, removed or advanced record no longer reports success. Re-run after the fix: typecheck, and prevention-register-records (17 pass, including the new regression test, which fails against the round-1 source), prevention-register, docs-site, documentation, style-lint and journal one at a time."
},
"records": {
"protocol": "sf-prevention-register-record/1",
"aggregates": [
"prevention-register:result:<64 hex>",
"prevention-register:exemption:<64 hex>"
],
"commands": [
"prevention-register/result/<64 hex>",
"prevention-register/exemption/<64 hex>"
],
"events": [
"prevention-register.result-recorded",
"prevention-register.exemption-recorded"
]
},
"files": {
"docs/agents/branch-health.md": "ec577fae97c054bdfd43e66e1c45c6ef25425282922d4e3072b1c40c69bce904",
"docs/agents/observability.md": "248322187336e3262603df8d71eff7e9571960f571b7ab88955a16237f7aafcc",
"docs/agents/prevention-register.md": "86f9b66fdfc4b2618bf106d98f48582ed451ffccb625644cc4aafa620056c03e",
"docs/explanation/modules.md": "df4c3eccc0951dbc65b963d0a80680f66f04eef6c010030b4b98290811759be7",
"docs/guide/branch-health.md": "2fd77ecc2e26b97c0697561a1b30cbb783e14141b3bc4a188d0c4cadce29875c",
"docs/guide/prevention-register.md": "36a69c0140ada96347344c6fc7cfef19ce9e5471f0050f11d403fa398b511007",
"src/branch-health-contract.ts": "e0b45cca770cf066b09c3314291ad1e1354c32403427c312b1aac59341139e9b",
"src/branch-health-github.ts": "3c1c2c5ccd2b5271318d9e694273044a146058ea2bf23a466da5ebf2d49dc6b3",
"src/canonical-json.ts": "986f7f53e942101a3a689e000242f49c5d611e641beb2817312553db32edaec2",
"src/errors.ts": "22e6444f42c15b40b7e8167017f01fb1922156764e6711de4248c3b8401f2357",
"src/intelligence.ts": "715ca1a402880c55872e9e4168c8ab1c961f877304d2f33b42d1332a6a722444",
"src/journal.ts": "7aeee88c01eaa65fdf286a8723b769476f45fc6ceadac1d583ccbcfa4d0d5ff3",
"src/prevention-register-records.ts": "592d28d85ebd949b71d2f0913cd410181a9350ee789adcc210605fbfad896b76",
"src/prevention-register.ts": "ca84d75e1a3631ef631008814c3b42141aac2b2ba7d6736ccf7a7ca8c4cb1231",
"test/fixtures/prevention-register/derived.json": "fa0622b54fcfa125c9afe010cea690d45b8cf45a131cd9cb05745066be5ab049",
"test/fixtures/prevention-register/visibility.json": "7038f3cf63a157b6395eb474c5f1b7da2d6c9a2e42f0a5cc6449b42198f809c8",
"test/helpers/branch-health-recording.ts": "4171712f9b32a8d85d8aa0743657680e30683b77b85b3963d13c4fda4f1e9f8d",
"test/helpers/fake-gh.mjs": "bbff8ef2614c97b98261b524a2425388b9f271c8edf27a3b9a8d61ba84204375",
"test/module-graph.test.ts": "8aea9ef9b6f41eaa3241bbad18796409dccf3513cd7911c50dce78eaf4a735f6",
"test/prevention-register-records.test.ts": "6e356b263158803e70b9d69bcf34be1661eb009223ac2e6f36cbd04515fb281d"
},
"fixtures": {
"note": "test/fixtures/prevention-register/visibility.json is synthetic: the branch-health capture of 29 September 2026 holds no read of a repository itself. Pasta's public answer follows the recorded cause (roadmap row 23); Family Watch's private answer and JustSpeakToIt's refusal are invented to exercise not-applicable and unknown."
},
"focusedChecks": {
"note": "Focused files only, run one at a time on a shared host; the full npm run check and test/distribution.test.ts were not run, by instruction. Logs under <local evidence archive>",
"commands": {
"npm run typecheck": "exit 0",
"node --test test/prevention-register-records.test.ts test/prevention-register.test.ts test/module-graph.test.ts test/intelligence.test.ts test/docs-site.test.ts test/design-tokens.test.ts": "128 pass, 0 fail",
"node --test test/prevention-register-records.test.ts": "17 pass, 0 fail",
"node --test test/observability-catalogue.test.ts": "5 pass, 0 fail",
"node --test test/branch-health-github.test.ts": "8 pass, 0 fail",
"node --test test/branch-health.test.ts": "38 pass, 0 fail",
"node --test test/branch-health-adversarial.test.ts": "42 pass, 0 fail",
"node --test test/branch-health-replay.test.ts": "10 pass, 0 fail",
"node --test test/branch-health-core.test.ts": "8 pass, 0 fail",
"node --test test/branch-health-mirror-throw.test.ts": "3 pass, 0 fail",
"node --test test/documentation.test.ts": "4 pass, 0 fail",
"node --test test/style-lint.test.ts": "27 pass, 0 fail",
"node --test test/website.test.ts": "34 pass, 0 fail",
"node --test test/public-build.test.ts": "21 pass, 0 fail",
"node --test test/delivery-boundaries.test.ts": "10 pass, 0 fail",
"node --test test/journal.test.ts": "14 pass, 0 fail",
"node --test test/intelligence-adversarial.test.ts test/intelligence-lifecycle.test.ts test/intelligence-lifecycle-adversarial.test.ts test/intelligence-priority.test.ts": "39 pass, 0 fail (run one file at a time)"
}
},
"environment": {
"node": "v26.8.1",
"platform": "darwin",
"architecture": "arm64"
},
"notBuilt": [
"withdrawing an exemption; only a template edit stops one applying",
"a listing of every record (reads are by key) and any Portfolio or Dashboard mirror",
"a caller that composes live reads, visibility and recording; no poll, schedule or live read",
"rollouts of any template to any Product (FB-H7), which need each Product's grant",
"a package entry: tracked adoption gap while the distribution harness is rewritten separately"
],
"notEstablished": [
"any repository's real visibility: the visibility answers in the tests are synthetic",
"any Product's guardrail state today",
"protection against a forged record: the digest check finds a record changed without its digest, not one written with a fresh digest"
],
"coordinatorRows": [
"docs/agents/factory-model.md module-map row",
"docs/build-review.md row",
"site/ rebuild after those rows"
],
"review": []
}
