ci(apple): characterize bounded xcrun stalls in iOS preflight and fold-helper gate
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 45/100
- Issue type
- Bug
- Clarity
- Mostly clear
- Activity status
- Active
- Tech stack
- ios, typescript
- Domain
- ci-cd, mobile-dev, testing-qa
Research direction
Start with packages/platform-apple/src/readiness/runtime.ts and its LIST_TIMEOUT_MS path for simctl device inventory, then inspect packages/platform-apple/src/foldable/fold-helper-cache.test.ts and its FOLD_HELPER_BUILD_TIMEOUT_MS gate. Add focused fake-host coverage for a recoverable first timeout and a persistent timeout, preserving the prepare budget and typed failure. Done includes a macOS gate measurement or failing-job link and a live iOS PR run through preflight.
Written by the indexing model from the issue text.
Description
Purpose
An Apple host stall can fail smoke before the test under review starts. Keep the two xcrun paths distinct so a cold simulator inventory failure is not reported as an XCTest assertion or hidden by a test retry.
Evidence and scope
- iOS PR run 36030060382, job 107736587593 failed in Preflight iOS runner through public CLI. The typed error was
COMMAND_FAILED: xcrun timed out after 15000ms, withargs: ["simctl", "list", "devices", "-j"], empty stdout/stderr, andtimeoutMs: 15000. The fixture E2E step never ran. The 15 s budget isLIST_TIMEOUT_MSinpackages/platform-apple/src/readiness/runtime.ts; this is distinct from the cold toolchain version probes closed by #2422. - The macOS fold-helper -Werror gate invokes
xcrunwithFOLD_HELPER_BUILD_TIMEOUT_MS = 30000inpackages/platform-apple/src/foldable/fold-helper-cache.test.ts. This is a separate compile path to audit. I have not established a recent failure of this gate from the currently visible macOS runs, so its budget should be changed only if a captured duration or timeout warrants it.
Required behavior
- Attribute a preflight failure to the exact
simctloperation, its elapsed time, remaining prepare deadline, and whether a retry could join/reuse a warmed result. A timeout must stay bounded and typed; no generic XCTest or E2E retry is the fix. - Reproduce or characterize the 15 s inventory stall on a cold/contended host and choose a bounded recovery using the remaining prepare budget. A warm second call may be tried only when the first typed timeout and deadline allow it. Verify the simulator is still the scoped target and that a persistent hang still fails promptly.
- Measure the fold-helper warning gate's cold and warm
xcrunduration separately. If it reaches its 30 s budget, file the concrete failing run here and fix that gate at its own compile seam while retaining-Werror; otherwise close that audit item without changing the timeout.
Completion
- A focused fake-host test plants a first inventory timeout followed by a valid scoped result, plus a persistent timeout, and proves both outcomes and total budget.
- A macOS gate measurement or failing job link settles the fold-helper audit.
- A live iOS PR run gets through preflight on the exact fixing head. Record runner queue and execution time separately.
Related: #2422 (closed toolchain identity probes), #2491 (rotating iOS smoke failures), #2879 (fold request envelope; a different budget).
- Dominant language
- TypeScript
- Stars
- 4.7k
- Forks
- 304
- Avg merge
- 11h 29m
- Merged PRs (30d)
- 514
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from callstack/agent-device
-
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
callstack/agent-device#1869 ·
-
needs-triage
Difficulty 5/5 Over a week Newbie friendliness 32/100
callstack/agent-device#2948 ·
-
Difficulty 4/5 3-5 days Newbie friendliness 55/100
callstack/agent-device#2946 ·
-
bug ready-for-agent
Difficulty 5/5 Over a week Newbie friendliness 35/100
callstack/agent-device#2935 ·
-
needs-triage
Difficulty 5/5 Over a week Newbie friendliness 38/100
callstack/agent-device#2906 ·
All issues in callstack/agent-device
Similar issues
-
bug(cli): hapi doctor inline-media prints a fabricated B:\ helper-script path in packaged installs Open
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
-
Crush Open
Difficulty 1/5 Under an hour Newbie friendliness 85/100
catppuccin/catppuccin#3125 ·
-
Add a SECURITY.md Open
Difficulty 1/5 Under an hour Newbie friendliness 90/100
ElementsProject/cln-application#167 · 1 comment · 1 reaction ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
Quantco/pnpm-licenses#17 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100