archctx 0.1.3 → 0.1.4

package/schemas/runtime/evidence-binding.schema.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archcontext.dev/schemas/runtime/evidence-binding.schema.json",
+  "title": "EvidenceBinding",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "bindingId", "evidenceId", "target", "bindingReason", "authorityEffect", "createdAt", "provenance"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.evidence-binding/v1" },
+    "bindingId": { "type": "string", "pattern": "^binding\\.[a-zA-Z0-9_.-]+$" },
+    "evidenceId": { "type": "string", "pattern": "^evidence\\.[a-zA-Z0-9_.-]+$" },
+    "target": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "id"],
+      "properties": {
+        "kind": { "enum": ["entity", "relation", "constraint", "recommendation", "practice", "event", "snapshot", "subject", "candidate-delta"] },
+        "id": { "type": "string" }
+      }
+    },
+    "bindingReason": { "enum": ["direct-selector", "predicate-subject", "change-cursor", "human-attestation", "deterministic-check", "subagent-proposal"] },
+    "authorityEffect": { "enum": ["context-only", "ranking", "checkpoint-eligible", "complete-eligible"] },
+    "createdAt": { "type": "string" },
+    "provenance": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["producer", "command", "inputDigest"],
+      "properties": {
+        "producer": { "type": "string" },
+        "command": { "type": "string" },
+        "inputDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "traceDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+      }
+    },
+    "extensions": { "type": "object", "additionalProperties": true }
+  }
+}

package/schemas/runtime/evidence-item.schema.json

@@ -0,0 +1,58 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archcontext.dev/schemas/runtime/evidence-item.schema.json",
+  "title": "EvidenceItem",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "evidenceId", "kind", "strength", "polarity", "origin", "subject", "selector", "summary", "coverage", "supports", "provenance", "createdAt", "digest"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.evidence-item/v2" },
+    "evidenceId": { "type": "string", "pattern": "^evidence\\.[a-zA-Z0-9_.-]+$" },
+    "kind": { "type": "string" },
+    "strength": { "enum": ["heuristic", "declared", "observed", "verified"] },
+    "polarity": { "enum": ["positive", "absence", "declaration"] },
+    "origin": { "enum": ["codegraph", "model-store-yaml", "checkpoint", "runtime-daemon", "user", "subagent", "external-doc"] },
+    "subject": { "type": "string" },
+    "selector": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "id"],
+      "properties": {
+        "kind": { "enum": ["repository", "path", "symbol", "relation", "constraint", "practice", "event", "snapshot"] },
+        "id": { "type": "string" },
+        "path": { "type": "string" },
+        "symbolId": { "type": "string" },
+        "startLine": { "type": "integer", "minimum": 1 },
+        "endLine": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "summary": { "type": "string" },
+    "coverage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["level", "scope"],
+      "properties": {
+        "level": { "enum": ["complete", "partial", "unknown"] },
+        "scope": { "type": "string" }
+      }
+    },
+    "supports": {
+      "type": "array",
+      "items": { "enum": ["recommendation", "checkpoint", "complete"] }
+    },
+    "provenance": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["producer", "command", "inputDigest"],
+      "properties": {
+        "producer": { "type": "string" },
+        "command": { "type": "string" },
+        "inputDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "traceDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+      }
+    },
+    "createdAt": { "type": "string" },
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "extensions": { "type": "object", "additionalProperties": true }
+  }
+}

package/schemas/runtime/explorer-projection.schema.json

