create-merlin-brain 3.11.0 → 3.13.0

package/bin/install.cjs

@@ -11,6 +11,11 @@
 const isServeMode = process.argv.includes('serve');
 const isInjectMode = process.argv.includes('inject-headers');
 
+// --runtime flag: 'all' | 'claude' | 'codex' | 'opencode' | 'gemini'
+// Default: 'all' (configure all detected runtimes)
+const runtimeFlagIdx = process.argv.indexOf('--runtime');
+const RUNTIME_FLAG = runtimeFlagIdx !== -1 ? (process.argv[runtimeFlagIdx + 1] || 'all') : 'all';
+
 // =============================================================================
 // MODE: inject-headers - Add Merlin reminder to CLAUDE.md files
 // =============================================================================
@@ -101,12 +106,14 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 const readline = require('readline');
+const { detectRuntimes, configureRuntimes } = require('./runtime-adapters.cjs');
 
 const CLAUDE_DIR = path.join(os.homedir(), '.claude');
 const MERLIN_DIR = path.join(CLAUDE_DIR, 'merlin');
 const AGENTS_DIR = path.join(CLAUDE_DIR, 'agents');
 const COMMANDS_DIR = path.join(CLAUDE_DIR, 'commands', 'merlin');
 const LOOP_DIR = path.join(CLAUDE_DIR, 'loop');
