stim 1.11.0 → 1.12.0

package/dist/{guide-NDvTmMi-.mjs → guide-BPBlh9ML.mjs}

@@ -1,6 +1,7 @@
-import { o as findProjectRoot } from "./project-BXZzOABt.mjs";
-import { t as ANDROID_AVD_CONFIG_HELP } from "./settings-B5oFZEri.mjs";
-import { t as guideStatus } from "./guide-status-CWvti2Lg.mjs";
+import { i as findProjectRoot } from "./project-B8rbutVC.mjs";
+import { t as ANDROID_AVD_CONFIG_HELP } from "./settings-BlyDn2Oz.mjs";
+import { t as RECENT_LAUNCH_MS } from "./status-BUASYyy_.mjs";
+import { t as guideStatus } from "./guide-status-i9ogHt4v.mjs";
 import { SETTINGS_SCHEMA_URL } from "@stim-cli/core/state";
 import chalk from "chalk";
 //#endregion
@@ -177,7 +178,8 @@ RULES DURING THE LOOP
   them. Use stim doctor when a build is unexpectedly slow or the environment
   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).
+  session on the reported serial (guide lifecycle). Each status issue names a
+  remedy to run from its workspace (guide facts status).
 
 OWNERSHIP AND DELETION
 
@@ -242,7 +244,11 @@ Run stim stop when you pause or finish a task, and stim worktree remove once
 it is merged or abandoned. Never create a simulator or emulator by hand;
 every device comes from Stim. Before starting a new workspace, check stim
 status for an idle workspace to reuse and confirm capacity headroom instead of
-adding another.
+adding another. Never quit Device Hub or Simulator.app: on Xcode 27
+(confirmed on 27A266a), quitting Device Hub by default shuts down every booted
+simulator on the machine, including ones it never opened a window for and
+ones other workspaces or agents are using. Use stim stop on workspaces you
+own instead.
 
 SANDBOXES
 
@@ -836,12 +842,14 @@ RULES
     orphanedWorkspaces      { dir, projectRoot, bytes }  --delete removes the
                               whole workspace directory
     linkedWorktrees         { path, idleDays, mergedInto, willRemove,
-                              reason, detail }  mergedInto is the default
-                              branch HEAD is merged into ("origin/main"),
-                              or null; detail says why it is removed
-                              ("merged into origin/main", "idle 9d") or kept.
-                              Without --worktrees, the source checkout and
-                              roots outside git are left out
+                              reason, detail, eligibleAt }  mergedInto is
+                              the default branch HEAD is merged into
+                              ("origin/main"), or null; detail says why it
+                              is removed ("merged into origin/main", "idle
+                              9d") or kept. eligibleAt is the ISO time a
+                              recent-activity worktree becomes removable,
+                              else null. Without --worktrees, the source
+                              checkout and roots outside git are left out
     parkedSimulators        { udid, name, model, runtime, parkedAt, bytes,
                               listed }  with --older-than, only those parked
                               at least that long
@@ -895,7 +903,8 @@ RULES
                             locked | in-use | status-unreadable | dirty |
                             unpushed-unchecked | unpushed | submodules |
                             not-merged | merge-unknown | last-use-unknown |
-                            recently-used
+                            recently-used | activity-unknown |
+                            recent-activity
 
   These print the error contract instead and exit 1:
 
@@ -906,9 +915,47 @@ RULES
   - --cache together with --worktrees or --idle`
 			},
 			status: {
-				summary: "the status payload's build and device activity fields: a running build, its estimate, each platform's last build, and who drives each device",
+				summary: "the status payload's issues and their codes, build and device activity fields: a running build, its estimate, each platform's last build, and who drives each device",
 				body: () => `  stim status --json
 
+  Each environment carries issues, the things in that workspace that need
+  the user, and warnings, the same issues as text ("<slot>: " when not the
+  default slot, then "<message>; run \`<remedy>\`"):
+
+  issues   [{ code, severity, message, remedy, workspace, slot? }]
+
+  code       port-not-ours          something other than this workspace's
+                                    Metro answers its reserved port
+             sim-missing            the recorded simulator no longer exists
+             sim-without-metro      the simulator is booted and no Metro
+                                    serves the workspace
+             avd-serial-changed     the owned emulator came back on another
+                                    serial, so Metro forwarding is lost
+             avd-missing            the recorded AVD no longer exists
+             avd-not-detected       adb does not see the owned emulator while
+                                    the workspace expects it: it holds an
+                                    unexpired lease on its serial, or it
+                                    launched onto it and has not stopped
+                                    that slot since, and its dev server runs
+                                    or the launch was in the last
+                                    ${RECENT_LAUNCH_MS / 6e4} minutes. An idle workspace's
+                                    shut-down emulator is android.state
+                                    "not-detected" with no issue.
+             avd-unchecked          the emulator listing could not be read
+             supervisor-unverified  a supervisor record whose process status
+                                    cannot prove gone or ours; stop refuses to
+                                    signal it
+  severity   "error" when stop or start refuses until it is resolved, else
+             "warning"
+  remedy     a command to run from workspace, such as "stim android --slot
+             fold"
+  slot       absent for the default slot
+
+  A supervisor record whose pid is gone or reused is not an issue: status
+  reports supervisor null, and the next stop or start clears the record.
+  \`stop --slot <name>\` forgets that slot's launch, so a device stopped on
+  purpose is not reported while the shared dev server keeps running.
+
   Each booted simulator and detected emulator in environments (and in
   slots) carries activity; a shut-down or physical device has none:
 
@@ -1006,11 +1053,12 @@ RULES
   is already built, so it does not measure progress.`
 			},
 			plan: {
-				summary: "the ios and android --plan payload: fingerprint, cacheHit, prebuild, expectedMs and basis",
+				summary: "the ios and android --plan payload: fingerprint, cacheHit, prebuild, missReason, expectedMs and basis",
 				body: () => `  stim ios --plan --json            # or: stim android --plan --json
 
   { platform, slot?, fingerprint, cacheKey, cacheHit, provider,
-    cacheSkipped, prebuild, outcome, expectedMs, basis, refusal? }
+    cacheSkipped, prebuild, outcome, expectedMs, basis, missReason?,
+    refusal? }
 
   fingerprint   the fingerprint the run would look up first; with
                 --eas-profile, the one EAS CLI computes
@@ -1025,6 +1073,15 @@ RULES
   expectedMs    the median wall time of this project's last successful runs
                 with that outcome on that platform, or null with none
   basis         how many runs expectedMs comes from (at most 10)
+  missReason    on a predicted cold build with cache reads on, why the
+                cache has no app, in the shape of lastBuilds.<platform>
+                .missReason (\`guide facts status\`), compared with the same
+                baseline the run would use. kind is "changed",
+                "no-baseline", "same-sources" or "prebuild-pending": a
+                baseline exists and the run would prebuild first, which the
+                plan does not, so changes compare the fingerprint before that
+                prebuild; changeCount 0 then means those inputs match the
+                baseline. rekeyedBy is empty.
   refusal       { code, message, remedy } when the run would refuse:
                 STIM_PREBUILD_FAILED for a tracked native dir the fingerprint
                 leaves out, STIM_EAS_BUILD_MISSING for an EAS miss
@@ -2574,7 +2631,11 @@ captured"  (in metro.ndjson, bare RN)
   ios.deviceType, ios.runtime, android.systemImage or android.deviceProfile
   setting is checked the same way, and the check applies
   even when this workspace ALREADY owns a device, so a name that could never
-  create anything is caught rather than left to a later run.
+  create anything is caught rather than left to a later run. The
+  \`pixel_fold\` and \`resizable\` profiles on a system image without
+  foldable support (SupportPixelFold in its advancedFeatures.ini) refuse the
+  same way, since the emulator quits on boot; the remedy names an installed
+  image that has it, or an sdkmanager install when none does.
   \`gc --json --cache <name>\` refuses with STIM_BAD_ARG when no shared cache
   carries the name; the remedy names the caches on this machine. \`gc\`
   refuses --cache together with --worktrees the same way.
@@ -2643,9 +2704,17 @@ captured"  (in metro.ndjson, bare RN)
 				summary: "a lock held past the wait; workspace-process and short directory locks",
 				body: () => `STIM_LOCK_TIMEOUT
   The same locks, held by an ordinary command that is still running, for
-  longer than the wait -- 60s by default, 4 minutes for the remote-session and
-  EAS project locks, and ~90 minutes for the \`worktree warm\` lock, which one
-  \`--refresh\` can hold for a whole dependency install. That wait prints its
+  longer than the wait -- 60s by default, 4 minutes for the remote-session lock
+  and for \`gc\` deleting EAS sessions under the EAS project lock (its sweep
+  skips at once while that lock is held), and ~90 minutes for the \`worktree warm\` lock, which one
+  \`--refresh\` can hold for a whole dependency install. The machine-wide EAS
+  project lock admits one EAS session start at a time. A \`--remote eas\` run
+  waits on it after its build with no overall limit, printing \`lock  waiting
+  for EAS remote start (pid 41233, in <workspace>, running for 1m12s) to
+  release the EAS project lock\` at once and \`still waiting for ...\` every 30
+  seconds. It refuses only when one holder has held the lock for longer than
+  the slowest EAS session start (39 minutes), naming that pid.
+  The \`worktree warm\` wait prints its
   elapsed waiting time and holder every 30 seconds (\`lock        waiting 40s
   for stim worktree warm --refresh (pid 41233)\`) and the refusal names the same holder
   and the lock directory under ~/.stim/warm-locks.
@@ -3111,9 +3180,9 @@ ANDROID EMULATOR RESTARTS
   started is alive. Stim keeps waiting on the same emulator; it never
   launches a duplicate. See \`stim guide errors STIM_NO_DEVICE\` for the
   wait windows, diagnostics, and recovery steps.
-  On macOS, top-level androidEmulatorApp "stim-desktop" in the machine config
-  boots owned emulators without a window and shows them in Stim Desktop; see
-  guide settings. An emulator that is already running keeps its current
+  On macOS, androidEmulatorApp "stim-desktop", the default while Stim Desktop
+  is installed, boots owned emulators without a window and shows them in Stim
+  Desktop; see guide settings. An emulator that is already running keeps its current
   display until it next boots.
 
 DESTRUCTIVE COMMANDS -- ask the user first
@@ -3657,7 +3726,11 @@ PREDICTING THE NEXT BUILD (--plan)
   the cache.provider tier into a temporary directory the plan removes, the
   app config's provider wherever it keeps its downloads, as during a run.
   On a miss it adds the prebuild decision the run would make (generate,
-  regenerate, none, or refuse with STIM_PREBUILD_FAILED). With --eas-profile it asks EAS for a matching
+  regenerate, none, or refuse with STIM_PREBUILD_FAILED) and, with cache
+  reads on, the miss reason the run would print, such as "native dependency
+  added: expo-clipboard". A plan never prebuilds, so when the run would and a
+  baseline exists, the reason's kind is prebuild-pending and it compares the
+  fingerprint before that prebuild. With --eas-profile it asks EAS for a matching
   build (config, fingerprint:generate, build:list) and downloads nothing.
   expectedMs is the median of this project's recorded runs with that outcome;
   the payload is in \`guide facts plan\`.
@@ -4362,8 +4435,17 @@ OPT-IN CONCURRENCY LIMITS (UNLIMITED BY DEFAULT)
   sim with \`stim worktree remove\` (or \`stim gc --delete\`), then run
   \`stim ios\` again to create the requested one. \`--device-profile\` does
   the same for an AVD of another profile. To keep both devices, give the new
-  one its own \`--slot\`. \`--runtime\` and \`--system-image\` apply at
-  creation only, so an existing device keeps the version it was made with.
+  one its own \`--slot\`. \`--runtime\` and the ios.runtime and
+  android.systemImage settings apply at creation only, so an existing device
+  keeps the version it was made with. An explicit \`--system-image\` that
+  names another image than this workspace's AVD refuses the same way, unless
+  that AVD never finished a boot (for example one made from an image its
+  profile cannot boot): Stim then deletes it through owned-device teardown and
+  creates the requested one. \`--device-profile pixel_fold\` or
+  \`resizable\` on a system image without foldable support (SupportPixelFold
+  in its advancedFeatures.ini) refuses with STIM_BAD_ARG before anything is
+  created, since the emulator quits on boot; the remedy names an installed
+  image that has it.
   The --json payload reports what was actually used: \`deviceType\` and
   \`runtime\` on iOS, \`systemImage\` and \`deviceProfile\` on Android, read
   from the device itself, so a settings-driven run reports them too.`
@@ -4723,9 +4805,10 @@ HOST MEMORY PRESSURE AND STALLED SIMULATORS
   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. After boot, Stim opens the owned
-  simulator in the selected Xcode's Device Hub on Xcode 27, or Simulator on
-  older Xcode. Top-level iosSimulatorApp in the machine config can select
-  Siniulator or Stim Desktop instead; see guide settings. Override it for one
+  simulator in Stim Desktop while it is installed, otherwise in the selected
+  Xcode's Device Hub on Xcode 27, or Simulator on older Xcode. Top-level
+  iosSimulatorApp in the machine config can select another viewer; see guide
+  settings. Override it for one
   local run with \`stim ios --simulator-app siniulator\`,
   \`--simulator-app stim-desktop\`, or \`--simulator-app xcode\`. This also
   opens an already running owned simulator without rebooting it or saving the
@@ -4745,7 +4828,11 @@ HOST MEMORY PRESSURE AND STALLED SIMULATORS
 
   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
+  agents' simulators or heavy apps. Never quit Device Hub or Simulator.app to
+  free memory: on Xcode 27 (confirmed on 27A266a), quitting Device Hub by
+  default shuts down every booted simulator on the machine, including ones it
+  never opened a window for and ones other workspaces or agents are using.
+  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.`
 			}
@@ -4773,6 +4860,8 @@ WHAT RECLAIMS AN OWNED DEVICE
                             verified parked simulators and emulators, and
                             runs \`stim worktree remove\` on every clean,
                             Stim-managed linked worktree whose branch is merged
+                            and that shows no activity within
+                            gc.worktreeGraceMinutes
   stim gc --delete --older-than <days>
                             also reaps the device of a workspace no Stim
                             command has used in that long, even though the
@@ -4795,8 +4884,12 @@ boot rather than a create, a provision and a reinstall.
 
 Before shutting down, parking or deleting an owned device, Stim best-effort
 closes local agent-device sessions bound to its exact iOS UDID or live Android
-serial. It rechecks device ownership and uses agent-device's rejecting session
-target guard; sessions on other devices stay open. Physical devices are outside
+serial. An Android session must also name the owned AVD, because the next
+emulator on a console port reuses its serial. \`stop\` closes a session only
+when agent-device's claim on the device names it and was taken inside this
+workspace; sessions from another workspace or claim stay open. Stim rechecks
+device ownership and uses agent-device's rejecting session target guard;
+sessions on other devices stay open. Physical devices are outside
 this cleanup. agent-device is optional: a missing binary skips this step, and a
 failed or timed-out list/close prints a device line on stderr while teardown
 continues. Cleanup allows at most 15 seconds of agent-device calls per device.
@@ -4852,6 +4945,26 @@ SWEEPING FINISHED WORKTREES
   initialized submodules. Without --worktrees, the report leaves out the
   source checkout and roots outside git.
 
+  IN USE means its dev server supervisor runs, a stim ios, android or stop
+  run holds its native-run lock, a live build lock or slot names it, a
+  managed tunnel or remote lock is held, an owned simulator or emulator of
+  the workspace is booted (an agent-device session needs one), or it holds
+  an unexpired device lease. When the simulator or emulator list cannot be
+  read, the worktree counts as in use. A device left booted keeps the
+  worktree until \`stim stop\` in it, or \`gc --idle <duration>\`, shuts
+  the device down.
+
+  RECENT ACTIVITY keeps a worktree gc would otherwise remove until
+  gc.worktreeGraceMinutes (120 by default, \`guide settings\`) have passed
+  since the latest of: a write to its git index, HEAD or HEAD reflog, a write
+  to its Stim workspace state or log files, and, for a merged branch, the
+  committer date of the commit that brought it into the default branch. That
+  window is when an agent that just merged runs \`stim stop\` and \`stim
+  worktree remove\` itself. The reason is recent-activity, and the report
+  and the JSON eligibleAt field say when it becomes removable. When that
+  activity cannot be read, the worktree is kept (reason activity-unknown).
+  0 turns the grace period off.
+
   MERGED means, with the default branch taken from origin/HEAD, after a
   \`git fetch origin <default>\` per repository (30s timeout, no credential
   prompt; skipped when that checkout fetched in the last 10 minutes):
@@ -4880,8 +4993,9 @@ SWEEPING FINISHED WORKTREES
   --cache with --worktrees is refused with STIM_BAD_ARG; run them separately.
   With --delete it runs the \`stim worktree remove\` pipeline, never --force,
   on each removable worktree. That pipeline re-inspects the worktree and
-  re-checks use under the removal locks, and idleness for an idle worktree
-  or an unchanged HEAD for a merged one, then parks devices and handles the
+  re-checks use and recent activity under the removal locks, and idleness
+  for an idle worktree or an unchanged HEAD for a merged one, then parks
+  devices through the same teardown and handles the
   branch exactly as a manual \`stim worktree remove\`, which keeps the
   checkout when its HEAD moves while devices are reclaimed. A worktree that
   changed since the report is kept with the reason. A worktree that fails is
@@ -5332,6 +5446,12 @@ KEYS STIM READS
                         profile. When this workspace already owns an AVD of
                         another profile, a requested profile refuses rather
                         than booting it; reap the AVD to create the new one.
+                        "pixel_fold" and "resizable" need a system image
+                        whose advancedFeatures.ini turns on SupportPixelFold
+                        (recent images such as API 34 google_apis do); the
+                        emulator quits on boot without it, so Stim refuses
+                        the pair with
+                        STIM_BAD_ARG and names an installed image that has it.
                         Existing AVDs keep their display settings; parked AVDs
                         from the old generic profile are not adopted.
   android.dataPartitionSizeGb
@@ -5360,6 +5480,10 @@ ${ANDROID_AVD_CONFIG_HELP.map((line) => `                          ${line}`).joi
                         keys are protected. The emulator may normalize a valid
                         value. These overrides apply only to a newly created
                         AVD; existing and recovered AVDs are never rewritten.
+                        Unless these settings set hw.keyboard, every AVD Stim
+                        creates gets hw.keyboard=yes, so the emulator takes
+                        gRPC key events. The one rewrite: a parked AVD created
+                        before that default gets it when a workspace adopts it.
                         On displayless Linux, Stim launches with
                         -gpu swiftshader_indirect -noaudio; those arguments
                         override hw.gpu.enabled, hw.gpu.mode, hw.audioInput,
@@ -5543,8 +5667,13 @@ STIM_BAD_ARG. See \`guide lifecycle budget\` for what each limit reclaims.
 THE IOS SIMULATOR APP IS MACHINE-LEVEL
 Top-level \`iosSimulatorApp\` in ~/.stim/config.json selects the macOS app that
 displays Stim's owned local iOS simulator after boot. It is not a project
-setting. Unset or \`"xcode"\` opens the selected Xcode's Device Hub on Xcode 27,
-or Simulator on older Xcode. To use an installed Siniulator instead:
+setting. Unset, it is \`"stim-desktop"\` while Stim Desktop is installed and
+\`"xcode"\` otherwise. \`"xcode"\` opens the selected Xcode's Device Hub on Xcode 27,
+or Simulator on older Xcode. On Xcode 27 (confirmed on 27A266a), quitting
+Device Hub by default shuts down every booted simulator on the machine,
+including ones it never opened a window for and ones other workspaces or
+agents are using; never quit it to free memory or clean up. To use an
+installed Siniulator instead:
 
   { "iosSimulatorApp": "siniulator" }
 
@@ -5570,9 +5699,10 @@ window behavior.
 
 THE ANDROID EMULATOR APP IS MACHINE-LEVEL
 Top-level \`androidEmulatorApp\` in ~/.stim/config.json selects how an owned
-Android emulator that Stim boots on macOS is displayed. Unset or
-\`"emulator"\` opens the emulator's own window. To boot it headlessly and show
-it in Stim Desktop instead:
+Android emulator that Stim boots on macOS is displayed. Unset, it is
+\`"stim-desktop"\` while Stim Desktop is installed and \`"emulator"\`
+otherwise. \`"emulator"\` opens the emulator's own window. To boot it
+headlessly and show it in Stim Desktop:
 
   { "androidEmulatorApp": "stim-desktop" }
 
@@ -5584,6 +5714,12 @@ current display until it next boots, and physical devices are unaffected.
 An invalid value refuses before boot. On Linux and Windows the setting has
 no effect.
 
+Stim finds Stim Desktop by its bundle id, dev.stim.desktop, in Launch Services.
+\`stim settings\` shows that default as \`(default: Stim Desktop installed)\`,
+\`settings get\` prints it on stderr, and \`--json\` adds
+\`"defaultReason": "Stim Desktop installed"\`. A set value always wins; set
+\`"xcode"\` or \`"emulator"\` to keep the device windows.
+
 THE DEVICE POOL BOUNDS ARE MACHINE-LEVEL TOO
 \`pool.iosParkedMax\` caps how many parked simulators \`worktree remove\` may
 leave behind for a later workspace to adopt. It is machine-level for the same
@@ -5614,6 +5750,21 @@ test suites and the end-to-end harness use one -- and a scoped config must not
 leave simulators on the machine it cannot account for. A redirected home that
 wants a pool says so with the variable.
 
+THE GC WORKTREE GRACE PERIOD IS MACHINE-LEVEL
+\`gc.worktreeGraceMinutes\` is how long \`gc --delete\` waits before it removes
+a merged or idle linked worktree. The clock starts at the worktree's latest
+activity: a write to its git index, HEAD or HEAD reflog, its Stim workspace
+state or logs, or the merge of its branch into the default branch.
+
+  {
+    "gc": { "worktreeGraceMinutes": 120 }
+  }
+
+in ~/.stim/config.json, or STIM_GC_WORKTREE_GRACE_MINUTES in the environment,
+which overrides the file. Absent means 120. \`0\` removes a finished worktree at
+once. A value that is not a whole number 0 or more is warned about by \`gc\`,
+which then uses 120. See \`guide cleanup\` for what else keeps a worktree.
+
 STIM NEEDS NO PROJECT CHANGES TO RUN
 Nothing above is required to use Stim. The performance caches that used to
 be setup steps are supplied by Stim on the command lines it composes itself:

package/dist/{guide-status-CWvti2Lg.mjs → guide-status-i9ogHt4v.mjs}

@@ -1,5 +1,5 @@
-import { f as getProject, u as getConfigDir, w as upsertProject } from "./config-BEq0Qw_a.mjs";
-import { n as appProjectProblem } from "./project-BXZzOABt.mjs";
+import { T as upsertProject, d as getConfigDir, p as getProject } from "./config-0jCcMM0E.mjs";
+import { n as appProjectProblem } from "./project-B8rbutVC.mjs";
 import { t as compareStimVersions } from "./stim-installations-CINXy_su.mjs";
 import { mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
 import { join } from "node:path";

package/dist/{idle-NETbeNiQ.mjs → idle-S3tFZ53_.mjs}

@@ -1,10 +1,10 @@
-import { H as projectDeviceSlots } from "./config-BEq0Qw_a.mjs";
-import { m as readWorkspaceState } from "./metro-BWLOJ_Wr.mjs";
-import { o as formatLongDuration } from "./command-output-D5z2_bcF.mjs";
-import { n as createActivityReader, r as idleForMs } from "./activity-BtG4Va9l.mjs";
-import { I as ownedAvdSerialResolver } from "./android-C4zG2Tuc.mjs";
-import { d as teardownOwnedAvd, f as teardownOwnedIosSim } from "./ownership-BiojdtAp.mjs";
-import { r as activeBuildState, s as parseActiveBuild, t as ACTIVE_BUILD_KEY } from "./build-progress-CDwogz6R.mjs";
+import { U as projectDeviceSlots } from "./config-0jCcMM0E.mjs";
+import { m as readWorkspaceState } from "./metro-Dzo30hvJ.mjs";
+import { o as formatLongDuration } from "./command-output-BWCj5Vh-.mjs";
+import { n as createActivityReader, r as idleForMs } from "./activity-CCZJs__P.mjs";
+import { L as ownedAvdSerialResolver } from "./android-75Sk2rIR.mjs";
+import { d as teardownOwnedAvd, f as teardownOwnedIosSim } from "./ownership-B8d4kXBx.mjs";
+import { r as activeBuildState, s as parseActiveBuild, t as ACTIVE_BUILD_KEY } from "./build-progress-h60GPV27.mjs";
 import chalk from "chalk";
 //#region src/commands/gc/idle.ts
 function findOwnedDeviceActivity({ config, sims, androidSerial, readActivity, deadProjects = [] }) {

package/dist/{in-use-DVhlSoyn.mjs → in-use-D9XYEgFD.mjs}

@@ -1,10 +1,10 @@
-import { f as getProject, k as ownership_claim_exports, u as getConfigDir } from "./config-BEq0Qw_a.mjs";
-import { O as workspaceDir, m as readWorkspaceState } from "./metro-BWLOJ_Wr.mjs";
-import { n as declareSpawnsOn, o as stopDeclaringSpawnsOn } from "./spawn-claims-BJwXTMPt.mjs";
-import { n as workspaceProcessLockError, r as workspaceProcessLockPath, t as withWorkspaceProcessLock } from "./workspace-process-lock-Cx74RSDZ.mjs";
-import { a as formatElapsed } from "./command-output-D5z2_bcF.mjs";
-import { h as listBuildLocks } from "./device-lease-D83nqeMX.mjs";
-import { n as managedLockHolders, t as resolveSupervisorTarget } from "./ownership-BiojdtAp.mjs";
+import { A as ownership_claim_exports, d as getConfigDir, p as getProject } from "./config-0jCcMM0E.mjs";
+import { O as workspaceDir, m as readWorkspaceState } from "./metro-Dzo30hvJ.mjs";
+import { n as declareSpawnsOn, o as stopDeclaringSpawnsOn } from "./spawn-claims-PT8aQpCa.mjs";
+import { n as workspaceProcessLockError, r as workspaceProcessLockPath, t as withWorkspaceProcessLock } from "./workspace-process-lock-BvvJTfo_.mjs";
+import { a as formatElapsed } from "./command-output-BWCj5Vh-.mjs";
+import { h as listBuildLocks } from "./device-lease-B9LAXIUH.mjs";
+import { n as managedLockHolders, t as resolveSupervisorTarget } from "./ownership-B8d4kXBx.mjs";
 import { lstatSync, readdirSync, rmSync, rmdirSync, statSync, unlinkSync } from "node:fs";
 import { realpathSync as realpathSync$1 } from "fs";
 import { resolve } from "path";

package/dist/{ios-CQLKpNfr.mjs → ios-CDzWL1mj.mjs}

@@ -1,33 +1,33 @@
-import { L as deviceSlotFileKey, R as deviceSlotKey, V as parseDeviceSlotOption, W as validateDeviceSlot, f as getProject, k as ownership_claim_exports, l as getConcurrencyLimits, w as upsertProject } from "./config-BEq0Qw_a.mjs";
+import { A as ownership_claim_exports, G as validateDeviceSlot, H as parseDeviceSlotOption, R as deviceSlotFileKey, T as upsertProject, p as getProject, u as getConcurrencyLimits, z as deviceSlotKey } from "./config-0jCcMM0E.mjs";
 import { t as getExecutor } from "./exec-DK8KaVHK.mjs";
 import { r as createNdjsonWriter } from "./ndjson-CDY9IkVC.mjs";
-import { O as workspaceDir, c as signalProcessTree, h as recordWorkspaceUse, i as pidExists, j as workspaceLogsDir, m as readWorkspaceState$1, s as resolveProjectMetro, y as writeWorkspaceState } from "./metro-BWLOJ_Wr.mjs";
-import { D as makeTemporaryDirectory, O as removeTemporaryEntry, s as gitCommonDir, y as repoRoot } from "./worktree-BlizKDpZ.mjs";
-import { a as detectIsExpo, i as detectBundleId, n as appProjectProblem, o as findProjectRoot, t as NO_PROJECT_REFUSAL } from "./project-BXZzOABt.mjs";
-import { n as MODE_EXPO, p as writeWorkspaceLaunch, t as MODE_BARE } from "./state-WGdIbi_d.mjs";
-import { _ as stepTimer, c as launchErrorReport, g as stepClock, h as shortUdid, i as formatDuration, l as phaseLine, m as shortHash, n as appReadinessMessage, v as launchErrorPreview } from "./command-output-D5z2_bcF.mjs";
-import { A as resolveBuild, C as filesystemBuildCapability, D as providerDownloadPath, E as prepareProviderDownloadDir, F as untrackedNativeFiles, O as providerUploadOutcome, P as untrackedMissLine, T as fingerprintProject, _ as waitForBuild, b as buildCacheKey, g as releaseBuildLock, j as storeBuild, k as refingerprintAfterMutation, m as acquireBuildLock, v as waitForSharedBuild, w as fingerprintDiffRecord } from "./device-lease-D83nqeMX.mjs";
-import { A as resolveCacheProviderConfig, E as publicUrlSetting, I as tunnelModeSetting, L as unknownSettingKeys, P as settingShapeErrors, S as metroWarmupUrlSetting, U as optimizationBuildProfile, V as artifactCachePolicy, W as resolveOptimizations, _ as iosSigningIdentitySha1SettingError, a as SETTING_SHAPE_REMEDY, d as cacheProviderSettingError, f as iosLanHostSetting, g as iosSigningIdentitySha1Setting, h as iosSigningIdentitySettingError, j as resolveSettings, k as remoteIosSetting, m as iosSigningIdentitySetting, p as iosLanHostSettingError, r as REMOTE_DEVICE_BACKENDS, z as detectProviders } from "./settings-B5oFZEri.mjs";
-import { h as POOL_SETTING_REMEDY, y as parkedMaxSetting } from "./ownership-BiojdtAp.mjs";
-import { D as parseIosSimulatorApp, f as listIosRuntimes } from "./ios-DArbmwer.mjs";
-import { c as startBuildProgress, n as NO_BUILD_PROGRESS } from "./build-progress-CDwogz6R.mjs";
-import { a as acquireBuildSlot, s as releaseBuildSlot } from "./in-use-DVhlSoyn.mjs";
-import { n as verifyCollectorOwnership } from "./ownership-D2xbLVoz.mjs";
-import { A as UPLOAD_TIMEOUT_MS, B as resolveRemote, F as isEasAuthFailureText, I as loadProjectProvider, M as checkEasAuth, N as easAuthNote, O as gateMetroOrigin, P as exitAfterFlush, V as uploadRemote, a as ensureMetroReachable, j as cacheLevel, k as RESOLVE_TIMEOUT_MS, l as remoteIosDeps, n as binOnPath, o as ensureRemoteBootOwned, r as bundleEntryPoint, u as resolveRemoteContext, w as ownedSessionName, z as resolveEasCliBin } from "./device-remote-BQZSnnmE.mjs";
-import { c as clearOtherUserApps, h as iosAppProcess, m as installIosApp, r as DEFAULT_METRO_PORT, u as devClientUrl, v as launchIosApp } from "./app-install-DHut6JnV.mjs";
-import { c as readMetroRecords, d as verifyLaunch, f as verifyReleaseLaunch, i as RELEASE_VERIFY_WAIT_MS, l as unverifiedLaunchLines, n as LAUNCH_FATAL, o as isBundleProof, r as LAUNCH_UNVERIFIED, s as readCollectorRecords, t as LAUNCH_BUNDLING } from "./launch-verify-CuPDGXdr.mjs";
-import { c as unknownIosDeviceTypeRefusal, d as easDeviceBuildRemedy, f as isEasBuildFailure, l as unknownIosRuntimeRefusal, m as resolveEasDevelopmentBuild, p as planEasDevelopmentBuild, r as checkDeviceCapacity } from "./simslim-CIR3IYJO.mjs";
-import { d as withNativeBuildRun, r as cancelledFailure, u as runCancellation } from "./native-run-D7yB_AsB.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-DHj7cdPy.mjs";
-import { C as ensureDevServer, D as sleep, E as launchOutcomeRecord, O as warmMetro, S as clearIosAdoptionPending, T as isPhysicalDeviceRequest, _ as staleNativeDirRefusal, a as refusePlan, c as skippedMissReason, d as schemesFromInfoPlist, g as runPrebuild, h as recordPrebuild, i as printPlan, l as devClientScheme, m as planPrebuild, n as planFlagRefusal, o as explainBuildMiss, p as swapJsBundle, r as planPayload, s as fingerprintErrorMissReason, t as planCachedBuild, u as pickDevClientScheme, v as ensureBooted, w as ensureWorkspaceStorageSafely, y as ensureOwnedDevice } from "./build-plan-CeAYgKAx.mjs";
-import { t as budgetGate } from "./budget-De3P2rq_.mjs";
-import { f as spawnEntry, s as startDevServer } from "./start-BSsf2tUs.mjs";
-import { a as statsProjectKey, i as recordRunStats, n as readRunEstimates, t as createRunRecorder } from "./stats-BAgJaLA4.mjs";
-import { a as compilationCacheActivityLine, c as readBundleExecutable, l as readBundleId, p as describeDiagnostic, r as buildIos, s as discoverXcodeProject, t as COMPILATION_CACHE_NOT_RUN, u as resolveScheme } from "./xcode-B5SPD--o.mjs";
-import { n as nativeRunCommand, t as launchSlotScope } from "./slot-launch-rggO1Esw.mjs";
-import { a as printNativeCrashReport, n as IOS_CRASH_REPORT_RETRY, o as simulatorConsolePaths, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-UYFSQwRy.mjs";
-import { a as iosPoolCandidates, c as listIosDevices, d as verifyIosDeviceReleaseLaunch, i as iosDeviceProcess, l as localNetworkPending, n as installIosDeviceApp, o as iosPoolNoCandidatesRefusal, r as iosDeviceBounds, s as isWirelessIosDevice, t as awaitIosDeviceLaunch, u as resolveIosPhysicalDevice } from "./ios-device-CwDZo0X4.mjs";
-import { a as runPodInstall, n as podsAreStale, r as readPodState } from "./deps-OF7CD5Dx.mjs";
+import { O as workspaceDir, c as signalProcessTree, h as recordWorkspaceUse, i as pidExists, j as workspaceLogsDir, m as readWorkspaceState$1, s as resolveProjectMetro, y as writeWorkspaceState } from "./metro-Dzo30hvJ.mjs";
+import { D as makeTemporaryDirectory, O as removeTemporaryEntry, s as gitCommonDir, y as repoRoot } from "./worktree-DeBQSVtR.mjs";
+import { i as findProjectRoot, n as appProjectProblem, r as detectIsExpo, t as NO_PROJECT_REFUSAL } from "./project-B8rbutVC.mjs";
+import { m as writeWorkspaceLaunch, n as MODE_EXPO, t as MODE_BARE } from "./state-DcDgzfu3.mjs";
+import { _ as stepTimer, c as launchErrorReport, g as stepClock, h as shortUdid, i as formatDuration, l as phaseLine, m as shortHash, n as appReadinessMessage, v as launchErrorPreview } from "./command-output-BWCj5Vh-.mjs";
+import { A as resolveBuild, C as filesystemBuildCapability, D as providerDownloadPath, E as prepareProviderDownloadDir, F as untrackedNativeFiles, O as providerUploadOutcome, P as untrackedMissLine, T as fingerprintProject, _ as waitForBuild, b as buildCacheKey, g as releaseBuildLock, j as storeBuild, k as refingerprintAfterMutation, m as acquireBuildLock, v as waitForSharedBuild, w as fingerprintDiffRecord } from "./device-lease-B9LAXIUH.mjs";
+import { A as resolveCacheProviderConfig, E as publicUrlSetting, I as tunnelModeSetting, L as unknownSettingKeys, P as settingShapeErrors, S as metroWarmupUrlSetting, U as optimizationBuildProfile, V as artifactCachePolicy, W as resolveOptimizations, _ as iosSigningIdentitySha1SettingError, a as SETTING_SHAPE_REMEDY, d as cacheProviderSettingError, f as iosLanHostSetting, g as iosSigningIdentitySha1Setting, h as iosSigningIdentitySettingError, j as resolveSettings, k as remoteIosSetting, m as iosSigningIdentitySetting, p as iosLanHostSettingError, r as REMOTE_DEVICE_BACKENDS, z as detectProviders } from "./settings-BlyDn2Oz.mjs";
+import { h as POOL_SETTING_REMEDY, y as parkedMaxSetting } from "./ownership-B8d4kXBx.mjs";
+import { D as parseIosSimulatorApp, f as listIosRuntimes } from "./ios-CZWOHTTc.mjs";
+import { c as startBuildProgress, n as NO_BUILD_PROGRESS } from "./build-progress-h60GPV27.mjs";
+import { a as acquireBuildSlot, s as releaseBuildSlot } from "./in-use-D9XYEgFD.mjs";
+import { n as verifyCollectorOwnership } from "./ownership-Dqnrjrio.mjs";
+import { a as easAuthNote, c as loadProjectProvider, f as resolveEasCliBin, i as checkEasAuth, m as uploadRemote, n as UPLOAD_TIMEOUT_MS, o as exitAfterFlush, p as resolveRemote, r as cacheLevel, s as isEasAuthFailureText, t as RESOLVE_TIMEOUT_MS } from "./remote-cache-BRsRZru5.mjs";
+import { F as ownedSessionName, S as withNativeBuildRun, a as ensureMetroReachable, l as remoteIosDeps, m as cancelledFailure, n as binOnPath, o as ensureRemoteBootOwned, r as bundleEntryPoint, u as resolveRemoteContext, x as runCancellation, z as gateMetroOrigin } from "./device-remote-C0_o-tJH.mjs";
+import { c as clearOtherUserApps, h as iosAppProcess, m as installIosApp, r as DEFAULT_METRO_PORT, u as devClientUrl, v as launchIosApp } from "./app-install-CsZi0SAT.mjs";
+import { c as readMetroRecords, d as verifyLaunch, f as verifyReleaseLaunch, i as RELEASE_VERIFY_WAIT_MS, l as unverifiedLaunchLines, n as LAUNCH_FATAL, o as isBundleProof, r as LAUNCH_UNVERIFIED, s as readCollectorRecords, t as LAUNCH_BUNDLING } from "./launch-verify-B2oR_kFN.mjs";
+import { c as unknownIosDeviceTypeRefusal, d as easDeviceBuildRemedy, f as isEasBuildFailure, l as unknownIosRuntimeRefusal, m as resolveEasDevelopmentBuild, p as planEasDevelopmentBuild, r as checkDeviceCapacity } from "./simslim-COtEEP7x.mjs";
+import { f as spawnEntry, h as detectBundleId, s as startDevServer } from "./start-BboE1HIS.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-BoezJd-c.mjs";
+import { C as ensureDevServer, D as sleep, E as launchOutcomeRecord, O as warmMetro, S as clearIosAdoptionPending, T as isPhysicalDeviceRequest, _ as staleNativeDirRefusal, a as refusePlan, c as skippedMissReason, d as schemesFromInfoPlist, g as runPrebuild, h as recordPrebuild, i as printPlan, l as devClientScheme, m as planPrebuild, n as planFlagRefusal, o as explainBuildMiss, p as swapJsBundle, r as planPayload, s as fingerprintErrorMissReason, t as planCachedBuild, u as pickDevClientScheme, v as ensureBooted, w as ensureWorkspaceStorageSafely, y as ensureOwnedDevice } from "./build-plan-CqntbR7b.mjs";
+import { t as budgetGate } from "./budget-DbzW5VTD.mjs";
+import { a as statsProjectKey, i as recordRunStats, n as readRunEstimates, t as createRunRecorder } from "./stats-D8rUTPHd.mjs";
+import { a as compilationCacheActivityLine, c as readBundleExecutable, l as readBundleId, p as describeDiagnostic, r as buildIos, s as discoverXcodeProject, t as COMPILATION_CACHE_NOT_RUN, u as resolveScheme } from "./xcode-BzplpQzc.mjs";
+import { n as nativeRunCommand, t as launchSlotScope } from "./slot-launch-DIACGEfH.mjs";
+import { a as printNativeCrashReport, n as IOS_CRASH_REPORT_RETRY, o as simulatorConsolePaths, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-CCxjn31V.mjs";
+import { a as iosPoolCandidates, c as listIosDevices, d as verifyIosDeviceReleaseLaunch, i as iosDeviceProcess, l as localNetworkPending, n as installIosDeviceApp, o as iosPoolNoCandidatesRefusal, r as iosDeviceBounds, s as isWirelessIosDevice, t as awaitIosDeviceLaunch, u as resolveIosPhysicalDevice } from "./ios-device-D9cLxVr5.mjs";
+import { a as runPodInstall, n as podsAreStale, r as readPodState } from "./deps-CO-_7UOm.mjs";
 import { existsSync, mkdirSync, mkdtempSync, openSync, rmSync, writeFileSync } from "node:fs";
 import { InvalidArgumentError } from "commander";
 import { LAST_BUILD_KEYS } from "@stim-cli/core/state";
@@ -3023,7 +3023,8 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 				abandonCreatedSession: remoteDevice.abandonCreatedSession,
 				webPreviewUrl: remoteDevice.webPreviewUrl,
 				writeState: d.writeWorkspaceState,
-				register: registerProject
+				register: registerProject,
+				notice: (line) => note(chalk.dim(phaseLine("lock", line)))
 			}) : boot()).then((result) => {
 				bootDuration = bootTimer();
 				return result;

package/dist/{ios-DArbmwer.mjs → ios-CZWOHTTc.mjs}

@@ -1,9 +1,10 @@
-import { g as loadConfig$1 } from "./config-BEq0Qw_a.mjs";
+import { _ as loadConfig$1 } from "./config-0jCcMM0E.mjs";
 import { t as getExecutor } from "./exec-DK8KaVHK.mjs";
 import { n as stripAnsi, r as waitForChild, t as createLineReader } from "./process-output-Fpl8PYi8.mjs";
-import { X as forgetCreatedDevice, Y as isStimOwnedSim, Z as recordCreatedDevice } from "./android-C4zG2Tuc.mjs";
+import { t as settingDefault } from "./stim-desktop-D0xhpZt8.mjs";
+import { $ as forgetCreatedDevice, Q as isStimOwnedSim, et as recordCreatedDevice } from "./android-75Sk2rIR.mjs";
 import { existsSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
-import { IOS_SIMULATOR_APPS } from "@stim-cli/core/state";
+import { IOS_SIMULATOR_APPS, settingDefinition } from "@stim-cli/core/state";
 import { dirname, join, resolve } from "node:path";
 import { tmpdir } from "node:os";
 //#region src/host-memory.ts
@@ -31,40 +32,43 @@ const OPEN_OPTIONS = {
 	killSignal: "SIGKILL"
 };
 function parseIosSimulatorApp(value, source = "iosSimulatorApp in machine config") {
-	if (value === void 0) return "xcode";
 	if (IOS_SIMULATOR_APPS.includes(value)) return value;
 	const error = /* @__PURE__ */ new Error(`Invalid ${source}. Use "xcode", "siniulator", or "stim-desktop".`);
 	Object.assign(error, { code: "STIM_BAD_ARG" });
 	throw error;
 }
 function configuredIosSimulatorViewer(override) {
-	const app = override ?? parseIosSimulatorApp(loadConfig$1()?.iosSimulatorApp);
+	const configured = loadConfig$1()?.iosSimulatorApp;
+	const chosen = override ?? (configured === void 0 ? void 0 : parseIosSimulatorApp(configured));
+	return { open: (udid) => openSimulator(chosen ?? settingDefault(settingDefinition("iosSimulatorApp")).value, udid) };
+}
+function openSimulator(app, udid) {
 	const exec = getExecutor();
-	if (app === "stim-desktop") return { open: (udid) => {
+	if (app === "stim-desktop") {
 		exec.runFileQuiet("open", [
 			"-g",
 			"-a",
 			"Stim",
 			`stim-desktop://open?udid=${udid}`
 		], OPEN_OPTIONS);
-	} };
-	if (app === "siniulator") return { open: (udid) => {
+		return;
+	}
+	if (app === "siniulator") {
 		exec.runFileQuiet("open", [
 			"-a",
 			"Siniulator",
 			`siniulator://open?udid=${udid}`
 		], OPEN_OPTIONS);
-	} };
-	return { open: (udid) => {
-		const simctlPath = exec.runFileQuiet("xcrun", ["--find", "simctl"], OPEN_OPTIONS);
-		const deviceHubApp = simctlPath ? resolve(dirname(simctlPath), "..", "..", "..", "Applications", "DeviceHub.app") : null;
-		const args = deviceHubApp && existsSync(deviceHubApp) ? [
-			"-a",
-			deviceHubApp,
-			`devices://device/open?id=${udid}`
-		] : ["-a", "Simulator"];
-		exec.runFileQuiet("open", args, OPEN_OPTIONS);
-	} };
+		return;
+	}
+	const simctlPath = exec.runFileQuiet("xcrun", ["--find", "simctl"], OPEN_OPTIONS);
+	const deviceHubApp = simctlPath ? resolve(dirname(simctlPath), "..", "..", "..", "Applications", "DeviceHub.app") : null;
+	const args = deviceHubApp && existsSync(deviceHubApp) ? [
+		"-a",
+		deviceHubApp,
+		`devices://device/open?id=${udid}`
+	] : ["-a", "Simulator"];
+	exec.runFileQuiet("open", args, OPEN_OPTIONS);
 }
 //#endregion
 //#region src/devices/ios.ts

package/dist/{ios-device-CwDZo0X4.mjs → ios-device-D9cLxVr5.mjs}

@@ -1,6 +1,6 @@
 import { t as getExecutor } from "./exec-DK8KaVHK.mjs";
 import { n as TOOL_ERROR_PREFIX } from "./ios-device-BiOsSVzd.mjs";
-import { i as INSTALL_ERROR } from "./app-install-DHut6JnV.mjs";
+import { i as INSTALL_ERROR } from "./app-install-CsZi0SAT.mjs";
 import { mkdtempSync, readFileSync, rmSync } from "node:fs";
 import { join } from "node:path";
 import { tmpdir } from "node:os";