codex-workflow-v2 2.0.0-alpha.4 → 2.0.0-alpha.6

package/schemas/adoption-posture-event.schema.json

@@ -0,0 +1,129 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://codex-workflow.local/schemas/adoption-posture-event.schema.json",
+  "title": "Codex Workflow V2 Alpha.6 Adoption Posture Event",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "eventId",
+    "projectId",
+    "eventType",
+    "actor",
+    "packageVersion",
+    "protocolVersion",
+    "stateSchemaVersion",
+    "adoptionBoundaryAt",
+    "baselineDigestHash",
+    "sidecarBaselineHash",
+    "confirmationCodeBindingHash",
+    "repositoryIdentity",
+    "terminalMilestones",
+    "terminalTasks",
+    "activeTasks",
+    "previousEventHash",
+    "recordedAt",
+    "eventHash"
+  ],
+  "properties": {
+    "eventId": { "type": "string", "minLength": 1 },
+    "projectId": { "type": "string", "pattern": "^[a-f0-9]{24}$" },
+    "eventType": { "enum": ["project-registration", "adoption-apply"] },
+    "actor": { "type": ["string", "null"], "minLength": 1 },
+    "packageVersion": { "type": "string", "minLength": 1 },
+    "protocolVersion": { "const": 1 },
+    "stateSchemaVersion": { "const": 2 },
+    "adoptionBoundaryAt": { "type": "string", "format": "date-time" },
+    "baselineDigestHash": { "$ref": "#/$defs/hash64" },
+    "sidecarBaselineHash": { "$ref": "#/$defs/hash64" },
+    "confirmationCodeBindingHash": { "$ref": "#/$defs/nullableHash64" },
+    "repositoryIdentity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["repositoryRoot", "gitCommonDir"],
+      "properties": {
+        "repositoryRoot": { "type": "string", "minLength": 1 },
+        "gitCommonDir": { "type": "string", "minLength": 1 }
+      }
+    },
+    "terminalMilestones": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["milestoneId", "revision", "status"],
+        "properties": {
+          "milestoneId": { "$ref": "#/$defs/milestoneId" },
+          "revision": { "type": "integer", "minimum": 1 },
+          "status": { "enum": ["accepted", "cancelled"] }
+        }
+      }
+    },
+    "terminalTasks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["taskId", "revision", "status"],
+        "properties": {
+          "taskId": { "$ref": "#/$defs/taskId" },
+          "revision": { "type": "integer", "minimum": 1 },
+          "status": { "enum": ["merged", "cancelled"] }
+        }
+      }
+    },
+    "activeTasks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["taskId", "taskRevision", "status", "completedSteps", "remainingStepIds"],
+        "properties": {
+          "taskId": { "$ref": "#/$defs/taskId" },
+          "taskRevision": { "type": "integer", "minimum": 1 },
+          "status": {
+            "enum": [
+              "planning",
+              "awaiting_execution_authorization",
+              "ready",
+              "in_progress",
+              "validating",
+              "needs_fix",
+              "awaiting_final_acceptance",
+              "merging",
+              "ready_to_merge",
+              "blocked"
+            ]
+          },
+          "completedSteps": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["stepId", "status", "evidenceHash"],
+              "properties": {
+                "stepId": { "$ref": "#/$defs/stepId" },
+                "status": { "enum": ["completed", "skipped"] },
+                "evidenceHash": { "$ref": "#/$defs/nullableHash64" }
+              }
+            }
+          },
+          "remainingStepIds": {
+            "type": "array",
+            "uniqueItems": true,
+            "items": { "$ref": "#/$defs/stepId" }
+          }
+        }
+      }
+    },
+    "previousEventHash": { "$ref": "#/$defs/nullableHash64" },
+    "recordedAt": { "type": "string", "format": "date-time" },
+    "eventHash": { "$ref": "#/$defs/hash64" }
+  },
+  "$defs": {
+    "milestoneId": { "type": "string", "pattern": "^MS-[0-9A-HJKMNP-TV-Z]{26}$" },
+    "taskId": { "type": "string", "pattern": "^TASK-[0-9A-HJKMNP-TV-Z]{26}$" },
+    "stepId": { "type": "string", "pattern": "^STEP-[0-9]{3}(?:-[A-Z0-9-]+)?$" },
+    "hash64": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "nullableHash64": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" }
+  }
+}

package/schemas/corrective-decision-event.schema.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://codex-workflow.local/schemas/corrective-decision-event.schema.json",
+  "title": "Codex Workflow V2 Alpha.6 Corrective Decision Event",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "eventId",
+    "taskId",
+    "stepId",
+    "triggeringAttemptCount",
+    "decision",
+    "auditor",
+    "coveredFindingIds",
+    "coveredEventIds",
+    "planHash",
+    "previousEventHash",
+    "recordedAt",
+    "eventHash"
+  ],
+  "properties": {
+    "eventId": { "type": "string", "minLength": 1 },
+    "taskId": { "$ref": "#/$defs/taskId" },
+    "stepId": { "$ref": "#/$defs/stepId" },
+    "triggeringAttemptCount": { "type": "integer", "minimum": 3 },
+    "decision": {
+      "enum": ["continue-fix", "replan-required", "split-required", "stop-escalate"]
+    },
+    "auditor": { "type": "string", "minLength": 1 },
+    "coveredFindingIds": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "coveredEventIds": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "planHash": { "$ref": "#/$defs/hash64" },
+    "previousEventHash": { "$ref": "#/$defs/nullableHash64" },
+    "recordedAt": { "type": "string", "format": "date-time" },
+    "eventHash": { "$ref": "#/$defs/hash64" }
+  },
+  "anyOf": [
+    { "properties": { "coveredFindingIds": { "minItems": 1 } } },
+    { "properties": { "coveredEventIds": { "minItems": 1 } } }
+  ],
+  "$defs": {
+    "taskId": { "type": "string", "pattern": "^TASK-[0-9A-HJKMNP-TV-Z]{26}$" },
+    "stepId": { "type": "string", "pattern": "^STEP-[0-9]{3}(?:-[A-Z0-9-]+)?$" },
+    "hash64": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "nullableHash64": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" }
+  }
+}

package/schemas/corrective-plan-audit.schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://codex-workflow.local/schemas/corrective-plan-audit.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["auditor", "summary", "decision", "reviewedFindingIds"],
+  "properties": {
+    "auditor": { "type": "string", "minLength": 1 },
+    "summary": { "type": "string", "minLength": 1 },
+    "decision": {
+      "enum": ["continue-fix", "replan-required", "split-required", "stop-escalate"]
+    },
+    "reviewedFindingIds": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    }
+  }
+}

package/schemas/milestone-scope-change-event.schema.json

@@ -0,0 +1,68 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://codex-workflow.local/schemas/milestone-scope-change-event.schema.json",
+  "title": "Codex Workflow V2 Alpha.6 Milestone Scope Change Event",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "eventId",
+    "milestoneId",
+    "previousMilestoneRevision",
+    "previousPlanHash",
+    "previousMembershipRevision",
+    "candidatePlanHash",
+    "candidateMembershipRevision",
+    "before",
+    "after",
+    "actor",
+    "confirmationCodeBindingHash",
+    "previousEventHash",
+    "recordedAt",
+    "eventHash"
+  ],
+  "properties": {
+    "eventId": { "type": "string", "minLength": 1 },
+    "milestoneId": { "$ref": "#/$defs/milestoneId" },
+    "previousMilestoneRevision": { "type": "integer", "minimum": 1 },
+    "previousPlanHash": { "$ref": "#/$defs/nullableHash64" },
+    "previousMembershipRevision": { "type": "integer", "minimum": 0 },
+    "candidatePlanHash": { "$ref": "#/$defs/hash64" },
+    "candidateMembershipRevision": { "type": "integer", "minimum": 0 },
+    "before": { "$ref": "#/$defs/scopeSnapshot" },
+    "after": { "$ref": "#/$defs/scopeSnapshot" },
+    "actor": { "type": "string", "minLength": 1 },
+    "confirmationCodeBindingHash": { "$ref": "#/$defs/hash64" },
+    "previousEventHash": { "$ref": "#/$defs/nullableHash64" },
+    "recordedAt": { "type": "string", "format": "date-time" },
+    "eventHash": { "$ref": "#/$defs/hash64" }
+  },
+  "$defs": {
+    "milestoneId": { "type": "string", "pattern": "^MS-[0-9A-HJKMNP-TV-Z]{26}$" },
+    "taskId": { "type": "string", "pattern": "^TASK-[0-9A-HJKMNP-TV-Z]{26}$" },
+    "hash64": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "nullableHash64": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" },
+    "membership": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["taskId", "disposition", "reason"],
+      "properties": {
+        "taskId": { "$ref": "#/$defs/taskId" },
+        "disposition": { "enum": ["required", "waived", "cancelled"] },
+        "reason": { "type": "string" }
+      }
+    },
+    "scopeSnapshot": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["outcome", "successSignal", "acceptance", "checks", "taskIds", "memberships"],
+      "properties": {
+        "outcome": { "type": "string" },
+        "successSignal": { "type": "string" },
+        "acceptance": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+        "checks": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+        "taskIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/taskId" } },
+        "memberships": { "type": "array", "items": { "$ref": "#/$defs/membership" } }
+      }
+    }
+  }
+}

package/schemas/milestone-transaction-journal.schema.json

@@ -0,0 +1,95 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://codex-workflow.local/schemas/milestone-transaction-journal.schema.json",
+  "title": "Codex Workflow V2 Alpha.6 Milestone Transaction Journal",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "transactionId",
+    "milestoneId",
+    "expectedMilestoneRevision",
+    "actor",
+    "confirmationCodeBindingHash",
+    "phase",
+    "targetFiles",
+    "preparedAt",
+    "updatedAt"
+  ],
+  "properties": {
+    "transactionId": { "type": "string", "minLength": 1 },
+    "milestoneId": { "$ref": "#/$defs/milestoneId" },
+    "expectedMilestoneRevision": { "type": "integer", "minimum": 1 },
+    "actor": { "type": "string", "minLength": 1 },
+    "confirmationCodeBindingHash": { "$ref": "#/$defs/hash64" },
+    "phase": { "enum": ["prepared", "applying", "applied", "rolled_back"] },
+    "targetFiles": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["path", "preimage", "staged"],
+        "properties": {
+          "path": { "type": "string", "minLength": 1 },
+          "preimage": { "$ref": "#/$defs/fileSnapshot" },
+          "staged": { "$ref": "#/$defs/fileSnapshot" }
+        }
+      }
+    },
+    "preparedAt": { "type": "string", "format": "date-time" },
+    "updatedAt": { "type": "string", "format": "date-time" }
+  },
+  "$defs": {
+    "milestoneId": { "type": "string", "pattern": "^MS-[0-9A-HJKMNP-TV-Z]{26}$" },
+    "hash64": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "fileSnapshot": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["exists", "contentHash", "contentBase64", "contentPath"],
+      "properties": {
+        "exists": { "type": "boolean" },
+        "contentHash": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" },
+        "contentBase64": { "type": ["string", "null"], "minLength": 1 },
+        "contentPath": { "type": ["string", "null"], "minLength": 1 }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": { "exists": { "const": true } },
+            "required": ["exists"]
+          },
+          "then": {
+            "properties": {
+              "contentHash": { "$ref": "#/$defs/hash64" }
+            },
+            "anyOf": [
+              {
+                "properties": {
+                  "contentBase64": { "type": "string", "minLength": 1 }
+                }
+              },
+              {
+                "properties": {
+                  "contentPath": { "type": "string", "minLength": 1 }
+                }
+              }
+            ]
+          }
+        },
+        {
+          "if": {
+            "properties": { "exists": { "const": false } },
+            "required": ["exists"]
+          },
+          "then": {
+            "properties": {
+              "contentHash": { "const": null },
+              "contentBase64": { "const": null },
+              "contentPath": { "const": null }
+            }
+          }
+        }
+      ]
+    }
+  }
+}

package/schemas/plan-risk-audit-event.schema.json

