From e1176f337eba7a9ebb8737fb9e12ea5a0a87dc0e Mon Sep 17 00:00:00 2001
From: Brian Madison <brianmadison@Brians-MacBook-Pro.local>
Date: Fri, 15 Aug 2025 21:42:52 -0500
Subject: [PATCH] feat: publish stable release 5.0.0

BREAKING CHANGE: Promote beta features to stable release for v5.0.0

This commit ensures the stable release gets properly published to NPM and GitHub releases.
---
 .github/workflows/promote-to-stable.yml | 26 +++++++++++++++++++++++--
 CHANGELOG.md                            |  1 +
 2 files changed, 25 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/promote-to-stable.yml b/.github/workflows/promote-to-stable.yml
index d0dabbf2..526b7179 100644
--- a/.github/workflows/promote-to-stable.yml
+++ b/.github/workflows/promote-to-stable.yml
@@ -83,6 +83,27 @@ jobs:
               ;;
           esac
           
+          # Check if calculated version already exists on NPM and increment if necessary
+          while npm view bmad-method@$NEW_VERSION version >/dev/null 2>&1; do
+            echo "Version $NEW_VERSION already exists, incrementing..."
+            IFS='.' read -ra NEW_VERSION_PARTS <<< "$NEW_VERSION"
+            NEW_MAJOR=${NEW_VERSION_PARTS[0]}
+            NEW_MINOR=${NEW_VERSION_PARTS[1]}
+            NEW_PATCH=${NEW_VERSION_PARTS[2]}
+            
+            case "${{ github.event.inputs.version_bump }}" in
+              "major")
+                NEW_VERSION="$((NEW_MAJOR + 1)).0.0"
+                ;;
+              "minor")
+                NEW_VERSION="$NEW_MAJOR.$((NEW_MINOR + 1)).0"
+                ;;
+              "patch")
+                NEW_VERSION="$NEW_MAJOR.$NEW_MINOR.$((NEW_PATCH + 1))"
+                ;;
+            esac
+          done
+          
           echo "new_version=$NEW_VERSION" >> $GITHUB_OUTPUT
           echo "Promoting from $CURRENT_VERSION to $NEW_VERSION"
 
@@ -100,9 +121,10 @@ jobs:
       - name: Commit stable release
         run: |
           git add .
-          git commit -m "release: promote to stable ${{ steps.version.outputs.new_version }}
+          git commit -m "feat: promote to stable ${{ steps.version.outputs.new_version }}
+
+          BREAKING CHANGE: Promote beta features to stable release
 
-          - Promote beta features to stable release
           - Update version from ${{ steps.version.outputs.current_version }} to ${{ steps.version.outputs.new_version }}
           - Automated promotion via GitHub Actions"
 
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5ab680c8..a25450f3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -686,3 +686,4 @@ Co-Authored-By: Claude <noreply@anthropic.com>
 ### Features
 
 - add versioning and release automation ([0ea5e50](https://github.com/bmadcode/BMAD-METHOD/commit/0ea5e50aa7ace5946d0100c180dd4c0da3e2fd8c))
+# Promote to stable release 5.0.0