docs(infrastructure): note Homebrew 6 tap-trust on the macOS Tahoe 26.5 stack#4
docs(infrastructure): note Homebrew 6 tap-trust on the macOS Tahoe 26.5 stack#4arcappcircle wants to merge 1 commit into
Conversation
📝 WalkthroughWalkthroughThis change adds a documentation caution callout to the iOS build infrastructure guide, describing Homebrew 6.x behavior on the macOS Tahoe 26.5.1 stack, required ChangesDocumentation update
Related PRs: None identified. Suggested labels: documentation Suggested reviewers: None identified. Poem
🚥 Pre-merge checks | ✅ 2✅ Passed checks (2 passed)
✨ Finishing Touches🧪 Generate unit tests (beta)
✨ Simplify code
Comment |
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 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 `@docs/infrastructure/ios-build-infrastructure.md`:
- Around line 132-143: Update the caution heading in the iOS build
infrastructure docs so it matches the stack version used in the body text and
tables. The issue is the heading references Tahoe 26.5 while the content refers
to 26.5.1; make the version consistent throughout that caution block so readers
can identify the correct macOS stack.
🪄 Autofix (Beta)
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: Organization UI
Review profile: CHILL
Plan: Pro
Run ID: e55c04d6-c4eb-4da0-905b-0a3e74bd9158
📒 Files selected for processing (1)
docs/infrastructure/ios-build-infrastructure.md
| :::caution Homebrew 6 on the macOS Tahoe `26.5` stack | ||
|
|
||
| The upcoming macOS **Tahoe `26.5.1`** stack ships **Homebrew 6.x** (up from `5.1.0` on the Tahoe `26.3.2` stack). Starting with Homebrew `6.0`, `brew` no longer installs formulae from **untrusted third-party taps** until the tap is explicitly trusted. If a [custom script](/workflows/common-workflow-steps/custom-script) step installs from a third-party tap, add a trust step first: | ||
|
|
||
| ```bash | ||
| brew trust <user>/<tap> | ||
| brew install <user>/<tap>/<formula> | ||
| ``` | ||
|
|
||
| Formulae from the default Homebrew taps are not affected. Node also changes on this stack: the default stays **Node 22**, with **Node 24** available via the [Install Node](/workflows/react-native-specific-workflow-steps/node-install) step. | ||
|
|
||
| ::: |
There was a problem hiding this comment.
📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win
Align the caution heading with the target stack version.
The block title says 26.5, but the surrounding text and tables refer to 26.5.1. Please make the version consistent so readers don’t infer the warning applies to the wrong image.
🤖 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 `@docs/infrastructure/ios-build-infrastructure.md` around lines 132 - 143,
Update the caution heading in the iOS build infrastructure docs so it matches
the stack version used in the body text and tables. The issue is the heading
references Tahoe 26.5 while the content refers to 26.5.1; make the version
consistent throughout that caution block so readers can identify the correct
macOS stack.
Deploying with
|
| Status | Name | Latest Commit | Preview URL | Updated (UTC) |
|---|---|---|---|---|
| ✅ Deployment successful! View logs |
appcircle-docs | b5ce3d5 | Commit Preview URL Branch Preview URL |
Jul 07 2026, 12:00 PM |
Deploying with
|
| Status | Name | Latest Commit | Preview URL | Updated (UTC) |
|---|---|---|---|---|
| ✅ Deployment successful! View logs |
appcircle-docs | b5ce3d5 | Commit Preview URL Branch Preview URL |
Jul 07 2026, 12:01 PM |
What
Adds a caution note under the macOS build-environment toolset table in
infrastructure/ios-build-infrastructure.mdcovering the upcoming macOS Tahoe26.5.1stack's Homebrew change.Why
The 26.5 stack ships Homebrew 6.x (up from
5.1.0on Tahoe26.3.2). Homebrew 6.0 introduced a tap-trust security mechanism:brewrefuses to install formulae from untrusted third-party taps until the tap is trusted. Customers whobrew installfrom a third-party tap in a custom script will hit an error withoutbrew trustfirst. The note documents the workaround and also flags the Node default (stays 22, 24 available).Notes / placement
macOS Tahoe 26.5.1column to the toolset table yet - most per-tool versions resolve at image build time and aren't validated until the CI build of the stack completes. The column should be added with real values once PL-194 builds and smoke-tests pass.Ready-to-paste release-notes.md bullet for the release that ships the stack:
Companion to ac-script-agent #71/#72 (tahoe26.5 toolset) and ac-agent-build #52 (android runner sync).
Migrated from appcircle-docusaurus#1238.
Created on behalf of ozcan@appcircle.io via Arc.
Summary by CodeRabbit
26.5.1.6.x, which may require trusted taps before installing packages from third-party sources.22is still the default, with24available through the standard install step.