homebrew-release

name	homebrew-release
description	Use when building, validating, publishing, or tap-rendering Homebrew formula tarball releases for this Swift project, including scripts/build-homebrew-release.sh, scripts/render-homebrew-formula.sh, and task build:homebrew or homebrew:formula commands.

Homebrew Release

Use this skill for Formula releases installed with:

brew tap @ign-var:HOMEBREW_TAP=user/tap@
brew install @ign-var:HOMEBREW_CASK_TOKEN={current_dir}@

Use .agents/skills/macos-cask-release/SKILL.md for signed and notarized Cask DMGs.

Release Contract

1. Confirm VERSION is the intended release version.
2. Build and test the Swift package.
3. Build macOS Homebrew tarballs with scripts/build-homebrew-release.sh.
4. Publish the tarballs to a GitHub Release only when explicitly requested.
5. Render the formula only after all referenced archives and checksums exist.
6. Update and verify the tap formula from the tap checkout.

The default Swift formula contract is macOS-only:

Homebrew platform	Release asset
macOS Apple Silicon	@ign-var:HOMEBREW_CASK_TOKEN={current_dir}@-<version>-darwin-arm64.tar.gz
macOS Intel	@ign-var:HOMEBREW_CASK_TOKEN={current_dir}@-<version>-darwin-x64.tar.gz

Do not add Linux assets unless the project has a reviewed Swift Linux runtime contract.

Standard Commands

Build:

task build
task test
task build:homebrew -- darwin-arm64 darwin-x64

Render locally:

version="$(tr -d '[:space:]' < VERSION)"
task homebrew:formula -- "$version"

Render into the default sibling tap:

version="$(tr -d '[:space:]' < VERSION)"
task homebrew:tap-formula -- "$version"

For a custom tap path:

version="$(tr -d '[:space:]' < VERSION)"
scripts/render-homebrew-formula.sh "$version" /path/to/homebrew-tap/Formula/@ign-var:HOMEBREW_CASK_TOKEN={current_dir}@.rb

Publishing Notes

Before rendering a formula for public use, ensure the GitHub Release assets exist:

version="$(tr -d '[:space:]' < VERSION)"
gh release view "v${version}" --repo @ign-var:GITHUB_REPOSITORY=user/repo@

If publishing is explicitly requested:

version="$(tr -d '[:space:]' < VERSION)"
gh release upload "v${version}" \
  "dist/homebrew/@ign-var:HOMEBREW_CASK_TOKEN={current_dir}@-${version}-darwin-arm64.tar.gz" \
  "dist/homebrew/@ign-var:HOMEBREW_CASK_TOKEN={current_dir}@-${version}-darwin-x64.tar.gz" \
  --repo @ign-var:GITHUB_REPOSITORY=user/repo@ \
  --clobber

Verification

From the tap checkout:

ruby -c Formula/@ign-var:HOMEBREW_CASK_TOKEN={current_dir}@.rb
brew audit --strict @ign-var:HOMEBREW_CASK_TOKEN={current_dir}@ || brew audit --strict --formula @ign-var:HOMEBREW_CASK_TOKEN={current_dir}@
brew install @ign-var:HOMEBREW_TAP=user/tap@/@ign-var:HOMEBREW_CASK_TOKEN={current_dir}@
@ign-var:EXECUTABLE_NAME={current_dir}@ --version
brew test @ign-var:HOMEBREW_TAP=user/tap@/@ign-var:HOMEBREW_CASK_TOKEN={current_dir}@

If online audit fails because of local GitHub credentials or rate limits, run a non-online audit and report the limitation.