create-merlin-brain 2.6.0 → 2.7.0

package/bin/install.cjs

@@ -395,7 +395,7 @@ function cleanupLegacy() {
     }
   }
 
-  // Clean config.json - remove briefed server, fix merlin server
+  // Clean config.json - remove briefed server, fix merlin server, migrate to global binary
   const configPath = path.join(CLAUDE_DIR, 'config.json');
   if (fs.existsSync(configPath)) {
     try {
@@ -403,26 +403,26 @@ function cleanupLegacy() {
       let modified = false;
 
       if (config.mcpServers?.briefed) {
-        // Save API key before deleting
         const apiKey = config.mcpServers.briefed.env?.CCWIKI_API_KEY ||
                        config.mcpServers.briefed.env?.MERLIN_API_KEY;
         delete config.mcpServers.briefed;
-        // Ensure merlin server exists with correct config
         if (apiKey) {
           config.mcpServers.merlin = {
-            command: 'npx',
-            args: ['create-merlin-brain@latest', 'serve'],
+            command: 'merlin-brain',
             env: { MERLIN_API_KEY: apiKey }
           };
         }
         modified = true;
       }
 
-      // Fix merlin server if it has wrong command
+      // Migrate merlin server to global binary
       if (config.mcpServers?.merlin) {
+        const cmd = config.mcpServers.merlin.command;
         const args = config.mcpServers.merlin.args;
-        if (args && (args[0] === 'create-merlin-brain' || args[0] === 'ccwiki-mcp')) {
-          config.mcpServers.merlin.args = ['create-merlin-brain@latest', 'serve'];
+        // Migrate from npx to global binary
+        if (cmd === 'npx' || (args && (args[0] === 'create-merlin-brain' || args[0] === 'ccwiki-mcp'))) {
+          config.mcpServers.merlin.command = 'merlin-brain';
+          delete config.mcpServers.merlin.args;
           modified = true;
         }
         if (config.mcpServers.merlin.env?.CCWIKI_API_KEY) {
@@ -435,7 +435,7 @@ function cleanupLegacy() {
 
       if (modified) {
         fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
-        cleaned.push('~/.claude/config.json (fixed MCP config)');
+        cleaned.push('~/.claude/config.json (migrated to global binary)');
       }
     } catch (e) { /* ignore */ }
   }
@@ -456,8 +456,7 @@ function cleanupLegacy() {
         delete config.mcpServers.briefed;
         if (apiKey) {
           config.mcpServers.merlin = {
-            command: 'npx',
-            args: ['create-merlin-brain@latest', 'serve'],
+            command: 'merlin-brain',
             env: { MERLIN_API_KEY: apiKey }
           };
         }
@@ -465,9 +464,11 @@ function cleanupLegacy() {
       }
 
       if (config.mcpServers?.merlin) {
+        const cmd = config.mcpServers.merlin.command;
         const args = config.mcpServers.merlin.args;
-        if (args && (args[0] === 'create-merlin-brain' || args[0] === 'ccwiki-mcp')) {
-          config.mcpServers.merlin.args = ['create-merlin-brain@latest', 'serve'];
+        if (cmd === 'npx' || (args && (args[0] === 'create-merlin-brain' || args[0] === 'ccwiki-mcp'))) {
+          config.mcpServers.merlin.command = 'merlin-brain';
+          delete config.mcpServers.merlin.args;
           modified = true;
         }
         if (config.mcpServers.merlin.env?.CCWIKI_API_KEY) {
@@ -480,7 +481,7 @@ function cleanupLegacy() {
 
       if (modified) {
         fs.writeFileSync(desktopConfigPath, JSON.stringify(config, null, 2));
-        cleaned.push('~/.claude/claude_desktop_config.json (fixed MCP config)');
+        cleaned.push('~/.claude/claude_desktop_config.json (migrated to global binary)');
       }
     } catch (e) { /* ignore */ }
   }
@@ -573,7 +574,7 @@ function cleanupLegacy() {
   }
 
   // ═══════════════════════════════════════════════════════════════
-  // FIX ~/.claude.json MCP REGISTRY (update old merlin-mcp to create-merlin-brain)
+  // FIX ~/.claude.json MCP REGISTRY (migrate to global binary)
   // ═══════════════════════════════════════════════════════════════
   const claudeJsonPath = path.join(os.homedir(), '.claude.json');
   if (fs.existsSync(claudeJsonPath)) {
@@ -581,14 +582,15 @@ function cleanupLegacy() {
       let claudeJson = JSON.parse(fs.readFileSync(claudeJsonPath, 'utf8'));
       let modified = false;
 
-      // Check if merlin MCP server uses old package name
+      // Migrate merlin MCP server to global binary
       if (claudeJson.mcpServers?.merlin) {
+        const cmd = claudeJson.mcpServers.merlin.command;
         const args = claudeJson.mcpServers.merlin.args;
-        if (args && (args[0] === 'merlin-mcp' || args[0] === 'merlin-mcp@latest' || args[0] === 'ccwiki-mcp')) {
-          // Update to new package name
-          claudeJson.mcpServers.merlin.args = ['create-merlin-brain@latest', 'serve'];
+        if (cmd === 'npx' || (args && (args[0] === 'merlin-mcp' || args[0] === 'merlin-mcp@latest' || args[0] === 'ccwiki-mcp' || args[0] === 'create-merlin-brain@latest'))) {
+          claudeJson.mcpServers.merlin.command = 'merlin-brain';
+          delete claudeJson.mcpServers.merlin.args;
           modified = true;
-          cleaned.push('~/.claude.json (updated merlin-mcp → create-merlin-brain)');
+          cleaned.push('~/.claude.json (migrated to global binary)');
         }
       }
 
@@ -605,6 +607,25 @@ function cleanupLegacy() {
     } catch (e) { /* ignore */ }
   }
 
+  // ═══════════════════════════════════════════════════════════════
+  // CLEAN NPX CACHE (remove old cached versions of merlin packages)
+  // ═══════════════════════════════════════════════════════════════
+  try {
+    const npxCacheDir = path.join(os.homedir(), '.npm', '_npx');
+    if (fs.existsSync(npxCacheDir)) {
+      const entries = fs.readdirSync(npxCacheDir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (!entry.isDirectory()) continue;
+        const pkgJsonPath = path.join(npxCacheDir, entry.name, 'node_modules', 'create-merlin-brain', 'package.json');
+        const pkgJsonPath2 = path.join(npxCacheDir, entry.name, 'node_modules', 'create-merlin-pro', 'package.json');
+        if (fs.existsSync(pkgJsonPath) || fs.existsSync(pkgJsonPath2)) {
+          removeDirRecursive(path.join(npxCacheDir, entry.name));
+          cleaned.push('~/.npm/_npx/' + entry.name + ' (old npx cache)');
+        }
+      }
+    }
+  } catch (e) { /* ignore - npx cache cleanup is best-effort */ }
+
   // ═══════════════════════════════════════════════════════════════
   // PATTERN-BASED CLEANUP IN AGENTS DIR
   // ═══════════════════════════════════════════════════════════════
@@ -707,7 +728,7 @@ async function install() {
   }
 
   // Step 0: Clean up legacy GSD/ccwiki artifacts
-  logStep('0/8', 'Cleaning up legacy installations...');
+  logStep('0/9', 'Cleaning up legacy installations...');
   const cleaned = cleanupLegacy();
   if (cleaned.length > 0) {
     for (const item of cleaned) {
@@ -717,16 +738,53 @@ async function install() {
     logSuccess('No legacy artifacts found');
   }
 
-  // Step 1: Create directories
-  logStep('1/8', 'Creating directories...');
+  // Step 1: Install globally for instant startup across all terminals
+  logStep('1/9', 'Installing globally (fast startup for all terminals)...');
+  try {
+    const { execSync } = require('child_process');
+    // Check if already installed globally and up-to-date
+    let needsInstall = true;
+    try {
+      const globalVersion = execSync('merlin-brain --version 2>/dev/null || echo "none"', { encoding: 'utf8' }).trim();
+      const localVersion = require('../package.json').version;
+      if (globalVersion === localVersion) {
+        logSuccess(`Already installed globally (v${localVersion})`);
+        needsInstall = false;
+      }
+    } catch (e) { /* not installed globally yet */ }
+
+    if (needsInstall) {
+      const localVersion = require('../package.json').version;
+      execSync(`npm install -g create-merlin-brain@${localVersion}`, { stdio: 'pipe' });
+      logSuccess('Installed merlin-brain globally');
+      logSuccess('All terminals now share the same fast binary');
+    }
+  } catch (e) {
+    logWarn('Could not install globally (permissions issue?)');
+    logWarn('Falling back to npx mode. To fix, run: sudo npm install -g create-merlin-brain');
+    logWarn('Or use: npm config set prefix ~/.npm-global && export PATH=~/.npm-global/bin:$PATH');
+  }
+
+  // Check if global binary is available (determines MCP config style)
+  let useGlobalBinary = false;
+  try {
+    const { execSync } = require('child_process');
+    execSync('which merlin-brain', { stdio: 'pipe' });
+    useGlobalBinary = true;
+  } catch (e) {
+    useGlobalBinary = false;
+  }
+
+  // Step 2: Create directories
+  logStep('2/9', 'Creating directories...');
   ensureDir(CLAUDE_DIR);
   ensureDir(MERLIN_DIR);
   ensureDir(AGENTS_DIR);
   ensureDir(COMMANDS_DIR);
   logSuccess('Directories created');
 
-  // Step 2: Install Merlin core (workflows, references, templates)
-  logStep('2/8', 'Installing Merlin workflows...');
+  // Step 3: Install Merlin core (workflows, references, templates)
+  logStep('3/9', 'Installing Merlin workflows...');
   const merlinSrc = path.join(filesDir, 'merlin');
   if (fs.existsSync(merlinSrc)) {
     const count = copyDirRecursive(merlinSrc, MERLIN_DIR);
@@ -735,8 +793,8 @@ async function install() {
     logWarn('Merlin workflows not found in package');
   }
 
-  // Step 3: Install agents
-  logStep('3/8', 'Installing Merlin agents...');
+  // Step 4: Install agents
+  logStep('4/9', 'Installing Merlin agents...');
   const agentsSrc = path.join(filesDir, 'agents');
   if (fs.existsSync(agentsSrc)) {
     const count = copyDirRecursive(agentsSrc, AGENTS_DIR);
@@ -745,8 +803,8 @@ async function install() {
     logWarn('Agents not found in package');
   }
 
-  // Step 4: Install commands
-  logStep('4/8', 'Installing /merlin:* commands...');
+  // Step 5: Install commands
+  logStep('5/9', 'Installing /merlin:* commands...');
   const commandsSrc = path.join(filesDir, 'commands', 'merlin');
   if (fs.existsSync(commandsSrc)) {
     const count = copyDirRecursive(commandsSrc, COMMANDS_DIR);
@@ -755,8 +813,8 @@ async function install() {
     logWarn('Commands not found in package');
   }
 
-  // Step 5: Install CLAUDE.md
-  logStep('5/8', 'Configuring Claude Code...');
+  // Step 6: Install CLAUDE.md
+  logStep('6/9', 'Configuring Claude Code...');
   const claudeMdSrc = path.join(filesDir, 'CLAUDE.md');
   const claudeMdDest = path.join(CLAUDE_DIR, 'CLAUDE.md');
 
@@ -767,8 +825,8 @@ async function install() {
     logSuccess('Installed CLAUDE.md (Merlin instructions)');
   }
 
-  // Step 6: Install Merlin Loop (autonomous orchestration)
-  logStep('6/8', 'Installing Merlin Loop...');
+  // Step 7: Install Merlin Loop (autonomous orchestration)
+  logStep('7/9', 'Installing Merlin Loop...');
   const loopSrc = path.join(filesDir, 'loop');
   if (fs.existsSync(loopSrc)) {
     ensureDir(LOOP_DIR);
@@ -793,8 +851,18 @@ async function install() {
     logWarn('Merlin Loop not found in package');
   }
 
-  // Step 7: Optional Merlin Sights configuration
-  logStep('7/8', 'Optional: Merlin Sights configuration...');
+  // Helper: create MCP config object based on available binary
+  function mcpConfig(apiKey, includeType) {
+    const cfg = useGlobalBinary
+      ? { command: 'merlin-brain' }
+      : { command: 'npx', args: ['create-merlin-brain@latest', 'serve'] };
+    if (includeType) cfg.type = 'stdio';
+    if (apiKey) cfg.env = { MERLIN_API_KEY: apiKey };
+    return cfg;
+  }
+
+  // Step 8: Optional Merlin Sights configuration
+  logStep('8/9', 'Optional: Merlin Sights configuration...');
   console.log(`Merlin Sights provides instant codebase context.`);
   console.log(`Get your API key at: ${colors.cyan}https://merlin.build${colors.reset}`);
 
@@ -813,13 +881,7 @@ async function install() {
     }
 
     config.mcpServers = config.mcpServers || {};
-    config.mcpServers.merlin = {
-      command: 'npx',
-      args: ['create-merlin-brain@latest', 'serve'],
-      env: {
-        MERLIN_API_KEY: apiKey
-      }
-    };
+    config.mcpServers.merlin = mcpConfig(apiKey, false);
 
     fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
     logSuccess('Merlin Sights configured for Claude Code CLI');
@@ -839,13 +901,7 @@ async function install() {
       }
 
       desktopConfig.mcpServers = desktopConfig.mcpServers || {};
-      desktopConfig.mcpServers.merlin = {
-        command: 'npx',
-        args: ['create-merlin-brain@latest', 'serve'],
-        env: {
-          MERLIN_API_KEY: apiKey
-        }
-      };
+      desktopConfig.mcpServers.merlin = mcpConfig(apiKey, false);
 
       // Ensure directory exists
       const desktopConfigDir = path.dirname(desktopConfigPath);
@@ -868,11 +924,7 @@ async function install() {
       }
     }
     claudeDirConfig.mcpServers = claudeDirConfig.mcpServers || {};
-    claudeDirConfig.mcpServers.merlin = {
-      command: 'npx',
-      args: ['create-merlin-brain@latest', 'serve'],
-      env: { MERLIN_API_KEY: apiKey }
-    };
+    claudeDirConfig.mcpServers.merlin = mcpConfig(apiKey, false);
     fs.writeFileSync(claudeDirDesktopConfig, JSON.stringify(claudeDirConfig, null, 2));
     logSuccess('Merlin Sights configured for ~/.claude/claude_desktop_config.json');
 
@@ -882,12 +934,7 @@ async function install() {
       try {
         let claudeJson = JSON.parse(fs.readFileSync(claudeJsonPath, 'utf8'));
         claudeJson.mcpServers = claudeJson.mcpServers || {};
-        claudeJson.mcpServers.merlin = {
-          type: 'stdio',
-          command: 'npx',
-          args: ['create-merlin-brain@latest', 'serve'],
-          env: { MERLIN_API_KEY: apiKey }
-        };
+        claudeJson.mcpServers.merlin = mcpConfig(apiKey, true);
         fs.writeFileSync(claudeJsonPath, JSON.stringify(claudeJson, null, 2));
         logSuccess('Merlin Sights configured for ~/.claude.json (Claude MCP registry)');
       } catch (e) {
@@ -896,28 +943,25 @@ async function install() {
     } else {
       // Create ~/.claude.json with MCP config if it doesn't exist
       try {
-        const claudeJson = {
-          mcpServers: {
-            merlin: {
-              type: 'stdio',
-              command: 'npx',
-              args: ['create-merlin-brain@latest', 'serve'],
-              env: { MERLIN_API_KEY: apiKey }
-            }
-          }
-        };
+        const claudeJson = { mcpServers: { merlin: mcpConfig(apiKey, true) } };
         fs.writeFileSync(claudeJsonPath, JSON.stringify(claudeJson, null, 2));
         logSuccess('Merlin Sights configured for ~/.claude.json (Claude MCP registry - created)');
       } catch (e) {
         logWarn('Could not create ~/.claude.json');
       }
     }
+
+    if (useGlobalBinary) {
+      logSuccess(`Using global binary (merlin-brain) — instant startup in all terminals!`);
+    } else {
+      logWarn('Using npx fallback — run "npm install -g create-merlin-brain" for faster startup');
+    }
   } else {
     logWarn('Skipped Merlin Sights (you can configure it later)');
   }
 
-  // Step 7: Set up shell integration
-  logStep('8/8', 'Setting up shell integration...');
+  // Step 9: Set up shell integration
+  logStep('9/9', 'Setting up shell integration...');
   const shellConfigured = setupShellIntegration();
   if (shellConfigured) {
     log(`\n  ${colors.yellow}IMPORTANT:${colors.reset} Run ${colors.cyan}source ~/.zshrc${colors.reset} or ${colors.bright}restart your terminal${colors.reset}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-merlin-brain",
-  "version": "2.6.0",
+  "version": "2.7.0",
   "description": "Merlin - The Ultimate AI Brain for Claude Code. Installs workflows, agents, and Sights MCP server.",
   "type": "module",
   "main": "./dist/server/index.js",