stim 1.10.1 → 1.11.0

package/dist/{dev-client-DExzPiOa.mjs → build-plan-CeAYgKAx.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 { 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 { S as sharedBuildCache, 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, c as gitCommonDirOnDisk } 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 { a as spawnDeclared } from "./spawn-claims-BJwXTMPt.mjs";
+import { t as withWorkspaceProcessLock } from "./workspace-process-lock-Cx74RSDZ.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-D5z2_bcF.mjs";
+import { N as storedSources, S as entryDir, x as diffFingerprintSources, y as artifactIn } from "./device-lease-D83nqeMX.mjs";
+import { D as listAvds, F as ownedAvdName, H as resolveOwnedAvdSerial, L as ownedAvdSystemImage, M as ownedAvdDeviceProfile, O as listInstalledSystemImages, P as ownedAvdMatchesConfiguration, S as getAvdNameForSerial, T as listAdbDevices, f as avdPoolConfiguration, g as createOwnedAvd, h as configureNewOwnedAvd, j as nextConsolePort, m as bootAndroidEmulator, q as waitForBoot, t as DEFAULT_AVD_DEVICE_PROFILE, u as assertOwnedAvdStopped, z as pickDefaultSystemImage } from "./android-C4zG2Tuc.mjs";
+import { l as androidDataPartitionSizeGbSetting, o as androidAvdConfigSetting, v as iosSimSlimProfileSetting } from "./settings-B5oFZEri.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-BiojdtAp.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-DArbmwer.mjs";
+import { o as estimateBuild } from "./build-progress-CDwogz6R.mjs";
+import { i as expoBinRefusal, r as expoBinPath, t as cleanLine } from "./server-expo-o6H5gcBc.mjs";
+import { N as easAuthNote } from "./device-remote-BQZSnnmE.mjs";
+import { r as LAUNCH_UNVERIFIED, t as LAUNCH_BUNDLING } from "./launch-verify-CuPDGXdr.mjs";
+import { a as liveOwnedDeviceCount, i as deviceTypeMismatch, t as reconcileSimSlim } from "./simslim-CIR3IYJO.mjs";
+import { s as startDevServer } from "./start-BSsf2tUs.mjs";
+import { r as readStats } from "./stats-BAgJaLA4.mjs";
+import { d as startBuildHeartbeat, f as tailLines, n as HEARTBEAT_INTERVAL_MS } from "./xcode-B5SPD--o.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-/, ""))
@@ -669,7 +677,9 @@ 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 requestedProfile = flags.deviceProfile || settings.android?.deviceProfile || null;
+	const deviceProfile = requestedProfile ?? DEFAULT_AVD_DEVICE_PROFILE;
+	const configuration = avdPoolConfiguration(androidDataPartitionSizeGbSetting(settings), avdConfig, deviceProfile);
 	if (record?.setupIncomplete && record.avdName) {
 		const avdName = record.avdName;
 		const cleanup = teardownAvd(avdName, {
@@ -689,6 +699,8 @@ async function ensureOwnedAndroidDevice({ record, projectPath, slot, settingsRoo
 	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 +715,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 +731,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)) {
@@ -780,7 +794,8 @@ async function ensureOwnedAndroidDevice({ record, projectPath, slot, settingsRoo
 					alive
 				}),
 				adopted: true,
-				systemImage
+				systemImage,
+				deviceProfile
 			};
 		}
 	}
@@ -790,6 +805,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),
@@ -817,7 +833,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 } = {}) {
@@ -1572,4 +1589,378 @@ 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 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;
+	if (!cacheHit) {
+		prebuild = deps.planPrebuild(root, platform, {
+			isExpo,
+			fingerprint,
+			sources
+		});
+		if (prebuild === "refuse") refusal = staleNativeDirRefusal(platform);
+	}
+	return planPayload(lookup, {
+		fingerprint,
+		cacheKey,
+		cacheHit,
+		provider,
+		cacheSkipped: !cachePolicy.read,
+		prebuild,
+		refusal
+	});
+}
+function planPayload({ platform, slot, projectKey }, found) {
+	const { refusal, ...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,
+		...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.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 };