scip-query 0.1.0

package/dist/chunk-VRUJH4BO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queries/change-surface.ts"],"sourcesContent":["import type { ScipDatabase } from '../db.js';\nimport { TEST_FILE_PATTERNS, testFileMatchSql } from '../query-support.js';\nimport type { ChangeSurfaceEntry, ChangeSurfaceResult } from '../types.js';\nimport { shortenSymbol } from '../symbol-parser.js';\n\n/**\n * Pre-change briefing for a file. For each symbol defined in the file,\n * reports external consumer count, test coverage, and risk level.\n */\nexport function changeSurface(\n  db: ScipDatabase,\n  filePattern: string,\n): ChangeSurfaceResult | null {\n  // Find the file\n  const doc = db.get<{ id: number; relative_path: string }>(\n    `SELECT id, relative_path FROM documents\n     WHERE relative_path LIKE ?\n       ${db.pathExclusionsFor('documents')}\n     LIMIT 1`,\n    `%${filePattern}%`,\n  );\n\n  if (!doc || db.isIgnored(doc.relative_path)) return null;\n\n  // Get all symbols defined in this file, excluding typeLiterals\n  const syms = db.all<{\n    symbol_id: number;\n    symbol: string;\n    start_line: number;\n    end_line: number;\n  }>(\n    `SELECT DISTINCT gs.id AS symbol_id, gs.symbol, der.start_line, der.end_line\n    FROM defn_enclosing_ranges der\n    JOIN global_symbols gs ON der.symbol_id = gs.id\n    WHERE der.document_id = ?\n      ${db.symbolNoiseFor('gs')}\n    ORDER BY der.start_line`,\n    doc.id,\n  );\n\n  const testPatternSql = testFileMatchSql('ref_d', TEST_FILE_PATTERNS);\n\n  const symbols: ChangeSurfaceEntry[] = [];\n  let totalExternalConsumers = 0;\n  let coveredCount = 0;\n\n  for (const sym of syms) {\n    // Count external consumers: mentions with role=0 from different documents\n    const consumerRow = db.get<{ consumer_count: number }>(\n      `SELECT COUNT(DISTINCT c.document_id) AS consumer_count\n      FROM mentions m\n      JOIN chunks c ON m.chunk_id = c.id\n      WHERE m.symbol_id = ?\n        AND m.role = 0\n        AND c.document_id != ?`,\n      sym.symbol_id,\n      doc.id,\n    );\n\n    const externalConsumers = consumerRow?.consumer_count ?? 0;\n\n    // Find test files that reference this symbol\n    const testFiles = db.all<{ relative_path: string }>(\n      `SELECT DISTINCT ref_d.relative_path\n      FROM mentions m\n      JOIN chunks c ON m.chunk_id = c.id\n      JOIN documents ref_d ON c.document_id = ref_d.id\n      WHERE m.symbol_id = ?\n        AND m.role = 0\n        AND (${testPatternSql})\n      ORDER BY ref_d.relative_path`,\n      sym.symbol_id,\n    ).map((r) => r.relative_path);\n\n    const hasTests = testFiles.length > 0;\n    if (hasTests) coveredCount++;\n\n    // Risk level determination\n    let riskLevel: 'low' | 'medium' | 'high';\n    if (externalConsumers > 10 && !hasTests) {\n      riskLevel = 'high';\n    } else if (externalConsumers > 5 || !hasTests) {\n      riskLevel = 'medium';\n    } else {\n      riskLevel = 'low';\n    }\n\n    totalExternalConsumers += externalConsumers;\n\n    symbols.push({\n      symbol: sym.symbol,\n      shortName: shortenSymbol(sym.symbol),\n      startLine: sym.start_line,\n      endLine: sym.end_line,\n      externalConsumers,\n      testFiles,\n      riskLevel,\n    });\n  }\n\n  const testCoveragePercent =\n    symbols.length > 0 ? Math.round((coveredCount / symbols.length) * 100) : 0;\n\n  return {\n    file: doc.relative_path,\n    symbols,\n    totalExternalConsumers,\n    testCoveragePercent,\n  };\n}\n"],"mappings":";;;;;;;;;AASO,SAAS,cACd,IACA,aAC4B;AAE5B,QAAM,MAAM,GAAG;AAAA,IACb;AAAA;AAAA,SAEK,GAAG,kBAAkB,WAAW,CAAC;AAAA;AAAA,IAEtC,IAAI,WAAW;AAAA,EACjB;AAEA,MAAI,CAAC,OAAO,GAAG,UAAU,IAAI,aAAa,EAAG,QAAO;AAGpD,QAAM,OAAO,GAAG;AAAA,IAMd;AAAA;AAAA;AAAA;AAAA,QAII,GAAG,eAAe,IAAI,CAAC;AAAA;AAAA,IAE3B,IAAI;AAAA,EACN;AAEA,QAAM,iBAAiB,iBAAiB,SAAS,kBAAkB;AAEnE,QAAM,UAAgC,CAAC;AACvC,MAAI,yBAAyB;AAC7B,MAAI,eAAe;AAEnB,aAAW,OAAO,MAAM;AAEtB,UAAM,cAAc,GAAG;AAAA,MACrB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAMA,IAAI;AAAA,MACJ,IAAI;AAAA,IACN;AAEA,UAAM,oBAAoB,aAAa,kBAAkB;AAGzD,UAAM,YAAY,GAAG;AAAA,MACnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,eAMS,cAAc;AAAA;AAAA,MAEvB,IAAI;AAAA,IACN,EAAE,IAAI,CAAC,MAAM,EAAE,aAAa;AAE5B,UAAM,WAAW,UAAU,SAAS;AACpC,QAAI,SAAU;AAGd,QAAI;AACJ,QAAI,oBAAoB,MAAM,CAAC,UAAU;AACvC,kBAAY;AAAA,IACd,WAAW,oBAAoB,KAAK,CAAC,UAAU;AAC7C,kBAAY;AAAA,IACd,OAAO;AACL,kBAAY;AAAA,IACd;AAEA,8BAA0B;AAE1B,YAAQ,KAAK;AAAA,MACX,QAAQ,IAAI;AAAA,MACZ,WAAW,cAAc,IAAI,MAAM;AAAA,MACnC,WAAW,IAAI;AAAA,MACf,SAAS,IAAI;AAAA,MACb;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AAEA,QAAM,sBACJ,QAAQ,SAAS,IAAI,KAAK,MAAO,eAAe,QAAQ,SAAU,GAAG,IAAI;AAE3E,SAAO;AAAA,IACL,MAAM,IAAI;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-VZ7AMAFL.js

@@ -0,0 +1,76 @@
+import {
+  findFirstSymbolMatch
+} from "./chunk-FUHJCHS4.js";
+import {
+  shortenSymbol
+} from "./chunk-QOV2R2WT.js";
+
+// src/queries/code.ts
+import { readFileSync } from "fs";
+import { join } from "path";
+function code(db, symbolPattern, opts = {}) {
+  const { context = 0 } = opts;
+  const fileLineMatch = symbolPattern.match(/^(.+\.\w+):(\d+)-(\d+)$/);
+  if (fileLineMatch) {
+    return readFileRange(db, fileLineMatch[1], parseInt(fileLineMatch[2], 10), parseInt(fileLineMatch[3], 10), context);
+  }
+  const match = findFirstSymbolMatch(db, symbolPattern);
+  if (!match) return null;
+  const doc = db.get(
+    `SELECT language FROM documents WHERE relative_path = ?`,
+    match.relativePath
+  );
+  const filePath = join(db.config.projectRoot, match.relativePath);
+  let fileContent;
+  try {
+    fileContent = readFileSync(filePath, "utf-8");
+  } catch {
+    return null;
+  }
+  const lines = fileContent.split("\n");
+  const startLine = Math.max(0, match.startLine - context);
+  const endLine = Math.min(lines.length - 1, match.endLine + context);
+  const source = lines.slice(startLine, endLine + 1).join("\n");
+  return {
+    symbol: match.symbol,
+    shortName: shortenSymbol(match.symbol),
+    relativePath: match.relativePath,
+    startLine: startLine + 1,
+    // 1-indexed for display
+    endLine: endLine + 1,
+    language: doc?.language ?? null,
+    source
+  };
+}
+function readFileRange(db, filePath, startLine, endLine, context) {
+  const doc = db.get(
+    `SELECT relative_path, language FROM documents WHERE relative_path LIKE ?`,
+    `%${filePath}%`
+  );
+  if (!doc) return null;
+  const fullPath = join(db.config.projectRoot, doc.relative_path);
+  let fileContent;
+  try {
+    fileContent = readFileSync(fullPath, "utf-8");
+  } catch {
+    return null;
+  }
+  const lines = fileContent.split("\n");
+  const start = Math.max(0, startLine - 1 - context);
+  const end = Math.min(lines.length - 1, endLine - 1 + context);
+  const source = lines.slice(start, end + 1).join("\n");
+  return {
+    symbol: `${doc.relative_path}:${startLine}-${endLine}`,
+    shortName: `${doc.relative_path}:${startLine}-${endLine}`,
+    relativePath: doc.relative_path,
+    startLine: start + 1,
+    endLine: end + 1,
+    language: doc.language,
+    source
+  };
+}
+
+export {
+  code
+};
+//# sourceMappingURL=chunk-VZ7AMAFL.js.map

package/dist/chunk-VZ7AMAFL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queries/code.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport type { ScipDatabase } from '../db.js';\nimport { findFirstSymbolMatch } from '../query-support.js';\nimport type { CodeResult } from '../types.js';\nimport { shortenSymbol } from '../symbol-parser.js';\n\n/**\n * Read the source code for a symbol, bounded to its definition range.\n * Language-agnostic: just reads the file and extracts the relevant lines.\n *\n * Accepts:\n *   - Symbol name pattern: \"processVegaMention\"\n *   - Full short name: \"src:modules:chat:processVegaMention\"\n *   - File:line-line syntax: \"src/chat/service.ts:100-200\"\n */\nexport function code(\n  db: ScipDatabase,\n  symbolPattern: string,\n  opts: { context?: number } = {},\n): CodeResult | null {\n  const { context = 0 } = opts;\n\n  // Handle direct file:line-line syntax (bypass symbol lookup)\n  const fileLineMatch = symbolPattern.match(/^(.+\\.\\w+):(\\d+)-(\\d+)$/);\n  if (fileLineMatch) {\n    return readFileRange(db, fileLineMatch[1]!, parseInt(fileLineMatch[2]!, 10), parseInt(fileLineMatch[3]!, 10), context);\n  }\n\n  const match = findFirstSymbolMatch(db, symbolPattern);\n  if (!match) return null;\n\n  // Get the language from the documents table\n  const doc = db.get<{ language: string | null }>(\n    `SELECT language FROM documents WHERE relative_path = ?`,\n    match.relativePath,\n  );\n\n  // Read the file\n  const filePath = join(db.config.projectRoot, match.relativePath);\n  let fileContent: string;\n  try {\n    fileContent = readFileSync(filePath, 'utf-8');\n  } catch {\n    return null;\n  }\n\n  const lines = fileContent.split('\\n');\n  const startLine = Math.max(0, match.startLine - context);\n  const endLine = Math.min(lines.length - 1, match.endLine + context);\n  const source = lines.slice(startLine, endLine + 1).join('\\n');\n\n  return {\n    symbol: match.symbol,\n    shortName: shortenSymbol(match.symbol),\n    relativePath: match.relativePath,\n    startLine: startLine + 1, // 1-indexed for display\n    endLine: endLine + 1,\n    language: doc?.language ?? null,\n    source,\n  };\n}\n\n/** Read source by file path and line range directly (no symbol lookup) */\nfunction readFileRange(\n  db: ScipDatabase,\n  filePath: string,\n  startLine: number,\n  endLine: number,\n  context: number,\n): CodeResult | null {\n  // Find the file in the index\n  const doc = db.get<{ relative_path: string; language: string | null }>(\n    `SELECT relative_path, language FROM documents WHERE relative_path LIKE ?`,\n    `%${filePath}%`,\n  );\n  if (!doc) return null;\n\n  const fullPath = join(db.config.projectRoot, doc.relative_path);\n  let fileContent: string;\n  try {\n    fileContent = readFileSync(fullPath, 'utf-8');\n  } catch {\n    return null;\n  }\n\n  const lines = fileContent.split('\\n');\n  const start = Math.max(0, startLine - 1 - context); // convert to 0-indexed\n  const end = Math.min(lines.length - 1, endLine - 1 + context);\n  const source = lines.slice(start, end + 1).join('\\n');\n\n  return {\n    symbol: `${doc.relative_path}:${startLine}-${endLine}`,\n    shortName: `${doc.relative_path}:${startLine}-${endLine}`,\n    relativePath: doc.relative_path,\n    startLine: start + 1,\n    endLine: end + 1,\n    language: doc.language,\n    source,\n  };\n}\n"],"mappings":";;;;;;;;AAAA,SAAS,oBAAoB;AAC7B,SAAS,YAAY;AAed,SAAS,KACd,IACA,eACA,OAA6B,CAAC,GACX;AACnB,QAAM,EAAE,UAAU,EAAE,IAAI;AAGxB,QAAM,gBAAgB,cAAc,MAAM,yBAAyB;AACnE,MAAI,eAAe;AACjB,WAAO,cAAc,IAAI,cAAc,CAAC,GAAI,SAAS,cAAc,CAAC,GAAI,EAAE,GAAG,SAAS,cAAc,CAAC,GAAI,EAAE,GAAG,OAAO;AAAA,EACvH;AAEA,QAAM,QAAQ,qBAAqB,IAAI,aAAa;AACpD,MAAI,CAAC,MAAO,QAAO;AAGnB,QAAM,MAAM,GAAG;AAAA,IACb;AAAA,IACA,MAAM;AAAA,EACR;AAGA,QAAM,WAAW,KAAK,GAAG,OAAO,aAAa,MAAM,YAAY;AAC/D,MAAI;AACJ,MAAI;AACF,kBAAc,aAAa,UAAU,OAAO;AAAA,EAC9C,QAAQ;AACN,WAAO;AAAA,EACT;AAEA,QAAM,QAAQ,YAAY,MAAM,IAAI;AACpC,QAAM,YAAY,KAAK,IAAI,GAAG,MAAM,YAAY,OAAO;AACvD,QAAM,UAAU,KAAK,IAAI,MAAM,SAAS,GAAG,MAAM,UAAU,OAAO;AAClE,QAAM,SAAS,MAAM,MAAM,WAAW,UAAU,CAAC,EAAE,KAAK,IAAI;AAE5D,SAAO;AAAA,IACL,QAAQ,MAAM;AAAA,IACd,WAAW,cAAc,MAAM,MAAM;AAAA,IACrC,cAAc,MAAM;AAAA,IACpB,WAAW,YAAY;AAAA;AAAA,IACvB,SAAS,UAAU;AAAA,IACnB,UAAU,KAAK,YAAY;AAAA,IAC3B;AAAA,EACF;AACF;AAGA,SAAS,cACP,IACA,UACA,WACA,SACA,SACmB;AAEnB,QAAM,MAAM,GAAG;AAAA,IACb;AAAA,IACA,IAAI,QAAQ;AAAA,EACd;AACA,MAAI,CAAC,IAAK,QAAO;AAEjB,QAAM,WAAW,KAAK,GAAG,OAAO,aAAa,IAAI,aAAa;AAC9D,MAAI;AACJ,MAAI;AACF,kBAAc,aAAa,UAAU,OAAO;AAAA,EAC9C,QAAQ;AACN,WAAO;AAAA,EACT;AAEA,QAAM,QAAQ,YAAY,MAAM,IAAI;AACpC,QAAM,QAAQ,KAAK,IAAI,GAAG,YAAY,IAAI,OAAO;AACjD,QAAM,MAAM,KAAK,IAAI,MAAM,SAAS,GAAG,UAAU,IAAI,OAAO;AAC5D,QAAM,SAAS,MAAM,MAAM,OAAO,MAAM,CAAC,EAAE,KAAK,IAAI;AAEpD,SAAO;AAAA,IACL,QAAQ,GAAG,IAAI,aAAa,IAAI,SAAS,IAAI,OAAO;AAAA,IACpD,WAAW,GAAG,IAAI,aAAa,IAAI,SAAS,IAAI,OAAO;AAAA,IACvD,cAAc,IAAI;AAAA,IAClB,WAAW,QAAQ;AAAA,IACnB,SAAS,MAAM;AAAA,IACf,UAAU,IAAI;AAAA,IACd;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-XFXDXEUN.js

@@ -0,0 +1,24 @@
+// src/queries/stats.ts
+function stats(db) {
+  const documents = db.get("SELECT COUNT(*) as c FROM documents").c;
+  const symbols = db.get("SELECT COUNT(*) as c FROM global_symbols").c;
+  const definitions = db.get(
+    "SELECT COUNT(*) as c FROM mentions WHERE role = 1"
+  ).c;
+  const references = db.get(
+    "SELECT COUNT(*) as c FROM mentions WHERE role = 0"
+  ).c;
+  return {
+    documents,
+    symbols,
+    definitions,
+    references,
+    indexSizeBytes: db.sizeBytes(),
+    lastBuilt: db.lastModified()
+  };
+}
+
+export {
+  stats
+};
+//# sourceMappingURL=chunk-XFXDXEUN.js.map

package/dist/chunk-XFXDXEUN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queries/stats.ts"],"sourcesContent":["import type { ScipDatabase } from '../db.js';\nimport type { StatsResult } from '../types.js';\n\nexport function stats(db: ScipDatabase): StatsResult {\n  const documents = db.get<{ c: number }>('SELECT COUNT(*) as c FROM documents')!.c;\n  const symbols = db.get<{ c: number }>('SELECT COUNT(*) as c FROM global_symbols')!.c;\n  const definitions = db.get<{ c: number }>(\n    'SELECT COUNT(*) as c FROM mentions WHERE role = 1',\n  )!.c;\n  const references = db.get<{ c: number }>(\n    'SELECT COUNT(*) as c FROM mentions WHERE role = 0',\n  )!.c;\n\n  return {\n    documents,\n    symbols,\n    definitions,\n    references,\n    indexSizeBytes: db.sizeBytes(),\n    lastBuilt: db.lastModified(),\n  };\n}\n"],"mappings":";AAGO,SAAS,MAAM,IAA+B;AACnD,QAAM,YAAY,GAAG,IAAmB,qCAAqC,EAAG;AAChF,QAAM,UAAU,GAAG,IAAmB,0CAA0C,EAAG;AACnF,QAAM,cAAc,GAAG;AAAA,IACrB;AAAA,EACF,EAAG;AACH,QAAM,aAAa,GAAG;AAAA,IACpB;AAAA,EACF,EAAG;AAEH,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,gBAAgB,GAAG,UAAU;AAAA,IAC7B,WAAW,GAAG,aAAa;AAAA,EAC7B;AACF;","names":[]}

package/dist/chunk-YZAA4LYG.js

@@ -0,0 +1,169 @@
+import {
+  TEST_FILE_PATTERNS,
+  testFileMatchSql
+} from "./chunk-FUHJCHS4.js";
+import {
+  shortenSymbol
+} from "./chunk-QOV2R2WT.js";
+
+// src/queries/diff-impact.ts
+import { execFileSync } from "child_process";
+function diffImpact(db, opts = {}) {
+  const { base = "HEAD" } = opts;
+  let changedFileLines;
+  try {
+    const stdout = execFileSync("git", ["diff", "--name-only", base], {
+      encoding: "utf-8",
+      cwd: db.config.projectRoot,
+      timeout: 1e4
+    });
+    changedFileLines = stdout.split("\n").map((l) => l.trim()).filter((l) => l.length > 0);
+  } catch {
+    return {
+      changedFiles: [],
+      changedSymbols: [],
+      affectedConsumers: [],
+      uncoveredSymbols: [],
+      summary: {
+        totalChangedFiles: 0,
+        totalChangedSymbols: 0,
+        totalAffectedFiles: 0,
+        testCoveragePercent: 0
+      }
+    };
+  }
+  if (changedFileLines.length === 0) {
+    return {
+      changedFiles: [],
+      changedSymbols: [],
+      affectedConsumers: [],
+      uncoveredSymbols: [],
+      summary: {
+        totalChangedFiles: 0,
+        totalChangedSymbols: 0,
+        totalAffectedFiles: 0,
+        testCoveragePercent: 0
+      }
+    };
+  }
+  const changedFiles = [];
+  const changedDocIds = [];
+  for (const file of changedFileLines) {
+    const doc = db.get(
+      `SELECT id, relative_path FROM documents
+       WHERE relative_path LIKE ?
+       LIMIT 1`,
+      `%${file}`
+    );
+    if (doc && !db.isIgnored(doc.relative_path)) {
+      changedFiles.push(doc.relative_path);
+      changedDocIds.push(doc.id);
+    }
+  }
+  if (changedDocIds.length === 0) {
+    return {
+      changedFiles: changedFileLines,
+      changedSymbols: [],
+      affectedConsumers: [],
+      uncoveredSymbols: [],
+      summary: {
+        totalChangedFiles: changedFileLines.length,
+        totalChangedSymbols: 0,
+        totalAffectedFiles: 0,
+        testCoveragePercent: 0
+      }
+    };
+  }
+  const docPlaceholders = changedDocIds.map(() => "?").join(",");
+  const syms = db.all(
+    `SELECT DISTINCT gs.id AS symbol_id, gs.symbol, d.relative_path
+    FROM defn_enclosing_ranges der
+    JOIN global_symbols gs ON der.symbol_id = gs.id
+    JOIN documents d ON der.document_id = d.id
+    WHERE der.document_id IN (${docPlaceholders})
+      ${db.symbolNoiseFor("gs")}
+    ORDER BY d.relative_path`,
+    ...changedDocIds
+  );
+  const testPatternSql = testFileMatchSql("ref_d", TEST_FILE_PATTERNS);
+  const changedSymbols = [];
+  const consumerMap = /* @__PURE__ */ new Map();
+  const uncoveredSymbols = [];
+  let coveredCount = 0;
+  for (const sym of syms) {
+    const fanInRow = db.get(
+      `SELECT COUNT(DISTINCT c.document_id) AS fan_in
+      FROM mentions m
+      JOIN chunks c ON m.chunk_id = c.id
+      WHERE m.symbol_id = ?
+        AND m.role = 0`,
+      sym.symbol_id
+    );
+    const fanIn = fanInRow?.fan_in ?? 0;
+    const shortName = shortenSymbol(sym.symbol);
+    changedSymbols.push({
+      symbol: sym.symbol,
+      shortName,
+      file: sym.relative_path,
+      fanIn
+    });
+    const consumers = 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 ref_d.relative_path NOT IN (${changedFiles.map(() => "?").join(",")})
+        ${db.pathExclusionsFor("ref_d")}`,
+      sym.symbol_id,
+      ...changedFiles
+    );
+    for (const consumer of consumers) {
+      if (db.isIgnored(consumer.relative_path)) continue;
+      if (!consumerMap.has(consumer.relative_path)) {
+        consumerMap.set(consumer.relative_path, /* @__PURE__ */ new Set());
+      }
+      consumerMap.get(consumer.relative_path).add(shortName);
+    }
+    const hasTest = db.get(
+      `SELECT COUNT(*) AS c
+      FROM mentions m
+      JOIN chunks c ON m.chunk_id = c.id
+      JOIN documents ref_d ON c.document_id = ref_d.id
+      WHERE m.symbol_id = ?
+        AND m.role = 0
+        AND (${testPatternSql})`,
+      sym.symbol_id
+    );
+    if (hasTest && hasTest.c > 0) {
+      coveredCount++;
+    } else {
+      uncoveredSymbols.push({
+        symbol: sym.symbol,
+        shortName,
+        file: sym.relative_path
+      });
+    }
+  }
+  const affectedConsumers = [...consumerMap.entries()].map(([file, symbols]) => ({ file, consumedSymbols: symbols.size })).sort((a, b) => b.consumedSymbols - a.consumedSymbols);
+  const totalSymbols = changedSymbols.length;
+  const testCoveragePercent = totalSymbols > 0 ? Math.round(coveredCount / totalSymbols * 100) : 0;
+  return {
+    changedFiles,
+    changedSymbols,
+    affectedConsumers,
+    uncoveredSymbols,
+    summary: {
+      totalChangedFiles: changedFiles.length,
+      totalChangedSymbols: totalSymbols,
+      totalAffectedFiles: affectedConsumers.length,
+      testCoveragePercent
+    }
+  };
+}
+
+export {
+  diffImpact
+};
+//# sourceMappingURL=chunk-YZAA4LYG.js.map

package/dist/chunk-YZAA4LYG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queries/diff-impact.ts"],"sourcesContent":["import { execFileSync } from 'node:child_process';\nimport type { ScipDatabase } from '../db.js';\nimport { TEST_FILE_PATTERNS, testFileMatchSql } from '../query-support.js';\nimport type { DiffImpactResult } from '../types.js';\nimport { shortenSymbol } from '../symbol-parser.js';\n\n/**\n * Given a git diff, compute the affected symbol set.\n * Finds all symbols defined in changed files, their fan-in,\n * the files that consume them, and test coverage gaps.\n */\nexport function diffImpact(\n  db: ScipDatabase,\n  opts: { base?: string } = {},\n): DiffImpactResult {\n  const { base = 'HEAD' } = opts;\n\n  // Get changed files from git\n  let changedFileLines: string[];\n  try {\n    const stdout = execFileSync('git', ['diff', '--name-only', base], {\n      encoding: 'utf-8',\n      cwd: db.config.projectRoot,\n      timeout: 10_000,\n    });\n    changedFileLines = stdout\n      .split('\\n')\n      .map((l) => l.trim())\n      .filter((l) => l.length > 0);\n  } catch {\n    // Not in a git repo or git not available — return empty result\n    return {\n      changedFiles: [],\n      changedSymbols: [],\n      affectedConsumers: [],\n      uncoveredSymbols: [],\n      summary: {\n        totalChangedFiles: 0,\n        totalChangedSymbols: 0,\n        totalAffectedFiles: 0,\n        testCoveragePercent: 0,\n      },\n    };\n  }\n\n  if (changedFileLines.length === 0) {\n    return {\n      changedFiles: [],\n      changedSymbols: [],\n      affectedConsumers: [],\n      uncoveredSymbols: [],\n      summary: {\n        totalChangedFiles: 0,\n        totalChangedSymbols: 0,\n        totalAffectedFiles: 0,\n        testCoveragePercent: 0,\n      },\n    };\n  }\n\n  // Match changed files against the index\n  const changedFiles: string[] = [];\n  const changedDocIds: number[] = [];\n\n  for (const file of changedFileLines) {\n    const doc = db.get<{ id: number; relative_path: string }>(\n      `SELECT id, relative_path FROM documents\n       WHERE relative_path LIKE ?\n       LIMIT 1`,\n      `%${file}`,\n    );\n    if (doc && !db.isIgnored(doc.relative_path)) {\n      changedFiles.push(doc.relative_path);\n      changedDocIds.push(doc.id);\n    }\n  }\n\n  if (changedDocIds.length === 0) {\n    return {\n      changedFiles: changedFileLines,\n      changedSymbols: [],\n      affectedConsumers: [],\n      uncoveredSymbols: [],\n      summary: {\n        totalChangedFiles: changedFileLines.length,\n        totalChangedSymbols: 0,\n        totalAffectedFiles: 0,\n        testCoveragePercent: 0,\n      },\n    };\n  }\n\n  // Get all symbols defined in changed files\n  const docPlaceholders = changedDocIds.map(() => '?').join(',');\n  const syms = db.all<{\n    symbol_id: number;\n    symbol: string;\n    relative_path: string;\n  }>(\n    `SELECT DISTINCT gs.id AS symbol_id, gs.symbol, d.relative_path\n    FROM defn_enclosing_ranges der\n    JOIN global_symbols gs ON der.symbol_id = gs.id\n    JOIN documents d ON der.document_id = d.id\n    WHERE der.document_id IN (${docPlaceholders})\n      ${db.symbolNoiseFor('gs')}\n    ORDER BY d.relative_path`,\n    ...changedDocIds,\n  );\n\n  // For each symbol, compute fan-in (distinct referencing documents)\n  const testPatternSql = testFileMatchSql('ref_d', TEST_FILE_PATTERNS);\n  const changedSymbols: DiffImpactResult['changedSymbols'] = [];\n  const consumerMap = new Map<string, Set<string>>(); // file -> set of consumed symbol shortNames\n  const uncoveredSymbols: DiffImpactResult['uncoveredSymbols'] = [];\n  let coveredCount = 0;\n\n  for (const sym of syms) {\n    // Fan-in: distinct files that reference this symbol\n    const fanInRow = db.get<{ fan_in: number }>(\n      `SELECT COUNT(DISTINCT c.document_id) AS fan_in\n      FROM mentions m\n      JOIN chunks c ON m.chunk_id = c.id\n      WHERE m.symbol_id = ?\n        AND m.role = 0`,\n      sym.symbol_id,\n    );\n\n    const fanIn = fanInRow?.fan_in ?? 0;\n    const shortName = shortenSymbol(sym.symbol);\n\n    changedSymbols.push({\n      symbol: sym.symbol,\n      shortName,\n      file: sym.relative_path,\n      fanIn,\n    });\n\n    // Collect consumer files (excluding the changed files themselves)\n    const consumers = db.all<{ relative_path: string }>(\n      `SELECT DISTINCT ref_d.relative_path\n      FROM mentions m\n      JOIN chunks c ON m.chunk_id = c.id\n      JOIN documents ref_d ON c.document_id = ref_d.id\n      WHERE m.symbol_id = ?\n        AND m.role = 0\n        AND ref_d.relative_path NOT IN (${changedFiles.map(() => '?').join(',')})\n        ${db.pathExclusionsFor('ref_d')}`,\n      sym.symbol_id,\n      ...changedFiles,\n    );\n\n    for (const consumer of consumers) {\n      if (db.isIgnored(consumer.relative_path)) continue;\n      if (!consumerMap.has(consumer.relative_path)) {\n        consumerMap.set(consumer.relative_path, new Set());\n      }\n      consumerMap.get(consumer.relative_path)!.add(shortName);\n    }\n\n    // Check test coverage\n    const hasTest = db.get<{ c: number }>(\n      `SELECT COUNT(*) AS c\n      FROM mentions m\n      JOIN chunks c ON m.chunk_id = c.id\n      JOIN documents ref_d ON c.document_id = ref_d.id\n      WHERE m.symbol_id = ?\n        AND m.role = 0\n        AND (${testPatternSql})`,\n      sym.symbol_id,\n    );\n\n    if (hasTest && hasTest.c > 0) {\n      coveredCount++;\n    } else {\n      uncoveredSymbols.push({\n        symbol: sym.symbol,\n        shortName,\n        file: sym.relative_path,\n      });\n    }\n  }\n\n  // Build affected consumers list\n  const affectedConsumers = [...consumerMap.entries()]\n    .map(([file, symbols]) => ({ file, consumedSymbols: symbols.size }))\n    .sort((a, b) => b.consumedSymbols - a.consumedSymbols);\n\n  const totalSymbols = changedSymbols.length;\n  const testCoveragePercent =\n    totalSymbols > 0 ? Math.round((coveredCount / totalSymbols) * 100) : 0;\n\n  return {\n    changedFiles,\n    changedSymbols,\n    affectedConsumers,\n    uncoveredSymbols,\n    summary: {\n      totalChangedFiles: changedFiles.length,\n      totalChangedSymbols: totalSymbols,\n      totalAffectedFiles: affectedConsumers.length,\n      testCoveragePercent,\n    },\n  };\n}\n"],"mappings":";;;;;;;;;AAAA,SAAS,oBAAoB;AAWtB,SAAS,WACd,IACA,OAA0B,CAAC,GACT;AAClB,QAAM,EAAE,OAAO,OAAO,IAAI;AAG1B,MAAI;AACJ,MAAI;AACF,UAAM,SAAS,aAAa,OAAO,CAAC,QAAQ,eAAe,IAAI,GAAG;AAAA,MAChE,UAAU;AAAA,MACV,KAAK,GAAG,OAAO;AAAA,MACf,SAAS;AAAA,IACX,CAAC;AACD,uBAAmB,OAChB,MAAM,IAAI,EACV,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EACnB,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC;AAAA,EAC/B,QAAQ;AAEN,WAAO;AAAA,MACL,cAAc,CAAC;AAAA,MACf,gBAAgB,CAAC;AAAA,MACjB,mBAAmB,CAAC;AAAA,MACpB,kBAAkB,CAAC;AAAA,MACnB,SAAS;AAAA,QACP,mBAAmB;AAAA,QACnB,qBAAqB;AAAA,QACrB,oBAAoB;AAAA,QACpB,qBAAqB;AAAA,MACvB;AAAA,IACF;AAAA,EACF;AAEA,MAAI,iBAAiB,WAAW,GAAG;AACjC,WAAO;AAAA,MACL,cAAc,CAAC;AAAA,MACf,gBAAgB,CAAC;AAAA,MACjB,mBAAmB,CAAC;AAAA,MACpB,kBAAkB,CAAC;AAAA,MACnB,SAAS;AAAA,QACP,mBAAmB;AAAA,QACnB,qBAAqB;AAAA,QACrB,oBAAoB;AAAA,QACpB,qBAAqB;AAAA,MACvB;AAAA,IACF;AAAA,EACF;AAGA,QAAM,eAAyB,CAAC;AAChC,QAAM,gBAA0B,CAAC;AAEjC,aAAW,QAAQ,kBAAkB;AACnC,UAAM,MAAM,GAAG;AAAA,MACb;AAAA;AAAA;AAAA,MAGA,IAAI,IAAI;AAAA,IACV;AACA,QAAI,OAAO,CAAC,GAAG,UAAU,IAAI,aAAa,GAAG;AAC3C,mBAAa,KAAK,IAAI,aAAa;AACnC,oBAAc,KAAK,IAAI,EAAE;AAAA,IAC3B;AAAA,EACF;AAEA,MAAI,cAAc,WAAW,GAAG;AAC9B,WAAO;AAAA,MACL,cAAc;AAAA,MACd,gBAAgB,CAAC;AAAA,MACjB,mBAAmB,CAAC;AAAA,MACpB,kBAAkB,CAAC;AAAA,MACnB,SAAS;AAAA,QACP,mBAAmB,iBAAiB;AAAA,QACpC,qBAAqB;AAAA,QACrB,oBAAoB;AAAA,QACpB,qBAAqB;AAAA,MACvB;AAAA,IACF;AAAA,EACF;AAGA,QAAM,kBAAkB,cAAc,IAAI,MAAM,GAAG,EAAE,KAAK,GAAG;AAC7D,QAAM,OAAO,GAAG;AAAA,IAKd;AAAA;AAAA;AAAA;AAAA,gCAI4B,eAAe;AAAA,QACvC,GAAG,eAAe,IAAI,CAAC;AAAA;AAAA,IAE3B,GAAG;AAAA,EACL;AAGA,QAAM,iBAAiB,iBAAiB,SAAS,kBAAkB;AACnE,QAAM,iBAAqD,CAAC;AAC5D,QAAM,cAAc,oBAAI,IAAyB;AACjD,QAAM,mBAAyD,CAAC;AAChE,MAAI,eAAe;AAEnB,aAAW,OAAO,MAAM;AAEtB,UAAM,WAAW,GAAG;AAAA,MAClB;AAAA;AAAA;AAAA;AAAA;AAAA,MAKA,IAAI;AAAA,IACN;AAEA,UAAM,QAAQ,UAAU,UAAU;AAClC,UAAM,YAAY,cAAc,IAAI,MAAM;AAE1C,mBAAe,KAAK;AAAA,MAClB,QAAQ,IAAI;AAAA,MACZ;AAAA,MACA,MAAM,IAAI;AAAA,MACV;AAAA,IACF,CAAC;AAGD,UAAM,YAAY,GAAG;AAAA,MACnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,0CAMoC,aAAa,IAAI,MAAM,GAAG,EAAE,KAAK,GAAG,CAAC;AAAA,UACrE,GAAG,kBAAkB,OAAO,CAAC;AAAA,MACjC,IAAI;AAAA,MACJ,GAAG;AAAA,IACL;AAEA,eAAW,YAAY,WAAW;AAChC,UAAI,GAAG,UAAU,SAAS,aAAa,EAAG;AAC1C,UAAI,CAAC,YAAY,IAAI,SAAS,aAAa,GAAG;AAC5C,oBAAY,IAAI,SAAS,eAAe,oBAAI,IAAI,CAAC;AAAA,MACnD;AACA,kBAAY,IAAI,SAAS,aAAa,EAAG,IAAI,SAAS;AAAA,IACxD;AAGA,UAAM,UAAU,GAAG;AAAA,MACjB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,eAMS,cAAc;AAAA,MACvB,IAAI;AAAA,IACN;AAEA,QAAI,WAAW,QAAQ,IAAI,GAAG;AAC5B;AAAA,IACF,OAAO;AACL,uBAAiB,KAAK;AAAA,QACpB,QAAQ,IAAI;AAAA,QACZ;AAAA,QACA,MAAM,IAAI;AAAA,MACZ,CAAC;AAAA,IACH;AAAA,EACF;AAGA,QAAM,oBAAoB,CAAC,GAAG,YAAY,QAAQ,CAAC,EAChD,IAAI,CAAC,CAAC,MAAM,OAAO,OAAO,EAAE,MAAM,iBAAiB,QAAQ,KAAK,EAAE,EAClE,KAAK,CAAC,GAAG,MAAM,EAAE,kBAAkB,EAAE,eAAe;AAEvD,QAAM,eAAe,eAAe;AACpC,QAAM,sBACJ,eAAe,IAAI,KAAK,MAAO,eAAe,eAAgB,GAAG,IAAI;AAEvE,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS;AAAA,MACP,mBAAmB,aAAa;AAAA,MAChC,qBAAqB;AAAA,MACrB,oBAAoB,kBAAkB;AAAA,MACtC;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-Z73NYSBZ.js

@@ -0,0 +1,92 @@
+import {
+  buildFileDepGraph
+} from "./chunk-FUHJCHS4.js";
+
+// src/queries/similar-files.ts
+function similarFiles(db, opts = {}) {
+  const { minSimilarity = 0.5, limit = 20, scope, minDeps = 3, filePattern } = opts;
+  const profiles = buildFileProfiles(db, { scope, minDeps });
+  const results = [];
+  if (filePattern) {
+    const target = profiles.find((p) => p.file.includes(filePattern));
+    if (!target) return [];
+    for (const candidate of profiles) {
+      if (candidate.file === target.file) continue;
+      const result = compareProfiles(target, candidate, minSimilarity);
+      if (result) results.push(result);
+    }
+  } else {
+    for (let i = 0; i < profiles.length; i++) {
+      for (let j = i + 1; j < profiles.length; j++) {
+        const result = compareProfiles(profiles[i], profiles[j], minSimilarity);
+        if (result) results.push(result);
+      }
+      if (results.length > limit * 5) break;
+    }
+  }
+  results.sort((a, b) => b.similarity - a.similarity);
+  return results.slice(0, limit);
+}
+function buildFileProfiles(db, opts) {
+  const { scope, minDeps } = opts;
+  const depMap = buildFileDepGraph(db, scope);
+  const universalDeps = findUniversalDependencies(depMap);
+  const profiles = [];
+  for (const [file, deps] of depMap) {
+    if (deps.size >= minDeps) {
+      profiles.push({
+        file,
+        deps: new Set([...deps].filter((dep) => !universalDeps.has(dep)))
+      });
+    }
+  }
+  return profiles;
+}
+function findUniversalDependencies(depMap) {
+  const universalDeps = /* @__PURE__ */ new Set();
+  const fileCount = depMap.size;
+  if (fileCount === 0) return universalDeps;
+  const depCounts = /* @__PURE__ */ new Map();
+  for (const deps of depMap.values()) {
+    for (const dep of deps) {
+      depCounts.set(dep, (depCounts.get(dep) ?? 0) + 1);
+    }
+  }
+  for (const [dep, count] of depCounts) {
+    if (count / fileCount > 0.5) {
+      universalDeps.add(dep);
+    }
+  }
+  return universalDeps;
+}
+function compareProfiles(a, b, minSimilarity) {
+  const shared = /* @__PURE__ */ new Set();
+  for (const dep of a.deps) {
+    if (b.deps.has(dep)) shared.add(dep);
+  }
+  if (shared.size === 0) return null;
+  const unionSize = (/* @__PURE__ */ new Set([...a.deps, ...b.deps])).size;
+  const similarity = shared.size / unionSize;
+  if (similarity < minSimilarity) return null;
+  const uniqueA = [];
+  for (const dep of a.deps) {
+    if (!b.deps.has(dep)) uniqueA.push(dep);
+  }
+  const uniqueB = [];
+  for (const dep of b.deps) {
+    if (!a.deps.has(dep)) uniqueB.push(dep);
+  }
+  return {
+    fileA: a.file,
+    fileB: b.file,
+    similarity,
+    sharedDeps: [...shared],
+    uniqueToA: uniqueA,
+    uniqueToB: uniqueB
+  };
+}
+
+export {
+  similarFiles
+};
+//# sourceMappingURL=chunk-Z73NYSBZ.js.map

package/dist/chunk-Z73NYSBZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queries/similar-files.ts"],"sourcesContent":["import type { ScipDatabase } from '../db.js';\nimport { buildFileDepGraph } from '../query-support.js';\nimport type { SimilarFileResult } from '../types.js';\n\n/**\n * Find files with similar dependency profiles.\n *\n * Two files that depend on (import from) the same set of other files\n * are structurally doing similar work. High Jaccard similarity between\n * their dependency sets = likely copy-paste variants or consolidation candidates.\n */\nexport function similarFiles(\n  db: ScipDatabase,\n  opts: {\n    minSimilarity?: number;\n    limit?: number;\n    scope?: string;\n    minDeps?: number;\n    filePattern?: string;\n  } = {},\n): SimilarFileResult[] {\n  const { minSimilarity = 0.5, limit = 20, scope, minDeps = 3, filePattern } = opts;\n\n  // Build dependency profile for each file\n  const profiles = buildFileProfiles(db, { scope, minDeps });\n\n  const results: SimilarFileResult[] = [];\n\n  if (filePattern) {\n    // Compare one file against all others\n    const target = profiles.find((p) => p.file.includes(filePattern));\n    if (!target) return [];\n\n    for (const candidate of profiles) {\n      if (candidate.file === target.file) continue;\n      const result = compareProfiles(target, candidate, minSimilarity);\n      if (result) results.push(result);\n    }\n  } else {\n    // Pairwise comparison across all files\n    for (let i = 0; i < profiles.length; i++) {\n      for (let j = i + 1; j < profiles.length; j++) {\n        const result = compareProfiles(profiles[i]!, profiles[j]!, minSimilarity);\n        if (result) results.push(result);\n      }\n      if (results.length > limit * 5) break;\n    }\n  }\n\n  results.sort((a, b) => b.similarity - a.similarity);\n  return results.slice(0, limit);\n}\n\n// ── Internal ───────────────────────────────────────────────\n\ninterface FileProfile {\n  file: string;\n  deps: Set<string>;\n}\n\nfunction buildFileProfiles(\n  db: ScipDatabase,\n  opts: { scope?: string; minDeps: number },\n): FileProfile[] {\n  const { scope, minDeps } = opts;\n  const depMap = buildFileDepGraph(db, scope);\n  const universalDeps = findUniversalDependencies(depMap);\n\n  // Filter to files with enough deps\n  const profiles: FileProfile[] = [];\n  for (const [file, deps] of depMap) {\n    if (deps.size >= minDeps) {\n      profiles.push({\n        file,\n        deps: new Set([...deps].filter((dep) => !universalDeps.has(dep))),\n      });\n    }\n  }\n\n  return profiles;\n}\n\nfunction findUniversalDependencies(\n  depMap: Map<string, Set<string>>,\n): Set<string> {\n  const universalDeps = new Set<string>();\n  const fileCount = depMap.size;\n  if (fileCount === 0) return universalDeps;\n\n  const depCounts = new Map<string, number>();\n  for (const deps of depMap.values()) {\n    for (const dep of deps) {\n      depCounts.set(dep, (depCounts.get(dep) ?? 0) + 1);\n    }\n  }\n\n  for (const [dep, count] of depCounts) {\n    if (count / fileCount > 0.5) {\n      universalDeps.add(dep);\n    }\n  }\n\n  return universalDeps;\n}\n\nfunction compareProfiles(\n  a: FileProfile,\n  b: FileProfile,\n  minSimilarity: number,\n): SimilarFileResult | null {\n  const shared = new Set<string>();\n  for (const dep of a.deps) {\n    if (b.deps.has(dep)) shared.add(dep);\n  }\n\n  if (shared.size === 0) return null;\n\n  const unionSize = new Set([...a.deps, ...b.deps]).size;\n  const similarity = shared.size / unionSize;\n\n  if (similarity < minSimilarity) return null;\n\n  const uniqueA: string[] = [];\n  for (const dep of a.deps) {\n    if (!b.deps.has(dep)) uniqueA.push(dep);\n  }\n  const uniqueB: string[] = [];\n  for (const dep of b.deps) {\n    if (!a.deps.has(dep)) uniqueB.push(dep);\n  }\n\n  return {\n    fileA: a.file,\n    fileB: b.file,\n    similarity,\n    sharedDeps: [...shared],\n    uniqueToA: uniqueA,\n    uniqueToB: uniqueB,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-ZJRYBOEE.js

@@ -0,0 +1,125 @@
+import {
+  findFirstSymbolMatch,
+  getCalleeRowsForSymbol
+} from "./chunk-FUHJCHS4.js";
+import {
+  shortenSymbol
+} from "./chunk-QOV2R2WT.js";
+
+// src/queries/slice.ts
+function slice(db, symbolPattern, opts = {}) {
+  const { direction = "backward" } = opts;
+  const match = findFirstSymbolMatch(db, symbolPattern);
+  if (!match) return null;
+  if (direction === "backward") {
+    return backwardSlice(db, match);
+  } else {
+    return forwardSlice(db, match);
+  }
+}
+function backwardSlice(db, match) {
+  const callees = getCalleeRowsForSymbol(db, match);
+  const localPredecessors = db.all(
+    `SELECT DISTINCT gs.symbol, d.relative_path AS file
+    FROM defn_enclosing_ranges der
+    JOIN global_symbols gs ON der.symbol_id = gs.id
+    JOIN documents d ON der.document_id = d.id
+    WHERE der.document_id = ?
+      AND der.end_line < ?
+      AND gs.id != ?
+      ${db.symbolNoiseFor("gs")}
+    ORDER BY der.start_line DESC
+    LIMIT 15`,
+    match.documentId,
+    match.startLine,
+    match.symbolId
+  );
+  const seen = /* @__PURE__ */ new Set();
+  const connected = [];
+  for (const c of callees) {
+    if (seen.has(c.symbol)) continue;
+    seen.add(c.symbol);
+    connected.push({
+      symbol: c.symbol,
+      shortName: shortenSymbol(c.symbol),
+      file: c.file,
+      relationship: "referenced within definition (callee)"
+    });
+  }
+  for (const p of localPredecessors) {
+    if (seen.has(p.symbol) || db.isIgnored(p.file)) continue;
+    seen.add(p.symbol);
+    connected.push({
+      symbol: p.symbol,
+      shortName: shortenSymbol(p.symbol),
+      file: p.file,
+      relationship: "defined before target in same file (local predecessor)"
+    });
+  }
+  return {
+    symbol: match.symbol,
+    shortName: shortenSymbol(match.symbol),
+    direction: "backward",
+    connectedSymbols: connected
+  };
+}
+function forwardSlice(db, match) {
+  const rows = db.all(
+    `SELECT DISTINCT
+      enc_gs.symbol AS enclosing_symbol,
+      enc_d.relative_path AS enclosing_file,
+      out_gs.symbol AS output_symbol,
+      out_d.relative_path AS output_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 enclosing function at each reference 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
+    JOIN documents enc_d ON enc_der.document_id = enc_d.id
+    -- Find other symbols referenced within that enclosing function
+    JOIN mentions out_m ON out_m.role = 0
+    JOIN chunks out_c ON out_m.chunk_id = out_c.id
+      AND out_c.document_id = enc_der.document_id
+      AND out_c.start_line >= enc_der.start_line
+      AND out_c.end_line <= enc_der.end_line
+    JOIN global_symbols out_gs ON out_m.symbol_id = out_gs.id
+    JOIN defn_enclosing_ranges out_der ON out_gs.id = out_der.symbol_id
+    JOIN documents out_d ON out_der.document_id = out_d.id
+    WHERE ref_m.symbol_id = ? AND ref_m.role = 0
+      AND out_gs.id != ? AND out_gs.id != enc_gs.id
+      AND out_d.id != ref_d.id
+      ${db.symbolNoiseFor("out_gs")}
+      ${db.pathExclusionsFor("out_d")}
+    ORDER BY out_d.relative_path
+    LIMIT 30`,
+    match.symbolId,
+    match.symbolId
+  );
+  const seen = /* @__PURE__ */ new Set();
+  const connected = [];
+  for (const r of rows) {
+    if (seen.has(r.output_symbol) || db.isIgnored(r.output_file)) continue;
+    seen.add(r.output_symbol);
+    connected.push({
+      symbol: r.output_symbol,
+      shortName: shortenSymbol(r.output_symbol),
+      file: r.output_file,
+      relationship: `used alongside target in ${shortenSymbol(r.enclosing_symbol)}`
+    });
+  }
+  return {
+    symbol: match.symbol,
+    shortName: shortenSymbol(match.symbol),
+    direction: "forward",
+    connectedSymbols: connected
+  };
+}
+
+export {
+  slice
+};
+//# sourceMappingURL=chunk-ZJRYBOEE.js.map

package/dist/chunk-ZJRYBOEE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queries/slice.ts"],"sourcesContent":["import type { ScipDatabase } from '../db.js';\nimport { findFirstSymbolMatch, getCalleeRowsForSymbol, type SymbolMatch } from '../query-support.js';\nimport type { SliceResult } from '../types.js';\nimport { shortenSymbol } from '../symbol-parser.js';\n\n/**\n * Reference-level program slicing: track what affects a symbol (backward)\n * or what a symbol affects (forward).\n *\n * Backward slice: \"What feeds into this?\" — symbols referenced in the same\n * function that defines the target. These are the inputs/dependencies.\n *\n * Forward slice: \"What does this feed into?\" — at each site where the target\n * is referenced, find the enclosing function, then find what that function\n * exports/defines. These are the outputs/consumers.\n *\n * Language-agnostic: works with any SCIP index.\n */\nexport function slice(\n  db: ScipDatabase,\n  symbolPattern: string,\n  opts: { direction?: 'backward' | 'forward' } = {},\n): SliceResult | null {\n  const { direction = 'backward' } = opts;\n\n  const match = findFirstSymbolMatch(db, symbolPattern);\n  if (!match) return null;\n\n  if (direction === 'backward') {\n    return backwardSlice(db, match);\n  } else {\n    return forwardSlice(db, match);\n  }\n}\n\n\nfunction backwardSlice(db: ScipDatabase, match: SymbolMatch): SliceResult {\n  // Find all symbols referenced within the definition range of the target.\n  // These are what \"feeds into\" the target — the inputs.\n  const callees = getCalleeRowsForSymbol(db, match);\n\n  // Also find symbols whose definitions are in the same file and whose\n  // ranges overlap or precede the target — local variables, parameters, etc.\n  const localPredecessors = db.all<{ symbol: string; file: string }>(\n    `SELECT DISTINCT gs.symbol, d.relative_path AS file\n    FROM defn_enclosing_ranges der\n    JOIN global_symbols gs ON der.symbol_id = gs.id\n    JOIN documents d ON der.document_id = d.id\n    WHERE der.document_id = ?\n      AND der.end_line < ?\n      AND gs.id != ?\n      ${db.symbolNoiseFor('gs')}\n    ORDER BY der.start_line DESC\n    LIMIT 15`,\n    match.documentId, match.startLine, match.symbolId,\n  );\n\n  const seen = new Set<string>();\n  const connected: SliceResult['connectedSymbols'] = [];\n\n  for (const c of callees) {\n    if (seen.has(c.symbol)) continue;\n    seen.add(c.symbol);\n    connected.push({\n      symbol: c.symbol,\n      shortName: shortenSymbol(c.symbol),\n      file: c.file,\n      relationship: 'referenced within definition (callee)',\n    });\n  }\n\n  for (const p of localPredecessors) {\n    if (seen.has(p.symbol) || db.isIgnored(p.file)) continue;\n    seen.add(p.symbol);\n    connected.push({\n      symbol: p.symbol,\n      shortName: shortenSymbol(p.symbol),\n      file: p.file,\n      relationship: 'defined before target in same file (local predecessor)',\n    });\n  }\n\n  return {\n    symbol: match.symbol,\n    shortName: shortenSymbol(match.symbol),\n    direction: 'backward',\n    connectedSymbols: connected,\n  };\n}\n\nfunction forwardSlice(db: ScipDatabase, match: SymbolMatch): SliceResult {\n  // Find where the target is referenced, then at each reference site,\n  // find what else the enclosing function defines/exports.\n  const rows = db.all<{\n    enclosing_symbol: string;\n    enclosing_file: string;\n    output_symbol: string;\n    output_file: string;\n  }>(\n    `SELECT DISTINCT\n      enc_gs.symbol AS enclosing_symbol,\n      enc_d.relative_path AS enclosing_file,\n      out_gs.symbol AS output_symbol,\n      out_d.relative_path AS output_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 enclosing function at each reference 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    JOIN documents enc_d ON enc_der.document_id = enc_d.id\n    -- Find other symbols referenced within that enclosing function\n    JOIN mentions out_m ON out_m.role = 0\n    JOIN chunks out_c ON out_m.chunk_id = out_c.id\n      AND out_c.document_id = enc_der.document_id\n      AND out_c.start_line >= enc_der.start_line\n      AND out_c.end_line <= enc_der.end_line\n    JOIN global_symbols out_gs ON out_m.symbol_id = out_gs.id\n    JOIN defn_enclosing_ranges out_der ON out_gs.id = out_der.symbol_id\n    JOIN documents out_d ON out_der.document_id = out_d.id\n    WHERE ref_m.symbol_id = ? AND ref_m.role = 0\n      AND out_gs.id != ? AND out_gs.id != enc_gs.id\n      AND out_d.id != ref_d.id\n      ${db.symbolNoiseFor('out_gs')}\n      ${db.pathExclusionsFor('out_d')}\n    ORDER BY out_d.relative_path\n    LIMIT 30`,\n    match.symbolId, match.symbolId,\n  );\n\n  const seen = new Set<string>();\n  const connected: SliceResult['connectedSymbols'] = [];\n\n  for (const r of rows) {\n    if (seen.has(r.output_symbol) || db.isIgnored(r.output_file)) continue;\n    seen.add(r.output_symbol);\n    connected.push({\n      symbol: r.output_symbol,\n      shortName: shortenSymbol(r.output_symbol),\n      file: r.output_file,\n      relationship: `used alongside target in ${shortenSymbol(r.enclosing_symbol)}`,\n    });\n  }\n\n  return {\n    symbol: match.symbol,\n    shortName: shortenSymbol(match.symbol),\n    direction: 'forward',\n    connectedSymbols: connected,\n  };\n}\n"],"mappings":";;;;;;;;;AAkBO,SAAS,MACd,IACA,eACA,OAA+C,CAAC,GAC5B;AACpB,QAAM,EAAE,YAAY,WAAW,IAAI;AAEnC,QAAM,QAAQ,qBAAqB,IAAI,aAAa;AACpD,MAAI,CAAC,MAAO,QAAO;AAEnB,MAAI,cAAc,YAAY;AAC5B,WAAO,cAAc,IAAI,KAAK;AAAA,EAChC,OAAO;AACL,WAAO,aAAa,IAAI,KAAK;AAAA,EAC/B;AACF;AAGA,SAAS,cAAc,IAAkB,OAAiC;AAGxE,QAAM,UAAU,uBAAuB,IAAI,KAAK;AAIhD,QAAM,oBAAoB,GAAG;AAAA,IAC3B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAOI,GAAG,eAAe,IAAI,CAAC;AAAA;AAAA;AAAA,IAG3B,MAAM;AAAA,IAAY,MAAM;AAAA,IAAW,MAAM;AAAA,EAC3C;AAEA,QAAM,OAAO,oBAAI,IAAY;AAC7B,QAAM,YAA6C,CAAC;AAEpD,aAAW,KAAK,SAAS;AACvB,QAAI,KAAK,IAAI,EAAE,MAAM,EAAG;AACxB,SAAK,IAAI,EAAE,MAAM;AACjB,cAAU,KAAK;AAAA,MACb,QAAQ,EAAE;AAAA,MACV,WAAW,cAAc,EAAE,MAAM;AAAA,MACjC,MAAM,EAAE;AAAA,MACR,cAAc;AAAA,IAChB,CAAC;AAAA,EACH;AAEA,aAAW,KAAK,mBAAmB;AACjC,QAAI,KAAK,IAAI,EAAE,MAAM,KAAK,GAAG,UAAU,EAAE,IAAI,EAAG;AAChD,SAAK,IAAI,EAAE,MAAM;AACjB,cAAU,KAAK;AAAA,MACb,QAAQ,EAAE;AAAA,MACV,WAAW,cAAc,EAAE,MAAM;AAAA,MACjC,MAAM,EAAE;AAAA,MACR,cAAc;AAAA,IAChB,CAAC;AAAA,EACH;AAEA,SAAO;AAAA,IACL,QAAQ,MAAM;AAAA,IACd,WAAW,cAAc,MAAM,MAAM;AAAA,IACrC,WAAW;AAAA,IACX,kBAAkB;AAAA,EACpB;AACF;AAEA,SAAS,aAAa,IAAkB,OAAiC;AAGvE,QAAM,OAAO,GAAG;AAAA,IAMd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QA2BI,GAAG,eAAe,QAAQ,CAAC;AAAA,QAC3B,GAAG,kBAAkB,OAAO,CAAC;AAAA;AAAA;AAAA,IAGjC,MAAM;AAAA,IAAU,MAAM;AAAA,EACxB;AAEA,QAAM,OAAO,oBAAI,IAAY;AAC7B,QAAM,YAA6C,CAAC;AAEpD,aAAW,KAAK,MAAM;AACpB,QAAI,KAAK,IAAI,EAAE,aAAa,KAAK,GAAG,UAAU,EAAE,WAAW,EAAG;AAC9D,SAAK,IAAI,EAAE,aAAa;AACxB,cAAU,KAAK;AAAA,MACb,QAAQ,EAAE;AAAA,MACV,WAAW,cAAc,EAAE,aAAa;AAAA,MACxC,MAAM,EAAE;AAAA,MACR,cAAc,4BAA4B,cAAc,EAAE,gBAAgB,CAAC;AAAA,IAC7E,CAAC;AAAA,EACH;AAEA,SAAO;AAAA,IACL,QAAQ,MAAM;AAAA,IACd,WAAW,cAAc,MAAM,MAAM;AAAA,IACrC,WAAW;AAAA,IACX,kBAAkB;AAAA,EACpB;AACF;","names":[]}