stim 1.1.0 → 1.2.0

package/README.md

@@ -58,6 +58,13 @@ one native platform is in scope; shared project checks still run. Doctor also
 prints the running CLI version and the `stim` installation resolved from PATH,
 and flags a resolved installation that is older than another available one.
 
+For parallel iOS work, SimSlim is recommended as an optional way to reduce
+simulator background services and memory use. Run `stim guide lifecycle simslim`
+to review the service tradeoffs and configure a profile. Doctor recommends the
+setup without installing or enabling it. When a simulator cannot start
+processes, Stim bounds the wait and reports observed host memory pressure when
+available; free memory before retrying. A timeout alone does not prove OOM.
+
 For stale Android CMake launcher findings, stop native builds and run
 `stim doctor --fix --platform android` in the affected checkout. It clears
 affected ignored, untracked generated `.cxx` configurations in the app and

package/dist/{android-CC5bUer7.mjs → android-BW8i_YxU.mjs}

@@ -1,4 +1,4 @@
-import { t as getExecutor } from "./exec-bsN9MJXb.mjs";
+import { t as getExecutor } from "./exec-CyylIdq9.mjs";
 //#region src/collector/android.ts
 const LEVEL_BY_LETTER = {
 	V: "debug",

package/dist/{android-DnZlT3aU.mjs → android-Bcmev2s2.mjs}

@@ -1,29 +1,29 @@
-import { t as getExecutor } from "./exec-bsN9MJXb.mjs";
-import { C as withConfigLock, S as upsertProject, f as getProject, g as loadConfig, l as getConcurrencyLimits, y as saveConfig } from "./config-D7uu8Gbq.mjs";
+import { t as getExecutor } from "./exec-CyylIdq9.mjs";
+import { C as withConfigLock, S as upsertProject, b as setDevice, f as getProject, g as loadConfig, l as getConcurrencyLimits, y as saveConfig } 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, v as emulatorLogFile } 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, n as detectAndroidPackage, r as detectBundleId, t as appProjectProblem } from "./project-COj6nzzh.mjs";
+import { D as workspaceLogsDir, T as workspaceDir, _ as writeWorkspaceState, g as writeWorkspaceLaunch, n as MODE_EXPO, p as readWorkspaceState, t as MODE_BARE, v as emulatorLogFile } 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, n as detectAndroidPackage, r as detectBundleId, t as appProjectProblem } from "./project-BBTVABUz.mjs";
 import { r as waitForChild, t as createLineReader } from "./process-output-C7IlIzd7.mjs";
-import { i as resolveProjectMetro, r as pidExists } from "./metro-B01H3EuD.mjs";
-import { n as verifyCollectorOwnership, r as readCollectors } 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, x as parkedMaxSetting } from "./remote-cache-DOi5-zLj.mjs";
-import { A as settingFile, B as compilerCacheFallbackMessage, E as remoteDeviceSettingError, F as unknownSettingKeys, H as resolveOptimizations, L as detectProviders, M as settingShapeErrors, O as resolveCacheProviderConfig, P as tunnelModeSetting, T as remoteAndroidSetting, V as optimizationBuildProfile, a as SETTING_SHAPE_REMEDY, d as cacheProviderSettingError, k as resolveSettings, r as REMOTE_DEVICE_BACKENDS, s as androidAvdConfigSettingError, u as androidDataPartitionSizeGbSettingError, w as publicUrlSetting, z as artifactCachePolicy } from "./settings-BSwrY4FZ.mjs";
+import { i as resolveProjectMetro, r as pidExists } from "./metro-COslRK_F.mjs";
+import { n as verifyCollectorOwnership, r as readCollectors } 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, x as parkedMaxSetting } from "./remote-cache-DDmJ1Roq.mjs";
+import { A as resolveSettings, B as artifactCachePolicy, D as remoteDeviceSettingError, E as remoteAndroidSetting, F as tunnelModeSetting, H as optimizationBuildProfile, I as unknownSettingKeys, N as settingShapeErrors, R as detectProviders, T as publicUrlSetting, U as resolveOptimizations, V as compilerCacheFallbackMessage, a as SETTING_SHAPE_REMEDY, d as cacheProviderSettingError, j as settingFile, k as resolveCacheProviderConfig, r as REMOTE_DEVICE_BACKENDS, s as androidAvdConfigSettingError, u as androidDataPartitionSizeGbSettingError, 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, n as appReadinessMessage, p as shortHash } from "./command-output-8wHMEde0.mjs";
-import { D as verifyAndroidReleaseLaunch, E as unverifiedLaunchLines, O as verifyLaunch, S as launchAndroidReleaseApp, _ as installConflictKind, c as RELEASE_VERIFY_WAIT_MS, d as androidDevClientUrl, g as installAndroidApp, h as deviceShellArg, i as LAUNCH_BUNDLING, n as DEFAULT_METRO_PORT, o as LAUNCH_FATAL, s as LAUNCH_UNVERIFIED, t as ADB_INSTALL_TIMEOUT_MS, u as androidAppProcess, x as launchAndroidApp } from "./app-install-oZIQRbdD.mjs";
-import { C as untrackedNativeFiles, D as readAssetManifest, E as compareAssetManifests, S as untrackedMissLine, T as captureAssetManifest, _ 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, w as assetDiffReason, x as storedAssetManifest, 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 { c as ensureWorkspaceStorageSafely, d as noMetroMessage, f as noMetroRemedy, i as detectEntryFile, n as pickDevClientScheme, o as needsPrebuild, p as resolveMetroWithRetry, 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 { E as physicalDeviceModel, O as probeEmulatorSerial, _ as listAdbDevices, a as androidSystemImageAbi, b as memoizeEmulatorProbe, f as emulatorDiskSpaceRemedy, h as findBuildTool, i as androidPoolNoCandidatesRefusal, j as resolvePhysicalDevice, k as resetAdoptedAvd, m as extractEmulatorFailure, n as androidHome, p as emulatorFailureRemedy, r as androidPoolCandidates, t as androidDeviceAbi, y as listInstalledSystemImages } from "./android-xmyGBNy5.mjs";
-import { S as unknownAndroidSystemImageRefusal, _ as checkDeviceCapacity, b as ensureOwnedDevice, f as startBuildHeartbeat, p as tailLines, r as HEARTBEAT_INTERVAL_MS, y as ensureBooted } from "./xcode-CDB6fytw.mjs";
-import { a as ensureMetroReachable, b as ownedSessionName, l as resolveRemoteContext, n as binOnPath, o as ensureRemoteBootOwned, s as remoteAndroidDeps } from "./device-remote-CCgkG82J.mjs";
-import { t as cleanLine } from "./server-expo-BEMr_m6p.mjs";
-import { a as buildAndroid, c as CCACHE_NOT_RUN, f as resolveCcache, l as CCACHE_UNAVAILABLE, n as resolveAndroidCas, o as productFlavorRefusal, p as formatDiagnostic, r as resolveAndroidCompilerCache, s as readProductFlavors, u as ccacheActivityLine } from "./android-cas-DGlTStWu.mjs";
+import { D as verifyAndroidReleaseLaunch, E as unverifiedLaunchLines, O as verifyLaunch, S as launchAndroidReleaseApp, _ as installConflictKind, c as RELEASE_VERIFY_WAIT_MS, d as androidDevClientUrl, g as installAndroidApp, h as deviceShellArg, i as LAUNCH_BUNDLING, l as VERIFY_TIMEOUT_MS, n as DEFAULT_METRO_PORT, o as LAUNCH_FATAL, s as LAUNCH_UNVERIFIED, t as ADB_INSTALL_TIMEOUT_MS, u as androidAppProcess, x as launchAndroidApp } from "./app-install-NFxUahnH.mjs";
+import { C as untrackedNativeFiles, D as readAssetManifest, E as compareAssetManifests, S as untrackedMissLine, T as captureAssetManifest, _ 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, w as assetDiffReason, x as storedAssetManifest, 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 { c as ensureWorkspaceStorageSafely, d as noMetroMessage, f as noMetroRemedy, h as warmMetro, i as detectEntryFile, n as pickDevClientScheme, o as needsPrebuild, p as resolveMetroWithRetry, 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 { C as memoizeEmulatorProbe, L as waitForBoot, M as resetAdoptedAvd, N as resolveOwnedAvdSerial, P as resolvePhysicalDevice, _ as findBuildTool, a as androidSystemImageAbi, g as extractEmulatorFailure, h as emulatorFailureRemedy, i as androidPoolNoCandidatesRefusal, j as probeEmulatorSerial, k as physicalDeviceModel, m as emulatorDiskSpaceRemedy, n as androidHome, r as androidPoolCandidates, t as androidDeviceAbi, x as listInstalledSystemImages, y as listAdbDevices } from "./android-K63_0UfF.mjs";
+import { C as unknownAndroidSystemImageRefusal, _ as AvdRecoveryError, b as ensureBooted, f as startBuildHeartbeat, p as tailLines, r as HEARTBEAT_INTERVAL_MS, v as checkDeviceCapacity, x as ensureOwnedDevice } from "./xcode-DeKCribl.mjs";
+import { a as ensureMetroReachable, b as ownedSessionName, l as resolveRemoteContext, n as binOnPath, o as ensureRemoteBootOwned, s as remoteAndroidDeps } from "./device-remote-E81KAdXf.mjs";
+import { t as cleanLine } from "./server-expo-C3ktAwUG.mjs";
+import { a as buildAndroid, c as CCACHE_NOT_RUN, f as resolveCcache, l as CCACHE_UNAVAILABLE, n as resolveAndroidCas, o as productFlavorRefusal, p as formatDiagnostic, r as resolveAndroidCompilerCache, s as readProductFlavors, u as ccacheActivityLine } from "./android-cas-D6HPZ6UQ.mjs";
 import { t as spawnEntry } from "./spawn-entry-nCE6m770.mjs";
-import { a as printNativeCrashReport, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-B5IJwv3-.mjs";
+import { a as printNativeCrashReport, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-Dw8Gn3yw.mjs";
 import { existsSync, mkdirSync, openSync, readFileSync, readdirSync, rmSync } from "node:fs";
 import { InvalidArgumentError } from "commander";
 import { basename, dirname, join, relative } from "node:path";
@@ -840,7 +840,7 @@ async function startCollector({ root, serial, packageName, spawn, kill, alive =
 }
 //#endregion
 //#region src/commands/android/launch.ts
-async function verifyAndroidRun({ root, release, remoteRelease, remoteDevice, verifyReleaseLaunched, verifyLaunched, serial, androidPackage, variant, metroCheck, logsDir, launchedAt, metroPort, isExpo, physical, scheme, component = null, phase }) {
+async function verifyAndroidRun({ root, release, remoteRelease, remoteDevice, verifyReleaseLaunched, verifyLaunched, serial, androidPackage, variant, metroCheck, logsDir, launchedAt, metroPort, isExpo, physical, device, scheme, component = null, phase }) {
 	const readNativeCrashes = () => remoteDevice ? [] : captureNativeCrashes({
 		root,
 		platform: "android",
@@ -872,7 +872,12 @@ async function verifyAndroidRun({ root, release, remoteRelease, remoteDevice, ve
 		phase("", chalk.yellow("A release process exited before readiness. Run `stim logs --errors` for captured crash reports, or `stim logs --source device` for the full device output."));
 		return { state: LAUNCH_FATAL };
 	}
+	const newEmulator = Boolean(device.created && device.owned && !remoteDevice);
+	const timeoutMs = newEmulator ? 6e4 : VERIFY_TIMEOUT_MS;
+	if (metroCheck && newEmulator) phase("verify", "waiting up to 60s for bundle load (new emulator)");
 	const verification = metroCheck ? await verifyLaunched({
+		timeoutMs,
+		requireBundleResponse: true,
 		onReadinessPending: () => phase("readiness", "waiting for app readiness (up to 30s after bundle load)"),
 		logsDir,
 		since: launchedAt,
@@ -947,7 +952,29 @@ async function verifyAndroidRun({ root, release, remoteRelease, remoteDevice, ve
 	})) phase("", chalk.yellow(line));
 	return { state: LAUNCH_UNVERIFIED };
 }
-async function finishAndroidRun({ lease, releaseLease, root, json, metroCheck, useBuildCache, variant, release, isExpo, metroPort, logsDir, emuLog, device, physical, remoteDevice, bootPromise, bootDuration, apkPath, androidPackage: initialPackage, swapDir, record, waitedForBuild, ccache, uploadPending, providerUpload, providerName, remote, abandonedRemote: remoteWasAbandoned, started, startedAt, writer, phase, fail, readApkPackage, install, launch, launchRelease, resolveDevClientScheme, verifyLaunched, verifyReleaseLaunched, spawn, kill, pidAlive, verifyCollector, writeLaunch, writeState, now, out, emit, recordRun }) {
+async function resolveInstallSerial({ root, device, physical, remoteDevice, serial, resolveAvdSerial, waitForDeviceBoot, phase }) {
+	if (physical || remoteDevice || !device.owned || !device.avdName) return serial;
+	const resolved = resolveAvdSerial(device.avdName, { timeoutMs: 5e3 });
+	if (!resolved.serial) throw new Error(`Could not verify a running owned AVD ${device.avdName} before installation.`);
+	if (resolved.serial !== serial) {
+		phase("device", `${device.avdName} changed serial (${serial} -> ${resolved.serial}); checking readiness before installation`);
+		const ready = await waitForDeviceBoot(resolved.serial, 6e4, { commandTimeoutMs: 5e3 });
+		if (!ready.ok) throw new Error(`Emulator ${resolved.serial} never reported boot completion. Diagnostic: ${JSON.stringify(ready.diagnostic)}`);
+		if (resolveAvdSerial(device.avdName, { timeoutMs: 5e3 }).serial !== resolved.serial) throw new Error(`Could not verify AVD ${device.avdName} still runs on ${resolved.serial} after checking readiness.`);
+		phase("device", `reopen agent-device on ${resolved.serial}`);
+	}
+	const consolePort = Number(resolved.serial.replace(/^emulator-/, ""));
+	withConfigLock(() => {
+		const current = loadConfig()?.projects?.[root]?.platforms?.android;
+		if (!current?.owned || current.avdName !== device.avdName) throw new Error("The owned emulator assignment changed before installation.");
+		if (current.consolePort !== consolePort) setDevice(root, PLATFORM, {
+			...current,
+			consolePort
+		});
+	});
+	return resolved.serial;
+}
+async function finishAndroidRun({ lease, releaseLease, root, json, metroCheck, useBuildCache, variant, release, isExpo, metroPort, logsDir, emuLog, device, physical, remoteDevice, bootPromise, resolveAvdSerial, waitForDeviceBoot, bootDuration, apkPath, androidPackage: initialPackage, swapDir, record, waitedForBuild, ccache, uploadPending, providerUpload, providerName, remote, abandonedRemote: remoteWasAbandoned, started, startedAt, writer, phase, fail, readApkPackage, install, launch, launchRelease, resolveDevClientScheme, verifyLaunched, verifyReleaseLaunched, spawn, kill, pidAlive, verifyCollector, writeLaunch, writeState, now, out, emit, recordRun }) {
 	let androidPackage = initialPackage;
 	let leaseWarned = false;
 	const raiseLeaseFor = (boundMs, beforeInstall) => {
@@ -976,7 +1003,21 @@ async function finishAndroidRun({ lease, releaseLease, root, json, metroCheck, u
 			logPath: diag.logPath ? displayPath(root, diag.logPath) : null
 		});
 	}
-	const serial = booted.serial;
+	let serial;
+	try {
+		serial = await resolveInstallSerial({
+			root,
+			device,
+			physical,
+			remoteDevice,
+			serial: booted.serial,
+			resolveAvdSerial,
+			waitForDeviceBoot,
+			phase
+		});
+	} catch (error) {
+		return fail(NO_DEVICE, error instanceof Error ? error.message : String(error), "Run `stim status` to inspect the owned AVD, then retry `stim android`; the APK was not installed.");
+	}
 	phase("device", physical ? `${device.deviceName || serial} (${serial}) connected, not owned by Stim` : `${device.avdName || serial} (${serial}) ${device.adopted || device.adoptionPending ? "adopted" : "booted"} ${bootDuration()}`);
 	const packageFromApk = readApkPackage(apkPath);
 	if (packageFromApk && androidPackage && packageFromApk !== androidPackage) phase("install", chalk.dim(`applicationId ${packageFromApk} (from the APK; project files say ${androidPackage})`));
@@ -1159,6 +1200,7 @@ async function finishAndroidRun({ lease, releaseLease, root, json, metroCheck, u
 		metroPort,
 		isExpo,
 		physical,
+		device,
 		scheme,
 		component: launched.component ?? null,
 		phase
@@ -1263,7 +1305,7 @@ function registerAndroid(program) {
 		})).ok) process.exit(1);
 	});
 }
-function resolveRunAndroidOptions({ root, json = false, remoteDevice: commandRemoteBackend = null, resolveSettingsFor = resolveSettings, resolveRemoteDeviceContext = resolveRemoteContext, remoteDeviceDeps: makeRemoteDeviceDeps = remoteAndroidDeps, resolveEasBin = resolveEasCliBin, ensureMetroReachable: ensureRemoteMetro = ensureMetroReachable, ensureRemoteBootOwned: ensureRemoteOwned = ensureRemoteBootOwned, detectRemoteProviders = detectProviders, metroCheck = true, useBuildCache = true, variant: variantFlag = null, systemImage: systemImageFlag = null, device: deviceFlag = null, wait: waitFlag = void 0, waitConflict = false, acquireLease = acquireRunLease, makeRunLease = runLease, selectPool = selectFromPool, onLeaseSignal = releaseLeaseOnSignal, listDevices = listAdbDevices, deviceModel = physicalDeviceModel, deviceAbi = androidDeviceAbi, isEmulatorDevice = probeEmulatorSerial, readApkPackage = (apkPath) => apkPackage(dumpApkManifest(apkPath)), getLimits = getConcurrencyLimits, checkCapacity = checkDeviceCapacity, acquireSlot = acquireBuildSlot, releaseSlot = releaseBuildSlot, ensureDevice = ensureOwnedDevice, listSystemImages = listInstalledSystemImages, ensureDeviceBooted = ensureBooted, resolveMetro = resolveProjectMetro, resolveMetroRetrying = resolveMetroWithRetry, readState = readWorkspaceState, pidAlive = pidExists, verifyCollector = verifyCollectorOwnership, verifyLaunched = verifyLaunch, ensureStorage = ensureWorkspaceStorageSafely, fingerprint = fingerprintProject, untracked = untrackedNativeFiles, resolveCached = resolveBuild, storeCached = storeBuild, storedAssets = storedAssetManifest, captureAssets = captureAssetManifest, acquireLock = acquireBuildLock, releaseLock = releaseBuildLock, waitForBuild: waitForBuild$1 = waitForBuild, loadProvider = loadProjectProvider, easAuth = checkEasAuth, resolveRemoteBuild = resolveRemote, uploadRemoteBuild = uploadRemote, resolveCacheProvider = resolveCacheProviderConfig, loadCacheProviderModule = loadCacheProvider, needsPrebuildFor = needsPrebuild, prebuild = runPrebuild, build = buildAndroid, ccacheFor = resolveCcache, install = installAndroidApp, launch = launchAndroidApp, launchRelease = launchAndroidReleaseApp, verifyReleaseLaunched = verifyAndroidReleaseLaunch, swapApk = swapApkBundle, resolveDevClientScheme = androidDevClientScheme, spawn = (cmd, args, opts) => getExecutor().spawn(cmd, args, opts), kill = (pid, signal) => process.kill(pid, signal), createWriter = createNdjsonWriter, writeLaunch = writeWorkspaceLaunch, writeState = writeWorkspaceState, recordStats = recordRunStats, readEstimates = readRunEstimates, now = Date.now, out = (line) => console.error(line), emit = (line) => console.log(line) } = {}) {
+function resolveRunAndroidOptions({ root, json = false, remoteDevice: commandRemoteBackend = null, resolveSettingsFor = resolveSettings, resolveRemoteDeviceContext = resolveRemoteContext, remoteDeviceDeps: makeRemoteDeviceDeps = remoteAndroidDeps, resolveEasBin = resolveEasCliBin, ensureMetroReachable: ensureRemoteMetro = ensureMetroReachable, ensureRemoteBootOwned: ensureRemoteOwned = ensureRemoteBootOwned, detectRemoteProviders = detectProviders, metroCheck = true, useBuildCache = true, variant: variantFlag = null, systemImage: systemImageFlag = null, device: deviceFlag = null, wait: waitFlag = void 0, waitConflict = false, acquireLease = acquireRunLease, makeRunLease = runLease, selectPool = selectFromPool, onLeaseSignal = releaseLeaseOnSignal, listDevices = listAdbDevices, deviceModel = physicalDeviceModel, deviceAbi = androidDeviceAbi, isEmulatorDevice = probeEmulatorSerial, readApkPackage = (apkPath) => apkPackage(dumpApkManifest(apkPath)), getLimits = getConcurrencyLimits, checkCapacity = checkDeviceCapacity, acquireSlot = acquireBuildSlot, releaseSlot = releaseBuildSlot, ensureDevice = ensureOwnedDevice, listSystemImages = listInstalledSystemImages, ensureDeviceBooted = ensureBooted, resolveAvdSerial = resolveOwnedAvdSerial, waitForDeviceBoot = waitForBoot, resolveMetro = resolveProjectMetro, warmMetro: prewarmMetro = warmMetro, resolveMetroRetrying = resolveMetroWithRetry, readState = readWorkspaceState, pidAlive = pidExists, verifyCollector = verifyCollectorOwnership, verifyLaunched = verifyLaunch, ensureStorage = ensureWorkspaceStorageSafely, fingerprint = fingerprintProject, untracked = untrackedNativeFiles, resolveCached = resolveBuild, storeCached = storeBuild, storedAssets = storedAssetManifest, captureAssets = captureAssetManifest, acquireLock = acquireBuildLock, releaseLock = releaseBuildLock, waitForBuild: waitForBuild$1 = waitForBuild, loadProvider = loadProjectProvider, easAuth = checkEasAuth, resolveRemoteBuild = resolveRemote, uploadRemoteBuild = uploadRemote, resolveCacheProvider = resolveCacheProviderConfig, loadCacheProviderModule = loadCacheProvider, needsPrebuildFor = needsPrebuild, prebuild = runPrebuild, build = buildAndroid, ccacheFor = resolveCcache, install = installAndroidApp, launch = launchAndroidApp, launchRelease = launchAndroidReleaseApp, verifyReleaseLaunched = verifyAndroidReleaseLaunch, swapApk = swapApkBundle, resolveDevClientScheme = androidDevClientScheme, spawn = (cmd, args, opts) => getExecutor().spawn(cmd, args, opts), kill = (pid, signal) => process.kill(pid, signal), createWriter = createNdjsonWriter, writeLaunch = writeWorkspaceLaunch, writeState = writeWorkspaceState, recordStats = recordRunStats, readEstimates = readRunEstimates, now = Date.now, out = (line) => console.error(line), emit = (line) => console.log(line) } = {}) {
 	return {
 		root,
 		json,
@@ -1298,7 +1340,10 @@ function resolveRunAndroidOptions({ root, json = false, remoteDevice: commandRem
 		ensureDevice,
 		listSystemImages,
 		ensureDeviceBooted,
+		resolveAvdSerial,
+		waitForDeviceBoot,
 		resolveMetro,
+		prewarmMetro,
 		resolveMetroRetrying,
 		readState,
 		pidAlive,
@@ -1343,7 +1388,7 @@ function resolveRunAndroidOptions({ root, json = false, remoteDevice: commandRem
 	};
 }
 async function runAndroid(options = {}) {
-	let { root, json, commandRemoteBackend, resolveSettingsFor, resolveRemoteDeviceContext, makeRemoteDeviceDeps, resolveEasBin, ensureRemoteMetro, ensureRemoteOwned, detectRemoteProviders, metroCheck, useBuildCache: requestedBuildCache, variantFlag, systemImageFlag, deviceFlag, waitFlag, waitConflict, acquireLease, makeRunLease, selectPool, onLeaseSignal, listDevices, deviceModel, deviceAbi, isEmulatorDevice, readApkPackage, getLimits, checkCapacity, acquireSlot, releaseSlot, ensureDevice, listSystemImages, ensureDeviceBooted, resolveMetro, resolveMetroRetrying, readState, pidAlive, verifyCollector, verifyLaunched, ensureStorage, fingerprint, untracked, resolveCached, storeCached, storedAssets, captureAssets, acquireLock, releaseLock, waitForBuild, loadProvider, easAuth, resolveRemoteBuild, uploadRemoteBuild, resolveCacheProvider, loadCacheProviderModule, needsPrebuildFor, prebuild, build, ccacheFor, install, launch, launchRelease, verifyReleaseLaunched, swapApk, resolveDevClientScheme, spawn, kill, createWriter, writeLaunch, writeState, recordStats, readEstimates, now, out, emit } = resolveRunAndroidOptions(options);
+	let { root, json, commandRemoteBackend, resolveSettingsFor, resolveRemoteDeviceContext, makeRemoteDeviceDeps, resolveEasBin, ensureRemoteMetro, ensureRemoteOwned, detectRemoteProviders, metroCheck, useBuildCache: requestedBuildCache, variantFlag, systemImageFlag, deviceFlag, waitFlag, waitConflict, acquireLease, makeRunLease, selectPool, onLeaseSignal, listDevices, deviceModel, deviceAbi, isEmulatorDevice, readApkPackage, getLimits, checkCapacity, acquireSlot, releaseSlot, ensureDevice, listSystemImages, ensureDeviceBooted, resolveAvdSerial, waitForDeviceBoot, resolveMetro, prewarmMetro, resolveMetroRetrying, readState, pidAlive, verifyCollector, verifyLaunched, ensureStorage, fingerprint, untracked, resolveCached, storeCached, storedAssets, captureAssets, acquireLock, releaseLock, waitForBuild, loadProvider, easAuth, resolveRemoteBuild, uploadRemoteBuild, resolveCacheProvider, loadCacheProviderModule, needsPrebuildFor, prebuild, build, ccacheFor, install, launch, launchRelease, verifyReleaseLaunched, swapApk, resolveDevClientScheme, spawn, kill, createWriter, writeLaunch, writeState, recordStats, readEstimates, now, out, emit } = resolveRunAndroidOptions(options);
 	const started = now();
 	const startedAt = new Date(started).toISOString();
 	const projectProblem = appProjectProblem(root);
@@ -1673,7 +1718,8 @@ async function runAndroid(options = {}) {
 			const diag = noDeviceDiagnostic({
 				reason: `Could not ensure an owned Android emulator: ${err?.message || err}`,
 				logFile: emuLog,
-				remedy: "Check that JAVA_HOME and ANDROID_HOME are set correctly, and that an arm64 system image is installed (`sdkmanager \"system-images;android-36;google_apis;arm64-v8a\"`)."
+				localEmulator: !(err instanceof AvdRecoveryError),
+				remedy: err instanceof AvdRecoveryError ? err.remedy : "Check that JAVA_HOME and ANDROID_HOME are set correctly, and that an arm64 system image is installed (`sdkmanager \"system-images;android-36;google_apis;arm64-v8a\"`)."
 			});
 			return fail(NO_DEVICE, diag.message, diag.remedy, {
 				lines: diag.lines,
@@ -1825,6 +1871,13 @@ async function runAndroid(options = {}) {
 		return true;
 	}
 	const runFromFingerprint = async () => {
+		if (metroCheck && metroPort !== null && optimizations.metroWarmup) prewarmMetro({
+			port: metroPort,
+			platform: "android",
+			isExpo,
+			appId: androidPackage,
+			bundleUrl: metroWarmupUrlSetting(settings, "android")
+		});
 		if (!await resolveInitialFingerprint()) return phaseFailure;
 		let remote = null;
 		let abandonedRemote = false;
@@ -1910,7 +1963,7 @@ async function runAndroid(options = {}) {
 					releasedWait = null;
 					const holder = attempt.held;
 					const who = holder.projectRoot || "another workspace";
-					phase("build", `${who} is already building ${shortHash(hash)} (pid ${holder.pid})${holder.logFile ? ` -- tail ${holder.logFile}` : ""}`);
+					phase("build", `${who} is already building ${shortHash(hash)} (pid ${holder.pid})${holder.logFile ? ` -- tail ${holder.logFile}` : ""} -- stim guide lifecycle concurrency`);
 					let waited = null;
 					try {
 						const ceilingMs = WAIT_CEILING_MS - (now() - waitStarted);
@@ -1942,7 +1995,7 @@ async function runAndroid(options = {}) {
 							pid: holder.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 = {
@@ -2049,7 +2102,7 @@ async function runAndroid(options = {}) {
 								phase("cache", `hit ${shortHash(storeHash)} (post-prebuild 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`);
 								}
 							}
 						}
@@ -2223,6 +2276,8 @@ async function runAndroid(options = {}) {
 				physical,
 				remoteDevice,
 				bootPromise,
+				resolveAvdSerial,
+				waitForDeviceBoot,
 				bootDuration: () => bootDuration,
 				apkPath,
 				androidPackage,

package/dist/{android-xmyGBNy5.mjs → android-K63_0UfF.mjs}

@@ -1,7 +1,7 @@
-import { t as getExecutor } from "./exec-bsN9MJXb.mjs";
-import { r as pidExists } from "./metro-B01H3EuD.mjs";
-import { c as androidDataPartitionSizeBytes } from "./settings-BSwrY4FZ.mjs";
-import { existsSync, mkdirSync, openSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "fs";
+import { t as getExecutor } from "./exec-CyylIdq9.mjs";
+import { r as pidExists } from "./metro-COslRK_F.mjs";
+import { c as androidDataPartitionSizeBytes } from "./settings-DwU1_U_q.mjs";
+import { existsSync, lstatSync, mkdirSync, openSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "fs";
 import { homedir } from "os";
 import { dirname, isAbsolute, join, resolve } from "path";
 //#region src/sim/android.ts
@@ -11,6 +11,7 @@ const ANDROID_ABIS = /* @__PURE__ */ new Set([
 	"x86",
 	"x86_64"
 ]);
+const DEFAULT_AVD_DEVICE = "pixel_6";
 function androidHome() {
 	return process.env.ANDROID_HOME || process.env.ANDROID_SDK_ROOT || join(homedir(), "Library", "Android", "sdk");
 }
@@ -115,7 +116,7 @@ function createOwnedAvd(label, { systemImage } = {}) {
 		throw new Error(`No ${arch} Android system image is installed. Install one, e.g.: sdkmanager "system-images;android-36;google_apis;${arch}"`);
 	}
 	const avdName = ownedAvdName(label);
-	getExecutor().run(`echo no | ${androidTool("avdmanager")} create avd -n "${avdName}" -k "${pick.pkg}"`);
+	getExecutor().run(`echo no | ${androidTool("avdmanager")} create avd -n "${avdName}" -k "${pick.pkg}" --device "${DEFAULT_AVD_DEVICE}"`);
 	return {
 		avdName,
 		systemImage: pick.pkg
@@ -334,6 +335,71 @@ function parseAvdRootIni(contents) {
 		relativePath
 	};
 }
+function avdIniPaths(root, ini) {
+	const parsed = parseAvdRootIni(ini);
+	return [parsed.relativePath && !isAbsolute(parsed.relativePath) ? resolve(dirname(root), parsed.relativePath) : null, parsed.path && isAbsolute(parsed.path) ? parsed.path : null].filter((candidate) => candidate !== null);
+}
+function avdStorageRoots() {
+	const env = process.env;
+	return [...new Set([
+		env.ANDROID_AVD_HOME,
+		env.ANDROID_EMULATOR_HOME ? join(env.ANDROID_EMULATOR_HOME, "avd") : null,
+		env.ANDROID_USER_HOME ? join(env.ANDROID_USER_HOME, "avd") : null,
+		env.ANDROID_SDK_HOME ? join(env.ANDROID_SDK_HOME, ".android", "avd") : null,
+		env.ANDROID_SDK_HOME ? join(env.ANDROID_SDK_HOME, "avd") : null,
+		join(homedir(), ".android", "avd")
+	].filter((value) => Boolean(value)))];
+}
+function avdPathExists(path) {
+	try {
+		lstatSync(path);
+		return true;
+	} catch (error) {
+		if (error.code === "ENOENT") return false;
+		throw error;
+	}
+}
+function listOrphanedAvdDirectories(avdName) {
+	const roots = avdStorageRoots();
+	const stores = roots.filter(avdPathExists).map((root) => ({
+		root,
+		canonicalRoot: realpathSync(root),
+		names: readdirSync(root)
+	}));
+	const registered = /* @__PURE__ */ new Set();
+	for (const { root, canonicalRoot, names } of stores) for (const name of names.filter((entry) => entry.endsWith(".ini"))) {
+		const path = join(root, name);
+		const ini = readFileSync(path, "utf8");
+		const targets = /* @__PURE__ */ new Set([...avdIniPaths(root, ini), ...avdIniPaths(canonicalRoot, ini)]);
+		if (!targets.size) throw new Error(`Cannot verify AVD registration at ${path}; its data was kept.`);
+		for (const target of targets) try {
+			registered.add(realpathSync(target));
+		} catch (error) {
+			const code = error.code;
+			if (code !== "ENOENT" && code !== "ENOTDIR") throw error;
+		}
+	}
+	const orphaned = [];
+	for (const { canonicalRoot, names: entries } of stores) {
+		const names = avdName ? [`${avdName}.avd`] : entries;
+		for (const entry of names) {
+			if (!/^stim-[A-Za-z0-9._-]+\.avd$/.test(entry)) continue;
+			const name = entry.slice(0, -4);
+			if (roots.some((candidate) => avdPathExists(join(candidate, `${name}.ini`)))) continue;
+			const directory = join(canonicalRoot, entry);
+			if (registered.has(directory) || !avdPathExists(directory)) continue;
+			const stat = lstatSync(directory);
+			if (!stat.isDirectory() || stat.isSymbolicLink() || realpathSync(directory) !== directory) throw new Error(`Cannot verify AVD data at ${directory}; it was kept.`);
+			if (!orphaned.some((candidate) => candidate.directory === directory)) orphaned.push({
+				name,
+				directory,
+				dev: stat.dev,
+				ino: stat.ino
+			});
+		}
+	}
+	return orphaned;
+}
 function ownedAvdDirectory(avdName, { env = process.env, home = homedir(), readFile = (path) => readFileSync(path, "utf8"), realpath = realpathSync, isDirectory = (path) => statSync(path).isDirectory() } = {}) {
 	if (!/^stim-[A-Za-z0-9._-]+$/.test(avdName)) return null;
 	const roots = [
@@ -350,15 +416,10 @@ function ownedAvdDirectory(avdName, { env = process.env, home = homedir(), readF
 			if (code === "ENOENT" || code === "ENOTDIR") continue;
 			return null;
 		}
-		const parsed = parseAvdRootIni(ini);
-		const candidates = [parsed.relativePath && !isAbsolute(parsed.relativePath) ? resolve(dirname(root), parsed.relativePath) : null, parsed.path && isAbsolute(parsed.path) ? parsed.path : null];
-		for (const candidate of candidates) {
-			if (!candidate) continue;
-			try {
-				const canonical = realpath(candidate);
-				if (isDirectory(canonical)) return canonical;
-			} catch {}
-		}
+		for (const candidate of avdIniPaths(root, ini)) try {
+			const canonical = realpath(candidate);
+			if (isDirectory(canonical)) return canonical;
+		} catch {}
 		return null;
 	}
 	return null;
@@ -415,6 +476,7 @@ function configureNewOwnedAvd(avdName, { dataPartitionSizeGb, avdConfig = {} },
 function avdPoolConfiguration(dataPartitionSizeGb, avdConfig) {
 	return JSON.stringify(Object.entries({
 		...avdConfig,
+		"hw.device.name": DEFAULT_AVD_DEVICE,
 		"disk.dataPartition.size": String(androidDataPartitionSizeBytes(dataPartitionSizeGb))
 	}).toSorted(([a], [b]) => a.localeCompare(b)));
 }
@@ -662,4 +724,4 @@ function resolveOwnedAvdSerial(avdName, { timeoutMs } = {}) {
 	return { notRunning: true };
 }
 //#endregion
-export { resolveOwnedAvdSerial as A, ownedAvdMatchesConfiguration as C, pickDefaultSystemImage as D, physicalDeviceModel as E, shutdownAndroidEmulator as M, waitForAndroidEmulatorShutdown as N, probeEmulatorSerial as O, waitForBoot as P, ownedAvdDirectory as S, ownedAvdSystemImage as T, listAdbDevices as _, androidSystemImageAbi as a, memoizeEmulatorProbe as b, bootAndroidEmulator as c, deleteAvd as d, emulatorDiskSpaceRemedy as f, getAvdNameForSerial as g, findBuildTool as h, androidPoolNoCandidatesRefusal as i, resolvePhysicalDevice as j, resetAdoptedAvd as k, configureNewOwnedAvd as l, extractEmulatorFailure as m, androidHome as n, assertOwnedAvdStopped as o, emulatorFailureRemedy as p, androidPoolCandidates as r, avdPoolConfiguration as s, androidDeviceAbi as t, createOwnedAvd as u, listAvds as v, ownedAvdName as w, nextConsolePort as x, listInstalledSystemImages as y };
+export { pickDefaultSystemImage as A, memoizeEmulatorProbe as C, ownedAvdName as D, ownedAvdMatchesConfiguration as E, shutdownAndroidEmulator as F, waitForAndroidEmulatorShutdown as I, waitForBoot as L, resetAdoptedAvd as M, resolveOwnedAvdSerial as N, ownedAvdSystemImage as O, resolvePhysicalDevice as P, listOrphanedAvdDirectories as S, ownedAvdDirectory as T, findBuildTool as _, androidSystemImageAbi as a, listAvds as b, avdPoolConfiguration as c, configureNewOwnedAvd as d, createOwnedAvd as f, extractEmulatorFailure as g, emulatorFailureRemedy as h, androidPoolNoCandidatesRefusal as i, probeEmulatorSerial as j, physicalDeviceModel as k, avdStorageRoots as l, emulatorDiskSpaceRemedy as m, androidHome as n, assertOwnedAvdStopped as o, deleteAvd as p, androidPoolCandidates as r, avdPathExists as s, androidDeviceAbi as t, bootAndroidEmulator as u, getAvdNameForSerial as v, nextConsolePort as w, listInstalledSystemImages as x, listAdbDevices as y };

package/dist/{android-cas-DGlTStWu.mjs → android-cas-D6HPZ6UQ.mjs}

@@ -1,11 +1,11 @@
-import { t as getExecutor } from "./exec-bsN9MJXb.mjs";
-import { k as withDirLock, u as getConfigDir } from "./config-D7uu8Gbq.mjs";
-import { r as register } from "./cache-manifest-oeH18ERr.mjs";
-import { D as workspaceLogsDir, x as sharedCcache, y as ensureWorkspaceStorage } from "./state-IYEY-zi8.mjs";
+import { t as getExecutor } from "./exec-CyylIdq9.mjs";
+import { k as withDirLock, u as getConfigDir } from "./config-CMtIaTk9.mjs";
+import { r as register } from "./cache-manifest-Cu4_Znw9.mjs";
+import { D as workspaceLogsDir, x as sharedCcache, y as ensureWorkspaceStorage } from "./state-CZ-ER-8d.mjs";
 import { n as stripAnsi, r as waitForChild, t as createLineReader } from "./process-output-C7IlIzd7.mjs";
 import { l as phaseLine } from "./command-output-8wHMEde0.mjs";
-import { n as androidHome } from "./android-xmyGBNy5.mjs";
-import { f as startBuildHeartbeat, r as HEARTBEAT_INTERVAL_MS } from "./xcode-CDB6fytw.mjs";
+import { n as androidHome } from "./android-K63_0UfF.mjs";
+import { f as startBuildHeartbeat, r as HEARTBEAT_INTERVAL_MS } from "./xcode-DeKCribl.mjs";
 import { accessSync, constants, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, symlinkSync, writeFileSync } from "node:fs";
 import { createHash, randomUUID } from "node:crypto";
 import { dirname, isAbsolute, join, relative } from "node:path";

package/dist/android-cas-compiler.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as getExecutor } from "./exec-bsN9MJXb.mjs";
+import { t as getExecutor } from "./exec-CyylIdq9.mjs";
 import { appendFileSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { createHash, randomUUID } from "node:crypto";
 import { join } from "node:path";

package/dist/{app-install-oZIQRbdD.mjs → app-install-NFxUahnH.mjs}

@@ -1,8 +1,8 @@
-import { t as getExecutor } from "./exec-bsN9MJXb.mjs";
+import { t as getExecutor } from "./exec-CyylIdq9.mjs";
 import { o as parseNdjsonText } from "./ndjson-DcAtEx_K.mjs";
-import { t as DEV_MENU_LAUNCH_ARGS } from "./ios-device-CYbuRNXR.mjs";
+import { t as DEV_MENU_LAUNCH_ARGS } from "./ios-device-D3pzTKQE.mjs";
 import { s as isAppLaunchError } from "./command-output-8wHMEde0.mjs";
-import { C as uninstallIosApp, f as listUserApps } from "./ios-BZxKPuqP.mjs";
+import { l as iosSimulatorFailureAdvice, p as listUserApps, w as uninstallIosApp } from "./ios-D1h1Di39.mjs";
 import { closeSync, lstatSync, openSync, readFileSync, readSync, readdirSync } from "node:fs";
 import { createHash } from "node:crypto";
 import { join } from "node:path";
@@ -157,6 +157,10 @@ const IOS_DEV_MENU_OFF_KEYS = ["EXDevMenuShowsAtLaunch", "EXDevMenuShowFloatingA
 const DEV_CLIENT_ONBOARDING_QUERY = "disableOnboarding=1";
 const DEV_CLIENT_DISABLE_FAB_QUERY = "disableFab=1";
 const ANDROID_DISABLE_AUTO_LAUNCH_EXTRA = "EXDevMenuDisableAutoLaunch";
+function describeIosSimulatorFailure(error, exec) {
+	const detail = describe(error);
+	return error?.code === "ETIMEDOUT" ? `${detail}. ${iosSimulatorFailureAdvice(exec)}` : detail;
+}
 function installIosApp({ udid, appPath, bundleId = null, devClientScheme = null, proveInstalled = true }, { exec = null, now = null } = {}) {
 	const e = exec || getExecutor();
 	const artifactStartedAt = now?.();
@@ -171,12 +175,15 @@ function installIosApp({ udid, appPath, bundleId = null, devClientScheme = null,
 			"install",
 			udid,
 			appPath
-		]);
+		], {
+			timeoutMs: 3e5,
+			killSignal: "SIGKILL"
+		});
 	} catch (err) {
 		return {
 			failed: true,
 			code: INSTALL_ERROR,
-			reason: `simctl install failed for ${appPath}: ${describe(err)}`
+			reason: `simctl install failed for ${appPath}: ${describeIosSimulatorFailure(err, e)}`
 		};
 	}
 	const artifactFinishedAt = now?.();
@@ -193,7 +200,7 @@ function installIosApp({ udid, appPath, bundleId = null, devClientScheme = null,
 			key,
 			"-bool",
 			"false"
-		]);
+		], { timeoutMs: 6e4 });
 		for (const key of iosSchemeApprovalKeys(bundleId, devClientScheme)) e.runFile("xcrun", [
 			"simctl",
 			"spawn",
@@ -204,12 +211,12 @@ function installIosApp({ udid, appPath, bundleId = null, devClientScheme = null,
 			key,
 			"-string",
 			bundleId
-		]);
+		], { timeoutMs: 6e4 });
 	} catch (err) {
 		return {
 			failed: true,
 			code: INSTALL_ERROR,
-			reason: `Installed ${bundleId}, but could not prepare the dev client: ${describe(err)}`
+			reason: `Installed ${bundleId}, but could not prepare the dev client: ${describeIosSimulatorFailure(err, e)}`
 		};
 	}
 	const devClientPreparationDurationMs = now && preparationStartedAt !== void 0 ? now() - preparationStartedAt : void 0;
@@ -318,12 +325,12 @@ function launchIosApp({ udid, bundleId, metroPort, devClientScheme = null, conso
 				bundleId,
 				"RCT_jsLocation",
 				jsLocationValue(metroPort)
-			]);
+			], { timeoutMs: 6e4 });
 		} catch (err) {
 			return {
 				failed: true,
 				code: LAUNCH_ERROR,
-				reason: `Could not point ${bundleId} at Metro port ${metroPort} (defaults write RCT_jsLocation): ${describe(err)}`
+				reason: `Could not point ${bundleId} at Metro port ${metroPort} (defaults write RCT_jsLocation): ${describeIosSimulatorFailure(err, e)}`
 			};
 		}
 		if (devClientScheme) {
@@ -349,7 +356,7 @@ function launchIosApp({ udid, bundleId, metroPort, devClientScheme = null, conso
 					"openurl",
 					udid,
 					url
-				]);
+				], { timeoutMs: 6e4 });
 				return {
 					ok: true,
 					mode: "openurl",
@@ -360,7 +367,7 @@ function launchIosApp({ udid, bundleId, metroPort, devClientScheme = null, conso
 				return {
 					failed: true,
 					code: LAUNCH_ERROR,
-					reason: `simctl openurl ${url} failed: ${describe(err)}`
+					reason: `simctl openurl ${url} failed: ${describeIosSimulatorFailure(err, e)}`
 				};
 			}
 		}
@@ -377,7 +384,7 @@ function launchIosApp({ udid, bundleId, metroPort, devClientScheme = null, conso
 		return {
 			failed: true,
 			code: LAUNCH_ERROR,
-			reason: `simctl launch ${bundleId} failed: ${describe(err)}`
+			reason: `simctl launch ${bundleId} failed: ${describeIosSimulatorFailure(err, e)}`
 		};
 	}
 }
@@ -893,7 +900,7 @@ function nativeLaunchFailure({ readCrashes, since, platform, processAlive, mode,
 		waitedMs
 	} : null;
 }
-async function verifyLaunch({ logsDir, since, metroPort = null, platform = null, mode = null, timeoutMs = VERIFY_TIMEOUT_MS, stabilityMs = STABILITY_WINDOW_MS, pollMs = VERIFY_POLL_MS, readRecords = null, readDeviceRecords = null, readClientRecords = null, readNativeCrashes = null, processAlive = null, onReadinessPending = null, now = Date.now, sleep = (ms) => new Promise((r) => setTimeout(r, ms)) } = {}) {
+async function verifyLaunch({ logsDir, since, metroPort = null, platform = null, mode = null, requireBundleResponse, timeoutMs = VERIFY_TIMEOUT_MS, stabilityMs = STABILITY_WINDOW_MS, pollMs = VERIFY_POLL_MS, readRecords = null, readDeviceRecords = null, readClientRecords = null, readNativeCrashes = null, processAlive = null, onReadinessPending = null, now = Date.now, sleep = (ms) => new Promise((r) => setTimeout(r, ms)) } = {}) {
 	const read = readRecords || (() => readMetroRecords(logsDir));
 	const readDevice = readDeviceRecords || (() => readNdjson(logsDir, "device.ndjson"));
 	const readClient = readClientRecords || (() => readNdjson(logsDir, "client.ndjson"));
@@ -909,6 +916,7 @@ async function verifyLaunch({ logsDir, since, metroPort = null, platform = null,
 	let nextCrashCheck = startedAt + 1e3;
 	while (true) {
 		const metroRecords = read().filter((record) => after(record, since));
+		const bundleRecords = metroRecords.filter((record) => !requireBundleResponse || String(record.event).startsWith("bundle_response_"));
 		const deviceRecords = readDevice().filter((record) => after(record, since));
 		const clientRecords = readClient().filter((record) => after(record, since));
 		if (now() >= nextCrashCheck) {
@@ -924,14 +932,14 @@ async function verifyLaunch({ logsDir, since, metroPort = null, platform = null,
 			if (crash) return crash;
 		}
 		if (deliveryId === null) {
-			const request = metroRecords.find((record) => record.event === "bundle_response_started" && typeof record.requestId === "string" && isBundleProof(record, since, platform));
+			const request = bundleRecords.find((record) => record.event === "bundle_response_started" && typeof record.requestId === "string" && isBundleProof(record, since, platform));
 			if (request) {
 				deliveryId = request.requestId;
 				proof = null;
 				stabilityDeadline = null;
 			}
 		}
-		for (const record of metroRecords) {
+		for (const record of bundleRecords) {
 			if (isBundleProof(record, since, platform)) activity = record;
 			const completed = deliveryId === null ? isBundleReadyProof(record, since, platform) : record.event === "bundle_response_finished" && record.requestId === deliveryId && isBundleProof(record, since, platform);
 			if (!proof && completed) {
@@ -960,7 +968,7 @@ async function verifyLaunch({ logsDir, since, metroPort = null, platform = null,
 			}
 		}
 		const ready = pendingAt !== null && signals.some((record) => Number(record.ts) >= pendingAt && Number(record.ts) <= readinessDeadline && appReadinessSignal(record, platform) === "ready");
-		const bundleErrors = metroRecords.filter((record) => isFatalLaunchError(record, platform) || deliveryId !== null && record.event === "bundle_response_failed" && record.requestId === deliveryId && isBundleProof(record, since, platform));
+		const bundleErrors = bundleRecords.filter((record) => isFatalLaunchError(record, platform) || deliveryId !== null && record.event === "bundle_response_failed" && record.requestId === deliveryId && isBundleProof(record, since, platform));
 		if (bundleErrors.length) {
 			const alive = processAlive ? processAlive() : null;
 			const fatalRecord = bundleErrors[bundleErrors.length - 1];

package/dist/{build-lock-vE45ZzJZ.mjs → build-lock-BsVoLDaq.mjs}

@@ -1,9 +1,9 @@
-import { t as getExecutor } from "./exec-bsN9MJXb.mjs";
-import { u as getConfigDir } from "./config-D7uu8Gbq.mjs";
-import { r as register } from "./cache-manifest-oeH18ERr.mjs";
-import { b as sharedBuildCache } from "./state-IYEY-zi8.mjs";
+import { t as getExecutor } from "./exec-CyylIdq9.mjs";
+import { u as getConfigDir } from "./config-CMtIaTk9.mjs";
+import { r as register } from "./cache-manifest-Cu4_Znw9.mjs";
+import { b as sharedBuildCache } from "./state-CZ-ER-8d.mjs";
 import { a as formatElapsed } from "./command-output-8wHMEde0.mjs";
-import { d as readClaimSet, f as releaseClaim, h as tryAcquireClaim, i as claimRemoveCommand, n as ClaimRefusedError } from "./ownership-claim-CeJLEpjD.mjs";
+import { d as readClaimSet, f as releaseClaim, h as tryAcquireClaim, i as claimRemoveCommand, n as ClaimRefusedError } from "./ownership-claim-7zRxxTfZ.mjs";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { createHash } from "node:crypto";
 import { join } from "node:path";
@@ -578,7 +578,7 @@ function listBuildLocks() {
 function waitingLine({ projectRoot, pid, elapsedMs, logFile }) {
 	const where = projectRoot || "another workspace";
 	const tail = logFile ? ` -- tail ${logFile}` : "";
-	return `${"build".padEnd(11)} waiting on ${where} (pid ${pid ?? "?"}, ${formatElapsed(elapsedMs)} elapsed)${tail}`;
+	return `${"build".padEnd(11)} waiting on ${where} (pid ${pid ?? "?"}, ${formatElapsed(elapsedMs)} elapsed)${tail} -- stim guide lifecycle concurrency`;
 }
 function takeoverLine({ projectRoot, pid, logFile, startedAt = null, now = Date.now }) {
 	const where = projectRoot || "another workspace";

package/dist/{build-slots-CgacA9zQ.mjs → build-slots-D0b6sJyo.mjs}

@@ -1,6 +1,6 @@
-import { u as getConfigDir } from "./config-D7uu8Gbq.mjs";
+import { u as getConfigDir } from "./config-CMtIaTk9.mjs";
 import { a as formatElapsed } from "./command-output-8wHMEde0.mjs";
-import { d as readClaimSet, f as releaseClaim, h as tryAcquireClaim, s as isClaimRefusal } from "./ownership-claim-CeJLEpjD.mjs";
+import { d as readClaimSet, f as releaseClaim, h as tryAcquireClaim, s as isClaimRefusal } from "./ownership-claim-7zRxxTfZ.mjs";
 import { readdirSync, statSync } from "node:fs";
 import { join } from "node:path";
 //#region src/engine/build-slots.ts
@@ -77,7 +77,7 @@ function tryAcquireBuildSlot({ max, root = null, logFile = null }) {
 	return null;
 }
 function slotWaitingLine({ max, elapsedMs }) {
-	return `${"build".padEnd(11)} waiting for a build slot (all ${max} in use, ${formatElapsed(elapsedMs)} elapsed)`;
+	return `${"build".padEnd(11)} waiting for a build slot (all ${max} in use, ${formatElapsed(elapsedMs)} elapsed) -- stim guide lifecycle concurrency`;
 }
 async function acquireBuildSlot({ max, root = null, logFile = null, now = Date.now, out = () => {}, sleep = sleepAsync, intervalMs = SLOT_POLL_MS, progressMs = SLOT_PROGRESS_MS, ceilingMs = SLOT_CEILING_MS }) {
 	if (!max || max <= 0) return {