@@ -0,0 +1,90 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://codex-workflow.local/schemas/plan-risk-audit-event.schema.json",
+  "title": "Codex Workflow V2 Alpha.6 Plan Risk Audit Event",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "eventId",
+    "taskId",
+    "taskRevision",
+    "briefHash",
+    "planHash",
+    "knowledgeMapRevision",
+    "knowledgeMapHash",
+    "planner",
+    "auditor",
+    "summary",
+    "decision",
+    "splitRationale",
+    "stepClassifications",
+    "previousEventHash",
+    "recordedAt",
+    "eventHash"
+  ],
+  "properties": {
+    "eventId": { "type": "string", "minLength": 1 },
+    "taskId": { "$ref": "#/$defs/taskId" },
+    "taskRevision": { "type": "integer", "minimum": 1 },
+    "briefHash": { "$ref": "#/$defs/hash64" },
+    "planHash": { "$ref": "#/$defs/hash64" },
+    "knowledgeMapRevision": { "type": "integer", "minimum": 1 },
+    "knowledgeMapHash": { "$ref": "#/$defs/hash64" },
+    "planner": { "type": "string", "minLength": 1 },
+    "auditor": { "type": "string", "minLength": 1 },
+    "summary": { "type": "string", "minLength": 1 },
+    "decision": { "enum": ["approved", "approved-with-rationale", "split-required", "stop-escalate"] },
+    "splitRationale": { "type": ["string", "null"], "minLength": 1 },
+    "stepClassifications": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/stepClassification" }
+    },
+    "previousEventHash": { "$ref": "#/$defs/nullableHash64" },
+    "recordedAt": { "type": "string", "format": "date-time" },
+    "eventHash": { "$ref": "#/$defs/hash64" }
+  },
+  "$defs": {
+    "taskId": { "type": "string", "pattern": "^TASK-[0-9A-HJKMNP-TV-Z]{26}$" },
+    "stepId": { "type": "string", "pattern": "^STEP-[0-9]{3}(?:-[A-Z0-9-]+)?$" },
+    "hash64": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "nullableHash64": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" },
+    "guardedRiskCategory": {
+      "enum": ["migration", "concurrency", "restart-replay", "crash-window", "external-provider", "runtime-composition", "security-boundary", "auth-secrets", "irreversible-execution"]
+    },
+    "stepClassification": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["stepId", "categories", "reviewRequired", "failureModes", "requiredEvidence"],
+      "properties": {
+        "stepId": { "$ref": "#/$defs/stepId" },
+        "categories": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": { "$ref": "#/$defs/guardedRiskCategory" }
+        },
+        "reviewRequired": { "type": "boolean" },
+        "failureModes": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+        "requiredEvidence": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
+      },
+      "oneOf": [
+        {
+          "properties": {
+            "categories": { "maxItems": 0 },
+            "reviewRequired": { "const": false },
+            "failureModes": { "maxItems": 0 },
+            "requiredEvidence": { "maxItems": 0 }
+          }
+        },
+        {
+          "properties": {
+            "categories": { "minItems": 1 },
+            "reviewRequired": { "const": true },
+            "failureModes": { "minItems": 1 },
+            "requiredEvidence": { "minItems": 1 }
+          }
+        }
+      ]
+    }
+  }
+}

package/schemas/remediation-event.schema.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://codex-workflow.local/schemas/remediation-event.schema.json",
+  "title": "Codex Workflow V2 Alpha.6 Remediation Event",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "eventId",
+    "taskId",
+    "stepId",
+    "guardedCategory",
+    "failureKind",
+    "failureEvidence",
+    "attemptOrdinal",
+    "mode",
+    "previousEventHash",
+    "recordedAt",
+    "eventHash"
+  ],
+  "properties": {
+    "eventId": { "type": "string", "minLength": 1 },
+    "taskId": { "$ref": "#/$defs/taskId" },
+    "stepId": { "$ref": "#/$defs/stepId" },
+    "guardedCategory": { "$ref": "#/$defs/guardedRiskCategory" },
+    "failureKind": { "enum": ["checks-failed", "review-failed", "review-unverified"] },
+    "failureEvidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["completionCommit", "checksHash", "reviewEventHash", "reviewerAttestationHash"],
+      "properties": {
+        "completionCommit": { "$ref": "#/$defs/gitHash" },
+        "checksHash": { "$ref": "#/$defs/hash64" },
+        "reviewEventHash": { "$ref": "#/$defs/nullableHash64" },
+        "reviewerAttestationHash": { "$ref": "#/$defs/nullableHash64" }
+      }
+    },
+    "attemptOrdinal": { "type": "integer", "minimum": 1 },
+    "mode": { "enum": ["ordinary", "corrective"] },
+    "previousEventHash": { "$ref": "#/$defs/nullableHash64" },
+    "recordedAt": { "type": "string", "format": "date-time" },
+    "eventHash": { "$ref": "#/$defs/hash64" }
+  },
+  "$defs": {
+    "taskId": { "type": "string", "pattern": "^TASK-[0-9A-HJKMNP-TV-Z]{26}$" },
+    "stepId": { "type": "string", "pattern": "^STEP-[0-9]{3}(?:-[A-Z0-9-]+)?$" },
+    "guardedRiskCategory": {
+      "enum": ["migration", "concurrency", "restart-replay", "crash-window", "external-provider"]
+    },
+    "hash64": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "nullableHash64": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" },
+    "gitHash": { "type": "string", "pattern": "^[a-f0-9]{40,64}$" }
+  }
+}

