bmad-method 5.1.3 → 6.0.0-Beta.0

package/tools/cli/commands/install.js

@@ -0,0 +1,87 @@
+const chalk = require('chalk');
+const path = require('node:path');
+const { Installer } = require('../installers/lib/core/installer');
+const { UI } = require('../lib/ui');
+
+const installer = new Installer();
+const ui = new UI();
+
+module.exports = {
+  command: 'install',
+  description: 'Install BMAD Core agents and tools',
+  options: [['-d, --debug', 'Enable debug output for manifest generation']],
+  action: async (options) => {
+    try {
+      // Set debug flag as environment variable for all components
+      if (options.debug) {
+        process.env.BMAD_DEBUG_MANIFEST = 'true';
+        console.log(chalk.cyan('Debug mode enabled\n'));
+      }
+
+      const config = await ui.promptInstall();
+
+      // Handle cancel
+      if (config.actionType === 'cancel') {
+        console.log(chalk.yellow('Installation cancelled.'));
+        process.exit(0);
+        return;
+      }
+
+      // Handle quick update separately
+      if (config.actionType === 'quick-update') {
+        const result = await installer.quickUpdate(config);
+        console.log(chalk.green('\n✨ Quick update complete!'));
+        console.log(chalk.cyan(`Updated ${result.moduleCount} modules with preserved settings (${result.modules.join(', ')})`));
+
+        // Display version-specific end message
+        const { MessageLoader } = require('../installers/lib/message-loader');
+        const messageLoader = new MessageLoader();
+        messageLoader.displayEndMessage();
+
+        process.exit(0);
+        return;
+      }
+
+      // Handle compile agents separately
+      if (config.actionType === 'compile-agents') {
+        const result = await installer.compileAgents(config);
+        console.log(chalk.green('\n✨ Agent recompilation complete!'));
+        console.log(chalk.cyan(`Recompiled ${result.agentCount} agents with customizations applied`));
+        process.exit(0);
+        return;
+      }
+
+      // Regular install/update flow
+      const result = await installer.install(config);
+
+      // Check if installation was cancelled
+      if (result && result.cancelled) {
+        process.exit(0);
+        return;
+      }
+
+      // Check if installation succeeded
+      if (result && result.success) {
+        // Display version-specific end message from install-messages.yaml
+        const { MessageLoader } = require('../installers/lib/message-loader');
+        const messageLoader = new MessageLoader();
+        messageLoader.displayEndMessage();
+
+        process.exit(0);
+      }
+    } catch (error) {
+      // Check if error has a complete formatted message
+      if (error.fullMessage) {
+        console.error(error.fullMessage);
+        if (error.stack) {
+          console.error('\n' + chalk.dim(error.stack));
+        }
+      } else {
+        // Generic error handling for all other errors
+        console.error(chalk.red('Installation failed:'), error.message);
+        console.error(chalk.dim(error.stack));
+      }
+      process.exit(1);
+    }
+  },
+};

package/tools/cli/commands/status.js

@@ -0,0 +1,65 @@
+const chalk = require('chalk');
+const path = require('node:path');
+const { Installer } = require('../installers/lib/core/installer');
+const { Manifest } = require('../installers/lib/core/manifest');
+const { UI } = require('../lib/ui');
+
+const installer = new Installer();
+const manifest = new Manifest();
+const ui = new UI();
+
+module.exports = {
+  command: 'status',
+  description: 'Display BMAD installation status and module versions',
+  options: [],
+  action: async (options) => {
+    try {
+      // Find the bmad directory
+      const projectDir = process.cwd();
+      const { bmadDir } = await installer.findBmadDir(projectDir);
+
+      // Check if bmad directory exists
+      const fs = require('fs-extra');
+      if (!(await fs.pathExists(bmadDir))) {
+        console.log(chalk.yellow('No BMAD installation found in the current directory.'));
+        console.log(chalk.dim(`Expected location: ${bmadDir}`));
+        console.log(chalk.dim('\nRun "bmad install" to set up a new installation.'));
+        process.exit(0);
+        return;
+      }
+
+      // Read manifest
+      const manifestData = await manifest._readRaw(bmadDir);
+
+      if (!manifestData) {
+        console.log(chalk.yellow('No BMAD installation manifest found.'));
+        console.log(chalk.dim('\nRun "bmad install" to set up a new installation.'));
+        process.exit(0);
+        return;
+      }
+
+      // Get installation info
+      const installation = manifestData.installation || {};
+      const modules = manifestData.modules || [];
+
+      // Check for available updates (only for external modules)
+      const availableUpdates = await manifest.checkForUpdates(bmadDir);
+
+      // Display status
+      ui.displayStatus({
+        installation,
+        modules,
+        availableUpdates,
+        bmadDir,
+      });
+
+      process.exit(0);
+    } catch (error) {
+      console.error(chalk.red('Status check failed:'), error.message);
+      if (process.env.BMAD_DEBUG) {
+        console.error(chalk.dim(error.stack));
+      }
+      process.exit(1);
+    }
+  },
+};

package/tools/cli/external-official-modules.yaml

@@ -0,0 +1,44 @@
+# This file allows these modules under bmad-code-org to also be installed with the bmad method installer, while
+# allowing us to keep the source of these projects in separate repos.
+
+modules:
+  bmad-builder:
+    url: https://github.com/bmad-code-org/bmad-builder
+    module-definition: src/module.yaml
+    code: bmb
+    name: "BMad Builder"
+    description: "Agent, Workflow and Module Builder"
+    defaultSelected: false
+    type: bmad-org
+    npmPackage: bmad-builder
+
+  bmad-creative-intelligence-suite:
+    url: https://github.com/bmad-code-org/bmad-module-creative-intelligence-suite
+    module-definition: src/module.yaml
+    code: cis
+    name: "BMad Creative Innovation Suite"
+    description: "Creative tools for writing, brainstorming, and more"
+    defaultSelected: false
+    type: bmad-org
+    npmPackage: bmad-creative-intelligence-suite
+
+  bmad-game-dev-studio:
+    url: https://github.com/bmad-code-org/bmad-module-game-dev-studio.git
+    module-definition: src/module.yaml
+    code: gds
+    name: "BMad Game Dev Suite"
+    description: "Game development agents and workflows"
+    defaultSelected: false
+    type: bmad-org
+    npmPackage: bmad-game-dev-studio
+
+# TODO: Enable once fixes applied:
+
+# whiteport-design-system:
+#   url: https://github.com/bmad-code-org/bmad-method-wds-expansion
+#   module-definition: src/module.yaml
+#   code: WDS
+#   name: "Whiteport UX Design System"
+#   description: "UX design framework with Figma integration"
+#   defaultSelected: false
+#   type: community

package/tools/cli/installers/install-messages.yaml

@@ -0,0 +1,58 @@
+# BMAD Installer Messages
+# These messages are displayed during installation
+# Edit this file to change what users see during the install process
+
+# Display at the START of installation (after logo, before prompts)
+startMessage: |
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  ⭐ IMPORTANT: Version Alpha.23 Changes
+
+  If your current version is older than Alpha.21, you'll need a fresh install:
+    - Remove .bmad folder and reinstall
+    - Only needed during final push to beta (ETA January 18th)
+
+  📚 New Docs Site: http://docs.bmad-method.org/
+    - Tons of guides and articles coming soon!
+    - Everything is free. No paywalls. No gated content.
+    - Knowledge should be shared, not sold.
+
+  📺 YouTube Master Class & Podcast launching February 1st!
+
+  💡 Love BMad? Please star us on GitHub & subscribe on YouTube!
+    - GitHub: https://github.com/bmad-code-org/BMAD-METHOD/
+    - YouTube: https://www.youtube.com/@BMadCode
+
+  Latest updates: https://github.com/bmad-code-org/BMAD-METHOD/blob/main/CHANGELOG.md
+
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+# Display at the END of installation (after all setup completes)
+endMessage: |
+  ════════════════════════════════════════════════════════════════════════════════
+
+  ✨ BMAD IS READY! Beta is just days away! Thank you for your support!
+
+  🌟 BMad is 100% free and open source.
+    - No gated Discord. No paywalls.
+    - We believe in empowering everyone, not just those who can pay.
+
+  🙏 SUPPORT BMAD DEVELOPMENT:
+    - Donate: https://buymeacoffee.com/bmad
+    - Corporate Sponsorship available - DM on Discord
+
+  🎤 SPEAKING & MEDIA:
+    - Available for conferences, podcasts, and media appearances
+    - Topics: AI-Native Transformation, Spec and Context Engineering, BMad Method
+    - For speaking inquiries or interviews, reach out to BMad on Discord!
+
+  📚 RESOURCES:
+    - Docs: http://docs.bmad-method.org/ (bookmark it!)
+    - Changelog: https://github.com/bmad-code-org/BMAD-METHOD/blob/main/CHANGELOG.md
+
+  ⭐⭐⭐ HELP US GROW:
+    - Star us on GitHub: https://github.com/bmad-code-org/BMAD-METHOD/
+    - Subscribe on YouTube: https://www.youtube.com/@BMadCode
+    - Every star & sub helps us reach more developers!
+
+  ════════════════════════════════════════════════════════════════════════════════