smashspace 0.1.3 → 0.1.5

package/README.md

@@ -17,6 +17,10 @@ agents work through the CLI, MCP, and HTTP API on the *same* data. See
 npm i -g smashspace
 ```
 
+> **Using [Volta](https://volta.sh)?** Install with `volta install smashspace`
+> instead. A global `npm i -g` under Volta leaves a stale shim that later fails
+> with `Volta error: Could not execute command` — `volta install` avoids it.
+
 ## Sign in (approve in the browser — no copy/paste)
 
 ```bash

package/dist/smash.mjs

@@ -3593,7 +3593,10 @@ back to the **\`smash\` CLI**. Do **not** hit the HTTP API with \`curl\` or a ra
 browser \u2014 the CLI and MCP are the supported surfaces and they resolve auth and
 the target board for you.
 
-- CLI install: \`npm i -g smashspace\` (then \`smash --help\`)
+- CLI install: \`npm i -g smashspace\` (then \`smash --help\`).
+  **If the machine uses Volta** (\`command -v volta\` succeeds), install with
+  \`volta install smashspace\` instead \u2014 \`npm i -g\` under Volta leaves a stale
+  shim that fails with "Volta error: Could not execute command".
 - MCP server: \`smashspace-mcp\` (exposes \`smash_*\` tools, same token as the CLI)
 - Sign in once per machine: \`smash login\` (browser approval; token saved to
   \`~/.config/smash/credentials.json\` and reused by MCP)
@@ -3742,7 +3745,10 @@ Verify \`Review\` cards and move verified work to \`Done\`.
 ## Fallbacks
 
 - Prefer \`smashspace-mcp\` MCP tools. If unavailable, use the \`smash\` CLI.
-- If the CLI is not installed: \`npm i -g smashspace\`, then \`smash login\`.
+- If the CLI is not installed: \`npm i -g smashspace\` (or \`volta install smashspace\`
+  on a Volta machine), then \`smash login\`.
+- \`smash\` fails with "Volta error: Could not execute command"? A stale Volta
+  shim \u2014 fix with \`volta install smashspace\` (do NOT \`npm i -g\` under Volta).
 - If a board returns "Sign-in required": run \`smash login\`, or set \`SMASH_TOKEN\`
   for a headless/CI agent.
 
@@ -4732,22 +4738,33 @@ program2.command("init").description(
       }
       if (opts.mcp !== false) {
         let mcp = { mcpServers: {} };
+        let parseFailed = false;
         if (await exists(".mcp.json")) {
           try {
-            mcp = JSON.parse(await readFile2(abs(".mcp.json"), "utf8"));
+            const parsed = JSON.parse(await readFile2(abs(".mcp.json"), "utf8"));
+            if (parsed && typeof parsed === "object")
+              mcp = parsed;
           } catch {
+            parseFailed = true;
           }
-          if (!mcp.mcpServers)
+          if (!mcp.mcpServers || typeof mcp.mcpServers !== "object") {
             mcp.mcpServers = {};
+          }
         }
-        const servers = mcp.mcpServers;
-        if (servers.smashspace && !opts.force) {
-          actions.push("\u2022 .mcp.json already wires 'smashspace' \u2014 kept (use --force)");
+        if (parseFailed && !opts.force) {
+          actions.push(
+            "\u26A0 .mcp.json exists but is not valid JSON \u2014 left untouched; add the 'smashspace' server by hand or re-run with --force"
+          );
         } else {
-          servers.smashspace = mcpServerEntry(baseUrl, boardId);
-          await put(".mcp.json", `${JSON.stringify(mcp, null, 2)}
+          const servers = mcp.mcpServers;
+          if (servers.smashspace && !opts.force) {
+            actions.push("\u2022 .mcp.json already wires 'smashspace' \u2014 kept (use --force)");
+          } else {
+            servers.smashspace = mcpServerEntry(baseUrl, boardId);
+            await put(".mcp.json", `${JSON.stringify(mcp, null, 2)}
 `);
-          actions.push("\u2713 .mcp.json \u2014 smashspace MCP server");
+            actions.push("\u2713 .mcp.json \u2014 smashspace MCP server");
+          }
         }
       }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smashspace",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "SmashSpace CLI + MCP — operate SmashSpace boards from your terminal, Claude Code, Cursor, and Codex.",
   "type": "module",
   "bin": {