@treedy/lsp-mcp 0.2.5 → 0.2.6

package/README.md

@@ -40,7 +40,7 @@ git_diagnostics
 - Language-specific refactor tools where needed:
   - Python: `python_move`, `python_change_signature`, `python_function_signature`
   - TypeScript: `typescript_move`, `typescript_function_signature`
-- Meta/admin tools: `status`, `list_backends`, `check_versions`, `update_backend`, `reload_config`, `switch_workspace`, `switch_workspace_for_language`, `discover_language_workspaces`, `doctor`, `expand_result`
+- Meta/admin tools: `status`, `list_backends`, `check_versions`, `update_backend`, `reload_config`, `switch_workspace`, `switch_workspace_for_language`, `discover_language_workspaces`, `semantic_session_start`, `doctor`, `expand_result`
 - Built-in prompts for agent workflows and best practices
 
 ## Tool Model (Current)
@@ -49,8 +49,9 @@ git_diagnostics
 
 Use these directly; language is inferred from file/path:
 
-- Navigation: `hover`, `definition`, `references`, `peek_definition`, `workspace_symbol`
-- Editing support: `completions`, `signature_help`, `rename`, `code_action`, `run_code_action`
+- Navigation: `hover`, `definition`, `implementation`, `type_definition`, `call_hierarchy`, `type_hierarchy`, `document_highlight`, `selection_range`, `folding_range`, `document_link`, `linked_editing_range`, `semantic_tokens`, `moniker`, `references`, `peek_definition`, `workspace_symbol`
+- Hinting: `inlay_hints`, `inlay_hint_resolve`, `read_file_with_hints`
+- Editing support: `completions`, `signature_help`, `prepare_rename`, `rename`, `code_action`, `run_code_action`, `code_lens`
 - Analysis: `diagnostics`, `git_diagnostics`, `symbols`, `search`, `summarize_file`, `read_file_with_hints`, `project_structure`
 - Sync/edit loop: `update_document`
 
@@ -64,6 +65,7 @@ For large repos, use preview arguments to reduce token usage:
 - `search` / `workspace_symbol`: `preview_limit` or `page_size` (default `200`), plus `cursor` for next page
 - `diagnostics`: `preview_limit` or `page_size` (default `200`), `summary_only` (default `false`), plus `cursor`
 - `doctor`: `page_size` (default `50`) plus `cursor` for long environment reports
+- `doctor`: set `check_latest_versions=true` to probe registry latest version drift (slower, network-dependent)
 - `project_structure`: `max_depth` (default `3`), `max_entries` (default `300`)
 - `summarize_file`: `max_symbols` (default `200`)
 - `read_file_with_hints`: `start_line` (default `1`), `max_lines` (default `300`)
@@ -81,10 +83,48 @@ Paged responses include:
 
 ### Server/meta tools
 
-- `status`, `list_backends`, `start_backend`, `update_backend`, `check_versions`, `reload_config`, `switch_python_backend`, `switch_workspace`, `switch_workspace_for_language`, `discover_language_workspaces`, `doctor`, `expand_result`
+- `status`, `list_backends`, `start_backend`, `update_backend`, `check_versions`, `reload_config`, `switch_python_backend`, `switch_workspace`, `switch_workspace_for_language`, `discover_language_workspaces`, `semantic_session_start`, `doctor`, `expand_result`
 - `discover_language_workspaces` input: `root` (optional), `max_depth` (optional, default `2`), `apply` (optional, default `false`)
+- `semantic_session_start` input: `language` (optional), `workspace` (optional), `file` (optional), `start_backend` (optional, default `true`)
 - In mixed-language monorepos, semantic tools require language workspace mapping (set via `switch_workspace_for_language` or `discover_language_workspaces(..., apply=true)`).
 - `doctor` now includes `workspaceDependencyChecks.language_workspace_discovery` with suggested per-language workspace commands.
+- `doctor` includes `backendPackageDrift` to show installed backend version vs latest policy and upgrade next steps.
+- `doctor` includes `backendVersionSummary` (counts + per-language concise status + latest lookup stats) for quick LLM triage.
+
+Example fields exposed for client/LLM orchestration:
+
+```json
+{
+  "backend_runtime_mode": "registry",
+  "backend_packages": [
+    {
+      "language": "typescript",
+      "package": "@treedy/typescript-lsp-mcp",
+      "package_ref": "@treedy/typescript-lsp-mcp@latest",
+      "registry": "npm",
+      "resolver": "npx",
+      "provider": "typescript-lsp-mcp",
+      "install_command": "npx --yes @treedy/typescript-lsp-mcp@latest",
+      "update_command": "npx --yes @treedy/typescript-lsp-mcp@latest",
+      "default_channel": "latest",
+      "auto_update_enabled": true,
+      "minimum_supported_version": "0.1.0"
+    }
+  ],
+  "backendPackageDrift": {
+    "typescript": {
+      "installed_version": "0.2.0",
+      "minimum_supported_version": "0.1.0",
+      "minimum_status": "supported",
+      "drift_status": "policy_aligned",
+      "latest_registry_version": "0.2.0",
+      "latest_status": "up_to_date",
+      "next_step": "No action needed.",
+      "latest_next_step": "Installed version matches latest policy."
+    }
+  }
+}
+```
 
 ## Prompts (Skills)
 
@@ -109,6 +149,8 @@ You can configure with env vars or `.lsp-mcp.json` in your workspace.
 | `LSP_MCP_TYPESCRIPT_ENABLED` | `true` | Enable TypeScript backend |
 | `LSP_MCP_VUE_ENABLED` | `true` | Enable Vue backend |
 | `LSP_MCP_AUTO_UPDATE` | `true` | Update backend packages to latest on startup/update |
+| `LSP_MCP_BACKEND_RUNTIME_MODE` | `registry` | Backend runtime strategy: `registry` (default), `auto`, `bundled` |
+| `LSP_MCP_REQUIRE_BUNDLED_BACKENDS` | `false` | Legacy strict bundled mode (equivalent to runtime mode `bundled`) |
 | `LSP_MCP_EAGER_START` | `false` | Start all enabled backends when server boots |
 | `LSP_MCP_IDLE_TIMEOUT` | `600` | Backend idle timeout in seconds |
 
@@ -123,7 +165,8 @@ When `LSP_MCP_AUTO_UPDATE=true`:
 
 ### Runtime dependency expectations
 
-- Lean mode (default): backend packages are fetched when first used.
+- Lean mode (default): backend packages are fetched when first used (`LSP_MCP_BACKEND_RUNTIME_MODE=registry`).
+- Bundled mode: set `LSP_MCP_BACKEND_RUNTIME_MODE=bundled` or `LSP_MCP_REQUIRE_BUNDLED_BACKENDS=true`.
 - Required host tools:
   - TypeScript/Vue/Pyright backends: `node` + `npx`
   - Python backend: `uv` (or `uvx`)