@openplanr/protocol 0.2.0

package/schemas/v2.0.0/operate-tool-call.schema.json

@@ -0,0 +1,172 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operate-tool-call.schema.json",
+  "x-openplanr-contract": { "id": "operate-tool-call", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 tool call",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "direction", "operation"],
+  "properties": {
+    "kind": { "const": "operate-tool-call" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "direction": { "type": "string", "enum": ["request", "response"] },
+    "operation": { "type": "string", "enum": ["operate.cycle.start", "operate.cycle.get", "operate.cycle.resume", "operate.assignment.claim", "operate.assignment.submit", "operate.artifact.get", "operate.review.get", "operate.review.submit", "operate.action.approve", "operate.action.execute", "operate.action.rollback"] },
+    "request": {},
+    "response": { "$ref": "operate-api-envelope.schema.json" }
+  },
+  "oneOf": [
+    { "title": "cycle.start request", "$ref": "#/$defs/cycleStartRequest" },
+    { "title": "cycle.get request", "$ref": "#/$defs/cycleGetRequest" },
+    { "title": "cycle.resume request", "$ref": "#/$defs/cycleResumeRequest" },
+    { "title": "assignment.claim request", "$ref": "#/$defs/assignmentClaimRequest" },
+    { "title": "assignment.submit request", "$ref": "#/$defs/assignmentSubmitRequest" },
+    { "title": "artifact.get request", "$ref": "#/$defs/artifactGetRequest" },
+    { "title": "review.get request", "$ref": "#/$defs/reviewGetRequest" },
+    { "title": "review.submit request", "$ref": "#/$defs/reviewSubmitRequest" },
+    { "title": "action.approve request", "$ref": "#/$defs/actionApproveRequest" },
+    { "title": "action.execute request", "$ref": "#/$defs/actionExecuteRequest" },
+    { "title": "action.rollback request", "$ref": "#/$defs/actionRollbackRequest" },
+    { "title": "cycle.start response", "$ref": "#/$defs/cycleStartResponse" },
+    { "title": "cycle.get response", "$ref": "#/$defs/cycleGetResponse" },
+    { "title": "cycle.resume response", "$ref": "#/$defs/cycleResumeResponse" },
+    { "title": "assignment.claim response", "$ref": "#/$defs/assignmentClaimResponse" },
+    { "title": "assignment.submit response", "$ref": "#/$defs/assignmentSubmitResponse" },
+    { "title": "artifact.get response", "$ref": "#/$defs/artifactGetResponse" },
+    { "title": "review.get response", "$ref": "#/$defs/reviewGetResponse" },
+    { "title": "review.submit response", "$ref": "#/$defs/reviewSubmitResponse" },
+    { "title": "action.approve response", "$ref": "#/$defs/actionApproveResponse" },
+    { "title": "action.execute response", "$ref": "#/$defs/actionExecuteResponse" },
+    { "title": "action.rollback response", "$ref": "#/$defs/actionRollbackResponse" }
+  ],
+  "$defs": {
+    "requestBase": { "required": ["request"], "properties": { "direction": { "const": "request" } }, "not": { "required": ["response"] } },
+    "responseBase": { "required": ["response"], "properties": { "direction": { "const": "response" } }, "not": { "required": ["request"] } },
+    "cycleStartRequest": { "allOf": [{ "$ref": "#/$defs/requestBase" }, { "properties": { "operation": { "const": "operate.cycle.start" }, "request": { "$ref": "#/$defs/cycleStartArguments" } } }] },
+    "cycleGetRequest": { "allOf": [{ "$ref": "#/$defs/requestBase" }, { "properties": { "operation": { "const": "operate.cycle.get" }, "request": { "$ref": "#/$defs/cycleIdentityArguments" } } }] },
+    "cycleResumeRequest": { "allOf": [{ "$ref": "#/$defs/requestBase" }, { "properties": { "operation": { "const": "operate.cycle.resume" }, "request": { "$ref": "#/$defs/cycleIdentityArguments" } } }] },
+    "assignmentClaimRequest": { "allOf": [{ "$ref": "#/$defs/requestBase" }, { "properties": { "operation": { "const": "operate.assignment.claim" }, "request": { "$ref": "#/$defs/assignmentClaimArguments" } } }] },
+    "assignmentSubmitRequest": { "allOf": [{ "$ref": "#/$defs/requestBase" }, { "properties": { "operation": { "const": "operate.assignment.submit" }, "request": { "$ref": "#/$defs/assignmentSubmitArguments" } } }] },
+    "artifactGetRequest": { "allOf": [{ "$ref": "#/$defs/requestBase" }, { "properties": { "operation": { "const": "operate.artifact.get" }, "request": { "$ref": "#/$defs/artifactGetArguments" } } }] },
+    "reviewGetRequest": { "allOf": [{ "$ref": "#/$defs/requestBase" }, { "properties": { "operation": { "const": "operate.review.get" }, "request": { "$ref": "#/$defs/reviewIdentityArguments" } } }] },
+    "reviewSubmitRequest": { "allOf": [{ "$ref": "#/$defs/requestBase" }, { "properties": { "operation": { "const": "operate.review.submit" }, "request": { "$ref": "#/$defs/reviewSubmitArguments" } } }] },
+    "actionApproveRequest": { "allOf": [{ "$ref": "#/$defs/requestBase" }, { "properties": { "operation": { "const": "operate.action.approve" }, "request": { "$ref": "#/$defs/actionApproveArguments" } } }] },
+    "actionExecuteRequest": { "allOf": [{ "$ref": "#/$defs/requestBase" }, { "properties": { "operation": { "const": "operate.action.execute" }, "request": { "$ref": "#/$defs/actionExecuteArguments" } } }] },
+    "actionRollbackRequest": { "allOf": [{ "$ref": "#/$defs/requestBase" }, { "properties": { "operation": { "const": "operate.action.rollback" }, "request": { "$ref": "#/$defs/actionRollbackArguments" } } }] },
+    "cycleStartResponse": { "allOf": [{ "$ref": "#/$defs/responseBase" }, { "properties": { "operation": { "const": "operate.cycle.start" }, "response": { "allOf": [{ "$ref": "operate-api-envelope.schema.json" }, { "properties": { "operation": { "const": "operate.cycle.start" } } }] } } }] },
+    "cycleGetResponse": { "allOf": [{ "$ref": "#/$defs/responseBase" }, { "properties": { "operation": { "const": "operate.cycle.get" }, "response": { "allOf": [{ "$ref": "operate-api-envelope.schema.json" }, { "properties": { "operation": { "const": "operate.cycle.get" } } }] } } }] },
+    "cycleResumeResponse": { "allOf": [{ "$ref": "#/$defs/responseBase" }, { "properties": { "operation": { "const": "operate.cycle.resume" }, "response": { "allOf": [{ "$ref": "operate-api-envelope.schema.json" }, { "properties": { "operation": { "const": "operate.cycle.resume" } } }] } } }] },
+    "assignmentClaimResponse": { "allOf": [{ "$ref": "#/$defs/responseBase" }, { "properties": { "operation": { "const": "operate.assignment.claim" }, "response": { "allOf": [{ "$ref": "operate-api-envelope.schema.json" }, { "properties": { "operation": { "const": "operate.assignment.claim" } } }] } } }] },
+    "assignmentSubmitResponse": { "allOf": [{ "$ref": "#/$defs/responseBase" }, { "properties": { "operation": { "const": "operate.assignment.submit" }, "response": { "allOf": [{ "$ref": "operate-api-envelope.schema.json" }, { "properties": { "operation": { "const": "operate.assignment.submit" } } }] } } }] },
+    "artifactGetResponse": { "allOf": [{ "$ref": "#/$defs/responseBase" }, { "properties": { "operation": { "const": "operate.artifact.get" }, "response": { "allOf": [{ "$ref": "operate-api-envelope.schema.json" }, { "properties": { "operation": { "const": "operate.artifact.get" } } }] } } }] },
+    "reviewGetResponse": { "allOf": [{ "$ref": "#/$defs/responseBase" }, { "properties": { "operation": { "const": "operate.review.get" }, "response": { "allOf": [{ "$ref": "operate-api-envelope.schema.json" }, { "properties": { "operation": { "const": "operate.review.get" } } }] } } }] },
+    "reviewSubmitResponse": { "allOf": [{ "$ref": "#/$defs/responseBase" }, { "properties": { "operation": { "const": "operate.review.submit" }, "response": { "allOf": [{ "$ref": "operate-api-envelope.schema.json" }, { "properties": { "operation": { "const": "operate.review.submit" } } }] } } }] },
+    "actionApproveResponse": { "allOf": [{ "$ref": "#/$defs/responseBase" }, { "properties": { "operation": { "const": "operate.action.approve" }, "response": { "allOf": [{ "$ref": "operate-api-envelope.schema.json" }, { "properties": { "operation": { "const": "operate.action.approve" } } }] } } }] },
+    "actionExecuteResponse": { "allOf": [{ "$ref": "#/$defs/responseBase" }, { "properties": { "operation": { "const": "operate.action.execute" }, "response": { "allOf": [{ "$ref": "operate-api-envelope.schema.json" }, { "properties": { "operation": { "const": "operate.action.execute" } } }] } } }] },
+    "actionRollbackResponse": { "allOf": [{ "$ref": "#/$defs/responseBase" }, { "properties": { "operation": { "const": "operate.action.rollback" }, "response": { "allOf": [{ "$ref": "operate-api-envelope.schema.json" }, { "properties": { "operation": { "const": "operate.action.rollback" } } }] } } }] },
+    "cycleStartArguments": {
+      "type": "object", "additionalProperties": false, "required": ["scope", "focus", "trigger", "mode", "ownerActorId"],
+      "properties": {
+        "scope": {
+          "type": "object", "additionalProperties": false, "required": ["scopeId", "domainId", "domainVersion"],
+          "properties": {
+            "scopeId": { "$ref": "#/$defs/nonPlaceholder" },
+            "domainId": { "$ref": "#/$defs/nonPlaceholder" },
+            "domainVersion": { "allOf": [{ "$ref": "#/$defs/nonPlaceholder" }, { "maxLength": 64 }] }
+          }
+        },
+        "focus": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/nonPlaceholder" } },
+        "trigger": { "type": "object", "additionalProperties": false, "required": ["kind"], "properties": { "kind": { "const": "manual" } } },
+        "mode": { "type": "string", "enum": ["standard", "preview"] },
+        "ownerActorId": { "$ref": "#/$defs/nonPlaceholder" },
+        "deliveryRoute": { "type": "string", "enum": ["contained-execution", "planning-work", "human-external", "observe-only"] }
+      }
+    },
+    "cycleIdentityArguments": { "type": "object", "additionalProperties": false, "required": ["cycleId"], "properties": { "cycleId": { "$ref": "#/$defs/nonPlaceholder" } } },
+    "assignmentClaimArguments": {
+      "type": "object", "additionalProperties": false, "required": ["assignmentId", "actor"],
+      "properties": {
+        "assignmentId": { "type": "string", "pattern": "^asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "actor": { "$ref": "#/$defs/publicActor" }
+      }
+    },
+    "assignmentSubmitArguments": {
+      "type": "object", "additionalProperties": false, "required": ["assignmentId", "submissionId", "actor", "mediaType", "encoding", "contentBase64"],
+      "properties": {
+        "assignmentId": { "type": "string", "pattern": "^asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "submissionId": { "type": "string", "pattern": "^sub_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "actor": { "$ref": "#/$defs/publicActor" },
+        "mediaType": { "$ref": "#/$defs/nonPlaceholder" },
+        "encoding": { "type": "string", "enum": ["utf-8", "binary"] },
+        "contentBase64": { "type": "string", "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$" }
+      }
+    },
+    "artifactGetArguments": {
+      "type": "object", "additionalProperties": false, "required": ["artifactId", "representation", "actor", "scope", "assignmentId"],
+      "properties": {
+        "artifactId": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "representation": { "type": "string", "enum": ["raw", "canonical", "metadata", "decoded-json"] },
+        "actor": { "$ref": "#/$defs/publicActor" },
+        "scope": { "$ref": "#/$defs/scope" },
+        "assignmentId": { "type": ["string", "null"], "pattern": "^asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }
+      },
+      "allOf": [{
+        "if": { "properties": { "actor": { "properties": { "kind": { "const": "agent" } }, "required": ["kind"] } }, "required": ["actor"] },
+        "then": { "properties": { "assignmentId": { "type": "string" } } }
+      }]
+    },
+    "reviewIdentityArguments": {
+      "type": "object", "additionalProperties": false, "required": ["reviewId", "cycleId", "actor", "scope"],
+      "properties": {
+        "reviewId": { "type": "string", "pattern": "^rev_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "cycleId": { "type": "string", "pattern": "^cyc_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "actor": { "$ref": "#/$defs/humanActor" },
+        "scope": { "$ref": "#/$defs/scope" }
+      }
+    },
+    "reviewSubmitArguments": {
+      "type": "object", "additionalProperties": false, "required": ["reviewId", "cycleId", "actor", "scope", "disposition", "workDispositions"],
+      "properties": {
+        "reviewId": { "type": "string", "pattern": "^rev_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "cycleId": { "type": "string", "pattern": "^cyc_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+        "actor": { "$ref": "#/$defs/humanActor" },
+        "scope": { "$ref": "#/$defs/scope" },
+        "disposition": { "type": "string", "enum": ["approved", "changes_requested", "rejected", "cancelled"] },
+        "workDispositions": { "type": "array", "maxItems": 1024, "uniqueItems": true, "items": { "$ref": "operating-review.schema.json#/$defs/workDisposition" } }
+      }
+    },
+    "actionApproveArguments": { "$ref": "operate-allowed-action.schema.json#/$defs/actionApproveArguments" },
+    "actionExecuteArguments": { "$ref": "operate-allowed-action.schema.json#/$defs/actionExecuteArguments" },
+    "actionRollbackArguments": { "$ref": "operate-allowed-action.schema.json#/$defs/actionRollbackArguments" },
+    "publicActor": {
+      "type": "object", "additionalProperties": false, "required": ["actorId", "kind", "runtime"],
+      "properties": {
+        "actorId": { "$ref": "#/$defs/nonPlaceholder" },
+        "kind": { "type": "string", "enum": ["agent", "human"] },
+        "runtime": { "$ref": "#/$defs/nonPlaceholder" }
+      }
+    },
+    "humanActor": {
+      "type": "object", "additionalProperties": false, "required": ["actorId", "kind", "runtime"],
+      "properties": {
+        "actorId": { "$ref": "#/$defs/nonPlaceholder" },
+        "kind": { "const": "human" },
+        "runtime": { "$ref": "#/$defs/nonPlaceholder" }
+      }
+    },
+    "scope": {
+      "type": "object", "additionalProperties": false, "required": ["scopeId", "domainId", "domainVersion"],
+      "properties": {
+        "scopeId": { "$ref": "#/$defs/nonPlaceholder" },
+        "domainId": { "$ref": "#/$defs/nonPlaceholder" },
+        "domainVersion": { "allOf": [{ "$ref": "#/$defs/nonPlaceholder" }, { "maxLength": 64 }] }
+      }
+    },
+    "nonPlaceholder": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "not": { "pattern": "(?:<[^>]+>|\\{\\{[^}]+\\}\\})" }
+    }
+  }
+}

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

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operate-verification-provider-registration.schema.json",
+  "x-openplanr-contract": { "id": "operate-verification-provider-registration", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 verification provider declaration",
+  "description": "A data-only, non-authorizing descriptor for a public built-in that returns an accepted-input verification candidate. It cannot execute an Action.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "providerId", "providerVersion", "supportedDomains", "inputContract", "outputContract", "accessMode", "returnSemantics", "errorCodes", "provenance", "conformanceDigest", "implementation", "fallback"],
+  "properties": { "kind": { "const": "operate-verification-provider-registration" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" }, "providerId": { "$ref": "#/$defs/id" }, "providerVersion": { "$ref": "#/$defs/version" }, "supportedDomains": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/domain" } }, "inputContract": { "$ref": "#/$defs/inputContract" }, "outputContract": { "$ref": "#/$defs/outputContract" }, "accessMode": { "enum": ["accepted-input-only", "declared-read-only"] }, "returnSemantics": { "const": "candidate" }, "errorCodes": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "enum": ["OPERATING_PROVIDER_INPUT_INVALID", "OPERATING_PROVIDER_UNAVAILABLE"] } }, "provenance": { "$ref": "#/$defs/provenance" }, "conformanceDigest": { "$ref": "#/$defs/hash" }, "implementation": { "$ref": "#/$defs/builtIn" }, "fallback": { "$ref": "#/$defs/fallback" } },
+  "$defs": { "builtIn": { "type": "object", "additionalProperties": false, "required": ["kind", "id"], "properties": { "kind": { "const": "built-in" }, "id": { "$ref": "#/$defs/id" } } }, "domain": { "type": "object", "additionalProperties": false, "required": ["apiDomainId", "domainContractId", "domainContractVersion"], "properties": { "apiDomainId": { "$ref": "#/$defs/id" }, "domainContractId": { "$ref": "#/$defs/id" }, "domainContractVersion": { "$ref": "#/$defs/version" } } }, "fallback": { "type": "object", "additionalProperties": false, "required": ["kind", "errorCode"], "properties": { "kind": { "const": "unavailable" }, "errorCode": { "const": "OPERATING_PROVIDER_UNAVAILABLE" } } }, "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "id": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" }, "inputContract": { "type": "object", "additionalProperties": false, "required": ["schemaId", "schemaVersion"], "properties": { "schemaId": { "enum": ["operating-artifact", "operating-action-verification-plan", "operating-metric-observation"] }, "schemaVersion": { "const": "2.0.0" } } }, "outputContract": { "type": "object", "additionalProperties": false, "required": ["schemaId", "schemaVersion"], "properties": { "schemaId": { "enum": ["operating-outcome", "operating-learning"] }, "schemaVersion": { "const": "2.0.0" } } }, "provenance": { "type": "object", "additionalProperties": false, "required": ["packageName", "packageVersion", "integrity"], "properties": { "packageName": { "$ref": "#/$defs/id" }, "packageVersion": { "$ref": "#/$defs/version" }, "integrity": { "$ref": "#/$defs/hash" } } }, "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-action-policy.schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-action-policy.schema.json",
+  "x-openplanr-contract": { "id": "operating-action-policy", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 action policy",
+  "type": "object", "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "policyId", "policyVersion", "domainId", "actionKind", "capability", "effectClasses", "targetKinds", "decisionMode", "approvalRequirementIds", "rollbackRequired", "verificationRequired", "tier", "precedence", "narrowingOnly", "provenance", "policyHash"],
+  "properties": {
+    "kind": { "const": "operating-action-policy" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" },
+    "policyId": { "$ref": "#/$defs/id" }, "policyVersion": { "$ref": "#/$defs/version" }, "domainId": { "$ref": "#/$defs/id" }, "actionKind": { "$ref": "#/$defs/versionedId" }, "capability": { "$ref": "#/$defs/versionedId" },
+    "effectClasses": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/effect" } },
+    "targetKinds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
+    "decisionMode": { "enum": ["automatic", "named-single-party", "named-multi-party", "threshold", "deferred", "rejected", "prohibited"] },
+    "approvalRequirementIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/approvalRequirementId" } },
+    "rollbackRequired": { "type": "boolean" }, "verificationRequired": { "type": "boolean" },
+    "tier": { "enum": ["core", "project", "domain"] }, "precedence": { "enum": [100, 200, 300] }, "narrowingOnly": { "type": "boolean" },
+    "provenance": { "$ref": "#/$defs/provenance" }, "policyHash": { "$ref": "#/$defs/hash" }
+  },
+  "allOf": [
+    { "if": { "properties": { "tier": { "const": "core" } } }, "then": { "properties": { "precedence": { "const": 300 }, "narrowingOnly": { "const": false } } } },
+    { "if": { "properties": { "tier": { "const": "project" } } }, "then": { "properties": { "precedence": { "const": 200 }, "narrowingOnly": { "const": true } } } },
+    { "if": { "properties": { "tier": { "const": "domain" } } }, "then": { "properties": { "precedence": { "const": 100 }, "narrowingOnly": { "const": true } } } }
+  ],
+  "$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]*)$" },
+    "versionedId": { "type": "object", "additionalProperties": false, "required": ["id", "version"], "properties": { "id": { "$ref": "#/$defs/id" }, "version": { "$ref": "#/$defs/version" } } },
+    "effect": { "enum": ["read-only", "machine-local-write", "project-write", "provider-call", "external-effect", "destructive"] },
+    "approvalRequirementId": { "type": "string", "pattern": "^aprq_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "provenance": { "type": "object", "additionalProperties": false, "required": ["providerId", "providerVersion", "sourceHash"], "properties": { "providerId": { "$ref": "#/$defs/id" }, "providerVersion": { "$ref": "#/$defs/version" }, "sourceHash": { "$ref": "#/$defs/hash" } } }
+  }
+}

package/schemas/v2.0.0/operating-action-verification-plan.schema.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-action-verification-plan.schema.json",
+  "x-openplanr-contract": { "id": "operating-action-verification-plan", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 bounded action verification plan",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "verificationPlanId", "actionId", "scopeId", "domainId", "domainVersion", "metricId", "baseline", "target", "window", "method", "observationRequest", "evaluationRules", "revisitDecisionIds", "sourceArtifactId", "createdAt"],
+  "properties": {
+    "kind": { "const": "operating-action-verification-plan" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" }, "verificationPlanId": { "$ref": "#/$defs/planId" }, "actionId": { "$ref": "#/$defs/actionId" }, "scopeId": { "$ref": "#/$defs/id" }, "domainId": { "$ref": "#/$defs/id" }, "domainVersion": { "$ref": "#/$defs/version" }, "metricId": { "type": "string", "pattern": "^met_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "baseline": { "type": "number" }, "target": { "type": "number" }, "window": { "$ref": "#/$defs/text" }, "method": { "$ref": "#/$defs/text" }, "observationRequest": { "$ref": "#/$defs/observationRequest" }, "evaluationRules": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/text" } }, "revisitDecisionIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/decisionId" } }, "sourceArtifactId": { "$ref": "#/$defs/artifactId" }, "createdAt": { "type": "string", "format": "date-time" }
+  },
+  "$defs": { "actionId": { "type": "string", "pattern": "^act_[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}$" }, "decisionId": { "type": "string", "pattern": "^dec_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "id": { "type": "string", "minLength": 1, "maxLength": 128 }, "observationRequest": { "type": "object", "additionalProperties": false, "required": ["kind", "reason"], "properties": { "kind": { "enum": ["future-observation", "future-analysis"] }, "reason": { "$ref": "#/$defs/text" } } }, "planId": { "type": "string", "pattern": "^vfy_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "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-action.schema.json

@@ -0,0 +1,86 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-action.schema.json",
+  "x-openplanr-contract": { "id": "operating-action", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 persistent operating action",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "actionId", "scopeId", "domainId", "domainVersion", "sourceCycleId", "sourceArtifactId", "title", "state", "ownerActorId", "accountabilityDisposition", "sourceDecisionId", "sourceFindingIds", "dependsOnActionIds", "objectiveId", "expectedResult", "metricId", "baseline", "target", "verificationWindow", "verificationPlanId", "createdAt", "updatedAt"],
+  "properties": {
+    "kind": { "const": "operating-action" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "actionId": { "type": "string", "pattern": "^act_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "revisionId": { "type": "string", "pattern": "^actrev_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "revision": { "type": "integer", "minimum": 1 },
+    "predecessorRevisionId": { "type": ["string", "null"], "pattern": "^actrev_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "actionHash": { "$ref": "#/$defs/hash" },
+    "scopeId": { "$ref": "#/$defs/nonPlaceholder" },
+    "domainId": { "$ref": "#/$defs/nonPlaceholder" },
+    "domainVersion": { "allOf": [{ "$ref": "#/$defs/nonPlaceholder" }, { "maxLength": 64 }] },
+    "sourceCycleId": { "$ref": "#/$defs/cycleId" },
+    "sourceArtifactId": { "$ref": "#/$defs/artifactId" },
+    "title": { "$ref": "#/$defs/title" },
+    "state": { "type": "string", "enum": ["proposed", "approved", "queued", "in_progress", "completed", "blocked", "rejected", "deferred", "cancelled"] },
+    "actionKind": { "$ref": "#/$defs/versionedId" },
+    "requestedCapability": { "$ref": "#/$defs/versionedId" },
+    "targetBinding": { "$ref": "#/$defs/targetBinding" },
+    "effectClass": { "$ref": "#/$defs/effectClass" },
+    "preconditionArtifactIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/artifactId" } },
+    "executionBinding": { "$ref": "#/$defs/executionBinding" },
+    "ownerActorId": { "type": ["string", "null"], "minLength": 1, "maxLength": 128 },
+    "accountabilityDisposition": { "type": ["string", "null"], "enum": [null, "unowned", "blocked"] },
+    "sourceDecisionId": { "type": ["string", "null"], "pattern": "^dec_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "sourceFindingIds": { "type": "array", "uniqueItems": true, "items": { "type": "string", "pattern": "^fnd_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" } },
+    "dependsOnActionIds": { "type": "array", "uniqueItems": true, "items": { "type": "string", "pattern": "^act_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" } },
+    "objectiveId": { "$ref": "#/$defs/objectiveId" },
+    "expectedResult": { "$ref": "#/$defs/nonBlankText" },
+    "metricId": { "$ref": "#/$defs/metricId" },
+    "baseline": { "type": "number" },
+    "target": { "type": "number" },
+    "verificationWindow": { "$ref": "#/$defs/nonBlankText" },
+    "verificationPlanId": { "$ref": "#/$defs/verificationPlanId" },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "updatedAt": { "type": "string", "format": "date-time" }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "ownerActorId": { "type": "null" } } },
+      "then": { "properties": { "accountabilityDisposition": { "type": "string", "enum": ["unowned", "blocked"] } } }
+    },
+    {
+      "if": { "properties": { "ownerActorId": { "type": "string" } } },
+      "then": { "properties": { "accountabilityDisposition": { "const": null } } }
+    },
+    {
+      "if": { "required": ["revisionId"] }, "then": { "$ref": "#/$defs/completeGovernedTuple" }
+    },
+    { "if": { "required": ["revision"] }, "then": { "$ref": "#/$defs/completeGovernedTuple" } },
+    { "if": { "required": ["predecessorRevisionId"] }, "then": { "$ref": "#/$defs/completeGovernedTuple" } },
+    { "if": { "required": ["actionHash"] }, "then": { "$ref": "#/$defs/completeGovernedTuple" } },
+    { "if": { "required": ["actionKind"] }, "then": { "$ref": "#/$defs/completeGovernedTuple" } },
+    { "if": { "required": ["requestedCapability"] }, "then": { "$ref": "#/$defs/completeGovernedTuple" } },
+    { "if": { "required": ["targetBinding"] }, "then": { "$ref": "#/$defs/completeGovernedTuple" } },
+    { "if": { "required": ["effectClass"] }, "then": { "$ref": "#/$defs/completeGovernedTuple" } },
+    { "if": { "required": ["preconditionArtifactIds"] }, "then": { "$ref": "#/$defs/completeGovernedTuple" } },
+    { "if": { "required": ["executionBinding"] }, "then": { "$ref": "#/$defs/completeGovernedTuple" } }
+  ],
+  "$defs": {
+    "completeGovernedTuple": { "required": ["revisionId", "revision", "predecessorRevisionId", "actionHash", "actionKind", "requestedCapability", "targetBinding", "effectClass", "preconditionArtifactIds", "executionBinding"] },
+    "artifactId": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "cycleId": { "type": "string", "pattern": "^cyc_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "metricId": { "type": "string", "pattern": "^met_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "nonPlaceholder": { "type": "string", "minLength": 1, "maxLength": 128, "not": { "pattern": "(?:<[^>]+>|\\{\\{[^}]+\\}\\})" } },
+    "nonBlankText": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[\\s\\S]*\\S[\\s\\S]*$" },
+    "objectiveId": { "type": "string", "pattern": "^obj_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "title": { "type": "string", "minLength": 1, "maxLength": 256, "pattern": "^\\S(?:[\\s\\S]*\\S)?$", "not": { "pattern": "(?:<[^>]+>|\\{\\{[^}]+\\}\\})" } },
+    "verificationPlanId": { "type": "string", "pattern": "^vfy_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }
+    ,"hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "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]*)$" },
+    "versionedId": { "type": "object", "additionalProperties": false, "required": ["id", "version"], "properties": { "id": { "$ref": "#/$defs/identifier" }, "version": { "$ref": "#/$defs/version" } } },
+    "effectClass": { "enum": ["read-only", "machine-local-write", "project-write", "provider-call", "external-effect", "destructive"] },
+    "targetBinding": { "type": "object", "additionalProperties": false, "required": ["kind", "id", "revision"], "properties": { "kind": { "$ref": "#/$defs/identifier" }, "id": { "type": "string", "minLength": 1, "maxLength": 128 }, "revision": { "type": "string", "minLength": 1, "maxLength": 128 } } },
+    "executionBinding": { "type": "object", "additionalProperties": false, "required": ["policyId", "policyVersion", "rollbackRequired", "verificationRequired"], "properties": { "policyId": { "$ref": "#/$defs/identifier" }, "policyVersion": { "$ref": "#/$defs/version" }, "rollbackRequired": { "type": "boolean" }, "verificationRequired": { "const": true } } }
+  }
+}