bmad-method 6.0.0-alpha.9 → 6.0.1

package/tools/cli/commands/build.js

@@ -1,458 +0,0 @@
-const chalk = require('chalk');
-const path = require('node:path');
-const fs = require('fs-extra');
-const { YamlXmlBuilder } = require('../lib/yaml-xml-builder');
-const { getProjectRoot } = require('../lib/project-root');
-
-const builder = new YamlXmlBuilder();
-
-/**
- * Find .claude directory by searching up from current directory
- */
-async function findClaudeDir(startDir) {
-  let currentDir = startDir;
-  const root = path.parse(currentDir).root;
-
-  while (currentDir !== root) {
-    const claudeDir = path.join(currentDir, '.claude');
-    if (await fs.pathExists(claudeDir)) {
-      return claudeDir;
-    }
-    currentDir = path.dirname(currentDir);
-  }
-
-  return null;
-}
-
-module.exports = {
-  command: 'build [agent]',
-  description: 'Build agent XML files from YAML sources',
-  options: [
-    ['-a, --all', 'Rebuild all agents'],
-    ['-d, --directory <path>', 'Project directory', '.'],
-    ['--force', 'Force rebuild even if up to date'],
-  ],
-  action: async (agentName, options) => {
-    try {
-      let projectDir = path.resolve(options.directory);
-
-      // Auto-detect .claude directory (search up from current dir)
-      const claudeDir = await findClaudeDir(projectDir);
-      if (!claudeDir) {
-        console.log(chalk.yellow('\n⚠️  No .claude directory found'));
-        console.log(chalk.dim('Run this command from your project directory or'));
-        console.log(chalk.dim('use --directory flag to specify location'));
-        console.log(chalk.dim('\nExample: npx bmad-method build pm --directory /path/to/project'));
-        process.exit(1);
-      }
-
-      // Use the directory containing .claude
-      projectDir = path.dirname(claudeDir);
-      console.log(chalk.dim(`Using project: ${projectDir}\n`));
-
-      console.log(chalk.cyan('🔨 Building Agent Files\n'));
-
-      if (options.all) {
-        // Build all agents
-        await buildAllAgents(projectDir, options.force);
-      } else if (agentName) {
-        // Build specific agent
-        await buildAgent(projectDir, agentName, options.force);
-      } else {
-        // No agent specified, check what needs rebuilding
-        await checkBuildStatus(projectDir);
-      }
-
-      process.exit(0);
-    } catch (error) {
-      console.error(chalk.red('\nError:'), error.message);
-      if (process.env.DEBUG) {
-        console.error(error.stack);
-      }
-      process.exit(1);
-    }
-  },
-};
-
-/**
- * Build a specific agent
- */
-async function buildAgent(projectDir, agentName, force = false) {
-  // First check standalone agents in bmad/agents/{agentname}/
-  const standaloneAgentDir = path.join(projectDir, 'bmad', 'agents', agentName);
-  let standaloneYamlPath = path.join(standaloneAgentDir, `${agentName}.agent.yaml`);
-
-  // If exact match doesn't exist, look for any .agent.yaml file in the directory
-  if (!(await fs.pathExists(standaloneYamlPath)) && (await fs.pathExists(standaloneAgentDir))) {
-    const files = await fs.readdir(standaloneAgentDir);
-    const agentFile = files.find((f) => f.endsWith('.agent.yaml'));
-    if (agentFile) {
-      standaloneYamlPath = path.join(standaloneAgentDir, agentFile);
-    }
-  }
-
-  if (await fs.pathExists(standaloneYamlPath)) {
-    const yamlFileName = path.basename(standaloneYamlPath, '.agent.yaml');
-    const outputPath = path.join(standaloneAgentDir, `${yamlFileName}.md`);
-
-    // Check if rebuild needed
-    if (!force && (await fs.pathExists(outputPath))) {
-      const needsRebuild = await checkIfNeedsRebuild(standaloneYamlPath, outputPath, projectDir, agentName);
-      if (!needsRebuild) {
-        console.log(chalk.dim(`  ${agentName}: already up to date`));
-        return;
-      }
-    }
-
-    // Build the standalone agent
-    console.log(chalk.cyan(`  Building standalone agent ${agentName}...`));
-
-    const customizePath = path.join(projectDir, 'bmad', '_cfg', 'agents', `${agentName}.customize.yaml`);
-    const customizeExists = await fs.pathExists(customizePath);
-
-    await builder.buildAgent(standaloneYamlPath, customizeExists ? customizePath : null, outputPath, { includeMetadata: true });
-
-    console.log(chalk.green(`  ✓ ${agentName} built successfully (standalone)`));
-    return;
-  }
-
-  // Find the agent YAML file in .claude/commands/bmad/
-  const bmadCommandsDir = path.join(projectDir, '.claude', 'commands', 'bmad');
-
-  // Search all module directories for the agent
-  const modules = await fs.readdir(bmadCommandsDir);
-  let found = false;
-
-  for (const module of modules) {
-    const agentYamlPath = path.join(bmadCommandsDir, module, 'agents', `${agentName}.agent.yaml`);
-    const outputPath = path.join(bmadCommandsDir, module, 'agents', `${agentName}.md`);
-
-    if (await fs.pathExists(agentYamlPath)) {
-      found = true;
-
-      // Check if rebuild needed
-      if (!force && (await fs.pathExists(outputPath))) {
-        const needsRebuild = await checkIfNeedsRebuild(agentYamlPath, outputPath, projectDir, agentName);
-        if (!needsRebuild) {
-          console.log(chalk.dim(`  ${agentName}: already up to date`));
-          return;
-        }
-      }
-
-      // Build the agent
-      console.log(chalk.cyan(`  Building ${agentName}...`));
-
-      const customizePath = path.join(projectDir, '.claude', '_cfg', 'agents', `${agentName}.customize.yaml`);
-      const customizeExists = await fs.pathExists(customizePath);
-
-      await builder.buildAgent(agentYamlPath, customizeExists ? customizePath : null, outputPath, { includeMetadata: true });
-
-      console.log(chalk.green(`  ✓ ${agentName} built successfully`));
-      return;
-    }
-  }
-
-  if (!found) {
-    console.log(chalk.yellow(`  ⚠️  Agent '${agentName}' not found`));
-    console.log(chalk.dim('     Available agents:'));
-    await listAvailableAgents(projectDir);
-  }
-}
-
-/**
- * Build all agents
- */
-async function buildAllAgents(projectDir, force = false) {
-  let builtCount = 0;
-  let skippedCount = 0;
-
-  // First, build standalone agents in bmad/agents/
-  const standaloneAgentsDir = path.join(projectDir, 'bmad', 'agents');
-  if (await fs.pathExists(standaloneAgentsDir)) {
-    console.log(chalk.cyan('\nBuilding standalone agents...'));
-    const agentDirs = await fs.readdir(standaloneAgentsDir);
-
-    for (const agentDirName of agentDirs) {
-      const agentDir = path.join(standaloneAgentsDir, agentDirName);
-
-      // Skip if not a directory
-      const stat = await fs.stat(agentDir);
-      if (!stat.isDirectory()) {
-        continue;
-      }
-
-      // Find any .agent.yaml file in the directory
-      const files = await fs.readdir(agentDir);
-      const agentFile = files.find((f) => f.endsWith('.agent.yaml'));
-
-      if (!agentFile) {
-        continue;
-      }
-
-      const agentYamlPath = path.join(agentDir, agentFile);
-      const agentName = path.basename(agentFile, '.agent.yaml');
-      const outputPath = path.join(agentDir, `${agentName}.md`);
-
-      // Check if rebuild needed
-      if (!force && (await fs.pathExists(outputPath))) {
-        const needsRebuild = await checkIfNeedsRebuild(agentYamlPath, outputPath, projectDir, agentName);
-        if (!needsRebuild) {
-          console.log(chalk.dim(`  ${agentName}: up to date`));
-          skippedCount++;
-          continue;
-        }
-      }
-
-      console.log(chalk.cyan(`  Building standalone agent ${agentName}...`));
-
-      const customizePath = path.join(projectDir, 'bmad', '_cfg', 'agents', `${agentName}.customize.yaml`);
-      const customizeExists = await fs.pathExists(customizePath);
-
-      await builder.buildAgent(agentYamlPath, customizeExists ? customizePath : null, outputPath, { includeMetadata: true });
-
-      console.log(chalk.green(`  ✓ ${agentName} (standalone)`));
-      builtCount++;
-    }
-  }
-
-  // Then, build module agents in .claude/commands/bmad/
-  const bmadCommandsDir = path.join(projectDir, '.claude', 'commands', 'bmad');
-  if (await fs.pathExists(bmadCommandsDir)) {
-    console.log(chalk.cyan('\nBuilding module agents...'));
-    const modules = await fs.readdir(bmadCommandsDir);
-
-    for (const module of modules) {
-      const agentsDir = path.join(bmadCommandsDir, module, 'agents');
-
-      if (!(await fs.pathExists(agentsDir))) {
-        continue;
-      }
-
-      const files = await fs.readdir(agentsDir);
-
-      for (const file of files) {
-        if (!file.endsWith('.agent.yaml')) {
-          continue;
-        }
-
-        const agentName = file.replace('.agent.yaml', '');
-        const agentYamlPath = path.join(agentsDir, file);
-        const outputPath = path.join(agentsDir, `${agentName}.md`);
-
-        // Check if rebuild needed
-        if (!force && (await fs.pathExists(outputPath))) {
-          const needsRebuild = await checkIfNeedsRebuild(agentYamlPath, outputPath, projectDir, agentName);
-          if (!needsRebuild) {
-            console.log(chalk.dim(`  ${agentName}: up to date`));
-            skippedCount++;
-            continue;
-          }
-        }
-
-        console.log(chalk.cyan(`  Building ${agentName}...`));
-
-        const customizePath = path.join(projectDir, '.claude', '_cfg', 'agents', `${agentName}.customize.yaml`);
-        const customizeExists = await fs.pathExists(customizePath);
-
-        await builder.buildAgent(agentYamlPath, customizeExists ? customizePath : null, outputPath, { includeMetadata: true });
-
-        console.log(chalk.green(`  ✓ ${agentName} (${module})`));
-        builtCount++;
-      }
-    }
-  }
-
-  console.log(chalk.green(`\n✓ Built ${builtCount} agent(s)`));
-  if (skippedCount > 0) {
-    console.log(chalk.dim(`  Skipped ${skippedCount} (already up to date)`));
-  }
-}
-
-/**
- * Check what needs rebuilding
- */
-async function checkBuildStatus(projectDir) {
-  const needsRebuild = [];
-  const upToDate = [];
-
-  // Check standalone agents in bmad/agents/
-  const standaloneAgentsDir = path.join(projectDir, 'bmad', 'agents');
-  if (await fs.pathExists(standaloneAgentsDir)) {
-    const agentDirs = await fs.readdir(standaloneAgentsDir);
-
-    for (const agentDirName of agentDirs) {
-      const agentDir = path.join(standaloneAgentsDir, agentDirName);
-
-      // Skip if not a directory
-      const stat = await fs.stat(agentDir);
-      if (!stat.isDirectory()) {
-        continue;
-      }
-
-      // Find any .agent.yaml file in the directory
-      const files = await fs.readdir(agentDir);
-      const agentFile = files.find((f) => f.endsWith('.agent.yaml'));
-
-      if (!agentFile) {
-        continue;
-      }
-
-      const agentYamlPath = path.join(agentDir, agentFile);
-      const agentName = path.basename(agentFile, '.agent.yaml');
-      const outputPath = path.join(agentDir, `${agentName}.md`);
-
-      if (!(await fs.pathExists(outputPath))) {
-        needsRebuild.push(`${agentName} (standalone)`);
-      } else if (await checkIfNeedsRebuild(agentYamlPath, outputPath, projectDir, agentName)) {
-        needsRebuild.push(`${agentName} (standalone)`);
-      } else {
-        upToDate.push(`${agentName} (standalone)`);
-      }
-    }
-  }
-
-  // Check module agents in .claude/commands/bmad/
-  const bmadCommandsDir = path.join(projectDir, '.claude', 'commands', 'bmad');
-  if (await fs.pathExists(bmadCommandsDir)) {
-    const modules = await fs.readdir(bmadCommandsDir);
-
-    for (const module of modules) {
-      const agentsDir = path.join(bmadCommandsDir, module, 'agents');
-
-      if (!(await fs.pathExists(agentsDir))) {
-        continue;
-      }
-
-      const files = await fs.readdir(agentsDir);
-
-      for (const file of files) {
-        if (!file.endsWith('.agent.yaml')) {
-          continue;
-        }
-
-        const agentName = file.replace('.agent.yaml', '');
-        const agentYamlPath = path.join(agentsDir, file);
-        const outputPath = path.join(agentsDir, `${agentName}.md`);
-
-        if (!(await fs.pathExists(outputPath))) {
-          needsRebuild.push(`${agentName} (${module})`);
-        } else if (await checkIfNeedsRebuild(agentYamlPath, outputPath, projectDir, agentName)) {
-          needsRebuild.push(`${agentName} (${module})`);
-        } else {
-          upToDate.push(`${agentName} (${module})`);
-        }
-      }
-    }
-  }
-
-  if (needsRebuild.length === 0) {
-    console.log(chalk.green('✓ All agents are up to date'));
-  } else {
-    console.log(chalk.yellow(`${needsRebuild.length} agent(s) need rebuilding:`));
-    for (const agent of needsRebuild) {
-      console.log(chalk.dim(`  - ${agent}`));
-    }
-    console.log(chalk.dim('\nRun "bmad build --all" to rebuild all agents'));
-  }
-
-  if (upToDate.length > 0) {
-    console.log(chalk.dim(`\n${upToDate.length} agent(s) up to date`));
-  }
-}
-
-/**
- * Check if an agent needs rebuilding by comparing hashes
- */
-async function checkIfNeedsRebuild(yamlPath, outputPath, projectDir, agentName) {
-  // Read the output file to check its metadata
-  const outputContent = await fs.readFile(outputPath, 'utf8');
-
-  // Extract hash from BUILD-META comment
-  const metaMatch = outputContent.match(/source:.*\(hash: ([a-f0-9]+)\)/);
-  if (!metaMatch) {
-    // No metadata, needs rebuild
-    return true;
-  }
-
-  const storedHash = metaMatch[1];
-
-  // Calculate current hash
-  const currentHash = await builder.calculateFileHash(yamlPath);
-
-  if (storedHash !== currentHash) {
-    return true;
-  }
-
-  // Check customize file if it exists
-  const customizePath = path.join(projectDir, '.claude', '_cfg', 'agents', `${agentName}.customize.yaml`);
-  if (await fs.pathExists(customizePath)) {
-    const customizeMetaMatch = outputContent.match(/customize:.*\(hash: ([a-f0-9]+)\)/);
-    if (!customizeMetaMatch) {
-      return true;
-    }
-
-    const storedCustomizeHash = customizeMetaMatch[1];
-    const currentCustomizeHash = await builder.calculateFileHash(customizePath);
-
-    if (storedCustomizeHash !== currentCustomizeHash) {
-      return true;
-    }
-  }
-
-  return false;
-}
-
-/**
- * List available agents
- */
-async function listAvailableAgents(projectDir) {
-  // List standalone agents first
-  const standaloneAgentsDir = path.join(projectDir, 'bmad', 'agents');
-  if (await fs.pathExists(standaloneAgentsDir)) {
-    console.log(chalk.dim('     Standalone agents:'));
-    const agentDirs = await fs.readdir(standaloneAgentsDir);
-
-    for (const agentDirName of agentDirs) {
-      const agentDir = path.join(standaloneAgentsDir, agentDirName);
-
-      // Skip if not a directory
-      const stat = await fs.stat(agentDir);
-      if (!stat.isDirectory()) {
-        continue;
-      }
-
-      // Find any .agent.yaml file in the directory
-      const files = await fs.readdir(agentDir);
-      const agentFile = files.find((f) => f.endsWith('.agent.yaml'));
-
-      if (agentFile) {
-        const agentName = path.basename(agentFile, '.agent.yaml');
-        console.log(chalk.dim(`       - ${agentName} (in ${agentDirName}/)`));
-      }
-    }
-  }
-
-  // List module agents
-  const bmadCommandsDir = path.join(projectDir, '.claude', 'commands', 'bmad');
-  if (await fs.pathExists(bmadCommandsDir)) {
-    console.log(chalk.dim('     Module agents:'));
-    const modules = await fs.readdir(bmadCommandsDir);
-
-    for (const module of modules) {
-      const agentsDir = path.join(bmadCommandsDir, module, 'agents');
-
-      if (!(await fs.pathExists(agentsDir))) {
-        continue;
-      }
-
-      const files = await fs.readdir(agentsDir);
-
-      for (const file of files) {
-        if (file.endsWith('.agent.yaml')) {
-          const agentName = file.replace('.agent.yaml', '');
-          console.log(chalk.dim(`       - ${agentName} (${module})`));
-        }
-      }
-    }
-  }
-}

package/tools/cli/commands/list.js

@@ -1,28 +0,0 @@
-const chalk = require('chalk');
-const { Installer } = require('../installers/lib/core/installer');
-
-const installer = new Installer();
-
-module.exports = {
-  command: 'list',
-  description: 'List available modules',
-  options: [],
-  action: async () => {
-    try {
-      const modules = await installer.getAvailableModules();
-      console.log(chalk.cyan('\n📦 Available BMAD Modules:\n'));
-
-      for (const module of modules) {
-        console.log(chalk.bold(`  ${module.id}`));
-        console.log(chalk.dim(`    ${module.description}`));
-        console.log(chalk.dim(`    Version: ${module.version}`));
-        console.log();
-      }
-
-      process.exit(0);
-    } catch (error) {
-      console.error(chalk.red('Error:'), error.message);
-      process.exit(1);
-    }
-  },
-};

package/tools/cli/commands/update.js

@@ -1,28 +0,0 @@
-const chalk = require('chalk');
-const { Installer } = require('../installers/lib/core/installer');
-
-const installer = new Installer();
-
-module.exports = {
-  command: 'update',
-  description: 'Update existing BMAD installation',
-  options: [
-    ['-d, --directory <path>', 'Installation directory', '.'],
-    ['--force', 'Force update, overwriting modified files'],
-    ['--dry-run', 'Show what would be updated without making changes'],
-  ],
-  action: async (options) => {
-    try {
-      await installer.update({
-        directory: options.directory,
-        force: options.force,
-        dryRun: options.dryRun,
-      });
-      console.log(chalk.green('\n✨ Update complete!'));
-      process.exit(0);
-    } catch (error) {
-      console.error(chalk.red('Update failed:'), error.message);
-      process.exit(1);
-    }
-  },
-};

package/tools/cli/installers/lib/ide/auggie.js

@@ -1,179 +0,0 @@
-const path = require('node:path');
-const { BaseIdeSetup } = require('./_base-ide');
-const chalk = require('chalk');
-const { AgentCommandGenerator } = require('./shared/agent-command-generator');
-
-/**
- * Auggie CLI setup handler
- * Installs to project directory (.augment/commands)
- */
-class AuggieSetup extends BaseIdeSetup {
-  constructor() {
-    super('auggie', 'Auggie CLI');
-    this.detectionPaths = ['.augment'];
-  }
-
-  /**
-   * Setup Auggie CLI configuration
-   * @param {string} projectDir - Project directory
-   * @param {string} bmadDir - BMAD installation directory
-   * @param {Object} options - Setup options
-   */
-  async setup(projectDir, bmadDir, options = {}) {
-    console.log(chalk.cyan(`Setting up ${this.name}...`));
-
-    // Always use project directory
-    const location = path.join(projectDir, '.augment', 'commands');
-
-    // Clean up old BMAD installation first
-    await this.cleanup(projectDir);
-
-    // Generate agent launchers
-    const agentGen = new AgentCommandGenerator(this.bmadFolderName);
-    const { artifacts: agentArtifacts } = await agentGen.collectAgentArtifacts(bmadDir, options.selectedModules || []);
-
-    // Get tasks, tools, and workflows (standalone only)
-    const tasks = await this.getTasks(bmadDir, true);
-    const tools = await this.getTools(bmadDir, true);
-    const workflows = await this.getWorkflows(bmadDir, true);
-
-    const bmadCommandsDir = path.join(location, 'bmad');
-    const agentsDir = path.join(bmadCommandsDir, 'agents');
-    const tasksDir = path.join(bmadCommandsDir, 'tasks');
-    const toolsDir = path.join(bmadCommandsDir, 'tools');
-    const workflowsDir = path.join(bmadCommandsDir, 'workflows');
-
-    await this.ensureDir(agentsDir);
-    await this.ensureDir(tasksDir);
-    await this.ensureDir(toolsDir);
-    await this.ensureDir(workflowsDir);
-
-    // Install agent launchers
-    for (const artifact of agentArtifacts) {
-      const targetPath = path.join(agentsDir, `${artifact.module}-${artifact.name}.md`);
-      await this.writeFile(targetPath, artifact.content);
-    }
-
-    // Install tasks
-    for (const task of tasks) {
-      const content = await this.readFile(task.path);
-      const commandContent = this.createTaskCommand(task, content);
-
-      const targetPath = path.join(tasksDir, `${task.module}-${task.name}.md`);
-      await this.writeFile(targetPath, commandContent);
-    }
-
-    // Install tools
-    for (const tool of tools) {
-      const content = await this.readFile(tool.path);
-      const commandContent = this.createToolCommand(tool, content);
-
-      const targetPath = path.join(toolsDir, `${tool.module}-${tool.name}.md`);
-      await this.writeFile(targetPath, commandContent);
-    }
-
-    // Install workflows
-    for (const workflow of workflows) {
-      const content = await this.readFile(workflow.path);
-      const commandContent = this.createWorkflowCommand(workflow, content);
-
-      const targetPath = path.join(workflowsDir, `${workflow.module}-${workflow.name}.md`);
-      await this.writeFile(targetPath, commandContent);
-    }
-
-    const totalInstalled = agentArtifacts.length + tasks.length + tools.length + workflows.length;
-
-    console.log(chalk.green(`✓ ${this.name} configured:`));
-    console.log(chalk.dim(`  - ${agentArtifacts.length} agents installed`));
-    console.log(chalk.dim(`  - ${tasks.length} tasks installed`));
-    console.log(chalk.dim(`  - ${tools.length} tools installed`));
-    console.log(chalk.dim(`  - ${workflows.length} workflows installed`));
-    console.log(chalk.dim(`  - Location: ${path.relative(projectDir, location)}`));
-    console.log(chalk.yellow(`\n  💡 Tip: Add 'model: gpt-4o' to command frontmatter to specify AI model`));
-
-    return {
-      success: true,
-      agents: agentArtifacts.length,
-      tasks: tasks.length,
-      tools: tools.length,
-      workflows: workflows.length,
-    };
-  }
-
-  /**
-   * Create task command content
-   */
-  createTaskCommand(task, content) {
-    const nameMatch = content.match(/name="([^"]+)"/);
-    const taskName = nameMatch ? nameMatch[1] : this.formatTitle(task.name);
-
-    return `---
-description: "Execute the ${taskName} task"
----
-
-# ${taskName} Task
-
-${content}
-
-## Module
-BMAD ${task.module.toUpperCase()} module
-`;
-  }
-
-  /**
-   * Create tool command content
-   */
-  createToolCommand(tool, content) {
-    const nameMatch = content.match(/name="([^"]+)"/);
-    const toolName = nameMatch ? nameMatch[1] : this.formatTitle(tool.name);
-
-    return `---
-description: "Use the ${toolName} tool"
----
-
-# ${toolName} Tool
-
-${content}
-
-## Module
-BMAD ${tool.module.toUpperCase()} module
-`;
-  }
-
-  /**
-   * Create workflow command content
-   */
-  createWorkflowCommand(workflow, content) {
-    const description = workflow.description || `Execute the ${workflow.name} workflow`;
-
-    return `---
-description: "${description}"
----
-
-# ${workflow.name} Workflow
-
-${content}
-
-## Module
-BMAD ${workflow.module.toUpperCase()} module
-`;
-  }
-
-  /**
-   * Cleanup Auggie configuration
-   */
-  async cleanup(projectDir) {
-    const fs = require('fs-extra');
-
-    // Only clean up project directory
-    const location = path.join(projectDir, '.augment', 'commands');
-    const bmadDir = path.join(location, 'bmad');
-
-    if (await fs.pathExists(bmadDir)) {
-      await fs.remove(bmadDir);
-      console.log(chalk.dim(`  Removed old BMAD commands`));
-    }
-  }
-}
-
-module.exports = { AuggieSetup };