bmad-method 6.12.1 → 6.12.3-next.0

package/.claude-plugin/marketplace.json

@@ -14,7 +14,7 @@
       "displayName": "BMad Method Analyze Plan Build",
       "source": "./",
       "description": "Full-lifecycle AI development framework — agents and workflows for product analysis, planning, architecture, and implementation.",
-      "version": "6.12.1",
+      "version": "6.12.3",
       "author": {
         "name": "Brian (BMad) Madison"
       },

package/bmad-modules.yaml

@@ -8,6 +8,11 @@
 # override with --channel/--pin/--next. Valid values: stable | next.
 # Omit to inherit the installer's hardcoded default (stable).
 #
+# pin (optional) — a git tag to install instead of the channel. Use it when
+# newer releases no longer work with this installer. The pin is the default for
+# every module that gets no explicit choice. --pin, --next=CODE and a stable or
+# next pick in the interactive picker override it; --channel and --all-* do not.
+#
 # deprecated (optional, default false) — when true, the module is hidden from
 # the installer picker UNLESS it is already installed (so existing users can
 # still see/manage it, but new users are not offered it).
@@ -55,6 +60,7 @@ modules:
     type: bmad-org
     npmPackage: bmad-creative-intelligence-suite
     default_channel: stable
+    pin: v0.3.2
 
   bmad-method-test-architecture-enterprise:
     url: https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise
@@ -66,6 +72,7 @@ modules:
     type: bmad-org
     npmPackage: bmad-method-test-architecture-enterprise
     default_channel: stable
+    pin: v1.27.2
 
   bmad-loop:
     url: https://github.com/bmad-code-org/bmad-loop

package/body.md

@@ -0,0 +1,17 @@
+Picking a channel in the picker is ignored when the module has a registry `pin`.
+The `tea` pin (v1.27.2) wins, and the manifest records `channel: pinned` with no message.
+
+`decideChannelForModule` checked `registryPin` before `--next=CODE`, and the picker never recorded a `stable` pick.
+
+New order: `--pin` > `--next=CODE` or picker stable > registry pin > `--channel`/`--all-*` > registry default > `stable`.
+
+- `channel-plan.js`: explicit per-module picks resolve before the registry pin. New `stableSet` holds a `stable` pick.
+- `ui.js`: `next` is gone from the install picker and from the update flow's channel review. A stable pick fills `stableSet`. A legacy install that tracks `main` moves to stable without a prompt.
+- Tests: "registry pin beats --next" splits into three cases. Picker-level tests drive the install and update flows, including the all-stable fast path that keeps the pin.
+
+`--yes`, the all-stable fast path and `--channel` still get the pin.
+
+`--next=CODE` stays for headless use.
+On 6.12 it now installs `main` for a pinned module, which fails for TEA v2+ because that layout needs the v7 installer.
+
+`npm run quality` passes.

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "bmad-method",
-  "version": "6.12.1",
+  "version": "6.12.3-next.0",
   "description": "Breakthrough Method of Agile AI-driven Development",
   "keywords": [
     "agile",

package/src/bmm-skills/plan/bmad-architecture/scripts/lint_spine.py

@@ -254,4 +254,8 @@ def main(argv: list[str] | None = None) -> int:
 
 
 if __name__ == "__main__":
+    if sys.platform == "win32":
+        # Piped output on Windows defaults to a legacy code page, not UTF-8.
+        sys.stdout.reconfigure(encoding="utf-8")
+        sys.stderr.reconfigure(encoding="utf-8")
     sys.exit(main())

package/src/bmm-skills/plan/bmad-sprint-planning/scripts/sprint_plan.py

@@ -694,4 +694,8 @@ def main(argv=None):
 
 
 if __name__ == "__main__":
+    if sys.platform == "win32":
+        # Piped output on Windows defaults to a legacy code page, not UTF-8.
+        sys.stdout.reconfigure(encoding="utf-8")
+        sys.stderr.reconfigure(encoding="utf-8")
     main()

package/src/bmm-skills/ship/bmad-retrospective/scripts/git_evidence.py

@@ -301,4 +301,8 @@ def main(argv=None):
 
 
 if __name__ == "__main__":
+    if sys.platform == "win32":
+        # Piped output on Windows defaults to a legacy code page, not UTF-8.
+        sys.stdout.reconfigure(encoding="utf-8")
+        sys.stderr.reconfigure(encoding="utf-8")
     main()

package/src/bmm-skills/ship/bmad-retrospective/scripts/sprint_status.py

@@ -743,4 +743,8 @@ def main(argv=None):
 
 
 if __name__ == "__main__":
+    if sys.platform == "win32":
+        # Piped output on Windows defaults to a legacy code page, not UTF-8.
+        sys.stdout.reconfigure(encoding="utf-8")
+        sys.stderr.reconfigure(encoding="utf-8")
     main()

package/src/core-skills/bmad-customize/scripts/list_customizable_skills.py

@@ -228,4 +228,8 @@ def main(argv: list[str]) -> int:
 
 
 if __name__ == "__main__":
+    if sys.platform == "win32":
+        # Piped output on Windows defaults to a legacy code page, not UTF-8.
+        sys.stdout.reconfigure(encoding="utf-8")
+        sys.stderr.reconfigure(encoding="utf-8")
     sys.exit(main(sys.argv[1:]))

package/src/core-skills/bmad-deep-recon/scripts/recon_kit.py

@@ -319,4 +319,8 @@ def main(argv: list[str] | None = None) -> int:
 
 
 if __name__ == "__main__":
+    if sys.platform == "win32":
+        # Piped output on Windows defaults to a legacy code page, not UTF-8.
+        sys.stdout.reconfigure(encoding="utf-8")
+        sys.stderr.reconfigure(encoding="utf-8")
     sys.exit(main())

package/src/scripts/memlog.py

@@ -221,4 +221,8 @@ def main(argv: list[str] | None = None) -> int:
 
 
 if __name__ == "__main__":
+    if sys.platform == "win32":
+        # Piped output on Windows defaults to a legacy code page, not UTF-8.
+        sys.stdout.reconfigure(encoding="utf-8")
+        sys.stderr.reconfigure(encoding="utf-8")
     sys.exit(main())

package/tools/installer/core/installer.js

@@ -1326,6 +1326,9 @@ class Installer {
       rounded: true,
       formatBorder: color.green,
     });
