scip-query 0.19.4 → 0.19.5

package/dist/direct-navigation-DUCZCTOE.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import{q as a}from"./chunk-XAGAZSFE.js";import"./chunk-7UY7SD7D.js";export{a as directNavigationQueryCommandDescriptors};
+//# sourceMappingURL=direct-navigation-DUCZCTOE.js.map

package/docs/AI_FAILURE_MODES.md

@@ -301,7 +301,7 @@ scip-query setup-agent --git-hook    # pre-commit backstop: fires whoever wrote
 | `co-change-partner` | Historically coupled files that usually change together but are missing from this diff. | Default diff gate. |
 | `twin-partner` | A changed symbol has a same-(near-)name twin (identical or already-divergent) elsewhere that this diff left untouched. | Default diff gate. Advisory: findings print but never cause a nonzero exit by themselves. |
 | `coverage-contract` | A configured `coverageContracts` entry (.scipquery.json) drifted: its declared key set no longer matches its ground-truth source. | Default diff gate, only when either side of a configured contract changed. |
-| `architecture` | A declared architecture boundary rule has a violation absent from the committed health baseline. | Default diff gate when closed dependency rows, requireCompletePolicy, requireAcyclic, requireResolvedBoundaries, requireMinimalPolicy, maxBoundaryFanOut, global maxBoundaryFiles, per-boundary maxFiles, or testPaths are configured and a baseline exists. |
+| `architecture` | A declared architecture boundary rule has a violation absent from the committed health baseline. | Default diff gate when closed dependency rows, requireCompletePolicy, requireAcyclic, requireResolvedBoundaries, requireMinimalPolicy, maxBoundaryFanOut/maxBoundaryFiles, or testPaths are configured and a baseline exists. |
 | `doc-reference` | Docs that cite changed files and may need a matching update. Dated snapshot docs (docs.snapshotPaths) are excluded by policy. | Default diff gate. Advisory (21.2) for bare file-mention citations; blocking when the citation has a line anchor or the cited file was deleted/renamed. |
 | `unused-params` | Fresh trailing parameters or options that no changed body uses. | Default diff gate. |
 | `new-dead` | Changed production symbols with zero indexed consumers. | Default diff gate. |

package/docs/COMMAND_REFERENCE.md

@@ -24,11 +24,11 @@ This syntax summary is generated from the CLI command descriptors. Keep workflow
 |---|---|---|
 | `files <pattern>` | Find files matching a pattern | `--json` |
 | `methods <className>` | List methods of a class (with line ranges) | `--json` |
-| `refs <symbol>` | Find all files referencing a symbol | `--full`<br>`--json` |
-| `trace <symbol>` | Trace a symbol: definition + all references | `--full`<br>`--json` |
+| `refs <symbol>` | Find all files referencing a symbol | `--full`<br>`-n, --limit <n>`<br>`--cursor <cursor>`<br>`--json`<br>`--compact` |
+| `trace <symbol>` | Trace a symbol: definition + all references | `--full`<br>`--compact`<br>`--json` |
 | `deps <file>` | Files this file depends on (internal) | `--json` |
 | `rdeps <file>` | Files that depend on this file/module | `--json` |
-| `system <module>` | Full module map: files, symbols, deps in/out | `--json` |
+| `system <module>` | Full module map: files, symbols, deps in/out | `--compact`<br>`--json` |
 | `surface <module>` | What symbols consumers actually use from this module | `--json` |
 | `imports <file>` | What symbols does this file import? | `--full`<br>`--json` |
 | `imported-by <symbol>` | Which files import this symbol? | `--json` |
@@ -100,7 +100,7 @@ This syntax summary is generated from the CLI command descriptors. Keep workflow
 | `affected <symbol>` | Transitive closure of symbols that could break if this symbol changes | `--max-depth <n>`<br>`-s, --scope <path>`<br>`--json` |
 | `change-surface <file>` | Pre-change briefing: exports, consumers, and blast-radius risk | `--full`<br>`--json` |
 | `co-change [file]` | Files that change together in git history without a dependency edge — hidden coupling candidates | `--min-together <n>`<br>`-n, --limit <n>`<br>`--all`<br>`--full`<br>`--json` |
