bmad-method 4.2.0 → 4.4.0

package/tools/installer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bmad-method",
-  "version": "4.0.0",
+  "version": "4.4.0",
   "description": "BMAD Method installer - AI-powered Agile development framework",
   "main": "lib/installer.js",
   "bin": {
@@ -22,12 +22,12 @@
   "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"
@@ -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

@@ -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/schemas/agent-team-schema.yml

@@ -1,153 +0,0 @@
-# BMAD Agent Team Configuration Schema
-# This schema defines the structure for BMAD agent team configuration files
-# Teams bundle multiple agents and workflows for specific project types
-
-type: object
-required:
-  - bundle
-  - agents
-  - workflows
-
-properties:
-  bundle:
-    type: object
-    description: Team bundle metadata and configuration
-    required:
-      - name
-      - description
-    properties:
-      name:
-        type: string
-        description: Human-friendly name of the team bundle
-        pattern: "^Team .+$"
-        examples:
-          - "Team Fullstack"
-          - "Team No UI"
-          - "Team All"
-
-      description:
-        type: string
-        description: Detailed description of the team's purpose, capabilities, and use cases
-        minLength: 20
-        maxLength: 500
-
-  agents:
-    type: array
-    description: List of agents included in this team bundle
-    minItems: 2
-    items:
-      type: string
-      description: Agent ID matching agents/{agent}.yml or special value '*' for all agents
-      pattern: "^([a-z-]+|\\*)$"
-      examples:
-        - "bmad"
-        - "analyst"
-        - "pm"
-        - "ux-expert"
-        - "architect"
-        - "po"
-        - "sm"
-        - "dev"
-        - "qa"
-        - "*"
-    uniqueItems: true
-    allOf:
-      - description: Must include 'bmad' as the orchestrator
-        contains:
-          const: "bmad"
-
-  workflows:
-    type: array
-    description: List of workflows this team can execute
-    minItems: 1
-    items:
-      type: string
-      description: Workflow ID matching bmad-core/workflows/{workflow}.yml
-      enum:
-        - "brownfield-fullstack"
-        - "brownfield-service"
-        - "brownfield-ui"
-        - "greenfield-fullstack"
-        - "greenfield-service"
-        - "greenfield-ui"
-    uniqueItems: true
-
-# No additional properties allowed
-additionalProperties: false
-
-# Validation rules
-allOf:
-  - if:
-      properties:
-        agents:
-          contains:
-            const: "*"
-    then:
-      properties:
-        agents:
-          maxItems: 2
-          description: When using wildcard '*', only 'bmad' and '*' should be present
-
-  - if:
-      properties:
-        bundle:
-          properties:
-            name:
-              const: "Team No UI"
-    then:
-      properties:
-        agents:
-          not:
-            contains:
-              const: "ux-expert"
-        workflows:
-          not:
-            contains:
-              enum: ["brownfield-ui", "greenfield-ui"]
-
-# Examples showing valid team configurations
-examples:
-  minimal_team:
-    bundle:
-      name: "Team Minimal"
-      description: "Minimal team for basic project planning and architecture without implementation"
-    agents:
-      - bmad
-      - analyst
-      - architect
-    workflows:
-      - greenfield-service
-
-  fullstack_team:
-    bundle:
-      name: "Team Fullstack"
-      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."
-    agents:
-      - bmad
-      - analyst
-      - pm
-      - ux-expert
-      - architect
-      - po
-    workflows:
-      - brownfield-fullstack
-      - brownfield-service
-      - brownfield-ui
-      - greenfield-fullstack
-      - greenfield-service
-      - greenfield-ui
-
-  all_agents_team:
-    bundle:
-      name: "Team All"
-      description: "This is a full organization of agents and includes every possible agent. This will produce the largest bundle but give the most options for discussion in a single session"
-    agents:
-      - bmad
-      - "*"
-    workflows:
-      - brownfield-fullstack
-      - brownfield-service
-      - brownfield-ui
-      - greenfield-fullstack
-      - greenfield-service
-      - greenfield-ui