version: "1.0.2" name: code-navigation description: "LSP-навигация BSL: definitions, refs, call graph" uses_capabilities:

• navigate_symbol
• get_call_graph
• get_code_actions
• rename_symbol
• search_ssl_functions
• get_completion
• get_symbol_impact

Навигация по коду (Code Navigation)

Не угадывать расположение кода. Для широкого 1C/BSL-поиска сначала используй RLM (rlm-bsl-search), а LSP — когда уже есть конкретный файл, символ или позиция курсора. LSP даёт точную IDE-семантику по индексу проекта: definition/references, hover, signature, completion, diagnostics, rename и code actions.

Граница с RLM

Когда применять

Алгоритмы

Найти все вызовы функции

Если известна только бизнес-тема или примерное имя — сначала RLM. Этот алгоритм применяй, когда уже есть конкретный метод или позиция.

1. navigate_symbol(query: "ИмяФункции", operation: "search") → получить uri, line, character
2. get_call_graph(uri, line, character, direction: "incoming")

Переименование по проекту

1. navigate_symbol → uri, line, character
2. rename_symbol(..., preview: true) → проверить changes
3. rename_symbol(..., preview: false)
4. get_diagnostics по затронутым файлам

Quick Fixes

1. get_diagnostics(uri) → список диагностик
2. get_code_actions(uri, range, diagnostic) → применить

Верификация API платформы после ошибки

Триггер: ошибка «Метод объекта не обнаружен» / «Неверное количество параметров» на типе платформы. Не угадывать повторно — верифицировать.

1. search_syntax_reference(query: "ТипОбъекта") → подтвердить имя, получить id
2. getMembers(typeId) → точный список методов/свойств
3. getMember(typeId, member) → сигнатура конкретного метода
4. getConstructors(typeId) → если ошибка про параметры Новый

Важно: Только реакция на ошибку, не превентивный поиск.

Discovery метаданных через get_completion

BSL LS Type System v2 отдаёт метаданные конфигурации через автодополнение. Один tool отвечает на разные вопросы — меняется только позиция курсора (после точки). В detail каждого пункта — сигнатура и возвращаемый тип.

Инверсный сигнал: если после перем. get_completion возвращает пусто или нет ожидаемого члена — тип переменной выведен неверно/неизвестен. Отсутствие автодополнения здесь = индикатор ошибки типа (частый баг 1С), а не «нет данных».

Найти использования объекта метаданных в коде

Для широкой карты использований объекта метаданных сначала RLM: он лучше покрывает BSL, XML/MDO/forms/rights/query, подписки и регламентные задания. Этот LSP-алгоритм применяй после RLM или когда нужен точный references по известному менеджеру.

Картина гибридная (как сам объект используется в BSL):

1. search_ssl_functions (режим references) на символе менеджера Документы.ИмяОбъекта → семантически точные места обращения через менеджер. references исключают совпадения в комментариях/строках/текстах запросов.
2. Добрать через RLM то, что не является символом и потому references не видит: строковые литералы типа ("ДокументСсылка.ИмяОбъекта", Тип("ДокументСсылка.…")), пути метаданных внутри текста запроса (ИЗ Документ.ИмяОбъекта), формы, права, подписки и XML/MDO.
3. Raw grep использовать только как fallback, если RLM недоступен или надо проверить один известный файл.

Для «где используется» не начинать с голого grep по имени: он даёт ложные срабатывания в комментариях и строках. Широкий поиск — RLM; точная позиционная семантика — LSP references.

Импакт-анализ правки: get_symbol_impact

Перед переименованием/изменением конкретной процедуры — оценить локальный LSP-радиус поражения одним вызовом:

1. navigate_symbol → uri, line, character символа.
2. get_symbol_impact(uri, line, character) → входящие вызывающие (call hierarchy) + все ссылки + классификация вызывающих по типу модуля (CommonModule / FormModule / ManagerModule / ObjectModule / …) — видно, откуда тянется правка: UI, сервер или фон.

Два слепых пятна (заложены в вывод, держать в голове):

• Триггеры. call hierarchy показывает только прямые вызовы. Метод достигается ещё и через подписки на события, обработчики форм, регл.задания, расширения &Вместо/&Перед/&После — этого здесь НЕ видно; добирать через RLM по BSL + XML/MDO.
• Однофамильцы. Для общих объектных методов (ОбработкаПроведения, ПередЗаписью, есть в сотнях модулей) привязывать call hierarchy к конкретному модулю — иначе в результат попадут ложные звенья от одноимённых методов других объектов.

Подсказки параметров на месте вызова: signature_help

Возвращает список параметров вызываемого метода и то, на каком аргументе стоит курсор. Контракт строгий — ошибка в позиции даёт пустой результат, который выглядит как «не поддерживается», а на деле это неверная позиция.

ОБЯЗАТЕЛЬНО передавать `line`/`character` 0-based, курсор ВНУТРИ скобок вызова — между ( и ), НЕ на имени метода и НЕ перед (. Провайдер находит охватывающий вызов (doCall), резолвит вызываемый метод и только тогда возвращает сигнатуры.

// Строка (1-based 8):  Аккаунт = ПолучитьАккаунт(ДокументОперации, ПараметрыОперации);
signature_help(uri, line=7, character=29)   // сразу после "(" → param 0
//   → ПолучитьАккаунт(ДокументОперации?, ПараметрыОперации?), Active parameter: 0
signature_help(uri, line=7, character=47)   // после запятой   → Active parameter: 1

Пустой результат ≠ tool сломан. signature_help возвращает сигнатуры только когда вызываемый метод резолвится в метод с известным списком параметров. Надёжно работает для методов того же модуля (резолв из разобранного исходника). Возвращает пусто для:

• курсор НЕ внутри скобок (на имени / перед () — самая частая ошибка;
• межмодульный вызов (Модуль.Метод() — нужен индекс типов конфигурации, исправен только когда BSL LS нацелен на единый корень конфигурации (см. «Типичные ошибки»: межмодульный резолв);
• глобальные методы платформы (СтрШаблон(, ЗначениеЗаполнено() и методы объектов платформы (Запрос.УстановитьПараметр() — нужен загруженный контекст платформы 1С (синтакс-помощник .hbk). Контейнер mcp-lsp лёгкий — платформа НЕ зашита в образ, провижинится в рантайме. Run-скрипт bsl-ls генерирует глобальный конфиг и передаёт его через -Dapp.globalConfiguration.path: когда задан BSL_PLATFORM_BIN (compose docker-compose.platform.yml монтирует каталог .hbk read-only) — используется явный v8platform.binPath с приоритетом; когда не задан — BSL LS автоопределяет установленную платформу (включая Windows). Без того и другого в стартовом логе Failed to load platform contexts: No 1C platform installations found, и hover/completion/сигнатуры по платформе пустые. С загруженным (Loaded N platform contexts from 1C syntax helper) — резолвятся с полными доками параметров (на русском при language:ru).

Для подтверждённого списка параметров независимо от места вызова — getMember(typeId, member) (типы платформы) или navigate_symbol→hover (собственное объявление метода).

Capabilities

Типичные ошибки

depends_on: []