-| `diff-gate` | Gate the current diff: architecture regressions plus echo, migration, coordination, doc-drift, unused-param, and new-dead candidates; exit 1 on blocking findings | `--base <ref>`<br>`--min-together <n>`<br>`--max-echo-checks <n>`<br>`--max-helpers <n>`<br>`--baseline`<br>`--full`<br>`--skip <check>`<br>`--hook`<br>`--json` |
+| `diff-gate` | Gate the current diff: architecture regressions plus echo, migration, coordination, doc-drift, unused-param, and new-dead candidates; exit 1 on blocking findings | `--base <ref>`<br>`--min-together <n>`<br>`--max-echo-checks <n>`<br>`--max-helpers <n>`<br>`--baseline`<br>`--full`<br>`--skip <check>`<br>`--hook`<br>`--json`<br>`--compact` |
 | `incomplete-migration` | Partially-completed extraction candidates: new helpers in the diff wired into some sites while similar un-migrated sites remain | `--base <ref>`<br>`--min-containment <n>`<br>`--max-helpers <n>`<br>`-n, --limit <n>`<br>`--full`<br>`--json` |
 | `diff-impact` | Compute changed symbols and downstream consumers from current git diff | `--base <ref>`<br>`--json` |
 
@@ -114,7 +114,7 @@ This syntax summary is generated from the CLI command descriptors. Keep workflow
 
 | Command | Description | Options |
 |---|---|---|
-| `plan-context <target>` | Pre-edit planning context for a symbol, file, or module | `--impact-depth <n>`<br>`--slice-depth <n>`<br>`-s, --scope <path>`<br>`-n, --limit <n>`<br>`--full`<br>`--json` |
+| `plan-context <target>` | Pre-edit planning context for a symbol, file, or module | `--impact-depth <n>`<br>`--slice-depth <n>`<br>`-s, --scope <path>`<br>`-n, --limit <n>`<br>`--full`<br>`--json`<br>`--compact` |
 
 ### Health
 

package/docs/DETECTOR_GUIDE.md

@@ -92,7 +92,7 @@ coverage, reciprocity, and connected-group signals.
 | `co-change-partner` | Historically coupled files that usually change together but are missing from this diff. | Default diff gate. |
 | `twin-partner` | A changed symbol has a same-(near-)name twin (identical or already-divergent) elsewhere that this diff left untouched. | Default diff gate. Advisory: findings print but never cause a nonzero exit by themselves. |
 | `coverage-contract` | A configured `coverageContracts` entry (.scipquery.json) drifted: its declared key set no longer matches its ground-truth source. | Default diff gate, only when either side of a configured contract changed. |
-| `architecture` | A declared architecture boundary rule has a violation absent from the committed health baseline. | Default diff gate when closed dependency rows, requireCompletePolicy, requireAcyclic, requireResolvedBoundaries, requireMinimalPolicy, maxBoundaryFanOut, global maxBoundaryFiles, per-boundary maxFiles, or testPaths are configured and a baseline exists. |
+| `architecture` | A declared architecture boundary rule has a violation absent from the committed health baseline. | Default diff gate when closed dependency rows, requireCompletePolicy, requireAcyclic, requireResolvedBoundaries, requireMinimalPolicy, maxBoundaryFanOut/maxBoundaryFiles, or testPaths are configured and a baseline exists. |
 | `doc-reference` | Docs that cite changed files and may need a matching update. Dated snapshot docs (docs.snapshotPaths) are excluded by policy. | Default diff gate. Advisory (21.2) for bare file-mention citations; blocking when the citation has a line anchor or the cited file was deleted/renamed. |
 | `unused-params` | Fresh trailing parameters or options that no changed body uses. | Default diff gate. |
 | `new-dead` | Changed production symbols with zero indexed consumers. | Default diff gate. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scip-query",
-  "version": "0.19.4",
+  "version": "0.19.5",
   "description": "Evidence and verification for AI coding agents: map code, reuse concepts, finish migrations, and gate diffs.",
   "type": "module",
   "main": "dist/index.js",

package/skills/_shared/SKILL.md

