bmad-method 6.0.0-alpha.9 → 6.0.2

package/src/utility/models/fragments/handler-tmpl.xml

@@ -1,5 +0,0 @@
-    <handler type="tmpl">
-      When menu item has: tmpl="path/to/template.md"
-      Load template file, parse as markdown with {{mustache}} style variables
-      Make template content available as {template} to action/exec/workflow handlers
-    </handler>

package/src/utility/models/fragments/handler-validate-workflow.xml

@@ -1,7 +0,0 @@
-<handler type="validate-workflow">
-  When command has: validate-workflow="path/to/workflow.yaml"
-  1. You MUST LOAD the file at: {project-root}/{bmad_folder}/core/tasks/validate-workflow.xml
-  2. READ its entire contents and EXECUTE all instructions in that file
-  3. Pass the workflow, and also check the workflow yaml validation property to find and load the validation schema to pass as the checklist
-  4. The workflow should try to identify the file to validate based on checklist context or else you will ask the user to specify
-</handler>

package/src/utility/models/fragments/handler-workflow.xml

@@ -1,9 +0,0 @@
-<handler type="workflow">
-  When menu item has: workflow="path/to/workflow.yaml"
-  1. CRITICAL: Always LOAD {project-root}/{bmad_folder}/core/tasks/workflow.xml
-  2. Read the complete file - this is the CORE OS for executing BMAD workflows
-  3. Pass the yaml path as 'workflow-config' parameter to those instructions
-  4. Execute workflow.xml instructions precisely following all steps
-  5. Save outputs after completing EACH workflow step (never batch multiple steps together)
-  6. If workflow.yaml path is "todo", inform user the workflow hasn't been implemented yet
-</handler>

package/src/utility/models/fragments/menu-handlers.xml

@@ -1,6 +0,0 @@
-<menu-handlers>
-  <extract>{DYNAMIC_EXTRACT_LIST}</extract>
-  <handlers>
-{DYNAMIC_HANDLERS}
-  </handlers>
-</menu-handlers>

package/src/utility/models/fragments/web-bundle-activation-steps.xml

@@ -1,32 +0,0 @@
-<step n="1">Load persona from this current agent XML block containing this activation you are reading now</step>
-{AGENT_SPECIFIC_STEPS}
-<step n="{MENU_STEP}">Show greeting + numbered list of ALL commands IN ORDER from current agent's menu section</step>
-<step n="{HALT_STEP}">CRITICAL HALT. AWAIT user input. NEVER continue without it.</step>
-<step n="{INPUT_STEP}">On user input: Number → execute menu item[n] | Text → case-insensitive substring match | Multiple matches → ask user
-  to clarify | No match → show "Not recognized"</step>
-<step n="{EXECUTE_STEP}">When executing a menu item: Check menu-handlers section below - extract any attributes from the selected menu item
-  (workflow, exec, tmpl, data, action, validate-workflow) and follow the corresponding handler instructions</step>
-
-<bundled-files critical="MANDATORY">
-  <access-method>
-    All dependencies are bundled within this XML file as &lt;file&gt; elements with CDATA content.
-    When you need to access a file path like "{bmad_folder}/core/tasks/workflow.xml":
-    1. Find the &lt;file id="{bmad_folder}/core/tasks/workflow.xml"&gt; element in this document
-    2. Extract the content from within the CDATA section
-    3. Use that content as if you read it from the filesystem
-  </access-method>
-  <rules>
-    <rule>NEVER attempt to read files from filesystem - all files are bundled in this XML</rule>
-    <rule>File paths starting with "{bmad_folder}/" refer to &lt;file id="..."&gt; elements</rule>
-    <rule>When instructions reference a file path, locate the corresponding &lt;file&gt; element by matching the id attribute</rule>
-    <rule>YAML files are bundled with only their web_bundle section content (flattened to root level)</rule>
-  </rules>
-</bundled-files>
-
-<rules>
-  Stay in character until *exit
-  Number all option lists, use letters for sub-options
-  All file content is bundled in &lt;file&gt; elements - locate by id attribute
-  NEVER attempt filesystem operations - everything is in this XML
-  Menu triggers use asterisk (*) - display exactly as shown
-</rules>

package/src/utility/templates/agent.customize.template.yaml

@@ -1,42 +0,0 @@
-# Agent Customization
-# Customize any section below - all are optional
-# After editing: npx bmad-method build <agent-name>
-
-# Override agent name
-agent:
-  metadata:
-    name: ""
-
-# Replace entire persona (not merged)
-persona:
-  role: ""
-  identity: ""
-  communication_style: ""
-  principles: []
-
-# Add custom critical actions (appended after standard config loading)
-critical_actions: []
-
-# Add persistent memories for the agent
-memories: []
-# Example:
-# memories:
-#   - "User prefers detailed technical explanations"
-#   - "Current project uses React and TypeScript"
-
-# Add custom menu items (appended to base menu)
-# Don't include * prefix or help/exit - auto-injected
-menu: []
-# Example:
-# menu:
-#   - trigger: my-workflow
-#     workflow: "{project-root}/custom/my.yaml"
-#     description: My custom workflow
-
-# Add custom prompts (for action="#id" handlers)
-prompts: []
-# Example:
-# prompts:
-# - id: my-prompt
-#   content: |
-#     Prompt instructions here

package/test/fixtures/agent-schema/invalid/metadata/core-agent-with-module.agent.yaml

@@ -1,26 +0,0 @@
-# Test: Core agent with unexpected module field
-# Expected: FAIL
-# Error code: custom
-# Error path: agent.metadata.module
-# Error message: core agents must not include agent.metadata.module
-# Path context: src/core/agents/core-agent-with-module.agent.yaml
-
-agent:
-  metadata:
-    id: core-with-module
-    name: Core With Module
-    title: Core Agent
-    icon: ❌
-    module: bmm
-
-  persona:
-    role: Test agent
-    identity: Test identity
-    communication_style: Test style
-    principles:
-      - Test principle
-
-  menu:
-    - trigger: help
-      description: Show help
-      action: display_help

package/test/fixtures/agent-schema/invalid/metadata/module-agent-missing-module.agent.yaml

@@ -1,25 +0,0 @@
-# Test: Module agent missing required module field
-# Expected: FAIL
-# Error code: custom
-# Error path: agent.metadata.module
-# Error message: module-scoped agents must declare agent.metadata.module
-# Path context: src/modules/bmm/agents/module-agent-missing-module.agent.yaml
-
-agent:
-  metadata:
-    id: bmm-missing-module
-    name: BMM Missing Module
-    title: Missing Module
-    icon: ❌
-
-  persona:
-    role: Test agent
-    identity: Test identity
-    communication_style: Test style
-    principles:
-      - Test principle
-
-  menu:
-    - trigger: help
-      description: Show help
-      action: display_help

package/test/fixtures/agent-schema/invalid/metadata/wrong-module-value.agent.yaml

@@ -1,26 +0,0 @@
-# Test: Module agent with wrong module value
-# Expected: FAIL
-# Error code: custom
-# Error path: agent.metadata.module
-# Error message: agent.metadata.module must equal "bmm"
-# Path context: src/modules/bmm/agents/wrong-module-value.agent.yaml
-
-agent:
-  metadata:
-    id: wrong-module
-    name: Wrong Module
-    title: Wrong Module
-    icon: ❌
-    module: cis
-
-  persona:
-    role: Test agent
-    identity: Test identity
-    communication_style: Test style
-    principles:
-      - Test principle
-
-  menu:
-    - trigger: help
-      description: Show help
-      action: display_help

package/tools/cli/bundlers/bundle-web.js

