@openplanr/protocol 0.2.0

package/schemas/v1.2.0/landing-confirmation.schema.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.2.0/landing-confirmation.schema.json",
+  "title": "Protocol 1.2 Landing Confirmation Proof",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "confirmationId", "authority", "ownerActorId", "planId", "planHash", "shipReceiptHash", "phaseId", "operationIds", "effectSet", "currentTargetHash", "docket", "docketHash", "choice", "issuedAt", "expiresAt", "opaqueCapabilityHash", "confirmationHash"],
+  "properties": {
+    "kind": { "const": "landing-confirmation" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "1.2.0" },
+    "confirmationId": { "type": "string", "pattern": "^lcnf_[a-f0-9]{32}$" }, "authority": { "const": "none" }, "ownerActorId": { "type": "string", "minLength": 1, "maxLength": 128 }, "planId": { "type": "string", "pattern": "^land_[a-f0-9]{32}$" }, "planHash": { "$ref": "#/$defs/hash" }, "shipReceiptHash": { "$ref": "#/$defs/hash" }, "phaseId": { "$ref": "#/$defs/id" }, "operationIds": { "type": "array", "minItems": 1, "maxItems": 16, "uniqueItems": true, "items": { "type": "string", "pattern": "^lop_[a-f0-9]{32}$" } }, "effectSet": { "type": "array", "minItems": 1, "maxItems": 4, "uniqueItems": true, "items": { "enum": ["commit", "push-or-pr", "merge", "publish", "staging-deploy", "production-deploy", "rollback-or-compensation"] } }, "currentTargetHash": { "$ref": "#/$defs/hash" }, "docket": { "$ref": "#/$defs/docket" }, "docketHash": { "$ref": "#/$defs/hash" }, "choice": { "const": "confirm" }, "issuedAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": "string", "format": "date-time" }, "opaqueCapabilityHash": { "$ref": "#/$defs/hash" }, "confirmationHash": { "$ref": "#/$defs/hash" }
+  },
+  "allOf": [{ "properties": { "operationIds": { "maxItems": 1 }, "docket": { "properties": { "operationIds": { "maxItems": 1 } } } } }],
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" }, "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "docket": { "type": "object", "additionalProperties": false, "required": ["sourceReceiptHash", "candidateDigest", "targetHash", "currentTargetHash", "operationIds", "effectSet", "inputDigest", "providerPreconditionHashes", "sensitivity", "consequences", "recoveryClass", "canaryPolicyHash", "containmentPolicyHash", "expiresAt", "changedStateDiffHash", "authorityBoundary", "choices", "defaultChoice", "cancelEffect"], "properties": { "sourceReceiptHash": { "$ref": "#/$defs/hash" }, "candidateDigest": { "$ref": "#/$defs/hash" }, "targetHash": { "$ref": "#/$defs/hash" }, "currentTargetHash": { "$ref": "#/$defs/hash" }, "operationIds": { "type": "array", "minItems": 1, "maxItems": 16, "uniqueItems": true, "items": { "type": "string", "pattern": "^lop_[a-f0-9]{32}$" } }, "effectSet": { "type": "array", "minItems": 1, "maxItems": 4, "uniqueItems": true, "items": { "enum": ["commit", "push-or-pr", "merge", "publish", "staging-deploy", "production-deploy", "rollback-or-compensation"] } }, "inputDigest": { "$ref": "#/$defs/hash" }, "providerPreconditionHashes": { "type": "array", "maxItems": 32, "uniqueItems": true, "items": { "$ref": "#/$defs/hash" } }, "sensitivity": { "enum": ["public", "internal", "confidential", "restricted"] }, "consequences": { "type": "array", "minItems": 1, "maxItems": 16, "items": { "type": "string", "minLength": 1, "maxLength": 512 } }, "recoveryClass": { "enum": ["reversible", "compensatable", "irreversible"] }, "canaryPolicyHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }, "containmentPolicyHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }, "expiresAt": { "type": "string", "format": "date-time" }, "changedStateDiffHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }, "authorityBoundary": { "const": "portable-confirmation-is-not-effect-authority" }, "choices": { "type": "array", "minItems": 2, "maxItems": 2, "prefixItems": [{ "const": "confirm" }, { "const": "cancel" }], "items": false }, "defaultChoice": { "const": null }, "cancelEffect": { "const": "none" } } }
+  }
+}