@@ -26,7 +26,7 @@ If freshness is `fresh`, continue. If it is `stale`, `missing`, or `unknown`, ru
 scip-query reindex
 ```
 
-Every file path, line number, symbol relationship, and behavior claim in a plan, report, or review must cite the command that produced it. If `scip-query` cannot answer a question because the target is not indexed, say so and use the narrowest other evidence available.
+Match evidence to the claim. Native search and file reads establish literal text, exact local source, and unambiguous local logic. Use scip-query for compiler-resolved identity and whenever you claim a relationship set is complete — definitions, references, callers, dependencies, consumers, affected units, or public surface. State when a bounded result does not establish completeness.
 
 ## Lookup
 
@@ -216,19 +216,7 @@ measured precision, not by volume:
 
 ## Postchecks
 
-Run the rows that match the actual edit:
-
-| Change made                                                                                             | Check                                                                                                                                                       |
-| ------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Extracted a helper or abstraction                                                                       | `scip-query incomplete-migration --json --full`                                                                                                             |
-| Added a helper, module, component, hook, composable, or adapter                                         | `scip-query similar <symbol> --json --full` and `scip-query recent-duplicates --json --full`                                                                |
-| Added parameters, options, props, config flags, or broad option objects                                 | `scip-query unused-params --json --full`                                                                                                                    |
-| Added a wrapper, facade, forwarding layer, alias, or re-export                                          | `scip-query wrapper-candidates --json --full`, `scip-query passthrough-candidates --json --full`, and `scip-query redundant-reexports` when exports changed |
-| Added an interface, base class, adapter contract, or type alias                                         | `scip-query stale-abstractions --json --full`                                                                                                               |
-| Changed schema, config, generated files, public contracts, command descriptors, or docs-backed behavior | `scip-query co-change <file> --json --full` and `scip-query doc-drift --json --full`                                                                        |
-| Deleted code                                                                                            | `scip-query cleanup-plan --verify --json`                                                                                                                   |
-| Changed React components or hooks                                                                       | the React frontend commands above                                                                                                                           |
-| Changed Vue SFCs or composables                                                                         | the Vue frontend commands above                                                                                                                             |
+The authoritative edit-to-postcheck table lives in [`../scip-verify/SKILL.md`](../scip-verify/SKILL.md). Invoke that skill after editing; do not maintain a second copy here.
 
 Every implemented change ends with:
 
@@ -244,7 +232,9 @@ Fix findings or record a specific acceptance reason. Do not report success while
 When a subagent is used for scip-query evidence, include these rules in its prompt:
 
 ```text
