Skip to content

fix(release): stop generating a redundant version stanza in the brew formula - #1078

Merged
Dumbris merged 1 commit into
mainfrom
fix/homebrew-formula-redundant-version
Aug 29, 2026
Merged

Dumbris merged 1 commit into
mainfrom
fix/homebrew-formula-redundant-version

Conversation

@Dumbris

@Dumbris Dumbris commented Aug 28, 2026

Copy link
Copy Markdown
Member

The Homebrew tap's brew style + audit workflow has failed on every release since v0.53.0 (2026-08-05) — eleven consecutive, most recently on v0.62.0:

smart-mcp-proxy/mcpproxy/mcpproxy
  * Stable: `version 0.62.0` is redundant with version scanned from URL

Cause

Every url in the generated formula already embeds the version, so Homebrew scans it from the URL and rejects the explicit version stanza as redundant. Brew turned this into a hard audit error somewhere between 2026-07-24 (v0.52.1, the last green run) and 2026-08-05 — exactly where the streak begins. I confirmed the cause is byte-identical across v0.62.0, v0.61.0, v0.60.0 and v0.59.0, so it is one persistent issue, not a series.

Impact

Installs were never affected. The audit is a lint gate in the tap repo that runs after the formula is committed and pushed, so it never gated publication — the tap has had correct URLs and sha256s throughout.

What it did do is leave the tap permanently red, which is the condition under which a genuine formula regression would go unnoticed.

Fix

Drop the version stanza from the generator, with a comment explaining why it must not come back. version stays available to the formula's own test do assert_match version.to_s — it is derived from the URL, not absent.

Verification

Reproduced the failure locally by symlinking the checked-out tap into Homebrew's Taps dir (the same thing the tap workflow does), then re-ran the three commands that workflow uses:

command before after
brew style smart-mcp-proxy/mcpproxy pass pass — no offenses
brew audit --tap … --cask --online mcpproxy pass pass — exit 0
brew audit --tap … --formula --online mcpproxy fail pass — exit 0
brew info --json=v2 … version 0.62.0 0.62.0 (scanned from URL)

I also diffed this generator's rendered output — heredoc extracted and run through the same sed substitutions with the real v0.62.0 shas — against the formula I audited green: identical.

Local Homebrew state was restored afterwards (the tap was not previously installed, and the symlink was removed).

Companion change

The tap's checked-in v0.62.0 formula is already fixed in smart-mcp-proxy/homebrew-mcpproxy@162cf39, so the current release is clean too, not just the next one. This PR stops the generator reintroducing the stanza at v0.63.0.

…w formula

The tap's `brew style + audit` workflow has failed on EVERY release since
v0.53.0 (2026-08-05) — eleven consecutive — with:

    smart-mcp-proxy/mcpproxy/mcpproxy
      * Stable: `version 0.62.0` is redundant with version scanned from URL

Every url in the generated formula already embeds the version, so Homebrew
scans it from the URL. Brew turned the redundant explicit stanza into a hard
audit error somewhere between 2026-07-24 (v0.52.1, the last green run) and
2026-08-05, which is exactly where the streak begins.

Installs were never affected: the audit is a lint gate in the tap repo that
runs AFTER the formula is committed and pushed, so it never gated
publication. What it did do is leave the tap permanently red — the condition
under which a real formula regression would go unnoticed.

`version` remains available to the formula's own `test do assert_match
version.to_s` — it is derived from the URL, not absent.

Verified by reproducing the failure locally against the checked-out tap and
re-running the three commands the tap workflow uses:

  brew style smart-mcp-proxy/mcpproxy                           -> no offenses
  brew audit --tap smart-mcp-proxy/mcpproxy --cask --online     -> exit 0
  brew audit --tap smart-mcp-proxy/mcpproxy --formula --online  -> exit 0
  brew info --json=v2 ...                                       -> version 0.62.0

and by diffing this generator's rendered output against that audited-green
formula byte for byte.

The tap's checked-in v0.62.0 formula is fixed in
smart-mcp-proxy/homebrew-mcpproxy@162cf39, so the current release is clean
too — not just the next one.
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying mcpproxy-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 3313615
Status: ✅  Deploy successful!
Preview URL: https://5e7b7a0c.mcpproxy-docs.pages.dev
Branch Preview URL: https://fix-homebrew-formula-redunda.mcpproxy-docs.pages.dev

View logs

@codecov-commenter

Copy link
Copy Markdown

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@github-actions

Copy link
Copy Markdown
Contributor

📦 Build Artifacts

Workflow Run: View Run
Branch: fix/homebrew-formula-redundant-version

Available Artifacts

  • archive-darwin-amd64 (29 MB)
  • archive-darwin-arm64 (26 MB)
  • archive-linux-amd64 (17 MB)
  • archive-linux-arm64 (15 MB)
  • archive-windows-amd64 (29 MB)
  • archive-windows-arm64 (26 MB)
  • frontend-dist-pr (0 MB)
  • installer-dmg-darwin-amd64 (23 MB)
  • installer-dmg-darwin-arm64 (21 MB)

How to Download

Option 1: GitHub Web UI (easiest)

  1. Go to the workflow run page linked above
  2. Scroll to the bottom "Artifacts" section
  3. Click on the artifact you want to download

Option 2: GitHub CLI

gh run download 33194701750 --repo smart-mcp-proxy/mcpproxy-go

Note: Artifacts expire in 14 days.

@Dumbris
Dumbris merged commit 172f7f4 into main Aug 29, 2026
37 checks passed
@Dumbris
Dumbris deleted the fix/homebrew-formula-redundant-version branch August 29, 2026 10:59
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.

2 participants