scip-query 0.2.0 → 0.3.1

package/README.md

@@ -12,7 +12,7 @@ For goal-oriented usage guides (not just command reference), see **[Agent Guide]
 - **[Write an implementation plan](docs/AGENT_GUIDE.md#workflow-2-write-a-concrete-implementation-plan)** — identify contracts, map dependencies, find reusable code
 - **[De-bloat a codebase](docs/AGENT_GUIDE.md#workflow-3-clean-up-and-de-bloat-a-codebase)** — prioritized cleanup from dead code to pattern drift
 - **[Assess code quality](docs/AGENT_GUIDE.md#workflow-4-assess-code-quality-and-risk)** — health score, complexity hotspots, coupling risks
-- **[Verify change impact](docs/AGENT_GUIDE.md#workflow-5-understand-impact-after-making-changes)** — diff impact, transitive blast radius, test gaps
+- **[Verify change impact](docs/AGENT_GUIDE.md#workflow-5-understand-impact-after-making-changes)** — diff impact, transitive blast radius, consumer blast radius
 
 ## Quick Start
 
@@ -53,6 +53,8 @@ scip-query diff-impact                   # what did my changes affect?
 | Dart | scip-dart | [releases](https://github.com/nicovince/scip-dart/releases) |
 | PHP | scip-php | [releases](https://github.com/nicovince/scip-php/releases) |
 
+For Python, the npm package is `scip-python-plus`. Depending on which version you installed, the executable on your `PATH` may be `scip-python`, `scip-python-plus`, or both. `scip-query` now accepts either name.
+
 ## How It Works
 
 1. A SCIP indexer analyzes your source code using the actual compiler/type checker and produces a `index.scip` protobuf file containing every symbol, definition, and reference — fully type-resolved.
@@ -461,10 +463,10 @@ scip-query dead src/utils --skip-barrels --include-members
 **Options:**
 - `--min-loc <n>` — Only show symbols >= N lines (default: 1)
 - `--include-tests` — Include test files in results (excluded by default)
-- `--skip-barrels` — Ignore references from barrel re-export files (index.ts)
+- `--skip-barrels` — Ignore references from inactive barrel re-export files
 - `--include-members` — Include class members (module-level only by default)
 
-**Value:** Find code you can delete. The `--skip-barrels` flag is key — without it, symbols re-exported through index.ts appear "referenced" even if no real consumer uses them.
+**Value:** Find code you can delete. The `--skip-barrels` flag is key when a codebase has unused barrels, but it now keeps live entry-surface barrels counted so active exports do not look dead.
 
 ---
 
@@ -510,31 +512,6 @@ scip-query doc-coverage --min-loc 5
 
 ---
 
-#### `test-coverage [symbol]`
-
-Check if symbols are referenced by test files. Without a symbol argument, shows a summary percentage. With a symbol, shows which specific test files cover it.
-
-```bash
-scip-query test-coverage
-# Test coverage: 45%
-#   Total symbols:  95
-#   Covered:        43
-#   Not covered:    52
-
-scip-query test-coverage AuthService
-#   [covered]      AuthService  (src/services/auth.service.ts)
-#     ← src/__tests__/auth.test.ts
-#   [NOT COVERED]  AuthService:logout()  (src/services/auth.service.ts)
-```
-
-**Options:**
-- `-s, --scope <path>` — Limit to files matching path
-- `--min-loc <n>` — Minimum LOC for summary mode (default: 3)
-
-**Value:** Reference-based test coverage — which symbols does your test suite actually exercise? Not execution coverage, but structural coverage: "do tests at least reference this code?"
-
----
-
 ### Codebase Metrics
 
 These commands measure structural properties of the codebase — hotspots, coupling, bottlenecks, fan-in/out.
@@ -556,7 +533,7 @@ scip-query hotspots -n 15
 - `-n, --limit <n>` — Number of results (default: 30)
 - `-s, --scope <path>` — Limit to files matching path
 
-**Value:** Identify the symbols where a bug or breaking change would affect the most consumers. Hotspots deserve the most careful review, the best test coverage, and the most stable interfaces.
+**Value:** Identify the symbols where a bug or breaking change would affect the most consumers. Hotspots deserve the most careful review and the most stable interfaces.
 
 ---
 
@@ -581,7 +558,7 @@ scip-query fan-in -n 10
 - `-n, --limit <n>` — Number of results for top mode (default: 30)
 - `-s, --scope <path>` — Limit to files matching path
 
-**Value:** High fan-in = widely depended upon. Changes to high fan-in symbols have large blast radius. These symbols should have stable interfaces and thorough tests.
+**Value:** High fan-in = widely depended upon. Changes to high fan-in symbols have large blast radius. These symbols should have stable interfaces and careful review.
 
 ---
 
@@ -871,19 +848,19 @@ scip-query affected login --max-depth 3
 
 #### `change-surface <file>`
 
-Pre-change briefing for a file: every exported symbol, consumer count, test coverage, and risk level.
+Pre-change briefing for a file: every exported symbol, consumer count, and blast-radius risk.
 
 ```bash
 scip-query change-surface auth.service.ts
 # File: src/services/auth.service.ts
-# Test coverage: 60% | External consumers: 45
+# External consumers: 45
 #
-#   1-50   AuthService  [12 consumers] (2 test files) * medium risk *
-#   5-20   login()      [8 consumers]  (1 test file)
-#   22-35  logout()     [3 consumers]  (no tests) *** HIGH RISK ***
+#   1-50   AuthService  [12 consumers] *** HIGH RISK ***
+#   5-20   login()      [8 consumers]  * medium risk *
+#   22-35  logout()     [0 consumers]
 ```
 
-**Value:** One command before modifying any file. Shows what's exported, who uses it, what's tested, and what's dangerous.
+**Value:** One command before modifying any file. Shows what's exported, who uses it, and which symbols carry the largest downstream blast radius.
 
 ---
 
@@ -897,13 +874,12 @@ scip-query diff-impact --base main
 # Changed files: 3
 # Changed symbols: 12
 # Affected consumer files: 28
-# Test coverage: 67%
 ```
 
 **Options:**
 - `--base <ref>` — Git ref to diff against (default: HEAD)
 
-**Value:** Run before committing. Shows everything your changes affect, which consumer files are impacted, and where test gaps exist.
+**Value:** Run before committing. Shows everything your changes affect and which consumer files sit downstream of the changed symbols.
 
 ---
 
@@ -914,15 +890,12 @@ scip-query diff-impact --base main
 Detect files that deviate from their directory's typical dependency pattern.
 
 ```bash
-scip-query drift --min-deviation 30
+scip-query drift
 # src/services/legacy-auth.ts  (65% deviation from src/services)
 #   Missing expected: validator.ts, logger.ts
 #   Unexpected:       raw-sql.ts, deprecated-crypto.ts
 ```
 
-**Options:**
-- `--min-deviation <n>` — Minimum deviation % to report (default: 30)
-
 **Value:** Finds files that don't follow their neighbors' conventions. The outliers are either legacy code needing migration or intentional exceptions needing documentation.
 
 ---
@@ -1149,7 +1122,7 @@ scip-query redundant-reexports
 - `-s, --scope <path>` — Limit to files matching path
 - `-n, --limit <n>` — Number of results (default: 30)
 
-**Value:** Finds dead entries in barrel files. Note: TypeScript namespace imports (`import * as`) resolve through barrels transparently, so the command is most effective on codebases using named imports.
+**Value:** Finds dead entries in inactive barrel files. Live barrels are skipped so shared entry surfaces like package roots and CLI registries do not show up as false positives.
 
 ---
 

package/dist/chunk-26DOJ63W.js

@@ -0,0 +1,161 @@
+import {
+  findFirstSymbolMatch,
+  getSourceImports,
+  resolveIndexedFile
+} from "./chunk-AXQKUYKF.js";
+import {
+  isModuleLikeSymbol,
+  leafName,
+  shortenSymbol
+} from "./chunk-QIXNAB5K.js";
+
+// src/queries/imports.ts
+function imports(db, filePattern) {
+  const importer = resolveIndexedFile(db, filePattern);
+  if (!importer) return [];
+  const rows = db.all(
+    `SELECT DISTINCT gs.symbol, def_d.relative_path AS from_file, imp_d.relative_path AS importer
+    FROM mentions m
+    JOIN chunks c ON m.chunk_id = c.id
+    JOIN documents imp_d ON c.document_id = imp_d.id
+    JOIN global_symbols gs ON m.symbol_id = gs.id
+    LEFT JOIN defn_enclosing_ranges der ON gs.id = der.symbol_id
+    LEFT JOIN documents def_d ON der.document_id = def_d.id
+    WHERE imp_d.relative_path = ?
+      AND m.role = 2
+    ORDER BY def_d.relative_path, gs.symbol`,
+    importer
+  );
+  const indexedResults = rows.filter((row) => !db.isIgnored(row.importer)).map((r) => ({
+    symbol: r.symbol,
+    shortName: shortenSymbol(r.symbol),
+    fromFile: r.from_file ?? "(external)"
+  }));
+  if (indexedResults.length > 0) {
+    return indexedResults;
+  }
+  return getSourceImports(db, importer).map((entry) => ({
+    symbol: renderImportSymbol(entry.importedName, entry.localName, entry.kind),
+    shortName: renderImportSymbol(entry.importedName, entry.localName, entry.kind),
+    fromFile: entry.sourcePath ?? "(external)"
+  }));
+}
+function importedBy(db, symbolPattern) {
+  const rows = db.all(
+    `SELECT DISTINCT gs.symbol, d.relative_path AS importer
+    FROM mentions m
+    JOIN chunks c ON m.chunk_id = c.id
+    JOIN documents d ON c.document_id = d.id
+    JOIN global_symbols gs ON m.symbol_id = gs.id
+    WHERE gs.symbol LIKE ?
+      AND m.role = 2
+    ORDER BY d.relative_path`,
+    `%${symbolPattern}%`
+  );
+  const indexedResults = rows.filter((r) => !db.isIgnored(r.importer)).map((r) => ({
+    symbol: r.symbol,
+    shortName: shortenSymbol(r.symbol),
+    fromFile: r.importer
+  }));
+  if (indexedResults.length > 0) {
+    return indexedResults;
+  }
+  const target = findFirstSymbolMatch(db, symbolPattern);
+  const targetFile = target?.relativePath ?? null;
+  const targetLeaf = target ? leafName(target.symbol) : symbolPattern.replace(/\(\)$/, "");
+  const targetIsModule = target ? isModuleLikeSymbol(target.symbol) : false;
+  const files = db.all(
+    `SELECT relative_path
+     FROM documents
+     WHERE 1 = 1
+       ${db.pathExclusionsFor("documents")}
+     ORDER BY relative_path`
+  );
+  const importers = /* @__PURE__ */ new Set();
+  for (const row of files) {
+    if (db.isIgnored(row.relative_path)) continue;
+    for (const entry of getSourceImports(db, row.relative_path)) {
+      if (!entry.sourcePath) continue;
+      if (targetFile && normalizePath(entry.sourcePath) !== normalizePath(targetFile)) {
+        continue;
+      }
+      if (targetIsModule) {
+        importers.add(row.relative_path);
+        continue;
+      }
+      if (entry.kind === "named" && entry.importedName === targetLeaf) {
+        importers.add(row.relative_path);
+        continue;
+      }
+      if (entry.kind === "namespace" && entry.usedMembers.includes(targetLeaf)) {
+        importers.add(row.relative_path);
+      }
+    }
+  }
+  return [...importers].sort().map((importer) => ({
+    symbol: target?.symbol ?? targetLeaf,
+    shortName: target ? shortenSymbol(target.symbol) : targetLeaf,
+    fromFile: importer
+  }));
+}
+function unusedImports(db, filePattern) {
+  const importer = resolveIndexedFile(db, filePattern);
+  if (!importer) return [];
+  const rows = db.all(
+    `SELECT gs.symbol, d.relative_path AS imported_in, d.relative_path AS importer
+    FROM mentions m
+    JOIN chunks c ON m.chunk_id = c.id
+    JOIN documents d ON c.document_id = d.id
+    JOIN global_symbols gs ON m.symbol_id = gs.id
+    WHERE d.relative_path = ?
+      AND m.role = 2
+      AND NOT EXISTS (
+        SELECT 1
+        FROM mentions ref_m
+        JOIN chunks ref_c ON ref_m.chunk_id = ref_c.id
+        WHERE ref_m.symbol_id = gs.id
+          AND ref_m.role != 1
+          AND ref_c.document_id = d.id
+      )
+    ORDER BY d.relative_path, gs.symbol`,
+    importer
+  );
+  const indexedResults = rows.filter((row) => !db.isIgnored(row.importer)).map((r) => ({
+    symbol: r.symbol,
+    shortName: shortenSymbol(r.symbol),
+    importedIn: r.imported_in
+  }));
+  if (indexedResults.length > 0) {
+    return indexedResults;
+  }
+  return getSourceImports(db, importer).filter((entry) => entry.kind !== "side-effect" && !entry.used).map((entry) => ({
+    symbol: renderImportSymbol(entry.importedName, entry.localName, entry.kind),
+    shortName: renderImportSymbol(entry.importedName, entry.localName, entry.kind),
+    importedIn: importer
+  }));
+}
+function renderImportSymbol(importedName, localName, kind) {
+  if (kind === "namespace" && importedName === "*" && localName) {
+    return `* as ${localName}`;
+  }
+  if (kind === "default" && localName) {
+    return `default as ${localName}`;
+  }
+  if (kind === "side-effect") {
+    return "(side effect import)";
+  }
+  if (localName && localName !== importedName) {
+    return `${importedName} as ${localName}`;
+  }
+  return importedName;
+}
+function normalizePath(path) {
+  return path.replace(/\\/g, "/");
+}
+
+export {
+  imports,
+  importedBy,
+  unusedImports
+};
+//# sourceMappingURL=chunk-26DOJ63W.js.map

package/dist/chunk-2UELLEBI.js

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-2UELLEBI.js.map

package/dist/{chunk-4PDAL6IL.js → chunk-4JCSOF2O.js}

@@ -1,9 +1,9 @@
 import {
   testFileExclusionSql
-} from "./chunk-ZOGY2V3N.js";
+} from "./chunk-AXQKUYKF.js";
 import {
   shortenSymbol
-} from "./chunk-QOV2R2WT.js";
+} from "./chunk-QIXNAB5K.js";
 
 // src/queries/wrapper-candidates.ts
 function wrapperCandidates(db, opts) {
@@ -94,4 +94,4 @@ function wrapperCandidates(db, opts) {
 export {
   wrapperCandidates
 };
-//# sourceMappingURL=chunk-4PDAL6IL.js.map
+//# sourceMappingURL=chunk-4JCSOF2O.js.map

package/dist/{chunk-6SXADWLW.js → chunk-5OMVSV6E.js}

@@ -1,18 +1,26 @@
+import {
+  resolveIndexedPaths
+} from "./chunk-AXQKUYKF.js";
 import {
   shortenSymbol
-} from "./chunk-QOV2R2WT.js";
+} from "./chunk-QIXNAB5K.js";
 
 // src/queries/outline.ts
 function outline(db, filePattern) {
+  const resolvedPaths = resolveIndexedPaths(db, filePattern);
+  if (resolvedPaths.length === 0) {
+    return [];
+  }
+  const placeholders = resolvedPaths.map(() => "?").join(", ");
   const rows = db.all(
     `SELECT gs.symbol, gs.enclosing_symbol, der.start_line, der.end_line
     FROM defn_enclosing_ranges der
     JOIN global_symbols gs ON der.symbol_id = gs.id
     JOIN documents d ON der.document_id = d.id
-    WHERE d.relative_path LIKE ?
+    WHERE d.relative_path IN (${placeholders})
       ${db.symbolNoise}
-    ORDER BY der.start_line`,
-    `%${filePattern}%`
+    ORDER BY d.relative_path, der.start_line`,
+    ...resolvedPaths
   );
   const nodeMap = /* @__PURE__ */ new Map();
   const roots = [];
@@ -40,4 +48,4 @@ function outline(db, filePattern) {
 export {
   outline
 };
-//# sourceMappingURL=chunk-6SXADWLW.js.map
+//# sourceMappingURL=chunk-5OMVSV6E.js.map

package/dist/{chunk-KPPHZCZJ.js → chunk-7HK5ZLOE.js}

@@ -1,10 +1,6 @@
-import {
-  TEST_FILE_PATTERNS,
-  testFileMatchSql
-} from "./chunk-ZOGY2V3N.js";
 import {
   shortenSymbol
-} from "./chunk-QOV2R2WT.js";
+} from "./chunk-QIXNAB5K.js";
 
 // src/queries/diff-impact.ts
 import { execFileSync } from "child_process";
@@ -12,23 +8,17 @@ function diffImpact(db, opts = {}) {
   const { base = "HEAD" } = opts;
   let changedFileLines;
   try {
-    const stdout = execFileSync("git", ["diff", "--name-only", base], {
-      encoding: "utf-8",
-      cwd: db.config.projectRoot,
-      timeout: 1e4
-    });
-    changedFileLines = stdout.split("\n").map((l) => l.trim()).filter((l) => l.length > 0);
+    changedFileLines = getChangedFiles(db.config.projectRoot, base);
   } catch {
     return {
       changedFiles: [],
       changedSymbols: [],
       affectedConsumers: [],
-      uncoveredSymbols: [],
       summary: {
         totalChangedFiles: 0,
         totalChangedSymbols: 0,
         totalAffectedFiles: 0,
-        testCoveragePercent: 0
+        note: "Unable to compute git diff."
       }
     };
   }
@@ -37,12 +27,11 @@ function diffImpact(db, opts = {}) {
       changedFiles: [],
       changedSymbols: [],
       affectedConsumers: [],
-      uncoveredSymbols: [],
       summary: {
         totalChangedFiles: 0,
         totalChangedSymbols: 0,
         totalAffectedFiles: 0,
-        testCoveragePercent: 0
+        note: "No changed files found."
       }
     };
   }
@@ -65,12 +54,11 @@ function diffImpact(db, opts = {}) {
       changedFiles: changedFileLines,
       changedSymbols: [],
       affectedConsumers: [],
-      uncoveredSymbols: [],
       summary: {
         totalChangedFiles: changedFileLines.length,
         totalChangedSymbols: 0,
         totalAffectedFiles: 0,
-        testCoveragePercent: 0
+        note: "Changed files are not present in the current SCIP index."
       }
     };
   }
@@ -85,11 +73,8 @@ function diffImpact(db, opts = {}) {
     ORDER BY d.relative_path`,
     ...changedDocIds
   );
-  const testPatternSql = testFileMatchSql("ref_d", TEST_FILE_PATTERNS);
   const changedSymbols = [];
   const consumerMap = /* @__PURE__ */ new Map();
-  const uncoveredSymbols = [];
-  let coveredCount = 0;
   for (const sym of syms) {
     const fanInRow = db.get(
       `SELECT COUNT(DISTINCT c.document_id) AS fan_in
@@ -126,44 +111,41 @@ function diffImpact(db, opts = {}) {
       }
       consumerMap.get(consumer.relative_path).add(shortName);
     }
-    const hasTest = db.get(
-      `SELECT COUNT(*) AS c
-      FROM mentions m
-      JOIN chunks c ON m.chunk_id = c.id
-      JOIN documents ref_d ON c.document_id = ref_d.id
-      WHERE m.symbol_id = ?
-        AND m.role != 1
-        AND (${testPatternSql})`,
-      sym.symbol_id
-    );
-    if (hasTest && hasTest.c > 0) {
-      coveredCount++;
-    } else {
-      uncoveredSymbols.push({
-        symbol: sym.symbol,
-        shortName,
-        file: sym.relative_path
-      });
-    }
   }
   const affectedConsumers = [...consumerMap.entries()].map(([file, symbols]) => ({ file, consumedSymbols: symbols.size })).sort((a, b) => b.consumedSymbols - a.consumedSymbols);
-  const totalSymbols = changedSymbols.length;
-  const testCoveragePercent = totalSymbols > 0 ? Math.round(coveredCount / totalSymbols * 100) : 0;
   return {
     changedFiles,
     changedSymbols,
     affectedConsumers,
-    uncoveredSymbols,
     summary: {
       totalChangedFiles: changedFiles.length,
-      totalChangedSymbols: totalSymbols,
-      totalAffectedFiles: affectedConsumers.length,
-      testCoveragePercent
+      totalChangedSymbols: changedSymbols.length,
+      totalAffectedFiles: affectedConsumers.length
     }
   };
 }
+function getChangedFiles(projectRoot, base) {
+  const diff = execFileSync("git", ["diff", "--name-only", base], {
+    encoding: "utf-8",
+    cwd: projectRoot,
+    timeout: 1e4
+  });
+  const staged = execFileSync("git", ["diff", "--name-only", "--cached", base], {
+    encoding: "utf-8",
+    cwd: projectRoot,
+    timeout: 1e4
+  });
+  const untracked = execFileSync("git", ["ls-files", "--others", "--exclude-standard"], {
+    encoding: "utf-8",
+    cwd: projectRoot,
+    timeout: 1e4
+  });
+  return [...new Set(
+    [diff, staged, untracked].flatMap((chunk) => chunk.split("\n")).map((line) => line.trim()).filter((line) => line.length > 0)
+  )];
+}
 
 export {
   diffImpact
 };
-//# sourceMappingURL=chunk-KPPHZCZJ.js.map
+//# sourceMappingURL=chunk-7HK5ZLOE.js.map

package/dist/{chunk-7RLE5EWE.js → chunk-7KIMF5PV.js}

@@ -1,6 +1,6 @@
 import {
   buildFileDepGraph
-} from "./chunk-ZOGY2V3N.js";
+} from "./chunk-AXQKUYKF.js";
 
 // src/queries/drift.ts
 import path from "path";
@@ -10,9 +10,10 @@ function drift(db, opts) {
   const symbolRefs = buildSymbolRefGraph(db, scope);
   const results = [];
   for (const [file, deps] of depGraph) {
-    if (isStructuralRole(path.basename(file))) continue;
+    if (shouldSkipDriftFile(file)) continue;
     const referencedFiles = symbolRefs.get(file) ?? /* @__PURE__ */ new Set();
     for (const dep of deps) {
+      if (shouldSkipDriftFile(dep)) continue;
       if (!referencedFiles.has(dep)) {
         if (isLikelyTypeOnlyDep(dep)) continue;
         results.push({
@@ -26,10 +27,11 @@ function drift(db, opts) {
   }
   const layerRules = inferLayerRules(depGraph);
   for (const [file, deps] of depGraph) {
-    if (isStructuralRole(path.basename(file))) continue;
-    const fileLayer = getTopDir(file);
+    if (shouldSkipDriftFile(file)) continue;
+    const fileLayer = getArchitecturalLayer(file);
     for (const dep of deps) {
-      const depLayer = getTopDir(dep);
+      if (shouldSkipDriftFile(dep)) continue;
+      const depLayer = getArchitecturalLayer(dep);
       if (fileLayer === depLayer) continue;
       const violation = layerRules.get(`${fileLayer}->${depLayer}`);
       if (violation === "violation") {
@@ -53,14 +55,16 @@ function drift(db, opts) {
     if (files.length < 3) continue;
     const depFreq = /* @__PURE__ */ new Map();
     for (const file of files) {
-      if (isStructuralRole(path.basename(file))) continue;
+      if (shouldSkipDriftFile(file)) continue;
       for (const dep of depGraph.get(file) ?? []) {
+        if (shouldSkipDriftFile(dep)) continue;
         depFreq.set(dep, (depFreq.get(dep) ?? 0) + 1);
       }
     }
     for (const file of files) {
-      if (isStructuralRole(path.basename(file))) continue;
+      if (shouldSkipDriftFile(file)) continue;
       for (const dep of depGraph.get(file) ?? []) {
+        if (shouldSkipDriftFile(dep)) continue;
         if ((depFreq.get(dep) ?? 0) === 1) {
           if (path.dirname(dep) === dir) continue;
           results.push({
@@ -107,10 +111,12 @@ function inferLayerRules(depGraph) {
   const layerEdges = /* @__PURE__ */ new Map();
   const layerSet = /* @__PURE__ */ new Set();
   for (const [file, deps] of depGraph) {
-    const fromLayer = getTopDir(file);
+    if (shouldSkipDriftFile(file)) continue;
+    const fromLayer = getArchitecturalLayer(file);
     layerSet.add(fromLayer);
     for (const dep of deps) {
-      const toLayer = getTopDir(dep);
+      if (shouldSkipDriftFile(dep)) continue;
+      const toLayer = getArchitecturalLayer(dep);
       if (fromLayer === toLayer) continue;
       layerSet.add(toLayer);
       const key = `${fromLayer}->${toLayer}`;
@@ -123,13 +129,23 @@ function inferLayerRules(depGraph) {
   }
   return rules;
 }
-function getTopDir(filePath) {
-  const parts = filePath.split("/");
-  return parts[0] ?? filePath;
+function getArchitecturalLayer(filePath) {
+  const normalized = filePath.replace(/\\/g, "/");
+  const parts = normalized.split("/").filter(Boolean);
+  if (parts.length <= 1) {
+    return "(root)";
+  }
+  if (parts.length >= 3 && ["src", "lib", "app", "server", "client"].includes(parts[0])) {
+    return `${parts[0]}/${parts[1]}`;
+  }
+  return parts[0];
 }
 function isLikelyTypeOnlyDep(dep) {
   return dep.includes("types") || dep.endsWith(".d.ts");
 }
+function shouldSkipDriftFile(filePath) {
+  return isStructuralRole(path.basename(filePath)) || isTestLikePath(filePath);
+}
 function isStructuralRole(basename) {
   if (basename === "index.ts" || basename === "index.js") return true;
   if (basename === "cli.ts" || basename === "main.ts" || basename === "main.rs") return true;
@@ -137,8 +153,13 @@ function isStructuralRole(basename) {
   if (basename === "health.ts" || basename === "health.js") return true;
   return false;
 }
+function isTestLikePath(filePath) {
+  const normalized = filePath.replace(/\\/g, "/");
+  const basename = path.basename(normalized);
+  return normalized.includes("/__tests__/") || normalized.includes("/tests/") || normalized.includes("/test/") || /\.(test|spec)\.[A-Za-z0-9]+$/.test(basename) || /_(test|spec)\.[A-Za-z0-9]+$/.test(basename) || /^test[_-]/.test(basename) || /^test\./.test(basename);
+}
 
 export {
   drift
 };
-//# sourceMappingURL=chunk-7RLE5EWE.js.map
+//# sourceMappingURL=chunk-7KIMF5PV.js.map