Локальный индекс кода для агентов программирования: разрешение импортов без языкового сервера

Basemind — это инструмент на Rust с лицензией MIT, который создает локальный индекс кода для ИИ-агентов, разрешая импорты и строя граф вызовов без языкового сервера. Он работает полностью офлайн, без этапа сборки и без демона для каждого языка, что важно, когда репозиторий не компилируется, потому что агент находится на полпути к его редактированию.

Инструмент распределяет поддержку языков по глубине понимания: JS/TS проходит через oxc для реального дерева областей, таблицы символов, разрешения импорта/экспорта и псевдонимов путей tsconfig в монорепозиториях. Python и Java используют GitHub's stack-graphs (архивированные, но форкнутые и поддерживаемые с исправлением четырех ошибок в правилах, которые ранее приводили к сбоям разрешения на типизированных параметрах splat или цепных присваиваниях). Все остальное получает только лексическое связывание областей в пределах файла.

371 грамматика разбирает, около 100 дают символы и вызовы, и три получают реальное разрешение. Ключевое дизайнерское решение: когда вы запрашиваете вызывающие функции, он возвращает все места вызовов, найденные сканированием имен, с аннотацией, какие из них разрешение могло доказать, а не только доказанное подмножество. Это позволяет избежать сбоя более ранней версии, которая фильтровала до доказанных совпадений и сообщала о 2 вызывающих на файл с 172, без флага усечения.

Производительность: сканирование компилятора TypeScript (81 тыс. файлов) занимает ~18 секунд на M4; запросы к истории git занимают десятки микросекунд независимо от глубины истории. Индекс хранится в локальном кэше.

Автор признает, что это не точность LSP; для дженериков, макросов, динамической отправки, DI-контейнеров и monkey-patching языковой сервер будет прав, а Basemind — нет. Но для агентов, находящихся в процессе редактирования некомпилируемого репозитория, это практичная альтернатива.

Для кого это: Разработчикам, создающим или использующим ИИ-агентов для программирования, которым нужна быстрая офлайн-навигация по коду без дополнительных затрат на языковые серверы.