archctx-contracts 0.7.1 → 0.8.0

package/fixtures/valid/projection-manifest.json

@@ -1,175 +1,53 @@
 {
-  "schemaVersion": "archcontext.architecture-docs-projection-manifest/v2",
-  "rendererVersion": "archcontext.docs-renderer/v5",
+  "schemaVersion": "archcontext.architecture-docs-projection-manifest/v3",
+  "rendererVersion": "archcontext.docs-renderer/v6",
   "profile": "repo-harness/v1",
-  "sourceDigest": "sha256:5555555555555555555555555555555555555555555555555555555555555555",
-  "provenance": {
-    "schemaVersion": "archcontext.architecture-docs-projection-provenance/v3",
-    "sourceTreeDigest": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
-    "modelDigest": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
-    "rendererVersion": "archcontext.docs-renderer/v5",
-    "layoutVersion": "archcontext.docs-layout/v1",
-    "generatedFrom": {
-      "codeGraphPackage": "@colbymchenry/codegraph",
-      "codeGraphVersion": "1.6.1"
-    },
-    "projectionInputDigest": "sha256:16f337f3a1e0eac82b565ca1a0dc04629af1df60d7e2b9ad9b767c21ae581d4c"
-  },
-  "projectionDigest": "sha256:336562d0f1772c32f64a5fe7ee62d49fb17ac6ef7c9d820385c05e538ed1e5d1",
+  "layoutVersion": "archcontext.docs-layout/v1",
+  "generatedFrom": {"codeGraphPackage":"@colbymchenry/codegraph","codeGraphVersion":"1.6.2"},
   "semanticBaseline": {
-    "semanticState": {
-      "schemaVersion": "archcontext.architecture-semantic-state/v1",
-      "capabilities": [
-        {
-          "capabilityId": "capability.example.billing",
-          "memberNodeIds": [
-            "capability.example.billing"
-          ],
-          "semanticFingerprint": "sha256:a6357941efd4f3307106c1650eca068e30db5d704e83a90ff238a1cda3c39471",
-          "flowProofFingerprint": "sha256:066fed47f724c54dca2e7c9d01c79bc05362004b1c49edb593bf80cd239e66f8",
-          "proofStatus": {
-            "p1": "unprovable",
-            "p2": "not-applicable"
-          },
-          "facets": {
-            "constraints": "sha256:d1c61fe896c27d26f03ec0c3d4ee584954bedee94abc988f5cc2ba12fa9aa246",
-            "entrypoints": "sha256:040e1e188d64957a0fbf33d790c062bb4b63ceae21e8d054720d2ef3c974ebca",
-            "interfaces": "sha256:78dd8a6e8eb5a106964ebdd464b873b6ed58f857c3d816a0b595106addac12b2",
-            "lifecycle": "sha256:45e0f02c02e3b6b1b9a7d4b30e9acb7aac52e68ca7fea468377cfa6e7ed1236f",
-            "names": "sha256:1e91c01c88f9156cc043971b089aa573d1ab0873a4ea73fbe12728775142f9b7",
-            "ownership": "sha256:a00ea5710e08406444452ccf3bce97d054e2c2d6595d0f560e98b32b04500c01",
-            "placement": "sha256:b5f9e3fd0ce231d6b4b05bd918c93043cc15d7f3b592b12b84972904e0f1b74d",
-            "relations": "sha256:4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945",
-            "responsibilities": "sha256:310fb2a928123d4df66bd32884e7eba3a854be1928f8d7c73e99fef59a5fb91a",
-            "riskBoundaries": "sha256:6457da469f290fa149c5eccbbc6347d7604fee7c59f5b231d10493e7722a57fe"
-          }
-        }
-      ],
-      "semanticFingerprint": "sha256:e5a66426ccb094ed525d4640727fa051f56cf447ade1a30c3d4034956fe376ab",
-      "flowProofFingerprint": "sha256:e435532a8614ec60bcae46f17b28e81bc847e4429d26fad19070264eca5dce3e"
-    },
-    "digests": {
-      "modelDigest": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
-      "sourceTreeDigest": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
-      "flowProofDigest": "sha256:e435532a8614ec60bcae46f17b28e81bc847e4429d26fad19070264eca5dce3e",
-      "projectionDigest": "sha256:336562d0f1772c32f64a5fe7ee62d49fb17ac6ef7c9d820385c05e538ed1e5d1"
-    },
-    "evidence": {
-      "sourceTreeDigest": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
-      "selectorEvidenceDigest": "sha256:4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945",
-      "rendererVersion": "archcontext.docs-renderer/v5"
-    }
-  },
-  "receiptDigest": "sha256:9f11bf3efe26f8ba7654d036e39316176e8d78b3270b886760e526a83b617e58",
-  "targetCount": 7,
-  "fileCount": 7,
-  "targets": [
-    {
-      "targetId": "projection_target.architecture.index",
-      "type": "architecture-index",
-      "scope": {
-        "kind": "repository"
-      },
-      "path": "docs/architecture/index.md",
-      "ownership": "mixed",
-      "rendererVersion": "archcontext.docs-renderer/v5",
-      "format": "markdown",
-      "sourceDigest": "sha256:5555555555555555555555555555555555555555555555555555555555555555",
-      "outputDigest": "sha256:64f1a29733be5033316aa99f657bfeb543df2fca99a2ba8b4103be22d46eeb57"
-    },
-    {
-      "targetId": "projection_target.entity.capability-example-billing",
-      "type": "entity-summary",
-      "scope": {
-        "kind": "entity",
-        "id": "capability.example.billing",
-        "entityKind": "capability"
-      },
-      "path": "docs/architecture/modules/example/billing.md",
-      "ownership": "mixed",
-      "rendererVersion": "archcontext.docs-renderer/v5",
-      "format": "markdown",
-      "sourceDigest": "sha256:b817894a048392bcfd08bcf0cb2db65be60c93b52adeba3c3858aab88fff2e55",
-      "outputDigest": "sha256:2963da98797bba21c3e87b86e60dca3b7c19f75a592723e4c98e0f41b2eb8f58",
-      "sourceFootprintDigest": "sha256:6666666666666666666666666666666666666666666666666666666666666666",
-      "scale": {
-        "fileCountBucket": {
-          "lower": 10,
-          "upper": 20
+    "modelDigest": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
+    "capabilities": [
+      {
+        "capabilityId": "capability.example.billing",
+        "memberNodeIds": [
+          "capability.example.billing"
+        ],
+        "semanticFingerprint": "sha256:a6357941efd4f3307106c1650eca068e30db5d704e83a90ff238a1cda3c39471",
+        "flowProofFingerprint": "sha256:066fed47f724c54dca2e7c9d01c79bc05362004b1c49edb593bf80cd239e66f8",
+        "proofStatus": {
+          "p1": "unprovable",
+          "p2": "not-applicable"
+        },
+        "facets": {
+          "constraints": "sha256:d1c61fe896c27d26f03ec0c3d4ee584954bedee94abc988f5cc2ba12fa9aa246",
+          "entrypoints": "sha256:040e1e188d64957a0fbf33d790c062bb4b63ceae21e8d054720d2ef3c974ebca",
+          "interfaces": "sha256:78dd8a6e8eb5a106964ebdd464b873b6ed58f857c3d816a0b595106addac12b2",
+          "lifecycle": "sha256:45e0f02c02e3b6b1b9a7d4b30e9acb7aac52e68ca7fea468377cfa6e7ed1236f",
+          "names": "sha256:1e91c01c88f9156cc043971b089aa573d1ab0873a4ea73fbe12728775142f9b7",
+          "ownership": "sha256:a00ea5710e08406444452ccf3bce97d054e2c2d6595d0f560e98b32b04500c01",
+          "placement": "sha256:b5f9e3fd0ce231d6b4b05bd918c93043cc15d7f3b592b12b84972904e0f1b74d",
+          "relations": "sha256:4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945",
+          "responsibilities": "sha256:310fb2a928123d4df66bd32884e7eba3a854be1928f8d7c73e99fef59a5fb91a",
+          "riskBoundaries": "sha256:6457da469f290fa149c5eccbbc6347d7604fee7c59f5b231d10493e7722a57fe"
         },
-        "lineCountBucket": {
-          "lower": 500,
-          "upper": 1000
-        }
+        "selectorEvidenceDigest": "sha256:4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945"
       }
-    },
-    {
-      "targetId": "projection_target.decision.index",
-      "type": "decision-index",
-      "scope": {
-        "kind": "decision"
-      },
-      "path": "docs/architecture/decisions/index.md",
-      "ownership": "mixed",
-      "rendererVersion": "archcontext.docs-renderer/v5",
-      "format": "markdown",
-      "sourceDigest": "sha256:5555555555555555555555555555555555555555555555555555555555555555",
-      "outputDigest": "sha256:34055a2aa0fbe868ce5dea7df5354de5da63830e5972ff683d9647f97374ec26"
-    },
-    {
-      "targetId": "projection_target.architecture.changelog",
-      "type": "architecture-changelog",
-      "scope": {
-        "kind": "changelog"
-      },
-      "path": "docs/architecture/changelog.md",
-      "ownership": "mixed",
-      "rendererVersion": "archcontext.docs-renderer/v5",
-      "format": "markdown",
-      "sourceDigest": "sha256:5555555555555555555555555555555555555555555555555555555555555555",
-      "outputDigest": "sha256:1f723aeb74466aae7d607eeab8c438a830c36f49a48e6622f868a8151afabea6"
-    },
-    {
-      "targetId": "projection_target.diagram.mermaid",
-      "type": "diagram-mermaid",
-      "scope": {
-        "kind": "diagram",
-        "id": "architecture"
-      },
-      "path": "docs/architecture/diagrams/architecture.mmd",
-      "ownership": "generated",
-      "rendererVersion": "archcontext.docs-renderer/v5",
-      "format": "mermaid",
-      "sourceDigest": "sha256:5555555555555555555555555555555555555555555555555555555555555555",
-      "outputDigest": "sha256:cab3b5ef19166b5dafbd869ba6060eb52a05f14670db938fa1b13ca4b8bb31bd"
-    },
-    {
-      "targetId": "projection_target.diagram.structurizr",
-      "type": "diagram-structurizr",
-      "scope": {
-        "kind": "diagram",
-        "id": "architecture"
-      },
-      "path": "docs/architecture/diagrams/architecture.structurizr.json",
-      "ownership": "generated",
-      "rendererVersion": "archcontext.docs-renderer/v5",
-      "format": "structurizr-json",
-      "sourceDigest": "sha256:5555555555555555555555555555555555555555555555555555555555555555",
-      "outputDigest": "sha256:c886230580a87c89ee758db91fc26f6fb2100eb1017cfe0619a3e2332171c42d"
-    },
-    {
-      "targetId": "projection_target.diagram.likec4",
-      "type": "diagram-likec4",
-      "scope": {
-        "kind": "diagram",
-        "id": "architecture"
-      },
-      "path": "docs/architecture/diagrams/architecture.likec4",
-      "ownership": "generated",
-      "rendererVersion": "archcontext.docs-renderer/v5",
-      "format": "likec4",
-      "sourceDigest": "sha256:5555555555555555555555555555555555555555555555555555555555555555",
-      "outputDigest": "sha256:99c534ffdd668102413d47529127887cba120ef9a3f4c2cd62b40e41ef8757e5"
-    }
-  ]
+    ]
+  },
+  "targets": {
+    "projection_target.architecture.changelog":
+      {"type":"architecture-changelog","scope":{"kind":"changelog"},"path":"docs/architecture/changelog.md","ownership":"mixed","format":"markdown","outputDigest":"sha256:1f723aeb74466aae7d607eeab8c438a830c36f49a48e6622f868a8151afabea6"},
+    "projection_target.architecture.index":
+      {"type":"architecture-index","scope":{"kind":"repository"},"path":"docs/architecture/index.md","ownership":"mixed","format":"markdown","outputDigest":"sha256:64f1a29733be5033316aa99f657bfeb543df2fca99a2ba8b4103be22d46eeb57"},
+    "projection_target.decision.index":
+      {"type":"decision-index","scope":{"kind":"decision"},"path":"docs/architecture/decisions/index.md","ownership":"mixed","format":"markdown","outputDigest":"sha256:34055a2aa0fbe868ce5dea7df5354de5da63830e5972ff683d9647f97374ec26"},
+    "projection_target.diagram.likec4":
+      {"type":"diagram-likec4","scope":{"kind":"diagram","id":"architecture"},"path":"docs/architecture/diagrams/architecture.likec4","ownership":"generated","format":"likec4","outputDigest":"sha256:99c534ffdd668102413d47529127887cba120ef9a3f4c2cd62b40e41ef8757e5"},
+    "projection_target.diagram.mermaid":
+      {"type":"diagram-mermaid","scope":{"kind":"diagram","id":"architecture"},"path":"docs/architecture/diagrams/architecture.mmd","ownership":"generated","format":"mermaid","outputDigest":"sha256:cab3b5ef19166b5dafbd869ba6060eb52a05f14670db938fa1b13ca4b8bb31bd"},
+    "projection_target.diagram.structurizr":
+      {"type":"diagram-structurizr","scope":{"kind":"diagram","id":"architecture"},"path":"docs/architecture/diagrams/architecture.structurizr.json","ownership":"generated","format":"structurizr-json","outputDigest":"sha256:c886230580a87c89ee758db91fc26f6fb2100eb1017cfe0619a3e2332171c42d"},
+    "projection_target.entity.capability-example-billing":
+      {"type":"entity-summary","scope":{"kind":"entity","id":"capability.example.billing","entityKind":"capability"},"path":"docs/architecture/modules/example/billing.md","ownership":"mixed","format":"markdown","outputDigest":"sha256:2963da98797bba21c3e87b86e60dca3b7c19f75a592723e4c98e0f41b2eb8f58","sourceStamps":{"capability.example.billing":"sha256:6666666666666666666666666666666666666666666666666666666666666666"},"scale":{"fileCountBucket":{"lower":10,"upper":20},"lineCountBucket":{"lower":500,"upper":1000}}}
+  }
 }

package/fixtures/valid/projection-result.json

@@ -13,9 +13,9 @@
     "codeGraphDigest": "sha256:4444444444444444444444444444444444444444444444444444444444444444",
     "indexedWorktreeDigest": "sha256:4545454545454545454545454545454545454545454545454545454545454545",
     "projectionInputDigest": "sha256:5555555555555555555555555555555555555555555555555555555555555555",
-    "rendererVersion": "archcontext.docs-renderer/v5",
+    "rendererVersion": "archcontext.docs-renderer/v6",
     "layoutVersion": "archcontext.docs-layout/v1",
-    "generatedFrom": { "codeGraphPackage": "@colbymchenry/codegraph", "codeGraphVersion": "1.6.1", "codeGraphStatus": "ready" }
+    "generatedFrom": { "codeGraphPackage": "@colbymchenry/codegraph", "codeGraphVersion": "1.6.2", "codeGraphStatus": "ready" }
   },
   "outputSnapshot": {
     "repositoryId": "repo.example",
@@ -28,9 +28,9 @@
     "codeGraphDigest": "sha256:9999999999999999999999999999999999999999999999999999999999999999",
     "indexedWorktreeDigest": "sha256:9898989898989898989898989898989898989898989898989898989898989898",
     "projectionInputDigest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
-    "rendererVersion": "archcontext.docs-renderer/v5",
+    "rendererVersion": "archcontext.docs-renderer/v6",
     "layoutVersion": "archcontext.docs-layout/v1",
-    "generatedFrom": { "codeGraphPackage": "@colbymchenry/codegraph", "codeGraphVersion": "1.6.1", "codeGraphStatus": "ready" }
+    "generatedFrom": { "codeGraphPackage": "@colbymchenry/codegraph", "codeGraphVersion": "1.6.2", "codeGraphStatus": "ready" }
   },
   "affectedNodeIds": ["capability.api"],
   "files": [
@@ -43,5 +43,5 @@
   ],
   "humanActions": [],
   "refreshSignals": [],
