archctx-contracts 0.2.2 → 0.4.0

package/fixtures/boundary/architecture-node-extension.json

@@ -1,5 +1,5 @@
 {
-  "schemaVersion": "archcontext.node/v1",
+  "schemaVersion": "archcontext.node/v2",
   "id": "interface.payment-api",
   "kind": "interface",
   "name": "Payment API",

package/fixtures/boundary/explorer-projection-v2-budget.json

@@ -0,0 +1,87 @@
+{
+  "schemaVersion": "archcontext.explorer-projection/v2",
+  "view": { "id": "system-map", "title": "System Map", "question": "What exists?" },
+  "availableViews": [{ "id": "system-map", "enabled": true }],
+  "semanticLevel": "context",
+  "breadcrumbs": [],
+  "cursor": {
+    "repository": { "repositoryId": "repo.local", "storageRepositoryId": "repo.1111111111111111" },
+    "worktree": { "workspaceId": "workspace.local", "storageWorkspaceId": "ws.1111111111111111", "branch": "main", "headSha": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "worktreeDigest": "sha256:1111111111111111111111111111111111111111111111111111111111111111" },
+    "authoritySource": "git",
+    "authorityCursor": null,
+    "evidenceAuthorityCursor": null,
+    "inputManifestDigest": "sha256:9999999999999999999999999999999999999999999999999999999999999999",
+    "compatibilityDigest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+    "graphDigest": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
+    "evidenceStateDigest": "sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
+    "observedFactsDigest": "sha256:3333333333333333333333333333333333333333333333333333333333333333",
+    "viewDefinitionDigest": "sha256:4444444444444444444444444444444444444444444444444444444444444444",
+    "compilerVersion": "archcontext.explorer-view-compiler/v1",
+    "observedAvailability": { "status": "ready" }
+  },
+  "inputManifest": {
+    "schemaVersion": "archcontext.projection-input-manifest/v1",
+    "repository": { "repositoryId": "repo.local", "storageRepositoryId": "repo.1111111111111111" },
+    "worktree": { "workspaceId": "workspace.local", "storageWorkspaceId": "ws.1111111111111111", "branch": "main", "headSha": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "worktreeDigest": "sha256:1111111111111111111111111111111111111111111111111111111111111111" },
+    "authoritySource": "git",
+    "authorityCursor": null,
+    "evidenceAuthorityCursor": null,
+    "queryDigest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+    "graphDigest": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
+    "evidenceStateDigest": "sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
+    "observedFactsDigest": "sha256:3333333333333333333333333333333333333333333333333333333333333333",
+    "observedAvailability": { "status": "ready" },
+    "bindingsDigest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+    "eventBacklinksDigest": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+    "driftDigest": null,
+    "pressureDigest": null,
+    "taskSessionDigest": null,
+    "readPlan": {
+      "schemaVersion": "archcontext.projection-read-plan/v1",
+      "plannerVersion": "archcontext.projection-read-planner/v1",
+      "kind": "bounded-context",
+      "source": "git-authority",
+      "queryDigest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "semanticLevel": "context",
+      "focusSubjectId": null,
+      "expandedKinds": [],
+      "depth": 1,
+      "limits": { "maxEntities": 1, "maxRelations": 0, "maxConstraints": 2, "maxBindings": 4, "maxBacklinks": 8, "maxGraphRows": 3 },
+      "requiredDomains": ["authority", "bindings", "evidence", "graph", "observed"],
+      "ordering": "canonical-id-asc",
+      "truncation": "hard-limit-with-authoritative-totals",
+      "planDigest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
+    },
+    "readSet": {
+      "schemaVersion": "archcontext.projection-read-set/v1",
+      "planDigest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+      "selectedGraphDigest": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
+      "authoritativeTotals": { "entities": 10000, "relations": 9999, "constraints": 0 },
+      "entityKindTotals": [{ "kind": "module", "count": 10000 }],
+      "rowsRead": { "entities": 0, "relations": 0, "constraints": 0, "bindings": 0, "backlinks": 0 },
+      "truncated": true,
+      "readSetDigest": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc"
+    },
+    "inputDomains": {
+      "authority": { "requirement": "required", "status": "ready", "digest": "sha256:ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff" },
+      "graph": { "requirement": "required", "status": "ready", "digest": "sha256:2222222222222222222222222222222222222222222222222222222222222222" },
+      "evidence": { "requirement": "required", "status": "ready", "digest": "sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee" },
+      "observed": { "requirement": "required", "status": "ready", "digest": "sha256:3333333333333333333333333333333333333333333333333333333333333333" },
+      "bindings": { "requirement": "required", "status": "ready", "digest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb" },
+      "event-backlinks": { "requirement": "optional", "status": "ready", "digest": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc" },
+      "drift": { "requirement": "optional", "status": "unavailable", "digest": null, "reasonCode": "not-provided" },
+      "pressure": { "requirement": "optional", "status": "unavailable", "digest": null, "reasonCode": "not-provided" },
+      "task-session": { "requirement": "optional", "status": "unavailable", "digest": null, "reasonCode": "not-provided" }
+    },
+    "viewDefinitionDigest": "sha256:4444444444444444444444444444444444444444444444444444444444444444",
+    "compilerVersion": "archcontext.explorer-view-compiler/v1",
+    "tokenRequired": true,
+    "compatibilityDigest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+    "manifestDigest": "sha256:9999999999999999999999999999999999999999999999999999999999999999"
+  },
+  "occurrences": [],
+  "relations": [],
+  "page": { "budget": { "maxNodes": 1, "maxRelations": 0 }, "totalNodes": 10000, "totalRelations": 9999, "returnedNodes": 0, "returnedRelations": 0, "truncated": true, "omittedNodeCount": 10000, "omittedRelationCount": 9999 },
+  "projectionDigest": "sha256:5555555555555555555555555555555555555555555555555555555555555555",
+  "capabilities": { "readOnly": true, "mutationMode": "forbidden", "egress": "none", "tokenRequired": true }
+}

package/fixtures/invalid/architecture-snapshot-unknown-mode.json

@@ -1,5 +1,5 @@
 {
-  "schemaVersion": "archcontext.architecture-snapshot/v1",
+  "schemaVersion": "archcontext.architecture-snapshot/v2",
   "snapshotId": "arch_snapshot.invalid_mode",
   "repository": {
     "repositoryId": "repo.archcontext",
@@ -14,14 +14,32 @@
   },
   "sourceMode": "sql-only",
   "eventCursor": {
+    "eventCount": 1,
+    "lastEventSequence": 1,
     "lastEventId": "arch_event.al0_contract_freeze",
     "lastEventHash": "sha256:5555555555555555555555555555555555555555555555555555555555555555"
   },
   "graphDigest": "sha256:6666666666666666666666666666666666666666666666666666666666666666",
+  "evidenceDigest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+  "stateDigest": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+  "state": {
+    "graph": {
+      "entities": [],
+      "relations": [],
+      "constraints": []
+    },
+    "evidence": {
+      "schemaVersion": "archcontext.evidence-state-at-cursor/v1",
+      "evidenceItems": [],
+      "evidenceBindings": [],
+      "tombstones": [],
+      "stateDigest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
+    }
+  },
   "projectionDigest": "sha256:7777777777777777777777777777777777777777777777777777777777777777",
-  "entityCount": 12,
-  "relationCount": 8,
-  "constraintCount": 4,
+  "entityCount": 0,
+  "relationCount": 0,
+  "constraintCount": 0,
   "inputDigests": {
     "modelDigest": "sha256:8888888888888888888888888888888888888888888888888888888888888888"
   },

package/fixtures/invalid/explorer-projection-query-v2-caller-scope.json

@@ -0,0 +1,7 @@
+{
+  "schemaVersion": "archcontext.explorer-projection-query/v2",
+  "viewId": "system-map",
+  "repositoryId": "caller-controlled",
+  "depth": 1,
+  "budget": { "maxNodes": 80, "maxRelations": 160 }
+}

package/fixtures/invalid/explorer-projection-v2-derived-subject.json

@@ -0,0 +1,101 @@
+{
+  "schemaVersion": "archcontext.explorer-projection/v2",
+  "view": { "id": "system-map", "title": "System Map", "question": "What exists?" },
+  "availableViews": [{ "id": "system-map", "enabled": true }],
+  "semanticLevel": "overview",
+  "breadcrumbs": [],
+  "cursor": {
+    "repository": { "repositoryId": "repo.local", "storageRepositoryId": "repo.1111111111111111" },
+    "worktree": { "workspaceId": "workspace.local", "storageWorkspaceId": "ws.1111111111111111", "branch": "main", "headSha": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "worktreeDigest": "sha256:1111111111111111111111111111111111111111111111111111111111111111" },
+    "authoritySource": "git",
+    "authorityCursor": null,
+    "evidenceAuthorityCursor": null,
+    "inputManifestDigest": "sha256:9999999999999999999999999999999999999999999999999999999999999999",
+    "compatibilityDigest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+    "graphDigest": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
+    "evidenceStateDigest": "sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
+    "observedFactsDigest": "sha256:3333333333333333333333333333333333333333333333333333333333333333",
+    "viewDefinitionDigest": "sha256:4444444444444444444444444444444444444444444444444444444444444444",
+    "compilerVersion": "archcontext.explorer-view-compiler/v1",
+    "observedAvailability": { "status": "ready" }
+  },
+  "inputManifest": {
+    "schemaVersion": "archcontext.projection-input-manifest/v1",
+    "repository": { "repositoryId": "repo.local", "storageRepositoryId": "repo.1111111111111111" },
+    "worktree": { "workspaceId": "workspace.local", "storageWorkspaceId": "ws.1111111111111111", "branch": "main", "headSha": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "worktreeDigest": "sha256:1111111111111111111111111111111111111111111111111111111111111111" },
+    "authoritySource": "git",
+    "authorityCursor": null,
+    "evidenceAuthorityCursor": null,
+    "queryDigest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+    "graphDigest": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
+    "evidenceStateDigest": "sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
+    "observedFactsDigest": "sha256:3333333333333333333333333333333333333333333333333333333333333333",
+    "observedAvailability": { "status": "ready" },
+    "bindingsDigest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+    "eventBacklinksDigest": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+    "driftDigest": null,
+    "pressureDigest": null,
+    "taskSessionDigest": null,
+    "readPlan": {
+      "schemaVersion": "archcontext.projection-read-plan/v1",
+      "plannerVersion": "archcontext.projection-read-planner/v1",
+      "kind": "bounded-context",
+      "source": "git-authority",
+      "queryDigest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "semanticLevel": "context",
+      "focusSubjectId": null,
+      "expandedKinds": [],
+      "depth": 1,
+      "limits": { "maxEntities": 80, "maxRelations": 160, "maxConstraints": 160, "maxBindings": 320, "maxBacklinks": 640, "maxGraphRows": 400 },
+      "requiredDomains": ["authority", "bindings", "evidence", "graph", "observed"],
+      "ordering": "canonical-id-asc",
+      "truncation": "hard-limit-with-authoritative-totals",
+      "planDigest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
+    },
+    "readSet": {
+      "schemaVersion": "archcontext.projection-read-set/v1",
+      "planDigest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+      "selectedGraphDigest": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
+      "authoritativeTotals": { "entities": 1, "relations": 0, "constraints": 0 },
+      "entityKindTotals": [{ "kind": "module", "count": 1 }],
+      "rowsRead": { "entities": 1, "relations": 0, "constraints": 0, "bindings": 0, "backlinks": 0 },
+      "truncated": false,
+      "readSetDigest": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc"
+    },
+    "inputDomains": {
+      "authority": { "requirement": "required", "status": "ready", "digest": "sha256:ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff" },
+      "graph": { "requirement": "required", "status": "ready", "digest": "sha256:2222222222222222222222222222222222222222222222222222222222222222" },
+      "evidence": { "requirement": "required", "status": "ready", "digest": "sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee" },
+      "observed": { "requirement": "required", "status": "ready", "digest": "sha256:3333333333333333333333333333333333333333333333333333333333333333" },
+      "bindings": { "requirement": "required", "status": "ready", "digest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb" },
+      "event-backlinks": { "requirement": "optional", "status": "ready", "digest": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc" },
+      "drift": { "requirement": "optional", "status": "unavailable", "digest": null, "reasonCode": "not-provided" },
+      "pressure": { "requirement": "optional", "status": "unavailable", "digest": null, "reasonCode": "not-provided" },
+      "task-session": { "requirement": "optional", "status": "unavailable", "digest": null, "reasonCode": "not-provided" }
+    },
+    "viewDefinitionDigest": "sha256:4444444444444444444444444444444444444444444444444444444444444444",
+    "compilerVersion": "archcontext.explorer-view-compiler/v1",
+    "tokenRequired": true,
+    "compatibilityDigest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+    "manifestDigest": "sha256:9999999999999999999999999999999999999999999999999999999999999999"
+  },
+  "occurrences": [{
+    "occurrenceId": "occurrence.system-map.group.fake",
+    "role": "derived-group",
+    "subjectRefs": [{ "kind": "architecture-entity", "id": "fake" }],
+    "name": "Fake",
+    "kind": "group",
+    "childrenCount": 0,
+    "expandable": false,
+    "verificationStatus": "UNKNOWN",
+    "authorityState": "DERIVED",
+    "pressure": { "evaluated": false, "signals": [] },
+    "sourceSelectors": [],
+    "provenance": { "declaredEntityIds": [], "observedSymbolIds": [], "evidenceBindingIds": [] },
+    "derivation": { "ruleId": "fake", "inputDigest": "sha256:x", "compilerVersion": "archcontext.explorer-view-compiler/v1" }
+  }],
+  "relations": [],
+  "page": { "budget": { "maxNodes": 1, "maxRelations": 0 }, "totalNodes": 1, "totalRelations": 0, "returnedNodes": 1, "returnedRelations": 0, "truncated": false, "omittedNodeCount": 0, "omittedRelationCount": 0 },
+  "projectionDigest": "sha256:5555555555555555555555555555555555555555555555555555555555555555",
+  "capabilities": { "readOnly": true, "mutationMode": "forbidden", "egress": "none", "tokenRequired": true }
+}

package/fixtures/invalid/node-unknown-field.json

@@ -1,5 +1,5 @@
 {
-  "schemaVersion": "archcontext.node/v1",
+  "schemaVersion": "archcontext.node/v2",
   "id": "module.subscription",
   "kind": "module",
   "name": "Subscription",

package/fixtures/valid/archctx-capabilities.json

@@ -0,0 +1,14 @@
+{
+  "schemaVersion": "archcontext.capabilities/v1",
+  "package": { "name": "archctx", "version": "0.4.0" },
+  "protocols": {
+    "projectionRequest": "archcontext.projection-request/v1",
+    "projectionResult": "archcontext.projection-result/v1",
+    "architectureRefreshSignal": "archcontext.architecture-refresh-signal/v1"
+  },
+  "renderers": {
+    "architectureDocs": "archcontext.docs-renderer/v2",
+    "agentContext": "archcontext.agent-context-renderer/v1"
+  },
+  "features": ["architecture-docs-renderer-v2", "architecture-refresh-signal-v1", "projection-protocol-v1"]
+}

package/fixtures/valid/architecture-flow.json

@@ -0,0 +1,53 @@
+{
+  "schemaVersion": "archcontext.flow/v1",
+  "id": "flow.subscriptions.create",
+  "capabilityId": "capability.subscriptions",
+  "name": "Create subscription",
+  "applicability": "required",
+  "participants": [
+    { "id": "client", "nodeId": "external.client" },
+    { "id": "api", "nodeId": "module.subscription" },
+    { "id": "store", "nodeId": "datastore.subscription" }
+  ],
+  "steps": [
+    {
+      "id": "request",
+      "from": "client",
+      "to": "api",
+      "label": "Create subscription",
+      "evidence": { "entrypointId": "entrypoint.subscription.create", "sourceSymbol": "createSubscription", "sinkId": "sink.subscription.persist" }
+    }
+  ],
+  "outcomes": [
+    {
+      "id": "accepted",
+      "kind": "success",
+      "label": "Subscription accepted",
+      "steps": [
+        {
+          "id": "persist",
+          "from": "api",
+          "to": "store",
+          "label": "Persist subscription",
+          "evidence": { "entrypointId": "entrypoint.subscription.create", "sourceSymbol": "createSubscription", "sinkId": "sink.subscription.persist" }
+        }
+      ],
+      "terminal": { "participant": "api", "label": "Return subscription ID" }
+    },
+    {
+      "id": "rejected",
+      "kind": "error",
+      "label": "Subscription rejected",
+      "steps": [
+        {
+          "id": "reject",
+          "from": "api",
+          "to": "client",
+          "label": "Return validation error",
+          "evidence": { "entrypointId": "entrypoint.subscription.create", "sourceSymbol": "createSubscription", "sinkId": "sink.subscription.persist" }
+        }
+      ],
+      "terminal": { "participant": "client", "label": "Handle validation error" }
+    }
+  ]
+}

package/fixtures/valid/architecture-node.json

@@ -1,5 +1,5 @@
 {
-  "schemaVersion": "archcontext.node/v1",
+  "schemaVersion": "archcontext.node/v2",
   "id": "module.subscription",
   "kind": "module",
   "name": "Subscription",
@@ -10,7 +10,24 @@
   "source": {
     "include": ["src/subscription/**"],
     "exclude": ["src/subscription/generated/**"],
-    "entrypoints": ["src/subscription/index.ts"]
+    "entrypoints": [
+      {
+        "id": "entrypoint.subscription.create",
+        "path": "src/subscription/index.ts",
+        "symbols": [
+          {
+            "name": "createSubscription",
+            "sinks": [
+              {
+                "id": "sink.subscription.persist",
+                "path": "src/subscription/store.ts",
+                "symbol": "saveSubscription"
+              }
+            ]
+          }
+        ]
+      }
+    ]
   },
   "ownership": {
     "lifecycle": ["subscription"],

package/fixtures/valid/architecture-refresh-signal.json

@@ -0,0 +1,35 @@
+{
+  "schemaVersion": "archcontext.architecture-refresh-signal/v1",
+  "signalId": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
+  "idempotencyKey": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
+  "mode": "refresh-required",
+  "repository": { "repositoryId": "repo.example" },
+  "worktree": {
+    "workspaceId": "ws.example",
+    "headSha": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+    "worktreeDigest": "sha256:3333333333333333333333333333333333333333333333333333333333333333"
+  },
+  "cause": "accepted-semantic-delta",
+  "acceptedChange": {
+    "changeSetId": "changeset.architecture-api-v2",
+    "eventId": "architecture_event.changeset_apply.api-v2",
+    "reasonCodes": ["entrypoint-changed", "responsibility-changed"],
+    "affectedNodeIds": ["capability.api", "capability.runtime"]
+  },
+  "reasonCodes": ["entrypoint-changed", "responsibility-changed"],
+  "affectedNodeIds": ["capability.api", "capability.runtime"],
+  "refreshTargets": ["architecture-contract-context", "architecture-readiness", "capability-context", "capability-index"],
+  "baseDigests": {
+    "modelDigest": "sha256:4444444444444444444444444444444444444444444444444444444444444444",
+    "sourceTreeDigest": "sha256:5555555555555555555555555555555555555555555555555555555555555555",
+    "flowProofDigest": "sha256:6666666666666666666666666666666666666666666666666666666666666666",
+    "projectionDigest": "sha256:7777777777777777777777777777777777777777777777777777777777777777"
+  },
+  "resultingDigests": {
+    "modelDigest": "sha256:8888888888888888888888888888888888888888888888888888888888888888",
+    "sourceTreeDigest": "sha256:9999999999999999999999999999999999999999999999999999999999999999",
+    "flowProofDigest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+    "projectionDigest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
+  },
+  "projectionReceiptDigest": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc"
+}

package/fixtures/valid/architecture-snapshot.json

@@ -1,5 +1,5 @@
 {
-  "schemaVersion": "archcontext.architecture-snapshot/v1",
+  "schemaVersion": "archcontext.architecture-snapshot/v2",
   "snapshotId": "arch_snapshot.al0_contract_freeze",
   "repository": {
     "repositoryId": "repo.archcontext",
@@ -14,14 +14,32 @@
   },
   "sourceMode": "dual",
   "eventCursor": {
+    "eventCount": 1,
+    "lastEventSequence": 1,
     "lastEventId": "arch_event.al0_contract_freeze",
     "lastEventHash": "sha256:5555555555555555555555555555555555555555555555555555555555555555"
   },
   "graphDigest": "sha256:6666666666666666666666666666666666666666666666666666666666666666",
+  "evidenceDigest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+  "stateDigest": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+  "state": {
+    "graph": {
+      "entities": [],
+      "relations": [],
+      "constraints": []
+    },
+    "evidence": {
+      "schemaVersion": "archcontext.evidence-state-at-cursor/v1",
+      "evidenceItems": [],
+      "evidenceBindings": [],
+      "tombstones": [],
+      "stateDigest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
+    }
+  },
   "projectionDigest": "sha256:7777777777777777777777777777777777777777777777777777777777777777",
-  "entityCount": 12,
-  "relationCount": 8,
-  "constraintCount": 4,
+  "entityCount": 0,
+  "relationCount": 0,
+  "constraintCount": 0,
   "inputDigests": {
     "modelDigest": "sha256:8888888888888888888888888888888888888888888888888888888888888888",
     "codeFactsDigest": "sha256:9999999999999999999999999999999999999999999999999999999999999999",

package/fixtures/valid/explorer-delta-query.json

@@ -0,0 +1,11 @@
+{
+  "schemaVersion": "archcontext.explorer-delta-query/v2",
+  "base": {
+    "eventId": "arch_event.base",
+    "projectionDigest": "sha256:1111111111111111111111111111111111111111111111111111111111111111"
+  },
+  "head": {
+    "eventId": "arch_event.head",
+    "projectionDigest": "sha256:2222222222222222222222222222222222222222222222222222222222222222"
+  }
+}

package/fixtures/valid/explorer-projection-delta.json

@@ -0,0 +1,32 @@
+{
+  "schemaVersion": "archcontext.explorer-projection-delta/v2",
+  "base": {
+    "schemaVersion": "archcontext.authority-cursor/v1",
+    "repository": { "repositoryId": "repo.local", "storageRepositoryId": "repo.storage" },
+    "worktree": { "workspaceId": "ws.local", "storageWorkspaceId": "ws.storage", "branch": "main", "headSha": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "worktreeDigest": "sha256:1111111111111111111111111111111111111111111111111111111111111111" },
+    "eventSequence": 1,
+    "eventId": "arch_event.base",
+    "eventHash": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
+    "graphDigest": "sha256:3333333333333333333333333333333333333333333333333333333333333333",
+    "evidenceStateDigest": "sha256:4444444444444444444444444444444444444444444444444444444444444444",
+    "projectionDigest": "sha256:5555555555555555555555555555555555555555555555555555555555555555",
+    "inputManifestDigest": "sha256:6666666666666666666666666666666666666666666666666666666666666666"
+  },
+  "head": {
+    "schemaVersion": "archcontext.authority-cursor/v1",
+    "repository": { "repositoryId": "repo.local", "storageRepositoryId": "repo.storage" },
+    "worktree": { "workspaceId": "ws.local", "storageWorkspaceId": "ws.storage", "branch": "main", "headSha": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb", "worktreeDigest": "sha256:7777777777777777777777777777777777777777777777777777777777777777" },
+    "eventSequence": 2,
+    "eventId": "arch_event.head",
+    "eventHash": "sha256:8888888888888888888888888888888888888888888888888888888888888888",
+    "graphDigest": "sha256:9999999999999999999999999999999999999999999999999999999999999999",
+    "evidenceStateDigest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+    "projectionDigest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+    "inputManifestDigest": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc"
+  },
+  "factChanges": [{ "deltaClass": "architecture-fact", "subjectId": "entity:module.api", "change": "added", "fields": ["entity"] }],
+  "evidenceChanges": [],
+  "projectionChanges": [],
+  "counts": { "architecture-fact": 1, "evidence": 0, "projection": 0 },
+  "deltaDigest": "sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd"
+}

package/fixtures/valid/explorer-projection-query-v2.json

@@ -0,0 +1,6 @@
+{
+  "schemaVersion": "archcontext.explorer-projection-query/v2",
+  "viewId": "system-map",
+  "depth": 1,
+  "budget": { "maxNodes": 80, "maxRelations": 160 }
+}