pi-daddy 0.22.0 → 0.23.0

package/contracts/debrief/v1/work-capture/README.md

@@ -0,0 +1,38 @@
+# Work capture/review contract — P07 input for P08
+
+Owner: skill-harness. `work-case.schema.json` and `review-request.schema.json` are emitted from source-owned schemas. `fixtures/` comes from the actual case builder, archive and decision writer over seven synthetic layout incidents. These are not live captures, authenticated human statements or approved work.
+
+## Host API
+
+```ts
+import { createWorkCaseReviewer } from '@skill-harness/adapters';
+// An independently configured operator/controller selects this exact private archive, batch and author.
+const reviewer = createWorkCaseReviewer(archiveRoot, batchManifestId, operatorIdentity);
+const page = reviewer.list(0, 5); // total/offset/items; no writes, <=5 items per call
+const history = reviewer.history(caseManifestId); // read-only; no decision is inferred
+const result = reviewer.decide({ caseManifestId, priorDecisionId, disposition, note });
+```
+
+The caller must establish the legitimate operator and presentation/attention policy. This API is not a user authenticator, remote capability service or authorization for workers/adoption. A JSON case cannot supply the author, change batch membership or promote itself. Host callbacks can integrate this actual harness-owned writer with an existing dashboard; absent a genuine configured writer, UI actions must stay unavailable rather than writing a separate dashboard ledger.
+
+- `list` returns `{total,offset,items:[{caseManifestId,candidate,priorDecisionId,disposition}]}`. Unselected cases do not become agreement. A skip remains skip/unresolved, not a positive label. Five is a per-call ceiling, not proof of the P08 per-pause budget; the presenter must enforce one overall budget including blind cards.
+- `decide` accepts only the four schema fields. The selected batch bounds membership; author is fixed at host initialization. Unknown keys, stale prior IDs, invalid case state and altered history reject.
+- Result is `{current:WorkCaseDecision,replayed:boolean}`. Exact replay does not overwrite a newer current decision. Corrections append a digest-bound chain and preserve prior records.
+- Data lives in the existing private harness archive under `case-decisions/<caseId>/history.jsonl`, with a non-expiring owner-token lock at `case-decisions/<caseId>.lock`. First initialization occurs under that lock. Files/ancestors are checked, writes/directory entries synced, and another owner's lock is never removed.
+- Missing/partial/invalid existing histories refuse further writes. No truncate, automatic stale-lock recovery, rollback or manufactured empty history is provided. A crash/cleanup failure can leave durable bytes and an error; inspect the exact case. Whole-directory rollback by a hostile same-user owner is not prevented or qualified.
+- Case records stay silent/unresolved/causal-not-established. Labels do not alter P01 acceptance, grants, runtime control or scored specifications. Scenario promotion and independently verified calibration outcomes remain separate.
+
+Schemas cover wire shape. The source case builder additionally checks canonical ID and cost/reason consistency; the decision writer validates chain identity and expected prior state. Rendering arbitrary caller objects is not validation.
+
+## P08 presentation obligations
+
+Use existing dashboard/plugin. A verified suitable pause (not every agent_end or guessed idle state) and explicit exposure/calibration policy are still required for automatic presentation. At most five total questions/cards, including blind-choice cards. Defer on unknown boundary/absence/budget exhaustion. Reconnect retains unresolved cards. Quality choice must precede cost/configuration reveal in the separate frozen comparison family; no live casting result is implied by these fixtures. No worker/status messages or observer steering.
+
+Direct reproduction after compiler build:
+
+```sh
+node scripts/generate-work-case-contract.mjs --check
+node node_modules/vitest/vitest.mjs run packages/core/test/work-capture.test.ts packages/adapters/test/work-case-review.test.ts packages/adapters/test/work-case-archive.test.ts
+```
+
+Actual integration, independent labels/attention policy and full P07/P08 acceptance remain pending.

package/contracts/debrief/v1/work-capture/fixtures/batch.json

