brainstorm-companion 2.0.5 → 2.1.0

package/README.md

@@ -12,29 +12,35 @@ Zero dependencies. Node.js >= 18 only.
 npm install -g brainstorm-companion
 ```
 
-Or run directly:
+### Claude Code MCP Setup
 
-```bash
-npx brainstorm-companion start
-```
+Add to `~/.claude/.mcp.json` (create the file if it doesn't exist):
 
-### Claude Code MCP Setup
+```json
+{
+  "mcpServers": {
+    "brainstorm": {
+      "command": "brainstorm-companion",
+      "args": ["--mcp"]
+    }
+  }
+}
+```
 
-Add to `~/.claude/settings.json`:
+Then restart Claude Code. The agent gets 5 tools (`brainstorm_start_session`, `brainstorm_push_screen`, `brainstorm_read_events`, `brainstorm_clear_screen`, `brainstorm_stop_session`) with full usage docs embedded — it knows how to use them immediately.
 
+**Alternative (no global install):** Use `npx` instead:
 ```json
 {
   "mcpServers": {
     "brainstorm": {
       "command": "npx",
-      "args": ["brainstorm-companion", "--mcp"]
+      "args": ["brainstorm-companion@latest", "--mcp"]
     }
   }
 }
 ```
 
-Once configured, the agent has access to 5 tools: `brainstorm_start_session`, `brainstorm_push_screen`, `brainstorm_read_events`, `brainstorm_clear_screen`, and `brainstorm_stop_session`. Full documentation is embedded in the tool descriptions — the agent becomes an expert immediately upon connecting.
-
 ---
 
 ## Complete Usage Guide

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brainstorm-companion",
-  "version": "2.0.5",
+  "version": "2.1.0",
   "description": "AI-assisted visual brainstorming companion",
   "type": "commonjs",
   "license": "MIT",

package/src/mcp.js

@@ -317,6 +317,15 @@ Use clear_after_read: true between brainstorming rounds to avoid stale events.`,
         fs.writeFileSync(path.join(slotDir, '.label'), String(label), 'utf8');
       }
     } else {
+      // Single-screen mode: clear any existing slot dirs so server doesn't stay in comparison mode
+      try {
+        const entries = fs.readdirSync(this.sessionDir, { withFileTypes: true });
+        for (const entry of entries) {
+          if (entry.isDirectory() && entry.name.startsWith('slot-')) {
+            fs.rmSync(path.join(this.sessionDir, entry.name), { recursive: true, force: true });
+          }
+        }
+      } catch { /* ignore */ }
       filePath = path.join(this.sessionDir, `screen-${Date.now()}.html`);
     }
 

package/src/session.js

@@ -111,6 +111,15 @@ class SessionManager {
         fs.writeFileSync(path.join(slotDir, '.label'), String(label), 'utf8');
       }
     } else {
+      // Single-screen mode: clear any existing slot dirs so server switches out of comparison mode
+      try {
+        const entries = fs.readdirSync(sessionDir, { withFileTypes: true });
+        for (const entry of entries) {
+          if (entry.isDirectory() && entry.name.startsWith('slot-')) {
+            fs.rmSync(path.join(sessionDir, entry.name), { recursive: true, force: true });
+          }
+        }
+      } catch { /* ignore */ }
       filePath = path.join(sessionDir, filename || `screen-${Date.now()}.html`);
     }