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 ```bash
./scripts/bump-version.sh 0.9.X --commit ./scripts/bump-version.sh 0.9.X --commit
git push origin main
``` ```
This updates: This updates:
@@ -65,6 +66,12 @@ This updates:
- `README.md` - `README.md`
- `PLUGIN.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 ## Publish to All Channels
### 1. Create Git Tag ### 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 ### 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: The formula needs the SHA256 of the tag tarball:
```bash ```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 curl -sL https://github.com/steveyegge/beads/archive/refs/tags/v0.9.X.tar.gz | shasum -a 256
# Clone tap repo (if not already) # Navigate to tap repo (if already cloned) or clone it
git clone https://github.com/steveyegge/homebrew-beads /tmp/homebrew-beads cd /tmp/homebrew-beads || 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"
# 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 # - url: https://github.com/steveyegge/beads/archive/refs/tags/v0.9.X.tar.gz
# - sha256: <computed SHA256> # - sha256: <computed SHA256>
@@ -130,13 +140,15 @@ git commit -m "Update bd formula to v0.9.X"
git push origin main git push origin main
``` ```
Install/upgrade locally with: **IMPORTANT**: Install/upgrade locally to verify:
```bash ```bash
brew update brew update
brew upgrade bd # Or: brew reinstall bd 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: **Note:** If you have an old bd binary from `go install` in your PATH, remove it to avoid conflicts:
```bash ```bash
# Find where bd is installed # Find where bd is installed