scip-cli 2.6.0__tar.gz → 2.8.0__tar.gz

{scip_cli-2.6.0 → scip_cli-2.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: scip-cli
-Version: 2.6.0
+Version: 2.8.0
 Summary: Fast code intelligence via SCIP indexes
 Project-URL: Homepage, https://github.com/flesler/scip-cli
 Author: Ariel Flesler
@@ -153,7 +153,7 @@ scip-cli <command> [arguments]
 - `rdeps <file>` - Find files that depend on a file (`--path`)
 - `deps <symbol|file>` - Find outbound dependencies (what a symbol or file calls) (`--path`, `--paths-only`)
 - `members <symbol>` - List members of a class/interface (`--path`)
-- `analyze [target]` - SQL health dashboards (`--limit`, `--priority`, `--include-tests`). No target: project-wide; directory or file path; symbol name. See [Finding easy wins with `analyze`](#finding-easy-wins-with-analyze).
+- `analyze [target]` - SQL health dashboards (`--limit`, `--priority`, `--check`, `--include-tests`). No target: project-wide; directory or file path; symbol name. See [Finding easy wins with `analyze`](#finding-easy-wins-with-analyze).
 - `reindex` - Force re-indexing of the current project (`--path` to limit scope; repeatable)
 - `skill [path]` - Install or dump the SKILL.md
 
@@ -280,15 +280,17 @@ Use `analyze` on the repo itself before broad refactors or agent review — it s
 ```bash
 scip-cli analyze --limit 25
 scip-cli analyze --priority high --limit 25   # dead exports & cycles only
+scip-cli analyze --check cycles --limit 25    # one named section
+scip-cli analyze --check dead_files --limit 25
 ```
 
 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, dead files, 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.
 

{scip_cli-2.6.0 → scip_cli-2.8.0}/README.md

@@ -132,7 +132,7 @@ scip-cli <command> [arguments]
 - `rdeps <file>` - Find files that depend on a file (`--path`)
 - `deps <symbol|file>` - Find outbound dependencies (what a symbol or file calls) (`--path`, `--paths-only`)
 - `members <symbol>` - List members of a class/interface (`--path`)
-- `analyze [target]` - SQL health dashboards (`--limit`, `--priority`, `--include-tests`). No target: project-wide; directory or file path; symbol name. See [Finding easy wins with `analyze`](#finding-easy-wins-with-analyze).
+- `analyze [target]` - SQL health dashboards (`--limit`, `--priority`, `--check`, `--include-tests`). No target: project-wide; directory or file path; symbol name. See [Finding easy wins with `analyze`](#finding-easy-wins-with-analyze).
 - `reindex` - Force re-indexing of the current project (`--path` to limit scope; repeatable)
 - `skill [path]` - Install or dump the SKILL.md
 
@@ -259,15 +259,17 @@ Use `analyze` on the repo itself before broad refactors or agent review — it s
 ```bash
 scip-cli analyze --limit 25
 scip-cli analyze --priority high --limit 25   # dead exports & cycles only
+scip-cli analyze --check cycles --limit 25    # one named section
+scip-cli analyze --check dead_files --limit 25
 ```
 
 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, dead files, 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.
 

scip_cli-2.8.0/docs/port-v28-board.md

@@ -0,0 +1,32 @@
+# v2.8.0 multi-port board
+
+**Goal:** Ship Python v2.8.0 (exclude globs), then port full v2.6.0→v2.8.0 gap to go/rust/zig in `/tmp`, direct-to-main, smoke-tested. Mirror GitHub releases optional.
+
+**Frozen reference:** `/tmp/scip-cli-2.8.0-freeze.patch` (pre-commit snapshot)
+
+## Gap to port (per mirror)
+
+| Release | Features | Manual port |
+|---|---|---|
+| v2.7.0 | `analyze --check`, `dead_files`, section FP warnings | analyze/*, commands/analyze, tests |
+| v2.8.0 | `reindex --exclude`, `excludeGlobs`, post-process prune | exclude, indexing, config, reindex, tests |
+
+`scripts/sync-upstream.sh --ref v2.8.0` covers SKILL, fixtures, templates only.
+
+## Lanes
+
+| Lane | Path | Status | Notes |
+|---|---|---|---|
+| P0 Python | `~/Code/scip-cli` | in progress | commit → v2.8.0 → push → release |
+| G1-go | `/tmp/scip-cli-go` | pending | direct-to-main |
+| G1-rust | `/tmp/scip-cli-rust` | pending | direct-to-main |
+| G1-zig | `/tmp/scip-cli-zig` | pending | direct-to-main |
+
+## Verify log
+
+| Check | Python | Go | Rust | Zig |
+|---|---|---|---|---|
+| scripts/test.sh | | | | |
+| exclude dogfood | | | | |
+| analyze --check | n/a | | | |
+| readonly /iterate review | | | | |

{scip_cli-2.6.0 → scip_cli-2.8.0}/scip_cli/SKILL.md

@@ -133,7 +133,7 @@ Returns `startLine:endLine kind name` for each member. Members are found via SCI
 ### analyze
 
 ```bash
-analyze [--limit N] [--path PATH] [--include-tests] [target]
+analyze [--limit N] [--path PATH] [--include-tests] [--priority LEVEL] [--check NAME] [target]
 ```
 
 | Target                                 | Output                                                                                          |
@@ -143,22 +143,26 @@ analyze [--limit N] [--path PATH] [--include-tests] [target]
 | **file**                               | Scoped project dashboards for that file + per-file sections + top symbols by external consumers |
 | **symbol**                             | Symbol pressure, consumers, dependencies, affected                                              |
 
-Sections are ordered **high → medium → low**. `[high]` cycles, unreferenced, dead exports, stale types; `[medium]` same-file-only, change surface (file); `[low]` test-only consumers (noisy on Python), coupling, bottlenecks, hotspots.
+Sections are ordered **high → medium → low**. `[high]` cycles, unreferenced, dead exports, dead files, stale types; `[medium]` same-file-only, change surface (file); `[low]` test-only consumers (noisy on Python), coupling, bottlenecks, hotspots.
 
 `--limit` caps **result rows across the whole run** (default 20); remaining checks are skipped once the cap is reached. `(none)` sections and section headers do not count.
 
 `--priority high` or `--priority high,medium` (also `1`/`2`/`3`) skips lower tiers.
 
+`--check NAME` (repeatable or comma-separated) runs only those sections and ANDs with `--priority`. Unknown names error. A name that exists for another target (e.g. `unused_imports` on a project-wide run) yields no matching sections.
+
 Directory detection uses the filesystem when present, otherwise an indexed path prefix. `--path` narrows ambiguous file/symbol resolution only (not directory scope — pass the dir as `target`).
 
 **Dogfood loop:** `reindex` → `analyze --limit 25` → `analyze scip_cli` or `analyze scip_cli/queries.py` on suspects. Skips test paths in project-wide and directory runs (`tests/`, `*.test.*`, `*.spec.*`); `--include-tests` to include them. File-target analyze always includes that file.
 
-**Easy pickings:** **Cycles** and **dead exports** (production paths) — cross-file cleanup. **Stale types** — types with no external refs in the index. Ignore `analyze/*` section helpers in dead exports. “Dead” = no refs from _other_ files in the index, not `vulture`.
+**Easy pickings:** **Cycles**, **dead exports**, and **dead files** (production paths) — cross-file cleanup. **Stale types** — types with no external refs in the index. Ignore `analyze/*` section helpers in dead exports. “Dead” = no refs from _other_ files in the index (empty `rdeps` for files), not `vulture`. Sections with hits print a short false-positive caveat; `export const` arrows often look like dead files because SCIP indexes the module only.
 
 ### reindex
 
 ```bash
-reindex [--path DIR ...] [--tsconfig FILE_OR_GLOB ...] [--with-external]
+reindex [--path DIR ...] [--tsconfig FILE_OR_GLOB ...] [--exclude GLOB ...] [--with-external]
 ```
 
 `--path` and `--tsconfig` cannot be combined (**TypeScript only**). `--tsconfig` takes `tsconfig*.json` files (repeatable; globs expanded inside the tool). File-based runs default to one `scip-typescript` process per file so each gets its own heap (`SCIP_CLI_TS_INDEX_BATCH_SIZE` still overrides). Scope is saved as `index-scope.json` and reused until a full `reindex` with neither flag.
+
+`--exclude GLOB` omits matching files from the SQLite index after conversion (repeatable; merged with `excludeGlobs` in `.scip-cli.json`). Persisted in `index-exclude.json` until a full `reindex` with no `--exclude`. Patterns without `/` match basenames (`*.test.ts`); patterns with `/` match repo-relative paths (`tests/**`, `**/__tests__/**`). Indexers still parse excluded files when production code imports them — post-process removal is authoritative.

{scip_cli-2.6.0 → scip_cli-2.8.0}/scip_cli/__init__.py

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

{scip_cli-2.6.0 → scip_cli-2.8.0}/scip_cli/__main__.py

@@ -141,6 +141,12 @@ def main() -> None:
         metavar="LEVEL",
         help="Comma-separated check tiers: high, medium, low (or 1/2/3). Default: all. E.g. high or high,medium",
     )
+    analyze_parser.add_argument(
+        "--check",
+        action="append",
+        metavar="NAME",
+        help="Run only these checks (repeatable or comma-separated). ANDs with --priority",
+    )
 
     # reindex
     reindex_parser = subparsers.add_parser("reindex", help="Force re-indexing of the current project")
@@ -160,6 +166,15 @@ def main() -> None:
             "Cannot be combined with --path."
         ),
     )
+    reindex_parser.add_argument(
+        "--exclude",
+        action="append",
+        metavar="GLOB",
+        help=(
+            "Omit indexed files matching GLOB from the SQLite index "
+            "(repeatable; merged with excludeGlobs in .scip-cli.json; persisted until full reindex)"
+        ),
+    )
     reindex_parser.add_argument(
         "--with-external",
         action="store_true",

{scip_cli-2.6.0 → scip_cli-2.8.0}/scip_cli/analyze/file.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 
 from .common import DEFAULT_LIMIT, SYM_DEF_JOIN, analyze_noise, fetch_all, short_name
 from .live import LiveIndex, file_has_scip_importers, has_same_file_reference_usage
-from .sections import Check, Priority, run_checks
+from .sections import FALSE_POSITIVE_PREFACES, Check, Priority, run_checks
 from .symbol import symbol_pressure
 
 
@@ -302,6 +302,7 @@ def _file_checks(relative_path: str, *, include_top_symbols: bool) -> list[Check
             Priority.HIGH,
             f"Unreferenced in file {title}",
             _bind_path(unreferenced_in_file, relative_path),
+            false_positive_preface=FALSE_POSITIVE_PREFACES["unreferenced_in_file"],
         ),
         Check(
             "dead_in_file",
@@ -340,8 +341,9 @@ def _run_file_checks(
     priorities,
     *,
     budget=None,
+    check_keys=None,
 ) -> list[tuple[str, list[str], str | None]]:
-    return run_checks(checks, db, limit, priorities, budget=budget)
+    return run_checks(checks, db, limit, priorities, budget=budget, check_keys=check_keys)
 
 
 def run_all(
@@ -350,6 +352,7 @@ def run_all(
     limit: int = DEFAULT_LIMIT,
     priorities=None,
     budget=None,
+    check_keys=None,
 ) -> list[tuple[str, list[str], str | None]]:
     return _run_file_checks(
         _file_checks(relative_path, include_top_symbols=True),
@@ -357,6 +360,7 @@ def run_all(
         limit,
         priorities,
         budget=budget,
+        check_keys=check_keys,
     )
 
 
@@ -366,6 +370,7 @@ def run_all_sections_only(
     limit: int = DEFAULT_LIMIT,
     priorities=None,
     budget=None,
+    check_keys=None,
 ) -> list[tuple[str, list[str], str | None]]:
     """Per-file sections without top-symbols (directory batch)."""
     return _run_file_checks(
@@ -374,4 +379,5 @@ def run_all_sections_only(
         limit,
         priorities,
         budget=budget,
+        check_keys=check_keys,
     )

{scip_cli-2.6.0 → scip_cli-2.8.0}/scip_cli/analyze/project.py

@@ -13,6 +13,7 @@ from .common import (
     cycle_path_noise,
     fetch_all,
     file_pair_noise,
+    is_generated_analyze_path,
     is_test_path,
     short_name,
     stale_type_noise,
@@ -379,6 +380,44 @@ def dead_exports(
     return _format_dead_export_rows(db, rows, LiveIndex(db), include_tests=include_tests, limit=limit)
 
 
+def dead_files(
+    db,
+    limit: int = DEFAULT_LIMIT,
+    *,
+    include_tests: bool = False,
+    scope: str | None = None,
+) -> list[str]:
+    """Files with no inbound mentions from other documents (empty rdeps)."""
+    scope_clause, scope_params = path_filter_sql(db, scope, doc_alias="d")
+    rows = fetch_all(
+        db,
+        f"""
+        SELECT d.relative_path
+        FROM documents d
+        WHERE NOT EXISTS (
+            SELECT 1
+            FROM defn_enclosing_ranges der
+            JOIN mentions m ON m.symbol_id = der.symbol_id AND m.role != 1
+            JOIN chunks c ON m.chunk_id = c.id
+            WHERE der.document_id = d.id AND c.document_id != d.id
+        ){scope_clause}
+        ORDER BY d.relative_path
+        LIMIT ?
+        """,
+        (*scope_params, limit * 5),
+    )
+    lines: list[str] = []
+    for (path,) in rows:
+        if not include_tests and is_test_path(path):
+            continue
+        if is_generated_analyze_path(path):
+            continue
+        lines.append(path)
+        if len(lines) >= limit:
+            break
+    return lines
+
+
 def top_coupling(
     db,
     limit: int = DEFAULT_LIMIT,
@@ -421,6 +460,7 @@ def run_all(
     scope: str | None = None,
     priorities=None,
     budget=None,
+    check_keys=None,
 ) -> list[tuple[str, list[str], str | None]]:
     suffix = _scope_suffix(scope)
     checks = [
@@ -432,6 +472,7 @@ def run_all(
             f"Dead exports (no in-file or external use){suffix}",
             dead_exports,
         ),
+        Check("dead_files", Priority.HIGH, f"Dead files (no importers){suffix}", dead_files),
         Check("stale_types", Priority.HIGH, f"Stale types (no external consumers){suffix}", stale_types),
         Check("same_file_only", Priority.MEDIUM, f"Same-file only (in-file use, not exported){suffix}", same_file_only),
         Check(
@@ -452,4 +493,5 @@ def run_all(
         include_tests=include_tests,
         scope=scope,
         budget=budget,
+        check_keys=check_keys,
     )

{scip_cli-2.6.0 → scip_cli-2.8.0}/scip_cli/analyze/sections.py

@@ -48,6 +48,54 @@ def parse_priorities(value: str | None) -> set[Priority] | None:
     return out
 
 
+# Project, file, and symbol Check.key values. --check rejects anything else.
+CHECK_KEYS = frozenset(
+    {
+        "affected",
+        "bottlenecks",
+        "change_surface",
+        "consumer_files",
+        "coupling",
+        "cycles",
+        "dead_exports",
+        "dead_files",
+        "dead_in_file",
+        "def_context",
+        "dependencies",
+        "file_consumers",
+        "hotspots",
+        "imports_summary",
+        "same_file_only",
+        "stale_types",
+        "symbol_pressure",
+        "test_only",
+        "top_coupling",
+        "top_symbols",
+        "unreferenced",
+        "unused_imports",
+    }
+)
+
+
+def parse_checks(values: list[str] | None) -> set[str] | None:
+    """Parse --check (repeatable; commas allowed). None means all checks."""
+    if not values:
+        return None
+    out: set[str] = set()
+    for value in values:
+        for part in value.replace(" ", "").split(","):
+            if not part:
+                continue
+            key = part.lower()
+            if key not in CHECK_KEYS:
+                allowed = ", ".join(sorted(CHECK_KEYS))
+                raise RuntimeError(f"unknown analyze check {part!r} (use {allowed})")
+            out.add(key)
+    if not out:
+        return None
+    return out
+
+
 @dataclass(frozen=True)
 class Check:
     key: str
@@ -60,24 +108,38 @@ class Check:
         return f"[{self.priority.value}] {self.title}"
 
 
-# Shown only when the section has hits (not "(none)").
+# Shown only when the section has hits (not "(none)"). Situation hints, not exhaustive.
 FALSE_POSITIVE_PREFACES: dict[str, str] = {
     "dead_exports": (
-        "SCIP may miss dynamic loading (loadFiles, GraphQL) and default-export object members "
-        "— verify with rdeps/rg before deleting."
+        "SCIP may miss dynamic loading (loadFiles, GraphQL), default-export object members, "
+        "and some export const arrows — verify with rdeps/rg before deleting."
+    ),
+    "dead_files": (
+        "Empty rdeps in the index. SCIP often records export const / arrow files as module-only, "
+        "so named imports (routes, barrels) may not count; same for dynamic require. Confirm with rg."
     ),
     "unreferenced": (
-        "No mentions in the index — symbols may still run via dynamic import or side-effect registration."
+        "No mentions in the index — may still run via dynamic import, side-effect registration, "
+        "or a call SCIP did not record."
+    ),
+    "same_file_only": (
+        "Referenced only in the defining file — often handlers or private helpers, "
+        "or an external call SCIP missed; not necessarily a dead export."
+    ),
+    "stale_types": (
+        "No cross-file refs in the index — may still be used in-file, as a type-only import SCIP dropped, "
+        "or as a structural shape."
     ),
-    "same_file_only": ("Referenced only in the defining file — often handlers or private helpers, not dead exports."),
-    "stale_types": ("No cross-file refs in the index — may still be used in-file or as a type-only shape."),
     "cycles": "Remaining cycles may be barrel re-exports; confirm before refactoring.",
     "dead_in_file": (
-        "SCIP may miss dynamic loading and default-export indirection — verify with rdeps/rg before deleting."
+        "SCIP may miss dynamic loading, default-export indirection, and some export const arrows "
+        "— verify with rdeps/rg before deleting."
     ),
     "unreferenced_in_file": (
         "No mentions in the index — may still be used in-file via handlers or dynamic registration."
     ),
+    "unused_imports": ("Import may still be a type-only use or a name SCIP did not bind — confirm before removing."),
+    "test_only": "Index may miss same-file production calls, so this can look test-only when it is not.",
 }
 
 
@@ -104,9 +166,12 @@ def run_checks(
     include_tests: bool = False,
     scope: str | None = None,
     budget: RowBudget | None = None,
+    check_keys: set[str] | 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]
+    if check_keys is not None:
+        selected = [check for check in selected if check.key in check_keys]
     selected.sort(key=lambda check: (_ORDER.index(check.priority), check.key))
     budget_obj: RowBudget = budget or RowBudget(remaining=limit)
     sections: list[tuple[str, list[str], str | None]] = []

{scip_cli-2.6.0 → scip_cli-2.8.0}/scip_cli/analyze/symbol.py

@@ -169,6 +169,7 @@ def run_all(
     limit: int = DEFAULT_LIMIT,
     priorities=None,
     budget=None,
+    check_keys=None,
 ) -> list[tuple[str, list[str], str | None]]:
     checks = [
         Check("consumer_files", Priority.HIGH, "Consumer files (direct)", _bind_symbol(consumer_files, symbol_id)),
@@ -182,4 +183,4 @@ def run_all(
         ),
         Check("def_context", Priority.LOW, "Definition context", _bind_symbol0(def_context, symbol_id)),
     ]
-    return run_checks(checks, db, limit, priorities, budget=budget)
+    return run_checks(checks, db, limit, priorities, budget=budget, check_keys=check_keys)

{scip_cli-2.6.0 → scip_cli-2.8.0}/scip_cli/commands/analyze.py

@@ -8,7 +8,7 @@ from ..analyze import file as file_checks
 from ..analyze import project as project_checks
 from ..analyze import symbol as symbol_checks
 from ..analyze.common import is_test_path, section
-from ..analyze.sections import RowBudget, parse_priorities
+from ..analyze.sections import RowBudget, parse_checks, parse_priorities
 from ..analyze.targets import MAX_DIR_FILES, list_dir_files, resolve_analyze_target
 from ..cli_args import path_scope_from_args
 from ..session import resolve_one_symbol, setup
@@ -39,6 +39,7 @@ def _project_sections(
     scope: str | None,
     priorities,
     budget: RowBudget,
+    check_keys,
 ) -> list[tuple[str, list[str], str | None]]:
     return project_checks.run_all(
         db,
@@ -47,6 +48,7 @@ def _project_sections(
         scope=scope,
         priorities=priorities,
         budget=budget,
+        check_keys=check_keys,
     )
 
 
@@ -57,8 +59,9 @@ def _file_sections(
     limit: int,
     priorities,
     budget: RowBudget,
+    check_keys,
 ) -> list[tuple[str, list[str], str | None]]:
-    return file_checks.run_all(db, path, limit=limit, priorities=priorities, budget=budget)
+    return file_checks.run_all(db, path, limit=limit, priorities=priorities, budget=budget, check_keys=check_keys)
 
 
 def _dir_sections(
@@ -69,6 +72,7 @@ def _dir_sections(
     include_tests: bool,
     priorities,
     budget: RowBudget,
+    check_keys,
 ) -> list[tuple[str, list[str], str | None]]:
     sections = _project_sections(
         db,
@@ -77,6 +81,7 @@ def _dir_sections(
         scope=scope,
         priorities=priorities,
         budget=budget,
+        check_keys=check_keys,
     )
     files = list_dir_files(db, scope, include_tests=include_tests)
     total = len(files)
@@ -99,7 +104,11 @@ def _dir_sections(
     for path in files:
         if budget.exhausted():
             break
-        sections.extend(file_checks.run_all_sections_only(db, path, limit=limit, priorities=priorities, budget=budget))
+        sections.extend(
+            file_checks.run_all_sections_only(
+                db, path, limit=limit, priorities=priorities, budget=budget, check_keys=check_keys
+            )
+        )
     return sections
 
 
@@ -112,6 +121,7 @@ def main(args):
         budget = RowBudget(remaining=limit)
         include_tests = getattr(args, "include_tests", False)
         priorities = parse_priorities(getattr(args, "priority", None))
+        check_keys = parse_checks(getattr(args, "check", None))
         target = getattr(args, "target", None)
 
         if target is None:
@@ -128,6 +138,7 @@ def main(args):
                 scope=None,
                 priorities=priorities,
                 budget=budget,
+                check_keys=check_keys,
             )
         else:
             resolved = resolve_analyze_target(db, target, project_root, path_scope)
@@ -140,6 +151,7 @@ def main(args):
                     include_tests=include_tests,
                     priorities=priorities,
                     budget=budget,
+                    check_keys=check_keys,
                 )
             elif resolved.kind == "file":
                 file_include = _project_include_tests(include_tests, scope)
@@ -150,16 +162,23 @@ def main(args):
                     scope=scope,
                     priorities=priorities,
                     budget=budget,
+                    check_keys=check_keys,
                 )
                 if not budget.exhausted():
-                    sections.extend(_file_sections(db, scope, limit=limit, priorities=priorities, budget=budget))
+                    sections.extend(
+                        _file_sections(
+                            db, scope, limit=limit, priorities=priorities, budget=budget, check_keys=check_keys
+                        )
+                    )
             else:
                 symbol_id, _symbol_str, _display = resolve_one_symbol(
                     db,
                     resolved.symbol_name,
                     path_scope=path_scope,
                 )
-                sections = symbol_checks.run_all(db, symbol_id, limit=limit, priorities=priorities, budget=budget)
+                sections = symbol_checks.run_all(
+                    db, symbol_id, limit=limit, priorities=priorities, budget=budget, check_keys=check_keys
+                )
 
         _print_sections(sections)
     finally:

{scip_cli-2.6.0 → scip_cli-2.8.0}/scip_cli/commands/reindex.py

@@ -9,6 +9,7 @@ from ..cache import (
     index_db_path,
     promote_next_index,
 )
+from ..exclude import save_persisted_exclude_globs
 from ..indexing import index_project, log_index_complete
 from ..paths import normalize_path_scope
 from ..project import Language, find_project_root_and_language
@@ -24,6 +25,7 @@ def main(args):
 
     path_args = getattr(args, "path", None) or []
     tsconfig_args = getattr(args, "tsconfig", None) or []
+    exclude_args = getattr(args, "exclude", None) or []
     if path_args and tsconfig_args:
         print("Error: reindex --path and --tsconfig cannot be combined", file=sys.stderr)
         sys.exit(1)
@@ -68,6 +70,12 @@ def main(args):
     else:
         save_index_scope(root, None)
 
+    if exclude_args:
+        save_persisted_exclude_globs(root, exclude_args)
+        print(f"Index exclude: {', '.join(exclude_args)}", file=sys.stderr)
+    else:
+        save_persisted_exclude_globs(root, None)
+
     cache_dir = get_cache_dir(root)
     cache_dir.mkdir(parents=True, exist_ok=True)
 

{scip_cli-2.6.0 → scip_cli-2.8.0}/scip_cli/config.py

@@ -16,6 +16,7 @@ class ProjectSettings:
     max_heap_mb: int | None = None
     index_roots: list[str] = field(default_factory=list)
     only_index_roots: bool = False
+    exclude_globs: list[str] = field(default_factory=list)
 
 
 def load_project_config(project_root: Path) -> ProjectSettings:
@@ -44,10 +45,15 @@ def load_project_config(project_root: Path) -> ProjectSettings:
     if type(only_index_roots) is not bool:
         raise RuntimeError(f"Invalid {CONFIG_FILENAME}: onlyIndexRoots must be a boolean")
 
+    exclude_globs = data.get("excludeGlobs", [])
+    if not isinstance(exclude_globs, list) or not all(isinstance(p, str) for p in exclude_globs):
+        raise RuntimeError(f"Invalid {CONFIG_FILENAME}: excludeGlobs must be a string array")
+
     return ProjectSettings(
         max_heap_mb=max_heap_mb,
         index_roots=index_roots,
         only_index_roots=only_index_roots,
+        exclude_globs=exclude_globs,
     )