scip-query 0.4.3 → 0.5.0

package/dist/{chunk-FMAYH7GS.js → chunk-OMCRXXDX.js}

@@ -1150,10 +1150,6 @@ var TEST_FILE_PATTERNS = [
 var TEST_SUPPORT_PATH_PATTERNS = [
   "%/test-utils/%"
 ];
-function testFileExclusionSql(alias, extraPatterns = []) {
-  const patterns = uniquePatterns([...TEST_FILE_PATTERNS, ...extraPatterns]);
-  return patterns.map((pattern) => `${alias}.relative_path NOT LIKE '${pattern}'`).join("\n      AND ");
-}
 function buildFileDepGraph(db, scope) {
   const scopeFilter = scope ? `AND d1.relative_path LIKE '%${scope}%'` : "";
   const edges = db.all(
@@ -1208,6 +1204,8 @@ function findFirstSymbolMatch(db, symbolPattern) {
   const fileLineMatch = symbolPattern.match(/^(.+):(\d+)-(\d+)$/);
   if (fileLineMatch) {
     const [, filePath, startStr, endStr] = fileLineMatch;
+    const userStart0 = Math.max(0, parseInt(startStr, 10) - 1);
+    const userEnd0 = Math.max(userStart0, parseInt(endStr, 10) - 1);
     let row = db.get(
       `SELECT gs.id, gs.symbol, der.document_id, der.start_line, der.end_line, d.relative_path
       FROM global_symbols gs
@@ -1219,8 +1217,8 @@ function findFirstSymbolMatch(db, symbolPattern) {
       ORDER BY (der.end_line - der.start_line) ASC
         LIMIT 1`,
       `%${filePath}%`,
-      parseInt(startStr, 10),
-      parseInt(endStr, 10)
+      userStart0,
+      userEnd0
     );
     if (!row) {
       row = db.get(
@@ -1237,8 +1235,8 @@ function findFirstSymbolMatch(db, symbolPattern) {
          ORDER BY (MAX(c.end_line) - MIN(c.start_line)) ASC
          LIMIT 1`,
         `%${filePath}%`,
-        parseInt(startStr, 10),
-        parseInt(endStr, 10)
+        userStart0,
+        userEnd0
       );
     }
     if (row && !db.isIgnored(row.relative_path)) {
@@ -1530,6 +1528,59 @@ function getSourceReferenceSites(db, symbol) {
   }
   return sites;
 }
+function getResolvedReferenceSites(db, symbol) {
+  const match = getFullSymbolMatch(db, symbol);
+  if (!match) {
+    return [];
+  }
+  const rows = db.all(
+    `SELECT DISTINCT d.relative_path, c.start_line, c.end_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
+       ${db.pathExclusionsFor("d")}
+     ORDER BY d.relative_path, c.start_line`,
+    match.symbolId
+  );
+  const chunksByFile = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    if (db.isIgnored(row.relative_path)) continue;
+    let bucket = chunksByFile.get(row.relative_path);
+    if (!bucket) {
+      bucket = [];
+      chunksByFile.set(row.relative_path, bucket);
+    }
+    bucket.push({ start_line: row.start_line, end_line: row.end_line });
+  }
+  const identifier = leafName(match.symbol);
+  const sites = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const [file, chunks] of chunksByFile) {
+    const definitions = getDefinitionsForFile(db, file);
+    const excludeOpts = file === match.relativePath ? { excludeStartLine: match.startLine, excludeEndLine: match.endLine } : {};
+    const allHits = identifier ? findIdentifierLines(db, file, identifier, excludeOpts) : [];
+    for (const chunk of chunks) {
+      const hitsInChunk = allHits.filter(
+        (line) => line >= chunk.start_line && line <= chunk.end_line
+      );
+      const lines = hitsInChunk.length > 0 ? hitsInChunk : [chunk.start_line];
+      for (const line of lines) {
+        const enclosing = findEnclosingDefinition(definitions, line);
+        const key = `${file}|${line}|${enclosing?.symbol ?? ""}`;
+        if (seen.has(key)) continue;
+        seen.add(key);
+        sites.push({
+          file,
+          line,
+          enclosingSymbol: enclosing?.symbol ?? null
+        });
+      }
+    }
+  }
+  return sites;
+}
 function calleeQueryParams(symbol, limit) {
   const params = [
     symbol.documentId,
@@ -1895,7 +1946,16 @@ function resolveCallableDefinitionStartLine(lines, definition) {
   const escapedLeaf = escapeRegex2(definition.leaf);
   const strongPatterns = [
     new RegExp(`\\b(?:function|def|fn)\\s+${escapedLeaf}\\b`),
-    new RegExp(`\\b${escapedLeaf}\\b\\s*[:=]\\s*(?:async\\s*)?(?:function\\b|\\()`)
+    new RegExp(`\\b${escapedLeaf}\\b\\s*[:=]\\s*(?:async\\s*)?(?:function\\b|\\()`),
+    // Method/function declaration with optional TypeScript generic
+    // parameters: matches `foo(`, `foo<T>(`, `foo<T = Record<string, unknown>>(`.
+    // `[^(]*` with greedy backtracking handles nested generics as long as
+    // the generic block itself doesn't contain a `(`. Anchored to start of
+    // line content (optional leading whitespace + optional access modifiers)
+    // so it prefers the declaration line over call sites.
+    new RegExp(
+      `^\\s*(?:export\\s+|public\\s+|private\\s+|protected\\s+|static\\s+|readonly\\s+|async\\s+|abstract\\s+|get\\s+|set\\s+)*${escapedLeaf}\\s*(?:<[^(]*>)?\\s*\\(`
+    )
   ];
   const fallbackPatterns = [
     new RegExp(`\\b${escapedLeaf}\\b\\s*\\(`)
@@ -2516,9 +2576,6 @@ function scoreDocumentPath(relativePath, rawPattern) {
 function normalizeLookupPath(filePattern) {
   return filePattern.trim().replace(/\\/g, "/").replace(/^\.\//, "").replace(/^\/+/, "").replace(/\/+$/, "");
 }
-function uniquePatterns(patterns) {
-  return [...new Set(patterns)];
-}
 
 export {
   getSourceImports,
@@ -2526,7 +2583,6 @@ export {
   getSourceText,
   TEST_FILE_PATTERNS,
   TEST_SUPPORT_PATH_PATTERNS,
-  testFileExclusionSql,
   buildFileDepGraph,
   findFirstSymbolMatch,
   findExactSymbolMatch,
@@ -2535,8 +2591,10 @@ export {
   getCalleeRowsForSymbol,
   getCallerRowsForSymbol,
   getSourceReferenceSites,
+  getResolvedReferenceSites,
+  findEnclosingDefinition,
   getDefinitionsForFile,
   getAllDefinitions,
   getScopedDefinitions
 };
-//# sourceMappingURL=chunk-FMAYH7GS.js.map
+//# sourceMappingURL=chunk-OMCRXXDX.js.map

package/dist/{chunk-6PVHJ332.js → chunk-OWJOHUZE.js}

@@ -1,6 +1,6 @@
 import {
   buildFileDepGraph
-} from "./chunk-FMAYH7GS.js";
+} from "./chunk-OMCRXXDX.js";
 
 // src/queries/deep-chains.ts
 function deepChains(db, opts = {}) {
@@ -41,4 +41,4 @@ function deepChains(db, opts = {}) {
 export {
   deepChains
 };
-//# sourceMappingURL=chunk-6PVHJ332.js.map
+//# sourceMappingURL=chunk-OWJOHUZE.js.map

package/dist/{chunk-IC5NTO47.js → chunk-PEDH3D4G.js}

@@ -1,6 +1,6 @@
 import {
   resolveIndexedFile
-} from "./chunk-FMAYH7GS.js";
+} from "./chunk-OMCRXXDX.js";
 
 // src/queries/deps.ts
 function deps(db, filePattern) {
@@ -50,4 +50,4 @@ export {
   deps,
   rdeps
 };
-//# sourceMappingURL=chunk-IC5NTO47.js.map
+//# sourceMappingURL=chunk-PEDH3D4G.js.map

package/dist/{chunk-U74VYTLX.js → chunk-POAN4SCR.js}

@@ -2,7 +2,7 @@ import {
   findFirstSymbolMatch,
   getCalleeRowsForSymbol,
   getCallerRowsForSymbol
-} from "./chunk-FMAYH7GS.js";
+} from "./chunk-OMCRXXDX.js";
 import {
   shortenSymbol
 } from "./chunk-YMSJCSRG.js";
@@ -43,4 +43,4 @@ function uniqueRows(rows) {
 export {
   callGraph
 };
-//# sourceMappingURL=chunk-U74VYTLX.js.map
+//# sourceMappingURL=chunk-POAN4SCR.js.map

package/dist/{chunk-5YB6UXQ3.js → chunk-PTMGEBU3.js}

@@ -1,7 +1,7 @@
 import {
   getCalleeRowsForSymbol,
   getScopedDefinitions
-} from "./chunk-FMAYH7GS.js";
+} from "./chunk-OMCRXXDX.js";
 import {
   isFunctionLikeSymbol,
   shortenSymbol
@@ -98,4 +98,4 @@ function definitionLoc(definition) {
 export {
   extractCandidates
 };
-//# sourceMappingURL=chunk-5YB6UXQ3.js.map
+//# sourceMappingURL=chunk-PTMGEBU3.js.map

package/dist/{chunk-LQXBFCP2.js → chunk-PU44HK7P.js}

@@ -2,7 +2,7 @@ import {
   findExactSymbolMatch,
   findFirstSymbolMatch,
   getCallerRowsForSymbol
-} from "./chunk-FMAYH7GS.js";
+} from "./chunk-OMCRXXDX.js";
 import {
   shortenSymbol
 } from "./chunk-YMSJCSRG.js";
@@ -84,4 +84,4 @@ function getDirectAffectedRows(db, target, scope) {
 export {
   affected
 };
-//# sourceMappingURL=chunk-LQXBFCP2.js.map
+//# sourceMappingURL=chunk-PU44HK7P.js.map

package/dist/{chunk-QZ4FRB65.js → chunk-QJI7EECA.js}

@@ -3,7 +3,7 @@ import {
   getAllDefinitions,
   getCalleeRowsForSymbol,
   getSourceText
-} from "./chunk-FMAYH7GS.js";
+} from "./chunk-OMCRXXDX.js";
 import {
   isFunctionLikeSymbol,
   leafName,
@@ -152,35 +152,21 @@ function findCallees(db, symbolPattern) {
 }
 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;
-    if (!isFunctionLikeSymbol(sym.symbol)) continue;
-    const calleeRows = getCalleeRowsForSymbol(db, {
-      documentId: sym.document_id,
-      startLine: sym.start_line,
-      endLine: sym.end_line,
-      symbolId: sym.id
+  for (const definition of getAllDefinitions(db, { scope })) {
+    if (db.isIgnored(definition.relativePath)) continue;
+    if (!definition.isFunctionLike) continue;
+    if (excludeSymbol && definition.symbol === excludeSymbol) continue;
+    if (definition.endLine - definition.startLine + 1 < 5) continue;
+    const callees = new Set(
+      getCalleeRowsForSymbol(db, definition).map((row) => row.symbol)
+    );
+    if (callees.size < minCallees) continue;
+    fingerprints.push({
+      symbol: definition.symbol,
+      file: definition.relativePath,
+      callees
     });
-    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;
 }
@@ -338,4 +324,4 @@ export {
   similar,
   similarAll
 };
-//# sourceMappingURL=chunk-QZ4FRB65.js.map
+//# sourceMappingURL=chunk-QJI7EECA.js.map

package/dist/{chunk-C2VSV54P.js → chunk-R5HICGMB.js}

@@ -1,12 +1,12 @@
 import {
   getInactiveBarrelPaths,
   isEntrySurface
-} from "./chunk-OMVF3BHY.js";
+} from "./chunk-UGS7HJI4.js";
 import {
   TEST_FILE_PATTERNS,
   TEST_SUPPORT_PATH_PATTERNS,
   getAllDefinitions
-} from "./chunk-FMAYH7GS.js";
+} from "./chunk-OMCRXXDX.js";
 import {
   isFunctionLikeSymbol,
   isModuleLikeSymbol,
@@ -107,4 +107,4 @@ function looksValueLikeDefinition(rawSymbol) {
 export {
   dead
 };
-//# sourceMappingURL=chunk-C2VSV54P.js.map
+//# sourceMappingURL=chunk-R5HICGMB.js.map

package/dist/{chunk-NWXTQGUE.js → chunk-RJ2D6YWQ.js}

@@ -1,7 +1,7 @@
 import {
   getCalleeRowsForSymbol,
   getScopedDefinitions
-} from "./chunk-FMAYH7GS.js";
+} from "./chunk-OMCRXXDX.js";
 import {
   isFunctionLikeSymbol,
   shortenSymbol
@@ -46,4 +46,4 @@ function definitionLoc(definition) {
 export {
   passthroughCandidates
 };
-//# sourceMappingURL=chunk-NWXTQGUE.js.map
+//# sourceMappingURL=chunk-RJ2D6YWQ.js.map

package/dist/{chunk-PGQXIAJF.js → chunk-RZ5GYPBP.js}

@@ -2,7 +2,7 @@ import {
   getAllDefinitions,
   getCalleeRowsForSymbol,
   getCallerRowsForSymbol
-} from "./chunk-FMAYH7GS.js";
+} from "./chunk-OMCRXXDX.js";
 import {
   shortenSymbol
 } from "./chunk-YMSJCSRG.js";
@@ -76,4 +76,4 @@ function bottlenecks(db, opts = {}) {
 export {
   bottlenecks
 };
-//# sourceMappingURL=chunk-PGQXIAJF.js.map
+//# sourceMappingURL=chunk-RZ5GYPBP.js.map

package/dist/chunk-SRLQNO6O.js

@@ -0,0 +1,101 @@
+import {
+  findEnclosingDefinition,
+  findExactSymbolMatch,
+  findFirstSymbolMatch,
+  getCalleeRowsForSymbol,
+  getDefinitionsForFile,
+  getResolvedReferenceSites,
+  getSourceReferenceSites
+} from "./chunk-OMCRXXDX.js";
+import {
+  shortenSymbol
+} from "./chunk-YMSJCSRG.js";
+
+// src/queries/slice.ts
+function slice(db, symbolPattern, opts = {}) {
+  const { direction = "backward", maxDepth = 3 } = opts;
+  const match = findFirstSymbolMatch(db, symbolPattern);
+  if (!match) return null;
+  if (direction === "backward") {
+    return backwardSlice(db, match, maxDepth);
+  } else {
+    return forwardSlice(db, match);
+  }
+}
+function backwardSlice(db, match, maxDepth) {
+  const connected = [];
+  const visited = /* @__PURE__ */ new Set([match.symbol]);
+  let frontier = [match];
+  for (let depth = 1; depth <= maxDepth; depth++) {
+    if (frontier.length === 0) break;
+    const nextFrontier = [];
+    for (const current of frontier) {
+      const callees = getCalleeRowsForSymbol(db, current);
+      for (const c of callees) {
+        if (visited.has(c.symbol)) continue;
+        visited.add(c.symbol);
+        connected.push({
+          symbol: c.symbol,
+          shortName: shortenSymbol(c.symbol),
+          file: c.file,
+          relationship: depth === 1 ? "referenced within definition (callee)" : `depth ${depth} callee`
+        });
+        const calleeMatch = findExactSymbolMatch(db, c.symbol);
+        if (calleeMatch && !db.isIgnored(calleeMatch.relativePath)) {
+          nextFrontier.push(calleeMatch);
+        }
+      }
+    }
+    frontier = nextFrontier;
+  }
+  return {
+    symbol: match.symbol,
+    shortName: shortenSymbol(match.symbol),
+    direction: "backward",
+    connectedSymbols: connected
+  };
+}
+function forwardSlice(db, match) {
+  const sourceRefs = getSourceReferenceSites(db, match);
+  const refs = sourceRefs.length > 0 ? sourceRefs : getResolvedReferenceSites(db, match);
+  const seenOutputs = /* @__PURE__ */ new Set();
+  const connected = [];
+  for (const ref of refs) {
+    if (connected.length >= 30) break;
+    if (db.isIgnored(ref.file)) continue;
+    const enclosingSymbol = ref.enclosingSymbol ?? findEnclosingDefinition(
+      getDefinitionsForFile(db, ref.file),
+      ref.line
+    )?.symbol ?? null;
+    if (!enclosingSymbol || enclosingSymbol === match.symbol) continue;
+    const enclosingMatch = findExactSymbolMatch(db, enclosingSymbol);
+    if (!enclosingMatch) continue;
+    for (const callee of getCalleeRowsForSymbol(db, enclosingMatch)) {
+      if (callee.symbol === match.symbol) continue;
+      if (callee.symbol === enclosingSymbol) continue;
+      if (callee.file === ref.file) continue;
+      if (db.isIgnored(callee.file)) continue;
+      if (seenOutputs.has(callee.symbol)) continue;
+      seenOutputs.add(callee.symbol);
+      connected.push({
+        symbol: callee.symbol,
+        shortName: shortenSymbol(callee.symbol),
+        file: callee.file,
+        relationship: `used alongside target in ${shortenSymbol(enclosingSymbol)}`
+      });
+      if (connected.length >= 30) break;
+    }
+  }
+  connected.sort((a, b) => a.file.localeCompare(b.file));
+  return {
+    symbol: match.symbol,
+    shortName: shortenSymbol(match.symbol),
+    direction: "forward",
+    connectedSymbols: connected
+  };
+}
+
+export {
+  slice
+};
+//# sourceMappingURL=chunk-SRLQNO6O.js.map

package/dist/{chunk-OMVF3BHY.js → chunk-UGS7HJI4.js}

@@ -1,6 +1,6 @@
 import {
   buildFileDepGraph
-} from "./chunk-FMAYH7GS.js";
+} from "./chunk-OMCRXXDX.js";
 
 // src/entry-surfaces.ts
 var liveBarrelCache = /* @__PURE__ */ new WeakMap();
@@ -81,4 +81,4 @@ export {
   isEntrySurface,
   getInactiveBarrelPaths
 };
-//# sourceMappingURL=chunk-OMVF3BHY.js.map
+//# sourceMappingURL=chunk-UGS7HJI4.js.map

package/dist/{chunk-7OGXSMLY.js → chunk-VKUUXOE7.js}

@@ -3,7 +3,7 @@ import {
   getCallerRowsForSymbol,
   getDefinitionsForFile,
   getScopedDefinitions
-} from "./chunk-FMAYH7GS.js";
+} from "./chunk-OMCRXXDX.js";
 import {
   isFunctionLikeSymbol,
   shortenSymbol
@@ -102,4 +102,4 @@ function fallbackCallerFanIn(db, reverseFanIn, callerFile) {
 export {
   wrapperCandidates
 };
-//# sourceMappingURL=chunk-7OGXSMLY.js.map
+//# sourceMappingURL=chunk-VKUUXOE7.js.map

package/dist/{chunk-XMZAC2VU.js → chunk-VPUJSJCI.js}

@@ -1,6 +1,6 @@
 import {
   resolveIndexedFile
-} from "./chunk-FMAYH7GS.js";
+} from "./chunk-OMCRXXDX.js";
 
 // src/queries/coupling.ts
 function coupling(db, file1, file2) {
@@ -81,4 +81,4 @@ export {
   coupling,
   topCoupling
 };
-//# sourceMappingURL=chunk-XMZAC2VU.js.map
+//# sourceMappingURL=chunk-VPUJSJCI.js.map

package/dist/{chunk-NNFP4ZRF.js → chunk-VRWVV3EP.js}

@@ -1,7 +1,7 @@
 import {
   getDefinitionsForFile,
   resolveIndexedPaths
-} from "./chunk-FMAYH7GS.js";
+} from "./chunk-OMCRXXDX.js";
 import {
   isCallableSymbol,
   shortenSymbol
@@ -69,4 +69,4 @@ function surface(db, modulePattern) {
 export {
   surface
 };
-//# sourceMappingURL=chunk-NNFP4ZRF.js.map
+//# sourceMappingURL=chunk-VRWVV3EP.js.map

package/dist/{chunk-HESWGDIV.js → chunk-WJWQEU4A.js}

@@ -1,7 +1,7 @@
 import {
   getAllDefinitions,
   getSourceText
-} from "./chunk-FMAYH7GS.js";
+} from "./chunk-OMCRXXDX.js";
 import {
   shortenSymbol
 } from "./chunk-YMSJCSRG.js";
@@ -159,4 +159,4 @@ function escapeRegex(value) {
 export {
   similarSignatures
 };
-//# sourceMappingURL=chunk-HESWGDIV.js.map
+//# sourceMappingURL=chunk-WJWQEU4A.js.map

package/dist/chunk-WJZHDUSB.js

@@ -0,0 +1,40 @@
+import {
+  getAllDefinitions,
+  getCalleeRowsForSymbol,
+  getCallerRowsForSymbol
+} from "./chunk-OMCRXXDX.js";
+import {
+  shortenSymbol
+} from "./chunk-YMSJCSRG.js";
+
+// src/queries/complexity-hotspots.ts
+function complexityHotspots(db, opts) {
+  const { scope, minLoc = 10, limit = 30 } = opts ?? {};
+  return getAllDefinitions(db, { scope }).filter((definition) => !db.isIgnored(definition.relativePath)).map((definition) => {
+    const loc = definition.endLine - definition.startLine + 1;
+    const callerRows = getCallerRowsForSymbol(db, definition, { limit: 500 });
+    const calleeRows = getCalleeRowsForSymbol(db, definition, { limit: 500 });
+    const fanIn = new Set(callerRows.map((row) => row.file)).size;
+    const fanOut = new Set(
+      calleeRows.filter((row) => row.file !== definition.relativePath).map((row) => `${row.symbol}|${row.file}`)
+    ).size;
+    const calleeCount = new Set(calleeRows.map((row) => `${row.symbol}|${row.file}`)).size;
+    return {
+      symbol: definition.symbol,
+      shortName: shortenSymbol(definition.symbol),
+      file: definition.relativePath,
+      startLine: definition.startLine,
+      endLine: definition.endLine,
+      loc,
+      fanIn,
+      fanOut,
+      calleeCount,
+      score: Math.round(loc / 50 * (fanIn / 5) * Math.max(fanOut / 5, 1) * 100) / 100
+    };
+  }).filter((row) => row.loc >= minLoc).sort((left, right) => right.score - left.score || right.loc - left.loc).slice(0, limit);
+}
+
+export {
+  complexityHotspots
+};
+//# sourceMappingURL=chunk-WJZHDUSB.js.map

package/dist/{chunk-HL2LXSBW.js → chunk-WWOCQ5W4.js}

@@ -1,7 +1,7 @@
 import {
   findFirstSymbolMatch,
   getDefinitionsForFile
-} from "./chunk-FMAYH7GS.js";
+} from "./chunk-OMCRXXDX.js";
 import {
   isCallableSymbol,
   leafName
@@ -31,4 +31,4 @@ function stripExtension(relativePath) {
 export {
   methods
 };
-//# sourceMappingURL=chunk-HL2LXSBW.js.map
+//# sourceMappingURL=chunk-WWOCQ5W4.js.map

package/dist/chunk-X3Q2OVRL.js

@@ -0,0 +1,77 @@
+import {
+  findFirstSymbolMatch,
+  getResolvedReferenceSites,
+  getSourceReferenceSites,
+  getSourceText
+} from "./chunk-OMCRXXDX.js";
+import {
+  isFunctionLikeSymbol
+} from "./chunk-YMSJCSRG.js";
+
+// src/queries/refs.ts
+function refs(db, symbolPattern) {
+  const match = findFirstSymbolMatch(db, symbolPattern);
+  if (!match) return [];
+  const includeDefinitionSite = !isFunctionLikeSymbol(match.symbol);
+  const definitionRows = includeDefinitionSite && !db.isIgnored(match.relativePath) ? [{ relativePath: match.relativePath, line: match.startLine }] : [];
+  const sourceSites = getSourceReferenceSites(db, match);
+  const referenceSites = (sourceSites.length > 0 ? sourceSites : getResolvedReferenceSites(db, match)).filter((site) => !db.isIgnored(site.file)).map((site) => ({ relativePath: site.file, line: site.line }));
+  const rubySites = getRubySemanticRefs(db, match);
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const row of [...definitionRows, ...referenceSites, ...rubySites]) {
+    const key = `${row.relativePath}:${row.line}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    out.push(row);
+  }
+  return out;
+}
+function getRubySemanticRefs(db, match) {
+  if (!match.relativePath.endsWith(".rb")) {
+    return [];
+  }
+  const tokens = rubyReferenceTokens(match.symbol);
+  if (tokens.length === 0) {
+    return [];
+  }
+  const rows = db.all(
+    `SELECT relative_path
+     FROM documents
+     WHERE relative_path LIKE '%.rb'
+       ${db.pathExclusionsFor("documents")}
+     ORDER BY relative_path`
+  );
+  const results = [];
+  for (const row of rows) {
+    if (db.isIgnored(row.relative_path)) continue;
+    const source = getSourceText(db, row.relative_path);
+    if (!source) continue;
+    const lines = source.split("\n");
+    for (let index = 0; index < lines.length; index++) {
+      const line = lines[index] ?? "";
+      if (tokens.some((token) => new RegExp(`@${token}\\b|\\b${token}:`).test(line))) {
+        results.push({
+          relativePath: row.relative_path,
+          line: index
+        });
+      }
+    }
+  }
+  return results;
+}
+function rubyReferenceTokens(rawSymbol) {
+  const leaf = rawSymbol.split(":").pop() ?? rawSymbol;
+  const snake = leaf.replace(/([a-z0-9])([A-Z])/g, "$1_$2").replace(/[^A-Za-z0-9_]+/g, "_").toLowerCase().replace(/^_+|_+$/g, "");
+  const parts = snake.split("_").filter(Boolean);
+  const candidates = /* @__PURE__ */ new Set();
+  if (snake) candidates.add(snake);
+  if (parts.length >= 1) candidates.add(parts[parts.length - 1]);
+  if (parts.length >= 2) candidates.add(parts.slice(-2).join("_"));
+  return [...candidates];
+}
+
+export {
+  refs
+};
+//# sourceMappingURL=chunk-X3Q2OVRL.js.map

package/dist/chunk-Y3P7QKKN.js

@@ -0,0 +1,27 @@
+import {
+  findFirstSymbolMatch,
+  getDefinitionsForFile
+} from "./chunk-OMCRXXDX.js";
+import {
+  isDirectChildSymbol,
+  leafSuffix,
+  shortenSymbol
+} from "./chunk-YMSJCSRG.js";
+
+// src/queries/members.ts
+function members(db, symbolPattern) {
+  const parent = findFirstSymbolMatch(db, symbolPattern);
+  if (!parent) return [];
+  return getDefinitionsForFile(db, parent.relativePath).filter((definition) => definition.symbol !== parent.symbol).filter((definition) => isDirectChildSymbol(parent.symbol, definition.symbol)).sort((a, b) => a.startLine - b.startLine || a.endLine - b.endLine).map((definition) => ({
+    symbol: definition.symbol,
+    shortName: shortenSymbol(definition.symbol),
+    startLine: definition.startLine,
+    endLine: definition.endLine,
+    kind: leafSuffix(definition.symbol) ?? "unknown"
+  }));
+}
+
+export {
+  members
+};
+//# sourceMappingURL=chunk-Y3P7QKKN.js.map