Factory docs, home

A record from the Factory repository, docs/work-items-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-register (roadmap WI1; the owner's request of 2 October 2026)",
  "scope": "The register of work per Product: scope keys, fixed duplicate rules, claims, takeovers, comparisons, retention, replay, the pure lane classifier, report and summary on recorded facts, and the factory:work command line. No lane reader, PR state, wiring into other modules, package entry or live register.",
  "source": {
    "base": "66cef113ff119c594e1f141ddcd9ba613dc1f12c",
    "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.test.ts": 37,
      "test/work-items-adversarial.test.ts": 12,
      "test/work-items-fixture.test.ts": 6,
      "test/factory-work-cli.test.ts": 7
    },
    "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": 29
    },
    "typecheck": "npx tsc -p tsconfig.json passed",
    "fullCheck": "npm run check passed on a quiet-enough shared machine: 2,442 tests, 0 failed (log <local evidence archive>), before two late tests and one guide sentence were added; the four focused files and the touch-point tests were rerun after.",
    "fixture": "The lane capture reproduces the planner's measured numbers for the six unmerged lanes (ahead, patch-equal, blob landing, best match, containment); the claims replay shows the continuation's duplicate of churn-p3 and churn-p5 and five takeovers of active items."
  },
  "notEstablished": [
    "Independent review (Opus 5.5 primary, Fable 5.1 xhigh secondary) has not run.",
    "No live register exists; no Product has been configured outside tests.",
    "Nothing here deletes a branch or worktree, reads a pull request, or is wired into a lifecycle stage, the Product gate, the digest or a dispatcher.",
    "The package entry and an external consumer are open (WI1b).",
    "website/ drifted by one derived count (pending portraits, 15 to 16) and is regenerated."
  ],
  "files": {
    "README.md": "ba70091e55f96ff0a96222d271192b59c149740662b7dcbaf3ad59d2b56af853",
    "docs/agents/factory-model.md": "f9e9353670d0200e8f19e1322119d3a1b313dc4a481cf0a30c462712c25358a5",
    "docs/agents/intelligence.md": "9d7f001d9c4fea92c26327289830afccd0ad3b2b2272c132df47a5aeb6e48e1e",
    "docs/agents/observability.md": "cf91b33e6b8005f2a127a4e2c64a6e60e7986f288a3f6ddc7e8d717d6f324a2e",
    "docs/agents/work-items.md": "657bd827411bfb0abe8a698a32960cb380182e2c37c8f66acf15e7f19aa60f0d",
    "docs/brand/plumb-family.json": "6f003359e0a97856ec2c2c6cb925fcf43ca4a6aa814a4e33e832a331511cd98d",
    "docs/brand/plumb-family.md": "487a402b820185219170891caa773c257829998b1b0b99be257a727ebfa6bc87",
    "docs/brand/portrait-commission.json": "a1b37f9a80da3b181ac219534cf7db94b37d13ad27d2707d63a4e8858f33a727",
    "docs/build-review.md": "735aaaa0a252608cf9177cb9bce7d3c46ac15432d4629d23d8584a8fac19a73f",
    "docs/documentation-map.json": "0e975ff00aed8369591f4569da6a04b8671dbbc7e1bf66475e95ae3b4de4cbfa",
    "docs/explanation/modules.md": "603ee2117e5f8314484dbb17d29d13158846d0e489de2d2a3bf78eace6c11e25",
    "docs/guide/work-items.md": "bb201be74be7428af9210d8eefabe87b5c92a63ff76ead992f6a988dc990bb06",
    "docs/how-to/claim-work.md": "1967a78d3cde74138b53d478c6b3c403b07cc4d3d7b9a60340c05feb083286b0",
    "docs/roadmap.md": "f14f66fb4606e47d65bb59a62208539699bc0bcff7cd73c4b7dd6d46979cd08d",
    "package.json": "94cce4501f80e6f81dc3dc4a3b9f362ab031195c625a13f130a2fa9980d1be5b",
    "scripts/factory-work.ts": "ccd757651b92b6d72c42ea2189850b73874037486cc5a51775de5776ee22dc94",
    "src/intelligence.ts": "af3bcc011dcef3348ccfa824cbbfe390bb261d53052eada7d7e64179ad0a55aa",
    "src/work-items-core.ts": "8c4cdb0a1026d1b63685e06e2e4d63e8f8a31677343ea7f5f2265cadc47948c5",
    "src/work-items.ts": "5849ec3c632314bb40f83d40e4f35f180b97b2fead62bb4e5a8727a906624bc9",
    "test/docs-site.test.ts": "e6cf9b7045d70aec28bf090cd68aa823a3ec0efab84426b2ba98aa0e34e6dd6a",
    "test/factory-work-cli.test.ts": "10a3b209204ac26953f296d5f1fa73da3dd8a3d7a1b5a4116bb89cfe0fb906cd",
    "test/fixtures/work-items/claims-2026-09-29.json": "d31fe2a2bb4a2e2006fe8ffdd0862432755672802dcc085c44935164b5f4ecbd",
    "test/fixtures/work-items/lanes-2026-10-02.json": "366be6c2875626fece705bcf5518545a78f6585efd96c76f584a22a4d7f6d3d0",
    "test/helpers/work-items-child.ts": "89281c2100cb142029eae3aa08a7af3e2457962eb1fc09005b98a094a2a4f232",
    "test/helpers/work-items.ts": "1991031f5ae80d35a61d7d5d810c8afbfae7201b093fc43892fd80e2a460f0a2",
    "test/module-graph.test.ts": "992e142349db3416bf3d0a22217937288e68acb3c8d64e2264a188e40fdc5e35",
    "test/work-items-adversarial.test.ts": "9b52f99ea8a805b19d385f54bbfe94bca0180860ce2a4600a6c9be0f1a3b2805",
    "test/work-items-fixture.test.ts": "0193776b1338e99fcb05552b63eaafc3871ee4a88f481240c3b217d41e9469df",
    "test/work-items.test.ts": "a63a8a0193cb32bc377919a4d103400115e85ceefe809d97ee8101acea5829ad"
  }
}

Source: docs/work-items-draft.json