@openplanr/protocol 0.2.0

package/schemas/v2.0.0/operating-review-read.schema.json

@@ -0,0 +1,217 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-review-read.schema.json",
+  "x-openplanr-contract": { "id": "operating-review-read", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 owner-bound review read",
+  "description": "Runtime-projected pre-commit Review data for the exact immutable human owner. The runtime owns readAt.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "kind", "schemaVersion", "protocolVersion", "cycleId", "eventHead", "scope", "reader",
+    "review", "seatStatus", "decisions", "actions", "findings", "dissent", "gaps",
+    "dispositionChoices", "readAt"
+  ],
+  "properties": {
+    "kind": { "const": "operating-review-read" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "cycleId": { "$ref": "#/$defs/cycleId" },
+    "eventHead": { "$ref": "#/$defs/eventHead" },
+    "scope": { "$ref": "#/$defs/scope" },
+    "reader": { "$ref": "#/$defs/humanActor" },
+    "review": { "$ref": "operating-review.schema.json" },
+    "seatStatus": { "type": "array", "maxItems": 16, "items": { "$ref": "#/$defs/seatStatus" } },
+    "decisions": { "type": "array", "maxItems": 256, "items": { "$ref": "#/$defs/decisionSummary" } },
+    "actions": { "type": "array", "maxItems": 512, "items": { "$ref": "#/$defs/actionSummary" } },
+    "findings": { "type": "array", "maxItems": 256, "items": { "$ref": "#/$defs/findingSummary" } },
+    "dissent": { "type": "array", "maxItems": 256, "items": { "$ref": "#/$defs/dissentSummary" } },
+    "gaps": { "type": "array", "maxItems": 2048, "items": { "$ref": "#/$defs/gapSummary" } },
+    "dispositionChoices": { "type": "array", "minItems": 1, "maxItems": 128, "items": { "$ref": "#/$defs/dispositionChoice" } },
+    "readAt": { "type": "string", "format": "date-time" }
+  },
+  "$defs": {
+    "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "identifier": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" },
+    "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}$" },
+    "cycleId": { "type": "string", "pattern": "^cyc_[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}$" },
+    "assignmentId": { "type": "string", "pattern": "^asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "evidenceRefId": { "type": "string", "pattern": "^evr_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "absenceId": { "type": "string", "pattern": "^abs_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "title": { "type": "string", "minLength": 1, "maxLength": 256, "pattern": "^\\S(?:[\\s\\S]*\\S)?$" },
+    "text": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[\\s\\S]*\\S[\\s\\S]*$" },
+    "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" } } }
+      ]
+    },
+    "scope": {
+      "type": "object", "additionalProperties": false, "required": ["scopeId", "domainId", "domainVersion"],
+      "properties": { "scopeId": { "$ref": "#/$defs/id" }, "domainId": { "$ref": "#/$defs/identifier" }, "domainVersion": { "$ref": "#/$defs/version" } }
+    },
+    "humanActor": {
+      "type": "object", "additionalProperties": false, "required": ["actorId", "kind", "runtime"],
+      "properties": { "actorId": { "$ref": "#/$defs/id" }, "kind": { "const": "human" }, "runtime": { "$ref": "#/$defs/id" } }
+    },
+    "seatStatus": {
+      "type": "object", "additionalProperties": false,
+      "required": ["roleId", "roleKind", "roleVersion", "state", "artifactId", "absenceIds"],
+      "properties": {
+        "roleId": { "$ref": "#/$defs/identifier" }, "roleKind": { "enum": ["advisor", "challenger", "chair"] },
+        "roleVersion": { "$ref": "#/$defs/version" },
+        "state": { "enum": ["pending", "available", "running", "validated", "rejected", "abandoned", "failed"] },
+        "artifactId": { "type": ["string", "null"], "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "absenceIds": { "type": "array", "maxItems": 2048, "uniqueItems": true, "items": { "$ref": "#/$defs/absenceId" } }
+      }
+    },
+    "decisionSummary": {
+      "type": "object", "additionalProperties": false,
+      "required": [
+        "origin", "decisionId", "title", "question", "outcome", "rationale", "confidence", "ownerActorId",
+        "expectedUpside", "expectedDownside", "revisitConditions", "dissent", "evidenceRefIds"
+      ],
+      "properties": {
+        "origin": { "enum": ["persistent-work", "operating-intelligence"] },
+        "decisionId": { "type": "string", "pattern": "^dec_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "title": { "$ref": "#/$defs/title" }, "question": { "$ref": "#/$defs/text" },
+        "outcome": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/text" }] }, "rationale": { "$ref": "#/$defs/text" },
+        "confidence": { "type": "number", "minimum": 0, "maximum": 1 }, "ownerActorId": { "$ref": "#/$defs/id" },
+        "expectedUpside": { "$ref": "#/$defs/text" }, "expectedDownside": { "$ref": "#/$defs/text" },
+        "uncertainty": { "$ref": "#/$defs/text" }, "reversibility": { "$ref": "#/$defs/text" },
+        "revisitConditions": { "type": "array", "minItems": 1, "maxItems": 32, "items": { "$ref": "#/$defs/text" } },
+        "dissentIds": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "type": "string", "pattern": "^dissent:asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}:[1-9][0-9]*$" } },
+        "dissent": { "type": "array", "maxItems": 128, "items": { "$ref": "#/$defs/text" } },
+        "evidenceRefIds": { "type": "array", "minItems": 1, "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/evidenceRefId" } }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "origin": { "const": "persistent-work" } }, "required": ["origin"] },
+          "then": { "not": { "anyOf": [{ "required": ["uncertainty"] }, { "required": ["reversibility"] }, { "required": ["dissentIds"] }] } }
+        },
+        {
+          "if": { "properties": { "origin": { "const": "operating-intelligence" } }, "required": ["origin"] },
+          "then": { "required": ["uncertainty", "reversibility", "dissentIds"] }
+        }
+      ]
+    },
+    "actionSummary": {
+      "type": "object", "additionalProperties": false,
+      "required": ["actionId", "title", "state", "ownerActorId", "sourceDecisionId", "expectedResult", "metricId", "baseline", "target", "verificationWindow", "verificationMethod"],
+      "properties": {
+        "actionId": { "type": "string", "pattern": "^act_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "title": { "$ref": "#/$defs/title" },
+        "state": { "enum": ["proposed", "approved", "queued", "in_progress", "completed", "blocked", "rejected", "deferred", "cancelled"] },
+        "ownerActorId": { "type": ["string", "null"], "minLength": 1, "maxLength": 128 },
+        "sourceDecisionId": { "type": ["string", "null"], "pattern": "^dec_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "expectedResult": { "$ref": "#/$defs/text" },
+        "metricId": { "type": ["string", "null"], "pattern": "^met_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "baseline": { "type": ["number", "null"] }, "target": { "type": ["number", "null"] },
+        "verificationWindow": { "$ref": "#/$defs/text" }, "verificationMethod": { "$ref": "#/$defs/text" }
+      }
+    },
+    "findingSummary": {
+      "type": "object", "additionalProperties": false,
+      "required": ["origin", "findingId", "title", "statement", "state", "ownerActorId", "revisitAt"],
+      "properties": {
+        "origin": { "enum": ["persistent-work", "operating-intelligence"] },
+        "findingId": { "type": "string", "pattern": "^fnd_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "title": { "$ref": "#/$defs/title" }, "statement": { "$ref": "#/$defs/text" },
+        "findingType": { "enum": ["unsupported", "contradicted", "correlated-reasoning", "missing-alternative", "unpriced-downside", "irreversibility-mismatch", "overconfidence", "scope-violation"] },
+        "severity": { "enum": ["low", "medium", "high", "critical"] }, "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+        "state": { "enum": ["open", "accepted", "resolved", "rejected", "deferred", "superseded"] },
+        "ownerActorId": { "type": ["string", "null"], "minLength": 1, "maxLength": 128 },
+        "revisitAt": { "type": ["string", "null"], "format": "date-time" },
+        "supportingEvidenceRefIds": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/evidenceRefId" } },
+        "contradictingEvidenceRefIds": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/evidenceRefId" } }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "origin": { "const": "persistent-work" } }, "required": ["origin"] },
+          "then": {
+            "not": {
+              "anyOf": [
+                { "required": ["findingType"] }, { "required": ["severity"] }, { "required": ["confidence"] },
+                { "required": ["supportingEvidenceRefIds"] }, { "required": ["contradictingEvidenceRefIds"] }
+              ]
+            }
+          }
+        },
+        {
+          "if": { "properties": { "origin": { "const": "operating-intelligence" } }, "required": ["origin"] },
+          "then": { "required": ["findingType", "severity", "confidence", "supportingEvidenceRefIds", "contradictingEvidenceRefIds"] }
+        }
+      ]
+    },
+    "dissentSummary": {
+      "type": "object", "additionalProperties": false,
+      "required": ["sourceArtifactId", "localDissentId", "statement", "resolutionCondition"],
+      "properties": {
+        "sourceArtifactId": { "$ref": "#/$defs/artifactId" },
+        "localDissentId": { "type": "string", "pattern": "^dissent:asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}:[1-9][0-9]*$" },
+        "statement": { "$ref": "#/$defs/text" }, "resolutionCondition": { "$ref": "#/$defs/text" }
+      }
+    },
+    "gapSummary": {
+      "oneOf": [
+        { "$ref": "#/$defs/roleGapSummary" },
+        { "$ref": "#/$defs/evidenceGapSummary" }
+      ]
+    },
+    "roleGapSummary": {
+      "type": "object", "additionalProperties": false,
+      "required": ["absenceId", "kind", "roleId", "roleKind", "roleVersion", "sourceAssignmentId", "reason", "recoveryDisposition"],
+      "properties": {
+        "absenceId": { "$ref": "#/$defs/absenceId" },
+        "kind": { "const": "role" },
+        "roleId": { "$ref": "operating-assignment.schema.json#/$defs/roleInputAbsence/properties/roleId" },
+        "roleKind": { "enum": ["advisor", "challenger", "chair"] },
+        "roleVersion": { "$ref": "#/$defs/version" },
+        "sourceAssignmentId": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/assignmentId" }] },
+        "reason": { "$ref": "operating-assignment.schema.json#/$defs/roleInputAbsence/properties/reason" },
+        "recoveryDisposition": { "$ref": "operating-assignment.schema.json#/$defs/roleInputAbsence/properties/recoveryDisposition" }
+      }
+    },
+    "evidenceGapSummary": {
+      "type": "object", "additionalProperties": false,
+      "required": ["absenceId", "kind", "requirementId", "sourceContracts", "reason", "recoveryDisposition"],
+      "properties": {
+        "absenceId": { "$ref": "#/$defs/absenceId" },
+        "kind": { "const": "evidence" },
+        "requirementId": { "$ref": "#/$defs/identifier" },
+        "sourceContracts": {
+          "type": "array", "minItems": 1, "maxItems": 16, "uniqueItems": true,
+          "items": {
+            "type": "object", "additionalProperties": false, "required": ["id", "version"],
+            "properties": { "id": { "$ref": "#/$defs/identifier" }, "version": { "$ref": "#/$defs/version" } }
+          }
+        },
+        "reason": { "$ref": "operating-assignment.schema.json#/$defs/evidenceInputAbsence/properties/reason" },
+        "recoveryDisposition": { "$ref": "operating-assignment.schema.json#/$defs/evidenceInputAbsence/properties/recoveryDisposition" }
+      }
+    },
+    "dispositionChoice": {
+      "type": "object", "additionalProperties": false,
+      "required": ["choiceId", "choiceHash", "label", "submitArguments"],
+      "properties": {
+        "choiceId": { "type": "string", "pattern": "^rch_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "choiceHash": { "$ref": "#/$defs/hash" },
+        "label": { "$ref": "#/$defs/title" },
+        "submitArguments": { "$ref": "#/$defs/reviewSubmitArguments" }
+      }
+    },
+    "reviewSubmitArguments": {
+      "type": "object", "additionalProperties": false,
+      "required": ["reviewId", "cycleId", "actor", "scope", "disposition", "workDispositions"],
+      "properties": {
+        "reviewId": { "type": "string", "pattern": "^rev_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "cycleId": { "$ref": "#/$defs/cycleId" },
+        "actor": { "$ref": "#/$defs/humanActor" },
+        "scope": { "$ref": "#/$defs/scope" },
+        "disposition": { "enum": ["approved", "changes_requested", "rejected", "cancelled"] },
+        "workDispositions": { "type": "array", "maxItems": 1024, "uniqueItems": true, "items": { "$ref": "operating-review.schema.json#/$defs/workDisposition" } }
+      }
+    }
+  }
+}

package/schemas/v2.0.0/operating-review-receipt.schema.json

@@ -0,0 +1,64 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-review-receipt.schema.json",
+  "x-openplanr-contract": { "id": "operating-review-receipt", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 owner-bound review receipt",
+  "description": "Post-commit proof of the exact human owner's Review disposition. The runtime owns receiptId and committedAt.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "kind", "schemaVersion", "protocolVersion", "receiptId", "cycleId", "readEventHead", "eventHead", "scope", "actor",
+    "review", "decision", "seatStatus", "decisions", "actions", "findings", "dissent", "gaps",
+    "dispositionChoices", "appliedChoiceId", "appliedChoiceHash", "appliedWorkDispositions", "summary", "committedAt"
+  ],
+  "properties": {
+    "kind": { "const": "operating-review-receipt" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "receiptId": { "type": "string", "pattern": "^rrc_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "cycleId": { "$ref": "operating-review-read.schema.json#/$defs/cycleId" },
+    "readEventHead": { "$ref": "operating-review-read.schema.json#/$defs/eventHead" },
+    "eventHead": { "$ref": "operating-review-read.schema.json#/$defs/eventHead" },
+    "scope": { "$ref": "operating-review-read.schema.json#/$defs/scope" },
+    "actor": { "$ref": "operating-review-read.schema.json#/$defs/humanActor" },
+    "review": { "$ref": "operating-review.schema.json" },
+    "decision": { "enum": ["approved", "changes_requested", "rejected", "cancelled"] },
+    "seatStatus": { "type": "array", "maxItems": 16, "items": { "$ref": "operating-review-read.schema.json#/$defs/seatStatus" } },
+    "decisions": { "type": "array", "maxItems": 256, "items": { "$ref": "operating-review-read.schema.json#/$defs/decisionSummary" } },
+    "actions": { "type": "array", "maxItems": 512, "items": { "$ref": "operating-review-read.schema.json#/$defs/actionSummary" } },
+    "findings": { "type": "array", "maxItems": 256, "items": { "$ref": "operating-review-read.schema.json#/$defs/findingSummary" } },
+    "dissent": { "type": "array", "maxItems": 256, "items": { "$ref": "operating-review-read.schema.json#/$defs/dissentSummary" } },
+    "gaps": { "type": "array", "maxItems": 2048, "items": { "$ref": "operating-review-read.schema.json#/$defs/gapSummary" } },
+    "dispositionChoices": { "type": "array", "minItems": 1, "maxItems": 128, "items": { "$ref": "operating-review-read.schema.json#/$defs/dispositionChoice" } },
+    "appliedChoiceId": { "type": "string", "pattern": "^rch_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "appliedChoiceHash": { "$ref": "operating-review-read.schema.json#/$defs/hash" },
+    "appliedWorkDispositions": { "type": "array", "maxItems": 1024, "uniqueItems": true, "items": { "$ref": "operating-review.schema.json#/$defs/workDisposition" } },
+    "boundSubmission": { "$ref": "operate-review-bound-submission.schema.json" },
+    "summary": { "$ref": "#/$defs/summary" },
+    "committedAt": { "type": "string", "format": "date-time" }
+  },
+  "$defs": {
+    "replayProjection": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Runtime-owned pre-commit Review read and exact applied choice proof retained for byte-identical receipt replay. Receipt identity, post-commit Event head, and commit time derive from the committed Event and are intentionally excluded to avoid a hash cycle.",
+      "required": ["read", "appliedChoiceId", "appliedChoiceHash"],
+      "properties": {
+        "read": { "$ref": "operating-review-read.schema.json" },
+        "appliedChoiceId": { "$ref": "#/properties/appliedChoiceId" },
+        "appliedChoiceHash": { "$ref": "#/properties/appliedChoiceHash" },
+        "boundSubmission": { "$ref": "operate-review-bound-submission.schema.json" }
+      }
+    },
+    "summary": {
+      "type": "object", "additionalProperties": false,
+      "required": ["decisionCount", "actionCount", "findingCount", "dissentCount", "gapCount", "message"],
+      "properties": {
+        "decisionCount": { "type": "integer", "minimum": 0 }, "actionCount": { "type": "integer", "minimum": 0 },
+        "findingCount": { "type": "integer", "minimum": 0 }, "dissentCount": { "type": "integer", "minimum": 0 },
+        "gapCount": { "type": "integer", "minimum": 0 },
+        "message": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^.*\\S.*$" }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-review.schema.json",
+  "x-openplanr-contract": { "id": "operating-review", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 cycle-scoped review",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "reviewId", "cycleId", "ownerActorId", "state", "disposition", "workDispositions", "createdAt", "updatedAt"],
+  "properties": {
+    "kind": { "const": "operating-review" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "reviewId": { "type": "string", "pattern": "^rev_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "cycleId": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "subject": { "$ref": "#/$defs/subject" },
+    "ownerActorId": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "state": { "type": "string", "enum": ["pending", "approved", "changes_requested", "rejected", "cancelled"] },
+    "disposition": { "type": ["string", "null"], "enum": [null, "approved", "changes_requested", "rejected", "cancelled"] },
+    "workDispositions": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/workDisposition" } },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "updatedAt": { "type": "string", "format": "date-time" }
+  },
+  "oneOf": [
+    { "title": "pending review", "properties": { "state": { "const": "pending" }, "disposition": { "const": null }, "workDispositions": { "maxItems": 0 } } },
+    { "title": "approved review", "properties": { "state": { "const": "approved" }, "disposition": { "const": "approved" } } },
+    { "title": "changes requested review", "properties": { "state": { "const": "changes_requested" }, "disposition": { "const": "changes_requested" }, "workDispositions": { "maxItems": 0 } } },
+    { "title": "rejected review", "properties": { "state": { "const": "rejected" }, "disposition": { "const": "rejected" }, "workDispositions": { "maxItems": 0 } } },
+    { "title": "cancelled review", "properties": { "state": { "const": "cancelled" }, "disposition": { "const": "cancelled" }, "workDispositions": { "maxItems": 0 } } }
+  ],
+  "$defs": {
+    "subject": {
+      "oneOf": [
+        { "type": "object", "additionalProperties": false, "required": ["type", "cycleId"], "properties": { "type": { "const": "cycle" }, "cycleId": { "type": "string", "minLength": 1, "maxLength": 128 } } },
+        { "type": "object", "additionalProperties": false, "required": ["type", "actionId", "revision", "actionHash"], "properties": { "type": { "const": "action" }, "actionId": { "type": "string", "pattern": "^act_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "revision": { "type": "integer", "minimum": 1 }, "actionHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } } }
+      ]
+    },
+    "workDisposition": {
+      "type": "object", "additionalProperties": false,
+      "required": ["entityType", "entityId", "disposition"],
+      "properties": {
+        "entityType": { "type": "string", "enum": ["operating-finding", "operating-decision", "operating-action"] },
+        "entityId": { "type": "string", "pattern": "^(?:fnd|dec|act)_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "disposition": { "type": "string", "enum": ["accepted", "approved", "rejected", "resolved", "deferred", "superseded", "cancelled"] }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,96 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-risk.schema.json",
+  "x-openplanr-contract": { "id": "operating-risk", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 persistent risk",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "kind", "schemaVersion", "protocolVersion", "riskId", "scopeId", "domainId", "domainVersion",
+    "origin", "title", "statement", "state", "likelihood", "impact", "exposure", "ownerActorId", "mitigations", "triggerIds", "evidenceRefIds",
+    "sourceArtifactId", "closedAt", "createdAt", "updatedAt", "revisionId", "revision", "predecessorRevisionId"
+  ],
+  "properties": {
+    "kind": { "const": "operating-risk" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "riskId": { "$ref": "#/$defs/riskId" },
+    "scopeId": { "$ref": "#/$defs/id" },
+    "domainId": { "$ref": "#/$defs/id" },
+    "domainVersion": { "$ref": "#/$defs/version" },
+    "origin": { "enum": ["generic", "operating-intelligence"] },
+    "sourceCycleId": { "$ref": "#/$defs/cycleId" },
+    "sourceAssignmentId": { "$ref": "#/$defs/assignmentId" },
+    "sourceLocalRiskId": { "$ref": "#/$defs/localRiskId" },
+    "sourceClaimIds": { "type": "array", "minItems": 1, "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/localClaimId" } },
+    "title": { "$ref": "#/$defs/title" },
+    "statement": { "$ref": "#/$defs/text" },
+    "state": { "enum": ["open", "monitoring", "mitigated", "closed", "superseded"] },
+    "likelihood": { "type": "number", "minimum": 0, "maximum": 1 },
+    "impact": { "type": "number", "minimum": 0, "maximum": 1 },
+    "sourceImpact": { "enum": ["low", "medium", "high", "critical"] },
+    "exposure": { "type": "number", "minimum": 0, "maximum": 1 },
+    "exposureStatement": { "$ref": "#/$defs/text" },
+    "exposedSurfaces": { "type": "array", "minItems": 1, "maxItems": 64, "uniqueItems": true, "items": { "$ref": "#/$defs/title" } },
+    "ownerActorId": { "type": ["string", "null"], "minLength": 1, "maxLength": 128 },
+    "mitigation": { "$ref": "#/$defs/text" },
+    "mitigations": { "type": "array", "minItems": 1, "maxItems": 32, "items": { "$ref": "#/$defs/text" } },
+    "reversibility": { "$ref": "#/$defs/text" },
+    "triggerIds": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/triggerId" } },
+    "evidenceRefIds": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/evidenceRefId" } },
+    "sourceArtifactId": { "$ref": "#/$defs/artifactId" },
+    "closedAt": { "type": ["string", "null"], "format": "date-time" },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "updatedAt": { "type": "string", "format": "date-time" },
+    "revisionId": { "$ref": "#/$defs/riskId" },
+    "revision": { "type": "integer", "minimum": 1 },
+    "predecessorRevisionId": { "type": ["string", "null"], "pattern": "^rsk_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "origin": { "const": "generic" } }, "required": ["origin"] },
+      "then": {
+        "not": {
+          "anyOf": [
+            { "required": ["sourceCycleId"] },
+            { "required": ["sourceAssignmentId"] },
+            { "required": ["sourceLocalRiskId"] },
+            { "required": ["sourceClaimIds"] },
+            { "required": ["sourceImpact"] },
+            { "required": ["exposureStatement"] },
+            { "required": ["exposedSurfaces"] },
+            { "required": ["mitigation"] },
+            { "required": ["reversibility"] }
+          ]
+        }
+      }
+    },
+    {
+      "if": { "properties": { "origin": { "const": "operating-intelligence" } }, "required": ["origin"] },
+      "then": {
+        "required": [
+          "sourceCycleId", "sourceAssignmentId", "sourceLocalRiskId", "sourceClaimIds", "sourceImpact",
+          "exposureStatement", "exposedSurfaces", "mitigation", "reversibility"
+        ]
+      }
+    },
+    {
+      "if": { "properties": { "state": { "const": "closed" } }, "required": ["state"] },
+      "then": { "properties": { "closedAt": { "type": "string", "format": "date-time" } } }
+    }
+  ],
+  "$defs": {
+    "artifactId": { "type": "string", "pattern": "^art_[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", "pattern": "^cyc_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "evidenceRefId": { "type": "string", "pattern": "^evr_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "localClaimId": { "type": "string", "pattern": "^claim:asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}:[1-9][0-9]*$" },
+    "localRiskId": { "type": "string", "pattern": "^risk:asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}:[1-9][0-9]*$" },
+    "riskId": { "type": "string", "pattern": "^rsk_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "text": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[\\s\\S]*\\S[\\s\\S]*$" },
+    "title": { "type": "string", "minLength": 1, "maxLength": 256, "pattern": "^\\S(?:[\\s\\S]*\\S)?$" },
+    "triggerId": { "type": "string", "pattern": "^trg_[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-rollback-plan.schema.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://openplanr.dev/schemas/v2.0.0/operating-rollback-plan.schema.json",
+  "x-openplanr-contract": { "id": "operating-rollback-plan", "version": "2.0.0" }, "title": "OpenPlanr Operate 2.0 rollback plan",
+  "type": "object", "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "rollbackPlanId", "operationId", "executionResultId", "action", "eligibility", "capability", "effectClass", "executor", "baselineArtifactId", "baselineHash", "steps", "verificationPlanId", "expiresAt", "planHash"],
+  "properties": {
+    "kind": { "const": "operating-rollback-plan" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" }, "rollbackPlanId": { "type": "string", "pattern": "^rbp_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "operationId": { "type": "string", "pattern": "^op_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "executionResultId": { "type": "string", "pattern": "^xres_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "action": { "$ref": "#/$defs/action" }, "eligibility": { "enum": ["eligible", "required", "unsupported", "prohibited", "expired", "stale", "uncertain"] }, "capability": { "$ref": "#/$defs/versionedId" }, "effectClass": { "$ref": "#/$defs/effect" }, "executor": { "$ref": "#/$defs/executor" }, "baselineArtifactId": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "baselineHash": { "$ref": "#/$defs/hash" }, "steps": { "type": "array", "minItems": 1, "items": { "type": "object", "additionalProperties": false, "required": ["stepId", "description", "expectedTargetHash"], "properties": { "stepId": { "$ref": "#/$defs/id" }, "description": { "type": "string", "minLength": 1, "maxLength": 2048 }, "expectedTargetHash": { "$ref": "#/$defs/hash" } } } }, "verificationPlanId": { "type": "string", "pattern": "^vfy_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "expiresAt": { "type": "string", "format": "date-time" }, "planHash": { "$ref": "#/$defs/hash" }
+  },
+  "$defs": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" }, "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}$" }, "effect": { "enum": ["read-only", "machine-local-write", "project-write", "provider-call", "external-effect"] }, "versionedId": { "type": "object", "additionalProperties": false, "required": ["id", "version"], "properties": { "id": { "$ref": "#/$defs/id" }, "version": { "$ref": "#/$defs/version" } } }, "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" } } }, "executor": { "type": "object", "additionalProperties": false, "required": ["executorId", "executorVersion"], "properties": { "executorId": { "$ref": "#/$defs/id" }, "executorVersion": { "$ref": "#/$defs/version" } } } }
+}

package/schemas/v2.0.0/operating-rollback-result.schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-rollback-result.schema.json",
+  "x-openplanr-contract": { "id": "operating-rollback-result", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 rollback result",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "rollbackResultId", "rollbackOperationId", "operationKind", "requestFingerprint", "originalOperationId", "executionResultId", "rollbackPlanId", "action", "assignmentId", "evaluationId", "approvalIds", "grantId", "capability", "target", "effectClass", "executor", "connector", "status", "targetBeforeHash", "targetAfterHash", "baselineArtifactId", "baselineHash", "inputArtifactIds", "outputArtifactIds", "effectSummary", "resultArtifactId", "verificationPlanId", "eventIds", "completedAt", "resultHash"],
+  "properties": {
+    "kind": { "const": "operating-rollback-result" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" }, "rollbackResultId": { "type": "string", "pattern": "^rbres_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "rollbackOperationId": { "type": "string", "pattern": "^op_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "operationKind": { "const": "rollback" }, "requestFingerprint": { "$ref": "#/$defs/hash" }, "originalOperationId": { "type": "string", "pattern": "^op_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "executionResultId": { "type": "string", "pattern": "^xres_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "rollbackPlanId": { "type": "string", "pattern": "^rbp_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "action": { "$ref": "#/$defs/action" }, "assignmentId": { "type": "string", "pattern": "^asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "evaluationId": { "type": "string", "pattern": "^pevl_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "approvalIds": { "type": "array", "uniqueItems": true, "items": { "type": "string", "pattern": "^aprv_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" } }, "grantId": { "type": "string", "pattern": "^cgr_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "capability": { "$ref": "#/$defs/versionedId" }, "target": { "$ref": "#/$defs/target" }, "effectClass": { "$ref": "#/$defs/effect" }, "executor": { "$ref": "#/$defs/executor" }, "connector": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/versionedId" }] },
+    "status": { "enum": ["succeeded", "failed", "partial", "uncertain", "blocked"] }, "targetBeforeHash": { "$ref": "#/$defs/hash" }, "targetAfterHash": { "type": ["string", "null"], "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}$" }, "inputArtifactIds": { "$ref": "#/$defs/artifactIds" }, "outputArtifactIds": { "$ref": "#/$defs/artifactIds" }, "effectSummary": { "$ref": "#/$defs/effectSummary" }, "resultArtifactId": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "verificationPlanId": { "type": "string", "pattern": "^vfy_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "eventIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "pattern": "^evt_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" } }, "completedAt": { "type": "string", "format": "date-time" }, "resultHash": { "$ref": "#/$defs/hash" }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" }, "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}$" }, "effect": { "enum": ["read-only", "machine-local-write", "project-write", "provider-call", "external-effect", "destructive"] },
+    "versionedId": { "type": "object", "additionalProperties": false, "required": ["id", "version"], "properties": { "id": { "$ref": "#/$defs/id" }, "version": { "$ref": "#/$defs/version" } } }, "artifactIds": { "type": "array", "uniqueItems": true, "items": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" } },
+    "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" } } }, "target": { "type": "object", "additionalProperties": false, "required": ["kind", "id", "revision"], "properties": { "kind": { "$ref": "#/$defs/id" }, "id": { "type": "string", "minLength": 1, "maxLength": 128 }, "revision": { "type": "string", "minLength": 1, "maxLength": 128 } } }, "executor": { "type": "object", "additionalProperties": false, "required": ["executorId", "executorVersion"], "properties": { "executorId": { "$ref": "#/$defs/id" }, "executorVersion": { "$ref": "#/$defs/version" } } },
+    "effectSummary": { "type": "object", "additionalProperties": false, "required": ["changed", "summary", "affectedTargetIds"], "properties": { "changed": { "type": "boolean" }, "summary": { "type": "string", "minLength": 1, "maxLength": 2048 }, "affectedTargetIds": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 128 } } } }
+  }
+}