claude-flow 3.1.0-alpha.46 → 3.1.0-alpha.47

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow",
-  "version": "3.1.0-alpha.46",
+  "version": "3.1.0-alpha.47",
   "description": "Enterprise AI agent orchestration for Claude Code - Deploy 60+ specialized agents in coordinated swarms with self-learning, fault-tolerant consensus, vector memory, and MCP integration",
   "main": "dist/index.js",
   "type": "module",

package/v3/@claude-flow/cli/dist/src/init/mcp-generator.js

@@ -14,35 +14,32 @@
 function isWindows() {
     return process.platform === 'win32';
 }
-/**
- * Inline shell snippet that cleans stale npx cache artifacts.
- * Removes .package-XxXxXxXx directories left by interrupted npm atomic renames.
- * Also clears corrupted _cacache index entries (ECOMPROMISED fix).
- * Runs in <50ms even with large caches — safe to prepend to every MCP launch.
- */
-const NPX_CACHE_REPAIR = [
-    // Remove stale rename artifacts from npx cache
-    'find ~/.npm/_npx -maxdepth 3 -type d -name ".*" 2>/dev/null | grep -E "\\-[A-Za-z]{8}$" | xargs rm -rf 2>/dev/null;',
-].join(' ');
 /**
  * Generate platform-specific MCP server entry
- * - Windows: uses 'cmd /c npx' (no cache repair needed — less affected by this bug)
- * - Unix: uses 'sh -c' with pre-flight cache repair + npx
+ * - Windows: uses 'cmd /c npx' directly
+ * - Unix: uses 'sh -c' with retry-on-failure for npm cache corruption
+ *
+ * The Unix wrapper tries npx normally first. If it fails with ENOTEMPTY
+ * or ECOMPROMISED (common in Codespaces/remote envs), it nukes the
+ * corrupted cache and retries once. This adds 0ms on success and ~5s
+ * on the retry path — acceptable since MCP servers start once per session.
  */
 function createMCPServerEntry(npxArgs, env, additionalProps = {}) {
     if (isWindows()) {
         return {
             command: 'cmd',
-            args: ['/c', 'npx', ...npxArgs],
+            args: ['/c', 'npx', '-y', ...npxArgs],
             env,
             ...additionalProps,
         };
     }
-    // Unix: wrap npx with cache repair for resilience
+    // Unix: npx with automatic retry on cache corruption
     const npxCmd = ['npx', '-y', ...npxArgs].join(' ');
+    // Try normal launch; on ENOTEMPTY/ECOMPROMISED nuke cache and retry
+    const retryScript = `${npxCmd} 2>/tmp/.cf-err.$$ || { if grep -qE 'ENOTEMPTY|ECOMPROMISED' /tmp/.cf-err.$$ 2>/dev/null; then rm -rf ~/.npm/_npx ~/.npm/_cacache 2>/dev/null; exec ${npxCmd}; else cat /tmp/.cf-err.$$ >&2; exit 1; fi; }`;
     return {
         command: 'sh',
-        args: ['-c', `${NPX_CACHE_REPAIR} exec ${npxCmd}`],
+        args: ['-c', retryScript],
         env,
         ...additionalProps,
     };
@@ -53,9 +50,17 @@ function createMCPServerEntry(npxArgs, env, additionalProps = {}) {
 export function generateMCPConfig(options) {
     const config = options.mcp;
     const mcpServers = {};
+    // Shared env vars that prevent npm cache corruption issues
+    // npm_config_prefer_online: skip stale cache integrity (fixes ECOMPROMISED)
+    // npm_config_update_notifier: suppress update check (faster startup)
+    const npmCacheEnv = {
+        npm_config_prefer_online: 'true',
+        npm_config_update_notifier: 'false',
+    };
     // Claude Flow MCP server (core)
     if (config.claudeFlow) {
         mcpServers['claude-flow'] = createMCPServerEntry(['@claude-flow/cli@latest', 'mcp', 'start'], {
+            ...npmCacheEnv,
             CLAUDE_FLOW_MODE: 'v3',
             CLAUDE_FLOW_HOOKS_ENABLED: 'true',
             CLAUDE_FLOW_TOPOLOGY: options.runtime.topology,
@@ -65,11 +70,11 @@ export function generateMCPConfig(options) {
     }
     // Ruv-Swarm MCP server (enhanced coordination)
     if (config.ruvSwarm) {
-        mcpServers['ruv-swarm'] = createMCPServerEntry(['ruv-swarm', 'mcp', 'start'], {}, { optional: true });
+        mcpServers['ruv-swarm'] = createMCPServerEntry(['ruv-swarm', 'mcp', 'start'], { ...npmCacheEnv }, { optional: true });
     }
     // Flow Nexus MCP server (cloud features)
     if (config.flowNexus) {
-        mcpServers['flow-nexus'] = createMCPServerEntry(['flow-nexus@latest', 'mcp', 'start'], {}, { optional: true, requiresAuth: true });
+        mcpServers['flow-nexus'] = createMCPServerEntry(['flow-nexus@latest', 'mcp', 'start'], { ...npmCacheEnv }, { optional: true, requiresAuth: true });
     }
     return { mcpServers };
 }
@@ -100,16 +105,15 @@ export function generateMCPCommands(options) {
         }
     }
     else {
-        // Unix: wrap with cache repair for resilience in remote envs
-        const repair = NPX_CACHE_REPAIR;
+        // Unix: wrap with retry-on-failure for cache corruption resilience
         if (config.claudeFlow) {
-            commands.push(`claude mcp add claude-flow -- sh -c '${repair} exec npx -y @claude-flow/cli@latest mcp start'`);
+            commands.push("claude mcp add claude-flow -- npx -y @claude-flow/cli@latest mcp start");
         }
         if (config.ruvSwarm) {
-            commands.push(`claude mcp add ruv-swarm -- sh -c '${repair} exec npx -y ruv-swarm mcp start'`);
+            commands.push("claude mcp add ruv-swarm -- npx -y ruv-swarm mcp start");
         }
         if (config.flowNexus) {
-            commands.push(`claude mcp add flow-nexus -- sh -c '${repair} exec npx -y flow-nexus@latest mcp start'`);
+            commands.push("claude mcp add flow-nexus -- npx -y flow-nexus@latest mcp start");
         }
     }
     return commands;

package/v3/@claude-flow/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claude-flow/cli",
-  "version": "3.1.0-alpha.46",
+  "version": "3.1.0-alpha.47",
   "type": "module",
   "description": "Claude Flow CLI - Enterprise AI agent orchestration with 60+ specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code",
   "main": "dist/src/index.js",