Factory docs, home

A record from the Factory repository, docs/prevention-register-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": "W1-13-PREVENTION-REGISTER (roadmap FB-H7r; bet module M3, first increment)",
  "scope": "Pure, value-only evaluation of three frozen guardrail templates (dispatcher circuit breaker, self-hosted runner on a public repository, schedule disabled for inactivity) over caller-supplied per-Product reads and dated owner exemptions. No storage, journal, Portfolio mirror, reader, network, clock, grant, rollout or package entry.",
  "source": {
    "base": "d73b06e71f440a98844f13296fdc91d401ae741d",
    "branch": "claude/w1-13-prevention-register",
    "note": "Hashes are of the working tree at the time this draft was last refreshed (review round 3 fixes, after merging origin/main 85a5472), before that commit; the commit carries these bytes.",
    "reviewRound1": "Fixes from independent review round 1 on 7daeec3: a truncated workflow listing is unknown whatever it shows (findings kept); a dispatch line whose reading depends on quoting is dispatch-ambiguous (unknown), not skipped; an impossible exemption month or day is refused INVALID; the docs state the dispatcher scan's lexical scope.",
    "reviewRound2": "Fixes from independent review round 2 on 4f12ecb: the dispatcher scan's quoted reading also models the JavaScript template literal (an actions/github-script step) and ANSI-C $'...' quoting, so a # inside either makes a dispatch line dispatch-ambiguous (unknown) instead of not-applicable; the docs state which quoting is modelled and that a quote carried over from an earlier line can still hide a dispatch.",
    "reviewRound3": "Fixes from independent review round 3 on 28af1f6: the dispatcher scan reads an ordinary single quote twice, with the backslash literal (shell) and with backslash escapes (JavaScript or Python), and a dispatch line is dispatch-ambiguous (unknown) when either reading leaves a quote open or keeps the dispatch, so an escaped quote before a # no longer hides a dispatch as not-applicable; an ANSI-C $' is opened only by a $ no backslash escaped (an even run of backslashes no longer misreads it). The one changed assertion (echo \\$'a\\' # gh workflow run later) is now stricter: dispatch-ambiguous instead of not-dispatcher. The Intelligence declaration (none, no tasks) already meets the priority-list task shape of #64 and is unchanged."
  },
  "templates": [
    {
      "id": "dispatcher-circuit-breaker",
      "version": 1,
      "digest": "sha256:effb07f613f12e55a9205239136f5199fa9345a7bcd3b80f52d1e0a5fd4d14d2"
    },
    {
      "id": "self-hosted-runner-public-repository",
      "version": 1,
      "digest": "sha256:1991d50e639bbe807c1d5cf25ca322acd75f1c4d54369cac2d26efde0df8231f"
    },
    {
      "id": "schedule-disabled-for-inactivity",
      "version": 1,
      "digest": "sha256:5db889a8d243283a57f6fd3c63140b2e915de94039609959e98d63677b68da06"
    }
  ],
  "catalogueDigest": "sha256:b21a0c28008fcd3d7d0359132a81cc4871754107b6cf2c02bb4582486eb942d7",
  "files": {
    "README.md": "46886c1d2e9276dff7b245b8095c294dfe48ad09e231990450c3cc65db64b113",
    "docs/agents/intelligence.md": "5f4075bd785febaea4b020b97af10f45a5e4f19df1c8e361349dab7d14fa2849",
    "docs/agents/observability.md": "17b6e282cfafa8804b7bae2a4fb1f5f53d414407bbcacd0ef6ab9f70220f3139",
    "docs/agents/prevention-register.md": "b9387fd1476e5fca652e4a52ba3907af5ea257301596c285681ccf58eeeabb90",
    "docs/brand/plumb-family.json": "f77e320e45ba67c8bdef1ce6c24c27f841fe4c590797e7ce2b827aff55a25c86",
    "docs/brand/plumb-family.md": "60f6aa77eb66d2e20fee75995cc0a3d1ae60d3dfdf66aa7800d2693e38b24399",
    "docs/documentation-map.json": "0aa5536937792fb63c222464cfb9623e92a7abff3880aab8ef7c2306d03167e9",
    "docs/explanation/modules.md": "6ab1e92aeabc97d6101851b0d46e936d96710dc329c89ee7f63890fbccbe66f8",
    "docs/guide/prevention-register.md": "31289f330b52b42fb68669bc46115e01460a1de315cbb665a0bf9455cfbbd250",
    "src/branch-health-contract.ts": "e0b45cca770cf066b09c3314291ad1e1354c32403427c312b1aac59341139e9b",
    "src/canonical-json.ts": "986f7f53e942101a3a689e000242f49c5d611e641beb2817312553db32edaec2",
    "src/errors.ts": "22e6444f42c15b40b7e8167017f01fb1922156764e6711de4248c3b8401f2357",
    "src/intelligence.ts": "0960b0bfa029e8bbbb3b407576e7e47367d6f7e9b15c78178caffe656f3f180f",
    "src/prevention-register.ts": "87362fb6cbc15fa37b98106c36b6b2e3209f6bf42ed5b3c1f43a317a7dab55c7",
    "test/docs-site.test.ts": "30bd1941fb22bad0f6699361e85508628ef053eed9f836d2b0815183fd2cd845",
    "test/fixtures/prevention-register/derived.json": "fa0622b54fcfa125c9afe010cea690d45b8cf45a131cd9cb05745066be5ab049",
    "test/module-graph.test.ts": "24b9951789c1c698982385b71d0a194e67cea96d10f9388b34aa0d85a9f37814",
    "test/prevention-register.test.ts": "f67d72c63b242f8274d0e06cbccfa87fa143b81efb466714502676c9cba04d3b"
  },
  "derivedFromCapture": {
    "note": "Inputs are read unchanged from these branch-health capture files (their SHA-256 as replay.json records them); the one workflow text in test/fixtures/prevention-register/derived.json is a labelled synthetic stand-in, since the capture holds no workflow file.",
    "files": {
      "test/fixtures/branch-health/gh-runs/per-workflow/crmitchelmore_pasta__workflows.json": "46c1097ae25338f7cf27019b720b291bf4417b67a74e8c172c0a694ef7dd974d",
      "test/fixtures/branch-health/gh-runs/per-workflow/crmitchelmore_tally__workflows.json": "722edc36214c9369d58c0651fcb293c9be92c41c0b06953f814a74b8ed4c5535",
      "test/fixtures/branch-health/gh-runs/per-workflow/crmitchelmore_family-watch-activity-tracker__workflows.json": "20b8c881a677280ad7c8fbe16cbf6badd4811f00ece137922a22451316b6e053",
      "test/fixtures/branch-health/gh-runs/per-workflow/crmitchelmore_justspeaktoit__workflows.json": "4d0d4bba096198ee76a28b3ee07550099b39d57ed3b1ef446a254b892295f598",
      "test/fixtures/branch-health/gh-runs/heads/crmitchelmore_pasta__run36542967423.jobs.jsonl": "adb99c938627782fe3ec1bd20af83138c1d5d42eb46c894439e10bbe425fc1b2",
      "test/fixtures/branch-health/gh-runs/heads/crmitchelmore_pasta__run36582077961.jobs.jsonl": "c6d19acebf4f88378ef280353605a484113e9beac22a65e3c24facee242b9b18",
      "test/fixtures/branch-health/gh-runs/heads/crmitchelmore_family-watch-activity-tracker__run34574506245.jobs.jsonl": "7f572e6998b76f1daad3bc7b11bab8eda5ab7a4961325a0a9adcc7c7f7406103",
      "test/fixtures/branch-health/gh-runs/heads/crmitchelmore_justspeaktoit__run36582067536.jobs.jsonl": "368bd32597520c20b37296697f46ae03f3ad1750ee76c7c341ccb5982eb4d933",
      "test/fixtures/branch-health/gh-runs/heads/crmitchelmore_pasta__wf355610375.runs.jsonl": "6c925953a607c8d630e86656151e17f58ed513dd361aa88e36303eb53fe801bd"
    }
  },
  "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. Round 1 and 2 logs under <local evidence archive>; round 3 logs (after merging origin/main 85a5472) under <local evidence archive>",
    "commands": {
      "npm run typecheck": "exit 0",
      "node --test test/prevention-register.test.ts test/module-graph.test.ts test/intelligence.test.ts test/docs-site.test.ts test/design-tokens.test.ts": "111 pass, 0 fail",
      "node --test test/prevention-register.test.ts": "19 pass, 0 fail",
      "node --test test/documentation.test.ts": "4 pass, 0 fail",
      "node --test test/observability-catalogue.test.ts": "5 pass, 0 fail",
      "node --test test/style-lint.test.ts": "27 pass, 0 fail",
      "node --test test/delivery-boundaries.test.ts": "10 pass, 0 fail",
      "node --test test/public-build.test.ts": "21 pass, 0 fail",
      "node --test test/website.test.ts": "33 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"
    }
  },
  "environment": {
    "node": "v26.8.1",
    "platform": "darwin",
    "architecture": "arm64"
  },
  "notBuilt": [
    "durable recording of facts or exemptions (no journal, store or Portfolio mirror)",
    "any read of GitHub for this module; branch health keeps neither workflow file text nor repository visibility",
    "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": [
    "that a declared breaker marker corresponds to a breaker that trips",
    "that no dispatch exists outside the examined workflow file text: dispatches from repository scripts, local composite or unlisted actions, or in forms outside the listed patterns are not detected, so present and not-applicable cannot rule them out",
    "that no dispatch is hidden by quoting the scan does not model: each line is read alone, so a quote opened on an earlier line can put a later dispatch in an apparent comment",
    "that any public repository has no self-hosted job (job listings are samples, so the template never reports present)",
    "any Product's guardrail state today: the fixtures reproduce recorded causes from one capture of 29 September 2026"
  ],
  "coordinatorRows": [
    "docs/agents/factory-model.md module-map row",
    "docs/build-review.md row",
    "site/ rebuild after those rows"
  ],
  "review": []
}

Source: docs/prevention-register-draft.json