@@ -1,179 +0,0 @@
-const { WebBundler } = require('./web-bundler');
-const chalk = require('chalk');
-const { program } = require('commander');
-const path = require('node:path');
-const fs = require('fs-extra');
-
-program.name('bundle-web').description('Generate web bundles for BMAD agents and teams').version('1.0.0');
-
-program
-  .command('all')
-  .description('Bundle all modules')
-  .option('-o, --output <path>', 'Output directory', 'web-bundles')
-  .action(async (options) => {
-    try {
-      const bundler = new WebBundler(null, options.output);
-      await bundler.bundleAll();
-    } catch (error) {
-      console.error(chalk.red('Error:'), error.message);
-      process.exit(1);
-    }
-  });
-
-program
-  .command('rebundle')
-  .description('Clean and rebundle all modules')
-  .option('-o, --output <path>', 'Output directory', 'web-bundles')
-  .action(async (options) => {
-    try {
-      // Clean output directory first
-      const outputDir = path.isAbsolute(options.output) ? options.output : path.join(process.cwd(), options.output);
-
-      if (await fs.pathExists(outputDir)) {
-        console.log(chalk.cyan(`🧹 Cleaning ${options.output}...`));
-        await fs.emptyDir(outputDir);
-      }
-
-      // Bundle all
-      const bundler = new WebBundler(null, options.output);
-      await bundler.bundleAll();
-    } catch (error) {
-      console.error(chalk.red('Error:'), error.message);
-      process.exit(1);
-    }
-  });
-
-program
-  .command('module <name>')
-  .description('Bundle a specific module')
-  .option('-o, --output <path>', 'Output directory', 'web-bundles')
-  .action(async (moduleName, options) => {
-    try {
-      const bundler = new WebBundler(null, options.output);
-      const result = await bundler.bundleModule(moduleName);
-
-      if (result.agents.length === 0 && result.teams.length === 0) {
-        console.log(chalk.yellow(`No agents or teams found in module: ${moduleName}`));
-      } else {
-        console.log(chalk.green(`\n✨ Successfully bundled ${result.agents.length} agents and ${result.teams.length} teams`));
-      }
-    } catch (error) {
-      console.error(chalk.red('Error:'), error.message);
-      process.exit(1);
-    }
-  });
-
-program
-  .command('agent <module> <agent>')
-  .description('Bundle a specific agent')
-  .option('-o, --output <path>', 'Output directory', 'web-bundles')
-  .action(async (moduleName, agentFile, options) => {
-    try {
-      const bundler = new WebBundler(null, options.output);
-
-      // Ensure .md extension
-      if (!agentFile.endsWith('.md')) {
-        agentFile += '.md';
-      }
-
-      // Pre-discover module for complete manifests
-      await bundler.preDiscoverModule(moduleName);
-
-      await bundler.bundleAgent(moduleName, agentFile, false);
-      console.log(chalk.green(`\n✨ Successfully bundled agent: ${agentFile}`));
-    } catch (error) {
-      console.error(chalk.red('Error:'), error.message);
-      process.exit(1);
-    }
-  });
-
-program
-  .command('team <module> <team>')
-  .description('Bundle a specific team')
-  .option('-o, --output <path>', 'Output directory', 'web-bundles')
-  .action(async (moduleName, teamFile, options) => {
-    try {
-      const bundler = new WebBundler(null, options.output);
-
-      // Ensure .yaml or .yml extension
-      if (!teamFile.endsWith('.yaml') && !teamFile.endsWith('.yml')) {
-        teamFile += '.yaml';
-      }
-
-      // Pre-discover module for complete manifests
-      await bundler.preDiscoverModule(moduleName);
-
-      await bundler.bundleTeam(moduleName, teamFile);
-      console.log(chalk.green(`\n✨ Successfully bundled team: ${teamFile}`));
-    } catch (error) {
-      console.error(chalk.red('Error:'), error.message);
-      process.exit(1);
-    }
-  });
-
-program
-  .command('list')
-  .description('List available modules and agents')
-  .action(async () => {
-    try {
-      const bundler = new WebBundler();
-      const modules = await bundler.discoverModules();
-
-      console.log(chalk.cyan.bold('\n📦 Available Modules:\n'));
-
-      for (const module of modules) {
-        console.log(chalk.bold(`  ${module}/`));
-
-        const modulePath = path.join(bundler.modulesPath, module);
-        const agents = await bundler.discoverAgents(modulePath);
-        const teams = await bundler.discoverTeams(modulePath);
-
-        if (agents.length > 0) {
-          console.log(chalk.gray('    agents/'));
-          for (const agent of agents) {
-            console.log(chalk.gray(`      - ${agent}`));
-          }
-        }
-
-        if (teams.length > 0) {
-          console.log(chalk.gray('    teams/'));
-          for (const team of teams) {
-            console.log(chalk.gray(`      - ${team}`));
-          }
-        }
-      }
-
-      console.log('');
-    } catch (error) {
-      console.error(chalk.red('Error:'), error.message);
-      process.exit(1);
-    }
-  });
-
-program
-  .command('clean')
-  .description('Remove all web bundles')
-  .action(async () => {
-    try {
-      const fs = require('fs-extra');
-      const outputDir = path.join(process.cwd(), 'web-bundles');
-
-      if (await fs.pathExists(outputDir)) {
-        await fs.remove(outputDir);
-        console.log(chalk.green('✓ Web bundles directory cleaned'));
-      } else {
-        console.log(chalk.yellow('Web bundles directory does not exist'));
-      }
-    } catch (error) {
-      console.error(chalk.red('Error:'), error.message);
-      process.exit(1);
-    }
-  });
-
-// Parse command line arguments
-program.parse(process.argv);
-
-// Show help if no command provided
-if (process.argv.slice(2).length === 0) {
-  program.outputHelp();
-}

package/tools/cli/bundlers/test-analyst.js

@@ -1,28 +0,0 @@
-const { WebBundler } = require('./web-bundler');
-const chalk = require('chalk');
-const path = require('node:path');
-
-async function testAnalystBundle() {
-  console.log(chalk.cyan.bold('\n🧪 Testing Analyst Agent Bundle\n'));
-
-  try {
-    const bundler = new WebBundler();
-
-    // Load web activation first
-    await bundler.loadWebActivation();
-
-    // Bundle just the analyst agent from bmm module
-    // Only bundle the analyst for testing
-    const agentPath = path.join(bundler.modulesPath, 'bmm', 'agents', 'analyst.md');
-    await bundler.bundleAgent('bmm', 'analyst.md');
-
-    console.log(chalk.green.bold('\n✅ Test completed successfully!\n'));
-  } catch (error) {
-    console.error(chalk.red('\n❌ Test failed:'), error.message);
-    console.error(error.stack);
-    process.exit(1);
-  }
-}
-
-// Run test
-testAnalystBundle();

package/tools/cli/bundlers/test-bundler.js

@@ -1,118 +0,0 @@
-const { WebBundler } = require('./web-bundler');
-const chalk = require('chalk');
-const fs = require('fs-extra');
-const path = require('node:path');
-
-async function testWebBundler() {
-  console.log(chalk.cyan.bold('\n🧪 Testing Web Bundler\n'));
-
-  const bundler = new WebBundler();
-  let passedTests = 0;
-  let failedTests = 0;
-
-  // Test 1: Load web activation
-  try {
-    await bundler.loadWebActivation();
-    console.log(chalk.green('✓ Web activation loaded successfully'));
-    passedTests++;
-  } catch (error) {
-    console.error(chalk.red('✗ Failed to load web activation:'), error.message);
-    failedTests++;
-  }
-
-  // Test 2: Discover modules
-  try {
-    const modules = await bundler.discoverModules();
-    console.log(chalk.green(`✓ Discovered ${modules.length} modules:`, modules.join(', ')));
-    passedTests++;
-  } catch (error) {
-    console.error(chalk.red('✗ Failed to discover modules:'), error.message);
-    failedTests++;
-  }
-
-  // Test 3: Bundle analyst agent
-  try {
-    const result = await bundler.bundleAgent('bmm', 'analyst.md');
-
-    // Check if bundle was created
-    const bundlePath = path.join(bundler.outputDir, 'bmm', 'agents', 'analyst.xml');
-    if (await fs.pathExists(bundlePath)) {
-      const content = await fs.readFile(bundlePath, 'utf8');
-
-      // Validate bundle structure
-      const hasAgent = content.includes('<agent');
-      const hasActivation = content.includes('<activation');
-      const hasPersona = content.includes('<persona>');
-      const activationBeforePersona = content.indexOf('<activation') < content.indexOf('<persona>');
-      const hasManifests =
-        content.includes('<agent-party id="bmad/_cfg/agent-manifest.csv">') && content.includes('<manifest id="bmad/web-manifest.xml">');
-      const hasDependencies = content.includes('<dependencies>');
-
-      console.log(chalk.green('✓ Analyst bundle created successfully'));
-      console.log(chalk.gray(`  - Has agent tag: ${hasAgent ? '✓' : '✗'}`));
-      console.log(chalk.gray(`  - Has activation: ${hasActivation ? '✓' : '✗'}`));
-      console.log(chalk.gray(`  - Has persona: ${hasPersona ? '✓' : '✗'}`));
-      console.log(chalk.gray(`  - Activation before persona: ${activationBeforePersona ? '✓' : '✗'}`));
-      console.log(chalk.gray(`  - Has manifests: ${hasManifests ? '✓' : '✗'}`));
-      console.log(chalk.gray(`  - Has dependencies: ${hasDependencies ? '✓' : '✗'}`));
-
-      if (hasAgent && hasActivation && hasPersona && activationBeforePersona && hasManifests && hasDependencies) {
-        passedTests++;
-      } else {
-        console.error(chalk.red('✗ Bundle structure validation failed'));
-        failedTests++;
-      }
-    } else {
-      console.error(chalk.red('✗ Bundle file not created'));
-      failedTests++;
-    }
-  } catch (error) {
-    console.error(chalk.red('✗ Failed to bundle analyst agent:'), error.message);
-    failedTests++;
-  }
-
-  // Test 4: Bundle a different agent (architect which exists)
-  try {
-    const result = await bundler.bundleAgent('bmm', 'architect.md');
-    const bundlePath = path.join(bundler.outputDir, 'bmm', 'agents', 'architect.xml');
-
-    if (await fs.pathExists(bundlePath)) {
-      console.log(chalk.green('✓ Architect bundle created successfully'));
-      passedTests++;
-    } else {
-      console.error(chalk.red('✗ Architect bundle file not created'));
-      failedTests++;
-    }
-  } catch (error) {
-    console.error(chalk.red('✗ Failed to bundle architect agent:'), error.message);
-    failedTests++;
-  }
-
-  // Test 5: Bundle all agents in a module
-  try {
-    const results = await bundler.bundleModule('bmm');
-    console.log(chalk.green(`✓ Bundled ${results.agents.length} agents from bmm module`));
-    passedTests++;
-  } catch (error) {
-    console.error(chalk.red('✗ Failed to bundle bmm module:'), error.message);
-    failedTests++;
-  }
-
-  // Summary
-  console.log(chalk.bold('\n📊 Test Results:'));
-  console.log(chalk.green(`  Passed: ${passedTests}`));
-  console.log(chalk.red(`  Failed: ${failedTests}`));
-
-  if (failedTests === 0) {
-    console.log(chalk.green.bold('\n✅ All tests passed!\n'));
-  } else {
-    console.log(chalk.red.bold(`\n❌ ${failedTests} test(s) failed\n`));
-    process.exit(1);
-  }
-}
-
-// Run tests
-testWebBundler().catch((error) => {
-  console.error(chalk.red('Fatal error:'), error);
-  process.exit(1);
-});