scip-cli 2.4.0__tar.gz → 2.5.0__tar.gz

{scip_cli-2.4.0 → scip_cli-2.5.0}/.cursor/rules/agent.mdc

@@ -30,6 +30,7 @@ Node.js + `npx` required for integration tests (`scip-typescript`). Optional: `S
 
 | Task | Command |
 |------|---------|
+| **All checks** | `scripts/test.sh` (lint + format + types + tests) |
 | Full suite | `pytest` |
 | E2e loop | `pytest tests/test_e2e.py tests/test_e2e_analyze_patterns.py` |
 | Lint / format | `ruff check .` / `ruff format .` |
@@ -37,6 +38,8 @@ Node.js + `npx` required for integration tests (`scip-typescript`). Optional: `S
 
 Pre-commit: ruff + ruff-format + basedpyright + full pytest. E2e before commit on command changes.
 
+**Use `scripts/test.sh`** before committing to catch all issues (lint, format, types, tests). This matches what pre-commit runs.
+
 ## Improving this repo (do this before review subagents)
 
 **Dogfood on the repo itself** — faster and more honest than spawning reviewers:
@@ -187,3 +190,20 @@ If both layers help during development, **keep both until e2e passes**, then del
 - User install + analyze guide → `README.md`
 - Agent/user CLI reference → `scip_cli/SKILL.md` (must match `__main__.py` flags)
 - After flag changes: update SKILL + README command list; run `scip-cli skill` to verify output
+
+
+## Dogfood Notes
+
+Future improvements from using the CLI on real projects.
+
+### Workflow
+
+Requires bare `scip-cli` mapped to local (`pip install -e ".[dev]"` from repo root).
+
+```bash
+scip-cli reindex
+scip-cli analyze --limit 25
+scip-cli analyze scip_cli/queries.py --limit 20   # drill into hubs
+```
+
+Project-wide analyze skips test paths by default; `--include-tests` to include. See README **Finding easy wins with analyze**.

scip_cli-2.5.0/.github/workflows/ci.yml

@@ -0,0 +1,22 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+      - name: Run publish gate
+        run: ./scripts/test.sh

{scip_cli-2.4.0 → scip_cli-2.5.0}/.pre-commit-config.yaml

@@ -15,5 +15,6 @@ repos:
         name: pytest
         entry: pytest
         language: python
+        additional_dependencies: [pytest>=7]
         pass_filenames: false
         always_run: true

{scip_cli-2.4.0 → scip_cli-2.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scip-cli
-Version: 2.4.0
+Version: 2.5.0
 Summary: Fast code intelligence via SCIP indexes
 Project-URL: Homepage, https://github.com/flesler/scip-cli
 Author: Ariel Flesler
@@ -24,7 +24,7 @@ Description-Content-Type: text/markdown
 [![PyPI version](https://badge.fury.io/py/scip-cli.svg)](https://badge.fury.io/py/scip-cli)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Token-efficient code intelligence for AI agents. Precise refs, definitions, and repo health analysis via SCIP indexes — TypeScript/JavaScript and Python.
+Token-efficient code intelligence for AI agents. Precise refs, definitions, and repo health analysis via SCIP indexes — TypeScript/JavaScript, Python, Go, and Rust.
 
 ## Why
 
@@ -90,7 +90,7 @@ On **first index**, scip-cli runs language indexers and builds a SQLite cache. Y
 
 Install `scip-cli` and run it. On first index, scip-cli will:
 
-- Download `scip-typescript` / `scip-python` via `npx` when not already on PATH
+- Download `scip-typescript` / `scip-python` via `npx`, `scip-go` via `go install`, or `rust-analyzer` via `rustup` when not already on PATH
 - Download the `scip` converter binary from [GitHub releases](https://github.com/scip-code/scip/releases) into `~/.cache/scip-cli/bin/` when not already on PATH
 - Walk the repo for `tsconfig*.json` project roots (TypeScript monorepos), run `scip-typescript` per project (parallel by default), convert each partial index, then merge into one `index.db`
 
@@ -107,6 +107,12 @@ npm install -g @sourcegraph/scip-typescript
 # Python indexer
 npm install -g @sourcegraph/scip-python
 
+# Go indexer
+go install github.com/scip-code/scip-go/cmd/scip-go@latest
+
+# Rust indexer (rust-analyzer with SCIP support)
+rustup component add rust-analyzer
+
 # SCIP CLI for index conversion (GitHub release — not on npm)
 # https://github.com/scip-code/scip/releases  (v0.8.1+ recommended)
 ```
@@ -200,9 +206,9 @@ scip-cli deps greet --paths-only | sort -u
 
 ## How It Works
 
-1. On first query, automatically detects project language from `package.json` (TS/JS) or `pyproject.toml`/`setup.py` (Python)
+1. On first query, automatically detects project language from `package.json` (TS/JS), `pyproject.toml`/`setup.py` (Python), `go.mod` (Go), or `Cargo.toml` (Rust)
 2. For TypeScript monorepos, walks the repository for `tsconfig*.json` project roots (nested ancestors deduped; root included only when its `include` is broad)
-3. Runs `scip-typescript` per project (in parallel when there are multiple projects; set `SCIP_CLI_INDEX_WORKERS=1` to force serial), or `scip-python` for Python
+3. Runs `scip-typescript` per project (in parallel when there are multiple projects; set `SCIP_CLI_INDEX_WORKERS=1` to force serial), `scip-python` for Python, `scip-go` for Go, or `rust-analyzer scip` for Rust
 4. Converts each SCIP output to SQLite with `scip expt-convert`, then merges partial databases when needed
 5. Caches the result in `~/.cache/scip-cli/projects/<dirname>-<hash>/index.db` (e.g. `my-monorepo-1a3f7a`)
 6. Subsequent queries are SQLite lookups against that cache (not re-indexing)
@@ -219,11 +225,23 @@ Optional `.scip-cli.json` in the project root:
 }
 ```
 
-- `maxHeapMb` — Node heap for `scip-typescript` / `scip-python` (default **8192 MB** when omitted). Overridden by `SCIP_CLI_MAX_HEAP_MB`. This is the V8 heap cap, not total RAM usage.
+- `maxHeapMb` — Node heap for `scip-typescript` / `scip-python` (default **8192 MB** when omitted). Overridden by `SCIP_CLI_MAX_HEAP_MB`. This is the V8 heap cap, not total RAM usage. Does not affect `scip-go`.
 - `indexRoots` — extra TypeScript project directories to include on **first index**, merged with auto-discovered projects.
 - `onlyIndexRoots` — skip auto-discovery and index **only** `indexRoots` (smaller initial index when you only care about part of a monorepo).
 
-`SCIP_CLI_INDEX_WORKERS` controls parallel `scip-typescript` runs during first index (default: up to 8). Merge into one database is always serial.
+`SCIP_CLI_INDEX_WORKERS` controls parallel indexer runs during first index (default: up to 8). Merge into one database is always serial.
+
+Other environment variables:
+
+| Variable                       | Purpose                                                                                       |
+| ------------------------------ | --------------------------------------------------------------------------------------------- |
+| `SCIP_CLI_MAX_HEAP_MB`         | Node heap for `scip-typescript` / `scip-python` (overrides `maxHeapMb` in config)             |
+| `SCIP_CLI_TS_INDEX_BATCH_SIZE` | Split large TS repos into multiple `scip-typescript` runs (default: all tsconfigs in one run) |
+| `SCIP_CLI_MERGE_BATCH_SIZE`    | SQLite ATTACH batch size when merging part DBs (max 9)                                        |
+| `SCIP_CLI_MAX_DEF_LINES`       | Max definition lines in `code` output                                                         |
+| `SCIP_CLI_DEBUG`               | Log SQL queries to stderr                                                                     |
+
+**Version policy:** only the `scip` converter (`expt-convert`) is pinned to the 0.8.x release line because it defines the SQLite schema. Language indexers (`scip-typescript`, `scip-python` via `npx`; `scip-go` via `go install @latest`) install at latest on first use. `rust-analyzer` installs via `rustup component add`.
 
 Large monorepos (>10 tsconfig projects) log per-project progress to stderr during indexing; smaller repos stay quiet aside from the final `Indexed … (size)` line.
 
@@ -234,7 +252,7 @@ scip-cli reindex --path packages/server
 scip-cli reindex --path packages/api --path packages/worker
 ```
 
-`--path` limits which discovered tsconfig projects are indexed (prefix match, same idea as query `--path`). The scope is saved as `index-scope.json` next to `index.db` and reused until you run a full `scip-cli reindex` with no `--path`.
+`--path` limits which discovered tsconfig projects are indexed (prefix match, same idea as query `--path`). **TypeScript only** — other languages reject `reindex --path`. The scope is saved as `index-scope.json` next to `index.db` and reused until you run a full `scip-cli reindex` with no `--path`.
 
 Run `scip-cli reindex` after changing scope, `.scip-cli.json` index settings, or when you want a fresh index.
 
@@ -251,24 +269,24 @@ scip-cli analyze --priority high --limit 25   # dead exports & cycles only
 
 Sections are tagged `[high]`, `[medium]`, `[low]` and listed in that order.
 
-| Tier | Project sections | Action |
-| ---- | ---------------- | ------ |
-| **high** | Cycles, unreferenced, dead exports, stale types | Nuke or fix cycles; delete unused; `_` prefix |
-| **medium** | Same-file only, change surface (file target) | Module-private by usage |
-| **low** | Test-only consumers, coupling, bottlenecks, hotspots | Noisy on Python (index omits many same-file calls); verify with `rg` |
+| Tier       | Project sections                                     | Action                                                               |
+| ---------- | ---------------------------------------------------- | -------------------------------------------------------------------- |
+| **high**   | Cycles, unreferenced, dead exports, stale types      | Nuke or fix cycles; delete unused; `_` prefix                        |
+| **medium** | Same-file only, change surface (file target)         | Module-private by usage                                              |
+| **low**    | Test-only consumers, coupling, bottlenecks, hotspots | Noisy on Python (index omits many same-file calls); verify with `rg` |
 
 Use `--priority high` for a quick gate; `--priority high,medium` adds context. File drill-down adds change surface and unused imports.
 
 **What to look at first**
 
-| Section | Easy pickings |
-| ------- | ------------- |
-| **Cycles** | Import/mention cycles between production files — break the edge or extract shared code |
-| **Unreferenced** | No usage in the index at all — delete |
-| **Dead exports** | No external refs — delete or `_` prefix |
-| **Stale types** | Classes/types with no external consumer in the index — verify in-file or type-only use before removing |
-| **Same-file only** | Used only inside defining file — rename to `_` |
-| **Test-only consumers** | Cross-file refs are all from tests — promote to e2e or accept as internal |
+| Section                 | Easy pickings                                                                                          |
+| ----------------------- | ------------------------------------------------------------------------------------------------------ |
+| **Cycles**              | Import/mention cycles between production files — break the edge or extract shared code                 |
+| **Unreferenced**        | No usage in the index at all — delete                                                                  |
+| **Dead exports**        | No external refs — delete or `_` prefix                                                                |
+| **Stale types**         | Classes/types with no external consumer in the index — verify in-file or type-only use before removing |
+| **Same-file only**      | Used only inside defining file — rename to `_`                                                         |
+| **Test-only consumers** | Cross-file refs are all from tests — promote to e2e or accept as internal                              |
 
 **Per-file or package drill-down** on hubs or suspects:
 
@@ -277,7 +295,7 @@ scip-cli analyze scip_cli/queries.py --limit 20   # file: scoped project + per-f
 scip-cli analyze scip_cli --limit 15              # directory: scoped project + each file under it
 ```
 
-`Dead exports in file` lists same-module symbols with no *external* refs — module-private `_helpers` are filtered out. Remaining rows are worth a manual `rg` check.
+`Dead exports in file` lists same-module symbols with no _external_ refs — module-private `_helpers` are filtered out. Remaining rows are worth a manual `rg` check.
 
 **Defaults:** project-wide and directory analyze skip `tests/`, `*.test.*`, `*.spec.*`, `conftest.py`, and `__tests__/`. Pass `--include-tests` to include them. File-target analyze always includes that file.
 

{scip_cli-2.4.0 → scip_cli-2.5.0}/README.md

@@ -3,7 +3,7 @@
 [![PyPI version](https://badge.fury.io/py/scip-cli.svg)](https://badge.fury.io/py/scip-cli)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Token-efficient code intelligence for AI agents. Precise refs, definitions, and repo health analysis via SCIP indexes — TypeScript/JavaScript and Python.
+Token-efficient code intelligence for AI agents. Precise refs, definitions, and repo health analysis via SCIP indexes — TypeScript/JavaScript, Python, Go, and Rust.
 
 ## Why
 
@@ -69,7 +69,7 @@ On **first index**, scip-cli runs language indexers and builds a SQLite cache. Y
 
 Install `scip-cli` and run it. On first index, scip-cli will:
 
-- Download `scip-typescript` / `scip-python` via `npx` when not already on PATH
+- Download `scip-typescript` / `scip-python` via `npx`, `scip-go` via `go install`, or `rust-analyzer` via `rustup` when not already on PATH
 - Download the `scip` converter binary from [GitHub releases](https://github.com/scip-code/scip/releases) into `~/.cache/scip-cli/bin/` when not already on PATH
 - Walk the repo for `tsconfig*.json` project roots (TypeScript monorepos), run `scip-typescript` per project (parallel by default), convert each partial index, then merge into one `index.db`
 
@@ -86,6 +86,12 @@ npm install -g @sourcegraph/scip-typescript
 # Python indexer
 npm install -g @sourcegraph/scip-python
 
+# Go indexer
+go install github.com/scip-code/scip-go/cmd/scip-go@latest
+
+# Rust indexer (rust-analyzer with SCIP support)
+rustup component add rust-analyzer
+
 # SCIP CLI for index conversion (GitHub release — not on npm)
 # https://github.com/scip-code/scip/releases  (v0.8.1+ recommended)
 ```
@@ -179,9 +185,9 @@ scip-cli deps greet --paths-only | sort -u
 
 ## How It Works
 
-1. On first query, automatically detects project language from `package.json` (TS/JS) or `pyproject.toml`/`setup.py` (Python)
+1. On first query, automatically detects project language from `package.json` (TS/JS), `pyproject.toml`/`setup.py` (Python), `go.mod` (Go), or `Cargo.toml` (Rust)
 2. For TypeScript monorepos, walks the repository for `tsconfig*.json` project roots (nested ancestors deduped; root included only when its `include` is broad)
-3. Runs `scip-typescript` per project (in parallel when there are multiple projects; set `SCIP_CLI_INDEX_WORKERS=1` to force serial), or `scip-python` for Python
+3. Runs `scip-typescript` per project (in parallel when there are multiple projects; set `SCIP_CLI_INDEX_WORKERS=1` to force serial), `scip-python` for Python, `scip-go` for Go, or `rust-analyzer scip` for Rust
 4. Converts each SCIP output to SQLite with `scip expt-convert`, then merges partial databases when needed
 5. Caches the result in `~/.cache/scip-cli/projects/<dirname>-<hash>/index.db` (e.g. `my-monorepo-1a3f7a`)
 6. Subsequent queries are SQLite lookups against that cache (not re-indexing)
@@ -198,11 +204,23 @@ Optional `.scip-cli.json` in the project root:
 }
 ```
 
-- `maxHeapMb` — Node heap for `scip-typescript` / `scip-python` (default **8192 MB** when omitted). Overridden by `SCIP_CLI_MAX_HEAP_MB`. This is the V8 heap cap, not total RAM usage.
+- `maxHeapMb` — Node heap for `scip-typescript` / `scip-python` (default **8192 MB** when omitted). Overridden by `SCIP_CLI_MAX_HEAP_MB`. This is the V8 heap cap, not total RAM usage. Does not affect `scip-go`.
 - `indexRoots` — extra TypeScript project directories to include on **first index**, merged with auto-discovered projects.
 - `onlyIndexRoots` — skip auto-discovery and index **only** `indexRoots` (smaller initial index when you only care about part of a monorepo).
 
-`SCIP_CLI_INDEX_WORKERS` controls parallel `scip-typescript` runs during first index (default: up to 8). Merge into one database is always serial.
+`SCIP_CLI_INDEX_WORKERS` controls parallel indexer runs during first index (default: up to 8). Merge into one database is always serial.
+
+Other environment variables:
+
+| Variable                       | Purpose                                                                                       |
+| ------------------------------ | --------------------------------------------------------------------------------------------- |
+| `SCIP_CLI_MAX_HEAP_MB`         | Node heap for `scip-typescript` / `scip-python` (overrides `maxHeapMb` in config)             |
+| `SCIP_CLI_TS_INDEX_BATCH_SIZE` | Split large TS repos into multiple `scip-typescript` runs (default: all tsconfigs in one run) |
+| `SCIP_CLI_MERGE_BATCH_SIZE`    | SQLite ATTACH batch size when merging part DBs (max 9)                                        |
+| `SCIP_CLI_MAX_DEF_LINES`       | Max definition lines in `code` output                                                         |
+| `SCIP_CLI_DEBUG`               | Log SQL queries to stderr                                                                     |
+
+**Version policy:** only the `scip` converter (`expt-convert`) is pinned to the 0.8.x release line because it defines the SQLite schema. Language indexers (`scip-typescript`, `scip-python` via `npx`; `scip-go` via `go install @latest`) install at latest on first use. `rust-analyzer` installs via `rustup component add`.
 
 Large monorepos (>10 tsconfig projects) log per-project progress to stderr during indexing; smaller repos stay quiet aside from the final `Indexed … (size)` line.
 
@@ -213,7 +231,7 @@ scip-cli reindex --path packages/server
 scip-cli reindex --path packages/api --path packages/worker
 ```
 
-`--path` limits which discovered tsconfig projects are indexed (prefix match, same idea as query `--path`). The scope is saved as `index-scope.json` next to `index.db` and reused until you run a full `scip-cli reindex` with no `--path`.
+`--path` limits which discovered tsconfig projects are indexed (prefix match, same idea as query `--path`). **TypeScript only** — other languages reject `reindex --path`. The scope is saved as `index-scope.json` next to `index.db` and reused until you run a full `scip-cli reindex` with no `--path`.
 
 Run `scip-cli reindex` after changing scope, `.scip-cli.json` index settings, or when you want a fresh index.
 
@@ -230,24 +248,24 @@ scip-cli analyze --priority high --limit 25   # dead exports & cycles only
 
 Sections are tagged `[high]`, `[medium]`, `[low]` and listed in that order.
 
-| Tier | Project sections | Action |
-| ---- | ---------------- | ------ |
-| **high** | Cycles, unreferenced, dead exports, stale types | Nuke or fix cycles; delete unused; `_` prefix |
-| **medium** | Same-file only, change surface (file target) | Module-private by usage |
-| **low** | Test-only consumers, coupling, bottlenecks, hotspots | Noisy on Python (index omits many same-file calls); verify with `rg` |
+| Tier       | Project sections                                     | Action                                                               |
+| ---------- | ---------------------------------------------------- | -------------------------------------------------------------------- |
+| **high**   | Cycles, unreferenced, dead exports, stale types      | Nuke or fix cycles; delete unused; `_` prefix                        |
+| **medium** | Same-file only, change surface (file target)         | Module-private by usage                                              |
+| **low**    | Test-only consumers, coupling, bottlenecks, hotspots | Noisy on Python (index omits many same-file calls); verify with `rg` |
 
 Use `--priority high` for a quick gate; `--priority high,medium` adds context. File drill-down adds change surface and unused imports.
 
 **What to look at first**
 
-| Section | Easy pickings |
-| ------- | ------------- |
-| **Cycles** | Import/mention cycles between production files — break the edge or extract shared code |
-| **Unreferenced** | No usage in the index at all — delete |
-| **Dead exports** | No external refs — delete or `_` prefix |
-| **Stale types** | Classes/types with no external consumer in the index — verify in-file or type-only use before removing |
-| **Same-file only** | Used only inside defining file — rename to `_` |
-| **Test-only consumers** | Cross-file refs are all from tests — promote to e2e or accept as internal |
+| Section                 | Easy pickings                                                                                          |
+| ----------------------- | ------------------------------------------------------------------------------------------------------ |
+| **Cycles**              | Import/mention cycles between production files — break the edge or extract shared code                 |
+| **Unreferenced**        | No usage in the index at all — delete                                                                  |
+| **Dead exports**        | No external refs — delete or `_` prefix                                                                |
+| **Stale types**         | Classes/types with no external consumer in the index — verify in-file or type-only use before removing |
+| **Same-file only**      | Used only inside defining file — rename to `_`                                                         |
+| **Test-only consumers** | Cross-file refs are all from tests — promote to e2e or accept as internal                              |
 
 **Per-file or package drill-down** on hubs or suspects:
 
@@ -256,7 +274,7 @@ scip-cli analyze scip_cli/queries.py --limit 20   # file: scoped project + per-f
 scip-cli analyze scip_cli --limit 15              # directory: scoped project + each file under it
 ```
 
-`Dead exports in file` lists same-module symbols with no *external* refs — module-private `_helpers` are filtered out. Remaining rows are worth a manual `rg` check.
+`Dead exports in file` lists same-module symbols with no _external_ refs — module-private `_helpers` are filtered out. Remaining rows are worth a manual `rg` check.
 
 **Defaults:** project-wide and directory analyze skip `tests/`, `*.test.*`, `*.spec.*`, `conftest.py`, and `__tests__/`. Pass `--include-tests` to include them. File-target analyze always includes that file.
 

{scip_cli-2.4.0 → scip_cli-2.5.0}/scip_cli/SKILL.md

@@ -1,9 +1,9 @@
 ---
 name: scip-cli
-description: Read when needing symbols, definitions, refs, members, or SQL health dashboards in TS/JS or Python
+description: Read when needing symbols, definitions, refs, members, or SQL health dashboards in TS/JS, Python, Go, or Rust
 ---
 
-TypeScript/JavaScript (.ts, .tsx, .js, .jsx) and Python (.py) — not GraphQL, CSS, or other files.
+TypeScript/JavaScript (.ts, .tsx, .js, .jsx), Python (.py), Go (.go), and Rust (.rs) — not GraphQL, CSS, or other files.
 
 All commands are sub-commands of `scip-cli`. Run from the project root.
 
@@ -27,10 +27,10 @@ All commands are sub-commands of `scip-cli`. Run from the project root.
 - **Bare names** resolve functions, types (aliases + interfaces), and classes. Use dotted qualifiers to disambiguate members: `code Widget.run`, `refs Foo.setBar`, `search MyClass.myMethod`, `members pkg.MyClass`. Type/object fields use the same form: `search Options.verbose`, `code Options.verbose`. Consts/let/var are not kept in the index (too many rows, single-line defs) — use `rg` or read the file. Class methods need `members ClassName`, not bare `code methodName`.
 - **Ambiguous types** (e.g. `Opts` in multiple hooks) — `code`/`refs` return all matches up to `--limit`; `members` and `analyze` pick the first match with a stderr warning. Use dotted qualifiers or `--path` to narrow.
 - **Stale index** — the cache is a snapshot; run `scip-cli reindex` after substantive code changes (no automatic invalidation).
-- **Query `--path` vs `reindex --path`** — query `--path` filters results only. `reindex --path` persists scope and **replaces** the cached index with only those tsconfig projects; run full `reindex` (no `--path`) to restore.
+- **Query `--path` vs `reindex --path`** — query `--path` filters results only. `reindex --path` is **TypeScript-only**: persists scope and **replaces** the cached index with only those tsconfig projects; run full `reindex` (no `--path`) to restore.
 - **First run** in a project may auto-index (one-time wait; large monorepos with many `tsconfig.json` files take longer). Projects index in parallel by default (`SCIP_CLI_INDEX_WORKERS`; merge is serial). Repos with more than 10 tsconfig projects log per-project progress to stderr. JS-only projects (no `tsconfig.json`) are supported automatically.
 - **Monorepos** are indexed by walking for `tsconfig*.json` under the repo (skips `node_modules`, `.git`, etc.). Nested parent/child projects are deduped. Add extra roots or limit indexing with `.scip-cli.json` (see README). Use query `--path packages/api` to scope lookups.
-- **Prerequisites**: Node.js (for `npx` indexers). The `scip` converter auto-downloads on first use if missing; `scip-typescript` / `scip-python` download via `npx`. Optional `.scip-cli.json` for extra index roots or heap tuning. `brew install scip` installs an unrelated optimization solver — scip-cli ignores it and downloads the real binary.
+- **Prerequisites**: Node.js (for TypeScript/Python via `npx`), Go toolchain (for Go via `go install`), or Rust toolchain (for Rust via `rustup`). The `scip` converter auto-downloads on first use if missing; `scip-typescript` / `scip-python` download via `npx`; `scip-go` downloads via `go install` to `~/go/bin`; `rust-analyzer` installs via `rustup component add`. Optional `.scip-cli.json` for extra index roots or heap tuning. `brew install scip` installs an unrelated optimization solver — scip-cli ignores it and downloads the real binary.
 
 ## Details
 

{scip_cli-2.4.0 → scip_cli-2.5.0}/scip_cli/__init__.py

@@ -1,3 +1,3 @@
 """scip-cli: Fast code intelligence via SCIP indexes."""
 
-__version__ = "2.4.0"
+__version__ = "2.5.0"

{scip_cli-2.4.0 → scip_cli-2.5.0}/scip_cli/analyze/live.py

@@ -155,6 +155,21 @@ def has_same_file_reference_usage(db, symbol_id: int, def_doc_id: int) -> bool:
     return row is not None
 
 
+def has_same_file_usage_mention(db, symbol_id: int, def_doc_id: int) -> bool:
+    """Non-definition mention in the defining file (in-file callers)."""
+    row = _fetch_one(
+        db,
+        """
+        SELECT 1 FROM mentions m
+        JOIN chunks c ON m.chunk_id = c.id
+        WHERE m.symbol_id = ? AND c.document_id = ? AND m.role != 1
+        LIMIT 1
+        """,
+        (symbol_id, def_doc_id),
+    )
+    return row is not None
+
+
 def file_has_scip_importers(db, relative_path: str, *, live: LiveIndex, def_doc_id: int) -> bool:
     """True when the index shows another file importing this module or its symbols."""
     if def_doc_id in live.live_module_docs:

{scip_cli-2.4.0 → scip_cli-2.5.0}/scip_cli/analyze/project.py

@@ -18,7 +18,12 @@ from .common import (
     stale_type_noise,
 )
 from .graph import FILE_EDGES_SQL, fetch_file_edges, find_longer_cycles
-from .live import LiveIndex, file_has_scip_importers, has_same_file_reference_usage
+from .live import (
+    LiveIndex,
+    file_has_scip_importers,
+    has_same_file_reference_usage,
+    has_same_file_usage_mention,
+)
 from .sections import Check, Priority, run_checks
 
 
@@ -165,6 +170,8 @@ def _format_dead_export_rows(
             continue
         if has_same_file_reference_usage(db, symbol_id, def_doc_id):
             continue
+        if has_same_file_usage_mention(db, symbol_id, def_doc_id):
+            continue
         if live.dead_export_noise(symbol, def_doc_id):
             continue
         lines.append(f"{short_name(symbol)}  loc={loc}  ({path})")

{scip_cli-2.4.0 → scip_cli-2.5.0}/scip_cli/commands/reindex.py

@@ -22,7 +22,7 @@ def main(args):
         sys.exit(1)
 
     path_args = getattr(args, "path", None) or []
-    if path_args and lang == Language.PYTHON:
+    if path_args and lang != Language.TYPESCRIPT:
         print("Error: reindex --path is only supported for TypeScript projects", file=sys.stderr)
         sys.exit(1)
 

{scip_cli-2.4.0 → scip_cli-2.5.0}/scip_cli/discover.py

@@ -19,6 +19,8 @@ _SKIP_DIR_NAMES = frozenset(
         ".turbo",
         ".nx",
         "tmp",
+        ".venv",
+        "venv",
     }
 )
 
@@ -121,3 +123,55 @@ def should_index_root_alongside_projects(root: Path, projects: list[Path]) -> bo
     if not root_tsconfig.is_file():
         return False
     return _tsconfig_covers_subdirectories(root_tsconfig)
+
+
+def _walk_marker_files(root: Path, marker_names: frozenset[str]) -> list[Path]:
+    """Return directories containing any of marker_names (relative to root)."""
+    root = root.resolve()
+    found: list[Path] = []
+
+    for dirpath, dirnames, filenames in os.walk(root):
+        dirnames[:] = [name for name in dirnames if name not in _SKIP_DIR_NAMES and not name.startswith(".")]
+        if not any(name in marker_names for name in filenames):
+            continue
+        project_dir = Path(dirpath).resolve()
+        try:
+            relative = project_dir.relative_to(root)
+        except ValueError:
+            continue
+        found.append(relative if relative.parts else Path("."))
+
+    return found
+
+
+def discover_golang_modules(root: Path) -> list[Path]:
+    """Return Go module directories (go.mod roots) under the repository."""
+    root = root.resolve()
+    modules = _walk_marker_files(root, frozenset({"go.mod"}))
+    if modules:
+        return sorted(set(modules), key=str)
+    if (root / "go.mod").is_file():
+        return [Path(".")]
+    return [Path(".")]
+
+
+def discover_python_projects(root: Path) -> list[Path]:
+    """Return Python package roots (pyproject.toml or setup.py) under the repository."""
+    root = root.resolve()
+    projects = _walk_marker_files(root, frozenset({"pyproject.toml", "setup.py"}))
+    if projects:
+        return sorted(set(projects), key=str)
+    if (root / "pyproject.toml").is_file() or (root / "setup.py").is_file():
+        return [Path(".")]
+    return [Path(".")]
+
+
+def discover_rust_crates(root: Path) -> list[Path]:
+    """Return Rust crate directories (Cargo.toml roots) under the repository."""
+    root = root.resolve()
+    crates = _walk_marker_files(root, frozenset({"Cargo.toml"}))
+    if crates:
+        return sorted(set(crates), key=str)
+    if (root / "Cargo.toml").is_file():
+        return [Path(".")]
+    return [Path(".")]

scip_cli-2.5.0/scip_cli/indexing/__init__.py

@@ -0,0 +1,29 @@
+"""SCIP index building and SQLite database access."""
+
+from __future__ import annotations
+
+from ..merge import merge_sqlite_indexes
+from .constants import (
+    DEFAULT_MAX_HEAP_MB,
+    DEFAULT_TS_INDEX_BATCH_SIZE,
+    MAX_TS_INDEX_BATCH_SIZE,
+)
+from .core import format_db_size, get_db, index_project, indexer_env, log_index_complete
+from .orchestrate import ts_index_batch_size
+from .runners import run_indexer_with_fallback
+from .typescript import typescript_projects
+
+__all__ = [
+    "DEFAULT_MAX_HEAP_MB",
+    "DEFAULT_TS_INDEX_BATCH_SIZE",
+    "MAX_TS_INDEX_BATCH_SIZE",
+    "format_db_size",
+    "get_db",
+    "index_project",
+    "indexer_env",
+    "log_index_complete",
+    "merge_sqlite_indexes",
+    "run_indexer_with_fallback",
+    "ts_index_batch_size",
+    "typescript_projects",
+]

scip_cli-2.5.0/scip_cli/indexing/constants.py

@@ -0,0 +1,13 @@
+"""Indexing constants."""
+
+INDEX_TIMEOUT = 300
+DEFAULT_MAX_HEAP_MB = 8192
+PROGRESS_LOG_MIN_PROJECTS = 10
+SCIP_INSTALL_URL = "https://github.com/scip-code/scip/releases"
+
+# Language indexers (npx / go install) use latest on first use.
+# The scip expt-convert binary is pinned separately in scip_tool.py (DB schema).
+# scip-typescript accepts many tsconfig paths per invocation (one .scip, one convert, no merge).
+# Split only when SCIP_CLI_TS_INDEX_BATCH_SIZE is set (OOM/timeout tuning).
+DEFAULT_TS_INDEX_BATCH_SIZE = None
+MAX_TS_INDEX_BATCH_SIZE = 2_147_483_647

scip_cli-2.5.0/scip_cli/indexing/convert.py

@@ -0,0 +1,94 @@
+"""SCIP protobuf to SQLite conversion."""
+
+from __future__ import annotations
+
+import os
+import re
+import sqlite3
+import sys
+from pathlib import Path
+
+from ..scip_tool import ensure_scip_binary
+from .constants import SCIP_INSTALL_URL
+from .postprocess import postprocess_index
+from .runners import run_subprocess
+
+_scip_version_warned = False
+
+
+def _scip_version(binary):
+    result = run_subprocess([binary, "--version"], cwd=os.getcwd())
+    if result.returncode != 0:
+        return None
+    match = re.search(r"v?(\d+)\.(\d+)\.(\d+)", result.stdout + result.stderr)
+    if not match:
+        return None
+    return tuple(int(part) for part in match.groups())
+
+
+def resolve_scip_binary():
+    """Locate the scip CLI used to convert protobuf indexes to SQLite."""
+    return str(ensure_scip_binary())
+
+
+def _warn_old_scip(binary):
+    global _scip_version_warned
+    if _scip_version_warned:
+        return
+    version = _scip_version(binary)
+    if version and version < (0, 8, 0):
+        _scip_version_warned = True
+        print(
+            f"Warning: {binary} {'.'.join(map(str, version))} is older than 0.8.0; "
+            + "upgrade from "
+            + f"{SCIP_INSTALL_URL} if indexing fails.",
+            file=sys.stderr,
+        )
+
+
+def project_path_prefix(project: Path | str | None) -> str | None:
+    if project is None:
+        return None
+    path = Path(project)
+    if path == Path("."):
+        return None
+    return path.as_posix()
+
+
+def prefix_document_paths(db_path: Path, prefix: str) -> None:
+    """Rewrite document paths to be relative to the repository root."""
+    conn = sqlite3.connect(str(db_path))
+    try:
+        conn.execute(
+            "UPDATE documents SET relative_path = ? || '/' || relative_path",
+            (prefix,),
+        )
+        conn.commit()
+    finally:
+        conn.close()
+
+
+def convert_scip_to_db(scip_path, db_path, *, document_path_prefix: Path | str | None = None):
+    """Convert a SCIP protobuf file to a SQLite index at db_path."""
+    db_path = Path(db_path)
+    db_path.parent.mkdir(parents=True, exist_ok=True)
+    if db_path.exists():
+        db_path.unlink()
+
+    scip_binary = resolve_scip_binary()
+    _warn_old_scip(scip_binary)
+
+    result = run_subprocess(
+        [scip_binary, "expt-convert", str(scip_path), "--output", db_path.name],
+        cwd=str(db_path.parent),
+    )
+    if result.returncode != 0:
+        print(result.stderr, file=sys.stderr)
+        raise RuntimeError("Failed to convert index")
+    if not db_path.exists():
+        raise RuntimeError("Failed to convert index")
+
+    postprocess_index(db_path)
+    prefix = project_path_prefix(document_path_prefix)
+    if prefix is not None:
+        prefix_document_paths(db_path, prefix)