@@ -0,0 +1,28 @@
1+# LSP Integration TODO
2+
3+## Current State
4+- Go works end-to-end via gopls (closed-loop diagnostics + red/yellow line numbers)
5+- Uses charmbracelet/x/powernap for LSP client management
6+- Powernap ships with 300+ server configs via lsps.json
7+
8+## TODO
9+
10+### lookPath coverage
11+- `lookPath` checks `$PATH`, `$GOBIN`, `$GOPATH/bin`, `~/go/bin`, `~/.cargo/bin`, `~/.local/bin`
12+- Missing: npm global bin (`~/.npm/bin`), nvm dirs (`~/.nvm/versions/node/*/bin`), pipx (`~/.local/pipx/venvs/*/bin`)
13+- Consider reading `npm prefix -g` or `$NVM_DIR` at startup
14+
15+### Test with other languages
16+- [ ] TypeScript — `typescript-language-server --stdio` (npm install -g typescript-language-server typescript)
17+- [ ] Python — `pyright` or `pylsp` (pip install pyright / python-lsp-server)
18+- [ ] Rust — `rust-analyzer` (~/.cargo/bin, ships with rustup)
19+- [ ] C/C++ — `clangd` (system package)
20+- [ ] Lua — `lua-language-server`
21+
22+### Future features (not now)
23+- LLM tools: `lsp_diagnostics`, `lsp_references`, `lsp_restart`
24+- User-configurable LSP servers in config.toml
25+- Auto-install common LSP servers
26+- Statusbar error/warning count
27+- Workspace/applyEdit support
28+- Unit tests for `internal/lsp/` pure functions (FormatDiagnostics, diagLineSeverities, findRoot, lookPath)