@@ -0,0 +1,17 @@
+{
+  "version": "work-candidate-batch-v1",
+  "observationId": "3be5c1b87d00d4457a9ec843379815d15a7d953b2c30b11d2325a0b6705adb82",
+  "candidateIds": [
+    "8c558dfc1db9526c1635515d259f1b6328915e08fee9724b06771c4e739a003c",
+    "48910d9ba3af6ab7fd022e6ee38b14f5a4a02d3fca6fe4aa12dc3ada1ef1f181",
+    "9dde8e074796e03ef02458e2bd158520e5a4fd7242f1fa88da2e86a6af20bddc",
+    "30e6b213a7ad8c236f597484f644ec867874bfa0de56d5c2fd430f7a9178e1a4",
+    "fedbb6f6549c42d213e36603d5246ae030ebc4c28a6f76491632f429cf656f94",
+    "d0303fd5789b494edafcd3c5a215a7191f1547f9d33802d7101bf911cda21ca3",
+    "54856ce8abf12a39cf6e09f92c3b744bae4647bb6dd817a47611c230c69a9635"
+  ],
+  "issues": [],
+  "expected": [],
+  "visibility": "silent",
+  "promotion": "not-authorized"
+}

package/contracts/debrief/v1/work-capture/fixtures/cases.json

