scip-query 0.19.8 → 0.20.0

package/skills/scip-diagnose/references/triage.md

@@ -16,12 +16,12 @@ Load shared mechanics from [`../../_shared/SKILL.md`](../../_shared/SKILL.md) on
 | `scip-query code <entry-or-error-symbol>` | Trace the failing path: read the exact source (complete coverage: definition identity, source, line range). For stack traces, read the exact range with `scip-query code 'file:start-end'`. |
 | `scip-query call-graph <entry-symbol>` | Trace the failing path: callers and callees (bounded coverage). |
 | `scip-query dataflow <state-or-input-symbol>` / `scip-query slice <state-or-input-symbol>` | Trace the failing path: data flow and slices from the suspect input or state. |
-| `scip-query similar <suspect-symbol> --json --full` | Compare and bound: nearby implementations for missing handling (bounded coverage: symbol pairs, similarity scores, shared evidence). |
+| `scip-query similar <suspect-symbol> --full` | Compare and bound: nearby implementations for missing handling (bounded coverage: symbol pairs, similarity scores, shared evidence). |
 | `scip-query similar <suspect-symbol> <comparison-symbol> --plan` | Compare and bound: two specific implementations directly. |
-| `scip-query similar-files <suspect-file> --json --full` | Compare and bound: nearby files for missing handling. |
-| `scip-query co-change <suspect-file> --json --full` | Compare and bound: files that historically changed with the suspect file. |
-| `scip-query change-surface <suspect-file> --json --full` | Compare and bound: exports, consumers, and blast-radius risk. |
-| `scip-query affected <suspect-symbol> --json` | Compare and bound: transitive impact bound for the fix plan (bounded coverage). |
+| `scip-query similar-files <suspect-file> --full` | Compare and bound: nearby files for missing handling. |
+| `scip-query co-change <suspect-file> --full` | Compare and bound: files that historically changed with the suspect file. |
+| `scip-query change-surface <suspect-file> --full` | Compare and bound: exports, consumers, and blast-radius risk. |
+| `scip-query affected <suspect-symbol>` | Compare and bound: transitive impact bound for the fix plan (bounded coverage). |
 
 ## Rules
 
@@ -70,12 +70,12 @@ This step is complete only when a suspected root cause is tied to source evidenc
 ### 4. Compare and bound
 
 ```bash
-scip-query similar <suspect-symbol> --json --full
+scip-query similar <suspect-symbol> --full
 scip-query similar <suspect-symbol> <comparison-symbol> --plan
-scip-query similar-files <suspect-file> --json --full
-scip-query co-change <suspect-file> --json --full
-scip-query change-surface <suspect-file> --json --full
-scip-query affected <suspect-symbol> --json
+scip-query similar-files <suspect-file> --full
+scip-query co-change <suspect-file> --full
+scip-query change-surface <suspect-file> --full
+scip-query affected <suspect-symbol>
 ```
 
 This step is complete only when the packet has a narrow test shape and an impact bound.

package/skills/scip-explore/SKILL.md

@@ -6,7 +6,7 @@ commands:
     when: "Orient to a module's files, symbols, dependencies, and consumers."
   - template: "scip-query trace <entry-symbol>"
     when: "Connect an entry symbol to its definition and references."
-  - template: "scip-query affected <symbol> --json"
+  - template: "scip-query affected <symbol>"
     when: "Measure the transitive downstream blast radius of a change."
 ---
 
@@ -21,7 +21,7 @@ Build verified understanding of how a system works end to end — entry points,
 | --- | --- | --- | --- | --- |
 | `scip-query system <module-or-scope>` | Full module map: files, symbols, deps in/out | module file paths; exported symbols with line ranges; internal dependencies; reverse dependencies | `complete` | Orient to a module's files, symbols, dependencies, and consumers. |
 | `scip-query trace <entry-symbol>` | Trace a symbol: definition + all references | definition sites with source and signature; referencing files with line numbers | `bounded` | Connect an entry symbol to its definition and references. |
-| `scip-query affected <symbol> --json` | Transitive closure of symbols that could break if this symbol changes | affected symbol identities, files, and traversal depths | `bounded` | Measure the transitive downstream blast radius of a change. |
+| `scip-query affected <symbol>` | Transitive closure of symbols that could break if this symbol changes | affected symbol identities, files, and traversal depths | `bounded` | Measure the transitive downstream blast radius of a change. |
 
 Use this shortlist first. Open [`../_shared/SKILL.md`](../_shared/SKILL.md) only when it is insufficient.
 <!-- END GENERATED SKILL COMMANDS -->
@@ -46,7 +46,7 @@ Done when: module files, key symbols, dependencies, and reverse dependencies are
 **2. Trace entry points.** Run `trace <entry-symbol>` (definition + every reference, bounded), `call-graph <entry-symbol>` (incoming callers, outgoing callees, bounded), `code <entry-symbol>`, `dataflow <entry-symbol>` — repeat for important callees until the path reaches a side effect, a returned value, or a terminal output.
 Done when: the traced path connects entry point to observable effect.
 
-**3. Map dependencies and consumers.** Run `deps <file>`, `rdeps <file>`, `fan-out <file>`, `surface <module>`, `affected <symbol> --json` (transitive closure of symbols that could break if this symbol changes: identities, files, traversal depths, bounded).
+**3. Map dependencies and consumers.** Run `deps <file>`, `rdeps <file>`, `fan-out <file>`, `surface <module>`, `affected <symbol>` (transitive closure of symbols that could break if this symbol changes: identities, files, traversal depths, bounded).
 Done when: direct dependencies, public surface, and downstream blast radius are named.
 
 **4. Follow data and state.** Run `dataflow <symbol-or-variable>` (definition sites, usage sites, producers, consumers, bounded), `slice <symbol-or-variable>`, `slice <symbol-or-variable> --forward`.

package/skills/scip-improve/SKILL.md

@@ -2,11 +2,11 @@
 name: scip-improve
 description: Use when edits should actually be made: fix confirmed cleanup findings batch by batch, consolidate a drifted twin into one canonical helper, implement a named maintainability mechanism, extract a React hook or Vue composable, move files to fix locality, or bring AGENTS.md/standards/docs back in sync with code. Requires findings already confirmed — audit first if they are not. For reducing one symbol's cognitive complexity, use `complexity-cleanup`; for deciding where a boundary belongs at design time, use `decomposition`.
 commands:
-  - template: "scip-query cleanup-plan --verify --json"
+  - template: "scip-query cleanup-plan --verify"
     when: "Build compiler-checked deletion batches from confirmed dead-code findings."
-  - template: "scip-query cleanup-apply --verified --batch <n>"
+  - template: "scip-query cleanup-apply --verified --batch <n> --dry-run"
     when: "Apply one already verified cleanup batch."
-  - template: "scip-query diff-gate --json --compact"
+  - template: "scip-query diff-gate"
     when: "Gate each implemented improvement slice before declaring it complete."
 ---
 
@@ -31,12 +31,12 @@ with its evidence and disposition.
 
 | Situation | Do this | Reference |
 |---|---|---|
-| Fix confirmed cleanup findings, raise health, "keep cleaning" | `health` → `cleanup-plan --verify` → `cleanup-apply --verified --batch <n>` in a loop | `references/cleanup-batches.md` |
+| Fix confirmed cleanup findings, raise health, "keep cleaning" | `health` → `cleanup-plan --verify` → preview then apply one `cleanup-apply --verified --batch <n>` in a loop | `references/cleanup-batches.md` |
 | AGENTS.md/CLAUDE.md/standards/command docs are stale or cite moved code | `doc-drift` → `outline`/`trace`/`code` per doc → rerun `doc-drift` | `references/doc-reconcile.md` |
-| Same-name/near-name functions diverged, one-sided fix, drifted threshold | `twin-drift --json --full` → classify → consolidate → rerun `twin-drift` | `references/twin-drift.md` |
+| Same-name/near-name functions diverged, one-sided fix, drifted threshold | `twin-drift --full` → classify → consolidate → rerun `twin-drift` | `references/twin-drift.md` |
 | Implement a confirmed maintainability register entry (hidden policy, thin wrapper, dead re-export) | `extract-candidates` / `passthrough-candidates` / `wrapper-candidates` / `stale-abstractions` / `redundant-reexports` to confirm, then implement the disposition | `references/maintainability-mechanism.md` |
 | Extract a React hook/component or Vue composable/component | cross-check confirmed candidates, classify reuse/extract/split, extract | `references/frontend-extraction.md` |
-| Move files to fix locality, declare/close an architecture boundary | `locality-candidates --json --full` → migration slice → boundary config → postchecks | `references/directory-moves.md` |
+| Move files to fix locality, declare/close an architecture boundary | `locality-candidates --full` → migration slice → boundary config → postchecks | `references/directory-moves.md` |
 
 ## Owned commands
 
@@ -48,9 +48,9 @@ with its evidence and disposition.
 
 | Command | Purpose | Returns | Coverage | When |
 | --- | --- | --- | --- | --- |
-| `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` | Build compiler-checked deletion batches from confirmed dead-code findings. |
-| `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` | Apply one already verified cleanup batch. |
-| `scip-query diff-gate --json --compact` | Runtime-bounded, single-flight gate for the current diff: architecture regressions plus echo, migration, coordination, doc-drift, unused-param, and new-dead candidates; exit 1 on blocking findings | blocking findings with check id, message, and remediation; advisory findings; root-cause groups; changed file and symbol counts; process exit status (1 when blocking findings exist) | `bounded` | Gate each implemented improvement slice before declaring it complete. |
+| `scip-query cleanup-plan --verify` | Ordered, batched deletion plan: graph-fact dead code plus the cascade candidates it unlocks | ordered cleanup batches, evidence, and optional verification outcomes | `bounded` | Build compiler-checked deletion batches from confirmed dead-code findings. |
+| `scip-query cleanup-apply --verified --batch <n> --dry-run` | Apply a compiler-verified cleanup-plan batch to the working tree | applied files, deletions, verification, and refusal reasons | `bounded` | Apply one already verified cleanup batch. |
+| `scip-query diff-gate` | Runtime-bounded, single-flight gate for the current diff: architecture regressions plus echo, migration, coordination, doc-drift, unused-param, and new-dead candidates; exit 1 on blocking findings | blocking findings with check id, message, and remediation; advisory findings; root-cause groups; changed file and symbol counts; process exit status (1 when blocking findings exist) | `bounded` | Gate each implemented improvement slice before declaring it complete. |
 
 Use this shortlist first. Open [`../_shared/SKILL.md`](../_shared/SKILL.md) only when it is insufficient.
-<!-- END GENERATED SKILL COMMANDS -->
+<!-- END GENERATED SKILL COMMANDS -->

package/skills/scip-improve/references/cleanup-batches.md

@@ -8,7 +8,7 @@ If cleanup findings have not been swept and confirmed yet, run the cleanup
 scenario in `scip-audit` first. Then report a markdown block before touching
 any code:
 
-- current score from `scip-query health --json`
+- current score from `scip-query health`
 - the first confirmed batch: finding, evidence, planned fix, verification plan
 - remaining signals with status
 
@@ -28,9 +28,9 @@ Work top to bottom, one item at a time:
 
 Repeat until stopping:
 
-1. Apply one verified deletion batch — `scip-query cleanup-apply --verified --batch <n>` against the plan from `scip-query cleanup-plan --verify --json` — or one small targeted refactor for the next prioritized item.
+1. Preview one verified deletion batch with `scip-query cleanup-apply --verified --batch <n> --dry-run`. Confirm the exact files, symbol ranges, LOC, and verifier match the intended batch; then run the same command without `--dry-run` to apply it. Otherwise make one small targeted refactor for the next prioritized item.
 2. Run the narrow project check for the touched behavior (tests/typecheck scoped to what changed).
-3. Run `scip-query health --json`.
+3. Run `scip-query health`.
 4. Invoke the `scip-verify` skill.
 5. If `docs/scip-query/health-dossier.md` exists (or a custom `--dossier-dir` was used), refresh it by rerunning `scip-query setup --json` with the same `--dossier-dir` if one was used.
 6. Pick the next highest-priority confirmed item and repeat.

package/skills/scip-improve/references/directory-moves.md

@@ -8,7 +8,7 @@ on its own.
 
 ## Find and confirm the move
 
-Run `scip-query locality-candidates --json --full` for directory-locality and ancestry candidates from consumer ownership (symbols, current homes, consumer locality, suggested homes). Cross-check current placement with `scip-query system <scope>` (files, exported symbols with line ranges, internal deps, reverse deps).
+Run `scip-query locality-candidates --full` for directory-locality and ancestry candidates from consumer ownership (symbols, current homes, consumer locality, suggested homes). Cross-check current placement with `scip-query system <scope>` (files, exported symbols with line ranges, internal deps, reverse deps).
 
 Concepts that decide whether a move is safe:
 
@@ -32,7 +32,7 @@ Add mature boundary path patterns to `.scipquery.json` under `architecture.bound
 ] } }
 ```
 
-Then run `scip-query config-validate --json`, then `scip-query architecture --json`.
+Then run `scip-query config-validate`, then `scip-query architecture`.
 
 An `allowedDependencies` row is closed: an outgoing target omitted from a present row is forbidden, but a missing row makes no dependency claim at all. Example: `{ "architecture": { "boundaries": [...], "allowedDependencies": { "domain": [], "runtime": ["domain"] }, "requireAcyclic": true } }`. For each closed row, record the evidence for its intended direction. Never copy the current dependency graph into the allow-list merely to obtain zero findings; leave emerging or disputed rules undeclared rather than closing the row prematurely.
 
@@ -48,6 +48,6 @@ The default `diff-gate` architecture check compares only architecture identities
 
 Run `scip-query incomplete-migration`, `scip-query recent-duplicates`, and `scip-query co-change <moved-file-or-config>`, plus the project's tests or typecheck for the affected workspace.
 
-If `.scipquery.json` locality changed, also run `scip-query config-validate`, `scip-query locality-candidates --json --full`, `scip-query architecture --json`, `scip-query drift --architecture`, and `scip-query diff-gate`.
+If `.scipquery.json` locality changed, also run `scip-query config-validate`, `scip-query locality-candidates --full`, `scip-query architecture`, `scip-query drift --architecture`, and `scip-query diff-gate`.
 
 Then invoke `scip-verify`. The implementation is complete only when imports, tests, locality signals, and verification are all checked.

package/skills/scip-improve/references/doc-reconcile.md

@@ -9,7 +9,7 @@ The core distinction driving every edit:
 
 ## Step 1 — Build the worklist
 
-Run `scip-query doc-drift --json --full` for the ranked worklist (document paths, coupled code subjects, history evidence), plus `scip-query doc-drift <doc-or-tree>` for anything scoped. Prioritize broken references first, then highest staleness, then the docs agents read most. Done only when each target doc is selected for a current-use reason.
+Run `scip-query doc-drift --full` for the ranked worklist (document paths, coupled code subjects, history evidence), plus `scip-query doc-drift <doc-or-tree>` for anything scoped. Prioritize broken references first, then highest staleness, then the docs agents read most. Done only when each target doc is selected for a current-use reason.
 
 ## Step 2 — Reconcile one doc
 

package/skills/scip-improve/references/frontend-extraction.md

@@ -10,7 +10,7 @@ nothing is confirmed yet, run that scenario first, then cross-check, then act.
 
 ## Scan (only if not already done)
 
-React: `scip-query react-component-duplicates`, `react-hook-candidates`, `react-large-component-pressure`, `recent-duplicates`, `health` — all `--scope <scope> --full --json`, uncapped.
+React: `scip-query react-component-duplicates`, `react-hook-candidates`, `react-large-component-pressure`, `recent-duplicates`, `health` — all `--scope <scope> --full`, uncapped.
 
 Vue: same shape, using `vue-component-duplicates`, `vue-composable-candidates`, `vue-large-view-pressure`. Before scanning, when component references, imported composables, script blocks, or linked external scripts matter, run `scip-query augment-vue --project <path-to-tsconfig>` to add compiler-resolved Vue SFC references via Volar — Vue needs this step; React doesn't.
 
@@ -18,7 +18,7 @@ Record scope, counts, and uncapped/full status.
 
 ## Cross-check before acting
 
