@devo-bmad-custom/agent-orchestration 1.0.0 → 1.0.1

package/lib/installer.js

@@ -130,8 +130,10 @@ async function install(opts) {
   // ── Interactive prompts ───────────────────────────────────────────────────
   let resolvedUserName = userName;
 
+  let resolvedTools = tools ? tools.split(',').map(t => t.trim()).filter(t => t !== 'none') : ['claude-code'];
+
   if (!yes) {
-    const { intro, text, select, outro } = require('@clack/prompts');
+    const { intro, text, multiselect, outro, isCancel } = require('@clack/prompts');
     intro(chalk.bold.cyan(`BMAD Method — ${isUpdate ? 'Update' : 'Install'}`));
 
     if (isUpdate && existingManifest) {
@@ -145,12 +147,31 @@ async function install(opts) {
         placeholder: 'Developer',
         defaultValue: existingManifest?.userName || 'Developer',
       });
+      if (isCancel(resolvedUserName)) { process.exit(0); }
+    }
+
+    const platformChoices = await multiselect({
+      message: 'Which AI tools / IDEs are you installing for?',
+      options: [
+        { value: 'claude-code',     label: 'Claude Code',     hint: 'agents, CLAUDE.md, settings.json, tmux setup' },
+        { value: 'cursor',          label: 'Cursor',          hint: '.cursor/rules/bmad.mdc' },
+        { value: 'windsurf',        label: 'Windsurf',        hint: '.windsurfrules' },
+        { value: 'cline',           label: 'Cline',           hint: '.clinerules' },
+        { value: 'github-copilot',  label: 'GitHub Copilot',  hint: '.github/copilot-instructions.md' },
+        { value: 'gemini',          label: 'Gemini CLI',      hint: 'GEMINI.md' },
+      ],
+      initialValues: existingManifest?.tools || ['claude-code'],
+      required: false,
+    });
+    if (isCancel(platformChoices)) { process.exit(0); }
+    if (platformChoices && platformChoices.length > 0) {
+      resolvedTools = platformChoices;
     }
+
     outro(`${isUpdate ? 'Updating' : 'Installing'} BMAD...`);
   }
 
   const selectedModules = modules.split(',').map(m => m.trim()).filter(Boolean);
-  const resolvedTools = tools ? tools.split(',').map(t => t.trim()).filter(t => t !== 'none') : [];
 
   console.log(`\n${chalk.bold.blue('BMAD')} ${isUpdate ? 'Update' : 'Install'}`);
   console.log(`  Target:   ${chalk.cyan(projectRoot)}`);
@@ -636,21 +657,46 @@ async function setupTmux(projectRoot, chalk) {
         console.log(chalk.dim('     pane-title-changed hook requires set-hook -wg (3.4 feature)'));
         console.log(chalk.dim('     Upgrade: sudo apt-get install -y tmux  (or build from source for latest)\n'));
       } else {
-        console.log(chalk.green(`  ✓  tmux ${match[1]}.${match[2]} — version OK`));
+        console.log(chalk.green(`  ✓  tmux ${match[1]}.${match[2]} — version OK\n`));
       }
     }
   } catch { /* tmux not installed yet — skip check */ }
 
