From 36490a16485f02d7644e20e950574aa508c64ddc Mon Sep 17 00:00:00 2001
From: Steve Yegge <stevey@sourcegraph.com>
Date: Sat, 25 Oct 2025 16:48:28 -0700
Subject: [PATCH] Fix RELEASING.md: clarify rebuild requirement and Homebrew
 timing

Issues fixed:
- Added explicit rebuild step after version bump (source changes but binary doesn't)
- Clarified Homebrew formula update must happen AFTER tag push
- Added git pull step for /tmp/homebrew-beads to avoid stale repo
- Made it clear users won't get new version until Homebrew formula is updated
- Removed redundant git config steps (already configured in cloned repo)
---
 RELEASING.md | 30 +++++++++++++++++++++---------
 1 file changed, 21 insertions(+), 9 deletions(-)

diff --git a/RELEASING.md b/RELEASING.md
index 7d54be5c..314b365d 100644
--- a/RELEASING.md
+++ b/RELEASING.md
@@ -54,6 +54,7 @@ Use the automated script to update all version files:
 
 ```bash
 ./scripts/bump-version.sh 0.9.X --commit
+git push origin main
 ```
 
 This updates:
@@ -65,6 +66,12 @@ This updates:
 - `README.md`
 - `PLUGIN.md`
 
+**IMPORTANT**: After version bump, rebuild the local binary:
+```bash
+go build -o bd ./cmd/bd
+./bd version  # Should show new version
+```
+
 ## Publish to All Channels
 
 ### 1. Create Git Tag
@@ -108,19 +115,22 @@ See [integrations/beads-mcp/PYPI.md](integrations/beads-mcp/PYPI.md) for detaile
 
 ### 3. Update Homebrew Formula
 
+**CRITICAL**: This step must be done AFTER pushing the git tag in step 1, otherwise the tarball won't exist yet.
+
 The formula needs the SHA256 of the tag tarball:
 
 ```bash
-# Compute SHA256 from tag
+# Compute SHA256 from tag (wait a few seconds after pushing tag if you get 404)
 curl -sL https://github.com/steveyegge/beads/archive/refs/tags/v0.9.X.tar.gz | shasum -a 256
 
-# Clone tap repo (if not already)
-git clone https://github.com/steveyegge/homebrew-beads /tmp/homebrew-beads
-cd /tmp/homebrew-beads
-git config user.name "Your Name"
-git config user.email "your.email@example.com"
+# Navigate to tap repo (if already cloned) or clone it
+cd /tmp/homebrew-beads || git clone https://github.com/steveyegge/homebrew-beads /tmp/homebrew-beads
 
-# Update Formula/bd.rb:
+# Pull latest changes
+cd /tmp/homebrew-beads
+git pull
+
+# Update Formula/bd.rb (replace version and SHA256):
 # - url: https://github.com/steveyegge/beads/archive/refs/tags/v0.9.X.tar.gz
 # - sha256: <computed SHA256>
 
@@ -130,13 +140,15 @@ git commit -m "Update bd formula to v0.9.X"
 git push origin main
 ```
 
-Install/upgrade locally with:
+**IMPORTANT**: Install/upgrade locally to verify:
 ```bash
 brew update
 brew upgrade bd  # Or: brew reinstall bd
-bd version  # Verify it shows new version
+bd version  # Should now show v0.9.X
 ```
 
+**Note**: Until this step is complete, users with Homebrew-installed bd will still have the old version.
+
 **Note:** If you have an old bd binary from `go install` in your PATH, remove it to avoid conflicts:
 ```bash
 # Find where bd is installed