scip-query 0.1.0

package/dist/chunk-LUSIFBXO.js

@@ -0,0 +1,57 @@
+import {
+  testFileExclusionSql
+} from "./chunk-FUHJCHS4.js";
+import {
+  shortenSymbol
+} from "./chunk-QOV2R2WT.js";
+
+// src/queries/isolated.ts
+function isolated(db, opts = {}) {
+  const { scope, minLoc = 3 } = opts;
+  const scopeFilter = scope ? `AND d.relative_path LIKE '%${scope}%'` : "";
+  const rows = db.all(
+    `SELECT
+      gs.symbol,
+      d.relative_path,
+      der.start_line,
+      der.end_line,
+      (der.end_line - der.start_line + 1) AS loc
+    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 ${testFileExclusionSql("d")}
+      ${db.symbolNoiseFor("gs")}
+      AND gs.symbol NOT LIKE '%#%'
+      AND (der.end_line - der.start_line + 1) >= ?
+      ${scopeFilter}
+      -- No cross-file references TO this symbol
+      AND NOT EXISTS (
+        SELECT 1 FROM mentions m
+        JOIN chunks c ON m.chunk_id = c.id
+        WHERE m.symbol_id = gs.id AND m.role = 0 AND c.document_id != d.id
+      )
+      -- No same-file references either
+      AND NOT EXISTS (
+        SELECT 1 FROM mentions m
+        JOIN chunks c ON m.chunk_id = c.id
+        WHERE m.symbol_id = gs.id AND m.role = 0 AND c.document_id = d.id
+      )
+    ORDER BY loc DESC, d.relative_path`,
+    minLoc
+  );
+  return rows.filter((r) => !db.isIgnored(r.relative_path)).map((r) => ({
+    symbol: r.symbol,
+    shortName: shortenSymbol(r.symbol),
+    relativePath: r.relative_path,
+    startLine: r.start_line,
+    endLine: r.end_line,
+    loc: r.loc
+  }));
+}
+
+export {
+  isolated
+};
+//# sourceMappingURL=chunk-LUSIFBXO.js.map

package/dist/chunk-LUSIFBXO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queries/isolated.ts"],"sourcesContent":["import type { ScipDatabase } from '../db.js';\nimport { testFileExclusionSql } from '../query-support.js';\nimport type { IsolatedResult } from '../types.js';\nimport { shortenSymbol } from '../symbol-parser.js';\n\n/**\n * Find isolated symbols: defined locally, referenced by nothing,\n * and referencing nothing external. These are truly orphaned code —\n * not just unused exports, but completely disconnected from the graph.\n */\nexport function isolated(\n  db: ScipDatabase,\n  opts: { scope?: string; minLoc?: number } = {},\n): IsolatedResult[] {\n  const { scope, minLoc = 3 } = opts;\n  const scopeFilter = scope ? `AND d.relative_path LIKE '%${scope}%'` : '';\n\n  const rows = db.all<{\n    symbol: string;\n    relative_path: string;\n    start_line: number;\n    end_line: number;\n    loc: number;\n  }>(\n    `SELECT\n      gs.symbol,\n      d.relative_path,\n      der.start_line,\n      der.end_line,\n      (der.end_line - der.start_line + 1) AS loc\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 ${testFileExclusionSql('d')}\n      ${db.symbolNoiseFor('gs')}\n      AND gs.symbol NOT LIKE '%#%'\n      AND (der.end_line - der.start_line + 1) >= ?\n      ${scopeFilter}\n      -- No cross-file references TO this symbol\n      AND NOT EXISTS (\n        SELECT 1 FROM mentions m\n        JOIN chunks c ON m.chunk_id = c.id\n        WHERE m.symbol_id = gs.id AND m.role = 0 AND c.document_id != d.id\n      )\n      -- No same-file references either\n      AND NOT EXISTS (\n        SELECT 1 FROM mentions m\n        JOIN chunks c ON m.chunk_id = c.id\n        WHERE m.symbol_id = gs.id AND m.role = 0 AND c.document_id = d.id\n      )\n    ORDER BY loc DESC, d.relative_path`,\n    minLoc,\n  );\n\n  return rows\n    .filter((r) => !db.isIgnored(r.relative_path))\n    .map((r) => ({\n      symbol: r.symbol,\n      shortName: shortenSymbol(r.symbol),\n      relativePath: r.relative_path,\n      startLine: r.start_line,\n      endLine: r.end_line,\n      loc: r.loc,\n    }));\n}\n"],"mappings":";;;;;;;;AAUO,SAAS,SACd,IACA,OAA4C,CAAC,GAC3B;AAClB,QAAM,EAAE,OAAO,SAAS,EAAE,IAAI;AAC9B,QAAM,cAAc,QAAQ,8BAA8B,KAAK,OAAO;AAEtE,QAAM,OAAO,GAAG;AAAA,IAOd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAUI,GAAG,kBAAkB,GAAG,CAAC;AAAA,YACrB,qBAAqB,GAAG,CAAC;AAAA,QAC7B,GAAG,eAAe,IAAI,CAAC;AAAA;AAAA;AAAA,QAGvB,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAcf;AAAA,EACF;AAEA,SAAO,KACJ,OAAO,CAAC,MAAM,CAAC,GAAG,UAAU,EAAE,aAAa,CAAC,EAC5C,IAAI,CAAC,OAAO;AAAA,IACX,QAAQ,EAAE;AAAA,IACV,WAAW,cAAc,EAAE,MAAM;AAAA,IACjC,cAAc,EAAE;AAAA,IAChB,WAAW,EAAE;AAAA,IACb,SAAS,EAAE;AAAA,IACX,KAAK,EAAE;AAAA,EACT,EAAE;AACN;","names":[]}

package/dist/chunk-MBVNHJVN.js

@@ -0,0 +1,44 @@
+import {
+  buildFileDepGraph
+} from "./chunk-FUHJCHS4.js";
+
+// src/queries/deep-chains.ts
+function deepChains(db, opts = {}) {
+  const { limit = 10, scope, minDepth = 3 } = opts;
+  const graph = buildFileDepGraph(db, scope);
+  const results = [];
+  function dfs(node, path, visited) {
+    const neighbors = graph.get(node);
+    if (!neighbors || neighbors.size === 0) {
+      if (path.length >= minDepth) {
+        results.push({ chain: [...path], depth: path.length });
+      }
+      return;
+    }
+    let extended = false;
+    for (const next of neighbors) {
+      if (visited.has(next)) continue;
+      visited.add(next);
+      path.push(next);
+      dfs(next, path, visited);
+      path.pop();
+      visited.delete(next);
+      extended = true;
+    }
+    if (!extended && path.length >= minDepth) {
+      results.push({ chain: [...path], depth: path.length });
+    }
+  }
+  for (const startNode of graph.keys()) {
+    const visited = /* @__PURE__ */ new Set([startNode]);
+    dfs(startNode, [startNode], visited);
+    if (results.length > limit * 10) break;
+  }
+  results.sort((a, b) => b.depth - a.depth);
+  return results.slice(0, limit);
+}
+
+export {
+  deepChains
+};
+//# sourceMappingURL=chunk-MBVNHJVN.js.map