@@ -0,0 +1,92 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/runtime/explorer-projection.schema.json",
+  "title": "ExplorerProjection",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "generatedAt", "repository", "nodes", "relations", "verification", "pressure", "interventions", "capabilities"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.explorer-projection/v1" },
+    "generatedAt": { "type": "string" },
+    "repository": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["repositoryId", "headSha", "worktreeDigest"],
+      "properties": {
+        "repositoryId": { "type": "string" },
+        "headSha": { "type": "string" },
+        "worktreeDigest": { "type": "string" },
+        "modelDigest": { "type": "string" }
+      }
+    },
+    "nodes": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "name", "kind", "verificationStatus", "pressure", "sourceSelectors"],
+        "properties": {
+          "id": { "type": "string" },
+          "name": { "type": "string" },
+          "kind": { "type": "string" },
+          "repositoryId": { "type": "string" },
+          "verificationStatus": { "type": "string", "enum": ["MATCHED", "DRIFT", "UNKNOWN", "VERIFIED"] },
+          "pressure": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["level", "score", "signals"],
+            "properties": {
+              "level": { "type": "string", "enum": ["low", "medium", "high"] },
+              "score": { "type": "number", "minimum": 0, "maximum": 100 },
+              "signals": { "type": "array", "items": { "type": "string" } }
+            }
+          },
+          "sourceSelectors": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["path"],
+              "properties": {
+                "path": { "type": "string" },
+                "symbolId": { "type": "string" },
+                "startLine": { "type": "integer", "minimum": 1 },
+                "endLine": { "type": "integer", "minimum": 1 }
+              }
+            }
+          }
+        }
+      }
+    },
+    "relations": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "source", "target", "kind", "verificationStatus"],
+        "properties": {
+          "id": { "type": "string" },
+          "source": { "type": "string" },
+          "target": { "type": "string" },
+          "kind": { "type": "string" },
+          "verificationStatus": { "type": "string", "enum": ["MATCHED", "DRIFT", "UNKNOWN", "VERIFIED"] }
+        }
+      }
+    },
+    "landscape": { "type": "object", "additionalProperties": true },
+    "verification": { "type": "array", "items": { "type": "object", "additionalProperties": true } },
+    "pressure": { "type": "array", "items": { "type": "object", "additionalProperties": true } },
+    "interventions": { "type": "array", "items": { "type": "object", "additionalProperties": true } },
+    "capabilities": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["readOnly", "mutationMode", "egress", "tokenRequired"],
+      "properties": {
+        "readOnly": { "const": true },
+        "mutationMode": { "type": "string", "enum": ["forbidden"] },
+        "egress": { "type": "string", "enum": ["none"] },
+        "tokenRequired": { "type": "boolean" }
+      }
+    }
+  }
+}

package/schemas/runtime/explorer-service.schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/runtime/explorer-service.schema.json",
+  "title": "ExplorerServiceContract",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "bindHost", "protocol", "optIn", "defaultEnabled", "tokenTtlSeconds", "readOnly", "allowedMethods", "egress"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.explorer-service/v1" },
+    "bindHost": { "const": "127.0.0.1" },
+    "protocol": { "const": "http-loopback" },
+    "optIn": { "const": true },
+    "defaultEnabled": { "const": false },
+    "tokenTtlSeconds": { "type": "integer", "minimum": 1 },
+    "readOnly": { "const": true },
+    "allowedMethods": { "type": "array", "items": { "type": "string", "enum": ["GET"] } },
+    "egress": { "type": "string", "enum": ["none"] }
+  }
+}

package/schemas/runtime/external-document-resource.schema.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archcontext.dev/schemas/runtime/external-document-resource.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "provider",
+    "libraryId",
+    "queryDigest",
+    "contentDigest",
+    "retrievedAt",
+    "expiresAt",
+    "trust",
+    "enforcement",
+    "cacheStatus",
+    "uri",
+    "byteCount",
+    "snippets",
+    "warning"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.external-document/v1" },
+    "provider": { "const": "context7" },
+    "libraryId": { "type": "string", "pattern": "^/[A-Za-z0-9._-]+/[A-Za-z0-9._/@-]+$" },
+    "requestedVersion": { "type": "string", "minLength": 1 },
+    "resolvedVersion": { "type": "string", "minLength": 1 },
+    "queryDigest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "contentDigest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+    "retrievedAt": { "type": "string" },
+    "expiresAt": { "type": "string" },
+    "trust": { "const": "external-unverified" },
+    "enforcement": { "const": "advisory-only" },
+    "cacheStatus": { "enum": ["fresh", "stale", "miss"] },
+    "uri": { "type": "string", "pattern": "^archcontext://external-docs/context7/sha256:[0-9a-f]{64}$" },
+    "byteCount": { "type": "integer", "minimum": 0 },
+    "snippets": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["title", "contentPreview", "contentDigest", "sourceUri", "byteCount"],
+        "properties": {
+          "title": { "type": "string", "minLength": 1 },
+          "contentPreview": { "type": "string", "maxLength": 4000 },
+          "contentDigest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" },
+          "sourceUri": { "type": "string", "pattern": "^https://.+" },
+          "byteCount": { "type": "integer", "minimum": 0 }
+        }
+      }
+    },
+    "warning": { "const": "untrusted-documentation-data" },
+    "metadata": { "type": "object", "additionalProperties": true }
+  }
+}

package/schemas/runtime/investigation-report.schema.json

@@ -0,0 +1,119 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archcontext.dev/schemas/runtime/investigation-report.schema.json",
+  "title": "InvestigationReport",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "reportId", "jobId", "status", "findings", "outputDigest", "createdAt", "directMutationAllowed"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.investigation-report/v1" },
+    "reportId": { "type": "string", "pattern": "^investigation_report\\.[a-zA-Z0-9_-]+$" },
+    "jobId": { "type": "string", "pattern": "^agent_job\\.[a-zA-Z0-9_-]+$" },
+    "status": { "enum": ["succeeded", "failed", "partial"] },
+    "findings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["findingId", "hypothesis", "evidenceBindingIds", "unknowns", "falsifier", "proposedDelta", "proposedDeltaDigest", "confidence"],
+        "properties": {
+          "findingId": { "type": "string" },
+          "hypothesis": { "type": "string" },
+          "evidenceBindingIds": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "type": "string", "pattern": "^binding\\.[a-zA-Z0-9_.-]+$" }
+          },
+          "unknowns": { "type": "array", "items": { "type": "string" } },
+          "falsifier": { "type": "string" },
+          "proposedDelta": { "$ref": "#/$defs/architectureCandidateChange" },
+          "proposedDeltaDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+          "confidence": { "enum": ["low", "medium", "high"] }
+        }
+      }
+    },
+    "outputDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "createdAt": { "type": "string" },
+    "directMutationAllowed": { "const": false },
+    "extensions": { "type": "object", "additionalProperties": true }
+  },
+  "$defs": {
+    "architectureCandidateChange": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "candidateChangeId",
+        "kind",
+        "target",
+        "stateDimension",
+        "changeKind",
+        "subjectSelectorIds",
+        "mappingIds",
+        "ambiguityIds",
+        "evidenceIds",
+        "confidence",
+        "heuristic",
+        "summary",
+        "digest"
+      ],
+      "properties": {
+        "candidateChangeId": { "type": "string", "pattern": "^candidate_change\\.[a-zA-Z0-9_.-]+$" },
+        "kind": {
+          "enum": [
+            "node-added",
+            "node-removed",
+            "node-moved",
+            "node-renamed",
+            "node-materially-changed",
+            "relation-added",
+            "relation-removed",
+            "relation-moved",
+            "relation-renamed",
+            "relation-materially-changed",
+            "constraint-added",
+            "constraint-removed",
+            "constraint-moved",
+            "constraint-renamed",
+            "constraint-materially-changed",
+            "owner-added",
+            "owner-removed",
+            "owner-moved",
+            "owner-renamed",
+            "owner-materially-changed",
+            "lifecycle-added",
+            "lifecycle-removed",
+            "lifecycle-moved",
+            "lifecycle-renamed",
+            "lifecycle-materially-changed",
+            "migration-state-added",
+            "migration-state-removed",
+            "migration-state-moved",
+            "migration-state-renamed",
+            "migration-state-materially-changed"
+          ]
+        },
+        "target": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind", "id"],
+          "properties": {
+            "kind": { "enum": ["node", "relation", "constraint", "owner", "lifecycle", "migration-state"] },
+            "id": { "type": "string" },
+            "parentId": { "type": "string" }
+          }
+        },
+        "stateDimension": { "enum": ["target-state", "migration-state"] },
+        "changeKind": { "enum": ["added", "removed", "moved", "renamed", "materially_changed"] },
+        "subjectSelectorIds": { "type": "array", "items": { "type": "string" } },
+        "mappingIds": { "type": "array", "items": { "type": "string" } },
+        "ambiguityIds": { "type": "array", "items": { "type": "string" } },
+        "evidenceIds": { "type": "array", "items": { "type": "string" } },
+        "confidence": { "enum": ["low", "medium", "high"] },
+        "heuristic": { "const": true },
+        "summary": { "type": "string" },
+        "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "extensions": { "type": "object", "additionalProperties": true }
+      }
+    }
+  }
+}

package/schemas/runtime/notification-event.schema.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/runtime/notification-event.schema.json",
+  "title": "NotificationEvent",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "eventId", "prUrl", "result", "riskLevel", "commitSha", "runtimeVersion", "occurredAt"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.notification-event/v1" },
+    "eventId": { "type": "string", "pattern": "^notification\\.[a-z0-9][a-z0-9-]*$" },
+    "prUrl": { "type": "string", "pattern": "^https://github\\.com/[^/]+/[^/]+/pull/[0-9]+$" },
+    "result": { "type": "string", "enum": ["pass", "pass_with_warnings", "fail_action_required"] },
+    "riskLevel": { "type": "string", "enum": ["low", "medium", "high", "critical"] },
+    "commitSha": { "type": "string", "pattern": "^[a-f0-9]{7,40}$" },
+    "runtimeVersion": { "type": "string" },
+    "occurredAt": { "type": "string" }
+  }
+}

