Factory docs, home

A record from the Factory repository, docs/project-guidance-v2-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-30T19:36:02.901929+00:00",
  "status": "gap found",
  "scope": "E34 compatible eight-value Project guidance, stacked above all seven E28/E29 public entries",
  "implementation": "Versioned implementation and disposable compatibility evidence; independent review and Fable acceptance pending",
  "sourceBase": "b13cb8a6e822ab6f208434a989e59101b47b0e70",
  "sourceCandidate": "8d6f929ae424fe3112c25d3bd3ed2645f61972ef",
  "publicEntryPoints": [
    "software-factory/command-journal",
    "software-factory/execution",
    "software-factory/lifecycle-schedule",
    "software-factory/intelligence",
    "software-factory/project-guidance",
    "software-factory/attention",
    "software-factory/owner-digest"
  ],
  "artifact": {
    "file": "<local evidence archive>",
    "sha256": "c742c562425c8c14b61293cb910beecd811b090c7a6525a7573e7f4a175c34a4",
    "private": true,
    "version": "0.1.0",
    "npmRuntimeDependencies": [],
    "compiledFiles": [
      "dist/attention-contract.d.ts",
      "dist/attention-contract.js",
      "dist/attention.d.ts",
      "dist/attention.js",
      "dist/branch-health-contract.d.ts",
      "dist/branch-health-contract.js",
      "dist/canonical-json.d.ts",
      "dist/canonical-json.js",
      "dist/errors.d.ts",
      "dist/errors.js",
      "dist/execution.d.ts",
      "dist/execution.js",
      "dist/intelligence.d.ts",
      "dist/intelligence.js",
      "dist/journal.d.ts",
      "dist/journal.js",
      "dist/lifecycle-schedule.d.ts",
      "dist/lifecycle-schedule.js",
      "dist/owner-digest-core.d.ts",
      "dist/owner-digest-core.js",
      "dist/project-guidance-core.d.ts",
      "dist/project-guidance-core.js"
    ]
  },
  "oldReaderFixture": {
    "purpose": "Immutable actual pre-E34 package for old-reader/new-reader compatibility, on disposable stores only",
    "sourceCommit": "503fbef2b50e1250fe4bcd0ba0318763b013a1c3",
    "artifact": "software-factory-0.1.0.tgz",
    "sha256": "213f038927fd1b76a6ab417ca5c9ad23f23ad7a343496d1ad0573ace5b736649",
    "protocol": "product-guidance/1",
    "maxValues": 6,
    "regeneration": "Do not rebuild with current source. This is the exact archived E29 with-foundations artifact."
  },
  "compatibility": {
    "writes": "Every new save appends guidance.values-set.v2 with product-guidance-state/2 and product-guidance/2 digest, including empty or short saves.",
    "historical": "V1 exact shapes and six-value parser remain supported; revision zero stays v1. Existing event/receipt bytes, revisions, provenance, digests and pins are never rewritten.",
    "replay": "Payload/result shapes unchanged. The recorded revision selects the digest protocol for old and new exact command replay after later edits.",
    "oldReader": "Actual old package reports CORRUPT for recorded v2/mixed history and refuses edits/replay with no writes. Its independent revision-zero lookup remains valid. No forward compatibility is claimed.",
    "helper": "guidanceDigest defaults to v2; recompute history with snapshot.protocol as the fourth argument, including v1 revision-zero pins.",
    "browser": "Dashboard/3 DTO shape unchanged; existing browser consumes advertised maxValues=8 without truncation and rejects unsupported Dashboard protocols."
  },
  "checks": [
    {
      "command": "node --test test/distribution.test.ts",
      "result": "18 passed, 0 failed; all 17 prior checks retained",
      "evidence": "<local evidence archive>"
    },
    {
      "command": "focused guidance, Dashboard, projections, Intelligence, dependency graph, observability, docs and design checks",
      "result": "155 passed, 0 failed",
      "evidence": "<local evidence archive>"
    },
    {
      "command": "npm run typecheck",
      "result": "passed",
      "evidence": "<local evidence archive>"
    },
    {
      "command": "node scripts/style-lint.ts",
      "result": "passed; no baseline changes",
      "evidence": "<local evidence archive>"
    },
    {
      "command": "npm --prefix apps/dashboard run build",
      "result": "passed; own worktree output",
      "evidence": "<local evidence archive>"
    }
  ],
  "browserEvidence": {
    "method": "Existing cached Playwright/Chromium headless; IAB returned Browser is not available: iab; no installation or user browser switch",
    "viewports": [
      "1536x1024",
      "390x844"
    ],
    "result": "added seventh/eighth, saved revision 2, reloaded all eight, preserved revision 1/provenance, add disabled at eight, no horizontal overflow or console/page errors",
    "evidence": "<local evidence archive>",
    "source": "Browser sources unchanged from 503fbef; guidance runtime bytes unchanged during projections merge"
  },
  "policy": "Only the project-guidance/summarise explanatory purpose/returns limit changes from six to eight. These fields are outside policyDigest; the explicit comparison confirms every task policy digest, model pin, qualification and runtime acceptance unchanged.",
  "sourceSha256": {
    "docs/agents/dashboard.md": "df7a0f08600a80d4c19db8bfd79eb3821a0656cea5588423dba105decdf7f80f",
    "docs/agents/factory-model.md": "adafd7a25ce9dba9c11aba5c2974a7fc271bc633c775d9c7dc809a3193f02933",
    "docs/agents/observability.md": "9009f1eb1c0dc351e5400c1e56dd4b34d268e11b3ea9716740c61232941d983e",
    "docs/agents/project-guidance.md": "fff8c65a80c6544fcf1eddc52b0ad5c13306de7df1ce7bde886b1d246d8eacf3",
    "docs/build-review.md": "e05d3046947cff0b05ac61680e1da5b9907f17d4101da5cb688aa7ecf4b928db",
    "docs/guide/project-guidance.md": "2bd79d93f88c0f2e72e14039189bc2aedbe1eaf5a302a719cda827703ffd099a",
    "docs/how-to/adopt-project-guidance.md": "bc517c7d19eff0c816222d885d838917d188cad6634ce215e729ab333599b91e",
    "docs/project-guidance.md": "ba1687a511f98c9c275fd03c946164270b37f4c45d0295bea7218d18e768a8ec",
    "docs/values.md": "ecf3c14da4a900608bc6a955ae92a3d996d6b9512ae2b706977d1124d637757d",
    "src/intelligence.ts": "dce256b315d207e97d1b57553a3f33011467bfd768acf08cbb18bc8c1a88e14e",
    "src/project-guidance-core.ts": "31ddf3e784b7f795c13a3924f82b8c9fe7a5000bfaebb21400cb19c673a5587c",
    "test/dashboard-editor.test.ts": "10887f7fd2a824c290e9c76bdb5ecf2a416c95bb7443447983fed701e814cafb",
    "test/dashboard-guidance-attention.test.ts": "36c5661133d8cde43396fd958a31af1b3fdd7799681300f05e0e6dd8105cb6e6",
    "test/distribution.test.ts": "deb6a010f622ccb0ea8442ad06ff5ba443a0e7acb3ec5c7a7f75da33d4bcb1de",
    "test/fixtures/distribution/guidance-consumer.mjs": "3014977a70a7d16e3a3701e13d0f49f2ee12800f98dc57d00921d1ef2a5c49cc",
    "test/fixtures/guidance-v1/provenance.json": "82d5051fe9440bd297a95ca9e61d725d2737a6894c021e510305a30934332569",
    "test/fixtures/guidance-v1/reader.mjs": "61e8986f4eb12cd87fa571902d81ec40ba29023389042ceb20cfe6531bbbd84b",
    "test/fixtures/guidance-v1/software-factory-0.1.0.tgz": "213f038927fd1b76a6ab417ca5c9ad23f23ad7a343496d1ad0573ace5b736649",
    "test/helpers/guidance-core-child.ts": "4c192ed5782b40613d0e76eca3a390943d261a3f492c1723c8a83638a0bd87e9",
    "test/observability-catalogue.test.ts": "52270d71ffae6d1a31bff4e0f99e5d933f2e69a11fb7e1a0c25e1097eb1fc479",
    "test/project-guidance-core.test.ts": "384d9f8e07eb24ce96cbe25c22db71d5441a1c3bed0ee74906d6010c885b1437",
    "test/project-guidance-namespace.test.ts": "2701fcc5bb4c471b6d86ce174e75b4182858d9362c588f07c00bee0078007776",
    "test/project-guidance-v2.test.ts": "674189f6eec6cde763f623eaa5d19ff44bca80be6d2776ed09703008c2b4148e",
    "test/project-guidance.test.ts": "e0834364c8a218545decafb66a619579cb7c62764c6d9af7c9695c195d430ce0"
  },
  "openGates": [
    "Fable acceptance",
    "separately authorised live append and old/new pin read-back",
    "planner consumption remains unimplemented"
  ],
  "excluded": [
    "live .factory writes or migrations",
    "rewrite of existing events/receipts/revisions or acceptance hashes",
    "registry publication",
    "new runtime authority or planner consumption",
    "E34 epic closure"
  ],
  "combinedStackProof": {
    "baseCommit": "1a39c50b08276b14cea0bca6a7082d758f1644a9",
    "sourceCommit": "5eb86314d62b97200c896f8b08944d411a786098",
    "artifactSha256": "c8cea2533aaf68810bd229682666fcf289d06b8030e2b49d19bf66065bc82991",
    "publicEntries": 8,
    "compiledSources": 12,
    "packedConsumerChecks": 23,
    "fullSuite": {
      "passed": 1655,
      "failed": 0,
      "skipped": 0,
      "concurrentTestFiles": 4,
      "evidence": "<local evidence archive>"
    },
    "independentReview": {
      "result": "Astra ultra PASS; two prose findings corrected",
      "probes": 13,
      "combinedArtifactRerun": "passed; every original reviewed compiled file remains byte-identical",
      "evidence": "<local evidence archive>"
    },
    "browser": "Independent in-app browser desktop 1440x1000/mobile 375x812 save/reload/history/provenance/ninth-value refusal/overflow checks passed; source unchanged",
    "documentation": "LIMIT eight corrected, E33 removed from scope, all packaged relative guide links resolve or use immutable source references",
    "policy": "all eleven task policy digests unchanged",
    "limits": "No live append/migration, Fable acceptance or epic closure"
  }
}

Source: docs/project-guidance-v2-draft.json