package/dist/chunk-MBVNHJVN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queries/deep-chains.ts"],"sourcesContent":["import type { ScipDatabase } from '../db.js';\nimport { buildFileDepGraph } from '../query-support.js';\nimport type { DeepChainResult } from '../types.js';\n\n/**\n * Find the longest transitive dependency chains between files.\n * A chain A → B → C → D means A depends on B, B on C, C on D.\n *\n * Long chains = high coupling depth = changes at the end ripple through many layers.\n */\nexport function deepChains(\n  db: ScipDatabase,\n  opts: { limit?: number; scope?: string; minDepth?: number } = {},\n): DeepChainResult[] {\n  const { limit = 10, scope, minDepth = 3 } = opts;\n  const graph = buildFileDepGraph(db, scope);\n\n  // DFS to find longest paths (with cycle detection)\n  const results: DeepChainResult[] = [];\n\n  function dfs(node: string, path: string[], visited: Set<string>): void {\n    const neighbors = graph.get(node);\n    if (!neighbors || neighbors.size === 0) {\n      if (path.length >= minDepth) {\n        results.push({ chain: [...path], depth: path.length });\n      }\n      return;\n    }\n\n    let extended = false;\n    for (const next of neighbors) {\n      if (visited.has(next)) continue; // skip cycles\n      visited.add(next);\n      path.push(next);\n      dfs(next, path, visited);\n      path.pop();\n      visited.delete(next);\n      extended = true;\n    }\n\n    // If no unvisited neighbors, this is a leaf in this path\n    if (!extended && path.length >= minDepth) {\n      results.push({ chain: [...path], depth: path.length });\n    }\n  }\n\n  // Start DFS from each node\n  for (const startNode of graph.keys()) {\n    const visited = new Set<string>([startNode]);\n    dfs(startNode, [startNode], visited);\n\n    // Early termination if we have enough results\n    if (results.length > limit * 10) break;\n  }\n\n  // Sort by depth descending, take top N\n  results.sort((a, b) => b.depth - a.depth);\n  return results.slice(0, limit);\n}\n"],"mappings":";;;;;AAUO,SAAS,WACd,IACA,OAA8D,CAAC,GAC5C;AACnB,QAAM,EAAE,QAAQ,IAAI,OAAO,WAAW,EAAE,IAAI;AAC5C,QAAM,QAAQ,kBAAkB,IAAI,KAAK;AAGzC,QAAM,UAA6B,CAAC;AAEpC,WAAS,IAAI,MAAc,MAAgB,SAA4B;AACrE,UAAM,YAAY,MAAM,IAAI,IAAI;AAChC,QAAI,CAAC,aAAa,UAAU,SAAS,GAAG;AACtC,UAAI,KAAK,UAAU,UAAU;AAC3B,gBAAQ,KAAK,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,OAAO,KAAK,OAAO,CAAC;AAAA,MACvD;AACA;AAAA,IACF;AAEA,QAAI,WAAW;AACf,eAAW,QAAQ,WAAW;AAC5B,UAAI,QAAQ,IAAI,IAAI,EAAG;AACvB,cAAQ,IAAI,IAAI;AAChB,WAAK,KAAK,IAAI;AACd,UAAI,MAAM,MAAM,OAAO;AACvB,WAAK,IAAI;AACT,cAAQ,OAAO,IAAI;AACnB,iBAAW;AAAA,IACb;AAGA,QAAI,CAAC,YAAY,KAAK,UAAU,UAAU;AACxC,cAAQ,KAAK,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,OAAO,KAAK,OAAO,CAAC;AAAA,IACvD;AAAA,EACF;AAGA,aAAW,aAAa,MAAM,KAAK,GAAG;AACpC,UAAM,UAAU,oBAAI,IAAY,CAAC,SAAS,CAAC;AAC3C,QAAI,WAAW,CAAC,SAAS,GAAG,OAAO;AAGnC,QAAI,QAAQ,SAAS,QAAQ,GAAI;AAAA,EACnC;AAGA,UAAQ,KAAK,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK;AACxC,SAAO,QAAQ,MAAM,GAAG,KAAK;AAC/B;","names":[]}

package/dist/chunk-MGNMHKX3.js

@@ -0,0 +1,15 @@
+// src/queries/files.ts
+function files(db, pattern) {
+  const rows = db.all(
+    `SELECT relative_path FROM documents
+     WHERE relative_path LIKE ?
+     ORDER BY relative_path`,
+    `%${pattern}%`
+  );
+  return rows.filter((r) => !db.isIgnored(r.relative_path)).map((r) => ({ relativePath: r.relative_path }));
+}
+
+export {
+  files
+};
+//# sourceMappingURL=chunk-MGNMHKX3.js.map

package/dist/chunk-MGNMHKX3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queries/files.ts"],"sourcesContent":["import type { ScipDatabase } from '../db.js';\nimport type { FileResult } from '../types.js';\n\nexport function files(db: ScipDatabase, pattern: string): FileResult[] {\n  const rows = db.all<{ relative_path: string }>(\n    `SELECT relative_path FROM documents\n     WHERE relative_path LIKE ?\n     ORDER BY relative_path`,\n    `%${pattern}%`,\n  );\n\n  // Apply gitignore filtering\n  return rows\n    .filter((r) => !db.isIgnored(r.relative_path))\n    .map((r) => ({ relativePath: r.relative_path }));\n}\n"],"mappings":";AAGO,SAAS,MAAM,IAAkB,SAA+B;AACrE,QAAM,OAAO,GAAG;AAAA,IACd;AAAA;AAAA;AAAA,IAGA,IAAI,OAAO;AAAA,EACb;AAGA,SAAO,KACJ,OAAO,CAAC,MAAM,CAAC,GAAG,UAAU,EAAE,aAAa,CAAC,EAC5C,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE;AACnD;","names":[]}

package/dist/chunk-N5KEREIA.js

@@ -0,0 +1,41 @@
+// src/queries/deps.ts
+function deps(db, filePattern) {
+  const rows = db.all(
+    `SELECT DISTINCT d2.relative_path
+    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.relative_path LIKE ?
+      AND d2.relative_path <> d1.relative_path
+      AND ${db.localSymbolPredicate}
+    ORDER BY d2.relative_path`,
+    `%${filePattern}%`
+  );
+  return rows.filter((r) => !db.isIgnored(r.relative_path)).map((r) => ({ relativePath: r.relative_path }));
+}
+function rdeps(db, filePattern) {
+  const rows = db.all(
+    `SELECT DISTINCT d1.relative_path
+    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 d2.relative_path LIKE ?
+      AND d1.relative_path NOT LIKE ?
+    ORDER BY d1.relative_path`,
+    `%${filePattern}%`,
+    `%${filePattern}%`
+  );
+  return rows.filter((r) => !db.isIgnored(r.relative_path)).map((r) => ({ relativePath: r.relative_path }));
+}
+
+export {
+  deps,
+  rdeps
+};
+//# sourceMappingURL=chunk-N5KEREIA.js.map

package/dist/chunk-N5KEREIA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queries/deps.ts"],"sourcesContent":["import type { ScipDatabase } from '../db.js';\nimport type { DepResult } from '../types.js';\n\n/** What internal files does this file depend on? (forward dependencies) */\nexport function deps(db: ScipDatabase, filePattern: string): DepResult[] {\n  const rows = db.all<{ relative_path: string }>(\n    `SELECT DISTINCT d2.relative_path\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.relative_path LIKE ?\n      AND d2.relative_path <> d1.relative_path\n      AND ${db.localSymbolPredicate}\n    ORDER BY d2.relative_path`,\n    `%${filePattern}%`,\n  );\n\n  return rows\n    .filter((r) => !db.isIgnored(r.relative_path))\n    .map((r) => ({ relativePath: r.relative_path }));\n}\n\n/** What files depend on this file/module? (reverse dependencies) */\nexport function rdeps(db: ScipDatabase, filePattern: string): DepResult[] {\n  const rows = db.all<{ relative_path: string }>(\n    `SELECT DISTINCT d1.relative_path\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 d2.relative_path LIKE ?\n      AND d1.relative_path NOT LIKE ?\n    ORDER BY d1.relative_path`,\n    `%${filePattern}%`,\n    `%${filePattern}%`,\n  );\n\n  return rows\n    .filter((r) => !db.isIgnored(r.relative_path))\n    .map((r) => ({ relativePath: r.relative_path }));\n}\n"],"mappings":";AAIO,SAAS,KAAK,IAAkB,aAAkC;AACvE,QAAM,OAAO,GAAG;AAAA,IACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,YASQ,GAAG,oBAAoB;AAAA;AAAA,IAE/B,IAAI,WAAW;AAAA,EACjB;AAEA,SAAO,KACJ,OAAO,CAAC,MAAM,CAAC,GAAG,UAAU,EAAE,aAAa,CAAC,EAC5C,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE;AACnD;AAGO,SAAS,MAAM,IAAkB,aAAkC;AACxE,QAAM,OAAO,GAAG;AAAA,IACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAUA,IAAI,WAAW;AAAA,IACf,IAAI,WAAW;AAAA,EACjB;AAEA,SAAO,KACJ,OAAO,CAAC,MAAM,CAAC,GAAG,UAAU,EAAE,aAAa,CAAC,EAC5C,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE;AACnD;","names":[]}

package/dist/chunk-NDSQYIWT.js

@@ -0,0 +1,71 @@
+import {
+  getCalleeRowsForSymbol,
+  testFileExclusionSql
+} from "./chunk-FUHJCHS4.js";
+import {
+  shortenSymbol
+} from "./chunk-QOV2R2WT.js";
+
+// src/queries/passthrough-candidates.ts
+function passthroughCandidates(db, opts) {
+  const { scope, maxLoc = 15, limit = 30 } = opts ?? {};
+  const scopeFilter = scope ? `AND d.relative_path LIKE '%${scope}%'` : "";
+  const symbols = db.all(
+    `SELECT
+      gs.id,
+      gs.symbol,
+      der.document_id,
+      der.start_line,
+      der.end_line,
+      (der.end_line - der.start_line + 1) AS loc,
+      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 1 = 1
+      ${db.pathExclusionsFor("d")}
+      AND ${testFileExclusionSql("d")}
+      ${db.symbolNoiseFor("gs")}
+      AND (der.end_line - der.start_line + 1) >= 3
+      AND (der.end_line - der.start_line + 1) <= ?
+      ${scopeFilter}
+    ORDER BY d.relative_path`,
+    maxLoc
+  );
+  const results = [];
+  for (const sym of symbols) {
+    if (db.isIgnored(sym.relative_path)) continue;
+    const callees = getCalleeRowsForSymbol(db, {
+      documentId: sym.document_id,
+      startLine: sym.start_line,
+      endLine: sym.end_line,
+      symbolId: sym.id
+    });
+    const uniqueCallees = /* @__PURE__ */ new Map();
+    for (const c of callees) {
+      if (!uniqueCallees.has(c.symbol)) {
+        uniqueCallees.set(c.symbol, { symbol: c.symbol, file: c.file });
+      }
+    }
+    if (uniqueCallees.size !== 1) continue;
+    const [, callee] = [...uniqueCallees.entries()][0];
+    results.push({
+      symbol: sym.symbol,
+      shortName: shortenSymbol(sym.symbol),
+      file: sym.relative_path,
+      startLine: sym.start_line,
+      endLine: sym.end_line,
+      loc: sym.loc,
+      forwardsTo: callee.symbol,
+      forwardsToShort: shortenSymbol(callee.symbol),
+      forwardsToFile: callee.file
+    });
+  }
+  results.sort((a, b) => a.loc - b.loc || a.file.localeCompare(b.file));
+  return results.slice(0, limit);
+}
+
+export {
+  passthroughCandidates
+};
+//# sourceMappingURL=chunk-NDSQYIWT.js.map

package/dist/chunk-NDSQYIWT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queries/passthrough-candidates.ts"],"sourcesContent":["import type { ScipDatabase } from '../db.js';\nimport { getCalleeRowsForSymbol, testFileExclusionSql } from '../query-support.js';\nimport type { PassthroughCandidate } from '../types.js';\nimport { shortenSymbol } from '../symbol-parser.js';\n\n/**\n * Find passthrough candidates: functions that just forward to one\n * other function.\n *\n * A function with exactly 1 callee and small LOC is likely a thin\n * wrapper that adds no value — it just passes arguments through to\n * the real implementation.\n */\nexport function passthroughCandidates(\n  db: ScipDatabase,\n  opts?: { scope?: string; maxLoc?: number; limit?: number },\n): PassthroughCandidate[] {\n  const { scope, maxLoc = 15, limit = 30 } = opts ?? {};\n  const scopeFilter = scope ? `AND d.relative_path LIKE '%${scope}%'` : '';\n\n  // 1. Find all non-trivial symbols with definition ranges (>= 3 LOC)\n  const symbols = db.all<{\n    id: number;\n    symbol: string;\n    document_id: number;\n    start_line: number;\n    end_line: number;\n    loc: number;\n    relative_path: string;\n  }>(\n    `SELECT\n      gs.id,\n      gs.symbol,\n      der.document_id,\n      der.start_line,\n      der.end_line,\n      (der.end_line - der.start_line + 1) AS loc,\n      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 1 = 1\n      ${db.pathExclusionsFor('d')}\n      AND ${testFileExclusionSql('d')}\n      ${db.symbolNoiseFor('gs')}\n      AND (der.end_line - der.start_line + 1) >= 3\n      AND (der.end_line - der.start_line + 1) <= ?\n      ${scopeFilter}\n    ORDER BY d.relative_path`,\n    maxLoc,\n  );\n\n  const results: PassthroughCandidate[] = [];\n\n  for (const sym of symbols) {\n    if (db.isIgnored(sym.relative_path)) continue;\n\n    // 2. Count callees for this symbol\n    const callees = getCalleeRowsForSymbol(db, {\n      documentId: sym.document_id,\n      startLine: sym.start_line,\n      endLine: sym.end_line,\n      symbolId: sym.id,\n    });\n\n    // Deduplicate by symbol (same callee may appear in multiple chunks)\n    const uniqueCallees = new Map<string, { symbol: string; file: string }>();\n    for (const c of callees) {\n      if (!uniqueCallees.has(c.symbol)) {\n        uniqueCallees.set(c.symbol, { symbol: c.symbol, file: c.file });\n      }\n    }\n\n    // 3. Passthrough = exactly 1 unique callee\n    if (uniqueCallees.size !== 1) continue;\n\n    const [, callee] = [...uniqueCallees.entries()][0]!;\n\n    results.push({\n      symbol: sym.symbol,\n      shortName: shortenSymbol(sym.symbol),\n      file: sym.relative_path,\n      startLine: sym.start_line,\n      endLine: sym.end_line,\n      loc: sym.loc,\n      forwardsTo: callee.symbol,\n      forwardsToShort: shortenSymbol(callee.symbol),\n      forwardsToFile: callee.file,\n    });\n  }\n\n  results.sort((a, b) => a.loc - b.loc || a.file.localeCompare(b.file));\n  return results.slice(0, limit);\n}\n"],"mappings":";;;;;;;;;AAaO,SAAS,sBACd,IACA,MACwB;AACxB,QAAM,EAAE,OAAO,SAAS,IAAI,QAAQ,GAAG,IAAI,QAAQ,CAAC;AACpD,QAAM,cAAc,QAAQ,8BAA8B,KAAK,OAAO;AAGtE,QAAM,UAAU,GAAG;AAAA,IASjB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAYI,GAAG,kBAAkB,GAAG,CAAC;AAAA,YACrB,qBAAqB,GAAG,CAAC;AAAA,QAC7B,GAAG,eAAe,IAAI,CAAC;AAAA;AAAA;AAAA,QAGvB,WAAW;AAAA;AAAA,IAEf;AAAA,EACF;AAEA,QAAM,UAAkC,CAAC;AAEzC,aAAW,OAAO,SAAS;AACzB,QAAI,GAAG,UAAU,IAAI,aAAa,EAAG;AAGrC,UAAM,UAAU,uBAAuB,IAAI;AAAA,MACzC,YAAY,IAAI;AAAA,MAChB,WAAW,IAAI;AAAA,MACf,SAAS,IAAI;AAAA,MACb,UAAU,IAAI;AAAA,IAChB,CAAC;AAGD,UAAM,gBAAgB,oBAAI,IAA8C;AACxE,eAAW,KAAK,SAAS;AACvB,UAAI,CAAC,cAAc,IAAI,EAAE,MAAM,GAAG;AAChC,sBAAc,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,MAAM,EAAE,KAAK,CAAC;AAAA,MAChE;AAAA,IACF;AAGA,QAAI,cAAc,SAAS,EAAG;AAE9B,UAAM,CAAC,EAAE,MAAM,IAAI,CAAC,GAAG,cAAc,QAAQ,CAAC,EAAE,CAAC;AAEjD,YAAQ,KAAK;AAAA,MACX,QAAQ,IAAI;AAAA,MACZ,WAAW,cAAc,IAAI,MAAM;AAAA,MACnC,MAAM,IAAI;AAAA,MACV,WAAW,IAAI;AAAA,MACf,SAAS,IAAI;AAAA,MACb,KAAK,IAAI;AAAA,MACT,YAAY,OAAO;AAAA,MACnB,iBAAiB,cAAc,OAAO,MAAM;AAAA,MAC5C,gBAAgB,OAAO;AAAA,IACzB,CAAC;AAAA,EACH;AAEA,UAAQ,KAAK,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,IAAI,CAAC;AACpE,SAAO,QAAQ,MAAM,GAAG,KAAK;AAC/B;","names":[]}

package/dist/chunk-NUZ4OMU3.js

@@ -0,0 +1,28 @@
+import {
+  leafName
+} from "./chunk-QOV2R2WT.js";
+
+// src/queries/methods.ts
+function methods(db, className) {
+  const rows = db.all(
+    `SELECT der.start_line, der.end_line, gs.symbol
+    FROM global_symbols gs
+    JOIN defn_enclosing_ranges der ON gs.id = der.symbol_id
+    WHERE gs.symbol LIKE ?
+      AND ${db.localSymbolPredicate}
+      AND gs.symbol LIKE '%().%'
+      ${db.symbolNoise}
+    ORDER BY der.start_line`,
+    `%${className}#%`
+  );
+  return rows.map((r) => ({
+    startLine: r.start_line,
+    endLine: r.end_line,
+    name: leafName(r.symbol)
+  }));
+}
+
+export {
+  methods
+};
+//# sourceMappingURL=chunk-NUZ4OMU3.js.map

package/dist/chunk-NUZ4OMU3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queries/methods.ts"],"sourcesContent":["import type { ScipDatabase } from '../db.js';\nimport type { MethodResult } from '../types.js';\nimport { leafName } from '../symbol-parser.js';\n\nexport function methods(db: ScipDatabase, className: string): MethodResult[] {\n  const rows = db.all<{\n    start_line: number;\n    end_line: number;\n    symbol: string;\n  }>(\n    `SELECT der.start_line, der.end_line, gs.symbol\n    FROM global_symbols gs\n    JOIN defn_enclosing_ranges der ON gs.id = der.symbol_id\n    WHERE gs.symbol LIKE ?\n      AND ${db.localSymbolPredicate}\n      AND gs.symbol LIKE '%().%'\n      ${db.symbolNoise}\n    ORDER BY der.start_line`,\n    `%${className}#%`,\n  );\n\n  return rows.map((r) => ({\n    startLine: r.start_line,\n    endLine: r.end_line,\n    name: leafName(r.symbol),\n  }));\n}\n"],"mappings":";;;;;AAIO,SAAS,QAAQ,IAAkB,WAAmC;AAC3E,QAAM,OAAO,GAAG;AAAA,IAKd;AAAA;AAAA;AAAA;AAAA,YAIQ,GAAG,oBAAoB;AAAA;AAAA,QAE3B,GAAG,WAAW;AAAA;AAAA,IAElB,IAAI,SAAS;AAAA,EACf;AAEA,SAAO,KAAK,IAAI,CAAC,OAAO;AAAA,IACtB,WAAW,EAAE;AAAA,IACb,SAAS,EAAE;AAAA,IACX,MAAM,SAAS,EAAE,MAAM;AAAA,EACzB,EAAE;AACJ;","names":[]}

package/dist/chunk-QOV2R2WT.js

@@ -0,0 +1,170 @@
+// src/symbol-parser.ts
+var SUFFIX_MAP = {
+  "/": "namespace",
+  "#": "type",
+  ".": "term",
+  "[": "type-param",
+  ":": "meta",
+  "!": "macro"
+};
+function parseSymbol(raw) {
+  if (raw.startsWith("local ")) {
+    return { kind: "local", id: raw.slice(6), raw };
+  }
+  const parts = raw.split(" ");
+  if (parts.length < 4) {
+    return {
+      scheme: parts[0] ?? "",
+      manager: parts[1] ?? "",
+      packageName: parts[2] ?? "",
+      version: "",
+      descriptors: [],
+      raw
+    };
+  }
+  const scheme = parts[0];
+  const manager = parts[1];
+  let restAfterManager = raw.slice(scheme.length + 1 + manager.length + 1);
+  let packageName;
+  if (restAfterManager.startsWith("`")) {
+    const closingTick = restAfterManager.indexOf("`", 1);
+    if (closingTick === -1) {
+      packageName = restAfterManager.slice(1);
+      restAfterManager = "";
+    } else {
+      packageName = restAfterManager.slice(1, closingTick);
+      restAfterManager = restAfterManager.slice(closingTick + 2);
+    }
+  } else {
+    const spaceIdx = restAfterManager.indexOf(" ");
+    if (spaceIdx === -1) {
+      packageName = restAfterManager;
+      restAfterManager = "";
+    } else {
+      packageName = restAfterManager.slice(0, spaceIdx);
+      restAfterManager = restAfterManager.slice(spaceIdx + 1);
+    }
+  }
+  let version;
+  const versionSpaceIdx = restAfterManager.indexOf(" ");
+  if (versionSpaceIdx === -1) {
+    version = restAfterManager;
+    restAfterManager = "";
+  } else {
+    version = restAfterManager.slice(0, versionSpaceIdx);
+    restAfterManager = restAfterManager.slice(versionSpaceIdx + 1);
+  }
+  const descriptors = parseDescriptors(restAfterManager);
+  return { scheme, manager, packageName, version, descriptors, raw };
+}
+function parseDescriptors(input) {
+  const descriptors = [];
+  let i = 0;
+  while (i < input.length) {
+    if (input[i] === "[") {
+      const closeBracket = input.indexOf("]", i + 1);
+      if (closeBracket === -1) {
+        descriptors.push({ name: input.slice(i + 1), suffix: "type-param" });
+        break;
+      }
+      descriptors.push({ name: input.slice(i + 1, closeBracket), suffix: "type-param" });
+      i = closeBracket + 1;
+      continue;
+    }
+    if (input[i] === "(" && (descriptors.length === 0 || i === 0 || isSuffixChar(input[i - 1]))) {
+      const closeParen = input.indexOf(")", i + 1);
+      if (closeParen !== -1 && input[closeParen + 1] !== ".") {
+        descriptors.push({ name: input.slice(i + 1, closeParen), suffix: "parameter" });
+        i = closeParen + 1;
+        continue;
+      }
+    }
+    let name;
+    if (input[i] === "`") {
+      const closingTick = input.indexOf("`", i + 1);
+      if (closingTick === -1) {
+        name = input.slice(i + 1);
+        i = input.length;
+        descriptors.push({ name, suffix: "term" });
+        break;
+      }
+      name = input.slice(i + 1, closingTick);
+      i = closingTick + 1;
+    } else {
+      const start = i;
+      while (i < input.length && !isSuffixChar(input[i])) {
+        i++;
+      }
+      name = input.slice(start, i);
+    }
+    if (i >= input.length) {
+      if (name) descriptors.push({ name, suffix: "term" });
+      break;
+    }
+    const char = input[i];
+    if (char === "(") {
+      const closeParen = input.indexOf(")", i + 1);
+      if (closeParen !== -1 && input[closeParen + 1] === ".") {
+        descriptors.push({ name, suffix: "method" });
+        i = closeParen + 2;
+      } else if (closeParen !== -1) {
+        descriptors.push({ name, suffix: "method" });
+        i = closeParen + 1;
+      } else {
+        descriptors.push({ name, suffix: "term" });
+        i++;
+      }
+    } else {
+      const suffix = SUFFIX_MAP[char];
+      if (suffix) {
+        descriptors.push({ name, suffix });
+        i += 1;
+      } else {
+        i += 1;
+      }
+    }
+  }
+  return descriptors;
+}
+function isSuffixChar(c) {
+  return c === "/" || c === "#" || c === "." || c === "(" || c === "[" || c === ":" || c === "!";
+}
+function shortenSymbol(raw) {
+  const parsed = parseSymbol(raw);
+  if ("kind" in parsed && parsed.kind === "local") {
+    return `local:${parsed.id}`;
+  }
+  const sym = parsed;
+  if (sym.descriptors.length === 0) return sym.raw;
+  const parts = [];
+  for (const desc of sym.descriptors) {
+    let name = desc.name;
+    if (desc.suffix === "namespace") {
+      name = name.replace(/\.(ts|tsx|js|jsx|mjs|cjs)$/, "").replace(/\.(py|pyi)$/, "").replace(/\.(rs)$/, "").replace(/\.(java|scala|kt|kts)$/, "").replace(/\.(rb)$/, "").replace(/\.(go)$/, "").replace(/\.(cs|vb)$/, "").replace(/\.(dart)$/, "").replace(/\.(php)$/, "").replace(/\.(c|cc|cpp|cxx|h|hpp)$/, "");
+    }
+    if (!name) continue;
+    if (desc.suffix === "method") {
+      parts.push(`${name}()`);
+    } else {
+      parts.push(name);
+    }
+  }
+  return parts.join(":");
+}
+function leafName(raw) {
+  const parsed = parseSymbol(raw);
+  if ("kind" in parsed && parsed.kind === "local") {
+    return parsed.id;
+  }
+  const sym = parsed;
+  if (sym.descriptors.length === 0) return "";
+  const last = sym.descriptors[sym.descriptors.length - 1];
+  return last.name;
+}
+
+export {
+  parseSymbol,
+  shortenSymbol,
+  leafName
+};
+//# sourceMappingURL=chunk-QOV2R2WT.js.map

package/dist/chunk-QOV2R2WT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/symbol-parser.ts"],"sourcesContent":["import type { ScipSymbol, ScipDescriptor, ScipLocalSymbol, DescriptorSuffix } from './types.js';\n\n/**\n * SCIP Symbol Grammar (from the SCIP spec):\n *\n *   <symbol>     ::= <scheme> ' ' <package> ' ' <descriptor>+ | 'local ' <local-id>\n *   <package>    ::= <manager> ' ' <package-name> ' ' <version> ' '\n *   <descriptor> ::= <name> <suffix>\n *\n * Suffix characters:\n *   /    namespace\n *   #    type (class, interface, enum)\n *   .    term (variable, field, property)\n *   ().  method\n *   [    type parameter\n *   ()   parameter\n *   :    meta\n *   !    macro\n *\n * Names may be backtick-escaped: `some.weird/name`\n */\n\nconst SUFFIX_MAP: Record<string, DescriptorSuffix> = {\n  '/': 'namespace',\n  '#': 'type',\n  '.': 'term',\n  '[': 'type-param',\n  ':': 'meta',\n  '!': 'macro',\n};\n\n/**\n * Parse a SCIP symbol string into its structured components.\n * Works for any SCIP-indexed language (TypeScript, Java, Rust, Python, etc.)\n */\nexport function parseSymbol(raw: string): ScipSymbol | ScipLocalSymbol {\n  if (raw.startsWith('local ')) {\n    return { kind: 'local', id: raw.slice(6), raw };\n  }\n\n  // Split: <scheme> <manager> <package-name> <version> <descriptors...>\n  // The tricky part: package-name can contain spaces if backtick-escaped\n  const parts = raw.split(' ');\n  if (parts.length < 4) {\n    // Malformed — return a best-effort parse\n    return {\n      scheme: parts[0] ?? '',\n      manager: parts[1] ?? '',\n      packageName: parts[2] ?? '',\n      version: '',\n      descriptors: [],\n      raw,\n    };\n  }\n\n  const scheme = parts[0]!;\n  const manager = parts[1]!;\n\n  // Package name and version: package name might be backtick-escaped\n  // After scheme + manager, we need to find package + version + descriptor string\n  let restAfterManager = raw.slice(scheme.length + 1 + manager.length + 1);\n\n  // Parse package name (may be backtick-escaped)\n  let packageName: string;\n  if (restAfterManager.startsWith('`')) {\n    const closingTick = restAfterManager.indexOf('`', 1);\n    if (closingTick === -1) {\n      packageName = restAfterManager.slice(1);\n      restAfterManager = '';\n    } else {\n      packageName = restAfterManager.slice(1, closingTick);\n      restAfterManager = restAfterManager.slice(closingTick + 2); // skip ` and space\n    }\n  } else {\n    const spaceIdx = restAfterManager.indexOf(' ');\n    if (spaceIdx === -1) {\n      packageName = restAfterManager;\n      restAfterManager = '';\n    } else {\n      packageName = restAfterManager.slice(0, spaceIdx);\n      restAfterManager = restAfterManager.slice(spaceIdx + 1);\n    }\n  }\n\n  // Parse version\n  let version: string;\n  const versionSpaceIdx = restAfterManager.indexOf(' ');\n  if (versionSpaceIdx === -1) {\n    version = restAfterManager;\n    restAfterManager = '';\n  } else {\n    version = restAfterManager.slice(0, versionSpaceIdx);\n    restAfterManager = restAfterManager.slice(versionSpaceIdx + 1);\n  }\n\n  // Parse descriptors from the remaining string\n  const descriptors = parseDescriptors(restAfterManager);\n\n  return { scheme, manager, packageName, version, descriptors, raw };\n}\n\n/**\n * Parse the descriptor chain from a SCIP symbol.\n *\n * SCIP descriptor grammar:\n *   namespace:   name/\n *   type:        name#\n *   term:        name.\n *   method:      name(disambiguator).\n *   type-param:  [name]          (bracket-wrapped, prefix syntax)\n *   parameter:   (name)          (paren-wrapped, prefix syntax)\n *   meta:        name:\n *   macro:       name!\n *\n * Names can be backtick-escaped: `some/name.with.dots`\n */\nfunction parseDescriptors(input: string): ScipDescriptor[] {\n  const descriptors: ScipDescriptor[] = [];\n  let i = 0;\n\n  while (i < input.length) {\n    // Type parameter: [name]\n    if (input[i] === '[') {\n      const closeBracket = input.indexOf(']', i + 1);\n      if (closeBracket === -1) {\n        descriptors.push({ name: input.slice(i + 1), suffix: 'type-param' });\n        break;\n      }\n      descriptors.push({ name: input.slice(i + 1, closeBracket), suffix: 'type-param' });\n      i = closeBracket + 1;\n      continue;\n    }\n\n    // Parameter: (name) — only when ( appears at descriptor start with no preceding name\n    if (input[i] === '(' && (descriptors.length === 0 || i === 0 || isSuffixChar(input[i - 1]!))) {\n      const closeParen = input.indexOf(')', i + 1);\n      if (closeParen !== -1 && input[closeParen + 1] !== '.') {\n        // This is a parameter (name), not a method disambiguator\n        descriptors.push({ name: input.slice(i + 1, closeParen), suffix: 'parameter' });\n        i = closeParen + 1;\n        continue;\n      }\n    }\n\n    let name: string;\n\n    // Backtick-escaped name\n    if (input[i] === '`') {\n      const closingTick = input.indexOf('`', i + 1);\n      if (closingTick === -1) {\n        name = input.slice(i + 1);\n        i = input.length;\n        descriptors.push({ name, suffix: 'term' });\n        break;\n      }\n      name = input.slice(i + 1, closingTick);\n      i = closingTick + 1;\n    } else {\n      // Read name until we hit a suffix character\n      const start = i;\n      while (i < input.length && !isSuffixChar(input[i]!)) {\n        i++;\n      }\n      name = input.slice(start, i);\n    }\n\n    // Parse suffix after name\n    if (i >= input.length) {\n      if (name) descriptors.push({ name, suffix: 'term' });\n      break;\n    }\n\n    const char = input[i]!;\n\n    // Method: name(disambiguator).\n    if (char === '(') {\n      const closeParen = input.indexOf(')', i + 1);\n      if (closeParen !== -1 && input[closeParen + 1] === '.') {\n        descriptors.push({ name, suffix: 'method' });\n        i = closeParen + 2; // skip past ).\n      } else if (closeParen !== -1) {\n        // Bare (disambiguator) without . — treat as method anyway (common in practice)\n        descriptors.push({ name, suffix: 'method' });\n        i = closeParen + 1;\n      } else {\n        descriptors.push({ name, suffix: 'term' });\n        i++;\n      }\n    } else {\n      const suffix = SUFFIX_MAP[char];\n      if (suffix) {\n        descriptors.push({ name, suffix });\n        i += 1;\n      } else {\n        i += 1; // Unknown suffix — skip\n      }\n    }\n  }\n\n  return descriptors;\n}\n\nfunction isSuffixChar(c: string): boolean {\n  return c === '/' || c === '#' || c === '.' || c === '(' || c === '[' || c === ':' || c === '!';\n}\n\n/**\n * Convert a parsed SCIP symbol to a short, human-readable name.\n * Language-agnostic: works for any SCIP-indexed language.\n *\n * Examples:\n *   \"scip-typescript npm @vega/api 0.1.3 src/modules/auth/auth.service.ts/AuthService#login().\"\n *   → \"auth.service:AuthService:login()\"\n *\n *   \"scip-java maven com.example/mylib 1.0.0 com/example/MyClass#doStuff().\"\n *   → \"MyClass:doStuff()\"\n *\n *   \"rust-analyzer cargo my-crate 0.1.0 src/lib.rs/MyStruct#new().\"\n *   → \"lib:MyStruct:new()\"\n */\nexport function shortenSymbol(raw: string): string {\n  const parsed = parseSymbol(raw);\n  if ('kind' in parsed && parsed.kind === 'local') {\n    return `local:${parsed.id}`;\n  }\n\n  const sym = parsed as ScipSymbol;\n  if (sym.descriptors.length === 0) return sym.raw;\n\n  const parts: string[] = [];\n  for (const desc of sym.descriptors) {\n    // Strip file extensions from namespace descriptors (the file path parts)\n    let name = desc.name;\n    if (desc.suffix === 'namespace') {\n      // Remove common file extensions\n      name = name\n        .replace(/\\.(ts|tsx|js|jsx|mjs|cjs)$/, '')\n        .replace(/\\.(py|pyi)$/, '')\n        .replace(/\\.(rs)$/, '')\n        .replace(/\\.(java|scala|kt|kts)$/, '')\n        .replace(/\\.(rb)$/, '')\n        .replace(/\\.(go)$/, '')\n        .replace(/\\.(cs|vb)$/, '')\n        .replace(/\\.(dart)$/, '')\n        .replace(/\\.(php)$/, '')\n        .replace(/\\.(c|cc|cpp|cxx|h|hpp)$/, '');\n    }\n\n    // Skip empty names (can happen with trailing suffixes)\n    if (!name) continue;\n\n    // For methods, append () for clarity\n    if (desc.suffix === 'method') {\n      parts.push(`${name}()`);\n    } else {\n      parts.push(name);\n    }\n  }\n\n  return parts.join(':');\n}\n\n/**\n * Extract just the leaf name from a SCIP symbol.\n * Useful when you only need the function/class/variable name without path context.\n */\nexport function leafName(raw: string): string {\n  const parsed = parseSymbol(raw);\n  if ('kind' in parsed && parsed.kind === 'local') {\n    return parsed.id;\n  }\n\n  const sym = parsed as ScipSymbol;\n  if (sym.descriptors.length === 0) return '';\n\n  const last = sym.descriptors[sym.descriptors.length - 1]!;\n  return last.name;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-SEFSL2GF.js

@@ -0,0 +1,78 @@
+import {
+  shortenSymbol
+} from "./chunk-QOV2R2WT.js";
+
+// src/queries/similar-signatures.ts
+function similarSignatures(db, opts = {}) {
+  const { scope, minLoc = 1, limit } = opts;
+  const scopeFilter = scope ? `AND d.relative_path LIKE '%${scope}%'` : "";
+  const rows = db.all(
+    `SELECT
+      gs.symbol,
+      d.relative_path,
+      der.start_line,
+      der.end_line,
+      (der.end_line - der.start_line + 1) AS loc,
+      REPLACE(SUBSTR(gs.documentation, INSTR(gs.documentation, '|') + 1), char(10), ' ') AS sig
+    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.documentation IS NOT NULL
+      AND gs.documentation != ''
+      AND INSTR(gs.documentation, '|') > 0
+      AND (der.end_line - der.start_line + 1) >= ?
+      ${db.pathExclusionsFor("d")}
+      ${db.symbolNoiseFor("gs")}
+      ${scopeFilter}
+    ORDER BY d.relative_path, der.start_line`,
+    minLoc
+  );
+  const sigGroups = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    if (db.isIgnored(row.relative_path)) continue;
+    const normalized = normalizeSignature(row.sig);
+    if (!normalized) continue;
+    const entry = {
+      symbol: row.symbol,
+      shortName: shortenSymbol(row.symbol),
+      file: row.relative_path,
+      startLine: row.start_line,
+      endLine: row.end_line,
+      loc: row.loc
+    };
+    const existing = sigGroups.get(normalized);
+    if (existing) {
+      existing.push(entry);
+    } else {
+      sigGroups.set(normalized, [entry]);
+    }
+  }
+  const results = [];
+  for (const [signature, functions] of sigGroups) {
+    if (functions.length < 2) continue;
+    results.push({ signature, functions });
+  }
+  results.sort((a, b) => {
+    const sizeDiff = b.functions.length - a.functions.length;
+    if (sizeDiff !== 0) return sizeDiff;
+    const locA = a.functions.reduce((sum, f) => sum + f.loc, 0);
+    const locB = b.functions.reduce((sum, f) => sum + f.loc, 0);
+    return locB - locA;
+  });
+  return limit ? results.slice(0, limit) : results;
+}
+function normalizeSignature(raw) {
+  if (!raw || !raw.trim()) return null;
+  let sig = raw.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();
+  const parenIdx = sig.indexOf("(");
+  if (parenIdx === -1) return null;
+  sig = sig.slice(parenIdx);
+  sig = sig.replace(/\s+/g, "").toLowerCase();
+  if (sig.length < 3) return null;
+  return sig;
+}
+
+export {
+  similarSignatures
+};
+//# sourceMappingURL=chunk-SEFSL2GF.js.map

package/dist/chunk-SEFSL2GF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queries/similar-signatures.ts"],"sourcesContent":["import type { ScipDatabase } from '../db.js';\nimport type { SimilarSignatureGroup } from '../types.js';\nimport { shortenSymbol } from '../symbol-parser.js';\n\n/**\n * Find functions with near-identical type signatures (same parameter types\n * and return type) but different names. These are \"same shape\" functions\n * that may be doing similar work even if their internal implementation differs.\n *\n * The SCIP `documentation` field often contains the full type signature\n * after a `|` delimiter. We parse it, normalize it (strip the function name,\n * whitespace, and case), then group by normalized signature.\n *\n * Groups with 2+ functions = same-shape candidates.\n */\nexport function similarSignatures(\n  db: ScipDatabase,\n  opts: { scope?: string; minLoc?: number; limit?: number } = {},\n): SimilarSignatureGroup[] {\n  const { scope, minLoc = 1, limit } = opts;\n\n  const scopeFilter = scope ? `AND d.relative_path LIKE '%${scope}%'` : '';\n\n  // Get all function-level symbols with their documentation/signature strings.\n  // We use the same signature extraction pattern as symbols.ts / trace.ts.\n  // Filter to symbols that have a documentation field containing '|' (the sig delimiter)\n  // and whose signature contains '(' (indicating a callable).\n  const rows = db.all<{\n    symbol: string;\n    relative_path: string;\n    start_line: number;\n    end_line: number;\n    loc: number;\n    sig: string;\n  }>(\n    `SELECT\n      gs.symbol,\n      d.relative_path,\n      der.start_line,\n      der.end_line,\n      (der.end_line - der.start_line + 1) AS loc,\n      REPLACE(SUBSTR(gs.documentation, INSTR(gs.documentation, '|') + 1), char(10), ' ') AS sig\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.documentation IS NOT NULL\n      AND gs.documentation != ''\n      AND INSTR(gs.documentation, '|') > 0\n      AND (der.end_line - der.start_line + 1) >= ?\n      ${db.pathExclusionsFor('d')}\n      ${db.symbolNoiseFor('gs')}\n      ${scopeFilter}\n    ORDER BY d.relative_path, der.start_line`,\n    minLoc,\n  );\n\n  // Group by normalized signature\n  const sigGroups = new Map<string, Array<{\n    symbol: string;\n    shortName: string;\n    file: string;\n    startLine: number;\n    endLine: number;\n    loc: number;\n  }>>();\n\n  for (const row of rows) {\n    if (db.isIgnored(row.relative_path)) continue;\n\n    const normalized = normalizeSignature(row.sig);\n    if (!normalized) continue;\n\n    const entry = {\n      symbol: row.symbol,\n      shortName: shortenSymbol(row.symbol),\n      file: row.relative_path,\n      startLine: row.start_line,\n      endLine: row.end_line,\n      loc: row.loc,\n    };\n\n    const existing = sigGroups.get(normalized);\n    if (existing) {\n      existing.push(entry);\n    } else {\n      sigGroups.set(normalized, [entry]);\n    }\n  }\n\n  // Collect groups with 2+ functions\n  const results: SimilarSignatureGroup[] = [];\n\n  for (const [signature, functions] of sigGroups) {\n    if (functions.length < 2) continue;\n\n    results.push({ signature, functions });\n  }\n\n  // Sort by group size descending (largest groups = most duplication),\n  // then by total LOC in the group\n  results.sort((a, b) => {\n    const sizeDiff = b.functions.length - a.functions.length;\n    if (sizeDiff !== 0) return sizeDiff;\n    const locA = a.functions.reduce((sum, f) => sum + f.loc, 0);\n    const locB = b.functions.reduce((sum, f) => sum + f.loc, 0);\n    return locB - locA;\n  });\n\n  return limit ? results.slice(0, limit) : results;\n}\n\n/**\n * Normalize a signature for comparison:\n * 1. Clean markdown fences and SCIP prefixes\n * 2. Strip everything before the first '(' (removes the function name)\n * 3. Strip whitespace and lowercase\n *\n * Returns null if the signature doesn't contain a callable form.\n */\nfunction normalizeSignature(raw: string): string | null {\n  if (!raw || !raw.trim()) return null;\n\n  // Clean markdown and SCIP decoration (same as cleanSignature)\n  let sig = raw\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();\n\n  // Find the first '(' — everything from there is the parameter/return signature\n  const parenIdx = sig.indexOf('(');\n  if (parenIdx === -1) return null;\n\n  sig = sig.slice(parenIdx);\n\n  // Normalize: strip all whitespace, lowercase\n  sig = sig.replace(/\\s+/g, '').toLowerCase();\n\n  // Must have meaningful content after normalization\n  if (sig.length < 3) return null; // e.g. \"()\" alone is too generic\n\n  return sig;\n}\n"],"mappings":";;;;;AAeO,SAAS,kBACd,IACA,OAA4D,CAAC,GACpC;AACzB,QAAM,EAAE,OAAO,SAAS,GAAG,MAAM,IAAI;AAErC,QAAM,cAAc,QAAQ,8BAA8B,KAAK,OAAO;AAMtE,QAAM,OAAO,GAAG;AAAA,IAQd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAcI,GAAG,kBAAkB,GAAG,CAAC;AAAA,QACzB,GAAG,eAAe,IAAI,CAAC;AAAA,QACvB,WAAW;AAAA;AAAA,IAEf;AAAA,EACF;AAGA,QAAM,YAAY,oBAAI,IAOlB;AAEJ,aAAW,OAAO,MAAM;AACtB,QAAI,GAAG,UAAU,IAAI,aAAa,EAAG;AAErC,UAAM,aAAa,mBAAmB,IAAI,GAAG;AAC7C,QAAI,CAAC,WAAY;AAEjB,UAAM,QAAQ;AAAA,MACZ,QAAQ,IAAI;AAAA,MACZ,WAAW,cAAc,IAAI,MAAM;AAAA,MACnC,MAAM,IAAI;AAAA,MACV,WAAW,IAAI;AAAA,MACf,SAAS,IAAI;AAAA,MACb,KAAK,IAAI;AAAA,IACX;AAEA,UAAM,WAAW,UAAU,IAAI,UAAU;AACzC,QAAI,UAAU;AACZ,eAAS,KAAK,KAAK;AAAA,IACrB,OAAO;AACL,gBAAU,IAAI,YAAY,CAAC,KAAK,CAAC;AAAA,IACnC;AAAA,EACF;AAGA,QAAM,UAAmC,CAAC;AAE1C,aAAW,CAAC,WAAW,SAAS,KAAK,WAAW;AAC9C,QAAI,UAAU,SAAS,EAAG;AAE1B,YAAQ,KAAK,EAAE,WAAW,UAAU,CAAC;AAAA,EACvC;AAIA,UAAQ,KAAK,CAAC,GAAG,MAAM;AACrB,UAAM,WAAW,EAAE,UAAU,SAAS,EAAE,UAAU;AAClD,QAAI,aAAa,EAAG,QAAO;AAC3B,UAAM,OAAO,EAAE,UAAU,OAAO,CAAC,KAAK,MAAM,MAAM,EAAE,KAAK,CAAC;AAC1D,UAAM,OAAO,EAAE,UAAU,OAAO,CAAC,KAAK,MAAM,MAAM,EAAE,KAAK,CAAC;AAC1D,WAAO,OAAO;AAAA,EAChB,CAAC;AAED,SAAO,QAAQ,QAAQ,MAAM,GAAG,KAAK,IAAI;AAC3C;AAUA,SAAS,mBAAmB,KAA4B;AACtD,MAAI,CAAC,OAAO,CAAC,IAAI,KAAK,EAAG,QAAO;AAGhC,MAAI,MAAM,IACP,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;AAGR,QAAM,WAAW,IAAI,QAAQ,GAAG;AAChC,MAAI,aAAa,GAAI,QAAO;AAE5B,QAAM,IAAI,MAAM,QAAQ;AAGxB,QAAM,IAAI,QAAQ,QAAQ,EAAE,EAAE,YAAY;AAG1C,MAAI,IAAI,SAAS,EAAG,QAAO;AAE3B,SAAO;AACT;","names":[]}