stim 1.1.0 → 1.2.0

package/dist/{guide-DrhrDBo5.mjs → guide-BS2Xc24o.mjs}

@@ -1,4 +1,4 @@
-import { t as ANDROID_AVD_CONFIG_HELP } from "./settings-BSwrY4FZ.mjs";
+import { t as ANDROID_AVD_CONFIG_HELP } from "./settings-DwU1_U_q.mjs";
 import chalk from "chalk";
 //#endregion
 //#region src/guide/index.ts
@@ -64,6 +64,11 @@ Doctor reports cross-volume staging and build-cache copies; read guide settings
 for placement overrides and guide lifecycle options for warm behavior.
 For iOS Debug architecture findings, review the project's overrides and imported
 Podfile helpers using guide lifecycle options. Doctor --fix does not change them.
+For parallel iOS work, review the recommended optional SimSlim setup in
+stim guide lifecycle simslim. If simulator process startup times out, check
+host memory pressure and free memory before retrying; do not restart other
+workspaces' devices or close their apps without asking. That guide covers
+the recovery steps and profile tradeoffs.
 For a linked native library carrying Git metadata, add the printed .git entries to
 .fingerprintignore only when the native build does not read Git state.
 
@@ -83,6 +88,11 @@ them. It preserves source, custom launcher settings, and the shared ccache.
   stim start
   stim ios                             # or: stim android
 
+Read stim guide lifecycle concurrency when a build waits on another workspace
+or a build call times out. A native build can outlive a shell timeout; if the
+tool call timed out, retry the same command and follow its printed remedy if
+waiting times out.
+
   # Reproduce the affected behavior and capture the baseline errors.
   stim logs --errors
 
@@ -132,8 +142,6 @@ RULES DURING THE LOOP
   the error screen remains, follow the printed reload remedy instead of
   running ios or android again. If launch says FATAL because the app process exited,
   fix the crash and run the platform command again; Metro cannot restart it.
-- A native build can outlive a shell timeout. Retry the same command and
-  follow its printed remedy if waiting times out. See guide lifecycle concurrency.
 - ios and android install the app, launch it, and check readiness. Trust the
   exact device, app, Metro, and launch facts in the final summary. Use the full
   reported device ID. Never assume a simulator named booted belongs to this
@@ -156,7 +164,9 @@ RULES DURING THE LOOP
 - Use stim status when resuming a workspace or recovering missing device,
   port, server, or build facts. A normal start and platform run already print
   them. Use stim doctor when a build is unexpectedly slow or the environment
-  looks incomplete.
+  looks incomplete. If status reports a changed Android serial, rerun stim
+  android with the same build options to restore forwarding, then reopen your automation
+  session on the reported serial (guide lifecycle).
 
 OWNERSHIP AND DELETION
 
@@ -215,6 +225,34 @@ requirements.
 
 LOAD ADVANCED GUIDANCE WHEN NEEDED
 
+Read the matching guide before acting in these situations:
+
+| Situation                                             | Read                             |
+| ----------------------------------------------------- | -------------------------------- |
+| Build waiting on another workspace or tool timeout    | stim guide lifecycle concurrency |
+| --variant, scheme, or several APKs from assembleDebug | stim guide lifecycle options     |
+| Refusal with a CODE                                   | stim guide errors <CODE>         |
+| Running under a sandbox                               | stim guide errors sandbox        |
+| Release configuration or ...Release variant           | stim guide lifecycle release     |
+| Remote device, custom Metro, or tunnel                | stim guide metro                 |
+| Cache miss, bypass, or fingerprint exclusions         | stim guide lifecycle builds      |
+| Capacity limits                                       | stim guide lifecycle concurrency |
+| Cache statistics from stim stats                      | stim guide facts stats           |
+| Worktree carry-over                                   | stim guide lifecycle options     |
+| gc or orphaned resources                              | stim guide cleanup gc            |
+| worktree remove refusal or --force                    | stim guide errors remove         |
+| Cleanup failure or unverified cleanup ownership       | stim guide errors teardown       |
+| Unfamiliar state or JSON field                        | stim guide facts payloads        |
+| Refusal without a code                                | stim guide errors                |
+
+Use the CODE exactly as printed; codes sharing a header resolve to the same
+section. For a refusal without a code, find its quoted message in the errors
+index. Ordinary stim stop and an authorized clean stim worktree remove do not
+need the cleanup guide. A sectioned topic called without a section prints its
+index; choose the narrowest section.
+
+FULL TOPIC LIST
+
   stim guide                      # list topics
   stim guide errors               # index of every refusal code and message
   stim guide errors <CODE>        # one refusal, e.g. stim guide errors STIM_NO_METRO
@@ -235,19 +273,7 @@ LOAD ADVANCED GUIDANCE WHEN NEEDED
   stim guide logs                 # filters, record shape, and capture limits
   stim guide cleanup              # what reclaims a device, and what deletes
   stim guide cleanup collector    # an unproven collector pid; why the app on a phone closed
