bmad-method 6.0.0-alpha.9 → 6.0.2

package/tools/cli/bmad-cli.js

@@ -1,9 +1,75 @@
 const { program } = require('commander');
 const path = require('node:path');
 const fs = require('node:fs');
+const { execSync } = require('node:child_process');
+const semver = require('semver');
+const prompts = require('./lib/prompts');
 
-// Load package.json from root for version info
+// The installer flow uses many sequential @clack/prompts, each adding keypress
+// listeners to stdin. Raise the limit to avoid spurious EventEmitter warnings.
+if (process.stdin?.setMaxListeners) {
+  const currentLimit = process.stdin.getMaxListeners();
+  process.stdin.setMaxListeners(Math.max(currentLimit, 50));
+}
+
+// Check for updates - do this asynchronously so it doesn't block startup
 const packageJson = require('../../package.json');
+const packageName = 'bmad-method';
+checkForUpdate().catch(() => {
+  // Silently ignore errors - version check is best-effort
+});
+
+async function checkForUpdate() {
+  try {
+    // For beta versions, check the beta tag; otherwise check latest
+    const isBeta =
+      packageJson.version.includes('Beta') ||
+      packageJson.version.includes('beta') ||
+      packageJson.version.includes('alpha') ||
+      packageJson.version.includes('rc');
+    const tag = isBeta ? 'beta' : 'latest';
+
+    const result = execSync(`npm view ${packageName}@${tag} version`, {
+      encoding: 'utf8',
+      stdio: 'pipe',
+      timeout: 5000,
+    }).trim();
+
+    if (result && semver.gt(result, packageJson.version)) {
+      const color = await prompts.getColor();
+      const updateMsg = [
+        `You are using version ${packageJson.version} but ${result} is available.`,
+        '',
+        'To update, exit and first run:',
+        `  npm cache clean --force && npx bmad-method@${tag} install`,
+      ].join('\n');
+      await prompts.box(updateMsg, 'Update Available', {
+        rounded: true,
+        formatBorder: color.yellow,
+      });
+    }
+  } catch {
+    // Silently fail - network issues or npm not available
+  }
+}
+
+// Fix for stdin issues when running through npm on Windows
+// Ensures keyboard interaction works properly with CLI prompts
+if (process.stdin.isTTY) {
+  try {
+    process.stdin.resume();
+    process.stdin.setEncoding('utf8');
+
+    // On Windows, explicitly reference the stdin stream to ensure it's properly initialized
+    if (process.platform === 'win32') {
+      process.stdin.on('error', () => {
+        // Ignore stdin errors - they can occur when the terminal is closing
+      });
+    }
+  } catch {
+    // Silently ignore - some environments may not support these operations
+  }
+}
 
 // Load all command modules
 const commandsPath = path.join(__dirname, 'commands');

package/tools/cli/commands/install.js

@@ -1,5 +1,5 @@
-const chalk = require('chalk');
 const path = require('node:path');
+const prompts = require('../lib/prompts');
 const { Installer } = require('../installers/lib/core/installer');
 const { UI } = require('../lib/ui');
 
