Retire legacy Homebrew tap publishing (#4478)

* Retire legacy Homebrew tap publishing

Stop the release workflow from publishing the independent bd tap formula, and document Homebrew core beads as the supported Homebrew package with migration commands for legacy tap users.

Agent-Signature: codex-gpt-5.5-medium on behalf of matt wilkie

* Sync beads-mcp uv.lock with pyproject version

CI Package Gate (MCP) fails on `uv sync --all-groups --locked` because
integrations/beads-mcp/uv.lock still pins the editable package at 1.0.5
while pyproject.toml declares 1.1.0-rc.1. This drift exists on
upstream/main itself, not from this branch (PR #4478 only retires the
legacy Homebrew tap and touches no MCP package files), so the branch is
already on top of the latest upstream/main and a rebase cannot resolve it.

Regenerate the lockfile with `uv lock`. The only change is the package's
own version (1.0.5 -> 1.1.0rc1); no dependency versions change.

Agent-Signature: claude-opus-4-8-high on behalf of matt wilkie
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
matt wilkie 2026-06-22 19:26:46 -07:00 • committed by GitHub
commit c86acb0d73
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
7 changed files with 39 additions and 103 deletions

View file

@ -338,106 +338,6 @@ jobs:
subject-checksums: ${{ steps.assets.outputs.checksums }}
sbom-path: ${{ steps.assets.outputs.sbom }}
update-homebrew-formula:
# Generate Homebrew formula after all archives (Linux + macOS) are uploaded.
if: ${{ github.repository == 'gastownhall/beads' && startsWith(github.ref, 'refs/tags/v') && !contains(github.ref_name, '-') }}
needs: [goreleaser, goreleaser-macos, attest-release]
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v6
- name: Extract version from tag
id: version
run: echo "version=${GITHUB_REF_NAME#v}" >> "$GITHUB_OUTPUT"
- name: Mint Homebrew tap token
id: homebrew-token
uses: actions/create-github-app-token@bcd2ba49218906704ab6c1aa796996da409d3eb1 # v3
with:
app-id: ${{ secrets.HOMEBREW_TAP_APP_ID }}
private-key: ${{ secrets.HOMEBREW_TAP_APP_PRIVATE_KEY }}
owner: gastownhall
repositories: homebrew-beads
permission-contents: write
- name: Generate and push Homebrew formula
env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
HOMEBREW_TAP_TOKEN: ${{ steps.homebrew-token.outputs.token }}
run: |
version="${{ steps.version.outputs.version }}"
tag="v${version}"
base_url="https://github.com/gastownhall/beads/releases/download/${tag}"
# Download checksums (same repo, no --repo needed)
gh release download "${tag}" --pattern checksums.txt --dir /tmp
checksums_file="/tmp/checksums.txt"
get_sha256() {
local sha
sha=$(grep "$1" "$checksums_file" | awk '{print $1}')
if [ -z "$sha" ]; then
echo "ERROR: missing checksum for $1" >&2
exit 1
fi
echo "$sha"
}
darwin_arm64_sha=$(get_sha256 "beads_${version}_darwin_arm64.tar.gz")
darwin_amd64_sha=$(get_sha256 "beads_${version}_darwin_amd64.tar.gz")
linux_amd64_sha=$(get_sha256 "beads_${version}_linux_amd64.tar.gz")
linux_arm64_sha=$(get_sha256 "beads_${version}_linux_arm64.tar.gz")
cat > /tmp/bd.rb <<FORMULA
# typed: false
# frozen_string_literal: true
class Bd < Formula
desc "AI-supervised issue tracker for coding workflows"
homepage "https://github.com/gastownhall/beads"
version "${version}"
license "MIT"
on_macos do
if Hardware::CPU.arm?
url "${base_url}/beads_${version}_darwin_arm64.tar.gz"
sha256 "${darwin_arm64_sha}"
else
url "${base_url}/beads_${version}_darwin_amd64.tar.gz"
sha256 "${darwin_amd64_sha}"
end
end
on_linux do
if Hardware::CPU.arm?
url "${base_url}/beads_${version}_linux_arm64.tar.gz"
sha256 "${linux_arm64_sha}"
else
url "${base_url}/beads_${version}_linux_amd64.tar.gz"
sha256 "${linux_amd64_sha}"
end
end
def install
bin.install "bd"
end
end
FORMULA
# Strip leading whitespace from heredoc (YAML run: block indentation)
sed -i 's/^ //' /tmp/bd.rb
# Push formula to homebrew tap
cd /tmp
git clone "https://x-access-token:${HOMEBREW_TAP_TOKEN}@github.com/gastownhall/homebrew-beads.git"
cp bd.rb homebrew-beads/Formula/bd.rb
cd homebrew-beads
git config user.name "github-actions[bot]"
git config user.email "github-actions[bot]@users.noreply.github.com"
git add Formula/bd.rb
git commit -m "bd ${version}" || echo "No changes to commit"
git push
publish-pypi:
runs-on: ubuntu-latest
needs: [release-package-mcp, goreleaser]

View file

@ -81,7 +81,7 @@ Contributors: coffeegoddd (Dustin Brown / DoltHub), matt wilkie (maphew), harry-
## Upgrade
```bash
brew upgrade bd
brew upgrade beads
# or
curl -fsSL https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh | bash
```

View file

@ -267,7 +267,13 @@ gh release create v0.22.0 \
## 3. Homebrew Update
Homebrew formula is now in homebrew-core. Updates are handled automatically via GitHub Release artifacts.
Homebrew uses the `beads` formula in homebrew-core. Do not publish or revive
the old `bd` formula in `gastownhall/homebrew-beads`; having two independently
updated Homebrew formulas causes version drift and installs the wrong binary for
some users.
Updates to the supported Homebrew formula are handled through Homebrew core
after GitHub Release artifacts are available.
### Verify Homebrew

View file

@ -39,6 +39,16 @@ Beads has several components - here's what they are and when you need them:
brew install beads
```
Homebrew core's `beads` formula is the supported Homebrew package. If you
previously installed the old tap formula as `bd`, migrate to the core formula:
```bash
brew uninstall bd
brew untap gastownhall/beads 2>/dev/null || true
brew untap steveyegge/beads 2>/dev/null || true
brew install beads
```
**Why Homebrew?**
- ✅ Simple one-command install
- ✅ Automatic updates via `brew upgrade`

View file

@ -80,7 +80,7 @@ wheels = [
[[package]]
name = "beads-mcp"
version = "1.0.5"
version = "1.1.0rc1"
source = { editable = "." }
dependencies = [
{ name = "fastmcp" },

View file

@ -16,6 +16,16 @@ Complete installation guide for all platforms.
brew install beads
```
Homebrew core's `beads` formula is the supported Homebrew package. If you
previously installed the old tap formula as `bd`, migrate to the core formula:
```bash
brew uninstall bd
brew untap gastownhall/beads 2>/dev/null || true
brew untap steveyegge/beads 2>/dev/null || true
brew install beads
```
**Why Homebrew?**
- Simple one-command install
- Automatic updates via `brew upgrade`

View file

@ -52,6 +52,16 @@ irm https://raw.githubusercontent.com/gastownhall/beads/main/install.ps1 | iex
brew upgrade beads
```
If you still have the old tap formula installed as `bd`, switch to the
Homebrew core formula:
```bash
brew uninstall bd
brew untap gastownhall/beads 2>/dev/null || true
brew untap steveyegge/beads 2>/dev/null || true
brew install beads
```
### go install
```bash