stim 1.8.0 → 1.10.0

package/dist/{ios-BP04pY5f.mjs → ios-Dd-hYJBh.mjs}

@@ -1,38 +1,40 @@
-import { t as getExecutor } from "./exec-B29XNuhP.mjs";
-import { B as validateDeviceSlot, E as ownership_claim_exports, F as deviceSlotKey, P as deviceSlotFileKey, S as upsertProject, f as getProject, l as getConcurrencyLimits } from "./config-B7iyKWkL.mjs";
-import { r as createNdjsonWriter } from "./ndjson-BZwI1NBv.mjs";
-import { _ as workspaceLogsDir, h as workspaceDir, o as writeWorkspaceState, r as readWorkspaceState } from "./workspace-state-BT5E3SA2.mjs";
-import { T as removeTemporaryEntry, g as repoRoot, s as gitCommonDir, w as makeTemporaryDirectory } from "./worktree-FG_ZKKdb.mjs";
-import { a as findProjectRoot, c as projectShortcut, i as detectIsExpo, r as detectBundleId, t as appProjectProblem } from "./project-DDZWf_16.mjs";
-import { n as MODE_EXPO, p as writeWorkspaceLaunch, t as MODE_BARE } from "./state-DZobzxLW.mjs";
-import { a as resolveProjectMetro, i as pidExists, o as signalProcessTree } from "./metro-C7bcJ0uo.mjs";
-import { n as verifyCollectorOwnership } from "./ownership-Cp52QAK1.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-BXXorVM2.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-B3ycpsYv.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-CgtsB6TV.mjs";
-import { C as resolveRemote, S as resolveEasCliBin, _ as exitAfterFlush, a as POOL_SETTING_REMEDY, f as RESOLVE_TIMEOUT_MS, g as easAuthNote, h as checkEasAuth, l as parkedMaxSetting, m as cacheLevel, p as UPLOAD_TIMEOUT_MS, v as isEasAuthFailureText, w as uploadRemote, y as loadProjectProvider } from "./teardown-BJqEzPo_.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-BmT-ioFI.mjs";
-import { t as withWorkspaceProcessLock } from "./workspace-process-lock-BYfZz_S-.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-BDbsSgCl.mjs";
-import { E as parseIosSimulatorApp, f as listIosRuntimes } from "./ios-BcCiI4TS.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-BxRwdufO.mjs";
-import { r as releaseBuildSlot, t as acquireBuildSlot } from "./build-slots-C-oAHRT1.mjs";
-import { a as statsProjectKey, i as recordRunStats, n as readRunEstimates, t as createRunRecorder } from "./stats-BYcZ6n1h.mjs";
-import { c as unknownIosRuntimeRefusal, i as ensureOwnedDevice, n as clearIosAdoptionPending, r as ensureBooted, s as unknownIosDeviceTypeRefusal, t as checkDeviceCapacity } from "./device-BUoZyMoR.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-ByN8P6CB.mjs";
-import { a as compilationCacheActivityLine, c as readBundleExecutable, l as readBundleId, p as describeDiagnostic, r as buildIos, s as discoverXcodeProject, t as COMPILATION_CACHE_NOT_RUN, u as resolveScheme } from "./xcode-B6YaWeg0.mjs";
-import { n as nativeRunCommand, t as launchSlotScope } from "./slot-launch-ZUUe0TQP.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-D1Kaf-eT.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-CauFJiYx.mjs";
-import { a as runPodInstall, n as podsAreStale, r as readPodState } from "./deps-oCXVNEqQ.mjs";
+import { L as deviceSlotFileKey, R as deviceSlotKey, V as parseDeviceSlotOption, W as validateDeviceSlot, f as getProject, k as ownership_claim_exports, l as getConcurrencyLimits, w as upsertProject } from "./config-BEq0Qw_a.mjs";
+import { t as getExecutor } from "./exec-DK8KaVHK.mjs";
+import { r as createNdjsonWriter } from "./ndjson-CDY9IkVC.mjs";
+import { O as workspaceDir, c as signalProcessTree, h as recordWorkspaceUse, i as pidExists, j as workspaceLogsDir, m as readWorkspaceState, s as resolveProjectMetro, y as writeWorkspaceState } from "./metro-BWLOJ_Wr.mjs";
+import { D as makeTemporaryDirectory, O as removeTemporaryEntry, s as gitCommonDir, y as repoRoot } from "./worktree-BlizKDpZ.mjs";
+import { a as detectIsExpo, i as detectBundleId, n as appProjectProblem, o as findProjectRoot, t as NO_PROJECT_REFUSAL } from "./project-BXZzOABt.mjs";
+import { n as MODE_EXPO, p as writeWorkspaceLaunch, t as MODE_BARE } from "./state-WGdIbi_d.mjs";
+import { t as withWorkspaceProcessLock } from "./workspace-process-lock-BXA96myD.mjs";
+import { _ as stepTimer, c as launchErrorReport, g as stepClock, h as shortUdid, i as formatDuration, l as phaseLine, m as shortHash, n as appReadinessMessage, v as launchErrorPreview } from "./command-output-D5z2_bcF.mjs";
+import { A as resolveBuild, C as fingerprintDiffRecord, D as providerDownloadPath, E as prepareProviderDownloadDir, N as untrackedMissLine, O as providerUploadOutcome, P as untrackedNativeFiles, S as filesystemBuildCapability, T as fingerprintProject, _ as waitForBuild, b as describeFingerprintMiss, g as releaseBuildLock, j as storeBuild, k as refingerprintAfterMutation, m as acquireBuildLock, v as waitForSharedBuild, w as fingerprintDiffSuffix, y as buildCacheKey } from "./device-lease-CbEaIk7b.mjs";
+import { n as NO_BUILD_PROGRESS, s as startBuildProgress } from "./build-progress-BXx-ZBe4.mjs";
+import { A as resolveCacheProviderConfig, E as publicUrlSetting, I as tunnelModeSetting, L as unknownSettingKeys, P as settingShapeErrors, S as metroWarmupUrlSetting, U as optimizationBuildProfile, V as artifactCachePolicy, W as resolveOptimizations, _ as iosSigningIdentitySha1SettingError, a as SETTING_SHAPE_REMEDY, d as cacheProviderSettingError, f as iosLanHostSetting, g as iosSigningIdentitySha1Setting, h as iosSigningIdentitySettingError, j as resolveSettings, k as remoteIosSetting, m as iosSigningIdentitySetting, p as iosLanHostSettingError, r as REMOTE_DEVICE_BACKENDS, z as detectProviders } from "./settings-DOugPlPz.mjs";
+import { h as POOL_SETTING_REMEDY, y as parkedMaxSetting } from "./ownership-DZjdx8Gq.mjs";
+import { D as parseIosSimulatorApp, f as listIosRuntimes } from "./ios-B2Fpqvlb.mjs";
+import { a as acquireBuildSlot, s as releaseBuildSlot } from "./in-use-CjUluqIX.mjs";
+import { n as verifyCollectorOwnership } from "./ownership-D2xbLVoz.mjs";
+import { A as UPLOAD_TIMEOUT_MS, B as resolveRemote, F as isEasAuthFailureText, I as loadProjectProvider, M as checkEasAuth, N as easAuthNote, O as gateMetroOrigin, P as exitAfterFlush, V as uploadRemote, a as ensureMetroReachable, j as cacheLevel, k as RESOLVE_TIMEOUT_MS, l as remoteIosDeps, n as binOnPath, o as ensureRemoteBootOwned, r as bundleEntryPoint, u as resolveRemoteContext, w as ownedSessionName, z as resolveEasCliBin } from "./device-remote-Dy1jGj3U.mjs";
+import { c as clearOtherUserApps, h as iosAppProcess, m as installIosApp, r as DEFAULT_METRO_PORT, u as devClientUrl, v as launchIosApp } from "./app-install-CrJ6t_bv.mjs";
+import { c as readMetroRecords, d as verifyLaunch, f as verifyReleaseLaunch, i as RELEASE_VERIFY_WAIT_MS, l as unverifiedLaunchLines, n as LAUNCH_FATAL, o as isBundleProof, r as LAUNCH_UNVERIFIED, s as readCollectorRecords, t as LAUNCH_BUNDLING } from "./launch-verify-CQS_Kg-C.mjs";
+import { c as unknownIosRuntimeRefusal, d as isEasBuildFailure, f as resolveEasDevelopmentBuild, r as checkDeviceCapacity, s as unknownIosDeviceTypeRefusal, u as easDeviceBuildRemedy } from "./simslim-Ca3487H6.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-Di8Q-9Ro.mjs";
+import { _ as isPhysicalDeviceRequest, a as swapJsBundle, b as warmMetro, c as runPrebuild, d as ensureOwnedDevice, g as ensureWorkspaceStorageSafely, h as ensureDevServer, l as staleNativeDirRefusal, m as clearIosAdoptionPending, n as pickDevClientScheme, o as planPrebuild, r as schemesFromInfoPlist, s as recordPrebuild, t as devClientScheme, u as ensureBooted, v as launchOutcomeRecord, y as sleep } from "./dev-client-92U593KT.mjs";
+import { t as budgetGate } from "./budget-BP4jZZL4.mjs";
+import { f as spawnEntry, s as startDevServer } from "./start-F9gv5dcC.mjs";
+import { a as statsProjectKey, i as recordRunStats, n as readRunEstimates, t as createRunRecorder } from "./stats-BAgJaLA4.mjs";
+import { a as compilationCacheActivityLine, c as readBundleExecutable, l as readBundleId, p as describeDiagnostic, r as buildIos, s as discoverXcodeProject, t as COMPILATION_CACHE_NOT_RUN, u as resolveScheme } from "./xcode-B2tBkf0m.mjs";
+import { n as nativeRunCommand, t as launchSlotScope } from "./slot-launch-C5cg0fmk.mjs";
+import { a as printNativeCrashReport, n as IOS_CRASH_REPORT_RETRY, o as simulatorConsolePaths, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-xxWKNO3-.mjs";
+import { a as iosPoolCandidates, c as listIosDevices, d as verifyIosDeviceReleaseLaunch, i as iosDeviceProcess, l as localNetworkPending, n as installIosDeviceApp, o as iosPoolNoCandidatesRefusal, r as iosDeviceBounds, s as isWirelessIosDevice, t as awaitIosDeviceLaunch, u as resolveIosPhysicalDevice } from "./ios-device-CtRdEVjx.mjs";
+import { a as runPodInstall, n as podsAreStale, r as readPodState } from "./deps-DP4eWqea.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 { X509Certificate } from "node:crypto";
 import { networkInterfaces, tmpdir } from "node:os";
-import { createWarnOnce, loadCacheProvider, resolveTieredBuild, storeTieredBuild } from "@stim-cli/cache";
 import chalk from "chalk";
+import { createWarnOnce, loadCacheProvider, resolveTieredBuild, storeTieredBuild } from "@stim-cli/cache";
 //#region src/engine/ios-lan.ts
 const IP_TXT = "ip.txt";
 function chooseLanAddress({ pinned = null, candidates }) {
@@ -91,6 +93,7 @@ function copyAppAside(appPath, { exec = null, mkdtemp = () => makeTemporaryDirec
 		]);
 	} catch {
 		try {
+			removeTemporaryEntry(copy);
 			e.runFile("cp", [
 				"-R",
 				appPath,
@@ -170,7 +173,7 @@ function deviceModelRefusal({ slot, deviceTypeFlag, runtimeFlag, deviceType, run
 	if (typeof deviceTypeFlag === "string" && deviceTypeFlag.trim() === "") return {
 		code: "STIM_BAD_ARG",
 		message: "--device-type was given an empty name.",
-		remedy: "Pass `--device-type <name>` with a model `xcrun simctl list devicetypes` names, e.g. \"iPad Pro 13-inch (M4)\"."
+		remedy: "Pass `--device-type <name>` with a model `xcrun simctl list devicetypes` names, e.g. \"iPad Pro 13-inch (M5)\"."
 	};
 	if (typeof runtimeFlag === "string" && runtimeFlag.trim() === "") return {
 		code: "STIM_BAD_ARG",
@@ -248,7 +251,7 @@ function lastBuildRecord({ fingerprint = null, cacheKey = null, cacheHit = false
 	if (errorCode) record.errorCode = errorCode;
 	return record;
 }
-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 }) {
+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, devServer = null }) {
 	return {
 		platform: "ios",
 		...slot && slot !== "default" ? { slot } : {},
@@ -275,7 +278,8 @@ function iosFacts({ slot, udid, deviceName, deviceType = null, runtime = null, f
 		logs: { dir: logsDir },
 		durationMs,
 		...webPreviewUrl ? { webPreviewUrl } : {},
-		...lease === void 0 ? {} : { lease }
+		...lease === void 0 ? {} : { lease },
+		...devServer ? { devServer } : {}
 	};
 }
 function writeLastBuild(root, record, { write = writeWorkspaceState } = {}) {
@@ -301,7 +305,7 @@ async function finishIosUpload(uploadPending, remote, phase, note) {
 	}
 	return false;
 }
-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, 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, providerName, closeWriter, webPreviewUrl, lease, recordRun, reclaimed = [], devServer = null }) {
 	const durationMs = elapsed();
 	recordRun({
 		failed: false,
@@ -343,15 +347,19 @@ function reportIosResult({ slot, d, root, json, release, configuration, buildSch
 		durationMs,
 		launched: launchState,
 		webPreviewUrl,
-		lease
+		lease,
+		devServer
 	});
-	if (json) console.log(JSON.stringify(facts));
+	if (json) console.log(JSON.stringify(reclaimed.length ? {
+		...facts,
+		reclaimed
+	} : facts));
 	else {
 		const summary = `${launchWarning ? "WARNING" : "OK"}: ${bundleId} on ${deviceLabel(device, udid)}, ` + (release ? `${configuration} (embedded JS, no Metro)` : `Metro port ${metroPort}`) + ` (${cacheDescription(cacheHit, providerName)}, ${formatDuration(durationMs)})`;
 		const outcome = launchWarning ? chalk.yellow(`${summary} -- ${launchWarning}`) : launchState === "unverified" ? chalk.yellow(`${summary} -- launch UNVERIFIED`) : launchState === "bundling" ? chalk.green(`${summary} -- bundle requested, still building`) : chalk.green(summary);
 		const deviceName = device?.deviceName ?? device?.name ?? udid;
 		const cacheResult = useBuildCache ? cacheDescription(cacheHit, providerName) : "bypassed; built";
-		const metroResult = release ? `embedded (${configuration})` : !metroCheck ? `check skipped on port ${metroPort}` : launchState === "unverified" ? `state unverified on port ${metroPort}` : `running on port ${metroPort}`;
+		const metroResult = release ? `embedded (${configuration})` : !metroCheck ? `check skipped on port ${metroPort}` : launchState === "unverified" ? `state unverified on port ${metroPort}` : `running on port ${metroPort}${devServer ? ` (started: ${devServer.reason})` : ""}`;
 		console.log([
 			outcome,
 			phaseLine("device", `${deviceName} (${udid})`),
@@ -383,7 +391,7 @@ var ArtifactRefusal = class extends Error {
 	}
 };
 async function acquireIosArtifact({ root, logFile, udid, remoteDestination, device, configuration, buildScheme, buildProfile, isExpo, optimizations, cache, easBuild, easProfile, maxBuilds, progress }, d) {
-	const { phase, note, logWriter, estimates, stats } = progress;
+	const { phase, note, logWriter, estimates, stats, step } = progress;
 	const physical = device !== null;
 	const lanAddress = device?.lanAddress ?? null;
 	const metroPort = device?.metroPort ?? null;
@@ -481,6 +489,7 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 			}
 			return;
 		}
+		step("cache-lookup");
 		const fingerprintTimer = stepTimer(d.now);
 		let computedFingerprint;
 		try {
@@ -605,107 +614,40 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 		}
 		return remote;
 	}
-	async function waitForSharedBuild() {
-		if (!useBuildCache) return;
-		const waitStarted = d.now();
-		let failedHolder;
-		while (!appPath) {
-			let attempt = null;
-			try {
-				attempt = d.acquireBuildLock({
-					platform: "ios",
-					key: cacheKey,
-					root,
-					logFile
-				});
-			} catch (e) {
-				const refusal = (0, ownership_claim_exports.claimFailure)(e, "stim ios");
-				if (refusal) fail({
-					code: refusal.code,
-					message: refusal.message,
-					remedy: refusal.remedy,
-					build: {
-						fingerprint,
-						cacheKey,
-						cacheHit,
-						cacheSkipped: !useBuildCache
-					}
-				});
-				note(chalk.yellow(phaseLine("build", `could not take the build lock: ${e?.message || e}; building anyway`)));
+	async function awaitSharedBuild() {
+		if (!useBuildCache || appPath) return;
+		const shared = await waitForSharedBuild({
+			platform: "ios",
+			key: cacheKey,
+			fingerprint,
+			root,
+			logFile,
+			command: "stim ios",
+			acquire: d.acquireBuildLock,
+			wait: d.waitForBuild,
+			now: d.now,
+			phase: (text) => {
+				step("wait");
+				phase("build", text);
+			},
+			warn: (text) => note(chalk.yellow(phaseLine("build", text))),
+			out: note
+		});
+		if (shared.refusal) fail({
+			...shared.refusal,
+			build: {
+				fingerprint,
+				cacheKey,
+				cacheHit,
+				cacheSkipped: !useBuildCache
 			}
-			if (attempt?.acquired) {
-				buildLock = attempt;
-				const previous = attempt.tookOver ?? failedHolder;
-				if (previous) note(chalk.yellow(phaseLine("build", takeoverLine(previous))));
-				break;
-			} else if (attempt?.held) {
-				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}` : ""} -- stim guide lifecycle concurrency`);
-				let waited = null;
-				try {
-					const ceilingMs = WAIT_CEILING_MS - (d.now() - waitStarted);
-					if (ceilingMs <= 0) throw Object.assign(/* @__PURE__ */ new Error(`Waited ${formatDuration(d.now() - waitStarted)} for shared builds without an artifact; ${who} (pid ${held.pid}) holds ${attempt.path}.`), {
-						code: "STIM_BUILD_WAIT_TIMEOUT",
-						lockPath: attempt.path
-					});
-					waited = await d.waitForBuild({
-						platform: "ios",
-						key: cacheKey,
-						out: note,
-						ceilingMs
-					});
-				} catch (e) {
-					const refusal = (0, ownership_claim_exports.claimFailure)(e, "stim ios");
-					if (refusal) fail({
-						code: refusal.code,
-						message: refusal.message,
-						remedy: refusal.remedy,
-						build: {
-							fingerprint,
-							cacheKey,
-							cacheHit,
-							cacheSkipped: !useBuildCache
-						}
-					});
-					const err = e;
-					if (err?.code !== "STIM_BUILD_WAIT_TIMEOUT") throw e;
-					fail({
-						code: "STIM_BUILD_WAIT_TIMEOUT",
-						message: err.message,
-						remedy: `Check pid ${held.pid}; if it is not really building, remove ${err.lockPath} and run \`stim ios\` again.`,
-						build: {
-							fingerprint,
-							cacheKey,
-							cacheHit,
-							cacheSkipped: !useBuildCache
-						}
-					});
-				}
-				if (waited?.hit) {
-					appPath = waited.hit ?? null;
-					cacheHit = "local";
-					waitedForBuild = {
-						pid: held.pid,
-						ms: waited.waitedMs
-					};
-					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 = {
-						facts: {
-							pid: held.pid,
-							ms: waited.waitedMs
-						},
-						who
-					};
-					phase("build", `${who}'s build lock was released; rechecking this workspace before building`);
-				} else {
-					note(chalk.yellow(phaseLine("build", `${who}'s build ended without an artifact (${waited?.builderFailed}); retrying the build lock`)));
-					failedHolder = held;
-				}
-			} else break;
+		});
+		buildLock = shared.lock;
+		releasedWait = shared.released;
+		if (shared.hit) {
+			appPath = shared.hit.path;
+			cacheHit = "local";
+			waitedForBuild = shared.hit.waited;
 		}
 	}
 	const prepareDeviceApp = async (path, { fresh }) => {
@@ -826,8 +768,19 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 				note(chalk.yellow(phaseLine("build", `could not take a build slot: ${e?.message || e}; building anyway`)));
 			}
 			const mutatingSteps = [];
-			if (d.needsPrebuild(root, "ios", isExpo)) {
-				const result = await d.runPrebuild(root, "ios", logWriter());
+			const prebuild = d.planPrebuild(root, "ios", {
+				isExpo,
+				fingerprint,
+				sources: fingerprintSources
+			});
+			if (prebuild === "refuse") fail({
+				...staleNativeDirRefusal("ios"),
+				build: buildFailure
+			});
+			if (prebuild === "generate" || prebuild === "regenerate") {
+				step("prebuild");
+				recordPrebuild(root, "ios", null);
+				const result = await d.runPrebuild(root, "ios", logWriter(), { clean: prebuild === "regenerate" });
 				if (result?.failed) {
 					phase("prebuild", "FAILED");
 					fail({
@@ -838,12 +791,25 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 						build: buildFailure
 					});
 				}
-				phase("prebuild", `ios/ absent -> generated (${formatDuration(result?.durationMs ?? 0)})`);
+				phase("prebuild", `${prebuild === "generate" ? "ios/ absent -> generated" : "ios/ not generated from this fingerprint -> regenerated with --clean"} (${formatDuration(result?.durationMs ?? 0)})`);
 				mutatingSteps.push("prebuild");
 			}
+			if (isExpo && buildScheme !== void 0) {
+				const project = d.discoverXcodeProject(root);
+				if (project.error) fail({
+					...project.error,
+					build: buildFailure
+				});
+				const schemeError = d.resolveScheme(project, { scheme: buildScheme }).error;
+				if (schemeError) fail({
+					...schemeError,
+					build: buildFailure
+				});
+			}
 			const podState = d.readPodState(root);
 			const action = podAction(podState, d.podsAreStale(podState.lockText, podState.manifestText));
 			if (action.install) {
+				step("pods");
 				const result = await d.runPodInstall(root, logWriter(), { estimateMs: estimates().podsMs });
 				const podCommand = result?.command || "pod install";
 				for (const line of result?.notes || []) note(chalk.dim(phaseLine("pods", line)));
@@ -868,6 +834,7 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 					previousHash: fingerprint,
 					fingerprint: d.fingerprintProject
 				});
+				if (after && mutatingSteps.includes("prebuild")) recordPrebuild(root, "ios", after.hash);
 				if (!after) {
 					storeHash = null;
 					storeKey = null;
@@ -903,6 +870,7 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 				}
 			}
 			if (!appPath) {
+				step("compile");
 				phase("build", `compiling ${configuration || "Debug"} with xcodebuild`);
 				const result = await d.buildIos({
 					root,
@@ -977,7 +945,7 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 		await resolveInitialFingerprint();
 		if (!easBuild) {
 			remote = await resolveRemoteArtifact();
-			await waitForSharedBuild();
+			await awaitSharedBuild();
 			await prepareCachedArtifact();
 			await buildArtifact();
 		}
@@ -1229,7 +1197,7 @@ function profileGate(input) {
 	if (!input.profile) return {
 		ok: false,
 		code: SIGNING_CODES.noProfile,
-		reason: "`security cms -D` could not decode the app bundle's embedded.mobileprovision.",
+		reason: "`openssl smime` could not decode the app bundle's embedded.mobileprovision.",
 		remedy: `The profile inside the app is corrupt. Delete the build cache entry with \`stim gc --delete\`, then ${XCODE_STEP}`
 	};
 	const profile = input.profile;
@@ -1335,10 +1303,13 @@ function readEmbeddedProfile(appPath, { exec = null } = {}) {
 	try {
 		return {
 			present: true,
-			profile: parseProvisioningProfilePlist(executor.runFile("security", [
-				"cms",
-				"-D",
-				"-i",
+			profile: parseProvisioningProfilePlist(executor.runFile("/usr/bin/openssl", [
+				"smime",
+				"-verify",
+				"-noverify",
+				"-inform",
+				"DER",
+				"-in",
 				path
 			], { timeoutMs: SIGNING_TIMEOUT_MS }))
 		};
@@ -1624,8 +1595,8 @@ const DEFAULT_DEPS = {
 	devClientScheme,
 	getProject,
 	upsertProject,
-	projectShortcut,
 	checkDeviceCapacity,
+	budgetGate,
 	ensureOwnedDevice,
 	listIosRuntimes,
 	ensureBooted,
@@ -1635,7 +1606,7 @@ const DEFAULT_DEPS = {
 	ensureRemoteBootOwned,
 	detectProviders,
 	resolveProjectMetro,
-	resolveMetroWithRetry,
+	startDevServer,
 	warmMetro,
 	readWorkspaceState,
 	pidExists,
@@ -1656,7 +1627,7 @@ const DEFAULT_DEPS = {
 	resolveEasCliBin,
 	resolveRemote,
 	uploadRemote,
-	needsPrebuild,
+	planPrebuild,
 	runPrebuild,
 	readPodState,
 	podsAreStale,
@@ -1838,6 +1809,12 @@ function reportLaunchErrors(errors, note, root) {
 	for (const line of report.lines) note(chalk.yellow(phaseLine("launch", line)));
 	return report.lines.length > 0;
 }
+function installsOverWifi(d, udid, selectedWireless, note) {
+	const current = d.listIosDevices().find((entry) => entry.udid === udid);
+	const wireless = current ? isWirelessIosDevice(current) : selectedWireless;
+	if (wireless) note(phaseLine("device", `${current?.name ?? udid} is paired over Wi-Fi, so the install and launch go over the network and take longer than over a cable`));
+	return wireless;
+}
 function cleanAdoptedIosApps({ d, root, slot, udid, bundleId, phase, note }) {
 	const swept = d.clearOtherUserApps({
 		udid,
@@ -1875,10 +1852,14 @@ function recordIosReloadTarget({ d, root, physical, remoteDevice, bundleId, udid
 		note(chalk.yellow(phaseLine("state", `could not record iOS launch: ${error?.message || error}`)));
 	}
 }
-function simulatorLaunchFailureRemedy(remote, udid, bundleId, logFile) {
-	return `${remote ? "Run" : "If the simulator timed out, run `stim doctor --platform ios` and resolve any reported host memory pressure before retrying. Otherwise run"} \`xcrun simctl launch --terminate-running-process --console ${udid} ${bundleId}\` to see what the app reports, and check ${logFile}.`;
+function installFailureRemedy(remoteDevice) {
+	return remoteDevice?.failureRemedy() ?? "Check that the simulator is booted and that the app was built for the simulator SDK.";
+}
+function launchFailureRemedy(remoteDevice, udid, bundleId, logFile) {
+	if (remoteDevice) return remoteDevice.failureRemedy();
+	return `If the simulator timed out, run \`stim doctor --platform ios\` and resolve any reported host memory pressure before retrying. Otherwise run \`xcrun simctl launch --terminate-running-process --console ${udid} ${bundleId}\` to see what the app reports, and check ${logFile}.`;
 }
-async function finishIosRun({ artifact, d, root, slot, json, release, configuration, buildScheme, isExpo, metroCheck, metroPort, logsDir, logFile, device, udid, physical, lanAddress, lanOriginUrl, remoteDevice, bootPromise, bootDuration, fail, phase, note, logWriter, elapsed, startedAt, closeWriter, lease, releaseLease, recordRun }) {
+async function finishIosRun({ artifact, d, root, slot, json, release, configuration, buildScheme, isExpo, metroCheck, metroPort, logsDir, logFile, device, udid, physical, wireless, lanAddress, lanOriginUrl, remoteDevice, bootPromise, bootDuration, fail, phase, note, logWriter, elapsed, startedAt, closeWriter, lease, releaseLease, recordRun, reclaimed, devServer, enterPhase }) {
 	const { path: appPath, bundleId: initialBundleId, failureFields: buildFailure, cache } = artifact;
 	const { hit: cacheHit, providerName, readEnabled: useBuildCache, waitedForBuild, compilation: compilationCache } = cache;
 	const storeHash = cache.identity?.fingerprint ?? null;
@@ -1918,6 +1899,7 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 		}
 	});
 	if (bundleId) d.upsertProject(root, { bundleId });
+	enterPhase("install");
 	const booted = await bootPromise;
 	if (!booted?.ok) return fail({
 		code: booted?.code || "STIM_NO_DEVICE",
@@ -1934,7 +1916,9 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 	let launched = null;
 	let launchedAt = d.now();
 	if (physical) {
-		const lostBeforeInstall = raiseLeaseFor(DEVICECTL_INSTALL_TIMEOUT_MS, true);
+		const overWifi = installsOverWifi(d, udid, wireless, note);
+		const bounds = iosDeviceBounds(overWifi);
+		const lostBeforeInstall = raiseLeaseFor(bounds.installMs, true);
 		if (lostBeforeInstall) return fail(lostBeforeInstall);
 		await d.stopPreviousCollector({
 			root,
@@ -1944,8 +1928,9 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 		const installed = d.installIosDeviceApp({
 			udid,
 			appPath,
-			bundleId
-		});
+			bundleId,
+			wireless: overWifi
+		}, { beforeStep: () => raiseLeaseFor(bounds.installMs, false) });
 		if (installed?.failed) {
 			dropSwapDir();
 			return fail({
@@ -1970,8 +1955,9 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 			});
 		}
 		dropSwapDir();
-		raiseLeaseFor(COLLECTOR_EXIT_WAIT_MS + LAUNCH_PROBE_TIMEOUT_MS, false);
+		raiseLeaseFor(COLLECTOR_EXIT_WAIT_MS + bounds.launchMs, false);
 		const payloadUrl = scheme && metroPort !== null && lanAddress ? devClientUrl(scheme, metroPort, lanAddress) : null;
+		enterPhase("launch");
 		const launchTimer = stepTimer(d.now);
 		launchedAt = d.now();
 		logWriter().write({
@@ -2012,10 +1998,11 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 			bundleId,
 			appName: appName ?? bundleId,
 			collectorPid: collector.pid,
+			wireless: overWifi,
 			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",
+			code: started.code ?? "STIM_LAUNCH_FAILED",
 			message: started.reason ?? `${bundleId} did not start on ${udid}.`,
 			remedy: started.remedy ?? null,
 			lines: started.lines ?? [],
@@ -2067,7 +2054,7 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 		if (installed?.failed) return fail({
 			code: installed.code || "STIM_INSTALL_FAILED",
 			message: installed.reason,
-			remedy: "Check that the simulator is booted and that the app was built for the simulator SDK.",
+			remedy: installFailureRemedy(remoteDevice),
 			build: {
 				...buildFailure,
 				appPath,
@@ -2088,6 +2075,7 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 			appExecutable,
 			note
 		});
+		enterPhase("launch");
 		const launchTimer = stepTimer(d.now);
 		launchedAt = d.now();
 		logWriter().write({
@@ -2127,7 +2115,7 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 			return fail({
 				code: launched.code || "STIM_LAUNCH_FAILED",
 				message: launched.reason,
-				remedy: simulatorLaunchFailureRemedy(Boolean(remoteDevice), udid, bundleId, logFile),
+				remedy: launchFailureRemedy(remoteDevice, udid, bundleId, logFile),
 				build: {
 					...buildFailure,
 					appPath,
@@ -2240,7 +2228,9 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 			closeWriter,
 			webPreviewUrl: remoteDevice?.webPreviewUrl() ?? null,
 			lease: physical ? leaseFacts : void 0,
-			recordRun
+			recordRun,
+			reclaimed,
+			devServer
 		}),
 		uploadsAbandoned
 	};
@@ -2257,18 +2247,33 @@ 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("--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("--simulator-app <app>", "Open the owned simulator in xcode or siniulator for this run, overriding the machine iosSimulatorApp setting. Also opens an already running simulator; local simulators only.").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) => {
+	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. A Debug run starts the dev server when it is not running.").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)", parseDeviceSlotOption).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?\" check: do not start it, 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 (M5)\"). 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("--simulator-app <app>", "Open the owned simulator in xcode, siniulator, or stim-desktop for this run, overriding the machine iosSimulatorApp setting. Also opens an already running simulator; local simulators only.").option("--device [udid]", "Build the iphoneos slice for a connected iPhone, install it, and launch it, instead of using this workspace's owned simulator. The phone can be cabled or paired over Wi-Fi. With no UDID, the first cabled device this workspace can lease is used, waiting for one that is busy; a Wi-Fi device is used only when no cabled one is connected and ready. 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) => {
 		const root = (deps.findProjectRoot ?? DEFAULT_DEPS.findProjectRoot)(process.cwd());
-		const run = () => runIos({
+		const run = (progress) => runIos({
 			...opts,
 			waitConflict: waitFlagConflict(process.argv)
-		}, deps);
-		const completion = root ? await withWorkspaceProcessLock(workspaceDir(root), "native-run", run, {
+		}, deps, progress);
+		const completion = root ? await withWorkspaceProcessLock(workspaceDir(root), "native-run", async (claim) => {
+			recordWorkspaceUse(root);
+			const progress = startBuildProgress({
+				root,
+				platform: "ios",
+				slot: opts.slot ?? "default",
+				claim,
+				note: (line) => writeNote(chalk.dim(line))
+			});
+			try {
+				return await run(progress);
+			} finally {
+				progress.clear();
+			}
+		}, {
 			external: true,
-			waitMs: 18e5
+			waitMs: 18e5,
+			declareSpawns: true
 		}) : await run();
 		if (!completion) process.exit(1);
 		else if (completion.uploadsAbandoned) exitAfterFlush(0);
@@ -2281,7 +2286,7 @@ function explicitSchemeRefusal(root, scheme, isExpo, d) {
 		message: "--scheme must name a non-empty shared Xcode app scheme.",
 		remedy: "Pass the exact scheme name shown by xcodebuild -list."
 	};
-	if (d.needsPrebuild(root, "ios", isExpo)) return null;
+	if (isExpo) return null;
 	const project = d.discoverXcodeProject(root);
 	if (project.error) return project.error;
 	return d.resolveScheme(project, { scheme }).error ?? null;
@@ -2332,7 +2337,7 @@ function iosSlotDeps(d, slot) {
 	}
 	return d;
 }
-async function runIos(opts = {}, overrides = {}) {
+async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 	const slot = validateDeviceSlot(opts.slot);
 	let d = iosSlotDeps({
 		...DEFAULT_DEPS,
@@ -2346,16 +2351,7 @@ async function runIos(opts = {}, overrides = {}) {
 	const started = d.now();
 	const startedAt = new Date(started).toISOString();
 	const elapsed = () => d.now() - started;
-	const foundRoot = d.findProjectRoot(process.cwd());
-	if (!foundRoot) {
-		note(chalk.red("Not in a React Native project (no package.json found)."));
-		process.exitCode = 1;
-		return null;
-	}
-	const root = foundRoot;
-	const projectProblem = appProjectProblem(root);
-	if (projectProblem) {
-		const { message, remedy } = projectProblem;
+	const refuseProject = ({ message, remedy }) => {
 		note(chalk.red(phaseLine("error", message)));
 		note(chalk.dim(phaseLine("remedy", remedy)));
 		note(chalk.red(phaseLine("failed", "STIM_NO_PROJECT")));
@@ -2366,7 +2362,12 @@ async function runIos(opts = {}, overrides = {}) {
 		}));
 		process.exitCode = 1;
 		return null;
-	}
+	};
+	const foundRoot = d.findProjectRoot(process.cwd());
+	if (!foundRoot) return refuseProject(NO_PROJECT_REFUSAL);
+	const root = foundRoot;
+	const projectProblem = appProjectProblem(root);
+	if (projectProblem) return refuseProject(projectProblem);
 	try {
 		await d.ensureWorkspaceStorage(root, { note });
 	} catch (error) {
@@ -2404,10 +2405,12 @@ async function runIos(opts = {}, overrides = {}) {
 		platform: "ios",
 		write: (statsRun, at) => d.recordStats(statsRun, at),
 		now: () => d.now(),
-		note: (line) => note(chalk.dim(line))
+		note: (line) => note(chalk.dim(line)),
+		phases: () => progress.durations()
 	});
 	const recordRun = stats.record;
 	let compilationCache = COMPILATION_CACHE_NOT_RUN;
+	let reclaimed = [];
 	const fail = ({ code, message, remedy = null, lines = [], logPath = null, build = null, lease }) => {
 		releaseLease();
 		if (message) note(chalk.red(phaseLine("error", message)));
@@ -2431,7 +2434,8 @@ async function runIos(opts = {}, overrides = {}) {
 			message: message ?? null,
 			remedy: remedy ?? null,
 			...compilationCache.status === "not-run" ? {} : { compilationCache },
-			...lease === void 0 ? {} : { lease }
+			...lease === void 0 ? {} : { lease },
+			...reclaimed.length ? { reclaimed } : {}
 		}));
 		writer?.close?.();
 		process.exitCode = 1;
@@ -2477,12 +2481,6 @@ async function runIos(opts = {}, overrides = {}) {
 	for (const key of unknownSettingKeys(settings)) note(phaseLine("setting", chalk.yellow(`Warning: setting "${key}" is not read by Stim and will be ignored.`)));
 	const cacheProviderError = cacheProviderSettingError(settings);
 	if (cacheProviderError) note(chalk.yellow(phaseLine("cache", `${cacheProviderError} Using the local cache.`)));
-	const remoteSettingError = remoteDeviceSettingError(settings);
-	if (remoteSettingError) return fail({
-		code: "STIM_BAD_ARG",
-		message: remoteSettingError,
-		remedy: `Set ios.remote and android.remote to one of: ${REMOTE_DEVICE_BACKENDS.join(", ")}.`
-	});
 	const poolError = parkedMaxSetting("ios").error;
 	if (poolError) return fail({
 		code: "STIM_BAD_ARG",
@@ -2514,7 +2512,7 @@ async function runIos(opts = {}, overrides = {}) {
 	});
 	if (physical && opts.remote) return fail({
 		code: "STIM_BAD_ARG",
-		message: "--device builds for a phone cabled to this machine, and --remote installs on a remote one.",
+		message: "--device builds for a phone connected to this machine, and --remote installs on a remote one.",
 		remedy: "Pass only one of --device and --remote."
 	});
 	const noWait = opts.wait === false;
@@ -2554,29 +2552,16 @@ async function runIos(opts = {}, overrides = {}) {
 		listRuntimes: d.listIosRuntimes
 	});
 	if (modelRefusal) return fail(modelRefusal);
-	const easBuild = await d.resolveEasDevelopmentBuild({
+	const budget = await d.budgetGate({
 		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
+		note
 	});
-	if (remoteBackend !== "eas") registerProject();
-	const proj = d.getProject(root);
-	const label = d.projectShortcut(root, proj);
+	reclaimed = budget.reclaimed;
+	if (budget.refusal) return fail(budget.refusal);
 	let remoteDevice = null;
 	if (remoteBackend) {
 		const resolved = await d.resolveRemoteContext({
 			root,
-			label,
 			backend: remoteBackend,
 			easBin: d.resolveEasCliBin(root)?.file ?? null
 		});
@@ -2595,8 +2580,26 @@ async function runIos(opts = {}, overrides = {}) {
 			launchIosApp: remoteDevice.launchIosApp
 		};
 	}
+	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
+	});
+	if (remoteBackend !== "eas") registerProject();
+	const proj = d.getProject(root);
 	const limits = d.getConcurrencyLimits();
 	let physicalDevice = null;
+	let wireless = false;
 	if (physical && typeof deviceFlag !== "string") {
 		const pooled = await d.selectFromPool({
 			root,
@@ -2604,7 +2607,8 @@ async function runIos(opts = {}, overrides = {}) {
 			idLabel: "udid",
 			list: () => iosPoolCandidates(d.listIosDevices()).map((entry) => ({
 				id: entry.udid,
-				name: entry.name
+				name: entry.name,
+				fallback: isWirelessIosDevice(entry)
 			})),
 			noCandidates: () => {
 				const resolved = iosPoolNoCandidatesRefusal(d.listIosDevices());
@@ -2628,6 +2632,7 @@ async function runIos(opts = {}, overrides = {}) {
 			udid: pooled.candidate.id,
 			name: pooled.candidate.name ?? pooled.candidate.id
 		};
+		wireless = pooled.candidate.fallback === true;
 	} else if (physical) {
 		const resolved = resolveIosPhysicalDevice(typeof deviceFlag === "string" ? deviceFlag : null, d.listIosDevices());
 		if (!resolved.udid) return fail({
@@ -2639,6 +2644,7 @@ async function runIos(opts = {}, overrides = {}) {
 			udid: resolved.udid,
 			name: resolved.name ?? resolved.udid
 		};
+		wireless = resolved.wireless === true;
 	}
 	if (!physical) {
 		const capacity = d.checkDeviceCapacity({
@@ -2651,6 +2657,7 @@ async function runIos(opts = {}, overrides = {}) {
 	let metroPort = proj?.metroPort ?? null;
 	let lanAddress = null;
 	let lanOriginUrl = null;
+	let devServer = null;
 	if (!await resolveMetroPort()) return null;
 	let device;
 	if (physicalDevice) device = {
@@ -2693,34 +2700,28 @@ async function runIos(opts = {}, overrides = {}) {
 			metroPort = null;
 			phase("metro", `skipped (${configuration}: the JS bundle is embedded, no dev server is used)`);
 		} else if (metroCheck) {
-			if (!metroPort) {
-				fail({
-					code: "STIM_NO_METRO",
-					message: "No Metro port is reserved for this workspace, so there is no dev server to build against.",
-					remedy: "Run `stim start` first, or pass --no-metro-check."
-				});
-				return false;
-			}
-			const resolution = await d.resolveMetroWithRetry(d.resolveProjectMetro, metroPort, root, { onRetry: ({ delayMs }) => note(chalk.dim(phaseLine("metro", `port ${metroPort} did not verify yet; retrying in ${Math.round(delayMs / 1e3)}s (Metro may still be indexing)`))) });
-			if (!resolution?.metro) {
-				const supervisor = d.readWorkspaceState(root)?.supervisor ?? null;
-				const supervisorAlive = Boolean(supervisor?.pid && d.pidExists(supervisor.pid));
+			const gate = await ensureDevServer({
+				root,
+				port: metroPort,
+				settings,
+				remote: Boolean(remoteDevice),
+				note,
+				resolve: d.resolveProjectMetro,
+				start: d.startDevServer,
+				readState: d.readWorkspaceState
+			});
+			reclaimed = [...reclaimed, ...gate.reclaimed];
+			if (!gate.ok) {
 				fail({
-					code: "STIM_NO_METRO",
-					message: noMetroMessage({
-						port: metroPort,
-						resolution,
-						supervisor,
-						supervisorAlive
-					}),
-					remedy: noMetroRemedy({
-						port: metroPort,
-						supervisor,
-						supervisorAlive
-					})
+					code: gate.code,
+					message: gate.message,
+					remedy: gate.remedy,
+					lines: gate.lines
 				});
 				return false;
 			}
+			metroPort = gate.port;
+			devServer = gate.devServer;
 		} else if (!metroPort) {
 			metroPort = DEFAULT_METRO_PORT;
 			note(chalk.yellow(`No Metro port is reserved for this workspace; wiring the app to ${metroPort}.`));
@@ -2814,6 +2815,7 @@ async function runIos(opts = {}, overrides = {}) {
 			boot,
 			createdSessionId: remoteDevice.createdSessionId,
 			abandonCreatedSession: remoteDevice.abandonCreatedSession,
+			webPreviewUrl: remoteDevice.webPreviewUrl,
 			writeState: d.writeWorkspaceState,
 			register: registerProject
 		}) : boot()).then((result) => {
@@ -2850,7 +2852,8 @@ async function runIos(opts = {}, overrides = {}) {
 				note,
 				logWriter,
 				estimates,
-				stats
+				stats,
+				step: progress.step
 			}
 		}, d);
 		if (!acquiredArtifact.ok) {
@@ -2868,7 +2871,7 @@ async function runIos(opts = {}, overrides = {}) {
 				idLabel: "udid",
 				waitSeconds,
 				noWait,
-				installBoundMs: DEVICECTL_INSTALL_TIMEOUT_MS,
+				installBoundMs: iosDeviceBounds(wireless).installMs,
 				appId: artifact.bundleId ?? proj?.bundleId ?? null,
 				holderAppId: (holder) => d.getProject(holder)?.bundleId ?? null,
 				now: d.now,
@@ -2908,6 +2911,7 @@ async function runIos(opts = {}, overrides = {}) {
 				device,
 				udid,
 				physical,
+				wireless,
 				lanAddress,
 				lanOriginUrl,
 				remoteDevice,
@@ -2923,7 +2927,10 @@ async function runIos(opts = {}, overrides = {}) {
 				closeWriter: () => writer?.close?.(),
 				lease: leaseHandle,
 				releaseLease,
-				recordRun
+				recordRun,
+				reclaimed,
+				devServer,
+				enterPhase: progress.step
 			});
 		} finally {
 			releaseLease();
@@ -2939,4 +2946,4 @@ async function runIos(opts = {}, overrides = {}) {
 	}
 }
 //#endregion
-export { appNameFromPath, buildLogFile, cacheDescription, collectorEntry, iosCommand as default, devClientScheme, deviceLabel, ensureWorkspaceStorageSafely, formatDuration, gateShouldRetry, iosConfigurationSetting, iosFacts, isReleaseConfiguration, lastBuildRecord, noMetroMessage, phaseLine, pickDevClientScheme, podAction, registerIos, replaceCollector, resolveConfiguration, resolveDeviceType, resolveMetroWithRetry, resolveRuntime, schemesFromInfoPlist, shortHash, shortUdid, writeLastBuild };
+export { appNameFromPath, buildLogFile, cacheDescription, collectorEntry, iosCommand as default, devClientScheme, deviceLabel, ensureWorkspaceStorageSafely, formatDuration, iosConfigurationSetting, iosFacts, isReleaseConfiguration, lastBuildRecord, phaseLine, pickDevClientScheme, podAction, registerIos, replaceCollector, resolveConfiguration, resolveDeviceType, resolveRuntime, schemesFromInfoPlist, shortHash, shortUdid, writeLastBuild };