bmad-method 4.27.5 → 5.0.0

package/tools/cli.js

@@ -10,7 +10,7 @@ const program = new Command();
 
 program
   .name('bmad-build')
-  .description('BMad-Method build tool for creating web bundles')
+  .description('BMAD-METHOD build tool for creating web bundles')
   .version('4.0.0');
 
 program
@@ -18,8 +18,6 @@ program
   .description('Build web bundles for agents and teams')
   .option('-a, --agents-only', 'Build only agent bundles')
   .option('-t, --teams-only', 'Build only team bundles')
-  .option('-e, --expansions-only', 'Build only expansion pack bundles')
-  .option('--no-expansions', 'Skip building expansion packs')
   .option('--no-clean', 'Skip cleaning output directories')
   .action(async (options) => {
     const builder = new WebBuilder({
@@ -32,23 +30,28 @@ program
         await builder.cleanOutputDirs();
       }
 
-      if (options.expansionsOnly) {
-        console.log('Building expansion pack bundles...');
-        await builder.buildAllExpansionPacks({ clean: false });
-      } else {
-        if (!options.teamsOnly) {
-          console.log('Building agent bundles...');
-          await builder.buildAgents();
-        }
+      if (!options.teamsOnly) {
+        console.log('Building agent bundles...');
+        await builder.buildAgents();
+      }
 
-        if (!options.agentsOnly) {
-          console.log('Building team bundles...');
-          await builder.buildTeams();
-        }
+      if (!options.agentsOnly) {
+        console.log('Building team bundles...');
+        await builder.buildTeams();
+      }
 
-        if (!options.noExpansions) {
-          console.log('Building expansion pack bundles...');
-          await builder.buildAllExpansionPacks({ clean: false });
+      // Generate IDE configuration folders
+      console.log('Generating IDE configuration folders...');
+      const installDir = process.cwd();
+      
+      // Generate configurations for all supported IDEs
+      const ides = ['cursor', 'claude-code', 'windsurf', 'roo'];
+      for (const ide of ides) {
+        try {
+          console.log(`Setting up ${ide} integration...`);
+          await IdeSetup.setup(ide, installDir);
+        } catch (error) {
+          console.warn(`Warning: Failed to setup ${ide}:`, error.message);
         }
       }
 
@@ -59,32 +62,6 @@ program
     }
   });
 
-program
-  .command('build:expansions')
-  .description('Build web bundles for all expansion packs')
-  .option('--expansion <name>', 'Build specific expansion pack only')
-  .option('--no-clean', 'Skip cleaning output directories')
-  .action(async (options) => {
-    const builder = new WebBuilder({
-      rootDir: process.cwd()
-    });
-
-    try {
-      if (options.expansion) {
-        console.log(`Building expansion pack: ${options.expansion}`);
-        await builder.buildExpansionPack(options.expansion, { clean: options.clean });
-      } else {
-        console.log('Building all expansion packs...');
-        await builder.buildAllExpansionPacks({ clean: options.clean });
-      }
-
-      console.log('Expansion pack build completed successfully!');
-    } catch (error) {
-      console.error('Expansion pack build failed:', error.message);
-      process.exit(1);
-    }
-  });
-
 program
   .command('list:agents')
   .description('List all available agents')
@@ -95,16 +72,6 @@ program
     agents.forEach(agent => console.log(`  - ${agent}`));
   });
 
-program
-  .command('list:expansions')
-  .description('List all available expansion packs')
-  .action(async () => {
-    const builder = new WebBuilder({ rootDir: process.cwd() });
-    const expansions = await builder.listExpansionPacks();
-    console.log('Available expansion packs:');
-    expansions.forEach(expansion => console.log(`  - ${expansion}`));
-  });
-
 program
   .command('validate')
   .description('Validate agent and team configurations')
@@ -136,7 +103,7 @@ program
 
 program
   .command('upgrade')
-  .description('Upgrade a BMad-Method V3 project to V4')
+  .description('Upgrade a BMAD-METHOD V3 project to V4')
   .option('-p, --project <path>', 'Path to V3 project (defaults to current directory)')
   .option('--dry-run', 'Show what would be changed without making changes')
   .option('--no-backup', 'Skip creating backup (not recommended)')