-  "receiptDigest": "sha256:efd5f90c12bb14cf64bfe2b5f244eac776ec7984dbbdfebc4bc89bc963818843"
+  "receiptDigest": "sha256:b080eaee9ba5c2d617b00a91e5848162f6c65eb53a367849f390237bac574a3e"
 }

package/fixtures/valid/refactor-decision.json

@@ -0,0 +1,38 @@
+{
+  "schemaVersion": "archcontext.refactor-decision/v1",
+  "namespace": "product.architecture-context",
+  "recommendationId": "recommendation.4aa8477d81e9d473",
+  "fingerprint": "sha256:5fcec35f40c11d3c1fbc62d2ee21c794f4abcd201ada86940fe142773cb736c4",
+  "fingerprintSchemaVersion": "archcontext.recommendation-fingerprint/v3",
+  "category": "structural_observation",
+  "kind": "cycle",
+  "subject": {
+    "selectorKind": "repository",
+    "stableKey": "pair:component.architecture-context.core.changeset-engine|component.architecture-context.core.policy-engine",
+    "subjectSelectorId": "subject.repository.b7c61fc13826e1e3"
+  },
+  "affectedNodeIds": [
+    "component.architecture-context.core.changeset-engine",
+    "component.architecture-context.core.policy-engine"
+  ],
+  "affectedNodeCount": 2,
+  "regressesFrom": null,
+  "status": "rejected",
+  "observationMetrics": {
+    "backwardEdgeCount": 4,
+    "forwardEdgeCount": 1,
+    "thinDirectionEdgeCount": 1,
+    "totalEdgeCount": 5
+  },
+  "reason": "The policy engine owns the path allowlist; the back edge is the intended seam.",
+  "actor": {
+    "kind": "cli",
+    "id": "developer"
+  },
+  "decidedAt": "2026-10-13T09:00:00.000Z",
+  "provenance": {
+    "headSha": "0c6bc11d00000000000000000000000000000000",
+    "assessmentDigest": "sha256:3c0eb0020e00e35b734ac0396c00ef1c01733543ad7863938edcf7906b89c971",
+    "baselineSnapshotDigest": "sha256:b5bcfda3c89d235c429f584439f5db74f833abd91d4c12f0b7a477ed49b60e80"
+  }
+}

