Factory docs, home

A record from the Factory repository, docs/work-items-lanes-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-work-items-draft/1",
  "disposition": "implemented-awaiting-independent-review",
  "packet": "WI1-lanes (roadmap WI1; the owner's request of 2 October 2026)",
  "scope": "The read-only lane reader (src/work-items-git.ts), the stale, keys, claim --from-branch, claim --repo and advance --repo commands, the LANDED refusal, and the documentation and touch-points that go with them. Reads Git only; deletes, fetches and writes nothing.",
  "source": {
    "base": "32967cb6c369b9f556505a5ca734ce03ff094237",
    "branch": "factory/work-items",
    "note": "Hashes are of the working tree at the time this draft was written, before the commit that carries these bytes. The plan is <local evidence archive>"
  },
  "checks": {
    "focused": {
      "test/work-items-git.test.ts": 18,
      "test/factory-work-cli.test.ts": 12,
      "test/work-items.test.ts": 37,
      "test/work-items-adversarial.test.ts": 12,
      "test/work-items-fixture.test.ts": 6
    },
    "reproduction": "The reader, run once over the bundles of the 2 October sweep in a disposable repository, reproduces the committed capture test/fixtures/work-items/lanes-2026-10-02.json for every lane (log <local evidence archive>).",
    "noWrites": "test/work-items-git.test.ts: refs, packed refs, indexes and worktree administration are byte-identical after two reads; a repository whose configuration names diff.external, a textconv driver, a clean filter, core.fsmonitor, four hooks and log.showSignature with a gpg.program over signed commits runs none of them, and its worktree state is unknown (filter-configured); a worktree on a branch outside the lane prefixes is read, and one behind a symbolic link is unknown (symbolic-link).",
    "liveTiming": "One read-only read of the shared repository's 210 lanes (prefixes factory/, claude/ and codex/) took 6 seconds with every lane read (log logs/lanes-live-read-timing.log); nothing was recorded.",
    "fullCheck": "npm run check passed with both parts in the tree: 2,468 tests, 0 failed (log <local evidence archive>); a later comment-only edit to four source files and one test header was followed by the five focused files, the touch-point tests and the typecheck.",
    "touchPoints": {
      "intelligence": 55,
      "observability-catalogue": 5,
      "docs-site": 24,
      "design-tokens": 26,
      "generate-portraits": 9,
      "delivery-boundaries": 10,
      "factory-specific-docs": 5,
      "website": 34,
      "module-graph": 30
    }
  },
  "notEstablished": [
    "Independent review (Opus 5.5 primary, Fable 5.1 xhigh secondary) has not run.",
    "No live register exists, and no live report has been recorded.",
    "Of the 210 live lanes read, 100 held only untracked entries (symbolic links to node_modules), which the classifier's rule sends to the owner as preserve-then-remove: a decision for review before live use.",
    "Remote-only branches and other hosts' worktrees are not read; there is no pull-request state (WI1c).",
    "The package entry and an external consumer are open (WI1b)."
  ],
  "files": {
    "docs/agents/factory-model.md": "555860cf1fcf8eb146ba25dc5b8a82dfd73e7432574cf4581e1ceaf704c9eccf",
    "docs/agents/observability.md": "eb2c9172327d48a0efa78045d3e48df4a2df77c573b061825d321d6400b3cf6e",
    "docs/agents/work-items.md": "0c9ac1b2c0b6a4d05bea48cd52c90ff2fe87639a90c3473e1c72e95e2875e424",
    "docs/build-review.md": "d37972c7a90747890dc1ab58a585dc0569b678d538d6871a81db9e42454c7589",
    "docs/explanation/modules.md": "ed9e208809f71d845ab56ad044b1bd3ad8ad0248984bf5ad603a18f4d8fffb05",
    "docs/guide/work-items.md": "ad21b14d014fead7cc5ffbec18d357bdd121bdfeffb08fccb970317a2c6d8d41",
    "docs/how-to/claim-work.md": "e5d42a4f5e92ab7d7b847a2b78021d86fb6c76f16e0423b2fc4c5fe01876e44a",
    "scripts/factory-work.ts": "f704d76752d4589d2463fe0de6242286561626e81cb744e03c474bfed3ff23db",
    "src/intelligence.ts": "c63a41addb6b72347768dc5b4dbefb8f78fee3aa3807ca9c14cb9cd5d6c99fb4",
    "src/work-items-core.ts": "78f5db673c6fce24d5492b1ae1f776d2b758e7284463b5694cda39e374971aae",
    "src/work-items-git.ts": "3a143098932ec79a658325604029f58fbccb6c26f100e9d16b9eae27fefeda91",
    "test/factory-work-cli.test.ts": "38c11a9ff36c3ee288db4d4d2ce0d162238f36f25a00d2a52e58d0e97977f9fc",
    "test/helpers/work-items-repo.ts": "7a6e66fad467edd660f9a389340aef96e54d5b0173b5943a6b3c17fb2a5b779d",
    "test/module-graph.test.ts": "b4202d941d162bfa11404b768b4ca302b33ba67d21e859f8ad16cb93e45fa2b3",
    "test/work-items-git.test.ts": "a0349ef03f3c9ba2a20d5c3a9c9d34c7d43c6665f2d9c375358758e4c3d03390"
  }
}

Source: docs/work-items-lanes-draft.json