archctx 0.1.3 → 0.1.4-beta.0

package/schemas/repo/compatibility-contract.schema.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/repo/compatibility-contract.schema.json",
+  "title": "CompatibilityContract",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "id",
+    "status",
+    "kind",
+    "protects",
+    "consumers",
+    "legacyPaths",
+    "reason",
+    "owner",
+    "introducedAt",
+    "reviewAt",
+    "removalConditions"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.compatibility/v1" },
+    "id": { "type": "string", "pattern": "^[a-z][a-z0-9]*(\\.[a-z0-9][a-z0-9-]*)+$" },
+    "status": { "type": "string", "enum": ["active", "review-due", "expired", "removed"] },
+    "kind": {
+      "type": "string",
+      "enum": ["external-contract", "persisted-data-migration", "rolling-deployment", "temporary-feature-transition"]
+    },
+    "protects": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "id"],
+      "properties": {
+        "type": { "type": "string" },
+        "id": { "type": "string" }
+      }
+    },
+    "consumers": { "type": "array", "items": { "type": "string" } },
+    "legacyPaths": { "type": "array", "items": { "type": "string" } },
+    "reason": { "type": "string", "pattern": "^(?!just in case$|safer to keep$|many internal callers$|large diff$|old code already exists$).+" },
+    "owner": { "type": "string" },
+    "introducedAt": { "type": "string" },
+    "reviewAt": { "type": "string" },
+    "expiresAt": { "type": "string" },
+    "removalConditions": { "type": "array", "items": { "type": "string" }, "minItems": 1 },
+    "migrationIssue": { "type": "string" },
+    "extensions": { "type": "object", "additionalProperties": true }
+  }
+}

package/schemas/repo/constraint.schema.json

@@ -0,0 +1,56 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/repo/constraint.schema.json",
+  "title": "Constraint",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "name", "severity", "scope", "rule", "rationale"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.constraint/v1" },
+    "id": { "type": "string", "pattern": "^[a-z][a-z0-9]*(\\.[a-z0-9][a-z0-9-]*)+$" },
+    "name": { "type": "string" },
+    "severity": { "type": "string", "enum": ["notice", "warning", "error", "critical"] },
+    "scope": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "nodes": { "type": "array", "items": { "type": "string" } },
+        "relations": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "rule": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["type"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "forbid-dependency",
+            "require-interface",
+            "forbid-data-access",
+            "require-owner",
+            "require-adr",
+            "require-compatibility-contract",
+            "forbid-cycle",
+            "require-cleanup-by",
+            "require-review"
+          ]
+        }
+      }
+    },
+    "allowedVia": { "type": "array", "items": { "type": "string" } },
+    "rationale": { "type": "string" },
+    "humanExplanation": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "title": { "type": "string" },
+        "consequence": { "type": "string" },
+        "recommendation": { "type": "string" }
+      }
+    },
+    "requiresAdrForException": { "type": "boolean" },
+    "extensions": { "type": "object", "additionalProperties": true }
+  }
+}

package/schemas/repo/cross-repo-relation.schema.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/repo/cross-repo-relation.schema.json",
+  "title": "CrossRepoRelation",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "kind", "source", "target", "via", "intent"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.cross-repo-relation/v1" },
+    "id": { "type": "string", "pattern": "^relation\\.[a-z0-9][a-z0-9.-]*$" },
+    "kind": { "type": "string", "enum": ["depends-on", "calls", "publishes", "subscribes", "implements"] },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["repositoryId", "nodeId"],
+      "properties": {
+        "repositoryId": { "type": "string" },
+        "nodeId": { "type": "string" }
+      }
+    },
+    "target": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["repositoryId", "nodeId"],
+      "properties": {
+        "repositoryId": { "type": "string" },
+        "nodeId": { "type": "string" }
+      }
+    },
+    "via": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "id"],
+      "properties": {
+        "kind": { "type": "string", "enum": ["interface", "event"] },
+        "id": { "type": "string" }
+      }
+    },
+    "synchrony": { "type": "string", "enum": ["synchronous", "asynchronous", "batch"] },
+    "intent": { "type": "string" },
+    "owner": { "type": "string" },
+    "allowedData": { "type": "array", "items": { "type": "string" } },
+    "forbiddenData": { "type": "array", "items": { "type": "string" } },
+    "criticality": { "type": "string", "enum": ["low", "medium", "high", "critical"] },
+    "extensions": { "type": "object", "additionalProperties": true }
+  }
+}

