Repository navigation
docs(release): describe a formula that lands without a bottle - #176
Open
brettdavies wants to merge 1 commit into
Open
brettdavies wants to merge 1 commit into
brettdavies wants to merge 1 commit into
Conversation
The tap installs and tests the `agentnative` formula from the archives a release publishes and lands the bump as one commit, with no bottle. The release documents described a bottle build, a bottle upload back to this repository's release, and a bottle attestation check. - `RELEASES.md` and `RELEASES-RATIONALE.md` state what the tap does with a release and why the release stays not-latest until the formula lands. The Homebrew rollback reverts one commit. - `RELEASES-POSTFLIGHT.md` names the tap workflow `Publish formula`, checks an archive install where it checked a bottle, and drops the `brew verify` gate, which reads bottles. - `README.md` says the formula installs the archive by checksum and points at the tap's "Verifying an archive". - `scripts/SYNCS.md` shows the tap downloading and verifying the release's archives, with nothing uploaded back. - The header comments of `release.yml` and `finalize-release.yml` give the pipeline as it runs, and say the `build` job is the one place a release compiles.
brettdavies
added this pull request to stack #177
October 8, 2026 22:27
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
The release documents describe what the tap does with an
ancrelease: it installs and tests theagentnativeformula from the archives the release publishes, on four platforms, and lands the bump as one commit with no bottle. They described a bottle build, a bottle upload back to this repository's release, and a bottle attestation check.RELEASES.mdandRELEASES-RATIONALE.md: what the tap does with a release, and why the GitHub Release stays not-latest until the formula lands. The Homebrew rollback reverts one commit; a release published with a bottle (0.6.0 and earlier) has a second.RELEASES-POSTFLIGHT.md: the tap workflow isPublish formula, the Homebrew gate checks an archive install, and thebrew verifygate is gone because it reads bottles. The archive attestation gate is unchanged.README.md: the Homebrew paragraph says the formula installs the release archive by checksum, and links the tap's "Verifying an archive".scripts/SYNCS.md: the tap downloads and verifies the release's archives and uploads nothing back.release.ymlandfinalize-release.ymlgive the pipeline as it runs, and name thebuildjob as the one place a release compiles its binaries.Changelog
Documentation
Type of Change
feat: New feature (non-breaking change which adds functionality)fix: Bug fix (non-breaking change which fixes an issue)refactor: Code refactoring (no functional changes)perf: Performance improvementdocs: Documentation updatetest: Adding or updating testschore: Maintenance tasks (dependencies, config, etc.)ci: CI/CD configuration changesstyle: Code style/formatting changesbuild: Build system changesBREAKING CHANGE: Breaking API change (requires major version bump)Related Issues/Stories
RELEASES-RATIONALE.md§ Whymake_latest: falsethenfinalize-releasemainbefore the release that carries these documents. chore(release): take the postflight tap gate from the template #175 brings the postflight gate that knows thePublish formulaname.Testing
Test Summary:
markdownlint-cli2andactionlintare clean on the changed files.Files Modified
Modified:
RELEASES.md,RELEASES-RATIONALE.md,RELEASES-POSTFLIGHT.mdREADME.mdscripts/SYNCS.md.github/workflows/release.yml,.github/workflows/finalize-release.yml: header comments only.Created:
Renamed:
Deleted: