scip-query 0.1.0

package/dist/chunk-T6ARFSBZ.js

@@ -0,0 +1,103 @@
+import {
+  findFirstSymbolMatch
+} from "./chunk-FUHJCHS4.js";
+import {
+  shortenSymbol
+} from "./chunk-QOV2R2WT.js";
+
+// src/queries/dataflow.ts
+function dataflow(db, symbolPattern) {
+  const match = findFirstSymbolMatch(db, symbolPattern);
+  if (!match) return null;
+  const defSites = db.all(
+    `SELECT d.relative_path AS file, c.start_line AS line
+    FROM mentions m
+    JOIN chunks c ON m.chunk_id = c.id
+    JOIN documents d ON c.document_id = d.id
+    WHERE m.symbol_id = ? AND m.role = 1
+    ORDER BY d.relative_path, c.start_line`,
+    match.symbolId
+  );
+  const usageSites = db.all(
+    `SELECT d.relative_path AS file, c.start_line AS line,
+      (SELECT enc_gs.symbol
+       FROM defn_enclosing_ranges enc_der
+       JOIN global_symbols enc_gs ON enc_der.symbol_id = enc_gs.id
+       WHERE enc_der.document_id = d.id
+         AND enc_der.start_line <= c.start_line
+         AND enc_der.end_line >= c.end_line
+       ORDER BY (enc_der.end_line - enc_der.start_line) ASC
+       LIMIT 1
+      ) AS enclosing_symbol
+    FROM mentions m
+    JOIN chunks c ON m.chunk_id = c.id
+    JOIN documents d ON c.document_id = d.id
+    WHERE m.symbol_id = ? AND m.role = 0
+      ${db.pathExclusionsFor("d")}
+    ORDER BY d.relative_path, c.start_line`,
+    match.symbolId
+  );
+  const producers = db.all(
+    `SELECT DISTINCT other_gs.symbol, other_d.relative_path AS file
+    FROM mentions other_m
+    JOIN chunks other_c ON other_m.chunk_id = other_c.id
+    JOIN global_symbols other_gs ON other_m.symbol_id = other_gs.id
+    JOIN defn_enclosing_ranges other_der ON other_gs.id = other_der.symbol_id
+    JOIN documents other_d ON other_der.document_id = other_d.id
+    WHERE other_c.document_id = ?
+      AND other_c.start_line >= ? AND other_c.end_line <= ?
+      AND other_m.role = 0
+      AND other_gs.id != ?
+      ${db.symbolNoiseFor("other_gs")}
+      ${db.pathExclusionsFor("other_d")}
+    ORDER BY other_d.relative_path
+    LIMIT 30`,
+    match.documentId,
+    match.startLine,
+    match.endLine,
+    match.symbolId
+  );
+  const consumers = db.all(
+    `SELECT DISTINCT consumer_gs.symbol, consumer_d.relative_path AS file
+    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
+    -- Find the enclosing function at each usage site
+    JOIN defn_enclosing_ranges enc_der
+      ON enc_der.document_id = ref_d.id
+      AND enc_der.start_line <= ref_c.start_line
+      AND enc_der.end_line >= ref_c.end_line
+    JOIN global_symbols enc_gs ON enc_der.symbol_id = enc_gs.id
+    -- Find other symbols defined by that enclosing function's file
+    JOIN mentions consumer_m ON consumer_m.symbol_id = enc_gs.id AND consumer_m.role = 0
+    JOIN chunks consumer_c ON consumer_m.chunk_id = consumer_c.id
+    JOIN documents consumer_d ON consumer_c.document_id = consumer_d.id
+    JOIN global_symbols consumer_gs ON consumer_m.symbol_id = consumer_gs.id
+    WHERE ref_m.symbol_id = ? AND ref_m.role = 0
+      AND consumer_d.id != ref_d.id
+      ${db.symbolNoiseFor("consumer_gs")}
+      ${db.pathExclusionsFor("consumer_d")}
+    ORDER BY consumer_d.relative_path
+    LIMIT 30`,
+    match.symbolId
+  );
+  return {
+    symbol: match.symbol,
+    shortName: shortenSymbol(match.symbol),
+    relativePath: match.relativePath,
+    definitionSites: defSites.filter((s) => !db.isIgnored(s.file)),
+    usageSites: usageSites.filter((s) => !db.isIgnored(s.file)).map((s) => ({
+      file: s.file,
+      line: s.line,
+      enclosingSymbol: s.enclosing_symbol ?? "(top-level)",
+      enclosingShort: s.enclosing_symbol ? shortenSymbol(s.enclosing_symbol) : "(top-level)"
+    })),
+    producers: producers.filter((p) => !db.isIgnored(p.file)).map((p) => ({ symbol: p.symbol, shortName: shortenSymbol(p.symbol), file: p.file })),
+    consumers: consumers.filter((c) => !db.isIgnored(c.file)).map((c) => ({ symbol: c.symbol, shortName: shortenSymbol(c.symbol), file: c.file }))
+  };
+}
+
+export {
+  dataflow
+};
+//# sourceMappingURL=chunk-T6ARFSBZ.js.map

