@openplanr/protocol 0.2.0

package/schemas/v1.1.0/professional-specification.schema.json

@@ -0,0 +1,111 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.1.0/professional-specification.schema.json",
+  "title": "OpenPlanr Protocol 1.1 professional specification projection",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "kind", "schemaVersion", "protocolVersion", "source", "audience", "outcome",
+    "constraints", "evidenceExpectations", "failureModes", "rollback", "scope",
+    "acceptanceCriteria", "declaredSpecialists", "decisionComplete", "sourceDigest", "digest"
+  ],
+  "properties": {
+    "kind": { "const": "professional-specification" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "1.1.0" },
+    "source": {
+      "type": "object", "additionalProperties": false,
+      "required": ["mode", "featureId", "slug", "title"],
+      "properties": {
+        "mode": { "type": "string", "enum": ["spec-driven", "default"] },
+        "featureId": { "type": "string", "pattern": "^(?:SPEC|FEAT)-[0-9]{3}$" },
+        "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$", "maxLength": 160 },
+        "title": { "type": "string", "minLength": 1, "maxLength": 240 }
+      }
+    },
+    "audience": {
+      "type": "object", "additionalProperties": false,
+      "required": ["primary", "affected"],
+      "properties": {
+        "primary": { "type": "string", "minLength": 1, "maxLength": 1000 },
+        "affected": { "type": "array", "maxItems": 32, "uniqueItems": true, "items": { "$ref": "#/$defs/boundedText" } }
+      }
+    },
+    "outcome": {
+      "type": "object", "additionalProperties": false,
+      "required": ["statement", "measure", "target", "timeframe"],
+      "properties": {
+        "statement": { "$ref": "#/$defs/boundedText" },
+        "measure": { "$ref": "#/$defs/boundedText" },
+        "target": { "$ref": "#/$defs/boundedText" },
+        "timeframe": { "$ref": "#/$defs/boundedText" }
+      }
+    },
+    "constraints": { "$ref": "#/$defs/explicitList" },
+    "evidenceExpectations": { "type": "array", "minItems": 1, "maxItems": 64, "uniqueItems": true, "items": { "$ref": "#/$defs/boundedText" } },
+    "failureModes": { "type": "array", "minItems": 1, "maxItems": 64, "uniqueItems": true, "items": { "$ref": "#/$defs/boundedText" } },
+    "rollback": {
+      "type": "object", "additionalProperties": false,
+      "required": ["trigger", "strategy", "verification"],
+      "properties": {
+        "trigger": { "$ref": "#/$defs/boundedText" },
+        "strategy": { "$ref": "#/$defs/boundedText" },
+        "verification": { "$ref": "#/$defs/boundedText" }
+      }
+    },
+    "scope": {
+      "type": "object", "additionalProperties": false,
+      "required": ["inScope", "outOfScope"],
+      "properties": {
+        "inScope": { "type": "array", "minItems": 1, "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/boundedText" } },
+        "outOfScope": { "type": "array", "minItems": 1, "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/boundedText" } }
+      }
+    },
+    "acceptanceCriteria": {
+      "type": "array", "minItems": 1, "maxItems": 128,
+      "items": {
+        "type": "object", "additionalProperties": false,
+        "required": ["id", "statement", "evidence"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^AC-[0-9]{1,3}$" },
+          "statement": { "$ref": "#/$defs/boundedText" },
+          "evidence": { "$ref": "#/$defs/boundedText" }
+        }
+      }
+    },
+    "declaredSpecialists": {
+      "type": "array", "maxItems": 5, "uniqueItems": true,
+      "items": { "$ref": "#/$defs/specialistId" }
+    },
+    "decisionComplete": { "const": true },
+    "sourceDigest": { "$ref": "#/$defs/digest" },
+    "digest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": {
+    "boundedText": { "type": "string", "minLength": 1, "maxLength": 4000 },
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "specialistId": { "type": "string", "enum": ["security-reviewer", "performance-reviewer", "migration-reviewer", "api-contract-reviewer", "data-integrity-reviewer"] },
+    "explicitList": {
+      "oneOf": [
+        {
+          "title": "declared constraints",
+          "type": "object", "additionalProperties": false,
+          "required": ["status", "items"],
+          "properties": {
+            "status": { "const": "declared" },
+            "items": { "type": "array", "minItems": 1, "maxItems": 64, "uniqueItems": true, "items": { "$ref": "#/$defs/boundedText" } }
+          }
+        },
+        {
+          "title": "explicitly no constraints",
+          "type": "object", "additionalProperties": false,
+          "required": ["status", "items"],
+          "properties": {
+            "status": { "const": "none" },
+            "items": { "type": "array", "maxItems": 0 }
+          }
+        }
+      ]
+    }
+  }
+}

