agent-qa 0.2.2 → 0.2.4

package/capability-catalog/capability-catalog.json

@@ -1,228 +1,17 @@
 {
   "$note": [
-    "GENERATED — the capability catalog for Phase 398 (XPLN-01, D-01/D-03/D-05).",
+    "GENERATED — the capability catalog.",
     "One row per registry capability, per chat alias and per shipped skill. This artifact is the ONE",
     "data source behind `init --agent`, the chat `/` type-ahead, the starter prompts and `explain`.",
-    "DO NOT EDIT BY HAND: regenerate with \"bash scripts/398-regen-catalog.sh --write\" and commit the",
+    "DO NOT EDIT BY HAND: regenerate with \"bash scripts/regen-capability-catalog.sh --write\" and commit the",
     "result as a deliberate, reviewed change. The script refuses to run while any other leg of the",
     "conformance suite is red, so a regeneration cannot launder an unrelated failure, and no",
     "test-runner update flag reaches this file.",
-    "IT DESCRIBES, IT DOES NOT GATE. Nothing here allows or withholds a capability, and since",
-    "2026-10-01 (432 D-12) nothing anywhere does: no caller is shown or refused a capability",
-    "by who it is.",
-    "`migrationMap` is the v1 -> v2 tool-name adjudication (XPLN-03), projected verbatim from",
-    "`packages/mcp`. It is retired HISTORY, not capability: nothing in it is callable today.",
+    "IT DESCRIBES, IT DOES NOT GATE. Nothing here allows or withholds a capability, and nothing",
+    "anywhere does: no caller is shown or refused a capability by who it is.",
     "Each op row's `exampleCall` is DERIVED from that row's own `params` — a null arm with a stated",
     "reason means the contract carries a construct a placeholder could not be shown to satisfy."
   ],
-  "migrationCount": 33,
-  "migrationMap": [
-    {
-      "arm": "pending",
-      "note": "gap (397, 2026-08-16): ruled a REAL gap as `runs.cancel` and routed to its owner rather than minted in 397, because D-17 binds the adjudicator too.",
-      "owner": "M5 (live-view control arbiter)",
-      "route": "until `runs.cancel` lands, a run is stopped by the host that started it; this surface starts runs through `agent_qa_start_run` and cannot stop one.",
-      "v1Name": "agent_qa_cancel_run"
-    },
-    {
-      "arm": "retired",
-      "note": "not-a-gap (397, 2026-08-16): classification on demand over dashboard-fetched data is the private data path M4 abolished, not a capability that went missing.",
-      "route": "`analysis.get` reads the verdict the `analyze-run` job produced; over this surface the triage answer is `agent_qa_get_run_digest`.",
-      "v1Name": "agent_qa_classify_failure"
-    },
-    {
-      "arm": "renamed-to",
-      "note": "projected by 396 (inventory row 21, 2026-08-16): `config.hook.add` is an arm of the config fold. Since 2026-09-30 (432-12, D-05) the fold is `agent_qa_change_config` and the hook is written in the call, with the files it changed on the answer.",
-      "v1Name": "agent_qa_create_hook",
-      "v2Tool": "agent_qa_change_config"
-    },
-    {
-      "arm": "retired",
-      "note": "not-a-gap (397, 2026-08-16): a suite is a committed file the authoring funnel writes. A blind create is the v1 write the verified authoring funnel replaced (re-spelled 2026-10-02, 432-40, D-06: the funnel writes in the call).",
-      "route": "`agent_qa_write_test` names the suite file a draft joins and writes it in the call, unless a keep-gate rejected the draft.",
-      "v1Name": "agent_qa_create_suite"
-    },
-    {
-      "arm": "renamed-to",
-      "note": "projected by 396 (inventory row 10, 2026-08-16): `authoring.draft.write` is workflow-coarse and verifies a draft rather than performing v1's blind write, so the input shape differs. Since 2026-10-02 (432-40, D-06) it writes the test file in the call unless a keep-gate rejected the draft.",
-      "v1Name": "agent_qa_create_test",
-      "v2Tool": "agent_qa_write_test"
-    },
-    {
-      "arm": "retired",
-      "note": "not-a-gap (397, 2026-08-16): row 12's MCPS-02 rule.",
-      "route": "removing a hook is an edit to the hooks file that a person makes and reviews.",
-      "v1Name": "agent_qa_delete_hook"
-    },
-    {
-      "arm": "retired",
-      "note": "not-a-gap (397, 2026-08-16): row 12's MCPS-02 rule, applied to the file rather than the record.",
-      "route": "removing a suite file is a repository edit a person makes and reviews; no surface door exists.",
-      "v1Name": "agent_qa_delete_suite"
-    },
-    {
-      "arm": "retired",
-      "note": "not-a-gap (397, 2026-08-16): a rule, not an absence. MCPS-02 forbids a surface delete verb for irreversible deletes.",
-      "route": "removing a committed test is a repository edit a person makes and reviews; no surface has a delete door and none is coming.",
-      "v1Name": "agent_qa_delete_test"
-    },
-    {
-      "arm": "retired",
-      "note": "not-a-gap (397, 2026-08-16): the protocol answers discovery itself, so a hand-written catalogue tool beside it would be a second, drifting answer to one question.",
-      "route": "`tools/list` (plus SEP-2575 `server/discover`) answers machine discovery; 398's build-time capability catalog, carried by `agent-qa init --agent`, answers the human-facing version.",
-      "v1Name": "agent_qa_discover"
-    },
-    {
-      "arm": "renamed-to",
-      "note": "projected by 396 (inventory row 26, 2026-08-16): the SAME op as row 25 at suite scope, which is why D-01 allows one tool over both.",
-      "v1Name": "agent_qa_enqueue_suite_run",
-      "v2Tool": "agent_qa_start_run"
-    },
-    {
-      "arm": "renamed-to",
-      "note": "projected by 396 (inventory row 25, 2026-08-16): `runs.start` is workflow-coarse, and the test scope is an argument rather than a tool of its own.",
-      "v1Name": "agent_qa_enqueue_test_run",
-      "v2Tool": "agent_qa_start_run"
-    },
-    {
-      "arm": "retired",
-      "note": "not-a-gap (397, 2026-08-16): died with the CRUD model. Minting a canonical id on a surface is what 394-11 removed from the CLI, for this same reason.",
-      "route": "ids are minted host-side where the entity is written; a caller names what it wants and reads the id back off the entity card `agent_qa_get_entity` returns.",
-      "v1Name": "agent_qa_generate_id"
-    },
-    {
-      "arm": "retired",
-      "note": "A4 adjudication (2026-08-17, phase 398 plan 02): the inventory rules this row `n/a -> projected by 396`, but `config.get` is in UNPROJECTED_OPS after 396 plan 04 — not a mid-flight workflow read per D-02 — so there is no live tool to rename to.",
-      "route": "no MCP tool reads configuration; the workspace posture an agent needs reaches it through `agent-qa init --agent`'s manifest (398 D-16), by env-ref name and never by value.",
-      "v1Name": "agent_qa_get_config"
-    },
-    {
-      "arm": "retired",
-      "note": "A4 adjudication (2026-08-17, phase 398 plan 02): the inventory rules this row `n/a -> projected by 396`, but `runs.get` is in UNPROJECTED_OPS after 396 plan 04 — not a mid-flight workflow read per D-02 — so there is no live tool to rename to.",
-      "route": "the entity door renders a run's card: `agent_qa_get_entity` on the run reference. `agent_qa_list_runs` enumerates recent runs.",
-      "v1Name": "agent_qa_get_run"
-    },
-    {
-      "arm": "pending",
-      "note": "gap (397, 2026-08-16): artifact bytes over a tool result is a disclosure surface nobody has scoped, so the read is routed WITH that scoping rather than minted without it — an artifact read without it is the gap made worse.",
-      "owner": "M5 (artifact resolution route)",
-      "route": "until the owning milestone ships artifact resolution, artifacts are read from the run directory on disk; `agent_qa_get_run_digest` names what a run produced.",
-      "v1Name": "agent_qa_get_run_artifact"
-    },
-    {
-      "arm": "retired",
-      "note": "A4 adjudication (2026-08-17, phase 398 plan 02): row 29's reading — `runs.events` is unprojected, so the second logs alias has no live tool either.",
-      "route": "`agent_qa_get_run_digest` for triage; execution logs live in the run's artifacts on disk.",
-      "v1Name": "agent_qa_get_run_execution_logs"
-    },
-    {
-      "arm": "retired",
-      "note": "A4 adjudication (2026-08-17, phase 398 plan 02): ruled `n/a -> projected by 396` against `runs.events`, which is in UNPROJECTED_OPS as a stream op with no single-round-trip shape.",
-      "route": "`agent_qa_get_run_digest` carries the triage-relevant remainder of a run; the full event feed is read from the run artifacts on disk, not over this surface.",
-      "v1Name": "agent_qa_get_run_logs"
-    },
-    {
-      "arm": "retired",
-      "note": "A4 adjudication (2026-08-17, phase 398 plan 02): ruled `n/a -> projected by 396` against `runs.get`/`runs.events`, both of which are in UNPROJECTED_OPS — `runs.events` is a stream op besides, and a `tools/call` is one round trip with no shape for a resumable feed.",
-      "route": "`agent_qa_get_run_digest` carries what triage needs from a run, including its steps' outcome; the run's card comes from `agent_qa_get_entity`.",
-      "v1Name": "agent_qa_get_run_steps"
-    },
-    {
-      "arm": "pending",
-      "note": "gap (397, 2026-08-16, corrected the same day): the 396 reason overstated `config.get`, which projects the resolved CONFIG's leaves; hook definitions live in the separate `workspace.hooksFile`, so no registered op reads them today.",
-      "owner": "M7 (skills layer)",
-      "route": "until the owning milestone re-opens the hook execution model, hooks are read from `workspace.hooksFile` in the workspace; no tool enumerates them.",
-      "v1Name": "agent_qa_list_hooks"
-    },
-    {
-      "arm": "pending",
-      "note": "gap (397, 2026-08-16): folded into row 7's verb — enumerating the corpus answers \"which tests exist, and in which files\". A suite is a file, so this is not a second registry.",
-      "owner": "M5 (live view & run invocation)",
-      "route": "until `entities.list` lands, suite membership is read from the workspace files themselves; the TST records inside them resolve through `agent_qa_get_entity`.",
-      "v1Name": "agent_qa_list_suites"
-    },
-    {
-      "arm": "pending",
-      "note": "gap (397, 2026-08-16): nothing in the registry enumerates the test corpus — `entities.resolve` resolves a reference to an entity, which is a different question.",
-      "owner": "M5 (live view & run invocation)",
-      "route": "until the owning milestone mints `entities.list`, a known reference resolves through `agent_qa_get_entity`; enumeration has no tool.",
-      "v1Name": "agent_qa_list_tests"
-    },
-    {
-      "arm": "pending",
-      "note": "gap (397, 2026-08-16): with row 19, ONE hook-read verb and not two. What `config.get` shows is `workspace.hooksFile` — the path, not the hooks.",
-      "owner": "M7 (skills layer)",
-      "route": "until that verb lands, a single hook is read from the hooks file itself; no tool projects it.",
-      "v1Name": "agent_qa_read_hook"
-    },
-    {
-      "arm": "retired",
-      "note": "not-a-gap (397, 2026-08-16): there is no suite RECORD to read. `ENTITY_KINDS` has no suite kind and a suite is a committed file addressed by workspace path.",
-      "route": "the TST records inside a suite are `agent_qa_get_entity`'s job; the file itself is read from the workspace.",
-      "v1Name": "agent_qa_read_suite"
-    },
-    {
-      "arm": "renamed-to",
-      "note": "projected by 396 (inventory row 8, 2026-08-16): `entities.get` is D-02's universal entity read, kind TST, behind the one read door.",
-      "v1Name": "agent_qa_read_test",
-      "v2Tool": "agent_qa_get_entity"
-    },
-    {
-      "arm": "retired",
-      "note": "not-a-gap (397, 2026-08-16): a hook's whole contract is \"runs at this lifecycle point\". Invoking one by name from a surface is arbitrary script execution decoupled from the lifecycle that gives it meaning — the private-power shape M4 abolished.",
-      "route": "hooks run at their declared lifecycle points during a run started by `agent_qa_start_run`; nothing invokes one out of band.",
-      "v1Name": "agent_qa_run_hook"
-    },
-    {
-      "arm": "retired",
-      "note": "not-a-gap (397, 2026-08-16): a served COPY of a contract is exactly the drift that advertising the live contract replaced.",
-      "route": "every tool advertises its op's live `inputSchema`/`outputSchema` in `tools/list` (396 D-16), so a caller reads the contract the gate actually validates with; a fold lists its arms' fields as one object, and its `action` field says which fields each action takes.",
-      "v1Name": "agent_qa_schema_reference"
-    },
-    {
-      "arm": "pending",
-      "note": "gap (397, 2026-08-16): `config.field.set` reaches any schema-addressable CONFIG path and the hooks file is not one, so an existing hook has no edit verb. Minting one now would pin an edit shape to a contract the owning milestone revisits.",
-      "owner": "M7 (skills layer)",
-      "route": "adding a hook goes through `agent_qa_change_config`; editing an existing one is a hooks-file edit a person makes until the owner rules on the verb.",
-      "v1Name": "agent_qa_update_hook"
-    },
-    {
-      "arm": "retired",
-      "note": "not-a-gap (397, 2026-08-16): row 16's ruling, through the edit arm instead of the write (re-spelled 2026-10-02, 432-40, D-06: the edit lands in the call).",
-      "route": "`agent_qa_refine_test` edits the written test; the suite file changes in the call.",
-      "v1Name": "agent_qa_update_suite"
-    },
-    {
-      "arm": "renamed-to",
-      "note": "projected by 396 (inventory row 11, 2026-08-16): `authoring.draft.edit` is the edit arm of the refine fold, selected by the fold discriminant.",
-      "v1Name": "agent_qa_update_test",
-      "v2Tool": "agent_qa_refine_test"
-    },
-    {
-      "arm": "retired",
-      "note": "not-a-gap (397, 2026-08-16): a standalone linter over arbitrary text is a second validator that can disagree with the one that gates writes.",
-      "route": "validation reaches a caller as `authoring.draft.verify`'s verdict inside the authoring funnel — the verify arm of `agent_qa_refine_test`.",
-      "v1Name": "agent_qa_validate_definition"
-    },
-    {
-      "arm": "retired",
-      "note": "not-a-gap (397, 2026-08-16): died with the CRUD model. A standalone validator would be a second answer to a question already answered at every parse point.",
-      "route": "the one URI codec (`packages/schema/src/entity/uri.ts`) validates every `agentqa://` reference as it is parsed, including the one `agent_qa_get_entity` resolves.",
-      "v1Name": "agent_qa_validate_id"
-    },
-    {
-      "arm": "retired",
-      "note": "not-a-gap (397, 2026-08-16): row 4's ruling — one validator, inside the funnel.",
-      "route": "the verify arm of `agent_qa_refine_test` validates the draft that joins the suite file.",
-      "v1Name": "agent_qa_validate_suite"
-    },
-    {
-      "arm": "retired",
-      "note": "not-a-gap (397, 2026-08-16): row 4's ruling. `authoring.draft.verify` is the only validator, and it validates a draft in the funnel rather than arbitrary text a caller pasted.",
-      "route": "the verify arm of `agent_qa_refine_test` returns the same verdict that gates the write.",
-      "v1Name": "agent_qa_validate_test"
-    }
-  ],
   "rowCount": 52,
   "rows": [
     {
@@ -242,7 +31,7 @@
     {
       "alias": "status",
       "description": "List completed runs, newest finished first (20 by default, at most 200), each naming its tests; filter by verdict, test id or title, recorded target, or completion time.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "kind": "alias",
       "targetOpId": "runs.list"
@@ -250,14 +39,14 @@
     {
       "alias": "test-ref",
       "description": "Resolve any entity reference to a card, a disambiguation set, or an honest miss.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "kind": "alias",
       "targetOpId": "entities.resolve"
     },
     {
       "description": "The chat entry point: begin ONE new conversational turn from outside a conversation. Surfaces (a REPL, the ask verb, an MCP client) call this to START a turn — it is not a way to carry out a request while a turn is already running. It routes the utterance, executes what it resolves to, and answers with per-clause receipts.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -289,7 +78,7 @@
     },
     {
       "description": "Answer a question about what this product can do by citing the capability catalog, or say plainly that the catalog does not ground an answer.",
-      "docAbsentReason": "no shipped page documents this capability (dated 2026-08-17, 398 D-07). It is the op whose abstention log IS the demand signal for writing docs, so a guessed link here would be the invention the whole feature refuses.",
+      "docAbsentReason": "No shipped page documents this capability. It is the op whose abstention log is the demand signal for writing docs, so a guessed link here would be the invention the feature refuses.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -347,7 +136,7 @@
     },
     {
       "description": "Apply a requested change to an existing test and write it, answering the diff it applied.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -384,7 +173,7 @@
     },
     {
       "description": "Evaluate a draft test against the four keep-gates and return its receipt.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -427,7 +216,7 @@
     },
     {
       "description": "Author a test for an intent, verify it against the keep-gates, and return its receipt.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -490,7 +279,7 @@
     },
     {
       "description": "Report the authoring funnel for a window — built, passed stably, added value, write-eligible — and flag a keep rate above the ceiling as the loop failing to filter.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -574,7 +363,7 @@
     },
     {
       "description": "Declare an auth plugin for a configured target by package NAME, written in this call.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -613,7 +402,7 @@
     },
     {
       "description": "Set one configuration field, written in this call.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -653,7 +442,7 @@
     },
     {
       "description": "Read the resolved project configuration with secret-bearing values masked.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {}
@@ -673,7 +462,7 @@
     },
     {
       "description": "Declare a hook in the hooks file, written in this call.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -728,7 +517,7 @@
     },
     {
       "description": "Configure this project for a site from zero — config, hooks and gitignore, written in this call.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -759,7 +548,7 @@
     },
     {
       "description": "Add a web target to the registry, written in this call.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -810,7 +599,7 @@
     },
     {
       "description": "Change a configured target's URL, written in this call.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -853,7 +642,7 @@
     },
     {
       "description": "Mint a short-lived, view-scoped live-view URL for one live editor session.",
-      "docAbsentReason": "no shipped page documents the editor mint (dated 2026-09-25, 428 D-07); a person meets it through Test → Live on the dashboard, which is the only door that dispatches it.",
+      "docAbsentReason": "No shipped page documents the editor mint; a person meets it through Test → Live on the dashboard, which is the only door that dispatches it.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -883,7 +672,7 @@
     },
     {
       "description": "Render the entity card for one exact short-ID or agentqa:// URI.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -914,7 +703,7 @@
     },
     {
       "description": "Resolve any entity reference to a card, a disambiguation set, or an honest miss.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -945,7 +734,7 @@
     },
     {
       "description": "Accept a knowledge candidate, applying the change in the call.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -1020,7 +809,7 @@
     },
     {
       "description": "Explain why a served brief said what it said, from the trace written at serve time.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -1066,7 +855,7 @@
     },
     {
       "description": "List the committed knowledge bundles with their derived trust state.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {}
@@ -1087,7 +876,7 @@
     },
     {
       "description": "Forget a knowledge record or bundle, tombstoning it in the call.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -1161,8 +950,8 @@
       ]
     },
     {
-      "description": "Read a knowledge record’s gate history, standing receipts and current promotion verdict.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "description": "Read a knowledge record’s mark and approval receipts, promotion lines and live promotion verdict.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -1193,7 +982,7 @@
     },
     {
       "description": "Show one committed knowledge record with its provenance.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -1224,7 +1013,7 @@
     },
     {
       "description": "List every committed knowledge record change since a build ordinal.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -1256,7 +1045,7 @@
     },
     {
       "description": "Inspect committed knowledge records through a closed structural filter.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -1328,7 +1117,7 @@
     },
     {
       "description": "Reject a knowledge candidate with a reason, applying the change in the call.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -1409,7 +1198,7 @@
     },
     {
       "description": "Quarantine one test by hand, renewing and claiming an existing entry.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -1459,7 +1248,7 @@
     },
     {
       "description": "List every quarantined test with its owner, expiry and lifecycle state.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {}
@@ -1479,7 +1268,7 @@
     },
     {
       "description": "Release one test from quarantine — the manual half of the exit path.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -1521,10 +1310,10 @@
     },
     {
       "description": "Read one run's content-addressed evidence blob by its sha, with a sniffed content type.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": null,
-      "exampleCallAbsentReason": "D-08 (dated 2026-08-17): no example call is derivable for runs.artifact — params.sha constrains its value with the regular expression /^[0-9a-f]{64}$/, and a placeholder cannot be SHOWN to satisfy an arbitrary pattern — an example the shipped contract would reject teaches a caller a shape this product does not have. The explicit absence is the honest state; an example an agent copies and is refused for is worse than a column that says there is none.",
+      "exampleCallAbsentReason": "No example call is derivable for runs.artifact: params.sha constrains its value with the regular expression /^[0-9a-f]{64}$/, and a placeholder cannot be SHOWN to satisfy an arbitrary pattern — an example the shipped contract would reject teaches a caller a shape this product does not have. An example an agent copies and is refused for is worse than a column that says there is none.",
       "id": "runs.artifact",
       "kind": "op",
       "mcpTool": "agent_qa_get_run_evidence",
@@ -1572,7 +1361,7 @@
     },
     {
       "description": "Read one run's durable members, steps and sub-actions as the dashboard projected them.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -1630,7 +1419,7 @@
     },
     {
       "description": "Stream one run's recorded events in seq order, resuming after lastEventId.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -1664,7 +1453,7 @@
     },
     {
       "description": "Read validated evidence recorded on one run step or ARIA sub-action.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -1725,7 +1514,7 @@
     },
     {
       "description": "Read one completed run in full, including its member-test outcomes.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -1754,7 +1543,7 @@
     },
     {
       "description": "Project one run's used brief channels, serve-time traces, procedure use, recorded retrieval rung and curator deltas from its handoff.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -1784,7 +1573,7 @@
     },
     {
       "description": "List completed runs, newest finished first (20 by default, at most 200), each naming its tests; filter by verdict, test id or title, recorded target, or completion time.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {}
@@ -1832,7 +1621,7 @@
     },
     {
       "description": "Mint a short-lived, view-scoped live-view URL for one handle of a running run.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -1865,8 +1654,8 @@
       ]
     },
     {
-      "description": "Mark a run or step false-fail / false-pass / confirmed-bug: freeze the marked decision as gold, triage, and apply the fix (a knowledge change or a test edit) in the call.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "description": "Mark a run or step false-fail / false-pass / confirmed-bug: triage it and apply the fix (a knowledge change or a test edit) in the call.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -1881,23 +1670,6 @@
         "$schema": "https://json-schema.org/draft/2020-12/schema",
         "additionalProperties": false,
         "properties": {
-          "correctedAction": {
-            "additionalProperties": {},
-            "properties": {
-              "type": {
-                "minLength": 1,
-                "type": "string"
-              }
-            },
-            "required": [
-              "type"
-            ],
-            "type": "object"
-          },
-          "correctedExpectation": {
-            "maxLength": 2000,
-            "type": "string"
-          },
           "kind": {
             "enum": [
               "false-fail",
@@ -1935,8 +1707,8 @@
       ]
     },
     {
-      "description": "Preview what runs.mark would do for this exact input: its refusals, resolved step, labels, the knowledge records it reaches with their content and evidence effects, and the fix it would apply, without writing.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "description": "Preview what runs.mark would do for this exact input: its refusals, resolved step, the knowledge records it reaches with their content and evidence effects, and the fix it would apply, without writing.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -1951,23 +1723,6 @@
         "$schema": "https://json-schema.org/draft/2020-12/schema",
         "additionalProperties": false,
         "properties": {
-          "correctedAction": {
-            "additionalProperties": {},
-            "properties": {
-              "type": {
-                "minLength": 1,
-                "type": "string"
-              }
-            },
-            "required": [
-              "type"
-            ],
-            "type": "object"
-          },
-          "correctedExpectation": {
-            "maxLength": 2000,
-            "type": "string"
-          },
           "kind": {
             "enum": [
               "false-fail",
@@ -2006,7 +1761,7 @@
     },
     {
       "description": "Read every mark on a run in ordinal order with supersession and what each applied fix changed.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -2036,7 +1791,7 @@
     },
     {
       "description": "Map one completed run: its tests and steps with verdicts, and the address of everything recorded at each, without bodies, traces or bytes.",
-      "docAbsentReason": "D-07 (dated 2026-08-16): no canonical doc ships for this capability yet. The explicit absence is the honest state — a guessed path would existence-check green and mislead a reader — and the abstention coverage log is the demand signal for writing one.",
+      "docAbsentReason": "No canonical doc ships for this capability yet. A guessed path would pass the existence check and mislead a reader, and the abstention coverage log is the demand signal for writing one.",
       "docPath": null,
       "exampleCall": {
         "arguments": {
@@ -2112,15 +1867,6 @@
             "const": true,
             "type": "boolean"
           },
-          "executionContext": {
-            "enum": [
-              "local-interactive",
-              "local-headless",
-              "ci",
-              "cloud"
-            ],
-            "type": "string"
-          },
           "gateRun": {
             "const": true,
             "type": "boolean"
@@ -2133,28 +1879,6 @@
           },
           "runId": {
             "type": "string"
-          },
-          "scope": {
-            "additionalProperties": false,
-            "properties": {
-              "key": {
-                "type": "string"
-              },
-              "tier": {
-                "enum": [
-                  "global",
-                  "product",
-                  "suite",
-                  "test"
-                ],
-                "type": "string"
-              }
-            },
-            "required": [
-              "tier",
-              "key"
-            ],
-            "type": "object"
           }
         },
         "type": "object"
@@ -2193,5 +1917,5 @@
       "shortDescription": "Triage agent-qa run failures"
     }
   ],
-  "rowsDigest": "02b98e4022fd087c9404069c9bcde2f37bf2e07c1742c4b3f3b036d9d48b9818"
+  "rowsDigest": "969c837ed9da12e271ef0dec7dfaff6a0d9adbadf829be300a5c081a998cc97d"
 }