bmad-method 5.0.1 → 5.1.0

package/.github/workflows/manual-release.yaml

@@ -146,10 +146,10 @@ jobs:
             echo "📝 Version bump and tag were created successfully."
           fi
 
-      - name: Publish to NPM
+      - name: Publish to NPM with stable tag
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-        run: npm publish
+        run: npm publish --tag stable
 
       - name: Create GitHub Release
         uses: actions/create-release@v1
@@ -165,7 +165,7 @@ jobs:
       - name: Summary
         run: |
           echo "🎉 Successfully released v${{ steps.version.outputs.new_version }}!"
-          echo "📦 Published to NPM with @latest tag"
+          echo "📦 Published to NPM with @stable tag"
           echo "🏷️ Git tag: v${{ steps.version.outputs.new_version }}"
           echo "✅ Users running 'npx bmad-method install' will now get version ${{ steps.version.outputs.new_version }}"
           echo ""

package/docs/versioning-and-releases.md

@@ -1,147 +1,77 @@
-# Versioning and Releases
+# How to Release a New Version
 
-BMad Method uses a simplified release system with manual control and automatic release notes generation.
+## Automated Releases (Recommended)
 
-## 🚀 Release Workflow
+The easiest way to release new versions is through **automatic semantic releases**. Just commit with the right message format and push and everything else happens automatically.
 
-### Command Line Release (Recommended)
+### Commit Message Format
 
-The fastest way to create a release with beautiful release notes:
+Use these prefixes to control what type of release happens:
 
 ```bash
-# Preview what will be in the release
-npm run preview:release
-
-# Create a release
-npm run release:patch    # 5.1.0 → 5.1.1 (bug fixes)
-npm run release:minor    # 5.1.0 → 5.2.0 (new features)
-npm run release:major    # 5.1.0 → 6.0.0 (breaking changes)
-
-# Watch the release process
-npm run release:watch
-```
-
-### One-Liner Release
-
-```bash
-npm run preview:release && npm run release:minor && npm run release:watch
+fix: resolve CLI argument parsing bug      # → patch release (4.1.0 → 4.1.1)
+feat: add new agent orchestration mode     # → minor release (4.1.0 → 4.2.0)
+feat!: redesign CLI interface              # → major release (4.1.0 → 5.0.0)
 ```
 
-## 📝 What Happens Automatically
-
-When you trigger a release, the GitHub Actions workflow automatically:
-
-1. ✅ **Validates** - Runs tests, linting, and formatting checks
-2. ✅ **Bumps Version** - Updates `package.json` and installer version
-3. ✅ **Generates Release Notes** - Categorizes commits since last release:
-   - ✨ **New Features** (`feat:`, `Feature:`)
-   - 🐛 **Bug Fixes** (`fix:`, `Fix:`)
-   - 🔧 **Maintenance** (`chore:`, `Chore:`)
-   - 📦 **Other Changes** (everything else)
-4. ✅ **Creates Git Tag** - Tags the release version
-5. ✅ **Publishes to NPM** - With `@latest` tag for user installations
-6. ✅ **Creates GitHub Release** - With formatted release notes
-
-## 📋 Sample Release Notes
-
-The workflow automatically generates professional release notes like this:
-
-````markdown
-## 🚀 What's New in v5.2.0
-
-### ✨ New Features
-
-- feat: add team collaboration mode
-- feat: enhance CLI with interactive prompts
-
-### 🐛 Bug Fixes
-
-- fix: resolve installation path issues
-- fix: handle edge cases in agent loading
+### What Happens Automatically
 
-### 🔧 Maintenance
+When you push commits with `fix:` or `feat:`, GitHub Actions will:
 
-- chore: update dependencies
-- chore: improve error messages
+1. ✅ Analyze your commit messages
+2. ✅ Bump version in `package.json`
+3. ✅ Generate changelog
+4. ✅ Create git tag
+5. ✅ **Publish to NPM automatically**
+6. ✅ Create GitHub release with notes
 
-## 📦 Installation
+### Your Simple Workflow
 
 ```bash
-npx bmad-method install
-```
-````
-
-**Full Changelog**: https://github.com/bmadcode/BMAD-METHOD/compare/v5.1.0...v5.2.0
+# Make your changes
+git add .
+git commit -m "feat: add team collaboration mode"
+git push
 
-````
+# That's it! Release happens automatically 🎉
+# Users can now run: npx bmad-method (and get the new version)
+```
 
-## 🎯 User Installation
+### Commits That DON'T Trigger Releases
 
-After any release, users can immediately get the new version with:
+These commit types won't create releases (use them for maintenance):
 
 ```bash
-npx bmad-method install    # Always gets latest release
+chore: update dependencies     # No release
+docs: fix typo in readme      # No release
+style: format code            # No release
+test: add unit tests          # No release
 ```
 
-## 📊 Preview Before Release
-
-Always preview what will be included in your release:
+### Test Your Setup
 
 ```bash
-npm run preview:release
+npm run release:test    # Safe to run locally - tests the config
 ```
 
-This shows:
-
-- Commits since last release
-- Categorized changes
-- Estimated next version
-- Release notes preview
-
-## 🔧 Manual Release (GitHub UI)
-
-You can also trigger releases through GitHub Actions:
-
-1. Go to **GitHub Actions** → **Manual Release**
-2. Click **"Run workflow"**
-3. Choose version bump type (patch/minor/major)
-4. Everything else happens automatically
+---
 
-## 📈 Version Strategy
+## Manual Release Methods (Exceptions Only)
 
-- **Patch** (5.1.0 → 5.1.1): Bug fixes, minor improvements
-- **Minor** (5.1.0 → 5.2.0): New features, enhancements
-- **Major** (5.1.0 → 6.0.0): Breaking changes, major redesigns
+⚠️ Only use these methods if you need to bypass the automatic system
 
-## 🛠️ Development Workflow
-
-1. **Develop Freely** - Merge PRs to main without triggering releases
-2. **Test Unreleased Changes** - Clone repo to test latest main branch
-3. **Release When Ready** - Use command line or GitHub Actions to cut releases
-4. **Users Get Updates** - Via simple `npx bmad-method install` command
-
-This gives you complete control over when releases happen while automating all the tedious parts like version bumping, release notes, and publishing.
-
-## 🔍 Troubleshooting
-
-### Check Release Status
+### Quick Manual Version Bump
 
 ```bash
-gh run list --workflow="Manual Release"
-npm view bmad-method dist-tags
-git tag -l | sort -V | tail -5
-```
-
-### View Latest Release
+npm run version:patch   # 4.1.0 → 4.1.1 (bug fixes)
+npm run version:minor   # 4.1.0 → 4.2.0 (new features)
+npm run version:major   # 4.1.0 → 5.0.0 (breaking changes)
 
-```bash
-gh release view --web
-npm view bmad-method versions --json
+# Then manually publish:
+npm publish
+git push && git push --tags
 ```
 
-### If Release Fails
+### Manual GitHub Actions Trigger
 
-- Check GitHub Actions logs: `gh run view <run-id> --log-failed`
-- Verify NPM tokens are configured
-- Ensure branch protection allows workflow pushes
-````
+You can also trigger releases manually through GitHub Actions workflow dispatch if needed.

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "bmad-method",
-  "version": "5.0.1",
+  "version": "5.1.0",
   "description": "Breakthrough Method of Agile AI-driven Development",
   "keywords": [
     "agile",
@@ -100,6 +100,6 @@
     "node": ">=20.10.0"
   },
   "publishConfig": {
-    "access": "public"
+    "tag": "stable"
   }
 }

package/release_notes.md

@@ -1,4 +1,4 @@
-## 🚀 What's New in v5.0.1
+## 🚀 What's New in v5.1.0
 
 ### ✨ New Features
 - feat: simplify installation to single @stable tag
@@ -10,11 +10,6 @@
 - fix: handle existing tags in promote-to-stable workflow
 - fix: enable version bumping in manual release workflow
 - fix: handle protected branch in manual release workflow
-- fix: simplify npm publishing to use latest tag only
-- fix: update installer package.json version to 5.1.0
-
-### 📦 Other Changes
-- docs: update versioning and releases documentation
 
 ### 🔧 Maintenance
 - chore: configure changelog file path in semantic-release config (#448)
@@ -27,4 +22,4 @@
 npx bmad-method install
 ```
 
-**Full Changelog**: https://github.com/bmadcode/BMAD-METHOD/compare/v5.0.0-beta.2...v5.0.1
+**Full Changelog**: https://github.com/bmadcode/BMAD-METHOD/compare/v5.0.0-beta.2...v5.1.0

package/tools/installer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bmad-method",
-  "version": "5.0.1",
+  "version": "5.1.0",
   "description": "BMad Method installer - AI-powered Agile development framework",
   "keywords": [
     "bmad",