@optave/codegraph 3.2.0 → 3.3.1

package/src/domain/analysis/context.js

@@ -5,14 +5,17 @@ import {
   findCrossFileCallTargets,
   findDbPath,
   findFileNodes,
+  findImplementors,
   findImportSources,
   findImportTargets,
+  findInterfaces,
   findIntraFileCallEdges,
   findNodeChildren,
   findNodesByFile,
   getComplexityForNode,
   openReadonlyOrFail,
 } from '../../db/index.js';
+import { loadConfig } from '../../infrastructure/config.js';
 import { debug } from '../../infrastructure/logger.js';
 import { isTestFile } from '../../infrastructure/test-filter.js';
 import {
@@ -28,16 +31,16 @@ import { paginateResult } from '../../shared/paginate.js';
 import { findMatchingNodes } from './symbol-lookup.js';
 
 function buildCallees(db, node, repoRoot, getFileLines, opts) {
-  const { noTests, depth } = opts;
+  const { noTests, depth, displayOpts } = opts;
   const calleeRows = findCallees(db, node.id);
   const filteredCallees = noTests ? calleeRows.filter((c) => !isTestFile(c.file)) : calleeRows;
 
   const callees = filteredCallees.map((c) => {
     const cLines = getFileLines(c.file);
-    const summary = cLines ? extractSummary(cLines, c.line) : null;
+    const summary = cLines ? extractSummary(cLines, c.line, displayOpts) : null;
     let calleeSource = null;
     if (depth >= 1) {
-      calleeSource = readSourceRange(repoRoot, c.file, c.line, c.end_line);
+      calleeSource = readSourceRange(repoRoot, c.file, c.line, c.end_line, displayOpts);
     }
     return {
       name: c.name,
@@ -70,8 +73,8 @@ function buildCallees(db, node, repoRoot, getFileLines, opts) {
               file: c.file,
               line: c.line,
               endLine: c.end_line || null,
-              summary: cLines ? extractSummary(cLines, c.line) : null,
-              source: readSourceRange(repoRoot, c.file, c.line, c.end_line),
+              summary: cLines ? extractSummary(cLines, c.line, displayOpts) : null,
+              source: readSourceRange(repoRoot, c.file, c.line, c.end_line, displayOpts),
             });
           }
         }
@@ -107,6 +110,31 @@ function buildCallers(db, node, noTests) {
   }));
 }
 
+const INTERFACE_LIKE_KINDS = new Set(['interface', 'trait']);
+const IMPLEMENTOR_KINDS = new Set(['class', 'struct', 'record', 'enum']);
+
+function buildImplementationInfo(db, node, noTests) {
+  // For interfaces/traits: show who implements them
+  if (INTERFACE_LIKE_KINDS.has(node.kind)) {
+    let impls = findImplementors(db, node.id);
+    if (noTests) impls = impls.filter((n) => !isTestFile(n.file));
+    return {
+      implementors: impls.map((n) => ({ name: n.name, kind: n.kind, file: n.file, line: n.line })),
+    };
+  }
+  // For classes/structs: show what they implement
+  if (IMPLEMENTOR_KINDS.has(node.kind)) {
+    let ifaces = findInterfaces(db, node.id);
+    if (noTests) ifaces = ifaces.filter((n) => !isTestFile(n.file));
+    if (ifaces.length > 0) {
+      return {
+        implements: ifaces.map((n) => ({ name: n.name, kind: n.kind, file: n.file, line: n.line })),
+      };
+    }
+  }
+  return {};
+}
+
 function buildRelatedTests(db, node, getFileLines, includeTests) {
   const testCallerRows = findCallers(db, node.id);
   const testCallers = testCallerRows.filter((c) => isTestFile(c.file));
@@ -170,7 +198,7 @@ function getNodeChildrenSafe(db, nodeId) {
   }
 }
 
