stim 1.25.0 → 1.27.0

package/dist/{launch-DscF1QfM.mjs → dependencies-BGokZ-Ng.mjs}

@@ -1,162 +1,50 @@
-import { o as cancellableSleep, t as getExecutor } from "./exec-VFRpu1iA.mjs";
-import { m as workspaceLogsDir } from "./paths-DQtTgsBf.mjs";
-import { B as deviceSlotFileKey, E as upsertProject, O as withConfigLockAsync, V as deviceSlotKey, p as getProject, u as getConcurrencyLimits, v as recordIosSchemeApprovals } from "./config-BZhXY15H.mjs";
-import { _ as stepTimer, c as launchErrorReport, i as formatDuration, l as phaseLine, n as appReadinessMessage, v as launchErrorPreview } from "./command-output-BBvS1H6v.mjs";
-import { f as writeWorkspaceStateAsync, r as readWorkspaceState } from "./workspace-state-CPSp3mav.mjs";
-import { K as resolveCacheProviderConfig, Pt as repoRootAsync, Ut as makeTemporaryDirectory, Wt as removeTemporaryEntry, X as resolveSettings, et as settingOriginScope, lt as detectProviders, rt as settingsLayers, yt as gitCommonDirAsync } from "./settings-B5tCoq9N.mjs";
-import { L as workspaceDevServerMode, f as projectRegistry, i as findProjectRoot, v as detectIsExpo, z as writeWorkspaceLaunchAsync } from "./project-BiC68mIp.mjs";
-import { o as workspaceLinks } from "./stim-desktop-DS0mzR8U.mjs";
-import { c as pidExists, d as resolveProjectMetro, f as signalProcessTree } from "./metro-1pJgCX4U.mjs";
-import { r as createNdjsonWriter } from "./ndjson-CgE_o3Dl.mjs";
-import { $t as RELEASE_VERIFY_WAIT_MS, Bt as bundleEntryPoint, Fn as readRemoteSimulatorArch, Ht as ensureMetroReachable, In as gateMetroOrigin, J as recordCapacityRefusal, K as readRunEstimates, Kn as loadProjectProvider, Kt as remoteIosDeps, On as launchIosApp, Qn as uploadRemote, Tn as iosAppProcess, Un as checkEasAuth, Ut as ensureRemoteBootOwned, X as recordRunStats, Xn as resolveEasCliBin, Xt as LAUNCH_FATAL, Yt as LAUNCH_BUNDLING, Zn as resolveRemote, Zt as LAUNCH_UNVERIFIED, _n as clearOtherUserApps, an as unverifiedLaunchLines, cn as verifyReleaseLaunch, in as unattributedLaunchLines, kn as restartedAppNote, nn as readCollectorRecords, pn as IOS_DEV_MENU_OFF_DEFAULTS_PLIST, qt as resolveRemoteContext, rn as readMetroRecords, sn as verifyLaunch, t as budgetGate, tn as isBundleProof, vn as devClientUrl, wn as installIosApp } from "./budget-HyShrIpL.mjs";
-import { L as acquireBuildSlot, z as releaseBuildSlot } from "./workspaces-C9w4aeXF.mjs";
-import { F as waitForBuild, M as acquireBuildLock, P as releaseBuildLock } from "./activity-BpjwrQXU.mjs";
-import { E as untrackedNativeFiles, b as storeBuild, d as fingerprintProject, y as resolveBuild } from "./build-cache-CKCzxzxA.mjs";
-import { d as listAllIosSims, h as listIosRuntimesAsync, r as clearIosAppData } from "./ios-BQzvJlzw.mjs";
-import { f as readBundleExecutable, m as resolveScheme, p as readBundleId } from "./xcode-CiIIDnuD.mjs";
-import { h as readPodState, m as podsAreStale, v as runPodInstall } from "./toolchain-VzLJzZ7O.mjs";
-import { n as readHostedIos, o as writeHostedIosAsync } from "./ios-state-CT9nV5SP.mjs";
-import { n as hostedMetroPortProbe } from "./hosted-native-BxTizGU2.mjs";
-import { n as prepareHostedIos, t as placeHostedIos } from "./hosted-ios-RtVcJH3u.mjs";
-import { n as verifyCollectorOwnership } from "./ownership-jxxz-19m.mjs";
-import { n as nativeRunCommand, r as siblingPlatformSlots, t as launchSlotScope } from "./slot-launch-QeuJMlnJ.mjs";
-import { c as startDevServer, g as detectBundleId } from "./start-YMpNwLhh.mjs";
+import { o as cancellableSleep, t as getExecutor, x as withDrainingCancellation } from "./exec-aULwtNly.mjs";
+import { f as writeWorkspaceStateAsync, k as workspaceLogsDir, r as readWorkspaceState } from "./workspace-state-BjqdjnJR.mjs";
+import { B as deviceSlotFileKey, E as upsertProject, O as withConfigLockAsync, V as deviceSlotKey, p as getProject, u as getConcurrencyLimits, v as recordIosSchemeApprovals } from "./config-Cn94Jc0g.mjs";
+import { _ as stepTimer, c as launchErrorReport, i as formatDuration, l as phaseLine, n as appReadinessMessage, v as launchErrorPreview } from "./command-output-Dj-WT4BP.mjs";
+import { $t as makeTemporaryDirectory, J as resolveCacheProviderConfig, Lt as repoRootAsync, Q as resolveSettings, at as settingsLayers, dt as detectProviders, en as removeTemporaryEntry, nt as settingOriginScope, xt as gitCommonDirAsync } from "./settings-BDVI8Ivc.mjs";
+import { L as workspaceDevServerMode, f as projectRegistry, i as findProjectRoot, v as detectIsExpo, z as writeWorkspaceLaunchAsync } from "./project-DYj-HVx6.mjs";
+import { o as workspaceLinks } from "./stim-desktop-CbWo21kb.mjs";
+import { c as pidExists, d as resolveProjectMetro, f as signalProcessTree } from "./metro-CvyD-xwe.mjs";
+import { i as createNdjsonWriter } from "./ndjson-Dy2W4vRa.mjs";
+import { An as checkEasAuth, At as ensureRemoteBootOwned, Bt as RELEASE_VERIFY_WAIT_MS, Cn as gateMetroOrigin, Dt as bundleEntryPoint, Gt as unattributedLaunchLines, Ht as isBundleProof, It as LAUNCH_BUNDLING, Jt as verifyLaunch, Kt as unverifiedLaunchLines, Ln as resolveEasCliBin, Lt as LAUNCH_FATAL, Nn as loadProjectProvider, Nt as remoteIosDeps, Pt as resolveRemoteContext, Rn as resolveRemote, Rt as LAUNCH_UNVERIFIED, Sn as readRemoteSimulatorArch, Ut as readCollectorRecords, Wt as readMetroRecords, Yt as verifyReleaseLaunch, an as devClientUrl, c as budgetGate, dn as installIosApp, en as IOS_DEV_MENU_OFF_DEFAULTS_PLIST, fn as iosAppProcess, gn as restartedAppNote, hn as launchIosApp, in as clearOtherUserApps, kt as ensureMetroReachable, zn as uploadRemote } from "./ccache-BWTze1Ls.mjs";
+import { at as recordRunStats, rt as recordCapacityRefusal, tt as readRunEstimates, xt as releaseBuildSlot, yt as acquireBuildSlot } from "./workspaces-DFbj07jp.mjs";
+import { B as readBundleExecutable, H as resolveScheme, O as runPodInstall, T as readPodState, V as readBundleId, w as podsAreStale } from "./toolchain-CbCG6C5Z.mjs";
+import { F as waitForBuild, M as acquireBuildLock, P as releaseBuildLock } from "./activity-Cd-ysFes.mjs";
+import { A as untrackedNativeFiles, C as resolveBuild, c as evictBuild, m as fingerprintProject, w as storeBuild } from "./build-cache-gBJ-WKzA.mjs";
+import { d as listAllIosSims, h as listIosRuntimesAsync, r as clearIosAppData } from "./ios-E26qSpkb.mjs";
+import { n as readHostedIos, o as writeHostedIosAsync } from "./ios-state-BZ03NFgF.mjs";
+import { n as hostedMetroPortProbe } from "./hosted-native-CdgaiuyP.mjs";
+import { i as prepareHostedIos, r as placeHostedIos } from "./phone-reverses-C9yAaKEv.mjs";
+import { n as verifyCollectorOwnership } from "./ownership-Bx-0cku-.mjs";
+import { n as nativeRunCommand, r as siblingPlatformSlots, t as launchSlotScope } from "./slot-launch-0l7RqSpr.mjs";
+import { a as discoverXcodeProject, r as buildIos } from "./react-native-build-DaK2IFyP.mjs";
+import { c as startDevServer, g as detectBundleId } from "./start-DrPwER_2.mjs";
 import { t as spawnEntry } from "./spawn-entry-jw19m8Nl.mjs";
-import { a as discoverXcodeProject, r as buildIos } from "./react-native-build-CwZB-agu.mjs";
-import { a as acquireRunLease, c as lostRefusal, d as runLease, s as lostLine, t as DEBUG_VERIFY_STEP_MS, u as releaseLeaseOnAbort } from "./device-lease-run-ogEeJ62K.mjs";
-import { r as checkDeviceCapacity } from "./device-capacity-ZYaRALv5.mjs";
-import { n as clearIosAdoptionPending } from "./device-ios-DkHBrmvH.mjs";
-import { i as deviceLabel, o as deviceShortName, t as appNameFromPath } from "./support-qKcbgmI5.mjs";
-import { a as sealAppForDevice, r as gateProfileForDevice } from "./ios-signing-4c_qXvQm.mjs";
-import { a as resolveEasDevelopmentBuild } from "./eas-build-CyDKNTBP.mjs";
-import { a as printNativeCrashReport, n as IOS_CRASH_REPORT_RETRY, o as simulatorConsolePaths, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-B1Mj_-7h.mjs";
-import { i as launchOutcomeRecord, n as ensureWorkspaceStorageSafely } from "./native-runtime-B9w_Qyz3.mjs";
-import { a as runPrebuild, n as planPrebuildAsync } from "./prebuild-JUaqOLpc.mjs";
-import { n as devClientTakesDevMenuParams, r as hasDevClient, t as devClientScheme } from "./dev-client-CHoXXZeg.mjs";
-import { n as automaticDevicePlacement, t as checkEasFallback } from "./eas-fallback-gaZi-dJL.mjs";
-import { n as ensureBooted, o as warmMetro, r as ensureOwnedDevice } from "./device-B9FqTBYW.mjs";
-import { t as selectFromPool } from "./device-pool-BIg8MU8l.mjs";
-import { o as reportIosResult } from "./ios-project-DCUDo06I.mjs";
-import { c as isWirelessIosDevice, i as iosDeviceProcess, l as listIosDevices, n as installIosDeviceApp, p as verifyIosDeviceReleaseLaunch, r as iosDeviceBounds, t as awaitIosDeviceLaunch, u as localNetworkPending } from "./ios-device-CKSvk0bu.mjs";
-import { i as swapJsBundle } from "./js-swap-Z9HbC4cj.mjs";
+import { a as acquireRunLease, c as lostRefusal, d as runLease, s as lostLine, t as DEBUG_VERIFY_STEP_MS, u as releaseLeaseOnAbort } from "./device-lease-run-DwsGfjUN.mjs";
+import { r as checkDeviceCapacity } from "./device-capacity-6LP7QsaA.mjs";
+import { n as clearIosAdoptionPending } from "./device-ios-534c14fz.mjs";
+import { i as deviceLabel, o as deviceShortName, t as appNameFromPath } from "./support-Be0UeVZU.mjs";
+import { a as sealAppForDevice, r as gateProfileForDevice } from "./ios-signing-BJzvDPfU.mjs";
+import { a as resolveEasDevelopmentBuild } from "./eas-build-CjNSWmjo.mjs";
+import { a as captureNativeCrashes, c as simulatorConsolePaths, i as bundleBindFailure, n as IOS_CRASH_REPORT_RETRY, s as printNativeCrashReport, t as errorDiagnostics } from "./error-diagnostics-snej9k4j.mjs";
+import { t as followHostedLaunchLogs } from "./hosted-logs-sync-Dg3qrZmV.mjs";
+import { a as runPrebuild, d as memoizedFingerprint, n as planPrebuildAsync } from "./prebuild-BDpToDgR.mjs";
+import { i as launchOutcomeRecord, n as ensureWorkspaceStorageSafely } from "./native-runtime-DqaIBO5w.mjs";
+import { n as devClientTakesDevMenuParams, r as hasDevClient, t as devClientScheme } from "./dev-client-BMca82xo.mjs";
+import { t as automaticDevicePlacement } from "./auto-placement-z-H5pJza.mjs";
+import { t as checkEasFallback } from "./eas-fallback-9fqb46kW.mjs";
+import { n as ensureBooted, o as warmMetro, r as ensureOwnedDevice } from "./device-tM41-TUq.mjs";
+import { t as selectFromPool } from "./device-pool-BnQqvs6o.mjs";
+import { s as reportIosResult } from "./ios-project-D8Jcy_br.mjs";
+import { c as isWirelessIosDevice, i as iosDeviceProcess, l as listIosDevices, n as installIosDeviceApp, p as verifyIosDeviceReleaseLaunch, r as iosDeviceBounds, t as awaitIosDeviceLaunch, u as localNetworkPending } from "./ios-device-C_QkIf1Z.mjs";
+import { i as swapJsBundle } from "./js-swap-Dg2a945i.mjs";
 import { mkdirSync, openSync, writeFileSync } from "node:fs";
 import { networkInterfaces } from "node:os";
 import { basename, join } from "node:path";
 import { ambientEnv, hostSimulatorArch } from "@stim-cli/core";
 import chalk from "chalk";
 import { loadCacheProvider } from "@stim-cli/cache";
-//#region src/engine/ios-lan.ts
-const IP_TXT = "ip.txt";
-function chooseLanAddress({ pinned = null, candidates }) {
-	const list = Array.isArray(candidates) ? candidates : [];
-	if (pinned) return {
-		address: pinned,
-		interfaceName: list.find((candidate) => candidate.address === pinned)?.interfaceName ?? null,
-		pinned: true,
-		candidates: list.length
-	};
-	const first = list[0];
-	if (!first) return null;
-	return {
-		address: first.address,
-		interfaceName: first.interfaceName,
-		pinned: false,
-		candidates: list.length
-	};
-}
-function lanOriginUrlFor(address, port) {
-	return `http://${address}:${port}`;
-}
-function ipTxtContents(address, port) {
-	return `${String(address).trim()}:${String(port).trim()}\n`;
-}
-function writeIpTxt(appPath, address, port, { write = writeFileSync } = {}) {
-	const path = join(appPath, IP_TXT);
-	write(path, ipTxtContents(address, port), "utf-8");
-	return path;
-}
-async function ensureLanReachable({ origin, metroPort, root, isExpo, logsDir, gateOrigin = gateMetroOrigin, readRecords = null }) {
-	const result = await gateOrigin({
-		origin,
-		metroPort,
-		platform: "ios",
-		entryPoint: bundleEntryPoint(root, isExpo),
-		readRecords: readRecords ?? (() => readMetroRecords(logsDir)),
-		isProof: isBundleProof
-	});
-	if (result.failed) return {
-		failed: result.reason ?? `${origin} is not this workspace's Metro.`,
-		remedy: `The phone reaches Metro at ${origin}, so that address has to serve THIS workspace's dev server. \`stim start\` prints the port it reserved. Set ios.lanHost in .stim.json when this Mac has several network interfaces and the phone shares one that is not the first.`
-	};
-	return { ok: true };
-}
-function copyAppAside(appPath, { exec = null, mkdtemp = () => makeTemporaryDirectory(appPath, "stim-ios-device-") } = {}) {
-	const e = exec || getExecutor();
-	const tmpDir = mkdtemp();
-	const copy = join(tmpDir, basename(appPath));
-	try {
-		e.runFile("cp", [
-			"-c",
-			"-R",
-			appPath,
-			copy
-		], { timeoutMs: "unbounded" });
-	} catch {
-		try {
-			removeTemporaryEntry(copy);
-			e.runFile("cp", [
-				"-R",
-				appPath,
-				copy
-			], { timeoutMs: "unbounded" });
-		} catch (error) {
-			removeTemporaryEntry(tmpDir);
-			throw error;
-		}
-	}
-	return {
-		tmpDir,
-		appPath: copy
-	};
-}
-//#endregion
-//#region src/engine/lan-address.ts
-const EN_INTERFACE = /^en(\d+)$/;
-const EXCLUDED_INTERFACE = /^(?:utun|bridge|awdl)/;
-const LINK_LOCAL = /^169\.254\./;
-function isIpv4(entry) {
-	return entry.family === "IPv4" || entry.family === 4;
-}
-function lanCandidates(interfaces) {
-	const ranked = [];
-	const seen = /* @__PURE__ */ new Set();
-	for (const [interfaceName, entries] of Object.entries(interfaces ?? {})) {
-		if (EXCLUDED_INTERFACE.test(interfaceName)) continue;
-		const en = EN_INTERFACE.exec(interfaceName);
-		for (const entry of entries ?? []) {
-			if (!entry || typeof entry !== "object" || !isIpv4(entry) || entry.internal === true) continue;
-			const address = typeof entry.address === "string" ? entry.address.trim() : "";
-			if (address === "" || LINK_LOCAL.test(address)) continue;
-			if (seen.has(address)) continue;
-			seen.add(address);
-			ranked.push({
-				interfaceName,
-				address,
-				rank: en ? 0 : 1,
-				index: en ? Number(en[1]) : 0
-			});
-		}
-	}
-	ranked.sort((a, b) => a.rank - b.rank || a.index - b.index || a.interfaceName.localeCompare(b.interfaceName) || a.address.localeCompare(b.address));
-	return ranked.map(({ interfaceName, address }) => ({
-		interfaceName,
-		address
-	}));
-}
-function hostLanCandidates(interfaces = networkInterfaces) {
-	return lanCandidates(interfaces());
-}
-//#endregion
 //#region src/commands/ios/collector.ts
 function collectorLogFile(root, slot) {
 	return join(workspaceLogsDir(root), `collector-${deviceSlotFileKey("ios", slot)}.log`);
@@ -250,109 +138,6 @@ async function replaceCollector({ root, slot = "default", udid, bundleId, appNam
 	};
 }
 //#endregion
-//#region src/commands/ios/dependencies.ts
-const DEFAULT_DEPS = {
-	projectRegistry,
-	automaticDevicePlacement,
-	checkEasFallback,
-	prepareHostedIos,
-	placeHostedIos,
-	hostedMetroPortProbe,
-	readHostedIos,
-	writeHostedIos: writeHostedIosAsync,
-	resolveEasDevelopmentBuild,
-	findProjectRoot,
-	resolveSettings,
-	settingsLayers,
-	settingOriginScope,
-	gitCommonDir: gitCommonDirAsync,
-	repoRoot: repoRootAsync,
-	detectBundleId,
-	detectIsExpo,
-	devClientScheme,
-	hasDevClient,
-	devClientTakesDevMenuParams,
-	getProject,
-	upsertProject: (...args) => withConfigLockAsync(() => upsertProject(...args)),
-	recordIosSchemeApprovals,
-	checkDeviceCapacity,
-	budgetGate,
-	ensureOwnedDevice,
-	listIosRuntimes: listIosRuntimesAsync,
-	listAllIosSims,
-	ensureBooted,
-	resolveRemoteContext,
-	remoteIosDeps,
-	readRemoteSimulatorArch,
-	hostSimulatorArch,
-	ensureMetroReachable,
-	ensureRemoteBootOwned,
-	detectProviders,
-	resolveProjectMetro,
-	startDevServer,
-	warmMetro,
-	readWorkspaceState,
-	pidExists,
-	getConcurrencyLimits,
-	fingerprintProject,
-	untrackedNativeFiles,
-	resolveBuild,
-	storeBuild,
-	resolveCacheProviderConfig,
-	loadCacheProvider,
-	acquireBuildLock,
-	releaseBuildLock,
-	waitForBuild,
-	acquireBuildSlot,
-	releaseBuildSlot,
-	loadProjectProvider,
-	checkEasAuth,
-	resolveEasCliBin,
-	resolveRemote,
-	uploadRemote,
-	planPrebuild: planPrebuildAsync,
-	runPrebuild,
-	readPodState,
-	podsAreStale,
-	runPodInstall,
-	buildIos,
-	discoverXcodeProject,
-	resolveScheme,
-	listIosDevices,
-	hostLanCandidates,
-	ensureLanReachable,
-	gateProfileForDevice,
-	sealAppForDevice,
-	installIosDeviceApp,
-	awaitIosDeviceLaunch,
-	acquireRunLease,
-	runLease,
-	selectFromPool,
-	releaseLeaseOnAbort,
-	iosDeviceProcess,
-	verifyIosDeviceReleaseLaunch,
-	readBundleId,
-	readBundleExecutable,
-	swapJsBundle,
-	installIosApp,
-	clearOtherUserApps,
-	clearIosAppData,
-	clearIosAdoptionPending,
-	launchIosApp,
-	verifyLaunch,
-	verifyReleaseLaunch,
-	ensureWorkspaceStorage: ensureWorkspaceStorageSafely,
-	replaceCollector,
-	stopPreviousCollector,
-	writeWorkspaceLaunch: writeWorkspaceLaunchAsync,
-	writeWorkspaceState: writeWorkspaceStateAsync,
-	createWriter: createNdjsonWriter,
-	recordStats: recordRunStats,
-	recordCapacityRefusal,
-	readEstimates: readRunEstimates,
-	now: () => Date.now()
-};
-//#endregion
 //#region src/commands/ios/launch.ts
 function iosProcessRuntime(prepare, kind = "process") {
 	return {
@@ -424,12 +209,12 @@ async function verifyIosProcessRun({ operation, root, slot, appPath, d, launched
 	note(chalk.yellow(phaseLine("", `${embeddedJavaScript ? "Release" : "Process"} readiness was not established. Run \`stim logs --errors\` for captured crash reports, or \`stim logs --source device\` for the full device output.`)));
 	return { state: crashes.length || processCheck?.reason === "exited" ? LAUNCH_FATAL : LAUNCH_UNVERIFIED };
 }
-async function verifyIosMetroRun({ operation, root, slot, appPath, d, launched, phase, note, metroCheck, logsDir, launchedAt, metroPort, isExpo, bundleId, udid, scheme, physical, appName, lanAddress, lanOrigin, remoteDevice, metroOrigin, enterActivity }) {
+async function verifyIosMetroRun({ operation, root, slot, appPath, d, launched, phase, note, metroCheck, logsDir, launchedAt, metroPort, isExpo, bundleId, udid, scheme, physical, appName, lanAddress, lanOrigin, remoteDevice, metroOrigin, enterActivity, hostedLogs }) {
 	const runCommand = nativeRunCommand("ios", slot, {
 		physical,
 		deviceId: udid
 	});
-	const readNativeCrashes = () => remoteDevice ? [] : captureNativeCrashes({
+	const readNativeCrashes = () => hostedLogs ? hostedLogs.readNativeCrashes() : remoteDevice ? [] : captureNativeCrashes({
 		root,
 		slot,
 		platform: "ios",
@@ -447,7 +232,8 @@ async function verifyIosMetroRun({ operation, root, slot, appPath, d, launched,
 		return running.state === "unknown" ? null : running.state === "running";
 	};
 	const siblings = metroCheck ? await siblingPlatformSlots(root, "ios", slot) : [];
-	const verification = metroCheck ? await d.verifyLaunch({
+	const verification = metroCheck ? await withDrainingCancellation(operation, operation?.signal, () => d.verifyLaunch({
+		signal: operation?.signal,
 		requireBundleResponse: true,
 		slot: launchSlotScope(root, slot),
 		appPid: physical || remoteDevice ? null : launched?.pid,
@@ -460,12 +246,14 @@ async function verifyIosMetroRun({ operation, root, slot, appPath, d, launched,
 		platform: "ios",
 		mode: workspaceDevServerMode(root, isExpo),
 		readNativeCrashes,
+		readDeviceRecords: hostedLogs?.readDeviceRecords,
+		deviceLogsThrough: hostedLogs?.deviceLogsThrough,
 		processAlive: remoteDevice ? null : physical ? deviceProcess : async () => {
 			if (launched?.pid) return d.pidExists(launched.pid);
 			const running = await iosAppProcess(udid, bundleId);
 			return running.state === "unknown" ? null : running.state === "running";
 		}
-	}) : {
+	})) : {
 		verified: false,
 		skipped: true
 	};
@@ -609,6 +397,27 @@ async function cleanAdoptedIosApps({ d, udid, bundleId, devClient, phase, note }
 	for (const failure of swept.failed) note(chalk.yellow(phaseLine("install", `could not remove ${failure}, left by the previous workspace`)));
 	return `Could not remove ${swept.failed.join(", ")}, left by the previous workspace.`;
 }
+async function evictUnbindableCacheHit({ d, root, slot, udid, bundleId, appPath, launchedAt, logsDir, cacheHit, providerName, storeKey, runCommand, local, logFields, operation }) {
+	if (!cacheHit || !storeKey || !bundleId || !local) return null;
+	const symbol = (await captureNativeCrashes({
+		root,
+		slot,
+		platform: "ios",
+		deviceId: udid,
+		appId: bundleId,
+		since: launchedAt,
+		appPath
+	}, logsDir, operation?.signal, operation?.env)).map(bundleBindFailure).find(Boolean);
+	if (!symbol || !await d.evictBuild("ios", storeKey)) return null;
+	const provider = cacheHit === "remote" || Boolean(providerName);
+	return {
+		code: "STIM_LAUNCH_FAILED",
+		message: `The cached app cannot start: dyld could not bind ${symbol} between two parts of the app itself.`,
+		remedy: `Stim removed the cache entry ${storeKey}${provider ? ", but the cache provider may still hold its copy" : ""}. Run \`${runCommand}\`${provider ? " with `--no-build-cache`" : ""} again to build the app fresh. If the fresh app crashes the same way, the project's own native code is the cause.`,
+		logPath: logsDir,
+		build: logFields
+	};
+}
 function installMayBeProven(adopting, parkedCacheKey, storeKey) {
 	return !adopting || !parkedCacheKey || parkedCacheKey === storeKey;
 }
@@ -639,8 +448,9 @@ async function recordIosReloadTarget({ d, root, physical, remoteDevice, bundleId
 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) {
+function launchFailureRemedy(remoteDevice, udid, bundleId, logFile, reason) {
 	if (remoteDevice) return remoteDevice.failureRemedy();
+	if (reason && /system shell .*probably crashed/.test(reason)) return `SpringBoard, the simulator's system shell, is not running, and only a reboot brings it back. Run \`stim stop\`, then \`stim ios\` again. Repeated crashes leave SpringBoard reports in ~/Library/Logs/DiagnosticReports.`;
 	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({ operation, output, projectBundleId, runtime, runtimePreparation, devicePlacement, artifact, d, root, slot, json, release, configuration, buildScheme, isExpo, metroCheck, metroPort, logsDir, logFile, device, udid, physical, wireless, lanAddress, lanOriginUrl, remoteDevice, bootPromise, bootDuration, bootPending, fail, phase, note, logWriter, elapsed, startedAt, closeWriter, lease, releaseLease, recordRun, reclaimed, devServer, enterPhase, enterActivity }) {
@@ -702,6 +512,27 @@ async function finishIosRun({ operation, output, projectBundleId, runtime, runti
 	let installSkipped = false;
 	let launched;
 	let launchedAt = d.now();
+	const evictUnbound = () => evictUnbindableCacheHit({
+		d,
+		root,
+		slot,
+		udid,
+		bundleId,
+		appPath,
+		launchedAt,
+		logsDir,
+		cacheHit,
+		providerName,
+		storeKey,
+		runCommand,
+		local: !physical && !remoteDevice,
+		logFields: {
+			...buildFailure,
+			appPath,
+			bundleId
+		},
+		operation
+	});
 	if (physical) {
 		const overWifi = await installsOverWifi(d, udid, wireless, note);
 		const bounds = iosDeviceBounds(overWifi);
@@ -929,10 +760,12 @@ async function finishIosRun({ operation, output, projectBundleId, runtime, runti
 				since: launchedAt,
 				appPath
 			}, logsDir, (line) => note(chalk.red(phaseLine("launch", line))), Boolean(remoteDevice), operation?.signal, operation?.env);
+			const evicted = await evictUnbound();
+			if (evicted) return fail(evicted);
 			return fail({
 				code: launched.code || "STIM_LAUNCH_FAILED",
 				message: launched.reason,
-				remedy: launchFailureRemedy(remoteDevice, udid, bundleId, logFile),
+				remedy: launchFailureRemedy(remoteDevice, udid, bundleId, logFile, launched.reason),
 				build: {
 					...buildFailure,
 					appPath,
@@ -995,25 +828,25 @@ async function finishIosRun({ operation, output, projectBundleId, runtime, runti
 		metroOrigin: typeof launched?.jsLocation === "string" ? launched.jsLocation : null,
 		enterActivity
 	});
-	if (launchState === "fatal") return fail({
-		code: "STIM_LAUNCH_FAILED",
-		message: "The app failed its launch readiness check.",
-		remedy: `Read the launch error above or run \`stim logs --errors\`. The full timeline is in ${logsDir}.`,
-		logPath: logsDir,
-		build: {
-			...buildFailure,
-			appPath,
-			bundleId
-		}
-	});
-	logWriter().write(runtime.kind === "process" ? {
-		src: "build",
-		level: launchState === "unverified" ? "warn" : "info",
-		event: launchState === "unverified" ? "launch_unverified" : "launch_verified",
-		msg: launchState === "unverified" ? `${bundleId} could not be verified as running` : `${bundleId} is running its native process`
-	} : launchOutcomeRecord({
+	if (launchState === "fatal") {
+		const evicted = await evictUnbound();
+		if (evicted) return fail(evicted);
+		return fail({
+			code: "STIM_LAUNCH_FAILED",
+			message: "The app failed its launch readiness check.",
+			remedy: `Read the launch error above or run \`stim logs --errors\`. The full timeline is in ${logsDir}.`,
+			logPath: logsDir,
+			build: {
+				...buildFailure,
+				appPath,
+				bundleId
+			}
+		});
+	}
+	logWriter().write(launchOutcomeRecord({
 		launchState,
 		release: runtime.kind === "embedded-js",
+		process: runtime.kind === "process",
 		bundleId,
 		configuration,
 		metroPort,
@@ -1072,4 +905,222 @@ async function finishIosRun({ operation, output, projectBundleId, runtime, runti
 	};
 }
 //#endregion
-export { collectorEntry as a, copyAppAside as c, DEFAULT_DEPS as i, lanOriginUrlFor as l, iosMetroRuntime as n, replaceCollector as o, iosProcessRuntime as r, chooseLanAddress as s, finishIosRun as t, writeIpTxt as u };
+//#region src/engine/ios-lan.ts
+const IP_TXT = "ip.txt";
+function chooseLanAddress({ pinned = null, candidates }) {
+	const list = Array.isArray(candidates) ? candidates : [];
+	if (pinned) return {
+		address: pinned,
+		interfaceName: list.find((candidate) => candidate.address === pinned)?.interfaceName ?? null,
+		pinned: true,
+		candidates: list.length
+	};
+	const first = list[0];
+	if (!first) return null;
+	return {
+		address: first.address,
+		interfaceName: first.interfaceName,
+		pinned: false,
+		candidates: list.length
+	};
+}
+function lanOriginUrlFor(address, port) {
+	return `http://${address}:${port}`;
+}
+function ipTxtContents(address, port) {
+	return `${String(address).trim()}:${String(port).trim()}\n`;
+}
+function writeIpTxt(appPath, address, port, { write = writeFileSync } = {}) {
+	const path = join(appPath, IP_TXT);
+	write(path, ipTxtContents(address, port), "utf-8");
+	return path;
+}
+async function ensureLanReachable({ origin, metroPort, root, isExpo, logsDir, gateOrigin = gateMetroOrigin, readRecords = null }) {
+	const result = await gateOrigin({
+		origin,
+		metroPort,
+		platform: "ios",
+		entryPoint: bundleEntryPoint(root, isExpo),
+		readRecords: readRecords ?? (() => readMetroRecords(logsDir)),
+		isProof: isBundleProof
+	});
+	if (result.failed) return {
+		failed: result.reason ?? `${origin} is not this workspace's Metro.`,
+		remedy: `The phone reaches Metro at ${origin}, so that address has to serve THIS workspace's dev server. \`stim start\` prints the port it reserved. Set ios.lanHost in .stim.json when this Mac has several network interfaces and the phone shares one that is not the first.`
+	};
+	return { ok: true };
+}
+function copyAppAside(appPath, { exec = null, mkdtemp = () => makeTemporaryDirectory(appPath, "stim-ios-device-") } = {}) {
+	const e = exec || getExecutor();
+	const tmpDir = mkdtemp();
+	const copy = join(tmpDir, basename(appPath));
+	try {
+		e.runFile("cp", [
+			"-c",
+			"-R",
+			appPath,
+			copy
+		], { timeoutMs: "unbounded" });
+	} catch {
+		try {
+			removeTemporaryEntry(copy);
+			e.runFile("cp", [
+				"-R",
+				appPath,
+				copy
+			], { timeoutMs: "unbounded" });
+		} catch (error) {
+			removeTemporaryEntry(tmpDir);
+			throw error;
+		}
+	}
+	return {
+		tmpDir,
+		appPath: copy
+	};
+}
+//#endregion
+//#region src/engine/lan-address.ts
+const EN_INTERFACE = /^en(\d+)$/;
+const EXCLUDED_INTERFACE = /^(?:utun|bridge|awdl)/;
+const LINK_LOCAL = /^169\.254\./;
+function isIpv4(entry) {
+	return entry.family === "IPv4" || entry.family === 4;
+}
+function lanCandidates(interfaces) {
+	const ranked = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const [interfaceName, entries] of Object.entries(interfaces ?? {})) {
+		if (EXCLUDED_INTERFACE.test(interfaceName)) continue;
+		const en = EN_INTERFACE.exec(interfaceName);
+		for (const entry of entries ?? []) {
+			if (!entry || typeof entry !== "object" || !isIpv4(entry) || entry.internal === true) continue;
+			const address = typeof entry.address === "string" ? entry.address.trim() : "";
+			if (address === "" || LINK_LOCAL.test(address)) continue;
+			if (seen.has(address)) continue;
+			seen.add(address);
+			ranked.push({
+				interfaceName,
+				address,
+				rank: en ? 0 : 1,
+				index: en ? Number(en[1]) : 0
+			});
+		}
+	}
+	ranked.sort((a, b) => a.rank - b.rank || a.index - b.index || a.interfaceName.localeCompare(b.interfaceName) || a.address.localeCompare(b.address));
+	return ranked.map(({ interfaceName, address }) => ({
+		interfaceName,
+		address
+	}));
+}
+function hostLanCandidates(interfaces = networkInterfaces) {
+	return lanCandidates(interfaces());
+}
+//#endregion
+//#region src/commands/ios/dependencies.ts
+const DEFAULT_DEPS = {
+	projectRegistry,
+	automaticDevicePlacement,
+	checkEasFallback,
+	prepareHostedIos,
+	placeHostedIos,
+	hostedMetroPortProbe,
+	readHostedIos,
+	writeHostedIos: writeHostedIosAsync,
+	resolveEasDevelopmentBuild,
+	findProjectRoot,
+	resolveSettings,
+	settingsLayers,
+	settingOriginScope,
+	gitCommonDir: gitCommonDirAsync,
+	repoRoot: repoRootAsync,
+	detectBundleId,
+	detectIsExpo,
+	devClientScheme,
+	hasDevClient,
+	devClientTakesDevMenuParams,
+	getProject,
+	upsertProject: (...args) => withConfigLockAsync(() => upsertProject(...args)),
+	recordIosSchemeApprovals,
+	checkDeviceCapacity,
+	budgetGate,
+	ensureOwnedDevice,
+	listIosRuntimes: listIosRuntimesAsync,
+	listAllIosSims,
+	ensureBooted,
+	resolveRemoteContext,
+	remoteIosDeps,
+	readRemoteSimulatorArch,
+	hostSimulatorArch,
+	ensureMetroReachable,
+	ensureRemoteBootOwned,
+	detectProviders,
+	resolveProjectMetro,
+	startDevServer,
+	warmMetro,
+	readWorkspaceState,
+	pidExists,
+	getConcurrencyLimits,
+	fingerprintProject,
+	memoizedFingerprint,
+	untrackedNativeFiles,
+	evictBuild,
+	resolveBuild,
+	storeBuild,
+	resolveCacheProviderConfig,
+	loadCacheProvider,
+	acquireBuildLock,
+	releaseBuildLock,
+	waitForBuild,
+	acquireBuildSlot,
+	releaseBuildSlot,
+	loadProjectProvider,
+	checkEasAuth,
+	resolveEasCliBin,
+	resolveRemote,
+	uploadRemote,
+	planPrebuild: planPrebuildAsync,
+	runPrebuild,
+	readPodState,
+	podsAreStale,
+	runPodInstall,
+	buildIos,
+	discoverXcodeProject,
+	resolveScheme,
+	listIosDevices,
+	hostLanCandidates,
+	ensureLanReachable,
+	gateProfileForDevice,
+	sealAppForDevice,
+	installIosDeviceApp,
+	awaitIosDeviceLaunch,
+	acquireRunLease,
+	runLease,
+	selectFromPool,
+	releaseLeaseOnAbort,
+	iosDeviceProcess,
+	verifyIosDeviceReleaseLaunch,
+	readBundleId,
+	readBundleExecutable,
+	swapJsBundle,
+	installIosApp,
+	clearOtherUserApps,
+	clearIosAppData,
+	clearIosAdoptionPending,
+	launchIosApp,
+	verifyLaunch,
+	verifyReleaseLaunch,
+	followHostedLaunchLogs,
+	ensureWorkspaceStorage: ensureWorkspaceStorageSafely,
+	replaceCollector,
+	stopPreviousCollector,
+	writeWorkspaceLaunch: writeWorkspaceLaunchAsync,
+	writeWorkspaceState: writeWorkspaceStateAsync,
+	createWriter: createNdjsonWriter,
+	recordStats: recordRunStats,
+	recordCapacityRefusal,
+	readEstimates: readRunEstimates,
+	now: () => Date.now()
+};
+//#endregion
+export { writeIpTxt as a, iosProcessRuntime as c, replaceCollector as d, lanOriginUrlFor as i, verifyIosMetroRun as l, chooseLanAddress as n, finishIosRun as o, copyAppAside as r, iosMetroRuntime as s, DEFAULT_DEPS as t, collectorEntry as u };