-  console.log('\n' + chalk.bold('Step 1 — Prerequisites'));
-  console.log(chalk.dim('  tmux runs in WSL2 (Ubuntu). You need these before continuing:\n'));
-  console.log('  ' + chalk.white('① WSL2 + Ubuntu') + chalk.dim(' — in PowerShell (Admin): ') + chalk.cyan('wsl --install'));
-  console.log('  ' + chalk.white('② Update packages') + chalk.dim(' — in Ubuntu: ') + chalk.cyan('sudo apt-get update && sudo apt-get upgrade -y'));
-  console.log('  ' + chalk.white('③ Install tmux 3.4+') + chalk.dim(' — ') + chalk.cyan('sudo apt-get install -y tmux'));
-  console.log('  ' + chalk.white('④ Install clipboard + image tools') + chalk.dim(' — ') + chalk.cyan('sudo apt-get install -y wl-clipboard imagemagick wslu'));
-  console.log('  ' + chalk.white('⑤ NVM + Node') + chalk.dim(' (for MCP servers) — ') + chalk.cyan('curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash && source ~/.bashrc && nvm install --lts'));
-  console.log('  ' + chalk.white('⑥ Docker Desktop WSL integration') + chalk.dim(' — Docker Desktop → Settings → Resources → WSL Integration → toggle your Ubuntu distro → Apply & Restart'));
-
-  console.log('\n' + chalk.dim('  These require sudo/GUI and must be done manually. Press Enter once WSL2 is ready.'));
+  // ── Step 1: Prerequisites ────────────────────────────────────────────────
+  console.log(chalk.bold('Step 1 — Prerequisites'));
+  console.log('');
+
+  console.log(chalk.bold.red('  ⛔ Must be done manually (require WSL install or sudo):'));
+  console.log(chalk.dim('     These cannot be automated. Complete them before continuing.\n'));
+  console.log('  ' + chalk.white('① Install WSL2 + Ubuntu') + chalk.dim(' — run in PowerShell (Admin):'));
+  console.log('    ' + chalk.cyan('wsl --install'));
+  console.log('  ' + chalk.white('② Update packages') + chalk.dim(' — run in Ubuntu terminal:'));
+  console.log('    ' + chalk.cyan('sudo apt-get update && sudo apt-get upgrade -y'));
+  console.log('  ' + chalk.white('③ Install tmux 3.4+') + chalk.dim(' — run in Ubuntu terminal:'));
+  console.log('    ' + chalk.cyan('sudo apt-get install -y tmux'));
+  console.log('  ' + chalk.white('④ Install clipboard + image tools') + chalk.dim(' — run in Ubuntu terminal:'));
+  console.log('    ' + chalk.cyan('sudo apt-get install -y wl-clipboard imagemagick wslu'));
+  console.log('  ' + chalk.white('⑤ Docker Desktop WSL integration') + chalk.dim(' — GUI only:'));
+  console.log('    ' + chalk.dim('Docker Desktop → Settings → Resources → WSL Integration → toggle Ubuntu → Apply & Restart'));
+
+  console.log('');
+  console.log(chalk.bold.yellow('  ✦ Can be done manually OR by an AI with relaxed permissions:'));
+  console.log(chalk.dim('     These are safe to automate — no sudo or system-level access needed.\n'));
+  console.log('  ' + chalk.white('⑥ NVM + Node') + chalk.dim(' (required for Node-based MCP servers):'));
+  console.log('    ' + chalk.cyan('curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash'));
+  console.log('    ' + chalk.cyan('source ~/.bashrc && nvm install --lts'));
+  console.log('  ' + chalk.white('⑦ TPM (tmux Plugin Manager):'));
+  console.log('    ' + chalk.cyan('git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm'));
+  console.log('    ' + chalk.dim('    Then inside tmux: press Ctrl+B I to install plugins'));
+  console.log('  ' + chalk.white('⑧ fzf') + chalk.dim(' (required for Actions popup menu):'));
+  console.log('    ' + chalk.cyan('mkdir -p ~/.local/bin && curl -Lo /tmp/fzf.tar.gz https://github.com/junegunn/fzf/releases/download/v0.54.3/fzf-0.54.3-linux_amd64.tar.gz && tar -xzf /tmp/fzf.tar.gz -C ~/.local/bin'));
+  console.log('  ' + chalk.white('⑨ Nerd Fonts') + chalk.dim(' (required for Powerline status bar separators):'));
+  console.log('    ' + chalk.dim('    Download JetBrainsMono NFM from https://www.nerdfonts.com/'));
+  console.log('    ' + chalk.dim('    Install JetBrainsMonoNerdFontMono-Regular.ttf to Windows (double-click → Install for all users)'));
+  console.log('    ' + chalk.white('    Cursor/VS Code:') + ' ' + chalk.cyan('"terminal.integrated.fontFamily": "JetBrainsMono NFM"'));
+  console.log('    ' + chalk.white('    Windows Terminal:') + ' ' + chalk.cyan('"font": { "face": "JetBrainsMono NFM", "builtinGlyphs": false }'));
+
+  console.log('\n' + chalk.dim('  Complete the manual steps above, then press Enter to continue with config file installation.'));
   await ask(chalk.yellow('  Press Enter to continue → '));
 
   // ── Detect environment ──────────────────────────────────────────────────
