@optave/codegraph 3.1.5 → 3.3.0

package/src/cli/commands/check.js

@@ -1,7 +1,24 @@
+import { collectFile } from '../../db/query-builder.js';
 import { EVERY_SYMBOL_KIND } from '../../domain/queries.js';
 import { ConfigError } from '../../shared/errors.js';
 import { config } from '../shared/options.js';
 
+function validateKind(kind) {
+  if (kind && !EVERY_SYMBOL_KIND.includes(kind)) {
+    throw new ConfigError(`Invalid kind "${kind}". Valid: ${EVERY_SYMBOL_KIND.join(', ')}`);
+  }
+}
+
+async function runManifesto(opts, qOpts) {
+  validateKind(opts.kind);
+  const { manifesto } = await import('../../presentation/manifesto.js');
+  manifesto(opts.db, {
+    file: opts.file,
+    kind: opts.kind,
+    ...qOpts,
+  });
+}
+
 export const command = {
   name: 'check [ref]',
   description:
@@ -15,7 +32,7 @@ export const command = {
     ['--signatures', 'Assert no function declaration lines were modified'],
     ['--boundaries', 'Assert no cross-owner boundary violations'],
     ['--depth <n>', 'Max BFS depth for blast radius (default: 3)'],
-    ['-f, --file <path>', 'Scope to file (partial match, manifesto mode)'],
+    ['-f, --file <path>', 'Scope to file (partial match, repeatable, manifesto mode)', collectFile],
     ['-k, --kind <kind>', 'Filter by symbol kind (manifesto mode)'],
     ['-T, --no-tests', 'Exclude test/spec files from results'],
     ['--include-tests', 'Include test/spec files (overrides excludeTests config)'],
@@ -29,17 +46,7 @@ export const command = {
     const qOpts = ctx.resolveQueryOpts(opts);
 
     if (!isDiffMode && !opts.rules) {
-      if (opts.kind && !EVERY_SYMBOL_KIND.includes(opts.kind)) {
-        throw new ConfigError(
-          `Invalid kind "${opts.kind}". Valid: ${EVERY_SYMBOL_KIND.join(', ')}`,
-        );
-      }
-      const { manifesto } = await import('../../presentation/manifesto.js');
-      manifesto(opts.db, {
-        file: opts.file,
-        kind: opts.kind,
-        ...qOpts,
-      });
+      await runManifesto(opts, qOpts);
       return;
     }
 
@@ -58,17 +65,7 @@ export const command = {
     });
 
     if (opts.rules) {
-      if (opts.kind && !EVERY_SYMBOL_KIND.includes(opts.kind)) {
-        throw new ConfigError(
-          `Invalid kind "${opts.kind}". Valid: ${EVERY_SYMBOL_KIND.join(', ')}`,
-        );
-      }
-      const { manifesto } = await import('../../presentation/manifesto.js');
-      manifesto(opts.db, {
-        file: opts.file,
-        kind: opts.kind,
-        ...qOpts,
-      });
+      await runManifesto(opts, qOpts);
     }
   },
 };

package/src/cli/commands/children.js

@@ -1,3 +1,4 @@
+import { collectFile } from '../../db/query-builder.js';
 import { EVERY_SYMBOL_KIND } from '../../domain/queries.js';
 import { children } from '../../presentation/queries-cli.js';
 
@@ -6,7 +7,11 @@ export const command = {
   description: 'List parameters, properties, and constants of a symbol',
   options: [
     ['-d, --db <path>', 'Path to graph.db'],
-    ['-f, --file <path>', 'Scope search to symbols in this file (partial match)'],
+    [
+      '-f, --file <path>',
+      'Scope search to symbols in this file (partial match, repeatable)',
+      collectFile,
+    ],
     ['-k, --kind <kind>', 'Filter to a specific symbol kind'],
     ['-T, --no-tests', 'Exclude test/spec files from results'],
     ['-j, --json', 'Output as JSON'],

package/src/cli/commands/complexity.js

@@ -1,3 +1,4 @@
+import { collectFile } from '../../db/query-builder.js';
 import { EVERY_SYMBOL_KIND } from '../../domain/queries.js';
 
 export const command = {
@@ -13,7 +14,7 @@ export const command = {
     ],
     ['--above-threshold', 'Only functions exceeding warn thresholds'],
     ['--health', 'Show health metrics (Halstead, MI) columns'],
-    ['-f, --file <path>', 'Scope to file (partial match)'],
+    ['-f, --file <path>', 'Scope to file (partial match, repeatable)', collectFile],
     ['-k, --kind <kind>', 'Filter by symbol kind'],
     ['-T, --no-tests', 'Exclude test/spec files from results'],
     ['--include-tests', 'Include test/spec files (overrides excludeTests config)'],

package/src/cli/commands/context.js

@@ -1,3 +1,4 @@
+import { collectFile } from '../../db/query-builder.js';
 import { EVERY_SYMBOL_KIND } from '../../domain/queries.js';
 import { context } from '../../presentation/queries-cli.js';
 
@@ -7,7 +8,11 @@ export const command = {
   queryOpts: true,
   options: [
     ['--depth <n>', 'Include callee source up to N levels deep', '0'],
-    ['-f, --file <path>', 'Scope search to functions in this file (partial match)'],
+    [
+      '-f, --file <path>',
+      'Scope search to functions in this file (partial match, repeatable)',
+      collectFile,
+    ],
     ['-k, --kind <kind>', 'Filter to a specific symbol kind'],
     ['--no-source', 'Metadata only (skip source extraction)'],
     ['--with-test-source', 'Include test source code'],

package/src/cli/commands/dataflow.js

@@ -1,3 +1,4 @@
+import { collectFile } from '../../db/query-builder.js';
 import { EVERY_SYMBOL_KIND } from '../../domain/queries.js';
 
 export const command = {
@@ -5,7 +6,7 @@ export const command = {
   description: 'Show data flow for a function: parameters, return consumers, mutations',
   queryOpts: true,
   options: [
-    ['-f, --file <path>', 'Scope to file (partial match)'],
+    ['-f, --file <path>', 'Scope to file (partial match, repeatable)', collectFile],
     ['-k, --kind <kind>', 'Filter by symbol kind'],
     ['--impact', 'Show data-dependent blast radius'],
     ['--depth <n>', 'Max traversal depth', '5'],

package/src/cli/commands/deps.js

@@ -1,12 +1,17 @@
+import { brief } from '../../presentation/brief.js';
 import { fileDeps } from '../../presentation/queries-cli.js';
 
 export const command = {
   name: 'deps <file>',
   description: 'Show what this file imports and what imports it',
   queryOpts: true,
+  options: [['--brief', 'Compact output with symbol roles, caller counts, and risk tier']],
   execute([file], opts, ctx) {
-    fileDeps(file, opts.db, {
-      ...ctx.resolveQueryOpts(opts),
-    });
+    const qOpts = ctx.resolveQueryOpts(opts);
+    if (opts.brief) {
+      brief(file, opts.db, qOpts);
+    } else {
+      fileDeps(file, opts.db, qOpts);
+    }
   },
 };

package/src/cli/commands/diff-impact.js

@@ -13,6 +13,7 @@ export const command = {
     ['--staged', 'Analyze staged changes instead of unstaged'],
     ['--depth <n>', 'Max transitive caller depth', '3'],
     ['-f, --format <format>', 'Output format: text, mermaid, json', 'text'],
+    ['--no-implementations', 'Exclude interface/trait implementors from blast radius'],
   ],
   execute([ref], opts, ctx) {
     diffImpact(opts.db, {
@@ -20,6 +21,7 @@ export const command = {
       staged: opts.staged,
       depth: parseInt(opts.depth, 10),
       format: opts.format,
+      includeImplementors: opts.implementations !== false,
       ...ctx.resolveQueryOpts(opts),
     });
   },

package/src/cli/commands/flow.js

@@ -1,3 +1,4 @@
+import { collectFile } from '../../db/query-builder.js';
 import { EVERY_SYMBOL_KIND } from '../../domain/queries.js';
 
 export const command = {
@@ -8,7 +9,7 @@ export const command = {
   options: [
     ['--list', 'List all entry points grouped by type'],
     ['--depth <n>', 'Max forward traversal depth', '10'],
-    ['-f, --file <path>', 'Scope to a specific file (partial match)'],
+    ['-f, --file <path>', 'Scope to a specific file (partial match, repeatable)', collectFile],
     ['-k, --kind <kind>', 'Filter by symbol kind'],
   ],
   validate([name], opts) {

package/src/cli/commands/fn-impact.js

@@ -1,3 +1,4 @@
+import { collectFile } from '../../db/query-builder.js';
 import { EVERY_SYMBOL_KIND } from '../../domain/queries.js';
 import { fnImpact } from '../../presentation/queries-cli.js';
 
@@ -7,8 +8,13 @@ export const command = {
   queryOpts: true,
   options: [
     ['--depth <n>', 'Max transitive depth', '5'],
-    ['-f, --file <path>', 'Scope search to functions in this file (partial match)'],
+    [
+      '-f, --file <path>',
+      'Scope search to functions in this file (partial match, repeatable)',
+      collectFile,
+    ],
     ['-k, --kind <kind>', 'Filter to a specific symbol kind'],
+    ['--no-implementations', 'Exclude interface/trait implementors from blast radius'],
   ],
   validate([_name], opts) {
     if (opts.kind && !EVERY_SYMBOL_KIND.includes(opts.kind)) {
@@ -20,6 +26,7 @@ export const command = {
       depth: parseInt(opts.depth, 10),
       file: opts.file,
       kind: opts.kind,
+      includeImplementors: opts.implementations !== false,
       ...ctx.resolveQueryOpts(opts),
     });
   },

package/src/cli/commands/implementations.js

@@ -0,0 +1,29 @@
+import { collectFile } from '../../db/query-builder.js';
+import { EVERY_SYMBOL_KIND } from '../../domain/queries.js';
+import { implementations } from '../../presentation/queries-cli.js';
+
+export const command = {
+  name: 'implementations <name>',
+  description: 'List all concrete types implementing a given interface or trait',
+  queryOpts: true,
+  options: [
+    [
+      '-f, --file <path>',
+      'Scope search to symbols in this file (partial match, repeatable)',
+      collectFile,
+    ],
+    ['-k, --kind <kind>', 'Filter to a specific symbol kind'],
+  ],
+  validate([_name], opts) {
+    if (opts.kind && !EVERY_SYMBOL_KIND.includes(opts.kind)) {
+      return `Invalid kind "${opts.kind}". Valid: ${EVERY_SYMBOL_KIND.join(', ')}`;
+    }
+  },
+  execute([name], opts, ctx) {
+    implementations(name, opts.db, {
+      file: opts.file,
+      kind: opts.kind,
+      ...ctx.resolveQueryOpts(opts),
+    });
+  },
+};

package/src/cli/commands/info.js

@@ -25,7 +25,7 @@ export const command = {
       const knownBinaryVersion = binaryVersion !== 'unknown' ? binaryVersion : null;
       if (pkgVersion && knownBinaryVersion && pkgVersion !== knownBinaryVersion) {
         console.log(
-          `  Native version: ${pkgVersion} (binary reports ${knownBinaryVersion} — stale)`,
+          `  Native version: ${pkgVersion} (binary built as ${knownBinaryVersion}, engine loaded OK)`,
         );
       } else {
         console.log(`  Native version: ${pkgVersion ?? binaryVersion}`);

package/src/cli/commands/interfaces.js

@@ -0,0 +1,29 @@
+import { collectFile } from '../../db/query-builder.js';
+import { EVERY_SYMBOL_KIND } from '../../domain/queries.js';
+import { interfaces } from '../../presentation/queries-cli.js';
+
+export const command = {
+  name: 'interfaces <name>',
+  description: 'List all interfaces and traits that a class or struct implements',
+  queryOpts: true,
+  options: [
+    [
+      '-f, --file <path>',
+      'Scope search to symbols in this file (partial match, repeatable)',
+      collectFile,
+    ],
+    ['-k, --kind <kind>', 'Filter to a specific symbol kind'],
+  ],
+  validate([_name], opts) {
+    if (opts.kind && !EVERY_SYMBOL_KIND.includes(opts.kind)) {
+      return `Invalid kind "${opts.kind}". Valid: ${EVERY_SYMBOL_KIND.join(', ')}`;
+    }
+  },
+  execute([name], opts, ctx) {
+    interfaces(name, opts.db, {
+      file: opts.file,
+      kind: opts.kind,
+      ...ctx.resolveQueryOpts(opts),
+    });
+  },
+};

package/src/cli/commands/owners.js

@@ -1,3 +1,5 @@
+import { collectFile } from '../../db/query-builder.js';
+
 export const command = {
   name: 'owners [target]',
   description: 'Show CODEOWNERS mapping for files and functions',
@@ -5,7 +7,7 @@ export const command = {
     ['-d, --db <path>', 'Path to graph.db'],
     ['--owner <owner>', 'Filter to a specific owner'],
     ['--boundary', 'Show cross-owner boundary edges'],
-    ['-f, --file <path>', 'Scope to a specific file'],
+    ['-f, --file <path>', 'Scope to a specific file (repeatable)', collectFile],
     ['-k, --kind <kind>', 'Filter by symbol kind'],
     ['-T, --no-tests', 'Exclude test/spec files'],
     ['--include-tests', 'Include test/spec files (overrides excludeTests config)'],
@@ -16,7 +18,7 @@ export const command = {
     owners(opts.db, {
       owner: opts.owner,
       boundary: opts.boundary,
-      file: opts.file || target,
+      file: opts.file && opts.file.length > 0 ? opts.file : target,
       kind: opts.kind,
       noTests: ctx.resolveNoTests(opts),
       json: opts.json,

package/src/cli/commands/query.js

@@ -1,3 +1,4 @@
+import { collectFile } from '../../db/query-builder.js';
 import { EVERY_SYMBOL_KIND } from '../../domain/queries.js';
 import { fnDeps, symbolPath } from '../../presentation/queries-cli.js';
 
@@ -7,7 +8,11 @@ export const command = {
   queryOpts: true,
   options: [
     ['--depth <n>', 'Transitive caller depth', '3'],
-    ['-f, --file <path>', 'Scope search to functions in this file (partial match)'],
+    [
+      '-f, --file <path>',
+      'Scope search to functions in this file (partial match, repeatable)',
+      collectFile,
+    ],
     ['-k, --kind <kind>', 'Filter to a specific symbol kind'],
     ['--path <to>', 'Path mode: find shortest path to <to>'],
     ['--kinds <kinds>', 'Path mode: comma-separated edge kinds to follow (default: calls)'],

package/src/cli/commands/roles.js

@@ -1,13 +1,15 @@
+import { collectFile } from '../../db/query-builder.js';
 import { VALID_ROLES } from '../../domain/queries.js';
 import { roles } from '../../presentation/queries-cli.js';
 
 export const command = {
   name: 'roles',
-  description: 'Show node role classification: entry, core, utility, adapter, dead, leaf',
+  description:
+    'Show node role classification: entry, core, utility, adapter, dead (dead-leaf, dead-entry, dead-ffi, dead-unresolved), leaf',
   options: [
     ['-d, --db <path>', 'Path to graph.db'],
     ['--role <role>', `Filter by role (${VALID_ROLES.join(', ')})`],
-    ['-f, --file <path>', 'Scope to a specific file (partial match)'],
+    ['-f, --file <path>', 'Scope to a specific file (partial match, repeatable)', collectFile],
     ['-T, --no-tests', 'Exclude test/spec files'],
     ['--include-tests', 'Include test/spec files (overrides excludeTests config)'],
     ['-j, --json', 'Output as JSON'],

package/src/cli/commands/search.js

@@ -1,3 +1,4 @@
+import { collectFile } from '../../db/query-builder.js';
 import { search } from '../../domain/search/index.js';
 
 export const command = {
@@ -11,7 +12,7 @@ export const command = {
     ['--include-tests', 'Include test/spec files (overrides excludeTests config)'],
     ['--min-score <score>', 'Minimum similarity threshold', '0.2'],
     ['-k, --kind <kind>', 'Filter by kind: function, method, class'],
-    ['--file <pattern>', 'Filter by file path pattern'],
+    ['--file <pattern>', 'Filter by file path pattern (repeatable)', collectFile],
     ['--rrf-k <number>', 'RRF k parameter for multi-query ranking', '60'],
     ['--mode <mode>', 'Search mode: hybrid, semantic, keyword (default: hybrid)'],
     ['-j, --json', 'Output as JSON'],
@@ -25,6 +26,11 @@ export const command = {
     }
   },
   async execute([query], opts, ctx) {
+    // --file collects into an array; pass single element unwrapped for single
+    // value, or pass the raw array for multi-file scoping.
+    const fileArr = opts.file || [];
+    const filePattern =
+      fileArr.length === 1 ? fileArr[0] : fileArr.length > 1 ? fileArr : undefined;
     await search(query, opts.db, {
       limit: parseInt(opts.limit, 10),
       offset: opts.offset ? parseInt(opts.offset, 10) : undefined,
@@ -32,7 +38,7 @@ export const command = {
       minScore: parseFloat(opts.minScore),
       model: opts.model,
       kind: opts.kind,
-      filePattern: opts.file,
+      filePattern,
       rrfK: parseInt(opts.rrfK, 10),
       mode: opts.mode,
       json: opts.json,

package/src/cli/commands/sequence.js

@@ -1,3 +1,4 @@
+import { collectFile } from '../../db/query-builder.js';
 import { EVERY_SYMBOL_KIND } from '../../domain/queries.js';
 
 export const command = {
@@ -7,7 +8,7 @@ export const command = {
   options: [
     ['--depth <n>', 'Max forward traversal depth', '10'],
     ['--dataflow', 'Annotate with parameter names and return arrows from dataflow table'],
-    ['-f, --file <path>', 'Scope to a specific file (partial match)'],
+    ['-f, --file <path>', 'Scope to a specific file (partial match, repeatable)', collectFile],
     ['-k, --kind <kind>', 'Filter by symbol kind'],
   ],
   validate([_name], opts) {

package/src/cli/commands/triage.js

@@ -1,6 +1,40 @@
+import { collectFile } from '../../db/query-builder.js';
 import { EVERY_SYMBOL_KIND, VALID_ROLES } from '../../domain/queries.js';
 import { ConfigError } from '../../shared/errors.js';
 
+function validateFilters(opts) {
+  if (opts.kind && !EVERY_SYMBOL_KIND.includes(opts.kind)) {
+    throw new ConfigError(`Invalid kind "${opts.kind}". Valid: ${EVERY_SYMBOL_KIND.join(', ')}`);
+  }
+  if (opts.role && !VALID_ROLES.includes(opts.role)) {
+    throw new ConfigError(`Invalid role "${opts.role}". Valid: ${VALID_ROLES.join(', ')}`);
+  }
+}
+
+function parseWeights(raw) {
+  if (!raw) return undefined;
+  try {
+    return JSON.parse(raw);
+  } catch (err) {
+    throw new ConfigError('Invalid --weights JSON', { cause: err });
+  }
+}
+
+async function runHotspots(opts, ctx) {
+  const { hotspotsData, formatHotspots } = await import('../../presentation/structure.js');
+  const metric = opts.sort === 'risk' ? 'fan-in' : opts.sort;
+  const data = hotspotsData(opts.db, {
+    metric,
+    level: opts.level,
+    limit: parseInt(opts.limit, 10),
+    offset: opts.offset ? parseInt(opts.offset, 10) : undefined,
+    noTests: ctx.resolveNoTests(opts),
+  });
+  if (!ctx.outputResult(data, 'hotspots', opts)) {
+    console.log(formatHotspots(data));
+  }
+}
+
 export const command = {
   name: 'triage',
   description:
@@ -19,8 +53,11 @@ export const command = {
       'risk',
     ],
     ['--min-score <score>', 'Only show symbols with risk score >= threshold'],
-    ['--role <role>', 'Filter by role (entry, core, utility, adapter, leaf, dead)'],
-    ['-f, --file <path>', 'Scope to a specific file (partial match)'],
+    [
+      '--role <role>',
+      'Filter by role (entry, core, utility, adapter, leaf, dead, dead-leaf, dead-entry, dead-ffi, dead-unresolved)',
+    ],
+    ['-f, --file <path>', 'Scope to a specific file (partial match, repeatable)', collectFile],
     ['-k, --kind <kind>', 'Filter by symbol kind (function, method, class)'],
     ['-T, --no-tests', 'Exclude test/spec files from results'],
     ['--include-tests', 'Include test/spec files (overrides excludeTests config)'],
@@ -31,35 +68,12 @@ export const command = {
   ],
   async execute(_args, opts, ctx) {
     if (opts.level === 'file' || opts.level === 'directory') {
-      const { hotspotsData, formatHotspots } = await import('../../presentation/structure.js');
-      const metric = opts.sort === 'risk' ? 'fan-in' : opts.sort;
-      const data = hotspotsData(opts.db, {
-        metric,
-        level: opts.level,
-        limit: parseInt(opts.limit, 10),
-        offset: opts.offset ? parseInt(opts.offset, 10) : undefined,
-        noTests: ctx.resolveNoTests(opts),
-      });
-      if (!ctx.outputResult(data, 'hotspots', opts)) {
-        console.log(formatHotspots(data));
-      }
+      await runHotspots(opts, ctx);
       return;
     }
 
-    if (opts.kind && !EVERY_SYMBOL_KIND.includes(opts.kind)) {
-      throw new ConfigError(`Invalid kind "${opts.kind}". Valid: ${EVERY_SYMBOL_KIND.join(', ')}`);
-    }
-    if (opts.role && !VALID_ROLES.includes(opts.role)) {
-      throw new ConfigError(`Invalid role "${opts.role}". Valid: ${VALID_ROLES.join(', ')}`);
-    }
-    let weights;
-    if (opts.weights) {
-      try {
-        weights = JSON.parse(opts.weights);
-      } catch (err) {
-        throw new ConfigError('Invalid --weights JSON', { cause: err });
-      }
-    }
+    validateFilters(opts);
+    const weights = parseWeights(opts.weights);
     const { triage } = await import('../../presentation/triage.js');
     triage(opts.db, {
       limit: parseInt(opts.limit, 10),

package/src/db/connection.js

@@ -37,10 +37,12 @@ export function findRepoRoot(fromDir) {
     // matches the realpathSync'd dir in findDbPath.
     try {
       root = fs.realpathSync(raw);
-    } catch {
+    } catch (e) {
+      debug(`realpathSync failed for git root "${raw}", using resolve: ${e.message}`);
       root = path.resolve(raw);
     }
-  } catch {
+  } catch (e) {
+    debug(`git rev-parse failed for "${dir}": ${e.message}`);
     root = null;
   }
   if (!fromDir) {
@@ -60,7 +62,8 @@ function isProcessAlive(pid) {
   try {
     process.kill(pid, 0);
     return true;
-  } catch {
+  } catch (e) {
+    debug(`PID ${pid} not alive: ${e.code || e.message}`);
     return false;
   }
 }
@@ -75,13 +78,13 @@ function acquireAdvisoryLock(dbPath) {
         warn(`Another process (PID ${pid}) may be using this database. Proceeding with caution.`);
       }
     }
-  } catch {
-    /* ignore read errors */
+  } catch (e) {
+    debug(`Advisory lock read failed: ${e.message}`);
   }
   try {
     fs.writeFileSync(lockPath, String(process.pid), 'utf-8');
-  } catch {
-    /* best-effort */
+  } catch (e) {
+    debug(`Advisory lock write failed: ${e.message}`);
   }
 }
 
@@ -91,8 +94,8 @@ function releaseAdvisoryLock(lockPath) {
     if (Number(content) === process.pid) {
       fs.unlinkSync(lockPath);
     }
-  } catch {
-    /* ignore */
+  } catch (e) {
+    debug(`Advisory lock release failed for ${lockPath}: ${e.message}`);
   }
 }
 
@@ -107,7 +110,8 @@ function isSameDirectory(a, b) {
     const sa = fs.statSync(a);
     const sb = fs.statSync(b);
     return sa.dev === sb.dev && sa.ino === sb.ino;
-  } catch {
+  } catch (e) {
+    debug(`isSameDirectory stat failed: ${e.message}`);
     return false;
   }
 }
@@ -139,7 +143,8 @@ export function findDbPath(customPath) {
   if (rawCeiling) {
     try {
       ceiling = fs.realpathSync(rawCeiling);
-    } catch {
+    } catch (e) {
+      debug(`realpathSync failed for ceiling "${rawCeiling}": ${e.message}`);
       ceiling = rawCeiling;
     }
   } else {
@@ -149,7 +154,8 @@ export function findDbPath(customPath) {
   let dir;
   try {
     dir = fs.realpathSync(process.cwd());
-  } catch {
+  } catch (e) {
+    debug(`realpathSync failed for cwd: ${e.message}`);
     dir = process.cwd();
   }
   while (true) {

package/src/db/index.js

@@ -31,9 +31,11 @@ export {
   findCrossFileCallTargets,
   findDistinctCallers,
   findFileNodes,
+  findImplementors,
   findImportDependents,
   findImportSources,
   findImportTargets,
+  findInterfaces,
   findIntraFileCallEdges,
   findNodeById,
   findNodeByQualifiedName,