scip-query 0.6.0 → 0.6.1

package/README.md

@@ -2,7 +2,7 @@
 
 Language-agnostic code intelligence CLI powered by [SCIP](https://github.com/sourcegraph/scip) indexes. Index any codebase, then query it for references, dependencies, dead code, similarity, coupling, and more — without an IDE or language server running.
 
-Works with every language that has a SCIP indexer: TypeScript, JavaScript, Java, Scala, Kotlin, Rust, Python, Ruby, Go, C/C++, C#, Dart, PHP.
+Works with every language that has a SCIP indexer: TypeScript, JavaScript, Vue, Java, Scala, Kotlin, Rust, Python, Ruby, Go, C/C++, C#, Visual Basic, Dart, PHP.
 
 ## Workflows
 
@@ -43,7 +43,7 @@ scip-query diff-impact                   # what did my changes affect?
 
 | Language | Indexer | Install |
 |---|---|---|
-| TypeScript / JavaScript | scip-typescript | `npm install -g @sourcegraph/scip-typescript` |
+| TypeScript / JavaScript / Vue | scip-typescript | `npm install -g @sourcegraph/scip-typescript` |
 | Java / Scala / Kotlin | scip-java | [releases](https://github.com/sourcegraph/scip-java/releases) |
 | Rust | rust-analyzer | Ships with rust-analyzer (`rust-analyzer scip`) |
 | Python | scip-python-plus | `npm install -g scip-python-plus` |
@@ -54,7 +54,9 @@ scip-query diff-impact                   # what did my changes affect?
 | Dart | scip-dart | [releases](https://github.com/nicovince/scip-dart/releases) |
 | PHP | scip-php | [releases](https://github.com/nicovince/scip-php/releases) |
 
-For Python, the npm package is `scip-python-plus`. Depending on which version you installed, the executable on your `PATH` may be `scip-python`, `scip-python-plus`, or both. `scip-query` now accepts either name.
+For Python, the npm package is `scip-python-plus`. Depending on which version you installed, the executable on your `PATH` may be `scip-python`, `scip-python-plus`, or both. `scip-query` accepts either name.
+
+Vue single-file components (`.vue`) are handled by the JavaScript/TypeScript indexer. `scip-query` extracts the `<script>` block (or `<script setup>`, picking the language from the `lang=` attribute) and parses it as TS/JS so symbol, reference, and import queries cover Vue components alongside regular `.ts`/`.js` files.
 
 ## How It Works
 
@@ -466,6 +468,8 @@ scip-query dead src/utils --skip-barrels --include-members
 - `--include-tests` — Include test files in results (excluded by default)
 - `--skip-barrels` — Ignore references from inactive barrel re-export files
 - `--include-members` — Include class members (module-level only by default)
+- `--only-dead` — Show only `[dead code]` symbols (skip `[file-internal only]`)
+- `--only-internal` — Show only `[file-internal only]` symbols (skip `[dead code]`)
 
 **Value:** Find code you can delete. The `--skip-barrels` flag is key when a codebase has unused barrels, but it now keeps live entry-surface barrels counted so active exports do not look dead.
 
@@ -695,7 +699,7 @@ These commands find duplication, redundancy, and extraction opportunities — th
 
 #### `similar [symbol]`
 
-Find functions with similar callee fingerprints using Jaccard similarity. Two functions that call the same set of symbols are likely doing the same work and are candidates for consolidation.
+Find functions with similar callee fingerprints using TF-IDF weighted cosine similarity. Each callee is weighted by how rare it is across the codebase — two functions sharing a niche helper (`sendWelcomeEmail()`) score much higher than two functions sharing infrastructure callees (`db.all()`, `shortenSymbol()`). The "shared" list shown for each pair is the high-IDF (significant) intersection, not every shared callee.
 
 Without a symbol argument, finds the top N most similar pairs across the codebase. With a symbol, finds what's most similar to that specific function.
 
@@ -716,10 +720,11 @@ scip-query similar dead --min-similarity 0.3
 ```
 
 **Options:**
-- `--min-similarity <n>` — Minimum Jaccard similarity 0-1 (default: 0.4)
+- `--min-similarity <n>` — Minimum cosine similarity 0-1 (default: 0.4)
 - `-n, --limit <n>` — Number of results (default: 20)
 - `-s, --scope <path>` — Limit to files matching path
 - `--min-callees <n>` — Minimum callees to consider a symbol (default: 4)
+- `--cross-file-only` — Only show cross-file pairs (skip same-file matches)
 
 **Value:** Finds "these two functions do basically the same thing" at scale. The shared callee list shows exactly what's duplicated. The unique callees show where they diverge — that's the parameterization point for a consolidated version.
 
@@ -743,7 +748,7 @@ scip-query similar-files auth.controller.ts
 - `--min-similarity <n>` — Minimum Jaccard similarity 0-1 (default: 0.5)
 - `-n, --limit <n>` — Number of results (default: 20)
 - `-s, --scope <path>` — Limit to files matching path
-- `--min-deps <n>` — Minimum dependencies to consider (default: 3)
+- `--min-deps <n>` — Minimum dependencies on the smaller side (auto-tunes by default; pass to override)
 
 **Value:** Finds copy-paste file variants and structurally redundant modules. When two files have 90%+ dependency overlap, they're likely doing similar jobs and should share code or be merged.
 
@@ -928,6 +933,7 @@ scip-query stale-abstractions --min-loc 5
 - `-s, --scope <path>` — Limit to files matching path
 - `--min-loc <n>` — Minimum LOC (default: 3)
 - `-n, --limit <n>` — Number of results (default: 30)
+- `--include-low-confidence` — Include 1-consumer classes (usually encapsulation, not stale)
 
 **Value:** An interface with one implementation isn't an abstraction — it's indirection. Finds over-engineering.
 
@@ -1076,6 +1082,7 @@ scip-query slice login --forward     # forward: what this feeds into
 
 **Options:**
 - `--forward` — Forward slice instead of backward (default: backward)
+- `--depth <n>` — Max transitive depth for backward slice (default: 3)
 
 **Value:** Backward slice shows inputs/dependencies. Forward slice shows outputs/effects. Useful for tracing data flow through error handling and concurrency paths.
 
@@ -1124,7 +1131,7 @@ scip-query similar-signatures --min-loc 5
 
 ## Programmatic API
 
-All 49 commands are available as TypeScript functions:
+Every CLI command is also a TypeScript function. The `queries` namespace exports cover all of them — including the `top*` variants of `fan-in`, `fan-out`, and `coupling`, plus `similarAll` for the cross-codebase mode of `similar`:
 
 ```typescript
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scip-query",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Language-agnostic code intelligence CLI powered by SCIP indexes",
   "type": "module",
   "main": "dist/index.js",

package/skills/concrete-plan/SKILL.md

@@ -67,7 +67,7 @@ This skill deliberately excludes `Grep` and `Read` from its allowed tools. This
 - Using `Read` via a subagent to browse files for discovery. Subagents must also use scip-query.
 - Spawning Explore agents that fall back to grep and file reads. If a subagent's output does not cite scip-query commands, reject its findings and re-run.
 
-**Instead, use scip-query (48 commands — full reference at `/Users/aydansalois/Documents/GitHub/scip-query/README.md`):**
+**Instead, use scip-query (full reference at `/Users/aydansalois/Documents/GitHub/scip-query/README.md`):**
 
 | You want to... | Use this |
 |---|---|
@@ -107,7 +107,7 @@ If none of these can answer your question, say so explicitly in the plan rather
 
 ### Full Documentation
 
-- **All 48 commands with options and examples:** `/Users/aydansalois/Documents/GitHub/scip-query/README.md`
+- **Every command with options and examples:** `/Users/aydansalois/Documents/GitHub/scip-query/README.md`
 - **Goal-oriented agent workflows:** `/Users/aydansalois/Documents/GitHub/scip-query/docs/AGENT_GUIDE.md`
 
 ---
@@ -255,7 +255,7 @@ When spawning any subagent for this planning process, **include the following bl
 
 You have the `scip-query` CLI for compiler-resolved code intelligence. Use it for ALL code references — do not use grep, rg, Read, or cat.
 
-### scip-query commands (48 total)
+### scip-query commands
 
 Navigation:
 - `scip-query code <symbol>` — read source code (bounded to definition range)

package/skills/scip-debloat/SKILL.md

@@ -73,7 +73,7 @@ scip-query code 'src/modules/chat/chat.service.ts:100-200'
 
 ---
 
-## The 10 Angles of Bloat
+## The 12 Angles of Bloat
 
 Run every one of these. Each catches a different class of problem. Skip none.
 
@@ -108,7 +108,7 @@ Stricter than dead code — these symbols reference nothing AND are referenced b
 scip-query similar --min-similarity 0.5 --min-callees 3
 ```
 
-Functions that call the same set of symbols. High Jaccard similarity = doing the same work.
+Functions that call the same set of symbols. Uses TF-IDF weighted cosine similarity over the callee set, so rare shared callees score higher than ubiquitous infrastructure ones — a high score means the pair shares meaningful work, not just the same `db` and `logger`.
 
 For each high-similarity pair, get the consolidation prescription:
 
@@ -263,7 +263,6 @@ scip-query deep-chains --min-depth 5       # Excessively deep dependency chains
 scip-query bottlenecks -n 10               # Coupling pressure points
 scip-query complexity-hotspots -n 10       # Riskiest symbols
 scip-query hotspots -n 10                  # Most-referenced symbols
-scip-query doc-coverage --min-loc 5        # Documentation coverage
 ```
 
 ---
@@ -281,7 +280,7 @@ Read the health score, the findings breakdown, and the prioritized action list.
 
 ### Phase 2: Deep Scan (10-15 minutes)
 
-Run all 10 angles plus the structural assessment. For each:
+Run all 12 angles plus the structural assessment. For each:
 1. Run the command
 2. Record the count and top findings
 3. For actionable findings, drill deeper (e.g., `convergence` for similar pairs)
@@ -349,7 +348,6 @@ The report is a markdown file with:
 - Max dependency chain depth: N
 - Coupling bottlenecks: [top 5]
 - Complexity hotspots: [top 5]
-- Doc coverage: N%
 ```
 
 Every finding includes the scip-query command that produced it.
@@ -402,7 +400,6 @@ Do NOT use grep, rg, or Read. Use only scip-query commands.
 | Coupling pressure | `scip-query bottlenecks -n 10` |
 | Complexity hotspots | `scip-query complexity-hotspots -n 10` |
 | Most-referenced | `scip-query hotspots -n 10` |
-| Doc coverage | `scip-query doc-coverage` |
 | Redundant re-exports | `scip-query redundant-reexports` |
 | Similar signatures | `scip-query similar-signatures --min-loc 5` |
 | Read source | `scip-query code <symbol>` |

package/skills/scip-language-playbook/SKILL.md

@@ -62,6 +62,8 @@ scip-query redundant-reexports
 
 Why this row is strong: TypeScript has the broadest verified command surface in the current suite, especially for imports, members, call flow, change risk, and DRY analysis.
 
+Vue note: `.vue` single-file components are handled by the same path. scip-query extracts the `<script>` (or `<script setup>`) block and parses it as TS/JS, so the TypeScript commands above also work on the Vue file's `<script>` symbols. Identifiers used only in `<template>`/`<style>` are tracked through a separate identifier scan so they don't show up as unused imports.
+
 ### Python
 
 Use first: