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

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

@@ -30,11 +30,15 @@ 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 .` |
+| Typecheck | `basedpyright scip_cli/` |
 
-Pre-commit: ruff + ruff-format + full pytest. E2e before commit on command changes.
+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)
 
@@ -186,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.3.0 → scip_cli-2.5.0}/.pre-commit-config.yaml

@@ -5,11 +5,16 @@ repos:
       - id: ruff
         args: [--fix]
       - id: ruff-format
+  - repo: https://github.com/DetachHead/basedpyright-pre-commit-mirror
+    rev: 1.39.9
+    hooks:
+      - id: basedpyright
   - repo: local
     hooks:
       - id: pytest
         name: pytest
         entry: pytest
         language: python
+        additional_dependencies: [pytest>=7]
         pass_filenames: false
         always_run: true

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scip-cli
-Version: 2.3.0
+Version: 2.5.0
 Summary: Fast code intelligence via SCIP indexes
 Project-URL: Homepage, https://github.com/flesler/scip-cli
 Author: Ariel Flesler
@@ -12,6 +12,7 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Topic :: Software Development :: Code Generators
 Requires-Python: >=3.9
 Provides-Extra: dev
+Requires-Dist: basedpyright>=1.39.9; extra == 'dev'
 Requires-Dist: build>=1; extra == 'dev'
 Requires-Dist: pre-commit>=4.0; extra == 'dev'
 Requires-Dist: pytest>=7; extra == 'dev'
@@ -23,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
 
@@ -79,7 +80,7 @@ python -m venv .venv && source .venv/bin/activate
 pip install -e ".[dev]"
 ```
 
-Tests and lint: `pytest`, `ruff check .` from the same environment.
+Tests and lint: `pytest`, `ruff check .`, `basedpyright scip_cli/` from the same environment (or `scripts/test.sh` for the publish gate).
 
 ### 2. Install prerequisites (optional)
 
@@ -89,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`
 
@@ -106,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)
 ```
@@ -199,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)
@@ -218,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.
 
@@ -233,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.
 
@@ -250,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:
 
@@ -276,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.3.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
 
