Índice de Código Local para Agentes de Codificação: Resolve Importações Sem Servidor de Linguagem

Basemind é uma ferramenta Rust licenciada sob MIT que constrói um índice de código local para agentes de codificação de IA, resolvendo imports e construindo um grafo de chamadas sem um language server. Ele roda totalmente offline, sem etapa de build e sem daemon por linguagem, o que importa quando o repositório não compila porque um agente está no meio da edição.

A ferramenta categoriza o suporte a linguagens por profundidade de entendimento: JS/TS passa pelo oxc para uma árvore de escopo real, tabela de símbolos, resolução de import/export e aliases de caminho tsconfig em monorepos. Python e Java usam stack-graphs do GitHub (arquivado, mas forkado e mantido com quatro bugs corrigidos nas regras upstream que costumavam abortar a resolução em parâmetros splat tipados ou atribuições encadeadas). Todo o resto recebe apenas ligação léxica de escopo intra-arquivo.

371 gramáticas fazem parsing, cerca de 100 fornecem símbolos e chamadas, e três têm resolução real. A decisão de design chave: quando você pergunta pelos chamadores de uma função, ele retorna todos os locais de chamada que uma varredura de nomes encontra, anotados com quais a resolução conseguiu provar, em vez de apenas o subconjunto provado. Isso evita o modo de falha de uma versão anterior que filtrava para hits provados e relatava 2 chamadores em um arquivo com 172, sem flag de truncamento.

Performance: escanear o compilador TypeScript (81k arquivos) leva ~18 segundos em um M4; consultas ao histórico do git caem em dezenas de microssegundos, independentemente da profundidade do histórico. O índice vive em um cache local.

O autor concede que isto não é precisão LSP; para genéricos, macros, despacho dinâmico, contêineres DI e monkey-patching, um language server estará certo onde Basemind erra. Mas para agentes no meio da edição de um repositório que não compila, é uma alternativa prática.

Para quem é: Desenvolvedores construindo ou usando agentes de codificação de IA que precisam de navegação rápida e offline sem a sobrecarga de language servers.