@openplanr/protocol 0.2.0

package/schemas/v2.0.0/operate-domain-registration.schema.json

@@ -0,0 +1,284 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operate-domain-registration.schema.json",
+  "x-openplanr-contract": { "id": "operate-domain-registration", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 domain registration",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "domainId", "domainVersion", "provenance", "roles", "requirements"],
+  "properties": {
+    "kind": { "const": "operate-domain-registration" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "domainId": { "$ref": "#/$defs/identifier" },
+    "domainVersion": { "$ref": "#/$defs/version" },
+    "domainContract": { "$ref": "#/$defs/domainContract" },
+    "provenance": { "$ref": "#/$defs/provenance" },
+    "roles": { "type": "array", "minItems": 1, "maxItems": 16, "uniqueItems": true, "items": { "$ref": "#/$defs/role" } },
+    "vocabulary": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/vocabularyTerm" } },
+    "projectionContracts": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/projectionContract" } },
+    "actionKinds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/actionKind" } },
+    "requestedCapabilities": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/requestedCapability" } },
+    "policyRequirements": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/policyRequirement" } },
+    "requirements": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/identifier" } }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "domainId": { "enum": ["business", "software"] } } },
+      "then": { "required": ["domainContract"] }
+    },
+    {
+      "if": { "properties": { "domainId": { "const": "business" } } },
+      "then": {
+        "properties": {
+          "domainContract": { "$ref": "#/$defs/businessDomainContract" },
+          "projectionContracts": { "$ref": "#/$defs/businessProjectionContracts" },
+          "roles": { "$ref": "#/$defs/rolesWithChallenger" }
+        }
+      }
+    },
+    {
+      "if": { "properties": { "domainId": { "const": "software" } } },
+      "then": {
+        "properties": {
+          "domainContract": { "$ref": "#/$defs/softwareDomainContract" },
+          "projectionContracts": { "$ref": "#/$defs/softwareProjectionContracts" },
+          "roles": { "$ref": "#/$defs/rolesWithChallenger" }
+        }
+      }
+    }
+  ],
+  "$defs": {
+    "identifier": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" },
+    "label": { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^\\S(?:.*\\S)?$" },
+    "version": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)$" },
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "domainContract": {
+      "type": "object", "additionalProperties": false,
+      "required": ["apiDomainId", "id", "version"],
+      "properties": {
+        "apiDomainId": { "$ref": "#/$defs/identifier" },
+        "id": { "$ref": "#/$defs/identifier" },
+        "version": { "$ref": "#/$defs/version" }
+      }
+    },
+    "businessDomainContract": {
+      "type": "object", "additionalProperties": false,
+      "required": ["apiDomainId", "id", "version"],
+      "properties": {
+        "apiDomainId": { "const": "business" },
+        "id": { "const": "business-domain" },
+        "version": { "const": "1.0.0" }
+      }
+    },
+    "softwareDomainContract": {
+      "type": "object", "additionalProperties": false,
+      "required": ["apiDomainId", "id", "version"],
+      "properties": {
+        "apiDomainId": { "const": "software" },
+        "id": { "const": "software-domain" },
+        "version": { "const": "1.0.0" }
+      }
+    },
+    "provenance": {
+      "type": "object", "additionalProperties": false,
+      "required": ["packageName", "packageVersion", "integrity"],
+      "properties": {
+        "packageName": { "$ref": "#/$defs/identifier" },
+        "packageVersion": { "$ref": "#/$defs/version" },
+        "integrity": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "output": {
+      "type": "object", "additionalProperties": false,
+      "required": ["schemaId", "schemaVersion", "mediaType", "maxBytes"],
+      "properties": {
+        "schemaId": { "enum": ["operating-advisor-result", "operating-challenger-review", "operating-decision-ledger"] },
+        "schemaVersion": { "const": "2.0.0" },
+        "mediaType": { "const": "application/json" },
+        "maxBytes": { "type": "integer", "minimum": 1, "maximum": 262144 }
+      }
+    },
+    "dependencyPolicy": {
+      "type": "object", "additionalProperties": false,
+      "required": ["id", "version"],
+      "properties": { "id": { "enum": ["none", "all-required", "threshold"] }, "version": { "const": "1.0.0" } }
+    },
+    "mandateCapability": {
+      "type": "string",
+      "enum": ["repository.read", "planr.read", "git.read", "artifact.read", "artifact.submit"]
+    },
+    "mandateForbiddenEffect": {
+      "type": "string",
+      "enum": ["repository.write", "production.deploy", "payment.change", "customer-contact", "publish", "spend", "ship", "governed-execution"]
+    },
+    "mandate": {
+      "type": "object", "additionalProperties": false,
+      "required": ["scope", "allowedEvidence", "allowedCapabilities", "forbiddenEffects", "capabilityCeiling", "skillId"],
+      "properties": {
+        "scope": { "$ref": "#/$defs/text" },
+        "allowedEvidence": {
+          "type": "array", "minItems": 1, "uniqueItems": true,
+          "items": { "$ref": "#/$defs/text" }
+        },
+        "allowedCapabilities": {
+          "type": "array", "minItems": 2, "maxItems": 5, "uniqueItems": true,
+          "items": { "$ref": "#/$defs/mandateCapability" }
+        },
+        "forbiddenEffects": {
+          "type": "array", "minItems": 8, "maxItems": 8, "uniqueItems": true,
+          "items": { "$ref": "#/$defs/mandateForbiddenEffect" }
+        },
+        "capabilityCeiling": { "const": "read-only" },
+        "skillId": { "$ref": "#/$defs/identifier" }
+      },
+      "allOf": [
+        { "properties": { "allowedCapabilities": { "contains": { "const": "artifact.read" } } } },
+        { "properties": { "allowedCapabilities": { "contains": { "const": "artifact.submit" } } } }
+      ]
+    },
+    "role": {
+      "type": "object", "additionalProperties": false,
+      "required": ["roleId", "roleKind", "label", "roleVersion", "output", "mandate", "analysisRubric", "analysisProfile", "evidenceRequirements", "resultRequirements", "selfAudit", "dependencyPolicy", "requirements"],
+      "properties": {
+        "roleId": { "$ref": "#/$defs/identifier" },
+        "roleKind": { "enum": ["advisor", "challenger", "chair"] },
+        "label": { "$ref": "#/$defs/label" },
+        "roleVersion": { "const": "2.0.0" },
+        "output": { "$ref": "#/$defs/output" },
+        "mandate": { "$ref": "#/$defs/mandate" },
+        "analysisRubric": { "$ref": "#/$defs/analysisRubric" },
+        "analysisProfile": { "$ref": "operating-assignment.schema.json#/$defs/analysisProfile" },
+        "evidenceRequirements": { "type": "array", "maxItems": 64, "items": { "$ref": "operating-assignment.schema.json#/$defs/evidenceRequirement" } },
+        "resultRequirements": { "type": "array", "minItems": 1, "maxItems": 64, "items": { "$ref": "operating-assignment.schema.json#/$defs/resultRequirement" } },
+        "selfAudit": { "$ref": "#/$defs/selfAudit" },
+        "dependencyPolicy": { "$ref": "#/$defs/dependencyPolicy" },
+        "requirements": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/identifier" } }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "roleKind": { "const": "advisor" } } },
+          "then": { "properties": { "output": { "properties": { "schemaId": { "const": "operating-advisor-result" } } }, "evidenceRequirements": { "minItems": 1 } } }
+        },
+        {
+          "if": { "properties": { "roleKind": { "const": "challenger" } } },
+          "then": { "properties": { "output": { "properties": { "schemaId": { "const": "operating-challenger-review" } } } } }
+        },
+        {
+          "if": { "properties": { "roleKind": { "const": "chair" } } },
+          "then": { "properties": { "output": { "properties": { "schemaId": { "const": "operating-decision-ledger" } } } } }
+        }
+      ]
+    },
+    "analysisRubric": {
+      "type": "object", "additionalProperties": false,
+      "required": ["requiredQuestions", "requiredEvidence", "failureModes", "artifactQualityBar", "outOfScope"],
+      "properties": {
+        "requiredQuestions": { "$ref": "#/$defs/rubricClauses" },
+        "requiredEvidence": { "$ref": "#/$defs/rubricClauses" },
+        "failureModes": { "$ref": "#/$defs/rubricClauses" },
+        "artifactQualityBar": { "$ref": "#/$defs/rubricClauses" },
+        "outOfScope": { "$ref": "#/$defs/rubricClauses" }
+      }
+    },
+    "selfAudit": {
+      "type": "object", "additionalProperties": false,
+      "required": ["evidenceCoverage", "questionCoverage", "claimQuality", "profileCompleteness", "gapsAndUncertainty", "forbiddenEffects", "promptInjection", "machinePreflight"],
+      "properties": {
+        "evidenceCoverage": { "$ref": "#/$defs/rubricClauses" },
+        "questionCoverage": { "$ref": "#/$defs/rubricClauses" },
+        "claimQuality": { "$ref": "#/$defs/rubricClauses" },
+        "profileCompleteness": { "$ref": "#/$defs/rubricClauses" },
+        "gapsAndUncertainty": { "$ref": "#/$defs/rubricClauses" },
+        "forbiddenEffects": { "$ref": "#/$defs/rubricClauses" },
+        "promptInjection": { "$ref": "#/$defs/rubricClauses" },
+        "machinePreflight": { "$ref": "#/$defs/rubricClauses" }
+      }
+    },
+    "rubricClauses": {
+      "type": "array", "minItems": 1, "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1, "maxLength": 1024, "pattern": "^\\S(?:.*\\S)?$" }
+    },
+    "actionKind": {
+      "type": "object", "additionalProperties": false,
+      "required": ["id", "version"],
+      "properties": {
+        "id": { "$ref": "#/$defs/identifier" },
+        "version": { "$ref": "#/$defs/version" }
+      }
+    },
+    "projectionContract": {
+      "type": "object", "additionalProperties": false,
+      "required": ["schemaId", "schemaVersion"],
+      "properties": {
+        "schemaId": { "$ref": "#/$defs/identifier" },
+        "schemaVersion": { "$ref": "#/$defs/version" }
+      }
+    },
+    "businessProjectionContracts": {
+      "type": "array", "minItems": 1, "maxItems": 1,
+      "items": {
+        "type": "object", "additionalProperties": false,
+        "required": ["schemaId", "schemaVersion"],
+        "properties": {
+          "schemaId": { "const": "business-operating-snapshot-projection" },
+          "schemaVersion": { "const": "1.0.0" }
+        }
+      }
+    },
+    "softwareProjectionContracts": {
+      "type": "array", "minItems": 1, "maxItems": 1,
+      "items": {
+        "type": "object", "additionalProperties": false,
+        "required": ["schemaId", "schemaVersion"],
+        "properties": {
+          "schemaId": { "const": "software-operating-snapshot-projection" },
+          "schemaVersion": { "const": "1.0.0" }
+        }
+      }
+    },
+    "requestedCapability": {
+      "type": "object", "additionalProperties": false,
+      "required": ["id", "version", "reason"],
+      "properties": {
+        "id": { "$ref": "#/$defs/identifier" },
+        "version": { "$ref": "#/$defs/version" },
+        "reason": { "$ref": "#/$defs/text" }
+      }
+    },
+    "policyRequirement": {
+      "type": "object", "additionalProperties": false,
+      "required": ["actionKind", "capability", "policy"],
+      "properties": {
+        "actionKind": { "$ref": "#/$defs/actionKind" },
+        "capability": { "type": "object", "additionalProperties": false, "required": ["id", "version"], "properties": { "id": { "$ref": "#/$defs/identifier" }, "version": { "$ref": "#/$defs/version" } } },
+        "policy": { "type": "object", "additionalProperties": false, "required": ["id", "version"], "properties": { "id": { "$ref": "#/$defs/identifier" }, "version": { "$ref": "#/$defs/version" } } }
+      }
+    },
+    "rolesWithChallenger": {
+      "type": "array",
+      "contains": {
+        "type": "object",
+        "required": ["roleKind", "roleVersion"],
+        "properties": {
+          "roleKind": { "const": "challenger" },
+          "roleVersion": { "const": "2.0.0" }
+        }
+      },
+      "minContains": 1,
+      "maxContains": 1
+    },
+    "text": {
+      "type": "string", "minLength": 1, "maxLength": 4096,
+      "pattern": "^.*\\S.*$"
+    },
+    "vocabularyTerm": {
+      "type": "object", "additionalProperties": false,
+      "required": ["term", "definition"],
+      "properties": {
+        "term": { "$ref": "#/$defs/identifier" },
+        "definition": { "$ref": "#/$defs/text" }
+      }
+    }
+  }
+}

