From 48a2632be0833864c40879fb6b865e7fed610720 Mon Sep 17 00:00:00 2001 From: matt wilkie Date: Wed, 1 Jul 2026 22:59:50 -0700 Subject: [PATCH] fix(release): branch install header for prerelease vs stable (#4530) Why: prerelease (RC) GitHub releases shipped the single static stable install header, so three of four documented methods (brew, install.sh, install.ps1) silently install the latest STABLE release instead of the RC. Only the manual asset download actually fetched the prerelease. What: gate release.header on goreleaser's `{{ if .Prerelease }}`. The prerelease branch emits RC-appropriate instructions (manual asset download + `go install ...@v{{ .Version }}`) and notes that stable channels keep serving the latest stable release. The else (stable) branch keeps the existing header content verbatim. Agent-Signature: claude-opus-4-8-high on behalf of matt wilkie --- .goreleaser.yml | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/.goreleaser.yml b/.goreleaser.yml index 1e3f63173..9ce3cc995 100644 --- a/.goreleaser.yml +++ b/.goreleaser.yml @@ -196,7 +196,28 @@ release: ## beads v{{.Version}} Pre-compiled binaries for Linux, macOS (Intel & Apple Silicon), Windows (AMD64 & ARM64), Android/Termux (ARM64), and FreeBSD. + {{ if .Prerelease }} + ### Installation (release candidate) + > **This is a prerelease for validation.** The stable install channels — + > Homebrew, the `install.sh` / `install.ps1` scripts, npm, and PyPI — + > intentionally keep serving the latest **stable** release, so they will **not** + > install this RC. Use one of the methods below. + + **Manual download (recommended):** + Download the archive for your platform from the **Assets** below, extract it, + and place `bd` on your PATH. + + **Go install (pinned to this RC):** + ```bash + go install github.com/steveyegge/beads/cmd/bd@v{{ .Version }} + # For embedded Dolt support: + CGO_ENABLED=1 GOFLAGS=-tags=gms_pure_go go install github.com/steveyegge/beads/cmd/bd@v{{ .Version }} + ``` + + When you are done validating, return to the stable release through your normal + channel (e.g. `brew upgrade beads`). + {{ else }} ### Installation **Homebrew (macOS/Linux):** @@ -216,6 +237,7 @@ release: **Manual Install:** Download the appropriate binary for your platform below, extract it, and place it in your PATH. + {{ end }} # Announce the release announce: