@optave/codegraph 2.1.1-dev.3c12b64 → 2.2.0

package/src/cli.js

@@ -11,7 +11,10 @@ import { buildEmbeddings, MODELS, search } from './embedder.js';
 import { exportDOT, exportJSON, exportMermaid } from './export.js';
 import { setVerbose } from './logger.js';
 import {
+  ALL_SYMBOL_KINDS,
+  context,
   diffImpact,
+  explain,
   fileDeps,
   fnDeps,
   fnImpact,
@@ -19,6 +22,7 @@ import {
   moduleMap,
   queryName,
   stats,
+  where,
 } from './queries.js';
 import {
   listRepos,
@@ -58,18 +62,20 @@ program
   .command('query <name>')
   .description('Find a function/class, show callers and callees')
   .option('-d, --db <path>', 'Path to graph.db')
+  .option('-T, --no-tests', 'Exclude test/spec files from results')
   .option('-j, --json', 'Output as JSON')
   .action((name, opts) => {
-    queryName(name, opts.db, { json: opts.json });
+    queryName(name, opts.db, { noTests: !opts.tests, json: opts.json });
   });
 
 program
   .command('impact <file>')
   .description('Show what depends on this file (transitive)')
   .option('-d, --db <path>', 'Path to graph.db')
+  .option('-T, --no-tests', 'Exclude test/spec files from results')
   .option('-j, --json', 'Output as JSON')
   .action((file, opts) => {
-    impactAnalysis(file, opts.db, { json: opts.json });
+    impactAnalysis(file, opts.db, { noTests: !opts.tests, json: opts.json });
   });
 
 program
@@ -77,27 +83,30 @@ program
   .description('High-level module overview with most-connected nodes')
   .option('-d, --db <path>', 'Path to graph.db')
   .option('-n, --limit <number>', 'Number of top nodes', '20')
+  .option('-T, --no-tests', 'Exclude test/spec files from results')
   .option('-j, --json', 'Output as JSON')
   .action((opts) => {
-    moduleMap(opts.db, parseInt(opts.limit, 10), { json: opts.json });
+    moduleMap(opts.db, parseInt(opts.limit, 10), { noTests: !opts.tests, json: opts.json });
   });
 
 program
   .command('stats')
   .description('Show graph health overview: nodes, edges, languages, cycles, hotspots, embeddings')
   .option('-d, --db <path>', 'Path to graph.db')
+  .option('-T, --no-tests', 'Exclude test/spec files from results')
   .option('-j, --json', 'Output as JSON')
   .action((opts) => {
-    stats(opts.db, { json: opts.json });
+    stats(opts.db, { noTests: !opts.tests, json: opts.json });
   });
 
 program
   .command('deps <file>')
   .description('Show what this file imports and what imports it')
   .option('-d, --db <path>', 'Path to graph.db')
+  .option('-T, --no-tests', 'Exclude test/spec files from results')
   .option('-j, --json', 'Output as JSON')
   .action((file, opts) => {
-    fileDeps(file, opts.db, { json: opts.json });
+    fileDeps(file, opts.db, { noTests: !opts.tests, json: opts.json });
   });
 
 program
@@ -105,11 +114,19 @@ program
   .description('Function-level dependencies: callers, callees, and transitive call chain')
   .option('-d, --db <path>', 'Path to graph.db')
   .option('--depth <n>', 'Transitive caller depth', '3')
+  .option('-f, --file <path>', 'Scope search to functions in this file (partial match)')
+  .option('-k, --kind <kind>', 'Filter to a specific symbol kind')
   .option('-T, --no-tests', 'Exclude test/spec files from results')
   .option('-j, --json', 'Output as JSON')
   .action((name, opts) => {
+    if (opts.kind && !ALL_SYMBOL_KINDS.includes(opts.kind)) {
+      console.error(`Invalid kind "${opts.kind}". Valid: ${ALL_SYMBOL_KINDS.join(', ')}`);
+      process.exit(1);
+    }
     fnDeps(name, opts.db, {
       depth: parseInt(opts.depth, 10),
+      file: opts.file,
+      kind: opts.kind,
       noTests: !opts.tests,
       json: opts.json,
     });
@@ -120,16 +137,77 @@ program
   .description('Function-level impact: what functions break if this one changes')
   .option('-d, --db <path>', 'Path to graph.db')
   .option('--depth <n>', 'Max transitive depth', '5')
+  .option('-f, --file <path>', 'Scope search to functions in this file (partial match)')
+  .option('-k, --kind <kind>', 'Filter to a specific symbol kind')
   .option('-T, --no-tests', 'Exclude test/spec files from results')
   .option('-j, --json', 'Output as JSON')
   .action((name, opts) => {
+    if (opts.kind && !ALL_SYMBOL_KINDS.includes(opts.kind)) {
+      console.error(`Invalid kind "${opts.kind}". Valid: ${ALL_SYMBOL_KINDS.join(', ')}`);
+      process.exit(1);
+    }
     fnImpact(name, opts.db, {
       depth: parseInt(opts.depth, 10),
+      file: opts.file,
+      kind: opts.kind,
+      noTests: !opts.tests,
+      json: opts.json,
+    });
+  });
+
+program
+  .command('context <name>')
+  .description('Full context for a function: source, deps, callers, tests, signature')
+  .option('-d, --db <path>', 'Path to graph.db')
+  .option('--depth <n>', 'Include callee source up to N levels deep', '0')
+  .option('-f, --file <path>', 'Scope search to functions in this file (partial match)')
+  .option('-k, --kind <kind>', 'Filter to a specific symbol kind')
+  .option('--no-source', 'Metadata only (skip source extraction)')
+  .option('--include-tests', 'Include test source code')
+  .option('-T, --no-tests', 'Exclude test/spec files from results')
+  .option('-j, --json', 'Output as JSON')
+  .action((name, opts) => {
+    if (opts.kind && !ALL_SYMBOL_KINDS.includes(opts.kind)) {
+      console.error(`Invalid kind "${opts.kind}". Valid: ${ALL_SYMBOL_KINDS.join(', ')}`);
+      process.exit(1);
+    }
+    context(name, opts.db, {
+      depth: parseInt(opts.depth, 10),
+      file: opts.file,
+      kind: opts.kind,
+      noSource: !opts.source,
       noTests: !opts.tests,
+      includeTests: opts.includeTests,
       json: opts.json,
     });
   });
 
+program
+  .command('explain <target>')
+  .description('Structural summary of a file or function (no LLM needed)')
+  .option('-d, --db <path>', 'Path to graph.db')
+  .option('-T, --no-tests', 'Exclude test/spec files from results')
+  .option('-j, --json', 'Output as JSON')
+  .action((target, opts) => {
+    explain(target, opts.db, { noTests: !opts.tests, json: opts.json });
+  });
+
+program
+  .command('where [name]')
+  .description('Find where a symbol is defined and used (minimal, fast lookup)')
+  .option('-d, --db <path>', 'Path to graph.db')
+  .option('-f, --file <path>', 'File overview: list symbols, imports, exports')
+  .option('-T, --no-tests', 'Exclude test/spec files from results')
+  .option('-j, --json', 'Output as JSON')
+  .action((name, opts) => {
+    if (!name && !opts.file) {
+      console.error('Provide a symbol name or use --file <path>');
+      process.exit(1);
+    }
+    const target = opts.file || name;
+    where(target, opts.db, { file: !!opts.file, noTests: !opts.tests, json: opts.json });
+  });
+
 program
   .command('diff-impact [ref]')
   .description('Show impact of git changes (unstaged, staged, or vs a ref)')
@@ -156,10 +234,11 @@ program
   .option('-d, --db <path>', 'Path to graph.db')
   .option('-f, --format <format>', 'Output format: dot, mermaid, json', 'dot')
   .option('--functions', 'Function-level graph instead of file-level')
+  .option('-T, --no-tests', 'Exclude test/spec files')
   .option('-o, --output <file>', 'Write to file instead of stdout')
   .action((opts) => {
     const db = new Database(findDbPath(opts.db), { readonly: true });
-    const exportOpts = { fileLevel: !opts.functions };
+    const exportOpts = { fileLevel: !opts.functions, noTests: !opts.tests };
 
     let output;
     switch (opts.format) {
@@ -167,7 +246,7 @@ program
         output = exportMermaid(db, exportOpts);
         break;
       case 'json':
-        output = JSON.stringify(exportJSON(db), null, 2);
+        output = JSON.stringify(exportJSON(db, exportOpts), null, 2);
         break;
       default:
         output = exportDOT(db, exportOpts);
@@ -189,10 +268,11 @@ program
   .description('Detect circular dependencies in the codebase')
   .option('-d, --db <path>', 'Path to graph.db')
   .option('--functions', 'Function-level cycle detection')
+  .option('-T, --no-tests', 'Exclude test/spec files')
   .option('-j, --json', 'Output as JSON')
   .action((opts) => {
     const db = new Database(findDbPath(opts.db), { readonly: true });
-    const cycles = findCycles(db, { fileLevel: !opts.functions });
+    const cycles = findCycles(db, { fileLevel: !opts.functions, noTests: !opts.tests });
     db.close();
 
     if (opts.json) {
@@ -322,7 +402,7 @@ program
   .option('-d, --db <path>', 'Path to graph.db')
   .option('-m, --model <name>', 'Override embedding model (auto-detects from DB)')
   .option('-n, --limit <number>', 'Max results', '15')
-  .option('-T, --no-tests', 'Exclude test/spec files')
+  .option('-T, --no-tests', 'Exclude test/spec files from results')
   .option('--min-score <score>', 'Minimum similarity threshold', '0.2')
   .option('-k, --kind <kind>', 'Filter by kind: function, method, class')
   .option('--file <pattern>', 'Filter by file path pattern')
@@ -347,6 +427,7 @@ program
   .option('-d, --db <path>', 'Path to graph.db')
   .option('--depth <n>', 'Max directory depth')
   .option('--sort <metric>', 'Sort by: cohesion | fan-in | fan-out | density | files', 'files')
+  .option('-T, --no-tests', 'Exclude test/spec files')
   .option('-j, --json', 'Output as JSON')
   .action(async (dir, opts) => {
     const { structureData, formatStructure } = await import('./structure.js');
@@ -354,6 +435,7 @@ program
       directory: dir,
       depth: opts.depth ? parseInt(opts.depth, 10) : undefined,
       sort: opts.sort,
+      noTests: !opts.tests,
     });
     if (opts.json) {
       console.log(JSON.stringify(data, null, 2));
@@ -371,6 +453,7 @@ program
   .option('-n, --limit <number>', 'Number of results', '10')
   .option('--metric <metric>', 'fan-in | fan-out | density | coupling', 'fan-in')
   .option('--level <level>', 'file | directory', 'file')
+  .option('-T, --no-tests', 'Exclude test/spec files from results')
   .option('-j, --json', 'Output as JSON')
   .action(async (opts) => {
     const { hotspotsData, formatHotspots } = await import('./structure.js');
@@ -378,6 +461,7 @@ program
       metric: opts.metric,
       level: opts.level,
       limit: parseInt(opts.limit, 10),
+      noTests: !opts.tests,
     });
     if (opts.json) {
       console.log(JSON.stringify(data, null, 2));

package/src/cycles.js

@@ -1,14 +1,16 @@
 import { loadNative } from './native.js';
+import { isTestFile } from './queries.js';
 
 /**
  * Detect circular dependencies in the codebase using Tarjan's SCC algorithm.
  * Dispatches to native Rust implementation when available, falls back to JS.
  * @param {object} db - Open SQLite database
- * @param {object} opts - { fileLevel: true }
+ * @param {object} opts - { fileLevel: true, noTests: false }
  * @returns {string[][]} Array of cycles, each cycle is an array of file paths
  */
 export function findCycles(db, opts = {}) {
   const fileLevel = opts.fileLevel !== false;
+  const noTests = opts.noTests || false;
 
   // Build adjacency list from SQLite (stays in JS — only the algorithm can move to Rust)
   let edges;
@@ -22,6 +24,9 @@ export function findCycles(db, opts = {}) {
       WHERE n1.file != n2.file AND e.kind IN ('imports', 'imports-type')
     `)
       .all();
+    if (noTests) {
+      edges = edges.filter((e) => !isTestFile(e.source) && !isTestFile(e.target));
+    }
   } else {
     edges = db
       .prepare(`
@@ -37,6 +42,13 @@ export function findCycles(db, opts = {}) {
         AND n1.id != n2.id
     `)
       .all();
+    if (noTests) {
+      edges = edges.filter((e) => {
+        const sourceFile = e.source.split('|').pop();
+        const targetFile = e.target.split('|').pop();
+        return !isTestFile(sourceFile) && !isTestFile(targetFile);
+      });
+    }
   }
 
   // Try native Rust implementation

package/src/db.js

@@ -67,6 +67,10 @@ export const MIGRATIONS = [
       );
     `,
   },
+  {
+    version: 4,
+    up: `ALTER TABLE file_hashes ADD COLUMN size INTEGER DEFAULT 0;`,
+  },
 ];
 
 export function openDb(dbPath) {

package/src/export.js

@@ -1,10 +1,12 @@
 import path from 'node:path';
+import { isTestFile } from './queries.js';
 
 /**
  * Export the dependency graph in DOT (Graphviz) format.
  */
 export function exportDOT(db, opts = {}) {
   const fileLevel = opts.fileLevel !== false;
+  const noTests = opts.noTests || false;
   const lines = [
     'digraph codegraph {',
     '  rankdir=LR;',
@@ -14,7 +16,7 @@ export function exportDOT(db, opts = {}) {
   ];
 
   if (fileLevel) {
-    const edges = db
+    let edges = db
       .prepare(`
       SELECT DISTINCT n1.file AS source, n2.file AS target
       FROM edges e
@@ -23,6 +25,7 @@ export function exportDOT(db, opts = {}) {
       WHERE n1.file != n2.file AND e.kind IN ('imports', 'imports-type', 'calls')
     `)
       .all();
+    if (noTests) edges = edges.filter((e) => !isTestFile(e.source) && !isTestFile(e.target));
 
     // Try to use directory nodes from DB (built by structure analysis)
     const hasDirectoryNodes =
@@ -89,7 +92,7 @@ export function exportDOT(db, opts = {}) {
       lines.push(`  "${source}" -> "${target}";`);
     }
   } else {
-    const edges = db
+    let edges = db
       .prepare(`
       SELECT n1.name AS source_name, n1.kind AS source_kind, n1.file AS source_file,
              n2.name AS target_name, n2.kind AS target_kind, n2.file AS target_file,
@@ -101,6 +104,8 @@ export function exportDOT(db, opts = {}) {
       AND e.kind = 'calls'
     `)
       .all();
+    if (noTests)
+      edges = edges.filter((e) => !isTestFile(e.source_file) && !isTestFile(e.target_file));
 
     for (const e of edges) {
       const sId = `${e.source_file}:${e.source_name}`.replace(/[^a-zA-Z0-9_]/g, '_');
@@ -120,10 +125,11 @@ export function exportDOT(db, opts = {}) {
  */
 export function exportMermaid(db, opts = {}) {
   const fileLevel = opts.fileLevel !== false;
+  const noTests = opts.noTests || false;
   const lines = ['graph LR'];
 
   if (fileLevel) {
-    const edges = db
+    let edges = db
       .prepare(`
       SELECT DISTINCT n1.file AS source, n2.file AS target
       FROM edges e
@@ -132,6 +138,7 @@ export function exportMermaid(db, opts = {}) {
       WHERE n1.file != n2.file AND e.kind IN ('imports', 'imports-type', 'calls')
     `)
       .all();
+    if (noTests) edges = edges.filter((e) => !isTestFile(e.source) && !isTestFile(e.target));
 
     for (const { source, target } of edges) {
       const s = source.replace(/[^a-zA-Z0-9]/g, '_');
@@ -139,7 +146,7 @@ export function exportMermaid(db, opts = {}) {
       lines.push(`  ${s}["${source}"] --> ${t}["${target}"]`);
     }
   } else {
-    const edges = db
+    let edges = db
       .prepare(`
       SELECT n1.name AS source_name, n1.file AS source_file,
              n2.name AS target_name, n2.file AS target_file
@@ -150,6 +157,8 @@ export function exportMermaid(db, opts = {}) {
       AND e.kind = 'calls'
     `)
       .all();
+    if (noTests)
+      edges = edges.filter((e) => !isTestFile(e.source_file) && !isTestFile(e.target_file));
 
     for (const e of edges) {
       const sId = `${e.source_file}_${e.source_name}`.replace(/[^a-zA-Z0-9]/g, '_');
@@ -164,14 +173,17 @@ export function exportMermaid(db, opts = {}) {
 /**
  * Export as JSON adjacency list.
  */
-export function exportJSON(db) {
-  const nodes = db
+export function exportJSON(db, opts = {}) {
+  const noTests = opts.noTests || false;
+
+  let nodes = db
     .prepare(`
     SELECT id, name, kind, file, line FROM nodes WHERE kind = 'file'
   `)
     .all();
+  if (noTests) nodes = nodes.filter((n) => !isTestFile(n.file));
 
-  const edges = db
+  let edges = db
     .prepare(`
     SELECT DISTINCT n1.file AS source, n2.file AS target, e.kind
     FROM edges e
@@ -180,6 +192,7 @@ export function exportJSON(db) {
     WHERE n1.file != n2.file
   `)
     .all();
+  if (noTests) edges = edges.filter((e) => !isTestFile(e.source) && !isTestFile(e.target));
 
   return { nodes, edges };
 }

package/src/extractors/csharp.js

@@ -186,7 +186,12 @@ export function extractCSharpSymbols(tree, _filePath) {
             calls.push({ name: fn.text, line: node.startPosition.row + 1 });
           } else if (fn.type === 'member_access_expression') {
             const name = fn.childForFieldName('name');
-            if (name) calls.push({ name: name.text, line: node.startPosition.row + 1 });
+            if (name) {
+              const expr = fn.childForFieldName('expression');
+              const call = { name: name.text, line: node.startPosition.row + 1 };
+              if (expr) call.receiver = expr.text;
+              calls.push(call);
+            }
           } else if (fn.type === 'generic_name' || fn.type === 'member_binding_expression') {
             const name = fn.childForFieldName('name') || fn.child(0);
             if (name) calls.push({ name: name.text, line: node.startPosition.row + 1 });

package/src/extractors/go.js

@@ -152,7 +152,12 @@ export function extractGoSymbols(tree, _filePath) {
             calls.push({ name: fn.text, line: node.startPosition.row + 1 });
           } else if (fn.type === 'selector_expression') {
             const field = fn.childForFieldName('field');
-            if (field) calls.push({ name: field.text, line: node.startPosition.row + 1 });
+            if (field) {
+              const operand = fn.childForFieldName('operand');
+              const call = { name: field.text, line: node.startPosition.row + 1 };
+              if (operand) call.receiver = operand.text;
+              calls.push(call);
+            }
           }
         }
         break;

package/src/extractors/java.js

@@ -203,7 +203,10 @@ export function extractJavaSymbols(tree, _filePath) {
       case 'method_invocation': {
         const nameNode = node.childForFieldName('name');
         if (nameNode) {
-          calls.push({ name: nameNode.text, line: node.startPosition.row + 1 });
+          const obj = node.childForFieldName('object');
+          const call = { name: nameNode.text, line: node.startPosition.row + 1 };
+          if (obj) call.receiver = obj.text;
+          calls.push(call);
         }
         break;
       }

package/src/extractors/javascript.js

@@ -140,6 +140,8 @@ export function extractSymbols(tree, _filePath) {
             calls.push(callInfo);
           }
         }
+        const cbDef = extractCallbackDefinition(node);
+        if (cbDef) definitions.push(cbDef);
         break;
       }
 
@@ -313,6 +315,18 @@ function extractImplementsFromNode(node) {
   return result;
 }
 
+function extractReceiverName(objNode) {
+  if (!objNode) return undefined;
+  if (objNode.type === 'identifier') return objNode.text;
+  if (objNode.type === 'this') return 'this';
+  if (objNode.type === 'super') return 'super';
+  if (objNode.type === 'member_expression') {
+    const prop = objNode.childForFieldName('property');
+    if (prop) return objNode.text;
+  }
+  return objNode.text;
+}
+
 function extractCallInfo(fn, callNode) {
   if (fn.type === 'identifier') {
     return { name: fn.text, line: callNode.startPosition.row + 1 };
@@ -335,21 +349,147 @@ function extractCallInfo(fn, callNode) {
 
     if (prop.type === 'string' || prop.type === 'string_fragment') {
       const methodName = prop.text.replace(/['"]/g, '');
-      if (methodName)
-        return { name: methodName, line: callNode.startPosition.row + 1, dynamic: true };
+      if (methodName) {
+        const receiver = extractReceiverName(obj);
+        return { name: methodName, line: callNode.startPosition.row + 1, dynamic: true, receiver };
+      }
     }
 
-    return { name: prop.text, line: callNode.startPosition.row + 1 };
+    const receiver = extractReceiverName(obj);
+    return { name: prop.text, line: callNode.startPosition.row + 1, receiver };
   }
 
   if (fn.type === 'subscript_expression') {
+    const obj = fn.childForFieldName('object');
     const index = fn.childForFieldName('index');
     if (index && (index.type === 'string' || index.type === 'template_string')) {
       const methodName = index.text.replace(/['"`]/g, '');
-      if (methodName && !methodName.includes('$'))
-        return { name: methodName, line: callNode.startPosition.row + 1, dynamic: true };
+      if (methodName && !methodName.includes('$')) {
+        const receiver = extractReceiverName(obj);
+        return { name: methodName, line: callNode.startPosition.row + 1, dynamic: true, receiver };
+      }
+    }
+  }
+
+  return null;
+}
+
+function findAnonymousCallback(argsNode) {
+  for (let i = 0; i < argsNode.childCount; i++) {
+    const child = argsNode.child(i);
+    if (child && (child.type === 'arrow_function' || child.type === 'function_expression')) {
+      return child;
+    }
+  }
+  return null;
+}
+
+function findFirstStringArg(argsNode) {
+  for (let i = 0; i < argsNode.childCount; i++) {
+    const child = argsNode.child(i);
+    if (child && child.type === 'string') {
+      return child.text.replace(/['"]/g, '');
     }
   }
+  return null;
+}
+
+function walkCallChain(startNode, methodName) {
+  let current = startNode;
+  while (current) {
+    if (current.type === 'call_expression') {
+      const fn = current.childForFieldName('function');
+      if (fn && fn.type === 'member_expression') {
+        const prop = fn.childForFieldName('property');
+        if (prop && prop.text === methodName) {
+          return current;
+        }
+      }
+    }
+    if (current.type === 'member_expression') {
+      const obj = current.childForFieldName('object');
+      current = obj;
+    } else if (current.type === 'call_expression') {
+      const fn = current.childForFieldName('function');
+      current = fn;
+    } else {
+      break;
+    }
+  }
+  return null;
+}
+
+const EXPRESS_METHODS = new Set([
+  'get',
+  'post',
+  'put',
+  'delete',
+  'patch',
+  'options',
+  'head',
+  'all',
+  'use',
+]);
+const EVENT_METHODS = new Set(['on', 'once', 'addEventListener', 'addListener']);
+
+function extractCallbackDefinition(callNode) {
+  const fn = callNode.childForFieldName('function');
+  if (!fn || fn.type !== 'member_expression') return null;
+
+  const prop = fn.childForFieldName('property');
+  if (!prop) return null;
+  const method = prop.text;
+
+  const args = callNode.childForFieldName('arguments') || findChild(callNode, 'arguments');
+  if (!args) return null;
+
+  // Commander: .action(callback) with .command('name') in chain
+  if (method === 'action') {
+    const cb = findAnonymousCallback(args);
+    if (!cb) return null;
+    const commandCall = walkCallChain(fn.childForFieldName('object'), 'command');
+    if (!commandCall) return null;
+    const cmdArgs =
+      commandCall.childForFieldName('arguments') || findChild(commandCall, 'arguments');
+    if (!cmdArgs) return null;
+    const cmdName = findFirstStringArg(cmdArgs);
+    if (!cmdName) return null;
+    const firstWord = cmdName.split(/\s/)[0];
+    return {
+      name: `command:${firstWord}`,
+      kind: 'function',
+      line: cb.startPosition.row + 1,
+      endLine: nodeEndLine(cb),
+    };
+  }
+
+  // Express: app.get('/path', callback)
+  if (EXPRESS_METHODS.has(method)) {
+    const strArg = findFirstStringArg(args);
+    if (!strArg || !strArg.startsWith('/')) return null;
+    const cb = findAnonymousCallback(args);
+    if (!cb) return null;
+    return {
+      name: `route:${method.toUpperCase()} ${strArg}`,
+      kind: 'function',
+      line: cb.startPosition.row + 1,
+      endLine: nodeEndLine(cb),
+    };
+  }
+
+  // Events: emitter.on('event', callback)
+  if (EVENT_METHODS.has(method)) {
+    const eventName = findFirstStringArg(args);
+    if (!eventName) return null;
+    const cb = findAnonymousCallback(args);
+    if (!cb) return null;
+    return {
+      name: `event:${eventName}`,
+      kind: 'function',
+      line: cb.startPosition.row + 1,
+      endLine: nodeEndLine(cb),
+    };
+  }
 
   return null;
 }

package/src/extractors/php.js

@@ -206,7 +206,10 @@ export function extractPHPSymbols(tree, _filePath) {
       case 'member_call_expression': {
         const name = node.childForFieldName('name');
         if (name) {
-          calls.push({ name: name.text, line: node.startPosition.row + 1 });
+          const obj = node.childForFieldName('object');
+          const call = { name: name.text, line: node.startPosition.row + 1 };
+          if (obj) call.receiver = obj.text;
+          calls.push(call);
         }
         break;
       }
@@ -214,7 +217,10 @@ export function extractPHPSymbols(tree, _filePath) {
       case 'scoped_call_expression': {
         const name = node.childForFieldName('name');
         if (name) {
-          calls.push({ name: name.text, line: node.startPosition.row + 1 });
+          const scope = node.childForFieldName('scope');
+          const call = { name: name.text, line: node.startPosition.row + 1 };
+          if (scope) call.receiver = scope.text;
+          calls.push(call);
         }
         break;
       }

package/src/extractors/python.js

@@ -69,12 +69,19 @@ export function extractPythonSymbols(tree, _filePath) {
         const fn = node.childForFieldName('function');
         if (fn) {
           let callName = null;
+          let receiver;
           if (fn.type === 'identifier') callName = fn.text;
           else if (fn.type === 'attribute') {
             const attr = fn.childForFieldName('attribute');
             if (attr) callName = attr.text;
+            const obj = fn.childForFieldName('object');
+            if (obj) receiver = obj.text;
+          }
+          if (callName) {
+            const call = { name: callName, line: node.startPosition.row + 1 };
+            if (receiver) call.receiver = receiver;
+            calls.push(call);
           }
-          if (callName) calls.push({ name: callName, line: node.startPosition.row + 1 });
         }
         break;
       }