@openplanr/protocol 0.2.0

package/schemas/v1.4.0/evaluation-host-profile.schema.json

@@ -0,0 +1,73 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.4.0/evaluation-host-profile.schema.json",
+  "title": "Protocol 1.4 evaluation host profile",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "hostProfileId", "host", "profileVersion", "runtime", "platform", "capabilityTier", "permissionModel", "outputModes", "skillHostSupport", "certifiedFullPipelineRuntime", "adapterBinding", "provenance", "profileDigest"],
+  "properties": {
+    "kind": { "const": "evaluation-host-profile" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "1.4.0" },
+    "hostProfileId": { "type": "string", "pattern": "^ehp_[a-f0-9]{32}$" },
+    "host": { "$ref": "#/$defs/name" },
+    "profileVersion": { "$ref": "#/$defs/version" },
+    "runtime": { "enum": ["cli", "desktop", "web", "mobile", "ide-extension", "headless-browser"] },
+    "platform": { "enum": ["darwin", "linux", "win32", "browser", "mobile"] },
+    "capabilityTier": { "enum": ["artifact", "workflow", "product"] },
+    "permissionModel": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode", "promptSurface", "toolIsolation", "escalation"],
+      "properties": {
+        "mode": { "enum": ["prompted", "preauthorized", "sandboxed", "denied"] },
+        "promptSurface": { "enum": ["terminal", "chat", "native-dialog", "none"] },
+        "toolIsolation": { "enum": ["enforced", "advisory", "none", "enforced-read-only"] },
+        "escalation": { "const": "refused" }
+      }
+    },
+    "outputModes": { "type": "array", "minItems": 1, "maxItems": 8, "uniqueItems": true, "items": { "enum": ["text", "markdown", "json", "file", "artifact", "image", "web-page"] } },
+    "skillHostSupport": { "type": "boolean" },
+    "certifiedFullPipelineRuntime": { "type": "boolean" },
+    "adapterBinding": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["contractId", "schemaVersion", "protocolVersion", "adapterId", "adapterVersion", "recordDigest"],
+          "properties": {
+            "contractId": { "const": "adapter-registry" },
+            "schemaVersion": { "const": "1.1.0" },
+            "protocolVersion": { "const": "1.4.0" },
+            "adapterId": { "enum": ["claude-code", "codex", "cursor"] },
+            "adapterVersion": { "$ref": "#/$defs/version" },
+            "recordDigest": { "$ref": "#/$defs/digest" }
+          }
+        }
+      ]
+    },
+    "provenance": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["packageName", "packageVersion", "sourceDigest"],
+      "properties": {
+        "packageName": { "$ref": "#/$defs/name" },
+        "packageVersion": { "$ref": "#/$defs/version" },
+        "sourceDigest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "profileDigest": { "$ref": "#/$defs/digest" }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "certifiedFullPipelineRuntime": { "const": true } }, "required": ["certifiedFullPipelineRuntime"] },
+      "then": { "properties": { "adapterBinding": { "type": "object" } }, "required": ["adapterBinding"] }
+    }
+  ],
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "name": { "type": "string", "maxLength": 64, "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/v1.4.0/evaluation-observation.schema.json

@@ -0,0 +1,76 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.4.0/evaluation-observation.schema.json",
+  "title": "OpenPlanr Protocol 1.4 evaluation observation",
+  "type": "object", "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "observationId", "runId", "scenario", "grader", "hostProfile", "fixtures", "packageDigest", "budgetDigest", "outcome", "terminalReason", "graderOutputDigest", "absence", "observedAt", "observationDigest"],
+  "properties": {
+    "kind": { "const": "evaluation-observation" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "1.4.0" },
+    "observationId": { "type": "string", "pattern": "^eob_[a-f0-9]{32}$" },
+    "runId": { "type": "string", "pattern": "^eru_[a-f0-9]{32}$" },
+    "scenario": {
+      "type": "object", "additionalProperties": false,
+      "required": ["scenarioId", "scenarioDigest", "corpusDigest", "promptClass"],
+      "properties": {
+        "scenarioId": { "type": "string", "pattern": "^esc_[a-f0-9]{64}$" },
+        "scenarioDigest": { "$ref": "#/$defs/digest" },
+        "corpusDigest": { "$ref": "#/$defs/digest" },
+        "promptClass": { "enum": ["positive", "negative", "ambiguous", "permission-denied"] }
+      }
+    },
+    "grader": {
+      "type": "object", "additionalProperties": false,
+      "required": ["graderId", "graderVersion", "graderType", "registrationDigest", "registryDigest"],
+      "properties": {
+        "graderId": { "type": "string", "pattern": "^egr_[a-f0-9]{32}$" },
+        "graderVersion": { "$ref": "#/$defs/version" },
+        "graderType": { "enum": ["deterministic-schema", "deterministic-behaviour", "live-model-judgement"] },
+        "registrationDigest": { "$ref": "#/$defs/digest" },
+        "registryDigest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "hostProfile": {
+      "type": "object", "additionalProperties": false,
+      "required": ["hostProfileId", "profileDigest", "registryDigest"],
+      "properties": {
+        "hostProfileId": { "type": "string", "pattern": "^ehp_[a-f0-9]{32}$" },
+        "profileDigest": { "$ref": "#/$defs/digest" },
+        "registryDigest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "fixtures": {
+      "type": "array", "minItems": 1, "maxItems": 32, "uniqueItems": true,
+      "items": {
+        "type": "object", "additionalProperties": false, "required": ["fixtureId", "contentDigest"],
+        "properties": { "fixtureId": { "type": "string", "pattern": "^efx_[a-f0-9]{64}$" }, "contentDigest": { "$ref": "#/$defs/digest" } }
+      }
+    },
+    "packageDigest": { "$ref": "#/$defs/digest" },
+    "budgetDigest": { "$ref": "#/$defs/digest" },
+    "outcome": { "enum": ["pass", "fail", "absent"] },
+    "terminalReason": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,63}$" },
+    "graderOutputDigest": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/digest" }] },
+    "absence": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/absence" }] },
+    "observedAt": { "type": "string", "format": "date-time" },
+    "observationDigest": { "$ref": "#/$defs/digest" }
+  },
+  "allOf": [
+    { "if": { "properties": { "outcome": { "enum": ["pass", "fail"] } }, "required": ["outcome"] }, "then": { "properties": { "absence": { "type": "null" }, "graderOutputDigest": { "$ref": "#/$defs/digest" } } } },
+    { "if": { "properties": { "outcome": { "const": "absent" } }, "required": ["outcome"] }, "then": { "properties": { "absence": { "$ref": "#/$defs/absence" }, "graderOutputDigest": { "type": "null" } } } }
+  ],
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "version": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)$" },
+    "absence": {
+      "type": "object", "additionalProperties": false,
+      "description": "A grader that is missing, errored, unavailable, or never run is recorded here. It is not a result.",
+      "required": ["code", "reason", "treatedAsPass", "recoveryDisposition"],
+      "properties": {
+        "code": { "enum": ["grader-missing", "grader-errored", "grader-unavailable", "host-unavailable", "fixture-unavailable", "budget-exceeded", "not-run"] },
+        "reason": { "type": "string", "minLength": 1, "maxLength": 2048 },
+        "treatedAsPass": { "const": false },
+        "recoveryDisposition": { "enum": ["rerun", "register-grader", "refresh-fixture", "escalate"] }
+      }
+    }
+  }
+}

