karellen / karellen-lsp-mcp / 23788025273 / 4

72%

master: 72%

push

github

[release] Add LSP proxy frontend for native Claude Code integration (#29)

## Summary

- Add `karellen-lsp` as a native LSP server for Claude Code —
transparent code intelligence with no permission prompts and no manual
project registration
- Both MCP (`karellen-lsp-mcp`) and LSP (`karellen-lsp`) interfaces
share the same daemon, backend LSP servers, adapters, normalizers, and
readiness tracking via refcounted project registry
- **Daemon-side routing**: `ProjectRegistry.find_project_for_file()`
matches file paths against all registered projects (longest-prefix,
extension disambiguation for polyglot). MCP-registered projects are
visible to native LSP queries and vice versa
- **Normalizer owns URI lifecycle**: `normalize_response()` normalizes
URIs in both structured fields and string values (e.g., `jdt://` in
hover markdown), `denormalize_params()` reverse-maps for hierarchy item
roundtripping — per-normalizer-instance reverse cache, no state in
frontend
- **LSP proxy is thin**: JSON-RPC framing + initialize/shutdown, all
routing and normalization in daemon
- Add `regenerate` parameter to `register_project` (clean managed data +
force restart in one call)
- Add `LSP_MCP_LOG_LEVEL` env var for configurable log verbosity (daemon
+ LSP proxy)
- Add `.lsp.json` for Claude Code native LSP plugin discovery
- Add marketplace notification workflow
- Reuse managed `compile_commands.json` if fresh — skip cmake/meson
re-run on re-registration
- Freeze `elapsed_seconds` in indexing status once server becomes ready
- Redirect LSP server stderr to `server.log` in managed directory
- Detect dead LSP server process before attempting graceful shutdown

## Test plan

- [x] 320 unit tests pass (routing in `ProjectRegistry`, normalizer
`normalize_response`/`denormalize_params` roundtrip, URI string
scanning, polyglot disambiguation, nested project path matching)
- [x] Flake8 clean
- [x] Verified all 9 native LSP operations on MariaDB C codebase
(clangd) and Kotlin/Java co... (continued)

763 of 1214 branches covered (62.85%)

Branch coverage included in aggregate %.

2374 of 3182 relevant lines covered (74.61%)

0.75 hits per line