Índice de código local para agentes de codificación: resuelve importaciones sin servidor de lenguaje

Basemind es una herramienta Rust con licencia MIT que construye un índice de código local para agentes de codificación de IA, resolviendo importaciones y creando un grafo de llamadas sin un servidor de lenguaje. Funciona completamente sin conexión, sin paso de compilación y sin demonio por lenguaje, lo que importa cuando el repositorio no compila porque un agente está a mitad de edición.

La herramienta clasifica el soporte de lenguajes según la profundidad de comprensión: JS/TS usa oxc para un árbol de alcance real, tabla de símbolos, resolución de importaciones/exportaciones y alias de rutas de tsconfig en monorepos. Python y Java usan stack-graphs de GitHub (archivado, pero bifurcado y mantenido con cuatro errores de reglas ascendentes corregidos que solían abortar la resolución en parámetros splat tipados o asignaciones encadenadas). Todo lo demás obtiene solo enlace de ámbito léxico dentro del archivo.

371 gramáticas analizan, unas 100 entregan símbolos y llamadas, y tres obtienen resolución real. La decisión de diseño clave: cuando se solicitan los llamadores de una función, devuelve todos los sitios de llamada que un escaneo de nombres encuentra, anotados con aquellos que la resolución pudo probar, en lugar de solo el subconjunto probado. Esto evita el modo de fallo de una versión anterior que filtraba a aciertos probados y reportaba 2 llamadores en un archivo con 172, sin indicador de truncamiento.

Rendimiento: escanear el compilador de TypeScript (81k archivos) toma ~18 segundos en un M4; las consultas de historial de git se resuelven en decenas de microsegundos independientemente de la profundidad del historial. El índice reside en una caché local.

El autor concede que esto no es precisión de LSP; para genéricos, macros, despacho dinámico, contenedores de DI y monkey-patching, un servidor de lenguaje será correcto donde Basemind se equivoca. Pero para agentes a mitad de edición en un repositorio que no compila, es una alternativa práctica.

Para quién es: Desarrolladores que construyen o usan agentes de codificación de IA que necesitan navegación de código rápida y sin conexión sin la sobrecarga de servidores de lenguaje.