package/schemas/v2.0.0/operate-evidence-provider-registration.schema.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operate-evidence-provider-registration.schema.json",
+  "x-openplanr-contract": { "id": "operate-evidence-provider-registration", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 evidence provider registration",
+  "description": "A declaration for one explicit local evidence provider. Registration is data, not a code-loading or authority grant.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "providerId", "providerVersion", "supportedEvidenceKinds", "inputContract", "outputContract", "effectClass", "requiredCapabilities", "classificationCeiling", "retentionClass", "provenance", "conformanceDigest", "implementation", "fallback"],
+  "properties": {
+    "kind": { "const": "operate-evidence-provider-registration" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "providerId": { "$ref": "#/$defs/identifier" },
+    "providerVersion": { "$ref": "#/$defs/version" },
+    "supportedEvidenceKinds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/evidenceKind" } },
+    "inputContract": { "$ref": "#/$defs/candidateContract" },
+    "outputContract": { "$ref": "#/$defs/resolutionContract" },
+    "effectClass": { "const": "local-read-only" },
+    "requiredCapabilities": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/capability" } },
+    "classificationCeiling": { "enum": ["public", "internal", "confidential", "restricted"] },
+    "retentionClass": { "enum": ["ephemeral", "project", "restricted-machine-local"] },
+    "provenance": { "$ref": "#/$defs/provenance" },
+    "conformanceDigest": { "$ref": "#/$defs/digest" },
+    "implementation": { "$ref": "#/$defs/builtInImplementation" },
+    "fallback": { "$ref": "#/$defs/unavailableFallback" }
+  },
+  "$defs": {
+    "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]*)$" },
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "evidenceKind": { "enum": ["git", "filesystem", "planr", "operate-artifact"] },
+    "capability": { "enum": ["evidence.git.read", "evidence.filesystem.read", "evidence.planr.read", "evidence.operate-artifact.read"] },
+    "candidateContract": {
+      "type": "object", "additionalProperties": false, "required": ["schemaId", "schemaVersion"],
+      "properties": { "schemaId": { "const": "operating-evidence-candidate" }, "schemaVersion": { "const": "2.0.0" } }
+    },
+    "resolutionContract": {
+      "type": "object", "additionalProperties": false, "required": ["schemaId", "schemaVersion"],
+      "properties": { "schemaId": { "const": "operating-evidence-resolution" }, "schemaVersion": { "const": "2.0.0" } }
+    },
+    "provenance": {
+      "type": "object", "additionalProperties": false, "required": ["packageName", "packageVersion", "integrity"],
+      "properties": { "packageName": { "$ref": "#/$defs/identifier" }, "packageVersion": { "$ref": "#/$defs/version" }, "integrity": { "$ref": "#/$defs/digest" } }
+    },
+    "builtInImplementation": {
+      "type": "object", "additionalProperties": false, "required": ["kind", "id"],
+      "properties": { "kind": { "const": "built-in" }, "id": { "$ref": "#/$defs/identifier" } }
+    },
+    "unavailableFallback": {
+      "type": "object", "additionalProperties": false, "required": ["kind", "errorCode"],
+      "properties": { "kind": { "const": "unavailable" }, "errorCode": { "const": "EVIDENCE_PROVIDER_UNAVAILABLE" } }
+    }
+  }
+}

package/schemas/v2.0.0/operate-evidence-resolver-registration.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operate-evidence-resolver-registration.schema.json",
+  "x-openplanr-contract": { "id": "operate-evidence-resolver-registration", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 evidence resolver registration",
+  "description": "A declaration for one explicit local resolver. It cannot identify a module, URL, function, plugin, or external implementation.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "resolverId", "resolverVersion", "supportedEvidenceKinds", "supportedSourceContracts", "inputContract", "outputContract", "evidenceRefContract", "effectClass", "requiredCapabilities", "classificationCeiling", "retentionClass", "errorCodes", "provenance", "conformanceDigest", "implementation", "fallback"],
+  "properties": {
+    "kind": { "const": "operate-evidence-resolver-registration" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "resolverId": { "$ref": "#/$defs/identifier" },
+    "resolverVersion": { "$ref": "#/$defs/version" },
+    "supportedEvidenceKinds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/evidenceKind" } },
+    "supportedSourceContracts": { "type": "array", "minItems": 1, "maxItems": 16, "uniqueItems": true, "items": { "$ref": "#/$defs/sourceContract" } },
+    "inputContract": { "$ref": "#/$defs/candidateContract" },
+    "outputContract": { "$ref": "#/$defs/resolutionContract" },
+    "evidenceRefContract": { "$ref": "#/$defs/evidenceRefContract" },
+    "effectClass": { "const": "local-read-only" },
+    "requiredCapabilities": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/capability" } },
+    "classificationCeiling": { "enum": ["public", "internal", "confidential", "restricted"] },
+    "retentionClass": { "enum": ["ephemeral", "project", "restricted-machine-local"] },
+    "errorCodes": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/resolverErrorCode" } },
+    "provenance": { "$ref": "#/$defs/provenance" },
+    "conformanceDigest": { "$ref": "#/$defs/digest" },
+    "implementation": { "$ref": "#/$defs/builtInImplementation" },
+    "fallback": { "$ref": "#/$defs/unavailableFallback" }
+  },
+  "$defs": {
+    "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]*)$" },
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "evidenceKind": { "enum": ["git", "filesystem", "planr", "operate-artifact"] },
+    "sourceContract": { "type": "object", "additionalProperties": false, "required": ["id", "version"], "properties": { "id": { "$ref": "#/$defs/identifier" }, "version": { "$ref": "#/$defs/version" } } },
+    "capability": { "enum": ["evidence.git.read", "evidence.filesystem.read", "evidence.planr.read", "evidence.operate-artifact.read"] },
+    "candidateContract": { "type": "object", "additionalProperties": false, "required": ["schemaId", "schemaVersion"], "properties": { "schemaId": { "const": "operating-evidence-candidate" }, "schemaVersion": { "const": "2.0.0" } } },
+    "resolutionContract": { "type": "object", "additionalProperties": false, "required": ["schemaId", "schemaVersion"], "properties": { "schemaId": { "const": "operating-evidence-resolution" }, "schemaVersion": { "const": "2.0.0" } } },
+    "evidenceRefContract": { "type": "object", "additionalProperties": false, "required": ["schemaId", "schemaVersion"], "properties": { "schemaId": { "const": "operating-evidence-ref" }, "schemaVersion": { "const": "2.0.0" } } },
+    "resolverErrorCode": { "enum": ["SOURCE_NOT_FOUND", "REVISION_NOT_FOUND", "OBJECT_TYPE_MISMATCH", "PATH_NOT_FOUND", "LINE_RANGE_INVALID", "ANCESTRY_MISMATCH", "ARTIFACT_NOT_FOUND", "ARTIFACT_HASH_MISMATCH", "SOURCE_UNTRACKED", "SOURCE_STALE", "CAPABILITY_DENIED", "CONSENT_REQUIRED", "SENSITIVITY_BLOCKED", "SECRET_DETECTED", "UNSUPPORTED_EVIDENCE_KIND", "EVIDENCE_RESOLVER_UNAVAILABLE", "EVIDENCE_SOURCE_SCOPE_MISMATCH", "EVIDENCE_LOCATOR_INVALID"] },
+    "provenance": { "type": "object", "additionalProperties": false, "required": ["packageName", "packageVersion", "integrity"], "properties": { "packageName": { "$ref": "#/$defs/identifier" }, "packageVersion": { "$ref": "#/$defs/version" }, "integrity": { "$ref": "#/$defs/digest" } } },
+    "builtInImplementation": { "type": "object", "additionalProperties": false, "required": ["kind", "id"], "properties": { "kind": { "const": "built-in" }, "id": { "$ref": "#/$defs/identifier" } } },
+    "unavailableFallback": { "type": "object", "additionalProperties": false, "required": ["kind", "errorCode"], "properties": { "kind": { "const": "unavailable" }, "errorCode": { "const": "EVIDENCE_RESOLVER_UNAVAILABLE" } } }
+  }
+}

package/schemas/v2.0.0/operate-executor-registration.schema.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://openplanr.dev/schemas/v2.0.0/operate-executor-registration.schema.json",
+  "x-openplanr-contract": { "id": "operate-executor-registration", "version": "2.0.0" }, "title": "OpenPlanr Operate 2.0 executor registration",
+  "type": "object", "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "executorId", "executorVersion", "operationKinds", "capabilities", "supportedActionKinds", "supportedDomains", "supportedTargetKinds", "effectCeiling", "inputContract", "outputContract", "rollbackContract", "errorContract", "errorCodes", "timeoutPolicy", "retryPolicy", "idempotency", "reconciliation", "health", "versionCompatibility", "provenance", "conformanceDigest", "implementation", "fallback"],
+  "properties": {
+    "kind": { "const": "operate-executor-registration" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" }, "executorId": { "$ref": "#/$defs/id" }, "executorVersion": { "$ref": "#/$defs/version" },
+    "operationKinds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "enum": ["execute", "rollback"] } }, "capabilities": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/versionedId" } }, "supportedActionKinds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/versionedId" } }, "supportedDomains": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }, "supportedTargetKinds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }, "effectCeiling": { "$ref": "#/$defs/effect" },
+    "inputContract": { "allOf": [{ "$ref": "#/$defs/contract" }, { "properties": { "schemaId": { "const": "operating-governed-operation" } } }] }, "outputContract": { "allOf": [{ "$ref": "#/$defs/contract" }, { "properties": { "schemaId": { "const": "operating-execution-result" } } }] }, "rollbackContract": { "allOf": [{ "$ref": "#/$defs/contract" }, { "properties": { "schemaId": { "const": "operating-rollback-result" } } }] }, "errorContract": { "allOf": [{ "$ref": "#/$defs/contract" }, { "properties": { "schemaId": { "const": "operate-api-envelope" } } }] },
+    "errorCodes": { "$ref": "#/$defs/errorCodes" }, "timeoutPolicy": { "$ref": "#/$defs/timeoutPolicy" }, "retryPolicy": { "$ref": "#/$defs/retryPolicy" }, "idempotency": { "$ref": "#/$defs/idempotency" }, "reconciliation": { "$ref": "#/$defs/reconciliation" }, "health": { "$ref": "#/$defs/health" }, "versionCompatibility": { "$ref": "#/$defs/versionCompatibility" },
+    "provenance": { "$ref": "#/$defs/provenance" }, "conformanceDigest": { "$ref": "#/$defs/hash" }, "implementation": { "$ref": "#/$defs/implementation" }, "fallback": { "$ref": "#/$defs/fallback" }
+  }, "$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" } } }, "contract": { "type": "object", "additionalProperties": false, "required": ["schemaId", "schemaVersion"], "properties": { "schemaId": { "$ref": "#/$defs/id" }, "schemaVersion": { "const": "2.0.0" } } },
+    "errorCodes": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]*$" } }, "timeoutPolicy": { "type": "object", "additionalProperties": false, "required": ["timeoutMs", "onTimeout"], "properties": { "timeoutMs": { "type": "integer", "minimum": 1, "maximum": 300000 }, "onTimeout": { "const": "fail-closed" } } }, "retryPolicy": { "type": "object", "additionalProperties": false, "required": ["maxAttempts", "backoff", "retryableErrorCodes"], "properties": { "maxAttempts": { "type": "integer", "minimum": 1, "maximum": 3 }, "backoff": { "enum": ["none", "fixed"] }, "retryableErrorCodes": { "$ref": "#/$defs/errorCodes" } } },
+    "idempotency": { "type": "object", "additionalProperties": false, "required": ["keySource", "replay", "intrinsicallyIdempotent"], "properties": { "keySource": { "const": "runtime-derived-request-fingerprint" }, "replay": { "const": "return-recorded-result" }, "intrinsicallyIdempotent": { "type": "boolean" } } },
+    "reconciliation": {
+      "type": "object", "additionalProperties": false, "required": ["supported", "mode"],
+      "properties": { "supported": { "type": "boolean" }, "mode": { "enum": ["none", "deterministic"] } },
+      "oneOf": [
+        { "properties": { "supported": { "const": false }, "mode": { "const": "none" } } },
+        { "properties": { "supported": { "const": true }, "mode": { "const": "deterministic" } } }
+      ]
+    },
+    "health": { "type": "object", "additionalProperties": false, "required": ["status", "checkedAt", "expiresAt", "healthHash"], "properties": { "status": { "enum": ["available", "degraded", "unavailable"] }, "checkedAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": "string", "format": "date-time" }, "healthHash": { "$ref": "#/$defs/hash" } } }, "versionCompatibility": { "type": "object", "additionalProperties": false, "required": ["protocolVersion", "minimumRuntimeVersion", "maximumRuntimeVersion"], "properties": { "protocolVersion": { "const": "2.0.0" }, "minimumRuntimeVersion": { "$ref": "#/$defs/version" }, "maximumRuntimeVersion": { "type": ["string", "null"], "pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)$" } } },
+    "provenance": { "type": "object", "additionalProperties": false, "required": ["packageName", "packageVersion", "integrity"], "properties": { "packageName": { "$ref": "#/$defs/id" }, "packageVersion": { "$ref": "#/$defs/version" }, "integrity": { "$ref": "#/$defs/hash" } } }, "implementation": { "type": "object", "additionalProperties": false, "required": ["source", "id"], "properties": { "source": { "enum": ["built-in", "public-optional", "external"] }, "id": { "$ref": "#/$defs/id" } } }, "fallback": { "type": "object", "additionalProperties": false, "required": ["kind", "errorCode"], "properties": { "kind": { "const": "unavailable" }, "errorCode": { "const": "EXECUTOR_UNAVAILABLE" } } }
+  }
+}

package/schemas/v2.0.0/operate-experience-live-patch.schema.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operate-experience-live-patch.schema.json",
+  "x-openplanr-contract": { "id": "operate-experience-live-patch", "version": "1.0.0" },
+  "title": "OpenPlanr Operate ordered experience patch",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "patchId", "scopeId", "domainId", "domainVersion", "actorId", "fromEventHead", "toEventHead", "fromViewHash", "toViewHash", "operations", "createdAt", "patchHash"],
+  "properties": {
+    "kind": { "const": "operate-experience-live-patch" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" },
+    "patchId": { "type": "string", "pattern": "^xpatch_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "scopeId": { "$ref": "#/$defs/id" }, "domainId": { "$ref": "#/$defs/id" }, "domainVersion": { "$ref": "#/$defs/version" }, "actorId": { "$ref": "#/$defs/id" },
+    "fromEventHead": { "$ref": "#/$defs/eventHead" }, "toEventHead": { "$ref": "#/$defs/eventHead" },
+    "fromViewHash": { "$ref": "#/$defs/hash" }, "toViewHash": { "$ref": "#/$defs/hash" },
+    "operations": { "type": "array", "items": { "$ref": "#/$defs/operation" } },
+    "createdAt": { "type": "string", "format": "date-time" }, "patchHash": { "$ref": "#/$defs/hash" }
+  },
+  "$defs": {
+    "id": { "type": "string", "minLength": 1, "maxLength": 128 }, "version": { "type": "string", "minLength": 1, "maxLength": 64 }, "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "eventHead": { "oneOf": [
+      { "type": "object", "additionalProperties": false, "required": ["sequence", "hash"], "properties": { "sequence": { "const": 0 }, "hash": { "type": "null" } } },
+      { "type": "object", "additionalProperties": false, "required": ["sequence", "hash"], "properties": { "sequence": { "type": "integer", "minimum": 1 }, "hash": { "$ref": "#/$defs/hash" } } }
+    ] },
+    "operation": {
+      "type": "object", "additionalProperties": false, "required": ["op", "path", "valueHash", "value"],
+      "properties": { "op": { "const": "replace" }, "path": { "enum": ["/status", "/attention", "/domainMetrics", "/cycles", "/inbox", "/actions", "/evidence", "/claims", "/rationale", "/outcomes", "/learnings", "/history", "/replay", "/allowedActions", "/omissions", "/export"] }, "valueHash": { "$ref": "#/$defs/hash" }, "value": {} },
+      "allOf": [
+        { "if": { "properties": { "path": { "const": "/status" } }, "required": ["path"] }, "then": { "properties": { "value": { "enum": ["ready", "read-only", "stale", "partial", "blocked", "offline", "incompatible", "corrupt"] } } } },
+        { "if": { "properties": { "path": { "const": "/attention" } }, "required": ["path"] }, "then": { "properties": { "value": { "type": "array", "items": { "$ref": "operate-experience-view.schema.json#/$defs/attention" } } } } },
+        { "if": { "properties": { "path": { "const": "/domainMetrics" } }, "required": ["path"] }, "then": { "properties": { "value": { "type": "array", "items": { "$ref": "operate-experience-view.schema.json#/$defs/domainMetric" } } } } },
+        { "if": { "properties": { "path": { "const": "/cycles" } }, "required": ["path"] }, "then": { "properties": { "value": { "type": "array", "items": { "$ref": "operate-experience-view.schema.json#/$defs/cycle" } } } } },
+        { "if": { "properties": { "path": { "const": "/inbox" } }, "required": ["path"] }, "then": { "properties": { "value": { "type": "array", "items": { "$ref": "operate-experience-view.schema.json#/$defs/inbox" } } } } },
+        { "if": { "properties": { "path": { "const": "/actions" } }, "required": ["path"] }, "then": { "properties": { "value": { "type": "array", "items": { "$ref": "operate-experience-view.schema.json#/$defs/action" } } } } },
+        { "if": { "properties": { "path": { "const": "/evidence" } }, "required": ["path"] }, "then": { "properties": { "value": { "type": "array", "items": { "$ref": "operate-experience-view.schema.json#/$defs/evidence" } } } } },
+        { "if": { "properties": { "path": { "const": "/claims" } }, "required": ["path"] }, "then": { "properties": { "value": { "type": "array", "items": { "$ref": "operate-experience-view.schema.json#/$defs/claim" } } } } },
+        { "if": { "properties": { "path": { "const": "/rationale" } }, "required": ["path"] }, "then": { "properties": { "value": { "type": "array", "items": { "$ref": "operate-experience-view.schema.json#/$defs/rationale" } } } } },
+        { "if": { "properties": { "path": { "const": "/outcomes" } }, "required": ["path"] }, "then": { "properties": { "value": { "type": "array", "items": { "$ref": "operate-experience-view.schema.json#/$defs/outcome" } } } } },
+        { "if": { "properties": { "path": { "const": "/learnings" } }, "required": ["path"] }, "then": { "properties": { "value": { "type": "array", "items": { "$ref": "operate-experience-view.schema.json#/$defs/learning" } } } } },
+        { "if": { "properties": { "path": { "const": "/history" } }, "required": ["path"] }, "then": { "properties": { "value": { "type": "array", "items": { "$ref": "operate-experience-view.schema.json#/$defs/history" } } } } },
+        { "if": { "properties": { "path": { "const": "/replay" } }, "required": ["path"] }, "then": { "properties": { "value": { "$ref": "operate-experience-view.schema.json#/$defs/replay" } } } },
+        { "if": { "properties": { "path": { "const": "/allowedActions" } }, "required": ["path"] }, "then": { "properties": { "value": { "type": "array", "items": { "$ref": "operate-experience-view.schema.json#/$defs/boundAllowedAction" } } } } },
+        { "if": { "properties": { "path": { "const": "/omissions" } }, "required": ["path"] }, "then": { "properties": { "value": { "type": "array", "items": { "$ref": "operate-experience-view.schema.json#/$defs/omission" } } } } },
+        { "if": { "properties": { "path": { "const": "/export" } }, "required": ["path"] }, "then": { "properties": { "value": { "type": "object", "additionalProperties": false, "required": ["formats", "accessSafe", "redactionCount"], "properties": { "formats": { "type": "array", "uniqueItems": true, "items": { "enum": ["json", "html"] } }, "accessSafe": { "const": true }, "redactionCount": { "type": "integer", "minimum": 0 } } } } } }
+      ]
+    }
+  }
+}

