bmad-method 5.1.0 → 5.1.3

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

@@ -146,10 +146,10 @@ jobs:
             echo "📝 Version bump and tag were created successfully."
           fi
 
-      - name: Publish to NPM with stable tag
+      - name: Publish to NPM
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-        run: npm publish --tag stable
+        run: npm publish
 
       - 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 @stable tag"
+          echo "📦 Published to NPM with @latest 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,77 +1,147 @@
-# How to Release a New Version
+# Versioning and Releases
 
-## Automated Releases (Recommended)
+BMad Method uses a simplified release system with manual control and automatic release notes generation.
 
-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.
+## 🚀 Release Workflow
 
-### Commit Message Format
+### Command Line Release (Recommended)
 
-Use these prefixes to control what type of release happens:
+The fastest way to create a release with beautiful release notes:
 
 ```bash
-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)
+# 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
 ```
 
-### What Happens Automatically
+## 📝 What Happens Automatically
 
-When you push commits with `fix:` or `feat:`, GitHub Actions will:
+When you trigger a release, the GitHub Actions workflow automatically:
 
-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
+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
 
-### Your Simple Workflow
+## 📋 Sample Release Notes
 
-```bash
-# Make your changes
-git add .
-git commit -m "feat: add team collaboration mode"
-git push
+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
+
+### 🔧 Maintenance
+
+- chore: update dependencies
+- chore: improve error messages
+
+## 📦 Installation
 
-# That's it! Release happens automatically 🎉
-# Users can now run: npx bmad-method (and get the new version)
+```bash
+npx bmad-method install
 ```
+````
+
+**Full Changelog**: https://github.com/bmadcode/BMAD-METHOD/compare/v5.1.0...v5.2.0
 
-### Commits That DON'T Trigger Releases
+````
 
-These commit types won't create releases (use them for maintenance):
+## 🎯 User Installation
+
+After any release, users can immediately get the new version with:
 
 ```bash
-chore: update dependencies     # No release
-docs: fix typo in readme      # No release
-style: format code            # No release
-test: add unit tests          # No release
+npx bmad-method install    # Always gets latest release
 ```
 
-### Test Your Setup
+## 📊 Preview Before Release
+
+Always preview what will be included in your release:
 
 ```bash
-npm run release:test    # Safe to run locally - tests the config
+npm run preview:release
 ```
 
----
+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
 
-## Manual Release Methods (Exceptions Only)
+## 📈 Version Strategy
 
-⚠️ Only use these methods if you need to bypass the automatic system
+- **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
 
-### Quick Manual Version Bump
+## 🛠️ 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
 
 ```bash
-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)
+gh run list --workflow="Manual Release"
+npm view bmad-method dist-tags
+git tag -l | sort -V | tail -5
+```
+
+### View Latest Release
 
-# Then manually publish:
-npm publish
-git push && git push --tags
+```bash
+gh release view --web
+npm view bmad-method versions --json
 ```
 
-### Manual GitHub Actions Trigger
+### If Release Fails
 
-You can also trigger releases manually through GitHub Actions workflow dispatch if needed.
+- Check GitHub Actions logs: `gh run view <run-id> --log-failed`
+- Verify NPM tokens are configured
+- Ensure branch protection allows workflow pushes
+````

package/package.json

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

package/release_notes.md

@@ -1,4 +1,4 @@
-## 🚀 What's New in v5.1.0
+## 🚀 What's New in v5.1.3
 
 ### ✨ New Features
 - feat: simplify installation to single @stable tag
@@ -10,6 +10,14 @@
 - 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
+- fix: correct version to 5.1.1 after patch release
+
+### 📦 Other Changes
+- docs: update versioning and releases documentation
+- sync: update package.json to match published version 5.0.1
+- sync: update versions to 5.1.2 to match published release
 
 ### 🔧 Maintenance
 - chore: configure changelog file path in semantic-release config (#448)
@@ -22,4 +30,4 @@
 npx bmad-method install
 ```
 
-**Full Changelog**: https://github.com/bmadcode/BMAD-METHOD/compare/v5.0.0-beta.2...v5.1.0
+**Full Changelog**: https://github.com/bmadcode/BMAD-METHOD/compare/v5.0.0-beta.2...v5.1.3

package/tools/installer/package.json

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