stim 1.10.1 → 1.12.0

package/dist/{dev-client-DExzPiOa.mjs → build-plan-CqntbR7b.mjs}

@@ -1,29 +1,35 @@
-import { H as projectDeviceSlots, O as acquireAvdClaim, S as setDevice, T as withConfigLock$1, g as loadConfig$1, i as clearDevice, t as allConsolePortsAndSerials, u as getConfigDir, v as releaseAndroidConsolePort, x as saveConfig, z as deviceSlotPlatforms } from "./config-BEq0Qw_a.mjs";
+import { B as deviceSlotPlatforms, C as setDevice, E as withConfigLock$1, S as saveConfig, U as projectDeviceSlots, _ as loadConfig$1, a as clearDevice, d as getConfigDir, i as clearAndroidBootPending, k as acquireAvdClaim, t as allConsolePortsAndSerials, y as releaseAndroidConsolePort } from "./config-0jCcMM0E.mjs";
 import { t as getExecutor } from "./exec-DK8KaVHK.mjs";
-import { g as updateWorkspaceState, i as pidExists, k as workspaceId, m as readWorkspaceState$1, s as resolveProjectMetro, x as ensureWorkspaceStorage } from "./metro-BWLOJ_Wr.mjs";
-import { D as makeTemporaryDirectory, O as removeTemporaryEntry } from "./worktree-BlizKDpZ.mjs";
-import { a as detectIsExpo, c as ownedDeviceLabel, s as isPackageResolvable } from "./project-BXZzOABt.mjs";
-import { n as spawnDeclared } from "./spawn-claims-CUleC2cM.mjs";
-import { t as withWorkspaceProcessLock } from "./workspace-process-lock-BXA96myD.mjs";
+import { S as sharedBuildCache, g as updateWorkspaceState, i as pidExists, k as workspaceId, m as readWorkspaceState$1, s as resolveProjectMetro, x as ensureWorkspaceStorage } from "./metro-Dzo30hvJ.mjs";
+import { D as makeTemporaryDirectory, O as removeTemporaryEntry, c as gitCommonDirOnDisk } from "./worktree-DeBQSVtR.mjs";
+import { a as isPackageResolvable, o as ownedDeviceLabel, r as detectIsExpo } from "./project-B8rbutVC.mjs";
+import { a as spawnDeclared } from "./spawn-claims-PT8aQpCa.mjs";
+import { t as withWorkspaceProcessLock } from "./workspace-process-lock-BvvJTfo_.mjs";
 import { n as stripAnsi, r as waitForChild, t as createLineReader } from "./process-output-Fpl8PYi8.mjs";