+const RULES_DIR = path.join(CLAUDE_DIR, 'rules');
 
 const colors = {
   reset: '\x1b[0m',
@@ -138,7 +145,7 @@ function logError(msg) {
   log(`  ${colors.red}✗${colors.reset} ${msg}`);
 }
 
-// Minimum Claude Code version required (--agent flag support)
+// Minimum Claude Code version required (MCP server support)
 const MIN_CLAUDE_VERSION = '2.0.0';
 
 function parseVersion(v) {
@@ -192,7 +199,7 @@ function ensureClaudeCode() {
   }
 
   // Needs update
-  logWarn(`Claude Code v${currentVersion} is too old (need >= ${MIN_CLAUDE_VERSION} for --agent support)`);
+  logWarn(`Claude Code v${currentVersion} is too old (need >= ${MIN_CLAUDE_VERSION})`);
   log(`  ${colors.cyan}Updating Claude Code...${colors.reset}`);
 
   try {
@@ -333,23 +340,17 @@ function setupShellIntegration() {
   } else {
     logWarn(`Unknown shell (${shell}), skipping shell setup`);
     log(`  Add manually to your shell rc file:`);
-    log(`  ${colors.cyan}function claude() { command claude --agent merlin "$@"; }${colors.reset}`);
     log(`  ${colors.cyan}alias cc='claude'${colors.reset}`);
     return false;
   }
 
-  // Simple Merlin shell integration - just wrap claude with merlin agent
+  // Merlin shell integration - shortcut alias and loop command
   const merlinBlock = `
 # ══════════════════════════════════════════════════════════════
 # Merlin Brain - The AI Brain for Claude Code
 # https://merlin.build
 # ══════════════════════════════════════════════════════════════
 
-# Simple claude wrapper - run with merlin agent
-claude() {
-  command claude --agent merlin "$@"
-}
-
 # Shortcut alias
 alias cc="claude"
 
@@ -380,11 +381,17 @@ merlin-loop() {
       fs.writeFileSync(rcFile, rcContent);
       logSuccess('Updating existing Merlin shell integration');
     }
+
+    // Remove broken claude() wrapper from older installs (--agent flag doesn't exist)
+    if (rcContent.includes('command claude --agent')) {
+      rcContent = rcContent.replace(/\n?# Simple claude wrapper.*\nclaude\(\) \{\n\s*command claude --agent.*\n\}\n?/g, '\n');
+      fs.writeFileSync(rcFile, rcContent);
+      logSuccess('Removed broken claude() wrapper (--agent flag is not valid)');
+    }
   }
 
   // Add new Merlin integration block
   fs.appendFileSync(rcFile, merlinBlock);
-  logSuccess(`Configured 'claude' command to use Merlin`);
   logSuccess(`Added 'cc' shortcut`);
   logSuccess(`Version check enabled (run /merlin:update to update)`);
   return true;
@@ -838,7 +845,7 @@ async function install() {
   }
 
   // Step 0: Clean up legacy GSD/ccwiki artifacts
-  logStep('0/11', 'Cleaning up legacy installations...');
+  logStep('0/13', 'Cleaning up legacy installations...');
   const cleaned = cleanupLegacy();
   if (cleaned.length > 0) {
     for (const item of cleaned) {
@@ -849,11 +856,24 @@ async function install() {
   }
 
   // Step 1: Ensure Claude Code is installed and up to date
-  logStep('1/11', 'Checking Claude Code...');
+  logStep('1/13', 'Checking Claude Code...');
   const claudeCheck = ensureClaudeCode();
 
-  // Step 2: Install globally for instant startup across all terminals
-  logStep('2/11', 'Installing globally (fast startup for all terminals)...');
+  // Step 2: Detect runtimes
+  logStep('2/13', 'Detecting runtimes...');
+  const detectedRuntimes = detectRuntimes();
+  log(`  ${colors.green}✅${colors.reset} Claude Code (primary)`);
+  for (const rt of detectedRuntimes) {
+    const icon = rt.found ? `${colors.green}✅${colors.reset}` : `${colors.yellow}⬚${colors.reset}`;
+    const suffix = rt.found ? '' : ' (not found)';
+    log(`  ${icon} ${rt.label}${suffix}`);
+  }
+  if (RUNTIME_FLAG === 'claude') {
+    log(`  ${colors.yellow}--runtime claude:${colors.reset} other runtimes will not be configured`);
+  }
+
+  // Step 3: Install globally for instant startup across all terminals
+  logStep('3/13', 'Installing globally (fast startup for all terminals)...');
   try {
     const { execSync } = require('child_process');
     // Check if already installed globally and up-to-date
@@ -893,16 +913,16 @@ async function install() {
     useGlobalBinary = false;
   }
 
-  // Step 3: Create directories
-  logStep('3/11', 'Creating directories...');
+  // Step 4: Create directories
+  logStep('4/13', 'Creating directories...');
   ensureDir(CLAUDE_DIR);
   ensureDir(MERLIN_DIR);
   ensureDir(AGENTS_DIR);
   ensureDir(COMMANDS_DIR);
   logSuccess('Directories created');
 
-  // Step 4: Install Merlin core (workflows, references, templates)
-  logStep('4/11', 'Installing Merlin workflows...');
+  // Step 5: Install Merlin core (workflows, references, templates)
+  logStep('5/13', 'Installing Merlin workflows...');
   const merlinSrc = path.join(filesDir, 'merlin');
   if (fs.existsSync(merlinSrc)) {
     const count = copyDirRecursive(merlinSrc, MERLIN_DIR);
@@ -914,8 +934,8 @@ async function install() {
     logWarn('Merlin workflows not found in package');
   }
 
-  // Step 5: Install agents (tiered)
-  logStep('5/11', 'Installing Merlin agents...');
+  // Step 6: Install agents (tiered)
+  logStep('6/13', 'Installing Merlin agents...');
   const agentsSrc = path.join(filesDir, 'agents');
   if (fs.existsSync(agentsSrc)) {
     // Load agent manifest for tiered display
@@ -942,8 +962,32 @@ async function install() {
     logWarn('Agents not found in package');
   }
 
-  // Step 6: Install commands
-  logStep('6/11', 'Installing /merlin:* commands...');
+  // Step 7: Install path-scoped rules
+  logStep('7/13', 'Installing path-scoped rules...');
+  const rulesSrc = path.join(filesDir, 'rules');
+  if (fs.existsSync(rulesSrc)) {
+    ensureDir(RULES_DIR);
+    const ruleFiles = fs.readdirSync(rulesSrc).filter(f => f.endsWith('.md'));
+    let installedCount = 0;
+    let skippedCount = 0;
+    for (const ruleFile of ruleFiles) {
+      const destPath = path.join(RULES_DIR, ruleFile);
+      // Never overwrite existing user rules — they may have been customized
+      if (fs.existsSync(destPath)) {
+        skippedCount++;
+      } else {
+        fs.copyFileSync(path.join(rulesSrc, ruleFile), destPath);
+        installedCount++;
+      }
+    }
+    if (installedCount > 0) logSuccess(`Installed ${installedCount} path-scoped rule files`);
+    if (skippedCount > 0) logSuccess(`Skipped ${skippedCount} existing rule files (user customizations preserved)`);
+  } else {
+    logWarn('Rules not found in package');
+  }
+
+  // Step 8: Install commands
+  logStep('8/13', 'Installing /merlin:* commands...');
   const commandsSrc = path.join(filesDir, 'commands', 'merlin');
   if (fs.existsSync(commandsSrc)) {
     const count = copyDirRecursive(commandsSrc, COMMANDS_DIR);
@@ -952,8 +996,8 @@ async function install() {
     logWarn('Commands not found in package');
   }
 
-  // Step 7: Install CLAUDE.md
-  logStep('7/11', 'Configuring Claude Code...');
+  // Step 9: Install CLAUDE.md
+  logStep('9/13', 'Configuring Claude Code...');
   const claudeMdSrc = path.join(filesDir, 'CLAUDE.md');
   const claudeMdDest = path.join(CLAUDE_DIR, 'CLAUDE.md');
 
@@ -964,12 +1008,12 @@ async function install() {
     logSuccess('Installed CLAUDE.md (Merlin instructions)');
   }
 
-  // Step 8: Install Merlin Loop (legacy — kept for backward compatibility)
+  // Step 10: Install Merlin Loop (legacy — kept for backward compatibility)
   // NOTE: Claude Code now has a native /loop command that replaces these scripts.
   // Use /merlin:loop-recipes in Claude Code for pre-built loop patterns.
   // These scripts are still copied so existing users and terminal workflows
   // (merlin-loop, merlin session) continue to work without interruption.
-  logStep('8/11', 'Installing Merlin Loop (legacy scripts)...');
+  logStep('10/13', 'Installing Merlin Loop (legacy scripts)...');
   const loopSrc = path.join(filesDir, 'loop');
   if (fs.existsSync(loopSrc)) {
     ensureDir(LOOP_DIR);
@@ -996,12 +1040,13 @@ async function install() {
     logSuccess(`Installed ${count} loop files`);
     logSuccess(`Added 'merlin-loop' command`);
     logSuccess(`Added 'merlin session' command (interactive orchestrator)`);
+    logWarn(`Note: Custom loop scripts are deprecated. Use /loop with /merlin:loop-recipes instead.`);
   } else {
     logWarn('Merlin Loop not found in package');
   }
 
-  // Step 9: Install Claude Code hooks
-  logStep('9/11', 'Installing Claude Code hooks...');
+  // Step 11: Install Claude Code hooks
+  logStep('11/13', 'Installing Claude Code hooks...');
   const HOOKS_DIR = path.join(CLAUDE_DIR, 'hooks');
   const hooksSrc = path.join(filesDir, 'hooks');
   if (fs.existsSync(hooksSrc)) {
@@ -1100,6 +1145,27 @@ async function install() {
       hooks: [{ type: 'command', command: 'bash ~/.claude/hooks/session-end.sh' }]
     });
 
+    // Stop hook: desktop notification (fires after session-end analytics)
+    addHookIfMissing(settings.hooks.Stop, {
+      hooks: [{ type: 'command', command: 'bash ~/.claude/hooks/notify-desktop.sh' }]
+    });
+
+    // Stop hook: webhook notification (Slack / Discord, fire-and-forget)
+    addHookIfMissing(settings.hooks.Stop, {
+      hooks: [{ type: 'command', command: 'bash ~/.claude/hooks/notify-webhook.sh' }]
+    });
+
+    // Stop hook: auto-memory sync (extracts session decisions → Sights cloud)
+    addHookIfMissing(settings.hooks.Stop, {
+      hooks: [{ type: 'command', command: 'bash ~/.claude/hooks/session-end-memory-sync.sh' }]
+    });
+
+    // Notification hook: desktop alert when Claude needs input
+    settings.hooks.Notification = settings.hooks.Notification || [];
+    addHookIfMissing(settings.hooks.Notification, {
+      hooks: [{ type: 'command', command: 'bash ~/.claude/hooks/notify-desktop.sh' }]
+    });
+
     // TeammateIdle hook (Agent Teams quality gate — only fires when Teams active)
     settings.hooks.TeammateIdle = settings.hooks.TeammateIdle || [];
     addHookIfMissing(settings.hooks.TeammateIdle, {
@@ -1124,6 +1190,48 @@ async function install() {
       hooks: [{ type: 'command', command: 'bash ~/.claude/hooks/task-completed-verify.sh' }]
     });
 
+    // InstructionsLoaded hook (cold-start Sights pre-warm)
+    settings.hooks.InstructionsLoaded = settings.hooks.InstructionsLoaded || [];
+    addHookIfMissing(settings.hooks.InstructionsLoaded, {
+      hooks: [{ type: 'command', command: 'bash ~/.claude/hooks/instructions-loaded.sh' }]
+    });
+
+    // WorktreeCreate hook (propagate Merlin config into new worktrees)
+    settings.hooks.WorktreeCreate = settings.hooks.WorktreeCreate || [];
+    addHookIfMissing(settings.hooks.WorktreeCreate, {
+      hooks: [{ type: 'command', command: 'bash ~/.claude/hooks/worktree-create.sh' }]
+    });
+
+    // WorktreeRemove hook (cleanup + lifecycle analytics)
+    settings.hooks.WorktreeRemove = settings.hooks.WorktreeRemove || [];
+    addHookIfMissing(settings.hooks.WorktreeRemove, {
+      hooks: [{ type: 'command', command: 'bash ~/.claude/hooks/worktree-remove.sh' }]
+    });
+
+    // ConfigChange hook (validate API key + audit trail)
+    settings.hooks.ConfigChange = settings.hooks.ConfigChange || [];
+    addHookIfMissing(settings.hooks.ConfigChange, {
+      hooks: [{ type: 'command', command: 'bash ~/.claude/hooks/config-change.sh' }]
+    });
+
+    // PostToolUse: file size enforcement (implementation agents only)
+    addHookIfMissing(settings.hooks.PostToolUse, {
+      matcher: 'Edit|Write',
+      hooks: [{ type: 'command', command: 'bash ~/.claude/hooks/check-file-size.sh' }]
+    });
+
+    // PreToolUse: security scanner (prompt injection, secrets, data exfiltration)
+    addHookIfMissing(settings.hooks.PreToolUse, {
+      matcher: 'Write|Edit|Bash|NotebookEdit',
+      hooks: [{ type: 'command', command: 'bash ~/.claude/hooks/security-scanner.sh' }]
+    });
+
+    // PreToolUse: smart bash auto-approval (read-only safe, dangerous blocked, unknown pass-through)
+    addHookIfMissing(settings.hooks.PreToolUse, {
+      matcher: 'Bash',
+      hooks: [{ type: 'command', command: 'bash ~/.claude/hooks/smart-approve.sh' }]
+    });
+
     // --- Prompt-based hooks cleanup & registration ---
     // Remove ALL prompt-type hooks from Merlin (identified by type: 'prompt').
     // This prevents duplicates across version upgrades and removes broken hooks.
@@ -1144,6 +1252,10 @@ async function install() {
     settings.hooks.Notification = removeAllPromptHooks(settings.hooks.Notification);
     settings.hooks.TaskCompleted = settings.hooks.TaskCompleted || [];
     settings.hooks.TaskCompleted = removeAllPromptHooks(settings.hooks.TaskCompleted);
+    settings.hooks.InstructionsLoaded = removeAllPromptHooks(settings.hooks.InstructionsLoaded || []);
+    settings.hooks.WorktreeCreate = removeAllPromptHooks(settings.hooks.WorktreeCreate || []);
+    settings.hooks.WorktreeRemove = removeAllPromptHooks(settings.hooks.WorktreeRemove || []);
+    settings.hooks.ConfigChange = removeAllPromptHooks(settings.hooks.ConfigChange || []);
 
     // NOTE: The PreToolUse prompt hook has been REMOVED. It caused an infinite
     // rejection loop because the evaluator model cannot see conversation history
@@ -1189,8 +1301,8 @@ async function install() {
     return cfg;
   }
 
-  // Step 10: Optional Merlin Sights configuration
-  logStep('10/11', 'Merlin Sights configuration...');
+  // Step 12: Optional Merlin Sights configuration
+  logStep('12/13', 'Merlin Sights configuration...');
 
   // Check if API key is already configured (skip prompt on updates)
   let existingApiKey = '';
@@ -1321,8 +1433,20 @@ async function install() {
     logWarn('Skipped Merlin Sights (you can configure it later)');
   }
 
-  // Step 11: Set up shell integration
-  logStep('11/11', 'Setting up shell integration...');
+  // Step 13: Configure non-Claude-Code runtimes
+  logStep('13/13', 'Configuring additional runtimes...');
+  configureRuntimes({
+    runtimeFlag: RUNTIME_FLAG,
+    useGlobalBinary,
+    apiKey,
+    logSuccess,
+    logWarn,
+    logInfo: (msg) => log(msg),
+    quiet: true, // step 2 already printed the detection summary
+  });
+
+  // Shell integration (runs after runtime adapters)
+  log(`\n${colors.cyan}[shell]${colors.reset} 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}`);