Skip to content

docs: Record the Homebrew tap shape for the macOS app - #1259

Merged
omesser merged 4 commits into
mainfrom
cursor/research-homebrew-release-shape-e12a
Oct 2, 2026
Merged

omesser merged 4 commits into
mainfrom
cursor/research-homebrew-release-shape-e12a

Conversation

@omesser

@omesser omesser commented Oct 2, 2026 •

Copy link
Copy Markdown
Owner

Why

#1204 has merged. The research note still described unpublished gaps from before that merge, including a raw cask URL and a tap that lagged the pull request tip. Those claims are false on main, and leaving them in the repo would record a review that the merge already settled.

What changed

docs/research/homebrew-release-shape.md describes the merged tree at 207fe9f0. It keeps the durable findings: a third-party tap plus a .app disk-image cask is the shape for this ad-hoc-signed build, why homebrew/cask stays closed, how brew tap omesser/fidget clones omesser/homebrew-fidget, the install line brew install --cask omesser/fidget/fidget, and the Release job that pushes the tap with HOMEBREW_TAP_DEPLOY_KEY.

Homebrew sends a native macOS .app on a disk image to a cask, and open-source command-line software to a formula in homebrew/core. Fidget ships Fidget.app via DMG, so the package is a cask in a third-party tap, not a formula.

The pre-merge gap list is gone. tests/research-anchors.test.js is unchanged: it does not name this note's sources, and the note no longer cites line numbers. The preamble still names 207fe9f0.

How to verify

Read the note against packaging/homebrew/Casks/fidget.rb, docs/DEVELOPMENT.md ("Homebrew"), and the homebrew job in .github/workflows/release.yml at 207fe9f0.

node --test tests/research-anchors.test.js

Notes

Does not merge. #1204 is already on main.

— Cursor agent, on @omesser's behalf.

Open in Web Open in Cursor 

Co-authored-by: Oded Messer <odedmesser@gmail.com>
@omesser
omesser marked this pull request as ready for review October 2, 2026 05:13
cursoragent and others added 2 commits October 2, 2026 05:20
Co-authored-by: Oded Messer <odedmesser@gmail.com>
Co-authored-by: Oded Messer <odedmesser@gmail.com>
@cursor cursor Bot changed the title docs: Record the Homebrew cask shape against upstream docs docs: Record the Homebrew tap shape for the macOS app Oct 2, 2026

@omesser omesser left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Soft CLEARED Soft (a) settling

Tip 4bb4efb82cd17458c9aae5085741aba009376eb3 on cursor/research-homebrew-release-shape-e12a.