package/schemas/repo/landscape.schema.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/repo/landscape.schema.json",
+  "title": "Landscape",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "name", "repositories", "relations", "syncPolicy"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.landscape/v1" },
+    "id": { "type": "string", "pattern": "^landscape\\.[a-z0-9][a-z0-9.-]*$" },
+    "name": { "type": "string" },
+    "repositories": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["repositoryId", "numericRepositoryId", "name", "role"],
+        "properties": {
+          "repositoryId": { "type": "string" },
+          "numericRepositoryId": { "type": "integer", "minimum": 1 },
+          "name": { "type": "string" },
+          "role": { "type": "string" },
+          "owner": { "type": "string" },
+          "defaultBranch": { "type": "string" }
+        }
+      }
+    },
+    "relations": { "type": "array", "items": { "type": "string" } },
+    "ownership": { "type": "object", "additionalProperties": true },
+    "scope": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "defaultActiveRepositories": { "type": "array", "items": { "type": "string" } },
+        "maxActiveRepositories": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "syncPolicy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode", "archcontextSyncService"],
+      "properties": {
+        "mode": { "type": "string", "enum": ["git-worktree-only"] },
+        "archcontextSyncService": { "type": "string", "enum": ["forbidden"] }
+      }
+    },
+    "extensions": { "type": "object", "additionalProperties": true }
+  }
+}

package/schemas/repo/practices/practice-policy.schema.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/repo/practices/practice-policy.schema.json",
+  "title": "PracticeEnforcementPolicy",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "mode", "rules"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.practice-enforcement-policy/v1" },
+    "mode": { "type": "string", "enum": ["advisory", "active", "fail-open", "fail-closed"] },
+    "recommendations": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "policyMode": { "type": "string", "enum": ["advisory", "checkpoint", "complete"] },
+        "frequency": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "minIntervalMs": { "type": "integer", "minimum": 0 },
+            "cooldownMs": { "type": "integer", "minimum": 0 }
+          }
+        },
+        "budgets": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "maxRecommendationsPerRun": { "type": "integer", "minimum": 0 },
+            "maxL3InvestigationsPerRun": { "type": "integer", "minimum": 0 },
+            "maxRunsPerTask": { "type": "integer", "minimum": 0 },
+            "maxRunsPerRepositoryPerDay": { "type": "integer", "minimum": 0 },
+            "maxRunsPerDay": { "type": "integer", "minimum": 0 }
+          }
+        }
+      }
+    },
+    "rules": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["practiceId", "enforcement"],
+        "properties": {
+          "practiceId": { "type": "string", "pattern": "^[a-z][a-z0-9-]*(\\.[a-z][a-z0-9-]*)+$" },
+          "enforcement": { "type": "string", "enum": ["advisory", "checkpoint", "complete"] },
+          "checkIds": { "type": "array", "items": { "type": "string" } },
+          "testEvidence": {
+            "type": "object",
+            "additionalProperties": false,
+            "anyOf": [
+              { "required": ["commands"] },
+              { "required": ["subjects"] }
+            ],
+            "properties": {
+              "commands": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1 },
+              "subjects": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1 }
+            }
+          },
+          "scope": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "pathGlobs": { "type": "array", "items": { "type": "string" } },
+              "subjects": { "type": "array", "items": { "type": "string" } }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/repo/practices/practice-profile.schema.json

@@ -0,0 +1,30 @@
+{
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "id",
+    "revision",
+    "status",
+    "title",
+    "repositoryKinds",
+    "languages",
+    "frameworks",
+    "includePracticeIds",
+    "excludePracticeIds",
+    "provenance"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.practice-profile/v1" },
+    "id": { "type": "string", "pattern": "^profile\\.[a-z0-9-]+(\\.[a-z0-9-]+)*$" },
+    "revision": { "type": "integer", "minimum": 1 },
+    "status": { "enum": ["active", "deprecated"] },
+    "title": { "type": "string" },
+    "repositoryKinds": { "type": "array", "items": { "type": "string" } },
+    "languages": { "type": "array", "items": { "type": "string" } },
+    "frameworks": { "type": "array", "items": { "type": "string" } },
+    "includePracticeIds": { "type": "array", "items": { "type": "string" } },
+    "excludePracticeIds": { "type": "array", "items": { "type": "string" } },
+    "provenance": { "type": "object" }
+  },
+  "additionalProperties": false
+}

package/schemas/repo/practices/practice-source.schema.json

@@ -0,0 +1,34 @@
+{
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "id",
+    "name",
+    "sourceType",
+    "uri",
+    "revision",
+    "licenseSpdx",
+    "licenseLevel",
+    "usagePolicy",
+    "retrievedAt",
+    "contentDigest",
+    "attribution",
+    "review"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.practice-source/v1" },
+    "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*(\\.[a-z0-9][a-z0-9-]*)*$" },
+    "name": { "type": "string" },
+    "sourceType": { "enum": ["archcontext", "git", "website", "standard", "reference"] },
+    "uri": { "type": "string" },
+    "revision": { "type": "string" },
+    "licenseSpdx": { "type": "string" },
+    "licenseLevel": { "enum": ["A", "B", "C", "D", "E"] },
+    "usagePolicy": { "enum": ["builtin-with-attribution", "reference-only", "repo-authored"] },
+    "retrievedAt": { "type": "string" },
+    "contentDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "attribution": { "type": "string" },
+    "review": { "type": "object" }
+  },
+  "additionalProperties": false
+}