-Use `scip-query outline <file>`, `deps <file>`, `rdeps <file>`, `similar-files --scope <scope>`, and either `scip-query similar <closest-existing-component-or-hook>` (React) or `scip-query recent-duplicates --scope <scope> --full --json` (Vue) to validate each candidate. Classify every top candidate as reuse, extract, split, skip, or blocked:
+Use `scip-query outline <file>`, `deps <file>`, `rdeps <file>`, `similar-files --scope <scope>`, and either `scip-query similar <closest-existing-component-or-hook>` (React) or `scip-query recent-duplicates --scope <scope> --full` (Vue) to validate each candidate. Classify every top candidate as reuse, extract, split, skip, or blocked:
 
 - Component-duplicate-only → look for a shared presentational component or existing reuse.
 - Hook/composable-candidate-only → look for shared state lifecycle, effects, requests, validation, persistence, or derived-state policy.

package/skills/scip-improve/references/twin-drift.md

@@ -6,7 +6,7 @@ A twin drift group is a same-leaf-name family of callables spanning at least two
 
 ## Detect
 
-Run `scip-query twin-drift --json --full` to surface every DIVERGENT and near-name group in scope; scope it with `-s/--scope <path>` when the review should be bounded. Cross-check against `scip-query duplicate-bodies --json --full` — IDENTICAL groups belong there, not here; don't re-report them. Homonyms (similarity below `--min-similarity`, default 0.3) are noise — skip them unless `--include-homonyms` was explicitly requested. Record group count, member count, and `maxDivergence` per group. Done only when every group in scope is enumerated with its relationship (divergent vs. suppressed homonym).
+Run `scip-query twin-drift --full` to surface every DIVERGENT and near-name group in scope; scope it with `-s/--scope <path>` when the review should be bounded. Cross-check against `scip-query duplicate-bodies --full` — IDENTICAL groups belong there, not here; don't re-report them. Homonyms (similarity below `--min-similarity`, default 0.3) are noise — skip them unless `--include-homonyms` was explicitly requested. Record group count, member count, and `maxDivergence` per group. Done only when every group in scope is enumerated with its relationship (divergent vs. suppressed homonym).
 
 ## Classify
 