package/schemas/v1.4.0/evaluation-run-result.schema.json

@@ -0,0 +1,84 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.4.0/evaluation-run-result.schema.json",
+  "title": "OpenPlanr Protocol 1.4 evaluation run result",
+  "type": "object", "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "runResultId", "runId", "visibility", "publishable", "evidenceTransport", "corpusDigest", "graderRegistryDigest", "hostProfileRegistryDigest", "hostProfiles", "budgetDigest", "gatePolicyDigest", "packageDigest", "sourceDigest", "observations", "measurements", "findingCounts", "rawEvidence", "terminalReason", "startedAt", "completedAt", "runResultDigest"],
+  "properties": {
+    "kind": { "const": "evaluation-run-result" }, "schemaVersion": { "const": "1.0.0" }, "protocolVersion": { "const": "1.4.0" },
+    "runResultId": { "type": "string", "pattern": "^ers_[a-f0-9]{32}$" },
+    "runId": { "type": "string", "pattern": "^eru_[a-f0-9]{32}$" },
+    "visibility": { "const": "local" },
+    "publishable": { "const": false, "description": "The aggregate report is the only publishable projection of a run." },
+    "evidenceTransport": { "const": "digest-only" },
+    "corpusDigest": { "$ref": "#/$defs/digest" },
+    "graderRegistryDigest": { "$ref": "#/$defs/digest" },
+    "hostProfileRegistryDigest": { "$ref": "#/$defs/digest" },
+    "hostProfiles": {
+      "type": "array", "minItems": 1, "maxItems": 32, "uniqueItems": true,
+      "items": {
+        "type": "object", "additionalProperties": false, "required": ["hostProfileId", "profileDigest"],
+        "properties": { "hostProfileId": { "type": "string", "pattern": "^ehp_[a-f0-9]{32}$" }, "profileDigest": { "$ref": "#/$defs/digest" } }
+      }
+    },
+    "budgetDigest": { "$ref": "#/$defs/digest" },
+    "gatePolicyDigest": { "$ref": "#/$defs/digest" },
+    "packageDigest": { "$ref": "#/$defs/digest" },
+    "sourceDigest": { "$ref": "#/$defs/digest" },
+    "observations": {
+      "type": "array", "minItems": 1, "maxItems": 4096, "uniqueItems": true,
+      "items": {
+        "type": "object", "additionalProperties": false, "required": ["observationId", "observationDigest", "scenarioDigest", "outcome"],
+        "properties": {
+          "observationId": { "type": "string", "pattern": "^eob_[a-f0-9]{32}$" },
+          "observationDigest": { "$ref": "#/$defs/digest" },
+          "scenarioDigest": { "$ref": "#/$defs/digest" },
+          "outcome": { "enum": ["pass", "fail", "absent"] }
+        }
+      }
+    },
+    "measurements": {
+      "type": "object", "additionalProperties": false,
+      "required": ["latencyMsP50", "latencyMsP95", "inputTokens", "outputTokens", "totalTokens", "costEstimateCurrency", "costEstimateMicros", "permissionPrompts", "retries"],
+      "properties": {
+        "latencyMsP50": { "$ref": "#/$defs/durationMs" },
+        "latencyMsP95": { "$ref": "#/$defs/durationMs" },
+        "inputTokens": { "$ref": "#/$defs/tokenCount" },
+        "outputTokens": { "$ref": "#/$defs/tokenCount" },
+        "totalTokens": { "$ref": "#/$defs/tokenCount" },
+        "costEstimateCurrency": { "const": "USD" },
+        "costEstimateMicros": { "$ref": "#/$defs/costMicros" },
+        "permissionPrompts": { "$ref": "#/$defs/counter" },
+        "retries": { "$ref": "#/$defs/counter" }
+      }
+    },
+    "findingCounts": {
+      "type": "object", "additionalProperties": false, "required": ["p0", "p1", "p2", "p3"],
+      "properties": { "p0": { "$ref": "#/$defs/counter" }, "p1": { "$ref": "#/$defs/counter" }, "p2": { "$ref": "#/$defs/counter" }, "p3": { "$ref": "#/$defs/counter" } }
+    },
+    "rawEvidence": {
+      "type": "array", "maxItems": 4096, "uniqueItems": true,
+      "description": "Prompts, traces, screenshots, and model output are referenced by digest. The bytes stay in the local store and never enter this record.",
+      "items": {
+        "type": "object", "additionalProperties": false, "required": ["evidenceId", "class", "contentDigest", "byteLength"],
+        "properties": {
+          "evidenceId": { "type": "string", "pattern": "^eev_[a-f0-9]{32}$" },
+          "class": { "enum": ["prompt", "trace", "screenshot", "model-output"] },
+          "contentDigest": { "$ref": "#/$defs/digest" },
+          "byteLength": { "type": "integer", "minimum": 0, "maximum": 1099511627776 }
+        }
+      }
+    },
+    "terminalReason": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{2,63}$" },
+    "startedAt": { "type": "string", "format": "date-time" },
+    "completedAt": { "type": "string", "format": "date-time" },
+    "runResultDigest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "durationMs": { "type": "integer", "minimum": 0, "maximum": 86400000 },
+    "tokenCount": { "type": "integer", "minimum": 0, "maximum": 100000000 },
+    "costMicros": { "type": "integer", "minimum": 0, "maximum": 1000000000000 },
+    "counter": { "type": "integer", "minimum": 0, "maximum": 1000000 }
+  }
+}