-Use scip-query for all code references. Do not use grep, rg, cat, or file reads as evidence for code behavior. Every file path, line number, and behavioral claim must cite the exact scip-query command that produced it. If scip-query cannot verify a claim, say so.
+Use scip-query for compiler-resolved identity and for completeness claims. Native search and file reads are valid evidence for literal source content and local logic, including an unambiguous helper you can see in the same file. Use scip-query when you assert which symbol something resolves to, or that a set is complete — definitions, references, callers, dependencies, consumers, or affected units. Cite the evidence source appropriate to each claim, and say so when neither source establishes it completely.
 ```
 
-Reject subagent findings that cite text search or raw file reads as code evidence when graph facts were required.
+The trigger is resolution or completeness, not whether execution crosses a call boundary. Asserting what `handler(x)` does without resolving `handler` is a resolution claim; reading a helper defined two lines down is not.
+
+Reject subagent findings that source a resolution or completeness claim from text search. Do not reject a literal-content claim for citing a file read.

package/skills/scip-api-impact/SKILL.md

@@ -1,19 +1,19 @@
 ---
 name: scip-api-impact
-description: Assess API impact with scip-query evidence. Use before changing public exports, module boundaries, schemas, routes, CLI commands, config fields, generated artifacts, signatures, docs-backed behavior, or consumer migrations.
+description: Answer "what will break if I change this?" before editing an API, export, module boundary, schema, route, CLI command, config field, generated artifact, signature, documented behavior, or consumer migration.
 commands:
-  - template: "scip-query surface <module-or-package>"
-    when: "Identify the surface: what consumers actually use from the module."
-  - template: "scip-query refs <symbol>"
-    when: "Find consumers: every direct reference to the surface symbol."
-  - template: "scip-query affected <symbol> --json"
-    when: "Find consumers: transitive blast radius of the change."
-  - template: "scip-query co-change <file> --json --full"
-    when: "Find hidden partners: historically coupled files without a dependency edge."
-  - template: "scip-query doc-drift --json --full"
-    when: "Find hidden partners: docs that describe the surface and may need an update."
-  - template: "scip-query unused-params --json --full"
-    when: "Choose migration shape: reject speculative new parameters."
+  - template: 'scip-query surface <module-or-package>'
+    when: 'Identify the surface: what consumers actually use from the module.'
+  - template: 'scip-query refs <symbol>'
+    when: 'Find consumers: every direct reference to the surface symbol.'
+  - template: 'scip-query affected <symbol> --json'
+    when: 'Find consumers: transitive blast radius of the change.'
+  - template: 'scip-query co-change <file> --json --full'
+    when: 'Find hidden partners: historically coupled files without a dependency edge.'
+  - template: 'scip-query doc-drift --json --full'
+    when: 'Find hidden partners: docs that describe the surface and may need an update.'
+  - template: 'scip-query unused-params --json --full'
+    when: 'Choose migration shape: reject speculative new parameters.'
 ---
 
 # scip-api-impact
@@ -25,14 +25,14 @@ Load shared mechanics from [`../_shared/SKILL.md`](../_shared/SKILL.md).
 <!-- BEGIN GENERATED SKILL COMMANDS -->
 ## Commands for this skill
 
-| Command | Purpose | When |
-| --- | --- | --- |
-| `scip-query surface <module-or-package>` | What symbols consumers actually use from this module | Identify the surface: what consumers actually use from the module. |
-| `scip-query refs <symbol>` | Find all files referencing a symbol | Find consumers: every direct reference to the surface symbol. |
-| `scip-query affected <symbol> --json` | Transitive closure of symbols that could break if this symbol changes | Find consumers: transitive blast radius of the change. |
-| `scip-query co-change <file> --json --full` | Files that change together in git history without a dependency edge — hidden coupling candidates | Find hidden partners: historically coupled files without a dependency edge. |
-| `scip-query doc-drift --json --full` | Stale-doc candidates: code the doc references or co-changed with kept changing after the doc stopped | Find hidden partners: docs that describe the surface and may need an update. |
-| `scip-query unused-params --json --full` | Speculative-generality candidates: trailing parameters no body ever uses (TS/JS) | Choose migration shape: reject speculative new parameters. |
+| Command | Purpose | Returns | Coverage | When |
+| --- | --- | --- | --- | --- |
+| `scip-query surface <module-or-package>` | What symbols consumers actually use from this module | consumer paths and consumed symbol identities | `complete` | Identify the surface: what consumers actually use from the module. |
+| `scip-query refs <symbol>` | Find all files referencing a symbol | referencing file paths; reference line numbers grouped by file | `bounded` | Find consumers: every direct reference to the surface symbol. |
+| `scip-query affected <symbol> --json` | Transitive closure of symbols that could break if this symbol changes | affected symbol identities, files, and traversal depths | `bounded` | Find consumers: transitive blast radius of the change. |
+| `scip-query co-change <file> --json --full` | Files that change together in git history without a dependency edge — hidden coupling candidates | file pairs, co-change counts, confidence, and history context | `bounded` | Find hidden partners: historically coupled files without a dependency edge. |
+| `scip-query doc-drift --json --full` | Stale-doc candidates: code the doc references or co-changed with kept changing after the doc stopped | document paths, coupled code subjects, and history evidence | `bounded` | Find hidden partners: docs that describe the surface and may need an update. |
+| `scip-query unused-params --json --full` | Speculative-generality candidates: trailing parameters no body ever uses (TS/JS) | candidate parameters with callable and file identities | `bounded` | Choose migration shape: reject speculative new parameters. |
 
 Use this shortlist first. Open [`../_shared/SKILL.md`](../_shared/SKILL.md) only when it is insufficient.
 <!-- END GENERATED SKILL COMMANDS -->
@@ -113,6 +113,7 @@ Consumer dispositions:
 Required co-changes:
 Migration:
 Verification:
+
 - targeted tests
 - `scip-query diff-impact --json`
 - invoke `scip-verify`

package/skills/scip-claim-audit/SKILL.md

@@ -2,16 +2,16 @@
 name: scip-claim-audit
 description: Audit output-facing status claims for evidence with scip-query. Use to classify whether an "available", "verified", "safe", "PASS", or "complete" status word is derived from a real check, hedged as a candidate, or merely asserted without being probed.
 commands:
-  - template: "scip-query files <pattern>"
-    when: "Inventory: locate the renderer or status-producing module for a claim."
-  - template: "scip-query refs <symbol>"
-    when: "Classify: find every producer and consumer of a status-bearing function."
-  - template: "scip-query code <symbol>"
-    when: "Classify: read the producing function to see whether it computes or asserts."
-  - template: "scip-query trace <symbol>"
-    when: "Classify: definition plus every reference for a status field or constant."
-  - template: "scip-query capabilities --matrix --json"
-    when: "Spot-check: an already-known example of a fixed derived-status surface."
+  - template: 'scip-query files <pattern>'
+    when: 'Inventory: locate the renderer or status-producing module for a claim.'
+  - template: 'scip-query refs <symbol>'
+    when: 'Classify: find every producer and consumer of a status-bearing function.'
+  - template: 'scip-query code <symbol>'
+    when: 'Classify: read the producing function to see whether it computes or asserts.'
+  - template: 'scip-query trace <symbol>'
+    when: 'Classify: definition plus every reference for a status field or constant.'
+  - template: 'scip-query capabilities --matrix --json'
+    when: 'Spot-check: an already-known example of a fixed derived-status surface.'
 ---
 
 # scip-claim-audit
@@ -23,13 +23,13 @@ Load shared mechanics from [`../_shared/SKILL.md`](../_shared/SKILL.md).
 <!-- BEGIN GENERATED SKILL COMMANDS -->
 ## Commands for this skill
 
-| Command | Purpose | When |
-| --- | --- | --- |
-| `scip-query files <pattern>` | Find files matching a pattern | Inventory: locate the renderer or status-producing module for a claim. |
-| `scip-query refs <symbol>` | Find all files referencing a symbol | Classify: find every producer and consumer of a status-bearing function. |
-| `scip-query code <symbol>` | Read the source code for a symbol (bounded to its definition range) | Classify: read the producing function to see whether it computes or asserts. |
-| `scip-query trace <symbol>` | Trace a symbol: definition + all references | Classify: definition plus every reference for a status field or constant. |
-| `scip-query capabilities --matrix --json` | Report which evidence and verification capabilities are available in this project | Spot-check: an already-known example of a fixed derived-status surface. |
+| Command | Purpose | Returns | Coverage | When |
+| --- | --- | --- | --- | --- |
+| `scip-query files <pattern>` | Find files matching a pattern | matching file paths | `complete` | Inventory: locate the renderer or status-producing module for a claim. |
+| `scip-query refs <symbol>` | Find all files referencing a symbol | referencing file paths; reference line numbers grouped by file | `bounded` | Classify: find every producer and consumer of a status-bearing function. |
+| `scip-query code <symbol>` | Read the source code for a symbol (bounded to its definition range) | definition identity, source, and line range | `complete` | Classify: read the producing function to see whether it computes or asserts. |
+| `scip-query trace <symbol>` | Trace a symbol: definition + all references | definition sites with source and signature; referencing files with line numbers | `bounded` | Classify: definition plus every reference for a status field or constant. |
+| `scip-query capabilities --matrix --json` | Report which evidence and verification capabilities are available in this project | capability matrix with availability and reasons | `complete` | Spot-check: an already-known example of a fixed derived-status surface. |
 
 Use this shortlist first. Open [`../_shared/SKILL.md`](../_shared/SKILL.md) only when it is insufficient.
 <!-- END GENERATED SKILL COMMANDS -->
@@ -100,6 +100,7 @@ Claim table:
 | --- | --- | --- | --- |
 
 Fixed since last audit:
+
 - <claim> — now derived via <probe>, no longer a finding.
 ```
 

