@openplanr/protocol 0.2.0

package/schemas/v2.0.0/operating-live-evidence-ingestion.schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://openplanr.dev/schemas/v2.0.0/operating-live-evidence-ingestion.schema.json", "x-openplanr-contract": { "id": "operating-live-evidence-ingestion", "version": "2.0.0" }, "title": "Operating Live Evidence Ingestion",
+  "type": "object", "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "ingestionId", "requestId", "requestHash", "assignment", "submission", "provider", "providerRegistration", "providerRegistrationHash", "resolverRegistration", "resolverRegistrationHash", "adapterVersion", "status", "consentRecordHash", "runtimeCapabilityHash", "checkpoint", "health", "boundsHash", "classification", "sourceContract", "sourceTiming", "records", "absences", "evidenceCandidates", "evidenceClaimLinks", "materialization", "ingestionHash"],
+  "properties": {
+    "kind": { "const": "operating-live-evidence-ingestion" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" },
+    "ingestionId": { "type": "string", "pattern": "^ling_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "requestId": { "type": "string", "pattern": "^lreq_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "requestHash": { "$ref": "#/$defs/hash" },
+    "assignment": { "type": "object", "additionalProperties": false, "required": ["assignmentId", "assignmentRevision", "assignmentHash", "requestHash", "assignmentKind", "outputContract"], "properties": { "assignmentId": { "type": "string", "pattern": "^asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "assignmentRevision": { "type": "integer", "minimum": 1 }, "assignmentHash": { "$ref": "#/$defs/hash" }, "requestHash": { "$ref": "#/$defs/hash" }, "assignmentKind": { "const": "verification" }, "outputContract": { "type": "object", "additionalProperties": false, "required": ["schemaId", "schemaVersion"], "properties": { "schemaId": { "const": "operating-live-evidence-ingestion" }, "schemaVersion": { "const": "2.0.0" } } } } },
+    "submission": { "type": "object", "additionalProperties": false, "required": ["operation", "submissionId", "submittedEventId", "artifactCreatedEventId", "validatedEventId", "artifactId", "evidenceRefId"], "properties": { "operation": { "const": "operate.assignment.submit" }, "submissionId": { "type": "string", "pattern": "^sub_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "submittedEventId": { "type": "string", "pattern": "^evt_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "artifactCreatedEventId": { "type": "string", "pattern": "^evt_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "validatedEventId": { "type": "string", "pattern": "^evt_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "artifactId": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "evidenceRefId": { "type": "string", "pattern": "^evr_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" } } },
+    "provider": { "$ref": "#/$defs/versionedId" }, "providerRegistration": { "$ref": "#/$defs/evidenceProviderRef" }, "providerRegistrationHash": { "$ref": "#/$defs/hash" }, "resolverRegistration": { "$ref": "#/$defs/resolverRef" }, "resolverRegistrationHash": { "$ref": "#/$defs/hash" }, "adapterVersion": { "$ref": "#/$defs/version" }, "status": { "enum": ["materialized", "absent", "uncertain"] }, "consentRecordHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }, "runtimeCapabilityHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" },
+    "checkpoint": { "type": "object", "additionalProperties": false, "required": ["checkpointId", "predecessorDigest", "checkpointHash"], "properties": { "checkpointId": { "type": "string", "pattern": "^lchk_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "predecessorDigest": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }, "checkpointHash": { "$ref": "#/$defs/hash" } } },
+    "health": { "$ref": "#/$defs/health" },
+    "boundsHash": { "$ref": "#/$defs/hash" }, "classification": { "$ref": "#/$defs/classification" }, "sourceContract": { "type": "object", "additionalProperties": false, "required": ["id", "version"], "properties": { "id": { "$ref": "#/$defs/id" }, "version": { "const": "1.0.0" } } },
+    "sourceTiming": { "type": "object", "additionalProperties": false, "required": ["requestedAt", "capturedAt", "freshUntil"], "properties": { "requestedAt": { "type": "string", "format": "date-time" }, "capturedAt": { "type": "string", "format": "date-time" }, "freshUntil": { "type": "string", "format": "date-time" } } },
+    "records": { "type": "array", "maxItems": 10000, "items": { "type": "object", "additionalProperties": false, "required": ["recordIdentityHash", "contentDigest", "classification"], "properties": { "recordIdentityHash": { "$ref": "#/$defs/hash" }, "contentDigest": { "$ref": "#/$defs/hash" }, "classification": { "$ref": "#/$defs/classification" } } } },
+    "absences": { "type": "array", "maxItems": 32, "items": { "$ref": "#/$defs/absence" } },
+    "evidenceCandidates": { "type": "array", "minItems": 1, "maxItems": 128, "items": { "$ref": "operating-evidence-candidate.schema.json" } },
+    "evidenceClaimLinks": { "type": "array", "maxItems": 256, "items": { "type": "object", "additionalProperties": false, "required": ["candidateId", "sourceArtifactId", "localClaimId", "relation", "confidence"], "properties": { "candidateId": { "type": "string", "pattern": "^evc_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "sourceArtifactId": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "localClaimId": { "type": "string", "minLength": 1, "maxLength": 128 }, "relation": { "enum": ["supportedBy", "contradictedBy"] }, "confidence": { "type": "number", "minimum": 0, "maximum": 1 } } } },
+    "materialization": { "oneOf": [{ "type": "null" }, { "type": "object", "additionalProperties": false, "required": ["artifactId", "artifactCreatedEventId", "evidenceRefId", "contentDigest", "redactionVersion"], "properties": { "artifactId": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "artifactCreatedEventId": { "type": "string", "pattern": "^evt_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "evidenceRefId": { "type": "string", "pattern": "^evr_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "contentDigest": { "$ref": "#/$defs/hash" }, "redactionVersion": { "$ref": "#/$defs/version" } } }] },
+    "ingestionHash": { "$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}$" }, "classification": { "enum": ["public", "internal", "confidential", "restricted"] },
+    "versionedId": { "type": "object", "additionalProperties": false, "required": ["id", "version"], "properties": { "id": { "$ref": "#/$defs/id" }, "version": { "$ref": "#/$defs/version" } } },
+    "absence": { "type": "object", "additionalProperties": false, "required": ["kind", "reasonCode", "required", "observedAt", "detailsHash"], "properties": { "kind": { "enum": ["missing-consent", "missing-credential", "stale", "unhealthy", "provider-unavailable", "rate-limited", "insufficient-evidence", "unsupported"] }, "reasonCode": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]*$" }, "required": { "type": "boolean" }, "observedAt": { "type": "string", "format": "date-time" }, "detailsHash": { "$ref": "#/$defs/hash" } } },
+    "health": { "type": "object", "additionalProperties": false, "required": ["status", "checkedAt", "freshUntil", "proofDigest"], "properties": { "status": { "enum": ["available", "degraded", "unavailable"] }, "checkedAt": { "type": "string", "format": "date-time" }, "freshUntil": { "type": "string", "format": "date-time" }, "proofDigest": { "$ref": "#/$defs/hash" } } },
+    "evidenceProviderRef": { "type": "object", "additionalProperties": false, "required": ["contractId", "schemaVersion", "protocolVersion", "providerId", "providerVersion", "recordDigest"], "properties": { "contractId": { "const": "operate-evidence-provider-registration" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" }, "providerId": { "$ref": "#/$defs/id" }, "providerVersion": { "$ref": "#/$defs/version" }, "recordDigest": { "$ref": "#/$defs/hash" } } },
+    "resolverRef": { "type": "object", "additionalProperties": false, "required": ["contractId", "schemaVersion", "protocolVersion", "resolverId", "resolverVersion", "recordDigest"], "properties": { "contractId": { "const": "operate-evidence-resolver-registration" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" }, "resolverId": { "$ref": "#/$defs/id" }, "resolverVersion": { "$ref": "#/$defs/version" }, "recordDigest": { "$ref": "#/$defs/hash" } } }
+  },
+  "allOf": [{ "if": { "properties": { "status": { "const": "materialized" } }, "required": ["status"] }, "then": { "properties": { "health": { "properties": { "status": { "const": "available" } } }, "consentRecordHash": { "type": "string" }, "runtimeCapabilityHash": { "type": "string" }, "absences": { "maxItems": 0 }, "materialization": { "type": "object" } } } }]
+}

package/schemas/v2.0.0/operating-measurement-plan.schema.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://openplanr.dev/schemas/v2.0.0/operating-measurement-plan.schema.json", "x-openplanr-contract": { "id": "operating-measurement-plan", "version": "2.0.0" }, "title": "Operating Measurement Plan",
+  "type": "object", "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "measurementPlanId", "action", "metric", "baseline", "target", "sources", "window", "dueAt", "freshnessSeconds", "sensitivity", "minimumEvidence", "terminalResults", "verificationPlan", "planHash"],
+  "properties": {
+    "kind": { "const": "operating-measurement-plan" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" }, "measurementPlanId": { "type": "string", "pattern": "^mpln_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "action": { "type": "object", "additionalProperties": false, "required": ["actionId", "revision", "actionHash"], "properties": { "actionId": { "type": "string", "pattern": "^act_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "revision": { "type": "integer", "minimum": 1 }, "actionHash": { "$ref": "#/$defs/hash" } } },
+    "metric": { "type": "object", "additionalProperties": false, "required": ["metricId", "metricHash", "unit", "dimension"], "properties": { "metricId": { "type": "string", "pattern": "^met_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "metricHash": { "$ref": "#/$defs/hash" }, "unit": { "$ref": "#/$defs/id" }, "dimension": { "$ref": "#/$defs/id" } } },
+    "baseline": { "$ref": "#/$defs/value" },
+    "target": { "type": "object", "additionalProperties": false, "required": ["operator", "value", "unit", "direction"], "properties": { "operator": { "enum": ["gt", "gte", "lt", "lte", "eq", "between"] }, "value": { "oneOf": [{ "type": "number" }, { "type": "array", "minItems": 2, "maxItems": 2, "items": { "type": "number" } }] }, "unit": { "$ref": "#/$defs/id" }, "direction": { "enum": ["increase", "decrease", "maintain", "range"] } } },
+    "sources": { "type": "array", "minItems": 1, "maxItems": 16, "items": { "type": "object", "additionalProperties": false, "required": ["provider", "queryHash", "consentRecordHash"], "properties": { "provider": { "$ref": "#/$defs/versionedId" }, "queryHash": { "$ref": "#/$defs/hash" }, "consentRecordHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" } } } },
+    "window": { "type": "object", "additionalProperties": false, "required": ["from", "to", "inclusive"], "properties": { "from": { "type": "string", "format": "date-time" }, "to": { "type": "string", "format": "date-time" }, "inclusive": { "const": true } } },
+    "dueAt": { "type": "string", "format": "date-time" }, "freshnessSeconds": { "type": "integer", "minimum": 1, "maximum": 31536000 }, "sensitivity": { "enum": ["public", "internal", "confidential", "restricted"] }, "minimumEvidence": { "type": "integer", "minimum": 1, "maximum": 1000 },
+    "terminalResults": { "type": "array", "minItems": 3, "maxItems": 3, "uniqueItems": true, "items": { "enum": ["passed", "failed", "insufficient-evidence"] } },
+    "verificationPlan": { "type": "object", "additionalProperties": false, "required": ["contractId", "schemaVersion", "protocolVersion", "verificationPlanId", "recordDigest", "canonicalTarget", "windowDigest", "methodDigest", "evaluationRulesDigest"], "properties": { "contractId": { "const": "operating-action-verification-plan" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" }, "verificationPlanId": { "type": "string", "pattern": "^vfy_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "recordDigest": { "$ref": "#/$defs/hash" }, "canonicalTarget": { "type": "number" }, "windowDigest": { "$ref": "#/$defs/hash" }, "methodDigest": { "$ref": "#/$defs/hash" }, "evaluationRulesDigest": { "$ref": "#/$defs/hash" } } }, "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}$" }, "versionedId": { "type": "object", "additionalProperties": false, "required": ["id", "version"], "properties": { "id": { "$ref": "#/$defs/id" }, "version": { "$ref": "#/$defs/version" } } }, "value": { "type": "object", "additionalProperties": false, "required": ["value", "unit", "observedAt", "evidenceHashes"], "properties": { "value": { "type": "number" }, "unit": { "$ref": "#/$defs/id" }, "observedAt": { "type": "string", "format": "date-time" }, "evidenceHashes": { "type": "array", "minItems": 1, "maxItems": 1000, "uniqueItems": true, "items": { "$ref": "#/$defs/hash" } } } } }
+}

package/schemas/v2.0.0/operating-measurement-schedule-receipt.schema.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://openplanr.dev/schemas/v2.0.0/operating-measurement-schedule-receipt.schema.json", "x-openplanr-contract": { "id": "operating-measurement-schedule-receipt", "version": "2.0.0" }, "title": "Operating Measurement Schedule Receipt",
+  "type": "object", "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "receiptId", "authority", "scheduleId", "scheduleHash", "previousScheduleHash", "resultingScheduleHash", "measurementPlanId", "planHash", "consentRecordHashes", "ceilingsHash", "clockHash", "recurrenceHash", "startsAt", "endsAt", "maxRuns", "misfirePolicy", "dstPolicy", "transition", "fromState", "toState", "previousRunCount", "resultingRunCount", "previousNextEventIdentity", "resultingNextEventIdentity", "previousNextDueAt", "resultingNextDueAt", "ownerActorId", "eventId", "nextEventIdentity", "at", "receiptHash"],
+  "properties": { "kind": { "const": "operating-measurement-schedule-receipt" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" }, "receiptId": { "type": "string", "pattern": "^msrc_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "authority": { "const": "none" }, "scheduleId": { "type": "string", "pattern": "^msch_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "scheduleHash": { "$ref": "#/$defs/hash" }, "previousScheduleHash": { "$ref": "#/$defs/hash" }, "resultingScheduleHash": { "$ref": "#/$defs/hash" }, "measurementPlanId": { "type": "string", "pattern": "^mpln_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "planHash": { "$ref": "#/$defs/hash" }, "consentRecordHashes": { "type": "array", "maxItems": 16, "uniqueItems": true, "items": { "$ref": "#/$defs/hash" } }, "ceilingsHash": { "$ref": "#/$defs/hash" }, "clockHash": { "$ref": "#/$defs/hash" }, "recurrenceHash": { "$ref": "#/$defs/hash" }, "startsAt": { "type": "string", "format": "date-time" }, "endsAt": { "type": ["string", "null"], "format": "date-time" }, "maxRuns": { "type": "integer", "minimum": 1, "maximum": 10000 }, "misfirePolicy": { "enum": ["skip", "run-once"] }, "dstPolicy": { "enum": ["wall-clock", "elapsed-time"] }, "transition": { "enum": ["enable", "disable", "pause", "resume", "revoke", "expire", "complete", "run-issued"] }, "fromState": { "$ref": "#/$defs/state" }, "toState": { "$ref": "#/$defs/state" }, "previousRunCount": { "type": "integer", "minimum": 0 }, "resultingRunCount": { "type": "integer", "minimum": 0 }, "previousNextEventIdentity": { "type": ["string", "null"], "pattern": "^mevt_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "resultingNextEventIdentity": { "type": ["string", "null"], "pattern": "^mevt_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "previousNextDueAt": { "type": ["string", "null"], "format": "date-time" }, "resultingNextDueAt": { "type": ["string", "null"], "format": "date-time" }, "ownerActorId": { "type": "string", "minLength": 1, "maxLength": 128 }, "eventId": { "type": "string", "pattern": "^mevt_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "nextEventIdentity": { "type": ["string", "null"], "pattern": "^mevt_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "at": { "type": "string", "format": "date-time" }, "receiptHash": { "$ref": "#/$defs/hash" } },
+  "$defs": { "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "state": { "enum": ["disabled", "enabled", "paused", "revoked", "expired", "completed"] } }
+}

package/schemas/v2.0.0/operating-measurement-schedule.schema.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://openplanr.dev/schemas/v2.0.0/operating-measurement-schedule.schema.json", "x-openplanr-contract": { "id": "operating-measurement-schedule", "version": "2.0.0" }, "title": "Operating Measurement Schedule",
+  "type": "object", "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "scheduleId", "generation", "measurementPlanId", "planHash", "ownerActorId", "consentRecordHashes", "ceilingsHash", "recurrence", "startsAt", "endsAt", "maxRuns", "misfirePolicy", "dstPolicy", "state", "runCount", "nextEventIdentity", "nextDueAt", "lastReceiptId", "lastTransitionHash", "scheduleHash"],
+  "properties": {
+    "kind": { "const": "operating-measurement-schedule" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" }, "scheduleId": { "type": "string", "pattern": "^msch_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "generation": { "type": "integer", "minimum": 0 }, "measurementPlanId": { "type": "string", "pattern": "^mpln_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "planHash": { "$ref": "#/$defs/hash" }, "ownerActorId": { "$ref": "#/$defs/textId" },
+    "consentRecordHashes": { "type": "array", "maxItems": 16, "uniqueItems": true, "items": { "$ref": "#/$defs/hash" } }, "ceilingsHash": { "$ref": "#/$defs/hash" },
+    "recurrence": { "type": "object", "additionalProperties": false, "required": ["kind", "intervalSeconds", "timeZone"], "properties": { "kind": { "enum": ["once", "interval"] }, "intervalSeconds": { "type": ["integer", "null"], "minimum": 60, "maximum": 31536000 }, "timeZone": { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[A-Za-z_]+(?:/[A-Za-z0-9_+-]+)*$" } } },
+    "startsAt": { "type": "string", "format": "date-time" }, "endsAt": { "type": ["string", "null"], "format": "date-time" }, "maxRuns": { "type": "integer", "minimum": 1, "maximum": 10000 }, "misfirePolicy": { "enum": ["skip", "run-once"] }, "dstPolicy": { "enum": ["wall-clock", "elapsed-time"] }, "state": { "enum": ["disabled", "enabled", "paused", "revoked", "expired", "completed"] }, "runCount": { "type": "integer", "minimum": 0, "maximum": 10000 }, "nextEventIdentity": { "type": ["string", "null"], "pattern": "^mevt_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "nextDueAt": { "type": ["string", "null"], "format": "date-time" }, "lastReceiptId": { "type": ["string", "null"], "pattern": "^msrc_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "lastTransitionHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }, "scheduleHash": { "$ref": "#/$defs/hash" }
+  },
+  "allOf": [
+    { "if": { "properties": { "state": { "const": "enabled" } }, "required": ["state"] }, "then": { "properties": { "consentRecordHashes": { "minItems": 1 }, "nextEventIdentity": { "type": "string" }, "nextDueAt": { "type": "string" } } } },
+    { "if": { "properties": { "state": { "enum": ["disabled", "revoked", "expired", "completed"] } }, "required": ["state"] }, "then": { "properties": { "nextEventIdentity": { "const": null }, "nextDueAt": { "const": null } } } }
+  ],
+  "$defs": { "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "textId": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$" } }
+}

package/schemas/v2.0.0/operating-metric-observation.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-metric-observation.schema.json",
+  "x-openplanr-contract": { "id": "operating-metric-observation", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 immutable metric observation",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "observationId", "metricId", "scopeId", "domainId", "domainVersion", "value", "unit", "observedAt", "snapshotId", "evidenceRefIds", "sourceArtifactId"],
+  "properties": {
+    "kind": { "const": "operating-metric-observation" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" }, "observationId": { "$ref": "#/$defs/observationId" }, "metricId": { "$ref": "#/$defs/metricId" }, "scopeId": { "$ref": "#/$defs/id" }, "domainId": { "$ref": "#/$defs/id" }, "domainVersion": { "$ref": "#/$defs/version" }, "value": { "type": "number" }, "unit": { "$ref": "#/$defs/id" }, "observedAt": { "type": "string", "format": "date-time" }, "snapshotId": { "$ref": "#/$defs/snapshotId" }, "evidenceRefIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/evidenceRefId" } }, "sourceArtifactId": { "$ref": "#/$defs/artifactId" }
+  },
+  "$defs": {
+    "artifactId": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "evidenceRefId": { "type": "string", "pattern": "^evr_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "id": { "type": "string", "minLength": 1, "maxLength": 128 }, "metricId": { "type": "string", "pattern": "^met_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "observationId": { "type": "string", "pattern": "^mob_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "snapshotId": { "type": "string", "pattern": "^snp_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "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-metric.schema.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-metric.schema.json",
+  "x-openplanr-contract": { "id": "operating-metric", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 metric definition",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "metricId", "scopeId", "domainId", "domainVersion", "title", "unit", "aggregation", "window", "target", "threshold", "observationIds", "freshness", "evidenceRefIds", "sourceArtifactId", "createdAt", "updatedAt"],
+  "properties": {
+    "kind": { "const": "operating-metric" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" },
+    "metricId": { "$ref": "#/$defs/metricId" }, "scopeId": { "$ref": "#/$defs/id" }, "domainId": { "$ref": "#/$defs/id" }, "domainVersion": { "$ref": "#/$defs/version" }, "title": { "$ref": "#/$defs/title" },
+    "unit": { "$ref": "#/$defs/id" }, "aggregation": { "enum": ["latest", "sum", "average", "minimum", "maximum", "ratio"] }, "window": { "$ref": "#/$defs/text" }, "target": { "type": ["number", "null"] }, "threshold": { "type": ["number", "null"] },
+    "observationIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/observationId" } }, "freshness": { "enum": ["current", "historical", "stale", "unknown"] }, "evidenceRefIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/evidenceRefId" } }, "sourceArtifactId": { "$ref": "#/$defs/artifactId" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }
+  },
+  "$defs": {
+    "artifactId": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "evidenceRefId": { "type": "string", "pattern": "^evr_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "id": { "type": "string", "minLength": 1, "maxLength": 128 }, "metricId": { "type": "string", "pattern": "^met_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "observationId": { "type": "string", "pattern": "^mob_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "text": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^.*\\S.*$" }, "title": { "type": "string", "minLength": 1, "maxLength": 256, "pattern": "^\\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-model-state.schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-model-state.schema.json",
+  "x-openplanr-contract": { "id": "operating-model-state", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 domain-neutral operating model state",
+  "description": "A rebuildable projection containing exactly the seven domain-neutral operating collections. Typed claims, observations, outcomes, and learnings remain separately addressable records linked by IDs.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "stateId", "scopeId", "domainId", "domainVersion", "snapshotId", "runtimeHash", "objectives", "metrics", "findings", "decisions", "actions", "risks", "assumptions", "generatedAt"],
+  "properties": {
+    "kind": { "const": "operating-model-state" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "stateId": { "$ref": "#/$defs/stateId" },
+    "scopeId": { "$ref": "#/$defs/id" },
+    "domainId": { "$ref": "#/$defs/id" },
+    "domainVersion": { "$ref": "#/$defs/version" },
+    "snapshotId": { "$ref": "#/$defs/snapshotId" },
+    "runtimeHash": { "$ref": "#/$defs/hash" },
+    "objectives": { "type": "array", "items": { "$ref": "operating-objective.schema.json" } },
+    "metrics": { "type": "array", "items": { "$ref": "operating-metric.schema.json" } },
+    "findings": { "type": "array", "items": { "$ref": "operating-finding.schema.json" } },
+    "decisions": { "type": "array", "items": { "$ref": "operating-decision.schema.json" } },
+    "actions": { "type": "array", "items": { "$ref": "operating-action.schema.json" } },
+    "risks": { "type": "array", "items": { "$ref": "operating-risk.schema.json" } },
+    "assumptions": { "type": "array", "items": { "$ref": "operating-assumption.schema.json" } },
+    "generatedAt": { "type": "string", "format": "date-time" }
+  },
+  "$defs": {
+    "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "id": { "type": "string", "minLength": 1, "maxLength": 128, "not": { "pattern": "(?:<[^>]+>|\\{\\{[^}]+\\}\\})" } },
+    "snapshotId": { "type": "string", "pattern": "^snp_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "stateId": { "type": "string", "pattern": "^oms_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "version": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)$" }
+  }
+}

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

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-objective.schema.json",
+  "x-openplanr-contract": { "id": "operating-objective", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 objective",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "objectiveId", "scopeId", "domainId", "domainVersion", "title", "status", "ownerActorId", "horizon", "successCriteria", "metricIds", "evidenceRefIds", "sourceArtifactId", "createdAt", "updatedAt"],
+  "properties": {
+    "kind": { "const": "operating-objective" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" },
+    "objectiveId": { "$ref": "#/$defs/objectiveId" }, "scopeId": { "$ref": "#/$defs/id" }, "domainId": { "$ref": "#/$defs/id" }, "domainVersion": { "$ref": "#/$defs/version" },
+    "title": { "$ref": "#/$defs/title" }, "status": { "enum": ["open", "at-risk", "achieved", "deferred", "superseded"] }, "ownerActorId": { "type": ["string", "null"], "minLength": 1, "maxLength": 128 },
+    "horizon": { "$ref": "#/$defs/text" }, "successCriteria": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/text" } }, "metricIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/metricId" } },
+    "evidenceRefIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/evidenceRefId" } }, "sourceArtifactId": { "$ref": "#/$defs/artifactId" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }
+  },
+  "$defs": {
+    "artifactId": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "evidenceRefId": { "type": "string", "pattern": "^evr_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "id": { "type": "string", "minLength": 1, "maxLength": 128 }, "metricId": { "type": "string", "pattern": "^met_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "objectiveId": { "type": "string", "pattern": "^obj_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "text": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^.*\\S.*$" }, "title": { "type": "string", "minLength": 1, "maxLength": 256, "pattern": "^\\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-origin.schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-origin.schema.json",
+  "x-openplanr-contract": { "id": "operating-origin", "version": "1.0.0" },
+  "title": "OpenPlanr Planning operating origin sidecar",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "correlationId", "proposalId", "proposalRevision", "proposalHash", "scopeId", "domainId", "domainVersion", "cycleId", "eventHead", "decision", "action", "metric", "verification", "evidence", "spec", "actor", "transaction", "createdAt", "originHash"],
+  "properties": {
+    "kind": { "const": "operating-origin" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" },
+    "correlationId": { "$ref": "#/$defs/id" }, "proposalId": { "$ref": "#/$defs/id" }, "proposalRevision": { "const": 2 }, "proposalHash": { "$ref": "#/$defs/hash" },
+    "scopeId": { "$ref": "#/$defs/id" }, "domainId": { "$ref": "#/$defs/id" }, "domainVersion": { "$ref": "#/$defs/version" }, "cycleId": { "$ref": "#/$defs/id" }, "eventHead": { "$ref": "#/$defs/eventHead" },
+    "decision": { "$ref": "#/$defs/source" }, "action": { "$ref": "#/$defs/source" }, "metric": { "$ref": "#/$defs/metric" }, "verification": { "$ref": "#/$defs/verification" },
+    "evidence": { "type": "array", "items": { "$ref": "#/$defs/evidence" } },
+    "spec": { "type": "object", "additionalProperties": false, "required": ["specId", "slug", "contentHash", "status"], "properties": { "specId": { "type": "string", "pattern": "^SPEC-[0-9]{3,}$" }, "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "contentHash": { "$ref": "#/$defs/hash" }, "status": { "const": "shaping" } } },
+    "actor": { "type": "object", "additionalProperties": false, "required": ["actorId", "kind"], "properties": { "actorId": { "$ref": "#/$defs/id" }, "kind": { "const": "human" } } },
+    "transaction": { "type": "object", "additionalProperties": false, "required": ["transactionId", "receiptHash", "planningProvenanceEventId"], "properties": { "transactionId": { "$ref": "#/$defs/id" }, "receiptHash": { "$ref": "#/$defs/hash" }, "planningProvenanceEventId": { "$ref": "#/$defs/id" } } },
+    "createdAt": { "type": "string", "format": "date-time" }, "originHash": { "$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" } } }
+    ] },
+    "source": { "type": "object", "additionalProperties": false, "required": ["id", "revision", "hash"], "properties": { "id": { "$ref": "#/$defs/id" }, "revision": { "type": "integer", "minimum": 1 }, "hash": { "$ref": "#/$defs/hash" } } },
+    "metric": { "type": "object", "additionalProperties": false, "required": ["metricId", "metricHash"], "properties": { "metricId": { "$ref": "#/$defs/id" }, "metricHash": { "$ref": "#/$defs/hash" } } },
+    "verification": { "type": "object", "additionalProperties": false, "required": ["verificationPlanId", "verificationPlanHash", "metricId", "metricHash", "window"], "properties": { "verificationPlanId": { "$ref": "#/$defs/id" }, "verificationPlanHash": { "$ref": "#/$defs/hash" }, "metricId": { "$ref": "#/$defs/id" }, "metricHash": { "$ref": "#/$defs/hash" }, "window": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^.*\\S.*$" } } },
+    "evidence": { "type": "object", "additionalProperties": false, "required": ["evidenceRefId", "artifactId", "artifactHash", "classification", "accessState"], "properties": { "evidenceRefId": { "$ref": "#/$defs/id" }, "artifactId": { "$ref": "#/$defs/id" }, "artifactHash": { "$ref": "#/$defs/hash" }, "classification": { "enum": ["public", "internal", "confidential", "restricted"] }, "accessState": { "enum": ["available", "restricted"] } } }
+  }
+}

package/schemas/v2.0.0/operating-outcome-evaluation.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-outcome-evaluation.schema.json",
+  "x-openplanr-contract": { "id": "operating-outcome-evaluation", "version": "2.0.0" },
+  "title": "Operating Outcome Evaluation",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "evaluationId", "previousEvaluationHash", "measurementPlan", "verificationPlan", "outcome", "actionId", "metricId", "observations", "providerVersions", "window", "operator", "unit", "dimension", "baseline", "target", "minimumEvidence", "exactInputDigest", "result", "confidence", "absences", "contradictions", "evaluatedAt", "revisit", "evaluationHash"],
+  "properties": {
+    "kind": { "const": "operating-outcome-evaluation" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "evaluationId": { "type": "string", "pattern": "^oevl_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "previousEvaluationHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" },
+    "measurementPlan": { "$ref": "#/$defs/recordRef" },
+    "verificationPlan": { "allOf": [{ "$ref": "#/$defs/recordRef" }, { "properties": { "contractId": { "const": "operating-action-verification-plan" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" }, "recordId": { "type": "string", "pattern": "^vfy_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" } } }] },
+    "outcome": { "allOf": [{ "$ref": "#/$defs/recordRef" }, { "properties": { "contractId": { "const": "operating-outcome" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" }, "recordId": { "type": "string", "pattern": "^out_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" } } }] },
+    "actionId": { "type": "string", "pattern": "^act_[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}$" },
+    "observations": { "type": "array", "maxItems": 1000, "items": { "type": "object", "additionalProperties": false, "required": ["evidenceObservationId", "observationId", "observationHash", "metricObservationDigest", "value", "unit", "observedAt", "freshUntil", "status"], "properties": { "evidenceObservationId": { "type": "string", "pattern": "^eobs_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "observationId": { "type": ["string", "null"], "pattern": "^mob_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "observationHash": { "$ref": "#/$defs/hash" }, "metricObservationDigest": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }, "value": { "type": ["number", "null"] }, "unit": { "$ref": "#/$defs/id" }, "observedAt": { "type": "string", "format": "date-time" }, "freshUntil": { "type": "string", "format": "date-time" }, "status": { "enum": ["observed", "absent", "contradicted"] } }, "allOf": [{ "if": { "properties": { "status": { "const": "observed" } }, "required": ["status"] }, "then": { "properties": { "observationId": { "type": "string" }, "metricObservationDigest": { "type": "string" }, "value": { "type": "number" } } } }, { "if": { "properties": { "status": { "enum": ["absent", "contradicted"] } }, "required": ["status"] }, "then": { "properties": { "observationId": { "const": null }, "metricObservationDigest": { "const": null } } } }] } },
+    "providerVersions": { "type": "array", "maxItems": 16, "uniqueItems": true, "items": { "$ref": "#/$defs/versionedId" } },
+    "window": { "type": "object", "additionalProperties": false, "required": ["from", "to", "inclusive"], "properties": { "from": { "type": "string", "format": "date-time" }, "to": { "type": "string", "format": "date-time" }, "inclusive": { "const": true } } },
+    "operator": { "enum": ["gt", "gte", "lt", "lte", "eq", "between"] },
+    "unit": { "$ref": "#/$defs/id" },
+    "dimension": { "$ref": "#/$defs/id" },
+    "baseline": { "type": "number" },
+    "target": { "oneOf": [{ "type": "number" }, { "type": "array", "minItems": 2, "maxItems": 2, "items": { "type": "number" } }] },
+    "minimumEvidence": { "type": "integer", "minimum": 1, "maximum": 1000 },
+    "exactInputDigest": { "$ref": "#/$defs/hash" },
+    "result": { "enum": ["passed", "failed", "insufficient-evidence"] },
+    "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+    "absences": { "type": "array", "maxItems": 64, "uniqueItems": true, "items": { "$ref": "#/$defs/hash" } },
+    "contradictions": { "type": "array", "maxItems": 64, "uniqueItems": true, "items": { "$ref": "#/$defs/hash" } },
+    "evaluatedAt": { "type": "string", "format": "date-time" },
+    "revisit": { "type": "object", "additionalProperties": false, "required": ["required", "condition", "decisionIds"], "properties": { "required": { "type": "boolean" }, "condition": { "type": ["string", "null"], "maxLength": 1024 }, "decisionIds": { "type": "array", "maxItems": 64, "uniqueItems": true, "items": { "type": "string", "pattern": "^dec_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" } } } },
+    "evaluationHash": { "$ref": "#/$defs/hash" }
+  },
+  "allOf": [{ "if": { "properties": { "result": { "const": "passed" } }, "required": ["result"] }, "then": { "properties": { "absences": { "maxItems": 0 }, "contradictions": { "maxItems": 0 } } } }],
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" },
+    "version": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)$" },
+    "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "versionedId": { "type": "object", "additionalProperties": false, "required": ["id", "version"], "properties": { "id": { "$ref": "#/$defs/id" }, "version": { "$ref": "#/$defs/version" } } },
+    "recordRef": { "type": "object", "additionalProperties": false, "required": ["contractId", "schemaVersion", "protocolVersion", "recordId", "recordDigest"], "properties": { "contractId": { "$ref": "#/$defs/id" }, "schemaVersion": { "$ref": "#/$defs/version" }, "protocolVersion": { "$ref": "#/$defs/version" }, "recordId": { "type": "string", "minLength": 1, "maxLength": 128 }, "recordDigest": { "$ref": "#/$defs/hash" } } }
+  }
+}

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

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-outcome.schema.json",
+  "x-openplanr-contract": { "id": "operating-outcome", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 observed action outcome",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "outcomeId", "actionId", "scopeId", "domainId", "domainVersion", "verificationPlanId", "status", "observationIds", "evidenceRefIds", "sourceArtifactId", "observedAt"],
+  "properties": {
+    "kind": { "const": "operating-outcome" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" }, "outcomeId": { "$ref": "#/$defs/outcomeId" }, "actionId": { "$ref": "#/$defs/actionId" }, "scopeId": { "$ref": "#/$defs/id" }, "domainId": { "$ref": "#/$defs/id" }, "domainVersion": { "$ref": "#/$defs/version" }, "verificationPlanId": { "$ref": "#/$defs/planId" }, "status": { "enum": ["succeeded", "failed", "blocked", "cancelled", "insufficient-evidence"] }, "observationIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/observationId" } }, "evidenceRefIds": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/evidenceRefId" } }, "sourceArtifactId": { "$ref": "#/$defs/artifactId" }, "observedAt": { "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}$" }, "evidenceRefId": { "type": "string", "pattern": "^evr_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "id": { "type": "string", "minLength": 1, "maxLength": 128 }, "observationId": { "type": "string", "pattern": "^mob_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "outcomeId": { "type": "string", "pattern": "^out_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "planId": { "type": "string", "pattern": "^vfy_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "version": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)$" } }
+}

package/schemas/v2.0.0/operating-planning-proposal.schema.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-planning-proposal.schema.json",
+  "x-openplanr-contract": { "id": "operating-planning-proposal", "version": "1.0.0" },
+  "title": "OpenPlanr Operate planning proposal",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "proposalId", "correlationId", "revision", "predecessorProposalHash", "state", "confirmation", "scopeId", "domainId", "domainVersion", "cycleId", "eventHead", "decision", "action", "deliveryRoute", "acceptedPerspectiveSummaries", "evidence", "omissions", "framing", "metric", "verification", "actor", "preview", "planningCommand", "createdAt", "proposalHash"],
+  "properties": {
+    "kind": { "const": "operating-planning-proposal" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" },
+    "proposalId": { "type": "string", "pattern": "^oprop_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "correlationId": { "$ref": "#/$defs/id" },
+    "revision": { "type": "integer", "minimum": 1 }, "predecessorProposalHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" },
+    "state": { "enum": ["review-required", "approved", "expired", "withdrawn", "superseded"] }, "confirmation": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/confirmation" }] },
+    "scopeId": { "$ref": "#/$defs/id" }, "domainId": { "$ref": "#/$defs/id" }, "domainVersion": { "$ref": "#/$defs/version" }, "cycleId": { "$ref": "#/$defs/id" }, "eventHead": { "$ref": "#/$defs/eventHead" },
+    "decision": { "$ref": "#/$defs/decision" }, "action": { "$ref": "#/$defs/action" },
+    "deliveryRoute": { "allOf": [{ "$ref": "operating-delivery-route.schema.json" }, { "properties": { "route": { "const": "planning-work" } } }] },
+    "acceptedPerspectiveSummaries": { "type": "array", "minItems": 3, "items": { "$ref": "#/$defs/perspective" }, "allOf": [{ "contains": { "properties": { "roleKind": { "const": "advisor" } }, "required": ["roleKind"] }, "minContains": 1 }, { "contains": { "properties": { "roleKind": { "const": "challenger" } }, "required": ["roleKind"] }, "minContains": 1, "maxContains": 1 }, { "contains": { "properties": { "roleKind": { "const": "chair" } }, "required": ["roleKind"] }, "minContains": 1, "maxContains": 1 }] },
+    "evidence": { "type": "array", "items": { "$ref": "#/$defs/evidence" } },
+    "omissions": { "type": "array", "items": { "$ref": "#/$defs/omission" } },
+    "framing": { "$ref": "#/$defs/framing" }, "metric": { "$ref": "#/$defs/metric" }, "verification": { "$ref": "#/$defs/verification" }, "actor": { "$ref": "#/$defs/actor" }, "preview": { "$ref": "#/$defs/preview" },
+    "planningCommand": { "const": "planr operate planning create-spec" }, "createdAt": { "type": "string", "format": "date-time" }, "proposalHash": { "$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": 4096, "pattern": "^.*\\S.*$" }, "title": { "type": "string", "minLength": 1, "maxLength": 256, "pattern": "^\\S(?:[\\s\\S]*\\S)?$" },
+    "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" } } }
+    ] },
+    "decision": { "type": "object", "additionalProperties": false, "required": ["decisionId", "revision", "decisionHash", "sourceArtifactId", "title", "outcome", "rationale", "confidence", "evidenceRefIds"], "properties": { "decisionId": { "$ref": "#/$defs/id" }, "revision": { "type": "integer", "minimum": 1 }, "decisionHash": { "$ref": "#/$defs/hash" }, "sourceArtifactId": { "$ref": "#/$defs/id" }, "title": { "$ref": "#/$defs/title" }, "outcome": { "$ref": "#/$defs/text" }, "rationale": { "$ref": "#/$defs/text" }, "confidence": { "type": "number", "minimum": 0, "maximum": 1 }, "evidenceRefIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } } } },
+    "action": { "type": "object", "additionalProperties": false, "required": ["actionId", "revision", "actionHash", "sourceArtifactId", "title", "expectedResult", "metricId", "verificationPlanId"], "properties": { "actionId": { "$ref": "#/$defs/id" }, "revision": { "type": "integer", "minimum": 1 }, "actionHash": { "$ref": "#/$defs/hash" }, "sourceArtifactId": { "$ref": "#/$defs/id" }, "title": { "$ref": "#/$defs/title" }, "expectedResult": { "$ref": "#/$defs/text" }, "metricId": { "$ref": "#/$defs/id" }, "verificationPlanId": { "$ref": "#/$defs/id" } } },
+    "perspective": { "type": "object", "additionalProperties": false, "required": ["roleId", "roleVersion", "roleKind", "artifactId", "artifactHash", "accessClassification", "disposition", "normative", "stance", "summary", "constraints", "uncertainties"], "properties": { "roleId": { "$ref": "#/$defs/id" }, "roleVersion": { "const": "2.0.0" }, "roleKind": { "enum": ["advisor", "challenger", "chair"] }, "artifactId": { "$ref": "#/$defs/id" }, "artifactHash": { "$ref": "#/$defs/hash" }, "accessClassification": { "enum": ["public", "internal", "confidential", "restricted"] }, "disposition": { "const": "accepted" }, "normative": { "type": "boolean" }, "stance": { "enum": ["support", "object", "constraint", "unknown", "synthesis"] }, "summary": { "$ref": "#/$defs/text" }, "constraints": { "type": "array", "items": { "$ref": "#/$defs/text" } }, "uncertainties": { "type": "array", "items": { "$ref": "#/$defs/text" } } }, "allOf": [{ "if": { "properties": { "roleKind": { "const": "chair" } }, "required": ["roleKind"] }, "then": { "properties": { "normative": { "const": true }, "stance": { "const": "synthesis" } } }, "else": { "properties": { "normative": { "const": false } } } }] },
+    "evidence": { "type": "object", "additionalProperties": false, "required": ["evidenceRefId", "artifactId", "artifactHash", "classification", "accessState", "relation", "freshness", "confidence", "summary", "limitations"], "properties": { "evidenceRefId": { "$ref": "#/$defs/id" }, "artifactId": { "$ref": "#/$defs/id" }, "artifactHash": { "$ref": "#/$defs/hash" }, "classification": { "enum": ["public", "internal", "confidential", "restricted"] }, "accessState": { "enum": ["available", "restricted"] }, "relation": { "enum": ["support", "contradiction", "gap"] }, "freshness": { "enum": ["current", "historical", "stale", "unknown"] }, "confidence": { "type": "number", "minimum": 0, "maximum": 1 }, "summary": { "type": ["string", "null"], "maxLength": 4096 }, "limitations": { "type": "array", "items": { "$ref": "#/$defs/text" } } }, "allOf": [{ "if": { "properties": { "accessState": { "const": "restricted" } }, "required": ["accessState"] }, "then": { "properties": { "summary": { "type": "null" } } }, "else": { "properties": { "summary": { "$ref": "#/$defs/text" } } } }] },
+    "omission": { "type": "object", "additionalProperties": false, "required": ["classification", "count", "reason"], "properties": { "classification": { "enum": ["public", "internal", "confidential", "restricted"] }, "count": { "type": "integer", "minimum": 1 }, "reason": { "enum": ["access-denied", "hidden-reasoning-excluded", "raw-prompt-excluded", "rejected-advice-excluded", "restricted-body-excluded"] } } },
+    "framing": { "type": "object", "additionalProperties": false, "required": ["title", "slug", "problem", "objective", "users", "scope", "nonScope", "risks", "constraints", "requirements", "acceptanceOutcomes"], "properties": { "title": { "$ref": "#/$defs/title" }, "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$", "maxLength": 96 }, "problem": { "$ref": "#/$defs/text" }, "objective": { "$ref": "#/$defs/text" }, "users": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/text" } }, "scope": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/text" } }, "nonScope": { "type": "array", "items": { "$ref": "#/$defs/text" } }, "risks": { "type": "array", "items": { "$ref": "#/$defs/text" } }, "constraints": { "type": "array", "items": { "$ref": "#/$defs/text" } }, "requirements": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/text" } }, "acceptanceOutcomes": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/text" } } } },
+    "metric": { "type": "object", "additionalProperties": false, "required": ["metricId", "metricHash"], "properties": { "metricId": { "$ref": "#/$defs/id" }, "metricHash": { "$ref": "#/$defs/hash" } } },
+    "verification": { "type": "object", "additionalProperties": false, "required": ["verificationPlanId", "verificationPlanHash", "metricId", "metricHash", "baseline", "target", "window", "method", "revisitConditions"], "properties": { "verificationPlanId": { "$ref": "#/$defs/id" }, "verificationPlanHash": { "$ref": "#/$defs/hash" }, "metricId": { "$ref": "#/$defs/id" }, "metricHash": { "$ref": "#/$defs/hash" }, "baseline": { "type": "number" }, "target": { "type": "number" }, "window": { "$ref": "#/$defs/text" }, "method": { "$ref": "#/$defs/text" }, "revisitConditions": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/text" } } } },
+    "actor": { "type": "object", "additionalProperties": false, "required": ["actorId", "kind"], "properties": { "actorId": { "$ref": "#/$defs/id" }, "kind": { "const": "human" } } },
+    "preview": { "type": "object", "additionalProperties": false, "required": ["digest", "issuedAt", "expiresAt"], "properties": { "digest": { "$ref": "#/$defs/hash" }, "issuedAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": "string", "format": "date-time" } } },
+    "confirmation": { "type": "object", "additionalProperties": false, "required": ["confirmationId", "reviewProposalHash", "reviewProposalRevision", "eventHead", "previewDigest", "actorId", "decision", "confirmedAt", "previewExpiresAt", "confirmationHash"], "properties": { "confirmationId": { "$ref": "#/$defs/id" }, "reviewProposalHash": { "$ref": "#/$defs/hash" }, "reviewProposalRevision": { "const": 1 }, "eventHead": { "$ref": "#/$defs/eventHead" }, "previewDigest": { "$ref": "#/$defs/hash" }, "actorId": { "$ref": "#/$defs/id" }, "decision": { "const": "approved" }, "confirmedAt": { "type": "string", "format": "date-time" }, "previewExpiresAt": { "type": "string", "format": "date-time" }, "confirmationHash": { "$ref": "#/$defs/hash" } } }
+  },
+  "allOf": [
+    { "if": { "properties": { "state": { "const": "review-required" } }, "required": ["state"] }, "then": { "properties": { "revision": { "const": 1 }, "predecessorProposalHash": { "type": "null" }, "confirmation": { "type": "null" } } } },
+    { "if": { "properties": { "state": { "const": "approved" } }, "required": ["state"] }, "then": { "properties": { "revision": { "minimum": 2 }, "predecessorProposalHash": { "$ref": "#/$defs/hash" }, "confirmation": { "$ref": "#/$defs/confirmation" } } } }
+  ]
+}

package/schemas/v2.0.0/operating-policy-evaluation.schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://openplanr.dev/schemas/v2.0.0/operating-policy-evaluation.schema.json",
+  "x-openplanr-contract": { "id": "operating-policy-evaluation", "version": "2.0.0" }, "title": "OpenPlanr Operate 2.0 policy evaluation",
+  "type": "object", "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "evaluationId", "policy", "policyTier", "precedence", "appliedPolicyRefs", "action", "capability", "target", "effectClass", "outcome", "approvalRequirementIds", "reasonCodes", "evaluatedBy", "evaluatedAt", "inputHash", "evaluationHash"],
+  "properties": {
+    "kind": { "const": "operating-policy-evaluation" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" },
+    "evaluationId": { "type": "string", "pattern": "^pevl_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "policy": { "$ref": "#/$defs/policy" },
+    "policyTier": { "enum": ["core", "project", "domain"] }, "precedence": { "enum": [100, 200, 300] }, "appliedPolicyRefs": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/policy" } },
+    "action": { "$ref": "#/$defs/action" }, "capability": { "$ref": "#/$defs/versionedId" }, "target": { "$ref": "#/$defs/target" }, "effectClass": { "$ref": "#/$defs/effect" },
+    "outcome": { "enum": ["automatic", "named-single-party", "named-multi-party", "threshold", "deferred", "rejected", "prohibited"] },
+    "approvalRequirementIds": { "type": "array", "uniqueItems": true, "items": { "type": "string", "pattern": "^aprq_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" } },
+    "reasonCodes": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }, "evaluatedBy": { "$ref": "#/$defs/provider" }, "evaluatedAt": { "$ref": "#/$defs/time" }, "inputHash": { "$ref": "#/$defs/hash" }, "evaluationHash": { "$ref": "#/$defs/hash" }
+  },
+  "allOf": [
+    { "if": { "properties": { "policyTier": { "const": "core" } } }, "then": { "properties": { "precedence": { "const": 300 } } } },
+    { "if": { "properties": { "policyTier": { "const": "project" } } }, "then": { "properties": { "precedence": { "const": 200 } } } },
+    { "if": { "properties": { "policyTier": { "const": "domain" } } }, "then": { "properties": { "precedence": { "const": 100 } } } }
+  ],
+  "$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}$" }, "time": { "type": "string", "format": "date-time" }, "effect": { "enum": ["read-only", "machine-local-write", "project-write", "provider-call", "external-effect", "destructive"] },
+    "versionedId": { "type": "object", "additionalProperties": false, "required": ["id", "version"], "properties": { "id": { "$ref": "#/$defs/id" }, "version": { "$ref": "#/$defs/version" } } },
+    "policy": { "type": "object", "additionalProperties": false, "required": ["policyId", "policyVersion", "policyHash"], "properties": { "policyId": { "$ref": "#/$defs/id" }, "policyVersion": { "$ref": "#/$defs/version" }, "policyHash": { "$ref": "#/$defs/hash" } } },
+    "action": { "type": "object", "additionalProperties": false, "required": ["actionId", "revision", "actionHash"], "properties": { "actionId": { "type": "string", "pattern": "^act_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "revision": { "type": "integer", "minimum": 1 }, "actionHash": { "$ref": "#/$defs/hash" } } },
+    "provider": { "type": "object", "additionalProperties": false, "required": ["providerId", "providerVersion"], "properties": { "providerId": { "$ref": "#/$defs/id" }, "providerVersion": { "$ref": "#/$defs/version" } } },
+    "target": { "type": "object", "additionalProperties": false, "required": ["kind", "id", "revision"], "properties": { "kind": { "$ref": "#/$defs/id" }, "id": { "type": "string", "minLength": 1, "maxLength": 128 }, "revision": { "type": "string", "minLength": 1, "maxLength": 128 } } }
+  }
+}