-import { l as phaseLine } from "./command-output-D5z2_bcF.mjs";
-import { E as listInstalledSystemImages, I as pickDefaultSystemImage, M as ownedAvdName, P as ownedAvdSystemImage, T as listAvds, W as waitForBoot, d as avdPoolConfiguration, h as createOwnedAvd, j as ownedAvdMatchesConfiguration, k as nextConsolePort, l as assertOwnedAvdStopped, m as configureNewOwnedAvd, p as bootAndroidEmulator, w as listAdbDevices, x as getAvdNameForSerial, z as resolveOwnedAvdSerial } from "./android-787HhP5w.mjs";
-import { l as androidDataPartitionSizeGbSetting, o as androidAvdConfigSetting, v as iosSimSlimProfileSetting } from "./settings-DOugPlPz.mjs";
-import { _ as dropParked, b as readParked, d as teardownOwnedAvd, g as adoptParked, m as teardownParkedIosSim, p as teardownParkedAvd, v as isLegacyDeletionClaim, x as selectParked, y as parkedMaxSetting } from "./ownership-BfPNRf3-.mjs";
-import { E as configuredIosSimulatorViewer, O as hostMemoryPressureAdvice, S as resolveOwnedIosSim, b as resetIosPrivacy, c as iosSimulatorFailureAdvice, d as listIosDeviceTypes, g as parseRuntimeVersion, k as readHostMemoryPressure, l as listAllIosSims, m as ownedSimName, n as bootIosSim, r as createOwnedIosSim, v as renameIosSim, x as resolveIosCreation, y as resetIosKeychain } from "./ios-COGcGEcN.mjs";
-import { i as expoBinRefusal, r as expoBinPath, t as cleanLine } from "./server-expo-BvOCeakp.mjs";
-import { r as LAUNCH_UNVERIFIED, t as LAUNCH_BUNDLING } from "./launch-verify-BhgkYAws.mjs";
-import { a as liveOwnedDeviceCount, i as deviceTypeMismatch, t as reconcileSimSlim } from "./simslim-DZUxzsjq.mjs";
-import { s as startDevServer } from "./start-RbmFPeZ7.mjs";
-import { d as startBuildHeartbeat, f as tailLines, n as HEARTBEAT_INTERVAL_MS } from "./xcode-B2tBkf0m.mjs";
-import { existsSync, mkdirSync, readFileSync, readdirSync } from "node:fs";
-import { isJsonObject, readIdleStop, readJsonObject } from "@stim-cli/core/state";
-import { basename, join } from "node:path";
+import { i as formatDuration, l as phaseLine, m as shortHash, u as plural } from "./command-output-BWCj5Vh-.mjs";
+import { N as storedSources, S as entryDir, x as diffFingerprintSources, y as artifactIn } from "./device-lease-B9LAXIUH.mjs";
+import { B as pickDefaultSystemImage, C as getAvdNameForSerial, E as listAdbDevices, F as ownedAvdMatchesConfiguration, I as ownedAvdName, M as nextConsolePort, N as ownedAvdDeviceProfile, O as listAvds, R as ownedAvdSystemImage, W as resolveOwnedAvdSerial, X as waitForBoot, _ as createOwnedAvd, d as assertOwnedAvdStopped, g as configureNewOwnedAvd, h as bootAndroidEmulator, k as listInstalledSystemImages, n as OWNED_AVD_CONFIG_DEFAULTS, p as avdPoolConfiguration, t as DEFAULT_AVD_DEVICE_PROFILE } from "./android-75Sk2rIR.mjs";
+import { l as androidDataPartitionSizeGbSetting, o as androidAvdConfigSetting, v as iosSimSlimProfileSetting } from "./settings-BlyDn2Oz.mjs";
+import { _ as dropParked, b as readParked, d as teardownOwnedAvd, g as adoptParked, m as teardownParkedIosSim, p as teardownParkedAvd, v as isLegacyDeletionClaim, x as selectParked, y as parkedMaxSetting } from "./ownership-B8d4kXBx.mjs";
+import { E as configuredIosSimulatorViewer, O as hostMemoryPressureAdvice, S as resolveOwnedIosSim, b as resetIosPrivacy, c as iosSimulatorFailureAdvice, d as listIosDeviceTypes, g as parseRuntimeVersion, k as readHostMemoryPressure, l as listAllIosSims, m as ownedSimName, n as bootIosSim, r as createOwnedIosSim, v as renameIosSim, x as resolveIosCreation, y as resetIosKeychain } from "./ios-CZWOHTTc.mjs";
+import { o as estimateBuild } from "./build-progress-h60GPV27.mjs";
+import { i as expoBinRefusal, r as expoBinPath, t as cleanLine } from "./server-expo-CeT1nIIk.mjs";
+import { a as easAuthNote } from "./remote-cache-BRsRZru5.mjs";
+import { r as LAUNCH_UNVERIFIED, t as LAUNCH_BUNDLING } from "./launch-verify-B2oR_kFN.mjs";
+import { a as liveOwnedDeviceCount, i as deviceTypeMismatch, t as reconcileSimSlim } from "./simslim-COtEEP7x.mjs";
+import { s as startDevServer } from "./start-BboE1HIS.mjs";
+import { r as readStats } from "./stats-D8rUTPHd.mjs";
+import { d as startBuildHeartbeat, f as tailLines, n as HEARTBEAT_INTERVAL_MS } from "./xcode-BzplpQzc.mjs";
+import { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync } from "node:fs";
+import { LAST_BUILD_KEYS, isJsonObject, loadConfig, readIdleStop, readJsonObject, readWorkspaceState } from "@stim-cli/core/state";
+import { basename, dirname, join, relative } from "node:path";
 import { claimRemoveCommand, clearClaimChild, markClaimChildPending, processGroupAlive, releaseClaim, setClaimChild } from "@stim-cli/core/ownership-claim";
 import { captureProcessIdentity } from "@stim-cli/core/process-identity";
 import { randomUUID } from "node:crypto";
 import chalk from "chalk";
 import { isDeepStrictEqual } from "node:util";
+import * as expoFingerprint from "@expo/fingerprint";
+import { resolveTieredBuild } from "@stim-cli/cache";
 import { request } from "node:http";
 //#region src/engine/metro-warmup.ts
 const WARMUP_TIMEOUT_MS = 6e4;
@@ -526,7 +532,7 @@ function findOtherOwner(avdName, projectPath, selectedSlot = "default") {
 	for (const [path, project] of Object.entries(loadConfig$1()?.projects ?? {})) if (projectDeviceSlots(project).some(({ slot, platforms }) => (path !== projectPath || slot !== selectedSlot) && platforms.android?.avdName?.toLowerCase() === avdName.toLowerCase())) return path;
 	return null;
 }
-async function prepareOwnedAvd({ projectPath, slot, label, previousAvdName, systemImage, configuration, configure, teardown = teardownOwnedAvd }) {
+async function prepareOwnedAvd({ projectPath, slot, label, previousAvdName, systemImage, deviceProfile, configuration, configure, teardown = teardownOwnedAvd }) {
 	const { claim, reservation, previous, avdName } = withConfigLock$1(() => {
 		const previous = deviceSlotPlatforms(loadConfig$1()?.projects?.[projectPath], slot)?.android;
 		if (previous?.avdName && previous.avdName !== previousAvdName) throw new Error(`Another Stim run assigned AVD ${previous.avdName} to this workspace. Retry to use it.`);
@@ -572,6 +578,7 @@ async function prepareOwnedAvd({ projectPath, slot, label, previousAvdName, syst
 		try {
 			const creation = await createOwnedAvd(label, {
 				systemImage,
+				deviceProfile,
 				spawn: (...args) => {
 					markClaimChildPending(claim);
 					child = getExecutor().spawn(...args);
@@ -607,6 +614,7 @@ async function prepareOwnedAvd({ projectPath, slot, label, previousAvdName, syst
 					avdName,
 					created: false,
 					systemImage: ownedAvdSystemImage(avdName),
+					deviceProfile: ownedAvdDeviceProfile(avdName),
 					...resolved.serial ? {
 						serial: resolved.serial,
 						consolePort: Number(resolved.serial.replace(/^emulator-/, ""))
@@ -633,7 +641,10 @@ async function prepareOwnedAvd({ projectPath, slot, label, previousAvdName, syst
 				avdName,
 				owned: true,
 				deviceName: avdName,
-				...prepared.created ? { poolConfiguration: configuration } : {},
+				...prepared.created ? {
+					poolConfiguration: configuration,
+					bootPending: true
+				} : {},
 				...prepared.consolePort ? { consolePort: prepared.consolePort } : {}
 			}, slot);
 		});
@@ -668,8 +679,13 @@ async function prepareOwnedAvd({ projectPath, slot, label, previousAvdName, syst
 const ANDROID_FRESH_BOOT_TIMEOUT_MS = process.platform === "win32" ? 12e5 : 12e4;
 const ANDROID_BOOT_TIMEOUT_MS = process.platform === "win32" ? 12e5 : 24e4;
 async function ensureOwnedAndroidDevice({ record, projectPath, slot, settingsRoot, label, settings, flags, note, out, logFile, alive, configureAvd, teardownAvd }) {
-	const avdConfig = androidAvdConfigSetting(settings, settingsRoot);
-	const configuration = avdPoolConfiguration(androidDataPartitionSizeGbSetting(settings), avdConfig);
+	const projectAvdConfig = androidAvdConfigSetting(settings, settingsRoot);
+	const avdConfig = {
+		...OWNED_AVD_CONFIG_DEFAULTS,
+		...projectAvdConfig
+	};
+	const requestedProfile = flags.deviceProfile || settings.android?.deviceProfile || null;
+	let replacedProfile = null;
 	if (record?.setupIncomplete && record.avdName) {
 		const avdName = record.avdName;
 		const cleanup = teardownAvd(avdName, {
@@ -686,9 +702,35 @@ async function ensureOwnedAndroidDevice({ record, projectPath, slot, settingsRoo
 		if (cleanup.status === "failed" || cleanup.status === "skipped") throw new AvdRecoveryError(`Owned AVD ${record.avdName} has incomplete setup and could not be deleted (${cleanup.reason || cleanup.status}). Fix the cause, then retry; Stim kept the device record for cleanup.`, "Wait for any active AVD operation to finish. If the refusal names an unresolved claim, inspect its creator and native processes before removing only that claim. Retry `stim android` to reconcile the incomplete device.");
 		record = null;
 	}
+	const requestedImage = flags.systemImageFlag || null;
+	const currentImage = requestedImage && record?.owned && record.avdName ? ownedAvdSystemImage(record.avdName) : null;
+	if (record?.avdName && requestedImage && currentImage && currentImage !== requestedImage) {
+		const avdName = record.avdName;
+		if (!record.bootPending) throw new AvdRecoveryError(`this project's emulator ${avdName} uses system image ${currentImage}, but ${requestedImage} was requested. --system-image replaces only an emulator that never finished a boot, and this one has.`, "Run `stim worktree remove` (or `stim gc --delete`) to reap the current emulator, then `stim android` again to create the requested one, or pass `--slot <name>` to create it beside the current one.");
+		replacedProfile = ownedAvdDeviceProfile(avdName);
+		const cleanup = teardownAvd(avdName, {
+			del: true,
+			owner: {
+				projectPath,
+				slot,
+				expectedRecord: record
+			},
+			onRemoved: () => {
+				clearDevice(projectPath, "android", slot, avdName);
+			}
+		});
+		if (cleanup.status === "failed" || cleanup.status === "skipped") throw new AvdRecoveryError(`Owned AVD ${avdName} never finished a boot, but could not be deleted to create one on ${requestedImage} (${cleanup.reason || cleanup.status}). Stim kept the device record.`, "Fix the cause, then retry, or pass `--slot <name>` to create the requested emulator beside it.");
+		out(phaseLine("device", `deleted ${avdName}, which never finished a boot, to create one on ${requestedImage}`));
+		record = null;
+	}
+	const deviceProfile = requestedProfile ?? replacedProfile ?? DEFAULT_AVD_DEVICE_PROFILE;
+	const configuration = avdPoolConfiguration(androidDataPartitionSizeGbSetting(settings), avdConfig, deviceProfile);
+	const configurationBeforeDefaults = avdPoolConfiguration(androidDataPartitionSizeGbSetting(settings), projectAvdConfig, deviceProfile);
 	if (record?.avdName) {
 		if (record.owned) {
 			const resolved = resolveOwnedAvdSerial(record.avdName);
+			const currentProfile = resolved.notOwned || resolved.missing ? null : ownedAvdDeviceProfile(record.avdName);
+			if (requestedProfile && currentProfile && currentProfile !== requestedProfile) throw new AvdRecoveryError(`this project's emulator uses device profile ${currentProfile}, but ${requestedProfile} was requested. Stim will not silently boot a different model.`, "Run `stim worktree remove` (or `stim gc --delete`) to reap the current emulator, then `stim android` again to create the requested one, or pass `--slot <name>` to create it beside the current one.");
 			if (resolved.notOwned) note(chalk.yellow(`Note: recorded AVD ${record.avdName} is not Stim-owned by name -- creating a fresh owned AVD instead of reusing it.`));
 			else if (resolved.serial) {
 				const consolePort = Number(resolved.serial.replace(/^emulator-/, ""));
@@ -703,7 +745,8 @@ async function ensureOwnedAndroidDevice({ record, projectPath, slot, settingsRoo
 				setDevice(projectPath, "android", updated, slot);
 				return {
 					...updated,
-					systemImage: ownedAvdSystemImage(record.avdName)
+					systemImage: ownedAvdSystemImage(record.avdName),
+					deviceProfile: currentProfile
 				};
 			} else if (!resolved.missing) {
 				out(chalk.dim(`Recorded port for owned AVD ${record.avdName} is not currently ours; booting it on a freshly allocated port...`));
@@ -718,7 +761,8 @@ async function ensureOwnedAndroidDevice({ record, projectPath, slot, settingsRoo
 						logFile,
 						alive
 					}),
-					systemImage: ownedAvdSystemImage(record.avdName)
+					systemImage: ownedAvdSystemImage(record.avdName),
+					deviceProfile: currentProfile
 				};
 			}
 		} else if (listAvds().includes(record.avdName)) {
@@ -734,7 +778,7 @@ async function ensureOwnedAndroidDevice({ record, projectPath, slot, settingsRoo
 	}
 	if (parkedMaxSetting("android").max > 0) {
 		const systemImage = pickDefaultSystemImage(listInstalledSystemImages(), { systemImage: flags.systemImage || settings.android?.systemImage })?.pkg;
-		const candidates = readParked("android").filter((entry) => entry.systemImage === systemImage && entry.configuration === configuration).toSorted((a, b) => a.parkedAt.localeCompare(b.parkedAt));
+		const candidates = readParked("android").filter((entry) => entry.systemImage === systemImage && (entry.configuration === configuration || entry.configuration === configurationBeforeDefaults)).toSorted((a, b) => a.parkedAt.localeCompare(b.parkedAt));
 		for (const parked of candidates) {
 			if (isLegacyDeletionClaim(parked.deletionClaim)) continue;
 			const resolved = resolveOwnedAvdSerial(parked.name);
@@ -750,7 +794,7 @@ async function ensureOwnedAndroidDevice({ record, projectPath, slot, settingsRoo
 				out(phaseLine("device", `kept parked ${parked.name}: ${String(error?.message || error)}`));
 				continue;
 			}
-			if (ownedAvdSystemImage(parked.name) !== systemImage || !ownedAvdMatchesConfiguration(parked.name, configuration)) {
+			if (ownedAvdSystemImage(parked.name) !== systemImage || !ownedAvdMatchesConfiguration(parked.name, parked.configuration)) {
 				const result = teardownParkedAvd(parked.name);
 				if (result.status === "failed") out(phaseLine("device", `kept ${parked.name}: ${result.reason}`));
 				continue;
@@ -759,7 +803,7 @@ async function ensureOwnedAndroidDevice({ record, projectPath, slot, settingsRoo
 				avdName: parked.name,
 				deviceName: parked.name,
 				owned: true,
-				poolConfiguration: configuration,
+				poolConfiguration: parked.configuration,
 				adoptionPending: true
 			};
 			if (!adoptParked({
@@ -769,6 +813,15 @@ async function ensureOwnedAndroidDevice({ record, projectPath, slot, settingsRoo
 				udid: parked.udid,
 				device: adopted
 			})) continue;
+			if (parked.configuration !== configuration) try {
+				configureAvd(parked.name, {
+					dataPartitionSizeGb: androidDataPartitionSizeGbSetting(settings),
+					avdConfig
+				});
+				adopted.poolConfiguration = configuration;
+			} catch (error) {
+				out(phaseLine("device", `${parked.name} keeps its old AVD settings: ${String(error?.message || error)}`));
+			}
 			return {
 				...await bootOwnedAvdOnFreshPort({
 					avdName: parked.name,
@@ -780,7 +833,8 @@ async function ensureOwnedAndroidDevice({ record, projectPath, slot, settingsRoo
 					alive
 				}),
 				adopted: true,
-				systemImage
+				systemImage,
+				deviceProfile
 			};
 		}
 	}
@@ -790,6 +844,7 @@ async function ensureOwnedAndroidDevice({ record, projectPath, slot, settingsRoo
 		label,
 		previousAvdName: record?.avdName,
 		systemImage: flags.systemImage || settings.android?.systemImage || void 0,
+		deviceProfile,
 		configuration,
 		configure: (avdName) => configureAvd(avdName, {
 			dataPartitionSizeGb: androidDataPartitionSizeGbSetting(settings),
@@ -808,7 +863,10 @@ async function ensureOwnedAndroidDevice({ record, projectPath, slot, settingsRoo
 	return {
 		...await bootOwnedAvdOnFreshPort({
 			avdName: created.avdName,
-			metadata: created.created ? { poolConfiguration: configuration } : void 0,
+			metadata: created.created ? {
+				poolConfiguration: configuration,
+				bootPending: true
+			} : void 0,
 			projectPath,
 			slot,
 			deviceName: created.avdName,
@@ -817,7 +875,8 @@ async function ensureOwnedAndroidDevice({ record, projectPath, slot, settingsRoo
 			alive
 		}),
 		created: created.created,
-		systemImage: created.systemImage
+		systemImage: created.systemImage,
+		deviceProfile: created.deviceProfile
 	};
 }
 function claimAndroidConsolePort({ projectPath, slot, avdName, deviceName, livePorts = [], metadata }, { lock = withConfigLock$1, recordedPorts = () => allConsolePortsAndSerials().androidConsolePorts, record = setDevice } = {}) {
@@ -826,6 +885,7 @@ function claimAndroidConsolePort({ projectPath, slot, avdName, deviceName, liveP
 		const claim = {
 			...metadata?.poolConfiguration ? { poolConfiguration: metadata.poolConfiguration } : {},
 			...metadata?.adoptionPending ? { adoptionPending: true } : {},
+			...metadata?.bootPending ? { bootPending: true } : {},
 			avdName,
 			consolePort,
 			owned: true,
@@ -863,8 +923,10 @@ async function bootOwnedAvdOnFreshPort({ avdName, metadata, projectPath, slot, d
 		if (result.failed) throw new AvdBootError(result.reason, result.remedy);
 		const running = getAvdNameForSerial(serial);
 		if (running && running !== avdName) throw new Error(`${serial} is running AVD ${running}, not this workspace's owned AVD ${avdName}; refusing to use it.`);
+		clearAndroidBootPending(projectPath, avdName, slot);
+		const { bootPending: _booted, ...booted } = claim;
 		return {
-			...claim,
+			...booted,
 			serial
 		};
 	} catch (error) {
@@ -943,17 +1005,22 @@ async function ensureAndroidBooted({ device, projectPath, slot, timeoutMs, out,
 		failed: true,
 		reason: `AVD ${device.avdName} is not Stim-owned by name; refusing to boot it.`
 	};
-	if (resolved.serial) return waitForAndroidBoot({
+	const avdName = device.avdName;
+	const booted = (result) => {
+		if (!result.failed) clearAndroidBootPending(projectPath, avdName, slot);
+		return result;
+	};
+	if (resolved.serial) return booted(await waitForAndroidBoot({
 		serial: resolved.serial,
 		timeoutMs,
 		out
-	});
+	}));
 	const freshSerial = `emulator-${device.consolePort}`;
-	if (device.owned && device.serial === freshSerial) return waitForAndroidBoot({
+	if (device.owned && device.serial === freshSerial) return booted(await waitForAndroidBoot({
 		serial: freshSerial,
 		timeoutMs,
 		out
-	});
+	}));
 	const claim = claimAndroidConsolePort({
 		projectPath,
 		slot,
@@ -983,7 +1050,7 @@ async function ensureAndroidBooted({ device, projectPath, slot, timeoutMs, out,
 		out
 	});
 	if (result.failed) releaseAndroidConsolePort(projectPath, claim.consolePort, slot);
-	return result;
+	return booted(result);
 }
 //#endregion
 //#region src/engine/device.ts
@@ -1572,4 +1639,413 @@ function hasDevClient(root) {
 	return isPackageResolvable(root, "expo-dev-client");
 }
 //#endregion
-export { isPhysicalDeviceRequest as _, swapJsBundle as a, warmMetro as b, runPrebuild as c, ensureOwnedDevice as d, AvdBootError as f, ensureWorkspaceStorageSafely as g, ensureDevServer as h, detectEntryFile as i, staleNativeDirRefusal as l, clearIosAdoptionPending as m, pickDevClientScheme as n, planPrebuild as o, AvdRecoveryError as p, schemesFromInfoPlist as r, recordPrebuild as s, devClientScheme as t, ensureBooted as u, launchOutcomeRecord as v, sleep$1 as y };
+//#region src/cache/miss-reason.ts
+const MISS_CHANGE_CAP = 20;
+function recordedBuilds(state, platform) {
+	const builds = [];
+	for (const value of [state?.[LAST_BUILD_KEYS[platform]], state?.lastBuild]) {
+		const record = value;
+		if (record?.platform !== platform) continue;
+		const startedAt = typeof record.startedAt === "string" ? record.startedAt : "";
+		if (typeof record.fingerprint === "string" && typeof record.cacheKey === "string") builds.push({
+			fingerprint: record.fingerprint,
+			cacheKey: record.cacheKey,
+			startedAt
+		});
+		const carried = record.missReason?.baseline;
+		if (typeof carried?.fingerprint === "string" && typeof carried.cacheKey === "string") builds.push({
+			fingerprint: carried.fingerprint,
+			cacheKey: carried.cacheKey,
+			startedAt
+		});
+	}
+	return builds;
+}
+function projectIdentity(root) {
+	let real;
+	try {
+		real = realpathSync.native(root);
+	} catch {
+		return null;
+	}
+	for (let dir = real;; dir = dirname(dir)) {
+		if (existsSync(join(dir, ".git"))) {
+			const common = gitCommonDirOnDisk(dir);
+			return common ? `${common}\n${relative(dir, real)}` : null;
+		}
+		if (dirname(dir) === dir) return null;
+	}
+}
+function findMissBaseline(root, platform, { readState = readWorkspaceState, projectRoots = () => Object.keys(loadConfig()?.projects ?? {}), identity = projectIdentity, sourcesOf = (p, key) => storedSources(p, key, sharedBuildCache()) } = {}) {
+	for (const build of recordedBuilds(readState(root), platform)) {
+		const sources = sourcesOf(platform, build.cacheKey);
+		if (sources) return {
+			fingerprint: build.fingerprint,
+			cacheKey: build.cacheKey,
+			sources,
+			from: "workspace"
+		};
+	}
+	const project = identity(root);
+	if (!project) return null;
+	const others = [];
+	for (const other of projectRoots()) {
+		if (other === root || identity(other) !== project) continue;
+		others.push(...recordedBuilds(readState(other), platform));
+	}
+	for (const build of others.toSorted((a, b) => (Date.parse(b.startedAt) || 0) - (Date.parse(a.startedAt) || 0))) {
+		const sources = sourcesOf(platform, build.cacheKey);
+		if (sources) return {
+			fingerprint: build.fingerprint,
+			cacheKey: build.cacheKey,
+			sources,
+			from: "project"
+		};
+	}
+	return null;
+}
+const CATEGORY_RANK = {
+	"native-dependency": 0,
+	"app-config": 1,
+	"config-plugin": 2,
+	package: 3,
+	"native-dir": 4,
+	file: 5,
+	"app-asset": 6,
+	other: 7,
+	"package-scripts": 8,
+	autolinking: 9
+};
+function packageIn(path) {
+	return [...path.matchAll(/(?:^|\/)node_modules\/((?:@[^/]+\/)?[^/]+)/g)].at(-1)?.[1] ?? null;
+}
+function describeChange({ name, change, reasons }) {
+	const pkg = packageIn(name);
+	if (name === "expoConfig" || reasons.includes("expoConfig")) return {
+		category: "app-config",
+		label: "app config changed"
+	};
+	if (pkg && reasons.some((reason) => /^(expo|rncore)Autolinking(Ios|Android)?$/.test(reason))) return {
+		category: "native-dependency",
+		label: `native dependency ${change}: ${pkg}`
+	};
+	if (pkg && reasons.includes("expoConfigPlugins")) return {
+		category: "config-plugin",
+		label: `config plugin ${change}: ${pkg}`
+	};
+	if (/^(expoAutolinkingConfig|rncoreAutolinkingConfig)(:|$)/.test(name)) return {
+		category: "autolinking",
+		label: "autolinking config changed"
+	};
+	if (name.startsWith("package:")) return {
+		category: "package",
+		label: `${name.slice(8)} ${change}`
+	};
+	if (name === "packageJson:scripts") return {
+		category: "package-scripts",
+		label: "package.json scripts changed"
+	};
+	if (reasons.includes("expoConfigExternalFile")) return {
+		category: "app-asset",
+		label: `app asset ${change}: ${name}`
+	};
+	if (reasons.includes("bareNativeDir")) return {
+		category: "native-dir",
+		label: `${name}/ ${change}`
+	};
+	if (reasons.length || name.includes("/") || name.includes(".")) return {
+		category: "file",
+		label: `${name} ${change}`
+	};
+	return {
+		category: "other",
+		label: `${name} ${change}`
+	};
+}
+function rekeyPrefix(rekeyedBy) {
+	return rekeyedBy.length ? `${rekeyedBy.join(" and ")} changed native inputs; ` : "";
+}
+function missReasonFromChanges({ changes, baseline, rekeyedBy = [] }) {
+	const prefix = rekeyPrefix(rekeyedBy);
+	if (!baseline) return {
+		kind: "no-baseline",
+		summary: `${prefix}no earlier build of this project in the cache to compare with`,
+		changes: [],
+		changeCount: 0,
+		baseline: null,
+		rekeyedBy
+	};
+	if (!changes.length) return {
+		kind: "same-sources",
+		summary: `${prefix}native inputs match the last build; no cached app for this configuration or target`,
+		changes: [],
+		changeCount: 0,
+		baseline,
+		rekeyedBy
+	};
+	const described = changes.map((change, index) => ({
+		change,
+		index,
+		...describeChange(change)
+	})).toSorted((a, b) => CATEGORY_RANK[a.category] - CATEGORY_RANK[b.category] || a.index - b.index);
+	const dependencyMoved = described.some((entry) => entry.category === "native-dependency");
+	const labels = [...new Set(described.filter((entry) => !(dependencyMoved && entry.category === "autolinking")).map((entry) => entry.label))];
+	const more = labels.length > 1 ? ` (+${labels.length - 1} more)` : "";
+	return {
+		kind: "changed",
+		summary: `${prefix}${labels[0]}${more}`,
+		changes: described.slice(0, MISS_CHANGE_CAP).map(({ change, category }) => ({
+			source: change.name,
+			change: change.change,
+			category
+		})),
+		changeCount: changes.length,
+		baseline,
+		rekeyedBy
+	};
+}
+function explainBuildMiss({ root, platform, current, rekeyedBy = [], baselineDeps, differ = expoFingerprint.diffFingerprints }) {
+	const baseline = findMissBaseline(root, platform, baselineDeps);
+	const changes = baseline ? diffFingerprintSources({
+		previous: baseline.sources,
+		previousHash: baseline.fingerprint,
+		current,
+		differ
+	}) : [];
+	return {
+		reason: missReasonFromChanges({
+			changes,
+			baseline: baseline ? {
+				fingerprint: baseline.fingerprint,
+				cacheKey: baseline.cacheKey,
+				from: baseline.from
+			} : null,
+			rekeyedBy
+		}),
+		changedNames: changes.map((change) => change.name),
+		previousHash: baseline?.fingerprint ?? null
+	};
+}
+function predictBuildMiss({ root, platform, current, prebuild }) {
+	const { reason } = explainBuildMiss({
+		root,
+		platform,
+		current
+	});
+	const baseline = reason.baseline && {
+		fingerprint: reason.baseline.fingerprint,
+		from: reason.baseline.from
+	};
+	if (!prebuild || !baseline) return {
+		...reason,
+		baseline
+	};
+	const dir = platform === "ios" ? "ios/" : "android/";
+	return {
+		...reason,
+		kind: "prebuild-pending",
+		summary: `${reason.summary} (before prebuild ${prebuild}s ${dir})`,
+		baseline
+	};
+}
+function skippedMissReason(summary) {
+	return {
+		kind: "cache-skipped",
+		summary,
+		changes: [],
+		changeCount: 0,
+		baseline: null,
+		rekeyedBy: []
+	};
+}
+function fingerprintErrorMissReason(message) {
+	return {
+		kind: "fingerprint-error",
+		summary: `fingerprinting failed: ${message}`,
+		changes: [],
+		changeCount: 0,
+		baseline: null,
+		rekeyedBy: []
+	};
+}
+//#endregion
+//#region src/commands/build-plan.ts
+const DISCARD = {
+	file: "",
+	written: 0,
+	dropped: 0,
+	lastError: null,
+	write: () => true,
+	close: () => ({
+		file: "",
+		written: 0,
+		dropped: 0,
+		lastError: null
+	})
+};
+async function providerHit({ root, platform, cacheKey, providerConfig }, deps) {
+	if (!providerConfig) return null;
+	let destinationDir;
+	try {
+		destinationDir = makeTemporaryDirectory(root, "stim-plan-");
+	} catch (error) {
+		deps.note(chalk.yellow(phaseLine("cache", `provider not checked: ${error?.message || error}`)));
+		return null;
+	}
+	try {
+		const found = await resolveTieredBuild({
+			local: {
+				resolve: () => null,
+				store: () => null
+			},
+			loadProvider: () => deps.loadCacheProvider({
+				projectRoot: root,
+				config: providerConfig
+			}),
+			target: {
+				projectRoot: root,
+				platform,
+				key: cacheKey
+			},
+			destinationDir,
+			warn: (_code, message) => deps.note(chalk.yellow(phaseLine("cache", message)))
+		});
+		return found ? found.providerName ?? "the cache provider" : null;
+	} finally {
+		removeTemporaryEntry(destinationDir);
+	}
+}
+async function expoRemoteHit(lookup, deps) {
+	if (!lookup.expoRemote) return null;
+	const { root, platform, isExpo, fingerprint } = lookup;
+	const loaded = await deps.loadProjectProvider(root, { isExpo });
+	if (loaded?.unavailable) {
+		deps.note(chalk.yellow(phaseLine("cache", `provider not usable: ${loaded.unavailable}`)));
+		return null;
+	}
+	if (!loaded?.provider) return null;
+	const name = loaded.name ?? "the build cache provider";
+	if (name === "eas") {
+		const auth = deps.checkEasAuth({
+			projectRoot: root,
+			owner: loaded.owner || null
+		});
+		const authNote = easAuthNote(auth);
+		if (authNote) deps.note(chalk.yellow(phaseLine("cache", authNote)));
+		if (auth?.code === "logged-out") return null;
+	}
+	const hit = await deps.resolveRemote({
+		provider: loaded.provider,
+		platform,
+		projectRoot: root,
+		fingerprintHash: fingerprint,
+		runOptions: lookup.expoRemote.runOptions,
+		logWriter: DISCARD
+	});
+	if (hit?.timedOut) deps.note(chalk.yellow(phaseLine("cache", `${name} did not answer; counted as a miss`)));
+	else if (hit?.failed) deps.note(chalk.yellow(phaseLine("cache", `${name} could not be used: ${hit.failed}`)));
+	return hit?.appPath ? name : null;
+}
+async function planCachedBuild(lookup, deps) {
+	const { root, platform, isExpo, fingerprint, sources, cacheKey, cachePolicy } = lookup;
+	let cacheHit = false;
+	let provider = null;
+	if (cachePolicy.read) {
+		if (artifactIn(entryDir(platform, cacheKey))) cacheHit = "local";
+		else {
+			provider = (cachePolicy.remote ? await providerHit(lookup, deps) : null) ?? await expoRemoteHit(lookup, deps);
+			if (provider) cacheHit = "remote";
+		}
+	}
+	let prebuild = null;
+	let refusal = null;
+	let missReason;
+	if (!cacheHit) {
+		prebuild = deps.planPrebuild(root, platform, {
+			isExpo,
+			fingerprint,
+			sources
+		});
+		if (prebuild === "refuse") refusal = staleNativeDirRefusal(platform);
+		else if (cachePolicy.read) missReason = predictBuildMiss({
+			root,
+			platform,
+			current: {
+				hash: fingerprint,
+				sources
+			},
+			prebuild: prebuild === "generate" || prebuild === "regenerate" ? prebuild : null
+		});
+	}
+	return planPayload(lookup, {
+		fingerprint,
+		cacheKey,
+		cacheHit,
+		provider,
+		cacheSkipped: !cachePolicy.read,
+		prebuild,
+		...missReason ? { missReason } : {},
+		refusal
+	});
+}
+function planPayload({ platform, slot, projectKey }, found) {
+	const { refusal, missReason, ...rest } = found;
+	const outcome = refusal ? null : found.cacheHit ? "hit" : "cold";
+	const estimate = outcome ? estimateBuild(readStats().record?.history?.[projectKey], platform, outcome, "prepare") : {
+		expectedMs: null,
+		basis: 0
+	};
+	return {
+		platform,
+		...slot === "default" ? {} : { slot },
+		...rest,
+		outcome,
+		expectedMs: estimate.expectedMs,
+		basis: estimate.basis,
+		...missReason ? { missReason } : {},
+		...refusal ? { refusal } : {}
+	};
+}
+function cacheLine(plan) {
+	if (plan.refusal) return `the build would refuse with ${plan.refusal.code}`;
+	if (plan.cacheHit === "local") return "local cache hit";
+	if (plan.cacheHit === "remote") return `remote cache hit (${plan.provider})`;
+	return `${plan.cacheSkipped ? "cache reads are off" : "cache miss"}: compiles${plan.prebuild === "generate" || plan.prebuild === "regenerate" ? `, ${plan.prebuild}s the native dir` : ""}`;
+}
+function printPlan(plan, json) {
+	if (json) {
+		console.log(JSON.stringify(plan));
+		return;
+	}
+	const slot = plan.slot ? ` [${plan.slot}]` : "";
+	console.log(phaseLine("plan", `${plan.platform}${slot} ${shortHash(plan.fingerprint)} -> ${cacheLine(plan)}`));
+	if (plan.missReason) console.log(phaseLine("cache", `miss: ${plan.missReason.summary}`));
+	if (plan.refusal) {
+		console.log(phaseLine("error", plan.refusal.message));
+		console.log(phaseLine("remedy", plan.refusal.remedy));
+		return;
+	}
+	console.log(phaseLine("expect", plan.expectedMs === null ? `unknown: no ${plan.outcome} run of this project is recorded yet` : `~${formatDuration(plan.expectedMs)} (median of ${plural(plan.basis, `${plan.outcome} run`)})`));
+}
+function refusePlan({ code, message, remedy }, json, lines = []) {
+	console.error(chalk.red(phaseLine("error", message)));
+	for (const line of lines) console.error(chalk.dim(phaseLine("", line)));
+	console.error(chalk.dim(phaseLine("remedy", remedy)));
+	console.error(chalk.red(phaseLine("failed", code)));
+	if (json) console.log(JSON.stringify({
+		code,
+		message,
+		remedy
+	}));
+	process.exitCode = 1;
+}
+const PLAN_ONLY_REMEDY = "Drop the flag to plan the owned simulator or emulator build, or run the command without --plan.";
+function planFlagRefusal(flag) {
+	return {
+		code: "STIM_BAD_ARG",
+		message: `${flag} does not apply to --plan, which predicts the next local build without choosing a device.`,
+		remedy: PLAN_ONLY_REMEDY
+	};
+}
+//#endregion
+export { ensureDevServer as C, sleep$1 as D, launchOutcomeRecord as E, warmMetro as O, clearIosAdoptionPending as S, isPhysicalDeviceRequest as T, staleNativeDirRefusal as _, refusePlan as a, AvdBootError as b, skippedMissReason as c, schemesFromInfoPlist as d, detectEntryFile as f, runPrebuild as g, recordPrebuild as h, printPlan as i, devClientScheme as l, planPrebuild as m, planFlagRefusal as n, explainBuildMiss as o, swapJsBundle as p, planPayload as r, fingerprintErrorMissReason as s, planCachedBuild as t, pickDevClientScheme as u, ensureBooted as v, ensureWorkspaceStorageSafely as w, AvdRecoveryError as x, ensureOwnedDevice as y };