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

package/tools/bmad-npx-wrapper.js

@@ -3,7 +3,6 @@
 /**
  * BMad Method CLI - Direct execution wrapper for npx
  * This file ensures proper execution when run via npx from GitHub or npm registry
- * Supports version selection between stable (v4) and beta (v6)
  */
 
 const { execSync } = require('node:child_process');
@@ -13,114 +12,27 @@ const fs = require('node:fs');
 // Check if we're running in an npx temporary directory
 const isNpxExecution = __dirname.includes('_npx') || __dirname.includes('.npm');
 
-async function promptVersionSelection() {
-  const inquirer = require('inquirer');
-  const chalk = require('chalk');
-
-  console.log(
-    chalk.cyan(`
-    ██████╗ ███╗   ███╗ █████╗ ██████╗ ™
-    ██╔══██╗████╗ ████║██╔══██╗██╔══██╗
-    ██████╔╝██╔████╔██║███████║██║  ██║
-    ██╔══██╗██║╚██╔╝██║██╔══██║██║  ██║
-    ██████╔╝██║ ╚═╝ ██║██║  ██║██████╔╝
-    ╚═════╝ ╚═╝     ╚═╝╚═╝  ╚═╝╚═════╝
-  `),
-  );
-
-  console.log(chalk.dim('    Build More, Architect Dreams\n'));
-
-  const answers = await inquirer.prompt([
-    {
-      type: 'list',
-      name: 'version',
-      message: 'Which version would you like to install?',
-      choices: [
-        {
-          name: chalk.green('Stable (v4.x) - Production Ready'),
-          value: 'stable',
-          short: 'Stable v4.x',
-        },
-        {
-          name: chalk.yellow('Beta (v6.0.0-beta) - Latest Features (Early Access)'),
-          value: 'beta',
-          short: 'Beta v6.0.0-beta',
-        },
-      ],
-      default: 'stable',
-    },
-  ]);
-
-  return answers.version;
-}
-
-async function installStableVersion(args) {
-  const chalk = require('chalk');
-
-  console.log(chalk.cyan('\n📦 Installing BMad Method v4 (Stable)...\n'));
-
-  // Use npx to install the stable version from npm registry
-  // The @4 tag will fetch the latest v4.x.x version
-  const npxCommand = `npx bmad-method@4 ${args.join(' ')}`;
-
-  try {
-    execSync(npxCommand, {
-      stdio: 'inherit',
-      cwd: process.cwd(),
-    });
-  } catch (error) {
-    console.error(chalk.red('Failed to install stable version'));
-    process.exit(error.status || 1);
-  }
-}
-
-async function installBetaVersion(args) {
-  const chalk = require('chalk');
-
-  console.log(chalk.yellow('\n📦 Installing BMad Method v6 Beta (Early Access)...\n'));
-
-  // Use the v6 installer from the current installation
+if (isNpxExecution) {
+  // Running via npx - spawn child process to preserve user's working directory
+  const args = process.argv.slice(2);
   const bmadCliPath = path.join(__dirname, 'cli', 'bmad-cli.js');
 
   if (!fs.existsSync(bmadCliPath)) {
-    console.error(chalk.red('Error: Could not find bmad-cli.js at'), bmadCliPath);
-    console.error(chalk.dim('Current directory:'), __dirname);
+    console.error('Error: Could not find bmad-cli.js at', bmadCliPath);
+    console.error('Current directory:', __dirname);
     process.exit(1);
   }
 
   try {
+    // Execute CLI from user's working directory (process.cwd()), not npm cache
     execSync(`node "${bmadCliPath}" ${args.join(' ')}`, {
       stdio: 'inherit',
-      cwd: path.dirname(__dirname),
+      cwd: process.cwd(), // This preserves the user's working directory
     });
   } catch (error) {
     process.exit(error.status || 1);
   }
+} else {
+  // Local execution - use require
+  require('./cli/bmad-cli.js');
 }
-
-async function main() {
-  const args = process.argv.slice(2);
-
-  // Check if user wants to skip version prompt
-  const skipPrompt = args.includes('--skip-version-prompt');
-  const filteredArgs = args.filter((arg) => arg !== '--skip-version-prompt');
-
-  if (isNpxExecution && !skipPrompt) {
-    // Running via npx - prompt for version selection unless skipped
-    const selectedVersion = await promptVersionSelection();
-
-    if (selectedVersion === 'stable') {
-      await installStableVersion(filteredArgs);
-    } else {
-      await installBetaVersion(filteredArgs);
-    }
-  } else {
-    // Local execution or skipped prompt - use the v6 installer directly
-    require('./cli/bmad-cli.js');
-  }
-}
-
-main().catch((error) => {
-  console.error('Unexpected error:', error);
-  process.exit(1);
-});

package/tools/cli/README.md

@@ -4,19 +4,37 @@ The BMad CLI handles installation and web bundling for the BMAD-METHOD framework
 
 ## Table of Contents
 
-- [Overview](#overview)
-- [Commands](#commands)
-- [Installation System](#installation-system)
-  - [Installation Flow](#installation-flow)
-  - [IDE Support](#ide-support)
-  - [Custom Module Configuration](#custom-module-configuration)
-  - [Platform Specifics](#platform-specifics)
-  - [Manifest System](#manifest-system)
-  - [Advanced Features](#advanced-features)
-- [Bundling System](#bundling-system)
-- [Agent Compilation](#agent-compilation)
-- [Architecture](#architecture)
-- [Key Differences: Installation vs Bundling](#key-differences-installation-vs-bundling)
+- [BMad CLI Tool](#bmad-cli-tool)
+  - [Table of Contents](#table-of-contents)
+  - [Overview](#overview)
+  - [Commands](#commands)
+    - [Installation](#installation)
+    - [Bundling](#bundling)
+    - [Utilities](#utilities)
+  - [Installation System](#installation-system)
+    - [Installation Flow](#installation-flow)
+    - [IDE Support](#ide-support)
+    - [Custom Module Configuration](#custom-module-configuration)
+    - [Platform Specifics](#platform-specifics)
+    - [Manifest System](#manifest-system)
+    - [Advanced Features](#advanced-features)
+  - [Bundling System](#bundling-system)
+    - [Bundling Flow](#bundling-flow)
+  - [Agent Compilation](#agent-compilation)
+    - [Compilation Engine](#compilation-engine)
+    - [Fragment System](#fragment-system)
+    - [Input: Agent YAML](#input-agent-yaml)
+    - [Output: IDE (Markdown with XML)](#output-ide-markdown-with-xml)
+  - [Architecture](#architecture)
+    - [Directory Structure](#directory-structure)
+    - [Fragment Library](#fragment-library)
+  - [Key Differences: Installation vs Bundling](#key-differences-installation-vs-bundling)
+  - [Development Workflows](#development-workflows)
+    - [Testing Compilation](#testing-compilation)
+    - [Adding New Menu Handlers](#adding-new-menu-handlers)
+    - [Regenerating Manifests](#regenerating-manifests)
+  - [Related Documentation](#related-documentation)
+  - [Support](#support)
 
 ---
 
@@ -87,7 +105,7 @@ The installer is a multi-stage system that handles agent compilation, IDE integr
    - Resolve module dependencies (4-pass system)
 
 3. Install Core + Modules
-   - Copy files to {target}/bmad/
+   - Copy files to {target}/{bmad_folder}/
    - Compile agents: YAML → Markdown/XML (forWebBundle: false)
    - Merge customize.yaml files if they exist
    - Inject activation blocks based on agent capabilities
@@ -113,7 +131,7 @@ The installer is a multi-stage system that handles agent compilation, IDE integr
 
 ```
 {target}/
-├── bmad/
+├── {bmad_folder}/
 │   ├── core/              # Always installed
 │   ├── {module}/          # Selected modules
 │   │   ├── agents/        # Compiled .md files
@@ -220,7 +238,7 @@ Platform specifics are **IDE+module combination hooks** that execute custom logi
 
 ### Manifest System
 
-The installer generates **5 manifest files** in `{target}/bmad/_cfg/`:
+The installer generates **5 manifest files** in `{target}/{bmad_folder}/_cfg/`:
 
 **1. Installation Manifest** (`manifest.yaml`)
 
@@ -409,7 +427,7 @@ agent:
     identity: 'You are an experienced PM...'
   menu:
     - trigger: '*create-brief'
-      workflow: '{project-root}/bmad/bmm/workflows/.../workflow.yaml'
+      workflow: '{project-root}/{bmad_folder}/bmm/workflows/.../workflow.yaml'
 ```
 
 ### Output: IDE (Markdown with XML)
@@ -422,7 +440,7 @@ agent:
 ```xml
 <agent id="..." name="PM">
   <activation critical="MANDATORY">
-    <step n="2">Load {project-root}/bmad/bmm/config.yaml at runtime</step>
+    <step n="2">Load {project-root}/{bmad_folder}/bmm/config.yaml at runtime</step>
     ...
   </activation>
   <persona>...</persona>
@@ -514,20 +532,20 @@ src/utility/models/fragments/
 
 ## Key Differences: Installation vs Bundling
 
-| Aspect                  | Installation (IDE)            | Bundling (Web)                    |
-| ----------------------- | ----------------------------- | --------------------------------- |
-| **Trigger**             | `npm run install:bmad`        | `npm run bundle`                  |
-| **Entry Point**         | `commands/install.js`         | `bundlers/bundle-web.js`          |
-| **Compiler Flag**       | `forWebBundle: false`         | `forWebBundle: true`              |
-| **Output Format**       | Markdown `.md`                | Standalone XML `.xml`             |
-| **Output Location**     | `{target}/bmad/` + IDE dirs   | `web-bundles/`                    |
-| **Customization**       | Merges `customize.yaml`       | Base agents only                  |
-| **Dependencies**        | Referenced by path            | Bundled inline (CDATA)            |
-| **Activation Fragment** | `activation-steps.xml`        | `web-bundle-activation-steps.xml` |
-| **Filesystem Access**   | Required                      | Not needed                        |
-| **Build Metadata**      | Included (hash)               | Excluded                          |
-| **Path Format**         | `{project-root}` placeholders | Stripped, wrapped as `<file>`     |
-| **Use Case**            | Local IDE development         | Web deployment                    |
+| Aspect                  | Installation (IDE)                   | Bundling (Web)                    |
+| ----------------------- | ------------------------------------ | --------------------------------- |
+| **Trigger**             | `npm run install:bmad`               | `npm run bundle`                  |
+| **Entry Point**         | `commands/install.js`                | `bundlers/bundle-web.js`          |
+| **Compiler Flag**       | `forWebBundle: false`                | `forWebBundle: true`              |
+| **Output Format**       | Markdown `.md`                       | Standalone XML `.xml`             |
+| **Output Location**     | `{target}/{bmad_folder}/` + IDE dirs | `web-bundles/`                    |
+| **Customization**       | Merges `customize.yaml`              | Base agents only                  |
+| **Dependencies**        | Referenced by path                   | Bundled inline (CDATA)            |
+| **Activation Fragment** | `activation-steps.xml`               | `web-bundle-activation-steps.xml` |
+| **Filesystem Access**   | Required                             | Not needed                        |
+| **Build Metadata**      | Included (hash)                      | Excluded                          |
+| **Path Format**         | `{project-root}` placeholders        | Stripped, wrapped as `<file>`     |
+| **Use Case**            | Local IDE development                | Web deployment                    |
 
 **Activation Differences**: