@openplanr/protocol 0.2.0

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

@@ -0,0 +1,204 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-challenger-review.schema.json",
+  "x-openplanr-contract": { "id": "operating-challenger-review", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 challenger review",
+  "description": "A closed, source-targeted critique of the exact accepted Advisor Artifacts issued to one Challenger Assignment.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "kind", "schemaVersion", "protocolVersion", "assignmentId", "roleId", "roleVersion",
+    "analysisProfile", "intelligencePlanId", "snapshotId", "scopeId", "domainId", "domainVersion",
+    "summary", "analysisMarkdown", "inputAbsenceIds", "advisorArtifactIds", "reviewedClaims", "questionCoverage",
+    "findings", "missingAlternatives", "dissent", "gaps"
+  ],
+  "properties": {
+    "kind": { "const": "operating-challenger-review" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "assignmentId": { "$ref": "#/$defs/assignmentId" },
+    "roleId": { "$ref": "#/$defs/identifier" },
+    "roleVersion": { "$ref": "#/$defs/version" },
+    "analysisProfile": { "$ref": "#/$defs/analysisProfile" },
+    "intelligencePlanId": { "$ref": "#/$defs/planId" },
+    "snapshotId": { "$ref": "#/$defs/snapshotId" },
+    "scopeId": { "$ref": "#/$defs/id" },
+    "domainId": { "$ref": "#/$defs/identifier" },
+    "domainVersion": { "$ref": "#/$defs/version" },
+    "summary": { "$ref": "#/$defs/text" },
+    "analysisMarkdown": { "$ref": "#/$defs/analysisMarkdown" },
+    "inputAbsenceIds": { "type": "array", "maxItems": 2048, "uniqueItems": true, "items": { "$ref": "#/$defs/absenceId" } },
+    "advisorArtifactIds": { "type": "array", "minItems": 1, "maxItems": 16, "uniqueItems": true, "items": { "$ref": "#/$defs/artifactId" } },
+    "reviewedClaims": { "type": "array", "maxItems": 2048, "items": { "$ref": "#/$defs/claimTarget" } },
+    "questionCoverage": { "type": "array", "minItems": 1, "maxItems": 16, "items": { "$ref": "#/$defs/questionCoverage" } },
+    "findings": { "type": "array", "maxItems": 256, "items": { "$ref": "#/$defs/finding" } },
+    "missingAlternatives": { "type": "array", "maxItems": 64, "items": { "$ref": "#/$defs/missingAlternative" } },
+    "dissent": { "type": "array", "maxItems": 128, "items": { "$ref": "#/$defs/dissent" } },
+    "gaps": { "type": "array", "maxItems": 128, "items": { "$ref": "#/$defs/gap" } }
+  },
+  "$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]*)$" },
+    "assignmentId": { "type": "string", "pattern": "^asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "planId": { "type": "string", "pattern": "^ipl_[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}$" },
+    "artifactId": { "type": "string", "pattern": "^art_[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}$" },
+    "advisorClaimId": { "type": "string", "pattern": "^claim:asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}:[1-9][0-9]*$" },
+    "advisorAnalysisId": { "type": "string", "pattern": "^analysis:asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}:[1-9][0-9]*$" },
+    "advisorMeasurementId": { "type": "string", "pattern": "^measurement:asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}:[1-9][0-9]*$" },
+    "advisorRiskId": { "type": "string", "pattern": "^risk:asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}:[1-9][0-9]*$" },
+    "advisorRecommendationId": { "type": "string", "pattern": "^recommendation:asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}:1$" },
+    "findingId": { "type": "string", "pattern": "^finding:asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}:[1-9][0-9]*$" },
+    "alternativeId": { "type": "string", "pattern": "^alternative:asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}:[1-9][0-9]*$" },
+    "dissentId": { "type": "string", "pattern": "^dissent:asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}:[1-9][0-9]*$" },
+    "gapId": { "type": "string", "pattern": "^gap:asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}:[1-9][0-9]*$" },
+    "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)?$", "not": { "pattern": "(?:<[^>]+>|\\{\\{[^}]+\\}\\})" } },
+    "analysisMarkdown": { "type": "string", "minLength": 1, "maxLength": 32768, "pattern": "^[\\s\\S]*\\S[\\s\\S]*$" },
+    "evidenceRefIds": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/evidenceRefId" } },
+    "analysisProfile": {
+      "type": "object", "additionalProperties": false, "required": ["id", "version", "questionIds"],
+      "properties": {
+        "id": { "$ref": "#/$defs/identifier" }, "version": { "$ref": "#/$defs/version" },
+        "questionIds": { "type": "array", "minItems": 1, "maxItems": 16, "uniqueItems": true, "items": { "$ref": "#/$defs/identifier" } }
+      }
+    },
+    "claimTarget": {
+      "type": "object", "additionalProperties": false, "required": ["advisorArtifactId", "localClaimId"],
+      "properties": { "advisorArtifactId": { "$ref": "#/$defs/artifactId" }, "localClaimId": { "$ref": "#/$defs/advisorClaimId" } }
+    },
+    "questionCoverage": {
+      "type": "object", "additionalProperties": false,
+      "required": ["questionId", "disposition", "answer", "findingIds", "alternativeIds", "dissentIds", "gapIds", "justification"],
+      "properties": {
+        "questionId": { "$ref": "#/$defs/identifier" },
+        "disposition": { "enum": ["answered", "gap", "not-applicable"] },
+        "answer": { "$ref": "#/$defs/text" },
+        "findingIds": { "type": "array", "maxItems": 256, "uniqueItems": true, "items": { "$ref": "#/$defs/findingId" } },
+        "alternativeIds": { "type": "array", "maxItems": 64, "uniqueItems": true, "items": { "$ref": "#/$defs/alternativeId" } },
+        "dissentIds": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/dissentId" } },
+        "gapIds": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/gapId" } },
+        "justification": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/text" }] }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "disposition": { "const": "answered" } }, "required": ["disposition"] },
+          "then": {
+            "properties": { "gapIds": { "maxItems": 0 }, "justification": { "const": null } },
+            "anyOf": [
+              { "properties": { "findingIds": { "minItems": 1 } } },
+              { "properties": { "alternativeIds": { "minItems": 1 } } },
+              { "properties": { "dissentIds": { "minItems": 1 } } }
+            ]
+          }
+        },
+        {
+          "if": { "properties": { "disposition": { "const": "gap" } }, "required": ["disposition"] },
+          "then": {
+            "properties": {
+              "findingIds": { "maxItems": 0 }, "alternativeIds": { "maxItems": 0 }, "dissentIds": { "maxItems": 0 },
+              "gapIds": { "minItems": 1 }, "justification": { "const": null }
+            }
+          }
+        },
+        {
+          "if": { "properties": { "disposition": { "const": "not-applicable" } }, "required": ["disposition"] },
+          "then": {
+            "properties": {
+              "findingIds": { "maxItems": 0 }, "alternativeIds": { "maxItems": 0 }, "dissentIds": { "maxItems": 0 },
+              "gapIds": { "maxItems": 0 }, "justification": { "$ref": "#/$defs/text" }
+            }
+          }
+        }
+      ]
+    },
+    "target": {
+      "type": "object", "additionalProperties": false,
+      "required": ["advisorArtifactId", "analysisIds", "claimIds", "measurementIds", "riskIds", "recommendationIds"],
+      "properties": {
+        "advisorArtifactId": { "$ref": "#/$defs/artifactId" },
+        "analysisIds": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/advisorAnalysisId" } },
+        "claimIds": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/advisorClaimId" } },
+        "measurementIds": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/advisorMeasurementId" } },
+        "riskIds": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/advisorRiskId" } },
+        "recommendationIds": { "type": "array", "maxItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/advisorRecommendationId" } }
+      },
+      "anyOf": [
+        { "properties": { "analysisIds": { "minItems": 1 } } },
+        { "properties": { "claimIds": { "minItems": 1 } } },
+        { "properties": { "measurementIds": { "minItems": 1 } } },
+        { "properties": { "riskIds": { "minItems": 1 } } },
+        { "properties": { "recommendationIds": { "minItems": 1 } } }
+      ]
+    },
+    "finding": {
+      "type": "object", "additionalProperties": false,
+      "required": ["localFindingId", "title", "statement", "type", "severity", "confidence", "targets", "supportingEvidenceRefIds", "contradictingEvidenceRefIds", "rationale", "correctionCondition"],
+      "properties": {
+        "localFindingId": { "$ref": "#/$defs/findingId" },
+        "title": { "$ref": "#/$defs/title" },
+        "statement": { "$ref": "#/$defs/text" },
+        "type": { "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 },
+        "targets": { "type": "array", "minItems": 1, "maxItems": 64, "items": { "$ref": "#/$defs/target" } },
+        "supportingEvidenceRefIds": { "$ref": "#/$defs/evidenceRefIds" },
+        "contradictingEvidenceRefIds": { "$ref": "#/$defs/evidenceRefIds" },
+        "rationale": { "$ref": "#/$defs/text" },
+        "correctionCondition": { "$ref": "#/$defs/text" }
+      },
+      "allOf": [
+        { "if": { "properties": { "type": { "const": "contradicted" } }, "required": ["type"] }, "then": { "properties": { "contradictingEvidenceRefIds": { "minItems": 1 } } } },
+        { "if": { "properties": { "type": { "const": "correlated-reasoning" } }, "required": ["type"] }, "then": { "properties": { "targets": { "minItems": 2 } } } }
+      ]
+    },
+    "missingAlternative": {
+      "type": "object", "additionalProperties": false,
+      "required": ["localAlternativeId", "title", "description", "targets", "evidenceRefIds", "tradeoffs"],
+      "properties": {
+        "localAlternativeId": { "$ref": "#/$defs/alternativeId" }, "title": { "$ref": "#/$defs/title" },
+        "description": { "$ref": "#/$defs/text" }, "targets": { "type": "array", "minItems": 1, "maxItems": 64, "items": { "$ref": "#/$defs/target" } },
+        "evidenceRefIds": { "$ref": "#/$defs/evidenceRefIds" }, "tradeoffs": { "type": "array", "minItems": 1, "maxItems": 64, "items": { "$ref": "#/$defs/text" } }
+      }
+    },
+    "dissent": {
+      "type": "object", "additionalProperties": false,
+      "required": ["localDissentId", "findingIds", "statement", "evidenceRefIds", "resolutionCondition"],
+      "properties": {
+        "localDissentId": { "$ref": "#/$defs/dissentId" },
+        "findingIds": { "type": "array", "minItems": 1, "maxItems": 256, "uniqueItems": true, "items": { "$ref": "#/$defs/findingId" } },
+        "statement": { "$ref": "#/$defs/text" }, "evidenceRefIds": { "$ref": "#/$defs/evidenceRefIds" },
+        "resolutionCondition": { "$ref": "#/$defs/text" }
+      }
+    },
+    "gap": {
+      "oneOf": [
+        { "$ref": "#/$defs/roleGap" },
+        { "$ref": "#/$defs/evidenceGap" }
+      ]
+    },
+    "roleGap": {
+      "type": "object", "additionalProperties": false,
+      "required": ["localGapId", "inputAbsenceId", "kind", "roleId", "roleKind", "roleVersion", "sourceAssignmentId", "impact", "recoveryPath"],
+      "properties": {
+        "localGapId": { "$ref": "#/$defs/gapId" }, "inputAbsenceId": { "$ref": "#/$defs/absenceId" },
+        "kind": { "const": "role" }, "roleId": { "$ref": "#/$defs/identifier" },
+        "roleKind": { "enum": ["advisor", "challenger", "chair"] }, "roleVersion": { "$ref": "#/$defs/version" },
+        "sourceAssignmentId": { "type": ["string", "null"], "pattern": "^asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "impact": { "$ref": "#/$defs/text" }, "recoveryPath": { "$ref": "#/$defs/text" }
+      }
+    },
+    "evidenceGap": {
+      "type": "object", "additionalProperties": false,
+      "required": ["localGapId", "inputAbsenceId", "kind", "requirementId", "impact", "recoveryPath"],
+      "properties": {
+        "localGapId": { "$ref": "#/$defs/gapId" }, "inputAbsenceId": { "$ref": "#/$defs/absenceId" },
+        "kind": { "const": "evidence" }, "requirementId": { "$ref": "#/$defs/identifier" },
+        "impact": { "$ref": "#/$defs/text" }, "recoveryPath": { "$ref": "#/$defs/text" }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-checkpoint.schema.json",
+  "x-openplanr-contract": { "id": "operating-checkpoint", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 runtime checkpoint",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "createdAt", "eventHead", "runtimeStateHash", "eventReplayIndexHash", "recordDigests", "blobHashes", "recoveryVersion"],
+  "properties": {
+    "kind": { "const": "operating-checkpoint" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "eventHead": {
+      "type": "object", "additionalProperties": false, "required": ["sequence", "hash", "protocolVersions"],
+      "properties": {
+        "sequence": { "type": "integer", "minimum": 0 },
+        "hash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" },
+        "protocolVersions": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 1,
+          "items": { "const": "2.0.0" }
+        }
+      }
+    },
+    "runtimeStateHash": { "$ref": "#/$defs/hash" },
+    "eventReplayIndexHash": {
+      "$ref": "#/$defs/hash",
+      "description": "SHA-256 JCS digest of the durable runtime state's complete eventReplayIndex at this checkpoint."
+    },
+    "operationReplayIndexHash": { "$ref": "#/$defs/hash" },
+    "authorityHistoryHash": { "$ref": "#/$defs/hash" },
+    "recordDigests": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/hash" } },
+    "blobHashes": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/hash" } },
+    "recoveryVersion": { "type": "string", "minLength": 1, "maxLength": 64 }
+  },
+  "allOf": [
+    { "if": { "required": ["operationReplayIndexHash"] }, "then": { "required": ["authorityHistoryHash"] } },
+    { "if": { "required": ["authorityHistoryHash"] }, "then": { "required": ["operationReplayIndexHash"] } }
+  ],
+  "$defs": { "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }
+}

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

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-claim.schema.json",
+  "x-openplanr-contract": { "id": "operating-claim", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 evidence-linked claim",
+  "description": "A material claim links typed supporting and/or contradicting EvidenceRefs. It is not arbitrary citation prose.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "claimId", "scopeId", "domainId", "domainVersion", "statement", "epistemicStatus", "confidence", "supportingEvidenceRefIds", "contradictingEvidenceRefIds", "assumptionIds", "changeCondition", "sourceArtifactId", "createdAt"],
+  "properties": {
+    "kind": { "const": "operating-claim" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" }, "claimId": { "$ref": "#/$defs/claimId" }, "scopeId": { "$ref": "#/$defs/id" }, "domainId": { "$ref": "#/$defs/id" }, "domainVersion": { "$ref": "#/$defs/version" }, "statement": { "$ref": "#/$defs/text" }, "epistemicStatus": { "enum": ["known", "strongly-supported", "probable", "speculative", "unknown"] }, "confidence": { "type": "number", "minimum": 0, "maximum": 1 }, "supportingEvidenceRefIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/evidenceRefId" } }, "contradictingEvidenceRefIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/evidenceRefId" } }, "assumptionIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/assumptionId" } }, "changeCondition": { "$ref": "#/$defs/text" }, "sourceArtifactId": { "$ref": "#/$defs/artifactId" }, "createdAt": { "type": "string", "format": "date-time" }
+  },
+  "allOf": [{ "if": { "properties": { "epistemicStatus": { "enum": ["known", "strongly-supported", "probable"] } } }, "then": { "anyOf": [{ "properties": { "supportingEvidenceRefIds": { "minItems": 1 } } }, { "properties": { "contradictingEvidenceRefIds": { "minItems": 1 } } }] } }],
+  "$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}$" }, "claimId": { "type": "string", "pattern": "^clm_[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 }, "text": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[\\s\\S]*\\S[\\s\\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-connector-checkpoint.schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-connector-checkpoint.schema.json",
+  "x-openplanr-contract": { "id": "operating-connector-checkpoint", "version": "2.0.0" },
+  "title": "Operating Connector Checkpoint",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "checkpointId", "generation", "lastEventId", "lastEventHash", "state", "requestId", "requestHash", "effect", "provider", "providerRegistrationHash", "adapterVersion", "sourceIdentityHash", "consentRecordId", "consentRecordHash", "consentExpiresAt", "runtimeCapabilityHash", "credentialRefHash", "boundsHash", "queryHash", "windowHash", "health", "redactionVersion", "predecessorDigest", "watermarkDigest", "artifactId", "artifactHash", "absenceDigest", "createdAt", "updatedAt", "checkpointHash"],
+  "properties": {
+    "kind": { "const": "operating-connector-checkpoint" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" },
+    "checkpointId": { "type": "string", "pattern": "^lchk_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "generation": { "type": "integer", "minimum": 0 }, "lastEventId": { "type": ["string", "null"], "pattern": "^lcev_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "lastEventHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" },
+    "state": { "enum": ["prepared", "requesting", "materialized", "committed", "absent", "uncertain"] },
+    "requestId": { "type": "string", "pattern": "^lreq_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "requestHash": { "$ref": "#/$defs/hash" }, "effect": { "const": "provider-call" },
+    "provider": { "$ref": "#/$defs/versionedId" }, "providerRegistrationHash": { "$ref": "#/$defs/hash" }, "adapterVersion": { "$ref": "#/$defs/version" }, "sourceIdentityHash": { "$ref": "#/$defs/hash" },
+    "consentRecordId": { "type": ["string", "null"], "pattern": "^lcon_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "consentRecordHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }, "consentExpiresAt": { "type": ["string", "null"], "format": "date-time" }, "runtimeCapabilityHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }, "credentialRefHash": { "$ref": "#/$defs/hash" }, "boundsHash": { "$ref": "#/$defs/hash" }, "queryHash": { "$ref": "#/$defs/hash" }, "windowHash": { "$ref": "#/$defs/hash" }, "health": { "$ref": "#/$defs/health" }, "redactionVersion": { "$ref": "#/$defs/version" },
+    "predecessorDigest": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }, "watermarkDigest": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" },
+    "artifactId": { "type": ["string", "null"], "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "artifactHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }, "absenceDigest": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" },
+    "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "checkpointHash": { "$ref": "#/$defs/hash" }
+  },
+  "allOf": [
+    { "if": { "properties": { "state": { "const": "prepared" } }, "required": ["state"] }, "then": { "properties": { "consentRecordId": { "const": null }, "consentRecordHash": { "const": null }, "consentExpiresAt": { "const": null }, "runtimeCapabilityHash": { "const": null }, "artifactId": { "const": null }, "artifactHash": { "const": null }, "absenceDigest": { "const": null } } } },
+    { "if": { "properties": { "state": { "enum": ["requesting", "materialized", "committed"] } }, "required": ["state"] }, "then": { "properties": { "consentRecordId": { "type": "string" }, "consentRecordHash": { "type": "string" }, "consentExpiresAt": { "type": "string" }, "runtimeCapabilityHash": { "type": "string" }, "absenceDigest": { "const": null } } } },
+    { "if": { "properties": { "state": { "const": "requesting" } }, "required": ["state"] }, "then": { "properties": { "artifactId": { "const": null }, "artifactHash": { "const": null } } } },
+    { "if": { "properties": { "state": { "enum": ["materialized", "committed"] } }, "required": ["state"] }, "then": { "properties": { "health": { "properties": { "status": { "const": "available" } } }, "artifactId": { "type": "string" }, "artifactHash": { "type": "string" } } } },
+    { "if": { "properties": { "state": { "enum": ["absent", "uncertain"] } }, "required": ["state"] }, "then": { "properties": { "artifactId": { "const": null }, "artifactHash": { "const": null }, "absenceDigest": { "type": "string" } } } }
+  ],
+  "$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}$" }, "versionedId": { "type": "object", "additionalProperties": false, "required": ["id", "version"], "properties": { "id": { "$ref": "#/$defs/id" }, "version": { "$ref": "#/$defs/version" } } }, "health": { "type": "object", "additionalProperties": false, "required": ["status", "checkedAt", "freshUntil", "proofDigest"], "properties": { "status": { "enum": ["available", "degraded", "unavailable"] }, "checkedAt": { "type": "string", "format": "date-time" }, "freshUntil": { "type": "string", "format": "date-time" }, "proofDigest": { "$ref": "#/$defs/hash" } } } }
+}

package/schemas/v2.0.0/operating-context-capture.schema.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-context-capture.schema.json",
+  "x-openplanr-contract": { "id": "operating-context-capture", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 context-capture result",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "contextKind", "scope"],
+  "properties": {
+    "kind": { "const": "operating-context-capture" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "contextKind": { "enum": ["cycle-evidence", "cycle-manifest"] },
+    "scope": { "$ref": "#/$defs/scope" },
+    "focus": {
+      "type": "array", "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1, "maxLength": 128 }
+    },
+    "trigger": { "$ref": "./operating-cycle.schema.json#/properties/trigger" },
+    "evidenceCandidates": {
+      "type": "array", "uniqueItems": true,
+      "items": { "$ref": "./operating-evidence-candidate.schema.json" }
+    },
+    "evidenceClaimLinks": {
+      "type": "array", "uniqueItems": true,
+      "items": { "$ref": "#/$defs/evidenceClaimLink" }
+    }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "contextKind": { "const": "cycle-evidence" } }, "required": ["contextKind"] },
+      "then": {
+        "required": ["focus", "trigger"],
+        "allOf": [
+          { "not": { "required": ["evidenceCandidates"] } },
+          { "not": { "required": ["evidenceClaimLinks"] } }
+        ]
+      }
+    },
+    {
+      "if": { "properties": { "contextKind": { "const": "cycle-manifest" } }, "required": ["contextKind"] },
+      "then": {
+        "required": ["evidenceCandidates", "evidenceClaimLinks"],
+        "allOf": [
+          { "not": { "required": ["focus"] } },
+          { "not": { "required": ["trigger"] } }
+        ]
+      }
+    }
+  ],
+  "$defs": {
+    "scope": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["scopeId", "domainId", "domainVersion"],
+      "properties": {
+        "scopeId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "domainId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "domainVersion": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)$" }
+      }
+    },
+    "evidenceClaimLink": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sourceArtifactId", "localClaimId", "relation", "confidence"],
+      "properties": {
+        "sourceArtifactId": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "localClaimId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "relation": { "enum": ["supportedBy", "contradictedBy"] },
+        "confidence": { "type": "number", "minimum": 0, "maximum": 1 }
+      }
+    }
+  }
+}