-  stim guide settings             # configuration files and supported keys
-
-A refusal prints a CODE such as STIM_NO_METRO. Run stim guide errors <CODE>
-with the code exactly as printed and read only that section; every code in a
-shared header (STIM_BAD_ARG / STIM_NO_PROJECT) resolves to the same section. A
-refusal with no code is quoted by message in stim guide errors. A topic with
-sections called bare prints its section index, so read the narrowest section
-before release configurations or Android variants; remote devices; custom
-Metro processes or tunnels; cache misses, bypasses, or concurrent builds;
-capacity limits; cache statistics from stim stats; worktree carry-over;
-fingerprint exclusions; gc; --force; cleanup failures; or unfamiliar states
-and error codes. Ordinary stim stop and an authorized clean
-stim worktree remove do not need the cleanup guide.`
+  stim guide settings             # configuration files and supported keys`
 	},
 	facts: {
 		summary: "The --json payloads: `start`, `ios`, `android`, `reload`, `stop`, `status`, `doctor`, `device lock`/`unlock`, and the error contract",
@@ -705,6 +731,30 @@ Plain \`stim start\` is local and does not create a public tunnel. Remote intent
 comes from \`start --remote\`, \`ios.remote\`, or \`android.remote\`. The
 \`metro.tunnel\` setting selects the provider after remote intent exists.
 
+BUNDLE WARMUP
+  After verifying Metro, \`stim ios\` and \`stim android\` prefetch the
+  platform's development bundle while native work continues. Expo supplies the
+  entry point and bundle options through its manifest; bare React Native uses
+  the standard index entry and development bundle options, including lazy loading.
+  Warmup is enabled by default. Set optimizations.metroWarmup=false to disable
+  it on the next ios/android command, using the machine or project settings.
+  For custom entry points or bundle options, set metro.warmupUrl.ios and/or
+  metro.warmupUrl.android to the app's complete bundle URL or /path?query.
+  Stim keeps the path and query and uses the verified local Metro port.
+  Overrides replace discovery and receive no additional query defaults.
+  doctor validates configured URLs, including their platform; it does not
+  infer or auto-fix runtime native entry points or dev-menu bundle options.
+  See \`guide settings\` for configuration examples.
+  Each request times out after 60 seconds and does not keep the command alive.
+  Warmup failures do not fail the native build.
+  Release builds and \`--no-metro-check\` skip warmup. Servers without Stim's
+  prefetch-aware response observer also skip it; restart an older supervisor
+  with the current CLI to enable warmup.
+
+  Prefetch completion is not launch proof. Development launch verification
+  waits for the app's own bundle response. With a bundler started outside Stim,
+  device logs may prove a request, but bundle completion may stay unverified.
+
 REMOTE DEVICE BACKENDS
   Metro exposure and device selection are separate:
 
@@ -1355,6 +1405,11 @@ code, never on the message.`,
 				body: () => `STIM_LAUNCH_FAILED
   Installed, but the app would not start. On Android this usually means no
   launchable activity resolved.
+  On a local iOS simulator, a timed-out launch can mean the simulator cannot
+  spawn processes, even while it reports Booted. Check the reported memory
+  pressure and free host memory before retrying; a timeout alone is not an OOM
+  diagnosis. See \`stim guide lifecycle simslim\` for recovery and the optional
+  SimSlim recommendation.
   On a PHONE it means the app never appeared in the device's own process list
   after \`devicectl device process launch\`, and the devicectl lines that
   explain it are quoted under the message. The refusal a first launch usually
@@ -1578,9 +1633,21 @@ so a Debug run on one is wired to a LAN origin instead of localhost.`,
   reach a booted state. \`stim doctor\` checks the toolchain; \`stim status\` says what
   Stim thinks it owns. Re-running the command creates a fresh owned device
   when the recorded one is gone.
+  If Android creation says an AVD already exists on disk but is not listed,
+  run \`npx stim gc\` to inspect orphaned owned AVDs, then \`npx stim gc --delete\`
+  to reclaim those safe to delete before retrying. Keep anything GC cannot
+  verify; do not delete AVD directories by hand. A registered unrecorded owned
+  AVD is recovered, reusing its existing emulator when its identity is verified.
+  If recovery cannot verify registration or process state, inspect \`npx stim status\`
+  and \`adb devices\`, then retry after any other run finishes. Keep the AVD and
+  its process locks while its state is unverified.
   On iOS a slow first boot is waited out for up to ten minutes while the
   simulator still reports Booting -- a long silent wait on a loaded machine
   is patience, not a hang. The failure names the udid and the wait.
+  After boot, a process-spawn probe must finish within 30 seconds before
+  installation. If it fails, the refusal includes observed host memory pressure
+  when available. Free memory before retrying under pressure; see
+  \`stim guide lifecycle simslim\`. Booted alone does not prove readiness.
   On Android the emulator's own stdio is captured to
   the global workspace logs/emulator.log (truncated per boot), and when it printed a
   \`FATAL |\` / \`ERROR |\` / \`PANIC:\` line THAT is the message and the remedy
@@ -2116,9 +2183,11 @@ changes nothing  (worktree warm --refresh)
   blocks network egress by default, which breaks a cache lookup and a fetch.
 
   \`stim doctor\` names this when a write to STIM_HOME actually fails, not
-  merely when a harness that can sandbox is present, and
-  \`stim doctor --fix\` writes the three keys into .claude/settings.local.json,
-  the per-user file, merging with what is there. It refuses under Codex, which
+  merely when a harness that can sandbox is present. \`stim doctor --fix\`
+  writes only when the report shows that finding, and only what the finding
+  names: the three keys, into .claude/settings.local.json, the per-user file,
+  merging with what is there. A report without the finding, with or without
+  --platform, leaves that file alone. It refuses under Codex, which
   has no per-path allowance to add, and refuses any settings file it cannot
   parse rather than replace it: comments make one unparseable here even though
   Claude Code accepts them. Claude Code reads project settings from the
@@ -2293,6 +2362,21 @@ If the app is stuck before loading its first bundle, restart its process with
 the printed force-stop and launcher commands. Foregrounding the same process
 does not restart initialization. Confirm the bundle request and expected UI.
 
+Debug Android launches on an owned emulator created in the same run get up to
+60 seconds for bundle loading; the verify phase names that budget. Existing
+emulators, remote targets, and physical devices keep the 20-second budget.
+Bundle delivery still requires the usual stability or app readiness check;
+an observed fatal error ends verification without waiting for the deadline.
+
+ANDROID EMULATOR RESTARTS
+  \`stim status\` resolves owned AVDs to their currently detected adb serial.
+  Its Android JSON adds serial and state (detected, not-detected, missing,
+  or unknown). Detection confirms device identity, not app health. Status
+  reports a serial change without changing forwarding or restarting anything.
+  Rerun \`stim android\` with the same build options in that workspace to restore Metro
+  forwarding, then reopen agent-device on the serial that run reports.
+  Other workspaces' simulators and automation sessions remain theirs.
+
 DESTRUCTIVE COMMANDS -- ask the user first
   gc --delete             deletes orphaned stim-* devices, tens of GB
   gc --delete --cache all empties the shared build caches every project uses
@@ -2474,7 +2558,7 @@ result as proof instead of requiring an unrelated screenshot.`
     build       still compiling (4m00s, usually ~3m10s)
     build       still compiling (1m00s)
     pods        still installing (1m30s of ~1m40s)
-    build       waiting on /w/app-411 (pid 41233, 1m30s elapsed)
+    build       waiting on /w/app-411 (pid 41233, 1m30s elapsed) -- stim guide lifecycle concurrency
 
   The \`~\` value is an estimate, never a countdown; the third line is a
   project with no record to estimate from yet. \`guide facts stats\` says where
@@ -2490,7 +2574,7 @@ result as proof instead of requiring an unrelated screenshot.`
   step, before those. A plain warm prints the \`lock\` line only when its copy
   actually waited for another warm:
 
-    lock        acquired (waited 12s for stim worktree warm --refresh pid 41233)
+    lock        acquired (waited 12s for stim worktree warm --refresh pid 41233) -- stim guide lifecycle options
     checkout    janic/wip 2 commits behind origin/janic/wip -> fast-forwarded to 4b81e0c
                 not the default branch (main); worktrees seeded from this copy
                 carry janic/wip's dependencies
@@ -2498,7 +2582,7 @@ result as proof instead of requiring an unrelated screenshot.`
     pods        source /w/main/apps/mobile: ios/Podfile.lock changed -> pod install (1m12s)
 
   A wait reports how long this caller has waited and names the holder:
-  \`lock        waiting 40s for stim worktree warm --refresh (pid 41233)\`.
+  \`lock        waiting 40s for stim worktree warm --refresh (pid 41233) -- stim guide lifecycle options\`.
 
   \`start\` names the port, the supervisor mode and its pid on one line
   (\`metro       starting on port 8083 (expo-child, supervisor pid 13724)\`),
@@ -2744,7 +2828,7 @@ changing modes selects another profile. See \`guide settings\` for cleanup.
 
 Each reports its cache setup. \`stim doctor\` checks missing or stale setup
 when a build is blocked or slow. It reports what Stim cannot handle itself
-(a missing dev client, ccache absent from PATH or a .cxx that predates the
+(ccache absent from PATH or a .cxx that predates the
 launcher, a fingerprint no fresh worktree reproduces, a provider on a key this
 SDK ignores) and settings for builds outside Stim.
 
@@ -2926,9 +3010,9 @@ WHAT MAKES THE CACHE ACTUALLY HIT: .FINGERPRINTIGNORE
   <fingerprint, platform> (a directory under ~/.stim/build-locks). Exactly
   one workspace compiles; the others print
 
-    build       /w/app-412 is already building a3f9b1.. (pid 41233) -- tail ...
-    build       waiting on /w/app-412 (pid 41233, 4m elapsed) -- tail ...
-    build       waited 12m41s for /w/app-412's build -> installed from cache
+    build       /w/app-412 is already building a3f9b1.. (pid 41233) -- tail ... -- stim guide lifecycle concurrency
+    build       waiting on /w/app-412 (pid 41233, 4m elapsed) -- tail ... -- stim guide lifecycle concurrency
+    build       waited 12m41s for /w/app-412's build -> installed from cache -- stim guide lifecycle concurrency
 
   and install the artifact the builder stored. They report cacheHit: "local"
   plus waitedForBuild: { pid, ms }.
@@ -3096,10 +3180,27 @@ OPT-IN CONCURRENCY LIMITS (UNLIMITED BY DEFAULT)
   paths eligible under the source checkout's Git ignore rules, including .env
   and local configuration. The source's nonempty
   .worktreeexclude replaces its resolved worktree.exclude setting. Nested
-  registered worktrees, .DerivedData, and android/build/generated/autolinking
-  caches are excluded, including in nested apps. Gradle regenerates autolinking
+  registered worktrees, .DS_Store, .DerivedData, .idea, and
+  android/build/generated/autolinking caches are excluded, including inside
+  newly copied directories. Gradle regenerates autolinking
   for the destination checkout on its next build. Warm also skips paths
   overlapping a nested destination worktree or below a symlink ancestor.
+  Tracked .idea settings come from Git and stay untouched by warm.
+
+  Other generated state stays eligible: .gradle, .cxx, *.tsbuildinfo, build
+  directories, and embedded JavaScript need project-specific decisions about
+  regeneration. Native intermediates can record the source checkout's paths;
+  warm does not relocate them. Excluding the whole .expo directory can drop
+  generated TypeScript inputs.
+
+  To choose exclusions, run this in the source checkout's repository root:
+
+    git ls-files --others --ignored --exclude-standard --directory --no-empty-directory
+
+  Patterns match those entries with the trailing / removed. They do not prune
+  children of a whole ignored directory: if Git lists android/app/src/main/assets/,
+  excluding its bundle.jsbundle child has no effect. Exclude the assets entry
+  only when the project regenerates everything inside it.
 
   Warm copies directly into the destination, without intermediate staging.
   Keep the source checkout and the linked worktree on the same volume to
@@ -3451,22 +3552,63 @@ THE POOL: WHICH DEVICE AN ID-LESS \`--device\` PICKS
   \`.ipa\` export, store signing and distribution stay out of scope.`
 			},
 			simslim: {
-				summary: "installing SimSlim and what ios.simslimProfile does to an owned simulator",
-				body: () => `OPTIONAL SIMSLIM PROFILE
+				summary: "recommended SimSlim profiles and recovery from host memory pressure",
+				body: () => `SIMSLIM FOR PARALLEL IOS WORK
+  SimSlim is recommended as an optional way to reduce simulator background
+  services and memory use, especially with several workspaces. Review which
+  services your app and tests need; a slim profile can disable those features.
+  It does not guarantee that a memory stall or crash will be fixed.
+
   Install SimSlim once on each Mac:
 
     brew install mobai-app/tap/simslim
 
-  Then commit a profile and select it in .stim.json:
+  Review the categories and create a profile in an interactive terminal:
+
+    simslim profiles
+    mkdir -p .simslim
+    simslim profile .simslim/dev.json
+
+  Selected categories in the wizard stay enabled. The wizard writes the
+  profile without applying it. Review and commit it, then select it in .stim.json:
 
     { "ios": { "simslimProfile": ".simslim/dev.json" } }
 
-  SimSlim requires an iOS 18 or newer simulator. On each local \`stim ios\`,
+  SimSlim 0.8 requires iOS 18.5 or newer. On each local \`stim ios\`,
   Stim reconciles that profile on the owned simulator before the app build.
   The first change can update services and reboot the simulator. A matching
   profile is a fast no-op on later launches. The settings persist across normal
   shutdowns and reboots. Removing the setting restores stock services when
-  Stim applied the profile. Stim never changes an unowned or remote simulator.`
+  Stim applied the profile. Stim never changes an unowned or remote simulator.
+  Each SimSlim operation has a 12-minute outer deadline, including discovery.
+  This cap also applies when SimSlim's own timeout is increased. On timeout,
+  Ctrl-C, or SIGTERM, Stim attempts to stop only its verified process group, then waits up to
+  10 seconds to confirm termination before returning or exiting.
+  An unconfirmed process group keeps its claim and blocks another reconciliation;
+  inspect the named processes before removing the exact claim in the error.
+  The simulator's managed settings record is retained, so retrying reconciles an
+  interrupted apply or restore. Stim does not assume partial changes rolled back.
+  Doctor recommends this setup but never installs SimSlim or applies a profile.
+  Profile schema and service tradeoffs: https://github.com/MobAI-App/simslim
+
+HOST MEMORY PRESSURE AND STALLED SIMULATORS
+  Booted and a working screenshot do not prove that simulator processes can
+  start. Stim checks a bounded process spawn before install and bounds local
+  simulator launch operations. Simulator discovery waits up to 30 seconds,
+  boot (including the initial boot request) up to 10 minutes, and app installation
+  up to 5 minutes. Process termination confirmation can take another 10 seconds;
+  a final boot-state query can take 30 seconds. Opening the Simulator app after
+  boot is best-effort and takes at most 5 seconds. A timeout is not proof of an
+  app crash or OOM.
+  Doctor and failure diagnostics report macOS memory pressure when available;
+  a failed query remains unknown. Existing swap or low free RAM alone is not
+  enough to diagnose pressure.
+
+  If pressure is elevated, free host memory before retrying. Use \`stim stop\`
+  only in workspaces you own and have finished using; ask before closing other
+  agents' simulators or heavy apps. Rebooting a simulator under the same pressure
+  can repeat the stall. Consider fewer concurrent builds/devices (guide lifecycle
+  concurrency) and a reviewed SimSlim profile for future runs.`
 			}
 		}
 	},
@@ -3527,6 +3669,18 @@ If a delete fails, the device's config record is KEPT and the command reports
 it. A record is what makes the device findable again, so it outlives a failed
 teardown rather than turning it into an orphan.
 
+ANDROID DATA WITHOUT A REGISTRATION
+  \`gc\` also reports stim-*.avd directories whose .ini registration is
+  gone. \`gc --delete\` rechecks the directory, emulator process locks, and
+  current workspace and pool references before removing that data. A registration
+  under any name that points at the directory protects it. User AVDs, symlinks
+  and unverifiable storage stay. The no-config and scoped-STIM_HOME
+  sweep guards apply to these directories too.
+  A partial avdmanager deletion is a failure even if the tool exits successfully.
+  The owning workspace or pool record stays for a retry. If removing orphan
+  data fails, its remaining directory is reported as stim-gc-<id>.avd on the
+  next sweep.
+
 BUILD LOCKS
   \`gc\` also reports the single-flight build locks (above): the ones whose
   builder is no longer running are debris a reboot or a kill left behind, and
@@ -3777,7 +3931,9 @@ KEYS STIM READS
                         at most 64 KiB. Install the
                         external tool once with
                         \`brew install mobai-app/tap/simslim\`. SimSlim requires
-                        an iOS 18 or newer simulator. Each local \`stim ios\`
+                        iOS 18.5 or newer in SimSlim 0.8. Recommended for parallel
+                        iOS work after reviewing service tradeoffs; see
+                        \`stim guide lifecycle simslim\`. Each local \`stim ios\`
                         reconciles the profile on its Stim-owned simulator.
                         The first change can reboot it; a matching profile is a
                         fast no-op. Removing the setting restores stock services
@@ -3814,7 +3970,10 @@ KEYS STIM READS
                         -- the sdkmanager package id the owned AVD is created
                         from. The \`--system-image\` flag overrides this per
                         invocation, and an id this SDK has not installed is
-                        STIM_BAD_ARG with the installed ids printed
+                        STIM_BAD_ARG with the installed ids printed.
+                        New AVDs use the Pixel 6 hardware profile (1080x2400,
+                        420 dpi). Existing AVDs keep their display settings;
+                        parked AVDs from the old generic profile are not adopted.
   android.dataPartitionSizeGb
                         whole GiB for a newly created owned AVD's data
                         partition. Defaults to 8; accepts 6 through 16384.
@@ -3894,6 +4053,25 @@ ${ANDROID_AVD_CONFIG_HELP.map((line) => `                          ${line}`).joi
                         did not create it, so a Metro request through it is
                         still gated the same way a managed tunnel's is. Set it
                         before Expo start so the manifest advertises it.
+  metro.warmupUrl       optional object with per-platform bundle URLs:
+  metro.warmupUrl.ios
+  metro.warmupUrl.android
+                        an HTTP(S) URL or a /path ending in .bundle, with the
+                        full query the app uses, including a matching platform.
+                        Unset uses Expo's manifest or bare React Native defaults.
+                        Stim preserves the path and query but always requests
+                        this workspace's verified local Metro port; a supplied
+                        host and port are ignored. No defaults are added to an
+                        override. This only configures prefetch, not the app.
+                        For example, in .stim.json:
+                        { "metro": { "warmupUrl": {
+                          "ios": "/src/main.bundle?platform=ios&dev=true&lazy=true"
+                        } } }
+                        Use the app's complete request for custom options.
+                        URLs must encode spaces and omit fragments. doctor
+                        validates the shape and platform but cannot discover
+                        runtime entry-point or dev-menu overrides or auto-fix
+                        them. See \`guide metro\` for warmup behavior.
   worktree.exclude      ignored-path skip list for worktree warm. Settings
                         come from the source checkout's repository-root
                         .stim.json. A nonempty .worktreeexclude in the source
@@ -4044,6 +4222,7 @@ key inherits the next layer. Changes apply on the next build or Metro restart.
       "remoteBuildCache": true,
       "releaseBundleSwap": true,
       "metroSharedCache": true,
+      "metroWarmup": true,
       "ios": {
         "compilationCache": true,
         "swiftCompilationCache": false,
@@ -4075,6 +4254,11 @@ The example shows the defaults. Full setting names and behavior:
     false stops Stim appending its shared Metro store on both dev servers.
     Project-configured stores remain the project's choice. Replace the removed
     machine setting caches.injectMetroStore=false with this setting set false.
+  optimizations.metroWarmup
+    true by default. false skips background development bundle requests during
+    ios/android, including any metro.warmupUrl override. Metro verification and
+    native builds still run. Applies on the next ios/android command; no Metro
+    restart is needed.
   optimizations.ios.compilationCache
     controls Xcode compilation caching (Xcode 26+).
   optimizations.ios.swiftCompilationCache

package/dist/{ios-CK1Vrk6Q.mjs → ios-B7KLgIp5.mjs}

@@ -1,28 +1,28 @@
-import { t as getExecutor } from "./exec-bsN9MJXb.mjs";
-import { S as upsertProject, f as getProject, l as getConcurrencyLimits } from "./config-D7uu8Gbq.mjs";
+import { t as getExecutor } from "./exec-CyylIdq9.mjs";
+import { S as upsertProject, f as getProject, l as getConcurrencyLimits } from "./config-CMtIaTk9.mjs";
 import { r as createNdjsonWriter } from "./ndjson-DcAtEx_K.mjs";
-import { D as workspaceLogsDir, T as workspaceDir, _ as writeWorkspaceState, g as writeWorkspaceLaunch, n as MODE_EXPO, p as readWorkspaceState, t as MODE_BARE } from "./state-IYEY-zi8.mjs";
-import { C as removeTemporaryEntry, S as makeTemporaryDirectory, g as repoRoot, s as gitCommonDir } from "./worktree-Dx3ZC5lS.mjs";
-import { a as findProjectRoot, c as projectShortcut, i as detectIsExpo, r as detectBundleId, t as appProjectProblem } from "./project-COj6nzzh.mjs";
-import { i as resolveProjectMetro, r as pidExists } from "./metro-B01H3EuD.mjs";
-import { n as verifyCollectorOwnership } from "./ownership-D8HmSv2E.mjs";
-import { a as easAuthNote, c as loadProjectProvider, d as resolveEasCliBin, f as resolveRemote, i as checkEasAuth, n as UPLOAD_TIMEOUT_MS, o as exitAfterFlush, p as uploadRemote, r as cacheLevel, s as isEasAuthFailureText, t as RESOLVE_TIMEOUT_MS, v as POOL_SETTING_REMEDY, x as parkedMaxSetting } from "./remote-cache-DOi5-zLj.mjs";
-import { D as remoteIosSetting, E as remoteDeviceSettingError, F as unknownSettingKeys, H as resolveOptimizations, L as detectProviders, M as settingShapeErrors, O as resolveCacheProviderConfig, P as tunnelModeSetting, V as optimizationBuildProfile, _ as iosSigningIdentitySha1SettingError, a as SETTING_SHAPE_REMEDY, d as cacheProviderSettingError, f as iosLanHostSetting, g as iosSigningIdentitySha1Setting, h as iosSigningIdentitySettingError, k as resolveSettings, m as iosSigningIdentitySetting, p as iosLanHostSettingError, r as REMOTE_DEVICE_BACKENDS, w as publicUrlSetting, z as artifactCachePolicy } from "./settings-BSwrY4FZ.mjs";
+import { D as workspaceLogsDir, T as workspaceDir, _ as writeWorkspaceState, g as writeWorkspaceLaunch, n as MODE_EXPO, p as readWorkspaceState, t as MODE_BARE } from "./state-CZ-ER-8d.mjs";
+import { C as removeTemporaryEntry, S as makeTemporaryDirectory, g as repoRoot, s as gitCommonDir } from "./worktree-C79xx_kM.mjs";
+import { a as findProjectRoot, c as projectShortcut, i as detectIsExpo, r as detectBundleId, t as appProjectProblem } from "./project-BBTVABUz.mjs";
+import { i as resolveProjectMetro, r as pidExists } from "./metro-COslRK_F.mjs";
+import { n as verifyCollectorOwnership } from "./ownership-CGPart6T.mjs";
+import { a as easAuthNote, c as loadProjectProvider, d as resolveEasCliBin, f as resolveRemote, i as checkEasAuth, n as UPLOAD_TIMEOUT_MS, o as exitAfterFlush, p as uploadRemote, r as cacheLevel, s as isEasAuthFailureText, t as RESOLVE_TIMEOUT_MS, v as POOL_SETTING_REMEDY, x as parkedMaxSetting } from "./remote-cache-DDmJ1Roq.mjs";
+import { A as resolveSettings, B as artifactCachePolicy, D as remoteDeviceSettingError, F as tunnelModeSetting, H as optimizationBuildProfile, I as unknownSettingKeys, N as settingShapeErrors, O as remoteIosSetting, R as detectProviders, T as publicUrlSetting, U as resolveOptimizations, _ as iosSigningIdentitySha1SettingError, a as SETTING_SHAPE_REMEDY, d as cacheProviderSettingError, f as iosLanHostSetting, g as iosSigningIdentitySha1Setting, h as iosSigningIdentitySettingError, k as resolveCacheProviderConfig, m as iosSigningIdentitySetting, p as iosLanHostSettingError, r as REMOTE_DEVICE_BACKENDS, x as metroWarmupUrlSetting } from "./settings-DwU1_U_q.mjs";
 import { _ as launchErrorPreview, c as launchErrorReport, g as stepTimer, h as stepClock, i as formatDuration, l as phaseLine, m as shortUdid, n as appReadinessMessage, p as shortHash } from "./command-output-8wHMEde0.mjs";
-import { C as launchIosApp, E as unverifiedLaunchLines, O as verifyLaunch, T as readMetroRecords, b as isBundleProof, c as RELEASE_VERIFY_WAIT_MS, f as clearOtherUserApps, i as LAUNCH_BUNDLING, k as verifyReleaseLaunch, m as devClientUrl, n as DEFAULT_METRO_PORT, o as LAUNCH_FATAL, s as LAUNCH_UNVERIFIED, v as installIosApp, w as readCollectorRecords, y as iosAppProcess } from "./app-install-oZIQRbdD.mjs";
-import { d as listIosRuntimes } from "./ios-BZxKPuqP.mjs";
-import { C as untrackedNativeFiles, S as untrackedMissLine, _ as providerUploadOutcome, b as storeBuild, c as buildCacheKey, d as filesystemBuildCapability, f as fingerprintDiffRecord, g as providerDownloadPath, h as prepareProviderDownloadDir, i as releaseBuildLock, l as describeFingerprintMiss, m as fingerprintProject, n as acquireBuildLock, o as takeoverLine, p as fingerprintDiffSuffix, s as waitForBuild, t as WAIT_CEILING_MS, v as refingerprintAfterMutation, y as resolveBuild } from "./build-lock-vE45ZzJZ.mjs";
-import { r as claimFailure } from "./ownership-claim-CeJLEpjD.mjs";
-import { a as lostLine, c as releaseLeaseOnSignal, i as leaseExpiryText, l as runLease, n as DEBUG_VERIFY_STEP_MS, o as lostRefusal, r as acquireRunLease, s as parseDeviceWait, t as selectFromPool, u as waitFlagConflict } from "./device-pool-BlHXnYYs.mjs";
-import { r as releaseBuildSlot, t as acquireBuildSlot } from "./build-slots-CgacA9zQ.mjs";
-import { a as swapJsBundle, c as ensureWorkspaceStorageSafely, d as noMetroMessage, f as noMetroRemedy, l as gateShouldRetry, m as sleep, n as pickDevClientScheme, o as needsPrebuild, p as resolveMetroWithRetry, r as schemesFromInfoPlist, s as runPrebuild, t as devClientScheme, u as launchOutcomeRecord } from "./dev-client-Bvky1hya.mjs";
-import { a as statsProjectKey, i as recordRunStats, n as readRunEstimates, t as createRunRecorder } from "./stats-wqxPm7Tv.mjs";
-import { C as unknownIosDeviceTypeRefusal, _ as checkDeviceCapacity, b as ensureOwnedDevice, c as discoverXcodeProject, d as resolveScheme, i as buildIos, l as readBundleExecutable, m as describeDiagnostic, n as COMPILATION_CACHE_UNAVAILABLE, o as compilationCacheActivityLine, t as COMPILATION_CACHE_NOT_RUN, u as readBundleId, v as clearIosAdoptionPending, w as unknownIosRuntimeRefusal, y as ensureBooted } from "./xcode-CDB6fytw.mjs";
-import { a as ensureMetroReachable, b as ownedSessionName, c as remoteIosDeps, l as resolveRemoteContext, n as binOnPath, o as ensureRemoteBootOwned, r as bundleEntryPoint, w as gateMetroOrigin } from "./device-remote-CCgkG82J.mjs";
+import { C as launchIosApp, E as unverifiedLaunchLines, O as verifyLaunch, T as readMetroRecords, b as isBundleProof, c as RELEASE_VERIFY_WAIT_MS, f as clearOtherUserApps, i as LAUNCH_BUNDLING, k as verifyReleaseLaunch, m as devClientUrl, n as DEFAULT_METRO_PORT, o as LAUNCH_FATAL, s as LAUNCH_UNVERIFIED, v as installIosApp, w as readCollectorRecords, y as iosAppProcess } from "./app-install-NFxUahnH.mjs";
+import { f as listIosRuntimes } from "./ios-D1h1Di39.mjs";
+import { C as untrackedNativeFiles, S as untrackedMissLine, _ as providerUploadOutcome, b as storeBuild, c as buildCacheKey, d as filesystemBuildCapability, f as fingerprintDiffRecord, g as providerDownloadPath, h as prepareProviderDownloadDir, i as releaseBuildLock, l as describeFingerprintMiss, m as fingerprintProject, n as acquireBuildLock, o as takeoverLine, p as fingerprintDiffSuffix, s as waitForBuild, t as WAIT_CEILING_MS, v as refingerprintAfterMutation, y as resolveBuild } from "./build-lock-BsVoLDaq.mjs";
+import { r as claimFailure } from "./ownership-claim-7zRxxTfZ.mjs";
+import { a as lostLine, c as releaseLeaseOnSignal, i as leaseExpiryText, l as runLease, n as DEBUG_VERIFY_STEP_MS, o as lostRefusal, r as acquireRunLease, s as parseDeviceWait, t as selectFromPool, u as waitFlagConflict } from "./device-pool-B5pEVa3t.mjs";
+import { r as releaseBuildSlot, t as acquireBuildSlot } from "./build-slots-D0b6sJyo.mjs";
+import { a as swapJsBundle, c as ensureWorkspaceStorageSafely, d as noMetroMessage, f as noMetroRemedy, h as warmMetro, l as gateShouldRetry, m as sleep, n as pickDevClientScheme, o as needsPrebuild, p as resolveMetroWithRetry, r as schemesFromInfoPlist, s as runPrebuild, t as devClientScheme, u as launchOutcomeRecord } from "./dev-client-RpvXxCXV.mjs";
+import { a as statsProjectKey, i as recordRunStats, n as readRunEstimates, t as createRunRecorder } from "./stats-BCWEVLrM.mjs";
+import { T as unknownIosRuntimeRefusal, b as ensureBooted, c as discoverXcodeProject, d as resolveScheme, i as buildIos, l as readBundleExecutable, m as describeDiagnostic, n as COMPILATION_CACHE_UNAVAILABLE, o as compilationCacheActivityLine, t as COMPILATION_CACHE_NOT_RUN, u as readBundleId, v as checkDeviceCapacity, w as unknownIosDeviceTypeRefusal, x as ensureOwnedDevice, y as clearIosAdoptionPending } from "./xcode-DeKCribl.mjs";
+import { a as ensureMetroReachable, b as ownedSessionName, c as remoteIosDeps, l as resolveRemoteContext, n as binOnPath, o as ensureRemoteBootOwned, r as bundleEntryPoint, w as gateMetroOrigin } from "./device-remote-E81KAdXf.mjs";
 import { t as spawnEntry } from "./spawn-entry-nCE6m770.mjs";
-import { a as printNativeCrashReport, n as IOS_CRASH_REPORT_RETRY, o as simulatorConsolePaths, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-B5IJwv3-.mjs";
-import { a as iosDeviceProcess, c as listIosDevices, d as verifyIosDeviceReleaseLaunch, i as installIosDeviceApp, l as localNetworkPending, n as LAUNCH_PROBE_TIMEOUT_MS, o as iosPoolCandidates, r as awaitIosDeviceLaunch, s as iosPoolNoCandidatesRefusal, t as DEVICECTL_INSTALL_TIMEOUT_MS, u as resolveIosPhysicalDevice } from "./ios-device-CdSm0GDw.mjs";
-import { a as runPodInstall, n as podsAreStale, r as readPodState } from "./deps-64wVnpZc.mjs";
+import { a as printNativeCrashReport, n as IOS_CRASH_REPORT_RETRY, o as simulatorConsolePaths, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-Dw8Gn3yw.mjs";
+import { a as iosDeviceProcess, c as listIosDevices, d as verifyIosDeviceReleaseLaunch, i as installIosDeviceApp, l as localNetworkPending, n as LAUNCH_PROBE_TIMEOUT_MS, o as iosPoolCandidates, r as awaitIosDeviceLaunch, s as iosPoolNoCandidatesRefusal, t as DEVICECTL_INSTALL_TIMEOUT_MS, u as resolveIosPhysicalDevice } from "./ios-device-xNt0Lg6v.mjs";
+import { a as runPodInstall, n as podsAreStale, r as readPodState } from "./deps-BLBsTNDS.mjs";
 import { existsSync, mkdirSync, mkdtempSync, openSync, rmSync, writeFileSync } from "node:fs";
 import { InvalidArgumentError } from "commander";
 import { X509Certificate } from "node:crypto";
@@ -812,6 +812,7 @@ const DEFAULT_DEPS = {
 	detectProviders,
 	resolveProjectMetro,
 	resolveMetroWithRetry,
+	warmMetro,
 	readWorkspaceState,
 	pidExists,
 	getConcurrencyLimits,
@@ -1052,6 +1053,7 @@ async function verifyIosRun({ root, appPath, d, release, launched, configuration
 		return { state: crashes.length || processCheck?.reason === "exited" ? LAUNCH_FATAL : LAUNCH_UNVERIFIED };
 	}
 	const verification = metroCheck ? await d.verifyLaunch({
+		requireBundleResponse: true,
 		onReadinessPending: () => phase("readiness", "waiting for app readiness (up to 30s after bundle load)"),
 		logsDir,
 		since: launchedAt,
@@ -1190,6 +1192,9 @@ function recordIosReloadTarget({ d, root, physical, remoteDevice, bundleId, udid
 		note(chalk.yellow(phaseLine("state", `could not record iOS launch: ${error?.message || error}`)));
 	}
 }
+function simulatorLaunchFailureRemedy(remote, udid, bundleId, logFile) {
+	return `${remote ? "Run" : "If the simulator timed out, run `stim doctor --platform ios` and resolve any reported host memory pressure before retrying. Otherwise run"} \`xcrun simctl launch --console ${udid} ${bundleId}\` to see what the app reports, and check ${logFile}.`;
+}
 async function finishIosRun({ d, root, json, release, configuration, buildScheme, isExpo, metroCheck, metroPort, logsDir, logFile, device, udid, physical, lanAddress, lanOriginUrl, remoteDevice, bootPromise, bootDuration, appPath, bundleId: initialBundleId, swapDir, buildFailure, fail, phase, note, logWriter, uploadPending, providerUpload, providerName, remote, abandonedRemote: remoteWasAbandoned, elapsed, startedAt, storeHash, storeKey, cacheHit, compilationCache, useBuildCache, waitedForBuild, closeWriter, lease, releaseLease, recordRun }) {
 	let bundleId = initialBundleId;
 	let leaseWarned = false;
@@ -1428,7 +1433,7 @@ async function finishIosRun({ d, root, json, release, configuration, buildScheme
 			return fail({
 				code: launched.code || "STIM_LAUNCH_FAILED",
 				message: launched.reason,
-				remedy: `Run \`xcrun simctl launch --console ${udid} ${bundleId}\` to see what the app reports, and check ${logFile}.`,
+				remedy: simulatorLaunchFailureRemedy(Boolean(remoteDevice), udid, bundleId, logFile),
 				build: {
 					...buildFailure,
 					appPath,
@@ -2032,6 +2037,13 @@ async function runIos(opts = {}, overrides = {}) {
 				return false;
 			}
 		}
+		if (!release && metroCheck && optimizations.metroWarmup) d.warmMetro({
+			port: metroPort,
+			platform: "ios",
+			isExpo,
+			appId: proj?.bundleId,
+			bundleUrl: metroWarmupUrlSetting(settings, "ios")
+		});
 		return true;
 	}
 	async function resolveLanOrigin() {
@@ -2267,7 +2279,7 @@ async function runIos(opts = {}, overrides = {}) {
 				releasedWait = null;
 				const held = attempt.held;
 				const who = held.projectRoot || "another workspace";
-				phase("build", `${who} is already building ${shortHash(fingerprint)} (pid ${held.pid})${held.logFile ? ` -- tail ${held.logFile}` : ""}`);
+				phase("build", `${who} is already building ${shortHash(fingerprint)} (pid ${held.pid})${held.logFile ? ` -- tail ${held.logFile}` : ""} -- stim guide lifecycle concurrency`);
 				let waited = null;
 				try {
 					const ceilingMs = WAIT_CEILING_MS - (d.now() - waitStarted);
@@ -2319,7 +2331,7 @@ async function runIos(opts = {}, overrides = {}) {
 						pid: held.pid,
 						ms: waited.waitedMs
 					};
-					phase("build", `waited ${formatDuration(waited.waitedMs)} for ${who}'s build -> installed from cache`);
+					phase("build", `waited ${formatDuration(waited.waitedMs)} for ${who}'s build -> installed from cache -- stim guide lifecycle concurrency`);
 				} else if (waited?.lockReleased) {
 					failedHolder = void 0;
 					releasedWait = {
@@ -2540,7 +2552,7 @@ async function runIos(opts = {}, overrides = {}) {
 							phase("cache", `hit ${shortHash(storeHash)} (post-${mutatingSteps.join("/")} key)`);
 							if (releasedWait) {
 								waitedForBuild = releasedWait.facts;
-								phase("build", `waited ${formatDuration(waitedForBuild.ms)} for ${releasedWait.who}'s build -> installed from cache`);
+								phase("build", `waited ${formatDuration(waitedForBuild.ms)} for ${releasedWait.who}'s build -> installed from cache -- stim guide lifecycle concurrency`);
 							}
 						}
 					}