package/schemas/reviewer-attestation-event.schema.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://codex-workflow.local/schemas/reviewer-attestation-event.schema.json",
+  "title": "Codex Workflow V2 Alpha.6 Reviewer Attestation Event",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "eventId",
+    "taskId",
+    "stepId",
+    "reviewer",
+    "isolationResult",
+    "outputHash",
+    "reviewedCommit",
+    "reviewEventHash",
+    "planHash",
+    "evidenceHash",
+    "previousEventHash",
+    "recordedAt",
+    "eventHash"
+  ],
+  "properties": {
+    "eventId": { "type": "string", "minLength": 1 },
+    "taskId": { "$ref": "#/$defs/taskId" },
+    "stepId": {
+      "oneOf": [
+        { "$ref": "#/$defs/stepId" },
+        { "const": "TASK_FINAL" }
+      ]
+    },
+    "reviewer": { "type": "string", "minLength": 1 },
+    "isolationResult": { "enum": ["verified", "unverified"] },
+    "outputHash": { "$ref": "#/$defs/hash64" },
+    "reviewedCommit": { "$ref": "#/$defs/gitHash" },
+    "reviewEventHash": { "$ref": "#/$defs/hash64" },
+    "planHash": { "$ref": "#/$defs/hash64" },
+    "evidenceHash": { "$ref": "#/$defs/nullableHash64" },
+    "previousEventHash": { "$ref": "#/$defs/nullableHash64" },
+    "recordedAt": { "type": "string", "format": "date-time" },
+    "eventHash": { "$ref": "#/$defs/hash64" }
+  },
+  "$defs": {
+    "taskId": { "type": "string", "pattern": "^TASK-[0-9A-HJKMNP-TV-Z]{26}$" },
+    "stepId": { "type": "string", "pattern": "^STEP-[0-9]{3}(?:-[A-Z0-9-]+)?$" },
+    "hash64": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "nullableHash64": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" },
+    "gitHash": { "type": "string", "pattern": "^[a-f0-9]{40,64}$" }
+  }
+}

package/schemas/step-review-event.schema.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://codex-workflow.local/schemas/step-review-event.schema.json",
+  "title": "Codex Workflow V2 Alpha.6 Step Review Event",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "eventId",
+    "taskId",
+    "taskRevision",
+    "stepId",
+    "stepDefinitionHash",
+    "completionCommit",
+    "checksHash",
+    "planHash",
+    "evidenceHash",
+    "eventType",
+    "decision",
+    "reviewerAttestationHash",
+    "previousEventHash",
+    "recordedAt",
+    "eventHash"
+  ],
+  "properties": {
+    "eventId": { "type": "string", "minLength": 1 },
+    "taskId": { "$ref": "#/$defs/taskId" },
+    "taskRevision": { "type": "integer", "minimum": 1 },
+    "stepId": { "$ref": "#/$defs/stepId" },
+    "stepDefinitionHash": { "$ref": "#/$defs/hash64" },
+    "completionCommit": { "$ref": "#/$defs/gitHash" },
+    "checksHash": { "$ref": "#/$defs/hash64" },
+    "planHash": { "$ref": "#/$defs/hash64" },
+    "evidenceHash": { "$ref": "#/$defs/nullableHash64" },
+    "eventType": { "enum": ["pending", "review-recorded", "attestation-verified"] },
+    "decision": { "enum": ["pending", "passed", "failed", "unverified"] },
+    "reviewerAttestationHash": { "$ref": "#/$defs/nullableHash64" },
+    "previousEventHash": { "$ref": "#/$defs/nullableHash64" },
+    "recordedAt": { "type": "string", "format": "date-time" },
+    "eventHash": { "$ref": "#/$defs/hash64" }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": { "eventType": { "const": "pending" } },
+        "required": ["eventType"]
+      },
+      "then": {
+        "properties": {
+          "decision": { "const": "pending" },
+          "reviewerAttestationHash": { "const": null }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": { "eventType": { "const": "attestation-verified" } },
+        "required": ["eventType"]
+      },
+      "then": {
+        "properties": {
+          "decision": { "enum": ["passed", "failed", "unverified"] },
+          "reviewerAttestationHash": { "$ref": "#/$defs/hash64" }
+        }
+      }
+    }
+  ],
+  "$defs": {
+    "taskId": { "type": "string", "pattern": "^TASK-[0-9A-HJKMNP-TV-Z]{26}$" },
+    "stepId": { "type": "string", "pattern": "^STEP-[0-9]{3}(?:-[A-Z0-9-]+)?$" },
+    "hash64": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "nullableHash64": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" },
+    "gitHash": { "type": "string", "pattern": "^[a-f0-9]{40,64}$" }
+  }
+}