@@ -9,39 +9,51 @@ const ui = new UI();
 module.exports = {
   command: 'install',
   description: 'Install BMAD Core agents and tools',
-  options: [],
-  action: async () => {
+  options: [
+    ['-d, --debug', 'Enable debug output for manifest generation'],
+    ['--directory <path>', 'Installation directory (default: current directory)'],
+    ['--modules <modules>', 'Comma-separated list of module IDs to install (e.g., "bmm,bmb")'],
+    [
+      '--tools <tools>',
+      'Comma-separated list of tool/IDE IDs to configure (e.g., "claude-code,cursor"). Use "none" to skip tool configuration.',
+    ],
+    ['--custom-content <paths>', 'Comma-separated list of paths to custom modules/agents/workflows'],
+    ['--action <type>', 'Action type for existing installations: install, update, quick-update, or compile-agents'],
+    ['--user-name <name>', 'Name for agents to use (default: system username)'],
+    ['--communication-language <lang>', 'Language for agent communication (default: English)'],
+    ['--document-output-language <lang>', 'Language for document output (default: English)'],
+    ['--output-folder <path>', 'Output folder path relative to project root (default: _bmad-output)'],
+    ['-y, --yes', 'Accept all defaults and skip prompts where possible'],
+  ],
+  action: async (options) => {
     try {
-      const config = await ui.promptInstall();
+      // Set debug flag as environment variable for all components
+      if (options.debug) {
+        process.env.BMAD_DEBUG_MANIFEST = 'true';
+        await prompts.log.info('Debug mode enabled');
+      }
+
+      const config = await ui.promptInstall(options);
 
       // Handle cancel
       if (config.actionType === 'cancel') {
-        console.log(chalk.yellow('Installation cancelled.'));
+        await prompts.log.warn('Installation cancelled.');
         process.exit(0);
-        return;
-      }
-
-      // Handle agent compilation separately
-      if (config.actionType === 'compile') {
-        const result = await installer.compileAgents(config);
-        console.log(chalk.green('\n✨ Agent compilation complete!'));
-        console.log(chalk.cyan(`Rebuilt ${result.agentCount} agents and ${result.taskCount} tasks`));
-        process.exit(0);
-        return;
       }
 
       // Handle quick update separately
       if (config.actionType === 'quick-update') {
         const result = await installer.quickUpdate(config);
-        console.log(chalk.green('\n✨ Quick update complete!'));
-        console.log(chalk.cyan(`Updated ${result.moduleCount} modules with preserved settings`));
+        await prompts.log.success('Quick update complete!');
+        await prompts.log.info(`Updated ${result.moduleCount} modules with preserved settings (${result.modules.join(', ')})`);
         process.exit(0);
-        return;
       }
 
-      // Handle reinstall by setting force flag
-      if (config.actionType === 'reinstall') {
-        config._requestedReinstall = true;
+      // Handle compile agents separately
+      if (config.actionType === 'compile-agents') {
+        const result = await installer.compileAgents(config);
+        await prompts.log.info(`Recompiled ${result.agentCount} agents with customizations applied`);
+        process.exit(0);
       }
 
       // Regular install/update flow
@@ -50,28 +62,24 @@ module.exports = {
       // Check if installation was cancelled
       if (result && result.cancelled) {
         process.exit(0);
-        return;
       }
 
       // Check if installation succeeded
       if (result && result.success) {
-        console.log(chalk.green('\n✨ Installation complete!'));
-        console.log(chalk.cyan('BMAD Core and Selected Modules have been installed to:'), chalk.bold(result.path));
-        console.log(chalk.yellow('\nThank you for helping test the early release version of the new BMad Core and BMad Method!'));
-        console.log(chalk.cyan('Stable Beta coming soon - please read the full readme.md and linked documentation to get started!'));
         process.exit(0);
       }
     } catch (error) {
-      // Check if error has a complete formatted message
-      if (error.fullMessage) {
-        console.error(error.fullMessage);
+      try {
+        if (error.fullMessage) {
+          await prompts.log.error(error.fullMessage);
+        } else {
+          await prompts.log.error(`Installation failed: ${error.message}`);
+        }
         if (error.stack) {
-          console.error('\n' + chalk.dim(error.stack));
+          await prompts.log.message(error.stack);
         }
-      } else {
-        // Generic error handling for all other errors
-        console.error(chalk.red('Installation failed:'), error.message);
-        console.error(chalk.dim(error.stack));
+      } catch {
+        console.error(error.fullMessage || error.message || error);
       }
       process.exit(1);
     }

package/tools/cli/commands/status.js

@@ -1,46 +1,64 @@
-const chalk = require('chalk');
+const path = require('node:path');
+const prompts = require('../lib/prompts');
 const { Installer } = require('../installers/lib/core/installer');
+const { Manifest } = require('../installers/lib/core/manifest');
+const { UI } = require('../lib/ui');
 
 const installer = new Installer();
+const manifest = new Manifest();
+const ui = new UI();
 
 module.exports = {
   command: 'status',
-  description: 'Show installation status',
-  options: [['-d, --directory <path>', 'Installation directory', '.']],
+  description: 'Display BMAD installation status and module versions',
+  options: [],
   action: async (options) => {
     try {
-      const status = await installer.getStatus(options.directory);
+      // Find the bmad directory
+      const projectDir = process.cwd();
+      const { bmadDir } = await installer.findBmadDir(projectDir);
 
-      if (!status.installed) {
-        console.log(chalk.yellow('\n⚠️  No BMAD installation found in:'), options.directory);
-        console.log(chalk.dim('Run "bmad install" to set up BMAD Method'));
+      // Check if bmad directory exists
+      const fs = require('fs-extra');
+      if (!(await fs.pathExists(bmadDir))) {
+        await prompts.log.warn('No BMAD installation found in the current directory.');
+        await prompts.log.message(`Expected location: ${bmadDir}`);
+        await prompts.log.message('Run "bmad install" to set up a new installation.');
         process.exit(0);
+        return;
       }
 
-      console.log(chalk.cyan('\n📊 BMAD Installation Status\n'));
-      console.log(chalk.bold('Location:'), status.path);
-      console.log(chalk.bold('Version:'), status.version);
-      console.log(chalk.bold('Core:'), status.hasCore ? chalk.green('✓ Installed') : chalk.red('✗ Not installed'));
-
-      if (status.modules.length > 0) {
-        console.log(chalk.bold('\nModules:'));
-        for (const mod of status.modules) {
-          console.log(`  ${chalk.green('✓')} ${mod.id} (v${mod.version})`);
-        }
-      } else {
-        console.log(chalk.bold('\nModules:'), chalk.dim('None installed'));
-      }
+      // Read manifest
+      const manifestData = await manifest._readRaw(bmadDir);
 
-      if (status.ides.length > 0) {
-        console.log(chalk.bold('\nConfigured IDEs:'));
-        for (const ide of status.ides) {
-          console.log(`  ${chalk.green('✓')} ${ide}`);
-        }
+      if (!manifestData) {
+        await prompts.log.warn('No BMAD installation manifest found.');
+        await prompts.log.message('Run "bmad install" to set up a new installation.');
+        process.exit(0);
+        return;
       }
 
+      // Get installation info
+      const installation = manifestData.installation || {};
+      const modules = manifestData.modules || [];
+
+      // Check for available updates (only for external modules)
+      const availableUpdates = await manifest.checkForUpdates(bmadDir);
+
+      // Display status
+      await ui.displayStatus({
+        installation,
+        modules,
+        availableUpdates,
+        bmadDir,
+      });
+
       process.exit(0);
     } catch (error) {
-      console.error(chalk.red('Error:'), error.message);
+      await prompts.log.error(`Status check failed: ${error.message}`);
+      if (process.env.BMAD_DEBUG) {
+        await prompts.log.message(error.stack);
+      }
       process.exit(1);
     }
   },

package/tools/cli/commands/uninstall.js

@@ -1,43 +1,166 @@
-const chalk = require('chalk');
 const path = require('node:path');
+const fs = require('fs-extra');
+const prompts = require('../lib/prompts');
 const { Installer } = require('../installers/lib/core/installer');
-const { UI } = require('../lib/ui');
 
 const installer = new Installer();
-const ui = new UI();
 
 module.exports = {
   command: 'uninstall',
-  description: 'Remove BMAD installation',
+  description: 'Remove BMAD installation from the current project',
   options: [
-    ['-d, --directory <path>', 'Installation directory', '.'],
-    ['--force', 'Skip confirmation prompt'],
+    ['-y, --yes', 'Remove all BMAD components without prompting (preserves user artifacts)'],
+    ['--directory <path>', 'Project directory (default: current directory)'],
   ],
   action: async (options) => {
     try {
-      const bmadPath = path.join(options.directory, 'bmad');
-
-      if (!options.force) {
-        const { confirm } = await ui.prompt([
-          {
-            type: 'confirm',
-            name: 'confirm',
-            message: `Are you sure you want to remove BMAD from ${bmadPath}?`,
-            default: false,
-          },
-        ]);
-
-        if (!confirm) {
-          console.log('Uninstall cancelled.');
+      let projectDir;
+
+      if (options.directory) {
+        // Explicit --directory flag takes precedence
+        projectDir = path.resolve(options.directory);
+      } else if (options.yes) {
+        // Non-interactive mode: use current directory
+        projectDir = process.cwd();
+      } else {
+        // Interactive: ask user which directory to uninstall from
+        // select() handles cancellation internally (exits process)
+        const dirChoice = await prompts.select({
+          message: 'Where do you want to uninstall BMAD from?',
+          choices: [
+            { value: 'cwd', name: `Current directory (${process.cwd()})` },
+            { value: 'other', name: 'Another directory...' },
+          ],
+        });
+
+        if (dirChoice === 'other') {
+          // text() handles cancellation internally (exits process)
+          const customDir = await prompts.text({
+            message: 'Enter the project directory path:',
+            placeholder: process.cwd(),
+            validate: (value) => {
+              if (!value || value.trim().length === 0) return 'Directory path is required';
+            },
+          });
+
+          projectDir = path.resolve(customDir.trim());
+        } else {
+          projectDir = process.cwd();
+        }
+      }
+
+      if (!(await fs.pathExists(projectDir))) {
+        await prompts.log.error(`Directory does not exist: ${projectDir}`);
+        process.exit(1);
+      }
+
+      const { bmadDir } = await installer.findBmadDir(projectDir);
+
+      if (!(await fs.pathExists(bmadDir))) {
+        await prompts.log.warn('No BMAD installation found.');
+        process.exit(0);
+      }
+
+      const existingInstall = await installer.getStatus(projectDir);
+      const version = existingInstall.version || 'unknown';
+      const modules = (existingInstall.modules || []).map((m) => m.id || m.name).join(', ');
+      const ides = (existingInstall.ides || []).join(', ');
+
+      const outputFolder = await installer.getOutputFolder(projectDir);
+
+      await prompts.intro('BMAD Uninstall');
+      await prompts.note(`Version: ${version}\nModules: ${modules}\nIDE integrations: ${ides}`, 'Current Installation');
+
+      let removeModules = true;
+      let removeIdeConfigs = true;
+      let removeOutputFolder = false;
+
+      if (!options.yes) {
+        // multiselect() handles cancellation internally (exits process)
+        const selected = await prompts.multiselect({
+          message: 'Select components to remove:',
+          options: [
+            {
+              value: 'modules',
+              label: `BMAD Modules & data (${installer.bmadFolderName}/)`,
+              hint: 'Core installation, agents, workflows, config',
+            },
+            { value: 'ide', label: 'IDE integrations', hint: ides || 'No IDEs configured' },
+            { value: 'output', label: `User artifacts (${outputFolder}/)`, hint: 'WARNING: Contains your work products' },
+          ],
+          initialValues: ['modules', 'ide'],
+          required: true,
+        });
+
+        removeModules = selected.includes('modules');
+        removeIdeConfigs = selected.includes('ide');
+        removeOutputFolder = selected.includes('output');
+
+        const red = (s) => `\u001B[31m${s}\u001B[0m`;
+        await prompts.note(
+          red('💀 This action is IRREVERSIBLE! Removed files cannot be recovered!') +
+            '\n' +
+            red('💀 IDE configurations and modules will need to be reinstalled.') +
+            '\n' +
+            red('💀 User artifacts are preserved unless explicitly selected.'),
+          '!! DESTRUCTIVE ACTION !!',
+        );
+
+        const confirmed = await prompts.confirm({
+          message: 'Proceed with uninstall?',
+          default: false,
+        });
+
+        if (!confirmed) {
+          await prompts.outro('Uninstall cancelled.');
           process.exit(0);
         }
       }
 
-      await installer.uninstall(options.directory);
-      console.log(chalk.green('\n✨ BMAD Method has been uninstalled.'));
+      // Phase 1: IDE integrations
+      if (removeIdeConfigs) {
+        const s = await prompts.spinner();
+        s.start('Removing IDE integrations...');
+        await installer.uninstallIdeConfigs(projectDir, existingInstall, { silent: true });
+        s.stop(`Removed IDE integrations (${ides || 'none'})`);
+      }
+
+      // Phase 2: User artifacts
+      if (removeOutputFolder) {
+        const s = await prompts.spinner();
+        s.start(`Removing user artifacts (${outputFolder}/)...`);
+        await installer.uninstallOutputFolder(projectDir, outputFolder);
+        s.stop('User artifacts removed');
+      }
+
+      // Phase 3: BMAD modules & data (last — other phases may need _bmad/)
+      if (removeModules) {
+        const s = await prompts.spinner();
+        s.start(`Removing BMAD modules & data (${installer.bmadFolderName}/)...`);
+        await installer.uninstallModules(projectDir);
+        s.stop('Modules & data removed');
+      }
+
+      const summary = [];
+      if (removeIdeConfigs) summary.push('IDE integrations cleaned');
+      if (removeModules) summary.push('Modules & data removed');
+      if (removeOutputFolder) summary.push('User artifacts removed');
+      if (!removeOutputFolder) summary.push(`User artifacts preserved in ${outputFolder}/`);
+
+      await prompts.note(summary.join('\n'), 'Summary');
+      await prompts.outro('To reinstall, run: npx bmad-method install');
+
       process.exit(0);
     } catch (error) {
-      console.error(chalk.red('Uninstall failed:'), error.message);
+      try {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        await prompts.log.error(`Uninstall failed: ${errorMessage}`);
+        if (error instanceof Error && error.stack) {
+          await prompts.log.message(error.stack);
+        }
+      } catch {
+        console.error(error instanceof Error ? error.message : error);
+      }
       process.exit(1);
     }
   },

package/tools/cli/external-official-modules.yaml

@@ -0,0 +1,53 @@
+# This file allows these modules under bmad-code-org to also be installed with the bmad method installer, while
+# allowing us to keep the source of these projects in separate repos.
+
+modules:
+  bmad-builder:
+    url: https://github.com/bmad-code-org/bmad-builder
+    module-definition: src/module.yaml
+    code: bmb
+    name: "BMad Builder"
+    description: "Agent, Workflow and Module Builder"
+    defaultSelected: false
+    type: bmad-org
+    npmPackage: bmad-builder
+
+  bmad-creative-intelligence-suite:
+    url: https://github.com/bmad-code-org/bmad-module-creative-intelligence-suite
+    module-definition: src/module.yaml
+    code: cis
+    name: "BMad Creative Intelligence Suite"
+    description: "Creative tools for writing, brainstorming, and more"
+    defaultSelected: false
+    type: bmad-org
+    npmPackage: bmad-creative-intelligence-suite
+
+  bmad-game-dev-studio:
+    url: https://github.com/bmad-code-org/bmad-module-game-dev-studio.git
+    module-definition: src/module.yaml
+    code: gds
+    name: "BMad Game Dev Studio"
+    description: "Game development agents and workflows"
+    defaultSelected: false
+    type: bmad-org
+    npmPackage: bmad-game-dev-studio
+
+  bmad-method-test-architecture-enterprise:
+    url: https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise
+    module-definition: src/module.yaml
+    code: tea
+    name: "Test Architect"
+    description: "Master Test Architect for quality strategy, test automation, and release gates"
+    defaultSelected: false
+    type: bmad-org
+    npmPackage: bmad-method-test-architecture-enterprise
+
+  # whiteport-design-system:
+  #   url: https://github.com/bmad-code-org/bmad-method-wds-expansion
+  #   module-definition: src/module.yaml
+  #   code: wds
+  #   name: "Whiteport UX Design System"
+  #   description: "UX design framework with Figma integration"
+  #   defaultSelected: false
+  #   type: community
+  #   npmPackage: bmad-method-wds-expansion

package/tools/cli/installers/install-messages.yaml

@@ -0,0 +1,39 @@
+# BMAD Installer Messages
+# These messages are displayed during installation
+# Edit this file to change what users see during the install process
+
+# Display at the START of installation (after logo, before prompts)
+startMessage: |
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  🎉 V6 IS HERE! Welcome to BMad Method V6 - Official Stable Release!
+
+  The BMad Method is now a Platform powered by the BMad Method Core and Module Ecosystem!
+    - Select and install modules during setup - customize your experience
+    - New BMad Method for Agile AI-Driven Development (the evolution of V4)
+    - Exciting new modules available during installation, with community modules coming soon
+    - Documentation: docs.bmad-method.com
+
+  🌟 BMad is 100% free and open source.
+    - No gated Discord. No paywalls. No gated content.
+    - We believe in empowering everyone, not just those who can pay.
+    - Knowledge should be shared, not sold.
+
+  🎤 SPEAKING & MEDIA:
+    - Available for conferences, podcasts, and media appearances
+    - Topics: AI-Native Transformation, Spec and Context Engineering, BMad Method
+    - For speaking inquiries or interviews, reach out to BMad on Discord!
+
+  ⭐ HELP US GROW:
+    - Star us on GitHub: https://github.com/bmad-code-org/BMAD-METHOD/
+    - Subscribe on YouTube: https://www.youtube.com/@BMadCode
+    - Free Community and Support: https://discord.gg/gk8jAdXWmj
+    - Donate: https://buymeacoffee.com/bmad
+    - Corporate Sponsorship available
+
+  Latest updates: https://github.com/bmad-code-org/BMAD-METHOD/blob/main/CHANGELOG.md
+
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+# No end message - install summary and next steps are rendered by the installer
+endMessage: ""