Factory docs, home

A record from the Factory repository, docs/producers-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.

{
  "status": "draft implementation; independent review and Fable acceptance pending",
  "scope": "E28 private Producer contract and existing Claude/OpenAI adapters with neutral proposal types and deterministic offline external consumers",
  "baseCommit": "3a819dccbea951b17d1e7b95e33b5b3c947daf0f",
  "artifact": {
    "name": "software-factory-0.1.0.tgz",
    "sha256": "e9714a8114b9221a4512fb9a990911ec95488f71b62cb48ef9ccf1e69ae90fe5",
    "private": true,
    "published": false,
    "version": "0.1.0",
    "files": 69
  },
  "environment": {
    "node": "v26.8.1",
    "platform": "darwin",
    "architecture": "arm64",
    "osVersion": "27.0",
    "typescript": "7.0.2",
    "developmentTypes": {
      "node": "26.6.3",
      "undici": "8.9.0"
    }
  },
  "sourceSha256": {
    "src/producer.ts": "80d79c1298a6156433ba3a42fe6259cabec27f2d3c55c4d80a3813e7cbcc688d",
    "src/claude-producer.ts": "95e42313a6df6ac0282d5260d4924c030f23b6ef6fc2f5eb4d4bf6741fcd5f8e",
    "src/openai-producer.ts": "5f5a9a22c004fc682eefc44d19ff4a5bdf5d6d713456b14ec626cc9568c291a1",
    "src/repository-protocol.ts": "15047f16574600cbc9fd3c71ffc39398c1d89e22ec57c672d20f94b3ec225190",
    "src/repository.ts": "80e98fb0a237e08a06090bb1311e3ac7f5248bb72739934a1d7d8f80a0e6fc49",
    "src/canonical-json.ts": "986f7f53e942101a3a689e000242f49c5d611e641beb2817312553db32edaec2",
    "src/errors.ts": "22e6444f42c15b40b7e8167017f01fb1922156764e6711de4248c3b8401f2357"
  },
  "changes": [
    "Three explicit subpaths: producer, claude-producer, openai-producer; seventeen total exports, twenty-four compiled modules, thirteen explicit Node declaration wrappers, sixty-nine package files.",
    "Producer imports unchanged limits and FileEdit/Proposal/SourceFile types from existing pure repository-protocol; Repository keeps the same type reexports. No new source helper, model task, provider policy or runtime dependency.",
    "Provider adapter files and both historical qualification receipts are byte-identical. Captured pre-change fixture retains requests, manifests, prompt bytes, proposal mapping/digests, commission digests and transport policy digests.",
    "The type-only Repository vocabulary move changes its TypeScript source hash; source-mode collector recipes with former closure pins therefore refuse dispatch without repinning. Compiled repository-protocol.js bytes and compiled collector runtime closure remain unchanged."
  ],
  "checks": [
    {
      "command": "npm run typecheck",
      "result": "passed",
      "evidence": "<local evidence archive>"
    },
    {
      "command": "focused Producer families, qualification-script unit tests, module graph/delivery boundaries, Repository/protocol/records and Intelligence",
      "result": "451/451 passed, none skipped; qualification scripts not executed",
      "evidence": "<local evidence archive>"
    },
    {
      "command": "node --test test/distribution.test.ts",
      "result": "39/39 passed, none skipped; includes all 30 prior packaged subtests, eight Producer subtests and outer test",
      "evidence": "<local evidence archive>"
    },
    {
      "command": "node --test test/documentation.test.ts test/design-tokens.test.ts test/observability-catalogue.test.ts",
      "result": "35/35 passed, none skipped; generated sites not written",
      "evidence": "<local evidence archive>"
    },
    {
      "command": "node scripts/style-lint.ts",
      "result": "passed; no baseline change",
      "evidence": "<local evidence archive>"
    }
  ],
  "externalProof": {
    "installation": "Actual npm-packed tarball installed in a disposable external application; no checkout imports or TypeScript runtime. Archived artefact integrity exactly equals the artefact tested.",
    "closure": "Producer runtime closure exactly canonical-json/errors/producer/repository-protocol; each adapter adds only itself. Restricted imports deny process/network/write capabilities. No Repository, executor, journal, Dashboard or Factory runtime loaded.",
    "types": "Strict NodeNext public declarations with explicit Node types and negative contract assertions; unchanged neutral data shapes accessible from public Producer entry.",
    "transports": "Useful bounded proposal from pinned local Node CLI fixture and loopback HTTP; synthetic test credentials/commissions only. Constructor passivity, admission denial, hard-bound refusal, malformed inputs, authentication, wrong model, credential echo, deadlines and cancellation retain documented outcomes.",
    "unknowns": "Billed spend remains unknown; remote uncertainty and local process-tree non-containment remain explicit. Lost consumption acknowledgement does not change proposal status or cause retry.",
    "recovery": "Fresh restricted process reconciles exact caller-owned consumption by dispatchId after lost acknowledgement, preserving original unknown acknowledgement. Producer itself has no durable replay API; repeated calls create new dispatch identities.",
    "guide": "Shipped complete runnable JavaScript example passes offline with no credential/commission. Every relative guide link resolves inside the exact tarball."
  },
  "remainingGates": [
    "Independent review and Fable acceptance; no merge before Fable.",
    "Coordinator combined full suite, generated documentation, stack integration and draft push; no such work performed in this lane.",
    "No live provider qualification, credentials, account access, sign-in, transport commission, Product-gate composition, complete Workflow or release.",
    "Claude remains tied to existing macOS arm64 executable/model pins and requires re-qualification/completeness audit. OpenAI live qualification remains unestablished. Fake endpoint/CLI seams are explicitly tests only.",
    "No claim of hostile-host containment, exactly-once provider execution, enforced monetary ceiling, remote cancellation or internal CLI request count.",
    "Caller owns durable admission, allowance reconciliation and decisions after unknown effects; proposed edits grant no integration authority."
  ],
  "combinedStackProof": {
    "baseCommit": "3f659019d96af949f6890c642495a73f474d7112",
    "artifactSha256": "5498282adbef32b5d0e6fa978545ecd03371ea3073bfd0427da60117d8af6ac8",
    "publicEntries": 29,
    "compiledSources": 44,
    "packedConsumerChecks": 75,
    "graphChecks": 13,
    "independentReview": "Astra ultra PASS;19 independent runtime checks and120 old/new request variants; all19 replayed against combined package, with same passive six-module Producer closure",
    "reviewedByteParity": "All three changed sources equal reviewed Producer candidate; all remaining src bytes equal reviewed Repository stack.45 original emitted files match; only reviewed ancestor Intelligence/calendar outputs differ. Both adapter outputs unchanged.",
    "typecheck": "passed",
    "fullSuite": {
      "testedSourceCommit": "cbf7966",
      "passed": 1730,
      "failed": 0,
      "skipped": 0,
      "concurrentTestFiles": 4,
      "evidence": "<local evidence archive>"
    },
    "limits": [
      "Fable acceptance remains pending",
      "Deterministic CLI and loopback HTTP only; no live provider qualification",
      "Package-facing README gap remains tracked"
    ]
  }
}

Source: docs/producers-adoption-draft.json