stim 1.1.0 → 1.3.0

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

@@ -1,35 +1,37 @@
-import { t as getExecutor } from "./exec-bsN9MJXb.mjs";
-import { S as upsertProject, f as getProject, l as getConcurrencyLimits } from "./config-D7uu8Gbq.mjs";
-import { r as createNdjsonWriter } from "./ndjson-DcAtEx_K.mjs";
-import { D as workspaceLogsDir, T as workspaceDir, _ as writeWorkspaceState, g as writeWorkspaceLaunch, n as MODE_EXPO, p as readWorkspaceState, t as MODE_BARE } from "./state-IYEY-zi8.mjs";
-import { C as removeTemporaryEntry, S as makeTemporaryDirectory, g as repoRoot, s as gitCommonDir } from "./worktree-Dx3ZC5lS.mjs";
-import { a as findProjectRoot, c as projectShortcut, i as detectIsExpo, r as detectBundleId, t as appProjectProblem } from "./project-COj6nzzh.mjs";
-import { i as resolveProjectMetro, r as pidExists } from "./metro-B01H3EuD.mjs";
-import { n as verifyCollectorOwnership } from "./ownership-D8HmSv2E.mjs";
-import { a as easAuthNote, c as loadProjectProvider, d as resolveEasCliBin, f as resolveRemote, i as checkEasAuth, n as UPLOAD_TIMEOUT_MS, o as exitAfterFlush, p as uploadRemote, r as cacheLevel, s as isEasAuthFailureText, t as RESOLVE_TIMEOUT_MS, v as POOL_SETTING_REMEDY, x as parkedMaxSetting } from "./remote-cache-DOi5-zLj.mjs";
-import { D as remoteIosSetting, E as remoteDeviceSettingError, F as unknownSettingKeys, H as resolveOptimizations, L as detectProviders, M as settingShapeErrors, O as resolveCacheProviderConfig, P as tunnelModeSetting, V as optimizationBuildProfile, _ as iosSigningIdentitySha1SettingError, a as SETTING_SHAPE_REMEDY, d as cacheProviderSettingError, f as iosLanHostSetting, g as iosSigningIdentitySha1Setting, h as iosSigningIdentitySettingError, k as resolveSettings, m as iosSigningIdentitySetting, p as iosLanHostSettingError, r as REMOTE_DEVICE_BACKENDS, w as publicUrlSetting, z as artifactCachePolicy } from "./settings-BSwrY4FZ.mjs";
+import { t as getExecutor } from "./exec-CyylIdq9.mjs";
+import { I as deviceSlotKey, S as upsertProject, V as validateDeviceSlot, f as getProject, l as getConcurrencyLimits } from "./config-CcefMY2Q.mjs";
+import { r as createNdjsonWriter } from "./ndjson-BZwI1NBv.mjs";
+import { D as workspaceLogsDir, T as workspaceDir, _ as writeWorkspaceState, g as writeWorkspaceLaunch, n as MODE_EXPO, p as readWorkspaceState, t as MODE_BARE } from "./state-B3XA2wp2.mjs";
+import { C as removeTemporaryEntry, S as makeTemporaryDirectory, g as repoRoot, s as gitCommonDir } from "./worktree-Eq6TLH8N.mjs";
+import { a as findProjectRoot, c as projectShortcut, i as detectIsExpo, r as detectBundleId, t as appProjectProblem } from "./project-fKmuIaMI.mjs";
+import { i as resolveProjectMetro, r as pidExists } from "./metro-CORqXyTL.mjs";
+import { n as verifyCollectorOwnership } from "./ownership-8O073GIC.mjs";
 import { _ as launchErrorPreview, c as launchErrorReport, g as stepTimer, h as stepClock, i as formatDuration, l as phaseLine, m as shortUdid, n as appReadinessMessage, p as shortHash } from "./command-output-8wHMEde0.mjs";
