Skip to content

Build macOS releases on a supported Apple silicon runner only - #56

Merged
JoshCLWren merged 1 commit into
mainfrom
fix-macos-runners
Aug 8, 2026
Merged

Build macOS releases on a supported Apple silicon runner only#56
JoshCLWren merged 1 commit into
mainfrom
fix-macos-runners

Conversation

@JoshCLWren

@JoshCLWren JoshCLWren commented Aug 8, 2026

Copy link
Copy Markdown
Owner

The v0.1.2 release hung with build-macos (x86_64, macos-13) queued for 16+ minutes and no runner to pick it up.

macos-13 has been retired from GitHub Actions, so that job could never start, and publish sat blocked behind it. macos-14, which the arm64 job used, is now flagged deprecated too. The arm64 build itself passed on its first real run, exercising uv sync --locked, make build, the run-from-/ smoke test, the Info.plist association check, and package-macos.sh.

Moves arm64 to macos-15 and drops Intel: Apple silicon covers every Mac sold since 2020, and Intel users can still make install from source. The matrix keeps its shape, so restoring Intel is a two-line entry with macos-15-intel (the current label; macos-26-intel also exists).

update-cask.sh followed suit. It required checksums for both architectures and would have failed outright on an arm-only release; the generated cask now carries a single sha256 and depends_on arch: :arm64.

After merge the v0.1.2 tag needs moving again to re-trigger the release.

Summary by CodeRabbit

  • Changes
    • macOS releases now provide an Apple silicon (arm64) artifact only.
    • Homebrew installation documentation has been updated to reflect Apple silicon support.
    • Intel Mac users are directed to build the application from source.
    • Homebrew cask metadata now targets Apple silicon exclusively.

The x86_64 job targeted macos-13, which GitHub has retired, so it queued
forever with no runner to pick it up and blocked publish behind it. The
arm64 job used macos-14, which is now deprecated.

Move arm64 to macos-15 and drop Intel entirely: Apple silicon covers every
Mac sold since 2020, and Intel users can build from source. The matrix keeps
its shape so Intel can be restored with a two-line entry.

Follow through in the cask generator, which required both architectures and
would have failed on an arm-only release.
@coderabbitai

coderabbitai Bot commented Aug 8, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

The macOS release workflow now builds only Apple Silicon artifacts. Homebrew cask generation uses ARM64 metadata. The README directs Intel users to build from source.

Changes

Apple Silicon macOS distribution

Layer / File(s) Summary
Apple Silicon release and cask configuration
.github/workflows/release.yml, scripts/update-cask.sh, README.md
The release matrix removes the Intel build and uses macos-15 for arm64. The cask uses fixed ARM64 paths, checksum data, and dependency metadata. The README documents Apple Silicon releases and source builds for Intel Macs.

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

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly summarizes the main change: macOS releases now build only on a supported Apple silicon runner.
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.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix-macos-runners

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

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

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.github/workflows/release.yml:
- Around line 87-89: Update the comment beside the macOS release matrix to
remove the inaccurate claim that Apple silicon covers every Mac sold since 2020.
Keep the arm64-only matrix unchanged and explain the intentional release policy:
Intel artifacts are omitted, while Intel users can build from source; retain the
note about re-adding the x86_64 runner if that policy changes.

In `@README.md`:
- Around line 74-75: Update the earlier macOS installation paragraph in
README.md to remove the stale claim that packages are unavailable; state that
Apple silicon macOS releases are available, while Intel Mac users must build
from source with make install. Keep the surrounding installation guidance
unchanged.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 73caadd2-ead6-4205-9789-3a6ca7f3321b

📥 Commits

Reviewing files that changed from the base of the PR and between 365f838 and 9feafae.

📒 Files selected for processing (3)
  • .github/workflows/release.yml
  • README.md
  • scripts/update-cask.sh

Comment on lines +87 to +89
# Intel is intentionally absent: Apple silicon covers every Mac sold
# since 2020, and Intel users can build from source. Re-add with
# "- arch: x86_64 / runner: macos-15-intel" if that changes.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Replace the incorrect hardware-history rationale.

Intel Macs remained in Apple’s lineup after 2020. Keep the arm64-only matrix, but describe the release policy instead of claiming that Apple silicon covers every Mac sold since 2020.

Suggested wording
-          # Intel is intentionally absent: Apple silicon covers every Mac sold
-          # since 2020, and Intel users can build from source. Re-add with
-          # "- arch: x86_64 / runner: macos-15-intel" if that changes.
+          # Intel is intentionally absent from this release. Intel users can
+          # build from source. Add an Intel matrix entry when a supported
+          # runner is available.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
# Intel is intentionally absent: Apple silicon covers every Mac sold
# since 2020, and Intel users can build from source. Re-add with
# "- arch: x86_64 / runner: macos-15-intel" if that changes.
# Intel is intentionally absent from this release. Intel users can
# build from source. Add an Intel matrix entry when a supported
# runner is available.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @.github/workflows/release.yml around lines 87 - 89, Update the comment
beside the macOS release matrix to remove the inaccurate claim that Apple
silicon covers every Mac sold since 2020. Keep the arm64-only matrix unchanged
and explain the intentional release policy: Intel artifacts are omitted, while
Intel users can build from source; retain the note about re-adding the x86_64
runner if that policy changes.

Comment thread README.md
Comment on lines +74 to +75
publishes for Apple silicon. Intel Macs get no release asset; build from source
with `make install` instead. Because the app is ad-hoc signed rather than

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Remove the stale statement that macOS packages are unavailable.

The earlier installation paragraph still says that packaged macOS releases are not available. That conflicts with the arm64 archive published by the workflow and with this cask section. Update the earlier paragraph to state that Apple silicon macOS releases are available and Intel users must build from source.

🧰 Tools
🪛 LanguageTool

[uncategorized] ~74-~74: Did you mean the proper noun “Apple Silicon”?
Context: ...ndle the release workflow publishes for Apple silicon. Intel Macs get no release asset; build...

(APPLE_PRODUCTS)

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@README.md` around lines 74 - 75, Update the earlier macOS installation
paragraph in README.md to remove the stale claim that packages are unavailable;
state that Apple silicon macOS releases are available, while Intel Mac users
must build from source with make install. Keep the surrounding installation
guidance unchanged.

@JoshCLWren
JoshCLWren merged commit d4c99bf into main Aug 8, 2026
7 checks passed
@JoshCLWren
JoshCLWren deleted the fix-macos-runners branch August 8, 2026 18:06
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