stim 1.10.0 → 1.11.0

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

@@ -1,35 +1,36 @@
 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 { O as workspaceDir, c as signalProcessTree, h as recordWorkspaceUse, i as pidExists, j as workspaceLogsDir, m as readWorkspaceState$1, s as resolveProjectMetro, y as writeWorkspaceState } from "./metro-BWLOJ_Wr.mjs";
 import { D as makeTemporaryDirectory, O as removeTemporaryEntry, s as gitCommonDir, y as repoRoot } from "./worktree-BlizKDpZ.mjs";
 import { a as detectIsExpo, i as detectBundleId, n as appProjectProblem, o as findProjectRoot, t as NO_PROJECT_REFUSAL } from "./project-BXZzOABt.mjs";
 import { n as MODE_EXPO, p as writeWorkspaceLaunch, t as MODE_BARE } from "./state-WGdIbi_d.mjs";
-import { 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 { A as resolveBuild, C as filesystemBuildCapability, D as providerDownloadPath, E as prepareProviderDownloadDir, F as untrackedNativeFiles, O as providerUploadOutcome, P as untrackedMissLine, T as fingerprintProject, _ as waitForBuild, b as buildCacheKey, g as releaseBuildLock, j as storeBuild, k as refingerprintAfterMutation, m as acquireBuildLock, v as waitForSharedBuild, w as fingerprintDiffRecord } from "./device-lease-D83nqeMX.mjs";
+import { A as resolveCacheProviderConfig, E as publicUrlSetting, I as tunnelModeSetting, L as unknownSettingKeys, P as settingShapeErrors, S as metroWarmupUrlSetting, U as optimizationBuildProfile, V as artifactCachePolicy, W as resolveOptimizations, _ as iosSigningIdentitySha1SettingError, a as SETTING_SHAPE_REMEDY, d as cacheProviderSettingError, f as iosLanHostSetting, g as iosSigningIdentitySha1Setting, h as iosSigningIdentitySettingError, j as resolveSettings, k as remoteIosSetting, m as iosSigningIdentitySetting, p as iosLanHostSettingError, r as REMOTE_DEVICE_BACKENDS, z as detectProviders } from "./settings-B5oFZEri.mjs";
+import { h as POOL_SETTING_REMEDY, y as parkedMaxSetting } from "./ownership-BiojdtAp.mjs";
+import { D as parseIosSimulatorApp, f as listIosRuntimes } from "./ios-DArbmwer.mjs";
+import { c as startBuildProgress, n as NO_BUILD_PROGRESS } from "./build-progress-CDwogz6R.mjs";
+import { a as acquireBuildSlot, s as releaseBuildSlot } from "./in-use-DVhlSoyn.mjs";
 import { n as verifyCollectorOwnership } from "./ownership-D2xbLVoz.mjs";
-import { A as UPLOAD_TIMEOUT_MS, B as resolveRemote, F as isEasAuthFailureText, I as loadProjectProvider, M as checkEasAuth, N as easAuthNote, O as gateMetroOrigin, P as exitAfterFlush, V as uploadRemote, a as ensureMetroReachable, j as cacheLevel, k as RESOLVE_TIMEOUT_MS, l as remoteIosDeps, n as binOnPath, o as ensureRemoteBootOwned, r as bundleEntryPoint, u as resolveRemoteContext, w as ownedSessionName, z as resolveEasCliBin } from "./device-remote-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 UPLOAD_TIMEOUT_MS, B as resolveRemote, F as isEasAuthFailureText, I as loadProjectProvider, M as checkEasAuth, N as easAuthNote, O as gateMetroOrigin, P as exitAfterFlush, V as uploadRemote, a as ensureMetroReachable, j as cacheLevel, k as RESOLVE_TIMEOUT_MS, l as remoteIosDeps, n as binOnPath, o as ensureRemoteBootOwned, r as bundleEntryPoint, u as resolveRemoteContext, w as ownedSessionName, z as resolveEasCliBin } from "./device-remote-BQZSnnmE.mjs";
+import { c as clearOtherUserApps, h as iosAppProcess, m as installIosApp, r as DEFAULT_METRO_PORT, u as devClientUrl, v as launchIosApp } from "./app-install-DHut6JnV.mjs";
+import { c as readMetroRecords, d as verifyLaunch, f as verifyReleaseLaunch, i as RELEASE_VERIFY_WAIT_MS, l as unverifiedLaunchLines, n as LAUNCH_FATAL, o as isBundleProof, r as LAUNCH_UNVERIFIED, s as readCollectorRecords, t as LAUNCH_BUNDLING } from "./launch-verify-CuPDGXdr.mjs";
+import { c as unknownIosDeviceTypeRefusal, d as easDeviceBuildRemedy, f as isEasBuildFailure, l as unknownIosRuntimeRefusal, m as resolveEasDevelopmentBuild, p as planEasDevelopmentBuild, r as checkDeviceCapacity } from "./simslim-CIR3IYJO.mjs";
+import { d as withNativeBuildRun, r as cancelledFailure, u as runCancellation } from "./native-run-D7yB_AsB.mjs";
+import { a as lostLine, c as releaseLeaseOnSignal, i as leaseExpiryText, l as runLease, n as DEBUG_VERIFY_STEP_MS, o as lostRefusal, r as acquireRunLease, s as parseDeviceWait, t as selectFromPool, u as waitFlagConflict } from "./device-pool-DHj7cdPy.mjs";
+import { C as ensureDevServer, D as sleep, E as launchOutcomeRecord, O as warmMetro, S as clearIosAdoptionPending, T as isPhysicalDeviceRequest, _ as staleNativeDirRefusal, a as refusePlan, c as skippedMissReason, d as schemesFromInfoPlist, g as runPrebuild, h as recordPrebuild, i as printPlan, l as devClientScheme, m as planPrebuild, n as planFlagRefusal, o as explainBuildMiss, p as swapJsBundle, r as planPayload, s as fingerprintErrorMissReason, t as planCachedBuild, u as pickDevClientScheme, v as ensureBooted, w as ensureWorkspaceStorageSafely, y as ensureOwnedDevice } from "./build-plan-CeAYgKAx.mjs";
+import { t as budgetGate } from "./budget-De3P2rq_.mjs";
+import { f as spawnEntry, s as startDevServer } from "./start-BSsf2tUs.mjs";
 import { a as statsProjectKey, i as recordRunStats, n as readRunEstimates, t as createRunRecorder } from "./stats-BAgJaLA4.mjs";
-import { a as compilationCacheActivityLine, c as readBundleExecutable, l as readBundleId, p as describeDiagnostic, r as buildIos, s as discoverXcodeProject, t as COMPILATION_CACHE_NOT_RUN, u as resolveScheme } from "./xcode-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 { a as compilationCacheActivityLine, c as readBundleExecutable, l as readBundleId, p as describeDiagnostic, r as buildIos, s as discoverXcodeProject, t as COMPILATION_CACHE_NOT_RUN, u as resolveScheme } from "./xcode-B5SPD--o.mjs";
+import { n as nativeRunCommand, t as launchSlotScope } from "./slot-launch-rggO1Esw.mjs";
+import { a as printNativeCrashReport, n as IOS_CRASH_REPORT_RETRY, o as simulatorConsolePaths, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-UYFSQwRy.mjs";
+import { a as iosPoolCandidates, c as listIosDevices, d as verifyIosDeviceReleaseLaunch, i as iosDeviceProcess, l as localNetworkPending, n as installIosDeviceApp, o as iosPoolNoCandidatesRefusal, r as iosDeviceBounds, s as isWirelessIosDevice, t as awaitIosDeviceLaunch, u as resolveIosPhysicalDevice } from "./ios-device-CwDZo0X4.mjs";
+import { a as runPodInstall, n as podsAreStale, r as readPodState } from "./deps-OF7CD5Dx.mjs";
 import { existsSync, mkdirSync, mkdtempSync, openSync, rmSync, writeFileSync } from "node:fs";
 import { InvalidArgumentError } from "commander";
+import { LAST_BUILD_KEYS } from "@stim-cli/core/state";
 import { basename, join } from "node:path";
 import { X509Certificate } from "node:crypto";
 import { networkInterfaces, tmpdir } from "node:os";
@@ -235,7 +236,7 @@ function printDiagnostics(note, result) {
 }
 //#endregion
 //#region src/commands/ios/result.ts
-function lastBuildRecord({ fingerprint = null, cacheKey = null, cacheHit = false, cacheSkipped = false, durationMs = 0, appPath = null, bundleId = null, startedAt, status, errorCode = null }) {
+function lastBuildRecord({ fingerprint = null, cacheKey = null, cacheHit = false, cacheSkipped = false, durationMs = 0, appPath = null, bundleId = null, startedAt, status, errorCode = null, missReason = null }) {
 	const record = {
 		platform: "ios",
 		fingerprint,
@@ -249,6 +250,7 @@ function lastBuildRecord({ fingerprint = null, cacheKey = null, cacheHit = false
 		status
 	};
 	if (errorCode) record.errorCode = errorCode;
+	if (missReason && !cacheLevel(cacheHit)) record.missReason = missReason;
 	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, devServer = null }) {
@@ -284,7 +286,10 @@ function iosFacts({ slot, udid, deviceName, deviceType = null, runtime = null, f
 }
 function writeLastBuild(root, record, { write = writeWorkspaceState } = {}) {
 	try {
-		write(root, { lastBuild: record });
+		write(root, {
+			lastBuild: record,
+			[LAST_BUILD_KEYS["ios"]]: record
+		});
 	} catch {}
 	return record;
 }
@@ -305,7 +310,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, reclaimed = [], devServer = null }) {
+function reportIosResult({ slot, d, root, json, release, configuration, buildScheme = null, metroCheck, metroPort, logsDir, device, udid, appPath, bundleId, installSkipped, elapsed, startedAt, storeHash, storeKey, cacheHit, missReason, compilationCache, useBuildCache, waitedForBuild, launchState, launchWarning, providerName, closeWriter, webPreviewUrl, lease, recordRun, reclaimed = [], devServer = null }) {
 	const durationMs = elapsed();
 	recordRun({
 		failed: false,
@@ -318,6 +323,7 @@ function reportIosResult({ slot, d, root, json, release, configuration, buildSch
 		cacheKey: storeKey,
 		cacheHit,
 		cacheSkipped: !useBuildCache,
+		missReason,
 		durationMs,
 		appPath,
 		bundleId,
@@ -462,6 +468,7 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 	let releasedWait = null;
 	let swapFellBack = false;
 	let buildFailure = {};
+	let missReason = null;
 	async function resolveInitialFingerprint() {
 		if (easBuild?.ok) {
 			fingerprint = storeHash = easBuild.fingerprint;
@@ -492,18 +499,24 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 		step("cache-lookup");
 		const fingerprintTimer = stepTimer(d.now);
 		let computedFingerprint;
+		let fingerprintError = "no hash";
 		try {
 			const computed = await d.fingerprintProject(root, { platform: "ios" });
 			computedFingerprint = computed?.hash ?? null;
 			fingerprintSources = computed?.sources ?? [];
 		} catch (e) {
 			computedFingerprint = null;
-			note(chalk.dim(`Fingerprinting failed: ${e?.message || e}`));
+			fingerprintError = String(e?.message || e);
+			note(chalk.dim(`Fingerprinting failed: ${fingerprintError}`));
 		}
 		if (!computedFingerprint) fail({
 			code: "STIM_NO_FINGERPRINT",
 			message: `Could not fingerprint ${root}: @expo/fingerprint produced no hash for it.`,
-			remedy: "Check the project native inputs and the @expo/fingerprint error above, then retry."
+			remedy: "Check the project native inputs and the @expo/fingerprint error above, then retry.",
+			build: {
+				cacheSkipped: !useBuildCache,
+				missReason: fingerprintErrorMissReason(fingerprintError)
+			}
 		});
 		fingerprint = computedFingerprint;
 		cacheKey = buildCacheKey("ios", fingerprint, {
@@ -535,29 +548,7 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 		});
 		const cached = found?.tier === "local" ? found.path : null;
 		cacheHit = cached ? "local" : false;
-		let missDiff = "";
-		let missUntracked = null;
-		if (!cached) {
-			const lastBuild = d.readWorkspaceState(root)?.lastBuild ?? null;
-			const miss = describeFingerprintMiss({
-				platform: "ios",
-				current: {
-					hash: fingerprint,
-					sources: fingerprintSources
-				},
-				lastBuild
-			});
-			if (miss) {
-				missDiff = fingerprintDiffSuffix(miss.changed);
-				logWriter().write(fingerprintDiffRecord({
-					changed: miss.changed,
-					previousHash: miss.previousHash,
-					hash: fingerprint
-				}));
-			} else if (useBuildCache) missUntracked = untrackedMissLine(d.untrackedNativeFiles({ projectRoot: root }));
-		}
-		phase("fingerprint", `${shortHash(fingerprint)} ${cached ? "hit" : "miss"}${useBuildCache ? "" : cache.disabledByFlag ? " (--no-build-cache)" : " (cache reuse off in config)"} ${fingerprintTimer()}${missDiff}`);
-		if (missUntracked) note(chalk.dim(phaseLine("fingerprint", missUntracked)));
+		phase("fingerprint", `${shortHash(fingerprint)} ${cached ? "hit" : "miss"}${useBuildCache ? "" : cache.disabledByFlag ? " (--no-build-cache)" : " (cache reuse off in config)"} ${fingerprintTimer()}`);
 		if (found?.tier === "provider") {
 			cacheHit = "remote";
 			providerName = found.providerName ?? null;
@@ -742,6 +733,38 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 			}
 		}
 	}
+	function explainMiss(rekeyedBy) {
+		if (swapFellBack) missReason = skippedMissReason("the cached app could not be reused, so this run built it fresh");
+		else if (!useBuildCache) missReason = skippedMissReason(cache.disabledByFlag ? "cache reuse turned off by --no-build-cache" : "cache reuse off in config");
+		else {
+			const current = {
+				hash: storeHash ?? fingerprint,
+				sources: storeSources
+			};
+			const explained = explainBuildMiss({
+				root,
+				platform: "ios",
+				current,
+				rekeyedBy,
+				baselineDeps: { readState: d.readWorkspaceState }
+			});
+			missReason = explained.reason;
+			if (explained.previousHash && explained.changedNames.length) logWriter().write(fingerprintDiffRecord({
+				changed: explained.changedNames,
+				previousHash: explained.previousHash,
+				hash: current.hash
+			}));
+		}
+		buildFailure = {
+			...buildFailure,
+			missReason
+		};
+		phase("cache", `miss: ${missReason.summary}`);
+		if (missReason.kind === "no-baseline") {
+			const untracked = untrackedMissLine(d.untrackedNativeFiles({ projectRoot: root }));
+			if (untracked) note(chalk.dim(phaseLine("fingerprint", untracked)));
+		}
+	}
 	async function buildArtifact() {
 		buildFailure = {
 			fingerprint,
@@ -768,6 +791,7 @@ 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 = [];
+			const rekeyedBy = [];
 			const prebuild = d.planPrebuild(root, "ios", {
 				isExpo,
 				fingerprint,
@@ -845,6 +869,7 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 					};
 					note(chalk.yellow(phaseLine("fingerprint", `unavailable after ${mutatingSteps.join(", ")}; the build will be installed but not cached`)));
 				} else if (after.moved) {
+					rekeyedBy.push(...mutatingSteps.map((mutation) => mutation === "prebuild" ? mutation : "pod install"));
 					storeHash = after.hash;
 					storeSources = after.sources;
 					storeKey = buildCacheKey("ios", after.hash, {
@@ -853,6 +878,11 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 						isSimulator: !physical,
 						...buildProfile ? { buildProfile } : {}
 					});
+					buildFailure = {
+						...buildFailure,
+						fingerprint: storeHash,
+						cacheKey: storeKey
+					};
 					note(chalk.dim(phaseLine("fingerprint", `${shortHash(fingerprint)} -> ${shortHash(storeHash)} (after ${mutatingSteps.join(", ")})`)));
 					const late = useBuildCache ? d.resolveBuild("ios", storeKey) : null;
 					if (late) {
@@ -870,6 +900,7 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 				}
 			}
 			if (!appPath) {
+				explainMiss(rekeyedBy);
 				step("compile");
 				phase("build", `compiling ${configuration || "Debug"} with xcodebuild`);
 				const result = await d.buildIos({
@@ -960,10 +991,17 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 				hit: cacheHit,
 				providerName: remote?.name ?? providerName,
 				readEnabled: useBuildCache,
+				missReason: cacheHit ? null : missReason,
 				waitedForBuild,
 				compilation: compilationCache
 			},
-			failureFields: buildFailure,
+			failureFields: {
+				...buildFailure,
+				fingerprint: storeHash,
+				cacheKey: storeKey,
+				cacheHit,
+				cacheSkipped: !useBuildCache
+			},
 			completeUploads: async () => {
 				const uploadWasAbandoned = await finishIosUpload(uploadPending, remote, phase, note);
 				const outcome = providerUploadOutcome(providerUpload ? await providerUpload : null, providerName);
@@ -1499,7 +1537,7 @@ function collectorEntry() {
 }
 const COLLECTOR_EXIT_WAIT_MS = 2e3;
 const COLLECTOR_POLL_MS = 25;
-async function stopPreviousCollector({ root, slot = "default", kill = (pid, signal) => signalProcessTree(pid, signal), alive = pidExists, readState = readWorkspaceState, verify = verifyCollectorOwnership, waitMs = COLLECTOR_EXIT_WAIT_MS, note = (_line) => {} }) {
+async function stopPreviousCollector({ root, slot = "default", kill = (pid, signal) => signalProcessTree(pid, signal), alive = pidExists, readState = readWorkspaceState$1, 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;
@@ -1524,7 +1562,7 @@ async function stopPreviousCollector({ root, slot = "default", kill = (pid, sign
 	}
 	return { killed };
 }
-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) => {} }) {
+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$1, verify = verifyCollectorOwnership, waitMs = COLLECTOR_EXIT_WAIT_MS, note = (_line) => {} }) {
 	const { killed } = await stopPreviousCollector({
 		root,
 		slot,
@@ -1608,7 +1646,7 @@ const DEFAULT_DEPS = {
 	resolveProjectMetro,
 	startDevServer,
 	warmMetro,
-	readWorkspaceState,
+	readWorkspaceState: readWorkspaceState$1,
 	pidExists,
 	getConcurrencyLimits,
 	fingerprintProject,
@@ -1861,7 +1899,7 @@ function launchFailureRemedy(remoteDevice, udid, bundleId, logFile) {
 }
 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 { hit: cacheHit, providerName, readEnabled: useBuildCache, missReason, waitedForBuild, compilation: compilationCache } = cache;
 	const storeHash = cache.identity?.fingerprint ?? null;
 	const storeKey = cache.identity?.key ?? null;
 	const runCommand = nativeRunCommand("ios", slot, {
@@ -2219,6 +2257,7 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 			storeHash,
 			storeKey,
 			cacheHit,
+			missReason,
 			compilationCache,
 			useBuildCache,
 			waitedForBuild,
@@ -2236,6 +2275,144 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 	};
 }
 //#endregion
+//#region src/commands/ios/next-build.ts
+function note(line) {
+	console.error(line);
+}
+function runOnlyFlag(opts) {
+	if (isPhysicalDeviceRequest(opts.device)) return "--device";
+	if (opts.remote) return "--remote";
+	if (opts.wait !== void 0) return opts.wait === false ? "--no-wait" : "--wait";
+	if (opts.simulatorApp !== void 0) return "--simulator-app";
+	if (opts.metroCheck === false) return "--no-metro-check";
+	return null;
+}
+async function planIos(opts, d, schemeRefusal) {
+	const json = Boolean(opts.json);
+	const refuse = (refusal, lines = []) => refusePlan(refusal, json, lines);
+	const flag = runOnlyFlag(opts);
+	if (flag) return refuse(planFlagRefusal(flag));
+	const root = d.findProjectRoot(process.cwd());
+	if (!root) return refuse(NO_PROJECT_REFUSAL);
+	const projectProblem = appProjectProblem(root);
+	if (projectProblem) return refuse({
+		code: "STIM_NO_PROJECT",
+		...projectProblem
+	});
+	const settingsContext = {
+		projectPath: root,
+		gitCommonDir: d.gitCommonDir(root),
+		repoRoot: d.repoRoot(root)
+	};
+	const settings = d.resolveSettings(settingsContext);
+	const [shapeError, ...moreShapeErrors] = settingShapeErrors(settings);
+	if (shapeError) return refuse({
+		code: "STIM_BAD_ARG",
+		message: shapeError,
+		remedy: SETTING_SHAPE_REMEDY
+	}, moreShapeErrors);
+	let optimizations;
+	try {
+		optimizations = resolveOptimizations(settings);
+	} catch (error) {
+		return refuse({
+			code: "STIM_BAD_ARG",
+			message: error.message,
+			remedy: SETTING_SHAPE_REMEDY
+		});
+	}
+	const cacheProviderError = cacheProviderSettingError(settings);
+	if (cacheProviderError) note(chalk.yellow(phaseLine("cache", `${cacheProviderError} Using the local cache.`)));
+	const slot = opts.slot ?? "default";
+	const target = {
+		platform: "ios",
+		slot,
+		root,
+		projectKey: statsProjectKey({
+			root,
+			commonDir: settingsContext.gitCommonDir,
+			repoRoot: settingsContext.repoRoot
+		})
+	};
+	const isExpo = d.detectIsExpo(root);
+	const modelRefusal = deviceModelRefusal({
+		slot,
+		deviceTypeFlag: opts.deviceType,
+		runtimeFlag: opts.runtime,
+		deviceType: resolveDeviceType(opts.deviceType, settings),
+		runtime: resolveRuntime(opts.runtime, settings),
+		physical: false,
+		remoteBackend: remoteIosSetting(settings),
+		listRuntimes: d.listIosRuntimes
+	});
+	if (modelRefusal) return refuse(modelRefusal);
+	if (opts.easProfile !== void 0) {
+		const eas = await planEasDevelopmentBuild({
+			root,
+			platform: "ios",
+			profile: opts.easProfile,
+			note,
+			isExpo,
+			selectors: [opts.scheme, opts.configuration],
+			buildCache: opts.buildCache
+		});
+		if (!eas.ok) return refuse(eas);
+		return printPlan(planPayload(target, {
+			fingerprint: eas.fingerprint,
+			cacheKey: eas.cacheKey,
+			cacheHit: eas.buildId ? "remote" : false,
+			provider: "eas",
+			cacheSkipped: false,
+			prebuild: null,
+			refusal: eas.missing
+		}), json);
+	}
+	const refusal = schemeRefusal(root, opts.scheme, isExpo);
+	if (refusal) return refuse({
+		code: refusal.code,
+		message: refusal.message ?? "",
+		remedy: refusal.remedy ?? ""
+	});
+	const configuration = resolveConfiguration(opts.configuration, settings);
+	const buildProfile = optimizationBuildProfile("ios", optimizations);
+	const cachePolicy = artifactCachePolicy(optimizations, opts.buildCache !== false, isReleaseConfiguration(configuration));
+	let fingerprint;
+	try {
+		fingerprint = await d.fingerprintProject(root, { platform: "ios" });
+	} catch (error) {
+		note(chalk.dim(`Fingerprinting failed: ${error?.message || error}`));
+	}
+	if (!fingerprint?.hash) return refuse({
+		code: "STIM_NO_FINGERPRINT",
+		message: `Could not fingerprint ${root}: @expo/fingerprint produced no hash for it.`,
+		remedy: "Check the project native inputs and the @expo/fingerprint error above, then retry."
+	});
+	const cacheKey = buildCacheKey("ios", fingerprint.hash, {
+		scheme: opts.scheme,
+		...configuration ? { configuration } : {},
+		isSimulator: true,
+		...buildProfile ? { buildProfile } : {}
+	});
+	const plan = await planCachedBuild({
+		...target,
+		isExpo,
+		fingerprint: fingerprint.hash,
+		sources: fingerprint.sources ?? [],
+		cacheKey,
+		cachePolicy,
+		providerConfig: d.resolveCacheProviderConfig(settingsContext),
+		expoRemote: cachePolicy.remote && !buildProfile && !opts.scheme ? { runOptions: configuration ? { configuration } : null } : null
+	}, {
+		loadCacheProvider: d.loadCacheProvider,
+		loadProjectProvider: d.loadProjectProvider,
+		checkEasAuth: d.checkEasAuth,
+		resolveRemote: d.resolveRemote,
+		planPrebuild: d.planPrebuild,
+		note
+	});
+	printPlan(plan, json);
+}
+//#endregion
 //#region src/commands/ios.ts
 function writeNote(line) {
 	console.error(line);
@@ -2247,16 +2424,28 @@ 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. 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) => {
+	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("--plan", "Predict the next build without building, booting or installing: resolve the fingerprint, check the local then remote cache, and print the expected cache result and duration. Writes no Stim state.").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) => {
+		if (opts.plan) {
+			const d = {
+				...DEFAULT_DEPS,
+				...deps
+			};
+			await planIos(opts, d, (root, scheme, isExpo) => explicitSchemeRefusal(root, scheme, isExpo, d));
+			return;
+		}
 		const root = (deps.findProjectRoot ?? DEFAULT_DEPS.findProjectRoot)(process.cwd());
 		const run = (progress) => runIos({
 			...opts,
 			waitConflict: waitFlagConflict(process.argv)
 		}, deps, progress);
-		const completion = root ? await withWorkspaceProcessLock(workspaceDir(root), "native-run", async (claim) => {
+		const completion = root ? await withNativeBuildRun(root, {
+			command: "ios",
+			platform: "ios",
+			slot: opts.slot ?? "default"
+		}, async (claim) => {
 			recordWorkspaceUse(root);
 			const progress = startBuildProgress({
 				root,
@@ -2270,15 +2459,22 @@ function registerIos(program, deps = {}) {
 			} finally {
 				progress.clear();
 			}
-		}, {
-			external: true,
-			waitMs: 18e5,
-			declareSpawns: true
-		}) : await run();
-		if (!completion) process.exit(1);
+		}, { write: (line) => writeNote(chalk.dim(phaseLine("lock", line))) }) : await run();
+		if (!completion) process.exit(runCancellation() ? 130 : 1);
 		else if (completion.uploadsAbandoned) exitAfterFlush(0);
 	});
 }
+function unlessCancelled(result) {
+	if (!result.ok || !runCancellation()) return result;
+	return {
+		ok: false,
+		failure: {
+			code: "STIM_CANCELLED",
+			message: "before install"
+		},
+		compilationCache: result.artifact.cache.compilation
+	};
+}
 function explicitSchemeRefusal(root, scheme, isExpo, d) {
 	if (scheme === void 0) return null;
 	if (!scheme.trim()) return {
@@ -2412,6 +2608,15 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 	let compilationCache = COMPILATION_CACHE_NOT_RUN;
 	let reclaimed = [];
 	const fail = ({ code, message, remedy = null, lines = [], logPath = null, build = null, lease }) => {
+		({code, message, remedy, lines} = cancelledFailure("ios", {
+			code,
+			message
+		}) ?? {
+			code,
+			message,
+			remedy,
+			lines
+		});
 		releaseLease();
 		if (message) note(chalk.red(phaseLine("error", message)));
 		for (const line of lines) note(chalk.dim(phaseLine("", line)));
@@ -2794,7 +2999,6 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 	}
 	let artifact = null;
 	try {
-		const bootTimer = stepTimer(d.now);
 		const boot = () => physicalDevice ? Promise.resolve({
 			ok: true,
 			udid: physicalDevice.udid
@@ -2807,23 +3011,28 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 			ok: false,
 			reason: String(e?.message || e)
 		}));
-		bootPromise = (remoteDevice?.ctx.backend === "eas" ? d.ensureRemoteBootOwned({
-			root,
-			platform: "ios",
-			sessionName: ownedSessionName(remoteDevice.ctx.label),
-			startedAt,
-			boot,
-			createdSessionId: remoteDevice.createdSessionId,
-			abandonCreatedSession: remoteDevice.abandonCreatedSession,
-			webPreviewUrl: remoteDevice.webPreviewUrl,
-			writeState: d.writeWorkspaceState,
-			register: registerProject
-		}) : boot()).then((result) => {
-			bootDuration = bootTimer();
-			return result;
-		});
-		udid = device.deviceUdid ?? (await bootPromise)?.udid ?? "";
-		const acquiredArtifact = await acquireIosArtifact({
+		const startBoot = () => {
+			const bootTimer = stepTimer(d.now);
+			bootPromise = (remoteDevice?.ctx.backend === "eas" ? d.ensureRemoteBootOwned({
+				root,
+				platform: "ios",
+				sessionName: ownedSessionName(remoteDevice.ctx.label),
+				startedAt: new Date(d.now()).toISOString(),
+				boot,
+				createdSessionId: remoteDevice.createdSessionId,
+				abandonCreatedSession: remoteDevice.abandonCreatedSession,
+				webPreviewUrl: remoteDevice.webPreviewUrl,
+				writeState: d.writeWorkspaceState,
+				register: registerProject
+			}) : boot()).then((result) => {
+				bootDuration = bootTimer();
+				return result;
+			});
+			return bootPromise.then((result) => result?.udid ?? "");
+		};
+		const localBoot = remoteDevice ? null : startBoot();
+		udid = device.deviceUdid ?? await localBoot ?? "";
+		const acquiredArtifact = unlessCancelled(await acquireIosArtifact({
 			root,
 			logFile,
 			udid,
@@ -2855,13 +3064,17 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 				stats,
 				step: progress.step
 			}
-		}, d);
+		}, d));
 		if (!acquiredArtifact.ok) {
 			compilationCache = acquiredArtifact.compilationCache;
 			return fail(acquiredArtifact.failure);
 		}
 		artifact = acquiredArtifact.artifact;
 		compilationCache = artifact.cache.compilation;
+		if (!localBoot) {
+			progress.step("install");
+			udid = await startBoot();
+		}
 		if (physicalDevice) {
 			const acquired = await d.acquireRunLease({
 				root,