ci(homebrew): Automate tap formula updates

Add a Homebrew formula generator script and release workflow automation that computes artifact SHAs, generates Formula/xcodebuildmcp.rb, and opens a PR in cameroncooke/homebrew-xcodebuildmcp when credentials are configured.

Keep the tap update flow token-gated and best-effort so releases continue when tap credentials are unavailable.

Co-Authored-By: Claude <noreply@anthropic.com>

Author: cameroncooke

.github/workflows/release.yml

@@ -339,3 +339,71 @@ jobs:
             dist/portable/universal/xcodebuildmcp-${{ needs.release.outputs.version }}-darwin-universal.tar.gz \
             dist/portable/universal/xcodebuildmcp-${{ needs.release.outputs.version }}-darwin-universal.tar.gz.sha256 \
             --clobber
+
+  update_homebrew_tap:
+    if: github.event_name == 'push'
+    needs: [release, publish_portable_assets]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+
+      - name: Download arm64 artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: portable-arm64
+          path: dist/portable/arm64
+
+      - name: Download x64 artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: portable-x64
+          path: dist/portable/x64
+
+      - name: Skip when tap token is unavailable
+        if: secrets.HOMEBREW_TAP_TOKEN == ''
+        run: echo "HOMEBREW_TAP_TOKEN is not set; skipping Homebrew tap update."
+
+      - name: Generate formula
+        if: secrets.HOMEBREW_TAP_TOKEN != ''
+        run: |
+          VERSION="${{ needs.release.outputs.version }}"
+          ARM64_SHA="$(awk '{print $1}' dist/portable/arm64/xcodebuildmcp-${VERSION}-darwin-arm64.tar.gz.sha256)"
+          X64_SHA="$(awk '{print $1}' dist/portable/x64/xcodebuildmcp-${VERSION}-darwin-x64.tar.gz.sha256)"
+          npm run homebrew:formula -- \
+            --version "$VERSION" \
+            --arm64-sha "$ARM64_SHA" \
+            --x64-sha "$X64_SHA" \
+            --out dist/homebrew/Formula/xcodebuildmcp.rb
+
+      - name: Create pull request in tap repo
+        if: secrets.HOMEBREW_TAP_TOKEN != ''
+        env:
+          GH_TOKEN: ${{ secrets.HOMEBREW_TAP_TOKEN }}
+        run: |
+          VERSION="${{ needs.release.outputs.version }}"
+          BRANCH="xcodebuildmcp-v${VERSION}"
+          git clone "https://x-access-token:${GH_TOKEN}@github.com/cameroncooke/homebrew-xcodebuildmcp.git" tap-repo
+          cp dist/homebrew/Formula/xcodebuildmcp.rb tap-repo/Formula/xcodebuildmcp.rb
+          cd tap-repo
+          if git diff --quiet Formula/xcodebuildmcp.rb; then
+            echo "Formula already up to date; skipping PR."
+            exit 0
+          fi
+          git checkout -b "$BRANCH"
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add Formula/xcodebuildmcp.rb
+          git commit -m "xcodebuildmcp ${VERSION}"
+          git push origin "$BRANCH"
+          gh pr create \
+            --repo cameroncooke/homebrew-xcodebuildmcp \
+            --title "Update xcodebuildmcp to ${VERSION}" \
+            --body "Automated formula update for xcodebuildmcp ${VERSION}." \
+            --base main \
+            --head "$BRANCH"

package.json

@@ -26,6 +26,7 @@
     "package:macos": "scripts/package-macos-portable.sh",
     "package:macos:universal": "scripts/package-macos-portable.sh --universal",
     "verify:portable": "scripts/verify-portable-install.sh",
+    "homebrew:formula": "scripts/create-homebrew-formula.sh",
     "lint": "eslint 'src/**/*.{js,ts}'",
     "lint:fix": "eslint 'src/**/*.{js,ts}' --fix",
     "format": "prettier --write 'src/**/*.{js,ts}'",

scripts/create-homebrew-formula.sh

@@ -0,0 +1,88 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+VERSION=""
+ARM64_SHA=""
+X64_SHA=""
+OUT_PATH=""
+
+usage() {
+  cat <<'EOF'
+Usage:
+  scripts/create-homebrew-formula.sh --version <semver> --arm64-sha <sha256> --x64-sha <sha256> [--out <path>]
+EOF
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --version)
+      VERSION="${2:-}"
+      shift 2
+      ;;
+    --arm64-sha)
+      ARM64_SHA="${2:-}"
+      shift 2
+      ;;
+    --x64-sha)
+      X64_SHA="${2:-}"
+      shift 2
+      ;;
+    --out)
+      OUT_PATH="${2:-}"
+      shift 2
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "Unknown argument: $1"
+      usage
+      exit 1
+      ;;
+  esac
+done
+
+if [[ -z "$VERSION" || -z "$ARM64_SHA" || -z "$X64_SHA" ]]; then
+  usage
+  exit 1
+fi
+
+FORMULA_CONTENT="$(cat <<EOF
+class Xcodebuildmcp < Formula
+  desc "Model Context Protocol server for Xcode project workflows"
+  homepage "https://github.com/cameroncooke/XcodeBuildMCP"
+  license "MIT"
+  version "$VERSION"
+
+  on_arm do
+    url "https://github.com/cameroncooke/XcodeBuildMCP/releases/download/v$VERSION/xcodebuildmcp-$VERSION-darwin-arm64.tar.gz"
+    sha256 "$ARM64_SHA"
+  end
+
+  on_intel do
+    url "https://github.com/cameroncooke/XcodeBuildMCP/releases/download/v$VERSION/xcodebuildmcp-$VERSION-darwin-x64.tar.gz"
+    sha256 "$X64_SHA"
+  end
+
+  def install
+    libexec.install Dir["*"]
+    bin.install_symlink libexec/"bin/xcodebuildmcp"
+    bin.install_symlink libexec/"bin/xcodebuildmcp-doctor"
+  end
+
+  test do
+    assert_match "xcodebuildmcp", shell_output("#{bin}/xcodebuildmcp --help")
+  end
+end
+EOF
+)"
+
+if [[ -n "$OUT_PATH" ]]; then
+  mkdir -p "$(dirname "$OUT_PATH")"
+  printf "%s\n" "$FORMULA_CONTENT" > "$OUT_PATH"
+else
+  printf "%s\n" "$FORMULA_CONTENT"
+fi
+