@openplanr/protocol 0.2.0

package/schemas/v2.0.0/operating-runtime-state.schema.json

@@ -0,0 +1,289 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-runtime-state.schema.json",
+  "x-openplanr-contract": { "id": "operating-runtime-state", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 rebuildable runtime workflow state",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "generatedAt", "eventHead", "cycles", "inputBindings", "assignments", "reviews", "submissions", "artifacts", "findings", "decisions", "actions", "submissionReplayIndex", "workChangeSetReplayIndex", "eventReplayIndex"],
+  "properties": {
+    "kind": { "const": "operating-runtime-state" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "eventHead": { "$ref": "#/$defs/eventHead" },
+    "cycles": { "type": "array", "items": { "$ref": "operating-cycle.schema.json" } },
+    "inputBindings": { "type": "array", "items": { "$ref": "operating-cycle-input-binding.schema.json" } },
+    "assignments": { "type": "array", "items": { "$ref": "operating-assignment.schema.json" } },
+    "reviews": { "type": "array", "items": { "$ref": "operating-review.schema.json" } },
+    "submissions": { "type": "array", "items": { "$ref": "operating-submission.schema.json" } },
+    "artifacts": { "type": "array", "items": { "$ref": "operating-artifact.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" } },
+    "executiveBoards": {
+      "type": "array",
+      "description": "Optional transition-owned Executive Board records. Historical v2 checkpoints omit this member byte-for-byte; new runtimes include it and only materialized variants may persist.",
+      "items": {
+        "allOf": [
+          { "$ref": "operating-executive-board.schema.json" },
+          {
+            "properties": {
+              "projectionMode": { "const": "materialized" },
+              "authoritativeForMutation": { "const": true },
+              "materializedEventId": { "type": "string" }
+            }
+          }
+        ]
+      }
+    },
+    "operatingModelStates": {
+      "type": "array",
+      "description": "Phase 5 immutable domain-neutral state snapshots. Kept optional until the Phase 5 materializer begins writing this projection.",
+      "items": { "$ref": "operating-model-state.schema.json" }
+    },
+    "operatingSnapshots": {
+      "type": "array",
+      "description": "Phase 5 immutable snapshot descriptors. They retain safe IDs, revisions, and hashes only.",
+      "items": { "$ref": "operating-snapshot.schema.json" }
+    },
+    "objectives": { "type": "array", "items": { "$ref": "operating-objective.schema.json" } },
+    "metrics": { "type": "array", "items": { "$ref": "operating-metric.schema.json" } },
+    "metricObservations": { "type": "array", "items": { "$ref": "operating-metric-observation.schema.json" } },
+    "risks": { "type": "array", "items": { "$ref": "operating-risk.schema.json" } },
+    "assumptions": { "type": "array", "items": { "$ref": "operating-assumption.schema.json" } },
+    "claims": { "type": "array", "items": { "$ref": "operating-claim.schema.json" } },
+    "domainProjections": { "type": "array", "items": { "$ref": "operating-domain-projection.schema.json" } },
+    "deltas": { "type": "array", "items": { "$ref": "operating-delta.schema.json" } },
+    "intelligencePlans": { "type": "array", "items": { "$ref": "operating-intelligence-plan.schema.json" } },
+    "decisionLedgers": { "type": "array", "items": { "$ref": "operating-decision-ledger.schema.json" } },
+    "verificationPlans": { "type": "array", "items": { "$ref": "operating-action-verification-plan.schema.json" } },
+    "outcomes": { "type": "array", "items": { "$ref": "operating-outcome.schema.json" } },
+    "learnings": { "type": "array", "items": { "$ref": "operating-learning.schema.json" } },
+    "scenarios": { "type": "array", "items": { "$ref": "operating-scenario.schema.json" } },
+    "eventTriggers": { "type": "array", "items": { "$ref": "operating-event-trigger.schema.json" } },
+    "actionPolicies": { "type": "array", "items": { "$ref": "operating-action-policy.schema.json" } },
+    "policyEvaluations": { "type": "array", "items": { "$ref": "operating-policy-evaluation.schema.json" } },
+    "approvalRequirements": { "type": "array", "items": { "$ref": "operating-approval-requirement.schema.json" } },
+    "approvalRecords": { "type": "array", "items": { "$ref": "operating-approval-record.schema.json" } },
+    "capabilityAvailability": { "type": "array", "items": { "$ref": "operating-capability-availability.schema.json" } },
+    "capabilityGrants": { "type": "array", "items": { "$ref": "operating-capability-grant.schema.json" } },
+    "governedOperations": { "type": "array", "items": { "$ref": "operating-governed-operation.schema.json" } },
+    "executionResults": { "type": "array", "items": { "$ref": "operating-execution-result.schema.json" } },
+    "rollbackPlans": { "type": "array", "items": { "$ref": "operating-rollback-plan.schema.json" } },
+    "rollbackResults": { "type": "array", "items": { "$ref": "operating-rollback-result.schema.json" } },
+    "operationReplayIndex": { "type": "array", "items": { "$ref": "#/$defs/operationReplayEntry" } },
+    "evidenceRefs": {
+      "type": "array",
+      "description": "Phase 4 runtime-owned resolved EvidenceRefs. The Phase 4 materializer populates this optional state slice atomically with its event transaction.",
+      "items": { "$ref": "operating-evidence-ref.schema.json" }
+    },
+    "evidenceResolutions": {
+      "type": "array",
+      "description": "Phase 4 runtime-owned evidence resolution outcomes. Normal agents cannot write this state.",
+      "items": { "$ref": "operating-evidence-resolution.schema.json" }
+    },
+    "evidenceEdges": {
+      "type": "array",
+      "description": "Phase 4 source-Artifact-local proof edges only; this is not a durable Claim store.",
+      "items": { "$ref": "operating-evidence-edge.schema.json" }
+    },
+    "evidenceResolutionReplayIndex": {
+      "type": "array",
+      "description": "Phase 4 runtime-owned resolution identity view. Its materializer is introduced separately from this contract family.",
+      "items": { "$ref": "#/$defs/evidenceResolutionReplayEntry" }
+    },
+    "submissionReplayIndex": { "type": "array", "items": { "$ref": "#/$defs/replayEntry" } },
+    "workChangeSetReplayIndex": {
+      "type": "array",
+      "description": "Runtime-owned materialization identity view. A validated work-change-set Artifact may materialize once; exact Event retry is handled by eventReplayIndex.",
+      "items": { "$ref": "#/$defs/workChangeSetReplayEntry" }
+    },
+    "eventReplayIndex": {
+      "type": "array",
+      "description": "Durable complete Event identity view for replay and checkpoint recovery. It is runtime-owned and never a normal-agent API field.",
+      "items": { "$ref": "#/$defs/eventReplayEntry" }
+    }
+  },
+  "allOf": [
+    { "if": { "required": ["actionPolicies"] }, "then": { "$ref": "#/$defs/completeAuthorityHistory" } },
+    { "if": { "required": ["policyEvaluations"] }, "then": { "$ref": "#/$defs/completeAuthorityHistory" } },
+    { "if": { "required": ["approvalRequirements"] }, "then": { "$ref": "#/$defs/completeAuthorityHistory" } },
+    { "if": { "required": ["approvalRecords"] }, "then": { "$ref": "#/$defs/completeAuthorityHistory" } },
+    { "if": { "required": ["capabilityAvailability"] }, "then": { "$ref": "#/$defs/completeAuthorityHistory" } },
+    { "if": { "required": ["capabilityGrants"] }, "then": { "$ref": "#/$defs/completeAuthorityHistory" } },
+    { "if": { "required": ["governedOperations"] }, "then": { "$ref": "#/$defs/completeAuthorityHistory" } },
+    { "if": { "required": ["executionResults"] }, "then": { "$ref": "#/$defs/completeAuthorityHistory" } },
+    { "if": { "required": ["rollbackPlans"] }, "then": { "$ref": "#/$defs/completeAuthorityHistory" } },
+    { "if": { "required": ["rollbackResults"] }, "then": { "$ref": "#/$defs/completeAuthorityHistory" } },
+    { "if": { "required": ["operationReplayIndex"] }, "then": { "$ref": "#/$defs/completeAuthorityHistory" } }
+  ],
+  "$defs": {
+    "completeAuthorityHistory": {
+      "required": ["actionPolicies", "policyEvaluations", "approvalRequirements", "approvalRecords", "capabilityAvailability", "capabilityGrants", "governedOperations", "executionResults", "rollbackPlans", "rollbackResults", "operationReplayIndex"]
+    },
+    "eventHead": {
+      "type": "object", "additionalProperties": false, "required": ["sequence", "hash"],
+      "properties": {
+        "sequence": { "type": "integer", "minimum": 0 },
+        "hash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }
+      }
+    },
+    "replayEntry": {
+      "type": "object", "additionalProperties": false,
+      "required": ["submissionId", "assignmentId", "rawHash", "canonicalHash", "sizeBytes", "artifactId", "acceptanceEventIds", "responseData"],
+      "properties": {
+        "submissionId": { "type": "string", "pattern": "^sub_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "assignmentId": { "type": "string", "pattern": "^asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "rawHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "canonicalHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" },
+        "sizeBytes": { "type": "integer", "minimum": 0 },
+        "artifactId": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "acceptanceEventIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 128 } },
+        "responseData": {}
+      }
+    },
+    "workChangeSetReplayEntry": {
+      "type": "object", "additionalProperties": false,
+      "required": ["artifactId", "canonicalHash", "eventId", "findingIds", "decisionIds", "actionIds"],
+      "properties": {
+        "artifactId": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "canonicalHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "eventId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "findingIds": { "type": "array", "uniqueItems": true, "items": { "type": "string", "pattern": "^fnd_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" } },
+        "decisionIds": { "type": "array", "uniqueItems": true, "items": { "type": "string", "pattern": "^dec_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" } },
+        "actionIds": { "type": "array", "uniqueItems": true, "items": { "type": "string", "pattern": "^act_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" } }
+      }
+    },
+    "evidenceResolutionReplayEntry": {
+      "type": "object", "additionalProperties": false,
+      "required": ["resolutionId", "candidateId", "sourceArtifactId", "outcome", "evidenceRefId", "evidenceArtifactId", "eventId", "requestHash", "outcomeHash"],
+      "properties": {
+        "resolutionId": { "type": "string", "pattern": "^evs_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "candidateId": { "type": "string", "pattern": "^evc_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "sourceArtifactId": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "outcome": { "enum": ["resolved", "rejected"] },
+        "evidenceRefId": { "type": ["string", "null"], "pattern": "^evr_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "evidenceArtifactId": { "type": ["string", "null"], "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "eventId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "requestHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "outcomeHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+      }
+    },
+    "operationReplayEntry": {
+      "type": "object", "additionalProperties": false,
+      "required": ["operationId", "operationKind", "requestFingerprint", "actionId", "actionRevision", "actionHash", "intentEventId", "operationHash", "payloadArtifactId", "payloadHash", "baselineArtifactId", "baselineHash", "targetBeforeHash", "reservedResultId", "reservedResultArtifactId", "reservedSubmissionId", "reservedTerminalEventIds", "reservedUncertaintyResultId", "reservedUncertaintyResultArtifactId", "reservedUncertaintySubmissionId", "reservedUncertaintyTerminalEventIds", "reservedCompletedAt", "reservedCorrelationId", "terminalResultId", "terminalReceipt"],
+      "properties": {
+        "operationId": { "type": "string", "pattern": "^op_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "requestFingerprint": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "operationKind": { "enum": ["execute", "rollback"] },
+        "actionId": { "type": "string", "pattern": "^act_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "actionRevision": { "type": "integer", "minimum": 1 }, "actionHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "intentEventId": { "type": "string", "pattern": "^evt_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "operationHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "payloadArtifactId": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "payloadHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "baselineArtifactId": { "type": ["string", "null"], "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "baselineHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" },
+        "targetBeforeHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "reservedResultId": { "type": "string", "pattern": "^(?:xres|rbres)_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "reservedResultArtifactId": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "reservedSubmissionId": { "type": "string", "pattern": "^sub_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "reservedTerminalEventIds": {
+          "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 }
+          }
+        },
+        "reservedUncertaintyResultId": { "type": "string", "pattern": "^(?:xres|rbres)_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "reservedUncertaintyResultArtifactId": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "reservedUncertaintySubmissionId": { "type": "string", "pattern": "^sub_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "reservedUncertaintyTerminalEventIds": {
+          "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 }
+          }
+        },
+        "reservedCompletedAt": { "type": "string", "format": "date-time" },
+        "reservedCorrelationId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "terminalResultId": { "type": ["string", "null"], "pattern": "^(?:xres|rbres)_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "terminalReceipt": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/executionReceiptProof" }] }
+      },
+      "allOf": [
+        { "if": { "properties": { "operationKind": { "const": "execute" } }, "required": ["operationKind"] }, "then": { "properties": { "reservedResultId": { "pattern": "^xres_" }, "reservedUncertaintyResultId": { "pattern": "^xres_" }, "terminalResultId": { "type": ["string", "null"], "pattern": "^xres_" } } } },
+        { "if": { "properties": { "operationKind": { "const": "rollback" } }, "required": ["operationKind"] }, "then": { "properties": { "reservedResultId": { "pattern": "^rbres_" }, "reservedUncertaintyResultId": { "pattern": "^rbres_" }, "terminalResultId": { "type": ["string", "null"], "pattern": "^rbres_" } } } }
+      ]
+    },
+    "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": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "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": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+      }
+    },
+    "eventReplayEntry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["eventId", "eventHash", "payloadHash", "sequence", "cycleId", "type", "entityId", "timestamp", "actor", "causationId", "correlationId", "previousEventHash"],
+      "properties": {
+        "eventId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "eventHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "payloadHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "sequence": { "type": "integer", "minimum": 1 },
+        "cycleId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "type": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "entityId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "timestamp": { "type": "string", "format": "date-time" },
+        "actor": {
+          "type": "object", "additionalProperties": false, "required": ["kind", "id"],
+          "properties": {
+            "kind": { "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": "Present only for closed runtime-owned intelligence requests; it prevents a matching Event identity from replaying divergent input."
+        },
+        "receiptProjection": { "$ref": "operating-review-receipt.schema.json#/$defs/replayProjection" }
+      },
+      "allOf": [
+        {
+          "if": { "required": ["type"], "properties": { "type": { "const": "review.submitted" } } },
+          "then": { "required": ["receiptProjection"] },
+          "else": { "not": { "required": ["receiptProjection"] } }
+        }
+      ]
+    }
+  }
+}

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

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-scenario.schema.json",
+  "x-openplanr-contract": { "id": "operating-scenario", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 transparent scenario analysis",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "scenarioId", "scopeId", "domainId", "domainVersion", "snapshotId", "base", "upside", "downside", "breakEven", "assumptionIds", "evidenceRefIds", "uncertainty", "sourceArtifactId", "createdAt"],
+  "properties": {
+    "kind": { "const": "operating-scenario" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" }, "scenarioId": { "$ref": "#/$defs/scenarioId" }, "scopeId": { "$ref": "#/$defs/id" }, "domainId": { "$ref": "#/$defs/id" }, "domainVersion": { "$ref": "#/$defs/version" }, "snapshotId": { "$ref": "#/$defs/snapshotId" }, "base": { "$ref": "#/$defs/case" }, "upside": { "$ref": "#/$defs/case" }, "downside": { "$ref": "#/$defs/case" }, "breakEven": { "$ref": "#/$defs/text" }, "assumptionIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/assumptionId" } }, "evidenceRefIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/evidenceRefId" } }, "uncertainty": { "$ref": "#/$defs/text" }, "sourceArtifactId": { "$ref": "#/$defs/artifactId" }, "createdAt": { "type": "string", "format": "date-time" }
+  },
+  "$defs": { "artifactId": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "assumptionId": { "type": "string", "pattern": "^asm_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "case": { "type": "object", "additionalProperties": false, "required": ["statement", "assumptionIds", "evidenceRefIds", "sourceArtifactId"], "properties": { "statement": { "$ref": "#/$defs/text" }, "assumptionIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/assumptionId" } }, "evidenceRefIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/evidenceRefId" } }, "sourceArtifactId": { "$ref": "#/$defs/artifactId" } } }, "evidenceRefId": { "type": "string", "pattern": "^evr_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "id": { "type": "string", "minLength": 1, "maxLength": 128 }, "scenarioId": { "type": "string", "pattern": "^scn_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "snapshotId": { "type": "string", "pattern": "^snp_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "text": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^.*\\S.*$" }, "version": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)$" } }
+}

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

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-snapshot.schema.json",
+  "x-openplanr-contract": { "id": "operating-snapshot", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 immutable operating snapshot",
+  "description": "An immutable, addressable descriptor of accepted source revisions and typed evidence. It contains no raw artifact bytes or resolver payload.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "snapshotId", "scopeId", "domainId", "domainVersion", "domainContract", "stateId", "runtimeHash", "previousSnapshotId", "sourceArtifactIds", "evidenceRefIds", "sourceRevisions", "createdAt"],
+  "properties": {
+    "kind": { "const": "operating-snapshot" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "snapshotId": { "$ref": "#/$defs/snapshotId" },
+    "scopeId": { "$ref": "#/$defs/id" },
+    "domainId": { "$ref": "#/$defs/id" },
+    "domainVersion": { "$ref": "#/$defs/version" },
+    "domainContract": { "$ref": "#/$defs/domainContract" },
+    "stateId": { "$ref": "#/$defs/stateId" },
+    "runtimeHash": { "$ref": "#/$defs/hash" },
+    "previousSnapshotId": { "type": ["string", "null"], "pattern": "^snp_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "sourceArtifactIds": { "type": "array", "minItems": 1, "maxItems": 256, "uniqueItems": true, "items": { "$ref": "#/$defs/artifactId" } },
+    "evidenceRefIds": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/evidenceRefId" } },
+    "sourceRevisions": { "type": "array", "maxItems": 256, "uniqueItems": true, "items": { "$ref": "#/$defs/sourceRevision" } },
+    "createdAt": { "type": "string", "format": "date-time" }
+  },
+  "$defs": {
+    "artifactId": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "domainContract": { "type": "object", "additionalProperties": false, "required": ["apiDomainId", "id", "version"], "properties": { "apiDomainId": { "$ref": "#/$defs/id" }, "id": { "$ref": "#/$defs/id" }, "version": { "$ref": "#/$defs/version" } } },
+    "evidenceRefId": { "type": "string", "pattern": "^evr_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "id": { "type": "string", "minLength": 1, "maxLength": 128, "not": { "pattern": "(?:<[^>]+>|\\{\\{[^}]+\\}\\})" } },
+    "snapshotId": { "type": "string", "pattern": "^snp_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "sourceRevision": { "type": "object", "additionalProperties": false, "required": ["sourceArtifactId", "revision"], "properties": { "sourceArtifactId": { "$ref": "#/$defs/artifactId" }, "revision": { "type": "string", "minLength": 1, "maxLength": 256 }, "evidenceRefIds": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/evidenceRefId" } } } },
+    "stateId": { "type": "string", "pattern": "^oms_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "version": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)$" }
+  }
+}

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

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-submission.schema.json",
+  "x-openplanr-contract": { "id": "operating-submission", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 operating submission",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "submissionId", "assignmentId", "cycleId", "state", "rawHash", "canonicalHash", "sizeBytes", "artifactId", "acceptanceEventIds", "responseData", "issuedAt", "resolvedAt"],
+  "properties": {
+    "kind": { "const": "operating-submission" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "submissionId": { "type": "string", "pattern": "^sub_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "assignmentId": { "type": "string", "pattern": "^asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "cycleId": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "state": { "type": "string", "enum": ["issued", "accepted", "rejected"] },
+    "rawHash": {
+      "type": ["string", "null"],
+      "pattern": "^sha256:[a-f0-9]{64}$",
+      "description": "Digest of the exact submitted bytes. It is never replaced by canonicalHash."
+    },
+    "canonicalHash": {
+      "type": ["string", "null"],
+      "pattern": "^sha256:[a-f0-9]{64}$",
+      "description": "Digest of a contract-defined canonical value when one exists. It is never used as the raw-byte identity."
+    },
+    "sizeBytes": { "type": ["integer", "null"], "minimum": 0 },
+    "artifactId": { "type": ["string", "null"], "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "acceptanceEventIds": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 128 } },
+    "responseData": {},
+    "issuedAt": { "type": "string", "format": "date-time" },
+    "resolvedAt": { "type": ["string", "null"], "format": "date-time" }
+  }
+}

package/schemas/v2.0.0/operating-trace-matrix.schema.json

@@ -0,0 +1,176 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-trace-matrix.schema.json",
+  "x-openplanr-contract": { "id": "operating-trace-matrix", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 bounded reciprocal trace matrix",
+  "description": "Access-safe identity graph joining operating requirements and absences to seats, accepted work, proof, decisions, governed actions, and verification. Every edge is listed once and reciprocally indexed by both endpoint nodes.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "kind", "schemaVersion", "protocolVersion", "matrixId", "scopeId", "domainId",
+    "domainVersion", "cycleId", "eventHead", "limits", "nodes", "edges", "omissions",
+    "proof", "matrixHash"
+  ],
+  "properties": {
+    "kind": { "const": "operating-trace-matrix" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "matrixId": { "type": "string", "pattern": "^trx_[a-f0-9]{32}$" },
+    "scopeId": { "$ref": "#/$defs/id" },
+    "domainId": { "$ref": "#/$defs/id" },
+    "domainVersion": { "$ref": "#/$defs/version" },
+    "cycleId": { "$ref": "#/$defs/id" },
+    "eventHead": { "$ref": "#/$defs/eventHead" },
+    "limits": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["maxNodes", "maxEdges", "truncated"],
+      "properties": {
+        "maxNodes": { "const": 8192 },
+        "maxEdges": { "const": 32768 },
+        "truncated": { "const": false }
+      }
+    },
+    "nodes": {
+      "type": "array",
+      "maxItems": 8192,
+      "items": { "$ref": "#/$defs/node" }
+    },
+    "edges": {
+      "type": "array",
+      "maxItems": 32768,
+      "items": { "$ref": "#/$defs/edge" }
+    },
+    "omissions": {
+      "type": "array",
+      "maxItems": 8192,
+      "items": { "$ref": "#/$defs/omission" }
+    },
+    "proof": { "$ref": "#/$defs/proof" },
+    "matrixHash": { "$ref": "#/$defs/hash" }
+  },
+  "$defs": {
+    "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "nodeId": { "type": "string", "minLength": 1, "maxLength": 512 },
+    "version": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)$" },
+    "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "eventHead": {
+      "oneOf": [
+        {
+          "type": "object", "additionalProperties": false, "required": ["sequence", "hash"],
+          "properties": { "sequence": { "const": 0 }, "hash": { "const": null } }
+        },
+        {
+          "type": "object", "additionalProperties": false, "required": ["sequence", "hash"],
+          "properties": { "sequence": { "type": "integer", "minimum": 1 }, "hash": { "$ref": "#/$defs/hash" } }
+        }
+      ]
+    },
+    "nodeKind": {
+      "enum": [
+        "requirement", "absence", "seat", "assignment", "artifact", "claim",
+        "evidence-ref", "finding", "decision", "action", "disposition",
+        "verification", "outcome"
+      ]
+    },
+    "locator": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "id", "contract", "scopeId", "domainId", "domainVersion", "cycleId"],
+      "properties": {
+        "kind": { "$ref": "#/$defs/nodeKind" },
+        "id": { "$ref": "#/$defs/nodeId" },
+        "contract": {
+          "type": "object", "additionalProperties": false, "required": ["id", "version"],
+          "properties": { "id": { "$ref": "#/$defs/id" }, "version": { "$ref": "#/$defs/version" } }
+        },
+        "scopeId": { "$ref": "#/$defs/id" },
+        "domainId": { "$ref": "#/$defs/id" },
+        "domainVersion": { "$ref": "#/$defs/version" },
+        "cycleId": { "$ref": "#/$defs/id" }
+      }
+    },
+    "node": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["locator", "accessState", "proofState", "inboundEdgeIds", "outboundEdgeIds"],
+      "properties": {
+        "locator": { "$ref": "#/$defs/locator" },
+        "accessState": { "enum": ["available", "restricted", "absent"] },
+        "proofState": {
+          "enum": [
+            "not-applicable", "pending", "terminal", "accepted", "rejected", "failed",
+            "abandoned", "verified", "stale", "supported", "contradicted", "contested",
+            "unverified", "absent", "restricted", "proposed", "governed", "completed",
+            "insufficient"
+          ]
+        },
+        "inboundEdgeIds": {
+          "type": "array", "maxItems": 32768, "uniqueItems": true,
+          "items": { "type": "string", "pattern": "^tre_[a-f0-9]{32}$" }
+        },
+        "outboundEdgeIds": {
+          "type": "array", "maxItems": 32768, "uniqueItems": true,
+          "items": { "type": "string", "pattern": "^tre_[a-f0-9]{32}$" }
+        }
+      }
+    },
+    "endpoint": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "id"],
+      "properties": { "kind": { "$ref": "#/$defs/nodeKind" }, "id": { "$ref": "#/$defs/nodeId" } }
+    },
+    "edge": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["edgeId", "relation", "from", "to"],
+      "properties": {
+        "edgeId": { "type": "string", "pattern": "^tre_[a-f0-9]{32}$" },
+        "relation": {
+          "enum": [
+            "declares", "assigned-to", "issued-as", "records", "produces", "contains",
+            "supported-by", "contradicted-by", "informs", "challenges", "decides",
+            "proposes", "disposes", "governed-by", "verified-by", "observed-as"
+          ]
+        },
+        "from": { "$ref": "#/$defs/endpoint" },
+        "to": { "$ref": "#/$defs/endpoint" }
+      }
+    },
+    "omission": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["omissionId", "kind", "subject", "subjectId", "reasonCode", "incidentEdgeCount"],
+      "properties": {
+        "omissionId": { "type": "string", "pattern": "^tro_[a-f0-9]{32}$" },
+        "kind": { "enum": ["restricted", "absent"] },
+        "subject": { "$ref": "#/$defs/nodeKind" },
+        "subjectId": { "$ref": "#/$defs/nodeId" },
+        "reasonCode": { "enum": ["OPERATE_TRACE_ACCESS_RESTRICTED", "OPERATE_TRACE_TYPED_ABSENCE", "OPERATE_TRACE_ROLE_NOT_SELECTED"] },
+        "incidentEdgeCount": { "type": "integer", "minimum": 0, "maximum": 32768 }
+      }
+    },
+    "proof": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "terminalAssignments", "acceptedArtifacts", "verifiedEvidence", "staleEvidence",
+        "supportedClaims", "contradictedClaims", "unverifiedClaims", "restrictedNodes",
+        "typedAbsences", "verifiedActions"
+      ],
+      "properties": {
+        "terminalAssignments": { "type": "integer", "minimum": 0, "maximum": 8192 },
+        "acceptedArtifacts": { "type": "integer", "minimum": 0, "maximum": 8192 },
+        "verifiedEvidence": { "type": "integer", "minimum": 0, "maximum": 8192 },
+        "staleEvidence": { "type": "integer", "minimum": 0, "maximum": 8192 },
+        "supportedClaims": { "type": "integer", "minimum": 0, "maximum": 8192 },
+        "contradictedClaims": { "type": "integer", "minimum": 0, "maximum": 8192 },
+        "unverifiedClaims": { "type": "integer", "minimum": 0, "maximum": 8192 },
+        "restrictedNodes": { "type": "integer", "minimum": 0, "maximum": 8192 },
+        "typedAbsences": { "type": "integer", "minimum": 0, "maximum": 8192 },
+        "verifiedActions": { "type": "integer", "minimum": 0, "maximum": 8192 }
+      }
+    }
+  }
+}