@openplanr/protocol 0.2.0

package/schemas/v2.0.0/operating-event.schema.json

@@ -0,0 +1,505 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-event.schema.json",
+  "x-openplanr-contract": { "id": "operating-event", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 operating event",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "eventId", "sequence", "timestamp", "cycleId", "type", "entityId", "actor", "causationId", "correlationId", "previousEventHash", "payload", "eventHash"],
+  "properties": {
+    "kind": { "const": "operating-event" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "eventId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "description": "Durable Event identity. Reuse is permitted only for an identical canonical Event retry; divergent content fails closed."
+    },
+    "sequence": { "type": "integer", "minimum": 1 },
+    "timestamp": { "type": "string", "format": "date-time" },
+    "cycleId": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "type": { "type": "string", "enum": ["planning-delivery.ingested", "cycle.input-bound", "assignment.created", "assignment.available", "assignment.claimed", "assignment.started", "assignment.submitted", "artifact.created", "assignment.validated", "assignment.rejected", "assignment.abandoned", "assignment.failed", "executive-board.materialized", "review.created", "review.submitted", "work-change-set.materialized", "action.authority-promoted", "evidence.resolved", "evidence.rejected", "operating-state.materialized", "snapshot.materialized", "metric.observed", "claim.recorded", "finding.recorded", "risk.recorded", "assumption.recorded", "decision.revised", "delta.derived", "intelligence.plan-recorded", "decision-ledger.materialized", "verification.plan-recorded", "outcome.recorded", "learning.recorded", "scenario.recorded", "trigger.recorded", "domain-projection.rebuilt", "policy.evaluated", "approval.recorded", "capability.availability-recorded", "capability.granted", "operation.intent-recorded", "execution.result-recorded", "rollback.plan-recorded", "rollback.result-recorded", "action.approved", "action.cancelled", "action.rejected", "action.deferred", "action.reopened", "action.queued", "action.started", "action.completed", "action.blocked", "cycle.approved", "cycle.executing", "cycle.verifying", "cycle.closed"] },
+    "entityId": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "actor": {
+      "type": "object", "additionalProperties": false, "required": ["kind", "id"],
+      "properties": {
+        "kind": { "type": "string", "enum": ["human", "engine", "runtime"] },
+        "id": { "type": "string", "minLength": 1, "maxLength": 128 }
+      }
+    },
+    "causationId": { "type": ["string", "null"], "maxLength": 128 },
+    "correlationId": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "previousEventHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" },
+    "requestHash": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$",
+      "description": "Canonical hash of a closed runtime-owned request and draft. Intelligence Events require it so an Event identity can replay only the exact request."
+    },
+    "payload": {},
+    "eventHash": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$",
+      "description": "SHA-256 JCS digest of the complete Event content excluding this field; it is the canonical same-content comparison for Event identity replay."
+    }
+  },
+  "oneOf": [
+    { "title": "planning-delivery.ingested", "required": ["requestHash"], "properties": { "type": { "const": "planning-delivery.ingested" }, "payload": { "$ref": "#/$defs/planningDeliveryIngested" } } },
+    { "title": "cycle.input-bound", "properties": { "type": { "const": "cycle.input-bound" }, "payload": { "$ref": "#/$defs/inputBound" } } },
+    { "title": "assignment.created", "properties": { "type": { "const": "assignment.created" }, "payload": { "allOf": [{ "$ref": "operating-assignment.schema.json" }, { "properties": { "state": { "const": "pending" }, "availableAt": { "const": null }, "completedAt": { "const": null }, "claim": { "const": null } } }] } } },
+    { "title": "assignment.available", "properties": { "type": { "const": "assignment.available" }, "payload": { "$ref": "#/$defs/assignmentAvailable" } } },
+    { "title": "assignment.claimed", "properties": { "type": { "const": "assignment.claimed" }, "payload": { "$ref": "#/$defs/assignmentClaimed" } } },
+    { "title": "assignment.started", "properties": { "type": { "const": "assignment.started" }, "payload": { "$ref": "#/$defs/assignmentStarted" } } },
+    { "title": "assignment.submitted", "properties": { "type": { "const": "assignment.submitted" }, "payload": { "$ref": "#/$defs/assignmentSubmitted" } } },
+    { "title": "artifact.created", "properties": { "type": { "const": "artifact.created" }, "payload": { "$ref": "operating-artifact.schema.json" } } },
+    { "title": "assignment.validated", "properties": { "type": { "const": "assignment.validated" }, "payload": { "$ref": "#/$defs/assignmentValidated" } } },
+    { "title": "assignment.rejected", "properties": { "type": { "const": "assignment.rejected" }, "payload": { "$ref": "#/$defs/assignmentRejected" } } },
+    { "title": "assignment.abandoned", "properties": { "type": { "const": "assignment.abandoned" }, "payload": { "$ref": "#/$defs/assignmentAbandoned" } } },
+    { "title": "assignment.failed", "properties": { "type": { "const": "assignment.failed" }, "payload": { "$ref": "#/$defs/assignmentFailed" } } },
+    {
+      "title": "executive-board.materialized",
+      "properties": {
+        "type": { "const": "executive-board.materialized" },
+        "payload": {
+          "allOf": [
+            { "$ref": "operating-executive-board.schema.json" },
+            {
+              "properties": {
+                "projectionMode": { "const": "materialized" },
+                "authoritativeForMutation": { "const": true },
+                "materializedEventId": { "type": "string" }
+              }
+            }
+          ]
+        }
+      }
+    },
+    { "title": "review.created", "properties": { "type": { "const": "review.created" }, "payload": { "allOf": [{ "$ref": "operating-review.schema.json" }, { "properties": { "state": { "const": "pending" }, "disposition": { "const": null } } }] } } },
+    { "title": "review.submitted", "properties": { "type": { "const": "review.submitted" }, "payload": { "$ref": "#/$defs/reviewSubmitted" } } },
+    { "title": "work-change-set.materialized", "properties": { "type": { "const": "work-change-set.materialized" }, "payload": { "$ref": "#/$defs/workChangeSetMaterialized" } } },
+    { "title": "action.authority-promoted", "required": ["requestHash"], "properties": { "type": { "const": "action.authority-promoted" }, "payload": { "$ref": "#/$defs/actionAuthorityPromoted" } } },
+    { "title": "evidence.resolved", "properties": { "type": { "const": "evidence.resolved" }, "payload": { "$ref": "#/$defs/evidenceResolved" } } },
+    { "title": "evidence.rejected", "properties": { "type": { "const": "evidence.rejected" }, "payload": { "$ref": "#/$defs/evidenceRejected" } } },
+    { "title": "operating-state.materialized", "properties": { "type": { "const": "operating-state.materialized" }, "payload": { "$ref": "operating-model-state.schema.json" } } },
+    { "title": "snapshot.materialized", "properties": { "type": { "const": "snapshot.materialized" }, "payload": { "$ref": "operating-snapshot.schema.json" } } },
+    { "title": "metric.observed", "required": ["requestHash"], "properties": { "type": { "const": "metric.observed" }, "payload": { "$ref": "#/$defs/metricObservationRecorded" } } },
+    { "title": "claim.recorded", "required": ["requestHash"], "properties": { "type": { "const": "claim.recorded" }, "payload": { "$ref": "#/$defs/claimRecorded" } } },
+    { "title": "finding.recorded", "required": ["requestHash"], "properties": { "type": { "const": "finding.recorded" }, "payload": { "$ref": "#/$defs/findingRecorded" } } },
+    { "title": "risk.recorded", "required": ["requestHash"], "properties": { "type": { "const": "risk.recorded" }, "payload": { "$ref": "#/$defs/riskRecorded" } } },
+    { "title": "assumption.recorded", "required": ["requestHash"], "properties": { "type": { "const": "assumption.recorded" }, "payload": { "$ref": "#/$defs/assumptionRecorded" } } },
+    { "title": "decision.revised", "required": ["requestHash"], "properties": { "type": { "const": "decision.revised" }, "payload": { "$ref": "#/$defs/decisionRevised" } } },
+    { "title": "delta.derived", "required": ["requestHash"], "properties": { "type": { "const": "delta.derived" }, "payload": { "$ref": "#/$defs/deltaDerived" } } },
+    { "title": "intelligence.plan-recorded", "properties": { "type": { "const": "intelligence.plan-recorded" }, "payload": { "$ref": "operating-intelligence-plan.schema.json" } } },
+    { "title": "decision-ledger.materialized", "properties": { "type": { "const": "decision-ledger.materialized" }, "payload": { "$ref": "operating-decision-ledger.schema.json" } } },
+    { "title": "verification.plan-recorded", "properties": { "type": { "const": "verification.plan-recorded" }, "payload": { "$ref": "operating-action-verification-plan.schema.json" } } },
+    { "title": "outcome.recorded", "properties": { "type": { "const": "outcome.recorded" }, "payload": { "$ref": "operating-outcome.schema.json" } } },
+    { "title": "learning.recorded", "properties": { "type": { "const": "learning.recorded" }, "payload": { "$ref": "operating-learning.schema.json" } } },
+    { "title": "scenario.recorded", "required": ["requestHash"], "properties": { "type": { "const": "scenario.recorded" }, "payload": { "$ref": "#/$defs/scenarioRecorded" } } },
+    { "title": "trigger.recorded", "required": ["requestHash"], "properties": { "type": { "const": "trigger.recorded" }, "payload": { "$ref": "#/$defs/triggerRecorded" } } },
+    { "title": "domain-projection.rebuilt", "properties": { "type": { "const": "domain-projection.rebuilt" }, "payload": { "$ref": "operating-domain-projection.schema.json" } } },
+    { "title": "policy.evaluated", "required": ["requestHash"], "properties": { "type": { "const": "policy.evaluated" }, "payload": { "$ref": "operating-policy-evaluation.schema.json" } } },
+    { "title": "approval.recorded", "properties": { "type": { "const": "approval.recorded" }, "payload": { "$ref": "operating-approval-record.schema.json" } } },
+    { "title": "capability.availability-recorded", "properties": { "type": { "const": "capability.availability-recorded" }, "payload": { "$ref": "operating-capability-availability.schema.json" } } },
+    { "title": "capability.granted", "properties": { "type": { "const": "capability.granted" }, "payload": { "$ref": "operating-capability-grant.schema.json" } } },
+    { "title": "operation.intent-recorded", "required": ["requestHash"], "properties": { "type": { "const": "operation.intent-recorded" }, "payload": { "$ref": "#/$defs/operationIntent" } } },
+    { "title": "execution.result-recorded", "properties": { "type": { "const": "execution.result-recorded" }, "payload": { "$ref": "#/$defs/executionResultRecorded" } } },
+    { "title": "rollback.plan-recorded", "properties": { "type": { "const": "rollback.plan-recorded" }, "payload": { "$ref": "operating-rollback-plan.schema.json" } } },
+    { "title": "rollback.result-recorded", "properties": { "type": { "const": "rollback.result-recorded" }, "payload": { "$ref": "operating-rollback-result.schema.json" } } },
+    { "title": "action.approved", "properties": { "type": { "const": "action.approved" }, "payload": { "allOf": [{ "$ref": "#/$defs/actionTransition" }, { "properties": { "from": { "const": "proposed" }, "to": { "const": "approved" }, "operationId": { "const": null }, "resultId": { "const": null }, "reasonCode": { "const": null } } }] } } },
+    { "title": "action.cancelled", "properties": { "type": { "const": "action.cancelled" }, "payload": { "allOf": [{ "$ref": "#/$defs/actionTransition" }, { "oneOf": [
+      { "properties": { "from": { "const": "approved" }, "to": { "const": "cancelled" }, "operationId": { "const": null }, "resultId": { "const": null }, "reasonCode": { "type": "string" } } },
+      { "properties": { "from": { "enum": ["queued", "in_progress"] }, "to": { "const": "cancelled" }, "operationId": { "type": "string" }, "resultId": { "const": null }, "reasonCode": { "type": "string" } } }
+    ] }] } } },
+    { "title": "action.rejected", "properties": { "type": { "const": "action.rejected" }, "payload": { "allOf": [{ "$ref": "#/$defs/actionTransition" }, { "properties": { "from": { "const": "proposed" }, "to": { "const": "rejected" }, "operationId": { "const": null }, "resultId": { "const": null }, "reasonCode": { "type": "string" } } }] } } },
+    { "title": "action.deferred", "properties": { "type": { "const": "action.deferred" }, "payload": { "allOf": [{ "$ref": "#/$defs/actionTransition" }, { "properties": { "from": { "const": "proposed" }, "to": { "const": "deferred" }, "operationId": { "const": null }, "resultId": { "const": null }, "reasonCode": { "type": "string" } } }] } } },
+    { "title": "action.reopened", "properties": { "type": { "const": "action.reopened" }, "payload": { "allOf": [{ "$ref": "#/$defs/actionTransition" }, { "properties": { "from": { "const": "deferred" }, "to": { "const": "proposed" }, "operationId": { "const": null }, "resultId": { "const": null }, "reasonCode": { "const": null } } }] } } },
+    { "title": "action.queued", "properties": { "type": { "const": "action.queued" }, "payload": { "allOf": [{ "$ref": "#/$defs/actionTransition" }, { "oneOf": [
+      { "properties": { "from": { "const": "approved" }, "to": { "const": "queued" }, "operationId": { "type": "string" }, "resultId": { "const": null }, "reasonCode": { "const": null } } },
+      { "properties": { "from": { "const": "blocked" }, "to": { "const": "queued" }, "operationId": { "type": "string" }, "resultId": { "type": "string" }, "reasonCode": { "type": "string" } } }
+    ] }] } } },
+    { "title": "action.started", "properties": { "type": { "const": "action.started" }, "payload": { "allOf": [{ "$ref": "#/$defs/actionTransition" }, { "oneOf": [
+      { "properties": { "from": { "const": "queued" }, "to": { "const": "in_progress" }, "operationId": { "type": "string" }, "resultId": { "const": null }, "reasonCode": { "const": null } } },
+      { "properties": { "from": { "const": "blocked" }, "to": { "const": "in_progress" }, "operationId": { "type": "string" }, "resultId": { "type": "string" }, "reasonCode": { "type": "string" } } }
+    ] }] } } },
+    { "title": "action.completed", "properties": { "type": { "const": "action.completed" }, "payload": { "allOf": [{ "$ref": "#/$defs/actionTransition" }, { "properties": { "from": { "const": "in_progress" }, "to": { "const": "completed" }, "operationId": { "type": "string" }, "resultId": { "type": "string" }, "reasonCode": { "const": null } } }] } } },
+    { "title": "action.blocked", "properties": { "type": { "const": "action.blocked" }, "payload": { "allOf": [{ "$ref": "#/$defs/actionTransition" }, { "properties": { "from": { "enum": ["queued", "in_progress"] }, "to": { "const": "blocked" }, "operationId": { "type": "string" }, "resultId": { "type": "string" }, "reasonCode": { "type": "string" } } }] } } },
+    { "title": "cycle.approved", "properties": { "type": { "const": "cycle.approved" }, "payload": { "allOf": [{ "$ref": "#/$defs/cycleTransition" }, { "properties": { "from": { "const": "awaiting_review" }, "to": { "const": "approved" }, "actionId": { "const": null }, "operationId": { "const": null }, "resultId": { "const": null }, "reasonCode": { "const": null } } }] } } },
+    { "title": "cycle.executing", "properties": { "type": { "const": "cycle.executing" }, "payload": { "allOf": [{ "$ref": "#/$defs/cycleTransition" }, { "properties": { "from": { "const": "approved" }, "to": { "const": "executing" }, "actionId": { "type": "string" }, "operationId": { "type": "string" }, "resultId": { "const": null }, "reasonCode": { "const": null } } }] } } },
+    { "title": "cycle.verifying", "properties": { "type": { "const": "cycle.verifying" }, "payload": { "allOf": [{ "$ref": "#/$defs/cycleTransition" }, { "oneOf": [
+      { "properties": { "from": { "const": "executing" }, "to": { "const": "verifying" }, "actionId": { "type": "string" }, "operationId": { "type": "string" }, "resultId": { "type": "string" }, "reasonCode": { "const": null } } },
+      { "properties": { "from": { "const": "approved" }, "to": { "const": "verifying" }, "actionId": { "type": "string" }, "operationId": { "const": null }, "resultId": { "const": null }, "reasonCode": { "type": "string" } } }
+    ] }] } } },
+    { "title": "cycle.closed", "properties": { "type": { "const": "cycle.closed" }, "payload": { "allOf": [{ "$ref": "#/$defs/cycleTransition" }, { "oneOf": [
+      { "properties": { "from": { "const": "verifying" }, "to": { "const": "closed" }, "actionId": { "type": "string" }, "operationId": { "type": "string" }, "resultId": { "type": "string" }, "reasonCode": { "type": ["string", "null"] } } },
+      { "properties": { "from": { "const": "verifying" }, "to": { "const": "closed" }, "actionId": { "type": "string" }, "operationId": { "const": null }, "resultId": { "const": null }, "reasonCode": { "type": "string" } } },
+      { "properties": { "from": { "const": "approved" }, "to": { "const": "closed" }, "actionId": { "const": null }, "operationId": { "const": null }, "resultId": { "const": null }, "reasonCode": { "type": "string" } } }
+    ] }] } } }
+  ],
+  "$defs": {
+    "planningDeliveryIngested": {
+      "type": "object", "additionalProperties": false,
+      "required": ["origin", "deliveryEvidence", "artifact", "evidenceRef", "assignment", "verificationPlanEvent", "verificationSource"],
+      "properties": {
+        "origin": { "$ref": "operating-origin.schema.json" },
+        "deliveryEvidence": { "$ref": "operating-delivery-evidence.schema.json" },
+        "artifact": { "$ref": "operating-artifact.schema.json" },
+        "evidenceRef": { "$ref": "operating-evidence-ref.schema.json" },
+        "assignment": { "$ref": "operating-assignment.schema.json" },
+        "verificationPlanEvent": { "$ref": "operating-event.schema.json" },
+        "verificationSource": {
+          "type": "object", "additionalProperties": false,
+          "required": ["ledgerId", "snapshotId", "stateId"],
+          "properties": {
+            "ledgerId": { "type": "string", "minLength": 1, "maxLength": 128 },
+            "snapshotId": { "type": "string", "minLength": 1, "maxLength": 128 },
+            "stateId": { "type": "string", "minLength": 1, "maxLength": 128 }
+          }
+        }
+      }
+    },
+    "operationIntent": {
+      "type": "object", "additionalProperties": false,
+      "required": ["operation", "request", "terminal"],
+      "properties": {
+        "operation": { "$ref": "operating-governed-operation.schema.json" },
+        "request": {
+          "type": "object", "additionalProperties": false,
+          "required": ["payload", "rollbackBaseline", "targetBeforeHash"],
+          "properties": {
+            "payload": { "$ref": "#/$defs/operationArtifactBinding" },
+            "rollbackBaseline": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/operationArtifactBinding" }] },
+            "targetBeforeHash": { "$ref": "#/$defs/hash" }
+          }
+        },
+        "terminal": { "$ref": "#/$defs/operationTerminalReservation" }
+      }
+    },
+    "operationTerminalReservation": {
+      "type": "object", "additionalProperties": false,
+      "required": ["resultId", "resultArtifactId", "submissionId", "eventIds", "completedAt", "correlationId", "uncertainty"],
+      "properties": {
+        "resultId": { "type": "string", "pattern": "^(?:xres|rbres)_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "resultArtifactId": { "$ref": "#/$defs/artifactId" },
+        "submissionId": { "$ref": "#/$defs/submissionId" },
+        "eventIds": {
+          "type": "object", "additionalProperties": false,
+          "required": ["submitted", "artifactCreated", "validated", "resultRecorded"],
+          "properties": {
+            "submitted": { "type": "string", "minLength": 1, "maxLength": 128 },
+            "artifactCreated": { "type": "string", "minLength": 1, "maxLength": 128 },
+            "validated": { "type": "string", "minLength": 1, "maxLength": 128 },
+            "resultRecorded": { "type": "string", "minLength": 1, "maxLength": 128 }
+          }
+        },
+        "completedAt": { "type": "string", "format": "date-time" },
+        "correlationId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "uncertainty": { "$ref": "#/$defs/operationTerminalIdentityReservation" }
+      }
+    },
+    "operationTerminalIdentityReservation": {
+      "type": "object", "additionalProperties": false,
+      "required": ["resultId", "resultArtifactId", "submissionId", "eventIds"],
+      "properties": {
+        "resultId": { "type": "string", "pattern": "^(?:xres|rbres)_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "resultArtifactId": { "$ref": "#/$defs/artifactId" },
+        "submissionId": { "$ref": "#/$defs/submissionId" },
+        "eventIds": {
+          "type": "object", "additionalProperties": false,
+          "required": ["submitted", "artifactCreated", "validated", "resultRecorded"],
+          "properties": {
+            "submitted": { "type": "string", "minLength": 1, "maxLength": 128 },
+            "artifactCreated": { "type": "string", "minLength": 1, "maxLength": 128 },
+            "validated": { "type": "string", "minLength": 1, "maxLength": 128 },
+            "resultRecorded": { "type": "string", "minLength": 1, "maxLength": 128 }
+          }
+        }
+      }
+    },
+    "operationArtifactBinding": {
+      "type": "object", "additionalProperties": false,
+      "required": ["artifactId", "contentHash"],
+      "properties": {
+        "artifactId": { "$ref": "#/$defs/artifactId" },
+        "contentHash": { "$ref": "#/$defs/hash" }
+      }
+    },
+    "executionResultRecorded": {
+      "type": "object", "additionalProperties": false,
+      "required": ["result", "receipt"],
+      "properties": {
+        "result": { "$ref": "operating-execution-result.schema.json" },
+        "receipt": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/executionReceiptProof" }] }
+      }
+    },
+    "executionReceiptProof": {
+      "type": "object", "additionalProperties": false,
+      "required": ["operationId", "requestFingerprint", "target", "before", "after", "changed", "synthetic", "effectCount"],
+      "properties": {
+        "operationId": { "type": "string", "pattern": "^op_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "requestFingerprint": { "$ref": "#/$defs/hash" },
+        "target": {
+          "type": "object", "additionalProperties": false, "required": ["kind", "id"],
+          "properties": {
+            "kind": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" },
+            "id": { "type": "string", "minLength": 1, "maxLength": 128 }
+          }
+        },
+        "before": { "$ref": "#/$defs/executionReceiptSnapshot" },
+        "after": { "$ref": "#/$defs/executionReceiptSnapshot" },
+        "changed": { "type": "boolean" },
+        "synthetic": { "type": "boolean" },
+        "effectCount": { "const": 1 }
+      }
+    },
+    "executionReceiptSnapshot": {
+      "type": "object", "additionalProperties": false, "required": ["revision", "stateHash"],
+      "properties": {
+        "revision": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "stateHash": { "$ref": "#/$defs/hash" }
+      }
+    },
+    "actionTransition": {
+      "type": "object", "additionalProperties": false,
+      "required": ["action", "from", "to", "operationId", "resultId", "reasonCode"],
+      "properties": {
+        "action": { "type": "object", "additionalProperties": false, "required": ["actionId", "revision", "actionHash"], "properties": { "actionId": { "type": "string", "pattern": "^act_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "revision": { "type": "integer", "minimum": 1 }, "actionHash": { "$ref": "#/$defs/hash" } } },
+        "from": { "enum": ["proposed", "approved", "queued", "in_progress", "completed", "blocked", "rejected", "deferred", "cancelled"] },
+        "to": { "enum": ["proposed", "approved", "queued", "in_progress", "completed", "blocked", "rejected", "deferred", "cancelled"] },
+        "operationId": { "type": ["string", "null"], "pattern": "^op_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "resultId": { "type": ["string", "null"], "pattern": "^(?:xres|rbres)_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "reasonCode": { "type": ["string", "null"], "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" }
+      }
+    },
+    "cycleTransition": {
+      "type": "object", "additionalProperties": false,
+      "required": ["cycleId", "from", "to", "actionId", "operationId", "resultId", "reasonCode"],
+      "properties": {
+        "cycleId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "from": { "enum": ["awaiting_review", "approved", "executing", "verifying", "closed"] },
+        "to": { "enum": ["awaiting_review", "approved", "executing", "verifying", "closed"] },
+        "actionId": { "type": ["string", "null"], "pattern": "^act_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "operationId": { "type": ["string", "null"], "pattern": "^op_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "resultId": { "type": ["string", "null"], "pattern": "^(?:xres|rbres)_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "reasonCode": { "type": ["string", "null"], "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" }
+      }
+    },
+    "intelligenceBinding": {
+      "type": "object", "additionalProperties": false,
+      "required": ["snapshotId", "stateId", "record"],
+      "properties": {
+        "snapshotId": { "type": "string", "pattern": "^snp_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "stateId": { "type": "string", "pattern": "^oms_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "record": {}
+      }
+    },
+    "metricObservationRecorded": { "allOf": [{ "$ref": "#/$defs/intelligenceBinding" }, { "properties": { "record": { "$ref": "operating-metric-observation.schema.json" } } }] },
+    "claimRecorded": { "allOf": [{ "$ref": "#/$defs/intelligenceBinding" }, { "properties": { "record": { "$ref": "operating-claim.schema.json" } } }] },
+    "findingRecorded": { "allOf": [{ "$ref": "#/$defs/intelligenceBinding" }, { "properties": { "record": { "$ref": "operating-finding.schema.json" } } }] },
+    "riskRecorded": { "allOf": [{ "$ref": "#/$defs/intelligenceBinding" }, { "properties": { "record": { "$ref": "operating-risk.schema.json" } } }] },
+    "assumptionRecorded": { "allOf": [{ "$ref": "#/$defs/intelligenceBinding" }, { "properties": { "record": { "$ref": "operating-assumption.schema.json" } } }] },
+    "decisionRevised": { "allOf": [{ "$ref": "#/$defs/intelligenceBinding" }, { "properties": { "record": { "$ref": "operating-decision.schema.json" } } }] },
+    "deltaDerived": { "allOf": [{ "$ref": "#/$defs/intelligenceBinding" }, { "properties": { "record": { "$ref": "operating-delta.schema.json" } } }] },
+    "scenarioRecorded": { "allOf": [{ "$ref": "#/$defs/intelligenceBinding" }, { "properties": { "record": { "$ref": "operating-scenario.schema.json" } } }] },
+    "triggerRecorded": { "allOf": [{ "$ref": "#/$defs/intelligenceBinding" }, { "properties": { "record": { "$ref": "operating-event-trigger.schema.json" } } }] },
+    "inputBound": {
+      "type": "object", "additionalProperties": false,
+      "required": ["inputBindingId", "scopeId", "domainId", "domainVersion", "contractVersions"],
+      "properties": {
+        "inputBindingId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "scopeId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "domainId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "domainVersion": { "type": "string", "minLength": 1, "maxLength": 64 },
+        "contractVersions": { "type": "object", "additionalProperties": { "type": "string", "minLength": 1 } }
+      }
+    },
+    "assignmentAvailable": {
+      "type": "object", "additionalProperties": false,
+      "required": ["assignmentId", "releaseId", "dependencyProofs", "dependencyEventIds"],
+      "properties": {
+        "assignmentId": { "$ref": "#/$defs/assignmentId" },
+        "releaseId": { "type": "string", "pattern": "^rel_[a-f0-9]{24}$" },
+        "dependencyProofs": { "type": "array", "items": { "$ref": "#/$defs/dependencyProof" } },
+        "dependencyEventIds": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 128 } }
+      }
+    },
+    "assignmentClaimed": {
+      "type": "object", "additionalProperties": false,
+      "required": ["assignmentId", "actorId", "actorKind", "runtime", "claimId", "submissionId"],
+      "properties": {
+        "assignmentId": { "$ref": "#/$defs/assignmentId" },
+        "actorId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "actorKind": { "type": "string", "enum": ["agent", "human"] },
+        "runtime": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "claimId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "submissionId": { "$ref": "#/$defs/submissionId" }
+      }
+    },
+    "assignmentStarted": {
+      "type": "object", "additionalProperties": false, "required": ["assignmentId", "attempt"],
+      "properties": { "assignmentId": { "$ref": "#/$defs/assignmentId" }, "attempt": { "type": "integer", "minimum": 1 } }
+    },
+    "assignmentSubmitted": {
+      "type": "object", "additionalProperties": false,
+      "required": ["assignmentId", "submissionId", "rawHash", "canonicalHash", "sizeBytes", "mediaType", "encoding"],
+      "properties": {
+        "assignmentId": { "$ref": "#/$defs/assignmentId" },
+        "submissionId": { "$ref": "#/$defs/submissionId" },
+        "rawHash": { "$ref": "#/$defs/hash" },
+        "canonicalHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" },
+        "sizeBytes": { "type": "integer", "minimum": 0 },
+        "mediaType": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "encoding": { "type": "string", "enum": ["utf-8", "binary"] }
+      }
+    },
+    "assignmentValidated": {
+      "type": "object", "additionalProperties": false,
+      "required": ["assignmentId", "submissionId", "artifactId", "validatorVersion"],
+      "properties": {
+        "assignmentId": { "$ref": "#/$defs/assignmentId" },
+        "submissionId": { "$ref": "#/$defs/submissionId" },
+        "artifactId": { "$ref": "#/$defs/artifactId" },
+        "validatorVersion": { "type": "string", "minLength": 1, "maxLength": 64 }
+      }
+    },
+    "assignmentRejected": {
+      "type": "object", "additionalProperties": false,
+      "required": ["assignmentId", "submissionId", "violations", "attempt", "attemptsRemaining"],
+      "properties": {
+        "assignmentId": { "$ref": "#/$defs/assignmentId" },
+        "submissionId": { "$ref": "#/$defs/submissionId" },
+        "violations": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/violation" } },
+        "attempt": { "type": "integer", "minimum": 1 },
+        "attemptsRemaining": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "assignmentAbandoned": {
+      "type": "object", "additionalProperties": false,
+      "required": ["assignmentId", "reasonCode", "reason", "recoveryDisposition"],
+      "properties": {
+        "assignmentId": { "$ref": "#/$defs/assignmentId" },
+        "reasonCode": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "reason": { "type": "string", "minLength": 1, "maxLength": 2048 },
+        "recoveryDisposition": { "type": "string", "minLength": 1, "maxLength": 128 }
+      }
+    },
+    "assignmentFailed": {
+      "type": "object", "additionalProperties": false,
+      "required": ["assignmentId", "errorCode", "reason", "recoveryStatus"],
+      "properties": {
+        "assignmentId": { "$ref": "#/$defs/assignmentId" },
+        "errorCode": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "reason": { "type": "string", "minLength": 1, "maxLength": 2048 },
+        "recoveryStatus": { "type": "string", "minLength": 1, "maxLength": 128 }
+      }
+    },
+    "dependencyProof": {
+      "oneOf": [
+        {
+          "type": "object", "additionalProperties": false,
+          "required": ["assignmentId", "outcome", "eventId", "artifactId"],
+          "properties": {
+            "assignmentId": { "$ref": "#/$defs/assignmentId" },
+            "outcome": { "const": "validated" },
+            "eventId": { "type": "string", "minLength": 1, "maxLength": 128 },
+            "artifactId": { "$ref": "#/$defs/artifactId" }
+          }
+        },
+        {
+          "type": "object", "additionalProperties": false,
+          "required": ["assignmentId", "outcome", "eventId", "absence"],
+          "properties": {
+            "assignmentId": { "$ref": "#/$defs/assignmentId" },
+            "outcome": { "type": "string", "enum": ["abandoned", "failed"] },
+            "eventId": { "type": "string", "minLength": 1, "maxLength": 128 },
+            "absence": {
+              "type": "object", "additionalProperties": false,
+              "required": ["code", "reason", "recoveryDisposition"],
+              "properties": {
+                "code": { "type": "string", "minLength": 1, "maxLength": 128 },
+                "reason": { "type": "string", "minLength": 1, "maxLength": 2048 },
+                "recoveryDisposition": { "type": "string", "minLength": 1, "maxLength": 128 }
+              }
+            }
+          }
+        }
+      ]
+    },
+    "reviewSubmitted": {
+      "type": "object", "additionalProperties": false,
+      "required": ["reviewId", "disposition", "workDispositions", "receiptProjection"],
+      "properties": {
+        "reviewId": { "$ref": "#/$defs/reviewId" },
+        "disposition": { "type": "string", "enum": ["approved", "changes_requested", "rejected", "cancelled"] },
+        "workDispositions": { "type": "array", "maxItems": 1024, "uniqueItems": true, "items": { "$ref": "operating-review.schema.json#/$defs/workDisposition" } },
+        "receiptProjection": { "$ref": "operating-review-receipt.schema.json#/$defs/replayProjection" }
+      }
+    },
+    "workChangeSetMaterialized": {
+      "type": "object", "additionalProperties": false,
+      "required": ["artifactId", "canonicalHash", "changeSet", "findings", "decisions", "actions"],
+      "properties": {
+        "artifactId": { "$ref": "#/$defs/artifactId" },
+        "canonicalHash": { "$ref": "#/$defs/hash" },
+        "changeSet": { "$ref": "operating-work-change-set.schema.json" },
+        "findings": { "type": "array", "items": { "$ref": "operating-finding.schema.json" } },
+        "decisions": { "type": "array", "items": { "$ref": "operating-decision.schema.json" } },
+        "actions": { "type": "array", "items": { "$ref": "operating-action.schema.json" } }
+      }
+    },
+    "actionAuthorityPromoted": {
+      "type": "object", "additionalProperties": false,
+      "required": ["before", "authority", "action"],
+      "properties": {
+        "before": { "$ref": "operating-action.schema.json" },
+        "authority": {
+          "type": "object", "additionalProperties": false,
+          "required": ["actionKind", "requestedCapability", "targetBinding", "effectClass", "preconditionArtifactIds", "executionBinding", "updatedAt"],
+          "properties": {
+            "actionKind": { "$ref": "operating-action.schema.json#/$defs/versionedId" },
+            "requestedCapability": { "$ref": "operating-action.schema.json#/$defs/versionedId" },
+            "targetBinding": { "$ref": "operating-action.schema.json#/$defs/targetBinding" },
+            "effectClass": { "$ref": "operating-action.schema.json#/$defs/effectClass" },
+            "preconditionArtifactIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/artifactId" } },
+            "executionBinding": { "$ref": "operating-action.schema.json#/$defs/executionBinding" },
+            "updatedAt": { "type": "string", "format": "date-time" }
+          }
+        },
+        "action": { "allOf": [{ "$ref": "operating-action.schema.json" }, { "required": ["revisionId", "revision", "predecessorRevisionId", "actionHash", "actionKind", "requestedCapability", "targetBinding", "effectClass", "preconditionArtifactIds", "executionBinding"], "properties": { "state": { "const": "proposed" } } }] }
+      }
+    },
+    "evidenceResolved": {
+      "type": "object", "additionalProperties": false,
+      "required": ["resolution", "evidenceRef", "evidenceArtifact", "edges", "requestHash", "outcomeHash"],
+      "properties": {
+        "resolution": { "allOf": [{ "$ref": "operating-evidence-resolution.schema.json" }, { "properties": { "outcome": { "const": "resolved" } } }] },
+        "evidenceRef": { "$ref": "operating-evidence-ref.schema.json" },
+        "evidenceArtifact": { "$ref": "operating-artifact.schema.json" },
+        "edges": { "type": "array", "uniqueItems": true, "items": { "$ref": "operating-evidence-edge.schema.json" } },
+        "requestHash": { "$ref": "#/$defs/hash" },
+        "outcomeHash": { "$ref": "#/$defs/hash" }
+      }
+    },
+    "evidenceRejected": {
+      "type": "object", "additionalProperties": false,
+      "required": ["resolution", "requestHash", "outcomeHash"],
+      "properties": {
+        "resolution": { "allOf": [{ "$ref": "operating-evidence-resolution.schema.json" }, { "properties": { "outcome": { "const": "rejected" } } }] },
+        "requestHash": { "$ref": "#/$defs/hash" },
+        "outcomeHash": { "$ref": "#/$defs/hash" }
+      }
+    },
+    "violation": {
+      "type": "object", "additionalProperties": false, "required": ["path", "code", "message"],
+      "properties": {
+        "path": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "code": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "message": { "type": "string", "minLength": 1, "maxLength": 2048 }
+      }
+    },
+    "assignmentId": { "type": "string", "pattern": "^asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "submissionId": { "type": "string", "pattern": "^sub_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "artifactId": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "reviewId": { "type": "string", "pattern": "^rev_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+  }
+}