package/schemas/v1.1.0/provenance-event.schema.json

@@ -0,0 +1,82 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.1.0/provenance-event.schema.json",
+  "title": "OpenPlanr provenance JSONL event",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "event_id", "timestamp", "artifact_id", "artifact_path", "operation", "producer", "run_id"],
+  "allOf": [
+    {
+      "if": { "properties": { "operation": { "const": "rolled-back" } }, "required": ["operation"] },
+      "then": { "required": ["rollback_evidence"] },
+      "else": { "not": { "required": ["rollback_evidence"] } }
+    }
+  ],
+  "properties": {
+    "schema_version": { "const": "1.0.0" },
+    "event_id": { "type": "string", "minLength": 1 },
+    "timestamp": { "type": "string", "format": "date-time" },
+    "artifact_id": { "type": "string", "minLength": 1 },
+    "artifact_path": { "type": "string", "minLength": 1 },
+    "operation": { "type": "string", "enum": ["created", "shaped", "decomposed", "updated", "promoted", "designed", "implemented", "verified", "shipped", "rolled-back", "recovered"] },
+    "producer": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["product", "version", "runtime", "phase"],
+      "properties": {
+        "product": { "type": "string", "enum": ["openplanr", "planr-pipeline"] },
+        "version": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+" },
+        "runtime": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+        "phase": { "type": "string", "enum": ["planning", "po", "design", "dev", "qa", "delivery"] }
+      }
+    },
+    "run_id": { "type": "string", "minLength": 1 },
+    "correlation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["correlation_id", "proposal_id", "proposal_hash", "transaction_id", "receipt_hash"],
+      "properties": {
+        "correlation_id": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "proposal_id": { "type": "string", "pattern": "^oprop_[a-f0-9]{32}$" },
+        "proposal_hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "transaction_id": { "type": "string", "pattern": "^txn_[a-f0-9]{32}$" },
+        "receipt_hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+      }
+    },
+    "run_evidence": {
+      "type": "object", "additionalProperties": false,
+      "required": ["manifest_hash", "manifest_start_line", "manifest_end_line", "marker_hash"],
+      "allOf": [
+        {
+          "if": { "required": ["closure_receipt_hash"] },
+          "then": { "required": ["candidate_hash", "gate_evidence_hash"] }
+        }
+      ],
+      "properties": {
+        "manifest_hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "manifest_start_line": { "type": "integer", "minimum": 1 },
+        "manifest_end_line": { "type": "integer", "minimum": 1 },
+        "marker_hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "closure_receipt_hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "candidate_hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "gate_evidence_hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+      }
+    },
+    "rollback_evidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["original_ship_run_id", "rollback_plan_artifact_id", "rollback_plan_hash", "rollback_result_artifact_id", "rollback_result_hash", "rollback_receipt_artifact_id", "target_before_hash", "target_after_hash", "completed_at"],
+      "properties": {
+        "original_ship_run_id": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "rollback_plan_artifact_id": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "rollback_plan_hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "rollback_result_artifact_id": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "rollback_result_hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "rollback_receipt_artifact_id": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "target_before_hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "target_after_hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "completed_at": { "type": "string", "format": "date-time" }
+      }
+    }
+  }
+}

package/schemas/v1.1.0/role-registry.schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.1.0/role-registry.schema.json",
+  "title": "OpenPlanr canonical role registry",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "roles"],
+  "properties": {
+    "schemaVersion": { "const": "1.0.0" },
+    "roles": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "phase", "activation", "capability", "writeBoundary", "source"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*-agent$" },
+          "phase": { "type": "string", "enum": ["po-preflight", "po", "dev", "qa", "post-build"] },
+          "activation": { "type": "string", "enum": ["always", "conditional", "manual"] },
+          "capability": { "type": "string", "enum": ["analysis-high", "implementation-high", "read-only-qa"] },
+          "writeBoundary": { "type": "string", "minLength": 1 },
+          "source": { "type": "string", "pattern": "^agents/[a-z0-9-]+\\.md$" }
+        }
+      }
+    }
+  }
+}