+
+    const { MessageLoader } = require('../message-loader');
+    await new MessageLoader().displayEndMessage();
   }
 
   /**
@@ -1471,7 +1474,7 @@ class Installer {
     // 'pinned' would trigger a stable-channel tag lookup at config-collection
     // time, burning GitHub API quota and potentially failing.
     const manifestData = await this.manifest.read(bmadDir);
-    const channelOptions = { global: null, nextSet: new Set(), pins: new Map(), warnings: [] };
+    const channelOptions = { global: null, nextSet: new Set(), stableSet: new Set(), pins: new Map(), warnings: [] };
     if (manifestData?.modulesDetailed) {
       const { fetchStableTags, classifyUpgrade, parseGitHubRepo } = require('../modules/channel-resolver');
       for (const entry of manifestData.modulesDetailed) {

package/tools/installer/install-messages.yaml

@@ -6,16 +6,19 @@
 startMessage: |
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-  Agile AI-Driven Development. Powered by BMad Core and a growing module ecosystem.
+  The Breakthrough Method of Agile AI-Driven Development - the original and best AI SDLC. Powered by BMad Core and a growing module ecosystem.
   Install official and community modules during setup to customize your experience.
 
   🌟 100% free. 100% open source. Always.
      No paywalls. No gated content. Knowledge shared, not sold.
 
+  🚀 BMad v7 is close, and you can preview and test it now:
+     npx skills add bmad-code-org/BMAD-METHOD
+     then ask your agent for `bmad setup`. After setup, `bmad migrate`
+     tests the v6 to v7 migration (still in beta).
+
   🐍 REQUIRED: uv (https://docs.astral.sh/uv/) runs the Python scripts BMAD
-     skills rely on (`uv run <script>`) and provisions the interpreter itself.
-     Without it, bmad-build and bmad-build-auto halt on activation.
-     If it's not set up yet, ask your AI agent to "install and set up uv for me".
+     skills rely on. If it's not set up yet, ask your AI agent to "install and set up uv for me".
 
   🌐 CONNECT:
     Website:   https://bmadcode.com/
@@ -33,5 +36,9 @@ startMessage: |
 
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-# No end message - install summary and next steps are rendered by the installer
-endMessage: ""
+# Display at the END of installation (after the install summary)
+endMessage: |
+  🚀 BMad v7 is close, and you can preview and test it now:
+     npx skills add bmad-code-org/BMAD-METHOD
+     then ask your agent for `bmad setup`. After setup, `bmad migrate`
+     tests the v6 to v7 migration (still in beta).

package/tools/installer/modules/channel-plan.js

@@ -10,7 +10,8 @@
  *   3. Registry defaults (default_channel from bmad-modules.yaml)
  *   4. Hardcoded fallback 'stable'
  *
- * Precedence: --pin > --next=CODE > --channel (global) > registry default > 'stable'.
+ * Precedence: --pin > explicit per-module choice (--next=CODE, picker next/stable) > registry pin
+ * > --channel (global) > registry default > 'stable'.
  *
  * This module is pure. No prompts, no git, no filesystem.
  */