@@ -59,7 +59,7 @@ python -m venv .venv && source .venv/bin/activate
 pip install -e ".[dev]"
 ```
 
-Tests and lint: `pytest`, `ruff check .` from the same environment.
+Tests and lint: `pytest`, `ruff check .`, `basedpyright scip_cli/` from the same environment (or `scripts/test.sh` for the publish gate).
 
 ### 2. Install prerequisites (optional)
 
@@ -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.3.0 → scip_cli-2.5.0}/pyproject.toml

@@ -32,6 +32,7 @@ packages = ["scip_cli"]
 [project.optional-dependencies]
 dev = [
     "ruff>=0.11",
+    "basedpyright>=1.39.9",
     "pytest>=7",
     "pre-commit>=4.0",
     "build>=1",
@@ -57,3 +58,20 @@ addopts = "-q --tb=line --no-header"
 markers = [
     "integration: uses the shared indexed TS fixture (requires npx / scip-typescript)",
 ]
+
+[tool.basedpyright]
+pythonVersion = "3.10"
+venvPath = "."
+venv = ".venv"
+include = ["scip_cli"]
+exclude = ["tests"]
+
+# Gradual typing: basedpyright's unknown* rules fire hundreds of times on CLI/SQL glue
+# pythonVersion=3.10 matches union syntax in annotations; package still supports 3.9 via __future__ annotations
+reportAny = "none"
+reportUnknownParameterType = "none"
+reportUnknownArgumentType = "none"
+reportUnknownVariableType = "none"
+reportUnknownMemberType = "none"
+reportMissingParameterType = "none"
+reportUnusedCallResult = "none"

{scip_cli-2.3.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.3.0 → scip_cli-2.5.0}/scip_cli/__init__.py

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

{scip_cli-2.3.0 → scip_cli-2.5.0}/scip_cli/__main__.py

@@ -1,11 +1,14 @@
 """CLI entry point for scip-cli."""
 
+from __future__ import annotations
+
 import argparse
 import logging
 import os
 import shutil
 import sqlite3
 import sys
+from collections.abc import Callable
 
 from . import __version__
 from .cli_args import add_limit_argument, add_names_only_argument, add_path_argument, add_paths_only_argument
@@ -19,7 +22,7 @@ else:
     logging.disable(logging.DEBUG)
 
 
-def main():
+def main() -> None:
     parser = argparse.ArgumentParser(
         prog="scip-cli",
         description="Fast code intelligence via SCIP indexes",
@@ -45,7 +48,7 @@ def main():
         type=int,
         default=None,
         metavar="N",
-        help=("Max source lines per definition body (default: 80, env SCIP_CLI_MAX_DEF_LINES). Use 0 for unlimited."),
+        help="Max source lines per definition body (default: 80, env SCIP_CLI_MAX_DEF_LINES). Use 0 for unlimited.",
     )
     code_parser.add_argument(
         "--full",
@@ -151,7 +154,7 @@ def main():
         return
 
     # Dispatch to command handlers
-    dispatch = {
+    dispatch: dict[str, Callable[..., None]] = {
         "refs": refs.main,
         "code": code.main,
         "search": search.main,

{scip_cli-2.3.0 → scip_cli-2.5.0}/scip_cli/analyze/common.py

@@ -16,7 +16,7 @@ SYM_DEF_JOIN = """
 """
 
 
-def fetch_all(db, sql: str, params=()) -> list:
+def fetch_all(db, sql: str, params=()):
     return debug_execute(db, sql, params).fetchall()
 
 

{scip_cli-2.3.0 → scip_cli-2.5.0}/scip_cli/analyze/file.py

@@ -298,7 +298,7 @@ def top_symbol_pressure(db, relative_path: str, limit: int = DEFAULT_LIMIT) -> l
 
 
 def _bind_path(fn, relative_path: str):
-    def run(db, limit: int, **kwargs):
+    def run(db, limit: int, **_kwargs):
         return fn(db, relative_path, limit)
 
     return run

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

@@ -15,7 +15,7 @@ _EXTERNAL_MENTION = """
 """
 
 
-def _fetch_all(db, sql: str, params=()) -> list:
+def _fetch_all(db, sql: str, params=()):
     return debug_execute(db, sql, params).fetchall()
 
 
@@ -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.3.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})")
@@ -416,7 +423,6 @@ def run_all(
     budget=None,
 ) -> list[tuple[str, list[str], str | None]]:
     suffix = _scope_suffix(scope)
-    opts = {"include_tests": include_tests, "scope": scope, "budget": budget}
     checks = [
         Check("cycles", Priority.HIGH, f"Cycles (file dependencies){suffix}", cycles),
         Check("unreferenced", Priority.HIGH, f"Unreferenced symbols (no refs){suffix}", unreferenced_symbols),
@@ -438,4 +444,12 @@ def run_all(
         Check("bottlenecks", Priority.LOW, f"Bottlenecks (fan-in x fan-out){suffix}", bottlenecks),
         Check("hotspots", Priority.LOW, f"Hotspots (most referenced){suffix}", hotspots),
     ]
-    return run_checks(checks, db, limit, priorities, **opts)
+    return run_checks(
+        checks,
+        db,
+        limit,
+        priorities,
+        include_tests=include_tests,
+        scope=scope,
+        budget=budget,
+    )

{scip_cli-2.3.0 → scip_cli-2.5.0}/scip_cli/analyze/sections.py

@@ -5,7 +5,6 @@ from __future__ import annotations
 from collections.abc import Callable
 from dataclasses import dataclass
 from enum import Enum
-from typing import Any
 
 from .common import section
 
@@ -101,20 +100,23 @@ def run_checks(
     db,
     limit: int,
     priorities: set[Priority] | None,
-    **kwargs: Any,
+    *,
+    include_tests: bool = False,
+    scope: str | None = None,
+    budget: RowBudget | None = None,
 ) -> list[tuple[str, list[str], str | None]]:
     """Run checks in priority order (high → low), optionally filtered."""
     selected = [check for check in checks if priorities is None or check.priority in priorities]
     selected.sort(key=lambda check: (_ORDER.index(check.priority), check.key))
-    budget: RowBudget = kwargs.pop("budget", None) or RowBudget(remaining=limit)
+    budget_obj: RowBudget = budget or RowBudget(remaining=limit)
     sections: list[tuple[str, list[str], str | None]] = []
     for check in selected:
-        if budget.exhausted():
+        if budget_obj.exhausted():
             break
-        lines = check.run(db, budget.remaining, **kwargs)
+        lines = check.run(db, budget_obj.remaining, include_tests=include_tests, scope=scope)
         if lines != ["(none)"]:
-            lines = lines[: budget.remaining]
-            budget.remaining -= len(lines)
+            lines = lines[: budget_obj.remaining]
+            budget_obj.remaining -= len(lines)
         preface = check.false_positive_preface if check.false_positive_preface else _preface_for(check.key)
         sections.append(section(check.labeled_title(), lines, preface=preface))
     return sections

{scip_cli-2.3.0 → scip_cli-2.5.0}/scip_cli/analyze/symbol.py

@@ -8,14 +8,14 @@ from .sections import Check, Priority, run_checks
 
 
 def _bind_symbol(fn, symbol_id: int):
-    def run(db, limit: int, **kwargs):
+    def run(db, limit: int, **_kwargs):
         return fn(db, symbol_id, limit)
 
     return run
 
 
 def _bind_symbol0(fn, symbol_id: int):
-    def run(db, limit: int, **kwargs):
+    def run(db, _limit: int, **_kwargs):
         return fn(db, symbol_id)
 
     return run

{scip_cli-2.3.0 → scip_cli-2.5.0}/scip_cli/cache.py

@@ -1,5 +1,7 @@
 """Index cache path resolution."""
 
+from __future__ import annotations
+
 import contextlib
 import fcntl
 import hashlib
@@ -78,13 +80,13 @@ def project_cache_slug(project_root: Path) -> str:
     return f"{slug}-{digest}"
 
 
-def get_cache_dir(project_root):
+def get_cache_dir(project_root: Path | str) -> Path:
     """Get the cache directory for a project (one dir per repo root)."""
     root = Path(project_root).resolve()
     return Path.home() / ".cache" / "scip-cli" / "projects" / project_cache_slug(root)
 
 
-def find_db(project_root=None):
+def find_db(project_root: Path | str | None = None) -> Path | None:
     """Find the index.db for the given project (or cwd)."""
     root = project_root or find_project_root()
     if not root: