code-index

Цепочка вызовов между двумя функциями за ОДИН вызов. Бери его на вопросы вида «есть ли путь от A до B», «как из A попадают в B», «через что A вызывает B»: кратчайший путь по графу ищет сервер. НЕ восстанавливай цепочку вручную — обход через get_callers/get_callees по одному узлу и чтение тел стоит десятки вызовов и даёт тот же ответ. Параметры: from, to — имена функций; max_depth по умолчанию 5, [1..10]. Универсальный, любой язык. Возвращает {from,to,found,path:[{caller,callee,line}]}. Пути нет — ответ различает «дошли до потолка» и «подграф исчерпан». Для 1С есть отдельный find_path_bsl (учитывает вид вызова).

Навигация: ГДЕ определён символ по ТОЧНОМУ имени — локации функций/классов/переменных/импортов БЕЗ тел (как search_*). Тело конкретного — get_function/get_class. Возвращает {functions, classes, variables, imports} (облегчённые: имя/путь/строки/сигнатура). Голым именем зови ТОЛЬКО для уникального имени: если имя — стандартный обработчик объекта/набора записей или просто распространённое, вернутся сотни локаций (truncated) — для таких сразу задавай path_glob (фильтр по пути).

Дерево вызовов на НЕСКОЛЬКО уровней за ОДИН вызов. Бери его на вопросы вида «кто вызывает того, кто вызывает X», «цепочка вызовов вверх/вниз», «дерево вызовов на N уровней»: обход по уровням делает сервер. НЕ собирай такое дерево вручную — перебор узлов через get_callers/get_callees/grep_code/find_symbol стоит десятки лишних вызовов и даёт тот же ответ. Параметры: root — имя функции; direction: callers/up (кто вызывает root — для вопросов «кто выше по цепочке») либо callees/down (что вызывает сам root, по умолчанию); max_depth (синоним depth) по умолчанию 3, [1..10]; max_nodes cap (default 200). Для 1С обход ВВЕРХ добавляет платформенные точки входа, которых нет в таблице calls: событие и команда формы, подписка на событие, перехват расширением, обработчик по соглашению об имени. Большой ответ сокращается по размеру: дальние рёбра отбрасываются, поля tree нет, в ответе truncated, edges_total, edges_shown и hint — как сузить запрос. Универсальный, любой язык. Возвращает {root,direction,edges:[{caller,callee,line,depth}],tree:{name,children}}.

Что вызывает данная функция (callees) — весь список за ОДИН вызов. В каждой записи уже есть caller, callee, line, path файла с вызовом, а для однозначных имён ещё и callee_path/callee_line — место, где вызываемая процедура ОПРЕДЕЛЕНА. Искать каждое вызываемое имя отдельным find_symbol/get_function НЕ нужно; если callee_path нет, значит имя носят несколько процедур — тогда спрашивай их одним grep_code с перечислением через | , а не по вызову на имя. limit — cap (default 200); при обрезке {truncated,total,limit}. Цепочка до конкретной функции — find_path, дерево на несколько уровней — get_call_tree. path_glob — фильтр по пути файла-источника вызова; если имя делят несколько функций, в ответе есть `ambiguous_name` с их определениями.

Найти вызывателей функции (callers) в указанном репо. limit — cap (default 200); на «горячих» функциях ответ обрезается с {truncated,total,limit}. Возвращает JSON-массив CallRecord. Для 1С к вызовам из кода добавляются декларативные привязки (поле kind): обработчик события формы, обработчик команды формы (binding=command), подписка на событие, перехват расширением, обработчик по соглашению об имени — вызова в коде у них нет, процедуру зовёт платформа. path_glob — фильтр по пути файла-ИСТОЧНИКА вызова: на одноимённых методах (`Dispose`, `RunAsync`) вызовы разных классов идут одним списком, и сузить его можно только файлом; тогда же в ответе появляется `ambiguous_name` с перечнем определений этого имени.

Тело класса/структуры по ТОЧНОМУ имени (с исходником). НЕуникальное имя (совпадений > порога) → тела опускаются, локации + hint, уточните path_glob. Навигация без тел — find_symbol; поиск по словам — search_class. Возвращает JSON-массив ClassRecord (или локации при множестве).

Карта/оглавление файла БЕЗ тел функций/классов (безопасно на больших модулях): имена, сигнатуры (args/return_type), диапазоны строк, обрезанные docstring, импорты, переменные + functions_total/classes_total. Тело конкретной функции — get_function(name) или read_file(line_start,line_end). Возвращает JSON-объект.

Тело функции по ТОЧНОМУ имени (с исходником). Уникальное имя → одно тело. НЕуникальное (совпадений > порога) → тела опускаются, возвращаются локации + hint: уточните path_glob к нужному файлу. Навигация «где символ» без тел — find_symbol; поиск по словам — search_function. Возвращает JSON-массив FunctionRecord (или облегчённые локации при множестве).

Импорты файла (file_id) или модуля (module) в указанном репо. limit — cap (default 200); при обрезке {truncated,total,limit}. Возвращает JSON-массив ImportRecord.

Статистика индекса. Если repo указан — для одного репо, иначе — массив по всем подключённым репо.

Изменённые git-файлы между двумя снимками (from/to — ревизия или локальная дата; to по умолчанию HEAD, без from диапазон пуст; tz — смещение для дат, по умолчанию локальный пояс). path_glob — glob по индексному пути. limit — максимум файлов (default 200). Возвращает статусы (A/M/D/R/C, T считается M), insertions/deletions (бинарные — 0 и binary=true), old_path для переименований, files_changed и суммы после фильтра до обрезки, empty_range для совпавших хешей, truncated и hint при обрезке.

Изменения git, сгруппированные по объектам метаданных 1С. from/to — ревизия или локальная дата (to по умолчанию HEAD), limit — максимум объектов (default 100), include_files — отдавать пути внутри объектов (default false). Объект берётся из metadata_modules (code_path от корня индекса, записи под REPO_DEFAULT), иначе разбирается раскладка base/<Категория>/<Имя>/…, extensions/<Имя>/… и External/<Имя>/…; неизвестные пути — ungrouped. meta_type выводится из известной категории (для metadata_modules — по первой части имени, у модулей форм это тип владельца). tz — смещение для дат, по умолчанию локальный пояс. totals и objects_total всегда полные; paths помечаются paths_truncated.

Unified diff одного файла между двумя снимками. ОБЯЗАТЕЛЕН буквальный path от корня индекса (from/to — ревизия или локальная дата, to по умолчанию HEAD; tz — смещение для дат, по умолчанию локальный пояс). context_lines — контекст (default 3), max_chars — предел патча (default 20000). Возвращает status, insertions, deletions, patch; для переименования в патч входят обе стороны, бинарное содержимое не декодируется (binary=true, patch пуст). Отсутствующий в обоих снимках путь — ошибка, неизменённый — пустой patch и status=unchanged.

История git-коммитов репозитория. ОБЯЗАТЕЛЕН repo (git-слой включается git = true в daemon.toml). rev — хеш/ветка/тег/локальная дата (YYYY-MM-DD, YYYY-MM-DD HH:MM, YYYY-MM-DDTHH:MM), по умолчанию HEAD; tz — смещение для дат (`+03:00` или `UTC`), по умолчанию локальный пояс. path — буквальный путь от корня индекса. limit — максимум коммитов (default 20), total считается по всей подходящей истории. Возвращает {rev: {input,resolved_hash,hash,date,subject,resolved_as,timezone,resolved_at}, commits:[{hash,short,date,author,subject}], shown,total,limit,truncated,hint?}.

Историческое содержимое файла из git (show <rev>:<path>). ОБЯЗАТЕЛЕН буквальный path от корня индекса; rev — хеш/ветка/тег/локальная дата (по умолчанию HEAD); tz — смещение для дат, по умолчанию локальный пояс. Диапазон строк line_start/line_end — 1-based inclusive; lines_total считается по файлу до диапазона и обрезки. max_chars — предел содержимого (default 20000). Каталог, отсутствующий путь и бинарное/недекодируемое содержимое — структурированная ошибка; при обрезке truncated=true и hint.

Поиск ТОЛЬКО в телах функций и классов (module-level код — объявления Перем, таблицы инициализации/маршрутизации, константы и строковые литералы ВНЕ процедур — НЕ виден; для поиска по всему файлу бери grep_code). Плюс grep_body в том, что показывает, в какой ИМЕННО функции/классе найден паттерн. pattern — буквальная подстрока без учёта регистра (кириллица тоже; `%` и `_` — обычные символы), regex — регулярное выражение; query — алиас regex. path_glob (синоним glob=) — фильтр по пути (SQL pushdown; альтернативы `{a,b}` поддерживаются). context_lines — N строк до/после совпадения. limit — число находок (default 30); при обрезке truncated=true. Возвращает {files: {"<path>": ["<name> (<kind>) L<start>-<end>: <строки>(+N)", …]}, shown, limit, truncated} — по одной строке-локатору на функцию/класс; контекст (context_lines>0) дописан строками "N: текст".

Regex-поиск по ПОЛНОМУ тексту code-файлов (Phase 2, v0.8.0; параметр regex=, синоним query=; pattern= — буквальная подстрока без учёта регистра, как в grep_body): ищет по ВСЕМУ файлу — и module-level (объявления Перем, таблицы маршрутизации/инициализации, константы, строковые литералы, комментарии, импорты), И внутри тел функций/классов. Это НАДмножество grep_body по покрытию текста. Для поиска ВСЕХ вхождений имени/строки где угодно в файле (например имя веб-сервиса в таблице маршрутизации + его же использование в теле) — бери grep_code, НЕ grep_body (тот видит только тела и пропустит module-level). grep_body — когда нужно узнать, в какой ИМЕННО функции/процедуре встречается паттерн. Источник — таблица file_contents (zstd). path_glob (синоним glob=) ИЛИ language обязательно желателен (full-scan дорогой из-за zstd-decode каждого файла); альтернативы `{a,b}` в path_glob поддерживаются. Файлы oversize=true пропускаются. limit — число совпадений (default 30); при обрезке truncated=true (дошлите больший limit). Возвращает {files: {"<path>": ["N: content", …]}, shown, limit, truncated} — строки "номер: содержимое"; контекст (context_lines>0) влит в тот же массив, отсортирован по номеру строки.

Regex-поиск по содержимому text-файлов (параметр regex=, синоним query=; pattern= — буквальная подстрока без учёта регистра, как в grep_body). path_glob (синоним glob=) ИЛИ language обязательно желателен (full-scan по всем text-файлам — дорого); альтернативы `{a,b}` в path_glob поддерживаются. context_lines — N строк до/после. limit — число находок (default 30 при full-scan); при обрезке truncated=true. Возвращает {files: {"<path>": ["N: content", …]}, shown, limit, truncated} — строки "номер: содержимое"; контекст (context_lines>0) влит в тот же массив, отсортирован по номеру строки.

Проверка живости MCP-сервера и демона индексации по всем подключённым репо. Возвращает JSON.

无需输入参数。

Список файлов в индексе с фильтрами. pattern — glob по пути (`**/*.py`; альтернативы `{a,b}`: `**/*.{rs,toml}`), path_prefix — префикс (`src/auth/`), language — язык. Возвращает JSON-массив строк "<path> | <lang> | <N> lines | <size>" (mtime — в _meta.file_mtimes). limit — максимум файлов в ответе (default 500); если подходящих файлов больше, ответ несёт {truncated, total, shown, limit}, где total — сколько их всего.

Прочитать содержимое файла из индекса. ОБЯЗАТЕЛЬНЫ оба параметра: repo (алиас репозитория, список — get_stats) и path. Отдаёт реальный content и для text-файлов (yaml/md/json/toml/xml/sh и др.), и для code-файлов (zstd-decode из file_contents, Phase 2 v0.8.0+); поле category в ответе — "text" или "code". Oversize code-файлы (> max_code_file_size_bytes) возвращают oversize=true и пустой content (их читать через get_function/grep_body/grep_code). line_start/line_end (синонимы start_line/end_line) — 1-based, inclusive. Soft-cap 5000 строк / 500 КБ (truncated=true при обрезке), hard-cap 2 МБ.

Нечёткий FTS-поиск классов/структур по СЛОВАМ (bm25): имя важнее docstring. Выдача БЕЗ тел — только локации (имя/путь/строки/bases). Тело конкретного класса — get_class; локации по ТОЧНОМУ имени — find_symbol. path_glob — фильтр по пути. При 0 совпадений — hint.

Нечёткий FTS-поиск функций по СЛОВАМ (bm25, OR между словами, префиксные термы): имя важнее qualified_name/docstring. Принимает и точное имя, и описание из слов ('расчёт цены продажи реализация'). Выдача БЕЗ тел — только локации (имя/путь/строки/сигнатура/обрезанный docstring). Тело конкретной функции — get_function; локации по ТОЧНОМУ имени — find_symbol; regex по коду — grep_code. path_glob — фильтр по пути. При 0 совпадений — hint; на BSL-репо он подсказывает search_terms (поиск процедур по смысловым термам).

FTS поиск по текстовым файлам (md, txt, yaml, toml) в указанном репо. path_glob — опциональный фильтр по пути. Возвращает JSON-массив [{path, snippet}].

Метаданные файла из индекса: existence, размер, mtime, lines_total, language, category. Чистая выборка из таблицы files (быстро). ОБЯЗАТЕЛЬНЫ оба параметра: repo (алиас репозитория, список — get_stats) и path.