package/skills/scip-cleanup-audit/SKILL.md

@@ -2,18 +2,18 @@
 name: scip-cleanup-audit
 description: Audit and rank scip-query cleanup signals without editing code. Use for health reports, de-bloat reports, recent AI residue audits, score-framed cleanup queues, confirming raw findings, or preparing a cleanup plan.
 commands:
-  - template: "scip-query health --json"
-    when: "Establish evidence: composite score and prioritized action list."
-  - template: "scip-query cleanup-plan --verify --json"
-    when: "Sweep signals: compiler-verified deletion plan, batched."
-  - template: "scip-query duplicate-bodies --json --full"
-    when: "Sweep signals: exact duplicate small-body candidates."
-  - template: "scip-query recent-duplicates --json --full"
-    when: "Sweep signals: recent code that re-implements established code."
-  - template: "scip-query incomplete-migration --json --full"
-    when: "Sweep signals: partially-completed extractions."
-  - template: "scip-query doc-drift --json --full"
-    when: "Sweep signals: stale docs referencing changed code."
+  - template: 'scip-query health --json'
+    when: 'Establish evidence: composite score and prioritized action list.'
+  - template: 'scip-query cleanup-plan --verify --json'
+    when: 'Sweep signals: compiler-verified deletion plan, batched.'
+  - template: 'scip-query duplicate-bodies --json --full'
+    when: 'Sweep signals: exact duplicate small-body candidates.'
+  - template: 'scip-query recent-duplicates --json --full'
+    when: 'Sweep signals: recent code that re-implements established code.'
+  - template: 'scip-query incomplete-migration --json --full'
+    when: 'Sweep signals: partially-completed extractions.'
+  - template: 'scip-query doc-drift --json --full'
+    when: 'Sweep signals: stale docs referencing changed code.'
 ---
 
 # scip-cleanup-audit
@@ -25,14 +25,14 @@ Load shared mechanics from [`../_shared/SKILL.md`](../_shared/SKILL.md).
 <!-- BEGIN GENERATED SKILL COMMANDS -->
 ## Commands for this skill
 
-| Command | Purpose | When |
-| --- | --- | --- |
-| `scip-query health --json` | Composite codebase health report with prioritized action list | Establish evidence: composite score and prioritized action list. |
-| `scip-query cleanup-plan --verify --json` | Ordered, batched deletion plan: graph-fact dead code plus the cascade candidates it unlocks | Sweep signals: compiler-verified deletion plan, batched. |
-| `scip-query duplicate-bodies --json --full` | Find exact duplicate small-body candidates across files | Sweep signals: exact duplicate small-body candidates. |
-| `scip-query recent-duplicates --json --full` | Directional duplicate candidates: recent code that re-implements established callable, React, or Vue code | Sweep signals: recent code that re-implements established code. |
-| `scip-query incomplete-migration --json --full` | Partially-completed extraction candidates: new helpers in the diff wired into some sites while similar un-migrated sites remain | Sweep signals: partially-completed extractions. |
-| `scip-query doc-drift --json --full` | Stale-doc candidates: code the doc references or co-changed with kept changing after the doc stopped | Sweep signals: stale docs referencing changed code. |
+| Command | Purpose | Returns | Coverage | When |
+| --- | --- | --- | --- | --- |
+| `scip-query health --json` | Composite codebase health report with prioritized action list | health score, findings, priorities, baselines, and coverage notes | `bounded` | Establish evidence: composite score and prioritized action list. |
+| `scip-query cleanup-plan --verify --json` | Ordered, batched deletion plan: graph-fact dead code plus the cascade candidates it unlocks | ordered cleanup batches, evidence, and optional verification outcomes | `bounded` | Sweep signals: compiler-verified deletion plan, batched. |
+| `scip-query duplicate-bodies --json --full` | Find exact duplicate small-body candidates across files | callable groups with exact normalized-body identity | `bounded` | Sweep signals: exact duplicate small-body candidates. |
+| `scip-query recent-duplicates --json --full` | Directional duplicate candidates: recent code that re-implements established callable, React, or Vue code | recent and established symbol pairs with similarity evidence | `bounded` | Sweep signals: recent code that re-implements established code. |
+| `scip-query incomplete-migration --json --full` | Partially-completed extraction candidates: new helpers in the diff wired into some sites while similar un-migrated sites remain | new helpers and similar unmigrated call sites | `bounded` | Sweep signals: partially-completed extractions. |
+| `scip-query doc-drift --json --full` | Stale-doc candidates: code the doc references or co-changed with kept changing after the doc stopped | document paths, coupled code subjects, and history evidence | `bounded` | Sweep signals: stale docs referencing changed code. |
 
 Use this shortlist first. Open [`../_shared/SKILL.md`](../_shared/SKILL.md) only when it is insufficient.
 <!-- END GENERATED SKILL COMMANDS -->
@@ -111,15 +111,19 @@ Health score: N/100
 Classification counts: <n> confirmed / <i> intentional / <fp> false positive / <b> blocked (must cover every collected signal)
 
 Confirmed items:
+
 - [priority] finding - evidence - first safe action
 
 Unconfirmed signals:
+
 - signal - evidence still needed
 
 Unavailable or blocked checks:
+
 - check - reason
 
 Recommended first cleanup batch:
+
 - batch - why safe now
 ```
 

package/skills/scip-cleanup-improve/SKILL.md

@@ -2,16 +2,16 @@
 name: scip-cleanup-improve
 description: Improve scip-query health autonomously with verified cleanup. Use when the user asks to fix cleanup findings, raise health, keep cleaning, continue after setup, or work until no safe confirmed cleanup remains.
 commands:
-  - template: "scip-query health --json"
-    when: "Before editing: report current score and remaining signals."
-  - template: "scip-query cleanup-plan --verify --json"
-    when: "Loop: confirm the next compiler-verified deletion batch."
-  - template: "scip-query cleanup-apply --verified --batch <n>"
-    when: "Loop: apply one verified deletion batch."
-  - template: "scip-query duplicate-bodies --json --full"
-    when: "Priority: exact duplicate small-body echoes to consolidate."
-  - template: "scip-query incomplete-migration --json --full"
-    when: "Priority: un-migrated call sites left behind by a new helper."
+  - template: 'scip-query health --json'
+    when: 'Before editing: report current score and remaining signals.'
+  - template: 'scip-query cleanup-plan --verify --json'
+    when: 'Loop: confirm the next compiler-verified deletion batch.'
+  - template: 'scip-query cleanup-apply --verified --batch <n>'
+    when: 'Loop: apply one verified deletion batch.'
+  - template: 'scip-query duplicate-bodies --json --full'
+    when: 'Priority: exact duplicate small-body echoes to consolidate.'
+  - template: 'scip-query incomplete-migration --json --full'
+    when: 'Priority: un-migrated call sites left behind by a new helper.'
 ---
 
 # scip-cleanup-improve
@@ -23,13 +23,13 @@ Load shared mechanics from [`../_shared/SKILL.md`](../_shared/SKILL.md).
 <!-- BEGIN GENERATED SKILL COMMANDS -->
 ## Commands for this skill
 
-| Command | Purpose | When |
-| --- | --- | --- |
-| `scip-query health --json` | Composite codebase health report with prioritized action list | Before editing: report current score and remaining signals. |
-| `scip-query cleanup-plan --verify --json` | Ordered, batched deletion plan: graph-fact dead code plus the cascade candidates it unlocks | Loop: confirm the next compiler-verified deletion batch. |
-| `scip-query cleanup-apply --verified --batch <n>` | Apply a compiler-verified cleanup-plan batch to the working tree | Loop: apply one verified deletion batch. |
-| `scip-query duplicate-bodies --json --full` | Find exact duplicate small-body candidates across files | Priority: exact duplicate small-body echoes to consolidate. |
-| `scip-query incomplete-migration --json --full` | Partially-completed extraction candidates: new helpers in the diff wired into some sites while similar un-migrated sites remain | Priority: un-migrated call sites left behind by a new helper. |
+| Command | Purpose | Returns | Coverage | When |
+| --- | --- | --- | --- | --- |
+| `scip-query health --json` | Composite codebase health report with prioritized action list | health score, findings, priorities, baselines, and coverage notes | `bounded` | Before editing: report current score and remaining signals. |
+| `scip-query cleanup-plan --verify --json` | Ordered, batched deletion plan: graph-fact dead code plus the cascade candidates it unlocks | ordered cleanup batches, evidence, and optional verification outcomes | `bounded` | Loop: confirm the next compiler-verified deletion batch. |
+| `scip-query cleanup-apply --verified --batch <n>` | Apply a compiler-verified cleanup-plan batch to the working tree | applied files, deletions, verification, and refusal reasons | `bounded` | Loop: apply one verified deletion batch. |
+| `scip-query duplicate-bodies --json --full` | Find exact duplicate small-body candidates across files | callable groups with exact normalized-body identity | `bounded` | Priority: exact duplicate small-body echoes to consolidate. |
+| `scip-query incomplete-migration --json --full` | Partially-completed extraction candidates: new helpers in the diff wired into some sites while similar un-migrated sites remain | new helpers and similar unmigrated call sites | `bounded` | Priority: un-migrated call sites left behind by a new helper. |
 
 Use this shortlist first. Open [`../_shared/SKILL.md`](../_shared/SKILL.md) only when it is insufficient.
 <!-- END GENERATED SKILL COMMANDS -->
@@ -59,8 +59,9 @@ Before editing:
 ```markdown
 Health score: N/100
 First confirmed batch:
+
 - finding - evidence - planned fix - verification
-Remaining signals:
+  Remaining signals:
 - signal - status
 ```