bmad-method 4.6.3 → 4.8.0

package/tools/builders/web-builder.js

@@ -1,19 +1,22 @@
-const fs = require('node:fs').promises;
-const path = require('node:path');
-const DependencyResolver = require('../lib/dependency-resolver');
+const fs = require("node:fs").promises;
+const path = require("node:path");
+const DependencyResolver = require("../lib/dependency-resolver");
 
 class WebBuilder {
   constructor(options = {}) {
     this.rootDir = options.rootDir || process.cwd();
-    this.outputDirs = options.outputDirs || [
-      path.join(this.rootDir, 'dist')
-    ];
+    this.outputDirs = options.outputDirs || [path.join(this.rootDir, "dist")];
     this.resolver = new DependencyResolver(this.rootDir);
-    this.templatePath = path.join(this.rootDir, 'bmad-core', 'templates', 'web-agent-startup-instructions-template.md');
+    this.templatePath = path.join(
+      this.rootDir,
+      "bmad-core",
+      "utils",
+      "web-agent-startup-instructions.md"
+    );
   }
 
   parseYaml(content) {
-    const yaml = require('js-yaml');
+    const yaml = require("js-yaml");
     return yaml.load(content);
   }
 
@@ -38,10 +41,10 @@ class WebBuilder {
 
       // Write to all output directories
       for (const outputDir of this.outputDirs) {
-        const outputPath = path.join(outputDir, 'agents');
+        const outputPath = path.join(outputDir, "agents");
         await fs.mkdir(outputPath, { recursive: true });
         const outputFile = path.join(outputPath, `${agentId}.txt`);
-        await fs.writeFile(outputFile, bundle, 'utf8');
+        await fs.writeFile(outputFile, bundle, "utf8");
       }
     }
 
@@ -57,10 +60,10 @@ class WebBuilder {
 
       // Write to all output directories
       for (const outputDir of this.outputDirs) {
-        const outputPath = path.join(outputDir, 'teams');
+        const outputPath = path.join(outputDir, "teams");
         await fs.mkdir(outputPath, { recursive: true });
         const outputFile = path.join(outputPath, `${teamId}.txt`);
-        await fs.writeFile(outputFile, bundle, 'utf8');
+        await fs.writeFile(outputFile, bundle, "utf8");
       }
     }
 
@@ -69,7 +72,7 @@ class WebBuilder {
 
   async buildAgentBundle(agentId) {
     const dependencies = await this.resolver.resolveAgentDependencies(agentId);
-    const template = await fs.readFile(this.templatePath, 'utf8');
+    const template = await fs.readFile(this.templatePath, "utf8");
 
     const sections = [template];
 
@@ -81,12 +84,12 @@ class WebBuilder {
       sections.push(this.formatSection(resource.path, resource.content));
     }
 
-    return sections.join('\n');
+    return sections.join("\n");
   }
 
   async buildTeamBundle(teamId) {
     const dependencies = await this.resolver.resolveTeamDependencies(teamId);
-    const template = await fs.readFile(this.templatePath, 'utf8');
+    const template = await fs.readFile(this.templatePath, "utf8");
 
     const sections = [template];
 
@@ -103,21 +106,72 @@ class WebBuilder {
       sections.push(this.formatSection(resource.path, resource.content));
     }
 
-    return sections.join('\n');
+    return sections.join("\n");
+  }
+
+  processAgentContent(content) {
+    // First, replace content before YAML with the template
+    const yamlMatch = content.match(/```ya?ml\n([\s\S]*?)\n```/);
+    if (!yamlMatch) return content;
+
+    const yamlContent = yamlMatch[1];
+    const yamlStartIndex = content.indexOf(yamlMatch[0]);
+    const yamlEndIndex = yamlStartIndex + yamlMatch[0].length;
+    
+    // Parse YAML and remove root and IDE-FILE-RESOLUTION properties
+    try {
+      const yaml = require("js-yaml");
+      const parsed = yaml.load(yamlContent);
+      
+      // Remove the properties if they exist at root level
+      delete parsed.root;
+      delete parsed['IDE-FILE-RESOLUTION'];
+      delete parsed['REQUEST-RESOLUTION'];
+      
+      // Also remove from activation-instructions if they exist
+      if (parsed['activation-instructions'] && Array.isArray(parsed['activation-instructions'])) {
+        parsed['activation-instructions'] = parsed['activation-instructions'].filter(instruction => {
+          return !instruction.startsWith('IDE-FILE-RESOLUTION:') && 
+                 !instruction.startsWith('REQUEST-RESOLUTION:');
+        });
+      }
+      
+      // Reconstruct the YAML
+      const cleanedYaml = yaml.dump(parsed, { lineWidth: -1 });
+      
+      // Get the agent name from the YAML for the header
+      const agentName = parsed.agent?.id || 'agent';
+      
+      // Build the new content with just the agent header and YAML
+      const newHeader = `# ${agentName}\n\nCRITICAL: 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:\n\n`;
+      const afterYaml = content.substring(yamlEndIndex);
+      
+      return newHeader + "```yaml\n" + cleanedYaml.trim() + "\n```" + afterYaml;
+    } catch (error) {
+      console.warn("Failed to process agent YAML:", error.message);
+      // If parsing fails, return original content
+      return content;
+    }
   }
 
   formatSection(path, content) {
-    const separator = '====================';
+    const separator = "====================";
+    
+    // Process agent content if this is an agent file
+    if (path.startsWith("agents#")) {
+      content = this.processAgentContent(content);
+    }
+    
     return [
       `${separator} START: ${path} ${separator}`,
       content.trim(),
       `${separator} END: ${path} ${separator}`,
-      ''
-    ].join('\n');
+      "",
+    ].join("\n");
   }
 
   async validate() {
-    console.log('Validating agent configurations...');
+    console.log("Validating agent configurations...");
     const agents = await this.resolver.listAgents();
     for (const agentId of agents) {
       try {
@@ -129,7 +183,7 @@ class WebBuilder {
       }
     }
 
-    console.log('\nValidating team configurations...');
+    console.log("\nValidating team configurations...");
     const teams = await this.resolver.listTeams();
     for (const teamId of teams) {
       try {
@@ -154,10 +208,8 @@ class WebBuilder {
   }
 
   async buildExpansionPack(packName, options = {}) {
-    const packDir = path.join(this.rootDir, 'expansion-packs', packName);
-    const outputDirs = [
-      path.join(this.rootDir, 'dist', 'expansion-packs', packName)
-    ];
+    const packDir = path.join(this.rootDir, "expansion-packs", packName);
+    const outputDirs = [path.join(this.rootDir, "dist", "expansion-packs", packName)];
 
     // Clean output directories if requested
     if (options.clean !== false) {
@@ -171,27 +223,27 @@ class WebBuilder {
     }
 
     // Build individual agents first
-    const agentsDir = path.join(packDir, 'agents');
+    const agentsDir = path.join(packDir, "agents");
     try {
       const agentFiles = await fs.readdir(agentsDir);
-      const agentMarkdownFiles = agentFiles.filter(f => f.endsWith('.md'));
-      
+      const agentMarkdownFiles = agentFiles.filter((f) => f.endsWith(".md"));
+
       if (agentMarkdownFiles.length > 0) {
         console.log(`    Building individual agents for ${packName}:`);
-        
+
         for (const agentFile of agentMarkdownFiles) {
-          const agentName = agentFile.replace('.md', '');
+          const agentName = agentFile.replace(".md", "");
           console.log(`      - ${agentName}`);
-          
+
           // Build individual agent bundle
           const bundle = await this.buildExpansionAgentBundle(packName, packDir, agentName);
-          
+
           // Write to all output directories
           for (const outputDir of outputDirs) {
-            const agentsOutputDir = path.join(outputDir, 'agents');
+            const agentsOutputDir = path.join(outputDir, "agents");
             await fs.mkdir(agentsOutputDir, { recursive: true });
             const outputFile = path.join(agentsOutputDir, `${agentName}.txt`);
-            await fs.writeFile(outputFile, bundle, 'utf8');
+            await fs.writeFile(outputFile, bundle, "utf8");
           }
         }
       }
@@ -200,24 +252,24 @@ class WebBuilder {
     }
 
     // Build team bundle
-    const agentTeamsDir = path.join(packDir, 'agent-teams');
+    const agentTeamsDir = path.join(packDir, "agent-teams");
     try {
       const teamFiles = await fs.readdir(agentTeamsDir);
-      const teamFile = teamFiles.find(f => f.endsWith('.yml'));
-      
+      const teamFile = teamFiles.find((f) => f.endsWith(".yml"));
+
       if (teamFile) {
         console.log(`    Building team bundle for ${packName}`);
         const teamConfigPath = path.join(agentTeamsDir, teamFile);
-        
+
         // Build expansion pack as a team bundle
         const bundle = await this.buildExpansionTeamBundle(packName, packDir, teamConfigPath);
-        
+
         // Write to all output directories
         for (const outputDir of outputDirs) {
-          const teamsOutputDir = path.join(outputDir, 'teams');
+          const teamsOutputDir = path.join(outputDir, "teams");
           await fs.mkdir(teamsOutputDir, { recursive: true });
-          const outputFile = path.join(teamsOutputDir, teamFile.replace('.yml', '.txt'));
-          await fs.writeFile(outputFile, bundle, 'utf8');
+          const outputFile = path.join(teamsOutputDir, teamFile.replace(".yml", ".txt"));
+          await fs.writeFile(outputFile, bundle, "utf8");
           console.log(`    ✓ Created bundle: ${path.relative(this.rootDir, outputFile)}`);
         }
       } else {
@@ -229,49 +281,58 @@ class WebBuilder {
   }
 
   async buildExpansionAgentBundle(packName, packDir, agentName) {
-    const template = await fs.readFile(this.templatePath, 'utf8');
+    const template = await fs.readFile(this.templatePath, "utf8");
     const sections = [template];
 
     // Add agent configuration
-    const agentPath = path.join(packDir, 'agents', `${agentName}.md`);
-    const agentContent = await fs.readFile(agentPath, 'utf8');
+    const agentPath = path.join(packDir, "agents", `${agentName}.md`);
+    const agentContent = await fs.readFile(agentPath, "utf8");
     sections.push(this.formatSection(`agents#${agentName}`, agentContent));
 
     // Resolve and add agent dependencies
     const agentYaml = agentContent.match(/```yaml\n([\s\S]*?)\n```/);
     if (agentYaml) {
       try {
-        const yaml = require('js-yaml');
+        const yaml = require("js-yaml");
         const agentConfig = yaml.load(agentYaml[1]);
-        
+
         if (agentConfig.dependencies) {
           // Add resources, first try expansion pack, then core
           for (const [resourceType, resources] of Object.entries(agentConfig.dependencies)) {
             if (Array.isArray(resources)) {
               for (const resourceName of resources) {
                 let found = false;
-                const extensions = ['.md', '.yml', '.yaml'];
-                
+                const extensions = [".md", ".yml", ".yaml"];
+
                 // Try expansion pack first
                 for (const ext of extensions) {
                   const resourcePath = path.join(packDir, resourceType, `${resourceName}${ext}`);
                   try {
-                    const resourceContent = await fs.readFile(resourcePath, 'utf8');
-                    sections.push(this.formatSection(`${resourceType}#${resourceName}`, resourceContent));
+                    const resourceContent = await fs.readFile(resourcePath, "utf8");
+                    sections.push(
+                      this.formatSection(`${resourceType}#${resourceName}`, resourceContent)
+                    );
                     found = true;
                     break;
                   } catch (error) {
                     // Not in expansion pack, continue
                   }
                 }
-                
+
                 // If not found in expansion pack, try core
                 if (!found) {
                   for (const ext of extensions) {
-                    const corePath = path.join(this.rootDir, 'bmad-core', resourceType, `${resourceName}${ext}`);
+                    const corePath = path.join(
+                      this.rootDir,
+                      "bmad-core",
+                      resourceType,
+                      `${resourceName}${ext}`
+                    );
                     try {
-                      const coreContent = await fs.readFile(corePath, 'utf8');
-                      sections.push(this.formatSection(`${resourceType}#${resourceName}`, coreContent));
+                      const coreContent = await fs.readFile(corePath, "utf8");
+                      sections.push(
+                        this.formatSection(`${resourceType}#${resourceName}`, coreContent)
+                      );
                       found = true;
                       break;
                     } catch (error) {
@@ -279,9 +340,11 @@ class WebBuilder {
                     }
                   }
                 }
-                
+
                 if (!found) {
-                  console.warn(`    ⚠ Dependency ${resourceType}#${resourceName} not found in expansion pack or core`);
+                  console.warn(
+                    `    ⚠ Dependency ${resourceType}#${resourceName} not found in expansion pack or core`
+                  );
                 }
               }
             }
@@ -292,27 +355,27 @@ class WebBuilder {
       }
     }
 
-    return sections.join('\n');
+    return sections.join("\n");
   }
 
   async buildExpansionTeamBundle(packName, packDir, teamConfigPath) {
-    const template = await fs.readFile(this.templatePath, 'utf8');
+    const template = await fs.readFile(this.templatePath, "utf8");
 
     const sections = [template];
 
     // Add team configuration and parse to get agent list
-    const teamContent = await fs.readFile(teamConfigPath, 'utf8');
-    const teamFileName = path.basename(teamConfigPath, '.yml');
+    const teamContent = await fs.readFile(teamConfigPath, "utf8");
+    const teamFileName = path.basename(teamConfigPath, ".yml");
     const teamConfig = this.parseYaml(teamContent);
     sections.push(this.formatSection(`agent-teams#${teamFileName}`, teamContent));
 
     // Get list of expansion pack agents
     const expansionAgents = new Set();
-    const agentsDir = path.join(packDir, 'agents');
+    const agentsDir = path.join(packDir, "agents");
     try {
       const agentFiles = await fs.readdir(agentsDir);
-      for (const agentFile of agentFiles.filter(f => f.endsWith('.md'))) {
-        const agentName = agentFile.replace('.md', '');
+      for (const agentFile of agentFiles.filter((f) => f.endsWith(".md"))) {
+        const agentName = agentFile.replace(".md", "");
         expansionAgents.add(agentName);
       }
     } catch (error) {
@@ -321,13 +384,15 @@ class WebBuilder {
 
     // Build a map of all available expansion pack resources for override checking
     const expansionResources = new Map();
-    const resourceDirs = ['templates', 'tasks', 'checklists', 'workflows', 'data'];
+    const resourceDirs = ["templates", "tasks", "checklists", "workflows", "data"];
     for (const resourceDir of resourceDirs) {
       const resourcePath = path.join(packDir, resourceDir);
       try {
         const resourceFiles = await fs.readdir(resourcePath);
-        for (const resourceFile of resourceFiles.filter(f => f.endsWith('.md') || f.endsWith('.yml'))) {
-          const fileName = resourceFile.replace(/\.(md|yml)$/, '');
+        for (const resourceFile of resourceFiles.filter(
+          (f) => f.endsWith(".md") || f.endsWith(".yml")
+        )) {
+          const fileName = resourceFile.replace(/\.(md|yml)$/, "");
           expansionResources.set(`${resourceDir}#${fileName}`, true);
         }
       } catch (error) {
@@ -337,22 +402,21 @@ class WebBuilder {
 
     // Process all agents listed in team configuration
     const agentsToProcess = teamConfig.agents || [];
-    
+
     // Ensure bmad-orchestrator is always included for teams
-    if (!agentsToProcess.includes('bmad-orchestrator')) {
+    if (!agentsToProcess.includes("bmad-orchestrator")) {
       console.warn(`    ⚠ Team ${teamFileName} missing bmad-orchestrator, adding automatically`);
-      agentsToProcess.unshift('bmad-orchestrator');
+      agentsToProcess.unshift("bmad-orchestrator");
     }
 
     // Track all dependencies from all agents (deduplicated)
     const allDependencies = new Map();
 
     for (const agentId of agentsToProcess) {
-
       if (expansionAgents.has(agentId)) {
         // Use expansion pack version (override)
         const agentPath = path.join(agentsDir, `${agentId}.md`);
-        const agentContent = await fs.readFile(agentPath, 'utf8');
+        const agentContent = await fs.readFile(agentPath, "utf8");
         sections.push(this.formatSection(`agents#${agentId}`, agentContent));
 
         // Parse and collect dependencies from expansion agent
@@ -379,8 +443,8 @@ class WebBuilder {
       } else {
         // Use core BMAD version
         try {
-          const coreAgentPath = path.join(this.rootDir, 'bmad-core', 'agents', `${agentId}.md`);
-          const coreAgentContent = await fs.readFile(coreAgentPath, 'utf8');
+          const coreAgentPath = path.join(this.rootDir, "bmad-core", "agents", `${agentId}.md`);
+          const coreAgentContent = await fs.readFile(coreAgentPath, "utf8");
           sections.push(this.formatSection(`agents#${agentId}`, coreAgentContent));
 
           // Parse and collect dependencies from core agent
@@ -389,8 +453,8 @@ class WebBuilder {
             try {
               // Clean up the YAML to handle command descriptions after dashes
               let yamlContent = agentYaml[1];
-              yamlContent = yamlContent.replace(/^(\s*-)(\s*"[^"]+")(\s*-\s*.*)$/gm, '$1$2');
-              
+              yamlContent = yamlContent.replace(/^(\s*-)(\s*"[^"]+")(\s*-\s*.*)$/gm, "$1$2");
+
               const agentConfig = this.parseYaml(yamlContent);
               if (agentConfig.dependencies) {
                 for (const [resourceType, resources] of Object.entries(agentConfig.dependencies)) {
@@ -418,15 +482,15 @@ class WebBuilder {
     // Always prefer expansion pack versions if they exist
     for (const [key, dep] of allDependencies) {
       let found = false;
-      const extensions = ['.md', '.yml', '.yaml'];
-      
+      const extensions = [".md", ".yml", ".yaml"];
+
       // Always check expansion pack first, even if the dependency came from a core agent
       if (expansionResources.has(key)) {
         // We know it exists in expansion pack, find and load it
         for (const ext of extensions) {
           const expansionPath = path.join(packDir, dep.type, `${dep.name}${ext}`);
           try {
-            const content = await fs.readFile(expansionPath, 'utf8');
+            const content = await fs.readFile(expansionPath, "utf8");
             sections.push(this.formatSection(key, content));
             console.log(`      ✓ Using expansion override for ${key}`);
             found = true;
@@ -436,13 +500,13 @@ class WebBuilder {
           }
         }
       }
-      
+
       // If not found in expansion pack (or doesn't exist there), try core
       if (!found) {
         for (const ext of extensions) {
-          const corePath = path.join(this.rootDir, 'bmad-core', dep.type, `${dep.name}${ext}`);
+          const corePath = path.join(this.rootDir, "bmad-core", dep.type, `${dep.name}${ext}`);
           try {
-            const content = await fs.readFile(corePath, 'utf8');
+            const content = await fs.readFile(corePath, "utf8");
             sections.push(this.formatSection(key, content));
             found = true;
             break;
@@ -451,7 +515,7 @@ class WebBuilder {
           }
         }
       }
-      
+
       if (!found) {
         console.warn(`    ⚠ Dependency ${key} not found in expansion pack or core`);
       }
@@ -462,11 +526,13 @@ class WebBuilder {
       const resourcePath = path.join(packDir, resourceDir);
       try {
         const resourceFiles = await fs.readdir(resourcePath);
-        for (const resourceFile of resourceFiles.filter(f => f.endsWith('.md') || f.endsWith('.yml'))) {
+        for (const resourceFile of resourceFiles.filter(
+          (f) => f.endsWith(".md") || f.endsWith(".yml")
+        )) {
           const filePath = path.join(resourcePath, resourceFile);
-          const fileContent = await fs.readFile(filePath, 'utf8');
-          const fileName = resourceFile.replace(/\.(md|yml)$/, '');
-          
+          const fileContent = await fs.readFile(filePath, "utf8");
+          const fileName = resourceFile.replace(/\.(md|yml)$/, "");
+
           // Only add if not already included as a dependency
           const resourceKey = `${resourceDir}#${fileName}`;
           if (!allDependencies.has(resourceKey)) {
@@ -478,18 +544,16 @@ class WebBuilder {
       }
     }
 
-    return sections.join('\n');
+    return sections.join("\n");
   }
 
   async listExpansionPacks() {
-    const expansionPacksDir = path.join(this.rootDir, 'expansion-packs');
+    const expansionPacksDir = path.join(this.rootDir, "expansion-packs");
     try {
       const entries = await fs.readdir(expansionPacksDir, { withFileTypes: true });
-      return entries
-        .filter(entry => entry.isDirectory())
-        .map(entry => entry.name);
+      return entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
     } catch (error) {
-      console.warn('No expansion-packs directory found');
+      console.warn("No expansion-packs directory found");
       return [];
     }
   }
@@ -499,4 +563,4 @@ class WebBuilder {
   }
 }
 
-module.exports = WebBuilder;
+module.exports = WebBuilder;

package/tools/installer/bin/bmad.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 
 const { program } = require('commander');
+const path = require('path');
 
 // Dynamic imports for ES modules
 let chalk, inquirer;
@@ -57,7 +58,9 @@ program
       if (!options.full && !options.agent && !options.team && !options.expansionOnly) {
         // Interactive mode
         const answers = await promptInstallation();
-        await installer.install(answers);
+        if (!answers._alreadyInstalled) {
+          await installer.install(answers);
+        }
       } else {
         // Direct mode
         let installType = 'full';
@@ -158,6 +161,35 @@ async function promptInstallation() {
   ]);
   answers.directory = directory;
 
+  // Check if this is an existing v4 installation
+  const installDir = path.resolve(answers.directory);
+  const state = await installer.detectInstallationState(installDir);
+  
+  if (state.type === 'v4_existing') {
+    console.log(chalk.yellow('\n🔍 Found existing BMAD v4 installation'));
+    console.log(`   Directory: ${installDir}`);
+    console.log(`   Version: ${state.manifest?.version || 'Unknown'}`);
+    console.log(`   Installed: ${state.manifest?.installed_at ? new Date(state.manifest.installed_at).toLocaleDateString() : 'Unknown'}`);
+    
+    const { shouldUpdate } = await inquirer.prompt([
+      {
+        type: 'confirm',
+        name: 'shouldUpdate',
+        message: 'Would you like to update your existing BMAD v4 installation?',
+        default: true
+      }
+    ]);
+    
+    if (shouldUpdate) {
+      // Skip other prompts and go directly to update
+      answers.installType = 'update';
+      answers._alreadyInstalled = true; // Flag to prevent double installation
+      await installer.install(answers);
+      return answers; // Return the answers object
+    }
+    // If user doesn't want to update, continue with normal flow
+  }
+
   // Ask for installation type
   const { installType } = await inquirer.prompt([
     {
@@ -373,7 +405,7 @@ async function promptInstallation() {
         type: 'input',
         name: 'webBundlesDirectory',
         message: 'Enter directory for web bundles:',
-        default: `${directory}/web-bundles`,
+        default: `${answers.directory}/web-bundles`,
         validate: (input) => {
           if (!input.trim()) {
             return 'Please enter a valid directory path';

package/tools/installer/lib/file-manager.js

@@ -2,6 +2,7 @@ const fs = require("fs-extra");
 const path = require("path");
 const crypto = require("crypto");
 const glob = require("glob");
+const yaml = require("js-yaml");
 
 // Dynamic import for ES module
 let chalk;
@@ -106,7 +107,7 @@ class FileManager {
 
     // Write manifest
     await fs.ensureDir(path.dirname(manifestPath));
-    await fs.writeFile(manifestPath, JSON.stringify(manifest, null, 2));
+    await fs.writeFile(manifestPath, yaml.dump(manifest, { indent: 2 }));
 
     return manifest;
   }
@@ -120,7 +121,7 @@ class FileManager {
 
     try {
       const content = await fs.readFile(manifestPath, "utf8");
-      return JSON.parse(content);
+      return yaml.load(content);
     } catch (error) {
       return null;
     }