-import { C as launchIosApp, E as unverifiedLaunchLines, O as verifyLaunch, T as readMetroRecords, b as isBundleProof, c as RELEASE_VERIFY_WAIT_MS, f as clearOtherUserApps, i as LAUNCH_BUNDLING, k as verifyReleaseLaunch, m as devClientUrl, n as DEFAULT_METRO_PORT, o as LAUNCH_FATAL, s as LAUNCH_UNVERIFIED, v as installIosApp, w as readCollectorRecords, y as iosAppProcess } from "./app-install-oZIQRbdD.mjs";
-import { d as listIosRuntimes } from "./ios-BZxKPuqP.mjs";
-import { C as untrackedNativeFiles, S as untrackedMissLine, _ as providerUploadOutcome, b as storeBuild, c as buildCacheKey, d as filesystemBuildCapability, f as fingerprintDiffRecord, g as providerDownloadPath, h as prepareProviderDownloadDir, i as releaseBuildLock, l as describeFingerprintMiss, m as fingerprintProject, n as acquireBuildLock, o as takeoverLine, p as fingerprintDiffSuffix, s as waitForBuild, t as WAIT_CEILING_MS, v as refingerprintAfterMutation, y as resolveBuild } from "./build-lock-vE45ZzJZ.mjs";
-import { r as claimFailure } from "./ownership-claim-CeJLEpjD.mjs";
-import { a as lostLine, c as releaseLeaseOnSignal, i as leaseExpiryText, l as runLease, n as DEBUG_VERIFY_STEP_MS, o as lostRefusal, r as acquireRunLease, s as parseDeviceWait, t as selectFromPool, u as waitFlagConflict } from "./device-pool-BlHXnYYs.mjs";
-import { r as releaseBuildSlot, t as acquireBuildSlot } from "./build-slots-CgacA9zQ.mjs";
-import { a as swapJsBundle, c as ensureWorkspaceStorageSafely, d as noMetroMessage, f as noMetroRemedy, l as gateShouldRetry, m as sleep, n as pickDevClientScheme, o as needsPrebuild, p as resolveMetroWithRetry, r as schemesFromInfoPlist, s as runPrebuild, t as devClientScheme, u as launchOutcomeRecord } from "./dev-client-Bvky1hya.mjs";
-import { a as statsProjectKey, i as recordRunStats, n as readRunEstimates, t as createRunRecorder } from "./stats-wqxPm7Tv.mjs";
-import { C as unknownIosDeviceTypeRefusal, _ as checkDeviceCapacity, b as ensureOwnedDevice, c as discoverXcodeProject, d as resolveScheme, i as buildIos, l as readBundleExecutable, m as describeDiagnostic, n as COMPILATION_CACHE_UNAVAILABLE, o as compilationCacheActivityLine, t as COMPILATION_CACHE_NOT_RUN, u as readBundleId, v as clearIosAdoptionPending, w as unknownIosRuntimeRefusal, y as ensureBooted } from "./xcode-CDB6fytw.mjs";
-import { a as ensureMetroReachable, b as ownedSessionName, c as remoteIosDeps, l as resolveRemoteContext, n as binOnPath, o as ensureRemoteBootOwned, r as bundleEntryPoint, w as gateMetroOrigin } from "./device-remote-CCgkG82J.mjs";
+import { r as claimFailure } from "./ownership-claim-Bf2CAfw3.mjs";
+import { $ as providerDownloadPath, G as buildCacheKey, J as filesystemBuildCapability, K as describeFingerprintMiss, Q as prepareProviderDownloadDir, R as WAIT_CEILING_MS, U as takeoverLine, V as releaseBuildLock, W as waitForBuild, X as fingerprintDiffSuffix, Y as fingerprintDiffRecord, Z as fingerprintProject, at as untrackedMissLine, et as providerUploadOutcome, nt as resolveBuild, ot as untrackedNativeFiles, rt as storeBuild, tt as refingerprintAfterMutation, z as acquireBuildLock } from "./android-BqVIJoG7.mjs";
+import { A as resolveSettings, B as artifactCachePolicy, D as remoteDeviceSettingError, F as tunnelModeSetting, H as optimizationBuildProfile, I as unknownSettingKeys, N as settingShapeErrors, O as remoteIosSetting, R as detectProviders, T as publicUrlSetting, U as resolveOptimizations, _ as iosSigningIdentitySha1SettingError, a as SETTING_SHAPE_REMEDY, d as cacheProviderSettingError, f as iosLanHostSetting, g as iosSigningIdentitySha1Setting, h as iosSigningIdentitySettingError, k as resolveCacheProviderConfig, m as iosSigningIdentitySetting, p as iosLanHostSettingError, r as REMOTE_DEVICE_BACKENDS, x as metroWarmupUrlSetting } from "./settings-DEJf6_kJ.mjs";
+import { C as uploadRemote, S as resolveRemote, _ as isEasAuthFailureText, a as POOL_SETTING_REMEDY, c as parkedMaxSetting, d as RESOLVE_TIMEOUT_MS, f as UPLOAD_TIMEOUT_MS, g as exitAfterFlush, h as easAuthNote, m as checkEasAuth, p as cacheLevel, v as loadProjectProvider, x as resolveEasCliBin } from "./teardown-ClFp1Aax.mjs";
+import { _ as easDeviceBuildRemedy, a as swapJsBundle, c as ensureWorkspaceStorageSafely, d as launchOutcomeRecord, f as noMetroMessage, g as warmMetro, h as sleep, l as gateShouldRetry, m as resolveMetroWithRetry, n as pickDevClientScheme, o as needsPrebuild, p as noMetroRemedy, r as schemesFromInfoPlist, s as runPrebuild, t as devClientScheme, u as isPhysicalDeviceRequest, v as isEasBuildFailure, y as resolveEasDevelopmentBuild } from "./dev-client-BjisHDB5.mjs";
+import { t as withWorkspaceProcessLock } from "./workspace-process-lock-3NcQnZ0X.mjs";
+import { C as launchIosApp, E as unverifiedLaunchLines, O as verifyLaunch, T as readMetroRecords, b as isBundleProof, c as RELEASE_VERIFY_WAIT_MS, f as clearOtherUserApps, i as LAUNCH_BUNDLING, k as verifyReleaseLaunch, m as devClientUrl, n as DEFAULT_METRO_PORT, o as LAUNCH_FATAL, s as LAUNCH_UNVERIFIED, v as installIosApp, w as readCollectorRecords, y as iosAppProcess } from "./app-install-DIp9riNx.mjs";
+import { f as listIosRuntimes } from "./ios-Deh5js5V.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-CPbLGfrB.mjs";
+import { r as releaseBuildSlot, t as acquireBuildSlot } from "./build-slots-C3-R4XQr.mjs";
+import { a as statsProjectKey, i as recordRunStats, n as readRunEstimates, t as createRunRecorder } from "./stats-BR-kwj0B.mjs";
+import { T as unknownIosRuntimeRefusal, b as ensureBooted, c as discoverXcodeProject, d as resolveScheme, i as buildIos, l as readBundleExecutable, m as describeDiagnostic, n as COMPILATION_CACHE_UNAVAILABLE, o as compilationCacheActivityLine, t as COMPILATION_CACHE_NOT_RUN, u as readBundleId, v as checkDeviceCapacity, w as unknownIosDeviceTypeRefusal, x as ensureOwnedDevice, y as clearIosAdoptionPending } from "./xcode-D7sAp-Zy.mjs";
+import { a as ensureMetroReachable, b as ownedSessionName, c as remoteIosDeps, l as resolveRemoteContext, n as binOnPath, o as ensureRemoteBootOwned, r as bundleEntryPoint, w as gateMetroOrigin } from "./device-remote-AkYCKS8U.mjs";
+import { n as nativeRunCommand, t as launchSlotScope } from "./slot-launch-cci0xvmC.mjs";
 import { t as spawnEntry } from "./spawn-entry-nCE6m770.mjs";
-import { a as printNativeCrashReport, n as IOS_CRASH_REPORT_RETRY, o as simulatorConsolePaths, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-B5IJwv3-.mjs";
-import { a as iosDeviceProcess, c as listIosDevices, d as verifyIosDeviceReleaseLaunch, i as installIosDeviceApp, l as localNetworkPending, n as LAUNCH_PROBE_TIMEOUT_MS, o as iosPoolCandidates, r as awaitIosDeviceLaunch, s as iosPoolNoCandidatesRefusal, t as DEVICECTL_INSTALL_TIMEOUT_MS, u as resolveIosPhysicalDevice } from "./ios-device-CdSm0GDw.mjs";
-import { a as runPodInstall, n as podsAreStale, r as readPodState } from "./deps-64wVnpZc.mjs";
+import { a as printNativeCrashReport, n as IOS_CRASH_REPORT_RETRY, o as simulatorConsolePaths, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-DHC31rXA.mjs";
+import { a as iosDeviceProcess, c as listIosDevices, d as verifyIosDeviceReleaseLaunch, i as installIosDeviceApp, l as localNetworkPending, n as LAUNCH_PROBE_TIMEOUT_MS, o as iosPoolCandidates, r as awaitIosDeviceLaunch, s as iosPoolNoCandidatesRefusal, t as DEVICECTL_INSTALL_TIMEOUT_MS, u as resolveIosPhysicalDevice } from "./ios-device-CWOM_S44.mjs";
+import { a as runPodInstall, n as podsAreStale, r as readPodState } from "./deps-Spz8ozgo.mjs";
 import { existsSync, mkdirSync, mkdtempSync, openSync, rmSync, writeFileSync } from "node:fs";
 import { InvalidArgumentError } from "commander";
 import { X509Certificate } from "node:crypto";
 import { basename, join } from "node:path";
 import { networkInterfaces, tmpdir } from "node:os";
-import chalk from "chalk";
 import { createWarnOnce, loadCacheProvider, resolveTieredBuild, storeTieredBuild } from "@stim-cli/cache";
+import chalk from "chalk";
 //#region src/engine/ios-profile.ts
 const TAG = /<(\/?)\s*([A-Za-z0-9_]+)(?:\s[^>]*?)?(\/?)>/g;
 const ENTITIES = {
@@ -633,7 +635,12 @@ function resolveDeviceType(flag, settings) {
 function resolveRuntime(flag, settings) {
 	return (typeof flag === "string" && flag.trim() !== "" ? flag.trim() : null) || iosStringSetting(settings, "runtime");
 }
-function deviceModelRefusal({ deviceTypeFlag, runtimeFlag, deviceType, runtime, physical, remoteBackend, listRuntimes }) {
+function deviceModelRefusal({ slot, deviceTypeFlag, runtimeFlag, deviceType, runtime, physical, remoteBackend, listRuntimes }) {
+	if (slot && slot !== "default" && remoteBackend) return {
+		code: "STIM_BAD_ARG",
+		message: "Named slots currently support local simulators and physical devices.",
+		remedy: "Use the default slot for a remote session."
+	};
 	if (typeof deviceTypeFlag === "string" && deviceTypeFlag.trim() === "") return {
 		code: "STIM_BAD_ARG",
 		message: "--device-type was given an empty name.",
@@ -699,22 +706,22 @@ function printDiagnostics(note, result) {
 }
 //#endregion
 //#region src/commands/ios/collector.ts
-function collectorLogFile(root) {
-	return join(workspaceLogsDir(root), `collector-ios.log`);
+function collectorLogFile(root, slot) {
+	return join(workspaceLogsDir(root), `collector-${deviceSlotKey("ios", slot)}.log`);
 }
 function collectorEntry() {
 	return spawnEntry("collector-run");
 }
 const COLLECTOR_EXIT_WAIT_MS = 2e3;
 const COLLECTOR_POLL_MS = 25;
-async function stopPreviousCollector({ root, kill = (pid, signal) => process.kill(pid, signal), alive = pidExists, readState = readWorkspaceState, verify = verifyCollectorOwnership, waitMs = COLLECTOR_EXIT_WAIT_MS, note = (_line) => {} }) {
-	const previous = (readState(root)?.collectors)?.["ios"] || null;
+async function stopPreviousCollector({ root, slot = "default", kill = (pid, signal) => process.kill(pid, signal), alive = pidExists, readState = readWorkspaceState, verify = verifyCollectorOwnership, waitMs = COLLECTOR_EXIT_WAIT_MS, note = (_line) => {} }) {
+	const previous = (readState(root)?.collectors)?.[deviceSlotKey("ios", slot)] || null;
 	const previousPid = Number(previous?.pid) || null;
 	let killed = null;
 	if (previousPid) {
 		const ownership = verify({
 			pid: previousPid,
-			platform: "ios",
+			platform: deviceSlotKey("ios", slot),
 			root,
 			isAlive: alive,
 			expected: previous
@@ -732,9 +739,10 @@ async function stopPreviousCollector({ root, kill = (pid, signal) => process.kil
 	}
 	return { killed };
 }
-async function replaceCollector({ root, udid, bundleId, appName, appExecutable, physical = false, payloadUrl = null, spawn = (cmd, args, opts) => getExecutor().spawn(cmd, args, opts), kill = (pid, signal) => process.kill(pid, signal), alive = pidExists, readState = readWorkspaceState, verify = verifyCollectorOwnership, waitMs = COLLECTOR_EXIT_WAIT_MS, note = (_line) => {} }) {
+async function replaceCollector({ root, slot = "default", udid, bundleId, appName, appExecutable, physical = false, payloadUrl = null, spawn = (cmd, args, opts) => getExecutor().spawn(cmd, args, opts), kill = (pid, signal) => process.kill(pid, signal), alive = pidExists, readState = readWorkspaceState, verify = verifyCollectorOwnership, waitMs = COLLECTOR_EXIT_WAIT_MS, note = (_line) => {} }) {
 	const { killed } = await stopPreviousCollector({
 		root,
+		slot,
 		kill,
 		alive,
 		readState,
@@ -753,6 +761,7 @@ async function replaceCollector({ root, udid, bundleId, appName, appExecutable,
 		"--bundle",
 		bundleId
 	];
+	if (slot !== "default") args.push("--slot", slot);
 	if (appName) args.push("--app-name", appName);
 	if (appExecutable) args.push("--app-executable", appExecutable);
 	if (physical) args.push("--physical");
@@ -760,7 +769,7 @@ async function replaceCollector({ root, udid, bundleId, appName, appExecutable,
 	let stdio = "ignore";
 	try {
 		mkdirSync(workspaceLogsDir(root), { recursive: true });
-		const fd = openSync(collectorLogFile(root), "a");
+		const fd = openSync(collectorLogFile(root, slot), "a");
 		stdio = [
 			"ignore",
 			fd,
@@ -791,6 +800,7 @@ async function replaceCollector({ root, udid, bundleId, appName, appExecutable,
 //#endregion
 //#region src/commands/ios/dependencies.ts
 const DEFAULT_DEPS = {
+	resolveEasDevelopmentBuild,
 	findProjectRoot,
 	resolveSettings,
 	gitCommonDir,
@@ -812,6 +822,7 @@ const DEFAULT_DEPS = {
 	detectProviders,
 	resolveProjectMetro,
 	resolveMetroWithRetry,
+	warmMetro,
 	readWorkspaceState,
 	pidExists,
 	getConcurrencyLimits,
@@ -889,9 +900,10 @@ function lastBuildRecord({ fingerprint = null, cacheKey = null, cacheHit = false
 	if (errorCode) record.errorCode = errorCode;
 	return record;
 }
-function iosFacts({ udid, deviceName, deviceType = null, runtime = null, fingerprint, configuration = null, scheme = null, cacheKey, cacheHit, cacheSkipped = false, compilationCache = COMPILATION_CACHE_NOT_RUN, waitedForBuild = null, appPath, bundleId, installSkipped = false, metroPort, logsDir, durationMs, launched = true, webPreviewUrl = null, lease }) {
+function iosFacts({ slot, udid, deviceName, deviceType = null, runtime = null, fingerprint, configuration = null, scheme = null, cacheKey, cacheHit, cacheSkipped = false, compilationCache = COMPILATION_CACHE_NOT_RUN, waitedForBuild = null, appPath, bundleId, installSkipped = false, metroPort, logsDir, durationMs, launched = true, webPreviewUrl = null, lease }) {
 	return {
 		platform: "ios",
+		...slot && slot !== "default" ? { slot } : {},
 		udid,
 		deviceName: deviceName ?? null,
 		deviceType: deviceType ?? null,
@@ -941,7 +953,7 @@ async function finishIosUpload(uploadPending, remote, phase, note) {
 	}
 	return false;
 }
-function reportIosResult({ d, root, json, release, configuration, buildScheme = null, metroCheck, metroPort, logsDir, device, udid, appPath, bundleId, installSkipped, elapsed, startedAt, storeHash, storeKey, cacheHit, compilationCache, useBuildCache, waitedForBuild, launchState, launchWarning, remote, providerName, closeWriter, webPreviewUrl, lease, recordRun }) {
+function reportIosResult({ slot, d, root, json, release, configuration, buildScheme = null, metroCheck, metroPort, logsDir, device, udid, appPath, bundleId, installSkipped, elapsed, startedAt, storeHash, storeKey, cacheHit, compilationCache, useBuildCache, waitedForBuild, launchState, launchWarning, remote, providerName, closeWriter, webPreviewUrl, lease, recordRun }) {
 	const durationMs = elapsed();
 	recordRun({
 		failed: false,
@@ -962,6 +974,7 @@ function reportIosResult({ d, root, json, release, configuration, buildScheme =
 	}), { write: d.writeWorkspaceState });
 	closeWriter();
 	const facts = iosFacts({
+		slot,
 		udid,
 		deviceName: device?.deviceName ?? null,
 		deviceType: device?.deviceType,
@@ -1014,9 +1027,14 @@ function cacheDescription(cacheHit, providerName = null) {
 function missingCrashReportHint({ physical, remote, crashed }) {
 	return crashed && !physical && !remote ? `No attributable native crash report captured yet. ${IOS_CRASH_REPORT_RETRY}` : "No attributable native crash report captured. Read `stim logs --source device` for available output.";
 }
-async function verifyIosRun({ root, appPath, d, release, launched, configuration, phase, note, metroCheck, logsDir, launchedAt, metroPort, isExpo, bundleId, udid, scheme, physical, appName, lanAddress, lanOrigin, remoteDevice, metroOrigin }) {
+async function verifyIosRun({ root, slot, appPath, d, release, launched, configuration, phase, note, metroCheck, logsDir, launchedAt, metroPort, isExpo, bundleId, udid, scheme, physical, appName, lanAddress, lanOrigin, remoteDevice, metroOrigin }) {
+	const runCommand = nativeRunCommand("ios", slot, {
+		physical,
+		deviceId: udid
+	});
 	const readNativeCrashes = () => remoteDevice ? [] : captureNativeCrashes({
 		root,
+		slot,
 		platform: "ios",
 		deviceId: udid,
 		appId: bundleId,
@@ -1052,6 +1070,8 @@ async function verifyIosRun({ root, appPath, d, release, launched, configuration
 		return { state: crashes.length || processCheck?.reason === "exited" ? LAUNCH_FATAL : LAUNCH_UNVERIFIED };
 	}
 	const verification = metroCheck ? await d.verifyLaunch({
+		requireBundleResponse: true,
+		slot: launchSlotScope(root, slot),
 		onReadinessPending: () => phase("readiness", "waiting for app readiness (up to 30s after bundle load)"),
 		logsDir,
 		since: launchedAt,
@@ -1088,10 +1108,10 @@ async function verifyIosRun({ root, appPath, d, release, launched, configuration
 			remote: Boolean(remoteDevice),
 			crashed: true
 		})));
-		if (nativeFatal || verification.processAlive === false) note(chalk.yellow(phaseLine("remedy", "Fix the crash, then run `stim ios` again. A Metro reload cannot restart an exited app.")));
+		if (nativeFatal || verification.processAlive === false) note(chalk.yellow(phaseLine("remedy", `Fix the crash, then run \`${runCommand}\` again. A Metro reload cannot restart an exited app.`)));
 		else if (verification.processAlive === true && metroPort !== null) {
 			const reloadRemedy = `press Reload on the app's own error screen -- run \`agent-device snapshot -i --platform ios --udid ${udid}\` in your existing automation session to reach it. Neither \`stim reload ios\` nor \`agent-device metro reload\` can: this app never connected to Metro.`;
-			note(chalk.yellow(phaseLine("remedy", `The native app is still running. ${deliveryFailed ? "Check the Metro logs and device connection, then" : "Fix the JavaScript or TypeScript error, then"} ${reloadRemedy} Do not run \`stim ios\` unless native inputs changed or the app process exits.`)));
+			note(chalk.yellow(phaseLine("remedy", `The native app is still running. ${deliveryFailed ? "Check the Metro logs and device connection, then" : "Fix the JavaScript or TypeScript error, then"} ${reloadRemedy} Do not run \`${runCommand}\` unless native inputs changed or the app process exits.`)));
 		}
 		return { state: LAUNCH_FATAL };
 	}
@@ -1100,7 +1120,7 @@ async function verifyIosRun({ root, appPath, d, release, launched, configuration
 		const hasAppErrors = reportLaunchErrors(verification.errors ?? [], note, root);
 		if (hasAppErrors && verification.processAlive === true && metroPort !== null) {
 			const reloadRemedy = physical || remoteDevice ? `run \`agent-device metro reload --metro-port ${metroPort}\`.` : "run `stim reload ios`.";
-			note(chalk.yellow(phaseLine("remedy", `The native app is still running. Fix the JavaScript or TypeScript error; Fast Refresh should apply the edit. If the error screen remains, ${reloadRemedy} Do not run \`stim ios\` unless native inputs changed or the app process exits.`)));
+			note(chalk.yellow(phaseLine("remedy", `The native app is still running. Fix the JavaScript or TypeScript error; Fast Refresh should apply the edit. If the error screen remains, ${reloadRemedy} Do not run \`${runCommand}\` unless native inputs changed or the app process exits.`)));
 		}
 		return {
 			state: true,
@@ -1144,14 +1164,14 @@ function reportLaunchErrors(errors, note, root) {
 	for (const line of report.lines) note(chalk.yellow(phaseLine("launch", line)));
 	return report.lines.length > 0;
 }
-function cleanAdoptedIosApps({ d, root, udid, bundleId, phase, note }) {
+function cleanAdoptedIosApps({ d, root, slot, udid, bundleId, phase, note }) {
 	const swept = d.clearOtherUserApps({
 		udid,
 		keep: bundleId
 	});
 	if (swept.removed.length) phase("install", `removed ${swept.removed.join(", ")}, left by the previous workspace`);
 	if (swept.listed && swept.failed.length === 0) {
-		d.clearIosAdoptionPending(root);
+		d.clearIosAdoptionPending(root, slot);
 		return null;
 	}
 	if (!swept.listed) return "Could not list apps left by the previous workspace.";
@@ -1190,7 +1210,14 @@ function recordIosReloadTarget({ d, root, physical, remoteDevice, bundleId, udid
 		note(chalk.yellow(phaseLine("state", `could not record iOS launch: ${error?.message || error}`)));
 	}
 }
-async function finishIosRun({ d, root, json, release, configuration, buildScheme, isExpo, metroCheck, metroPort, logsDir, logFile, device, udid, physical, lanAddress, lanOriginUrl, remoteDevice, bootPromise, bootDuration, appPath, bundleId: initialBundleId, swapDir, buildFailure, fail, phase, note, logWriter, uploadPending, providerUpload, providerName, remote, abandonedRemote: remoteWasAbandoned, elapsed, startedAt, storeHash, storeKey, cacheHit, compilationCache, useBuildCache, waitedForBuild, closeWriter, lease, releaseLease, recordRun }) {
+function simulatorLaunchFailureRemedy(remote, udid, bundleId, logFile) {
+	return `${remote ? "Run" : "If the simulator timed out, run `stim doctor --platform ios` and resolve any reported host memory pressure before retrying. Otherwise run"} \`xcrun simctl launch --console ${udid} ${bundleId}\` to see what the app reports, and check ${logFile}.`;
+}
+async function finishIosRun({ d, root, slot, json, release, configuration, buildScheme, isExpo, metroCheck, metroPort, logsDir, logFile, device, udid, physical, lanAddress, lanOriginUrl, remoteDevice, bootPromise, bootDuration, appPath, bundleId: initialBundleId, swapDir, buildFailure, fail, phase, note, logWriter, uploadPending, providerUpload, providerName, remote, abandonedRemote: remoteWasAbandoned, elapsed, startedAt, storeHash, storeKey, cacheHit, compilationCache, useBuildCache, waitedForBuild, closeWriter, lease, releaseLease, recordRun }) {
+	const runCommand = nativeRunCommand("ios", slot, {
+		physical,
+		deviceId: udid
+	});
 	let bundleId = initialBundleId;
 	let leaseWarned = false;
 	const raiseLeaseFor = (boundMs, beforeInstall) => {
@@ -1226,7 +1253,7 @@ async function finishIosRun({ d, root, json, release, configuration, buildScheme
 	if (!booted?.ok) return fail({
 		code: booted?.code || "STIM_NO_DEVICE",
 		message: booted?.reason || "The owned simulator could not be booted.",
-		remedy: booted?.remedy || "Run `stim ios` again to re-establish an owned simulator for this workspace."
+		remedy: booted?.remedy || `Run \`${runCommand}\` again to re-establish an owned simulator for this workspace.`
 	});
 	const deviceOutcome = physical ? "connected" : `${device?.adopted ? "adopted" : "booted"} ${bootDuration()}`;
 	phase("device", `${deviceLabel(device, udid)} ${deviceOutcome}`);
@@ -1293,6 +1320,7 @@ async function finishIosRun({ d, root, json, release, configuration, buildScheme
 		});
 		const collector = await d.replaceCollector({
 			root,
+			slot,
 			udid,
 			bundleId,
 			appName,
@@ -1315,7 +1343,7 @@ async function finishIosRun({ d, root, json, release, configuration, buildScheme
 			bundleId,
 			appName: appName ?? bundleId,
 			collectorPid: collector.pid,
-			readRecords: () => readCollectorRecords(logsDir).filter((entry) => Number(entry.ts) >= launchedAt)
+			readRecords: () => readCollectorRecords(logsDir).filter((entry) => Number(entry.ts) >= launchedAt && (entry.slot ?? "default") === (slot ?? "default"))
 		});
 		if (started.failed || !started.pid) return fail({
 			code: "STIM_LAUNCH_FAILED",
@@ -1351,7 +1379,7 @@ async function finishIosRun({ d, root, json, release, configuration, buildScheme
 			if (cleanupFailure) return fail({
 				code: "STIM_INSTALL_FAILED",
 				message: `${cleanupFailure} Stim kept the adoption cleanup pending and did not install or launch the app.`,
-				remedy: "Run `stim ios` again after simulator tooling is responsive.",
+				remedy: `Run \`${runCommand}\` again after simulator tooling is responsive.`,
 				build: {
 					...buildFailure,
 					appPath,
@@ -1384,6 +1412,7 @@ async function finishIosRun({ d, root, json, release, configuration, buildScheme
 		dropSwapDir();
 		if (!remoteDevice) await d.replaceCollector({
 			root,
+			slot,
 			udid,
 			bundleId,
 			appName,
@@ -1419,6 +1448,7 @@ async function finishIosRun({ d, root, json, release, configuration, buildScheme
 		if (launched?.failed) {
 			printNativeCrashReport({
 				root,
+				slot,
 				platform: "ios",
 				deviceId: udid,
 				appId: bundleId,
@@ -1428,7 +1458,7 @@ async function finishIosRun({ d, root, json, release, configuration, buildScheme
 			return fail({
 				code: launched.code || "STIM_LAUNCH_FAILED",
 				message: launched.reason,
-				remedy: `Run \`xcrun simctl launch --console ${udid} ${bundleId}\` to see what the app reports, and check ${logFile}.`,
+				remedy: simulatorLaunchFailureRemedy(Boolean(remoteDevice), udid, bundleId, logFile),
 				build: {
 					...buildFailure,
 					appPath,
@@ -1441,6 +1471,7 @@ async function finishIosRun({ d, root, json, release, configuration, buildScheme
 	recordIosReloadTarget({
 		d,
 		root,
+		slot,
 		physical,
 		remoteDevice: Boolean(remoteDevice),
 		bundleId,
@@ -1458,6 +1489,7 @@ async function finishIosRun({ d, root, json, release, configuration, buildScheme
 	});
 	if (remoteDevice) await d.replaceCollector({
 		root,
+		slot,
 		udid,
 		bundleId,
 		appName,
@@ -1467,6 +1499,7 @@ async function finishIosRun({ d, root, json, release, configuration, buildScheme
 	if (physical) raiseLeaseFor(release ? RELEASE_VERIFY_WAIT_MS : DEBUG_VERIFY_STEP_MS, false);
 	const { state: launchState, warning: launchWarning } = await verifyIosRun({
 		root,
+		slot,
 		appPath,
 		d,
 		release,
@@ -1518,6 +1551,7 @@ async function finishIosRun({ d, root, json, release, configuration, buildScheme
 	const facts = reportIosResult({
 		d,
 		root,
+		slot,
 		json,
 		release,
 		configuration,
@@ -1565,14 +1599,20 @@ function iosCommand(program) {
 	registerIos(program);
 }
 function registerIos(program, deps = {}) {
-	program.command("ios").description("Build (or restore from the fingerprint cache), install and launch this workspace's app on its owned simulator, wired to the reserved Metro port. Requires a running dev server (`stim start`).").option("--json", "Emit the facts as a single JSON line on stdout; every other line goes to stderr").option("--scheme <name>", "Shared Xcode app scheme to build; overrides automatic scheme selection, not the app URL scheme").option("--no-metro-check", "Skip the \"is this workspace's dev server running?\" gate and build anyway").option("--no-build-cache", "Build fresh, ignoring cached artifacts (local and the project's build-cache provider); the fresh build still replaces the cache entry").option("--configuration <name>", "Xcode configuration to build (e.g. Release). A non-Debug configuration embeds the JS bundle and skips Metro entirely. Overrides the ios.configuration setting. Default: Debug").option("--device-type <name>", "Simulator model to create this workspace's owned sim as, exactly as `xcrun simctl list devicetypes` names it (e.g. \"iPad Pro 13-inch (M4)\"). Overrides the ios.deviceType setting for this invocation. A model no installed runtime can create refuses with STIM_BAD_ARG and prints the models they do offer.").option("--runtime <version>", "Simulator runtime to create this workspace's owned sim on, as a version (\"18.5\") or a runtime's full name (\"iOS 18.5\"); nothing else matches. Overrides the ios.runtime setting for this invocation. An unknown version refuses with STIM_BAD_ARG and prints the installed runtimes.").option("--device [udid]", "Build the iphoneos slice for a connected iPhone, install it, and launch it, instead of using this workspace's owned simulator. With no UDID, the first connected device this workspace can lease is used. In Debug the app is wired to this workspace's Metro over the LAN. Stim never creates, boots, or deletes a physical device.").option("--remote <backend>", "Install and launch on a remote device with proxy or EAS. The build still happens here.", (value) => {
+	program.command("ios").description("Build (or restore from the fingerprint cache), install and launch this workspace's app on its owned simulator, wired to the reserved Metro port. Requires a running dev server (`stim start`).").option("--eas-profile <name>", "Download a matching EAS development build; on a miss, print the build command without running it").option("--slot <name>", "Reusable device slot within this workspace (default: default)", validateDeviceSlot).option("--json", "Emit the facts as a single JSON line on stdout; every other line goes to stderr").option("--scheme <name>", "Shared Xcode app scheme to build; overrides automatic scheme selection, not the app URL scheme").option("--no-metro-check", "Skip the \"is this workspace's dev server running?\" gate and build anyway").option("--no-build-cache", "Build fresh, ignoring cached artifacts (local and the project's build-cache provider); the fresh build still replaces the cache entry").option("--configuration <name>", "Xcode configuration to build (e.g. Release). A non-Debug configuration embeds the JS bundle and skips Metro entirely. Overrides the ios.configuration setting. Default: Debug").option("--device-type <name>", "Simulator model to create this workspace's owned sim as, exactly as `xcrun simctl list devicetypes` names it (e.g. \"iPad Pro 13-inch (M4)\"). Overrides the ios.deviceType setting for this invocation. A model no installed runtime can create refuses with STIM_BAD_ARG and prints the models they do offer.").option("--runtime <version>", "Simulator runtime to create this workspace's owned sim on, as a version (\"18.5\") or a runtime's full name (\"iOS 18.5\"); nothing else matches. Overrides the ios.runtime setting for this invocation. An unknown version refuses with STIM_BAD_ARG and prints the installed runtimes.").option("--device [udid]", "Build the iphoneos slice for a connected iPhone, install it, and launch it, instead of using this workspace's owned simulator. With no UDID, the first connected device this workspace can lease is used. In Debug the app is wired to this workspace's Metro over the LAN. Stim never creates, boots, or deletes a physical device.").option("--remote <backend>", "Install and launch on a remote device with proxy or EAS. Builds are local unless --eas-profile selects an existing EAS build.", (value) => {
 		if (REMOTE_DEVICE_BACKENDS.includes(value)) return value;
 		throw new InvalidArgumentError(`expected one of: ${REMOTE_DEVICE_BACKENDS.join(", ")}`);
 	}).option("--wait <seconds>", "How long to wait for another workspace to release the phone it leases, before refusing with STIM_DEVICE_BUSY (default 60, 0 refuses at once). Only with --device.").option("--no-wait", "Install on a phone another workspace leases instead of waiting: this run takes no lease and, when both workspaces build the same app id, the install terminates the holder's running app. Only with --device.").action(async (opts) => {
-		await runIos({
+		const root = (deps.findProjectRoot ?? DEFAULT_DEPS.findProjectRoot)(process.cwd());
+		const run = () => runIos({
 			...opts,
 			waitConflict: waitFlagConflict(process.argv)
 		}, deps);
+		if (!root) await run();
+		else await withWorkspaceProcessLock(workspaceDir(root), "native-run", run, {
+			external: true,
+			waitMs: 18e5
+		});
 	});
 }
 function explicitSchemeRefusal(root, scheme, isExpo, d) {
@@ -1587,11 +1627,58 @@ function explicitSchemeRefusal(root, scheme, isExpo, d) {
 	if (project.error) return project.error;
 	return d.resolveScheme(project, { scheme }).error ?? null;
 }
+function iosSlotLogFile(root, slot) {
+	return slot === "default" ? buildLogFile(root) : join(workspaceLogsDir(root), `build-${deviceSlotKey("ios", slot)}.ndjson`);
+}
+function iosSlotDeps(d, slot) {
+	if (slot !== "default") {
+		const base = d;
+		d = {
+			...base,
+			ensureOwnedDevice: (args) => base.ensureOwnedDevice({
+				...args,
+				slot
+			}),
+			checkDeviceCapacity: (args) => base.checkDeviceCapacity({
+				...args,
+				slot
+			}),
+			selectFromPool: (args) => base.selectFromPool({
+				...args,
+				slot
+			}),
+			acquireRunLease: (args) => base.acquireRunLease({
+				...args,
+				slot
+			}),
+			runLease: (args) => base.runLease({
+				...args,
+				slot
+			}),
+			replaceCollector: (args) => base.replaceCollector({
+				...args,
+				slot
+			}),
+			stopPreviousCollector: (args) => base.stopPreviousCollector({
+				...args,
+				slot
+			}),
+			clearIosAdoptionPending: (root) => base.clearIosAdoptionPending(root, slot),
+			writeWorkspaceLaunch: (root, platform, record) => base.writeWorkspaceLaunch(root, platform, record, slot),
+			createWriter: (file, options) => base.createWriter(file, {
+				...options,
+				fields: { slot }
+			})
+		};
+	}
+	return d;
+}
 async function runIos(opts = {}, overrides = {}) {
-	let d = {
+	const slot = validateDeviceSlot(opts.slot);
+	let d = iosSlotDeps({
 		...DEFAULT_DEPS,
 		...overrides
-	};
+	}, slot);
 	const json = Boolean(opts.json);
 	const metroCheck = opts.metroCheck !== false;
 	let useBuildCache = opts.buildCache !== false;
@@ -1637,7 +1724,7 @@ async function runIos(opts = {}, overrides = {}) {
 		return null;
 	}
 	const logsDir = workspaceLogsDir(root);
-	const logFile = buildLogFile(root);
+	const logFile = iosSlotLogFile(root, slot);
 	let writer = null;
 	const logWriter = () => writer ||= d.createWriter(logFile, { truncate: true });
 	let buildLock = null;
@@ -1776,7 +1863,7 @@ async function runIos(opts = {}, overrides = {}) {
 		message: settingError,
 		remedy: SETTING_SHAPE_REMEDY
 	});
-	const configuration = resolveConfiguration(opts.configuration, settings);
+	const configuration = opts.easProfile !== void 0 ? null : resolveConfiguration(opts.configuration, settings);
 	const buildScheme = opts.scheme;
 	const release = isReleaseConfiguration(configuration);
 	const cachePolicy = artifactCachePolicy(optimizations, useBuildCache, release);
@@ -1784,7 +1871,7 @@ async function runIos(opts = {}, overrides = {}) {
 	const deviceType = resolveDeviceType(opts.deviceType, settings);
 	const runtime = resolveRuntime(opts.runtime, settings);
 	const deviceFlag = opts.device;
-	const physical = deviceFlag !== null && deviceFlag !== void 0 && deviceFlag !== false;
+	const physical = isPhysicalDeviceRequest(deviceFlag);
 	if (physical && deviceFlag === "") return fail({
 		code: "STIM_BAD_ARG",
 		message: "--device was given an empty UDID.",
@@ -1819,6 +1906,7 @@ async function runIos(opts = {}, overrides = {}) {
 	if (schemeRefusal) return fail(schemeRefusal);
 	const remoteBackend = physical ? null : opts.remote ?? remoteIosSetting(settings);
 	const modelRefusal = deviceModelRefusal({
+		slot,
 		deviceTypeFlag: opts.deviceType,
 		runtimeFlag: opts.runtime,
 		deviceType,
@@ -1828,6 +1916,17 @@ async function runIos(opts = {}, overrides = {}) {
 		listRuntimes: d.listIosRuntimes
 	});
 	if (modelRefusal) return fail(modelRefusal);
+	const easBuild = await d.resolveEasDevelopmentBuild({
+		root,
+		platform: "ios",
+		profile: opts.easProfile,
+		note,
+		isExpo,
+		physical,
+		selectors: [opts.scheme, opts.configuration],
+		buildCache: opts.buildCache
+	});
+	if (isEasBuildFailure(easBuild)) return fail(easBuild);
 	const registerProject = () => d.upsertProject(root, {
 		bundleId: d.detectBundleId(root) ?? void 0,
 		isExpo
@@ -2032,6 +2131,13 @@ async function runIos(opts = {}, overrides = {}) {
 				return false;
 			}
 		}
+		if (!release && metroCheck && optimizations.metroWarmup) d.warmMetro({
+			port: metroPort,
+			platform: "ios",
+			isExpo,
+			appId: proj?.bundleId,
+			bundleUrl: metroWarmupUrlSetting(settings, "ios")
+		});
 		return true;
 	}
 	async function resolveLanOrigin() {
@@ -2100,6 +2206,38 @@ async function runIos(opts = {}, overrides = {}) {
 			return result;
 		});
 		udid = device.deviceUdid ?? (await bootPromise)?.udid ?? "";
+		if (easBuild?.ok) {
+			fingerprint = storeHash = easBuild.fingerprint;
+			cacheKey = storeKey = easBuild.cacheKey;
+			appPath = easBuild.path;
+			cacheHit = easBuild.cacheHit;
+			providerName = "eas";
+			stats.setCacheKey(cacheKey);
+			if (physical) {
+				const gate = d.gateProfileForDevice({
+					appPath,
+					udid,
+					configuration
+				});
+				if (!gate.ok) {
+					fail({
+						code: gate.code,
+						message: gate.reason,
+						remedy: easDeviceBuildRemedy(opts.easProfile)
+					});
+					return false;
+				}
+				if (!d.devClientScheme(root, appPath)) {
+					fail({
+						code: "STIM_BAD_ARG",
+						message: "The EAS device app has no development-client URL scheme.",
+						remedy: "Install expo-dev-client with npx expo install expo-dev-client, then rebuild the EAS profile and retry."
+					});
+					return false;
+				}
+			}
+			return true;
+		}
 		const fingerprintTimer = stepTimer(d.now);
 		let computedFingerprint;
 		try {
@@ -2267,7 +2405,7 @@ async function runIos(opts = {}, overrides = {}) {
 				releasedWait = null;
 				const held = attempt.held;
 				const who = held.projectRoot || "another workspace";
-				phase("build", `${who} is already building ${shortHash(fingerprint)} (pid ${held.pid})${held.logFile ? ` -- tail ${held.logFile}` : ""}`);
+				phase("build", `${who} is already building ${shortHash(fingerprint)} (pid ${held.pid})${held.logFile ? ` -- tail ${held.logFile}` : ""} -- stim guide lifecycle concurrency`);
 				let waited = null;
 				try {
 					const ceilingMs = WAIT_CEILING_MS - (d.now() - waitStarted);
@@ -2319,7 +2457,7 @@ async function runIos(opts = {}, overrides = {}) {
 						pid: held.pid,
 						ms: waited.waitedMs
 					};
-					phase("build", `waited ${formatDuration(waited.waitedMs)} for ${who}'s build -> installed from cache`);
+					phase("build", `waited ${formatDuration(waited.waitedMs)} for ${who}'s build -> installed from cache -- stim guide lifecycle concurrency`);
 				} else if (waited?.lockReleased) {
 					failedHolder = void 0;
 					releasedWait = {
@@ -2540,7 +2678,7 @@ async function runIos(opts = {}, overrides = {}) {
 							phase("cache", `hit ${shortHash(storeHash)} (post-${mutatingSteps.join("/")} key)`);
 							if (releasedWait) {
 								waitedForBuild = releasedWait.facts;
-								phase("build", `waited ${formatDuration(waitedForBuild.ms)} for ${releasedWait.who}'s build -> installed from cache`);
+								phase("build", `waited ${formatDuration(waitedForBuild.ms)} for ${releasedWait.who}'s build -> installed from cache -- stim guide lifecycle concurrency`);
 							}
 						}
 					}
@@ -2623,10 +2761,12 @@ async function runIos(opts = {}, overrides = {}) {
 	}
 	try {
 		if (!await resolveInitialFingerprint()) return null;
-		await resolveRemoteArtifact();
-		if (!await waitForSharedBuild()) return null;
-		await prepareCachedArtifact();
-		if (!await buildArtifact()) return null;
+		if (!easBuild) {
+			await resolveRemoteArtifact();
+			if (!await waitForSharedBuild()) return null;
+			await prepareCachedArtifact();
+			if (!await buildArtifact()) return null;
+		}
 		if (physicalDevice) {
 			const acquired = await d.acquireRunLease({
 				root,
@@ -2661,6 +2801,7 @@ async function runIos(opts = {}, overrides = {}) {
 		}
 		try {
 			return await finishIosRun({
+				slot,
 				d,
 				root,
 				json,