Servidores LSP

Compatível com dr3.4.25

O plugin declara três servidores de linguagem (LSP) no manifesto (.claude-plugin/plugin.json), cada um associado às extensões de arquivo que atende:

Linguagem	Servidor	Extensões
TypeScript / JavaScript	typescript-language-server	.ts, .tsx, .js, .jsx
Python	pyright-langserver	.py
Dart	dart language-server	.dart

Com o LSP ativo, os agentes navegam o código por símbolo, não por texto: achar um símbolo pelo nome, ir à definição de uma função, listar todas as referências antes de um refactor, ver quem chama quem. É a diferença entre saber onde calculateTotal é realmente usada e torcer para que um grep por “calculateTotal” não traga falsos positivos — nem esconda um uso renomeado por import.

As regras do framework (em ~/.claude/RULES.md e, no projeto, em .claude/rules/code-navigation.md) tornam isso disciplina: buscas de símbolo usam o LSP, grep fica para padrões de texto (strings, comentários, mensagens de log) ou para linguagens sem servidor; todo refactor começa listando as referências. Como o LSP não oferece diagnósticos, toda edição é seguida pelo type checker e pelo linter do projeto. Quando um Grep parece buscar um símbolo, um hook lembra o agente de usar o LSP.

Dica

O manifesto só declara os servidores; os binários precisam estar na máquina. A cada início de sessão o plugin verifica os servidores das linguagens que o projeto usa e instala em segundo plano, via npm install -g, os que faltam para TypeScript/JavaScript e Python (log em ~/.claude/dr-ai/lsp-install.log); uma tentativa que falhou só se repete depois de 24 horas. Para Dart, só avisa: instale o Dart SDK ou o Flutter. Com preferences.auto_install_lsp: false em .dr_ai/settings.json, o plugin deixa de instalar e só mostra o aviso. O instalador wisework também pergunta quais servidores instalar (TypeScript e Python) e instala os que faltam via npm install -g.

Ver também

• Hooks — as dicas que lembram os agentes de usar o LSP
• /dr:talk:explain — entender o código que o LSP ajuda a navegar