package/schemas/v2.0.0/operate-experience-preview.schema.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operate-experience-preview.schema.json",
+  "x-openplanr-contract": { "id": "operate-experience-preview", "version": "1.0.0" },
+  "title": "OpenPlanr Operate governed experience preview",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "previewId", "scopeId", "domainId", "domainVersion", "actorId", "subject", "eventHead", "sourceViewHash", "actionDigest", "allowedAction", "authority", "consequence", "reasonCodes", "transition", "issuedAt", "expiresAt", "previewHash"],
+  "properties": {
+    "kind": { "const": "operate-experience-preview" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "previewId": { "type": "string", "pattern": "^xprv_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "scopeId": { "$ref": "#/$defs/id" }, "domainId": { "$ref": "#/$defs/id" }, "domainVersion": { "$ref": "#/$defs/version" },
+    "actorId": { "$ref": "#/$defs/id" },
+    "subject": { "$ref": "#/$defs/subject" },
+    "eventHead": { "$ref": "#/$defs/eventHead" },
+    "sourceViewHash": { "$ref": "#/$defs/hash" },
+    "actionDigest": { "$ref": "#/$defs/hash" },
+    "allowedAction": { "$ref": "operate-allowed-action.schema.json" },
+    "authority": { "enum": ["allowed", "refused", "read-only"] },
+    "consequence": { "$ref": "#/$defs/text" },
+    "reasonCodes": { "type": "array", "uniqueItems": true, "items": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]*$" } },
+    "transition": { "$ref": "#/$defs/transition" },
+    "issuedAt": { "type": "string", "format": "date-time" },
+    "expiresAt": { "type": "string", "format": "date-time" },
+    "previewHash": { "$ref": "#/$defs/hash" }
+  },
+  "$defs": {
+    "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "version": { "type": "string", "minLength": 1, "maxLength": 64 },
+    "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "text": { "type": "string", "minLength": 1, "maxLength": 8192, "pattern": "^[\\s\\S]*\\S[\\s\\S]*$" },
+    "subject": {
+      "type": "object", "additionalProperties": false, "required": ["kind", "id", "revision", "hash"],
+      "properties": { "kind": { "enum": ["cycle", "assignment", "artifact", "decision", "review", "action"] }, "id": { "$ref": "#/$defs/id" }, "revision": { "type": ["integer", "null"], "minimum": 1 }, "hash": { "$ref": "#/$defs/hash" } },
+      "allOf": [
+        { "if": { "properties": { "kind": { "enum": ["decision", "action"] } }, "required": ["kind"] }, "then": { "properties": { "revision": { "type": "integer", "minimum": 1 } } } },
+        { "if": { "properties": { "kind": { "enum": ["cycle", "assignment", "artifact", "review"] } }, "required": ["kind"] }, "then": { "properties": { "revision": { "type": "null" } } } }
+      ]
+    },
+    "eventHead": { "oneOf": [
+      { "type": "object", "additionalProperties": false, "required": ["sequence", "hash"], "properties": { "sequence": { "const": 0 }, "hash": { "type": "null" } } },
+      { "type": "object", "additionalProperties": false, "required": ["sequence", "hash"], "properties": { "sequence": { "type": "integer", "minimum": 1 }, "hash": { "$ref": "#/$defs/hash" } } }
+    ] },
+    "transitionTarget": { "type": "object", "additionalProperties": false, "required": ["kind", "id", "revision", "hash", "disposition"], "properties": { "kind": { "$ref": "#/$defs/id" }, "id": { "$ref": "#/$defs/id" }, "revision": { "type": ["integer", "string", "null"], "minimum": 1, "minLength": 1, "maxLength": 128 }, "hash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }, "disposition": { "type": ["string", "null"], "minLength": 1, "maxLength": 128 } } },
+    "party": { "type": "object", "additionalProperties": false, "required": ["partyId", "actorKind", "actorId", "requiredCapability", "state", "redacted"], "properties": { "partyId": { "$ref": "#/$defs/id" }, "actorKind": { "enum": ["human", "engine"] }, "actorId": { "type": ["string", "null"], "minLength": 1, "maxLength": 128 }, "requiredCapability": { "type": "object", "additionalProperties": false, "required": ["id", "version"], "properties": { "id": { "$ref": "#/$defs/id" }, "version": { "$ref": "#/$defs/version" } } }, "state": { "enum": ["required", "recorded", "redacted"] }, "redacted": { "type": "boolean" } } },
+    "threshold": { "type": "object", "additionalProperties": false, "required": ["required", "recorded", "remaining", "parties"], "properties": { "required": { "type": "integer", "minimum": 1 }, "recorded": { "type": "integer", "minimum": 0 }, "remaining": { "type": "integer", "minimum": 0 }, "parties": { "type": "array", "items": { "$ref": "#/$defs/party" } } } },
+    "transition": { "type": "object", "additionalProperties": false, "required": ["kind", "targets", "reversible", "nextState", "threshold"], "properties": { "kind": { "enum": ["review", "approval", "verification", "execution", "rollback"] }, "targets": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/transitionTarget" } }, "reversible": { "type": "boolean" }, "nextState": { "$ref": "#/$defs/id" }, "threshold": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/threshold" }] } } }
+  }
+}