package/schemas/repo/practices/practice-waiver.schema.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/repo/practices/practice-waiver.schema.json",
+  "title": "PracticeWaiver",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "practiceId", "scope", "owner", "reason", "createdAt", "reviewAt", "expiresAt", "evidenceDigest"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.practice-waiver/v1" },
+    "practiceId": { "type": "string", "pattern": "^[a-z][a-z0-9-]*(\\.[a-z][a-z0-9-]*)+$" },
+    "checkId": { "type": "string" },
+    "scope": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "pathGlobs": { "type": "array", "items": { "type": "string" } },
+        "subjects": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "owner": { "type": "string" },
+    "reason": { "type": "string" },
+    "createdAt": { "type": "string" },
+    "reviewAt": { "type": "string" },
+    "expiresAt": { "type": "string" },
+    "evidenceDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+  }
+}

package/schemas/repo/practices/practice.schema.json

@@ -0,0 +1,88 @@
+{
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "id",
+    "revision",
+    "status",
+    "title",
+    "summary",
+    "category",
+    "tags",
+    "appliesTo",
+    "triggers",
+    "evidencePolicy",
+    "guidance",
+    "checks",
+    "enforcement",
+    "provenance",
+    "lifecycle"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.practice/v1" },
+    "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*(\\.[a-z][a-z0-9-]*)+$" },
+    "revision": { "type": "integer", "minimum": 1 },
+    "status": { "enum": ["active", "deprecated", "disabled"] },
+    "title": { "type": "string" },
+    "summary": { "type": "string" },
+    "category": { "type": "string" },
+    "tags": { "type": "array", "items": { "type": "string" } },
+    "appliesTo": { "type": "object" },
+    "triggers": { "type": "object" },
+    "evidencePolicy": { "type": "object" },
+    "guidance": { "type": "object" },
+    "checks": { "type": "array", "items": { "type": "object" } },
+    "enforcement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["default", "promotableTo", "repoOptInRequired"],
+      "properties": {
+        "default": { "enum": ["advisory", "checkpoint", "complete"] },
+        "promotableTo": { "enum": ["advisory", "checkpoint", "complete"] },
+        "repoOptInRequired": { "type": "boolean" },
+        "fixtureGate": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["positive", "nearNegative", "mixedChange", "baseline"],
+          "properties": {
+            "positive": { "$ref": "#/$defs/fixtureRefs" },
+            "nearNegative": { "$ref": "#/$defs/fixtureRefs" },
+            "mixedChange": { "$ref": "#/$defs/fixtureRefs" },
+            "baseline": { "$ref": "#/$defs/fixtureRefs" }
+          }
+        }
+      }
+    },
+    "provenance": { "type": "object" },
+    "lifecycle": { "type": "object" },
+    "overlay": {
+      "type": "object",
+      "properties": {
+        "mode": { "enum": ["add", "replace", "disable"] },
+        "extends": { "type": "string" },
+        "expiresAt": { "type": "string", "format": "date-time" }
+      },
+      "required": ["mode"],
+      "additionalProperties": false
+    }
+  },
+  "$defs": {
+    "fixtureRefs": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/fixtureRef" }
+    },
+    "fixtureRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "path", "description"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^[a-z][a-z0-9_.-]+$" },
+        "path": { "type": "string", "minLength": 1 },
+        "description": { "type": "string", "minLength": 1 },
+        "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/runtime/agent-job.schema.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archcontext.dev/schemas/runtime/agent-job.schema.json",
+  "title": "AgentJob",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "jobId", "status", "runnerPort", "repository", "worktree", "fingerprint", "trigger", "budget", "inputDigest", "promptTemplateDigest", "stalePolicy", "directMutationAllowed", "queuedAt", "updatedAt"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.agent-job/v1" },
+    "jobId": { "type": "string", "pattern": "^agent_job\\.[a-zA-Z0-9_-]+$" },
+    "status": { "enum": ["queued", "running", "succeeded", "failed", "cancelled", "superseded", "expired"] },
+    "runnerPort": { "enum": ["claude-code", "codex", "fake-provider"] },
+    "repository": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["repositoryId", "storageRepositoryId"],
+      "properties": {
+        "repositoryId": { "type": "string" },
+        "storageRepositoryId": { "type": "string" }
+      }
+    },
+    "worktree": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["workspaceId", "storageWorkspaceId", "branch", "headSha", "worktreeDigest"],
+      "properties": {
+        "workspaceId": { "type": "string" },
+        "storageWorkspaceId": { "type": "string" },
+        "branch": { "type": "string" },
+        "headSha": { "type": "string", "pattern": "^[a-f0-9]{40}$" },
+        "worktreeDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+      }
+    },
+    "fingerprint": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "trigger": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["source", "reason"],
+      "properties": {
+        "source": { "enum": ["prepare_task", "checkpoint", "plan_update", "apply_update", "complete_task", "git_hook", "yaml_import", "projection_reconcile", "migration", "manual"] },
+        "reason": { "type": "string" }
+      }
+    },
+    "budget": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["maxRunsPerTask", "maxRunsPerRepositoryPerDay"],
+      "properties": {
+        "maxRunsPerTask": { "type": "integer", "minimum": 0 },
+        "maxRunsPerRepositoryPerDay": { "type": "integer", "minimum": 0 },
+        "maxRunsPerDay": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "inputDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "promptTemplateDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "outputDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "stalePolicy": { "enum": ["cancel-on-head-change", "advisory-only-on-stale"] },
+    "directMutationAllowed": { "const": false },
+    "queuedAt": { "type": "string" },
+    "updatedAt": { "type": "string" },
+    "extensions": { "type": "object", "additionalProperties": true }
+  }
+}

package/schemas/runtime/architecture-candidate-delta-policy.schema.json

@@ -0,0 +1,129 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archcontext.dev/schemas/runtime/architecture-candidate-delta-policy.schema.json",
+  "title": "Architecture Candidate Delta Policy Evaluation",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "evaluationId",
+    "deltaId",
+    "repository",
+    "worktree",
+    "deltaDigest",
+    "policyVersion",
+    "evaluatedAt",
+    "decisions",
+    "summary",
+    "evaluationDigest"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.architecture-candidate-delta-policy/v1" },
+    "evaluationId": { "type": "string", "pattern": "^candidate_delta_policy\\.[a-zA-Z0-9_.-]+$" },
+    "deltaId": { "type": "string", "pattern": "^delta\\.[a-zA-Z0-9_.-]+$" },
+    "repository": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["repositoryId", "storageRepositoryId"],
+      "properties": {
+        "repositoryId": { "type": "string" },
+        "storageRepositoryId": { "type": "string" }
+      }
+    },
+    "worktree": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["workspaceId", "storageWorkspaceId", "branch", "headSha", "worktreeDigest"],
+      "properties": {
+        "workspaceId": { "type": "string" },
+        "storageWorkspaceId": { "type": "string" },
+        "branch": { "type": "string" },
+        "headSha": { "type": "string" },
+        "worktreeDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+      }
+    },
+    "deltaDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "policyVersion": { "type": "string" },
+    "evaluatedAt": { "type": "string", "format": "date-time" },
+    "decisions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "decisionId",
+          "candidateChangeId",
+          "target",
+          "stateDimension",
+          "changeKind",
+          "confidence",
+          "action",
+          "reasonCodes",
+          "evidenceIds",
+          "digest"
+        ],
+        "properties": {
+          "decisionId": { "type": "string", "pattern": "^candidate_delta_policy_decision\\.[a-zA-Z0-9_.-]+$" },
+          "candidateChangeId": { "type": "string", "pattern": "^candidate_change\\.[a-zA-Z0-9_.-]+$" },
+          "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"] },
+          "confidence": { "enum": ["low", "medium", "high"] },
+          "action": { "enum": ["auto-accept", "require-checkpoint", "require-proof", "require-human-approval"] },
+          "reasonCodes": {
+            "type": "array",
+            "items": {
+              "enum": [
+                "high-confidence-complete-evidence",
+                "medium-confidence",
+                "low-confidence",
+                "partial-evidence",
+                "missing-evidence",
+                "mapping-ambiguity",
+                "migration-state-progress",
+                "target-state-removal",
+                "relation-removal",
+                "constraint-relaxation",
+                "owner-authority-change"
+              ]
+            }
+          },
+          "evidenceIds": { "type": "array", "items": { "type": "string" } },
+          "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+          "extensions": { "type": "object", "additionalProperties": true }
+        }
+      }
+    },
+    "summary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "candidateChanges",
+        "autoAccept",
+        "requireCheckpoint",
+        "requireProof",
+        "requireHumanApproval",
+        "mappingAmbiguities"
+      ],
+      "properties": {
+        "candidateChanges": { "type": "integer", "minimum": 0 },
+        "autoAccept": { "type": "integer", "minimum": 0 },
+        "requireCheckpoint": { "type": "integer", "minimum": 0 },
+        "requireProof": { "type": "integer", "minimum": 0 },
+        "requireHumanApproval": { "type": "integer", "minimum": 0 },
+        "mappingAmbiguities": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "evaluationDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "extensions": { "type": "object", "additionalProperties": true }
+  }
+}