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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scip-cli
-Version: 2.6.0
+Version: 2.7.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.7.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.6.0 → scip_cli-2.7.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,17 +143,19 @@ 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
 

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

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

{scip_cli-2.6.0 → scip_cli-2.7.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")

{scip_cli-2.6.0 → scip_cli-2.7.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.7.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.7.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.7.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.7.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.7.0}/tests/test_analyze.py

@@ -114,10 +114,10 @@ class TestProjectAnalyze:
         assert total_rows <= 3
         assert len(sections) < 9
 
-    def test_run_all_returns_nine_sections(self):
+    def test_run_all_returns_ten_sections(self):
         db = mini_codebase_db()
         sections = project_checks.run_all(db, limit=500)
-        assert len(sections) == 9
+        assert len(sections) == 10
         titles = [title for title, _lines, _preface in sections]
         assert sum(1 for t in titles if "[low]" in t) == 4
         assert sum(1 for t in titles if "[medium]" in t) == 1
@@ -142,10 +142,55 @@ class TestProjectAnalyze:
 
         db = mini_codebase_db()
         sections = project_checks.run_all(db, limit=500, priorities={Priority.HIGH})
-        assert len(sections) == 4
+        assert len(sections) == 5
         titles = [title for title, _lines, _preface in sections]
         assert all("[high]" in title for title in titles)
 
+    def test_run_all_check_keys_only(self):
+        db = mini_codebase_db()
+        sections = project_checks.run_all(db, limit=500, check_keys={"cycles"})
+        assert len(sections) == 1
+        assert "Cycles" in sections[0][0]
+
+    def test_run_all_check_and_priority_and(self):
+        from scip_cli.analyze.sections import Priority
+
+        db = mini_codebase_db()
+        sections = project_checks.run_all(
+            db,
+            limit=500,
+            priorities={Priority.HIGH},
+            check_keys={"cycles", "hotspots"},
+        )
+        assert len(sections) == 1
+        assert "Cycles" in sections[0][0]
+
+    def test_dead_files_empty_rdeps(self):
+        b = AnalyzeDbBuilder()
+        used = b.define("src/used.ts", "usedFn")
+        b.reference("src/entry.ts", used)
+        b.define("src/orphan.ts", "orphanFn")
+        b.define("tests/orphan.spec.ts", "testHelper")
+        db = b.finish()
+        lines = project_checks.dead_files(db, limit=20)
+        assert "src/orphan.ts" in lines
+        assert "src/entry.ts" in lines
+        assert "src/used.ts" not in lines
+        assert not any("orphan.spec.ts" in line for line in lines)
+        with_tests = project_checks.dead_files(db, limit=20, include_tests=True)
+        assert any("orphan.spec.ts" in line for line in with_tests)
+
+    def test_dead_files_preface_when_hits(self):
+        db = mini_codebase_db()
+        sections = project_checks.run_all(db, limit=20, check_keys={"dead_files"})
+        assert len(sections) == 1
+        _title, lines, preface = sections[0]
+        assert "Dead files" in _title
+        if lines != ["(none)"]:
+            assert preface is not None
+            assert "rdeps" in preface
+            assert "export const" in preface
+
 
 class TestFileAnalyze:
     def test_change_surface_lists_exports(self):
@@ -254,6 +299,19 @@ class TestAnalyzeSections:
         assert parse_priorities("high") == {Priority.HIGH}
         assert parse_priorities("1,medium") == {Priority.HIGH, Priority.MEDIUM}
 
+    def test_parse_checks(self):
+        import pytest
+
+        from scip_cli.analyze.sections import parse_checks
+
+        assert parse_checks(None) is None
+        assert parse_checks([]) is None
+        assert parse_checks(["cycles"]) == {"cycles"}
+        assert parse_checks(["cycles,hotspots"]) == {"cycles", "hotspots"}
+        assert parse_checks(["cycles", "hotspots"]) == {"cycles", "hotspots"}
+        with pytest.raises(RuntimeError, match="unknown analyze check"):
+            parse_checks(["not_a_check"])
+
 
 class TestAnalyzeCommand:
     def test_project_include_tests_for_test_file_path(self):

{scip_cli-2.6.0 → scip_cli-2.7.0}/tests/test_e2e.py

@@ -272,6 +272,23 @@ class TestAnalyze:
         assert "[high]" in result.stdout
         assert "[low]" not in result.stdout
 
+    def test_check_runs_named_section_only(self, cli):
+        result = cli.run("analyze", "--check", "cycles", "--limit", "5")
+        assert result.returncode == 0
+        assert "Cycles" in result.stdout
+        assert "Hotspots" not in result.stdout
+        assert "Dead exports" not in result.stdout
+
+    def test_check_dead_files(self, cli):
+        result = cli.run("analyze", "--check", "dead_files", "--limit", "5")
+        assert result.returncode == 0
+        assert "Dead files" in result.stdout
+
+    def test_check_unknown_exits(self, cli):
+        result = cli.run("analyze", "--check", "not_a_check")
+        assert result.returncode == 1
+        assert "unknown analyze check" in result.stderr
+
 
 class TestIndex:
     def test_fixture_index_queryable(self, indexed_fixture):