@@ -0,0 +1,184 @@
+[
+  {
+    "capture_schema": 2,
+    "id": "cde56f1d95d336f923660c39fe28e229ab35a617bc10f95e721a09f844308696",
+    "detector": {
+      "id": "repeat_without_progress",
+      "version": "fixture-v1",
+      "population": "layout"
+    },
+    "target": {
+      "kind": "work",
+      "snapshotDigest": "2faa2f05b5b02895c1a132e371ed41ad589984a6fdabd1656e586689a19b8210",
+      "obligationId": "layout-1",
+      "obligationDigest": "a0fa4ebacf0486844bd388e4bc98a7af5c226485d412f46d1cd395c97f72287b"
+    },
+    "classification": "candidate_defect",
+    "reason": "repeat_without_progress",
+    "evidence": [
+      "e9cc4cf0642071e7f12c0fd62d4a94073b871c9694ee8c9b01cfd0d8c9ea9955"
+    ],
+    "metrics": {
+      "equivalentAttempts": 2
+    },
+    "status": "unresolved",
+    "visibility": "silent",
+    "causalAttribution": "not-established"
+  },
+  {
+    "capture_schema": 2,
+    "id": "9b2d86801bac09cf91b1ae79b66c4b5b06a3d1de8c540c0b82a1a9d63d05c2ae",
+    "detector": {
+      "id": "repeat_without_progress",
+      "version": "fixture-v1",
+      "population": "layout"
+    },
+    "target": {
+      "kind": "work",
+      "snapshotDigest": "2faa2f05b5b02895c1a132e371ed41ad589984a6fdabd1656e586689a19b8210",
+      "obligationId": "layout-2",
+      "obligationDigest": "70ffb2685bcd373e1cd46f1d07eb2156dce32a268db682babcb6579dbe206ae1"
+    },
+    "classification": "candidate_defect",
+    "reason": "repeat_without_progress",
+    "evidence": [
+      "e9cc4cf0642071e7f12c0fd62d4a94073b871c9694ee8c9b01cfd0d8c9ea9955"
+    ],
+    "metrics": {
+      "equivalentAttempts": 2
+    },
+    "status": "unresolved",
+    "visibility": "silent",
+    "causalAttribution": "not-established"
+  },
+  {
+    "capture_schema": 2,
+    "id": "a3a3840658bbfdb5fb6c29defa67f1694f762ce85f52c51df45b95822b8a40ac",
+    "detector": {
+      "id": "repeat_without_progress",
+      "version": "fixture-v1",
+      "population": "layout"
+    },
+    "target": {
+      "kind": "work",
+      "snapshotDigest": "2faa2f05b5b02895c1a132e371ed41ad589984a6fdabd1656e586689a19b8210",
+      "obligationId": "layout-3",
+      "obligationDigest": "91f6922af64a051483273f1ec7a9d26fff0181dd1ec308534ea2bacdbe7e7115"
+    },
+    "classification": "candidate_defect",
+    "reason": "repeat_without_progress",
+    "evidence": [
+      "e9cc4cf0642071e7f12c0fd62d4a94073b871c9694ee8c9b01cfd0d8c9ea9955"
+    ],
+    "metrics": {
+      "equivalentAttempts": 2
+    },
+    "status": "unresolved",
+    "visibility": "silent",
+    "causalAttribution": "not-established"
+  },
+  {
+    "capture_schema": 2,
+    "id": "b00ea15f36b19989370646e5147fd8c07fa6516166a9644406037e1a883ae2d8",
+    "detector": {
+      "id": "repeat_without_progress",
+      "version": "fixture-v1",
+      "population": "layout"
+    },
+    "target": {
+      "kind": "work",
+      "snapshotDigest": "2faa2f05b5b02895c1a132e371ed41ad589984a6fdabd1656e586689a19b8210",
+      "obligationId": "layout-4",
+      "obligationDigest": "57cf84e6c472010a3192fbbce4d6fb52d4f2ffb8f5469e8efebb729111ce085e"
+    },
+    "classification": "candidate_defect",
+    "reason": "repeat_without_progress",
+    "evidence": [
+      "e9cc4cf0642071e7f12c0fd62d4a94073b871c9694ee8c9b01cfd0d8c9ea9955"
+    ],
+    "metrics": {
+      "equivalentAttempts": 2
+    },
+    "status": "unresolved",
+    "visibility": "silent",
+    "causalAttribution": "not-established"
+  },
+  {
+    "capture_schema": 2,
+    "id": "d8501f65e20295b7fe243f04cf5948eec6324a6df752cb698fceb773d3cd0035",
+    "detector": {
+      "id": "repeat_without_progress",
+      "version": "fixture-v1",
+      "population": "layout"
+    },
+    "target": {
+      "kind": "work",
+      "snapshotDigest": "2faa2f05b5b02895c1a132e371ed41ad589984a6fdabd1656e586689a19b8210",
+      "obligationId": "layout-5",
+      "obligationDigest": "d6b30c9d90759d7e8b8c79610e8069111e1543ca754a04ef19f28f4a7e758691"
+    },
+    "classification": "candidate_defect",
+    "reason": "repeat_without_progress",
+    "evidence": [
+      "e9cc4cf0642071e7f12c0fd62d4a94073b871c9694ee8c9b01cfd0d8c9ea9955"
+    ],
+    "metrics": {
+      "equivalentAttempts": 2
+    },
+    "status": "unresolved",
+    "visibility": "silent",
+    "causalAttribution": "not-established"
+  },
+  {
+    "capture_schema": 2,
+    "id": "0d77c3aa02fcac76eda5b0e2b325c21e39cbf34aca02df3d4cce670c141bc16a",
+    "detector": {
+      "id": "repeat_without_progress",
+      "version": "fixture-v1",
+      "population": "layout"
+    },
+    "target": {
+      "kind": "work",
+      "snapshotDigest": "2faa2f05b5b02895c1a132e371ed41ad589984a6fdabd1656e586689a19b8210",
+      "obligationId": "layout-6",
+      "obligationDigest": "632be15828291b7ccaf216990c45dd72cf6700dc748cf2fb7fc4d243b0f799c8"
+    },
+    "classification": "candidate_defect",
+    "reason": "repeat_without_progress",
+    "evidence": [
+      "e9cc4cf0642071e7f12c0fd62d4a94073b871c9694ee8c9b01cfd0d8c9ea9955"
+    ],
+    "metrics": {
+      "equivalentAttempts": 2
+    },
+    "status": "unresolved",
+    "visibility": "silent",
+    "causalAttribution": "not-established"
+  },
+  {
+    "capture_schema": 2,
+    "id": "279ff762763d04bf18b0d91155e3bf2964b579d39a53d0569dc4ea51292c381b",
+    "detector": {
+      "id": "repeat_without_progress",
+      "version": "fixture-v1",
+      "population": "layout"
+    },
+    "target": {
+      "kind": "work",
+      "snapshotDigest": "2faa2f05b5b02895c1a132e371ed41ad589984a6fdabd1656e586689a19b8210",
+      "obligationId": "layout-7",
+      "obligationDigest": "858647bddfcb4f8d3c6eb9a10ac76e13eea7181875ddd670d06b9967986782ce"
+    },
+    "classification": "candidate_defect",
+    "reason": "repeat_without_progress",
+    "evidence": [
+      "e9cc4cf0642071e7f12c0fd62d4a94073b871c9694ee8c9b01cfd0d8c9ea9955"
+    ],
+    "metrics": {
+      "equivalentAttempts": 2
+    },
+    "status": "unresolved",
+    "visibility": "silent",
+    "causalAttribution": "not-established"
+  }
+]

