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

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}$" }
+  }
+}

package/schemas/task-handoff-event.schema.json

@@ -0,0 +1,116 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://codex-workflow.local/schemas/task-handoff-event.schema.json",
+  "title": "Codex Workflow V2 Alpha.6 Task Handoff Event",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "eventId",
+    "handoffId",
+    "taskId",
+    "taskRevision",
+    "milestoneId",
+    "milestoneDisplayNumber",
+    "taskDisplayNumber",
+    "briefHash",
+    "planHash",
+    "knowledgeMapRevision",
+    "knowledgeMapHash",
+    "expectedNext",
+    "delegate",
+    "grantId",
+    "claimTokenHash",
+    "expiresAt",
+    "eventType",
+    "coordinationLevel",
+    "actor",
+    "targetActor",
+    "machineEvidence",
+    "writerLeaseTokenHash",
+    "reason",
+    "handback",
+    "previousEventHash",
+    "recordedAt",
+    "eventHash"
+  ],
+  "properties": {
+    "eventId": { "type": "string", "minLength": 1 },
+    "handoffId": { "type": "string", "pattern": "^THO-[0-9A-HJKMNP-TV-Z]{26}$" },
+    "taskId": { "$ref": "#/$defs/taskId" },
+    "taskRevision": { "type": "integer", "minimum": 1 },
+    "milestoneId": { "type": ["string", "null"], "pattern": "^MS-[0-9A-HJKMNP-TV-Z]{26}$" },
+    "milestoneDisplayNumber": { "type": ["integer", "null"], "minimum": 1 },
+    "taskDisplayNumber": { "type": ["integer", "null"], "minimum": 1 },
+    "briefHash": { "$ref": "#/$defs/hash64" },
+    "planHash": { "$ref": "#/$defs/nullableHash64" },
+    "knowledgeMapRevision": { "type": ["integer", "null"], "minimum": 1 },
+    "knowledgeMapHash": { "$ref": "#/$defs/nullableHash64" },
+    "expectedNext": { "type": "string", "minLength": 1 },
+    "delegate": { "type": "string", "minLength": 1 },
+    "grantId": { "type": ["string", "null"], "minLength": 1 },
+    "claimTokenHash": { "$ref": "#/$defs/hash64" },
+    "expiresAt": { "type": "string", "format": "date-time" },
+    "eventType": { "enum": ["handoff", "claim", "handback"] },
+    "coordinationLevel": { "const": "C1" },
+    "actor": { "type": "string", "minLength": 1 },
+    "targetActor": { "type": ["string", "null"], "minLength": 1 },
+    "machineEvidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["hostname", "pid", "platform", "arch", "nodeVersion"],
+      "properties": {
+        "hostname": { "type": "string", "minLength": 1 },
+        "pid": { "type": "integer", "minimum": 1 },
+        "platform": { "type": "string", "minLength": 1 },
+        "arch": { "type": "string", "minLength": 1 },
+        "nodeVersion": { "type": "string", "minLength": 1 }
+      }
+    },
+    "writerLeaseTokenHash": { "$ref": "#/$defs/nullableHash64" },
+    "reason": { "type": "string", "minLength": 1 },
+    "handback": {
+      "oneOf": [
+        { "type": "null" },
+        { "$ref": "#/$defs/handback" }
+      ]
+    },
+    "previousEventHash": { "$ref": "#/$defs/nullableHash64" },
+    "recordedAt": { "type": "string", "format": "date-time" },
+    "eventHash": { "$ref": "#/$defs/hash64" }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": { "eventType": { "const": "handoff" } },
+        "required": ["eventType"]
+      },
+      "then": {
+        "properties": {
+          "targetActor": { "type": "string", "minLength": 1 }
+        }
+      }
+    }
+  ],
+  "$defs": {
+    "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}$" }
+    ,"handback": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "mergedCommit", "planHash", "resultHash", "evidenceHash", "reviewAttestationHash", "knowledgeMapRevision", "knowledgeMapHash", "limitations", "recommendedNext"],
+      "properties": {
+        "status": { "enum": ["merged", "cancelled"] },
+        "mergedCommit": { "type": ["string", "null"], "pattern": "^[a-f0-9]{40,64}$" },
+        "planHash": { "$ref": "#/$defs/nullableHash64" },
+        "resultHash": { "$ref": "#/$defs/nullableHash64" },
+        "evidenceHash": { "$ref": "#/$defs/nullableHash64" },
+        "reviewAttestationHash": { "$ref": "#/$defs/nullableHash64" },
+        "knowledgeMapRevision": { "type": ["integer", "null"], "minimum": 1 },
+        "knowledgeMapHash": { "$ref": "#/$defs/nullableHash64" },
+        "limitations": { "type": "array", "items": { "type": "string" } },
+        "recommendedNext": { "type": "string", "minLength": 1 }
+      }
+    }
+  }
+}