@claude-flow/cli 3.1.0-alpha.44 → 3.1.0-alpha.45

package/bin/cli.js

@@ -6,8 +6,36 @@
  *
  * Auto-detects MCP mode when stdin is piped and no args provided.
  * This allows: echo '{"jsonrpc":"2.0",...}' | npx @claude-flow/cli
+ *
+ * Includes pre-flight npx cache repair to prevent ENOTEMPTY errors
+ * in remote/CI environments (known npm 10.x bug).
  */
 
+// Pre-flight: repair stale npx cache to prevent ENOTEMPTY on next run
+import { existsSync, readdirSync, rmSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+
+try {
+  const npxRoot = join(homedir(), '.npm', '_npx');
+  if (existsSync(npxRoot)) {
+    for (const dir of readdirSync(npxRoot)) {
+      const nm = join(npxRoot, dir, 'node_modules');
+      if (!existsSync(nm)) continue;
+      try {
+        for (const entry of readdirSync(nm)) {
+          if (entry.startsWith('.') && entry.includes('-') && /[A-Za-z]{8}$/.test(entry)) {
+            try {
+              const p = join(nm, entry);
+              if (statSync(p).isDirectory()) rmSync(p, { recursive: true, force: true });
+            } catch {}
+          }
+        }
+      } catch {}
+    }
+  }
+} catch {}
+
 import { randomUUID } from 'crypto';
 
 // Check if we should run in MCP server mode

package/bin/mcp-server.js

@@ -5,8 +5,36 @@
  * Direct stdio MCP server for Claude Code integration.
  * This entry point handles stdin/stdout directly for MCP protocol
  * without any CLI formatting output that would corrupt the protocol.
+ *
+ * Includes pre-flight npx cache repair to prevent ENOTEMPTY errors
+ * in remote/CI environments (known npm 10.x bug).
  */
 
+// Pre-flight: repair stale npx cache to prevent ENOTEMPTY on next run
+import { existsSync, readdirSync, rmSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+
+try {
+  const npxRoot = join(homedir(), '.npm', '_npx');
+  if (existsSync(npxRoot)) {
+    for (const dir of readdirSync(npxRoot)) {
+      const nm = join(npxRoot, dir, 'node_modules');
+      if (!existsSync(nm)) continue;
+      try {
+        for (const entry of readdirSync(nm)) {
+          if (entry.startsWith('.') && entry.includes('-') && /[A-Za-z]{8}$/.test(entry)) {
+            try {
+              const p = join(nm, entry);
+              if (statSync(p).isDirectory()) rmSync(p, { recursive: true, force: true });
+            } catch {}
+          }
+        }
+      } catch {}
+    }
+  }
+} catch {}
+
 import { randomUUID } from 'crypto';
 import { listMCPTools, callMCPTool, hasTool } from '../dist/src/mcp-client.js';
 

package/bin/preinstall.cjs

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+/**
+ * Preinstall hook: repairs npm/npx cache to prevent ENOTEMPTY and ECOMPROMISED.
+ *
+ * Handles two common npm bugs in remote/CI/Codespaces environments:
+ *   - ENOTEMPTY: leftover .package-XxXxXxXx dirs from interrupted atomic renames
+ *   - ECOMPROMISED: corrupted integrity manifests in _cacache
+ *
+ * Works on Windows, macOS, and Linux. Uses only Node.js built-ins (CJS).
+ * Intentionally uses var/ES5 for maximum Node.js compatibility (14+).
+ */
+var fs = require('fs');
+var path = require('path');
+var os = require('os');
+
+var npmDir = path.join(os.homedir(), '.npm');
+
+// 1. Clean stale rename artifacts from npx cache (fixes ENOTEMPTY)
+try {
+  var npxRoot = path.join(npmDir, '_npx');
+  if (fs.existsSync(npxRoot)) {
+    var dirs = fs.readdirSync(npxRoot);
+    for (var i = 0; i < dirs.length; i++) {
+      var nm = path.join(npxRoot, dirs[i], 'node_modules');
+      if (fs.existsSync(nm) === false) continue;
+
+      try {
+        var entries = fs.readdirSync(nm);
+        for (var k = 0; k < entries.length; k++) {
+          var entry = entries[k];
+          // Stale rename targets: .package-name-XxXxXxXx (dot prefix, dash, 8+ alpha suffix)
+          if (entry.charAt(0) === '.' && entry.indexOf('-') > 0 && /[A-Za-z]{8}$/.test(entry)) {
+            try {
+              var p = path.join(nm, entry);
+              var stat = fs.statSync(p);
+              if (stat.isDirectory()) {
+                fs.rmSync(p, { recursive: true, force: true });
+              }
+            } catch (e) { /* ignore individual failures */ }
+          }
+        }
+      } catch (e) { /* can't read dir, skip */ }
+    }
+  }
+} catch (e) { /* non-fatal */ }
+
+// 2. Remove corrupted integrity entries from _cacache (fixes ECOMPROMISED)
+//    Only removes the index directory which contains integrity manifests.
+//    The content-v2 directory (actual cached tarballs) is left intact.
+try {
+  var cacheIndex = path.join(npmDir, '_cacache', 'index-v5');
+  if (fs.existsSync(cacheIndex)) {
+    // Check if the index is readable — if not, it's corrupted
+    try {
+      fs.readdirSync(cacheIndex);
+    } catch (e) {
+      if (e.code === 'EACCES' || e.code === 'EPERM') {
+        // Permission issue — try to fix
+        fs.rmSync(cacheIndex, { recursive: true, force: true });
+      }
+    }
+  }
+} catch (e) { /* non-fatal */ }
+
+// 3. Remove stale package-lock.json files from npx cache entries
+try {
+  if (fs.existsSync(npxRoot)) {
+    var cDirs = fs.readdirSync(npxRoot);
+    for (var j = 0; j < cDirs.length; j++) {
+      var lockFile = path.join(npxRoot, cDirs[j], 'package-lock.json');
+      try {
+        if (fs.existsSync(lockFile)) {
+          var lockStat = fs.statSync(lockFile);
+          // Remove lock files older than 1 hour (likely stale)
+          var ageMs = Date.now() - lockStat.mtimeMs;
+          if (ageMs > 3600000) {
+            fs.unlinkSync(lockFile);
+          }
+        }
+      } catch (e) { /* ignore */ }
+    }
+  }
+} catch (e) { /* non-fatal */ }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claude-flow/cli",
-  "version": "3.1.0-alpha.44",
+  "version": "3.1.0-alpha.45",
   "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",
@@ -75,6 +75,7 @@
     "test": "vitest run",
     "test:plugin-store": "npx tsx src/plugins/tests/standalone-test.ts",
     "test:pattern-store": "npx tsx src/transfer/store/tests/standalone-test.ts",
+    "preinstall": "node bin/preinstall.cjs || true",
     "prepublishOnly": "cp ../../../README.md ./README.md",
     "release": "npm version prerelease --preid=alpha && npm run publish:all",
     "publish:all": "./scripts/publish.sh"