Factory docs, home

A record from the Factory repository, docs/command-journal-adoption-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": "factory-adoption-draft/1",
  "recordedAt": "2026-09-30T18:48:16.043Z",
  "status": "gap found",
  "scope": "E28 first increment: private CommandJournal distribution only",
  "implementation": "local proof passed; independent Fable review pending; no merge or publication",
  "sourceBase": "c27b643",
  "publicEntryPoint": "software-factory/command-journal",
  "artifact": {
    "file": "<local evidence archive>",
    "sha256": "e7093d0debbaf4c306b12301d66f75ff1530167145f0f2e4925e447c870b4859",
    "private": true,
    "npmRuntimeDependencies": [],
    "compiledSourceClosure": [
      "src/journal.ts",
      "src/canonical-json.ts",
      "src/errors.ts"
    ]
  },
  "environment": {
    "node": "v26.8.1",
    "npm": "11.19.0",
    "typescript": "7.0.2",
    "platform": "darwin",
    "architecture": "arm64",
    "macOS": "27.0",
    "filesystem": "host-local SQLite files in disposable temporary consumer"
  },
  "sourceSha256": {
    "src/journal.ts": "eeb3288f539fe8863632457cf35ff7e7353d4bcee40a0eebae567cdd560e96b4",
    "src/canonical-json.ts": "986f7f53e942101a3a689e000242f49c5d611e641beb2817312553db32edaec2",
    "src/errors.ts": "22e6444f42c15b40b7e8167017f01fb1922156764e6711de4248c3b8401f2357"
  },
  "checks": [
    {
      "command": "npm run typecheck",
      "result": "passed",
      "evidence": "<local evidence archive>"
    },
    {
      "command": "node --test test/distribution.test.ts",
      "result": "6 passed, 0 failed",
      "evidence": "<local evidence archive>"
    },
    {
      "command": "node --test test/journal.test.ts test/journal-open.test.ts test/journal-read-only.test.ts test/journal-adversarial.test.ts test/journal-startup-boundaries.test.ts test/journal-existing.test.ts test/module-graph.test.ts",
      "result": "47 passed, 0 failed"
    },
    {
      "command": "node --test test/design-tokens.test.ts test/documentation.test.ts",
      "result": "30 passed, 0 failed"
    },
    {
      "command": "node scripts/style-lint.ts",
      "result": "passed; existing 5 baseline entries, none stale"
    }
  ],
  "externalProof": [
    "offline local-tarball installation with no runtime dependencies",
    "passive public import under read-only Node permissions; private paths rejected",
    "shipped declarations typecheck without Factory source or Node type dependency",
    "caller-owned files; durable replay and version/command conflicts",
    "invalid input, decision rollback, missing/foreign/future/corrupt store refusal",
    "isolated consumer files and read-only refusal",
    "source and compiled module share schema-1 state without migration",
    "same-command recovery after SIGKILL before and after commit"
  ],
  "substitution": "No storage or provider collaborator exists at this boundary; caller supplies trusted pure synchronous decisions. No new abstraction introduced.",
  "observedEffort": "One bounded draft implementation increment; existing sources unchanged; existing pinned TypeScript reused; no new installed dependency. Remaining estimates unchanged because other families and executable-resource identity are untested.",
  "openGates": [
    "independent Fable review and resulting repairs",
    "coordinator serialised full-suite check and generated-site rebuild",
    "other E28 module families, worker resources and integrity manifests",
    "all E29-E35 and complete Workflow adoption proofs",
    "platforms beyond Node 26.8.1 on macOS 27 arm64"
  ],
  "excluded": [
    "registry publication",
    "live storage migration",
    "provider or permission substitution",
    "power-loss or multi-host guarantee"
  ]
}

Source: docs/command-journal-adoption-draft.json