package/schemas/v1.4.0/evaluation-scenario.schema.json

@@ -0,0 +1,231 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.4.0/evaluation-scenario.schema.json",
+  "x-openplanr-contract": { "id": "evaluation-scenario", "version": "1.4.0" },
+  "title": "OpenPlanr Protocol v1.4 skill evaluation scenario",
+  "description": "One measurable skill trigger case, bound to an exact skill version, host profile, fixture set, and budget. `scenarioDigest` is SHA-256 over the RFC 8785 canonical form of this record with `scenarioId` and `scenarioDigest` removed, and `scenarioId` is `esc_` followed by that digest hex, so one changed byte yields a different identity and invalidates the evidence recorded against the old one.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "kind",
+    "schemaVersion",
+    "protocolVersion",
+    "scenarioId",
+    "scenarioDigest",
+    "title",
+    "intent",
+    "skill",
+    "hostProfileRef",
+    "promptClass",
+    "expectedTrigger",
+    "declaredPermissions",
+    "riskClass",
+    "fixtureRefs",
+    "budgetRef"
+  ],
+  "properties": {
+    "kind": { "const": "evaluation-scenario" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "1.4.0" },
+    "scenarioId": {
+      "$ref": "#/$defs/scenarioId",
+      "description": "The literal prefix `esc_` followed by the hexadecimal part of `scenarioDigest`. Any other value is a foreign identity."
+    },
+    "scenarioDigest": { "$ref": "#/$defs/digest" },
+    "title": { "$ref": "#/$defs/title" },
+    "intent": {
+      "$ref": "#/$defs/text",
+      "description": "What triggering behaviour this scenario proves, stated so a reader can tell a pass from a near miss."
+    },
+    "skill": {
+      "$ref": "#/$defs/skillIdentity",
+      "description": "The exact skill under evaluation. Evidence never carries across versions."
+    },
+    "hostProfileRef": {
+      "$ref": "#/$defs/hostProfileRef",
+      "description": "Bound by digest rather than by name so a re-declared host invalidates its own evidence."
+    },
+    "promptClass": {
+      "enum": ["positive", "negative", "ambiguous", "permission-denied"],
+      "description": "Positive cases measure recall, negative cases measure precision, ambiguous cases measure restraint, and permission-denied cases measure refusal."
+    },
+    "expectedTrigger": { "$ref": "#/$defs/expectedTrigger" },
+    "declaredPermissions": {
+      "type": "array",
+      "maxItems": 32,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/permission" },
+      "description": "Every capability the host offers this scenario and the decision it returns. An absent capability is denied, never assumed."
+    },
+    "riskClass": {
+      "enum": ["read-only", "local-write", "destructive", "external-effect"],
+      "description": "Widest blast radius the scenario may reach when the skill triggers."
+    },
+    "fixtureRefs": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 32,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/fixtureRef" },
+      "contains": { "type": "object", "required": ["role"], "properties": { "role": { "const": "prompt" } } },
+      "minContains": 1,
+      "maxContains": 1,
+      "description": "Exactly one fixture supplies the prompt. Prompt text lives in the fixture so no raw prompt is carried by an identity-bearing record."
+    },
+    "budgetRef": { "$ref": "#/$defs/budgetRef" }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "promptClass": { "const": "positive" } }, "required": ["promptClass"] },
+      "then": {
+        "properties": {
+          "expectedTrigger": { "properties": { "outcome": { "const": "invoke" } }, "required": ["outcome"] }
+        }
+      }
+    },
+    {
+      "if": { "properties": { "promptClass": { "const": "negative" } }, "required": ["promptClass"] },
+      "then": {
+        "properties": {
+          "expectedTrigger": { "properties": { "outcome": { "const": "decline" } }, "required": ["outcome"] }
+        }
+      }
+    },
+    {
+      "if": { "properties": { "promptClass": { "const": "ambiguous" } }, "required": ["promptClass"] },
+      "then": {
+        "properties": {
+          "expectedTrigger": { "properties": { "outcome": { "enum": ["clarify", "decline"] } }, "required": ["outcome"] }
+        }
+      }
+    },
+    {
+      "if": { "properties": { "promptClass": { "const": "permission-denied" } }, "required": ["promptClass"] },
+      "then": {
+        "properties": {
+          "expectedTrigger": { "properties": { "outcome": { "const": "refuse" } }, "required": ["outcome"] },
+          "declaredPermissions": {
+            "contains": { "type": "object", "required": ["decision"], "properties": { "decision": { "const": "denied" } } },
+            "minContains": 1
+          }
+        }
+      }
+    },
+    {
+      "if": { "properties": { "riskClass": { "const": "read-only" } }, "required": ["riskClass"] },
+      "then": {
+        "properties": {
+          "declaredPermissions": {
+            "not": {
+              "contains": {
+                "type": "object",
+                "required": ["capability", "decision"],
+                "properties": {
+                  "capability": { "enum": ["file-write", "command-execute", "network", "browser", "credential", "git", "publish", "deploy"] },
+                  "decision": { "const": "granted" }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  ],
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "scenarioId": { "type": "string", "pattern": "^esc_[a-f0-9]{64}$" },
+    "fixtureId": { "type": "string", "pattern": "^efx_[a-f0-9]{64}$" },
+    "identifier": {
+      "type": "string",
+      "minLength": 2,
+      "maxLength": 128,
+      "pattern": "^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$"
+    },
+    "skillId": {
+      "type": "string",
+      "minLength": 2,
+      "maxLength": 64,
+      "pattern": "^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$"
+    },
+    "semver": {
+      "type": "string",
+      "pattern": "^(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)\\.(?:0|[1-9][0-9]*)$"
+    },
+    "text": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 2048,
+      "pattern": "^[\\s\\S]*\\S[\\s\\S]*$"
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 160,
+      "pattern": "^\\S(?:[\\s\\S]*\\S)?$",
+      "not": { "pattern": "(?:<[^>]+>|\\{\\{[^}]+\\}\\})" }
+    },
+    "skillIdentity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "version"],
+      "properties": {
+        "id": { "$ref": "#/$defs/skillId" },
+        "version": { "$ref": "#/$defs/semver" }
+      }
+    },
+    "hostProfileRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["hostProfileId", "hostProfileDigest"],
+      "properties": {
+        "hostProfileId": { "$ref": "#/$defs/identifier" },
+        "hostProfileDigest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "budgetRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["budgetId", "budgetDigest"],
+      "properties": {
+        "budgetId": { "$ref": "#/$defs/identifier" },
+        "budgetDigest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "fixtureRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["fixtureId", "contentDigest", "role"],
+      "properties": {
+        "fixtureId": { "$ref": "#/$defs/fixtureId" },
+        "contentDigest": {
+          "$ref": "#/$defs/digest",
+          "description": "Bytes the scenario was authored against. A fixture whose recomputed content digest differs invalidates this scenario's evidence."
+        },
+        "role": { "enum": ["prompt", "context", "expected-output", "asset"] }
+      }
+    },
+    "permission": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["capability", "decision"],
+      "properties": {
+        "capability": {
+          "enum": ["file-read", "file-write", "command-execute", "network", "browser", "credential", "git", "publish", "deploy"]
+        },
+        "decision": { "enum": ["granted", "denied"] }
+      }
+    },
+    "expectedTrigger": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["outcome", "rationale"],
+      "properties": {
+        "outcome": {
+          "enum": ["invoke", "decline", "clarify", "refuse"],
+          "description": "The only correct terminal behaviour for this prompt class. There is no outcome meaning unknown, so a missing observation can never be read as a pass."
+        },
+        "rationale": { "$ref": "#/$defs/text" }
+      }
+    }
+  }
+}

package/schemas/v1.4.0/evaluation-waiver.schema.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.4.0/evaluation-waiver.schema.json",
+  "title": "OpenPlanr Protocol v1.4 skill evaluation waiver",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "waiverId", "gatePolicyDigest", "metric", "scope", "reason", "ownerSignature", "issuedAt", "expiresAt", "receiptVisibility", "waiverDigest"],
+  "properties": {
+    "kind": { "const": "evaluation-waiver" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "1.4.0" },
+    "waiverId": { "type": "string", "pattern": "^evw_[a-f0-9]{32}$" },
+    "gatePolicyDigest": { "$ref": "#/$defs/digest" },
+    "metric": { "$ref": "#/$defs/waivableMetric" },
+    "scope": { "oneOf": [{ "$ref": "#/$defs/scenarioScope" }, { "$ref": "#/$defs/skillScope" }] },
+    "reason": {
+      "type": "object", "additionalProperties": false,
+      "required": ["code", "statement"],
+      "properties": {
+        "code": { "enum": ["accepted-risk", "known-defect", "environment-limitation", "deferred-remediation", "external-dependency"] },
+        "statement": { "type": "string", "minLength": 10, "maxLength": 280, "pattern": "^[A-Za-z0-9][A-Za-z0-9 ,.()'-]{9,279}$" }
+      }
+    },
+    "ownerSignature": {
+      "type": "object", "additionalProperties": false,
+      "required": ["identity", "keyIdentity", "payloadDigest"],
+      "properties": {
+        "identity": { "$ref": "#/$defs/actorIdentity" },
+        "keyIdentity": { "$ref": "#/$defs/actorIdentity" },
+        "payloadDigest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "issuedAt": { "type": "string", "format": "date-time" },
+    "expiresAt": { "type": "string", "format": "date-time" },
+    "receiptVisibility": { "const": "visible" },
+    "waiverDigest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "actorIdentity": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$" },
+    "skillId": { "type": "string", "pattern": "^[a-z][a-z0-9-]{1,63}$" },
+    "skillVersion": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:[-+][0-9A-Za-z.-]+)?$" },
+    "waivableMetric": { "enum": ["trigger-precision", "trigger-recall", "journey-completion", "asset-parity", "export-parity", "latency-regression", "cost-regression"] },
+    "scenarioScope": {
+      "title": "scenario scope",
+      "type": "object", "additionalProperties": false,
+      "required": ["kind", "scenarioDigest"],
+      "properties": {
+        "kind": { "const": "scenario" },
+        "scenarioDigest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "skillScope": {
+      "title": "skill scope",
+      "type": "object", "additionalProperties": false,
+      "required": ["kind", "skillId", "skillVersion", "skillSourceDigest"],
+      "properties": {
+        "kind": { "const": "skill" },
+        "skillId": { "$ref": "#/$defs/skillId" },
+        "skillVersion": { "$ref": "#/$defs/skillVersion" },
+        "skillSourceDigest": { "$ref": "#/$defs/digest" }
+      }
+    }
+  }
+}

package/schemas/v1.4.0/skill-certification-receipt.schema.json

@@ -0,0 +1,103 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openplanr.dev/schemas/v1.4.0/skill-certification-receipt.schema.json",
+  "title": "OpenPlanr Protocol v1.4 skill certification readiness receipt",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["kind", "schemaVersion", "protocolVersion", "recordType", "receiptId", "issuedAt", "subject", "inputs", "gateEvaluation", "appliedWaivers", "result", "blockingMetrics", "receiptDigest"],
+  "properties": {
+    "kind": { "const": "skill-certification-receipt" },
+    "schemaVersion": { "const": "1.0.0" },
+    "protocolVersion": { "const": "1.4.0" },
+    "recordType": { "const": "readiness" },
+    "receiptId": { "type": "string", "pattern": "^scr_[a-f0-9]{32}$" },
+    "issuedAt": { "type": "string", "format": "date-time" },
+    "subject": {
+      "type": "object", "additionalProperties": false,
+      "required": ["skillId", "skillVersion", "skillSourceDigest"],
+      "properties": {
+        "skillId": { "$ref": "#/$defs/skillId" },
+        "skillVersion": { "$ref": "#/$defs/skillVersion" },
+        "skillSourceDigest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "inputs": {
+      "type": "object", "additionalProperties": false,
+      "required": ["corpusDigest", "graderRegistryDigest", "hostProfiles", "budgetBaselineDigest", "gatePolicyDigest", "aggregateReportDigest"],
+      "properties": {
+        "corpusDigest": { "$ref": "#/$defs/digest" },
+        "graderRegistryDigest": { "$ref": "#/$defs/digest" },
+        "hostProfiles": { "type": "array", "minItems": 1, "maxItems": 32, "uniqueItems": true, "items": { "$ref": "#/$defs/hostProfileBinding" } },
+        "budgetBaselineDigest": { "$ref": "#/$defs/digest" },
+        "gatePolicyDigest": { "$ref": "#/$defs/digest" },
+        "aggregateReportDigest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "gateEvaluation": { "type": "array", "minItems": 1, "maxItems": 32, "uniqueItems": true, "items": { "$ref": "#/$defs/gateResult" } },
+    "appliedWaivers": { "type": "array", "maxItems": 32, "uniqueItems": true, "items": { "$ref": "#/$defs/appliedWaiver" } },
+    "result": { "enum": ["release-ready", "blocked"] },
+    "blockingMetrics": { "type": "array", "maxItems": 16, "uniqueItems": true, "items": { "$ref": "#/$defs/metric" } },
+    "receiptDigest": { "$ref": "#/$defs/digest" }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "result": { "const": "release-ready" } }, "required": ["result"] },
+      "then": {
+        "properties": {
+          "blockingMetrics": { "maxItems": 0 },
+          "gateEvaluation": { "items": { "properties": { "status": { "enum": ["met", "waived"] } } } }
+        }
+      }
+    },
+    {
+      "if": { "properties": { "result": { "const": "blocked" } }, "required": ["result"] },
+      "then": { "properties": { "blockingMetrics": { "minItems": 1 } } }
+    }
+  ],
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "skillId": { "type": "string", "pattern": "^[a-z][a-z0-9-]{1,63}$" },
+    "skillVersion": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:[-+][0-9A-Za-z.-]+)?$" },
+    "hostProfileId": { "type": "string", "pattern": "^[a-z][a-z0-9-]{1,63}$" },
+    "metric": { "enum": ["trigger-precision", "trigger-recall", "journey-completion", "schema-validity", "asset-parity", "export-parity", "package-parity", "finding-severity-p0", "finding-severity-p1", "latency-regression", "cost-regression"] },
+    "waivableMetric": { "enum": ["trigger-precision", "trigger-recall", "journey-completion", "asset-parity", "export-parity", "latency-regression", "cost-regression"] },
+    "unwaivableMetric": { "enum": ["schema-validity", "package-parity", "finding-severity-p0", "finding-severity-p1"] },
+    "hostProfileBinding": {
+      "type": "object", "additionalProperties": false,
+      "required": ["hostProfileId", "hostProfileDigest"],
+      "properties": {
+        "hostProfileId": { "$ref": "#/$defs/hostProfileId" },
+        "hostProfileDigest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "gateResult": {
+      "type": "object", "additionalProperties": false,
+      "required": ["metric", "waivable", "status", "waiverDigest"],
+      "properties": {
+        "metric": { "$ref": "#/$defs/metric" },
+        "waivable": { "type": "boolean" },
+        "status": { "enum": ["met", "not-met", "waived"] },
+        "waiverDigest": { "oneOf": [{ "const": null }, { "$ref": "#/$defs/digest" }] }
+      },
+      "allOf": [
+        { "if": { "properties": { "metric": { "$ref": "#/$defs/unwaivableMetric" } }, "required": ["metric"] }, "then": { "properties": { "waivable": { "const": false } } } },
+        { "if": { "properties": { "waivable": { "const": false } }, "required": ["waivable"] }, "then": { "properties": { "status": { "enum": ["met", "not-met"] }, "waiverDigest": { "const": null } } } },
+        { "if": { "properties": { "status": { "const": "waived" } }, "required": ["status"] }, "then": { "properties": { "waivable": { "const": true }, "metric": { "$ref": "#/$defs/waivableMetric" }, "waiverDigest": { "$ref": "#/$defs/digest" } } } },
+        { "if": { "properties": { "status": { "enum": ["met", "not-met"] } }, "required": ["status"] }, "then": { "properties": { "waiverDigest": { "const": null } } } }
+      ]
+    },
+    "appliedWaiver": {
+      "type": "object", "additionalProperties": false,
+      "required": ["waiverDigest", "metric", "scopeKind", "reasonCode", "ownerSignatureIdentity", "issuedAt", "expiresAt"],
+      "properties": {
+        "waiverDigest": { "$ref": "#/$defs/digest" },
+        "metric": { "$ref": "#/$defs/waivableMetric" },
+        "scopeKind": { "enum": ["scenario", "skill"] },
+        "reasonCode": { "enum": ["accepted-risk", "known-defect", "environment-limitation", "deferred-remediation", "external-dependency"] },
+        "ownerSignatureIdentity": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$" },
+        "issuedAt": { "type": "string", "format": "date-time" },
+        "expiresAt": { "type": "string", "format": "date-time" }
+      }
+    }
+  }
+}