fix: publish Homebrew formula via PR

[leonid-shevtsov]

What & why

mailtrap/homebrew-local main requires pull requests, so goreleaser's direct Contents API push fails the release after GitHub/Docker already published.

Enable brews.repository.pull_request so tagged releases open a formula PR instead of writing main directly.

How to test

• On next v* tag release, goreleaser opens a PR in mailtrap/homebrew-local updating Formula/mailtrap-local.rb
• Merge that tap PR and confirm the formula points at the new tarball checksums

Summary by CodeRabbit

• New Features

  • Homebrew formula updates now arrive as pull requests for each tagged release, improving visibility and reviewability.

• Documentation

  • Updated release workflow and repository documentation to explain the new Homebrew pull request process and token access requirements.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: fe5d3749-cf9a-4489-89b9-1cde40c35c4d

📥 Commits

Reviewing files that changed from the base of the PR and between f2f74b5 and 1505260.

📒 Files selected for processing (3)

• .github/workflows/release.yml
• .goreleaser.yaml
• README.md

---

📝 Walkthrough

Walkthrough

Goreleaser is configured to open Homebrew tap pull requests on tagged releases using HOMEBREW_TAP_TOKEN. Release workflow comments and the README now describe this behavior and the narrowed GITHUB_TOKEN scope.

Changes

Homebrew release flow

Layer / File(s)	Summary
Configure Homebrew pull requests .goreleaser.yaml	Homebrew tap updates use HOMEBREW_TAP_TOKEN, enable pull requests, and no longer specify the main branch.
Align release guidance .github/workflows/release.yml, README.md	Workflow comments and repository documentation state that Goreleaser opens a formula pull request for each tag and clarify token usage.

Estimated code review effort: 2 (Simple) | ~10 minutes

Suggested reviewers: sergeykorolev

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly matches the main change: switching Homebrew formula publishing to a pull request.
Description check	✅ Passed	The description covers motivation and testing, but it omits the template's explicit Changes section and the Images/GIFs section.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 Checkov (3.3.8)

.github/workflows/release.yml

Traceback (most recent call last):
File "/usr/local/bin/checkov", line 2, in
from checkov.main import Checkov
ModuleNotFoundError: No module named 'checkov'

.goreleaser.yaml

Traceback (most recent call last):
File "/usr/local/bin/checkov", line 2, in
from checkov.main import Checkov
ModuleNotFoundError: No module named 'checkov'

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}