@@ -26,10 +26,10 @@ Done only when every DIVERGENT group is either consolidated (old copies gone or
 
 ## Verify
 
-Rerun `scip-query twin-drift --json --full` to confirm consolidated groups no longer appear as DIVERGENT, then run the routed postchecks from `scip-verify`. The twin-partner check inside `diff-gate` is advisory and never blocks the gate by itself — but a finding there on your own diff means you've reproduced the exact defect class this skill exists to catch; treat it as a signal to run this workflow, not just to suppress the finding. Fix it or explicitly accept it before finishing.
+Rerun `scip-query twin-drift --full` to confirm consolidated groups no longer appear as DIVERGENT, then run the routed postchecks from `scip-verify`. The twin-partner check inside `diff-gate` is advisory and never blocks the gate by itself — but a finding there on your own diff means you've reproduced the exact defect class this skill exists to catch; treat it as a signal to run this workflow, not just to suppress the finding. Fix it or explicitly accept it before finishing.
 
 Done only when `twin-drift` shows no unclassified DIVERGENT groups in scope and any `diff-gate` findings are resolved or explained.
 
 ## Report
 
-Scope, groups found (total / divergent / suppressed homonyms), each divergent group with its classification and action taken, and the verification results of `twin-drift --json --full` and `diff-gate --json`.
+Scope, groups found (total / divergent / suppressed homonyms), each divergent group with its classification and action taken, and the verification results of `twin-drift --full` and `diff-gate`.

package/skills/scip-plan/SKILL.md

@@ -6,7 +6,7 @@ commands:
     when: "Anchor the current flow, consumers, reuse options, and change risks."
   - template: "scip-query refs <symbol>"
     when: "Complete or narrow the direct consumer set for a planned symbol change."
-  - template: "scip-query affected <symbol> --json"
+  - template: "scip-query affected <symbol>"
     when: "Measure transitive impact when the change is not consumer-local."
 ---
 
@@ -19,7 +19,7 @@ commands:
 | --- | --- | --- | --- | --- |
 | `scip-query plan-context <target>` | Pre-edit planning context for a symbol, file, or module | definitions and references; callers and callees; dataflow producers and consumers; backward and forward slices; affected symbols; change-surface risk; dependencies and reverse dependencies; module files and exports; external surface use; complexity; churn; co-change partners; active suppressions | `bounded` | Anchor the current flow, consumers, reuse options, and change risks. |
 | `scip-query refs <symbol>` | Find all files referencing a symbol | referencing file paths; reference line numbers grouped by file | `bounded` | Complete or narrow the direct consumer set for a planned symbol change. |
-| `scip-query affected <symbol> --json` | Transitive closure of symbols that could break if this symbol changes | affected symbol identities, files, and traversal depths | `bounded` | Measure transitive impact when the change is not consumer-local. |
+| `scip-query affected <symbol>` | Transitive closure of symbols that could break if this symbol changes | affected symbol identities, files, and traversal depths | `bounded` | Measure transitive impact when the change is not consumer-local. |
 
 Use this shortlist first. Open [`../_shared/SKILL.md`](../_shared/SKILL.md) only when it is insufficient.
 <!-- END GENERATED SKILL COMMANDS -->

package/skills/scip-plan/references/api-impact.md

@@ -4,15 +4,15 @@ Use before changing anything another process or person depends on: a callable, e
 
 ## Scenario: assess what breaks before editing a public surface
 
-**Step 1 — identify the actual surface.** Run `scip-query surface <module-or-package>`, `scip-query outline <file>`, `scip-query trace <symbol-or-command>`, `scip-query code <symbol-or-command>`, and `scip-query hierarchy <symbol> --json`. Done only when the real surface is named as one of: member, class, module, package, route, schema, command, or config field.
+**Step 1 — identify the actual surface.** Run `scip-query surface <module-or-package>`, `scip-query outline <file>`, `scip-query trace <symbol-or-command>`, `scip-query code <symbol-or-command>`, and `scip-query hierarchy <symbol>`. Done only when the real surface is named as one of: member, class, module, package, route, schema, command, or config field.
 
-**Step 2 — find consumers.** Run `scip-query refs <symbol>`, `scip-query fan-in <symbol>`, `scip-query rdeps <file>`, `scip-query affected <symbol> --json`, and `scip-query change-surface <file> --json --full`. Record direct consumers separately from transitive consumers. Done only when direct breakage and regression blast radius are both known.
+**Step 2 — find consumers.** Run `scip-query refs <symbol>`, `scip-query fan-in <symbol>`, `scip-query rdeps <file>`, `scip-query affected <symbol>`, and `scip-query change-surface <file> --full`. Record direct consumers separately from transitive consumers. Done only when direct breakage and regression blast radius are both known.
 
-**Step 3 — find hidden partners.** Run `scip-query co-change <file> --json --full` (files historically coupled without a dependency edge), `scip-query doc-drift --json --full` (docs describing the surface), `scip-query similar <symbol> --json --full`, and `scip-query similar-files <file> --json --full`. Docs, generated files, tests, and config count as part of the API when they describe or enforce the surface. Done only when docs, generated files, fixtures, sibling APIs, and hand-synchronized partners are accounted for or ruled out.
+**Step 3 — find hidden partners.** Run `scip-query co-change <file> --full` (files historically coupled without a dependency edge), `scip-query doc-drift --full` (docs describing the surface), `scip-query similar <symbol> --full`, and `scip-query similar-files <file> --full`. Docs, generated files, tests, and config count as part of the API when they describe or enforce the surface. Done only when docs, generated files, fixtures, sibling APIs, and hand-synchronized partners are accounted for or ruled out.
 
-**Step 4 — choose the migration shape.** Pick one of: compatible extension, two-step migration, breaking coordinated change, or an adapter shim for external consumers/compatibility windows. Prefer backward-compatible migrations when consumers are broad or external. Reject speculative new parameters or empty wrappers using `scip-query unused-params --json --full`, `scip-query wrapper-candidates --json --full`, and `scip-query passthrough-candidates --json --full`. Done only when the migration shape explains deploy order, rollback, and compatibility risk.
+**Step 4 — choose the migration shape.** Pick one of: compatible extension, two-step migration, breaking coordinated change, or an adapter shim for external consumers/compatibility windows. Prefer backward-compatible migrations when consumers are broad or external. Reject speculative new parameters or empty wrappers using `scip-query unused-params --full`, `scip-query wrapper-candidates --full`, and `scip-query passthrough-candidates --full`. Done only when the migration shape explains deploy order, rollback, and compatibility risk.
 
-**Step 5 — write the plan and verify.** Plan template: Surface; a Consumer dispositions table (Consumer | Kind: direct/transitive/doc/config/test | Disposition: unchanged-safe/update/shim/defer); Required co-changes; Migration; Verification (targeted tests, `scip-query diff-impact --json`, `scip-verify`, `scip-query doc-drift --json --full` if docs changed, `scip-query config-validate` if config changed). Every consumer returned by refs/affected must appear as a row — a blank disposition means the analysis is unfinished. Non-indexed consumers (SQL, fixtures, dynamic strings, external callers) must be checked with `rg` and rowed the same way as indexed consumers.
+**Step 5 — write the plan and verify.** Plan template: Surface; a Consumer dispositions table (Consumer | Kind: direct/transitive/doc/config/test | Disposition: unchanged-safe/update/shim/defer); Required co-changes; Migration; Verification (targeted tests, `scip-query diff-impact`, `scip-verify`, `scip-query doc-drift --full` if docs changed, `scip-query config-validate` if config changed). Every consumer returned by refs/affected must appear as a row — a blank disposition means the analysis is unfinished. Non-indexed consumers (SQL, fixtures, dynamic strings, external callers) must be checked with `rg` and rowed the same way as indexed consumers.
 
 After editing, run the routed checks from `_shared` and invoke `scip-verify`. The workflow is complete only when direct consumers, docs/config partners, and scip-verify have all been checked.
 

package/skills/scip-plan/references/conductor.md

@@ -2,7 +2,7 @@
 
 This governs running a program of work — planning, delegation, review, closure — across multiple steps, not how to write a single change plan (use the main SKILL.md's ordinary-mode scenario, or `references/high-assurance.md`, for that). Act like a skeptical principal engineer.
 
-Key commands: `scip-query plan-context <target>` anchors each phase's step before delegating it; `scip-query diff-gate --json` verifies a handoff before accepting it and before closing the program; `scip-query health --json` pre-registers or checks a program-level health benchmark.
+Key commands: `scip-query plan-context <target>` anchors each phase's step before delegating it; `scip-query diff-gate` verifies a handoff before accepting it and before closing the program; `scip-query health` pre-registers or checks a program-level health benchmark.
 
 ## The three laws
 
@@ -24,7 +24,7 @@ Working agreement to include in the plan: ONE COMMIT PER STEP — bisectability
 
 Delegate breadth, keep judgment: fan out mechanical/scoped work to subagents, but personally own anything requiring taste, cross-cutting context, or the final word on "is this real." Concurrent agents must get disjoint write scopes, named in their briefs; if a collision happens anyway, stop racing, apply-verify-commit atomically in one action, and re-sequence to a single writer.
 
-Never accept a report at face value — reproduce its evidence. On every handoff, choose the minimal discriminating probe (the one command most likely to expose the report being wrong: a mutation input, a hand count, the benchmark number) and run it yourself; a report verified only by reading it is not verified. Loop until `scip-query diff-gate --json` is quiet: fix, re-run the discriminating probe, re-run the gate, and only then move on.
+Never accept a report at face value — reproduce its evidence. On every handoff, choose the minimal discriminating probe (the one command most likely to expose the report being wrong: a mutation input, a hand count, the benchmark number) and run it yourself; a report verified only by reading it is not verified. Loop until `scip-query diff-gate` is quiet: fix, re-run the discriminating probe, re-run the gate, and only then move on.
 
 Verify your verifier: a gate check that cannot fail is no gate (e.g. a lint grep that only matches one linter's output, a diff-gate run on a clean tree, a test suite that skips the new path) — prove the check catches a planted failure once before trusting its green. After any "all green," ask what that check does NOT cover (eslint vs prettier; unit vs integration; clean-tree vacuity).
 

package/skills/scip-plan/references/hyper-optimization.md

@@ -33,7 +33,7 @@ QUICK mode skips this and goes straight to tracing behavior, using the single ru
 
 ## Scenario: trace behavior
 
-Run `scip-query plan-context`, `trace`, `call-graph`, `code`, `dataflow`, and `complexity` on the entry/hot symbol — `call-graph <entry-symbol>` returns callers/callees, `complexity <hot-symbol>` returns LOC, branch, complexity, callee, fan-in/out counts — then `scip-query change-surface <touched-file> --json --full` to verify blast radius. Record input parsing, option resolution, subprocesses, lookups, database queries, graph traversal, source scans, semantic calls, cache reads/writes, rendering, serialization, and verification. Done only when each major pipeline step can be timed as a profile span.
+Run `scip-query plan-context`, `trace`, `call-graph`, `code`, `dataflow`, and `complexity` on the entry/hot symbol — `call-graph <entry-symbol>` returns callers/callees, `complexity <hot-symbol>` returns LOC, branch, complexity, callee, fan-in/out counts — then `scip-query change-surface <touched-file> --full` to verify blast radius. Record input parsing, option resolution, subprocesses, lookups, database queries, graph traversal, source scans, semantic calls, cache reads/writes, rendering, serialization, and verification. Done only when each major pipeline step can be timed as a profile span.
 
 Before adding profiling spans, check whether the target app already has an instrumentation layer — a bespoke profiling harness competes with the one the codebase already trusts. When the optimization target is scip-query itself, its instrumentation is `src/instrumentation/profile.ts` (`profileSpan`/`profileAsyncSpan`), env-gated by `SCIP_QUERY_PROFILE` and `SCIP_QUERY_PROFILE_OUT`, with `SCIP_QUERY_PROFILE_CACHE_STATE` for cache-state labels and inherited workload/subsystem identities — use it instead of adding a parallel harness.
 

package/skills/scip-query/SKILL.md

@@ -17,6 +17,16 @@ insufficient. The shared reference contains the complete command vocabulary,
 coverage rules, and evidence contract; loading it before a route is selected
 adds choices without adding direction.
 
+Run commands normally for agent reading: the human renderer preserves
+hierarchy, whitespace, and line numbers without transport metadata. Select
+`--json` only when a program will parse the response; add `--result-only` when
+that program needs only the command result rather than the stable public
+envelope. Do not select `--compact` or `--output-page-size` for readability.
+Follow an emitted continuation command only when the command itself says the
+output is incomplete. The final transport-complete footer means every rendered
+character was retrieved; inspect command coverage separately before claiming
+the logical result is exhaustive.
+
 ## Routes
 
 | The request starts from… | Owning skill | Completion criterion |
@@ -62,11 +72,11 @@ Top commands per routed skill, generated from each skill's own `commands:` front
 
 | Skill | Top commands |
 | --- | --- |
-| `scip-audit` | `scip-query health --json`, `scip-query decorative-checkers --json --full`, `scip-query doc-drift --json --full` |
+| `scip-audit` | `scip-query health`, `scip-query decorative-checkers --full`, `scip-query doc-drift --full` |
 | `scip-diagnose` | `scip-query files <feature-or-error-term>`, `scip-query trace <candidate-symbol>`, `scip-query call-graph <entry-symbol>` |
-| `scip-explore` | `scip-query system <module-or-scope>`, `scip-query trace <entry-symbol>`, `scip-query affected <symbol> --json` |
-| `scip-improve` | `scip-query cleanup-plan --verify --json`, `scip-query cleanup-apply --verified --batch <n>`, `scip-query diff-gate --json --compact` |
-| `scip-plan` | `scip-query plan-context <target>`, `scip-query refs <symbol>`, `scip-query affected <symbol> --json` |
+| `scip-explore` | `scip-query system <module-or-scope>`, `scip-query trace <entry-symbol>`, `scip-query affected <symbol>` |
+| `scip-improve` | `scip-query cleanup-plan --verify`, `scip-query cleanup-apply --verified --batch <n> --dry-run`, `scip-query diff-gate` |
+| `scip-plan` | `scip-query plan-context <target>`, `scip-query refs <symbol>`, `scip-query affected <symbol>` |
 | `scip-setup` | `scip-query setup --json`, `scip-query doctor`, `scip-query status --capabilities` |
-| `scip-verify` | `scip-query doctor`, `scip-query diff-impact --json`, `scip-query diff-gate --json --compact` |
+| `scip-verify` | `scip-query doctor`, `scip-query diff-impact`, `scip-query diff-gate` |
 <!-- END GENERATED ROUTER COMMAND PREVIEW -->

package/skills/scip-setup/references/bootstrap-workflow.md

@@ -58,15 +58,14 @@ every written, skipped, or blocked artifact.
 
 ```bash
 scip-query doctor
-scip-query status --json
+scip-query status
 scip-query capabilities --matrix
-scip-query config-validate --json
+scip-query config-validate
 ```
 
-`doctor` is the human diagnostic surface for config, index freshness, and
-dependency readiness. `status --json` is the machine surface for freshness
-and config. `capabilities --matrix` reports which evidence/verification
-capabilities are available. `config-validate --json` validates
+`doctor` reports config, index freshness, and dependency readiness. `status`
+reports freshness and config. `capabilities --matrix` reports which
+evidence/verification capabilities are available. `config-validate` validates
 `.scipquery.json`.
 
 Fix missing indexers, stale indexes, invalid config, or unavailable
@@ -84,8 +83,8 @@ language and how to interpret `stopped`/idle service states.
 
 ```bash
 scip-query status --capabilities
-scip-query reindex --json
-scip-query watch --status --json
+scip-query reindex
+scip-query watch --status
 ```
 
 Complete only when every selected language has an explicit

package/skills/scip-setup/references/language-verification.md

@@ -56,6 +56,6 @@ never as a clean semantic analysis.
 
 ```bash
 scip-query status --capabilities
-scip-query reindex --json
-scip-query watch --status --json
+scip-query reindex
+scip-query watch --status
 ```

package/skills/scip-setup/references/per-repo-triage.md

@@ -4,7 +4,7 @@ New repos surface standing findings that are intentional. Encode them once so
 every later gate run is precise, instead of re-litigating the same findings
 every time `diff-gate` runs.
 
-1. Sweep initial findings with `health --json` and `diff-gate --json`. For
+1. Sweep initial findings with `health` and `diff-gate`. For
    each accepted finding, run `suppress <id> --reason <why>` — reasons are
    required and audited.
 2. Declare files that legitimately change together in `.scipquery.json`

package/skills/scip-verify/SKILL.md

@@ -4,9 +4,9 @@ description: Use after finishing a change and before committing: ensure the watc
 commands:
   - template: "scip-query doctor"
     when: "Prove the workspace and configuration are usable before trusting evidence."
-  - template: "scip-query diff-impact --json"
+  - template: "scip-query diff-impact"
     when: "Compare changed files, symbols, and affected consumers with the intended diff."
-  - template: "scip-query diff-gate --json --compact"
+  - template: "scip-query diff-gate"
     when: "Run the complete finished-diff gate without blind line truncation."
 ---
 
@@ -32,8 +32,8 @@ Load shared mechanics — command syntax, the evidence contract, diff-gate's
 | Command | Purpose | Returns | Coverage | When |
 | --- | --- | --- | --- | --- |
 | `scip-query doctor` | Diagnose config, index freshness, dependency readiness, and project capabilities | config, freshness, dependency, and capability diagnostics | `complete` | Prove the workspace and configuration are usable before trusting evidence. |
-| `scip-query diff-impact --json` | Compute changed symbols and downstream consumers from current git diff | changed symbols, downstream consumer identities, and impact paths | `bounded` | Compare changed files, symbols, and affected consumers with the intended diff. |
-| `scip-query diff-gate --json --compact` | Runtime-bounded, single-flight gate for the current diff: architecture regressions plus echo, migration, coordination, doc-drift, unused-param, and new-dead candidates; exit 1 on blocking findings | blocking findings with check id, message, and remediation; advisory findings; root-cause groups; changed file and symbol counts; process exit status (1 when blocking findings exist) | `bounded` | Run the complete finished-diff gate without blind line truncation. |
+| `scip-query diff-impact` | Compute changed symbols and downstream consumers from current git diff | changed symbols, downstream consumer identities, and impact paths | `bounded` | Compare changed files, symbols, and affected consumers with the intended diff. |
+| `scip-query diff-gate` | Runtime-bounded, single-flight gate for the current diff: architecture regressions plus echo, migration, coordination, doc-drift, unused-param, and new-dead candidates; exit 1 on blocking findings | blocking findings with check id, message, and remediation; advisory findings; root-cause groups; changed file and symbol counts; process exit status (1 when blocking findings exist) | `bounded` | Run the complete finished-diff gate without blind line truncation. |
 
 Use this shortlist first. Open [`../_shared/SKILL.md`](../_shared/SKILL.md) only when it is insufficient.
 <!-- END GENERATED SKILL COMMANDS -->
@@ -67,7 +67,7 @@ environment and index freshness before trusting any graph fact that follows.
 ### 2. Assess the diff
 
 ```bash
-scip-query diff-impact --json
+scip-query diff-impact
 ```
 
 Compare changed files, changed symbols, and downstream consumers against the
@@ -91,8 +91,8 @@ you expected to need going in:
 | Changed React components or hooks | the React commands in `_shared` |
 | Changed Vue SFCs or composables | the Vue commands in `_shared` |
 
-Add `--json --full` to any of these when an unbounded machine-readable result
-is needed rather than the bounded default. This table is authoritative — the
+Add `--full` to any of these when an unbounded result is needed rather than
+the bounded default. This table is authoritative — the
 shared reference links here instead of duplicating it, so don't assume a
 different mapping. Complete only when each applicable postcheck has a result
 and every actionable finding is fixed, accepted with evidence, or blocked by
@@ -108,7 +108,7 @@ scip-query config-validate
 ### 4. Run the gate
 
 ```bash
-scip-query diff-gate --json
+scip-query diff-gate
 ```
 
 This is the primary blocker for diff-specific risk: architecture regressions
@@ -142,7 +142,7 @@ when a committed baseline exists. If docs, AGENTS.md, CLAUDE.md, command
 docs, generated docs, or skill instructions changed, run
 
 ```bash
-scip-query doc-drift --json --full
+scip-query doc-drift --full
 ```
 
 and read the returned stale-doc candidates against the diff.
@@ -202,7 +202,7 @@ Postchecks:
 - <command>: <result>
 
 Gate:
-- `scip-query diff-gate --json`: <result>
+- `scip-query diff-gate`: <result>
 
 Health/docs/self-audit:
 - <commands and results>

package/skills/scip-verify/references/calibrate-detectors.md

@@ -43,10 +43,10 @@ Run the full detector battery and don't react to any of the numbers yet —
 big counts here are sampling frames, not findings:
 
 ```bash
-scip-query health --json
-scip-query dead --json
+scip-query health
+scip-query dead
 scip-query similar <symbol>
-scip-query twin-drift -s <scope> --json
+scip-query twin-drift -s <scope>
 ```
 
 Complete only when every detector's finding count is recorded.
@@ -57,7 +57,7 @@ Replay the gate against the last 15-20 real commits, using a worktree per
 commit — never the user's live tree:
 
 ```bash
-scip-query diff-gate --base <commit> --json
+scip-query diff-gate --base <commit>
 ```
 
 This is the stage that exposes finding WALLS: one hub file or one convention
@@ -114,7 +114,7 @@ until it's fixed.
 Confirm the repair:
 
 ```bash
-scip-query diff-gate --json
+scip-query diff-gate
 ```
 
 run before and after, to check it worked.
@@ -147,11 +147,11 @@ Each of these has been observed in a real calibration:
 
 The finding-outcome ledger keeps calibrating automatically. Once the repo
 uses `diff-gate`, per-detector precision is recomputed from real outcomes as
-`detectorPrecision` in `health --json`. The committed event ledger under
+`detectorPrecision` in `health`. The committed event ledger under
 `.scipquery/events/*.json` makes those outcomes durable and queryable:
 
 ```bash
-scip-query effectiveness --since 30d --json
+scip-query effectiveness --since 30d
 ```
 
 reports, per check, caught / comparison-verified-fixed / suppressed / open /

package/dist/chunk-2465DLHK.js

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-import{$c as A,Aa as D,Ba as b,Cd as me,Dd as ge,Ea as se,Fa as E,Ga as M,Na as oe,Oa as ae,Qa as R,Ra as G,Rd as ye,Sa as ce,Sd as Se,Ua as j,Va as de,Wa as ue,Yd as ve,Za as N,ad as le,bd as pe,f as I,id as $,ld as F,md as he,n as re,nd as H,od as fe,x as v,xa as y,ya as ne,za as ie}from"./chunk-HIB452NU.js";import{spawn as dt}from"child_process";import{existsSync as ut,rmSync as ke}from"fs";import{dirname as lt,resolve as L}from"path";import{fileURLToPath as pt}from"url";import{createHash as He,randomUUID as Ie}from"crypto";import{existsSync as Ve,linkSync as Ue,mkdirSync as Re,readdirSync as Be,rmSync as ze}from"fs";import{basename as Ke,dirname as Je,join as S}from"path";var T=1,Ye=10*6e4,_t=10080*6e4,V="requests",Qe="claims",Xe="completions",Ze="staging";function we(e,t,r={}){let n=r.now?.()??new Date,i=ot(r.ttlMs),s=at(r.idempotencyKey),a=s?`key-${He("sha256").update(s).digest("hex")}`:`request-${(r.randomId??Ie)()}`,o={version:T,requestId:a,...s?{idempotencyKey:s}:{},createdAt:n.toISOString(),deadlineAt:new Date(n.getTime()+i).toISOString(),detail:t.trim().slice(0,2048)||"stale index observed by a command"},c=st(e,a);if(rt(e,c,o,r.onStage))return{disposition:"accepted",request:o};let u=U(c);if(!u)throw new Error(`Watch refresh request identity ${a} exists but is malformed.`);return{disposition:"duplicate",request:u}}function Lt(e){let t=nt(e),r=new Map,n=it(S(e,V),U);for(let c of P(S(e,Xe))){let d=tt(c);if(!d){n++;continue}r.set(d.requestId,d)}let i=new Set;for(let c of P(S(e,Qe))){let d=et(c);if(!d){n++;continue}i.add(d.requestId)}let s=t.filter(c=>!r.has(c.requestId)&&!i.has(c.requestId)),a=[...r.values()].filter(c=>c.outcome==="completed").length,o=[...r.values()].filter(c=>c.outcome==="expired").length;return{pending:s.length,claimed:t.filter(c=>!r.has(c.requestId)&&i.has(c.requestId)).length,completed:a,expired:o,invalid:n,...s.length>0?{oldestPendingAt:s.map(c=>c.createdAt).reduce((c,d)=>ct(c,d))}:{}}}function U(e){return B(e,t=>{let r=t;return r.version===T&&w(r.requestId)&&(r.idempotencyKey===void 0||typeof r.idempotencyKey=="string")&&I(r.createdAt)&&I(r.deadlineAt)&&Date.parse(r.deadlineAt)>=Date.parse(r.createdAt)&&typeof r.detail=="string"&&r.detail.length>0})}function et(e){return B(e,t=>{let r=t;return r.version===T&&w(r.requestId)&&w(r.claimId)&&I(r.claimedAt)})}function tt(e){return B(e,t=>{let r=t;return r.version===T&&w(r.requestId)&&(r.claimId===void 0||w(r.claimId))&&(r.outcome==="completed"||r.outcome==="expired")&&I(r.completedAt)})}function rt(e,t,r,n){let i=S(e,Ze),s=Je(t);Re(i,{recursive:!0}),Re(s,{recursive:!0});let a=S(i,`${Ke(t)}.${process.pid}.${Ie()}.tmp`);try{M(a,r,{spacing:2,trailingNewline:!0}),n?.("after-staged");try{Ue(a,t)}catch(o){if(o.code==="EEXIST")return!1;throw o}return se(s),n?.("after-published"),!0}finally{ze(a,{force:!0})}}function nt(e){let t=[];for(let r of P(S(e,V))){let n=U(r);n&&t.push(n)}return t}function it(e,t){return P(e).filter(r=>!t(r)).length}function P(e,t=".json"){return Ve(e)?Be(e,{withFileTypes:!0}).filter(r=>r.isFile()&&r.name.endsWith(t)).map(r=>S(e,r.name)).sort():[]}function B(e,t){try{let r=JSON.parse(v(e,"watch refresh request record"));return t(r)?r:null}catch{return null}}function st(e,t){return S(e,V,`${t}.json`)}function ot(e){if(e===void 0)return Ye;if(!Number.isFinite(e)||e<=0)throw new Error("Watch refresh request ttlMs must be positive.");return Math.floor(e)}function at(e){let t=e?.trim();return t?t.slice(0,512):void 0}function w(e){return typeof e=="string"&&/^[a-z0-9][a-z0-9-]{0,127}$/i.test(e)}function ct(e,t){return Date.parse(t)<Date.parse(e)?t:e}var We=5e3,ht=2e3,be=10,ft=new Set(["bench","config-validate","hook-context","hook-stop","init","reindex","setup","setup-agent","setup-ci","setup-hooks","uninstall","watch","work-audit"]);function Kt(e){let t=e.classification;if(t.kind!=="live")return;let{state:r}=t;return r.watcher.state==="idle"&&r.lastError===void 0?r.indexGeneration:void 0}function mt(e,t=process.env){return t.SCIP_QUERY_SKIP_WATCH_SERVICE!=="1"&&!e.startsWith("__")&&!ft.has(e)}function Jt(e){let t=e.env??process.env;if(t.SCIP_QUERY_SKIP_WATCH_SERVICE==="1")return{kind:"skipped",reason:"environment"};if(!mt(e.commandName,t))return{kind:"skipped",reason:"excluded-command"};if(e.config.watch?.enabled!==!0)return{kind:"skipped",reason:"disabled"};try{let r=gt({projectRoot:e.projectRoot,cacheDir:e.cacheDir,cliVersion:e.cliVersion,gitContext:e.gitContext,runtime:e.runtime});return{kind:r.disposition,state:r.state}}catch(r){return{kind:"failed",message:r instanceof Error?r.message:String(r)}}}function Ee(e,t,r){let n=N(L(e));if(r&&N(r.projectRoot)===n)return{projectRoot:n,worktreeKind:"git",worktreeId:r.worktreeId,cliVersion:t};let i=de(n);if(i.kind==="error")throw new Error(`Could not establish Git worktree identity for ${n}: ${i.message}`);return i.kind==="non-git"?{projectRoot:n,worktreeKind:"non-git",cliVersion:t}:{projectRoot:n,worktreeKind:"git",worktreeId:i.identity.worktreeId,cliVersion:t}}function Yt(e){return q(e,Ee(e.projectRoot,e.cliVersion,e.gitContext))}function q(e,t){let r=e.runtime??Q,n=R(e.cacheDir),i=G(n.statePath),s=Y(n.lockPath);return{identity:t,classification:yt(i,t,r.now(),r.isProcessAlive),lock:s,lockIsLive:s!==null&&r.isProcessAlive(s.pid),paths:n}}function gt(e){let t=e.runtime??Q,r=Ee(e.projectRoot,e.cliVersion,e.gitContext),n=q(e,r),i=K("ensure",n.classification);if(i.kind==="reuse")return x(n.paths.activityPath,t),{disposition:"reused",state:i.state};if(i.kind==="refuse-replace")throw new Error(`scip-query watch service pid ${i.state.pid} is still alive but its heartbeat is old. Refusing automatic replacement because civil-clock age alone cannot authorize a process signal.`);if(i.kind==="replace")J(i.state,e,t),k(n.paths,i.state.pid,t);else if(i.kind==="start"){if(n.lockIsLive){let o=Ce(e,r,t,Math.min(e.startupTimeoutMs??1e3,1e3));if(o)return x(n.paths.activityPath,t),{disposition:"reused",state:o};throw new Error(`scip-query watch is already running for ${L(e.projectRoot)} (pid ${n.lock?.pid}; lock: ${n.paths.lockPath}) without compatible daemon state. Stop the foreground watcher before starting the service.`)}n.classification.kind==="stale"&&k(n.paths,n.classification.state.pid,t)}else throw new Error(`Unexpected ensure action: ${i.kind}`);if(n=q(e,r),i=K("ensure",n.classification),i.kind==="reuse")return x(n.paths.activityPath,t),{disposition:"reused",state:i.state};if(i.kind==="refuse-replace")throw new Error(`scip-query watch service pid ${i.state.pid} remains alive with an old heartbeat; automatic replacement is not authorized.`);let s=e.serverPath??pt(new URL("./watch-server.js",import.meta.url));t.spawnServer(s,r.projectRoot,e.cliVersion,e.watchOverrides??{});let a=Ce(e,r,t,e.startupTimeoutMs??We);if(!a)throw new Error(`scip-query watch service did not become ready within ${e.startupTimeoutMs??We}ms.`);return x(n.paths.activityPath,t),{disposition:"started",state:a}}function Ae(e){let t=e.runtime??Q,r=R(e.cacheDir),n=G(r.statePath),i=n?t.isProcessAlive(n.pid)?{kind:"live",state:n}:{kind:"stale",state:n,reason:"dead-process"}:{kind:"stopped"},s=K("stop",i);if(s.kind==="signal-stop")return J(s.state,e,t),k(r,s.state.pid,t),{disposition:"stopped",pid:s.state.pid};if(s.kind==="clean-stale")return k(r,s.state.pid,t),{disposition:"stopped",pid:s.state.pid};let a=Y(r.lockPath);return s.kind==="already-stopped"&&a&&t.isProcessAlive(a.pid)?(J(a,e,t),k(r,a.pid,t),{disposition:"stopped",pid:a.pid}):{disposition:"already-stopped"}}function Pe(e,t=Date.now()){E(e,{version:1,at:new Date(t).toISOString()})}function Qt(e,t,r=Date.now(),n={}){we(R(lt(e)).refreshRequestsPath,t,{...n,now:()=>new Date(r)}),Pe(e,r)}function Xt(e,t,r={}){let n=r.pid??process.pid,i=r.isProcessAlive??y,s=()=>{},a=r.readProcessIdentity??D,o=r.now??(()=>new Date),c={...F,wallNow:()=>o().getTime(),isProcessAlive:i,readProcessIdentity:a},d=he(e,{kind:"watch",pid:n,processIdentity:a(n),detail:{projectRoot:L(t)},parseLegacy:_,runtime:c});if(d.kind==="contended"){let u=Te(d.observation);return{acquired:!1,lockPath:e,message:St(e,t,u),release:s}}return{acquired:!0,lockPath:e,message:"",release:()=>{d.lock.release()}}}function Y(e){return Te(H(e,{parseLegacy:_}))}var _=e=>{let t=xe(e);return t?{pid:t.pid,...t.processIdentity?{processIdentity:t.processIdentity}:{}}:null};function Te(e){if(e.state==="valid"&&e.record?.kind==="watch"){let t=e.record.detail?.projectRoot;return typeof t!="string"?null:{version:1,pid:e.record.pid,...e.record.processIdentity?{processIdentity:e.record.processIdentity}:{},projectRoot:t,startedAt:e.record.startedAt}}return xe(e.parsed)}function xe(e){try{let t=e;if(t.version!==1||typeof t.pid!="number"||!Number.isInteger(t.pid)||t.pid<=0||typeof t.projectRoot!="string"||!ce(t.startedAt))return null;let r=t.processIdentity===void 0?null:ne(t.processIdentity);return t.processIdentity!==void 0&&(!r||r.pid!==t.pid)?null:{version:1,pid:t.pid,...r?{processIdentity:r}:{},projectRoot:t.projectRoot,startedAt:t.startedAt}}catch{return null}}function yt(e,t,r,n){if(!e)return{kind:"stopped"};if(e.protocolVersion!==oe)return{kind:"incompatible",state:e,reason:"protocol"};if(e.projectRoot!==t.projectRoot)return{kind:"incompatible",state:e,reason:"project"};let i=t.worktreeKind==="git"?t.worktreeId:void 0;if(e.worktreeId!==i)return{kind:"incompatible",state:e,reason:"worktree"};if(e.cliVersion!==t.cliVersion)return{kind:"incompatible",state:e,reason:"cli-version"};if(!n(e.pid))return{kind:"stale",state:e,reason:"dead-process"};let s=Date.parse(e.heartbeatAt);return r-s>ae?{kind:"stale",state:e,reason:"old-heartbeat"}:{kind:"live",state:e}}function K(e,t){switch(e){case"status":return{kind:"report",classification:t};case"ensure":switch(t.kind){case"stopped":return{kind:"start"};case"stale":return t.reason==="old-heartbeat"?{kind:"refuse-replace",state:t.state,reason:"old-heartbeat"}:{kind:"start"};case"live":return{kind:"reuse",state:t.state};case"incompatible":return{kind:"replace",state:t.state};default:return z(t)}case"stop":switch(t.kind){case"stopped":return{kind:"already-stopped"};case"stale":return t.reason==="old-heartbeat"?{kind:"signal-stop",state:t.state}:{kind:"clean-stale",state:t.state};case"live":case"incompatible":return{kind:"signal-stop",state:t.state};default:return z(t)}default:return z(e)}}function Ce(e,t,r,n){let i=r.monotonicNow??b,s=i()+n;for(;i()<=s;){let a=q(e,t).classification;if(a.kind==="live")return a.state;r.sleep(be)}return null}function J(e,t,r){let{pid:n}=e;if(!r.isProcessAlive(n))return;Rt(e,r),r.signalProcess(n);let i=t.stopTimeoutMs??ht,s=r.monotonicNow??b,a=s()+i;for(;s()<=a;){if(!r.isProcessAlive(n))return;r.sleep(be)}throw new Error(`scip-query watch service pid ${n} did not stop within ${i}ms.`)}function k(e,t,r){if(ke(e.statePath,{force:!0}),ke(e.activityPath,{force:!0}),Y(e.lockPath)?.pid===t&&!r.isProcessAlive(t)){let i={...F,wallNow:r.now,isProcessAlive:r.isProcessAlive,readProcessIdentity:r.readProcessIdentity},s=H(e.lockPath,{parseLegacy:_,runtime:i});fe(e.lockPath,s,{parseLegacy:_,runtime:i})}}function St(e,t,r){return`error: scip-query watch is already running for ${L(t)}${r?` (pid ${r.pid}, started ${r.startedAt}; lock: ${e})`:` (lock: ${e})`}. Stop that watcher before starting another.`}function x(e,t){try{(t.recordActivity??Pe)(e,t.now())}catch(r){let n=vt(r);if(n!=="EPERM"&&n!=="EACCES"&&n!=="EROFS")throw r}}function vt(e){return e.code}var Q={now:Date.now,monotonicNow:b,isProcessAlive:y,readProcessIdentity:D,spawnServer(e,t,r,n){if(!ut(e))throw new Error(`Watch service helper was not found at ${e}. Run npm run build first.`);dt(process.execPath,[e,t,r,JSON.stringify(n)],{detached:!0,stdio:"ignore",env:{...process.env,SCIP_QUERY_SKIP_WATCH_SERVICE:"1"}}).unref()},signalProcess(e){process.kill(e,"SIGTERM")},sleep(e){let t=new Int32Array(new SharedArrayBuffer(4));Atomics.wait(t,0,0,e)}};function Rt(e,t){if(!e.processIdentity)throw new Error(`Refusing to signal scip-query watch pid ${e.pid}: its ownership record has no process identity.`);let r=t.readProcessIdentity(e.pid);if(!r)throw new Error(`Refusing to signal scip-query watch pid ${e.pid}: its process identity is unavailable.`);if(!ie(e.processIdentity,r))throw new Error(`Refusing to signal scip-query watch pid ${e.pid}: its process identity does not match the ownership record.`)}function z(e){throw new Error(`Unhandled watch service value: ${JSON.stringify(e)}`)}import{existsSync as Oe,lstatSync as O,readdirSync as De,realpathSync as qe,rmSync as W,statSync as Me}from"fs";import{join as h,resolve as C,sep as _e}from"path";var It=3600*1e3,wt=2*1024*1024*1024,kt=300*1e3;function Wt(e){let t=e.leases.filter(o=>o.managed&&!o.live&&!o.busy),r=Ge(e.leases,e.locks),n={};for(let o of e.generations)r.has(o.generationId)||(n[o.generationId]=o.unreferencedAt??e.nowMs);let i=e.generations.filter(o=>!r.has(o.generationId)).sort((o,c)=>n[o.generationId]-n[c.generationId]||o.generationId.localeCompare(c.generationId)),s=new Set;for(let o of i)e.nowMs-n[o.generationId]>=e.policy.generationTtlMs&&s.add(o.generationId);let a=e.generations.filter(o=>!s.has(o.generationId)).reduce((o,c)=>o+c.size,0);for(let o of i){if(a<=e.policy.budgetBytes)break;s.has(o.generationId)||(s.add(o.generationId),a-=o.size)}for(let o of s)delete n[o];return{deleteWorktrees:t,deleteGenerations:e.generations.filter(o=>s.has(o.generationId)),deleteLocks:e.locks.filter(o=>!o.live),deleteTemporaries:e.temporaries.filter(o=>!o.live),protectedGenerationIds:[...r].sort(),unreferencedSince:n}}function Ge(e,t){let r=new Set(e.filter(n=>n.managed&&(n.live||n.busy)).flatMap(n=>[n.lease.baseGenerationId,n.lease.activeGenerationId]).filter(n=>n!==void 0));for(let n of t)n.live&&r.add(n.generationId);return r}function pr(e,t,r={}){if(!pe())return{kind:"disabled"};let n=j(e);if(!n)return{kind:"unavailable"};let i=h(A(),"repositories",n.repositoryId);if(!Oe(i))return{kind:"unavailable"};let s=(r.now??Date.now)(),a=h(i,"gc-state.json"),o=Fe(a);if(!r.force&&o&&s-Date.parse(o.lastSweepAt)<kt)return{kind:"throttled",sweptAt:o.lastSweepAt};let c=me(i,{now:()=>s});if(!c)return{kind:"busy"};try{let d=je(e,i,n.repositoryId,o?.unreferencedSince??{}),u=Wt({nowMs:s,...d,policy:{generationTtlMs:r.policy?.generationTtlMs??It,budgetBytes:r.policy?.budgetBytes??wt}}),p=0,f=0;for(let l of u.deleteWorktrees){if(!Ne(l.lease))continue;let te=ge(h(l.lease.localCacheDir,"cache-lifecycle.lock"));if(te)try{if(Z(l.lease,!0))continue;try{Ae({projectRoot:l.lease.projectRoot,cacheDir:l.lease.localCacheDir,cliVersion:t})}catch{continue}if(Z(l.lease,!0))continue;W(l.lease.localCacheDir,{recursive:!0,force:!0}),W(l.leasePath,{force:!0}),f+=1}finally{te.release()}}for(let l of u.deleteLocks)W(l.path,{force:!0});for(let l of u.deleteTemporaries)W(l.path,{recursive:!0,force:!0});for(let l of u.deleteGenerations)W(l.path,{recursive:!0,force:!0}),p+=l.size;re(h(i,"evidence.db"));let g={kind:"swept",sweptAt:new Date(s).toISOString(),deletedWorktrees:f,deletedGenerations:u.deleteGenerations.length,deletedBytes:p,protectedGenerations:u.protectedGenerationIds.length},m={version:1,lastSweepAt:g.sweptAt,unreferencedSince:u.unreferencedSince,lastResult:g};return E(a,m,{spacing:2,trailingNewline:!0}),g}catch(d){return{kind:"failed",error:d instanceof Error?d.message:String(d)}}finally{c.release()}}function hr(e,t,r){let n=ye(e,r.dbPath,t);if(n)return{state:"bypassed",reason:n,localCacheDir:r.cacheDir,generations:0,generationBytes:0,protectedGenerations:0,unreferencedGenerations:0,unreferencedBytes:0,temporaryGenerations:0,sharedEvidence:{exists:!1,bytes:0}};let i=j(e);if(!i)return{state:"unavailable",reason:"Git worktree identity is unavailable",localCacheDir:r.cacheDir,generations:0,generationBytes:0,protectedGenerations:0,unreferencedGenerations:0,unreferencedBytes:0,temporaryGenerations:0,sharedEvidence:{exists:!1,bytes:0}};let s=h(A(),"repositories",i.repositoryId),a=$e(h(s,"worktrees",`${i.worktreeId}.json`)),o=Fe(h(s,"gc-state.json")),c=je(e,s,i.repositoryId,o?.unreferencedSince??{}),d=Ge(c.leases,c.locks),u=c.generations.filter(m=>!d.has(m.generationId)),p=c.generations.reduce((m,l)=>m+l.size,0),f=Se(e,t),g=0;return f&&(g=Ct(f)),{state:"managed",repositoryId:i.repositoryId,worktreeId:i.worktreeId,localCacheDir:r.cacheDir,...a?{baseGenerationId:a.baseGenerationId,activeGenerationId:a.activeGenerationId,lastAction:a.lastAction,reason:a.lastReason,lastSeenAt:a.lastSeenAt}:{},generations:c.generations.length,generationBytes:p,protectedGenerations:c.generations.filter(m=>d.has(m.generationId)).length,unreferencedGenerations:u.length,unreferencedBytes:u.reduce((m,l)=>m+l.size,0),temporaryGenerations:c.temporaries.length,sharedEvidence:{path:f,exists:g>0,bytes:g},cleanup:o?.lastResult}}function Ct(e){return[e,`${e}-wal`,`${e}-shm`].reduce((t,r)=>{try{return t+Me(r).size}catch{return t}},0)}function je(e,t,r,n){let i=new Set(ue(e).map(d=>C(d.path))),s=[];for(let d of X(h(t,"worktrees"))){if(!d.endsWith(".json"))continue;let u=h(t,"worktrees",d),p=$e(u);if(!p)continue;let f=C(p.projectRoot);s.push({leasePath:u,lease:p,managed:p.repositoryId===r&&Ne(p),live:i.has(f)||Oe(f),busy:Z(p)})}let a=[];for(let d of X(h(t,"locks"))){let u=/^([a-f0-9]{64})\.lock$/.exec(d);if(!u)continue;let p=h(t,"locks",d),f=ee(p),g=f!==void 0&&y(f),m=u[1];a.push({generationId:m,path:p,live:g})}let o=[],c=[];for(let d of X(h(t,"generations"))){let u=/^\.tmp-(\d+)-/.exec(d);if(u){let g=h(t,"generations",d),m=Number(u[1]);try{c.push({path:g,size:Le(g),live:Number.isSafeInteger(m)&&y(m)})}catch{}continue}if(!/^[a-f0-9]{64}$/.test(d))continue;let p=h(t,"generations",d),f;try{f=O(p)}catch{continue}!f.isDirectory()||f.isSymbolicLink()||o.push({generationId:d,path:p,size:Le(p),...n[d]===void 0?{}:{unreferencedAt:n[d]}})}return{leases:s,generations:o,locks:a,temporaries:c}}function Ne(e){if(e.ownershipChecksum!==ve(e)||$(e.localCacheDir)!==$(le(e.projectRoot)))return!1;let t=C(A()),r=C(h(t,"projects")),n=C(e.localCacheDir);if(!n.startsWith(`${r}${_e}`))return!1;try{let i=O(t),s=O(r),a=O(n);if(!i.isDirectory()||i.isSymbolicLink()||!s.isDirectory()||s.isSymbolicLink()||!a.isDirectory()||a.isSymbolicLink())return!1;let o=qe(r);return qe(n).startsWith(`${o}${_e}`)}catch{return!1}}function Z(e,t=!1){for(let n of t?["index.lock"]:["index.lock","cache-lifecycle.lock"]){let i=ee(h(e.localCacheDir,n));if(i!==void 0&&y(i))return!0}let r=ee(R(e.localCacheDir).lockPath);return r!==void 0&&y(r)}function $e(e){try{let t=JSON.parse(v(e,"worktree cache lease"));return t.version!==1||typeof t.repositoryId!="string"||typeof t.worktreeId!="string"||typeof t.projectRoot!="string"||t.treeOid!==void 0&&typeof t.treeOid!="string"||typeof t.localCacheDir!="string"||t.baseGenerationId!==void 0&&typeof t.baseGenerationId!="string"||t.activeGenerationId!==void 0&&typeof t.activeGenerationId!="string"||typeof t.ownershipChecksum!="string"||!/^[a-f0-9]{64}$/.test(t.ownershipChecksum)||typeof t.lastAction!="string"||t.lastReason!==void 0&&typeof t.lastReason!="string"||typeof t.lastSeenAt!="string"?null:t}catch{return null}}function ee(e){try{let t=JSON.parse(v(e,"watch lock record"));return typeof t.pid=="number"&&Number.isSafeInteger(t.pid)&&t.pid>0?t.pid:void 0}catch{return}}function Fe(e){try{let t=JSON.parse(v(e,"repository cache GC state"));return t.version!==1||typeof t.lastSweepAt!="string"||!Number.isFinite(Date.parse(t.lastSweepAt))||!t.unreferencedSince||typeof t.unreferencedSince!="object"||!t.lastResult?null:t}catch{return null}}function X(e){try{return De(e)}catch{return[]}}function Le(e){let t=0,r=[e];for(;r.length>0;){let n=r.pop();for(let i of De(n,{withFileTypes:!0})){let s=h(n,i.name);i.isDirectory()?r.push(s):i.isFile()&&(t+=Me(s).size)}}return t}export{Lt as a,Kt as b,mt as c,Jt as d,Yt as e,gt as f,Ae as g,Qt as h,Xt as i,pr as j,hr as k};
-//# sourceMappingURL=chunk-2465DLHK.js.map