scip-query 0.1.0

package/dist/chunk-2QZ23IBN.js

@@ -0,0 +1,55 @@
+import {
+  shortenSymbol
+} from "./chunk-QOV2R2WT.js";
+
+// src/queries/bottlenecks.ts
+function bottlenecks(db, opts = {}) {
+  const { limit = 20, scope, minFanIn = 2, minFanOut = 2 } = opts;
+  const scopeFilter = scope ? `AND def_d.relative_path LIKE '%${scope}%'` : "";
+  const rows = db.all(
+    `SELECT * FROM (
+      SELECT
+        gs.symbol,
+        def_d.relative_path AS defined_in,
+        (SELECT COUNT(DISTINCT ref_c.document_id)
+         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 = 0
+        ) AS fan_in,
+        (SELECT COUNT(DISTINCT ref_gs.id)
+         FROM mentions ref_m
+         JOIN chunks ref_c ON ref_m.chunk_id = ref_c.id
+         JOIN global_symbols ref_gs ON ref_m.symbol_id = ref_gs.id
+         JOIN defn_enclosing_ranges ref_der ON ref_gs.id = ref_der.symbol_id
+         WHERE ref_c.document_id = def_d.id
+           AND ref_m.role = 0
+           AND ref_der.document_id != def_d.id
+        ) AS fan_out
+      FROM global_symbols gs
+      JOIN defn_enclosing_ranges der ON gs.id = der.symbol_id
+      JOIN documents def_d ON der.document_id = def_d.id
+      WHERE 1 = 1
+        ${db.pathExclusionsFor("def_d")}
+        ${db.symbolNoiseFor("gs")}
+        ${scopeFilter}
+    ) WHERE fan_in >= ? AND fan_out >= ?
+    ORDER BY (fan_in * fan_out) DESC
+    LIMIT ?`,
+    minFanIn,
+    minFanOut,
+    limit
+  );
+  return rows.filter((r) => !db.isIgnored(r.defined_in)).map((r) => ({
+    symbol: r.symbol,
+    shortName: shortenSymbol(r.symbol),
+    fanIn: r.fan_in,
+    fanOut: r.fan_out,
+    score: r.fan_in * r.fan_out,
+    definedIn: r.defined_in
+  }));
+}
+
+export {
+  bottlenecks
+};
+//# sourceMappingURL=chunk-2QZ23IBN.js.map

package/dist/chunk-2QZ23IBN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queries/bottlenecks.ts"],"sourcesContent":["import type { ScipDatabase } from '../db.js';\nimport type { BottleneckResult } from '../types.js';\nimport { shortenSymbol } from '../symbol-parser.js';\n\n/**\n * Find coupling hubs: symbols with both high fan-in (many consumers)\n * AND high fan-out (references many other symbols).\n *\n * These are the most dangerous symbols to change — they sit at the\n * intersection of many dependency paths. Score = fanIn * fanOut.\n */\nexport function bottlenecks(\n  db: ScipDatabase,\n  opts: { limit?: number; scope?: string; minFanIn?: number; minFanOut?: number } = {},\n): BottleneckResult[] {\n  const { limit = 20, scope, minFanIn = 2, minFanOut = 2 } = opts;\n  const scopeFilter = scope ? `AND def_d.relative_path LIKE '%${scope}%'` : '';\n\n  // Use a wrapping query to filter on computed columns\n  const rows = db.all<{\n    symbol: string;\n    defined_in: string;\n    fan_in: number;\n    fan_out: number;\n  }>(\n    `SELECT * FROM (\n      SELECT\n        gs.symbol,\n        def_d.relative_path AS defined_in,\n        (SELECT COUNT(DISTINCT ref_c.document_id)\n         FROM mentions ref_m\n         JOIN chunks ref_c ON ref_m.chunk_id = ref_c.id\n         WHERE ref_m.symbol_id = gs.id AND ref_m.role = 0\n        ) AS fan_in,\n        (SELECT COUNT(DISTINCT ref_gs.id)\n         FROM mentions ref_m\n         JOIN chunks ref_c ON ref_m.chunk_id = ref_c.id\n         JOIN global_symbols ref_gs ON ref_m.symbol_id = ref_gs.id\n         JOIN defn_enclosing_ranges ref_der ON ref_gs.id = ref_der.symbol_id\n         WHERE ref_c.document_id = def_d.id\n           AND ref_m.role = 0\n           AND ref_der.document_id != def_d.id\n        ) AS fan_out\n      FROM global_symbols gs\n      JOIN defn_enclosing_ranges der ON gs.id = der.symbol_id\n      JOIN documents def_d ON der.document_id = def_d.id\n      WHERE 1 = 1\n        ${db.pathExclusionsFor('def_d')}\n        ${db.symbolNoiseFor('gs')}\n        ${scopeFilter}\n    ) WHERE fan_in >= ? AND fan_out >= ?\n    ORDER BY (fan_in * fan_out) DESC\n    LIMIT ?`,\n    minFanIn, minFanOut, limit,\n  );\n\n  return rows\n    .filter((r) => !db.isIgnored(r.defined_in))\n    .map((r) => ({\n      symbol: r.symbol,\n      shortName: shortenSymbol(r.symbol),\n      fanIn: r.fan_in,\n      fanOut: r.fan_out,\n      score: r.fan_in * r.fan_out,\n      definedIn: r.defined_in,\n    }));\n}\n"],"mappings":";;;;;AAWO,SAAS,YACd,IACA,OAAkF,CAAC,GAC/D;AACpB,QAAM,EAAE,QAAQ,IAAI,OAAO,WAAW,GAAG,YAAY,EAAE,IAAI;AAC3D,QAAM,cAAc,QAAQ,kCAAkC,KAAK,OAAO;AAG1E,QAAM,OAAO,GAAG;AAAA,IAMd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,UAsBM,GAAG,kBAAkB,OAAO,CAAC;AAAA,UAC7B,GAAG,eAAe,IAAI,CAAC;AAAA,UACvB,WAAW;AAAA;AAAA;AAAA;AAAA,IAIjB;AAAA,IAAU;AAAA,IAAW;AAAA,EACvB;AAEA,SAAO,KACJ,OAAO,CAAC,MAAM,CAAC,GAAG,UAAU,EAAE,UAAU,CAAC,EACzC,IAAI,CAAC,OAAO;AAAA,IACX,QAAQ,EAAE;AAAA,IACV,WAAW,cAAc,EAAE,MAAM;AAAA,IACjC,OAAO,EAAE;AAAA,IACT,QAAQ,EAAE;AAAA,IACV,OAAO,EAAE,SAAS,EAAE;AAAA,IACpB,WAAW,EAAE;AAAA,EACf,EAAE;AACN;","names":[]}

package/dist/chunk-36OMT7ZJ.js

@@ -0,0 +1,144 @@
+import {
+  buildFileDepGraph
+} from "./chunk-FUHJCHS4.js";
+
+// src/queries/drift.ts
+import path from "path";
+function drift(db, opts) {
+  const { scope } = opts ?? {};
+  const depGraph = buildFileDepGraph(db, scope);
+  const symbolRefs = buildSymbolRefGraph(db, scope);
+  const results = [];
+  for (const [file, deps] of depGraph) {
+    if (isStructuralRole(path.basename(file))) continue;
+    const referencedFiles = symbolRefs.get(file) ?? /* @__PURE__ */ new Set();
+    for (const dep of deps) {
+      if (!referencedFiles.has(dep)) {
+        if (isLikelyTypeOnlyDep(dep)) continue;
+        results.push({
+          file,
+          kind: "unused-import",
+          description: `Depends on ${dep} but references none of its symbols`,
+          dep
+        });
+      }
+    }
+  }
+  const layerRules = inferLayerRules(depGraph);
+  for (const [file, deps] of depGraph) {
+    if (isStructuralRole(path.basename(file))) continue;
+    const fileLayer = getTopDir(file);
+    for (const dep of deps) {
+      const depLayer = getTopDir(dep);
+      if (fileLayer === depLayer) continue;
+      const violation = layerRules.get(`${fileLayer}->${depLayer}`);
+      if (violation === "violation") {
+        results.push({
+          file,
+          kind: "layer-violation",
+          description: `Imports from ${depLayer}/ (${dep}) \u2014 may cross architectural boundary`,
+          dep,
+          detail: `${fileLayer}/ should not depend on ${depLayer}/`
+        });
+      }
+    }
+  }
+  const dirToFiles = /* @__PURE__ */ new Map();
+  for (const file of depGraph.keys()) {
+    const dir = path.dirname(file);
+    if (!dirToFiles.has(dir)) dirToFiles.set(dir, []);
+    dirToFiles.get(dir).push(file);
+  }
+  for (const [dir, files] of dirToFiles) {
+    if (files.length < 3) continue;
+    const depFreq = /* @__PURE__ */ new Map();
+    for (const file of files) {
+      if (isStructuralRole(path.basename(file))) continue;
+      for (const dep of depGraph.get(file) ?? []) {
+        depFreq.set(dep, (depFreq.get(dep) ?? 0) + 1);
+      }
+    }
+    for (const file of files) {
+      if (isStructuralRole(path.basename(file))) continue;
+      for (const dep of depGraph.get(file) ?? []) {
+        if ((depFreq.get(dep) ?? 0) === 1) {
+          if (path.dirname(dep) === dir) continue;
+          results.push({
+            file,
+            kind: "pattern-deviation",
+            description: `Only file in ${dir}/ that depends on ${dep}`,
+            dep
+          });
+        }
+      }
+    }
+  }
+  return {
+    results,
+    unusedImports: results.filter((r) => r.kind === "unused-import").length,
+    layerViolations: results.filter((r) => r.kind === "layer-violation").length,
+    patternDeviations: results.filter((r) => r.kind === "pattern-deviation").length
+  };
+}
+function buildSymbolRefGraph(db, scope) {
+  const scopeFilter = scope ? `AND d1.relative_path LIKE '%${scope}%'` : "";
+  const rows = db.all(
+    `SELECT DISTINCT d1.relative_path AS from_file, d2.relative_path AS to_file
+    FROM mentions m
+    JOIN chunks c ON m.chunk_id = c.id
+    JOIN documents d1 ON c.document_id = d1.id
+    JOIN global_symbols gs ON m.symbol_id = gs.id
+    JOIN defn_enclosing_ranges der ON gs.id = der.symbol_id
+    JOIN documents d2 ON der.document_id = d2.id
+    WHERE d1.id != d2.id
+      AND m.role = 0
+      ${db.pathExclusionsFor("d1", "d2")}
+      ${scopeFilter}`
+  );
+  const graph = /* @__PURE__ */ new Map();
+  for (const r of rows) {
+    if (db.isIgnored(r.from_file) || db.isIgnored(r.to_file)) continue;
+    if (!graph.has(r.from_file)) graph.set(r.from_file, /* @__PURE__ */ new Set());
+    graph.get(r.from_file).add(r.to_file);
+  }
+  return graph;
+}
+function inferLayerRules(depGraph) {
+  const layerEdges = /* @__PURE__ */ new Map();
+  const layerSet = /* @__PURE__ */ new Set();
+  for (const [file, deps] of depGraph) {
+    const fromLayer = getTopDir(file);
+    layerSet.add(fromLayer);
+    for (const dep of deps) {
+      const toLayer = getTopDir(dep);
+      if (fromLayer === toLayer) continue;
+      layerSet.add(toLayer);
+      const key = `${fromLayer}->${toLayer}`;
+      layerEdges.set(key, (layerEdges.get(key) ?? 0) + 1);
+    }
+  }
+  const rules = /* @__PURE__ */ new Map();
+  for (const [edge, count] of layerEdges) {
+    rules.set(edge, count <= 2 ? "violation" : "ok");
+  }
+  return rules;
+}
+function getTopDir(filePath) {
+  const parts = filePath.split("/");
+  return parts[0] ?? filePath;
+}
+function isLikelyTypeOnlyDep(dep) {
+  return dep.includes("types") || dep.endsWith(".d.ts");
+}
+function isStructuralRole(basename) {
+  if (basename === "index.ts" || basename === "index.js") return true;
+  if (basename === "cli.ts" || basename === "main.ts" || basename === "main.rs") return true;
+  if (basename.includes("worker.") || basename.includes("postinstall.")) return true;
+  if (basename === "health.ts" || basename === "health.js") return true;
+  return false;
+}
+
+export {
+  drift
+};
+//# sourceMappingURL=chunk-36OMT7ZJ.js.map

package/dist/chunk-36OMT7ZJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queries/drift.ts"],"sourcesContent":["import path from 'node:path';\nimport type { ScipDatabase } from '../db.js';\nimport { buildFileDepGraph } from '../query-support.js';\nimport type { DriftResult, DriftSummary } from '../types.js';\n\n/**\n * Detect structural drift using the reference graph, not just import patterns.\n *\n * Three types of drift, each detecting a real problem:\n *\n * 1. **Unused imports** — file depends on a module but never references\n *    any of its symbols. Dead dependency, safe to remove.\n *\n * 2. **Layer violations** — file imports from a directory it shouldn't\n *    based on the project's directory structure (e.g., a query importing\n *    from reindex, a helper importing from CLI). Architectural decay.\n *\n * 3. **Pattern deviations** — file imports something no sibling does,\n *    suggesting it's reaching outside its expected scope. Only flagged\n *    when the file is the ONLY one in its directory with that dep.\n */\nexport function drift(\n  db: ScipDatabase,\n  opts?: { scope?: string; minDeviation?: number },\n): DriftSummary {\n  const { scope } = opts ?? {};\n\n  // Build file dep graph (which files depend on which)\n  const depGraph = buildFileDepGraph(db, scope);\n\n  // Build symbol-level reference graph: for each file, which other files'\n  // symbols does it actually reference?\n  const symbolRefs = buildSymbolRefGraph(db, scope);\n\n  const results: DriftResult[] = [];\n\n  // ── Angle 1: Unused imports ──────────────────────────────\n  // File depends on module B (via dep graph) but never references\n  // any symbol defined in B (via symbol ref graph).\n  for (const [file, deps] of depGraph) {\n    if (isStructuralRole(path.basename(file))) continue;\n\n    const referencedFiles = symbolRefs.get(file) ?? new Set<string>();\n\n    for (const dep of deps) {\n      if (!referencedFiles.has(dep)) {\n        // This file \"depends on\" dep but never references its symbols.\n        // This can happen when the dep is imported for types only\n        // (which don't appear in the mention graph). Skip type-heavy deps.\n        if (isLikelyTypeOnlyDep(dep)) continue;\n\n        results.push({\n          file,\n          kind: 'unused-import',\n          description: `Depends on ${dep} but references none of its symbols`,\n          dep,\n        });\n      }\n    }\n  }\n\n  // ── Angle 2: Layer violations ────────────────────────────\n  // Detect when a file imports from a directory that represents\n  // a different architectural layer. We infer layers from the\n  // directory structure: files in the same top-level dir are peers,\n  // files in different top-level dirs crossing inward is a violation.\n  const layerRules = inferLayerRules(depGraph);\n\n  for (const [file, deps] of depGraph) {\n    if (isStructuralRole(path.basename(file))) continue;\n\n    const fileLayer = getTopDir(file);\n    for (const dep of deps) {\n      const depLayer = getTopDir(dep);\n      if (fileLayer === depLayer) continue; // same layer, fine\n\n      const violation = layerRules.get(`${fileLayer}->${depLayer}`);\n      if (violation === 'violation') {\n        results.push({\n          file,\n          kind: 'layer-violation',\n          description: `Imports from ${depLayer}/ (${dep}) — may cross architectural boundary`,\n          dep,\n          detail: `${fileLayer}/ should not depend on ${depLayer}/`,\n        });\n      }\n    }\n  }\n\n  // ── Angle 3: Unique deps (pattern deviation) ─────────────\n  // If a file is the ONLY one in its directory that depends on a\n  // particular module, that dependency is unusual and worth flagging.\n  const dirToFiles = new Map<string, string[]>();\n  for (const file of depGraph.keys()) {\n    const dir = path.dirname(file);\n    if (!dirToFiles.has(dir)) dirToFiles.set(dir, []);\n    dirToFiles.get(dir)!.push(file);\n  }\n\n  for (const [dir, files] of dirToFiles) {\n    if (files.length < 3) continue;\n\n    // Count dep frequency across siblings\n    const depFreq = new Map<string, number>();\n    for (const file of files) {\n      if (isStructuralRole(path.basename(file))) continue;\n      for (const dep of depGraph.get(file) ?? []) {\n        depFreq.set(dep, (depFreq.get(dep) ?? 0) + 1);\n      }\n    }\n\n    for (const file of files) {\n      if (isStructuralRole(path.basename(file))) continue;\n      for (const dep of depGraph.get(file) ?? []) {\n        if ((depFreq.get(dep) ?? 0) === 1) {\n          // This file is the only one in its dir that depends on this module\n          // Skip if dep is in the same directory (sibling imports are normal)\n          if (path.dirname(dep) === dir) continue;\n\n          results.push({\n            file,\n            kind: 'pattern-deviation',\n            description: `Only file in ${dir}/ that depends on ${dep}`,\n            dep,\n          });\n        }\n      }\n    }\n  }\n\n  return {\n    results,\n    unusedImports: results.filter((r) => r.kind === 'unused-import').length,\n    layerViolations: results.filter((r) => r.kind === 'layer-violation').length,\n    patternDeviations: results.filter((r) => r.kind === 'pattern-deviation').length,\n  };\n}\n\n// ── Helpers ────────────────────────────────────────────────\n\n/**\n * Build a map of file → set of files whose symbols it references.\n * This is more precise than the dep graph because it uses actual\n * symbol mentions, not just import statements.\n */\nfunction buildSymbolRefGraph(\n  db: ScipDatabase,\n  scope?: string,\n): Map<string, Set<string>> {\n  const scopeFilter = scope ? `AND d1.relative_path LIKE '%${scope}%'` : '';\n\n  const rows = db.all<{ from_file: string; to_file: string }>(\n    `SELECT DISTINCT d1.relative_path AS from_file, d2.relative_path AS to_file\n    FROM mentions m\n    JOIN chunks c ON m.chunk_id = c.id\n    JOIN documents d1 ON c.document_id = d1.id\n    JOIN global_symbols gs ON m.symbol_id = gs.id\n    JOIN defn_enclosing_ranges der ON gs.id = der.symbol_id\n    JOIN documents d2 ON der.document_id = d2.id\n    WHERE d1.id != d2.id\n      AND m.role = 0\n      ${db.pathExclusionsFor('d1', 'd2')}\n      ${scopeFilter}`,\n  );\n\n  const graph = new Map<string, Set<string>>();\n  for (const r of rows) {\n    if (db.isIgnored(r.from_file) || db.isIgnored(r.to_file)) continue;\n    if (!graph.has(r.from_file)) graph.set(r.from_file, new Set());\n    graph.get(r.from_file)!.add(r.to_file);\n  }\n  return graph;\n}\n\n/**\n * Infer layer boundary rules from the dependency graph.\n * If directory A never depends on directory B across the entire codebase,\n * then a new A→B dependency is a violation.\n */\nfunction inferLayerRules(\n  depGraph: Map<string, Set<string>>,\n): Map<string, 'ok' | 'violation'> {\n  const layerEdges = new Map<string, number>();\n  const layerSet = new Set<string>();\n\n  for (const [file, deps] of depGraph) {\n    const fromLayer = getTopDir(file);\n    layerSet.add(fromLayer);\n    for (const dep of deps) {\n      const toLayer = getTopDir(dep);\n      if (fromLayer === toLayer) continue;\n      layerSet.add(toLayer);\n      const key = `${fromLayer}->${toLayer}`;\n      layerEdges.set(key, (layerEdges.get(key) ?? 0) + 1);\n    }\n  }\n\n  // An edge that appears only 1-2 times across the whole codebase\n  // is likely a violation (anomalous cross-layer dep).\n  // Edges that appear many times are established patterns.\n  const rules = new Map<string, 'ok' | 'violation'>();\n  for (const [edge, count] of layerEdges) {\n    rules.set(edge, count <= 2 ? 'violation' : 'ok');\n  }\n\n  return rules;\n}\n\nfunction getTopDir(filePath: string): string {\n  const parts = filePath.split('/');\n  return parts[0] ?? filePath;\n}\n\nfunction isLikelyTypeOnlyDep(dep: string): boolean {\n  return dep.includes('types') || dep.endsWith('.d.ts');\n}\n\nfunction isStructuralRole(basename: string): boolean {\n  if (basename === 'index.ts' || basename === 'index.js') return true;\n  if (basename === 'cli.ts' || basename === 'main.ts' || basename === 'main.rs') return true;\n  if (basename.includes('worker.') || basename.includes('postinstall.')) return true;\n  if (basename === 'health.ts' || basename === 'health.js') return true;\n  return false;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-3E2X7RIE.js

@@ -0,0 +1,101 @@
+import {
+  shortenSymbol
+} from "./chunk-QOV2R2WT.js";
+
+// src/queries/redundant-reexports.ts
+function redundantReexports(db, opts = {}) {
+  const { scope, limit } = opts;
+  const scopeFilter = scope ? `AND barrel_d.relative_path LIKE '%${scope}%'` : "";
+  const reexportRows = db.all(
+    `SELECT DISTINCT
+      barrel_d.id AS barrel_doc_id,
+      barrel_d.relative_path AS barrel_path,
+      gs.id AS symbol_id,
+      gs.symbol AS symbol,
+      orig_d.id AS original_doc_id,
+      orig_d.relative_path AS original_path
+    FROM mentions m
+    JOIN chunks c ON m.chunk_id = c.id
+    JOIN documents barrel_d ON c.document_id = barrel_d.id
+    JOIN global_symbols gs ON m.symbol_id = gs.id
+    JOIN defn_enclosing_ranges der ON gs.id = der.symbol_id
+    JOIN documents orig_d ON der.document_id = orig_d.id
+    WHERE m.role = 0
+      AND (barrel_d.relative_path LIKE '%/index.ts'
+        OR barrel_d.relative_path LIKE '%/index.js'
+        OR barrel_d.relative_path = 'index.ts'
+        OR barrel_d.relative_path = 'index.js')
+      AND orig_d.id != barrel_d.id
+      ${db.pathExclusionsFor("barrel_d", "orig_d")}
+      ${db.symbolNoiseFor("gs")}
+      -- Only function-level symbols (ending with ().), not module-level
+      AND gs.symbol LIKE '%().'
+      ${scopeFilter}
+    ORDER BY barrel_d.relative_path, gs.symbol`
+  );
+  const results = [];
+  for (const row of reexportRows) {
+    if (db.isIgnored(row.barrel_path) || db.isIgnored(row.original_path)) continue;
+    const consumerCounts = db.get(
+      `SELECT
+        SUM(CASE WHEN uses_barrel = 1 THEN 1 ELSE 0 END) AS barrel_consumers,
+        SUM(CASE WHEN uses_barrel = 0 THEN 1 ELSE 0 END) AS direct_consumers
+      FROM (
+        SELECT
+          consumer_d.id AS consumer_doc_id,
+          MAX(CASE WHEN EXISTS (
+            SELECT 1
+            FROM mentions barrel_m
+            JOIN chunks barrel_c ON barrel_m.chunk_id = barrel_c.id
+            WHERE barrel_c.document_id = consumer_d.id
+              AND barrel_m.role = 0
+              AND barrel_m.symbol_id IN (
+                SELECT m2.symbol_id
+                FROM mentions m2
+                JOIN chunks c2 ON m2.chunk_id = c2.id
+                WHERE c2.document_id = ?
+                  AND m2.role = 0
+              )
+          ) THEN 1 ELSE 0 END) AS uses_barrel
+        FROM mentions ref_m
+        JOIN chunks ref_c ON ref_m.chunk_id = ref_c.id
+        JOIN documents consumer_d ON ref_c.document_id = consumer_d.id
+        WHERE ref_m.symbol_id = ?
+          AND ref_m.role = 0
+          AND consumer_d.id != ?
+          AND consumer_d.id != ?
+          ${db.pathExclusionsFor("consumer_d")}
+        GROUP BY consumer_d.id
+      )`,
+      row.barrel_doc_id,
+      // for the inner subquery checking barrel mentions
+      row.symbol_id,
+      // the re-exported symbol
+      row.barrel_doc_id,
+      // exclude the barrel itself
+      row.original_doc_id
+      // exclude the original file
+    );
+    const barrelConsumers = consumerCounts?.barrel_consumers ?? 0;
+    const directConsumers = consumerCounts?.direct_consumers ?? 0;
+    if (barrelConsumers === 0 && directConsumers === 0) {
+      results.push({
+        barrelFile: row.barrel_path,
+        symbol: row.symbol,
+        shortName: shortenSymbol(row.symbol),
+        originalFile: row.original_path,
+        barrelConsumers,
+        directConsumers
+      });
+    }
+  }
+  results.sort(
+    (a, b) => b.directConsumers - a.directConsumers || a.barrelFile.localeCompare(b.barrelFile) || a.shortName.localeCompare(b.shortName)
+  );
+  return limit ? results.slice(0, limit) : results;
+}
+
+export {
+  redundantReexports
+};
+//# sourceMappingURL=chunk-3E2X7RIE.js.map

package/dist/chunk-3E2X7RIE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queries/redundant-reexports.ts"],"sourcesContent":["import type { ScipDatabase } from '../db.js';\nimport type { RedundantReexport } from '../types.js';\nimport { shortenSymbol } from '../symbol-parser.js';\n\n/**\n * Find barrel re-exports that no consumer actually imports through.\n *\n * If `queries/index.ts` re-exports `byKind` from `by-kind.ts`, but every\n * consumer of `byKind` imports it directly from `by-kind.ts` (not through\n * `index.ts`), the re-export in the barrel is dead weight.\n *\n * Algorithm:\n * 1. Find all barrel files (index.ts / index.js)\n * 2. For each barrel, find symbols it re-exports (defined elsewhere, referenced in barrel with role=0)\n * 3. For each re-exported symbol, count consumers through the barrel vs direct from the source\n * 4. If zero consumers go through the barrel, the re-export is redundant\n */\nexport function redundantReexports(\n  db: ScipDatabase,\n  opts: { scope?: string; limit?: number } = {},\n): RedundantReexport[] {\n  const { scope, limit } = opts;\n\n  const scopeFilter = scope ? `AND barrel_d.relative_path LIKE '%${scope}%'` : '';\n\n  // Step 1 + 2: Find all barrel files and symbols they re-export.\n  // A re-export is a symbol that:\n  //   - is mentioned in a barrel file with role=0 (reference/import)\n  //   - has its definition (defn_enclosing_ranges) in a DIFFERENT file\n  const reexportRows = db.all<{\n    barrel_doc_id: number;\n    barrel_path: string;\n    symbol_id: number;\n    symbol: string;\n    original_doc_id: number;\n    original_path: string;\n  }>(\n    `SELECT DISTINCT\n      barrel_d.id AS barrel_doc_id,\n      barrel_d.relative_path AS barrel_path,\n      gs.id AS symbol_id,\n      gs.symbol AS symbol,\n      orig_d.id AS original_doc_id,\n      orig_d.relative_path AS original_path\n    FROM mentions m\n    JOIN chunks c ON m.chunk_id = c.id\n    JOIN documents barrel_d ON c.document_id = barrel_d.id\n    JOIN global_symbols gs ON m.symbol_id = gs.id\n    JOIN defn_enclosing_ranges der ON gs.id = der.symbol_id\n    JOIN documents orig_d ON der.document_id = orig_d.id\n    WHERE m.role = 0\n      AND (barrel_d.relative_path LIKE '%/index.ts'\n        OR barrel_d.relative_path LIKE '%/index.js'\n        OR barrel_d.relative_path = 'index.ts'\n        OR barrel_d.relative_path = 'index.js')\n      AND orig_d.id != barrel_d.id\n      ${db.pathExclusionsFor('barrel_d', 'orig_d')}\n      ${db.symbolNoiseFor('gs')}\n      -- Only function-level symbols (ending with ().), not module-level\n      AND gs.symbol LIKE '%().'\n      ${scopeFilter}\n    ORDER BY barrel_d.relative_path, gs.symbol`,\n  );\n\n  const results: RedundantReexport[] = [];\n\n  for (const row of reexportRows) {\n    if (db.isIgnored(row.barrel_path) || db.isIgnored(row.original_path)) continue;\n\n    // Step 3: Count consumers that reference this symbol through the barrel\n    // A \"barrel consumer\" is a file (other than the barrel itself and the original file)\n    // that mentions this symbol AND also mentions something from the barrel document.\n    // More precisely: count distinct files that reference this symbol AND whose\n    // chunk is in a document that also has a role=0 mention pointing to the barrel file's symbols.\n    //\n    // Simpler approach: count distinct documents that reference this symbol (role=0)\n    // grouped by whether the reference chunk is in a file that imports from the barrel\n    // or from the original.\n    //\n    // Actually, the most reliable approach with SCIP data: count how many distinct\n    // consumer documents reference this symbol_id with role=0, excluding the barrel\n    // and the original file themselves. Then check if those consumers also reference\n    // ANY symbol through a mention in the barrel doc vs the original doc.\n    //\n    // Simplest correct approach: In SCIP, when file A does `import { foo } from './bar/index'`,\n    // the mention of `foo` in file A points to the same global symbol regardless of import path.\n    // SCIP doesn't track import provenance. BUT the barrel file itself contains mentions\n    // (role=0 references) of the re-exported symbols. So we can check:\n    // - barrelConsumers: files that mention both this symbol AND any symbol whose definition\n    //   is in the barrel (i.e., they import the barrel)\n    // - directConsumers: files that mention this symbol but don't import the barrel\n    //\n    // Even simpler: check if the barrel document is in the deps of the consumer.\n    // A consumer \"goes through the barrel\" if it has ANY role=0 mention pointing to a\n    // chunk in the barrel file. Otherwise it goes direct.\n\n    const consumerCounts = db.get<{\n      barrel_consumers: number;\n      direct_consumers: number;\n    }>(\n      `SELECT\n        SUM(CASE WHEN uses_barrel = 1 THEN 1 ELSE 0 END) AS barrel_consumers,\n        SUM(CASE WHEN uses_barrel = 0 THEN 1 ELSE 0 END) AS direct_consumers\n      FROM (\n        SELECT\n          consumer_d.id AS consumer_doc_id,\n          MAX(CASE WHEN EXISTS (\n            SELECT 1\n            FROM mentions barrel_m\n            JOIN chunks barrel_c ON barrel_m.chunk_id = barrel_c.id\n            WHERE barrel_c.document_id = consumer_d.id\n              AND barrel_m.role = 0\n              AND barrel_m.symbol_id IN (\n                SELECT m2.symbol_id\n                FROM mentions m2\n                JOIN chunks c2 ON m2.chunk_id = c2.id\n                WHERE c2.document_id = ?\n                  AND m2.role = 0\n              )\n          ) THEN 1 ELSE 0 END) AS uses_barrel\n        FROM mentions ref_m\n        JOIN chunks ref_c ON ref_m.chunk_id = ref_c.id\n        JOIN documents consumer_d ON ref_c.document_id = consumer_d.id\n        WHERE ref_m.symbol_id = ?\n          AND ref_m.role = 0\n          AND consumer_d.id != ?\n          AND consumer_d.id != ?\n          ${db.pathExclusionsFor('consumer_d')}\n        GROUP BY consumer_d.id\n      )`,\n      row.barrel_doc_id,  // for the inner subquery checking barrel mentions\n      row.symbol_id,      // the re-exported symbol\n      row.barrel_doc_id,  // exclude the barrel itself\n      row.original_doc_id, // exclude the original file\n    );\n\n    const barrelConsumers = consumerCounts?.barrel_consumers ?? 0;\n    const directConsumers = consumerCounts?.direct_consumers ?? 0;\n\n    // In TypeScript, `import * as X from './barrel'` resolves all references\n    // directly to the source file — the barrel is transparent to SCIP.\n    // This means barrelConsumers is always 0 for namespace imports.\n    //\n    // We can only confidently report symbols with 0 consumers EVERYWHERE\n    // (both barrel and direct). These are truly dead re-exports.\n    //\n    // Symbols with directConsumers > 0 but barrelConsumers === 0 might be\n    // consumed through a namespace import — we can't tell, so we skip them.\n    if (barrelConsumers === 0 && directConsumers === 0) {\n      results.push({\n        barrelFile: row.barrel_path,\n        symbol: row.symbol,\n        shortName: shortenSymbol(row.symbol),\n        originalFile: row.original_path,\n        barrelConsumers,\n        directConsumers,\n      });\n    }\n  }\n\n  // Sort: symbols with the most direct consumers first (biggest cleanup wins),\n  // then by barrel file path for stable output\n  results.sort((a, b) =>\n    b.directConsumers - a.directConsumers\n    || a.barrelFile.localeCompare(b.barrelFile)\n    || a.shortName.localeCompare(b.shortName),\n  );\n\n  return limit ? results.slice(0, limit) : results;\n}\n"],"mappings":";;;;;AAiBO,SAAS,mBACd,IACA,OAA2C,CAAC,GACvB;AACrB,QAAM,EAAE,OAAO,MAAM,IAAI;AAEzB,QAAM,cAAc,QAAQ,qCAAqC,KAAK,OAAO;AAM7E,QAAM,eAAe,GAAG;AAAA,IAQtB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAmBI,GAAG,kBAAkB,YAAY,QAAQ,CAAC;AAAA,QAC1C,GAAG,eAAe,IAAI,CAAC;AAAA;AAAA;AAAA,QAGvB,WAAW;AAAA;AAAA,EAEjB;AAEA,QAAM,UAA+B,CAAC;AAEtC,aAAW,OAAO,cAAc;AAC9B,QAAI,GAAG,UAAU,IAAI,WAAW,KAAK,GAAG,UAAU,IAAI,aAAa,EAAG;AA6BtE,UAAM,iBAAiB,GAAG;AAAA,MAIxB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,YA2BM,GAAG,kBAAkB,YAAY,CAAC;AAAA;AAAA;AAAA,MAGxC,IAAI;AAAA;AAAA,MACJ,IAAI;AAAA;AAAA,MACJ,IAAI;AAAA;AAAA,MACJ,IAAI;AAAA;AAAA,IACN;AAEA,UAAM,kBAAkB,gBAAgB,oBAAoB;AAC5D,UAAM,kBAAkB,gBAAgB,oBAAoB;AAW5D,QAAI,oBAAoB,KAAK,oBAAoB,GAAG;AAClD,cAAQ,KAAK;AAAA,QACX,YAAY,IAAI;AAAA,QAChB,QAAQ,IAAI;AAAA,QACZ,WAAW,cAAc,IAAI,MAAM;AAAA,QACnC,cAAc,IAAI;AAAA,QAClB;AAAA,QACA;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AAIA,UAAQ;AAAA,IAAK,CAAC,GAAG,MACf,EAAE,kBAAkB,EAAE,mBACnB,EAAE,WAAW,cAAc,EAAE,UAAU,KACvC,EAAE,UAAU,cAAc,EAAE,SAAS;AAAA,EAC1C;AAEA,SAAO,QAAQ,QAAQ,MAAM,GAAG,KAAK,IAAI;AAC3C;","names":[]}

package/dist/chunk-3UOUTZQT.js

@@ -0,0 +1,45 @@
+import {
+  parseSymbol,
+  shortenSymbol
+} from "./chunk-QOV2R2WT.js";
+
+// src/queries/members.ts
+function members(db, symbolPattern) {
+  const parents = db.all(
+    `SELECT symbol FROM global_symbols WHERE symbol LIKE ?`,
+    `%${symbolPattern}%`
+  );
+  if (parents.length === 0) return [];
+  const placeholders = parents.map(() => "?").join(",");
+  const parentSymbols = parents.map((p) => p.symbol);
+  const rows = db.all(
+    `SELECT gs.symbol, der.start_line, der.end_line
+    FROM global_symbols gs
+    JOIN defn_enclosing_ranges der ON gs.id = der.symbol_id
+    WHERE gs.enclosing_symbol IN (${placeholders})
+      ${db.symbolNoise}
+    ORDER BY der.start_line`,
+    ...parentSymbols
+  );
+  return rows.map((r) => {
+    const parsed = parseSymbol(r.symbol);
+    let kind = "unknown";
+    if (!("kind" in parsed)) {
+      const sym = parsed;
+      const last = sym.descriptors[sym.descriptors.length - 1];
+      if (last) kind = last.suffix;
+    }
+    return {
+      symbol: r.symbol,
+      shortName: shortenSymbol(r.symbol),
+      startLine: r.start_line,
+      endLine: r.end_line,
+      kind
+    };
+  });
+}
+
+export {
+  members
+};
+//# sourceMappingURL=chunk-3UOUTZQT.js.map

package/dist/chunk-3UOUTZQT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queries/members.ts"],"sourcesContent":["import type { ScipDatabase } from '../db.js';\nimport type { MemberResult } from '../types.js';\nimport { shortenSymbol, parseSymbol } from '../symbol-parser.js';\nimport type { ScipSymbol } from '../types.js';\n\n/**\n * Find all direct children of a symbol (methods, fields, nested types).\n * Uses the enclosing_symbol relationship in global_symbols.\n */\nexport function members(db: ScipDatabase, symbolPattern: string): MemberResult[] {\n  // First find the parent symbol(s)\n  const parents = db.all<{ symbol: string }>(\n    `SELECT symbol FROM global_symbols WHERE symbol LIKE ?`,\n    `%${symbolPattern}%`,\n  );\n\n  if (parents.length === 0) return [];\n\n  // Find children whose enclosing_symbol matches any parent\n  const placeholders = parents.map(() => '?').join(',');\n  const parentSymbols = parents.map((p) => p.symbol);\n\n  const rows = db.all<{\n    symbol: string;\n    start_line: number;\n    end_line: number;\n  }>(\n    `SELECT gs.symbol, der.start_line, der.end_line\n    FROM global_symbols gs\n    JOIN defn_enclosing_ranges der ON gs.id = der.symbol_id\n    WHERE gs.enclosing_symbol IN (${placeholders})\n      ${db.symbolNoise}\n    ORDER BY der.start_line`,\n    ...parentSymbols,\n  );\n\n  return rows.map((r) => {\n    const parsed = parseSymbol(r.symbol);\n    let kind = 'unknown';\n    if (!('kind' in parsed)) {\n      const sym = parsed as ScipSymbol;\n      const last = sym.descriptors[sym.descriptors.length - 1];\n      if (last) kind = last.suffix;\n    }\n\n    return {\n      symbol: r.symbol,\n      shortName: shortenSymbol(r.symbol),\n      startLine: r.start_line,\n      endLine: r.end_line,\n      kind,\n    };\n  });\n}\n"],"mappings":";;;;;;AASO,SAAS,QAAQ,IAAkB,eAAuC;AAE/E,QAAM,UAAU,GAAG;AAAA,IACjB;AAAA,IACA,IAAI,aAAa;AAAA,EACnB;AAEA,MAAI,QAAQ,WAAW,EAAG,QAAO,CAAC;AAGlC,QAAM,eAAe,QAAQ,IAAI,MAAM,GAAG,EAAE,KAAK,GAAG;AACpD,QAAM,gBAAgB,QAAQ,IAAI,CAAC,MAAM,EAAE,MAAM;AAEjD,QAAM,OAAO,GAAG;AAAA,IAKd;AAAA;AAAA;AAAA,oCAGgC,YAAY;AAAA,QACxC,GAAG,WAAW;AAAA;AAAA,IAElB,GAAG;AAAA,EACL;AAEA,SAAO,KAAK,IAAI,CAAC,MAAM;AACrB,UAAM,SAAS,YAAY,EAAE,MAAM;AACnC,QAAI,OAAO;AACX,QAAI,EAAE,UAAU,SAAS;AACvB,YAAM,MAAM;AACZ,YAAM,OAAO,IAAI,YAAY,IAAI,YAAY,SAAS,CAAC;AACvD,UAAI,KAAM,QAAO,KAAK;AAAA,IACxB;AAEA,WAAO;AAAA,MACL,QAAQ,EAAE;AAAA,MACV,WAAW,cAAc,EAAE,MAAM;AAAA,MACjC,WAAW,EAAE;AAAA,MACb,SAAS,EAAE;AAAA,MACX;AAAA,IACF;AAAA,EACF,CAAC;AACH;","names":[]}

package/dist/chunk-3ZZJVBIO.js

@@ -0,0 +1,88 @@
+import {
+  TEST_FILE_PATTERNS,
+  testFileExclusionSql,
+  testFileMatchSql
+} from "./chunk-FUHJCHS4.js";
+import {
+  shortenSymbol
+} from "./chunk-QOV2R2WT.js";
+
+// src/queries/test-coverage.ts
+function testCoverage(db, symbolPattern) {
+  const syms = db.all(
+    `SELECT gs.id, gs.symbol, d.relative_path
+    FROM global_symbols gs
+    JOIN defn_enclosing_ranges der ON gs.id = der.symbol_id
+    JOIN documents d ON der.document_id = d.id
+    WHERE gs.symbol LIKE ?
+      ${db.pathExclusionsFor("d")}
+      ${db.symbolNoiseFor("gs")}
+    ORDER BY d.relative_path`,
+    `%${symbolPattern}%`
+  );
+  const testPatternSql = testFileMatchSql("ref_d", TEST_FILE_PATTERNS);
+  return syms.filter((s) => !db.isIgnored(s.relative_path)).map((s) => {
+    const testFiles = db.all(
+      `SELECT DISTINCT ref_d.relative_path
+        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 = 0
+          AND (${testPatternSql})
+        ORDER BY ref_d.relative_path`,
+      s.id
+    ).map((r) => r.relative_path);
+    return {
+      symbol: s.symbol,
+      shortName: shortenSymbol(s.symbol),
+      definedIn: s.relative_path,
+      testFiles,
+      covered: testFiles.length > 0
+    };
+  });
+}
+function testCoverageSummary(db, opts = {}) {
+  const { scope, minLoc = 3 } = opts;
+  const scopeFilter = scope ? `AND d.relative_path LIKE '%${scope}%'` : "";
+  const testPatternSql = testFileExclusionSql("d");
+  const symbols = db.all(
+    `SELECT gs.id
+    FROM global_symbols gs
+    JOIN defn_enclosing_ranges der ON gs.id = der.symbol_id
+    JOIN documents d ON der.document_id = d.id
+    WHERE 1 = 1
+      ${db.pathExclusionsFor("d")}
+      AND ${testPatternSql}
+      ${db.symbolNoiseFor("gs")}
+      AND gs.symbol NOT LIKE '%#%'
+      AND (der.end_line - der.start_line + 1) >= ?
+      ${scopeFilter}`,
+    minLoc
+  );
+  const testRefSql = testFileMatchSql("ref_d", TEST_FILE_PATTERNS);
+  let covered = 0;
+  for (const s of symbols) {
+    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 = 0 AND (${testRefSql})`,
+      s.id
+    );
+    if (hasTest && hasTest.c > 0) covered++;
+  }
+  const total = symbols.length;
+  return {
+    total,
+    covered,
+    uncovered: total - covered,
+    percent: total > 0 ? Math.round(covered / total * 100) : 0
+  };
+}
+
+export {
+  testCoverage,
+  testCoverageSummary
+};
+//# sourceMappingURL=chunk-3ZZJVBIO.js.map

package/dist/chunk-3ZZJVBIO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queries/test-coverage.ts"],"sourcesContent":["import type { ScipDatabase } from '../db.js';\nimport { TEST_FILE_PATTERNS, testFileExclusionSql, testFileMatchSql } from '../query-support.js';\nimport type { TestCoverageResult } from '../types.js';\nimport { shortenSymbol } from '../symbol-parser.js';\n\n/**\n * Check if a symbol is referenced by any test file.\n * Reports which test files cover (reference) each matching symbol.\n */\nexport function testCoverage(\n  db: ScipDatabase,\n  symbolPattern: string,\n): TestCoverageResult[] {\n  // Find matching symbols\n  const syms = db.all<{\n    id: number;\n    symbol: string;\n    relative_path: string;\n  }>(\n    `SELECT gs.id, gs.symbol, d.relative_path\n    FROM global_symbols gs\n    JOIN defn_enclosing_ranges der ON gs.id = der.symbol_id\n    JOIN documents d ON der.document_id = d.id\n    WHERE gs.symbol LIKE ?\n      ${db.pathExclusionsFor('d')}\n      ${db.symbolNoiseFor('gs')}\n    ORDER BY d.relative_path`,\n    `%${symbolPattern}%`,\n  );\n\n  const testPatternSql = testFileMatchSql('ref_d', TEST_FILE_PATTERNS);\n\n  return syms\n    .filter((s) => !db.isIgnored(s.relative_path))\n    .map((s) => {\n      // Find test files that reference this symbol\n      const testFiles = db.all<{ relative_path: string }>(\n        `SELECT DISTINCT ref_d.relative_path\n        FROM mentions m\n        JOIN chunks c ON m.chunk_id = c.id\n        JOIN documents ref_d ON c.document_id = ref_d.id\n        WHERE m.symbol_id = ?\n          AND m.role = 0\n          AND (${testPatternSql})\n        ORDER BY ref_d.relative_path`,\n        s.id,\n      ).map((r) => r.relative_path);\n\n      return {\n        symbol: s.symbol,\n        shortName: shortenSymbol(s.symbol),\n        definedIn: s.relative_path,\n        testFiles,\n        covered: testFiles.length > 0,\n      };\n    });\n}\n\n/**\n * Summary: what percentage of symbols in scope are referenced by test files?\n */\nexport function testCoverageSummary(\n  db: ScipDatabase,\n  opts: { scope?: string; minLoc?: number } = {},\n): { total: number; covered: number; uncovered: number; percent: number } {\n  const { scope, minLoc = 3 } = opts;\n  const scopeFilter = scope ? `AND d.relative_path LIKE '%${scope}%'` : '';\n  const testPatternSql = testFileExclusionSql('d');\n\n  const symbols = db.all<{ id: number }>(\n    `SELECT gs.id\n    FROM global_symbols gs\n    JOIN defn_enclosing_ranges der ON gs.id = der.symbol_id\n    JOIN documents d ON der.document_id = d.id\n    WHERE 1 = 1\n      ${db.pathExclusionsFor('d')}\n      AND ${testPatternSql}\n      ${db.symbolNoiseFor('gs')}\n      AND gs.symbol NOT LIKE '%#%'\n      AND (der.end_line - der.start_line + 1) >= ?\n      ${scopeFilter}`,\n    minLoc,\n  );\n\n  const testRefSql = testFileMatchSql('ref_d', TEST_FILE_PATTERNS);\n\n  let covered = 0;\n  for (const s of symbols) {\n    const hasTest = db.get<{ c: number }>(\n      `SELECT COUNT(*) AS c FROM mentions m\n       JOIN chunks c ON m.chunk_id = c.id\n       JOIN documents ref_d ON c.document_id = ref_d.id\n       WHERE m.symbol_id = ? AND m.role = 0 AND (${testRefSql})`,\n      s.id,\n    );\n    if (hasTest && hasTest.c > 0) covered++;\n  }\n\n  const total = symbols.length;\n  return {\n    total,\n    covered,\n    uncovered: total - covered,\n    percent: total > 0 ? Math.round((covered / total) * 100) : 0,\n  };\n}\n"],"mappings":";;;;;;;;;;AASO,SAAS,aACd,IACA,eACsB;AAEtB,QAAM,OAAO,GAAG;AAAA,IAKd;AAAA;AAAA;AAAA;AAAA;AAAA,QAKI,GAAG,kBAAkB,GAAG,CAAC;AAAA,QACzB,GAAG,eAAe,IAAI,CAAC;AAAA;AAAA,IAE3B,IAAI,aAAa;AAAA,EACnB;AAEA,QAAM,iBAAiB,iBAAiB,SAAS,kBAAkB;AAEnE,SAAO,KACJ,OAAO,CAAC,MAAM,CAAC,GAAG,UAAU,EAAE,aAAa,CAAC,EAC5C,IAAI,CAAC,MAAM;AAEV,UAAM,YAAY,GAAG;AAAA,MACnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iBAMS,cAAc;AAAA;AAAA,MAEvB,EAAE;AAAA,IACJ,EAAE,IAAI,CAAC,MAAM,EAAE,aAAa;AAE5B,WAAO;AAAA,MACL,QAAQ,EAAE;AAAA,MACV,WAAW,cAAc,EAAE,MAAM;AAAA,MACjC,WAAW,EAAE;AAAA,MACb;AAAA,MACA,SAAS,UAAU,SAAS;AAAA,IAC9B;AAAA,EACF,CAAC;AACL;AAKO,SAAS,oBACd,IACA,OAA4C,CAAC,GAC2B;AACxE,QAAM,EAAE,OAAO,SAAS,EAAE,IAAI;AAC9B,QAAM,cAAc,QAAQ,8BAA8B,KAAK,OAAO;AACtE,QAAM,iBAAiB,qBAAqB,GAAG;AAE/C,QAAM,UAAU,GAAG;AAAA,IACjB;AAAA;AAAA;AAAA;AAAA;AAAA,QAKI,GAAG,kBAAkB,GAAG,CAAC;AAAA,YACrB,cAAc;AAAA,QAClB,GAAG,eAAe,IAAI,CAAC;AAAA;AAAA;AAAA,QAGvB,WAAW;AAAA,IACf;AAAA,EACF;AAEA,QAAM,aAAa,iBAAiB,SAAS,kBAAkB;AAE/D,MAAI,UAAU;AACd,aAAW,KAAK,SAAS;AACvB,UAAM,UAAU,GAAG;AAAA,MACjB;AAAA;AAAA;AAAA,mDAG6C,UAAU;AAAA,MACvD,EAAE;AAAA,IACJ;AACA,QAAI,WAAW,QAAQ,IAAI,EAAG;AAAA,EAChC;AAEA,QAAM,QAAQ,QAAQ;AACtB,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,WAAW,QAAQ;AAAA,IACnB,SAAS,QAAQ,IAAI,KAAK,MAAO,UAAU,QAAS,GAAG,IAAI;AAAA,EAC7D;AACF;","names":[]}

package/dist/chunk-4TYLS5XX.js

@@ -0,0 +1,10 @@
+// src/queries/clean-signature.ts
+function cleanSignature(sig) {
+  if (!sig || !sig.trim()) return null;
+  return sig.replace(/^```\w*\s*/, "").replace(/\s*```$/, "").replace(/^\(method\)\s*/, "").replace(/^\(property\)\s*/, "").replace(/^\(function\)\s*/, "").replace(/^\(class\)\s*/, "").replace(/^\(interface\)\s*/, "").replace(/^\(enum\)\s*/, "").replace(/^\(type alias\)\s*/, "").replace(/^\(const\)\s*/, "").replace(/^\(var\)\s*/, "").trim() || null;
+}
+
+export {
+  cleanSignature
+};
+//# sourceMappingURL=chunk-4TYLS5XX.js.map

package/dist/chunk-4TYLS5XX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queries/clean-signature.ts"],"sourcesContent":["/**\n * Clean up the raw doc/signature string from the SCIP index.\n *\n * Shared across symbols, trace, and system queries.\n * Previously duplicated as cleanSig/cleanSignature in three files.\n */\nexport function cleanSignature(sig: string | null): string | null {\n  if (!sig || !sig.trim()) return null;\n  return sig\n    .replace(/^```\\w*\\s*/, '')\n    .replace(/\\s*```$/, '')\n    .replace(/^\\(method\\)\\s*/, '')\n    .replace(/^\\(property\\)\\s*/, '')\n    .replace(/^\\(function\\)\\s*/, '')\n    .replace(/^\\(class\\)\\s*/, '')\n    .replace(/^\\(interface\\)\\s*/, '')\n    .replace(/^\\(enum\\)\\s*/, '')\n    .replace(/^\\(type alias\\)\\s*/, '')\n    .replace(/^\\(const\\)\\s*/, '')\n    .replace(/^\\(var\\)\\s*/, '')\n    .trim() || null;\n}\n"],"mappings":";AAMO,SAAS,eAAe,KAAmC;AAChE,MAAI,CAAC,OAAO,CAAC,IAAI,KAAK,EAAG,QAAO;AAChC,SAAO,IACJ,QAAQ,cAAc,EAAE,EACxB,QAAQ,WAAW,EAAE,EACrB,QAAQ,kBAAkB,EAAE,EAC5B,QAAQ,oBAAoB,EAAE,EAC9B,QAAQ,oBAAoB,EAAE,EAC9B,QAAQ,iBAAiB,EAAE,EAC3B,QAAQ,qBAAqB,EAAE,EAC/B,QAAQ,gBAAgB,EAAE,EAC1B,QAAQ,sBAAsB,EAAE,EAChC,QAAQ,iBAAiB,EAAE,EAC3B,QAAQ,eAAe,EAAE,EACzB,KAAK,KAAK;AACf;","names":[]}

package/dist/chunk-5FGUEU7N.js

@@ -0,0 +1,101 @@
+import {
+  TEST_SUPPORT_PATH_PATTERNS,
+  testFileExclusionSql
+} from "./chunk-FUHJCHS4.js";
+import {
+  shortenSymbol
+} from "./chunk-QOV2R2WT.js";
+
+// src/queries/dead.ts
+function dead(db, opts = {}) {
+  const {
+    scope,
+    minLoc = 1,
+    includeTests = false,
+    skipBarrels = false,
+    includeMembers = false
+  } = opts;
+  const params = [minLoc];
+  let testFileExclusions = "";
+  let memberExclusion = "";
+  if (scope) {
+    params.push(`%${scope}%`);
+  }
+  if (!includeTests) {
+    testFileExclusions = `
+      AND ${testFileExclusionSql("d", TEST_SUPPORT_PATH_PATTERNS)}
+    `;
+  }
+  if (!includeMembers) {
+    memberExclusion = `AND gs.symbol NOT LIKE '%#%'`;
+  }
+  const barrelExclusions = skipBarrels ? `AND ref_d.relative_path NOT LIKE '%/index.ts'
+       AND ref_d.relative_path NOT LIKE '%/index.js'
+       AND ref_d.relative_path NOT LIKE '%/mod.rs'
+       AND ref_d.relative_path NOT LIKE '%/__init__.py'` : "";
+  const sql = `
+    SELECT
+      d.relative_path,
+      der.start_line,
+      der.end_line,
+      (der.end_line - der.start_line + 1) AS loc,
+      gs.symbol,
+      (SELECT COUNT(*) FROM mentions m2
+       JOIN chunks c2 ON m2.chunk_id = c2.id
+       WHERE m2.symbol_id = gs.id AND m2.role = 0 AND c2.document_id = d.id
+      ) AS same_file_refs
+    FROM global_symbols gs
+    JOIN defn_enclosing_ranges der ON gs.id = der.symbol_id
+    JOIN documents d ON der.document_id = d.id
+    WHERE 1 = 1
+      ${db.pathExclusionsFor("d")}
+      ${db.symbolNoiseFor("gs")}
+      AND (der.end_line - der.start_line + 1) >= ?
+      ${scope ? "AND d.relative_path LIKE ?" : ""}
+      ${testFileExclusions}
+      ${memberExclusion}
+      AND NOT EXISTS (
+        SELECT 1
+        FROM mentions ref_m
+        JOIN chunks ref_c ON ref_m.chunk_id = ref_c.id
+        JOIN documents ref_d ON ref_c.document_id = ref_d.id
+        WHERE ref_m.symbol_id = gs.id
+          AND ref_m.role = 0
+          AND ref_d.id != d.id
+          ${barrelExclusions}
+      )
+    ORDER BY (der.end_line - der.start_line + 1) DESC, d.relative_path, der.start_line
+  `;
+  const rows = db.all(sql, ...params);
+  let deadCodeCount = 0;
+  let fileInternalCount = 0;
+  let totalLoc = 0;
+  const symbols = rows.filter((r) => !db.isIgnored(r.relative_path)).map((r) => {
+    const kind = r.same_file_refs === 0 ? "dead-code" : "file-internal";
+    if (kind === "dead-code") deadCodeCount++;
+    else fileInternalCount++;
+    totalLoc += r.loc;
+    return {
+      relativePath: r.relative_path,
+      startLine: r.start_line,
+      endLine: r.end_line,
+      loc: r.loc,
+      symbol: r.symbol,
+      shortName: shortenSymbol(r.symbol),
+      sameFileRefs: r.same_file_refs,
+      kind
+    };
+  });
+  return {
+    symbols,
+    totalCount: symbols.length,
+    deadCodeCount,
+    fileInternalCount,
+    totalLoc
+  };
+}
+
+export {
+  dead
+};
+//# sourceMappingURL=chunk-5FGUEU7N.js.map

package/dist/chunk-5FGUEU7N.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queries/dead.ts"],"sourcesContent":["import type { ScipDatabase } from '../db.js';\nimport { TEST_SUPPORT_PATH_PATTERNS, testFileExclusionSql } from '../query-support.js';\nimport type { DeadOptions, DeadSymbolResult, DeadSummary } from '../types.js';\nimport { shortenSymbol } from '../symbol-parser.js';\n\n/**\n * Find dead exports: symbols defined locally with no cross-file references.\n * Language-agnostic — works with any SCIP index.\n */\nexport function dead(db: ScipDatabase, opts: DeadOptions = {}): DeadSummary {\n  const {\n    scope,\n    minLoc = 1,\n    includeTests = false,\n    skipBarrels = false,\n    includeMembers = false,\n  } = opts;\n\n  const params: unknown[] = [minLoc];\n  let testFileExclusions = '';\n  let memberExclusion = '';\n\n  if (scope) {\n    params.push(`%${scope}%`);\n  }\n\n  if (!includeTests) {\n    testFileExclusions = `\n      AND ${testFileExclusionSql('d', TEST_SUPPORT_PATH_PATTERNS)}\n    `;\n  }\n\n  if (!includeMembers) {\n    memberExclusion = `AND gs.symbol NOT LIKE '%#%'`;\n  }\n\n  // Barrel file exclusion for the NOT EXISTS subquery\n  const barrelExclusions = skipBarrels\n    ? `AND ref_d.relative_path NOT LIKE '%/index.ts'\n       AND ref_d.relative_path NOT LIKE '%/index.js'\n       AND ref_d.relative_path NOT LIKE '%/mod.rs'\n       AND ref_d.relative_path NOT LIKE '%/__init__.py'`\n    : '';\n\n  const sql = `\n    SELECT\n      d.relative_path,\n      der.start_line,\n      der.end_line,\n      (der.end_line - der.start_line + 1) AS loc,\n      gs.symbol,\n      (SELECT COUNT(*) FROM mentions m2\n       JOIN chunks c2 ON m2.chunk_id = c2.id\n       WHERE m2.symbol_id = gs.id AND m2.role = 0 AND c2.document_id = d.id\n      ) AS same_file_refs\n    FROM global_symbols gs\n    JOIN defn_enclosing_ranges der ON gs.id = der.symbol_id\n    JOIN documents d ON der.document_id = d.id\n    WHERE 1 = 1\n      ${db.pathExclusionsFor('d')}\n      ${db.symbolNoiseFor('gs')}\n      AND (der.end_line - der.start_line + 1) >= ?\n      ${scope ? 'AND d.relative_path LIKE ?' : ''}\n      ${testFileExclusions}\n      ${memberExclusion}\n      AND NOT EXISTS (\n        SELECT 1\n        FROM mentions ref_m\n        JOIN chunks ref_c ON ref_m.chunk_id = ref_c.id\n        JOIN documents ref_d ON ref_c.document_id = ref_d.id\n        WHERE ref_m.symbol_id = gs.id\n          AND ref_m.role = 0\n          AND ref_d.id != d.id\n          ${barrelExclusions}\n      )\n    ORDER BY (der.end_line - der.start_line + 1) DESC, d.relative_path, der.start_line\n  `;\n\n  const rows = db.all<{\n    relative_path: string;\n    start_line: number;\n    end_line: number;\n    loc: number;\n    symbol: string;\n    same_file_refs: number;\n  }>(sql, ...params);\n\n  let deadCodeCount = 0;\n  let fileInternalCount = 0;\n  let totalLoc = 0;\n\n  const symbols: DeadSymbolResult[] = rows\n    .filter((r) => !db.isIgnored(r.relative_path))\n    .map((r) => {\n      // dead-code: zero references anywhere (not even in same file) — safe to delete\n      // file-internal: referenced within same file but never cross-file —\n      //   may be a private helper (fine) or a forgotten export (needs review)\n      const kind = r.same_file_refs === 0 ? 'dead-code' : 'file-internal';\n      if (kind === 'dead-code') deadCodeCount++;\n      else fileInternalCount++;\n      totalLoc += r.loc;\n\n      return {\n        relativePath: r.relative_path,\n        startLine: r.start_line,\n        endLine: r.end_line,\n        loc: r.loc,\n        symbol: r.symbol,\n        shortName: shortenSymbol(r.symbol),\n        sameFileRefs: r.same_file_refs,\n        kind,\n      };\n    });\n\n  return {\n    symbols,\n    totalCount: symbols.length,\n    deadCodeCount,\n    fileInternalCount,\n    totalLoc,\n  };\n}\n"],"mappings":";;;;;;;;;AASO,SAAS,KAAK,IAAkB,OAAoB,CAAC,GAAgB;AAC1E,QAAM;AAAA,IACJ;AAAA,IACA,SAAS;AAAA,IACT,eAAe;AAAA,IACf,cAAc;AAAA,IACd,iBAAiB;AAAA,EACnB,IAAI;AAEJ,QAAM,SAAoB,CAAC,MAAM;AACjC,MAAI,qBAAqB;AACzB,MAAI,kBAAkB;AAEtB,MAAI,OAAO;AACT,WAAO,KAAK,IAAI,KAAK,GAAG;AAAA,EAC1B;AAEA,MAAI,CAAC,cAAc;AACjB,yBAAqB;AAAA,YACb,qBAAqB,KAAK,0BAA0B,CAAC;AAAA;AAAA,EAE/D;AAEA,MAAI,CAAC,gBAAgB;AACnB,sBAAkB;AAAA,EACpB;AAGA,QAAM,mBAAmB,cACrB;AAAA;AAAA;AAAA,2DAIA;AAEJ,QAAM,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAeN,GAAG,kBAAkB,GAAG,CAAC;AAAA,QACzB,GAAG,eAAe,IAAI,CAAC;AAAA;AAAA,QAEvB,QAAQ,+BAA+B,EAAE;AAAA,QACzC,kBAAkB;AAAA,QAClB,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,YASX,gBAAgB;AAAA;AAAA;AAAA;AAK1B,QAAM,OAAO,GAAG,IAOb,KAAK,GAAG,MAAM;AAEjB,MAAI,gBAAgB;AACpB,MAAI,oBAAoB;AACxB,MAAI,WAAW;AAEf,QAAM,UAA8B,KACjC,OAAO,CAAC,MAAM,CAAC,GAAG,UAAU,EAAE,aAAa,CAAC,EAC5C,IAAI,CAAC,MAAM;AAIV,UAAM,OAAO,EAAE,mBAAmB,IAAI,cAAc;AACpD,QAAI,SAAS,YAAa;AAAA,QACrB;AACL,gBAAY,EAAE;AAEd,WAAO;AAAA,MACL,cAAc,EAAE;AAAA,MAChB,WAAW,EAAE;AAAA,MACb,SAAS,EAAE;AAAA,MACX,KAAK,EAAE;AAAA,MACP,QAAQ,EAAE;AAAA,MACV,WAAW,cAAc,EAAE,MAAM;AAAA,MACjC,cAAc,EAAE;AAAA,MAChB;AAAA,IACF;AAAA,EACF,CAAC;AAEH,SAAO;AAAA,IACL;AAAA,IACA,YAAY,QAAQ;AAAA,IACpB;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":[]}