Skip to content

nightly: Sparkle delta updates per architecture track (77 MB → ~11 MB daily) - #11788

Merged
lawrencecchen merged 2 commits into
mainfrom
feat-nightly-sparkle-deltas
Sep 3, 2026
Merged

lawrencecchen merged 2 commits into
mainfrom
feat-nightly-sparkle-deltas

Conversation

@lawrencecchen

@lawrencecchen lawrencecchen commented Sep 3, 2026 •

Copy link
Copy Markdown
Contributor

A day-over-day nightly update still downloads the whole 77 MB DMG. Measured with Sparkle's own BinaryDelta between two consecutive arm64 nightlies (builds 3363401078801 → 3371034707301), the delta is 11 MB.

Each sign variant now fetches the two previous immutable DMGs of its track from the release (scripts/ci/fetch-previous-nightly-dmgs.py) and hands them to generate_appcast with --maximum-deltas 2. The resulting deltas are renamed from the app-based cmux NIGHTLY<new>-<old>.delta (identical for every track, and a space GitHub would rewrite) to cmux-nightly-macos-<variant>-<new>-<old>.delta by scripts/ci/finalize-sparkle-deltas.sh, the appcast URLs follow, and the files ship as release assets pruned together with their build.

sign-cmux-bundle.sh no longer code-signs the shell scripts under Resources/bin: the bundle seal already covers them, and the extended-attribute signatures that direct signing leaves on scripts are exactly what BinaryDelta refuses to diff. Because the currently published build still carries those attributes, the first nightly after this lands ships without deltas and the second one starts serving them. The unsigned-appcast fallback now patches only the full-archive enclosure and drops delta entries it cannot sign, instead of stamping the DMG signature onto every enclosure.

Tests: tests/test_finalize_sparkle_deltas.sh and tests/test_fetch_previous_nightly_dmgs.sh (new, wired into workflow-guard-tests), plus the existing nightly, notarization, and prune tests. Sign job timeout raised to 80 minutes for the two extra delta generations.


Summary by cubic

Switches nightly updates to Sparkle deltas so day-over-day updates download ~11 MB instead of the full 77 MB DMG.

Details

  • Fetches the two previous immutable DMGs per architecture track and passes them to generate_appcast with --maximum-deltas 2.
  • Renames deltas from app-based names to track-specific filenames and rewrites appcast URLs.
  • Stops direct code-signing of shell scripts under Resources/bin so BinaryDelta can diff them; the bundle seal already covers them.
  • The unsigned-appcast fallback now patches only the full-archive enclosure and drops unsigned delta entries.
  • Raises the sign job timeout to 80 minutes for the extra delta generations.
  • Adds behavioral tests for the new fetch and finalize scripts.
  • The first nightly after this lands ships without deltas; the second starts serving them.

Written for commit 1d9b3dd. Summary will update on new commits.

Review in cubic

A day-over-day nightly update downloaded the whole 77 MB DMG. Measured with
Sparkle's BinaryDelta between two consecutive arm64 nightlies, the delta is
11 MB.

Each sign variant fetches the two previous immutable DMGs of its track from
the release and hands them to generate_appcast with --maximum-deltas 2. The
resulting deltas are renamed from the app-based "cmux NIGHTLY<new>-<old>.delta"
(one name for every track, and a space GitHub would rewrite) to
cmux-nightly-macos-<variant>-<new>-<old>.delta, the appcast URLs follow, and
the files ship as release assets pruned together with their build.

sign-cmux-bundle.sh no longer code-signs shell scripts under Resources/bin:
the bundle seal already covers them, and the extended-attribute signatures
that direct signing leaves on scripts are exactly what BinaryDelta refuses to
diff. The unsigned-appcast fallback now patches only the full-archive
enclosure and drops delta entries it cannot sign.
@vercel

vercel Bot commented Sep 3, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
cmux166 Ready Ready Preview Sep 3, 2026 5:14pm UTC
cmux41 Ready Ready Preview Sep 3, 2026 5:14pm UTC

@coderabbitai

coderabbitai Bot commented Sep 3, 2026 •

Copy link
Copy Markdown

Warning

Review limit reached

Next included review available in 8 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used all 10 included reviews currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Team

Run ID: 4d4d94b6-5d19-49c7-be0e-f628375ce3c3

📥 Commits

Reviewing files that changed from the base of the PR and between 252acfb and 1d9b3dd.

📒 Files selected for processing (9)
  • .github/workflows/ci.yml
  • .github/workflows/nightly.yml
  • scripts/ci/fetch-previous-nightly-dmgs.py
  • scripts/ci/finalize-sparkle-deltas.sh
  • scripts/prune_nightly_release_assets.py
  • scripts/sign-cmux-bundle.sh
  • scripts/sparkle_generate_appcast.sh
  • tests/test_fetch_previous_nightly_dmgs.sh
  • tests/test_finalize_sparkle_deltas.sh

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.

@github-actions

github-actions Bot commented Sep 3, 2026

Copy link
Copy Markdown
Contributor

All contributors have signed the CLA ✍️ ✅
Posted by the CLA Assistant Lite bot.