@@ -673,9 +719,53 @@ async function setupTmux(projectRoot, chalk) {
   await fs.ensureDir(path.join(homeDir, '.local', 'bin'));
   await fs.ensureDir(path.join(homeDir, '.tmux', 'plugins'));
 
-  console.log('\n' + chalk.bold('Step 2 — Writing config files'));
+  // ── Step 2: Shell aliases ────────────────────────────────────────────────
+  console.log('\n' + chalk.bold('Step 2 — Shell aliases'));
+  const bashrc = path.join(homeDir, '.bashrc');
+  const resolvedRoot = path.resolve(projectRoot);
+  const tmuxAlias = `alias tmux-ai='tmux new-session -c ${resolvedRoot}'`;
+  const tmuxClaudeAlias = `alias tmux-claude='tmux new-session -c ${resolvedRoot} "claude --dangerously-skip-permissions"'`;
+  let bashrcContent = '';
+  if (await fs.pathExists(bashrc)) bashrcContent = await fs.readFile(bashrc, 'utf8');
+
+  const aliasBlock = `\n# BMAD tmux shortcuts\n${tmuxAlias}\n${tmuxClaudeAlias}\n`;
+  if (!bashrcContent.includes('tmux-claude')) {
+    const addAliases = await ask(chalk.yellow(`  Add 'tmux-ai' and 'tmux-claude' aliases to ~/.bashrc? (Y/n): `));
+    if (!addAliases.toLowerCase().startsWith('n')) {
+      await fs.appendFile(bashrc, aliasBlock, 'utf8');
+      console.log(chalk.green('  ✓ Aliases added to ~/.bashrc'));
+      console.log(chalk.dim('  Run: source ~/.bashrc'));
+    }
+  } else {
+    console.log(chalk.dim('  ○ Aliases already in ~/.bashrc'));
+  }
+
+  // xdg-open symlink → wslview
+  if (!await fs.pathExists(xdgOpenPath)) {
+    try {
+      await fs.ensureSymlink('/usr/bin/wslview', xdgOpenPath);
+      console.log(chalk.green(`  ✓ ${xdgOpenPath} → /usr/bin/wslview`));
+    } catch {
+      console.log(chalk.dim(`  ○ Could not create xdg-open symlink (run manually: ln -sf /usr/bin/wslview ~/.local/bin/xdg-open)`));
+    }
+  } else {
+    console.log(chalk.dim(`  ○ ${xdgOpenPath} already exists`));
+  }
+
+  // ── Step 3: TPM check ────────────────────────────────────────────────────
+  console.log('\n' + chalk.bold('Step 3 — TPM check'));
+  if (await fs.pathExists(tpmPath)) {
+    console.log(chalk.green('  ✓ TPM already installed at ~/.tmux/plugins/tpm'));
+  } else {
+    console.log(chalk.yellow('  ⚠  TPM not found — install it before starting tmux:'));
+    console.log('  ' + chalk.cyan('git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm'));
+    console.log(chalk.dim('  Then inside tmux press Ctrl+B I to install plugins.'));
+  }
+
+  // ── Step 4: Write config files (last) ───────────────────────────────────
+  console.log('\n' + chalk.bold('Step 4 — Writing config files'));
+  console.log(chalk.dim('  Installing tmux.conf, scripts, and support files...\n'));
 
-  // Map: src filename → dest absolute path
   const FILE_MAP = [
     ['tmux.conf',               tmuxConf],
     ['colors.conf',             colorsConf],
@@ -708,78 +798,24 @@ async function setupTmux(projectRoot, chalk) {
     }
 
     await fs.copy(src, dest, { overwrite: true });
-    // Make shell scripts and xclip executable
     if (dest.endsWith('.sh') || dest.endsWith('.py') || dest === xclipPath) {
       try { await fs.chmod(dest, 0o755); } catch {}
     }
     console.log(chalk.green(`  ✓ ${dest}`));
   }
 
-  // Also copy tmux-setup.md as reference doc to the project
+  // xdg-open symlink → wslview
+  // Copy reference doc to the project
   const tmuxSetupSrc = path.join(tmuxSrc, 'tmux-setup.md');
   if (await fs.pathExists(tmuxSetupSrc)) {
-    const refDocDest = path.join(projectRoot, 'docs', 'dev', 'tmux', 'README.md');
+    const refDocDest = path.join(resolvedRoot, 'docs', 'dev', 'tmux', 'README.md');
     await fs.ensureDir(path.dirname(refDocDest));
     await fs.copy(tmuxSetupSrc, refDocDest, { overwrite: true });
     console.log(chalk.green(`  ✓ ${refDocDest} (reference doc)`));
   }
 
-  // xdg-open symlink → wslview
-  if (!await fs.pathExists(xdgOpenPath)) {
-    try {
-      await fs.ensureSymlink('/usr/bin/wslview', xdgOpenPath);
-      console.log(chalk.green(`  ✓ ${xdgOpenPath} → /usr/bin/wslview`));
-    } catch {
-      console.log(chalk.dim(`  ○ Could not create xdg-open symlink (run manually: ln -sf /usr/bin/wslview ~/.local/bin/xdg-open)`));
-    }
-  } else {
-    console.log(chalk.dim(`  ○ ${xdgOpenPath} already exists`));
-  }
-
-  console.log('\n' + chalk.bold('Step 3 — TPM (tmux Plugin Manager)'));
-  if (await fs.pathExists(tpmPath)) {
-    console.log(chalk.dim('  ✓ TPM already installed at ~/.tmux/plugins/tpm'));
-  } else {
-    console.log(chalk.dim('  TPM not found. Run this to install it:'));
-    console.log('  ' + chalk.cyan('git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm'));
-    console.log(chalk.dim('  Then start tmux and press Ctrl+B I to install plugins.'));
-  }
-
-  console.log('\n' + chalk.bold('Step 4 — Nerd Fonts (required for status bar icons)'));
-  console.log(chalk.dim('  Download JetBrainsMono NFM from https://www.nerdfonts.com/'));
-  console.log(chalk.dim('  Install JetBrainsMonoNerdFontMono-Regular.ttf to Windows (double-click → Install for all users)'));
-  console.log(chalk.dim('  Then set your terminal font:'));
-  console.log('  ' + chalk.white('Cursor/VS Code') + ' → ' + chalk.cyan('"terminal.integrated.fontFamily": "JetBrainsMono NFM"'));
-  console.log('  ' + chalk.white('Windows Terminal') + ' → ' + chalk.cyan('"font": { "face": "JetBrainsMono NFM", "builtinGlyphs": false }'));
-
-  console.log('\n' + chalk.bold('Step 5 — fzf (Actions menu)'));
-  console.log(chalk.dim('  Run:'));
-  console.log('  ' + chalk.cyan('mkdir -p ~/.local/bin && curl -Lo /tmp/fzf.tar.gz https://github.com/junegunn/fzf/releases/download/v0.54.3/fzf-0.54.3-linux_amd64.tar.gz && tar -xzf /tmp/fzf.tar.gz -C ~/.local/bin'));
-
-  console.log('\n' + chalk.bold('Step 6 — Shell aliases'));
-  const bashrc = path.join(homeDir, '.bashrc');
-  const squidAlias = `alias squid='tmux new-session -c ${projectRoot}'`;
-  const squidClaudeAlias = `alias squid-claude='tmux new-session -c ${projectRoot} "claude --dangerously-skip-permissions"'`;
-  let bashrcContent = '';
-  if (await fs.pathExists(bashrc)) {
-    bashrcContent = await fs.readFile(bashrc, 'utf8');
-  }
-  const aliasBlock = `\n# BMAD tmux shortcuts\n${squidAlias}\n${squidClaudeAlias}\n`;
-  if (!bashrcContent.includes('squid-claude')) {
-    const addAliases = await ask(chalk.yellow(`  Add 'squid' and 'squid-claude' aliases to ~/.bashrc? (Y/n): `));
-    if (!addAliases.toLowerCase().startsWith('n')) {
-      await fs.appendFile(bashrc, aliasBlock, 'utf8');
-      console.log(chalk.green('  ✓ Aliases added to ~/.bashrc'));
-      console.log(chalk.dim('  Run: source ~/.bashrc'));
-    }
-  } else {
-    console.log(chalk.dim('  ○ Aliases already in ~/.bashrc'));
-  }
-
   console.log('\n' + chalk.bold.green('✓ tmux setup complete!'));
-  console.log(chalk.dim('  Start a session with: ') + chalk.cyan('squid'));
-  console.log(chalk.dim('  Or launch Claude directly: ') + chalk.cyan('squid-claude'));
-  console.log(chalk.dim('  Full docs: ') + chalk.cyan('docs/dev/tmux/README.md\n'));
+  console.log(chalk.dim('  Start tmux and press Ctrl+B I to finish TPM plugin install.\n'));
 
   rl.close();
 }

package/package.json

@@ -1,10 +1,19 @@
 {
   "name": "@devo-bmad-custom/agent-orchestration",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "BMAD Method — AI-native agile workflow system for Claude Code and compatible AI assistants",
-  "keywords": ["bmad", "ai-agents", "claude", "agile", "workflow", "llm"],
+  "keywords": [
+    "bmad",
+    "ai-agents",
+    "claude",
+    "agile",
+    "workflow",
+    "llm"
+  ],
   "license": "MIT",
-  "engines": { "node": ">=20.0.0" },
+  "engines": {
+    "node": ">=20.0.0"
+  },
   "bin": {
     "bmad": "bin/bmad.js",
     "bmad-install": "bin/bmad.js"

package/src/docs/dev/tmux/colors.conf

@@ -1,34 +1,26 @@
-# Catppuccin Frappe color palette — sourced by ~/.tmux.conf
-# These variables are available for use in tmux format strings and shell scripts.
-# The status bar in tmux.conf uses these values hardcoded for compatibility.
-
-# Base
-tm_crust='#232634'
-tm_mantle='#292c3c'
-tm_base='#303446'
-tm_surface0='#414559'
-tm_surface1='#51576d'
-tm_surface2='#626880'
-
-# Text
-tm_text='#c6d0f5'
-tm_subtext1='#b5bfe2'
-tm_subtext0='#a5adce'
-
-# Overlay
-tm_overlay0='#737994'
-tm_overlay1='#838ba7'
-tm_overlay2='#949cbb'
-
-# Status bar pill colors (also hardcoded in tmux.conf)
-tm_navy='#3d6095'
-tm_forest='#4a6e38'
-tm_teal='#316862'
-tm_slate='#306075'
-tm_crimson='#783a3c'
-tm_purple='#5c3c78'
-tm_rust='#784828'
-tm_gold='#685820'
-
-# Pill text
-tm_pill_text='#d8ddf0'
+set -g @thm_rosewater "#f2d5cf"
+set -g @thm_flamingo "#eebebe"
+set -g @thm_pink "#f4b8e4"
+set -g @thm_mauve "#ca9ee6"
+set -g @thm_red "#e78284"
+set -g @thm_maroon "#ea999c"
+set -g @thm_peach "#ef9f76"
+set -g @thm_yellow "#e5c890"
+set -g @thm_green "#a6d189"
+set -g @thm_teal "#81c8be"
+set -g @thm_sky "#99d1db"
+set -g @thm_sapphire "#85c1dc"
+set -g @thm_blue "#8caaee"
+set -g @thm_lavender "#babbf1"
+set -g @thm_text "#c6d0f5"
+set -g @thm_subtext1 "#b5bfe2"
+set -g @thm_subtext0 "#a5adce"
+set -g @thm_overlay2 "#949cbb"
+set -g @thm_overlay1 "#838ba7"
+set -g @thm_overlay0 "#737994"
+set -g @thm_surface2 "#626880"
+set -g @thm_surface1 "#51576d"
+set -g @thm_surface0 "#414559"
+set -g @thm_base "#303446"
+set -g @thm_mantle "#292c3c"
+set -g @thm_crust "#232634"

package/src/docs/dev/tmux/paste_image_wrapper.sh

@@ -45,6 +45,17 @@ if [ -n "$IMAGE_TYPE" ]; then
             || mv "$RAWFILE" "$PNGFILE"
     fi
 
+    # WSLg Wayland bridge sometimes lists image types but writes 0 bytes.
+    # Fall back to PowerShell (Windows clipboard API) when wl-paste produces empty output.
+    if [ ! -s "$PNGFILE" ]; then
+        WINPATH=$(wslpath -w "$PNGFILE" 2>/dev/null)
+        powershell.exe -NoProfile -Command "
+            Add-Type -AssemblyName System.Windows.Forms
+            \$img = [System.Windows.Forms.Clipboard]::GetImage()
+            if (\$img -ne \$null) { \$img.Save('$WINPATH') }
+        " 2>/dev/null
+    fi
+
     [ -s "$PNGFILE" ] || exit 1
     send_path "@$PNGFILE"
     /usr/bin/wl-copy --type image/png < "$PNGFILE" 2>/dev/null || true