package/schemas/v1.1.0/runtime-lock.schema.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.1.0/runtime-lock.schema.json",
+  "title": "OpenPlanr project runtime lock",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "generatedAt", "manifestDigest", "protocolVersion", "components", "adapters"],
+  "properties": {
+    "schemaVersion": { "const": "1.0.0" },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "manifestDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "protocolVersion": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+$" },
+    "components": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["cli", "pipeline", "skills"],
+      "properties": {
+        "cli": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+" },
+        "pipeline": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+" },
+        "skills": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+" }
+      }
+    },
+    "adapters": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["runtime", "version", "capabilityLevel", "installScope"],
+        "properties": {
+          "runtime": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+          "version": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+" },
+          "capabilityLevel": { "type": "string", "enum": ["artifact", "workflow", "product"] },
+          "installScope": { "type": "string", "enum": ["user", "project", "both"] },
+          "model": { "type": "string", "minLength": 1 }
+        }
+      }
+    }
+  }
+}

package/schemas/v1.1.0/ship-closure.schema.json

@@ -0,0 +1,353 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.1.0/ship-closure.schema.json",
+  "title": "OpenPlanr monotonic SHIP closure",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "kind", "schemaVersion", "protocolVersion", "recordType", "runId",
+    "generation", "state", "feature", "mode", "runtime", "createdAt",
+    "updatedAt", "approvedScope", "tasks", "repositories", "reviewerRoster",
+    "rosterDigest", "gates", "gateSetDigest", "candidateRevisions", "reviews", "gateEvidence", "events",
+    "correctionImpact", "terminal", "receiptHash", "startedFromReceiptHash",
+    "reopenReason", "operatingOriginCorrelation"
+  ],
+  "properties": {
+    "kind": { "const": "ship-closure" },
+    "schemaVersion": { "type": "string", "enum": ["1.0.0", "1.1.0", "1.2.0"] },
+    "protocolVersion": { "const": "1.1.0" },
+    "recordType": { "type": "string", "enum": ["active", "receipt"] },
+    "runId": { "type": "string", "pattern": "^ship_[a-f0-9]{32}$" },
+    "generation": { "type": "integer", "minimum": 0 },
+    "state": {
+      "type": "string",
+      "enum": [
+        "implementing", "reviewing_initial", "correction_required",
+        "reviewing_targeted", "ready_for_final", "passed", "blocked"
+      ]
+    },
+    "feature": { "type": "string", "minLength": 1, "maxLength": 160 },
+    "mode": { "type": "string", "enum": ["default", "spec-driven"] },
+    "runtime": { "type": "string", "enum": ["claude-code", "cursor", "codex", "unknown"] },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "updatedAt": { "type": "string", "format": "date-time" },
+    "approvedScope": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["featureRoot", "taskIds", "digest"],
+      "properties": {
+        "featureRoot": { "type": "string", "minLength": 1, "maxLength": 1024 },
+        "taskIds": { "type": "array", "maxItems": 256, "items": { "type": "string", "minLength": 1, "maxLength": 128 }, "uniqueItems": true },
+        "digest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "tasks": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 256,
+      "items": { "$ref": "#/$defs/task" }
+    },
+    "repositories": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 16,
+      "items": { "$ref": "#/$defs/repository" }
+    },
+    "reviewerRoster": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 16,
+      "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$", "maxLength": 128 },
+      "uniqueItems": true
+    },
+    "rosterDigest": { "$ref": "#/$defs/digest" },
+    "gates": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 32,
+      "items": { "$ref": "#/$defs/gate" }
+    },
+    "gateSetDigest": { "$ref": "#/$defs/digest" },
+    "candidateRevisions": {
+      "type": "array",
+      "maxItems": 2,
+      "items": { "$ref": "#/$defs/candidate" }
+    },
+    "reviews": {
+      "type": "array",
+      "maxItems": 2,
+      "items": { "$ref": "#/$defs/review" }
+    },
+    "gateEvidence": {
+      "type": "array",
+      "maxItems": 96,
+      "items": { "$ref": "#/$defs/gateEvidence" }
+    },
+    "events": {
+      "type": "array",
+      "maxItems": 512,
+      "items": { "$ref": "#/$defs/eventReceipt" }
+    },
+    "correctionImpact": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["summary", "findingIds", "paths", "affectedGateIds"],
+          "properties": {
+            "summary": { "type": "string", "minLength": 1, "maxLength": 4096 },
+            "findingIds": { "type": "array", "minItems": 1, "maxItems": 256, "items": { "type": "string", "minLength": 1, "maxLength": 128 }, "uniqueItems": true },
+            "paths": { "type": "array", "maxItems": 1000, "items": { "$ref": "#/$defs/repositoryPath" }, "uniqueItems": true },
+            "affectedGateIds": { "type": "array", "maxItems": 32, "items": { "type": "string", "minLength": 1, "maxLength": 128 }, "uniqueItems": true }
+          }
+        }
+      ]
+    },
+    "terminal": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["status", "at", "reason", "candidateDigest", "gateEvidenceDigest"],
+          "properties": {
+            "status": { "type": "string", "enum": ["passed", "blocked"] },
+            "at": { "type": "string", "format": "date-time" },
+            "reason": { "type": ["string", "null"], "maxLength": 4096 },
+            "candidateDigest": { "$ref": "#/$defs/digest" },
+            "gateEvidenceDigest": { "$ref": "#/$defs/digest" }
+          }
+        }
+      ]
+    },
+    "receiptHash": {
+      "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/digest" }]
+    },
+    "startedFromReceiptHash": {
+      "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/digest" }]
+    },
+    "reopenReason": { "type": ["string", "null"], "minLength": 1, "maxLength": 4096 },
+    "planningReview": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["receiptHash", "planDigest", "ownerDecisionDigest"],
+      "properties": {
+        "receiptHash": { "$ref": "#/$defs/digest" },
+        "planDigest": { "$ref": "#/$defs/digest" },
+        "ownerDecisionDigest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "riskClassification": { "$ref": "ship-risk-classification.schema.json" },
+    "browserQaRecords": {
+      "type": "array", "maxItems": 2,
+      "items": { "$ref": "browser-qa-gate.schema.json" }
+    },
+    "operatingOriginCorrelation": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["correlation_id", "proposal_id", "proposal_hash", "transaction_id", "receipt_hash"],
+          "properties": {
+            "correlation_id": { "type": "string", "minLength": 1, "maxLength": 128 },
+            "proposal_id": { "type": "string", "pattern": "^oprop_[a-f0-9]{32}$" },
+            "proposal_hash": { "$ref": "#/$defs/digest" },
+            "transaction_id": { "type": "string", "pattern": "^txn_[a-f0-9]{32}$" },
+            "receipt_hash": { "$ref": "#/$defs/digest" }
+          }
+        }
+      ]
+    }
+  },
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "repositoryPath": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["repositoryKey", "path"],
+      "properties": {
+        "repositoryKey": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$", "maxLength": 128 },
+        "path": { "type": "string", "minLength": 1, "maxLength": 1024 }
+      }
+    },
+    "task": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "storyId", "path", "status", "dependsOn", "agent", "filesWritten", "filesModified", "blockedReason", "preserve"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "storyId": { "type": ["string", "null"], "maxLength": 128 },
+        "path": { "$ref": "#/$defs/repositoryPath" },
+        "status": { "type": "string", "enum": ["pending", "completed", "blocked"] },
+        "dependsOn": { "type": "array", "maxItems": 256, "items": { "type": "string", "minLength": 1, "maxLength": 128 }, "uniqueItems": true },
+        "agent": { "type": ["string", "null"], "maxLength": 128 },
+        "filesWritten": { "type": "array", "maxItems": 1000, "items": { "$ref": "#/$defs/repositoryPath" }, "uniqueItems": true },
+        "filesModified": { "type": "array", "maxItems": 1000, "items": { "$ref": "#/$defs/repositoryPath" }, "uniqueItems": true },
+        "blockedReason": { "type": ["string", "null"], "maxLength": 4096 },
+        "preserve": { "type": "array", "maxItems": 256, "items": { "$ref": "#/$defs/preserve" }, "uniqueItems": true }
+      }
+    },
+    "preserve": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["repositoryKey", "path", "identity"],
+      "properties": {
+        "repositoryKey": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$", "maxLength": 128 },
+        "path": { "type": "string", "minLength": 1, "maxLength": 1024 },
+        "identity": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "repository": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["repositoryKey", "root", "head", "baselineDigest"],
+      "properties": {
+        "repositoryKey": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$", "maxLength": 128 },
+        "root": { "type": ["string", "null"], "maxLength": 4096 },
+        "head": { "type": "string", "pattern": "^[a-f0-9]{40,64}$" },
+        "baselineDigest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "gate": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "repositoryKey", "argv", "inputs", "dependsOn", "finalRelevantSuite"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$", "maxLength": 128 },
+        "repositoryKey": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$", "maxLength": 128 },
+        "argv": { "type": "array", "minItems": 1, "maxItems": 128, "items": { "type": "string", "minLength": 1, "maxLength": 4096 } },
+        "inputs": { "type": "array", "minItems": 1, "maxItems": 512, "items": { "$ref": "#/$defs/repositoryPath" }, "uniqueItems": true },
+        "dependsOn": { "type": "array", "maxItems": 32, "items": { "type": "string", "minLength": 1, "maxLength": 128 }, "uniqueItems": true },
+        "finalRelevantSuite": { "type": "boolean" },
+        "gateType": { "type": "string", "enum": ["command", "browser-qa"] }
+      }
+    },
+    "inventoryEntry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["repositoryKey", "path", "changeType", "kind", "mode", "contentDigest", "symlinkTarget", "originalPath"],
+      "properties": {
+        "repositoryKey": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$", "maxLength": 128 },
+        "path": { "type": "string", "minLength": 1, "maxLength": 1024 },
+        "changeType": { "type": "string", "enum": ["added", "modified", "deleted", "renamed"] },
+        "kind": { "type": "string", "enum": ["file", "directory", "symlink", "missing"] },
+        "mode": { "type": ["integer", "null"], "minimum": 0 },
+        "contentDigest": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/digest" }] },
+        "symlinkTarget": { "type": ["string", "null"], "maxLength": 4096 },
+        "originalPath": { "type": ["string", "null"], "maxLength": 1024 }
+      }
+    },
+    "candidate": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["revision", "sealedAt", "digest", "repositories", "inventory"],
+      "properties": {
+        "revision": { "type": "integer", "minimum": 1, "maximum": 2 },
+        "sealedAt": { "type": "string", "format": "date-time" },
+        "digest": { "$ref": "#/$defs/digest" },
+        "repositories": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 16,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["repositoryKey", "head", "baselineDigest", "inventoryDigest"],
+            "properties": {
+              "repositoryKey": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$", "maxLength": 128 },
+              "head": { "type": "string", "pattern": "^[a-f0-9]{40,64}$" },
+              "baselineDigest": { "$ref": "#/$defs/digest" },
+              "inventoryDigest": { "$ref": "#/$defs/digest" }
+            }
+          }
+        },
+        "inventory": { "type": "array", "maxItems": 10000, "items": { "$ref": "#/$defs/inventoryEntry" } }
+      }
+    },
+    "finding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "severity", "basis", "title", "evidence", "taskIds", "paths", "acceptanceRefs", "disposition"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^fnd_[a-f0-9]{32}$" },
+        "severity": { "type": "string", "enum": ["P0", "P1", "P2"] },
+        "basis": { "type": "string", "enum": ["acceptance", "security", "privacy", "correctness", "data-loss", "release-integrity"] },
+        "title": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "evidence": { "type": "string", "minLength": 1, "maxLength": 4096 },
+        "taskIds": { "type": "array", "maxItems": 256, "items": { "type": "string", "minLength": 1, "maxLength": 128 }, "uniqueItems": true },
+        "paths": { "type": "array", "maxItems": 1000, "items": { "$ref": "#/$defs/repositoryPath" }, "uniqueItems": true },
+        "acceptanceRefs": { "type": "array", "maxItems": 256, "items": { "type": "string", "minLength": 1, "maxLength": 512 }, "uniqueItems": true },
+        "disposition": { "type": "string", "enum": ["open", "resolved", "remains", "deferred"] }
+      }
+    },
+    "review": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["phase", "candidateRevision", "reviewerIds", "contributions", "candidateDigest", "rosterDigest", "gateSetDigest", "summary", "reviewedFindingIds", "findings", "closedAt"],
+      "properties": {
+        "phase": { "type": "string", "enum": ["initial", "targeted"] },
+        "candidateRevision": { "type": "integer", "minimum": 1, "maximum": 2 },
+        "reviewerIds": { "type": "array", "minItems": 1, "maxItems": 16, "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$", "maxLength": 128 }, "uniqueItems": true },
+        "contributions": { "type": "array", "minItems": 1, "maxItems": 16, "items": { "$ref": "#/$defs/reviewContribution" } },
+        "candidateDigest": { "$ref": "#/$defs/digest" },
+        "rosterDigest": { "$ref": "#/$defs/digest" },
+        "gateSetDigest": { "$ref": "#/$defs/digest" },
+        "summary": { "type": "string", "minLength": 1, "maxLength": 4096 },
+        "reviewedFindingIds": { "type": "array", "maxItems": 256, "items": { "type": "string", "minLength": 1, "maxLength": 128 }, "uniqueItems": true },
+        "findings": { "type": "array", "maxItems": 256, "items": { "$ref": "#/$defs/finding" } },
+        "closedAt": { "type": "string", "format": "date-time" }
+      }
+    },
+    "reviewContribution": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["reviewerId", "summary", "evidenceDigest"],
+      "properties": {
+        "reviewerId": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$", "maxLength": 128 },
+        "summary": { "type": "string", "minLength": 1, "maxLength": 4096 },
+        "evidenceDigest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "gateEvidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["gateId", "phase", "candidateDigest", "inputDigest", "status", "startedAt", "endedAt", "exitCode", "stdoutDigest", "stderrDigest", "stdoutExcerpt", "stderrExcerpt", "reusedFromPhase"],
+      "properties": {
+        "gateId": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$", "maxLength": 128 },
+        "phase": { "type": "string", "enum": ["initial", "targeted", "final"] },
+        "candidateDigest": { "$ref": "#/$defs/digest" },
+        "inputDigest": { "$ref": "#/$defs/digest" },
+        "status": { "type": "string", "enum": ["passed", "failed", "skipped", "reused"] },
+        "startedAt": { "type": "string", "format": "date-time" },
+        "endedAt": { "type": "string", "format": "date-time" },
+        "exitCode": { "type": ["integer", "null"] },
+        "stdoutDigest": { "$ref": "#/$defs/digest" },
+        "stderrDigest": { "$ref": "#/$defs/digest" },
+        "stdoutExcerpt": { "type": "string", "maxLength": 4096 },
+        "stderrExcerpt": { "type": "string", "maxLength": 4096 },
+        "reusedFromPhase": { "type": ["string", "null"], "enum": ["initial", "targeted", "final", null] }
+      }
+    },
+    "eventReceipt": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["eventId", "type", "inputDigest", "generation", "at"],
+      "properties": {
+        "eventId": { "type": "string", "pattern": "^evt_[a-f0-9]{32}$" },
+        "type": { "type": "string", "enum": ["task.completed", "task.blocked", "review.opened", "review.closed", "correction.registered", "browser-qa.recorded", "gates.recorded", "closure.finalized"] },
+        "inputDigest": { "$ref": "#/$defs/digest" },
+        "generation": { "type": "integer", "minimum": 1 },
+        "at": { "type": "string", "format": "date-time" }
+      }
+    }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "schemaVersion": { "const": "1.2.0" } }, "required": ["schemaVersion"] },
+      "then": { "required": ["planningReview", "riskClassification", "browserQaRecords"] },
+      "else": { "not": { "anyOf": [{ "required": ["riskClassification"] }, { "required": ["browserQaRecords"] }] } }
+    }
+  ]
+}