@axiomatic-labs/claudeflow 2.10.254 → 2.10.255

package/lib/install.js

@@ -77,22 +77,34 @@ async function run() {
       fs.copyFileSync(srcSettings, dstSettings);
     }
 
-    // Generate .mcp.json with project-specific CDP port
+    // Upsert playwright entry in .mcp.json with project-specific CDP port.
+    // IMPORTANT: read existing .mcp.json first and merge — never overwrite
+    // wholesale. Users may have custom MCP servers (claude-in-chrome, Linear,
+    // GitHub, etc) that must be preserved across install/update runs. Only
+    // the three template-managed entries (playwright, serena, context7) are
+    // allowed to be mutated by the installer.
     const cdpHash = require('crypto').createHash('sha1').update(cwd).digest();
     const cdpPort = 9200 + (cdpHash.readUInt16BE(2) % 100);
-    const mcpConfig = {
-      mcpServers: {
-        playwright: {
-          command: "npx",
-          args: [
-            "@playwright/mcp@latest",
-            "--cdp-endpoint", `http://localhost:${cdpPort}`,
-            "--caps", "vision,devtools",
-          ],
-        },
-      },
+    const mcpPath = path.join(cwd, '.mcp.json');
+    let mcpConfig = { mcpServers: {} };
+    try {
+      const existing = fs.readFileSync(mcpPath, 'utf8');
+      mcpConfig = JSON.parse(existing);
+      if (!mcpConfig.mcpServers || typeof mcpConfig.mcpServers !== 'object') {
+        mcpConfig.mcpServers = {};
+      }
+    } catch {
+      // File doesn't exist or is invalid JSON — start fresh with empty servers
+    }
+    mcpConfig.mcpServers.playwright = {
+      command: "npx",
+      args: [
+        "@playwright/mcp@latest",
+        "--cdp-endpoint", `http://localhost:${cdpPort}`,
+        "--caps", "vision,devtools",
+      ],
     };
-    fs.writeFileSync(path.join(cwd, '.mcp.json'), JSON.stringify(mcpConfig, null, 2) + '\n');
+    fs.writeFileSync(mcpPath, JSON.stringify(mcpConfig, null, 2) + '\n');
 
     // Copy all template-managed skills from the ZIP, including subskills.
     const srcSkills = path.join(srcClaude, 'skills');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axiomatic-labs/claudeflow",
-  "version": "2.10.254",
+  "version": "2.10.255",
   "description": "Claudeflow — AI-powered development toolkit for Claude Code. Skills, agents, hooks, and quality gates that ship production apps.",
   "bin": {
     "claudeflow": "./bin/cli.js"