package/schemas/v2.0.0/operating-cycle-input-binding.schema.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-cycle-input-binding.schema.json",
+  "x-openplanr-contract": { "id": "operating-cycle-input-binding", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 cycle input binding",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "inputBindingId", "cycleId", "scopeId", "domainId", "domainVersion", "sourceArtifactIds", "runtimeBinding", "capturedAt"],
+  "properties": {
+    "kind": { "const": "operating-cycle-input-binding" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "inputBindingId": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "cycleId": { "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 },
+    "sourceArtifactIds": { "type": "array", "uniqueItems": true, "items": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" } },
+    "runtimeBinding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["runtime", "adapterVersion"],
+      "properties": {
+        "runtime": { "type": "string", "enum": ["codex", "claude-code", "cursor"] },
+        "adapterVersion": { "type": "string", "minLength": 1, "maxLength": 64 }
+      }
+    },
+    "capturedAt": { "type": "string", "format": "date-time" }
+  }
+}

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

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-cycle.schema.json",
+  "x-openplanr-contract": { "id": "operating-cycle", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 Phase 1 operating cycle",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "cycleId", "scopeId", "domainId", "domainVersion", "state", "inputBindingId", "contractVersions", "trigger", "focus", "health", "activeReviewId", "createdAt", "updatedAt"],
+  "properties": {
+    "kind": { "const": "operating-cycle" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "cycleId": { "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 },
+    "state": { "type": "string", "enum": ["created", "observing", "advising", "challenging", "synthesizing", "awaiting_review", "approved", "executing", "verifying", "closed", "blocked", "failed", "cancelled"] },
+    "inputBindingId": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "contractVersions": { "type": "object", "additionalProperties": { "type": "string", "minLength": 1 } },
+    "trigger": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind"],
+      "properties": { "kind": { "const": "manual" } }
+    },
+    "focus": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 128 } },
+    "health": { "type": "string", "enum": ["normal", "quiet", "partial", "blocked"] },
+    "activeReviewId": { "type": ["string", "null"], "pattern": "^rev_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "updatedAt": { "type": "string", "format": "date-time" },
+    "closedAt": { "type": ["string", "null"], "format": "date-time" }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "state": { "const": "closed" } } },
+      "then": {
+        "required": ["closedAt"],
+        "properties": { "activeReviewId": { "const": null }, "closedAt": { "type": "string", "format": "date-time" } }
+      }
+    }
+  ]
+}