package/dist/chunk-T6ARFSBZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queries/dataflow.ts"],"sourcesContent":["import type { ScipDatabase } from '../db.js';\nimport { findFirstSymbolMatch } from '../query-support.js';\nimport type { DataflowResult } from '../types.js';\nimport { shortenSymbol } from '../symbol-parser.js';\n\n/**\n * Reference-level dataflow analysis: where does data around this symbol\n * come from and where does it go?\n *\n * This is not value-level dataflow (we can't trace x = foo(); bar(x);\n * as a chain). Instead it shows:\n * - Where the symbol is defined and used\n * - What other symbols appear in the same enclosing scope (co-occurring data)\n * - What feeds into the function that defines it (producers)\n * - What consumes the function that uses it (consumers)\n *\n * Language-agnostic: works with any SCIP index.\n */\nexport function dataflow(\n  db: ScipDatabase,\n  symbolPattern: string,\n): DataflowResult | null {\n  const match = findFirstSymbolMatch(db, symbolPattern);\n  if (!match) return null;\n\n  // Definition sites (role=1)\n  const defSites = db.all<{ file: string; line: number }>(\n    `SELECT d.relative_path AS file, c.start_line AS line\n    FROM mentions m\n    JOIN chunks c ON m.chunk_id = c.id\n    JOIN documents d ON c.document_id = d.id\n    WHERE m.symbol_id = ? AND m.role = 1\n    ORDER BY d.relative_path, c.start_line`,\n    match.symbolId,\n  );\n\n  // Usage sites (role=0) with enclosing symbol\n  const usageSites = db.all<{\n    file: string;\n    line: number;\n    enclosing_symbol: string | null;\n  }>(\n    `SELECT d.relative_path AS file, c.start_line AS line,\n      (SELECT enc_gs.symbol\n       FROM defn_enclosing_ranges enc_der\n       JOIN global_symbols enc_gs ON enc_der.symbol_id = enc_gs.id\n       WHERE enc_der.document_id = d.id\n         AND enc_der.start_line <= c.start_line\n         AND enc_der.end_line >= c.end_line\n       ORDER BY (enc_der.end_line - enc_der.start_line) ASC\n       LIMIT 1\n      ) AS enclosing_symbol\n    FROM mentions m\n    JOIN chunks c ON m.chunk_id = c.id\n    JOIN documents d ON c.document_id = d.id\n    WHERE m.symbol_id = ? AND m.role = 0\n      ${db.pathExclusionsFor('d')}\n    ORDER BY d.relative_path, c.start_line`,\n    match.symbolId,\n  );\n\n  // Producers: other symbols referenced within the same function that defines our target\n  const producers = db.all<{ symbol: string; file: string }>(\n    `SELECT DISTINCT other_gs.symbol, other_d.relative_path AS file\n    FROM mentions other_m\n    JOIN chunks other_c ON other_m.chunk_id = other_c.id\n    JOIN global_symbols other_gs ON other_m.symbol_id = other_gs.id\n    JOIN defn_enclosing_ranges other_der ON other_gs.id = other_der.symbol_id\n    JOIN documents other_d ON other_der.document_id = other_d.id\n    WHERE other_c.document_id = ?\n      AND other_c.start_line >= ? AND other_c.end_line <= ?\n      AND other_m.role = 0\n      AND other_gs.id != ?\n      ${db.symbolNoiseFor('other_gs')}\n      ${db.pathExclusionsFor('other_d')}\n    ORDER BY other_d.relative_path\n    LIMIT 30`,\n    match.documentId, match.startLine, match.endLine, match.symbolId,\n  );\n\n  // Consumers: symbols exported/defined by functions that reference our target\n  // (what does the data flow into after being used)\n  const consumers = db.all<{ symbol: string; file: string }>(\n    `SELECT DISTINCT consumer_gs.symbol, consumer_d.relative_path AS file\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    -- Find the enclosing function at each usage site\n    JOIN defn_enclosing_ranges enc_der\n      ON enc_der.document_id = ref_d.id\n      AND enc_der.start_line <= ref_c.start_line\n      AND enc_der.end_line >= ref_c.end_line\n    JOIN global_symbols enc_gs ON enc_der.symbol_id = enc_gs.id\n    -- Find other symbols defined by that enclosing function's file\n    JOIN mentions consumer_m ON consumer_m.symbol_id = enc_gs.id AND consumer_m.role = 0\n    JOIN chunks consumer_c ON consumer_m.chunk_id = consumer_c.id\n    JOIN documents consumer_d ON consumer_c.document_id = consumer_d.id\n    JOIN global_symbols consumer_gs ON consumer_m.symbol_id = consumer_gs.id\n    WHERE ref_m.symbol_id = ? AND ref_m.role = 0\n      AND consumer_d.id != ref_d.id\n      ${db.symbolNoiseFor('consumer_gs')}\n      ${db.pathExclusionsFor('consumer_d')}\n    ORDER BY consumer_d.relative_path\n    LIMIT 30`,\n    match.symbolId,\n  );\n\n  return {\n    symbol: match.symbol,\n    shortName: shortenSymbol(match.symbol),\n    relativePath: match.relativePath,\n    definitionSites: defSites.filter((s) => !db.isIgnored(s.file)),\n    usageSites: usageSites\n      .filter((s) => !db.isIgnored(s.file))\n      .map((s) => ({\n        file: s.file,\n        line: s.line,\n        enclosingSymbol: s.enclosing_symbol ?? '(top-level)',\n        enclosingShort: s.enclosing_symbol ? shortenSymbol(s.enclosing_symbol) : '(top-level)',\n      })),\n    producers: producers\n      .filter((p) => !db.isIgnored(p.file))\n      .map((p) => ({ symbol: p.symbol, shortName: shortenSymbol(p.symbol), file: p.file })),\n    consumers: consumers\n      .filter((c) => !db.isIgnored(c.file))\n      .map((c) => ({ symbol: c.symbol, shortName: shortenSymbol(c.symbol), file: c.file })),\n  };\n}\n"],"mappings":";;;;;;;;AAkBO,SAAS,SACd,IACA,eACuB;AACvB,QAAM,QAAQ,qBAAqB,IAAI,aAAa;AACpD,MAAI,CAAC,MAAO,QAAO;AAGnB,QAAM,WAAW,GAAG;AAAA,IAClB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMA,MAAM;AAAA,EACR;AAGA,QAAM,aAAa,GAAG;AAAA,IAKpB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAcI,GAAG,kBAAkB,GAAG,CAAC;AAAA;AAAA,IAE7B,MAAM;AAAA,EACR;AAGA,QAAM,YAAY,GAAG;AAAA,IACnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAUI,GAAG,eAAe,UAAU,CAAC;AAAA,QAC7B,GAAG,kBAAkB,SAAS,CAAC;AAAA;AAAA;AAAA,IAGnC,MAAM;AAAA,IAAY,MAAM;AAAA,IAAW,MAAM;AAAA,IAAS,MAAM;AAAA,EAC1D;AAIA,QAAM,YAAY,GAAG;AAAA,IACnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAiBI,GAAG,eAAe,aAAa,CAAC;AAAA,QAChC,GAAG,kBAAkB,YAAY,CAAC;AAAA;AAAA;AAAA,IAGtC,MAAM;AAAA,EACR;AAEA,SAAO;AAAA,IACL,QAAQ,MAAM;AAAA,IACd,WAAW,cAAc,MAAM,MAAM;AAAA,IACrC,cAAc,MAAM;AAAA,IACpB,iBAAiB,SAAS,OAAO,CAAC,MAAM,CAAC,GAAG,UAAU,EAAE,IAAI,CAAC;AAAA,IAC7D,YAAY,WACT,OAAO,CAAC,MAAM,CAAC,GAAG,UAAU,EAAE,IAAI,CAAC,EACnC,IAAI,CAAC,OAAO;AAAA,MACX,MAAM,EAAE;AAAA,MACR,MAAM,EAAE;AAAA,MACR,iBAAiB,EAAE,oBAAoB;AAAA,MACvC,gBAAgB,EAAE,mBAAmB,cAAc,EAAE,gBAAgB,IAAI;AAAA,IAC3E,EAAE;AAAA,IACJ,WAAW,UACR,OAAO,CAAC,MAAM,CAAC,GAAG,UAAU,EAAE,IAAI,CAAC,EACnC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,WAAW,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE;AAAA,IACtF,WAAW,UACR,OAAO,CAAC,MAAM,CAAC,GAAG,UAAU,EAAE,IAAI,CAAC,EACnC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,WAAW,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE;AAAA,EACxF;AACF;","names":[]}

package/dist/chunk-TBP6BICL.js

@@ -0,0 +1,46 @@
+import {
+  cleanSignature
+} from "./chunk-4TYLS5XX.js";
+
+// src/queries/trace.ts
+function trace(db, symbolPattern) {
+  const defRows = db.all(
+    `SELECT d.relative_path, der.start_line, der.end_line,
+      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.symbol LIKE ?
+      AND ${db.localSymbolPredicate}
+      ${db.symbolNoise}
+    ORDER BY d.relative_path, der.start_line
+    LIMIT 10`,
+    `%${symbolPattern}%`
+  );
+  const definitions = defRows.filter((r) => !db.isIgnored(r.relative_path)).map((r) => ({
+    relativePath: r.relative_path,
+    startLine: r.start_line,
+    endLine: r.end_line,
+    signature: cleanSignature(r.sig)
+  }));
+  const refRows = db.all(
+    `SELECT DISTINCT d.relative_path
+    FROM mentions m
+    JOIN chunks c ON m.chunk_id = c.id
+    JOIN documents d ON c.document_id = d.id
+    JOIN global_symbols gs ON m.symbol_id = gs.id
+    WHERE gs.symbol LIKE ?
+      AND ${db.localSymbolPredicate}
+      ${db.symbolNoise}
+      AND m.role = 0
+    ORDER BY d.relative_path`,
+    `%${symbolPattern}%`
+  );
+  const referencedBy = refRows.map((r) => r.relative_path).filter((p) => !db.isIgnored(p));
+  return { definitions, referencedBy };
+}
+
+export {
+  trace
+};
+//# sourceMappingURL=chunk-TBP6BICL.js.map

package/dist/chunk-TBP6BICL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queries/trace.ts"],"sourcesContent":["import type { ScipDatabase } from '../db.js';\nimport type { TraceResult } from '../types.js';\nimport { cleanSignature } from './clean-signature.js';\n\nexport function trace(db: ScipDatabase, symbolPattern: string): TraceResult {\n  // Definitions\n  const defRows = db.all<{\n    relative_path: string;\n    start_line: number;\n    end_line: number;\n    sig: string | null;\n  }>(\n    `SELECT d.relative_path, der.start_line, der.end_line,\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.symbol LIKE ?\n      AND ${db.localSymbolPredicate}\n      ${db.symbolNoise}\n    ORDER BY d.relative_path, der.start_line\n    LIMIT 10`,\n    `%${symbolPattern}%`,\n  );\n\n  const definitions = defRows\n    .filter((r) => !db.isIgnored(r.relative_path))\n    .map((r) => ({\n      relativePath: r.relative_path,\n      startLine: r.start_line,\n      endLine: r.end_line,\n      signature: cleanSignature(r.sig),\n    }));\n\n  // References\n  const refRows = db.all<{ relative_path: string }>(\n    `SELECT DISTINCT d.relative_path\n    FROM mentions m\n    JOIN chunks c ON m.chunk_id = c.id\n    JOIN documents d ON c.document_id = d.id\n    JOIN global_symbols gs ON m.symbol_id = gs.id\n    WHERE gs.symbol LIKE ?\n      AND ${db.localSymbolPredicate}\n      ${db.symbolNoise}\n      AND m.role = 0\n    ORDER BY d.relative_path`,\n    `%${symbolPattern}%`,\n  );\n\n  const referencedBy = refRows\n    .map((r) => r.relative_path)\n    .filter((p) => !db.isIgnored(p));\n\n  return { definitions, referencedBy };\n}\n"],"mappings":";;;;;AAIO,SAAS,MAAM,IAAkB,eAAoC;AAE1E,QAAM,UAAU,GAAG;AAAA,IAMjB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,YAMQ,GAAG,oBAAoB;AAAA,QAC3B,GAAG,WAAW;AAAA;AAAA;AAAA,IAGlB,IAAI,aAAa;AAAA,EACnB;AAEA,QAAM,cAAc,QACjB,OAAO,CAAC,MAAM,CAAC,GAAG,UAAU,EAAE,aAAa,CAAC,EAC5C,IAAI,CAAC,OAAO;AAAA,IACX,cAAc,EAAE;AAAA,IAChB,WAAW,EAAE;AAAA,IACb,SAAS,EAAE;AAAA,IACX,WAAW,eAAe,EAAE,GAAG;AAAA,EACjC,EAAE;AAGJ,QAAM,UAAU,GAAG;AAAA,IACjB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,YAMQ,GAAG,oBAAoB;AAAA,QAC3B,GAAG,WAAW;AAAA;AAAA;AAAA,IAGlB,IAAI,aAAa;AAAA,EACnB;AAEA,QAAM,eAAe,QAClB,IAAI,CAAC,MAAM,EAAE,aAAa,EAC1B,OAAO,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC;AAEjC,SAAO,EAAE,aAAa,aAAa;AACrC;","names":[]}

package/dist/chunk-TDNNOR6D.js

@@ -0,0 +1,97 @@
+import {
+  testFileExclusionSql
+} from "./chunk-FUHJCHS4.js";
+import {
+  shortenSymbol
+} from "./chunk-QOV2R2WT.js";
+
+// src/queries/wrapper-candidates.ts
+function wrapperCandidates(db, opts) {
+  const { scope, maxLoc = 15, limit = 30 } = opts ?? {};
+  const scopeFilter = scope ? `AND d.relative_path LIKE '%${scope}%'` : "";
+  const rows = db.all(
+    `SELECT * FROM (
+      SELECT
+        gs.symbol,
+        d.relative_path AS file,
+        der.start_line,
+        der.end_line,
+        (der.end_line - der.start_line + 1) AS loc,
+        -- The single caller: the symbol whose definition range contains
+        -- the chunk that references our target
+        (SELECT caller_gs.symbol
+         FROM mentions ref_m
+         JOIN chunks ref_c ON ref_m.chunk_id = ref_c.id
+         JOIN defn_enclosing_ranges caller_der
+           ON caller_der.document_id = ref_c.document_id
+           AND ref_c.start_line >= caller_der.start_line
+           AND ref_c.end_line <= caller_der.end_line
+         JOIN global_symbols caller_gs ON caller_der.symbol_id = caller_gs.id
+         WHERE ref_m.symbol_id = gs.id
+           AND ref_m.role = 0
+           AND ref_c.document_id != der.document_id
+         LIMIT 1
+        ) AS caller_symbol,
+        -- Fan-in of that single caller
+        (SELECT COUNT(DISTINCT caller_ref_c.document_id)
+         FROM mentions caller_ref_m
+         JOIN chunks caller_ref_c ON caller_ref_m.chunk_id = caller_ref_c.id
+         WHERE caller_ref_m.symbol_id = (
+           SELECT caller_der2.symbol_id
+           FROM mentions ref_m2
+           JOIN chunks ref_c2 ON ref_m2.chunk_id = ref_c2.id
+           JOIN defn_enclosing_ranges caller_der2
+             ON caller_der2.document_id = ref_c2.document_id
+             AND ref_c2.start_line >= caller_der2.start_line
+             AND ref_c2.end_line <= caller_der2.end_line
+           WHERE ref_m2.symbol_id = gs.id
+             AND ref_m2.role = 0
+             AND ref_c2.document_id != der.document_id
+           LIMIT 1
+         )
+         AND caller_ref_m.role = 0
+        ) AS caller_fan_in
+      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")}
+        -- Only functions/terms, not type definitions (types with # are not wrappers)
+        AND gs.symbol NOT LIKE '%#'
+        AND (der.end_line - der.start_line + 1) <= ?
+        AND (der.end_line - der.start_line + 1) >= 2
+        ${scopeFilter}
+        -- Exactly 1 cross-file consumer
+        AND (
+          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
+            AND ref_c.document_id != der.document_id
+        ) = 1
+    ) WHERE caller_symbol IS NOT NULL AND caller_fan_in > 3
+    ORDER BY caller_fan_in DESC, loc DESC
+    LIMIT ?`,
+    maxLoc,
+    limit
+  );
+  return rows.filter((r) => !db.isIgnored(r.file)).map((r) => ({
+    symbol: r.symbol,
+    shortName: shortenSymbol(r.symbol),
+    file: r.file,
+    startLine: r.start_line,
+    endLine: r.end_line,
+    loc: r.loc,
+    singleCaller: r.caller_symbol,
+    singleCallerShort: shortenSymbol(r.caller_symbol),
+    callerFanIn: r.caller_fan_in
+  }));
+}
+
+export {
+  wrapperCandidates
+};
+//# sourceMappingURL=chunk-TDNNOR6D.js.map

package/dist/chunk-TDNNOR6D.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queries/wrapper-candidates.ts"],"sourcesContent":["import type { ScipDatabase } from '../db.js';\nimport { testFileExclusionSql } from '../query-support.js';\nimport type { WrapperCandidate } from '../types.js';\nimport { shortenSymbol } from '../symbol-parser.js';\n\n/**\n * Find wrapper candidates: symbols called by only one other symbol.\n *\n * These are premature abstractions that add indirection without\n * providing reuse. A function with fan-in = 1 whose sole caller\n * is widely used is a strong signal of unnecessary wrapping.\n */\nexport function wrapperCandidates(\n  db: ScipDatabase,\n  opts?: { scope?: string; maxLoc?: number; limit?: number },\n): WrapperCandidate[] {\n  const { scope, maxLoc = 15, limit = 30 } = opts ?? {};\n  const scopeFilter = scope ? `AND d.relative_path LIKE '%${scope}%'` : '';\n\n  // Find all symbols with exactly 1 cross-file consumer (fan-in = 1),\n  // along with who that single caller is and the caller's own fan-in.\n  const rows = db.all<{\n    symbol: string;\n    file: string;\n    start_line: number;\n    end_line: number;\n    loc: number;\n    caller_symbol: string;\n    caller_fan_in: number;\n  }>(\n    `SELECT * FROM (\n      SELECT\n        gs.symbol,\n        d.relative_path AS file,\n        der.start_line,\n        der.end_line,\n        (der.end_line - der.start_line + 1) AS loc,\n        -- The single caller: the symbol whose definition range contains\n        -- the chunk that references our target\n        (SELECT caller_gs.symbol\n         FROM mentions ref_m\n         JOIN chunks ref_c ON ref_m.chunk_id = ref_c.id\n         JOIN defn_enclosing_ranges caller_der\n           ON caller_der.document_id = ref_c.document_id\n           AND ref_c.start_line >= caller_der.start_line\n           AND ref_c.end_line <= caller_der.end_line\n         JOIN global_symbols caller_gs ON caller_der.symbol_id = caller_gs.id\n         WHERE ref_m.symbol_id = gs.id\n           AND ref_m.role = 0\n           AND ref_c.document_id != der.document_id\n         LIMIT 1\n        ) AS caller_symbol,\n        -- Fan-in of that single caller\n        (SELECT COUNT(DISTINCT caller_ref_c.document_id)\n         FROM mentions caller_ref_m\n         JOIN chunks caller_ref_c ON caller_ref_m.chunk_id = caller_ref_c.id\n         WHERE caller_ref_m.symbol_id = (\n           SELECT caller_der2.symbol_id\n           FROM mentions ref_m2\n           JOIN chunks ref_c2 ON ref_m2.chunk_id = ref_c2.id\n           JOIN defn_enclosing_ranges caller_der2\n             ON caller_der2.document_id = ref_c2.document_id\n             AND ref_c2.start_line >= caller_der2.start_line\n             AND ref_c2.end_line <= caller_der2.end_line\n           WHERE ref_m2.symbol_id = gs.id\n             AND ref_m2.role = 0\n             AND ref_c2.document_id != der.document_id\n           LIMIT 1\n         )\n         AND caller_ref_m.role = 0\n        ) AS caller_fan_in\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        -- Only functions/terms, not type definitions (types with # are not wrappers)\n        AND gs.symbol NOT LIKE '%#'\n        AND (der.end_line - der.start_line + 1) <= ?\n        AND (der.end_line - der.start_line + 1) >= 2\n        ${scopeFilter}\n        -- Exactly 1 cross-file consumer\n        AND (\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\n            AND ref_m.role = 0\n            AND ref_c.document_id != der.document_id\n        ) = 1\n    ) WHERE caller_symbol IS NOT NULL AND caller_fan_in > 3\n    ORDER BY caller_fan_in DESC, loc DESC\n    LIMIT ?`,\n    maxLoc, limit,\n  );\n\n  return rows\n    .filter((r) => !db.isIgnored(r.file))\n    .map((r) => ({\n      symbol: r.symbol,\n      shortName: shortenSymbol(r.symbol),\n      file: r.file,\n      startLine: r.start_line,\n      endLine: r.end_line,\n      loc: r.loc,\n      singleCaller: r.caller_symbol,\n      singleCallerShort: shortenSymbol(r.caller_symbol),\n      callerFanIn: r.caller_fan_in,\n    }));\n}\n"],"mappings":";;;;;;;;AAYO,SAAS,kBACd,IACA,MACoB;AACpB,QAAM,EAAE,OAAO,SAAS,IAAI,QAAQ,GAAG,IAAI,QAAQ,CAAC;AACpD,QAAM,cAAc,QAAQ,8BAA8B,KAAK,OAAO;AAItE,QAAM,OAAO,GAAG;AAAA,IASd;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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,UA6CM,GAAG,kBAAkB,GAAG,CAAC;AAAA,cACrB,qBAAqB,GAAG,CAAC;AAAA,UAC7B,GAAG,eAAe,IAAI,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,UAKvB,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAajB;AAAA,IAAQ;AAAA,EACV;AAEA,SAAO,KACJ,OAAO,CAAC,MAAM,CAAC,GAAG,UAAU,EAAE,IAAI,CAAC,EACnC,IAAI,CAAC,OAAO;AAAA,IACX,QAAQ,EAAE;AAAA,IACV,WAAW,cAAc,EAAE,MAAM;AAAA,IACjC,MAAM,EAAE;AAAA,IACR,WAAW,EAAE;AAAA,IACb,SAAS,EAAE;AAAA,IACX,KAAK,EAAE;AAAA,IACP,cAAc,EAAE;AAAA,IAChB,mBAAmB,cAAc,EAAE,aAAa;AAAA,IAChD,aAAa,EAAE;AAAA,EACjB,EAAE;AACN;","names":[]}

package/dist/chunk-TSPZOMHC.js

@@ -0,0 +1,195 @@
+import {
+  findFirstSymbolMatch,
+  getCalleeRowsForSymbol
+} from "./chunk-FUHJCHS4.js";
+import {
+  shortenSymbol
+} from "./chunk-QOV2R2WT.js";
+
+// src/queries/similar.ts
+function similar(db, symbolPattern, opts = {}) {
+  const { minSimilarity = 0.4, limit = 20 } = opts;
+  const target = findCallees(db, symbolPattern);
+  if (!target || target.callees.size === 0) return [];
+  const candidates = getAllCalleeFingerprints(db, {
+    minCallees: 3,
+    excludeSymbol: target.symbol
+  });
+  const allFingerprints = [target, ...candidates];
+  const idfWeights = computeIdf(allFingerprints);
+  const results = [];
+  for (const candidate of candidates) {
+    if (candidate.callees.size < 3) continue;
+    const { similarity, significantShared, trivialShared } = weightedSimilarity(
+      target.callees,
+      candidate.callees,
+      idfWeights
+    );
+    if (similarity < minSimilarity) continue;
+    if (significantShared.length < 1) continue;
+    results.push({
+      symbolA: target.symbol,
+      shortNameA: shortenSymbol(target.symbol),
+      fileA: target.file,
+      symbolB: candidate.symbol,
+      shortNameB: shortenSymbol(candidate.symbol),
+      fileB: candidate.file,
+      similarity,
+      sharedCallees: significantShared.map(shortenSymbol),
+      uniqueToA: [...difference(target.callees, candidate.callees)].map(shortenSymbol),
+      uniqueToB: [...difference(candidate.callees, target.callees)].map(shortenSymbol)
+    });
+  }
+  results.sort((a, b) => b.similarity - a.similarity);
+  return results.slice(0, limit);
+}
+function similarAll(db, opts = {}) {
+  const { minSimilarity = 0.5, limit = 20, scope, minCallees = 4 } = opts;
+  const all = getAllCalleeFingerprints(db, { minCallees, scope });
+  const idfWeights = computeIdf(all);
+  const results = [];
+  for (let i = 0; i < all.length; i++) {
+    for (let j = i + 1; j < all.length; j++) {
+      const a = all[i];
+      const b = all[j];
+      if (a.file === b.file) continue;
+      const { similarity, significantShared } = weightedSimilarity(
+        a.callees,
+        b.callees,
+        idfWeights
+      );
+      if (similarity < minSimilarity) continue;
+      if (significantShared.length < 2) continue;
+      results.push({
+        symbolA: a.symbol,
+        shortNameA: shortenSymbol(a.symbol),
+        fileA: a.file,
+        symbolB: b.symbol,
+        shortNameB: shortenSymbol(b.symbol),
+        fileB: b.file,
+        similarity,
+        sharedCallees: significantShared.map(shortenSymbol),
+        uniqueToA: [...difference(a.callees, b.callees)].map(shortenSymbol),
+        uniqueToB: [...difference(b.callees, a.callees)].map(shortenSymbol)
+      });
+    }
+    if (results.length > limit * 5) break;
+  }
+  results.sort((a, b) => b.similarity - a.similarity);
+  return results.slice(0, limit);
+}
+function computeIdf(fingerprints) {
+  const n = fingerprints.length;
+  if (n === 0) return /* @__PURE__ */ new Map();
+  const docFreq = /* @__PURE__ */ new Map();
+  for (const fp of fingerprints) {
+    for (const callee of fp.callees) {
+      docFreq.set(callee, (docFreq.get(callee) ?? 0) + 1);
+    }
+  }
+  const idf = /* @__PURE__ */ new Map();
+  for (const [callee, df] of docFreq) {
+    idf.set(callee, Math.log(n / df));
+  }
+  return idf;
+}
+function weightedSimilarity(a, b, idf) {
+  const shared = intersection(a, b);
+  if (shared.size === 0) return { similarity: 0, significantShared: [], trivialShared: [] };
+  let dotProduct = 0;
+  let magA = 0;
+  let magB = 0;
+  const allCallees = /* @__PURE__ */ new Set([...a, ...b]);
+  for (const callee of allCallees) {
+    const weight = idf.get(callee) ?? 0;
+    const inA = a.has(callee) ? weight : 0;
+    const inB = b.has(callee) ? weight : 0;
+    dotProduct += inA * inB;
+    magA += inA * inA;
+    magB += inB * inB;
+  }
+  const magnitude = Math.sqrt(magA) * Math.sqrt(magB);
+  const similarity = magnitude > 0 ? dotProduct / magnitude : 0;
+  const medianIdf = getMedianIdf(idf);
+  const significantShared = [];
+  const trivialShared = [];
+  for (const callee of shared) {
+    const weight = idf.get(callee) ?? 0;
+    if (weight >= medianIdf) {
+      significantShared.push(callee);
+    } else {
+      trivialShared.push(callee);
+    }
+  }
+  significantShared.sort((x, y) => (idf.get(y) ?? 0) - (idf.get(x) ?? 0));
+  return { similarity, significantShared, trivialShared };
+}
+function getMedianIdf(idf) {
+  const values = [...idf.values()].sort((a, b) => a - b);
+  if (values.length === 0) return 0;
+  const mid = Math.floor(values.length / 2);
+  return values.length % 2 === 0 ? (values[mid - 1] + values[mid]) / 2 : values[mid];
+}
+function findCallees(db, symbolPattern) {
+  const target = findFirstSymbolMatch(db, symbolPattern);
+  if (!target) return null;
+  const calleeRows = getCalleeRowsForSymbol(db, target);
+  return {
+    symbol: target.symbol,
+    file: target.relativePath,
+    callees: new Set(calleeRows.map((r) => r.symbol))
+  };
+}
+function getAllCalleeFingerprints(db, opts) {
+  const { minCallees, scope, excludeSymbol } = opts;
+  const scopeFilter = scope ? `AND d.relative_path LIKE '%${scope}%'` : "";
+  const excludeFilter = excludeSymbol ? `AND gs.symbol != '${excludeSymbol.replace(/'/g, "''")}'` : "";
+  const symbols = db.all(
+    `SELECT gs.id, gs.symbol, der.document_id, der.start_line, der.end_line, 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")}
+      ${db.symbolNoiseFor("gs")}
+      AND (der.end_line - der.start_line + 1) >= 5
+      ${scopeFilter}
+      ${excludeFilter}
+    ORDER BY d.relative_path`
+  );
+  const fingerprints = [];
+  for (const sym of symbols) {
+    if (db.isIgnored(sym.relative_path)) continue;
+    const calleeRows = getCalleeRowsForSymbol(db, {
+      documentId: sym.document_id,
+      startLine: sym.start_line,
+      endLine: sym.end_line,
+      symbolId: sym.id
+    });
+    const callees = new Set(calleeRows.map((r) => r.symbol));
+    if (callees.size >= minCallees) {
+      fingerprints.push({ symbol: sym.symbol, file: sym.relative_path, callees });
+    }
+  }
+  return fingerprints;
+}
+function intersection(a, b) {
+  const result = /* @__PURE__ */ new Set();
+  for (const item of a) {
+    if (b.has(item)) result.add(item);
+  }
+  return result;
+}
+function difference(a, b) {
+  const result = /* @__PURE__ */ new Set();
+  for (const item of a) {
+    if (!b.has(item)) result.add(item);
+  }
+  return result;
+}
+
+export {
+  similar,
+  similarAll
+};
+//# sourceMappingURL=chunk-TSPZOMHC.js.map

package/dist/chunk-TSPZOMHC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queries/similar.ts"],"sourcesContent":["import type { ScipDatabase } from '../db.js';\nimport { findFirstSymbolMatch, getCalleeRowsForSymbol } from '../query-support.js';\nimport type { SimilarSymbolResult } from '../types.js';\nimport { shortenSymbol } from '../symbol-parser.js';\n\n/**\n * Find functions with similar callee fingerprints using TF-IDF weighted\n * cosine similarity.\n *\n * Plain Jaccard similarity inflates scores when functions share ubiquitous\n * infrastructure imports (db, types, shortenSymbol). TF-IDF fixes this by\n * weighting each shared callee by how rare it is:\n *\n *   - A callee used by 2 functions (rare) gets high weight → strong signal\n *   - A callee used by 30 functions (common) gets low weight → noise\n *\n * This means two functions sharing `sendWelcomeEmail()` (rare) score\n * much higher than two functions sharing `db.all()` (ubiquitous), even\n * though both are \"shared callees.\"\n */\nexport function similar(\n  db: ScipDatabase,\n  symbolPattern: string,\n  opts: { minSimilarity?: number; limit?: number } = {},\n): SimilarSymbolResult[] {\n  const { minSimilarity = 0.4, limit = 20 } = opts;\n\n  const target = findCallees(db, symbolPattern);\n  if (!target || target.callees.size === 0) return [];\n\n  const candidates = getAllCalleeFingerprints(db, {\n    minCallees: 3,\n    excludeSymbol: target.symbol,\n  });\n\n  // Compute IDF weights across all fingerprints + target\n  const allFingerprints = [target, ...candidates];\n  const idfWeights = computeIdf(allFingerprints);\n\n  const results: SimilarSymbolResult[] = [];\n\n  for (const candidate of candidates) {\n    if (candidate.callees.size < 3) continue;\n\n    const { similarity, significantShared, trivialShared } = weightedSimilarity(\n      target.callees, candidate.callees, idfWeights,\n    );\n\n    if (similarity < minSimilarity) continue;\n    if (significantShared.length < 1) continue; // no real overlap\n\n    results.push({\n      symbolA: target.symbol,\n      shortNameA: shortenSymbol(target.symbol),\n      fileA: target.file,\n      symbolB: candidate.symbol,\n      shortNameB: shortenSymbol(candidate.symbol),\n      fileB: candidate.file,\n      similarity,\n      sharedCallees: significantShared.map(shortenSymbol),\n      uniqueToA: [...difference(target.callees, candidate.callees)].map(shortenSymbol),\n      uniqueToB: [...difference(candidate.callees, target.callees)].map(shortenSymbol),\n    });\n  }\n\n  results.sort((a, b) => b.similarity - a.similarity);\n  return results.slice(0, limit);\n}\n\n/**\n * Find similar symbols across the entire codebase.\n * Uses TF-IDF weighted similarity to filter out infrastructure noise.\n */\nexport function similarAll(\n  db: ScipDatabase,\n  opts: { minSimilarity?: number; limit?: number; scope?: string; minCallees?: number } = {},\n): SimilarSymbolResult[] {\n  const { minSimilarity = 0.5, limit = 20, scope, minCallees = 4 } = opts;\n\n  const all = getAllCalleeFingerprints(db, { minCallees, scope });\n  const idfWeights = computeIdf(all);\n\n  const results: SimilarSymbolResult[] = [];\n\n  for (let i = 0; i < all.length; i++) {\n    for (let j = i + 1; j < all.length; j++) {\n      const a = all[i]!;\n      const b = all[j]!;\n\n      if (a.file === b.file) continue;\n\n      const { similarity, significantShared } = weightedSimilarity(\n        a.callees, b.callees, idfWeights,\n      );\n\n      if (similarity < minSimilarity) continue;\n      if (significantShared.length < 2) continue;\n\n      results.push({\n        symbolA: a.symbol,\n        shortNameA: shortenSymbol(a.symbol),\n        fileA: a.file,\n        symbolB: b.symbol,\n        shortNameB: shortenSymbol(b.symbol),\n        fileB: b.file,\n        similarity,\n        sharedCallees: significantShared.map(shortenSymbol),\n        uniqueToA: [...difference(a.callees, b.callees)].map(shortenSymbol),\n        uniqueToB: [...difference(b.callees, a.callees)].map(shortenSymbol),\n      });\n    }\n\n    if (results.length > limit * 5) break;\n  }\n\n  results.sort((a, b) => b.similarity - a.similarity);\n  return results.slice(0, limit);\n}\n\n// ── TF-IDF Engine ──────────────────────────────────────────\n\n/**\n * Compute inverse document frequency for each callee.\n * IDF(callee) = log(N / df(callee)) where N is total functions\n * and df is how many functions reference that callee.\n *\n * High IDF = rare callee = strong similarity signal.\n * Low IDF = ubiquitous callee = noise.\n */\nfunction computeIdf(fingerprints: SymbolFingerprint[]): Map<string, number> {\n  const n = fingerprints.length;\n  if (n === 0) return new Map();\n\n  // Count how many functions reference each callee\n  const docFreq = new Map<string, number>();\n  for (const fp of fingerprints) {\n    for (const callee of fp.callees) {\n      docFreq.set(callee, (docFreq.get(callee) ?? 0) + 1);\n    }\n  }\n\n  // Compute IDF\n  const idf = new Map<string, number>();\n  for (const [callee, df] of docFreq) {\n    idf.set(callee, Math.log(n / df));\n  }\n\n  return idf;\n}\n\n/**\n * Compute TF-IDF weighted cosine similarity between two callee sets.\n *\n * Each callee is a dimension. Its weight is its IDF score.\n * Cosine similarity of the weighted vectors gives a similarity\n * that ignores ubiquitous callees and emphasizes rare shared ones.\n *\n * Also returns which shared callees are \"significant\" (above-median IDF)\n * vs \"trivial\" (below-median IDF, i.e., infrastructure).\n */\nfunction weightedSimilarity(\n  a: Set<string>,\n  b: Set<string>,\n  idf: Map<string, number>,\n): { similarity: number; significantShared: string[]; trivialShared: string[] } {\n  const shared = intersection(a, b);\n  if (shared.size === 0) return { similarity: 0, significantShared: [], trivialShared: [] };\n\n  // Compute weighted dot product and magnitudes\n  let dotProduct = 0;\n  let magA = 0;\n  let magB = 0;\n\n  const allCallees = new Set([...a, ...b]);\n  for (const callee of allCallees) {\n    const weight = idf.get(callee) ?? 0;\n    const inA = a.has(callee) ? weight : 0;\n    const inB = b.has(callee) ? weight : 0;\n    dotProduct += inA * inB;\n    magA += inA * inA;\n    magB += inB * inB;\n  }\n\n  const magnitude = Math.sqrt(magA) * Math.sqrt(magB);\n  const similarity = magnitude > 0 ? dotProduct / magnitude : 0;\n\n  // Split shared callees into significant (high IDF) and trivial (low IDF)\n  const medianIdf = getMedianIdf(idf);\n  const significantShared: string[] = [];\n  const trivialShared: string[] = [];\n\n  for (const callee of shared) {\n    const weight = idf.get(callee) ?? 0;\n    if (weight >= medianIdf) {\n      significantShared.push(callee);\n    } else {\n      trivialShared.push(callee);\n    }\n  }\n\n  // Sort significant callees by IDF descending (most distinctive first)\n  significantShared.sort((x, y) => (idf.get(y) ?? 0) - (idf.get(x) ?? 0));\n\n  return { similarity, significantShared, trivialShared };\n}\n\nfunction getMedianIdf(idf: Map<string, number>): number {\n  const values = [...idf.values()].sort((a, b) => a - b);\n  if (values.length === 0) return 0;\n  const mid = Math.floor(values.length / 2);\n  return values.length % 2 === 0\n    ? (values[mid - 1]! + values[mid]!) / 2\n    : values[mid]!;\n}\n\n// ── Internal helpers ───────────────────────────────────────\n\ninterface SymbolFingerprint {\n  symbol: string;\n  file: string;\n  callees: Set<string>;\n}\n\nfunction findCallees(\n  db: ScipDatabase,\n  symbolPattern: string,\n): SymbolFingerprint | null {\n  const target = findFirstSymbolMatch(db, symbolPattern);\n\n  if (!target) return null;\n\n  const calleeRows = getCalleeRowsForSymbol(db, target);\n\n  return {\n    symbol: target.symbol,\n    file: target.relativePath,\n    callees: new Set(calleeRows.map((r) => r.symbol)),\n  };\n}\n\nfunction getAllCalleeFingerprints(\n  db: ScipDatabase,\n  opts: { minCallees: number; scope?: string; excludeSymbol?: string },\n): SymbolFingerprint[] {\n  const { minCallees, scope, excludeSymbol } = opts;\n  const scopeFilter = scope ? `AND d.relative_path LIKE '%${scope}%'` : '';\n  const excludeFilter = excludeSymbol ? `AND gs.symbol != '${excludeSymbol.replace(/'/g, \"''\")}'` : '';\n\n  const symbols = db.all<{\n    id: number;\n    symbol: string;\n    document_id: number;\n    start_line: number;\n    end_line: number;\n    relative_path: string;\n  }>(\n    `SELECT gs.id, gs.symbol, der.document_id, der.start_line, der.end_line, 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      ${db.symbolNoiseFor('gs')}\n      AND (der.end_line - der.start_line + 1) >= 5\n      ${scopeFilter}\n      ${excludeFilter}\n    ORDER BY d.relative_path`,\n  );\n\n  const fingerprints: SymbolFingerprint[] = [];\n\n  for (const sym of symbols) {\n    if (db.isIgnored(sym.relative_path)) continue;\n\n    const calleeRows = getCalleeRowsForSymbol(db, {\n      documentId: sym.document_id,\n      startLine: sym.start_line,\n      endLine: sym.end_line,\n      symbolId: sym.id,\n    });\n\n    const callees = new Set(calleeRows.map((r) => r.symbol));\n    if (callees.size >= minCallees) {\n      fingerprints.push({ symbol: sym.symbol, file: sym.relative_path, callees });\n    }\n  }\n\n  return fingerprints;\n}\n\nfunction intersection<T>(a: Set<T>, b: Set<T>): Set<T> {\n  const result = new Set<T>();\n  for (const item of a) {\n    if (b.has(item)) result.add(item);\n  }\n  return result;\n}\n\nfunction difference<T>(a: Set<T>, b: Set<T>): Set<T> {\n  const result = new Set<T>();\n  for (const item of a) {\n    if (!b.has(item)) result.add(item);\n  }\n  return result;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-UNTPVD36.js

@@ -0,0 +1,55 @@
+import {
+  findFirstSymbolMatch,
+  getCalleeRowsForSymbol
+} from "./chunk-FUHJCHS4.js";
+import {
+  shortenSymbol
+} from "./chunk-QOV2R2WT.js";
+
+// src/queries/call-graph.ts
+function callGraph(db, symbolPattern) {
+  const target = findFirstSymbolMatch(db, symbolPattern);
+  if (!target) return null;
+  const callerRows = db.all(
+    `SELECT DISTINCT caller_gs.symbol AS caller_symbol, caller_d.relative_path AS caller_file
+    FROM mentions m
+    JOIN chunks c ON m.chunk_id = c.id
+    JOIN documents ref_d ON c.document_id = ref_d.id
+    -- Find the enclosing symbol for where the reference appears
+    JOIN defn_enclosing_ranges caller_der
+      ON caller_der.document_id = ref_d.id
+      AND c.start_line >= caller_der.start_line
+      AND c.end_line <= caller_der.end_line
+    JOIN global_symbols caller_gs ON caller_der.symbol_id = caller_gs.id
+    JOIN documents caller_d ON caller_der.document_id = caller_d.id
+    WHERE m.symbol_id = ?
+      AND m.role = 0
+      AND caller_gs.id != ?
+      ${db.symbolNoiseFor("caller_gs")}
+      ${db.pathExclusionsFor("caller_d")}
+    ORDER BY caller_d.relative_path
+    LIMIT 50`,
+    target.symbolId,
+    target.symbolId
+  );
+  const calleeRows = getCalleeRowsForSymbol(db, target, { limit: 50 });
+  return {
+    symbol: target.symbol,
+    shortName: shortenSymbol(target.symbol),
+    callers: callerRows.filter((r) => !db.isIgnored(r.caller_file)).map((r) => ({
+      symbol: r.caller_symbol,
+      shortName: shortenSymbol(r.caller_symbol),
+      file: r.caller_file
+    })),
+    callees: calleeRows.map((r) => ({
+      symbol: r.symbol,
+      shortName: shortenSymbol(r.symbol),
+      file: r.file
+    }))
+  };
+}
+
+export {
+  callGraph
+};
+//# sourceMappingURL=chunk-UNTPVD36.js.map

package/dist/chunk-UNTPVD36.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queries/call-graph.ts"],"sourcesContent":["import type { ScipDatabase } from '../db.js';\nimport { findFirstSymbolMatch, getCalleeRowsForSymbol } from '../query-support.js';\nimport type { CallGraphResult } from '../types.js';\nimport { shortenSymbol } from '../symbol-parser.js';\n\n/**\n * Build a call graph for a symbol: who calls it (incoming) and\n * what it calls (outgoing).\n *\n * Incoming: other symbols whose definition ranges contain a reference to this symbol.\n * Outgoing: symbols referenced within this symbol's definition range.\n */\nexport function callGraph(db: ScipDatabase, symbolPattern: string): CallGraphResult | null {\n  // Find the target symbol and its definition range\n  const target = findFirstSymbolMatch(db, symbolPattern);\n\n  if (!target) return null;\n\n  // CALLERS: symbols whose definition ranges contain a reference to our target.\n  // Find chunks that reference our symbol, then find which symbol's definition encloses that chunk.\n  const callerRows = db.all<{\n    caller_symbol: string;\n    caller_file: string;\n  }>(\n    `SELECT DISTINCT caller_gs.symbol AS caller_symbol, caller_d.relative_path AS caller_file\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    -- Find the enclosing symbol for where the reference appears\n    JOIN defn_enclosing_ranges caller_der\n      ON caller_der.document_id = ref_d.id\n      AND c.start_line >= caller_der.start_line\n      AND c.end_line <= caller_der.end_line\n    JOIN global_symbols caller_gs ON caller_der.symbol_id = caller_gs.id\n    JOIN documents caller_d ON caller_der.document_id = caller_d.id\n    WHERE m.symbol_id = ?\n      AND m.role = 0\n      AND caller_gs.id != ?\n      ${db.symbolNoiseFor('caller_gs')}\n      ${db.pathExclusionsFor('caller_d')}\n    ORDER BY caller_d.relative_path\n    LIMIT 50`,\n    target.symbolId, target.symbolId,\n  );\n\n  // CALLEES: symbols referenced within our target's definition range.\n  const calleeRows = getCalleeRowsForSymbol(db, target, { limit: 50 });\n\n  return {\n    symbol: target.symbol,\n    shortName: shortenSymbol(target.symbol),\n    callers: callerRows\n      .filter((r) => !db.isIgnored(r.caller_file))\n      .map((r) => ({\n        symbol: r.caller_symbol,\n        shortName: shortenSymbol(r.caller_symbol),\n        file: r.caller_file,\n      })),\n    callees: calleeRows\n      .map((r) => ({\n        symbol: r.symbol,\n        shortName: shortenSymbol(r.symbol),\n        file: r.file,\n      })),\n  };\n}\n"],"mappings":";;;;;;;;;AAYO,SAAS,UAAU,IAAkB,eAA+C;AAEzF,QAAM,SAAS,qBAAqB,IAAI,aAAa;AAErD,MAAI,CAAC,OAAQ,QAAO;AAIpB,QAAM,aAAa,GAAG;AAAA,IAIpB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAcI,GAAG,eAAe,WAAW,CAAC;AAAA,QAC9B,GAAG,kBAAkB,UAAU,CAAC;AAAA;AAAA;AAAA,IAGpC,OAAO;AAAA,IAAU,OAAO;AAAA,EAC1B;AAGA,QAAM,aAAa,uBAAuB,IAAI,QAAQ,EAAE,OAAO,GAAG,CAAC;AAEnE,SAAO;AAAA,IACL,QAAQ,OAAO;AAAA,IACf,WAAW,cAAc,OAAO,MAAM;AAAA,IACtC,SAAS,WACN,OAAO,CAAC,MAAM,CAAC,GAAG,UAAU,EAAE,WAAW,CAAC,EAC1C,IAAI,CAAC,OAAO;AAAA,MACX,QAAQ,EAAE;AAAA,MACV,WAAW,cAAc,EAAE,aAAa;AAAA,MACxC,MAAM,EAAE;AAAA,IACV,EAAE;AAAA,IACJ,SAAS,WACN,IAAI,CAAC,OAAO;AAAA,MACX,QAAQ,EAAE;AAAA,MACV,WAAW,cAAc,EAAE,MAAM;AAAA,MACjC,MAAM,EAAE;AAAA,IACV,EAAE;AAAA,EACN;AACF;","names":[]}

package/dist/chunk-VRUJH4BO.js

@@ -0,0 +1,88 @@
+import {
+  TEST_FILE_PATTERNS,
+  testFileMatchSql
+} from "./chunk-FUHJCHS4.js";
+import {
+  shortenSymbol
+} from "./chunk-QOV2R2WT.js";
+
+// src/queries/change-surface.ts
+function changeSurface(db, filePattern) {
+  const doc = db.get(
+    `SELECT id, relative_path FROM documents
+     WHERE relative_path LIKE ?
+       ${db.pathExclusionsFor("documents")}
+     LIMIT 1`,
+    `%${filePattern}%`
+  );
+  if (!doc || db.isIgnored(doc.relative_path)) return null;
+  const syms = db.all(
+    `SELECT DISTINCT gs.id AS symbol_id, gs.symbol, der.start_line, der.end_line
+    FROM defn_enclosing_ranges der
+    JOIN global_symbols gs ON der.symbol_id = gs.id
+    WHERE der.document_id = ?
+      ${db.symbolNoiseFor("gs")}
+    ORDER BY der.start_line`,
+    doc.id
+  );
+  const testPatternSql = testFileMatchSql("ref_d", TEST_FILE_PATTERNS);
+  const symbols = [];
+  let totalExternalConsumers = 0;
+  let coveredCount = 0;
+  for (const sym of syms) {
+    const consumerRow = db.get(
+      `SELECT COUNT(DISTINCT c.document_id) AS consumer_count
+      FROM mentions m
+      JOIN chunks c ON m.chunk_id = c.id
+      WHERE m.symbol_id = ?
+        AND m.role = 0
+        AND c.document_id != ?`,
+      sym.symbol_id,
+      doc.id
+    );
+    const externalConsumers = consumerRow?.consumer_count ?? 0;
+    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`,
+      sym.symbol_id
+    ).map((r) => r.relative_path);
+    const hasTests = testFiles.length > 0;
+    if (hasTests) coveredCount++;
+    let riskLevel;
+    if (externalConsumers > 10 && !hasTests) {
+      riskLevel = "high";
+    } else if (externalConsumers > 5 || !hasTests) {
+      riskLevel = "medium";
+    } else {
+      riskLevel = "low";
+    }
+    totalExternalConsumers += externalConsumers;
+    symbols.push({
+      symbol: sym.symbol,
+      shortName: shortenSymbol(sym.symbol),
+      startLine: sym.start_line,
+      endLine: sym.end_line,
+      externalConsumers,
+      testFiles,
+      riskLevel
+    });
+  }
+  const testCoveragePercent = symbols.length > 0 ? Math.round(coveredCount / symbols.length * 100) : 0;
+  return {
+    file: doc.relative_path,
+    symbols,
+    totalExternalConsumers,
+    testCoveragePercent
+  };
+}
+
+export {
+  changeSurface
+};
+//# sourceMappingURL=chunk-VRUJH4BO.js.map