package/fixtures/valid/runtime-recommendation-show.json

@@ -3,6 +3,7 @@
   "recommendationId": "recommendation.c8c842b3d8529388",
   "source": "ledger",
   "status": "deferred",
+  "statusAuthority": "ledger",
   "recommendation": {
     "schemaVersion": "archcontext.recommendation/v3",
     "recommendationId": "recommendation.c8c842b3d8529388",

package/fixtures/valid/runtime-refactor-scan.json

@@ -12,6 +12,7 @@
     "worktreeDigest": "sha256:96cbb5ccf708d8b7c56c2633e8937311338957998b7154879461706460d4c467"
   },
   "requestId": "refactor_request.d514edefd58b7a9e",
+  "namespace": "product.architecture-context",
   "request": {
     "schemaVersion": "archcontext.refactor-request/v1",
     "scope": {
@@ -111,6 +112,7 @@
         "moduleDigest": "sha256:32d887790fe89e1415d1cb0e68557509e025b4026184ad8a463f4d886a3de182"
       }
     ],
+    "moduleDependencies": [],
     "repositorySummary": {
       "moduleCount": 2,
       "undeclaredFootprintNodeCount": 1,
@@ -140,6 +142,7 @@
       {
         "kind": "evidence-gap",
         "subjectSelectorId": "repository:repo.537182127c5f2134",
+        "affectedNodeIds": [],
         "metrics": {
           "unresolvedImportCount": 0,
           "edgeLimit": 5000
@@ -164,6 +167,9 @@
       {
         "kind": "undeclared-footprint",
         "subjectSelectorId": "capability.architecture.context",
+        "affectedNodeIds": [
+          "capability.architecture.context"
+        ],
         "metrics": {},
         "evidence": {
           "kind": "undeclared-footprint",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "archctx-contracts",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",

package/schemas/repo/refactor-decision.schema.json

@@ -0,0 +1,218 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/repo/refactor-decision.schema.json",
+  "title": "RefactorDecision",
+  "description": "The latest human decision for one refactor recommendation generation, stored at .archcontext/refactor-decisions/<recommendationId>.json (ADR-0046). Identity that needs the core hashers (recommendationId from fingerprint and regressesFrom, the namespace-scoped subject selector) is checked by the runtime reader.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "namespace",
+    "recommendationId",
+    "fingerprint",
+    "fingerprintSchemaVersion",
+    "category",
+    "kind",
+    "subject",
+    "affectedNodeIds",
+    "affectedNodeCount",
+    "regressesFrom",
+    "status",
+    "observationMetrics",
+    "reason",
+    "actor",
+    "decidedAt",
+    "provenance"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "archcontext.refactor-decision/v1"
+    },
+    "namespace": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9]*(\\.[a-z0-9][a-z0-9-]*)+$"
+    },
+    "recommendationId": {
+      "type": "string",
+      "pattern": "^recommendation\\.[a-f0-9]{16}$"
+    },
+    "fingerprint": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "fingerprintSchemaVersion": {
+      "const": "archcontext.recommendation-fingerprint/v3"
+    },
+    "category": {
+      "type": "string",
+      "enum": [
+        "refactor_proposal",
+        "structural_observation"
+      ]
+    },
+    "kind": {
+      "anyOf": [
+        {
+          "type": "null"
+        },
+        {
+          "type": "string",
+          "enum": [
+            "cycle",
+            "direction-violation",
+            "evidence-gap",
+            "ownership-ambiguous",
+            "residual-cycle",
+            "undeclared-footprint",
+            "unowned-paths"
+          ]
+        }
+      ]
+    },
+    "subject": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "selectorKind",
+        "stableKey",
+        "subjectSelectorId"
+      ],
+      "properties": {
+        "selectorKind": {
+          "type": "string",
+          "enum": [
+            "node",
+            "repository"
+          ]
+        },
+        "stableKey": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512,
+          "pattern": "^\\S(?:[^\\u0000-\\u001f\\u007f]*\\S)?$"
+        },
+        "subjectSelectorId": {
+          "type": "string",
+          "pattern": "^subject\\.(node|repository)\\.[a-f0-9]{16}$"
+        }
+      }
+    },
+    "affectedNodeIds": {
+      "type": "array",
+      "maxItems": 32,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "affectedNodeCount": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "regressesFrom": {
+      "anyOf": [
+        {
+          "type": "null"
+        },
+        {
+          "type": "string",
+          "pattern": "^recommendation\\.[a-f0-9]{16}$"
+        }
+      ]
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "acknowledged",
+        "accepted",
+        "deferred",
+        "rejected",
+        "resolved",
+        "waived"
+      ]
+    },
+    "observationMetrics": {
+      "anyOf": [
+        {
+          "type": "null"
+        },
+        {
+          "type": "object",
+          "additionalProperties": {
+            "anyOf": [
+              {
+                "type": "null"
+              },
+              {
+                "type": "number"
+              }
+            ]
+          }
+        }
+      ]
+    },
+    "reason": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 1024,
+      "pattern": "^\\S(?:[^\\u0000-\\u001f\\u007f]*\\S)?$"
+    },
+    "actor": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind",
+        "id"
+      ],
+      "properties": {
+        "kind": {
+          "type": "string",
+          "enum": [
+            "cli",
+            "daemon",
+            "developer",
+            "hook",
+            "mcp",
+            "migration",
+            "subagent",
+            "system"
+          ]
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128,
+          "pattern": "^\\S(?:[^\\u0000-\\u001f\\u007f]*\\S)?$"
+        }
+      }
+    },
+    "decidedAt": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,9})?(Z|[+-]\\d{2}:\\d{2})$"
+    },
+    "provenance": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "headSha",
+        "assessmentDigest",
+        "baselineSnapshotDigest"
+      ],
+      "properties": {
+        "headSha": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{40}$"
+        },
+        "assessmentDigest": {
+          "type": "string",
+          "pattern": "^sha256:[a-f0-9]{64}$"
+        },
+        "baselineSnapshotDigest": {
+          "type": "string",
+          "pattern": "^sha256:[a-f0-9]{64}$"
+        }
+      }
+    }
+  }
+}

