feat: trigger homebrew tap sync after releases

.github/workflows/release.yml

@@ -105,3 +105,25 @@ jobs:
             drift-*.tar.gz.sha256
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  update-homebrew-tap:
+    name: Trigger Homebrew tap update
+    needs: [release]
+    runs-on: ubuntu-22.04
+    steps:
+      - name: Dispatch tap sync
+        env:
+          HOMEBREW_TAP_TOKEN: ${{ secrets.HOMEBREW_TAP_TOKEN }}
+        run: |
+          if [ -z "$HOMEBREW_TAP_TOKEN" ]; then
+            echo "HOMEBREW_TAP_TOKEN is not configured; skipping Homebrew tap dispatch"
+            exit 0
+          fi
+
+          curl -fsSL \
+            -X POST \
+            -H "Accept: application/vnd.github+json" \
+            -H "Authorization: Bearer ${HOMEBREW_TAP_TOKEN}" \
+            -H "X-GitHub-Api-Version: 2022-11-28" \
+            https://api.github.com/repos/fiberplane/homebrew-tap/dispatches \
+            -d '{"event_type":"drift-release","client_payload":{"version":"${{ github.ref_name }}"}}'

README.md

@@ -7,6 +7,14 @@ Any markdown file in your repo can declare anchors to code — specific files or
 
 ## Install
 
+### Homebrew
+
+```bash
+brew install fiberplane/tap/drift
+```
+
+### Shell installer
+
 ```bash
 curl -fsSL https://drift.fp.dev/install.sh | sh
 ```

docs/RELEASING.md

@@ -1,9 +1,9 @@
 ---
 drift:
   files:
-    - .github/workflows/release.yml@2d3a4080
-    - .github/workflows/ci.yml@2d3a4080
-    - cliff.toml@2d3a4080
+    - .github/workflows/release.yml@520863d6
+    - .github/workflows/ci.yml@520863d6
+    - cliff.toml@520863d6
 ---
 
 # Releasing
@@ -43,6 +43,15 @@ Types `chore`, `style`, and `ci` are excluded from changelogs. Merge commits are
    - Generates release notes with git-cliff (grouped by Features, Bug Fixes, Documentation, Refactor)
    - Cross-compiles for all 4 targets with Zig 0.15.2
    - Creates a GitHub release with the generated notes, all tarballs, and matching `.sha256` checksum files attached
+   - Optionally dispatches `fiberplane/homebrew-tap` to open or refresh the Homebrew formula PR for that tag
+
+### Homebrew tap updates
+
+`fiberplane/homebrew-tap` now generates `Formula/drift.rb` directly from GitHub Releases metadata, so there is no manual template rendering or SHA input step.
+
+- The tap repo can sync on a schedule, via manual `workflow_dispatch`, or via `repository_dispatch` from the drift release workflow.
+- `.github/workflows/release.yml` sends that dispatch when the `HOMEBREW_TAP_TOKEN` secret is configured in `fiberplane/drift`.
+- If the secret is missing, releases still succeed; the tap can be updated by running its sync workflow manually or waiting for the next scheduled run.
 
 ### CHANGELOG.md