@lawrencecchen
lawrencecchen merged commit fcaa7e9 into main Sep 3, 2026
21 of 27 checks passed
rustybret pushed a commit to rustybret/bmux that referenced this pull request Sep 3, 2026
fcaa7e9 nightly: Sparkle delta updates per architecture track (manaflow-ai#11788)
e4f1f53 Fix invalid cmux-tui socket paths on Windows (manaflow-ai#11456)
252acfb feat(cmux-tui): report registry lock, writer, and admission stats (manaflow-ai#11772)
f7003ca fix(cloud): pass the create progress handler to the base-open launcher (manaflow-ai#11818)

# Conflicts:
#	.github/workflows/ci.yml
#	.github/workflows/nightly.yml
@lawrencecchen
lawrencecchen deleted the feat-nightly-sparkle-deltas branch September 3, 2026 08:12
austinywang added a commit that referenced this pull request Sep 8, 2026
…sh 3.2)

#11788 added `delta_args=()` and passed "${delta_args[@]}" to
generate_appcast. In bash 4.4+ an empty array expands to nothing; in
bash 3.2 (macOS /bin/bash, which `#!/usr/bin/env bash` resolves to on
the release runner) it is an "unbound variable" error under `set -u`.
Worse, with the script's EXIT trap bash 3.2 then exits 0, so the step
passed and no appcast was written. Nightly always has previous archives
(delta_args non-empty) and was never affected; the stable release lane
never has them and has been broken since 2026-09-03, unnoticed because
release.yml could not start at all (#12149).

Expand the array as ${delta_args[@]+"${delta_args[@]}"}, which is empty
when the array is empty in every bash. In release.yml, verify after
generation that appcast.xml exists, carries sparkle:edSignature and
references cmux-macos.dmg before anything uploads it: the exit status
alone is not a reliable signal on bash 3.2.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as
austinywang added a commit that referenced this pull request Sep 10, 2026
…issions guard, screenshot decoupling, notarization hardening) (#12157)

* ci: guard reusable-workflow permission grants (red on main's shape)

GitHub validates a reusable workflow's permissions against the calling job
when it parses the caller. A callee that requests a scope the caller does
not grant fails the whole caller run at startup, before any job runs. That
is what blocks the stable release today: release.yml calls
ios-screenshots.yml, which requests `actions: write` while release.yml
grants none (#12149).

Add scripts/ci/check_reusable_workflow_permissions.py (python3 stdlib
only) that walks every local `uses: ./.github/workflows/*.yml` call,
computes the calling job's grant (job block, else workflow block, else the
repository default) and the callee's request (max over its workflow block
and every job block, gated jobs included, mirroring 4b9720d), follows
nested calls with the intermediate grant, and fails on any scope that asks
for more. tests/test_ci_reusable_workflow_permissions.py covers the rule on
fixture trees (the exact #12149 shape, shorthands, job-level overrides,
repository defaults, nesting, missing callees) and then runs the checker on
the real tree, which fails until the next commit fixes the workflows.

Wired into the workflow-guard-tests job in ci.yml.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* ci: stop ios-screenshots.yml requesting actions: write (fixes release startup)

The screenshot workflow declared `actions: write` since #6697, but no step
ever used it: checkout runs with persist-credentials disabled, the two
artifact uploads use the runner's artifact token, the capture is a DEBUG
simulator build, and the App Store Connect upload path authenticates with an
API key. When #11342 made release.yml call this workflow, GitHub compared the
callee's block with the caller's grant (contents/attestations/id-token only)
and refused the release workflow at parse time: startup_failure, no job run,
for tag pushes and dispatches alike (#12149).

Reduce the callee to `contents: read`, the minimum its steps use. Widening
release.yml instead would have handed a UI-test job the ability to cancel or
dispatch runs for no benefit. The guard added in the previous commit now
passes on the tree.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* release: do not gate build-sign-notarize on iOS screenshot capture

#11342 made build-sign-notarize need generate-ios-screenshots ("gates
build-sign-notarize on screenshot success"). The DMG never consumes those
artifacts: nothing in build-sign-notarize downloads them, and the App Store
tooling (ios/scripts/appstore-shots.sh capture) dispatches its own
ios-screenshots.yml run rather than reading a release run. What the gate
did do was make every stable macOS release wait for, and fail with, a
300-minute simulator capture across nine locales on shared macOS runners,
a lane that had "not compiled on main for days" before #11342 healed it.

Keep the capture in release.yml as a sibling job, so every tag still gets
screenshots at the exact release ref and a failed capture still turns the
run red, but drop it from build-sign-notarize.needs. Trade-off: a green
macOS release no longer implies the screenshot capture succeeded; the run
conclusion still does.

tests/test_ci_release_ios_screenshots_decoupled.sh pins the policy (fails
on main's needs list, passes here) and runs in workflow-guard-tests.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* release: give the screenshot capture job only contents: read and no secrets

The screenshot job runs a DEBUG simulator UI test after `brew install`
of fastlane and imagemagick. Capture-only needs to read the repository and
nothing else: checkout runs with persist-credentials disabled, artifact
uploads use the runner's artifact token, and the App Store Connect upload
path in ios-screenshots.yml is gated to workflow_dispatch from main, so it
is unreachable from a release run whatever `upload` says.

Set job-level `permissions: contents: read` on the calling job (the pattern
the cmux-tui callers already use) instead of passing the workflow's
contents/attestations/id-token write grant through, and drop
`secrets: inherit`, which handed every repository secret (Developer ID
certificate and password, notarization credentials, Sparkle private key,
R2 keys, Sentry token, ASC key) to that job for no benefit.

Trade-off: if the release lane ever wants the ASC upload, it must add
`secrets: inherit` back together with `upload: true` and relax the callee's
dispatch-only guard. That should be a deliberate change.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* release: let the Sparkle monotonic guard warn on non-tag dry runs

release.yml runs tests/test_ci_sparkle_build_monotonic.sh at the top of
build-sign-notarize. On plain main it fails (CURRENT_PROJECT_VERSION 102
equals the published 0.64.22 build), which is correct for a tag push about
to publish but wrong for the workflow's built-in dry run: a non-tag
workflow_dispatch publishes nothing and, by design, runs from a branch
that has not been bumped yet. The dry run was therefore impossible without
a throwaway bump commit.

Chosen fix: a CMUX_SPARKLE_MONOTONIC_MODE switch on the guard, `enforce`
by default (tag pushes, scripts/release-pretag-guard.sh) and `warn` when
release.yml runs from anything but refs/tags/*. Rejected alternative:
running the dry run from a throwaway branch with a temporary bump, which
would validate a commit that never merges and leave the pipeline
un-dry-runnable for everyone else.

tests/test_sparkle_build_monotonic_modes.sh drives the guard against
fixture project files and a local appcast (stale fails in enforce and by
default, warns in warn mode, bumped passes in both, unreachable appcast
soft-passes, unknown mode fails) and pins the ref-based selection in
release.yml. Wired into workflow-guard-tests.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* ci: give Gatekeeper twenty minutes to see a fresh notarization ticket

scripts/ci/notarize-computer-use-helper.sh polls `spctl` on the standalone
Computer Use helper after stapling because Apple's CDN publishes the ticket
some time after notarytool reports Accepted. The budget was 20 x 15s. Nightly
run 34208928547 (2026-09-08) exhausted it: Accepted at 09:51:28, still
"Unnotarized Developer ID" at 09:56:18, exit 3, whole universal lane failed,
while the arm64 and x86_64 lanes passed in the same window.

Raise the default to 80 x 15s (twenty minutes) and announce the budget on the
first rejection so a log reader can tell propagation from a hang. Trade-off:
a genuinely rejected helper now takes up to twenty minutes to fail instead
of five, which only delays an already-lost release; a short budget failed
good releases, each costing a full rebuild and a human retry. Both knobs
remain env-configurable (CMUX_GATEKEEPER_ASSESS_ATTEMPTS/_DELAY_SECONDS).
nightly's signing job has an 80-minute timeout with a 7-10 minute typical
duration, so the budget fits there; release.yml's timeout is raised in the
next commit.

tests/test_notarize_computer_use_helper.sh now pins the defaults (at least
1200s, polled at least every 30s, env-configurable literals) and the budget
announcement, alongside the existing override and give-up coverage.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* release: raise build-sign-notarize timeout to 90 minutes

v0.64.22's build-sign-notarize took 39.8 minutes on 2026-08-03. Since then
the job gained the Cloud tunnel system extension and its Go engine build
(#11789), the universal diff sidecar and cmux-tui client install (#12006),
two extra smoke launches, and a Gatekeeper propagation wait that can now
run twenty minutes on its own. A 60-minute ceiling leaves no room for a
slow notarytool day, and a timeout mid-notarization wastes the whole build.

90 minutes covers the measured baseline plus the known variable waits with
headroom while still bounding a hung job on a shared self-hosted runner. To
be re-checked against the dry-run duration for this branch: the timeout must
stay at least 25 percent above it.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* release: name the tunnel extension by its bundle identifier, not its App ID

The first release dry run that could start after the permission fix
(run 34222835589) failed 30 minutes in, at "Verify binary architectures":

  error: system extension identifier is 'com.cmuxterm.app.tunnel',
         expected '7WLXT3NR37.com.cmuxterm.app.tunnel'

#11789 passed the team-prefixed App ID to
scripts/normalize-system-extension-bundle.sh and looked for the tunnel
binary under 7WLXT3NR37.com.cmuxterm.app.tunnel.systemextension. The
Release build's PRODUCT_BUNDLE_IDENTIFIER for the extension is
com.cmuxterm.app.tunnel; only NEMachServiceName
($(CMUX_TEAM_ID_PREFIX)$(PRODUCT_BUNDLE_IDENTIFIER)) and the provisioning
profile's com.apple.application-identifier carry the team prefix, and the
app activates whatever CFBundleIdentifier the bundled extension declares.
nightly.yml already does it this way and ships
com.cmuxterm.app.nightly.tunnel.systemextension with a profile for
7WLXT3NR37.com.cmuxterm.app.nightly.tunnel (run 34220568401). The mistake
was invisible until now because release.yml could not start at all.

Use the bundle identifier for the normalize call and the directory the
verify step inspects; keep the App ID for the profile check.
tests/test_ci_release_tunnel_identifiers.sh derives all three from
cmux.xcodeproj/project.pbxproj (fails on main's release.yml, passes here)
and runs in workflow-guard-tests.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* Fix main's package-test compile error and Swift warning-budget violations

main is red for every branch that routes the macOS lane (#12161, #12165),
which keeps ci-status from ever reporting green on this release-pipeline
PR. Fix both at the root rather than refreshing the budget:

- swift-package-tests: FakeTerminalEngine.swift gained a `UUID` parameter
  in #10564 but imports only GhosttyKit. Add `import Foundation`.
- tests-build-and-lag (scripts/swift_warning_budget.py, actual > budget):
  * AppDelegate+PaneMemoryGuardrail.swift: parenthesize the two
    `compactMap` closures inside the `guard` condition ("trailing closure
    in this context is confusable with the body of the statement").
  * SessionIndexTableController.swift: the bounds-change observer block is
    typed @sendable in the current SDK, so referencing `isApplyingRows` and
    `reconcilePresentation(in:)` warned. The block is delivered on
    `queue: .main`, so run it under `MainActor.assumeIsolated`, the same
    pattern SidebarWorkspaceRowCellView uses; no async hop, same timing.
  * CmuxTuiSnapshotParser.swift: `switch resourceID.kind` already covers
    every SurfaceResourceKind case (terminal, display, browser), so the
    `default: continue` could never run. Remove it; a new case now fails
    to compile here instead of being silently skipped.
  * SurfaceCatalogModel.swift: `if let rowID,` rebound a value the body
    never read; test `rowID != nil` instead.
  * TerminalController.swift: `payload` in the `.delivered` branch is never
    mutated; make it `let`.

Every change is behavior-preserving. Verified with `swiftc -parse` on each
file locally (no app build on the shared machine); the routed CI lane
proves the build and the budget.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* Normalize project.pbxproj (main bypassed the pre-commit hook in #12145)

scripts/check-pbxproj.sh fails on main since 567ba48 (#12145): the
three StackAccountAvatarViewTests.swift entries were added out of the
normalizer's sorted order, so every PR's workflow-guard-tests job goes
red at "Validate pbxproj objectVersion pin and normalization" and
linux-preflight, tests and ci-status cascade from it. This is the output
of scripts/normalize-pbxproj.py: three lines reordered, no identifier or
setting changed.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* tests: drive sparkle_generate_appcast.sh through the no-delta release path (red)

Release dry run 34227505375 (2026-09-08) reported "Generate Sparkle
appcast: success" and uploaded a cmux-release-dry-run artifact containing
only the DMG. The job log shows why:

  ./scripts/sparkle_generate_appcast.sh: line 93: delta_args[@]: unbound variable

A tag push would have published a GitHub Release without appcast.xml,
so no Sparkle client would ever be offered the update, and the R2 stable
appcast upload would then fail after the release already existed.

tests/test_sparkle_generate_appcast_no_deltas.sh runs the real script
with fake git/xcodebuild/generate_appcast/sign_update tools under every
bash on the machine (/bin/bash 3.2 on macOS reproduces the bug; bash 5
never did) and requires a signed appcast at the requested output path
with no delta arguments when there are no previous archives, and with
--maximum-deltas when there are. It also requires release.yml to verify
the feed after generation instead of trusting the exit status. Fails on
main's script and workflow; the next commit fixes both. Wired into
workflow-guard-tests.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* release: generate the appcast when there are no previous archives (bash 3.2)

#11788 added `delta_args=()` and passed "${delta_args[@]}" to
generate_appcast. In bash 4.4+ an empty array expands to nothing; in
bash 3.2 (macOS /bin/bash, which `#!/usr/bin/env bash` resolves to on
the release runner) it is an "unbound variable" error under `set -u`.
Worse, with the script's EXIT trap bash 3.2 then exits 0, so the step
passed and no appcast was written. Nightly always has previous archives
(delta_args non-empty) and was never affected; the stable release lane
never has them and has been broken since 2026-09-03, unnoticed because
release.yml could not start at all (#12149).

Expand the array as ${delta_args[@]+"${delta_args[@]}"}, which is empty
when the array is empty in every bash. In release.yml, verify after
generation that appcast.xml exists, carries sparkle:edSignature and
references cmux-macos.dmg before anything uploads it: the exit status
alone is not a reliable signal on bash 3.2.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* release: fail the Sparkle monotonic guard closed when the appcast is unreachable

CodeRabbit on #12157: enforce mode (tag pushes, release-pretag-guard.sh)
soft-passed when the published appcast could not be fetched, so a tag
push could publish a stale CURRENT_PROJECT_VERSION on a network blip or
on a latest release that lacks appcast.xml, the exact state that leaves
Sparkle clients without updates. A missing signal must fail closed when
the run is about to publish.

enforce mode now fails with an explanation when the published build is
unknown; warn mode (non-tag dry runs) keeps the soft pass because it
publishes nothing. curl retries transient failures (3 x 2s by default,
overridable so the tests exercise the unreachable path without waiting).
tests/test_sparkle_build_monotonic_modes.sh covers enforce, default and
warn against an unreachable appcast.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* tests: assert the journal-carried pane clear that #11976 replaced clear_notifications with

#11976 removed the v1 `clear_notifications --tab --panel` send from the
Claude prompt-submit and pre-tool-use hooks; the pane-scoped clear now
rides on the `agent.turn.started` / `agent.state.changed` journal events,
which the app reconciles into `clearNotifications(forTabId:surfaceId:)`.
It updated the Python hook tests to the new wire contract but not
ClaudeHookLifecycleCleanupTests, whose two moved-pane tests still expected
the removed command. They fail on main in the strict app-host
agent-notification step (shard 6), unnoticed because #11976's PR CI never
routed the macOS lane.

Assert the new contract instead: the journal event for the hook names the
re-homed workspace and the live pane (via the existing
AgentJournalAppendCapture parser), and nothing still wipes the whole
destination workspace. SessionEnd keeps sending the v1 command, so its
tests are unchanged.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* ci: make app-host hangs fail in minutes instead of the 75-minute job timeout

Every macOS lane run since 2026-09-03 has ended with app-host shards
"cancelled" at the 75-minute job timeout. Today's logs (run 34236235360,
shards 1/2/4, both attempts) show the mechanism, and it is two plumbing
defects rather than the tests:

1. scripts/ci/xcodebuild_noninteractive.py resets its 300s idle deadline on
   every output chunk. Since #11755 (merged 2026-09-03T02:09Z, after the
   last green lane at 2026-09-02T09:21Z) the app host logs every Cloud API
   poll, `[CloudVM] GET /api/vm not_signed_in`, every 45 seconds. A test
   host hung inside a WebKit page load (WebContent XPC: "Could not signal
   service ... 113") therefore never looks idle, so the wrapper's kill and
   retry path, which handled the same WebKit failure on the 09-02 green
   run, never fires.
2. The tolerant batch watchdog in ci.yml (1800s) killed only the
   console-session launcher and left the lock wrapper, xcodebuild and the
   app host alive; the app host kept the `| tee` pipe open, so the step sat
   idle from "timeout after 1800s; terminating" until the job timeout.

Fixes:
- CMUX_XCODEBUILD_NONINTERACTIVE_IDLE_IGNORE_RE: output lines matching it
  do not count as progress. run-app-host-xcodebuild.sh defaults it to the
  Cloud poll line (an empty value restores counting everything; an
  invalid regex fails closed with exit 2). Real output still resets the
  clock, so a slow but progressing batch is unaffected.
- The ci.yml batch runner writes xcodebuild output to the capture file and
  streams it with a detached tail, kills the whole process tree
  (pgrep -P recursion, TERM then KILL) when the batch budget expires, and
  reads both the streamed and per-batch captures for the SwiftPM retry
  heuristic.

Behavior tests: tests/test_ci_xcodebuild_noninteractive_helper.py drives a
child that prints only the keepalive every 50ms (finishes without the
pattern, idles out at 0.3s with it, invalid pattern exits 2);
tests/test_ci_change_areas.py runs the real step script against a runner
that hangs and leaves a grandchild holding stdout, and requires exit 124
within seconds with the grandchild dead.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* ci: keep the canonical OUTPUT capture line the SPM-retry guard pins

tests/test_ci_unit_test_spm_retry.sh requires `OUTPUT=$(cat "$TEST_OUTPUT")`
verbatim in the app-host step; the previous commit folded the per-batch
capture files into that line and turned workflow-guard-tests red. Keep the
pinned line and append the per-batch captures on the next line instead.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* ci: keep a watchdog-killed app-host batch terminal; drop the wall-clock assert

CodeRabbit on #12157: the expected-failure normalization in
run_unit_test_batch greps the capture for the last "Executed ... failures"
summary and returns success on "(0 unexpected)". After the watchdog kills a
batch (status 124) the capture can still hold an earlier attempt's summary
(run-app-host-xcodebuild.sh retries into the same file), so a terminated
batch could be reported as passed. Treat 124 as terminal before the
normalization. The hung-runner behavior test now prints a decoy
"(0 unexpected)" summary before hanging and requires the step to stay at
124 without the "All failures ... are expected" message.

Also drop the `elapsed < 60` assertion from that test: the harness's 120s
subprocess timeout already bounds a runaway step, and a hard wall-clock
ceiling only adds scheduler-delay flakes.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* chore: normalize project file after main merge

* test: remove timing dependency from terminal lane test

* ci: accept completed app-host summaries after launcher timeout

* test: make idle watchdog coverage scheduler tolerant

* ci: require Swift Testing completion before accepting launcher timeout

* ci: fail fast on known broad app-host hangs

* test: allowlist virtual retry delay fixtures

* ci: preserve app-host lock queue headroom

* ci: restore terminal creation CLI regression coverage

* ci: retain release guard coverage after main merge

* ci: remove obsolete app-host idle override

* cmuxTests: run the Coderouter no-socket tests without an unwaited expectation

`runCoderouterCLI(waitForSocket: false)` still asked `startMockServer` for a
case-bound `expectation(description: "cli mock socket handled")` and then
never waited on it. The shared accept loop fulfills that expectation when
the listener closes at the end of the helper, so XCTest ended
`testCoderouterUnknownVerbStillPassesThroughToTheInstalledCLI` and
`testCoderouterClaudeAddOAuthTokenRejectsAPIKeyShapeBeforeTheSocket` with
"Failed due to unwaited expectation", which it counts as an *unexpected*
failure. Since #12207 the app-host batch classifier fails a batch on any
unexpected failure, so this one test turned shard 5 (and the sibling test
shard 6) red on main and on every PR: run 34401456032, main run
34342638735 attempts 1 and 2.

Serve those two tests from the detached mock server instead, which owns no
expectation, and keep the waited path for every other Coderouter test.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* ci: rerun a remote tmux mirror suite once after an app-host crash

The non-tolerant "Run remote tmux mirror detach and placement regressions"
gate on shard 6 fails whenever the app host crashes mid-suite, which
#9348 documents as
nondeterministic: the crash point moves between tests and the relaunched
host passes the rest (run 34401456032 crashed in
dedicatedWindowSocketDefaultsToFocusNeutral; the previous run and both
main attempts passed the same step).

Capture each suite's output and rerun the suite exactly once, only when
xcodebuild printed "Restarting after unexpected exit, crash, or test
timeout". An assertion failure never earns a rerun and a second crash
still fails the shard, so the gate keeps rejecting real regressions.

tests/test_ci_change_areas.py drives the real step script against a fake
console runner: crash-then-pass is green with three invocations, an
assertion failure exits 65 after one invocation, and two crashes exit 65
after two.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* test(iroh): promote the replacement connection deterministically

usableConnectionRetiresOlderConnectionsFromSameEndpointIdentity keyed the
markUsable call off `recorder.recordedCount() == 2`, which both handlers
evaluate concurrently. When the first connection's handler reached that
check after the replacement had already recorded, it promoted `first`
instead, superseded the freshly admitted replacement, and the replacement's
own markUsable returned false: "Expectation failed: await
admission.markUsable()" at CmxIrohEndpointServerTests.swift:353 in CI run
34414741413 (swift-package-tests), while the previous run passed the same
code.

Admit before recording so the test's `recorder.next()` proves `first` is
active before `replacement` is enqueued, and promote only the replacement
by identity. The suite passes three consecutive local runs.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* cmuxTests: serialize the stdin pump suite and bound its blocking waits

Shard 3 of CI run 34414741413 hung three times at the app-host wrapper's
300s idle timeout in the same batch. The hang sample shows
SSHPTYAttachReconnectInputFilterTests.stdinPumpFiltersReadyInputBeforeStopSignal
parked in stopFiltering() -> read() on the stop-acknowledgement pipe with
every other visible cooperative-pool thread also inside a test body's
synchronous wait. The pump under test is a detached task that needs one of
those same threads, and the five pump tests each hold a thread for the
~13s reconnect probe deadline while running concurrently, so the suite can
leave no thread for any pump (the family issue #12180 tracks).

Run the suite serialized so at most one test parks a thread at a time, and
bound every wait: stopFiltering now takes a 30s acknowledgement timeout and
must succeed, and the EOF/exact reads poll with the same deadline. A pump
that never gets scheduled now fails its test inside the batch instead of
parking the shard until the idle timeout retries are exhausted.

The two assertions in this suite that already fail on main
(readUntilEOF == forwardedInput in stdinPumpFiltersReadyInputBeforeStopSignal
and stdinPumpKeepsFilteringLateProbeRepliesAfterInitialDrain) are
unchanged; the batch classifier tolerates them today.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

---------

Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>
aerickson pushed a commit to aerickson/cmux that referenced this pull request Sep 13, 2026
…rkflow permissions guard, screenshot decoupling, notarization hardening) (manaflow-ai#12157)

* ci: guard reusable-workflow permission grants (red on main's shape)

GitHub validates a reusable workflow's permissions against the calling job
when it parses the caller. A callee that requests a scope the caller does
not grant fails the whole caller run at startup, before any job runs. That
is what blocks the stable release today: release.yml calls
ios-screenshots.yml, which requests `actions: write` while release.yml
grants none (manaflow-ai#12149).

Add scripts/ci/check_reusable_workflow_permissions.py (python3 stdlib
only) that walks every local `uses: ./.github/workflows/*.yml` call,
computes the calling job's grant (job block, else workflow block, else the
repository default) and the callee's request (max over its workflow block
and every job block, gated jobs included, mirroring 4b9720d), follows
nested calls with the intermediate grant, and fails on any scope that asks
for more. tests/test_ci_reusable_workflow_permissions.py covers the rule on
fixture trees (the exact manaflow-ai#12149 shape, shorthands, job-level overrides,
repository defaults, nesting, missing callees) and then runs the checker on
the real tree, which fails until the next commit fixes the workflows.

Wired into the workflow-guard-tests job in ci.yml.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* ci: stop ios-screenshots.yml requesting actions: write (fixes release startup)

The screenshot workflow declared `actions: write` since manaflow-ai#6697, but no step
ever used it: checkout runs with persist-credentials disabled, the two
artifact uploads use the runner's artifact token, the capture is a DEBUG
simulator build, and the App Store Connect upload path authenticates with an
API key. When manaflow-ai#11342 made release.yml call this workflow, GitHub compared the
callee's block with the caller's grant (contents/attestations/id-token only)
and refused the release workflow at parse time: startup_failure, no job run,
for tag pushes and dispatches alike (manaflow-ai#12149).

Reduce the callee to `contents: read`, the minimum its steps use. Widening
release.yml instead would have handed a UI-test job the ability to cancel or
dispatch runs for no benefit. The guard added in the previous commit now
passes on the tree.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* release: do not gate build-sign-notarize on iOS screenshot capture

manaflow-ai#11342 made build-sign-notarize need generate-ios-screenshots ("gates
build-sign-notarize on screenshot success"). The DMG never consumes those
artifacts: nothing in build-sign-notarize downloads them, and the App Store
tooling (ios/scripts/appstore-shots.sh capture) dispatches its own
ios-screenshots.yml run rather than reading a release run. What the gate
did do was make every stable macOS release wait for, and fail with, a
300-minute simulator capture across nine locales on shared macOS runners,
a lane that had "not compiled on main for days" before manaflow-ai#11342 healed it.

Keep the capture in release.yml as a sibling job, so every tag still gets
screenshots at the exact release ref and a failed capture still turns the
run red, but drop it from build-sign-notarize.needs. Trade-off: a green
macOS release no longer implies the screenshot capture succeeded; the run
conclusion still does.

tests/test_ci_release_ios_screenshots_decoupled.sh pins the policy (fails
on main's needs list, passes here) and runs in workflow-guard-tests.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* release: give the screenshot capture job only contents: read and no secrets

The screenshot job runs a DEBUG simulator UI test after `brew install`
of fastlane and imagemagick. Capture-only needs to read the repository and
nothing else: checkout runs with persist-credentials disabled, artifact
uploads use the runner's artifact token, and the App Store Connect upload
path in ios-screenshots.yml is gated to workflow_dispatch from main, so it
is unreachable from a release run whatever `upload` says.

Set job-level `permissions: contents: read` on the calling job (the pattern
the cmux-tui callers already use) instead of passing the workflow's
contents/attestations/id-token write grant through, and drop
`secrets: inherit`, which handed every repository secret (Developer ID
certificate and password, notarization credentials, Sparkle private key,
R2 keys, Sentry token, ASC key) to that job for no benefit.

Trade-off: if the release lane ever wants the ASC upload, it must add
`secrets: inherit` back together with `upload: true` and relax the callee's
dispatch-only guard. That should be a deliberate change.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* release: let the Sparkle monotonic guard warn on non-tag dry runs

release.yml runs tests/test_ci_sparkle_build_monotonic.sh at the top of
build-sign-notarize. On plain main it fails (CURRENT_PROJECT_VERSION 102
equals the published 0.64.22 build), which is correct for a tag push about
to publish but wrong for the workflow's built-in dry run: a non-tag
workflow_dispatch publishes nothing and, by design, runs from a branch
that has not been bumped yet. The dry run was therefore impossible without
a throwaway bump commit.

Chosen fix: a CMUX_SPARKLE_MONOTONIC_MODE switch on the guard, `enforce`
by default (tag pushes, scripts/release-pretag-guard.sh) and `warn` when
release.yml runs from anything but refs/tags/*. Rejected alternative:
running the dry run from a throwaway branch with a temporary bump, which
would validate a commit that never merges and leave the pipeline
un-dry-runnable for everyone else.

tests/test_sparkle_build_monotonic_modes.sh drives the guard against
fixture project files and a local appcast (stale fails in enforce and by
default, warns in warn mode, bumped passes in both, unreachable appcast
soft-passes, unknown mode fails) and pins the ref-based selection in
release.yml. Wired into workflow-guard-tests.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* ci: give Gatekeeper twenty minutes to see a fresh notarization ticket

scripts/ci/notarize-computer-use-helper.sh polls `spctl` on the standalone
Computer Use helper after stapling because Apple's CDN publishes the ticket
some time after notarytool reports Accepted. The budget was 20 x 15s. Nightly
run 34208928547 (2026-09-08) exhausted it: Accepted at 09:51:28, still
"Unnotarized Developer ID" at 09:56:18, exit 3, whole universal lane failed,
while the arm64 and x86_64 lanes passed in the same window.

Raise the default to 80 x 15s (twenty minutes) and announce the budget on the
first rejection so a log reader can tell propagation from a hang. Trade-off:
a genuinely rejected helper now takes up to twenty minutes to fail instead
of five, which only delays an already-lost release; a short budget failed
good releases, each costing a full rebuild and a human retry. Both knobs
remain env-configurable (CMUX_GATEKEEPER_ASSESS_ATTEMPTS/_DELAY_SECONDS).
nightly's signing job has an 80-minute timeout with a 7-10 minute typical
duration, so the budget fits there; release.yml's timeout is raised in the
next commit.

tests/test_notarize_computer_use_helper.sh now pins the defaults (at least
1200s, polled at least every 30s, env-configurable literals) and the budget
announcement, alongside the existing override and give-up coverage.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* release: raise build-sign-notarize timeout to 90 minutes

v0.64.22's build-sign-notarize took 39.8 minutes on 2026-08-03. Since then
the job gained the Cloud tunnel system extension and its Go engine build
(manaflow-ai#11789), the universal diff sidecar and cmux-tui client install (manaflow-ai#12006),
two extra smoke launches, and a Gatekeeper propagation wait that can now
run twenty minutes on its own. A 60-minute ceiling leaves no room for a
slow notarytool day, and a timeout mid-notarization wastes the whole build.

90 minutes covers the measured baseline plus the known variable waits with
headroom while still bounding a hung job on a shared self-hosted runner. To
be re-checked against the dry-run duration for this branch: the timeout must
stay at least 25 percent above it.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* release: name the tunnel extension by its bundle identifier, not its App ID

The first release dry run that could start after the permission fix
(run 34222835589) failed 30 minutes in, at "Verify binary architectures":

  error: system extension identifier is 'com.cmuxterm.app.tunnel',
         expected '7WLXT3NR37.com.cmuxterm.app.tunnel'

manaflow-ai#11789 passed the team-prefixed App ID to
scripts/normalize-system-extension-bundle.sh and looked for the tunnel
binary under 7WLXT3NR37.com.cmuxterm.app.tunnel.systemextension. The
Release build's PRODUCT_BUNDLE_IDENTIFIER for the extension is
com.cmuxterm.app.tunnel; only NEMachServiceName
($(CMUX_TEAM_ID_PREFIX)$(PRODUCT_BUNDLE_IDENTIFIER)) and the provisioning
profile's com.apple.application-identifier carry the team prefix, and the
app activates whatever CFBundleIdentifier the bundled extension declares.
nightly.yml already does it this way and ships
com.cmuxterm.app.nightly.tunnel.systemextension with a profile for
7WLXT3NR37.com.cmuxterm.app.nightly.tunnel (run 34220568401). The mistake
was invisible until now because release.yml could not start at all.

Use the bundle identifier for the normalize call and the directory the
verify step inspects; keep the App ID for the profile check.
tests/test_ci_release_tunnel_identifiers.sh derives all three from
cmux.xcodeproj/project.pbxproj (fails on main's release.yml, passes here)
and runs in workflow-guard-tests.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* Fix main's package-test compile error and Swift warning-budget violations

main is red for every branch that routes the macOS lane (manaflow-ai#12161, manaflow-ai#12165),
which keeps ci-status from ever reporting green on this release-pipeline
PR. Fix both at the root rather than refreshing the budget:

- swift-package-tests: FakeTerminalEngine.swift gained a `UUID` parameter
  in manaflow-ai#10564 but imports only GhosttyKit. Add `import Foundation`.
- tests-build-and-lag (scripts/swift_warning_budget.py, actual > budget):
  * AppDelegate+PaneMemoryGuardrail.swift: parenthesize the two
    `compactMap` closures inside the `guard` condition ("trailing closure
    in this context is confusable with the body of the statement").
  * SessionIndexTableController.swift: the bounds-change observer block is
    typed @sendable in the current SDK, so referencing `isApplyingRows` and
    `reconcilePresentation(in:)` warned. The block is delivered on
    `queue: .main`, so run it under `MainActor.assumeIsolated`, the same
    pattern SidebarWorkspaceRowCellView uses; no async hop, same timing.
  * CmuxTuiSnapshotParser.swift: `switch resourceID.kind` already covers
    every SurfaceResourceKind case (terminal, display, browser), so the
    `default: continue` could never run. Remove it; a new case now fails
    to compile here instead of being silently skipped.
  * SurfaceCatalogModel.swift: `if let rowID,` rebound a value the body
    never read; test `rowID != nil` instead.
  * TerminalController.swift: `payload` in the `.delivered` branch is never
    mutated; make it `let`.

Every change is behavior-preserving. Verified with `swiftc -parse` on each
file locally (no app build on the shared machine); the routed CI lane
proves the build and the budget.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* Normalize project.pbxproj (main bypassed the pre-commit hook in manaflow-ai#12145)

scripts/check-pbxproj.sh fails on main since 567ba48 (manaflow-ai#12145): the
three StackAccountAvatarViewTests.swift entries were added out of the
normalizer's sorted order, so every PR's workflow-guard-tests job goes
red at "Validate pbxproj objectVersion pin and normalization" and
linux-preflight, tests and ci-status cascade from it. This is the output
of scripts/normalize-pbxproj.py: three lines reordered, no identifier or
setting changed.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* tests: drive sparkle_generate_appcast.sh through the no-delta release path (red)

Release dry run 34227505375 (2026-09-08) reported "Generate Sparkle
appcast: success" and uploaded a cmux-release-dry-run artifact containing
only the DMG. The job log shows why:

  ./scripts/sparkle_generate_appcast.sh: line 93: delta_args[@]: unbound variable

A tag push would have published a GitHub Release without appcast.xml,
so no Sparkle client would ever be offered the update, and the R2 stable
appcast upload would then fail after the release already existed.

tests/test_sparkle_generate_appcast_no_deltas.sh runs the real script
with fake git/xcodebuild/generate_appcast/sign_update tools under every
bash on the machine (/bin/bash 3.2 on macOS reproduces the bug; bash 5
never did) and requires a signed appcast at the requested output path
with no delta arguments when there are no previous archives, and with
--maximum-deltas when there are. It also requires release.yml to verify
the feed after generation instead of trusting the exit status. Fails on
main's script and workflow; the next commit fixes both. Wired into
workflow-guard-tests.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* release: generate the appcast when there are no previous archives (bash 3.2)

manaflow-ai#11788 added `delta_args=()` and passed "${delta_args[@]}" to
generate_appcast. In bash 4.4+ an empty array expands to nothing; in
bash 3.2 (macOS /bin/bash, which `#!/usr/bin/env bash` resolves to on
the release runner) it is an "unbound variable" error under `set -u`.
Worse, with the script's EXIT trap bash 3.2 then exits 0, so the step
passed and no appcast was written. Nightly always has previous archives
(delta_args non-empty) and was never affected; the stable release lane
never has them and has been broken since 2026-09-03, unnoticed because
release.yml could not start at all (manaflow-ai#12149).

Expand the array as ${delta_args[@]+"${delta_args[@]}"}, which is empty
when the array is empty in every bash. In release.yml, verify after
generation that appcast.xml exists, carries sparkle:edSignature and
references cmux-macos.dmg before anything uploads it: the exit status
alone is not a reliable signal on bash 3.2.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* release: fail the Sparkle monotonic guard closed when the appcast is unreachable

CodeRabbit on manaflow-ai#12157: enforce mode (tag pushes, release-pretag-guard.sh)
soft-passed when the published appcast could not be fetched, so a tag
push could publish a stale CURRENT_PROJECT_VERSION on a network blip or
on a latest release that lacks appcast.xml, the exact state that leaves
Sparkle clients without updates. A missing signal must fail closed when
the run is about to publish.

enforce mode now fails with an explanation when the published build is
unknown; warn mode (non-tag dry runs) keeps the soft pass because it
publishes nothing. curl retries transient failures (3 x 2s by default,
overridable so the tests exercise the unreachable path without waiting).
tests/test_sparkle_build_monotonic_modes.sh covers enforce, default and
warn against an unreachable appcast.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* tests: assert the journal-carried pane clear that manaflow-ai#11976 replaced clear_notifications with

manaflow-ai#11976 removed the v1 `clear_notifications --tab --panel` send from the
Claude prompt-submit and pre-tool-use hooks; the pane-scoped clear now
rides on the `agent.turn.started` / `agent.state.changed` journal events,
which the app reconciles into `clearNotifications(forTabId:surfaceId:)`.
It updated the Python hook tests to the new wire contract but not
ClaudeHookLifecycleCleanupTests, whose two moved-pane tests still expected
the removed command. They fail on main in the strict app-host
agent-notification step (shard 6), unnoticed because manaflow-ai#11976's PR CI never
routed the macOS lane.

Assert the new contract instead: the journal event for the hook names the
re-homed workspace and the live pane (via the existing
AgentJournalAppendCapture parser), and nothing still wipes the whole
destination workspace. SessionEnd keeps sending the v1 command, so its
tests are unchanged.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* ci: make app-host hangs fail in minutes instead of the 75-minute job timeout

Every macOS lane run since 2026-09-03 has ended with app-host shards
"cancelled" at the 75-minute job timeout. Today's logs (run 34236235360,
shards 1/2/4, both attempts) show the mechanism, and it is two plumbing
defects rather than the tests:

1. scripts/ci/xcodebuild_noninteractive.py resets its 300s idle deadline on
   every output chunk. Since manaflow-ai#11755 (merged 2026-09-03T02:09Z, after the
   last green lane at 2026-09-02T09:21Z) the app host logs every Cloud API
   poll, `[CloudVM] GET /api/vm not_signed_in`, every 45 seconds. A test
   host hung inside a WebKit page load (WebContent XPC: "Could not signal
   service ... 113") therefore never looks idle, so the wrapper's kill and
   retry path, which handled the same WebKit failure on the 09-02 green
   run, never fires.
2. The tolerant batch watchdog in ci.yml (1800s) killed only the
   console-session launcher and left the lock wrapper, xcodebuild and the
   app host alive; the app host kept the `| tee` pipe open, so the step sat
   idle from "timeout after 1800s; terminating" until the job timeout.

Fixes:
- CMUX_XCODEBUILD_NONINTERACTIVE_IDLE_IGNORE_RE: output lines matching it
  do not count as progress. run-app-host-xcodebuild.sh defaults it to the
  Cloud poll line (an empty value restores counting everything; an
  invalid regex fails closed with exit 2). Real output still resets the
  clock, so a slow but progressing batch is unaffected.
- The ci.yml batch runner writes xcodebuild output to the capture file and
  streams it with a detached tail, kills the whole process tree
  (pgrep -P recursion, TERM then KILL) when the batch budget expires, and
  reads both the streamed and per-batch captures for the SwiftPM retry
  heuristic.

Behavior tests: tests/test_ci_xcodebuild_noninteractive_helper.py drives a
child that prints only the keepalive every 50ms (finishes without the
pattern, idles out at 0.3s with it, invalid pattern exits 2);
tests/test_ci_change_areas.py runs the real step script against a runner
that hangs and leaves a grandchild holding stdout, and requires exit 124
within seconds with the grandchild dead.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* ci: keep the canonical OUTPUT capture line the SPM-retry guard pins

tests/test_ci_unit_test_spm_retry.sh requires `OUTPUT=$(cat "$TEST_OUTPUT")`
verbatim in the app-host step; the previous commit folded the per-batch
capture files into that line and turned workflow-guard-tests red. Keep the
pinned line and append the per-batch captures on the next line instead.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* ci: keep a watchdog-killed app-host batch terminal; drop the wall-clock assert

CodeRabbit on manaflow-ai#12157: the expected-failure normalization in
run_unit_test_batch greps the capture for the last "Executed ... failures"
summary and returns success on "(0 unexpected)". After the watchdog kills a
batch (status 124) the capture can still hold an earlier attempt's summary
(run-app-host-xcodebuild.sh retries into the same file), so a terminated
batch could be reported as passed. Treat 124 as terminal before the
normalization. The hung-runner behavior test now prints a decoy
"(0 unexpected)" summary before hanging and requires the step to stay at
124 without the "All failures ... are expected" message.

Also drop the `elapsed < 60` assertion from that test: the harness's 120s
subprocess timeout already bounds a runaway step, and a hard wall-clock
ceiling only adds scheduler-delay flakes.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VsJWT2S5Mx2Wv3XGFih8as

* chore: normalize project file after main merge

* test: remove timing dependency from terminal lane test

* ci: accept completed app-host summaries after launcher timeout

* test: make idle watchdog coverage scheduler tolerant

* ci: require Swift Testing completion before accepting launcher timeout

* ci: fail fast on known broad app-host hangs

* test: allowlist virtual retry delay fixtures

* ci: preserve app-host lock queue headroom

* ci: restore terminal creation CLI regression coverage

* ci: retain release guard coverage after main merge

* ci: remove obsolete app-host idle override

* cmuxTests: run the Coderouter no-socket tests without an unwaited expectation

`runCoderouterCLI(waitForSocket: false)` still asked `startMockServer` for a
case-bound `expectation(description: "cli mock socket handled")` and then
never waited on it. The shared accept loop fulfills that expectation when
the listener closes at the end of the helper, so XCTest ended
`testCoderouterUnknownVerbStillPassesThroughToTheInstalledCLI` and
`testCoderouterClaudeAddOAuthTokenRejectsAPIKeyShapeBeforeTheSocket` with
"Failed due to unwaited expectation", which it counts as an *unexpected*
failure. Since manaflow-ai#12207 the app-host batch classifier fails a batch on any
unexpected failure, so this one test turned shard 5 (and the sibling test
shard 6) red on main and on every PR: run 34401456032, main run
34342638735 attempts 1 and 2.

Serve those two tests from the detached mock server instead, which owns no
expectation, and keep the waited path for every other Coderouter test.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* ci: rerun a remote tmux mirror suite once after an app-host crash

The non-tolerant "Run remote tmux mirror detach and placement regressions"
gate on shard 6 fails whenever the app host crashes mid-suite, which
manaflow-ai#9348 documents as
nondeterministic: the crash point moves between tests and the relaunched
host passes the rest (run 34401456032 crashed in
dedicatedWindowSocketDefaultsToFocusNeutral; the previous run and both
main attempts passed the same step).

Capture each suite's output and rerun the suite exactly once, only when
xcodebuild printed "Restarting after unexpected exit, crash, or test
timeout". An assertion failure never earns a rerun and a second crash
still fails the shard, so the gate keeps rejecting real regressions.

tests/test_ci_change_areas.py drives the real step script against a fake
console runner: crash-then-pass is green with three invocations, an
assertion failure exits 65 after one invocation, and two crashes exit 65
after two.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* test(iroh): promote the replacement connection deterministically

usableConnectionRetiresOlderConnectionsFromSameEndpointIdentity keyed the
markUsable call off `recorder.recordedCount() == 2`, which both handlers
evaluate concurrently. When the first connection's handler reached that
check after the replacement had already recorded, it promoted `first`
instead, superseded the freshly admitted replacement, and the replacement's
own markUsable returned false: "Expectation failed: await
admission.markUsable()" at CmxIrohEndpointServerTests.swift:353 in CI run
34414741413 (swift-package-tests), while the previous run passed the same
code.

Admit before recording so the test's `recorder.next()` proves `first` is
active before `replacement` is enqueued, and promote only the replacement
by identity. The suite passes three consecutive local runs.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

* cmuxTests: serialize the stdin pump suite and bound its blocking waits

Shard 3 of CI run 34414741413 hung three times at the app-host wrapper's
300s idle timeout in the same batch. The hang sample shows
SSHPTYAttachReconnectInputFilterTests.stdinPumpFiltersReadyInputBeforeStopSignal
parked in stopFiltering() -> read() on the stop-acknowledgement pipe with
every other visible cooperative-pool thread also inside a test body's
synchronous wait. The pump under test is a detached task that needs one of
those same threads, and the five pump tests each hold a thread for the
~13s reconnect probe deadline while running concurrently, so the suite can
leave no thread for any pump (the family issue manaflow-ai#12180 tracks).

Run the suite serialized so at most one test parks a thread at a time, and
bound every wait: stopFiltering now takes a 30s acknowledgement timeout and
must succeed, and the EOF/exact reads poll with the same deadline. A pump
that never gets scheduled now fails its test inside the batch instead of
parking the shard until the idle timeout retries are exhausted.

The two assertions in this suite that already fail on main
(readUntilEOF == forwardedInput in stdinPumpFiltersReadyInputBeforeStopSignal
and stdinPumpKeepsFilteringLateProbeRepliesAfterInitialDrain) are
unchanged; the batch classifier tolerates them today.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

---------

Co-authored-by: Claude Fable 5.1 <noreply@anthropic.com>

This branch was successfully deployed

2 active deployments
Preview – cmux41 — 1d9b3dd2 Deployed Sep 3, 2026 by vercel[bot]
Preview – cmux166 — 1d9b3dd2 Deployed Sep 3, 2026 by vercel[bot]
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