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)
This commit is contained in:
Steve Yegge
2025-10-25 16:48:28 -07:00
parent d301ac68ed
commit 36490a1648

View File

@@ -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