package/schemas/runtime/notification-provider.schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/runtime/notification-provider.schema.json",
+  "title": "NotificationProviderConfig",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "provider", "enabled", "target", "retry"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.notification-provider/v1" },
+    "id": { "type": "string", "pattern": "^notification-provider\\.[a-z0-9][a-z0-9-]*$" },
+    "provider": { "type": "string", "enum": ["github-check", "slack", "webhook", "email"] },
+    "enabled": { "type": "boolean" },
+    "target": { "type": "string" },
+    "secretRef": { "type": "string", "pattern": "^(env|secret|keychain)://[A-Za-z0-9_.:/-]+$" },
+    "unsubscribeUrl": { "type": "string" },
+    "retry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["maxAttempts", "backoffSeconds"],
+      "properties": {
+        "maxAttempts": { "type": "integer", "minimum": 1, "maximum": 10 },
+        "backoffSeconds": { "type": "integer", "minimum": 1, "maximum": 3600 }
+      }
+    }
+  }
+}

package/schemas/runtime/practice-catalog-manifest.schema.json

@@ -0,0 +1,22 @@
+{
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "catalogVersion",
+    "productVersion",
+    "generatedAt",
+    "entries",
+    "sourceIds",
+    "catalogDigest"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.practice-catalog-manifest/v1" },
+    "catalogVersion": { "type": "string" },
+    "productVersion": { "type": "string" },
+    "generatedAt": { "type": "string" },
+    "entries": { "type": "array", "items": { "type": "object" } },
+    "sourceIds": { "type": "array", "items": { "type": "string" } },
+    "catalogDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+  },
+  "additionalProperties": false
+}

package/schemas/runtime/practice-check-result.schema.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/runtime/practice-check-result.schema.json",
+  "title": "PracticeCheckResult",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "practiceId", "checkId", "assetDigest", "enforcement", "status", "reasonCode", "deterministic", "subjects", "subjectDigests", "message", "remediation"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.practice-check-result/v1" },
+    "practiceId": { "type": "string", "pattern": "^[a-z][a-z0-9-]*(\\.[a-z][a-z0-9-]*)+$" },
+    "checkId": { "type": "string" },
+    "assetDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "enforcement": { "type": "string", "enum": ["advisory", "checkpoint", "complete"] },
+    "status": { "type": "string", "enum": ["pass", "fail", "waived", "not_applicable"] },
+    "reasonCode": {
+      "type": "string",
+      "enum": ["policy-disabled", "not-opted-in", "not-registered", "fixture-gate-missing", "heuristic-only", "no-baseline", "no-violation", "violation", "waived", "invalid-waiver"]
+    },
+    "deterministic": { "const": true },
+    "subjects": { "type": "array", "items": { "type": "string" } },
+    "subjectDigests": { "type": "array", "items": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } },
+    "message": { "type": "string" },
+    "remediation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["action", "paths"],
+      "properties": {
+        "action": { "type": "string" },
+        "paths": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "waiver": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["waiverDigest", "practiceId", "owner", "expiresAt"],
+      "properties": {
+        "waiverDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "practiceId": { "type": "string" },
+        "checkId": { "type": "string" },
+        "owner": { "type": "string" },
+        "expiresAt": { "type": "string" }
+      }
+    }
+  }
+}

package/schemas/runtime/practice-checkpoint.schema.json