-function explainFileImpl(db, target, getFileLines) {
+function explainFileImpl(db, target, getFileLines, displayOpts) {
   const fileNodes = findFileNodes(db, `%${target}%`);
   if (fileNodes.length === 0) return [];
 
@@ -186,8 +214,8 @@ function explainFileImpl(db, target, getFileLines) {
       kind: s.kind,
       line: s.line,
       role: s.role || null,
-      summary: fileLines ? extractSummary(fileLines, s.line) : null,
-      signature: fileLines ? extractSignature(fileLines, s.line) : null,
+      summary: fileLines ? extractSummary(fileLines, s.line, displayOpts) : null,
+      signature: fileLines ? extractSignature(fileLines, s.line, displayOpts) : null,
     });
 
     const publicApi = symbols.filter((s) => publicIds.has(s.id)).map(mapSymbol);
@@ -231,7 +259,7 @@ function explainFileImpl(db, target, getFileLines) {
   });
 }
 
-function explainFunctionImpl(db, target, noTests, getFileLines) {
+function explainFunctionImpl(db, target, noTests, getFileLines, displayOpts) {
   let nodes = db
     .prepare(
       `SELECT * FROM nodes WHERE name LIKE ? AND kind IN ('function','method','class','interface','type','struct','enum','trait','record','module','constant') ORDER BY file, line`,
@@ -244,8 +272,8 @@ function explainFunctionImpl(db, target, noTests, getFileLines) {
   return nodes.slice(0, 10).map((node) => {
     const fileLines = getFileLines(node.file);
     const lineCount = node.end_line ? node.end_line - node.line + 1 : null;
-    const summary = fileLines ? extractSummary(fileLines, node.line) : null;
-    const signature = fileLines ? extractSignature(fileLines, node.line) : null;
+    const summary = fileLines ? extractSummary(fileLines, node.line, displayOpts) : null;
+    const signature = fileLines ? extractSignature(fileLines, node.line, displayOpts) : null;
 
     const callees = findCallees(db, node.id).map((c) => ({
       name: c.name,
@@ -281,7 +309,15 @@ function explainFunctionImpl(db, target, noTests, getFileLines) {
   });
 }
 
-function explainCallees(parentResults, currentDepth, visited, db, noTests, getFileLines) {
+function explainCallees(
+  parentResults,
+  currentDepth,
+  visited,
+  db,
+  noTests,
+  getFileLines,
+  displayOpts,
+) {
   if (currentDepth <= 0) return;
   for (const r of parentResults) {
     const newCallees = [];
@@ -289,7 +325,13 @@ function explainCallees(parentResults, currentDepth, visited, db, noTests, getFi
       const key = `${callee.name}:${callee.file}:${callee.line}`;
       if (visited.has(key)) continue;
       visited.add(key);
-      const calleeResults = explainFunctionImpl(db, callee.name, noTests, getFileLines);
+      const calleeResults = explainFunctionImpl(
+        db,
+        callee.name,
+        noTests,
+        getFileLines,
+        displayOpts,
+      );
       const exact = calleeResults.find((cr) => cr.file === callee.file && cr.line === callee.line);
       if (exact) {
         exact._depth = (r._depth || 0) + 1;
@@ -298,7 +340,7 @@ function explainCallees(parentResults, currentDepth, visited, db, noTests, getFi
     }
     if (newCallees.length > 0) {
       r.depDetails = newCallees;
-      explainCallees(newCallees, currentDepth - 1, visited, db, noTests, getFileLines);
+      explainCallees(newCallees, currentDepth - 1, visited, db, noTests, getFileLines, displayOpts);
     }
   }
 }
@@ -313,6 +355,9 @@ export function contextData(name, customDbPath, opts = {}) {
     const noTests = opts.noTests || false;
     const includeTests = opts.includeTests || false;
 
+    const config = opts.config || loadConfig();
+    const displayOpts = config.display || {};
+
     const dbPath = findDbPath(customDbPath);
     const repoRoot = path.resolve(path.dirname(dbPath), '..');
 
@@ -328,15 +373,20 @@ export function contextData(name, customDbPath, opts = {}) {
 
       const source = noSource
         ? null
-        : readSourceRange(repoRoot, node.file, node.line, node.end_line);
+        : readSourceRange(repoRoot, node.file, node.line, node.end_line, displayOpts);
 
-      const signature = fileLines ? extractSignature(fileLines, node.line) : null;
+      const signature = fileLines ? extractSignature(fileLines, node.line, displayOpts) : null;
 
-      const callees = buildCallees(db, node, repoRoot, getFileLines, { noTests, depth });
+      const callees = buildCallees(db, node, repoRoot, getFileLines, {
+        noTests,
+        depth,
+        displayOpts,
+      });
       const callers = buildCallers(db, node, noTests);
       const relatedTests = buildRelatedTests(db, node, getFileLines, includeTests);
       const complexityMetrics = getComplexityMetrics(db, node.id);
       const nodeChildren = getNodeChildrenSafe(db, node.id);
+      const implInfo = buildImplementationInfo(db, node, noTests);
 
       return {
         name: node.name,
@@ -352,6 +402,7 @@ export function contextData(name, customDbPath, opts = {}) {
         callees,
         callers,
         relatedTests,
+        ...implInfo,
       };
     });
 
@@ -369,6 +420,9 @@ export function explainData(target, customDbPath, opts = {}) {
     const depth = opts.depth || 0;
     const kind = isFileLikeTarget(target) ? 'file' : 'function';
 
+    const config = opts.config || loadConfig();
+    const displayOpts = config.display || {};
+
     const dbPath = findDbPath(customDbPath);
     const repoRoot = path.resolve(path.dirname(dbPath), '..');
 
@@ -376,12 +430,12 @@ export function explainData(target, customDbPath, opts = {}) {
 
     const results =
       kind === 'file'
-        ? explainFileImpl(db, target, getFileLines)
-        : explainFunctionImpl(db, target, noTests, getFileLines);
+        ? explainFileImpl(db, target, getFileLines, displayOpts)
+        : explainFunctionImpl(db, target, noTests, getFileLines, displayOpts);
 
     if (kind === 'function' && depth > 0 && results.length > 0) {
       const visited = new Set(results.map((r) => `${r.name}:${r.file}:${r.line}`));
-      explainCallees(results, depth, visited, db, noTests, getFileLines);
+      explainCallees(results, depth, visited, db, noTests, getFileLines, displayOpts);
     }
 
     const base = { target, kind, results };

package/src/domain/analysis/exports.js

@@ -6,6 +6,7 @@ import {
   findNodesByFile,
   openReadonlyOrFail,
 } from '../../db/index.js';
+import { loadConfig } from '../../infrastructure/config.js';
 import { debug } from '../../infrastructure/logger.js';
 import { isTestFile } from '../../infrastructure/test-filter.js';
 import {
@@ -20,17 +21,30 @@ export function exportsData(file, customDbPath, opts = {}) {
   try {
     const noTests = opts.noTests || false;
 
+    const config = opts.config || loadConfig();
+    const displayOpts = config.display || {};
+
     const dbFilePath = findDbPath(customDbPath);
     const repoRoot = path.resolve(path.dirname(dbFilePath), '..');
 
     const getFileLines = createFileLinesReader(repoRoot);
 
     const unused = opts.unused || false;
-    const fileResults = exportsFileImpl(db, file, noTests, getFileLines, unused);
+    const fileResults = exportsFileImpl(db, file, noTests, getFileLines, unused, displayOpts);
 
     if (fileResults.length === 0) {
       return paginateResult(
-        { file, results: [], reexports: [], totalExported: 0, totalInternal: 0, totalUnused: 0 },
+        {
+          file,
+          results: [],
+          reexports: [],
+          reexportedSymbols: [],
+          totalExported: 0,
+          totalInternal: 0,
+          totalUnused: 0,
+          totalReexported: 0,
+          totalReexportedUnused: 0,
+        },
         'results',
         { limit: opts.limit, offset: opts.offset },
       );
@@ -42,17 +56,34 @@ export function exportsData(file, customDbPath, opts = {}) {
       file: first.file,
       results: first.results,
       reexports: first.reexports,
+      reexportedSymbols: first.reexportedSymbols,
       totalExported: first.totalExported,
       totalInternal: first.totalInternal,
       totalUnused: first.totalUnused,
+      totalReexported: first.totalReexported,
+      totalReexportedUnused: first.totalReexportedUnused,
     };
-    return paginateResult(base, 'results', { limit: opts.limit, offset: opts.offset });
+    const paginated = paginateResult(base, 'results', { limit: opts.limit, offset: opts.offset });
+    // Paginate reexportedSymbols with the same limit/offset (match paginateResult behaviour)
+    if (opts.limit != null) {
+      const off = opts.offset || 0;
+      paginated.reexportedSymbols = paginated.reexportedSymbols.slice(off, off + opts.limit);
+      // Update _pagination.hasMore to account for reexportedSymbols (barrel-only files
+      // have empty results[], so hasMore would always be false without this)
+      if (paginated._pagination) {
+        const reexTotal = opts.unused ? base.totalReexportedUnused : base.totalReexported;
+        const resultsHasMore = paginated._pagination.hasMore;
+        const reexHasMore = off + opts.limit < reexTotal;
+        paginated._pagination.hasMore = resultsHasMore || reexHasMore;
+      }
+    }
+    return paginated;
   } finally {
     db.close();
   }
 }
 
-function exportsFileImpl(db, target, noTests, getFileLines, unused) {
+function exportsFileImpl(db, target, noTests, getFileLines, unused, displayOpts) {
   const fileNodes = findFileNodes(db, `%${target}%`);
   if (fileNodes.length === 0) return [];
 
@@ -83,9 +114,7 @@ function exportsFileImpl(db, target, noTests, getFileLines, unused) {
     }
     const internalCount = symbols.length - exported.length;
 
-    const results = exported.map((s) => {
-      const fileLines = getFileLines(fn.file);
-
+    const buildSymbolResult = (s, fileLines) => {
       let consumers = db
         .prepare(
           `SELECT n.name, n.file, n.line FROM edges e JOIN nodes n ON e.source_id = n.id
@@ -100,12 +129,14 @@ function exportsFileImpl(db, target, noTests, getFileLines, unused) {
         line: s.line,
         endLine: s.end_line ?? null,
         role: s.role || null,
-        signature: fileLines ? extractSignature(fileLines, s.line) : null,
-        summary: fileLines ? extractSummary(fileLines, s.line) : null,
+        signature: fileLines ? extractSignature(fileLines, s.line, displayOpts) : null,
+        summary: fileLines ? extractSummary(fileLines, s.line, displayOpts) : null,
         consumers: consumers.map((c) => ({ name: c.name, file: c.file, line: c.line })),
         consumerCount: consumers.length,
       };
-    });
+    };
+
+    const results = exported.map((s) => buildSymbolResult(s, getFileLines(fn.file)));
 
     const totalUnused = results.filter((r) => r.consumerCount === 0).length;
 
@@ -118,18 +149,58 @@ function exportsFileImpl(db, target, noTests, getFileLines, unused) {
       .all(fn.id)
       .map((r) => ({ file: r.file }));
 
+    // For barrel files: gather symbols re-exported from target modules
+    const reexportTargets = db
+      .prepare(
+        `SELECT DISTINCT n.file FROM edges e JOIN nodes n ON e.target_id = n.id
+         WHERE e.source_id = ? AND e.kind = 'reexports'`,
+      )
+      .all(fn.id);
+
+    const reexportedSymbols = [];
+    for (const target of reexportTargets) {
+      let targetExported;
+      if (hasExportedCol) {
+        targetExported = db
+          .prepare(
+            "SELECT * FROM nodes WHERE file = ? AND kind != 'file' AND exported = 1 ORDER BY line",
+          )
+          .all(target.file);
+      } else {
+        // Fallback: same heuristic as direct exports — symbols called from other files
+        const targetSymbols = findNodesByFile(db, target.file);
+        const exportedIds = findCrossFileCallTargets(db, target.file);
+        targetExported = targetSymbols.filter((s) => exportedIds.has(s.id));
+      }
+      for (const s of targetExported) {
+        const fileLines = getFileLines(target.file);
+        reexportedSymbols.push({
+          ...buildSymbolResult(s, fileLines),
+          originFile: target.file,
+        });
+      }
+    }
+
     let filteredResults = results;
+    let filteredReexported = reexportedSymbols;
     if (unused) {
       filteredResults = results.filter((r) => r.consumerCount === 0);
+      filteredReexported = reexportedSymbols.filter((r) => r.consumerCount === 0);
     }
 
+    const totalReexported = reexportedSymbols.length;
+    const totalReexportedUnused = reexportedSymbols.filter((r) => r.consumerCount === 0).length;
+
     return {
       file: fn.file,
       results: filteredResults,
       reexports,
+      reexportedSymbols: filteredReexported,
       totalExported: exported.length,
       totalInternal: internalCount,
       totalUnused,
+      totalReexported,
+      totalReexportedUnused,
     };
   });
 }

package/src/domain/analysis/impact.js

@@ -5,6 +5,7 @@ import {
   findDbPath,
   findDistinctCallers,
   findFileNodes,
+  findImplementors,
   findImportDependents,
   findNodeById,
   openReadonlyOrFail,
@@ -21,20 +22,74 @@ import { findMatchingNodes } from './symbol-lookup.js';
 
 // ─── Shared BFS: transitive callers ────────────────────────────────────
 
+const INTERFACE_LIKE_KINDS = new Set(['interface', 'trait']);
+
+/**
+ * Check whether the graph contains any 'implements' edges.
+ * Cached per db handle so the query runs at most once per connection.
+ */
+const _hasImplementsCache = new WeakMap();
+function hasImplementsEdges(db) {
+  if (_hasImplementsCache.has(db)) return _hasImplementsCache.get(db);
+  const row = db.prepare("SELECT 1 FROM edges WHERE kind = 'implements' LIMIT 1").get();
+  const result = !!row;
+  _hasImplementsCache.set(db, result);
+  return result;
+}
+
 /**
  * BFS traversal to find transitive callers of a node.
+ * When an interface/trait node is encountered (either as the start node or
+ * during traversal), its concrete implementors are also added to the frontier
+ * so that changes to an interface signature propagate to all implementors.
  *
  * @param {import('better-sqlite3').Database} db - Open read-only SQLite database handle (not a Repository)
  * @param {number} startId - Starting node ID
- * @param {{ noTests?: boolean, maxDepth?: number, onVisit?: (caller: object, parentId: number, depth: number) => void }} options
+ * @param {{ noTests?: boolean, maxDepth?: number, includeImplementors?: boolean, onVisit?: (caller: object, parentId: number, depth: number) => void }} options
  * @returns {{ totalDependents: number, levels: Record<number, Array<{name:string, kind:string, file:string, line:number}>> }}
  */
-export function bfsTransitiveCallers(db, startId, { noTests = false, maxDepth = 3, onVisit } = {}) {
+export function bfsTransitiveCallers(
+  db,
+  startId,
+  { noTests = false, maxDepth = 3, includeImplementors = true, onVisit } = {},
+) {
+  // Skip all implementor lookups when the graph has no implements edges
+  const resolveImplementors = includeImplementors && hasImplementsEdges(db);
+
   const visited = new Set([startId]);
   const levels = {};
   let frontier = [startId];
 
+  // Seed: if start node is an interface/trait, include its implementors at depth 1.
+  // Implementors go into a separate list so their callers appear at depth 2, not depth 1.
+  const implNextFrontier = [];
+  if (resolveImplementors) {
+    const startNode = findNodeById(db, startId);
+    if (startNode && INTERFACE_LIKE_KINDS.has(startNode.kind)) {
+      const impls = findImplementors(db, startId);
+      for (const impl of impls) {
+        if (!visited.has(impl.id) && (!noTests || !isTestFile(impl.file))) {
+          visited.add(impl.id);
+          implNextFrontier.push(impl.id);
+          if (!levels[1]) levels[1] = [];
+          levels[1].push({
+            name: impl.name,
+            kind: impl.kind,
+            file: impl.file,
+            line: impl.line,
+            viaImplements: true,
+          });
+          if (onVisit) onVisit({ ...impl, viaImplements: true }, startId, 1);
+        }
+      }
+    }
+  }
+
   for (let d = 1; d <= maxDepth; d++) {
+    // On the first wave, merge seeded implementors so their callers appear at d=2
+    if (d === 1 && implNextFrontier.length > 0) {
+      frontier = [...frontier, ...implNextFrontier];
+    }
     const nextFrontier = [];
     for (const fid of frontier) {
       const callers = findDistinctCallers(db, fid);
@@ -46,6 +101,28 @@ export function bfsTransitiveCallers(db, startId, { noTests = false, maxDepth =
           levels[d].push({ name: c.name, kind: c.kind, file: c.file, line: c.line });
           if (onVisit) onVisit(c, fid, d);
         }
+
+        // If a caller is an interface/trait, also pull in its implementors
+        // Implementors are one extra hop away, so record at d+1
+        if (resolveImplementors && INTERFACE_LIKE_KINDS.has(c.kind)) {
+          const impls = findImplementors(db, c.id);
+          for (const impl of impls) {
+            if (!visited.has(impl.id) && (!noTests || !isTestFile(impl.file))) {
+              visited.add(impl.id);
+              nextFrontier.push(impl.id);
+              const implDepth = d + 1;
+              if (!levels[implDepth]) levels[implDepth] = [];
+              levels[implDepth].push({
+                name: impl.name,
+                kind: impl.kind,
+                file: impl.file,
+                line: impl.line,
+                viaImplements: true,
+              });
+              if (onVisit) onVisit({ ...impl, viaImplements: true }, c.id, implDepth);
+            }
+          }
+        }
       }
     }
     frontier = nextFrontier;
@@ -109,7 +186,8 @@ export function impactAnalysisData(file, customDbPath, opts = {}) {
 export function fnImpactData(name, customDbPath, opts = {}) {
   const db = openReadonlyOrFail(customDbPath);
   try {
-    const maxDepth = opts.depth || 5;
+    const config = opts.config || loadConfig();
+    const maxDepth = opts.depth || config.analysis?.fnImpactDepth || 5;
     const noTests = opts.noTests || false;
     const hc = new Map();
 
@@ -118,8 +196,14 @@ export function fnImpactData(name, customDbPath, opts = {}) {
       return { name, results: [] };
     }
 
+    const includeImplementors = opts.includeImplementors !== false;
+
     const results = nodes.map((node) => {
-      const { levels, totalDependents } = bfsTransitiveCallers(db, node.id, { noTests, maxDepth });
+      const { levels, totalDependents } = bfsTransitiveCallers(db, node.id, {
+        noTests,
+        maxDepth,
+        includeImplementors,
+      });
       return {
         ...normalizeSymbol(node, db, hc),
         levels,
@@ -261,7 +345,13 @@ function findAffectedFunctions(db, changedRanges, noTests) {
  * @param {number} maxDepth
  * @returns {{ functionResults: Array<object>, allAffected: Set<string> }}
  */
-function buildFunctionImpactResults(db, affectedFunctions, noTests, maxDepth) {
+function buildFunctionImpactResults(
+  db,
+  affectedFunctions,
+  noTests,
+  maxDepth,
+  includeImplementors = true,
+) {
   const allAffected = new Set();
   const functionResults = affectedFunctions.map((fn) => {
     const edges = [];
@@ -271,6 +361,7 @@ function buildFunctionImpactResults(db, affectedFunctions, noTests, maxDepth) {
     const { levels, totalDependents } = bfsTransitiveCallers(db, fn.id, {
       noTests,
       maxDepth,
+      includeImplementors,
       onVisit(c, parentId) {
         allAffected.add(`${c.file}:${c.name}`);
         const callerKey = `${c.file}::${c.name}:${c.line}`;
@@ -387,7 +478,8 @@ export function diffImpactData(customDbPath, opts = {}) {
   const db = openReadonlyOrFail(customDbPath);
   try {
     const noTests = opts.noTests || false;
-    const maxDepth = opts.depth || 3;
+    const config = opts.config || loadConfig();
+    const maxDepth = opts.depth || config.analysis?.impactDepth || 3;
 
     const dbPath = findDbPath(customDbPath);
     const repoRoot = path.resolve(path.dirname(dbPath), '..');
@@ -422,11 +514,13 @@ export function diffImpactData(customDbPath, opts = {}) {
     }
 
     const affectedFunctions = findAffectedFunctions(db, changedRanges, noTests);
+    const includeImplementors = opts.includeImplementors !== false;
     const { functionResults, allAffected } = buildFunctionImpactResults(
       db,
       affectedFunctions,
       noTests,
       maxDepth,
+      includeImplementors,
     );
 
     const affectedFiles = new Set();

package/src/domain/analysis/implementations.js

@@ -0,0 +1,98 @@
+import { findImplementors, findInterfaces, openReadonlyOrFail } from '../../db/index.js';
+import { isTestFile } from '../../infrastructure/test-filter.js';
+import { CORE_SYMBOL_KINDS } from '../../shared/kinds.js';
+import { normalizeSymbol } from '../../shared/normalize.js';
+import { paginateResult } from '../../shared/paginate.js';
+import { findMatchingNodes } from './symbol-lookup.js';
+
+/**
+ * Find all concrete types implementing a given interface/trait.
+ *
+ * @param {string} name - Interface/trait name (partial match)
+ * @param {string|undefined} customDbPath
+ * @param {{ noTests?: boolean, file?: string, kind?: string, limit?: number, offset?: number }} opts
+ * @returns {{ name: string, results: Array<{ name: string, kind: string, file: string, line: number, implementors: Array<{ name: string, kind: string, file: string, line: number }> }> }}
+ */
+export function implementationsData(name, customDbPath, opts = {}) {
+  const db = openReadonlyOrFail(customDbPath);
+  try {
+    const noTests = opts.noTests || false;
+    const hc = new Map();
+
+    const nodes = findMatchingNodes(db, name, {
+      noTests,
+      file: opts.file,
+      kind: opts.kind,
+      kinds: opts.kind ? undefined : CORE_SYMBOL_KINDS,
+    });
+    if (nodes.length === 0) {
+      return { name, results: [] };
+    }
+
+    const results = nodes.map((node) => {
+      let implementors = findImplementors(db, node.id);
+      if (noTests) implementors = implementors.filter((n) => !isTestFile(n.file));
+
+      return {
+        ...normalizeSymbol(node, db, hc),
+        implementors: implementors.map((impl) => ({
+          name: impl.name,
+          kind: impl.kind,
+          file: impl.file,
+          line: impl.line,
+        })),
+      };
+    });
+
+    const base = { name, results };
+    return paginateResult(base, 'results', { limit: opts.limit, offset: opts.offset });
+  } finally {
+    db.close();
+  }
+}
+
+/**
+ * Find all interfaces/traits that a given class/struct implements.
+ *
+ * @param {string} name - Class/struct name (partial match)
+ * @param {string|undefined} customDbPath
+ * @param {{ noTests?: boolean, file?: string, kind?: string, limit?: number, offset?: number }} opts
+ * @returns {{ name: string, results: Array<{ name: string, kind: string, file: string, line: number, interfaces: Array<{ name: string, kind: string, file: string, line: number }> }> }}
+ */
+export function interfacesData(name, customDbPath, opts = {}) {
+  const db = openReadonlyOrFail(customDbPath);
+  try {
+    const noTests = opts.noTests || false;
+    const hc = new Map();
+
+    const nodes = findMatchingNodes(db, name, {
+      noTests,
+      file: opts.file,
+      kind: opts.kind,
+      kinds: opts.kind ? undefined : CORE_SYMBOL_KINDS,
+    });
+    if (nodes.length === 0) {
+      return { name, results: [] };
+    }
+
+    const results = nodes.map((node) => {
+      let interfaces = findInterfaces(db, node.id);
+      if (noTests) interfaces = interfaces.filter((n) => !isTestFile(n.file));
+
+      return {
+        ...normalizeSymbol(node, db, hc),
+        interfaces: interfaces.map((iface) => ({
+          name: iface.name,
+          kind: iface.kind,
+          file: iface.file,
+          line: iface.line,
+        })),
+      };
+    });
+
+    const base = { name, results };
+    return paginateResult(base, 'results', { limit: opts.limit, offset: opts.offset });
+  } finally {
+    db.close();
+  }
+}