package/tools/installer/README.md

@@ -1,8 +1,58 @@
-# BMad Method Installer
+# BMAD Method Installer
+
+This directory contains the BMAD Method installer implementation.
+
+## Structure
+
+```text
+installer/
+├── bin/              # CLI entry points
+│   └── bmad.js      # Main CLI executable
+├── lib/             # Core implementation
+│   ├── installer.js # Main installation logic
+│   ├── updater.js   # Update management
+│   ├── config-loader.js # YAML config parsing
+│   ├── file-manager.js  # File operations
+│   ├── ide-setup.js     # IDE-specific setup
+│   └── prompts.js       # Interactive CLI prompts
+├── config/          # Configuration files
+│   └── install.config.yml # Installation profiles
+├── templates/       # IDE template files
+│   ├── cursor-rules.md     # Cursor template
+│   ├── claude-commands.md  # Claude Code template
+│   └── windsurf-rules.md   # Windsurf template
+└── package.json     # NPM package configuration
+```
+
+## Installation Profiles
+
+- **minimal**: IDE agents only (best for beginners)
+- **core**: IDE + Web agents
+- **teams**: Full team workflows
+- **developer**: Everything including creation tools
 
 ## Usage
 
-```bash
+````bash
 # Interactive installation
 npx bmad-method install
-```
+
+# Direct profile installation
+npx bmad-method install --profile=minimal
+
+# Update existing installation
+npx bmad-method update
+```text
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run tests
+npm test
+
+# Lint code
+npm run lint
+````

package/tools/installer/bin/bmad.js

@@ -1,9 +1,6 @@
 #!/usr/bin/env node
 
 const { program } = require('commander');
-const path = require('path');
-const fs = require('fs').promises;
-const yaml = require('js-yaml');
 
 // Dynamic imports for ES modules
 let chalk, inquirer;
@@ -42,35 +39,29 @@ try {
 
 program
   .version(version)
-  .description('BMad Method installer - Universal AI agent framework for any domain');
+  .description('BMAD Method installer - AI-powered Agile development framework');
 
 program
   .command('install')
-  .description('Install BMad Method agents and tools')
-  .option('-f, --full', 'Install complete BMad Method')
-  .option('-x, --expansion-only', 'Install only expansion packs (no bmad-core)')
-  .option('-d, --directory <path>', 'Installation directory')
-  .option('-i, --ide <ide...>', 'Configure for specific IDE(s) - can specify multiple (cursor, claude-code, windsurf, trae, roo, cline, gemini, github-copilot, other)')
-  .option('-e, --expansion-packs <packs...>', 'Install specific expansion packs (can specify multiple)')
+  .description('Install BMAD Method agents and tools')
+  .option('-f, --full', 'Install complete .bmad-core folder')
+  .option('-a, --agent <agent>', 'Install specific agent with dependencies')
+  .option('-d, --directory <path>', 'Installation directory (default: .bmad-core)')
+  .option('-i, --ide <ide...>', 'Configure for specific IDE(s) - can specify multiple (cursor, claude-code, windsurf, roo)')
   .action(async (options) => {
     try {
       await initializeModules();
-      if (!options.full && !options.expansionOnly) {
+      if (!options.full && !options.agent) {
         // Interactive mode
         const answers = await promptInstallation();
-        if (!answers._alreadyInstalled) {
-          await installer.install(answers);
-        }
+        await installer.install(answers);
       } else {
         // Direct mode
-        let installType = 'full';
-        if (options.expansionOnly) installType = 'expansion-only';
-
         const config = {
-          installType,
-          directory: options.directory || '.',
-          ides: (options.ide || []).filter(ide => ide !== 'other'),
-          expansionPacks: options.expansionPacks || []
+          installType: options.full ? 'full' : 'single-agent',
+          agent: options.agent,
+          directory: options.directory || '.bmad-core',
+          ides: options.ide || []
         };
         await installer.install(config);
       }
@@ -83,7 +74,7 @@ program
 
 program
   .command('update')
-  .description('Update existing BMad installation')
+  .description('Update existing BMAD installation')
   .option('--force', 'Force update, overwriting modified files')
   .option('--dry-run', 'Show what would be updated without making changes')
   .action(async () => {
@@ -97,11 +88,11 @@ program
   });
 
 program
-  .command('list:expansions')
-  .description('List available expansion packs')
+  .command('list')
+  .description('List available agents')
   .action(async () => {
     try {
-      await installer.listExpansionPacks();
+      await installer.listAgents();
     } catch (error) {
       if (!chalk) await initializeModules();
       console.error(chalk.red('Error:'), error.message);
@@ -124,156 +115,56 @@ program
 
 async function promptInstallation() {
   await initializeModules();
-  console.log(chalk.bold.blue(`\nWelcome to BMad Method Installer v${version}\n`));
+  console.log(chalk.bold.blue(`\nWelcome to BMAD Method Installer v${version}\n`));
 
   const answers = {};
 
-  // Ask for installation directory first
+  // Ask for installation directory
   const { directory } = await inquirer.prompt([
     {
       type: 'input',
       name: 'directory',
-      message: 'Enter the full path to your project directory where BMad should be installed:',
-      validate: (input) => {
-        if (!input.trim()) {
-          return 'Please enter a valid project path';
-        }
-        return true;
-      }
+      message: 'Where would you like to install BMAD?',
+      default: '.bmad-core'
     }
   ]);
   answers.directory = directory;
 
-  // Detect existing installations
-  const installDir = path.resolve(directory);
-  const state = await installer.detectInstallationState(installDir);
-  
-  // Check for existing expansion packs
-  const existingExpansionPacks = state.expansionPacks || {};
-  
-  // Get available expansion packs
-  const availableExpansionPacks = await installer.getAvailableExpansionPacks();
-  
-  // Build choices list
-  const choices = [];
-  
-  // Load core config to get short-title
-  const coreConfigPath = path.join(__dirname, '..', '..', '..', 'bmad-core', 'core-config.yaml');
-  const coreConfig = yaml.load(await fs.readFile(coreConfigPath, 'utf8'));
-  const coreShortTitle = coreConfig['short-title'] || 'BMad Agile Core System';
-  
-  // Add BMad core option
-  let bmadOptionText;
-  if (state.type === 'v4_existing') {
-    const currentVersion = state.manifest?.version || 'unknown';
-    const newVersion = coreConfig.version || 'unknown'; // Use version from core-config.yaml
-    const versionInfo = currentVersion === newVersion 
-      ? `(v${currentVersion} - reinstall)`
-      : `(v${currentVersion} → v${newVersion})`;
-    bmadOptionText = `Update ${coreShortTitle} ${versionInfo} .bmad-core`;
-  } else {
-    bmadOptionText = `Install ${coreShortTitle} (v${coreConfig.version || version}) .bmad-core`;
-  }
-  
-  choices.push({
-    name: bmadOptionText,
-    value: 'bmad-core',
-    checked: true
-  });
-  
-  // Add expansion pack options
-  for (const pack of availableExpansionPacks) {
-    const existing = existingExpansionPacks[pack.id];
-    let packOptionText;
-    
-    if (existing) {
-      const currentVersion = existing.manifest?.version || 'unknown';
-      const newVersion = pack.version;
-      const versionInfo = currentVersion === newVersion 
-        ? `(v${currentVersion} - reinstall)`
-        : `(v${currentVersion} → v${newVersion})`;
-      packOptionText = `Update ${pack.description} ${versionInfo} .${pack.id}`;
-    } else {
-      packOptionText = `Install ${pack.description} (v${pack.version}) .${pack.id}`;
-    }
-    
-    choices.push({
-      name: packOptionText,
-      value: pack.id,
-      checked: false
-    });
-  }
-  
-  // Ask what to install
-  const { selectedItems } = await inquirer.prompt([
+  // Ask for installation type
+  const { installType } = await inquirer.prompt([
     {
-      type: 'checkbox',
-      name: 'selectedItems',
-      message: 'Select what to install/update (use space to select, enter to continue):',
-      choices: choices,
-      validate: (selected) => {
-        if (selected.length === 0) {
-          return 'Please select at least one item to install';
+      type: 'list',
+      name: 'installType',
+      message: 'How would you like to install BMAD?',
+      choices: [
+        {
+          name: 'Complete installation (recommended) - All agents and tools',
+          value: 'full'
+        },
+        {
+          name: 'Single agent - Choose one agent to install',
+          value: 'single-agent'
         }
-        return true;
-      }
+      ]
     }
   ]);
-  
-  // Process selections
-  answers.installType = selectedItems.includes('bmad-core') ? 'full' : 'expansion-only';
-  answers.expansionPacks = selectedItems.filter(item => item !== 'bmad-core');
+  answers.installType = installType;
 
-  // Ask sharding questions if installing BMad core
-  if (selectedItems.includes('bmad-core')) {
-    console.log(chalk.cyan('\n📋 Document Organization Settings'));
-    console.log(chalk.dim('Configure how your project documentation should be organized.\n'));
-    
-    // Ask about PRD sharding
-    const { prdSharded } = await inquirer.prompt([
-      {
-        type: 'confirm',
-        name: 'prdSharded',
-        message: 'Will the PRD (Product Requirements Document) be sharded into multiple files?',
-        default: true
-      }
-    ]);
-    answers.prdSharded = prdSharded;
-    
-    // Ask about architecture sharding
-    const { architectureSharded } = await inquirer.prompt([
+  // If single agent, ask which one
+  if (installType === 'single-agent') {
+    const agents = await installer.getAvailableAgents();
+    const { agent } = await inquirer.prompt([
       {
-        type: 'confirm',
-        name: 'architectureSharded',
-        message: 'Will the architecture documentation be sharded into multiple files?',
-        default: true
+        type: 'list',
+        name: 'agent',
+        message: 'Select an agent to install:',
+        choices: agents.map(a => ({
+          name: `${a.id} - ${a.name} (${a.description})`,
+          value: a.id
+        }))
       }
     ]);
-    answers.architectureSharded = architectureSharded;
-    
-    // Show warning if architecture sharding is disabled
-    if (!architectureSharded) {
-      console.log(chalk.yellow.bold('\n⚠️  IMPORTANT: Architecture Sharding Disabled'));
-      console.log(chalk.yellow('With architecture sharding disabled, you should still create the files listed'));
-      console.log(chalk.yellow('in devLoadAlwaysFiles (like coding-standards.md, tech-stack.md, source-tree.md)'));
-      console.log(chalk.yellow('as these are used by the dev agent at runtime.'));
-      console.log(chalk.yellow('\nAlternatively, you can remove these files from the devLoadAlwaysFiles list'));
-      console.log(chalk.yellow('in your core-config.yaml after installation.'));
-      
-      const { acknowledge } = await inquirer.prompt([
-        {
-          type: 'confirm',
-          name: 'acknowledge',
-          message: 'Do you acknowledge this requirement and want to proceed?',
-          default: false
-        }
-      ]);
-      
-      if (!acknowledge) {
-        console.log(chalk.red('Installation cancelled.'));
-        process.exit(0);
-      }
-    }
+    answers.agent = agent;
   }
 
   // Ask for IDE configuration
@@ -281,151 +172,22 @@ async function promptInstallation() {
     {
       type: 'checkbox',
       name: 'ides',
-      message: 'Which IDE(s) are you using? (press Enter to skip IDE setup, or select any to configure):',
+      message: 'Which IDE(s) are you using? (Select all that apply)',
       choices: [
         { name: 'Cursor', value: 'cursor' },
         { name: 'Claude Code', value: 'claude-code' },
         { name: 'Windsurf', value: 'windsurf' },
-        { name: 'Trae', value: 'trae' }, // { name: 'Trae', value: 'trae'}
-        { name: 'Roo Code', value: 'roo' },
-        { name: 'Cline', value: 'cline' },
-        { name: 'Gemini CLI', value: 'gemini' },
-        { name: 'Github Copilot', value: 'github-copilot' }
-      ]
-    }
-  ]);
-
-  // Use selected IDEs directly
-  answers.ides = ides;
-
-  // Configure GitHub Copilot immediately if selected
-  if (ides.includes('github-copilot')) {
-    console.log(chalk.cyan('\n🔧 GitHub Copilot Configuration'));
-    console.log(chalk.dim('BMad works best with specific VS Code settings for optimal agent experience.\n'));
-    
-    const { configChoice } = await inquirer.prompt([
-      {
-        type: 'list',
-        name: 'configChoice',
-        message: chalk.yellow('How would you like to configure GitHub Copilot settings?'),
-        choices: [
-          {
-            name: 'Use recommended defaults (fastest setup)',
-            value: 'defaults'
-          },
-          {
-            name: 'Configure each setting manually (customize to your preferences)',
-            value: 'manual'
-          },
-          {
-            name: 'Skip settings configuration (I\'ll configure manually later)',
-            value: 'skip'
-          }
-        ],
-        default: 'defaults'
+        { name: 'Roo Code', value: 'roo' }
+      ],
+      validate: (answer) => {
+        if (answer.length < 1) {
+          return 'You must choose at least one IDE, or press Ctrl+C to skip IDE setup.';
+        }
+        return true;
       }
-    ]);
-    
-    answers.githubCopilotConfig = { configChoice };
-  }
-
-  // Ask for web bundles installation
-  const { includeWebBundles } = await inquirer.prompt([
-    {
-      type: 'confirm',
-      name: 'includeWebBundles',
-      message: 'Would you like to include pre-built web bundles? (standalone files for ChatGPT, Claude, Gemini)',
-      default: false
     }
   ]);
-
-  if (includeWebBundles) {
-    console.log(chalk.cyan('\n📦 Web bundles are standalone files perfect for web AI platforms.'));
-    console.log(chalk.dim('   You can choose different teams/agents than your IDE installation.\n'));
-
-    const { webBundleType } = await inquirer.prompt([
-      {
-        type: 'list',
-        name: 'webBundleType',
-        message: 'What web bundles would you like to include?',
-        choices: [
-          {
-            name: 'All available bundles (agents, teams, expansion packs)',
-            value: 'all'
-          },
-          {
-            name: 'Specific teams only',
-            value: 'teams'
-          },
-          {
-            name: 'Individual agents only',
-            value: 'agents'
-          },
-          {
-            name: 'Custom selection',
-            value: 'custom'
-          }
-        ]
-      }
-    ]);
-
-    answers.webBundleType = webBundleType;
-
-    // If specific teams, let them choose which teams
-    if (webBundleType === 'teams' || webBundleType === 'custom') {
-      const teams = await installer.getAvailableTeams();
-      const { selectedTeams } = await inquirer.prompt([
-        {
-          type: 'checkbox',
-          name: 'selectedTeams',
-          message: 'Select team bundles to include:',
-          choices: teams.map(t => ({
-            name: `${t.icon || '📋'} ${t.name}: ${t.description}`,
-            value: t.id,
-            checked: webBundleType === 'teams' // Check all if teams-only mode
-          })),
-          validate: (answer) => {
-            if (answer.length < 1) {
-              return 'You must select at least one team.';
-            }
-            return true;
-          }
-        }
-      ]);
-      answers.selectedWebBundleTeams = selectedTeams;
-    }
-
-    // If custom selection, also ask about individual agents
-    if (webBundleType === 'custom') {
-      const { includeIndividualAgents } = await inquirer.prompt([
-        {
-          type: 'confirm',
-          name: 'includeIndividualAgents',
-          message: 'Also include individual agent bundles?',
-          default: true
-        }
-      ]);
-      answers.includeIndividualAgents = includeIndividualAgents;
-    }
-
-    const { webBundlesDirectory } = await inquirer.prompt([
-      {
-        type: 'input',
-        name: 'webBundlesDirectory',
-        message: 'Enter directory for web bundles:',
-        default: `${answers.directory}/web-bundles`,
-        validate: (input) => {
-          if (!input.trim()) {
-            return 'Please enter a valid directory path';
-          }
-          return true;
-        }
-      }
-    ]);
-    answers.webBundlesDirectory = webBundlesDirectory;
-  }
-
-  answers.includeWebBundles = includeWebBundles;
+  answers.ides = ides;
 
   return answers;
 }