fix: ship the relocation fix to existing installs, document the real release flow

[cloudsmith-iduffy]

Follow-up to #28. Three small changes, no new tooling.

revision 1

The tap tracks the CLI's version, so a formula-only fix has no version of its own to ship under. Homebrew's revision covers exactly that: the package becomes 1.20.2_1 while the CLI still reports 1.20.2, so brew sees an upgrade and existing installs move onto the fixed formula.

Verified: brew outdated reports (1.20.2) < 1.20.2_1, brew upgrade reinstalls, brew style and brew audit stay clean.

Without it, anyone already on 1.20.2 keeps a keg built by the failed relocation — which aborts on the first failure, so the bundle is left partially rewritten.

publish-homebrew removes the line on the next release, since it overwrites the formula from its template. That is the correct lifetime: a revision belongs to one CLI version.

Release notes rollback instructions

They told users to roll back with brew install --formula ./cloudsmith-cli.rb, which current Homebrew refuses:

Error: Homebrew requires formulae to be in a tap, rejecting: ./cloudsmith-cli.rb

Now points at the pinned cloudsmith-cli@<version> formulae, which are installable, linkable and pinnable. Note this workflow only triggers on v* tags and the release automation opens a pull request without tagging, so it has not run since v1.14.0 — the fix is correct but dormant unless tagging resumes.

CONTRIBUTING.md and scripts/bump-cloudsmith-cli.sh

CONTRIBUTING documented the bump helper as the standard release process. That is no longer true — publish-homebrew in the CLI repo has owned this formula since 1.20.1 — and the helper had also stopped working: run against the current formula it aborts with Could not find formula url line, because its regexes expect a two-space indent while the urls now sit inside if OS.mac? branches. It also used sub against four url/sha256 pairs and never touched the version stanza, which is why recent bumps were hand-authored.

Following the documented process would have failed, so the helper is removed rather than repaired, and CONTRIBUTING now records what actually matters:

• the formula is generated, so a change to it must go into the upstream template or the next release drops it (see fix: stop Homebrew rewriting bundled dylib IDs on macOS cloudsmith-cli#335)
• the pinned formulae and the macOS workflow are what is maintained here
• the old setup instructions were unusable too, since brew install --formula ./path is rejected

🤖 Generated with Claude Code

[Copilot]

Pull request overview

• Ships a formula-only fix to existing installs by adding a Homebrew revision, and updates contributor/release documentation to reflect the current “generated formula” release flow and supported rollback paths.

Changes:

• Add revision 1 to Formula/cloudsmith-cli.rb so Homebrew treats the unchanged CLI version as an upgrade and reinstalls the fixed formula.
• Remove the now-broken/obsolete scripts/bump-cloudsmith-cli.sh helper and update CONTRIBUTING.md to document the upstream publish-homebrew template-driven process.
• Update release notes generation to describe rollback via pinned cloudsmith-cli@<version> formulae instead of brew install --formula ./....

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.

File	Description
scripts/bump-cloudsmith-cli.sh	Removes an outdated bump helper script that no longer matches the generated-formula workflow.
Formula/cloudsmith-cli.rb	Adds a Homebrew revision to push a formula-only fix to existing installs.
CONTRIBUTING.md	Re-documents the real release flow (upstream template) and correct local testing guidance inside a tap checkout.
.github/workflows/release.yml	Updates autogenerated release notes rollback instructions to avoid unsupported brew install --formula ./... usage.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.