docs(release): gate Homebrew availability claims

[benvinegar]

Summary

• add an announcement-only Homebrew readiness check that never blocks release publication or completion
• query the live formula API and pending Autobump PRs before making a promotional availability claim
• derive the next nominal scan from Homebrew's current workflow schedule
• clarify that exact-version hunk update guidance does not apply to Homebrew

Validation

• bun run check:docs
• bun run format:check
• git diff --check
• executed the documented formula and Autobump schedule probes against Homebrew

This PR description was generated by Pi using GPT-5.6 Sol

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated
hunk-web	Ignored	Preview	Sep 10, 2026 3:11pm UTC

[greptile-apps]

Greptile Summary

This PR strengthens the release procedure around Homebrew propagation.

• Restricts exact-version update guidance to npm- and curl-managed installations.
• Requires live Homebrew formula and local metadata verification before announcing availability.
• Adds diagnostic checks for pending Autobump work and its current schedule.
• Adds an empty changeset for the documentation-only release-process change.

Confidence Score: 5/5

The documentation-only pull request appears safe to merge.

The revised commands and guidance are consistent with the updater’s install-method behavior, and the live formula checks prevent Homebrew availability from being announced prematurely.

Important Files Changed

Filename	Overview
skills/hunk-release/SKILL.md	Adds consistent, fail-visible Homebrew readiness checks and install-method-specific upgrade guidance.
.changeset/tender-ravens-wait.md	Records the documentation-only change without requesting a package version bump.

_{Reviews (1): Last reviewed commit: "docs(release): gate Homebrew availabilit..." | Re-trigger Greptile}