Method execute

src/codegraph/tools.ts:182–242

(args: z.infer<typeof FindCallersArgs>, ctx: ToolContext)

  argsSchema = FindCallersArgs;

  async execute(args: z.infer<typeof FindCallersArgs>, ctx: ToolContext): Promise<ToolResult> {
    const db = requireDB();
    if ('error' in db) return { content: db.error, isError: true };

    // Build a set of definition locations to filter out from ripgrep results
    const defs = db.findSymbolsByName(args.name);
    const defKeys = new Set(defs.map(d => `${d.file_path}:${d.start_line}`));

    const escaped = args.name.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
    const pattern = `\\b${escaped}\\s*\\(`;
    const limit = args.limit ?? 100;

    const rgArgs = ['-n', '--no-heading', '--max-count', String(limit + defs.length), '-e', pattern];
    if (args.language) rgArgs.push('--type', args.language);
    rgArgs.push(ctx.cwd);

    const search = await runLineSearch(ctx.cwd, {
      rgArgs,
      regex: new RegExp(pattern),
      language: args.language,
      maxCount: limit + defs.length,
      signal: ctx.signal,
    });
    if ('error' in search) return { content: search.error, isError: true };

    const lines = search.stdout.split('\n').filter(Boolean);
    // Format: file:line:content
    const callers: Array<{ file: string; line: number; preview: string }> = [];
    for (const raw of lines) {
      const firstColon = raw.indexOf(':');
      const secondColon = raw.indexOf(':', firstColon + 1);
      if (firstColon === -1 || secondColon === -1) continue;
      const file = raw.slice(0, firstColon);
      const lineNum = parseInt(raw.slice(firstColon + 1, secondColon), 10);
      if (!Number.isFinite(lineNum)) continue;
      const preview = raw.slice(secondColon + 1).trim();
      // Filter out definition lines
      if (defKeys.has(`${file}:${lineNum}`)) continue;
      callers.push({ file, line: lineNum, preview: preview.slice(0, 200) });
      if (callers.length >= limit) break;
    }
    if (callers.length === 0) {
      return { content: `[NO_CALLERS] No call sites found for "${args.name}". Either it's only defined (never called from the indexed paths), or the project hasn't been indexed yet (try /index).` };
    }
    // Group by file
    const byFile = new Map<string, typeof callers>();
    for (const c of callers) {
      const rel = path.relative(ctx.cwd, c.file);
      if (!byFile.has(rel)) byFile.set(rel, []);
      byFile.get(rel)!.push(c);
    }
    const out: string[] = [`Found ${callers.length} call site${callers.length > 1 ? 's' : ''} for "${args.name}":`];
    for (const [rel, items] of byFile) {
      out.push(`\n  ${rel}`);
      for (const it of items) {
        out.push(`    :${it.line}  ${it.preview}`);
      }
    }