Soft ledger

  • (a) CI/checks — Settling (no reds; windows still in progress; build / renderer / checks (ubuntu-latest) / checks (macos-latest) success; deploy skipped)
  • (b) scope/intent — Met (single file docs/research/homebrew-release-shape.md; durable Homebrew shape after #1204)
  • (c) correctness vs claim — Met (packaging/homebrew/Casks/fidget.rb, docs/DEVELOPMENT.md Homebrew, release homebrew job + HOMEBREW_TAP_DEPLOY_KEY / bump-verify-publish / sync-tap-tag, and signingIdentity: "-" match; obsolete raw-URL / tap-lag gaps absent)
  • (d) docs/tests anchors — Met (preamble pins 207fe9f0; no line-number cites; tests/research-anchors.test.js unchanged)
  • (e) hygiene — Met (no Closes; notes #1204 already on main)

Soft-FIX: None

— Cursor agent (Architect), on @omesser's behalf.

@omesser omesser left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Soft CLEARED confirm Soft

Tip 4bb4efb82cd17458c9aae5085741aba009376eb3 on cursor/research-homebrew-release-shape-e12a.

Flip: Soft CLEARED Soft (a) settling COMMENT 5388556079 → Soft CLEARED confirm Soft (Soft (a) now fully green).

Soft ledger

  • (a) CI/checks — Met (MERGEABLE/CLEAN; PR Tests success — build / renderer / windows / checks (ubuntu-latest) / checks (macos-latest); Pages build success / deploy skipped)
  • (b) scope/intent — Met (single file docs/research/homebrew-release-shape.md; durable Homebrew shape after #1204)
  • (c) correctness vs claim — Met (packaging/homebrew/Casks/fidget.rb, docs/DEVELOPMENT.md Homebrew, release homebrew job + HOMEBREW_TAP_DEPLOY_KEY / bump-verify-publish / sync-tap-tag, and signingIdentity: "-" match; obsolete raw-URL / tap-lag gaps absent)
  • (d) docs/tests anchors — Met (preamble pins 207fe9f0; no line-number cites; tests/research-anchors.test.js unchanged)
  • (e) hygiene — Met (no Closes; notes #1204 already on main)

Soft-FIX: None

— Cursor agent (Architect), on @omesser's behalf.

Co-authored-by: Oded Messer <odedmesser@gmail.com>

@omesser omesser left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Soft CLEARED Soft (a) settling

Tip c946307bd075a523cce21ac0c2b460315f04c100 on cursor/research-homebrew-release-shape-e12a (moved from Soft CLEARED confirm Soft COMMENT 5388564023 at 4bb4efb82cd17458c9aae5085741aba009376eb3).

Tip delta: c946307bd075 — drop named DVC formula example; keep generalized cask-vs-formula rule for Fidget.app.

Soft ledger

  • (a) CI/checks — Settling (no reds; renderer success; windows / checks (ubuntu-latest) / checks (macos-latest) / Pages build in progress; deploy not yet; mergeable unstable)
  • (b) scope/intent — Met (single file docs/research/homebrew-release-shape.md; durable Homebrew shape after #1204; Oded ask for no named-CLI analogy met)
  • (c) correctness vs claim — Met (packaging/homebrew/Casks/fidget.rb, docs/DEVELOPMENT.md Homebrew, release homebrew job + HOMEBREW_TAP_DEPLOY_KEY / bump-verify-publish / sync-tap-tag, and signingIdentity: "-" match at 207fe9f0; obsolete raw-URL / tap-lag / DVC-named gaps absent)
  • (d) docs/tests anchors — Met (preamble pins 207fe9f0; no line-number cites; tests/research-anchors.test.js unchanged)
  • (e) hygiene — Met (no Closes; notes #1204 already on main)

Soft-FIX: None

— Cursor agent (Architect), on @omesser's behalf.

@omesser omesser left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Soft CLEARED Soft (a) settling

Tip c946307bd075a523cce21ac0c2b460315f04c100 on cursor/research-homebrew-release-shape-e12a.

Re-gate after tip move from Soft CLEARED tip 4bb4efb82cd17458c9aae5085741aba009376eb3 (COMMENT 5388564023 / Soft CLEARED Soft (a) settling 5388556079). Tip removes the DVC named-CLI example and states the formula-vs-cask rule in general terms.

Soft ledger

  • (a) CI/checks — Settling (no reds; windows still in progress; build / renderer / checks (ubuntu-latest) / checks (macos-latest) success; Pages build success / deploy skipped; MERGEABLE/unstable)
  • (b) scope/intent — Met (single file docs/research/homebrew-release-shape.md; durable Homebrew shape after #1204; tip delta is DVC removal + generalized formula vs cask)
  • (c) correctness vs claim — Met (packaging/homebrew/Casks/fidget.rb, docs/DEVELOPMENT.md Homebrew, release homebrew job + HOMEBREW_TAP_DEPLOY_KEY / bump-verify-publish / sync-tap-tag, and signingIdentity: "-" match; obsolete raw-URL / tap-lag gaps absent; no DVC mentions remain in tip)
  • (d) docs/tests anchors — Met (preamble pins 207fe9f0; no fidget line-number cites; tests/research-anchors.test.js unchanged)
  • (e) hygiene — Met (no Closes; notes #1204 already on main)

Soft-FIX: None

— Cursor agent (Architect), on @omesser's behalf.

@omesser
omesser merged commit 8ead768 into main Oct 2, 2026
6 checks passed
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