package/schemas/v1.2.0/landing-event.schema.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.2.0/landing-event.schema.json",
+  "title": "Protocol 1.2 Landing Event",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "eventId", "sequence", "runId", "type", "fromState", "toState", "actor", "planHash", "requestHash", "operationId", "confirmationHash", "targetStateHash", "trafficStateHash", "residualStateHash", "previousEventHash", "timestamp", "eventHash"],
+  "properties": {
+    "kind": { "const": "landing-event" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "1.2.0" }, "eventId": { "type": "string", "pattern": "^levt_[a-f0-9]{32}$" }, "sequence": { "type": "integer", "minimum": 1 }, "runId": { "type": "string", "pattern": "^lrun_[a-f0-9]{32}$" }, "type": { "enum": ["plan.created", "phase.intent-recorded", "phase.dispatching", "phase.succeeded", "phase.failed", "phase.blocked", "phase.uncertain", "containment.applied", "recovery.required", "recovery.confirmed", "recovery.succeeded", "recovery.failed", "landing.completed", "landing.blocked"] }, "fromState": { "$ref": "#/$defs/state" }, "toState": { "$ref": "#/$defs/state" }, "actor": { "type": "object", "additionalProperties": false, "required": ["kind", "id"], "properties": { "kind": { "enum": ["human", "engine", "runtime"] }, "id": { "type": "string", "minLength": 1, "maxLength": 128 } } }, "planHash": { "$ref": "#/$defs/hash" }, "requestHash": { "$ref": "#/$defs/hash" }, "operationId": { "type": ["string", "null"], "pattern": "^lop_[a-f0-9]{32}$" }, "confirmationHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }, "targetStateHash": { "$ref": "#/$defs/hash" }, "trafficStateHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }, "residualStateHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }, "previousEventHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }, "timestamp": { "type": "string", "format": "date-time" }, "eventHash": { "$ref": "#/$defs/hash" }
+  },
+  "$defs": { "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "state": { "enum": ["planned", "awaiting-confirmation", "intent-recorded", "dispatching", "verifying", "recovery_required", "completed", "blocked", "uncertain"] } }
+}

package/schemas/v1.2.0/landing-operation-registry.schema.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.2.0/landing-operation-registry.schema.json",
+  "title": "Protocol 1.2 Landing Operation Registry",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "registryVersion", "authority", "operations", "registryHash"],
+  "properties": {
+    "kind": { "const": "landing-operation-registry" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "1.2.0" }, "registryVersion": { "const": "1.0.0" }, "authority": { "const": "none" }, "operations": { "type": "array", "minItems": 1, "maxItems": 32, "items": { "$ref": "#/$defs/operation" } }, "registryHash": { "$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}$" },
+    "operation": { "type": "object", "additionalProperties": false, "required": ["operationId", "operationVersion", "kind", "effectClass", "recoveryClass", "runtimeAdapterRequired", "portableAuthority", "inputContract", "outputContract", "compatibleOperateContracts", "registrationHash"], "properties": { "operationId": { "$ref": "#/$defs/id" }, "operationVersion": { "$ref": "#/$defs/version" }, "kind": { "enum": ["commit", "pull-request", "merge", "package", "publish", "deploy", "canary", "verify", "rollback", "compensate"] }, "effectClass": { "enum": ["project-write", "provider-call", "external-effect", "destructive"] }, "recoveryClass": { "enum": ["reversible", "compensatable", "irreversible"] }, "runtimeAdapterRequired": { "const": true }, "portableAuthority": { "const": "none" }, "inputContract": { "$ref": "#/$defs/contract" }, "outputContract": { "$ref": "#/$defs/contract" }, "compatibleOperateContracts": { "type": "array", "maxItems": 4, "uniqueItems": true, "items": { "enum": ["operate-executor-registration", "operating-governed-operation", "operating-action-verification-plan", "operating-checkpoint", "operating-rollback-plan", "operating-rollback-result"] } }, "registrationHash": { "$ref": "#/$defs/hash" } } },
+    "contract": { "type": "object", "additionalProperties": false, "required": ["schemaId", "schemaVersion", "protocolVersion"], "properties": { "schemaId": { "$ref": "#/$defs/id" }, "schemaVersion": { "$ref": "#/$defs/version" }, "protocolVersion": { "$ref": "#/$defs/version" } } }
+  }
+}

