bmad-method 4.37.0-beta.5 → 4.37.0-beta.6

package/tools/lib/dependency-resolver.js

@@ -0,0 +1,179 @@
+const fs = require('fs').promises;
+const path = require('path');
+const yaml = require('js-yaml');
+const { extractYamlFromAgent } = require('./yaml-utils');
+
+class DependencyResolver {
+  constructor(rootDir) {
+    this.rootDir = rootDir;
+    this.bmadCore = path.join(rootDir, 'bmad-core');
+    this.common = path.join(rootDir, 'common');
+    this.cache = new Map();
+  }
+
+  async resolveAgentDependencies(agentId) {
+    const agentPath = path.join(this.bmadCore, 'agents', `${agentId}.md`);
+    const agentContent = await fs.readFile(agentPath, 'utf8');
+    
+    // Extract YAML from markdown content with command cleaning
+    const yamlContent = extractYamlFromAgent(agentContent, true);
+    if (!yamlContent) {
+      throw new Error(`No YAML configuration found in agent ${agentId}`);
+    }
+    
+    const agentConfig = yaml.load(yamlContent);
+    
+    const dependencies = {
+      agent: {
+        id: agentId,
+        path: agentPath,
+        content: agentContent,
+        config: agentConfig
+      },
+      resources: []
+    };
+
+    // Personas are now embedded in agent configs, no need to resolve separately
+
+    // Resolve other dependencies
+    const depTypes = ['tasks', 'templates', 'checklists', 'data', 'utils'];
+    for (const depType of depTypes) {
+      const deps = agentConfig.dependencies?.[depType] || [];
+      for (const depId of deps) {
+        const resource = await this.loadResource(depType, depId);
+        if (resource) dependencies.resources.push(resource);
+      }
+    }
+
+    return dependencies;
+  }
+
+  async resolveTeamDependencies(teamId) {
+    const teamPath = path.join(this.bmadCore, 'agent-teams', `${teamId}.yaml`);
+    const teamContent = await fs.readFile(teamPath, 'utf8');
+    const teamConfig = yaml.load(teamContent);
+    
+    const dependencies = {
+      team: {
+        id: teamId,
+        path: teamPath,
+        content: teamContent,
+        config: teamConfig
+      },
+      agents: [],
+      resources: new Map() // Use Map to deduplicate resources
+    };
+
+    // Always add bmad-orchestrator agent first if it's a team
+    const bmadAgent = await this.resolveAgentDependencies('bmad-orchestrator');
+    dependencies.agents.push(bmadAgent.agent);
+    bmadAgent.resources.forEach(res => {
+      dependencies.resources.set(res.path, res);
+    });
+
+    // Resolve all agents in the team
+    let agentsToResolve = teamConfig.agents || [];
+    
+    // Handle wildcard "*" - include all agents except bmad-master
+    if (agentsToResolve.includes('*')) {
+      const allAgents = await this.listAgents();
+      // Remove wildcard and add all agents except those already in the list and bmad-master
+      agentsToResolve = agentsToResolve.filter(a => a !== '*');
+      for (const agent of allAgents) {
+        if (!agentsToResolve.includes(agent) && agent !== 'bmad-master') {
+          agentsToResolve.push(agent);
+        }
+      }
+    }
+    
+    for (const agentId of agentsToResolve) {
+      if (agentId === 'bmad-orchestrator' || agentId === 'bmad-master') continue; // Already added or excluded
+      const agentDeps = await this.resolveAgentDependencies(agentId);
+      dependencies.agents.push(agentDeps.agent);
+      
+      // Add resources with deduplication
+      agentDeps.resources.forEach(res => {
+        dependencies.resources.set(res.path, res);
+      });
+    }
+
+    // Resolve workflows
+    for (const workflowId of teamConfig.workflows || []) {
+      const resource = await this.loadResource('workflows', workflowId);
+      if (resource) dependencies.resources.set(resource.path, resource);
+    }
+
+    // Convert Map back to array
+    dependencies.resources = Array.from(dependencies.resources.values());
+
+    return dependencies;
+  }
+
+  async loadResource(type, id) {
+    const cacheKey = `${type}#${id}`;
+    if (this.cache.has(cacheKey)) {
+      return this.cache.get(cacheKey);
+    }
+
+    try {
+      let content = null;
+      let filePath = null;
+
+      // First try bmad-core
+      try {
+        filePath = path.join(this.bmadCore, type, id);
+        content = await fs.readFile(filePath, 'utf8');
+      } catch (e) {
+        // If not found in bmad-core, try common folder
+        try {
+          filePath = path.join(this.common, type, id);
+          content = await fs.readFile(filePath, 'utf8');
+        } catch (e2) {
+          // File not found in either location
+        }
+      }
+
+      if (!content) {
+        console.warn(`Resource not found: ${type}/${id}`);
+        return null;
+      }
+
+      const resource = {
+        type,
+        id,
+        path: filePath,
+        content
+      };
+
+      this.cache.set(cacheKey, resource);
+      return resource;
+    } catch (error) {
+      console.error(`Error loading resource ${type}/${id}:`, error.message);
+      return null;
+    }
+  }
+
+  async listAgents() {
+    try {
+      const files = await fs.readdir(path.join(this.bmadCore, 'agents'));
+      return files
+        .filter(f => f.endsWith('.md'))
+        .map(f => f.replace('.md', ''));
+    } catch (error) {
+      return [];
+    }
+  }
+
+  async listTeams() {
+    try {
+      const files = await fs.readdir(path.join(this.bmadCore, 'agent-teams'));
+      return files
+        .filter(f => f.endsWith('.yaml'))
+        .map(f => f.replace('.yaml', ''));
+    } catch (error) {
+      return [];
+    }
+  }
+}
+
+module.exports = DependencyResolver;

