@elixpo/lixsketch 5.6.3 → 5.6.4

package/README.md

@@ -210,6 +210,25 @@ Deployment requires migration `0010_mcp_workspace_grants.sql`, a shared `MCP_REL
 
 The stdio channel is reserved for MCP JSON-RPC. Server status is written to stderr.
 
+Before configuring a client, verify the executable from the same terminal used to
+launch that client:
+
+```bash
+type -a codex
+node --version
+command -v npx
+npx -y @elixpo/lixsketch@latest --help
+```
+
+Node.js 20 or newer is required. If a desktop or sandboxed client cannot resolve
+`npx`, set its MCP `command` to the absolute path returned by `command -v npx`.
+The generated website configuration uses the portable `npx` command because a
+website cannot inspect local executable paths. When multiple Codex installations
+exist, use the first installation that shares the working Node.js environment.
+For Codex TOML configurations, set `startup_timeout_sec = 30` so the first package
+download has enough time to complete. `codex mcp list` confirms registration;
+restart Codex and use `/mcp` in a fresh session to confirm the handshake.
+
 ### MCP tools
 
 | Tool | Purpose |

package/dist/mcp/index.js

@@ -887,7 +887,7 @@ var LixSketchMcpServer = class {
     if (method === "initialize") {
       const requested = request.params?.protocolVersion;
       const protocolVersion = SUPPORTED_PROTOCOL_VERSIONS.has(requested) ? requested : PROTOCOL_VERSION;
-      return { protocolVersion, capabilities: { tools: { listChanged: false }, resources: { subscribe: false, listChanged: false } }, serverInfo: this.serverInfo, instructions: "Read canvas_get before mutations. Use expectedRevision and dryRun for safe edits. Prefer template_insert for reusable component packs." };
+      return { protocolVersion, capabilities: { tools: { listChanged: false }, resources: { subscribe: false, listChanged: false } }, serverInfo: this.serverInfo, instructions: "Before any mutation, call canvas_get and retain its revision. Preserve unrelated shapes. Send expectedRevision and dryRun: true first, inspect canvas_preview for layout changes, then commit the same validated operation with dryRun: false. Never clear or replace a canvas unless the user explicitly requests it. Prefer lixscript_apply for diagrams and template_insert for reusable component packs." };
     }
     if (method === "ping") return {};
     if (method === "tools/list") return { tools: this.listTools() };