package/schemas/v1.2.0/landing-phase-receipt.schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.2.0/landing-phase-receipt.schema.json",
+  "title": "Protocol 1.2 Landing Phase Receipt",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "receiptId", "runId", "planId", "planHash", "phaseId", "operationId", "operationRegistrationHash", "status", "effectClass", "authority", "requestHash", "attemptIdentity", "confirmation", "targetBeforeHash", "targetAfterHash", "evidenceHashes", "canary", "containment", "recovery", "operateBinding", "previousReceiptHash", "startedAt", "completedAt", "receiptHash"],
+  "properties": {
+    "kind": { "const": "landing-phase-receipt" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "1.2.0" }, "receiptId": { "type": "string", "pattern": "^lprc_[a-f0-9]{32}$" }, "runId": { "type": "string", "pattern": "^lrun_[a-f0-9]{32}$" }, "planId": { "type": "string", "pattern": "^land_[a-f0-9]{32}$" }, "planHash": { "$ref": "#/$defs/hash" }, "phaseId": { "$ref": "#/$defs/id" }, "operationId": { "type": "string", "pattern": "^lop_[a-f0-9]{32}$" }, "operationRegistrationHash": { "$ref": "#/$defs/hash" }, "status": { "enum": ["succeeded", "failed", "blocked", "uncertain", "recovery_required"] }, "effectClass": { "enum": ["project-write", "provider-call", "external-effect", "destructive"] }, "authority": { "const": "consumed-runtime-capability" }, "requestHash": { "$ref": "#/$defs/hash" }, "attemptIdentity": { "type": "string", "pattern": "^latm_[a-f0-9]{32}$" }, "confirmation": { "type": "object", "additionalProperties": false, "required": ["confirmationId", "confirmationHash", "opaqueCapabilityHash", "consumedAt"], "properties": { "confirmationId": { "type": "string", "pattern": "^lcnf_[a-f0-9]{32}$" }, "confirmationHash": { "$ref": "#/$defs/hash" }, "opaqueCapabilityHash": { "$ref": "#/$defs/hash" }, "consumedAt": { "type": "string", "format": "date-time" } } }, "targetBeforeHash": { "$ref": "#/$defs/hash" }, "targetAfterHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }, "evidenceHashes": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/hash" } }, "canary": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/canary" }] }, "containment": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/containment" }] }, "recovery": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/recovery" }] }, "operateBinding": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/recordRef" }] }, "previousReceiptHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }, "startedAt": { "type": "string", "format": "date-time" }, "completedAt": { "type": "string", "format": "date-time" }, "receiptHash": { "$ref": "#/$defs/hash" }
+  },
+  "allOf": [{ "if": { "properties": { "status": { "const": "recovery_required" } }, "required": ["status"] }, "then": { "properties": { "containment": { "$ref": "#/$defs/containment" }, "recovery": { "$ref": "#/$defs/recovery" } } } }],
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" }, "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "canary": { "type": "object", "additionalProperties": false, "required": ["status", "windowHash", "thresholdHash", "minimumEvidence", "artifactHashes", "absenceHashes"], "properties": { "status": { "enum": ["passed", "failed", "insufficient-evidence"] }, "windowHash": { "$ref": "#/$defs/hash" }, "thresholdHash": { "$ref": "#/$defs/hash" }, "minimumEvidence": { "type": "integer", "minimum": 1 }, "artifactHashes": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/hash" } }, "absenceHashes": { "type": "array", "maxItems": 64, "uniqueItems": true, "items": { "$ref": "#/$defs/hash" } } } },
+    "containment": { "type": "object", "additionalProperties": false, "required": ["policyHash", "applied", "stopPromotion", "stopNewTraffic", "failedTargetIsolated", "lastKnownGoodRetained", "trafficStateHash", "residualStateHash", "appliedAt"], "properties": { "policyHash": { "$ref": "#/$defs/hash" }, "applied": { "const": true }, "stopPromotion": { "const": true }, "stopNewTraffic": { "const": true }, "failedTargetIsolated": { "const": true }, "lastKnownGoodRetained": { "type": "boolean" }, "trafficStateHash": { "$ref": "#/$defs/hash" }, "residualStateHash": { "$ref": "#/$defs/hash" }, "appliedAt": { "type": "string", "format": "date-time" } } },
+    "recovery": { "type": "object", "additionalProperties": false, "required": ["state", "trafficStateHash", "residualStateHash", "expiresAt", "consequences", "choices", "defaultChoice", "authority"], "properties": { "state": { "const": "recovery_required" }, "trafficStateHash": { "$ref": "#/$defs/hash" }, "residualStateHash": { "$ref": "#/$defs/hash" }, "expiresAt": { "type": "string", "format": "date-time" }, "consequences": { "type": "array", "minItems": 1, "maxItems": 16, "items": { "type": "string", "minLength": 1, "maxLength": 512 } }, "choices": { "type": "array", "minItems": 1, "maxItems": 3, "uniqueItems": true, "items": { "enum": ["rollback", "compensate", "forward-fix"] } }, "defaultChoice": { "const": null }, "authority": { "const": "none" } } },
+    "recordRef": { "type": "object", "additionalProperties": false, "required": ["contractId", "schemaVersion", "protocolVersion", "recordId", "recordDigest"], "properties": { "contractId": { "enum": ["operating-governed-operation", "operating-action-verification-plan", "operating-checkpoint", "operating-rollback-plan", "operating-rollback-result"] }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" }, "recordId": { "type": "string", "minLength": 1, "maxLength": 128 }, "recordDigest": { "$ref": "#/$defs/hash" } } }
+  }
+}

package/schemas/v1.2.0/landing-plan.schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.2.0/landing-plan.schema.json",
+  "title": "Protocol 1.2 Landing Plan",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "planId", "authority", "shipClosure", "feature", "candidateDigest", "candidateInventoryDigest", "repositories", "currentTargetHash", "operations", "preconditions", "createdAt", "expiresAt", "planHash"],
+  "properties": {
+    "kind": { "const": "landing-plan" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "1.2.0" },
+    "planId": { "type": "string", "pattern": "^land_[a-f0-9]{32}$" },
+    "authority": { "const": "none" },
+    "shipClosure": { "$ref": "#/$defs/shipClosure" },
+    "feature": { "type": "string", "minLength": 1, "maxLength": 160 },
+    "candidateDigest": { "$ref": "#/$defs/hash" },
+    "candidateInventoryDigest": { "$ref": "#/$defs/hash" },
+    "repositories": { "type": "array", "minItems": 1, "maxItems": 16, "items": { "$ref": "#/$defs/repository" } },
+    "currentTargetHash": { "$ref": "#/$defs/hash" },
+    "operations": { "type": "array", "minItems": 1, "maxItems": 64, "items": { "$ref": "#/$defs/operation" } },
+    "preconditions": { "type": "array", "maxItems": 64, "items": { "type": "object", "additionalProperties": false, "required": ["id", "kind", "proofHash", "mandatory"], "properties": { "id": { "$ref": "#/$defs/id" }, "kind": { "enum": ["candidate-current", "target-current", "provider-available", "canary-ready", "rollback-ready", "containment-ready"] }, "proofHash": { "$ref": "#/$defs/hash" }, "mandatory": { "const": true } } } },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "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}$" },
+    "shipClosure": { "type": "object", "additionalProperties": false, "required": ["contractId", "schemaVersion", "protocolVersion", "recordType", "runId", "terminalStatus", "receiptHash", "recordDigest"], "properties": { "contractId": { "const": "ship-closure" }, "schemaVersion": { "enum": ["1.0.0", "1.1.0", "1.2.0"] }, "protocolVersion": { "const": "1.1.0" }, "recordType": { "const": "receipt" }, "runId": { "type": "string", "pattern": "^ship_[a-f0-9]{32}$" }, "terminalStatus": { "const": "passed" }, "receiptHash": { "$ref": "#/$defs/hash" }, "recordDigest": { "$ref": "#/$defs/hash" } } },
+    "repository": { "type": "object", "additionalProperties": false, "required": ["repositoryKey", "baselineDigest", "head", "inventoryDigest", "projectionDigest"], "properties": { "repositoryKey": { "$ref": "#/$defs/id" }, "baselineDigest": { "$ref": "#/$defs/hash" }, "head": { "type": "string", "pattern": "^[a-f0-9]{40,64}$" }, "inventoryDigest": { "$ref": "#/$defs/hash" }, "projectionDigest": { "$ref": "#/$defs/hash" } } },
+    "recordRef": { "type": "object", "additionalProperties": false, "required": ["contractId", "schemaVersion", "protocolVersion", "recordId", "recordDigest"], "properties": { "contractId": { "enum": ["operate-executor-registration", "operating-governed-operation", "operating-action-verification-plan", "operating-checkpoint", "operating-rollback-plan", "operating-rollback-result"] }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" }, "recordId": { "type": "string", "minLength": 1, "maxLength": 128 }, "recordDigest": { "$ref": "#/$defs/hash" } } },
+    "containment": { "type": "object", "additionalProperties": false, "required": ["policyHash", "state", "stopPromotion", "stopNewTraffic", "isolateFailedTarget", "retainLastKnownGood", "trafficStateHash", "residualStateHash", "expiresAt", "consequences", "recoveryChoices", "authority"], "properties": { "policyHash": { "$ref": "#/$defs/hash" }, "state": { "const": "preconfirmed" }, "stopPromotion": { "const": true }, "stopNewTraffic": { "const": true }, "isolateFailedTarget": { "const": true }, "retainLastKnownGood": { "type": "boolean" }, "trafficStateHash": { "$ref": "#/$defs/hash" }, "residualStateHash": { "$ref": "#/$defs/hash" }, "expiresAt": { "type": "string", "format": "date-time" }, "consequences": { "type": "array", "minItems": 1, "maxItems": 16, "items": { "type": "string", "minLength": 1, "maxLength": 512 } }, "recoveryChoices": { "type": "array", "minItems": 1, "maxItems": 3, "uniqueItems": true, "items": { "enum": ["rollback", "compensate", "forward-fix"] } }, "authority": { "const": "containment-only" } } },
+    "operation": { "type": "object", "additionalProperties": false, "required": ["operationId", "registryOperationId", "registrationHash", "kind", "repositoryKey", "dependsOn", "effectClass", "recoveryClass", "targetBeforeHash", "inputDigest", "outputContract", "preconditionHashes", "timeoutMs", "retryPolicy", "executorRegistration", "operateBindings", "containment"], "properties": { "operationId": { "type": "string", "pattern": "^lop_[a-f0-9]{32}$" }, "registryOperationId": { "$ref": "#/$defs/id" }, "registrationHash": { "$ref": "#/$defs/hash" }, "kind": { "enum": ["commit", "pull-request", "merge", "package", "publish", "deploy", "canary", "verify", "rollback", "compensate"] }, "repositoryKey": { "$ref": "#/$defs/id" }, "dependsOn": { "type": "array", "maxItems": 16, "uniqueItems": true, "items": { "type": "string", "pattern": "^lop_[a-f0-9]{32}$" } }, "effectClass": { "enum": ["project-write", "provider-call", "external-effect", "destructive"] }, "recoveryClass": { "enum": ["reversible", "compensatable", "irreversible"] }, "targetBeforeHash": { "$ref": "#/$defs/hash" }, "inputDigest": { "$ref": "#/$defs/hash" }, "outputContract": { "type": "object", "additionalProperties": false, "required": ["schemaId", "schemaVersion"], "properties": { "schemaId": { "$ref": "#/$defs/id" }, "schemaVersion": { "$ref": "#/$defs/version" } } }, "preconditionHashes": { "type": "array", "maxItems": 64, "uniqueItems": true, "items": { "$ref": "#/$defs/hash" } }, "timeoutMs": { "type": "integer", "minimum": 1, "maximum": 3600000 }, "retryPolicy": { "enum": ["none", "reconcile-before-retry"] }, "executorRegistration": { "allOf": [{ "$ref": "#/$defs/recordRef" }, { "properties": { "contractId": { "const": "operate-executor-registration" } } }] }, "operateBindings": { "type": "array", "maxItems": 6, "items": { "$ref": "#/$defs/recordRef" } }, "containment": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/containment" }] } }, "allOf": [{ "if": { "properties": { "kind": { "const": "deploy" } }, "required": ["kind"] }, "then": { "properties": { "containment": { "$ref": "#/$defs/containment" } } } }] }
+  }
+}

package/schemas/v1.2.0/landing-receipt.schema.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.2.0/landing-receipt.schema.json",
+  "title": "Protocol 1.2 Landing Receipt",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "receiptId", "runId", "authority", "shipClosure", "planId", "planHash", "candidateDigest", "candidateInventoryDigest", "status", "phaseReceipts", "journalHeadHash", "targetHash", "trafficStateHash", "residualStateHash", "recovery", "startedAt", "completedAt", "receiptHash"],
+  "properties": {
+    "kind": { "const": "landing-receipt" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "1.2.0" }, "receiptId": { "type": "string", "pattern": "^lrcp_[a-f0-9]{32}$" }, "runId": { "type": "string", "pattern": "^lrun_[a-f0-9]{32}$" }, "authority": { "const": "none" }, "shipClosure": { "$ref": "#/$defs/shipClosure" }, "planId": { "type": "string", "pattern": "^land_[a-f0-9]{32}$" }, "planHash": { "$ref": "#/$defs/hash" }, "candidateDigest": { "$ref": "#/$defs/hash" }, "candidateInventoryDigest": { "$ref": "#/$defs/hash" }, "status": { "enum": ["landed", "blocked", "uncertain", "recovery_required"] }, "phaseReceipts": { "type": "array", "maxItems": 64, "items": { "type": "object", "additionalProperties": false, "required": ["receiptId", "receiptHash", "operationId", "status"], "properties": { "receiptId": { "type": "string", "pattern": "^lprc_[a-f0-9]{32}$" }, "receiptHash": { "$ref": "#/$defs/hash" }, "operationId": { "type": "string", "pattern": "^lop_[a-f0-9]{32}$" }, "status": { "enum": ["succeeded", "failed", "blocked", "uncertain", "recovery_required"] } } } }, "journalHeadHash": { "$ref": "#/$defs/hash" }, "targetHash": { "$ref": "#/$defs/hash" }, "trafficStateHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }, "residualStateHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }, "recovery": { "type": "object", "additionalProperties": false, "required": ["required", "authority", "planHash", "resultHash", "choices", "defaultChoice"], "properties": { "required": { "type": "boolean" }, "authority": { "const": "none" }, "planHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }, "resultHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }, "choices": { "type": "array", "maxItems": 3, "uniqueItems": true, "items": { "enum": ["rollback", "compensate", "forward-fix"] } }, "defaultChoice": { "const": null } } }, "startedAt": { "type": "string", "format": "date-time" }, "completedAt": { "type": "string", "format": "date-time" }, "receiptHash": { "$ref": "#/$defs/hash" }
+  },
+  "$defs": { "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "shipClosure": { "type": "object", "additionalProperties": false, "required": ["contractId", "schemaVersion", "protocolVersion", "recordType", "runId", "terminalStatus", "receiptHash", "recordDigest"], "properties": { "contractId": { "const": "ship-closure" }, "schemaVersion": { "enum": ["1.0.0", "1.1.0", "1.2.0"] }, "protocolVersion": { "const": "1.1.0" }, "recordType": { "const": "receipt" }, "runId": { "type": "string", "pattern": "^ship_[a-f0-9]{32}$" }, "terminalStatus": { "const": "passed" }, "receiptHash": { "$ref": "#/$defs/hash" }, "recordDigest": { "$ref": "#/$defs/hash" } } } }
+}

package/schemas/v1.2.0/landing-workflow-catalog.schema.json

@@ -0,0 +1,143 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.2.0/landing-workflow-catalog.schema.json",
+  "title": "Protocol 1.2 Landing Workflow Catalog",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "kind",
+    "schemaVersion",
+    "protocolVersion",
+    "catalogVersion",
+    "authority",
+    "workflow",
+    "catalogHash"
+  ],
+  "properties": {
+    "kind": { "const": "landing-workflow-catalog" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "1.2.0" },
+    "catalogVersion": { "const": "1.0.0" },
+    "authority": { "const": "none" },
+    "workflow": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "workflowId",
+        "workflowVersion",
+        "objective",
+        "commands",
+        "hostAssets",
+        "authorityBoundary"
+      ],
+      "properties": {
+        "workflowId": { "const": "planr-land" },
+        "workflowVersion": { "const": "1.0.0" },
+        "objective": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "commands": {
+          "type": "array",
+          "minItems": 4,
+          "maxItems": 4,
+          "prefixItems": [
+            { "$ref": "#/$defs/prepareCommand" },
+            { "$ref": "#/$defs/showCommand" },
+            { "$ref": "#/$defs/statusCommand" },
+            { "$ref": "#/$defs/advanceCommand" }
+          ],
+          "items": false
+        },
+        "hostAssets": {
+          "type": "array",
+          "minItems": 3,
+          "maxItems": 3,
+          "prefixItems": [
+            { "$ref": "#/$defs/claudeAsset" },
+            { "$ref": "#/$defs/codexAsset" },
+            { "$ref": "#/$defs/cursorAsset" }
+          ],
+          "items": false
+        },
+        "authorityBoundary": { "const": "portable-json-is-not-effect-authority" }
+      }
+    },
+    "catalogHash": { "$ref": "#/$defs/hash" }
+  },
+  "$defs": {
+    "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "command": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "invocation",
+        "access",
+        "effect",
+        "agentCallable",
+        "machineJson",
+        "requiresTty",
+        "terminal"
+      ],
+      "properties": {
+        "id": { "enum": ["prepare", "show", "status", "advance"] },
+        "invocation": { "type": "string", "pattern": "^planr land (?:prepare|show|status|advance)$" },
+        "access": { "enum": ["read-only", "owner-interactive"] },
+        "effect": { "enum": ["none", "runtime-dispatch"] },
+        "agentCallable": { "type": "boolean" },
+        "machineJson": { "type": "boolean" },
+        "requiresTty": { "type": "boolean" },
+        "terminal": { "enum": ["ownerActionRequired", "read-only", "receipt-or-recovery"] }
+      }
+    },
+    "prepareCommand": {
+      "allOf": [
+        { "$ref": "#/$defs/command" },
+        { "properties": { "id": { "const": "prepare" }, "invocation": { "const": "planr land prepare" }, "access": { "const": "read-only" }, "effect": { "const": "none" }, "agentCallable": { "const": true }, "machineJson": { "const": true }, "requiresTty": { "const": false }, "terminal": { "const": "ownerActionRequired" } } }
+      ]
+    },
+    "showCommand": {
+      "allOf": [
+        { "$ref": "#/$defs/command" },
+        { "properties": { "id": { "const": "show" }, "invocation": { "const": "planr land show" }, "access": { "const": "read-only" }, "effect": { "const": "none" }, "agentCallable": { "const": true }, "machineJson": { "const": true }, "requiresTty": { "const": false }, "terminal": { "const": "ownerActionRequired" } } }
+      ]
+    },
+    "statusCommand": {
+      "allOf": [
+        { "$ref": "#/$defs/command" },
+        { "properties": { "id": { "const": "status" }, "invocation": { "const": "planr land status" }, "access": { "const": "read-only" }, "effect": { "const": "none" }, "agentCallable": { "const": true }, "machineJson": { "const": true }, "requiresTty": { "const": false }, "terminal": { "const": "read-only" } } }
+      ]
+    },
+    "advanceCommand": {
+      "allOf": [
+        { "$ref": "#/$defs/command" },
+        { "properties": { "id": { "const": "advance" }, "invocation": { "const": "planr land advance" }, "access": { "const": "owner-interactive" }, "effect": { "const": "runtime-dispatch" }, "agentCallable": { "const": false }, "machineJson": { "const": false }, "requiresTty": { "const": true }, "terminal": { "const": "receipt-or-recovery" } } }
+      ]
+    },
+    "asset": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["runtime", "path"],
+      "properties": {
+        "runtime": { "enum": ["claude-code", "codex", "cursor"] },
+        "path": { "type": "string", "minLength": 1, "maxLength": 256 }
+      }
+    },
+    "claudeAsset": {
+      "allOf": [
+        { "$ref": "#/$defs/asset" },
+        { "properties": { "runtime": { "const": "claude-code" }, "path": { "const": "skills/planr-land/SKILL.md" } } }
+      ]
+    },
+    "codexAsset": {
+      "allOf": [
+        { "$ref": "#/$defs/asset" },
+        { "properties": { "runtime": { "const": "codex" }, "path": { "const": "adapters/codex/skills/planr-land/SKILL.md" } } }
+      ]
+    },
+    "cursorAsset": {
+      "allOf": [
+        { "$ref": "#/$defs/asset" },
+        { "properties": { "runtime": { "const": "cursor" }, "path": { "const": "adapters/cursor/rules/openplanr-land.mdc" } } }
+      ]
+    }
+  }
+}

package/schemas/v1.2.0/operate-action-display-workspace.schema.json

@@ -0,0 +1,119 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://openplanr.dev/schemas/v1.2.0/operate-action-display-workspace.schema.json",
+	"x-openplanr-contract": {
+		"id": "operate-action-display-workspace",
+		"version": "1.0.0"
+	},
+	"title": "OpenPlanr browser-verifiable sanitized Action workspace",
+	"type": "object",
+	"additionalProperties": false,
+	"required": ["kind", "schemaVersion", "protocolVersion", "payload", "integrity"],
+	"properties": {
+		"kind": { "const": "operate-action-display-workspace" },
+		"schemaVersion": { "const": "1.0.0" },
+		"protocolVersion": { "const": "2.0.0" },
+		"payload": { "$ref": "#/$defs/workspace" },
+		"integrity": { "$ref": "#/$defs/integrity" }
+	},
+	"$defs": {
+		"workspace": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": [
+				"ok", "kind", "schemaVersion", "protocolVersion", "readOnly",
+				"mutationEnabled", "scopeId", "domainId", "domainVersion", "actorId",
+				"accessLevel", "generatedAt", "eventHead", "viewHash", "status",
+				"reasonCodes", "data"
+			],
+			"properties": {
+				"ok": { "const": true },
+				"kind": { "const": "operate-action-workspace" },
+				"schemaVersion": { "const": "1.0.0" },
+				"protocolVersion": { "const": "2.0.0" },
+				"readOnly": { "type": "boolean" },
+				"mutationEnabled": { "type": "boolean" },
+				"scopeId": { "$ref": "../v2.0.0/operate-experience-view.schema.json#/$defs/id" },
+				"domainId": { "$ref": "../v2.0.0/operate-experience-view.schema.json#/$defs/id" },
+				"domainVersion": { "$ref": "../v2.0.0/operate-experience-view.schema.json#/$defs/version" },
+				"actorId": { "$ref": "../v2.0.0/operate-experience-view.schema.json#/$defs/id" },
+				"accessLevel": { "$ref": "../v2.0.0/operate-experience-view.schema.json#/$defs/accessLevel" },
+				"generatedAt": { "type": "string", "format": "date-time" },
+				"eventHead": { "$ref": "../v2.0.0/operate-experience-view.schema.json#/$defs/eventHead" },
+				"viewHash": { "$ref": "../v2.0.0/operate-experience-view.schema.json#/$defs/hash" },
+				"status": {
+					"enum": ["ready", "read-only", "stale", "partial", "blocked", "offline"]
+				},
+				"reasonCodes": {
+					"type": "array", "uniqueItems": true, "items": { "type": "string" }
+				},
+				"data": {
+					"type": "object",
+					"additionalProperties": false,
+					"required": [
+						"action", "outcome", "learnings", "inbox", "history", "replay",
+						"verification", "boundaries", "allowedActions"
+					],
+					"properties": {
+						"action": { "$ref": "../v2.0.0/operate-experience-view.schema.json#/$defs/action" },
+						"outcome": {
+							"oneOf": [
+								{ "type": "null" },
+								{ "$ref": "../v2.0.0/operate-experience-view.schema.json#/$defs/outcome" }
+							]
+						},
+						"learnings": {
+							"type": "array",
+							"items": { "$ref": "../v2.0.0/operate-experience-view.schema.json#/$defs/learning" }
+						},
+						"inbox": {
+							"type": "array",
+							"items": { "$ref": "../v2.0.0/operate-experience-view.schema.json#/$defs/inbox" }
+						},
+						"history": {
+							"type": "array",
+							"items": { "$ref": "../v2.0.0/operate-experience-view.schema.json#/$defs/history" }
+						},
+						"replay": { "$ref": "../v2.0.0/operate-experience-view.schema.json#/$defs/replay" },
+						"verification": {
+							"type": "object",
+							"additionalProperties": false,
+							"required": ["status", "reasonCodes"],
+							"properties": {
+								"status": { "enum": ["not-required", "verified", "unverified"] },
+								"reasonCodes": {
+									"type": "array", "uniqueItems": true, "items": { "type": "string" }
+								}
+							}
+						},
+						"boundaries": {
+							"type": "object",
+							"additionalProperties": false,
+							"required": ["approvalExecution", "verification", "retry"],
+							"properties": {
+								"approvalExecution": { "type": "string", "minLength": 1, "maxLength": 512 },
+								"verification": { "type": "string", "minLength": 1, "maxLength": 512 },
+								"retry": { "type": "string", "minLength": 1, "maxLength": 512 }
+							}
+						},
+						"allowedActions": {
+							"type": "array",
+							"items": { "$ref": "../v2.0.0/operate-experience-view.schema.json#/$defs/boundAllowedAction" }
+						}
+					}
+				}
+			}
+		},
+		"integrity": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": ["algorithm", "domain", "sourceViewHash", "contentHash"],
+			"properties": {
+				"algorithm": { "const": "sha-256-jcs" },
+				"domain": { "const": "openplanr:operate-action-display-workspace:1.0.0" },
+				"sourceViewHash": { "$ref": "../v2.0.0/operate-experience-view.schema.json#/$defs/hash" },
+				"contentHash": { "$ref": "../v2.0.0/operate-experience-view.schema.json#/$defs/hash" }
+			}
+		}
+	}
+}

package/schemas/v1.2.0/operate-cycle-display-workspace.schema.json

@@ -0,0 +1,109 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://openplanr.dev/schemas/v1.2.0/operate-cycle-display-workspace.schema.json",
+	"x-openplanr-contract": {
+		"id": "operate-cycle-display-workspace",
+		"version": "1.0.0"
+	},
+	"title": "OpenPlanr browser-verifiable sanitized Cycle workspace",
+	"type": "object",
+	"additionalProperties": false,
+	"required": ["kind", "schemaVersion", "protocolVersion", "payload", "integrity"],
+	"properties": {
+		"kind": { "const": "operate-cycle-display-workspace" },
+		"schemaVersion": { "const": "1.0.0" },
+		"protocolVersion": { "const": "2.0.0" },
+		"payload": { "$ref": "#/$defs/workspace" },
+		"integrity": { "$ref": "#/$defs/integrity" }
+	},
+	"$defs": {
+		"workspace": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": [
+				"ok", "kind", "schemaVersion", "protocolVersion", "readOnly",
+				"mutationEnabled", "scopeId", "domainId", "domainVersion", "actorId",
+				"accessLevel", "generatedAt", "eventHead", "viewHash", "truthSummary", "status",
+				"reasonCodes", "data"
+			],
+			"properties": {
+				"ok": { "const": true },
+				"kind": { "const": "operate-cycle-workspace" },
+				"schemaVersion": { "const": "1.0.0" },
+				"protocolVersion": { "const": "2.0.0" },
+				"readOnly": { "const": true },
+				"mutationEnabled": { "const": false },
+				"scopeId": { "$ref": "../v2.0.0/operate-experience-view.schema.json#/$defs/id" },
+				"domainId": { "$ref": "../v2.0.0/operate-experience-view.schema.json#/$defs/id" },
+				"domainVersion": { "$ref": "../v2.0.0/operate-experience-view.schema.json#/$defs/version" },
+				"actorId": { "$ref": "../v2.0.0/operate-experience-view.schema.json#/$defs/id" },
+				"accessLevel": { "$ref": "../v2.0.0/operate-experience-view.schema.json#/$defs/accessLevel" },
+				"generatedAt": { "type": "string", "format": "date-time" },
+				"eventHead": { "$ref": "../v2.0.0/operate-experience-view.schema.json#/$defs/eventHead" },
+				"viewHash": { "$ref": "../v2.0.0/operate-experience-view.schema.json#/$defs/hash" },
+				"truthSummary": { "$ref": "../v2.0.0/operate-review-display-workspace.schema.json#/$defs/sharedTruthSummary" },
+				"status": {
+					"enum": ["ready", "read-only", "stale", "partial", "blocked", "offline"]
+				},
+				"reasonCodes": {
+					"type": "array", "uniqueItems": true, "items": { "type": "string" }
+				},
+				"data": {
+					"type": "object",
+					"additionalProperties": false,
+					"required": [
+						"ownerCycle", "cycle", "progress", "replay", "verification",
+						"persistentWork", "allowedActions"
+					],
+					"properties": {
+						"ownerCycle": { "type": "object" },
+						"cycle": { "type": "object" },
+						"progress": {
+							"$ref": "../v2.0.0/operate-api-envelope.schema.json#/$defs/cycleView/properties/progress"
+						},
+						"replay": { "$ref": "../v2.0.0/operate-experience-view.schema.json#/$defs/replay" },
+						"verification": {
+							"type": "object",
+							"additionalProperties": false,
+							"required": ["status", "reasonCodes"],
+							"properties": {
+								"status": { "enum": ["not-required", "verified", "unverified"] },
+								"reasonCodes": {
+									"type": "array", "uniqueItems": true, "items": { "type": "string" }
+								}
+							}
+						},
+						"persistentWork": {
+							"type": "object",
+							"additionalProperties": false,
+							"required": ["findings", "decisions", "actions", "outcomes", "learnings", "cycleLinks"],
+							"properties": {
+								"findings": { "type": "array" },
+								"decisions": { "type": "array" },
+								"actions": { "type": "array" },
+								"outcomes": { "type": "array" },
+								"learnings": { "type": "array" },
+								"cycleLinks": { "type": "array" }
+							}
+						},
+						"allowedActions": {
+							"type": "array", "minItems": 1, "maxItems": 1,
+							"items": { "$ref": "../v2.0.0/operate-allowed-action.schema.json" }
+						}
+					}
+				}
+			}
+		},
+		"integrity": {
+			"type": "object",
+			"additionalProperties": false,
+			"required": ["algorithm", "domain", "sourceViewHash", "contentHash"],
+			"properties": {
+				"algorithm": { "const": "sha-256-jcs" },
+				"domain": { "const": "openplanr:operate-cycle-display-workspace:1.0.0" },
+				"sourceViewHash": { "$ref": "../v2.0.0/operate-experience-view.schema.json#/$defs/hash" },
+				"contentHash": { "$ref": "../v2.0.0/operate-experience-view.schema.json#/$defs/hash" }
+			}
+		}
+	}
+}