@@ -0,0 +1,127 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/runtime/practice-checkpoint.schema.json",
+  "title": "PracticeCheckpoint",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "taskSessionId",
+    "event",
+    "headSha",
+    "worktreeDigest",
+    "fresh",
+    "reasonCode",
+    "staleReasons",
+    "changedPaths",
+    "catalogDigest",
+    "contextDigest",
+    "practiceGuidanceDigest",
+    "delta",
+    "noOpDigest",
+    "resultDigest",
+    "hook",
+    "nextSnapshot"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.practice-checkpoint/v1" },
+    "taskSessionId": { "type": "string", "minLength": 1 },
+    "event": { "enum": ["manual", "post-edit", "post-write", "pre-complete"] },
+    "headSha": { "type": "string", "minLength": 1 },
+    "expectedHeadSha": { "type": "string", "minLength": 1 },
+    "worktreeDigest": { "type": "string", "pattern": "^sha256:" },
+    "expectedWorktreeDigest": { "type": "string", "pattern": "^sha256:" },
+    "fresh": { "type": "boolean" },
+    "reasonCode": { "enum": ["fresh", "stale-head", "stale-worktree", "stale-catalog", "no-baseline", "no-op"] },
+    "staleReasons": {
+      "type": "array",
+      "items": { "enum": ["fresh", "stale-head", "stale-worktree", "stale-catalog", "no-baseline", "no-op"] }
+    },
+    "changedPaths": { "type": "array", "items": { "type": "string" } },
+    "toolCallId": { "type": "string" },
+    "catalogDigest": { "type": "string", "pattern": "^sha256:" },
+    "previousCatalogDigest": { "type": "string", "pattern": "^sha256:" },
+    "contextDigest": { "type": "string", "pattern": "^sha256:" },
+    "previousContextDigest": { "type": "string", "pattern": "^sha256:" },
+    "practiceGuidanceDigest": { "type": "string", "pattern": "^sha256:" },
+    "previousPracticeGuidanceDigest": { "type": "string", "pattern": "^sha256:" },
+    "delta": { "$ref": "#/$defs/delta" },
+    "noOpDigest": { "type": "string", "pattern": "^sha256:" },
+    "resultDigest": { "type": "string", "pattern": "^sha256:" },
+    "hook": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["egress", "failOpen", "pathCount", "network"],
+      "properties": {
+        "egress": { "const": "none" },
+        "failOpen": { "const": true },
+        "pathCount": { "type": "integer", "minimum": 0 },
+        "network": { "const": "forbidden" },
+        "pathSummary": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["schemaVersion", "total", "source", "generated", "ignored", "binary", "deleted", "renameHints"],
+          "properties": {
+            "schemaVersion": { "const": "archcontext.checkpoint-path-summary/v1" },
+            "total": { "type": "integer", "minimum": 0 },
+            "source": { "type": "integer", "minimum": 0 },
+            "generated": { "type": "integer", "minimum": 0 },
+            "ignored": { "type": "integer", "minimum": 0 },
+            "binary": { "type": "integer", "minimum": 0 },
+            "deleted": { "type": "integer", "minimum": 0 },
+            "renameHints": { "type": "integer", "minimum": 0 }
+          }
+        },
+        "coalesced": { "type": "boolean" },
+        "skippedAnalysis": { "type": "boolean" },
+        "coalescedEventCount": { "type": "integer", "minimum": 1 },
+        "coalesceKey": { "type": "string", "pattern": "^sha256:" },
+        "elapsedMs": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "nextSnapshot": { "$ref": "#/$defs/snapshot" }
+  },
+  "$defs": {
+    "delta": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "added", "removed", "upgraded", "downgraded", "unchanged", "requiresProof"],
+      "properties": {
+        "schemaVersion": { "const": "archcontext.practice-delta/v1" },
+        "added": { "type": "array", "items": { "$ref": "#/$defs/match" } },
+        "removed": { "type": "array", "items": { "$ref": "#/$defs/match" } },
+        "upgraded": { "type": "array", "items": { "$ref": "#/$defs/match" } },
+        "downgraded": { "type": "array", "items": { "$ref": "#/$defs/match" } },
+        "unchanged": { "type": "array", "items": { "$ref": "#/$defs/match" } },
+        "requiresProof": { "type": "array", "items": { "$ref": "#/$defs/match" } }
+      }
+    },
+    "match": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["schemaVersion", "practiceId", "assetDigest", "enforcement", "confidence"],
+      "properties": {
+        "schemaVersion": { "const": "archcontext.practice-match/v1" },
+        "practiceId": { "type": "string" },
+        "assetDigest": { "type": "string", "pattern": "^sha256:" },
+        "enforcement": { "enum": ["advisory", "checkpoint", "complete"] },
+        "confidence": { "enum": ["low", "medium", "high"] }
+      }
+    },
+    "snapshot": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schemaVersion", "task", "headSha", "worktreeDigest", "contextDigest", "practiceGuidanceDigest", "catalogDigest", "matches"],
+      "properties": {
+        "schemaVersion": { "const": "archcontext.practice-checkpoint-snapshot/v1" },
+        "task": { "type": "string" },
+        "headSha": { "type": "string" },
+        "worktreeDigest": { "type": "string", "pattern": "^sha256:" },
+        "contextDigest": { "type": "string", "pattern": "^sha256:" },
+        "practiceGuidanceDigest": { "type": "string", "pattern": "^sha256:" },
+        "catalogDigest": { "type": "string", "pattern": "^sha256:" },
+        "matches": { "type": "array", "items": { "$ref": "#/$defs/match" } }
+      }
+    }
+  }
+}