bmad-method 4.2.0 → 4.4.1

package/tools/installer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bmad-method",
-  "version": "4.0.0",
+  "version": "4.4.1",
   "description": "BMAD Method installer - AI-powered Agile development framework",
   "main": "lib/installer.js",
   "bin": {
@@ -22,15 +22,15 @@
   "author": "BMAD Team",
   "license": "MIT",
   "dependencies": {
-    "chalk": "^4.1.2",
-    "commander": "^9.4.1",
-    "fs-extra": "^11.1.0",
-    "inquirer": "^8.2.5",
+    "chalk": "^5.4.1",
+    "commander": "^14.0.0",
+    "fs-extra": "^11.3.0",
+    "inquirer": "^12.6.3",
     "js-yaml": "^4.1.0",
-    "ora": "^5.4.1"
+    "ora": "^8.2.0"
   },
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=20.0.0"
   },
   "repository": {
     "type": "git",
@@ -40,4 +40,4 @@
     "url": "https://github.com/bmad-team/bmad-method/issues"
   },
   "homepage": "https://github.com/bmad-team/bmad-method#readme"
-}
+}

package/tools/lib/dependency-resolver.js

@@ -5,7 +5,7 @@ const yaml = require('js-yaml');
 class DependencyResolver {
   constructor(rootDir) {
     this.rootDir = rootDir;
-    this.bmadCore = path.join(rootDir, '.bmad-core');
+    this.bmadCore = path.join(rootDir, 'bmad-core');
     this.cache = new Map();
   }
 
@@ -14,7 +14,7 @@ class DependencyResolver {
     const agentContent = await fs.readFile(agentPath, 'utf8');
     
     // Extract YAML from markdown content
-    const yamlMatch = agentContent.match(/```yml\n([\s\S]*?)\n```/);
+    const yamlMatch = agentContent.match(/```ya?ml\n([\s\S]*?)\n```/);
     if (!yamlMatch) {
       throw new Error(`No YAML configuration found in agent ${agentId}`);
     }

package/tools/semantic-release-sync-installer.js

@@ -0,0 +1,31 @@
+/**
+ * Semantic-release plugin to sync installer package.json version
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+function prepare(pluginConfig, context) {
+  const { nextRelease, logger } = context;
+  
+  // Path to installer package.json
+  const installerPackagePath = path.join(process.cwd(), 'tools', 'installer', 'package.json');
+  
+  if (!fs.existsSync(installerPackagePath)) {
+    logger.log('Installer package.json not found, skipping sync');
+    return;
+  }
+  
+  // Read installer package.json
+  const installerPackage = JSON.parse(fs.readFileSync(installerPackagePath, 'utf8'));
+  
+  // Update version
+  installerPackage.version = nextRelease.version;
+  
+  // Write back
+  fs.writeFileSync(installerPackagePath, JSON.stringify(installerPackage, null, 2) + '\n');
+  
+  logger.log(`Synced installer package.json to version ${nextRelease.version}`);
+}
+
+module.exports = { prepare };

package/tools/sync-installer-version.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+
+/**
+ * Sync installer package.json version with main package.json
+ * Used by semantic-release to keep versions in sync
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+function syncInstallerVersion() {
+  // Read main package.json
+  const mainPackagePath = path.join(__dirname, '..', 'package.json');
+  const mainPackage = JSON.parse(fs.readFileSync(mainPackagePath, 'utf8'));
+  
+  // Read installer package.json
+  const installerPackagePath = path.join(__dirname, 'installer', 'package.json');
+  const installerPackage = JSON.parse(fs.readFileSync(installerPackagePath, 'utf8'));
+  
+  // Update installer version to match main version
+  installerPackage.version = mainPackage.version;
+  
+  // Write back installer package.json
+  fs.writeFileSync(installerPackagePath, JSON.stringify(installerPackage, null, 2) + '\n');
+  
+  console.log(`Synced installer version to ${mainPackage.version}`);
+}
+
+// Run if called directly
+if (require.main === module) {
+  syncInstallerVersion();
+}
+
+module.exports = { syncInstallerVersion };

package/tools/upgraders/v3-to-v4-upgrader.js

@@ -1,11 +1,16 @@
 const fs = require("fs").promises;
 const path = require("path");
-const chalk = require("chalk");
-const ora = require("ora");
-const glob = require("glob");
-const inquirer = require("inquirer");
-const { promisify } = require("util");
-const globAsync = promisify(glob);
+const { glob } = require("glob");
+
+// Dynamic imports for ES modules
+let chalk, ora, inquirer;
+
+// Initialize ES modules
+async function initializeModules() {
+  chalk = (await import("chalk")).default;
+  ora = (await import("ora")).default;
+  inquirer = (await import("inquirer")).default;
+}
 
 class V3ToV4Upgrader {
   constructor() {
@@ -14,6 +19,8 @@ class V3ToV4Upgrader {
 
   async upgrade(options = {}) {
     try {
+      // Initialize ES modules
+      await initializeModules();
       // Keep readline open throughout the process
       process.stdin.resume();
 
@@ -233,17 +240,17 @@ class V3ToV4Upgrader {
     }
 
     // Find epic files
-    const epicFiles = await globAsync("epic*.md", { cwd: docsPath });
+    const epicFiles = await glob("epic*.md", { cwd: docsPath });
 
     // Find story files
     const storiesPath = path.join(docsPath, "stories");
     let storyFiles = [];
     if (await this.pathExists(storiesPath)) {
-      storyFiles = await globAsync("*.md", { cwd: storiesPath });
+      storyFiles = await glob("*.md", { cwd: storiesPath });
     }
 
     // Count custom files in bmad-agent
-    const bmadAgentFiles = await globAsync("**/*.md", {
+    const bmadAgentFiles = await glob("**/*.md", {
       cwd: bmadAgentPath,
       ignore: ["node_modules/**"],
     });
@@ -738,13 +745,11 @@ class V3ToV4Upgrader {
 
   async createInstallManifest(projectPath) {
     const fileManager = require("../installer/lib/file-manager");
-    const glob = require("glob");
-    const { promisify } = require("util");
-    const globAsync = promisify(glob);
+    const { glob } = require("glob");
 
     // Get all files in .bmad-core for the manifest
     const bmadCorePath = path.join(projectPath, ".bmad-core");
-    const files = await globAsync("**/*", {
+    const files = await glob("**/*", {
       cwd: bmadCorePath,
       nodir: true,
       ignore: ["**/.git/**", "**/node_modules/**"],

package/tools/version-bump.js

@@ -2,7 +2,17 @@
 
 const fs = require('fs');
 const { execSync } = require('child_process');
-const chalk = require('chalk');
+const path = require('path');
+
+// Dynamic import for ES module
+let chalk;
+
+// Initialize ES modules
+async function initializeModules() {
+  if (!chalk) {
+    chalk = (await import('chalk')).default;
+  }
+}
 
 /**
  * Simple version bumping script for BMAD-METHOD
@@ -14,38 +24,32 @@ function getCurrentVersion() {
   return packageJson.version;
 }
 
-function bumpVersion(type = 'patch') {
+async function bumpVersion(type = 'patch') {
+  await initializeModules();
+  
   const validTypes = ['patch', 'minor', 'major'];
   if (!validTypes.includes(type)) {
     console.error(chalk.red(`Invalid version type: ${type}. Use: ${validTypes.join(', ')}`));
     process.exit(1);
   }
 
-  console.log(chalk.blue(`🔄 Bumping ${type} version...`));
+  console.log(chalk.yellow('⚠️  Manual version bumping is disabled.'));
+  console.log(chalk.blue('🤖 This project uses semantic-release for automated versioning.'));
+  console.log('');
+  console.log(chalk.bold('To create a new release, use conventional commits:'));
+  console.log(chalk.cyan('  feat: new feature (minor version bump)'));
+  console.log(chalk.cyan('  fix: bug fix (patch version bump)'));
+  console.log(chalk.cyan('  feat!: breaking change (major version bump)'));
+  console.log('');
+  console.log(chalk.dim('Example: git commit -m "feat: add new installer features"'));
+  console.log(chalk.dim('Then push to main branch to trigger automatic release.'));
   
-  // Use npm version to bump and create git tag
-  try {
-    const newVersion = execSync(`npm version ${type} --no-git-tag-version`, { encoding: 'utf8' }).trim();
-    console.log(chalk.green(`✅ Version bumped to ${newVersion}`));
-    
-    // Stage the package.json change
-    execSync('git add package.json');
-    
-    // Create commit and tag
-    execSync(`git commit -m "chore: bump version to ${newVersion}"`);
-    execSync(`git tag -a ${newVersion} -m "Release ${newVersion}"`);
-    
-    console.log(chalk.green(`✅ Created git tag: ${newVersion}`));
-    console.log(chalk.yellow(`💡 Run 'git push && git push --tags' to publish`));
-    
-    return newVersion;
-  } catch (error) {
-    console.error(chalk.red('❌ Version bump failed:'), error.message);
-    process.exit(1);
-  }
+  return null;
 }
 
-function main() {
+async function main() {
+  await initializeModules();
+  
   const type = process.argv[2] || 'patch';
   const currentVersion = getCurrentVersion();
   
@@ -59,14 +63,17 @@ function main() {
     process.exit(1);
   }
   
-  const newVersion = bumpVersion(type);
+  const newVersion = await bumpVersion(type);
   
   console.log(chalk.green(`\n🎉 Version bump complete!`));
   console.log(chalk.blue(`📦 ${currentVersion} → ${newVersion}`));
 }
 
 if (require.main === module) {
-  main();
+  main().catch(error => {
+    console.error('Error:', error);
+    process.exit(1);
+  });
 }
 
 module.exports = { bumpVersion, getCurrentVersion };

package/tools/yaml-format.js

@@ -4,14 +4,24 @@ const fs = require('fs');
 const path = require('path');
 const yaml = require('js-yaml');
 const { execSync } = require('child_process');
-const chalk = require('chalk');
+
+// Dynamic import for ES module
+let chalk;
+
+// Initialize ES modules
+async function initializeModules() {
+  if (!chalk) {
+    chalk = (await import('chalk')).default;
+  }
+}
 
 /**
  * YAML Formatter and Linter for BMAD-METHOD
  * Formats and validates YAML files and YAML embedded in Markdown
  */
 
-function formatYamlContent(content, filename) {
+async function formatYamlContent(content, filename) {
+  await initializeModules();
   try {
     // First try to fix common YAML issues
     let fixedContent = content
@@ -62,7 +72,8 @@ function formatYamlContent(content, filename) {
   }
 }
 
-function processMarkdownFile(filePath) {
+async function processMarkdownFile(filePath) {
+  await initializeModules();
   const content = fs.readFileSync(filePath, 'utf8');
   let modified = false;
   let newContent = content;
@@ -77,22 +88,34 @@ function processMarkdownFile(filePath) {
 
   // Find YAML code blocks
   const yamlBlockRegex = /```ya?ml\n([\s\S]*?)\n```/g;
+  let match;
+  const replacements = [];
   
-  newContent = newContent.replace(yamlBlockRegex, (match, yamlContent) => {
-    const formatted = formatYamlContent(yamlContent, filePath);
-    if (formatted === null) {
-      return match; // Keep original if parsing failed
-    }
-    
-    // Remove trailing newline that js-yaml adds
-    const trimmedFormatted = formatted.replace(/\n$/, '');
-    
-    if (trimmedFormatted !== yamlContent) {
-      modified = true;
+  while ((match = yamlBlockRegex.exec(newContent)) !== null) {
+    const [fullMatch, yamlContent] = match;
+    const formatted = await formatYamlContent(yamlContent, filePath);
+    if (formatted !== null) {
+      // Remove trailing newline that js-yaml adds
+      const trimmedFormatted = formatted.replace(/\n$/, '');
+      
+      if (trimmedFormatted !== yamlContent) {
+        modified = true;
+        console.log(chalk.green(`✓ Formatted YAML in ${filePath}`));
+      }
+      
+      replacements.push({
+        start: match.index,
+        end: match.index + fullMatch.length,
+        replacement: `\`\`\`yaml\n${trimmedFormatted}\n\`\`\``
+      });
     }
-    
-    return `\`\`\`yml\n${trimmedFormatted}\n\`\`\``;
-  });
+  }
+  
+  // Apply replacements in reverse order to maintain indices
+  for (let i = replacements.length - 1; i >= 0; i--) {
+    const { start, end, replacement } = replacements[i];
+    newContent = newContent.slice(0, start) + replacement + newContent.slice(end);
+  }
 
   if (modified) {
     fs.writeFileSync(filePath, newContent);
@@ -101,9 +124,10 @@ function processMarkdownFile(filePath) {
   return false;
 }
 
-function processYamlFile(filePath) {
+async function processYamlFile(filePath) {
+  await initializeModules();
   const content = fs.readFileSync(filePath, 'utf8');
-  const formatted = formatYamlContent(content, filePath);
+  const formatted = await formatYamlContent(content, filePath);
   
   if (formatted === null) {
     return false; // Syntax error
@@ -116,7 +140,8 @@ function processYamlFile(filePath) {
   return false;
 }
 
-function lintYamlFile(filePath) {
+async function lintYamlFile(filePath) {
+  await initializeModules();
   try {
     // Use yaml-lint for additional validation
     execSync(`npx yaml-lint "${filePath}"`, { stdio: 'pipe' });
@@ -128,7 +153,8 @@ function lintYamlFile(filePath) {
   }
 }
 
-function main() {
+async function main() {
+  await initializeModules();
   const args = process.argv.slice(2);
   const glob = require('glob');
   
@@ -170,13 +196,13 @@ function main() {
     try {
       let changed = false;
       if (ext === '.md') {
-        changed = processMarkdownFile(filePath);
+        changed = await processMarkdownFile(filePath);
       } else if (ext === '.yml' || ext === '.yaml' || basename.includes('roomodes') || basename.includes('.yml') || basename.includes('.yaml')) {
         // Handle YAML files and special cases like .roomodes
-        changed = processYamlFile(filePath);
+        changed = await processYamlFile(filePath);
         
         // Also run linting
-        const lintPassed = lintYamlFile(filePath);
+        const lintPassed = await lintYamlFile(filePath);
         if (!lintPassed) hasErrors = true;
       } else {
         // Skip silently for unsupported files
@@ -205,7 +231,10 @@ function main() {
 }
 
 if (require.main === module) {
-  main();
+  main().catch(error => {
+    console.error('Error:', error);
+    process.exit(1);
+  });
 }
 
 module.exports = { formatYamlContent, processMarkdownFile, processYamlFile };

package/.bmad-core/agent-teams/team-fullstack.yml

@@ -1,26 +0,0 @@
-bundle:
-  name: Team Fullstack
-  icon: 🚀
-  description: >-
-    Comprehensive full-stack development team capable of handling both greenfield 
-    application development and brownfield enhancement projects. This team combines 
-    strategic planning, user experience design, and holistic system architecture 
-    to deliver complete solutions from concept to deployment. Specializes in 
-    full-stack applications, SaaS platforms, enterprise apps, feature additions, 
-    refactoring, and system modernization.
-
-agents:
-  - bmad-orchestrator
-  - analyst
-  - pm
-  - ux-expert
-  - architect
-  - po
-
-workflows:
-  - brownfield-fullstack
-  - brownfield-service
-  - brownfield-ui
-  - greenfield-fullstack
-  - greenfield-service
-  - greenfield-ui

package/.bmad-core/agents/bmad-orchestrator.md

@@ -1,81 +0,0 @@
-# bmad
-
-CRITICAL: Read the full YML to understand your operating params, start activation to alter your state of being, follow startup instructions, stay in this being until told to exit this mode:
-
-```yml
-agent:
-  name: BMad Orchestrator
-  id: bmad-orchestrator
-  title: BMAD Master Orchestrator
-  icon: 🎭
-  whenToUse: "Use for workflow coordination, multi-agent tasks, role switching guidance, and when unsure which specialist to consult"
-
-persona:
-  role: Master Orchestrator & BMAD Method Expert
-  style: Knowledgeable, guiding, adaptable, efficient, encouraging, technically brilliant yet approachable. Helps customize and use BMAD Method while orchestrating agents
-  identity: Unified interface to all BMAD-METHOD capabilities, dynamically transforms into any specialized agent
-  focus: Orchestrating the right agent/capability for each need, loading resources only when needed
-
-  core_principles:
-    - Become any agent on demand, loading files only when needed
-    - Never pre-load resources - discover and load at runtime
-    - Assess needs and recommend best approach/agent/workflow
-    - Track current state and guide to next logical steps
-    - When embodied, specialized persona's principles take precedence
-    - Be explicit about active persona and current task
-    - Always use numbered lists for choices
-    - Process (*) commands immediately
-
-startup:
-  - Announce: "Hey! I'm BMad, your BMAD-METHOD orchestrator. I can become any specialized agent, suggest workflows, explain setup, or help with any BMAD task. Type *help for options."
-  - Assess user goal, suggest agent transformation if match, offer numbered options if generic
-  - Load resources only when needed
-
-commands:
-  - "*help" - Show commands/workflows/agents
-  - "*chat-mode" - Conversational mode with advanced-elicitation
-  - "*kb-mode" - Load knowledge base for full BMAD help
-  - "*status" - Show current context/agent/progress
-  - "*agent {name}" - Transform into agent (list if unspecified)
-  - "*exit" - Return to BMad or exit (confirm if exiting BMad)
-  - "*task {name}" - Run task (list if unspecified)
-  - "*workflow {type}" - Start/list workflows
-  - "*checklist {name}" - Execute checklist (list if unspecified)
-  - "*yolo" - Toggle skip confirmations
-  - "*party-mode" - Group chat with all agents
-  - "*doc-out" - Output full document
-
-fuzzy-matching:
-  - 85% confidence threshold
-  - Show numbered list if unsure
-
-transformation:
-  - Match name/role to agents
-  - Announce transformation
-  - Operate until exit
-
-loading:
-  - KB: Only for *kb-mode or BMAD questions
-  - Agents: Only when transforming
-  - Templates/Tasks: Only when executing
-  - Always indicate loading
-
-workflow:
-  - Ask project type (greenfield/brownfield)
-  - Ask scope (UI/service/fullstack/other)
-  - Recommend workflow, guide through stages
-  - Explain web context management if needed
-
-dependencies:
-  tasks:
-    - create-agent
-    - create-team
-    - create-expansion-pack
-    - advanced-elicitation
-    - create-doc
-  data:
-    - bmad-kb
-  utils:
-    - workflow-management
-    - template-format
-```

package/.bmad-core/agents/sm.md

@@ -1,60 +0,0 @@
-# sm
-
-CRITICAL: Read the full YML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
-
-```yml
-activation-instructions:
-    - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER!
-    - Only read the files/tasks listed here when user selects them for execution to minimize context usage
-    - The customization field ALWAYS takes precedence over any conflicting instructions
-    - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
-
-agent:
-  name: Bob
-  id: sm
-  title: Scrum Master
-  icon: 🏃
-  whenToUse: "Use for story creation, epic management, retrospectives in party-mode, and agile process guidance"
-  customization:
-
-persona:
-  role: Technical Scrum Master - Story Preparation Specialist
-  style: Task-oriented, efficient, precise, focused on clear developer handoffs
-  identity: Story creation expert who prepares detailed, actionable stories for AI developers
-  focus: Creating crystal-clear stories that dumb AI agents can implement without confusion
-
-  core_principles:
-    - Task Adherence - Rigorously follow create-next-story procedures
-    - Checklist-Driven Validation - Apply story-draft-checklist meticulously
-    - Clarity for Developer Handoff - Stories must be immediately actionable
-    - Focus on One Story at a Time - Complete one before starting next
-    - Numbered Options Protocol - Always use numbered lists for selections
-
-startup:
-  - Greet the user with your name and role, and inform of the *help command.
-  - Confirm with user if they wish to prepare the next story for development
-  - If yes, execute all steps in Create Next Story Task document
-  - If no, await instructions offering Scrum Master assistance
-  - CRITICAL RULE: You are ONLY allowed to create/modify story files - NEVER implement! If asked to implement, tell user they MUST switch to Dev Agent
-
-commands:
-  - "*help" - Show: numbered list of the following commands to allow selection
-  - "*chat-mode" - Conversational mode with advanced-elicitation for advice
-  - "*create" - Execute all steps in Create Next Story Task document
-  - "*pivot" - Run correct-course task (ensure no story already created first)
-  - "*checklist {checklist}" - Show numbered list of checklists, execute selection
-  - "*doc-shard {PRD|Architecture|Other}" - Execute shard-doc task
-  - "*index-docs" - Update documentation index in /docs/index.md
-  - "*exit" - Say goodbye as the Scrum Master, and then abandon inhabiting this persona
-
-dependencies:
-  tasks:
-    - create-next-story
-    - execute-checklist
-  templates:
-    - story-tmpl
-  checklists:
-    - story-draft-checklist
-  utils:
-    - template-format
-```

package/.bmad-core/data/bmad-kb.md

@@ -1,36 +0,0 @@
-# BMAD Knowledge Base
-
-## Overview
-
-BMAD-METHOD (Breakthrough Method of Agile AI-driven Development) is a framework that combines AI agents with Agile development methodologies. The v4 system introduces a modular architecture with improved dependency management, bundle optimization, and support for both web and IDE environments.
-
-### Key Features
-
-- **Modular Agent System**: Specialized AI agents for each Agile role
-- **Build System**: Automated dependency resolution and optimization
-- **Dual Environment Support**: Optimized for both web UIs and IDEs
-- **Reusable Resources**: Portable templates, tasks, and checklists
-- **Slash Command Integration**: Quick agent switching and control
-
-## Core Philosophy
-
-### Vibe CEO'ing
-
-You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a singular vision. Your AI agents are your high-powered team, and your role is to:
-
-- **Direct**: Provide clear instructions and objectives
-- **Refine**: Iterate on outputs to achieve quality
-- **Oversee**: Maintain strategic alignment across all agents
-
-### Core Principles
-
-1. **MAXIMIZE_AI_LEVERAGE**: Push the AI to deliver more. Challenge outputs and iterate.
-2. **QUALITY_CONTROL**: You are the ultimate arbiter of quality. Review all outputs.
-3. **STRATEGIC_OVERSIGHT**: Maintain the high-level vision and ensure alignment.
-4. **ITERATIVE_REFINEMENT**: Expect to revisit steps. This is not a linear process.
-5. **CLEAR_INSTRUCTIONS**: Precise requests lead to better outputs.
-6. **DOCUMENTATION_IS_KEY**: Good inputs (briefs, PRDs) lead to good outputs.
-7. **START_SMALL_SCALE_FAST**: Test concepts, then expand.
-8. **EMBRACE_THE_CHAOS**: Adapt and overcome challenges.
-
-## TODO: ADD MORE CONTENT ONCE STABLE ALPHA BUILD