package/contracts/debrief/v1/work-capture/fixtures/review.json

@@ -0,0 +1,184 @@
+{
+  "request": {
+    "caseManifestId": "8c558dfc1db9526c1635515d259f1b6328915e08fee9724b06771c4e739a003c",
+    "priorDecisionId": null,
+    "disposition": "skip",
+    "note": "synthetic fixture"
+  },
+  "response": {
+    "current": {
+      "decision_schema": 1,
+      "id": "d196cb64e7531f002d61387a85cb288077d858d81b2db3ab2efa4d2d31f96334",
+      "caseId": "cde56f1d95d336f923660c39fe28e229ab35a617bc10f95e721a09f844308696",
+      "priorDecisionId": null,
+      "disposition": "skip",
+      "author": "operator:fixture",
+      "evidence": [
+        "8c558dfc1db9526c1635515d259f1b6328915e08fee9724b06771c4e739a003c"
+      ],
+      "note": "synthetic fixture"
+    },
+    "replayed": false
+  },
+  "page": {
+    "total": 7,
+    "offset": 0,
+    "items": [
+      {
+        "caseManifestId": "30e6b213a7ad8c236f597484f644ec867874bfa0de56d5c2fd430f7a9178e1a4",
+        "candidate": {
+          "capture_schema": 2,
+          "id": "b00ea15f36b19989370646e5147fd8c07fa6516166a9644406037e1a883ae2d8",
+          "detector": {
+            "id": "repeat_without_progress",
+            "version": "fixture-v1",
+            "population": "layout"
+          },
+          "target": {
+            "kind": "work",
+            "snapshotDigest": "2faa2f05b5b02895c1a132e371ed41ad589984a6fdabd1656e586689a19b8210",
+            "obligationId": "layout-4",
+            "obligationDigest": "57cf84e6c472010a3192fbbce4d6fb52d4f2ffb8f5469e8efebb729111ce085e"
+          },
+          "classification": "candidate_defect",
+          "reason": "repeat_without_progress",
+          "evidence": [
+            "e9cc4cf0642071e7f12c0fd62d4a94073b871c9694ee8c9b01cfd0d8c9ea9955"
+          ],
+          "metrics": {
+            "equivalentAttempts": 2
+          },
+          "status": "unresolved",
+          "visibility": "silent",
+          "causalAttribution": "not-established"
+        },
+        "priorDecisionId": null,
+        "disposition": "unresolved"
+      },
+      {
+        "caseManifestId": "48910d9ba3af6ab7fd022e6ee38b14f5a4a02d3fca6fe4aa12dc3ada1ef1f181",
+        "candidate": {
+          "capture_schema": 2,
+          "id": "9b2d86801bac09cf91b1ae79b66c4b5b06a3d1de8c540c0b82a1a9d63d05c2ae",
+          "detector": {
+            "id": "repeat_without_progress",
+            "version": "fixture-v1",
+            "population": "layout"
+          },
+          "target": {
+            "kind": "work",
+            "snapshotDigest": "2faa2f05b5b02895c1a132e371ed41ad589984a6fdabd1656e586689a19b8210",
+            "obligationId": "layout-2",
+            "obligationDigest": "70ffb2685bcd373e1cd46f1d07eb2156dce32a268db682babcb6579dbe206ae1"
+          },
+          "classification": "candidate_defect",
+          "reason": "repeat_without_progress",
+          "evidence": [
+            "e9cc4cf0642071e7f12c0fd62d4a94073b871c9694ee8c9b01cfd0d8c9ea9955"
+          ],
+          "metrics": {
+            "equivalentAttempts": 2
+          },
+          "status": "unresolved",
+          "visibility": "silent",
+          "causalAttribution": "not-established"
+        },
+        "priorDecisionId": null,
+        "disposition": "unresolved"
+      },
+      {
+        "caseManifestId": "54856ce8abf12a39cf6e09f92c3b744bae4647bb6dd817a47611c230c69a9635",
+        "candidate": {
+          "capture_schema": 2,
+          "id": "279ff762763d04bf18b0d91155e3bf2964b579d39a53d0569dc4ea51292c381b",
+          "detector": {
+            "id": "repeat_without_progress",
+            "version": "fixture-v1",
+            "population": "layout"
+          },
+          "target": {
+            "kind": "work",
+            "snapshotDigest": "2faa2f05b5b02895c1a132e371ed41ad589984a6fdabd1656e586689a19b8210",
+            "obligationId": "layout-7",
+            "obligationDigest": "858647bddfcb4f8d3c6eb9a10ac76e13eea7181875ddd670d06b9967986782ce"
+          },
+          "classification": "candidate_defect",
+          "reason": "repeat_without_progress",
+          "evidence": [
+            "e9cc4cf0642071e7f12c0fd62d4a94073b871c9694ee8c9b01cfd0d8c9ea9955"
+          ],
+          "metrics": {
+            "equivalentAttempts": 2
+          },
+          "status": "unresolved",
+          "visibility": "silent",
+          "causalAttribution": "not-established"
+        },
+        "priorDecisionId": null,
+        "disposition": "unresolved"
+      },
+      {
+        "caseManifestId": "8c558dfc1db9526c1635515d259f1b6328915e08fee9724b06771c4e739a003c",
+        "candidate": {
+          "capture_schema": 2,
+          "id": "cde56f1d95d336f923660c39fe28e229ab35a617bc10f95e721a09f844308696",
+          "detector": {
+            "id": "repeat_without_progress",
+            "version": "fixture-v1",
+            "population": "layout"
+          },
+          "target": {
+            "kind": "work",
+            "snapshotDigest": "2faa2f05b5b02895c1a132e371ed41ad589984a6fdabd1656e586689a19b8210",
+            "obligationId": "layout-1",
+            "obligationDigest": "a0fa4ebacf0486844bd388e4bc98a7af5c226485d412f46d1cd395c97f72287b"
+          },
+          "classification": "candidate_defect",
+          "reason": "repeat_without_progress",
+          "evidence": [
+            "e9cc4cf0642071e7f12c0fd62d4a94073b871c9694ee8c9b01cfd0d8c9ea9955"
+          ],
+          "metrics": {
+            "equivalentAttempts": 2
+          },
+          "status": "unresolved",
+          "visibility": "silent",
+          "causalAttribution": "not-established"
+        },
+        "priorDecisionId": "d196cb64e7531f002d61387a85cb288077d858d81b2db3ab2efa4d2d31f96334",
+        "disposition": "skip"
+      },
+      {
+        "caseManifestId": "9dde8e074796e03ef02458e2bd158520e5a4fd7242f1fa88da2e86a6af20bddc",
+        "candidate": {
+          "capture_schema": 2,
+          "id": "a3a3840658bbfdb5fb6c29defa67f1694f762ce85f52c51df45b95822b8a40ac",
+          "detector": {
+            "id": "repeat_without_progress",
+            "version": "fixture-v1",
+            "population": "layout"
+          },
+          "target": {
+            "kind": "work",
+            "snapshotDigest": "2faa2f05b5b02895c1a132e371ed41ad589984a6fdabd1656e586689a19b8210",
+            "obligationId": "layout-3",
+            "obligationDigest": "91f6922af64a051483273f1ec7a9d26fff0181dd1ec308534ea2bacdbe7e7115"
+          },
+          "classification": "candidate_defect",
+          "reason": "repeat_without_progress",
+          "evidence": [
+            "e9cc4cf0642071e7f12c0fd62d4a94073b871c9694ee8c9b01cfd0d8c9ea9955"
+          ],
+          "metrics": {
+            "equivalentAttempts": 2
+          },
+          "status": "unresolved",
+          "visibility": "silent",
+          "causalAttribution": "not-established"
+        },
+        "priorDecisionId": null,
+        "disposition": "unresolved"
+      }
+    ]
+  }
+}

package/contracts/debrief/v1/work-capture/review-request.schema.json

@@ -0,0 +1,41 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "caseManifestId": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "priorDecisionId": {
+      "anyOf": [
+        {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "disposition": {
+      "enum": [
+        "confirmed_defect",
+        "expected_behavior",
+        "exemplar",
+        "uncertain",
+        "skip"
+      ]
+    },
+    "note": {
+      "type": "string",
+      "maxLength": 4000
+    }
+  },
+  "required": [
+    "caseManifestId",
+    "priorDecisionId",
+    "disposition",
+    "note"
+  ],
+  "additionalProperties": false
+}

package/contracts/debrief/v1/work-capture/work-case.schema.json

@@ -0,0 +1,190 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mojomanyana/skill-harness/contracts/work-capture/v2/work-case.schema.json",
+  "type": "object",
+  "properties": {
+    "capture_schema": {
+      "const": 2
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "detector": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512,
+          "pattern": "^[^\\u0000-\\u001f\\u007f]+$"
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512,
+          "pattern": "^[^\\u0000-\\u001f\\u007f]+$"
+        },
+        "population": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512,
+          "pattern": "^[^\\u0000-\\u001f\\u007f]+$"
+        }
+      },
+      "required": [
+        "id",
+        "version",
+        "population"
+      ],
+      "additionalProperties": false
+    },
+    "target": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "const": "work"
+        },
+        "snapshotDigest": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        },
+        "obligationId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 512,
+          "pattern": "^[^\\u0000-\\u001f\\u007f]+$"
+        },
+        "obligationDigest": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        }
+      },
+      "required": [
+        "kind",
+        "snapshotDigest",
+        "obligationId",
+        "obligationDigest"
+      ],
+      "additionalProperties": false
+    },
+    "classification": {
+      "enum": [
+        "candidate_defect",
+        "candidate_exemplar",
+        "coverage_issue"
+      ]
+    },
+    "reason": {
+      "enum": [
+        "repeat_without_progress",
+        "economical_exemplar",
+        "coverage_gap"
+      ]
+    },
+    "evidence": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^[a-f0-9]{64}$"
+      },
+      "minItems": 1,
+      "maxItems": 256,
+      "uniqueItems": true
+    },
+    "metrics": {
+      "type": "object",
+      "properties": {
+        "equivalentAttempts": {
+          "type": "integer",
+          "minimum": 2,
+          "maximum": 9007199254740991
+        },
+        "measuredCost": {
+          "type": "number",
+          "minimum": 0
+        },
+        "costLimit": {
+          "type": "number",
+          "minimum": 0
+        },
+        "costUnit": {
+          "enum": [
+            "wall_ms",
+            "tool_calls",
+            "usd"
+          ]
+        }
+      },
+      "required": [],
+      "additionalProperties": false
+    },
+    "status": {
+      "const": "unresolved"
+    },
+    "visibility": {
+      "const": "silent"
+    },
+    "causalAttribution": {
+      "const": "not-established"
+    }
+  },
+  "required": [
+    "capture_schema",
+    "id",
+    "detector",
+    "target",
+    "classification",
+    "reason",
+    "evidence",
+    "metrics",
+    "status",
+    "visibility",
+    "causalAttribution"
+  ],
+  "additionalProperties": false,
+  "oneOf": [
+    {
+      "properties": {
+        "reason": {
+          "const": "repeat_without_progress"
+        },
+        "classification": {
+          "const": "candidate_defect"
+        },
+        "metrics": {
+          "required": [
+            "equivalentAttempts"
+          ]
+        }
+      }
+    },
+    {
+      "properties": {
+        "reason": {
+          "const": "economical_exemplar"
+        },
+        "classification": {
+          "const": "candidate_exemplar"
+        },
+        "metrics": {
+          "required": [
+            "measuredCost",
+            "costLimit",
+            "costUnit"
+          ]
+        }
+      }
+    },
+    {
+      "properties": {
+        "reason": {
+          "const": "coverage_gap"
+        },
+        "classification": {
+          "const": "coverage_issue"
+        }
+      }
+    }
+  ]
+}