From c6e719b1b4bbc53555f2b913a794dcff6055f2ae Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 27 May 2026 12:15:52 +0000 Subject: [PATCH] Relabel .lsp.json as a Python LSP and document .py shadowing risk The README described the LSP as "EnergyPlus language support," but idfkit-lsp registers only .py -> python and serves Python code that imports idfkit, not the IDF/epJSON language. Reword the entry and add a caveat that the server attaches to every .py file and may compete with the user's primary Python LSP. Closes #4 https://claude.ai/code/session_01BYBeYVxYHEv2rAC4TK9F8S --- README.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index c641beb..a8f4816 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,14 @@ Claude Code, Cursor, Copilot, Gemini, Codex, and any MCP-capable client. | **Workflow skills** | Task playbooks that orchestrate the MCP tools: `simulate`, `validate`, `new-model`, `load-model`, `energy-audit`, `weather`, `upgrade-version`, `idf-conventions`, `docs`. | | **Agents** | Focused sub-agents: `energy-modeler`, `envelope-analyst`, `hvac-designer`. | | **Commands & hooks** | `/quick-sim` slash command; context hooks that nudge agents toward the structured MCP tools when they touch `.idf` / `.epJSON` / `.epw` / `.ddy` files. | -| **LSP** | EnergyPlus language support via `.lsp.json`. | +| **LSP** | Python LSP for idfkit-based code (`idfkit-lsp`) via `.lsp.json`. | + +> **Note on the LSP.** `idfkit-lsp` is a language server for *Python code that +> imports idfkit* — it does **not** provide an IDF/epJSON language server. Because +> it registers `.py` → `python`, the host attaches it to **every** Python file in +> the project, where it coexists with (and may compete with) your primary Python +> LSP such as Pylance, pyright, or ruff-lsp. If your editor supports scoping a +> server by workspace or activation pattern, narrow it to idfkit projects. ## Two contexts, two surfaces