@openplanr/protocol 0.2.0

package/schemas/v2.0.0/operating-evidence-candidate.schema.json

@@ -0,0 +1,88 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-evidence-candidate.schema.json",
+  "x-openplanr-contract": { "id": "operating-evidence-candidate", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 evidence candidate",
+  "description": "An untrusted, source-Artifact-local request that only the runtime may resolve. It is not evidence, an Artifact, an Event, or a durable Claim.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "candidateId", "scopeId", "domainId", "domainVersion", "sourceArtifactId", "evidenceKind", "locator", "provider", "resolver"],
+  "properties": {
+    "kind": { "const": "operating-evidence-candidate" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "candidateId": { "$ref": "#/$defs/candidateId" },
+    "scopeId": { "$ref": "#/$defs/identifier" },
+    "domainId": { "$ref": "#/$defs/identifier" },
+    "domainVersion": { "$ref": "#/$defs/version" },
+    "sourceArtifactId": { "$ref": "#/$defs/artifactId" },
+    "evidenceKind": { "$ref": "#/$defs/evidenceKind" },
+    "locator": {},
+    "provider": { "$ref": "#/$defs/implementationRef" },
+    "resolver": { "$ref": "#/$defs/implementationRef" }
+  },
+  "allOf": [
+    { "if": { "properties": { "evidenceKind": { "const": "git" } } }, "then": { "properties": { "locator": { "$ref": "#/$defs/gitLocator" } } } },
+    { "if": { "properties": { "evidenceKind": { "const": "filesystem" } } }, "then": { "properties": { "locator": { "$ref": "#/$defs/filesystemLocator" } } } },
+    { "if": { "properties": { "evidenceKind": { "const": "planr" } } }, "then": { "properties": { "locator": { "$ref": "#/$defs/planrLocator" } } } },
+    { "if": { "properties": { "evidenceKind": { "const": "operate-artifact" } } }, "then": { "properties": { "locator": { "$ref": "#/$defs/operateArtifactLocator" } } } }
+  ],
+  "$defs": {
+    "identifier": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" },
+    "version": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)$" },
+    "candidateId": { "type": "string", "pattern": "^evc_[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}$" },
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "safeRelativePath": { "type": "string", "minLength": 1, "maxLength": 1024, "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))[A-Za-z0-9.][A-Za-z0-9._/-]*$" },
+    "evidenceKind": { "enum": ["git", "filesystem", "planr", "operate-artifact"] },
+    "implementationRef": {
+      "type": "object", "additionalProperties": false, "required": ["id", "version"],
+      "properties": { "id": { "$ref": "#/$defs/identifier" }, "version": { "$ref": "#/$defs/version" } }
+    },
+    "gitLocator": {
+      "type": "object", "additionalProperties": false, "required": ["repositoryId", "revision"],
+      "properties": {
+        "repositoryId": { "$ref": "#/$defs/identifier" },
+        "revision": { "type": "string", "minLength": 1, "maxLength": 256, "pattern": "^[A-Za-z0-9][A-Za-z0-9._/@+-]*$" },
+        "objectType": { "enum": ["commit", "tree", "blob", "tag"] },
+        "path": { "$ref": "#/$defs/safeRelativePath" },
+        "lines": {
+          "type": "object", "additionalProperties": false, "required": ["start", "end"],
+          "properties": { "start": { "type": "integer", "minimum": 1 }, "end": { "type": "integer", "minimum": 1 } }
+        },
+        "ancestry": {
+          "type": "object", "additionalProperties": false, "required": ["ancestorRevision"],
+          "properties": { "ancestorRevision": { "type": "string", "minLength": 1, "maxLength": 256, "pattern": "^[A-Za-z0-9][A-Za-z0-9._/@+-]*$" } }
+        }
+      },
+      "allOf": [
+        { "if": { "required": ["lines"] }, "then": { "required": ["path"] } }
+      ]
+    },
+    "filesystemLocator": {
+      "type": "object", "additionalProperties": false, "required": ["sourceRootId", "path"],
+      "properties": { "sourceRootId": { "$ref": "#/$defs/identifier" }, "path": { "$ref": "#/$defs/safeRelativePath" } }
+    },
+    "planrLocator": {
+      "type": "object", "additionalProperties": false, "required": ["projectId", "artifactId", "artifactType"],
+      "properties": {
+        "projectId": { "$ref": "#/$defs/identifier" },
+        "artifactId": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z][A-Za-z0-9._-]*$" },
+        "artifactType": { "$ref": "#/$defs/identifier" },
+        "path": { "$ref": "#/$defs/safeRelativePath" },
+        "contentHash": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "operateArtifactLocator": {
+      "type": "object", "additionalProperties": false, "required": ["artifactId", "expectedArtifactType", "expectedSchemaId", "expectedSchemaVersion"],
+      "properties": {
+        "artifactId": { "$ref": "#/$defs/artifactId" },
+        "expectedArtifactType": { "$ref": "#/$defs/identifier" },
+        "expectedSchemaId": { "$ref": "#/$defs/identifier" },
+        "expectedSchemaVersion": { "$ref": "#/$defs/version" },
+        "expectedRawHash": { "$ref": "#/$defs/digest" },
+        "expectedCanonicalHash": { "$ref": "#/$defs/digest" }
+      }
+    }
+  }
+}

package/schemas/v2.0.0/operating-evidence-edge.schema.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-evidence-edge.schema.json",
+  "x-openplanr-contract": { "id": "operating-evidence-edge", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 source-Artifact-local evidence edge",
+  "description": "A read-only proof link from a local claim proposal to a resolved EvidenceRef. It is not a durable Claim, Finding, Decision, Action, policy, approval, or executor record.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "edgeId", "scopeId", "domainId", "domainVersion", "sourceArtifactId", "localClaimId", "relation", "evidenceRefId", "createdBy", "createdAt", "confidence", "classification"],
+  "properties": {
+    "kind": { "const": "operating-evidence-edge" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "edgeId": { "$ref": "#/$defs/edgeId" },
+    "scopeId": { "$ref": "#/$defs/identifier" },
+    "domainId": { "$ref": "#/$defs/identifier" },
+    "domainVersion": { "$ref": "#/$defs/version" },
+    "sourceArtifactId": { "$ref": "#/$defs/artifactId" },
+    "localClaimId": { "$ref": "#/$defs/localClaimId" },
+    "relation": { "enum": ["supportedBy", "contradictedBy"] },
+    "evidenceRefId": { "$ref": "#/$defs/evidenceRefId" },
+    "createdBy": { "$ref": "#/$defs/runtimeActor" },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+    "classification": { "enum": ["public", "internal", "confidential", "restricted"] }
+  },
+  "$defs": {
+    "identifier": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" },
+    "version": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)$" },
+    "edgeId": { "type": "string", "pattern": "^eve_[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}$" },
+    "localClaimId": { "type": "string", "pattern": "^local-claim-[A-Za-z0-9][A-Za-z0-9._-]{0,119}$" },
+    "runtimeActor": {
+      "type": "object", "additionalProperties": false, "required": ["kind", "id"],
+      "properties": { "kind": { "const": "runtime" }, "id": { "type": "string", "minLength": 1, "maxLength": 128 } }
+    }
+  }
+}

package/schemas/v2.0.0/operating-evidence-graph.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-evidence-graph.schema.json",
+  "x-openplanr-contract": { "id": "operating-evidence-graph", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 rebuildable evidence graph",
+  "description": "A read-only scope/domain projection containing resolved EvidenceRefs and source-Artifact-local support or contradiction edges only.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "scopeId", "domainId", "domainVersion", "generatedAt", "evidenceRefs", "edges"],
+  "properties": {
+    "kind": { "const": "operating-evidence-graph" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "scopeId": { "$ref": "#/$defs/identifier" },
+    "domainId": { "$ref": "#/$defs/identifier" },
+    "domainVersion": { "$ref": "#/$defs/version" },
+    "generatedAt": { "type": "string", "format": "date-time" },
+    "evidenceRefs": { "type": "array", "uniqueItems": true, "items": { "$ref": "operating-evidence-ref.schema.json" } },
+    "edges": { "type": "array", "uniqueItems": true, "items": { "$ref": "operating-evidence-edge.schema.json" } }
+  },
+  "$defs": {
+    "identifier": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" },
+    "version": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)$" }
+  }
+}

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

@@ -0,0 +1,48 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-evidence-observation.schema.json",
+  "x-openplanr-contract": { "id": "operating-evidence-observation", "version": "2.0.0" },
+  "title": "Operating Evidence Observation",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "evidenceObservationId", "measurementPlan", "metricId", "metricObservation", "provider", "providerRegistrationHash", "checkpoint", "ingestion", "artifact", "evidenceRefs", "value", "unit", "dimension", "observedAt", "freshUntil", "classification", "status", "providerConfidence", "absences", "contradictions", "observationHash"],
+  "properties": {
+    "kind": { "const": "operating-evidence-observation" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "evidenceObservationId": { "type": "string", "pattern": "^eobs_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "measurementPlan": { "allOf": [{ "$ref": "#/$defs/recordRef" }, { "properties": { "contractId": { "const": "operating-measurement-plan" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" }, "recordId": { "type": "string", "pattern": "^mpln_[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}$" },
+    "metricObservation": { "oneOf": [{ "type": "null" }, { "allOf": [{ "$ref": "#/$defs/recordRef" }, { "properties": { "contractId": { "const": "operating-metric-observation" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" }, "recordId": { "type": "string", "pattern": "^mob_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" } } }] }] },
+    "provider": { "$ref": "#/$defs/versionedId" },
+    "providerRegistrationHash": { "$ref": "#/$defs/hash" },
+    "checkpoint": { "type": "object", "additionalProperties": false, "required": ["checkpointId", "checkpointHash"], "properties": { "checkpointId": { "type": "string", "pattern": "^lchk_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "checkpointHash": { "$ref": "#/$defs/hash" } } },
+    "ingestion": { "type": "object", "additionalProperties": false, "required": ["ingestionId", "ingestionHash"], "properties": { "ingestionId": { "type": "string", "pattern": "^ling_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "ingestionHash": { "$ref": "#/$defs/hash" } } },
+    "artifact": { "type": "object", "additionalProperties": false, "required": ["artifactId", "recordDigest"], "properties": { "artifactId": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "recordDigest": { "$ref": "#/$defs/hash" } } },
+    "evidenceRefs": { "type": "array", "minItems": 1, "maxItems": 128, "uniqueItems": true, "items": { "type": "object", "additionalProperties": false, "required": ["evidenceRefId", "recordDigest"], "properties": { "evidenceRefId": { "type": "string", "pattern": "^evr_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "recordDigest": { "$ref": "#/$defs/hash" } } } },
+    "value": { "type": ["number", "null"] },
+    "unit": { "$ref": "#/$defs/id" },
+    "dimension": { "$ref": "#/$defs/id" },
+    "observedAt": { "type": "string", "format": "date-time" },
+    "freshUntil": { "type": "string", "format": "date-time" },
+    "classification": { "enum": ["public", "internal", "confidential", "restricted"] },
+    "status": { "enum": ["observed", "absent", "contradicted"] },
+    "providerConfidence": { "type": ["number", "null"], "minimum": 0, "maximum": 1 },
+    "absences": { "type": "array", "maxItems": 32, "items": { "$ref": "#/$defs/absence" } },
+    "contradictions": { "type": "array", "maxItems": 32, "uniqueItems": true, "items": { "$ref": "#/$defs/hash" } },
+    "observationHash": { "$ref": "#/$defs/hash" }
+  },
+  "allOf": [
+    { "if": { "properties": { "status": { "const": "observed" } }, "required": ["status"] }, "then": { "properties": { "metricObservation": { "type": "object" }, "value": { "type": "number" }, "absences": { "maxItems": 0 }, "contradictions": { "maxItems": 0 } } } },
+    { "if": { "properties": { "status": { "const": "absent" } }, "required": ["status"] }, "then": { "properties": { "metricObservation": { "const": null }, "value": { "const": null }, "absences": { "minItems": 1 }, "contradictions": { "maxItems": 0 } } } },
+    { "if": { "properties": { "status": { "const": "contradicted" } }, "required": ["status"] }, "then": { "properties": { "metricObservation": { "const": null }, "contradictions": { "minItems": 1 } } } }
+  ],
+  "$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" } } },
+    "absence": { "type": "object", "additionalProperties": false, "required": ["kind", "reasonCode", "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_]*$" }, "detailsHash": { "$ref": "#/$defs/hash" } } }
+  }
+}

package/schemas/v2.0.0/operating-evidence-ref.schema.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-evidence-ref.schema.json",
+  "x-openplanr-contract": { "id": "operating-evidence-ref", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 resolved evidence reference",
+  "description": "Runtime-issued, immutable evidence identity. Its sourceContract is asserted by the selected registered resolver after validating the captured bytes; an untrusted candidate or locator cannot author it.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "evidenceRefId", "candidateId", "scopeId", "domainId", "domainVersion", "sourceArtifactId", "evidenceKind", "sourceContract", "locator", "provider", "resolver", "classification", "freshness", "evidenceArtifactId", "evidenceArtifactRawHash", "evidenceArtifactCanonicalHash", "resolvedAt"],
+  "properties": {
+    "kind": { "const": "operating-evidence-ref" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "evidenceRefId": { "$ref": "#/$defs/evidenceRefId" },
+    "candidateId": { "$ref": "#/$defs/candidateId" },
+    "scopeId": { "$ref": "#/$defs/identifier" },
+    "domainId": { "$ref": "#/$defs/identifier" },
+    "domainVersion": { "$ref": "#/$defs/version" },
+    "sourceArtifactId": { "$ref": "#/$defs/artifactId" },
+    "evidenceKind": { "$ref": "#/$defs/evidenceKind" },
+    "sourceContract": { "$ref": "#/$defs/sourceContract" },
+    "locator": {},
+    "provider": { "$ref": "operating-evidence-candidate.schema.json#/$defs/implementationRef" },
+    "resolver": { "$ref": "operating-evidence-candidate.schema.json#/$defs/implementationRef" },
+    "classification": { "enum": ["public", "internal", "confidential", "restricted"] },
+    "freshness": { "enum": ["current", "historical", "stale"] },
+    "evidenceArtifactId": { "$ref": "#/$defs/artifactId" },
+    "evidenceArtifactRawHash": { "$ref": "#/$defs/digest" },
+    "evidenceArtifactCanonicalHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" },
+    "resolvedAt": { "type": "string", "format": "date-time" }
+  },
+  "allOf": [
+    { "if": { "properties": { "evidenceKind": { "const": "git" } } }, "then": { "properties": { "locator": { "$ref": "operating-evidence-candidate.schema.json#/$defs/gitLocator" } } } },
+    { "if": { "properties": { "evidenceKind": { "const": "filesystem" } } }, "then": { "properties": { "locator": { "$ref": "operating-evidence-candidate.schema.json#/$defs/filesystemLocator" } } } },
+    { "if": { "properties": { "evidenceKind": { "const": "planr" } } }, "then": { "properties": { "locator": { "$ref": "operating-evidence-candidate.schema.json#/$defs/planrLocator" } } } },
+    { "if": { "properties": { "evidenceKind": { "const": "operate-artifact" } } }, "then": { "properties": { "locator": { "$ref": "operating-evidence-candidate.schema.json#/$defs/operateArtifactLocator" } } } }
+  ],
+  "$defs": {
+    "identifier": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" },
+    "version": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)$" },
+    "candidateId": { "type": "string", "pattern": "^evc_[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}$" },
+    "artifactId": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "evidenceKind": { "enum": ["git", "filesystem", "planr", "operate-artifact"] },
+    "sourceContract": {
+      "type": "object", "additionalProperties": false, "required": ["id", "version"],
+      "properties": { "id": { "$ref": "#/$defs/identifier" }, "version": { "$ref": "#/$defs/version" } }
+    }
+  }
+}

package/schemas/v2.0.0/operating-evidence-resolution.schema.json

@@ -0,0 +1,54 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-evidence-resolution.schema.json",
+  "x-openplanr-contract": { "id": "operating-evidence-resolution", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 evidence resolution outcome",
+  "description": "Runtime-owned outcome envelope. A rejection contains safe structured context only; a resolution binds one immutable evidence Artifact.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "resolutionId", "candidateId", "scopeId", "domainId", "domainVersion", "sourceArtifactId", "evidenceKind", "sourceContract", "provider", "resolver", "outcome", "evidenceRefId", "evidenceArtifactId", "error", "resolvedAt"],
+  "properties": {
+    "kind": { "const": "operating-evidence-resolution" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "resolutionId": { "$ref": "#/$defs/resolutionId" },
+    "candidateId": { "$ref": "#/$defs/candidateId" },
+    "scopeId": { "$ref": "#/$defs/identifier" },
+    "domainId": { "$ref": "#/$defs/identifier" },
+    "domainVersion": { "$ref": "#/$defs/version" },
+    "sourceArtifactId": { "$ref": "#/$defs/artifactId" },
+    "evidenceKind": { "enum": ["git", "filesystem", "planr", "operate-artifact"] },
+    "sourceContract": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/sourceContract" }] },
+    "provider": { "$ref": "operating-evidence-candidate.schema.json#/$defs/implementationRef" },
+    "resolver": { "$ref": "operating-evidence-candidate.schema.json#/$defs/implementationRef" },
+    "outcome": { "enum": ["resolved", "rejected"] },
+    "evidenceRefId": { "type": ["string", "null"], "pattern": "^evr_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "evidenceArtifactId": { "type": ["string", "null"], "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "error": { "type": ["object", "null"], "additionalProperties": false, "required": ["code", "retryable", "context"], "properties": { "code": { "$ref": "#/$defs/errorCode" }, "retryable": { "type": "boolean" }, "context": { "$ref": "#/$defs/safeErrorContext" } } },
+    "resolvedAt": { "type": "string", "format": "date-time" }
+  },
+  "allOf": [
+    { "if": { "properties": { "outcome": { "const": "resolved" } } }, "then": { "properties": { "sourceContract": { "$ref": "#/$defs/sourceContract" }, "evidenceRefId": { "type": "string" }, "evidenceArtifactId": { "type": "string" }, "error": { "const": null } } } },
+    { "if": { "properties": { "outcome": { "const": "rejected" } } }, "then": { "properties": { "sourceContract": { "const": null }, "evidenceRefId": { "const": null }, "evidenceArtifactId": { "const": null }, "error": { "type": "object" } } } }
+  ],
+  "$defs": {
+    "identifier": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$" },
+    "version": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)$" },
+    "resolutionId": { "type": "string", "pattern": "^evs_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "candidateId": { "type": "string", "pattern": "^evc_[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}$" },
+    "sourceContract": { "type": "object", "additionalProperties": false, "required": ["id", "version"], "properties": { "id": { "$ref": "#/$defs/identifier" }, "version": { "$ref": "#/$defs/version" } } },
+    "errorCode": { "enum": ["SOURCE_NOT_FOUND", "REVISION_NOT_FOUND", "OBJECT_TYPE_MISMATCH", "PATH_NOT_FOUND", "LINE_RANGE_INVALID", "ANCESTRY_MISMATCH", "ARTIFACT_NOT_FOUND", "ARTIFACT_HASH_MISMATCH", "SOURCE_UNTRACKED", "SOURCE_STALE", "CAPABILITY_DENIED", "CONSENT_REQUIRED", "SENSITIVITY_BLOCKED", "SECRET_DETECTED", "UNSUPPORTED_EVIDENCE_KIND", "EVIDENCE_PROVIDER_UNAVAILABLE", "EVIDENCE_RESOLVER_UNREGISTERED", "EVIDENCE_RESOLVER_UNAVAILABLE", "EVIDENCE_RESOLVER_VERSION_UNSUPPORTED", "EVIDENCE_SOURCE_SCOPE_MISMATCH", "EVIDENCE_LOCATOR_INVALID"] },
+    "safeErrorContext": {
+      "type": "object", "additionalProperties": false,
+      "properties": {
+        "evidenceKind": { "enum": ["git", "filesystem", "planr", "operate-artifact"] },
+        "repositoryId": { "$ref": "#/$defs/identifier" },
+        "sourceRootId": { "$ref": "#/$defs/identifier" },
+        "projectId": { "$ref": "#/$defs/identifier" },
+        "artifactId": { "$ref": "#/$defs/artifactId" },
+        "resolverId": { "$ref": "#/$defs/identifier" }
+      }
+    }
+  }
+}

package/schemas/v2.0.0/operating-execution-result.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-execution-result.schema.json",
+  "x-openplanr-contract": { "id": "operating-execution-result", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 execution result",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "resultId", "operationId", "operationKind", "requestFingerprint", "action", "assignmentId", "evaluationId", "approvalIds", "grantId", "capability", "target", "effectClass", "executor", "connector", "status", "targetBeforeHash", "targetAfterHash", "baselineArtifactId", "baselineHash", "inputArtifactIds", "outputArtifactIds", "effectSummary", "resultArtifactId", "verificationPlanId", "rollbackPlanId", "eventIds", "completedAt", "resultHash"],
+  "properties": {
+    "kind": { "const": "operating-execution-result" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "2.0.0" },
+    "resultId": { "type": "string", "pattern": "^xres_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "operationId": { "type": "string", "pattern": "^op_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "operationKind": { "const": "execute" }, "requestFingerprint": { "$ref": "#/$defs/hash" },
+    "action": { "$ref": "#/$defs/action" }, "assignmentId": { "type": "string", "pattern": "^asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "evaluationId": { "type": "string", "pattern": "^pevl_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "approvalIds": { "type": "array", "uniqueItems": true, "items": { "type": "string", "pattern": "^aprv_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" } }, "grantId": { "type": "string", "pattern": "^cgr_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "capability": { "$ref": "#/$defs/versionedId" }, "target": { "$ref": "#/$defs/target" }, "effectClass": { "$ref": "#/$defs/effect" }, "executor": { "$ref": "#/$defs/executor" }, "connector": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/versionedId" }] },
+    "status": { "enum": ["succeeded", "failed", "partial", "uncertain", "blocked"] }, "targetBeforeHash": { "$ref": "#/$defs/hash" }, "targetAfterHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" }, "baselineArtifactId": { "type": ["string", "null"], "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "baselineHash": { "type": ["string", "null"], "pattern": "^sha256:[a-f0-9]{64}$" },
+    "inputArtifactIds": { "$ref": "#/$defs/artifactIds" }, "outputArtifactIds": { "$ref": "#/$defs/artifactIds" }, "effectSummary": { "$ref": "#/$defs/effectSummary" }, "resultArtifactId": { "type": "string", "pattern": "^art_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "verificationPlanId": { "type": "string", "pattern": "^vfy_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "rollbackPlanId": { "type": ["string", "null"], "pattern": "^rbp_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" }, "eventIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "pattern": "^evt_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" } }, "completedAt": { "type": "string", "format": "date-time" }, "resultHash": { "$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}$" }, "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" } } }, "artifactIds": { "type": "array", "uniqueItems": true, "items": { "type": "string", "pattern": "^art_[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" } } }, "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 } } }, "executor": { "type": "object", "additionalProperties": false, "required": ["executorId", "executorVersion"], "properties": { "executorId": { "$ref": "#/$defs/id" }, "executorVersion": { "$ref": "#/$defs/version" } } },
+    "effectSummary": { "type": "object", "additionalProperties": false, "required": ["changed", "summary", "affectedTargetIds"], "properties": { "changed": { "type": "boolean" }, "summary": { "type": "string", "minLength": 1, "maxLength": 2048 }, "affectedTargetIds": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 128 } } } }
+  }
+}

package/schemas/v2.0.0/operating-executive-board.schema.json

@@ -0,0 +1,78 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-executive-board.schema.json",
+  "x-openplanr-contract": { "id": "operating-executive-board", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 transition-owned Executive Board",
+  "description": "Closed identity projection over Chair-to-Review truth. New Cycles persist the materialized variant in the atomic transition; old Cycles use the non-authoritative compatibility variant only in memory. Presentation labels and narrative remain derived from durable sources.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "kind", "schemaVersion", "protocolVersion", "boardId", "scopeId", "domainId",
+    "domainVersion", "cycleId", "planId", "ledgerId", "reviewId", "reviewHash", "projectionMode",
+    "authoritativeForMutation", "sourceEventHead", "materializedEventId", "seatBindings",
+    "findingIds", "decisionIds", "actionIds", "traceMatrix", "createdAt", "semanticHash", "boardHash"
+  ],
+  "properties": {
+    "kind": { "const": "operating-executive-board" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "boardId": { "type": "string", "pattern": "^xbr_[a-f0-9]{32}$" },
+    "scopeId": { "$ref": "#/$defs/id" },
+    "domainId": { "const": "business" },
+    "domainVersion": { "$ref": "#/$defs/version" },
+    "cycleId": { "$ref": "#/$defs/id" },
+    "planId": { "$ref": "#/$defs/id" },
+    "ledgerId": { "$ref": "#/$defs/id" },
+    "reviewId": { "$ref": "#/$defs/id" },
+    "reviewHash": { "$ref": "#/$defs/hash" },
+    "projectionMode": { "enum": ["materialized", "compatibility"] },
+    "authoritativeForMutation": { "type": "boolean" },
+    "sourceEventHead": { "$ref": "operating-trace-matrix.schema.json#/$defs/eventHead" },
+    "materializedEventId": { "type": ["string", "null"], "minLength": 1, "maxLength": 128 },
+    "seatBindings": {
+      "type": "array", "minItems": 1, "maxItems": 16,
+      "items": { "$ref": "#/$defs/seatBinding" }
+    },
+    "findingIds": { "type": "array", "maxItems": 256, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
+    "decisionIds": { "type": "array", "maxItems": 256, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
+    "actionIds": { "type": "array", "maxItems": 256, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
+    "traceMatrix": { "$ref": "operating-trace-matrix.schema.json" },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "semanticHash": { "$ref": "#/$defs/hash" },
+    "boardHash": { "$ref": "#/$defs/hash" }
+  },
+  "oneOf": [
+    {
+      "properties": {
+        "projectionMode": { "const": "materialized" },
+        "authoritativeForMutation": { "const": true },
+        "materializedEventId": { "$ref": "#/$defs/id" }
+      }
+    },
+    {
+      "properties": {
+        "projectionMode": { "const": "compatibility" },
+        "authoritativeForMutation": { "const": false },
+        "materializedEventId": { "const": null }
+      }
+    }
+  ],
+  "$defs": {
+    "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "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}$" },
+    "seatBinding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["roleId", "roleKind", "roleVersion", "assignmentId", "artifactId", "absenceId"],
+      "properties": {
+        "roleId": { "$ref": "#/$defs/id" },
+        "roleKind": { "enum": ["advisor", "challenger", "chair"] },
+        "roleVersion": { "$ref": "#/$defs/version" },
+        "assignmentId": { "type": ["string", "null"], "maxLength": 128 },
+        "artifactId": { "type": ["string", "null"], "maxLength": 128 },
+        "absenceId": { "type": ["string", "null"], "maxLength": 128 }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,116 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v2.0.0/operating-finding.schema.json",
+  "x-openplanr-contract": { "id": "operating-finding", "version": "2.0.0" },
+  "title": "OpenPlanr Operate 2.0 persistent finding",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "kind", "schemaVersion", "protocolVersion", "findingId", "scopeId", "domainId", "domainVersion",
+    "origin", "sourceCycleId", "sourceArtifactId", "title", "statement", "state", "ownerActorId", "revisitAt",
+    "createdAt", "updatedAt"
+  ],
+  "properties": {
+    "kind": { "const": "operating-finding" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "2.0.0" },
+    "findingId": { "type": "string", "pattern": "^fnd_[A-Za-z0-9][A-Za-z0-9._-]{7,127}$" },
+    "scopeId": { "$ref": "#/$defs/nonPlaceholder" },
+    "domainId": { "$ref": "#/$defs/nonPlaceholder" },
+    "domainVersion": { "allOf": [{ "$ref": "#/$defs/nonPlaceholder" }, { "maxLength": 64 }] },
+    "origin": { "enum": ["persistent-work", "operating-intelligence"] },
+    "sourceCycleId": { "$ref": "#/$defs/cycleId" },
+    "sourceArtifactId": { "$ref": "#/$defs/artifactId" },
+    "sourceAssignmentId": { "$ref": "#/$defs/assignmentId" },
+    "sourceLocalFindingId": { "$ref": "#/$defs/localFindingId" },
+    "findingType": { "enum": ["unsupported", "contradicted", "correlated-reasoning", "missing-alternative", "unpriced-downside", "irreversibility-mismatch", "overconfidence", "scope-violation"] },
+    "severity": { "enum": ["low", "medium", "high", "critical"] },
+    "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+    "targets": { "type": "array", "minItems": 1, "maxItems": 64, "items": { "$ref": "#/$defs/target" } },
+    "supportingEvidenceRefIds": { "$ref": "#/$defs/evidenceRefIds" },
+    "contradictingEvidenceRefIds": { "$ref": "#/$defs/evidenceRefIds" },
+    "title": { "$ref": "#/$defs/title" },
+    "statement": { "$ref": "#/$defs/nonBlankText" },
+    "rationale": { "$ref": "#/$defs/nonBlankText" },
+    "correctionCondition": { "$ref": "#/$defs/nonBlankText" },
+    "state": { "type": "string", "enum": ["open", "accepted", "resolved", "rejected", "deferred", "superseded"] },
+    "ownerActorId": { "type": ["string", "null"], "minLength": 1, "maxLength": 128 },
+    "revisitAt": { "type": ["string", "null"], "format": "date-time" },
+    "createdAt": { "type": "string", "format": "date-time" },
+    "updatedAt": { "type": "string", "format": "date-time" }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "origin": { "const": "persistent-work" } }, "required": ["origin"] },
+      "then": {
+        "not": {
+          "anyOf": [
+            { "required": ["sourceAssignmentId"] },
+            { "required": ["sourceLocalFindingId"] },
+            { "required": ["findingType"] },
+            { "required": ["severity"] },
+            { "required": ["confidence"] },
+            { "required": ["targets"] },
+            { "required": ["supportingEvidenceRefIds"] },
+            { "required": ["contradictingEvidenceRefIds"] },
+            { "required": ["rationale"] },
+            { "required": ["correctionCondition"] }
+          ]
+        }
+      }
+    },
+    {
+      "if": { "properties": { "origin": { "const": "operating-intelligence" } }, "required": ["origin"] },
+      "then": {
+        "required": [
+          "sourceAssignmentId", "sourceLocalFindingId", "findingType", "severity", "confidence", "targets",
+          "supportingEvidenceRefIds", "contradictingEvidenceRefIds", "rationale", "correctionCondition"
+        ]
+      }
+    },
+    {
+      "if": { "properties": { "state": { "const": "deferred" } } },
+      "then": {
+        "anyOf": [
+          { "properties": { "ownerActorId": { "type": "string" } } },
+          { "properties": { "revisitAt": { "type": "string", "format": "date-time" } } }
+        ]
+      }
+    }
+  ],
+  "$defs": {
+    "assignmentId": { "type": "string", "pattern": "^asg_[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}$" },
+    "cycleId": { "type": "string", "pattern": "^cyc_[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}$" },
+    "localFindingId": { "type": "string", "pattern": "^finding:asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}:[1-9][0-9]*$" },
+    "localAnalysisId": { "type": "string", "pattern": "^analysis:asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}:[1-9][0-9]*$" },
+    "localClaimId": { "type": "string", "pattern": "^claim:asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}:[1-9][0-9]*$" },
+    "localMeasurementId": { "type": "string", "pattern": "^measurement:asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}:[1-9][0-9]*$" },
+    "localRiskId": { "type": "string", "pattern": "^risk:asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}:[1-9][0-9]*$" },
+    "localRecommendationId": { "type": "string", "pattern": "^recommendation:asg_[A-Za-z0-9][A-Za-z0-9._-]{7,127}:1$" },
+    "evidenceRefIds": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/evidenceRefId" } },
+    "target": {
+      "type": "object", "additionalProperties": false,
+      "required": ["advisorArtifactId", "analysisIds", "claimIds", "measurementIds", "riskIds", "recommendationIds"],
+      "properties": {
+        "advisorArtifactId": { "$ref": "#/$defs/artifactId" },
+        "analysisIds": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/localAnalysisId" } },
+        "claimIds": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/localClaimId" } },
+        "measurementIds": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/localMeasurementId" } },
+        "riskIds": { "type": "array", "maxItems": 128, "uniqueItems": true, "items": { "$ref": "#/$defs/localRiskId" } },
+        "recommendationIds": { "type": "array", "maxItems": 1, "uniqueItems": true, "items": { "$ref": "#/$defs/localRecommendationId" } }
+      },
+      "anyOf": [
+        { "properties": { "analysisIds": { "minItems": 1 } } },
+        { "properties": { "claimIds": { "minItems": 1 } } },
+        { "properties": { "measurementIds": { "minItems": 1 } } },
+        { "properties": { "riskIds": { "minItems": 1 } } },
+        { "properties": { "recommendationIds": { "minItems": 1 } } }
+      ]
+    },
+    "nonBlankText": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^[\\s\\S]*\\S[\\s\\S]*$" },
+    "nonPlaceholder": { "type": "string", "minLength": 1, "maxLength": 128, "not": { "pattern": "(?:<[^>]+>|\\{\\{[^}]+\\}\\})" } },
+    "title": { "type": "string", "minLength": 1, "maxLength": 256, "pattern": "^\\S(?:[\\s\\S]*\\S)?$", "not": { "pattern": "(?:<[^>]+>|\\{\\{[^}]+\\}\\})" } }
+  }
+}