@@ -24,6 +25,7 @@ const VALID_CHANNELS = new Set(['stable', 'next']);
  * @returns {{
  *   global: 'stable'|'next'|null,
  *   nextSet: Set<string>,
+ *   stableSet: Set<string>,
  *   pins: Map<string, string>,
  *   warnings: string[]
  * }}
@@ -58,6 +60,9 @@ function parseChannelOptions(options = {}) {
     nextSet.add(trimmed);
   }
 
+  // Filled only by the interactive per-module picker (no CLI flag).
+  const stableSet = new Set();
+
   // --pin CODE=TAG (repeatable)
   const pins = new Map();
   for (const spec of options.pin || []) {
@@ -76,7 +81,7 @@ function parseChannelOptions(options = {}) {
   // headless installs with --next=/--pin for a community module don't hang.
   const acceptBypass = options.yes === true || options.acceptBypass === true;
 
-  return { global, nextSet, pins, warnings, acceptBypass };
+  return { global, nextSet, stableSet, pins, warnings, acceptBypass };
 }
 
 function normalizeChannel(raw, warnings, flagName) {
@@ -104,11 +109,12 @@ function parsePinSpec(spec) {
  * @param {string} args.code
  * @param {Object} args.channelOptions - from parseChannelOptions
  * @param {string} [args.registryDefault] - module's default_channel, if any
+ * @param {string} [args.registryPin] - module's registry pin, if any
  * @returns {{channel: 'stable'|'next'|'pinned', pin?: string, source: string}}
  *   source describes where the decision came from, for logging / debugging.
  */
-function decideChannelForModule({ code, channelOptions, registryDefault }) {
-  const { global, nextSet, pins } = channelOptions || { nextSet: new Set(), pins: new Map() };
+function decideChannelForModule({ code, channelOptions, registryDefault, registryPin }) {
+  const { global, nextSet, stableSet, pins } = channelOptions || { nextSet: new Set(), stableSet: new Set(), pins: new Map() };
 
   if (pins && pins.has(code)) {
     return { channel: 'pinned', pin: pins.get(code), source: 'flag:--pin' };
@@ -116,6 +122,12 @@ function decideChannelForModule({ code, channelOptions, registryDefault }) {
   if (nextSet && nextSet.has(code)) {
     return { channel: 'next', source: 'flag:--next' };
   }
+  if (stableSet && stableSet.has(code)) {
+    return { channel: 'stable', source: 'picker:stable' };
+  }
+  if (registryPin) {
+    return { channel: 'pinned', pin: registryPin, source: 'registry:pin' };
+  }
   if (global) {
     return { channel: global, source: 'flag:--channel' };
   }
@@ -144,6 +156,7 @@ function buildPlan({ modules, channelOptions }) {
         code: mod.code,
         channelOptions,
         registryDefault: mod.defaultChannel,
+        registryPin: mod.pin,
       }),
     );
   }

package/tools/installer/modules/external-manager.js

@@ -130,6 +130,7 @@ class ExternalModuleManager {
       npmPackage: mod.npm_package || mod.npmPackage || null,
       pluginName: mod.plugin_name || mod.pluginName || null,
       defaultChannel: normalizeChannelName(mod.default_channel || mod.defaultChannel) || 'stable',
+      pin: mod.pin || null,
       deprecated: mod.deprecated === true,
       deprecationMessage: mod.deprecation_message || mod['deprecation-message'] || mod.deprecationMessage || null,
       marketplacePlugin: mod.marketplace_plugin === true || mod['marketplace-plugin'] === true || mod.marketplacePlugin === true,
@@ -273,6 +274,7 @@ class ExternalModuleManager {
       code: moduleCode,
       channelOptions: options.channelOptions,
       registryDefault: moduleInfo.defaultChannel,
+      registryPin: moduleInfo.pin,
     });
 
     // Same-plan short-circuit: a single install calls cloneExternalModule

package/tools/installer/ui.js

@@ -70,15 +70,17 @@ function buildModuleLabel(name, latestVersion, installedVersion = '') {
  * @param {Object} options
  * @param {string|null} [options.repoUrl] - Module repository URL for tag resolution
  * @param {string|null} [options.registryDefault] - Registry default channel
+ * @param {string|null} [options.registryPin] - Registry pinned tag
  * @param {Object|null} [options.channelOptions] - Parsed installer channel options
  * @returns {Promise<{version: string, lookupAttempted: boolean, lookupSucceeded: boolean}>}
  */
-async function getModuleVersion(moduleCode, { repoUrl = null, registryDefault = null, channelOptions = null } = {}) {
+async function getModuleVersion(moduleCode, { repoUrl = null, registryDefault = null, registryPin = null, channelOptions = null } = {}) {
   if (repoUrl) {
     const plan = decideChannelForModule({
       code: moduleCode,
       channelOptions,
       registryDefault,
+      registryPin,
     });
 
     try {
@@ -291,6 +293,13 @@ class UI {
       }
       confirmedDirectory = expandedDir;
       await prompts.log.info(`Using directory from command-line: ${confirmedDirectory}`);
+    } else if (options.yes) {
+      confirmedDirectory = process.cwd();
+      const validation = this.validateDirectorySync(confirmedDirectory);
+      if (validation) {
+        throw new Error(`Invalid directory: ${validation}`);
+      }
+      await prompts.log.info(`Using current directory: ${confirmedDirectory}`);
     } else {
       confirmedDirectory = await this.getConfirmedDirectory();
     }
@@ -1058,10 +1067,10 @@ class UI {
     const allOptions = [];
     const initialValues = [];
 
-    const buildModuleEntry = async (code, name, description, isDefault, repoUrl = null, registryDefault = null) => {
+    const buildModuleEntry = async (code, name, description, isDefault, repoUrl = null, registryDefault = null, registryPin = null) => {
       const isInstalled = installedModuleIds.has(code);
       const installedVersion = installedModuleVersions.get(code) || '';
-      const versionState = await getModuleVersion(code, { repoUrl, registryDefault, channelOptions });
+      const versionState = await getModuleVersion(code, { repoUrl, registryDefault, registryPin, channelOptions });
       const label = buildModuleLabel(name, versionState.version, installedVersion);
       return {
         label,
@@ -1109,6 +1118,7 @@ class UI {
             mod.defaultSelected,
             mod.url || null,
             mod.defaultChannel || null,
+            mod.pin || null,
           );
           if (mod.deprecated && mod.deprecationMessage) {
             entry.hint = entry.hint ? `${entry.hint} — ${mod.deprecationMessage}` : mod.deprecationMessage;
@@ -1970,15 +1980,12 @@ class UI {
         message: `${code}: choose a channel`,
         choices: [
           { name: stableLabel, value: 'stable' },
-          { name: 'next   (main HEAD \u2014 current development)', value: 'next' },
           { name: 'pin    (specific version)', value: 'pin' },
         ],
         default: 'stable',
       });
 
-      if (choice === 'next') {
-        channelOptions.nextSet.add(code);
-      } else if (choice === 'pin') {
+      if (choice === 'pin') {
         const pinValue = await prompts.text({
           message: `Enter a version tag for '${code}' (e.g. v1.6.0):`,
           validate: (value) => {
@@ -1988,8 +1995,9 @@ class UI {
           },
         });
         channelOptions.pins.set(code, String(pinValue).trim());
+      } else {
+        channelOptions.stableSet.add(code);
       }
-      // 'stable' is the default; nothing to record.
     }
   }
 
@@ -2004,8 +2012,7 @@ class UI {
    *     frozen unless the user also passes `--pin CODE=NEW_TAG`.
    *   - On `next`: no prompt (pull HEAD).
    *   - On `pinned`: no prompt (stays pinned).
-   *   - No channel recorded and `version: null`: one-time migration prompt
-   *     ("Switch to stable / Keep on next").
+   *   - No channel recorded and `version: null`: moves to stable, no prompt.
    *
    * Decisions that freeze the current version are applied by adding a pin to
    * `channelOptions.pins` so downstream clone logic honors them.
@@ -2040,7 +2047,7 @@ class UI {
       });
       if (existingWithChannel.length > 0) {
         reviewChannels = await prompts.confirm({
-          message: 'Review channel assignments (stable / next / pin) for your existing modules?',
+          message: 'Review channel assignments (stable / pin) for your existing modules?',
           default: false,
         });
       }
@@ -2061,7 +2068,7 @@ class UI {
       const parsed = repoUrl ? parseGitHubRepo(repoUrl) : null;
 
       // Legacy migration: manifest carries no channel and a null/empty
-      // version. Offer the one-time pick between stable and next.
+      // version. The next channel is gone from the picker, so move it to stable.
       const recordedChannel = prev.channel || null;
       const needsMigration = !recordedChannel && (prev.version == null || prev.version === '');
       if (needsMigration) {
@@ -2069,15 +2076,7 @@ class UI {
           // Conservative headless default: stable.
           continue;
         }
-        const chosen = await prompts.select({
-          message: `${code}: your existing install tracks the main branch. Switch to stable releases (recommended for production), or keep on main?`,
-          choices: [
-            { name: 'Switch to stable', value: 'stable' },
-            { name: 'Keep on main (next)', value: 'next' },
-          ],
-          default: 'stable',
-        });
-        if (chosen === 'next') channelOptions.nextSet.add(code);
+        channelOptions.stableSet.add(code);
         continue;
       }
 
@@ -2095,9 +2094,6 @@ class UI {
         if (recordedChannel !== 'stable') {
           switchChoices.push({ name: 'Switch to stable (released version)', value: 'stable' });
         }
-        if (recordedChannel !== 'next') {
-          switchChoices.push({ name: 'Switch to next (main HEAD)', value: 'next' });
-        }
         switchChoices.push({ name: 'Pin to a specific version tag', value: 'pin' });
 
         const choice = await prompts.select({
@@ -2106,10 +2102,6 @@ class UI {
           default: 'keep',
         });
 
-        if (choice === 'next') {
-          channelOptions.nextSet.add(code);
-          continue;
-        }
         if (choice === 'pin') {
           const pinValue = await prompts.text({
             message: `Enter a version tag for '${code}' (e.g. v1.6.0):`,
@@ -2125,6 +2117,7 @@ class UI {
         if (choice === 'stable') {
           // Switch to stable: install at the top stable tag without an
           // upgrade-classification prompt (the user explicitly opted in).
+          channelOptions.stableSet.add(code);
           // Also warm the tag cache here so the actual clone step doesn't
           // need a second GitHub API call (can hit rate limits).
           if (parsed) {