From c86acb0d733ab4cf0f46fa373c0882bf6c3c8728 Mon Sep 17 00:00:00 2001 From: matt wilkie Date: Mon, 22 Jun 2026 19:26:46 -0700 Subject: [PATCH] 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) --------- Co-authored-by: Claude Opus 4.8 (1M context) --- .github/workflows/release.yml | 100 ------------------- NEWSLETTER.md | 2 +- RELEASING.md | 8 +- docs/INSTALLING.md | 10 ++ integrations/beads-mcp/uv.lock | 2 +- website/docs/getting-started/installation.md | 10 ++ website/docs/getting-started/upgrading.md | 10 ++ 7 files changed, 39 insertions(+), 103 deletions(-) diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index b62b12c18..b3dd0ae83 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -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 </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` diff --git a/integrations/beads-mcp/uv.lock b/integrations/beads-mcp/uv.lock index 37e638023..7b03051bc 100644 --- a/integrations/beads-mcp/uv.lock +++ b/integrations/beads-mcp/uv.lock @@ -80,7 +80,7 @@ wheels = [ [[package]] name = "beads-mcp" -version = "1.0.5" +version = "1.1.0rc1" source = { editable = "." } dependencies = [ { name = "fastmcp" }, diff --git a/website/docs/getting-started/installation.md b/website/docs/getting-started/installation.md index 9a2827c22..798cae45f 100644 --- a/website/docs/getting-started/installation.md +++ b/website/docs/getting-started/installation.md @@ -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` diff --git a/website/docs/getting-started/upgrading.md b/website/docs/getting-started/upgrading.md index d6c8ec2ef..fd4231c83 100644 --- a/website/docs/getting-started/upgrading.md +++ b/website/docs/getting-started/upgrading.md @@ -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