Архитектура Language Server для atopile

engineering

lsp — это скилл для Claude Code, который объясняет, как устроен Language Server Protocol в atopile: как работает pygls-сервер, как строятся изолированные графы на каждый документ и какие инварианты обеспечивают стабильность и быстродействие. Сервер реализован в `src/atopile/lsp/lsp_server.py` и поддерживает автодополнение, переход к определению, hover-подсказки и диагностику для `.ato`-файлов. Ключевая особенность — частичная компиляция: сервер обязан работать с незавершённым или сломанным кодом, не падая, и укладываться в лимиты латентности (<50 мс для ввода, <200 мс для completion). Скилл описывает структуру `DocumentState`, правило «хранить последний успешный билд», дебаунсинг дорогих операций и порядок уничтожения старых `GraphView`. Нужен при разработке IDE-интеграции для atopile, отладке LSP-хендлеров и написании тестов через `ato dev test`.