bmad-method 6.0.0-alpha.10 → 6.0.0-alpha.12

package/tools/cli/lib/agent/template-engine.js

@@ -0,0 +1,152 @@
+/**
+ * Template Engine for BMAD Agent Install Configuration
+ * Processes {{variable}}, {{#if}}, {{#unless}}, and {{/if}} blocks
+ */
+
+/**
+ * Process all template syntax in a string
+ * @param {string} content - Content with template syntax
+ * @param {Object} variables - Key-value pairs from install_config answers
+ * @returns {string} Processed content
+ */
+function processTemplate(content, variables = {}) {
+  let result = content;
+
+  // Process conditionals first (they may contain variables)
+  result = processConditionals(result, variables);
+
+  // Then process simple variable replacements
+  result = processVariables(result, variables);
+
+  // Clean up any empty lines left by removed conditionals
+  result = cleanupEmptyLines(result);
+
+  return result;
+}
+
+/**
+ * Process {{#if}}, {{#unless}}, {{/if}}, {{/unless}} blocks
+ */
+function processConditionals(content, variables) {
+  let result = content;
+
+  // Process {{#if variable == "value"}} blocks
+  // Handle both regular quotes and JSON-escaped quotes (\")
+  const ifEqualsPattern = /\{\{#if\s+(\w+)\s*==\s*\\?"([^"\\]+)\\?"\s*\}\}([\s\S]*?)\{\{\/if\}\}/g;
+  result = result.replaceAll(ifEqualsPattern, (match, varName, value, block) => {
+    return variables[varName] === value ? block : '';
+  });
+
+  // Process {{#if variable}} blocks (boolean or truthy check)
+  const ifBoolPattern = /\{\{#if\s+(\w+)\s*\}\}([\s\S]*?)\{\{\/if\}\}/g;
+  result = result.replaceAll(ifBoolPattern, (match, varName, block) => {
+    const val = variables[varName];
+    // Treat as truthy: true, non-empty string, non-zero number
+    const isTruthy = val === true || (typeof val === 'string' && val.length > 0) || (typeof val === 'number' && val !== 0);
+    return isTruthy ? block : '';
+  });
+
+  // Process {{#unless variable}} blocks (inverse of if)
+  const unlessPattern = /\{\{#unless\s+(\w+)\s*\}\}([\s\S]*?)\{\{\/unless\}\}/g;
+  result = result.replaceAll(unlessPattern, (match, varName, block) => {
+    const val = variables[varName];
+    const isFalsy = val === false || val === '' || val === null || val === undefined || val === 0;
+    return isFalsy ? block : '';
+  });
+
+  return result;
+}
+
+/**
+ * Process {{variable}} replacements
+ */
+function processVariables(content, variables) {
+  let result = content;
+
+  // Replace {{variable}} with value
+  const varPattern = /\{\{(\w+)\}\}/g;
+  result = result.replaceAll(varPattern, (match, varName) => {
+    if (Object.hasOwn(variables, varName)) {
+      return String(variables[varName]);
+    }
+    // If variable not found, leave as-is (might be runtime variable like {user_name})
+    return match;
+  });
+
+  return result;
+}
+
+/**
+ * Clean up excessive empty lines left after removing conditional blocks
+ */
+function cleanupEmptyLines(content) {
+  // Replace 3+ consecutive newlines with 2
+  return content.replaceAll(/\n{3,}/g, '\n\n');
+}
+
+/**
+ * Extract install_config from agent YAML object
+ * @param {Object} agentYaml - Parsed agent YAML
+ * @returns {Object|null} install_config section or null
+ */
+function extractInstallConfig(agentYaml) {
+  return agentYaml?.agent?.install_config || null;
+}
+
+/**
+ * Remove install_config from agent YAML (after processing)
+ * @param {Object} agentYaml - Parsed agent YAML
+ * @returns {Object} Agent YAML without install_config
+ */
+function stripInstallConfig(agentYaml) {
+  const result = structuredClone(agentYaml);
+  if (result.agent) {
+    delete result.agent.install_config;
+  }
+  return result;
+}
+
+/**
+ * Process entire agent YAML object with template variables
+ * @param {Object} agentYaml - Parsed agent YAML
+ * @param {Object} variables - Answers from install_config questions
+ * @returns {Object} Processed agent YAML
+ */
+function processAgentYaml(agentYaml, variables) {
+  // Convert to JSON string, process templates, parse back
+  const jsonString = JSON.stringify(agentYaml, null, 2);
+  const processed = processTemplate(jsonString, variables);
+  return JSON.parse(processed);
+}
+
+/**
+ * Get default values from install_config questions
+ * @param {Object} installConfig - install_config section
+ * @returns {Object} Default values keyed by variable name
+ */
+function getDefaultValues(installConfig) {
+  const defaults = {};
+
+  if (!installConfig?.questions) {
+    return defaults;
+  }
+
+  for (const question of installConfig.questions) {
+    if (question.var && question.default !== undefined) {
+      defaults[question.var] = question.default;
+    }
+  }
+
+  return defaults;
+}
+
+module.exports = {
+  processTemplate,
+  processConditionals,
+  processVariables,
+  extractInstallConfig,
+  stripInstallConfig,
+  processAgentYaml,
+  getDefaultValues,
+  cleanupEmptyLines,
+};

package/docs/installers-bundlers/web-bundler-usage.md

@@ -1,54 +0,0 @@
-# Web Bundler Usage
-
-ALPHA NOTE: Bundling of individual agents might work, team bundling is being reworked and will come with Beta release soon.
-
-The web bundler creates self-contained XML bundles for BMAD agents, packaging all dependencies for web deployment.
-
-## Quick Start
-
-```bash
-# Bundle all agents from all modules
-npm run bundle
-
-# Clean and rebundle (removes old bundles first)
-npm run rebundle
-```
-
-## Custom Output Directory
-
-```bash
-# Bundle to custom directory
-node tools/cli/bundlers/bundle-web.js all --output ./my-bundles
-
-# Rebundle to custom directory (auto-cleans first)
-node tools/cli/bundlers/bundle-web.js rebundle --output /absolute/path/to/custom/directory
-
-# Bundle specific module to custom directory
-node tools/cli/bundlers/bundle-web.js module bmm --output ./custom-folder
-
-# Bundle specific agent to custom directory
-node tools/cli/bundlers/bundle-web.js agent bmm analyst -o ./custom-folder
-```
-
-## Output
-
-Bundles are generated in `web-bundles/` directory by default when run from the root of the clones project:
-
-```
-web-bundles/
-├── [module-name]/
-│   └── agents/
-│       └── [agent-name].xml
-```
-
-## Skipping Agents
-
-Agents with `bundle="false"` attribute are automatically skipped during bundling.
-
-## Bundle Contents
-
-Each bundle includes:
-
-- Agent definition with web activation
-- All resolved dependencies
-- Manifests for agent/team discovery

package/src/modules/bmb/workflows/create-agent/README.md

@@ -1,203 +0,0 @@
-# Create Agent Workflow
-
-Interactive agent builder creating BMad Core compliant agents as YAML source files that compile to .md during installation.
-
-## Table of Contents
-
-- [Quick Start](#quick-start)
-- [Agent Types](#agent-types)
-- [Workflow Phases](#workflow-phases)
-- [Output Structure](#output-structure)
-- [Installation](#installation)
-- [Examples](#examples)
-
-## Quick Start
-
-```bash
-# Direct workflow
-workflow create-agent
-
-# Via BMad Builder
-*create-agent
-```
-
-## Agent Types
-
-### Simple Agent
-
-- Self-contained functionality
-- Basic command structure
-- No external resources
-
-### Expert Agent
-
-- Sidecar resources for domain knowledge
-- Extended capabilities
-- Knowledge base integration
-
-### Module Agent
-
-- Full-featured with workflows
-- Module-specific commands
-- Integrated with module structure
-
-## Workflow Phases
-
-### Phase 0: Optional Brainstorming
-
-- Creative ideation session
-- Explore concepts and personalities
-- Generate command ideas
-- Output feeds into persona development
-
-### Phase 1: Agent Setup
-
-1. Choose agent type (Simple/Expert/Module)
-2. Define identity (name, title, icon, filename)
-3. Assign to module (if Module agent)
-
-### Phase 2: Persona Development
-
-- Define role and responsibilities
-- Craft unique identity/backstory
-- Select communication style
-- Establish guiding principles
-- Add critical actions (optional)
-
-### Phase 3: Command Building
-
-- Add required commands (*help, *exit)
-- Define workflow commands
-- Add task commands
-- Create action commands
-- Configure attributes
-
-### Phase 4: Finalization
-
-- Generate .agent.yaml file
-- Create customize file (optional)
-- Setup sidecar resources (Expert agents)
-- Validate and compile
-- Provide usage instructions
-
-## Output Structure
-
-### Generated Files
-
-**Standalone Agents:**
-
-- Source: `{bmad_folder}/agents/{filename}.agent.yaml`
-- Compiled: `{bmad_folder}/agents/{filename}.md`
-
-**Module Agents:**
-
-- Source: `src/modules/{module}/agents/{filename}.agent.yaml`
-- Compiled: `{bmad_folder}/{module}/agents/{filename}.md`
-
-### YAML Structure
-
-```yaml
-agent:
-  metadata:
-    id: {bmad_folder}/{module}/agents/{filename}.md
-    name: Agent Name
-    title: Agent Title
-    icon: 🤖
-    module: module-name
-  persona:
-    role: '...'
-    identity: '...'
-    communication_style: '...'
-    principles: ['...', '...']
-  menu:
-    - trigger: command-name
-      workflow: path/to/workflow.yaml
-      description: Command description
-```
-
-### Optional Customize File
-
-Location: `{bmad_folder}/_cfg/agents/{module}-{filename}.customize.yaml`
-
-Allows persona and menu overrides that persist through updates.
-
-## Installation
-
-### Compilation Methods
-
-**Quick Rebuild:**
-
-```bash
-bmad compile-agents
-```
-
-**During Module Install:**
-Automatic compilation when installing modules
-
-**Manual Compilation:**
-
-```bash
-node tools/cli/bmad-cli.js compile-agents
-```
-
-## Examples
-
-### Creating a Code Review Agent
-
-```
-User: I need a code review agent
-Builder: Let's brainstorm first...
-
-[Brainstorming generates ideas for strict vs friendly reviewer]
-
-Builder: Now let's build your agent:
-- Type: Simple
-- Name: Code Reviewer
-- Role: Senior developer conducting thorough reviews
-- Style: Professional but approachable
-- Commands:
-  - *review-pr: Review pull request
-  - *review-file: Review single file
-  - *review-standards: Check coding standards
-```
-
-### Creating a Domain Expert
-
-```
-Type: Expert
-Name: Legal Advisor
-Sidecar: legal-knowledge/
-Commands:
-  - *contract-review
-  - *compliance-check
-  - *risk-assessment
-```
-
-## Workflow Files
-
-```
-create-agent/
-├── workflow.yaml              # Configuration
-├── instructions.md            # Step guide
-├── checklist.md              # Validation
-├── README.md                 # This file
-├── agent-types.md            # Type details
-├── agent-architecture.md     # Patterns
-├── agent-command-patterns.md # Commands
-└── communication-styles.md   # Styles
-```
-
-## Best Practices
-
-1. **Use brainstorming** for complex agents
-2. **Start simple** - Add commands incrementally
-3. **Test commands** before finalizing
-4. **Document thoroughly** in descriptions
-5. **Follow naming conventions** consistently
-
-## Related Documentation
-
-- [Agent Types](./agent-types.md)
-- [Command Patterns](./agent-command-patterns.md)
-- [Communication Styles](./communication-styles.md)
-- [BMB Module](../../README.md)