package/schemas/runtime/archctx-capabilities.schema.json

@@ -31,7 +31,7 @@
       "additionalProperties": false,
       "required": ["architectureDocs", "agentContext"],
       "properties": {
-        "architectureDocs": { "const": "archcontext.docs-renderer/v5" },
+        "architectureDocs": { "const": "archcontext.docs-renderer/v6" },
         "agentContext": { "const": "archcontext.agent-context-renderer/v1" }
       }
     },
@@ -43,7 +43,7 @@
         "type": "string",
         "pattern": "^[a-z0-9]+(-[a-z0-9]+)*-v[0-9]+$",
         "description": "One feature flag: a lowercase kebab-case name that ends in a version suffix (-v1, -v2, ...). The pattern is open, so a validator built from this schema accepts flags that a later archctx adds. A consumer must ignore a flag it does not know. examples lists the flags this schema version knows.",
-        "examples": ["architecture-change-capabilities-v1", "architecture-docs-renderer-v2", "architecture-refresh-signal-v1", "capability-dependencies-v1", "changeset-entity-operations-v1", "changeset-ownership-delta-v1", "code-facts-unavailable-error-v1", "docs-anchors-v1", "flow-selector-check-v1", "module-statistics-v1", "projection-apply-readback-v1", "projection-apply-receipt-v1", "projection-apply-recovery-v1", "projection-apply-replay-v1", "projection-check-freshness-v1", "projection-manifest-contract-v2", "projection-observed-major-change-acceptance-v1", "projection-orphan-review-v1", "projection-preview-v1", "projection-prior-committed-applies-v1", "projection-protocol-v2", "recommendation-scan-decision-v1", "recommendation-v3", "refactor-assessment-v1", "refactor-observation-evidence-v1", "refactor-resolution-v1", "refactor-scan-limits-v1", "refactor-scan-untracked-count-v1"]
+        "examples": ["architecture-change-capabilities-v1", "architecture-debt-v1", "architecture-docs-renderer-v2", "architecture-refresh-signal-v1", "capability-dependencies-declared-v1", "capability-dependencies-v1", "changeset-entity-operations-v1", "changeset-ownership-delta-v1", "code-facts-unavailable-error-v1", "docs-anchors-v1", "flow-selector-check-v1", "module-statistics-v1", "native-context-export-v1", "projection-apply-readback-v1", "projection-apply-receipt-v1", "projection-apply-recovery-v1", "projection-apply-replay-restore-v1", "projection-apply-replay-v1", "projection-architecture-debt-v1", "projection-capability-isolation-v1", "projection-change-classification-v1", "projection-check-freshness-v1", "projection-freshness-v1", "projection-manifest-contract-v3", "projection-observed-major-change-acceptance-v1", "projection-orphan-review-v1", "projection-preview-v1", "projection-prior-committed-applies-v1", "projection-protocol-v2", "projection-snapshot-v1", "recommendation-scan-decision-v1", "recommendation-v3", "refactor-assessment-v1", "refactor-observation-evidence-v1", "refactor-resolution-v1", "refactor-scan-limits-v1", "refactor-scan-untracked-count-v1"]
       }
     }
   }