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

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