Method execute

src/codegraph/tools.ts:36–66

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

  argsSchema = FindSymbolArgs;

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

    const rows = db.findSymbolsByName(args.name, args.kind);
    if (rows.length === 0) {
      // Try prefix search as a hint
      const prefixMatches = db.searchSymbolsByPrefix(args.name, args.kind, 10);
      if (prefixMatches.length > 0) {
        const hints = prefixMatches.slice(0, 8).map(r => `  ${r.kind} ${r.name}  → ${path.relative(ctx.cwd, r.file_path)}:${r.start_line}`).join('\n');
        return {
          content: `[NOT_FOUND] No ${args.kind ?? 'symbol'} named exactly "${args.name}". Did you mean one of:\n${hints}`,
          isError: false,
        };
      }
      return {
        content: `[NOT_FOUND] No ${args.kind ?? 'symbol'} named "${args.name}" in the indexed codebase. If you recently added it, run /index to refresh.`,
        isError: false,
      };
    }

    const lines = rows.map(r => {
      const rel = path.relative(ctx.cwd, r.file_path);
      const sig = r.signature ? `    ${r.signature}` : '';
      return `${r.kind} ${r.name}  → ${rel}:${r.start_line}${sig ? '\n' + sig : ''}`;
    });
    return {
      content: `Found ${rows.length} definition${rows.length > 1 ? 's' : ''}:\n${lines.join('\n')}`,
      metadata: { count: rows.length },
    };
  }
}

// ---------------- search_symbols (prefix) ----------------