package/tools/lib/yaml-utils.js

@@ -0,0 +1,29 @@
+/**
+ * Utility functions for YAML extraction from agent files
+ */
+
+/**
+ * Extract YAML content from agent markdown files
+ * @param {string} agentContent - The full content of the agent file
+ * @param {boolean} cleanCommands - Whether to clean command descriptions (default: false)
+ * @returns {string|null} - The extracted YAML content or null if not found
+ */
+function extractYamlFromAgent(agentContent, cleanCommands = false) {
+  // Remove carriage returns and match YAML block
+  const yamlMatch = agentContent.replace(/\r/g, "").match(/```ya?ml\n([\s\S]*?)\n```/);
+  if (!yamlMatch) return null;
+  
+  let yamlContent = yamlMatch[1].trim();
+  
+  // Clean up command descriptions if requested
+  // Converts "- command - description" to just "- command"
+  if (cleanCommands) {
+    yamlContent = yamlContent.replace(/^(\s*-)(\s*"[^"]+")(\s*-\s*.*)$/gm, '$1$2');
+  }
+  
+  return yamlContent;
+}
+
+module.exports = {
+  extractYamlFromAgent
+};

package/tools/md-assets/web-agent-startup-instructions.md

@@ -0,0 +1,39 @@
+# Web Agent Bundle Instructions
+
+You are now operating as a specialized AI agent from the BMad-Method framework. This is a bundled web-compatible version containing all necessary resources for your role.
+
+## Important Instructions
+
+### **Follow all startup commands**: Your agent configuration includes startup instructions that define your behavior, personality, and approach. These MUST be followed exactly.
+
+### **Resource Navigation**: This bundle contains all resources you need. Resources are marked with tags like:
+
+- `==================== START: .bmad-core/folder/filename.md ====================`
+- `==================== END: .bmad-core/folder/filename.md ====================`
+
+When you need to reference a resource mentioned in your instructions:
+
+- Look for the corresponding START/END tags
+- The format is always the full path with dot prefix (e.g., `.bmad-core/personas/analyst.md`, `.bmad-core/tasks/create-story.md`)
+- If a section is specified (e.g., `{root}/tasks/create-story.md#section-name`), navigate to that section within the file
+
+**Understanding YAML References**: In the agent configuration, resources are referenced in the dependencies section. For example:
+
+```yaml
+dependencies:
+  utils:
+    - template-format
+  tasks:
+    - create-story
+```
+
+These references map directly to bundle sections:
+
+- `dependencies.utils: template-format` → Look for `==================== START: .bmad-core/utils/template-format.md ====================`
+- `dependencies.utils: create-story` → Look for `==================== START: .bmad-core/tasks/create-story.md ====================`
+
+### **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance. You have no file system to write to, so you will maintain document history being drafted in your memory unless a canvas feature is available and the user confirms its usage.
+
+## **Primary Directive**: Your primary goal is defined in your agent configuration below. Focus on fulfilling your designated role explicitly as defined.
+
+---

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

@@ -0,0 +1,30 @@
+/**
+ * Semantic-release plugin to sync installer package.json version
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// This function runs during the "prepare" step of semantic-release
+function prepare(_, { nextRelease, logger }) {
+  // Define the path to the installer package.json file
+  const file = path.join(process.cwd(), 'tools/installer/package.json');
+
+  // If the file does not exist, skip syncing and log a message
+  if (!fs.existsSync(file)) return logger.log('Installer package.json not found, skipping');
+
+  // Read and parse the package.json file
+  const pkg = JSON.parse(fs.readFileSync(file, 'utf8'));
+
+  // Update the version field with the next release version
+  pkg.version = nextRelease.version;
+
+  // Write the updated JSON back to the file
+  fs.writeFileSync(file, JSON.stringify(pkg, null, 2) + '\n');
+
+  // Log success message
+  logger.log(`Synced installer package.json to version ${nextRelease.version}`);
+}
+
+// Export the prepare function so semantic-release can use it
+module.exports = { prepare };

package/tools/shared/bannerArt.js

@@ -0,0 +1,105 @@
+// ASCII banner art definitions extracted from banners.js to separate art from logic
+
+const BMAD_TITLE = "BMAD-METHOD";
+const FLATTENER_TITLE = "FLATTENER";
+const INSTALLER_TITLE = "INSTALLER";
+
+// Large ASCII blocks (block-style fonts)
+const BMAD_LARGE = `
+██████╗ ███╗   ███╗ █████╗ ██████╗       ███╗   ███╗███████╗████████╗██╗  ██╗ ██████╗ ██████╗ 
+██╔══██╗████╗ ████║██╔══██╗██╔══██╗      ████╗ ████║██╔════╝╚══██╔══╝██║  ██║██╔═══██╗██╔══██╗
+██████╔╝██╔████╔██║███████║██║  ██║█████╗██╔████╔██║█████╗     ██║   ███████║██║   ██║██║  ██║
+██╔══██╗██║╚██╔╝██║██╔══██║██║  ██║╚════╝██║╚██╔╝██║██╔══╝     ██║   ██╔══██║██║   ██║██║  ██║
+██████╔╝██║ ╚═╝ ██║██║  ██║██████╔╝      ██║ ╚═╝ ██║███████╗   ██║   ██║  ██║╚██████╔╝██████╔╝
+╚═════╝ ╚═╝     ╚═╝╚═╝  ╚═╝╚═════╝       ╚═╝     ╚═╝╚══════╝   ╚═╝   ╚═╝  ╚═╝ ╚═════╝ ╚═════╝ 
+`;
+
+const FLATTENER_LARGE = `
+███████╗██╗      █████╗ ████████╗████████╗███████╗███╗   ██╗███████╗██████╗ 
+██╔════╝██║     ██╔══██╗╚══██╔══╝╚══██╔══╝██╔════╝████╗  ██║██╔════╝██╔══██╗
+█████╗  ██║     ███████║   ██║      ██║   █████╗  ██╔██╗ ██║█████╗  ██████╔╝
+██╔══╝  ██║     ██╔══██║   ██║      ██║   ██╔══╝  ██║╚██╗██║██╔══╝  ██╔══██╗
+██║     ███████║██║  ██║   ██║      ██║   ███████╗██║ ╚████║███████╗██║  ██║
+╚═╝     ╚══════╝╚═╝  ╚═╝   ╚═╝      ╚═╝   ╚══════╝╚═╝  ╚═══╝╚══════╝╚═╝  ╚═╝
+ `;
+
+const INSTALLER_LARGE = `
+██╗███╗   ██╗███████╗████████╗ █████╗ ██╗     ██╗     ███████╗██████╗ 
+██║████╗  ██║██╔════╝╚══██╔══╝██╔══██╗██║     ██║     ██╔════╝██╔══██╗
+██║██╔██╗ ██║███████╗   ██║   ███████║██║     ██║     █████╗  ██████╔╝
+██║██║╚██╗██║╚════██║   ██║   ██╔══██║██║     ██║     ██╔══╝  ██╔══██╗
+██║██║ ╚████║███████║   ██║   ██║  ██║███████╗███████╗███████╗██║  ██║
+╚═╝╚═╝  ╚═══╝╚══════╝   ╚═╝   ╚═╝  ╚═╝╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝
+`;
+
+// Curated medium/small/tiny variants (fixed art, no runtime scaling)
+// Medium: bold framed title with heavy fill (high contrast, compact)
+const BMAD_MEDIUM = `
+███╗ █╗    █╗ ██╗ ███╗    █╗    █╗███╗█████╗█╗ █╗ ██╗ ███╗ 
+█╔═█╗██╗  ██║█╔═█╗█╔═█╗   ██╗  ██║█╔═╝╚═█╔═╝█║ █║█╔═█╗█╔═█╗
+███╔╝█╔███╔█║████║█║ █║██╗█╔███╔█║██╗   █║  ████║█║ █║█║ █║
+█╔═█╗█║ █╔╝█║█╔═█║█║ █║╚═╝█║ █╔╝█║█╔╝   █║  █╔═█║█║ █║█║ █║
+███╔╝█║ ╚╝ █║█║ █║███╔╝   █║ ╚╝ █║███╗  █║  █║ █║╚██╔╝███╔╝
+╚══╝ ╚╝    ╚╝╚╝ ╚╝╚══╝    ╚╝    ╚╝╚══╝  ╚╝  ╚╝ ╚╝ ╚═╝ ╚══╝ 
+`;
+
+const FLATTENER_MEDIUM = `
+███╗█╗   ██╗ █████╗█████╗███╗█╗  █╗███╗███╗ 
+█╔═╝█║  █╔═█╗╚═█╔═╝╚═█╔═╝█╔═╝██╗ █║█╔═╝█╔═█╗
+██╗ █║  ████║  █║    █║  ██╗ █╔█╗█║██╗ ███╔╝
+█╔╝ █║  █╔═█║  █║    █║  █╔╝ █║ ██║█╔╝ █╔═█╗
+█║  ███║█║ █║  █║    █║  ███╗█║  █║███╗█║ █║
+╚╝  ╚══╝╚╝ ╚╝  ╚╝    ╚╝  ╚══╝╚╝  ╚╝╚══╝╚╝ ╚╝
+ `;
+
+const INSTALLER_MEDIUM = `
+█╗█╗  █╗████╗█████╗ ██╗ █╗  █╗  ███╗███╗ 
+█║██╗ █║█╔══╝╚═█╔═╝█╔═█╗█║  █║  █╔═╝█╔═█╗
+█║█╔█╗█║████╗  █║  ████║█║  █║  ██╗ ███╔╝
+█║█║ ██║╚══█║  █║  █╔═█║█║  █║  █╔╝ █╔═█╗
+█║█║  █║████║  █║  █║ █║███╗███╗███╗█║ █║
+╚╝╚╝  ╚╝╚═══╝  ╚╝  ╚╝ ╚╝╚══╝╚══╝╚══╝╚╝ ╚╝
+`;
+
+// Small: rounded box with bold rule
+// Width: 30 columns total (28 inner)
+const BMAD_SMALL = `
+╭──────────────────────────╮
+│        BMAD-METHOD       │
+╰──────────────────────────╯
+`;
+
+const FLATTENER_SMALL = `
+╭──────────────────────────╮
+│         FLATTENER        │
+╰──────────────────────────╯
+`;
+
+const INSTALLER_SMALL = `
+ ╭──────────────────────────╮
+ │         INSTALLER        │
+ ╰──────────────────────────╯
+ `;
+
+// Tiny (compact brackets)
+const BMAD_TINY = `[ BMAD-METHOD ]`;
+const FLATTENER_TINY = `[ FLATTENER ]`;
+const INSTALLER_TINY = `[ INSTALLER ]`;
+
+module.exports = {
+  BMAD_TITLE,
+  FLATTENER_TITLE,
+  INSTALLER_TITLE,
+  BMAD_LARGE,
+  FLATTENER_LARGE,
+  INSTALLER_LARGE,
+  BMAD_MEDIUM,
+  FLATTENER_MEDIUM,
+  INSTALLER_MEDIUM,
+  BMAD_SMALL,
+  FLATTENER_SMALL,
+  INSTALLER_SMALL,
+  BMAD_TINY,
+  FLATTENER_TINY,
+  INSTALLER_TINY,
+};

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/update-expansion-version.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const yaml = require('js-yaml');
+
+const args = process.argv.slice(2);
+
+if (args.length < 2) {
+  console.log('Usage: node update-expansion-version.js <expansion-pack-id> <new-version>');
+  console.log('Example: node update-expansion-version.js bmad-creator-tools 1.1.0');
+  process.exit(1);
+}
+
+const [packId, newVersion] = args;
+
+// Validate version format
+if (!/^\d+\.\d+\.\d+$/.test(newVersion)) {
+  console.error('Error: Version must be in format X.Y.Z (e.g., 1.2.3)');
+  process.exit(1);
+}
+
+async function updateVersion() {
+  try {
+    // Update in config.yaml
+    const configPath = path.join(__dirname, '..', 'expansion-packs', packId, 'config.yaml');
+    
+    if (!fs.existsSync(configPath)) {
+      console.error(`Error: Expansion pack '${packId}' not found`);
+      process.exit(1);
+    }
+    
+    const configContent = fs.readFileSync(configPath, 'utf8');
+    const config = yaml.load(configContent);
+    const oldVersion = config.version || 'unknown';
+    
+    config.version = newVersion;
+    
+    const updatedYaml = yaml.dump(config, { indent: 2 });
+    fs.writeFileSync(configPath, updatedYaml);
+    
+    console.log(`✓ Updated ${packId}/config.yaml: ${oldVersion} → ${newVersion}`);
+    console.log(`\n✓ Successfully updated ${packId} to version ${newVersion}`);
+    console.log('\nNext steps:');
+    console.log('1. Test the changes');
+    console.log('2. Commit: git add -A && git commit -m "chore: bump ' + packId + ' to v' + newVersion + '"');
+    
+  } catch (error) {
+    console.error('Error updating version:', error.message);
+    process.exit(1);
+  }
+}
+
+updateVersion();