Skip to content

docs(release): describe a formula that lands without a bottle - #176

Open
brettdavies wants to merge 1 commit into
ci/release-matrix-builds-oncefrom
docs/release-formula-without-bottles
Open

brettdavies wants to merge 1 commit into
ci/release-matrix-builds-oncefrom
docs/release-formula-without-bottles

Conversation

@brettdavies

Copy link
Copy Markdown
Owner

Summary

The release documents describe what the tap does with an anc release: it installs and tests the agentnative formula 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.md and RELEASES-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 is Publish formula, the Homebrew gate checks an archive install, and the brew verify gate 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.
  • The header comments of release.yml and finalize-release.yml give the pipeline as it runs, and name the build job as the one place a release compiles its binaries.

Changelog

Documentation

  • Document that the Homebrew formula installs the release's archive directly, with no bottle, and where to verify an archive against its attestation.

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 improvement
  • docs: Documentation update
  • test: Adding or updating tests
  • chore: Maintenance tasks (dependencies, config, etc.)
  • ci: CI/CD configuration changes
  • style: Code style/formatting changes
  • build: Build system changes
  • BREAKING CHANGE: Breaking API change (requires major version bump)

Related Issues/Stories

Testing

  • Unit tests added/updated
  • Integration tests added/updated
  • Manual testing completed
  • All tests passing

Test Summary:

  • Documentation and workflow comments only. markdownlint-cli2 and actionlint are clean on the changed files.

Files Modified

Modified:

  • RELEASES.md, RELEASES-RATIONALE.md, RELEASES-POSTFLIGHT.md
  • README.md
  • scripts/SYNCS.md
  • .github/workflows/release.yml, .github/workflows/finalize-release.yml: header comments only.

Created:

  • None.

Renamed:

  • None.

Deleted:

  • None.

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
brettdavies added this pull request to stack #177 October 8, 2026 22:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant