Post-acceptance: update docs & comms when hookdeck lands in homebrew-core

[leggetter]

Trigger

hookdeck 2.2.0 (new formula) merged into Homebrew/homebrew-core on 2026-06-04 via #286152. See #295 for end-to-end history.

Status (2026-06-04)

Workstream	Status
GoReleaser config — stop publishing stable hookdeck.rb to tap	✅ #299 merged
README updates (macOS install, version-update model, troubleshooting, releasing)	✅ #299 merged
Tap repo: delete stale formulae + add tap_migrations.json	✅ hookdeck/homebrew-hookdeck#5 merged
Hookdeck.com docs	✅ updated (separate repo)
Hookdeck Console / Dashboard	⏳ PR open (separate repo)
Hookdeck Agent Skills	⏳ PR open (separate repo)
webhook-skills repo	✅ verified — no Hookdeck install references to update
webhooks.fyi repo	✅ verified — no Hookdeck install references to update
Next CLI release notes	⏳ next release
Onboarding emails / marketing pages / partner guides	⏳ owner-dependent
Internal announcement (support/sales/docs)	⏳ owner-dependent
Optional blog post	⏳ marketing decision
End-to-end verification walkthrough	✅ migration redirect + fresh install tested 2026-06-04

End-to-end test results (2026-06-04)

Validated on a clean install:

Test	Result
brew install hookdeck/hookdeck/hookdeck (qualified — checks tap_migrations.json redirect)	✅ Bottle pulled from homebrew-core, brew info shows From: Homebrew/homebrew-core/...
brew install hookdeck (unqualified)	✅ Bottle pulled from homebrew-core
brew install hookdeck/hookdeck/hookdeck-beta (beta unchanged)	✅ Resolves from hookdeck/hookdeck tap
hookdeck --version post-install	✅ hookdeck version 2.2.0

In-repo updates ✅

Merged in #299:

• README.md — recommends brew install hookdeck as primary macOS install path; tap demoted to beta-only.
• README.md — version-update model documented (BrewTestBot autobump explained).
• README.md — troubleshooting overhauled (tap-to-core migration, hookdeck/hookdeck-beta link conflict, beta tap-trust note).
• .goreleaser/mac.yml — brews block fixed to hookdeck-beta with skip_upload gated to pre-release tags.
• test-scripts/test-homebrew-build.sh + .github/workflows/test-homebrew-build.yml — validate hookdeck-beta.rb, drop stale deprecation reporting.

hookdeck/homebrew-hookdeck tap changes ✅

Merged in hookdeck/homebrew-hookdeck#5:

• Deleted hookdeck.rb (root stale duplicate)
• Deleted Formula/hookdeck.rb
• Added tap_migrations.json mapping hookdeck → homebrew/core
• Left Formula/hookdeck-beta.rb untouched

External updates

• hookdeck.com docs — updated (handled by maintainer separately)
• webhook-skills — audited; no Hookdeck install references found
• webhooks.fyi — audited; no Hookdeck install references found
• Hookdeck Console / Dashboard — PR open (separate repo)
• Hookdeck Agent Skills — PR open (separate repo)
• Marketing pages / landing pages / blog posts that reference brew install hookdeck/hookdeck/hookdeck
• Onboarding emails / sequences
• Third-party integration docs / partner guides

Comms

• Next CLI release notes — explicit announcement: "hookdeck is now in homebrew-core. Run brew install hookdeck (no tap needed). Existing tap users are auto-migrated."
• Internal announcement — let support, sales, and the docs team know the install command has changed.
• Optional blog post celebrating the homebrew-core landing.

What can close

Once the open external PRs (Console/Dashboard, Agent Skills) merge and the next CLI release lands with the release-notes callout, this issue can close. The optional blog post and ongoing audits (onboarding emails, partner guides) can be left open or split into a smaller follow-up.

References

• Parent: Submit hookdeck to homebrew-core for the stable channel #295 (homebrew-core submission)
• Context: Homebrew tap trust will become default — update install docs and release notes ahead of 5.2.0 #294 (Homebrew tap-trust default flip)
• In-repo PR: #299 (merged)
• Tap migration PR: hookdeck/homebrew-hookdeck#5 (merged)
• Homebrew-core formula: Formula/h/hookdeck.rb