stim 1.17.2 → 1.18.0

package/dist/offload-worker.d.mts

@@ -1,24 +1,10 @@
+import "./state-lKh8shBp.mjs";
+import { n as CcacheActivity, r as CompilationCacheActivity } from "./build-facts-DcLv2HSd.mjs";
 import "./ndjson-Du3j0AQ9.mjs";
-import "./state-B4PQFXMW.mjs";
-import { readFileSync } from "fs";
 import "@stim-cli/core/state";
+import { readFileSync } from "fs";
 import "@expo/fingerprint";
 import "@stim-cli/core/protocol";
-//#region src/engine/build-facts.d.ts
-interface CompilationCacheActivity {
-  status: "reported" | "unavailable" | "not-run";
-  hits: number | null;
-  cacheableTasks: number | null;
-  hitRatePercent: number | null;
-  swiftTargetsWithoutExplicitModules?: number;
-}
-interface CcacheActivity {
-  status: "reported" | "unavailable" | "not-run";
-  hits: number | null;
-  misses: number | null;
-  hitRatePercent: number | null;
-}
-//#endregion
 //#region src/optimizations.d.ts
 interface Optimizations {
   buildCache: boolean;

package/dist/offload-worker.mjs

@@ -1,16 +1,15 @@
-import { t as getExecutor } from "./exec-CaErVv7t.mjs";
+import { t as getExecutor } from "./exec-DWhCZDGm.mjs";
 import { n as stripAnsi } from "./process-output-Fpl8PYi8.mjs";
-import { D as fingerprintProject, M as refingerprintAfterMutation } from "./device-lease-DpoS36_u.mjs";
-import { T as CCACHE_UNAVAILABLE, d as buildIos, k as resolveCcache, o as workerToolchain, s as manifestDigest } from "./toolchain-DNyR3NPq.mjs";
-import { t as logLines } from "./run-CkE9y0nc.mjs";
-import { a as runPodInstall, n as podsAreStale, r as readPodState } from "./deps-iKw0eD4P.mjs";
-import { n as recordPrebuild, r as runPrebuild, t as planPrebuild } from "./prebuild-D7RUMkwN.mjs";
-import { a as gradlewPath, i as buildAndroid, r as assembleTaskFor } from "./gradle-dJpre3Yn.mjs";
-import { n as stageBundle, t as resolveBundleExtras } from "./stage-CzaiwFsI.mjs";
-import { d as podAction } from "./support-CsJNVfOc.mjs";
-import { createHash } from "node:crypto";
+import { D as fingerprintProject, M as refingerprintAfterMutation } from "./device-lease-Co-EwifR.mjs";
+import { F as resolveCcache, _ as buildIos, j as CCACHE_UNAVAILABLE, l as podsAreStale, o as workerToolchain, p as runPodInstall, s as manifestDigest, u as readPodState } from "./toolchain-Bnyd_K3A.mjs";
+import { n as recordPrebuild, r as runPrebuild, t as planPrebuild } from "./prebuild-juCyreaR.mjs";
+import { a as gradlewPath, i as buildAndroid, r as assembleTaskFor } from "./gradle-C6GKnunQ.mjs";
+import { d as podAction } from "./support-BaayeYCf.mjs";
+import { t as logLines } from "./run-vhtDgpHO.mjs";
+import { r as stageBundle, t as resolveBundleExtras } from "./stage-g_WqWeaE.mjs";
 import { chmodSync, constants, copyFileSync, cpSync, createReadStream, existsSync, lstatSync, mkdirSync, readFileSync, realpathSync, renameSync, rmSync, statSync, symlinkSync, writeFileSync } from "node:fs";
 import { basename, dirname, join } from "node:path";
+import { createHash } from "node:crypto";
 //#region src/offload/worker.ts
 function emit(value) {
 	process.stdout.write(`${JSON.stringify(value)}\n`);
@@ -582,7 +581,7 @@ async function compileAndroid(job, root, log, time) {
 }
 async function main() {
 	const mode = process.argv[2];
-	if (mode === "offer") return emit(workerToolchain());
+	if (mode === "offer") return emit(workerToolchain(process.argv[3] ?? null));
 	if (mode === "build") {
 		const chunks = [];
 		for await (const chunk of process.stdin) chunks.push(chunk);

package/dist/{ownership-DyRQru0q.mjs → ownership-D6Se7gg_.mjs}

@@ -1,6 +1,6 @@
-import { t as process_identity_exports } from "./process-identity-BmRm1qV0.mjs";
-import { o as pidExists } from "./metro-g8NqiJp-.mjs";
-import { c as writeWorkspaceState, o as withWorkspaceStateLock, r as readWorkspaceState } from "./workspace-state-DqcCbpE7.mjs";
+import { t as process_identity_exports } from "./process-identity-Biv3arCO.mjs";
+import { o as pidExists } from "./metro-Dh8T4Ytd.mjs";
+import { c as writeWorkspaceState, o as withWorkspaceStateLock, r as readWorkspaceState } from "./workspace-state-C59dqG-Z.mjs";
 import { realpathSync } from "node:fs";
 //#region src/collector/state.ts
 function collectorRoot(root) {

package/dist/{page-QF_Ke10s.mjs → page-Bv9s2KwY.mjs}

@@ -1,4 +1,4 @@
-import { t as process_identity_exports } from "./process-identity-BmRm1qV0.mjs";
+import { t as process_identity_exports } from "./process-identity-Biv3arCO.mjs";
 import { t as connectOwnedBrowser } from "./cdp-Dq_ypAlJ.mjs";
 //#region src/web/page.ts
 /** The record of a verified live browser: its supervisor and Chrome are the processes the record names. */

package/dist/placement-log-BcPhRwR4.mjs

@@ -0,0 +1,84 @@
+import { p as buildPlacementSettings } from "./client-DzhapoMB.mjs";
+//#region src/placement-log.ts
+/** `machine` is `local` when the run stays on this Mac. */
+function placementRecord(input) {
+	const { choice, fallback } = input;
+	const event = input.event ?? (input.kind === "build" ? "build_placement" : "device_placement");
+	const base = `${input.kind} placement: ${choice.machine} (${choice.msg})`;
+	return {
+		src: "placement",
+		level: fallback ? "warn" : "info",
+		...input,
+		event,
+		msg: fallback ? `${base}; fell back: ${fallback.msg}` : base
+	};
+}
+function skippedCandidates(skipped) {
+	return skipped.map(({ machine, code, reason }) => ({
+		machine,
+		code,
+		msg: reason
+	}));
+}
+function devicePlacementRecord({ platform, fromFlag, placed }) {
+	return placementRecord({
+		kind: "device",
+		platform,
+		settings: [{
+			key: `${platform}.remote`,
+			value: "auto",
+			from: fromFlag ? "flag" : "setting"
+		}],
+		candidates: skippedCandidates(placed.skipped),
+		choice: {
+			machine: placed.placement.machine ?? "local",
+			code: placed.code,
+			msg: placed.placement.reason
+		}
+	});
+}
+/**
+* The record for where a build runs. `stays` is the reason this Mac builds it, `chose` the remote Mac that takes it,
+* and `fallback` why a remote Mac that was meant to build it did not.
+*/
+function buildPlacementRecord({ platform, buildMachine, candidates = [], ...outcome }) {
+	const base = {
+		kind: "build",
+		platform,
+		settings: buildPlacementSettings(buildMachine),
+		candidates
+	};
+	if ("stays" in outcome) return placementRecord({
+		...base,
+		choice: {
+			machine: "local",
+			code: outcome.stays.code,
+			msg: outcome.stays.reason
+		}
+	});
+	if ("chose" in outcome) return placementRecord({
+		...base,
+		choice: {
+			machine: outcome.chose.machine,
+			code: "placed",
+			msg: outcome.chose.reason
+		}
+	});
+	const { code, reason, machine } = outcome.fallback;
+	return placementRecord({
+		...base,
+		event: outcome.event ?? "build_placement",
+		choice: {
+			machine: "local",
+			code,
+			msg: "building on this Mac"
+		},
+		fallback: {
+			code,
+			msg: reason,
+			...machine ? { machine } : {}
+		}
+	});
+}
+//#endregion
+export { devicePlacementRecord as n, buildPlacementRecord as t };

package/dist/{build-plan-BDsSi09V.mjs → plan-placement-CtxkCO54.mjs}

@@ -1,45 +1,46 @@
-import { t as getExecutor } from "./exec-CaErVv7t.mjs";
-import { D as withConfigLock$1, H as projectDeviceSlots, _ as loadConfig$1, a as clearDevice, b as releaseAndroidConsolePort, i as clearAndroidBootPending, k as acquireAvdClaim, p as getProject, t as allConsolePortsAndSerials, w as setDevice, z as deviceSlotPlatforms } from "./config-D0DbpZtM.mjs";
-import { n as ownership_claim_exports } from "./process-identity-BmRm1qV0.mjs";
+import { n as ownership_claim_exports } from "./process-identity-Biv3arCO.mjs";
+import { t as getExecutor } from "./exec-DWhCZDGm.mjs";
 import { r as waitForChild, t as createLineReader } from "./process-output-Fpl8PYi8.mjs";
-import { i as formatDuration, l as phaseLine, m as shortHash, u as plural } from "./command-output-CDAIFD-8.mjs";
-import { Tt as removeTemporaryEntry, a as androidAvdConfigSetting, at as gitCommonDirOnDisk, c as androidDataPartitionSizeGbSetting, wt as makeTemporaryDirectory } from "./settings-Cfd-0r2d.mjs";
-import { u as ownedDeviceLabel } from "./project-D47Rh0ly.mjs";
-import { o as pidExists } from "./metro-g8NqiJp-.mjs";
-import { d as sharedBuildCache } from "./workspace-state-DqcCbpE7.mjs";
-import { o as peekBudget } from "./budget-DfcgFdQB.mjs";
-import { C as diffFingerprintSources, I as storedSources, w as entryDir, y as artifactIn } from "./device-lease-DpoS36_u.mjs";
-import { A as listAvds, B as ownedAvdSystemImage, E as getAvdNameForSerial, F as ownedAvdDeviceProfile, J as resolveOwnedAvdSerial, L as ownedAvdMatchesConfiguration, O as listAdbDevices, P as nextConsolePort, R as ownedAvdName, W as pickDefaultSystemImage, b as createOwnedAvd, f as assertOwnedAvdStopped, ft as parkedMaxSetting, g as avdPoolConfiguration, j as listInstalledSystemImages, n as OWNED_AVD_CONFIG_DEFAULTS, pt as readParked, st as adoptParked, t as DEFAULT_AVD_DEVICE_PROFILE, tt as waitForBoot, ut as isLegacyDeletionClaim, v as bootAndroidEmulator, y as configureNewOwnedAvd } from "./android-B_YNZy61.mjs";
-import { j as readHostMemoryPressure, u as listAllIosSims } from "./ios-DSfnPfse.mjs";
-import { _ as teardownParkedAvd, m as teardownOwnedAvd } from "./ownership-BMLqyBgJ.mjs";
-import { o as estimateBuild, p as readStats$1 } from "./build-progress-D0WkjCPd.mjs";
-import { b as tailLines, u as HEARTBEAT_INTERVAL_MS, y as startBuildHeartbeat } from "./toolchain-DNyR3NPq.mjs";
-import { t as cleanLine } from "./server-expo-CHTyXD0G.mjs";
-import { f as namedBuildMachine, m as resolveBuildMachine, v as hostingMachines } from "./client-SvBdgObD.mjs";
-import { a as call, o as connectHost } from "./hosted-client-Bp4knSwu.mjs";
-import { t as clearDeviceIdleShutdown } from "./idle-shutdown-IGyNV8Cr.mjs";
-import { i as countLiveOwnedDevices, n as DeviceAdmissionRefusal, p as withDeviceBootAdmission, s as peekDeviceSlots } from "./device-capacity-ZC4XSZ4R.mjs";
-import { i as staleNativeDirRefusal } from "./prebuild-D7RUMkwN.mjs";
-import { i as ensureOwnedIosDevice, r as ensureIosBooted } from "./device-ios-C2Um-XUR.mjs";
-import { r as readHostedNative, s as writeHostedNative } from "./ios-state-8L3lgum6.mjs";
-import { n as prepareHostedNative } from "./hosted-native-1Ebbig4w.mjs";
-import { a as easAuthNote } from "./remote-cache-Ci4DQYYj.mjs";
-import { t as reconcileSimSlim } from "./simslim-BWNrc3M3.mjs";
-import { randomUUID } from "node:crypto";
+import { i as formatDuration, l as phaseLine, m as shortHash, u as plural } from "./command-output-CBtzyIgF.mjs";
+import { D as withConfigLock$1, H as projectDeviceSlots, _ as loadConfig$1, a as clearDevice, b as releaseAndroidConsolePort, i as clearAndroidBootPending, k as acquireAvdClaim, p as getProject, t as allConsolePortsAndSerials, w as setDevice, z as deviceSlotPlatforms } from "./config-CgYMahz7.mjs";
+import { D as makeTemporaryDirectory, O as removeTemporaryEntry, c as gitCommonDirOnDisk } from "./worktree-CsKYexJM.mjs";
+import { u as ownedDeviceLabel } from "./project-C3ChRLZy.mjs";
+import { o as pidExists } from "./metro-Dh8T4Ytd.mjs";
+import { d as sharedBuildCache } from "./workspace-state-C59dqG-Z.mjs";
+import { B as readStats$1, M as estimateBuild, s as peekBudget } from "./budget-DIhL2BKx.mjs";
+import { E as teardownOwnedAvd, k as teardownParkedAvd } from "./workspaces-xXItD8Dj.mjs";
+import { C as diffFingerprintSources, I as storedSources, w as entryDir, y as artifactIn } from "./device-lease-Co-EwifR.mjs";
+import { A as listAvds, B as ownedAvdSystemImage, E as getAvdNameForSerial, F as ownedAvdDeviceProfile, J as resolveOwnedAvdSerial, L as ownedAvdMatchesConfiguration, O as listAdbDevices, P as nextConsolePort, R as ownedAvdName, W as pickDefaultSystemImage, b as createOwnedAvd, f as assertOwnedAvdStopped, ft as parkedMaxSetting, g as avdPoolConfiguration, j as listInstalledSystemImages, n as OWNED_AVD_CONFIG_DEFAULTS, pt as readParked, st as adoptParked, t as DEFAULT_AVD_DEVICE_PROFILE, tt as waitForBoot, ut as isLegacyDeletionClaim, v as bootAndroidEmulator, y as configureNewOwnedAvd } from "./android-DC3ZLuw0.mjs";
+import { M as readHostMemoryPressure, d as listAllIosSims } from "./ios-B3SbOWdw.mjs";
+import { a as androidAvdConfigSetting, c as androidDataPartitionSizeGbSetting } from "./settings-CQyMElEP.mjs";
+import { b as hostingMachines, g as resolveBuildMachine, m as namedBuildMachine } from "./client-DzhapoMB.mjs";
+import { t as clearDeviceIdleShutdown } from "./idle-shutdown-jjtxAn5C.mjs";
+import { i as countLiveOwnedDevices, n as DeviceAdmissionRefusal, p as withDeviceBootAdmission, s as peekDeviceSlots } from "./device-capacity-EUOOYr8T.mjs";
+import { E as tailLines, T as startBuildHeartbeat, g as HEARTBEAT_INTERVAL_MS } from "./toolchain-Bnyd_K3A.mjs";
+import { t as cleanLine } from "./server-expo-DoBHhuzK.mjs";
+import { a as call, o as connectHost } from "./hosted-client-C-rMtppF.mjs";
+import { r as readHostedNative, s as writeHostedNative } from "./ios-state-B2pES6Vs.mjs";
+import { n as prepareHostedNative } from "./hosted-native-DeeOG8xZ.mjs";
+import { a as easAuthNote } from "./remote-cache-BGg7aGIZ.mjs";
+import { t as reconcileSimSlim } from "./simslim-EHBQ2R4G.mjs";
+import { i as ensureOwnedIosDevice, r as ensureIosBooted } from "./device-ios-6MewKKnc.mjs";
+import { i as staleNativeDirRefusal } from "./prebuild-juCyreaR.mjs";
 import { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, rmSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, relative } from "node:path";
 import { LAST_BUILD_KEYS, isJsonObject, loadConfig, machineCapacity, parseHostedChoice, parseHostedNativeOffer, readWorkspaceState } from "@stim-cli/core/state";
-import { claimRemoveCommand, clearClaimChild, markClaimChildPending, processGroupAlive, releaseClaim, setClaimChild } from "@stim-cli/core/ownership-claim";
-import { captureProcessIdentity } from "@stim-cli/core/process-identity";
 import chalk from "chalk";
 import { isDeepStrictEqual } from "node:util";
+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 * as expoFingerprint from "@expo/fingerprint";
 import { resolveTieredBuild } from "@stim-cli/cache";
 import { request } from "node:http";
 //#region src/device-host/placement.ts
-function local$1(reason, skipped = []) {
+function local$1(code, reason, skipped = []) {
 	return {
 		kind: "local",
+		code,
 		reason,
 		skipped
 	};
@@ -50,6 +51,7 @@ function decideDevicePlacement(inputs) {
 			const reason = `recorded session on ${inputs.sticky.machine}`;
 			return {
 				kind: "host",
+				code: "sticky",
 				reason,
 				machines: [{
 					machine: inputs.sticky.machine,
@@ -60,6 +62,7 @@ function decideDevicePlacement(inputs) {
 		}
 		return {
 			kind: "local",
+			code: "sticky",
 			reason: "this workspace's device runs here",
 			skipped: []
 		};
@@ -69,21 +72,22 @@ function decideDevicePlacement(inputs) {
 	const cannotTake = !(max === 0 || count !== null && count < max) || queued > 0;
 	const usage = max > 0 ? `${count} of ${max} devices in use` : `${count} devices in use, no device cap`;
 	const localReason = count === null ? "cannot tell how many devices run here; local boot admission decides" : cannotTake ? `${usage}${queued ? `, ${queued} runs queued ahead` : ""}` : here.budgetRefusal ?? (here.memoryPressure !== "normal" ? `host memory pressure ${here.memoryPressure ?? "unknown"} here` : `load ${here.loadPerCore.toFixed(1)}/core here, ${usage}`);
-	if (!offers.length) return local$1("no remote Macs configured; " + localReason);
-	if (count === null) return local$1(localReason);
-	if (!cannotTake && here.memoryPressure === "normal" && !here.budgetRefusal && here.loadPerCore < here.maxLoadPerCore) return local$1(localReason);
+	if (!offers.length) return local$1("no-remote-mac", "no remote Macs configured; " + localReason);
+	if (count === null) return local$1("device-count-unknown", localReason);
+	if (!cannotTake && here.memoryPressure === "normal" && !here.budgetRefusal && here.loadPerCore < here.maxLoadPerCore) return local$1("this-mac-free", localReason);
 	const skipped = [];
 	const admitted = [];
 	offers.forEach((probe, index) => {
 		let reason = null;
+		let code = "unreachable";
 		if ("failure" in probe) reason = probe.failure;
 		else {
 			const { offer } = probe;
-			if (offer.declined !== null) reason = `declined: ${offer.declined}`;
-			else if (offer.platform !== platform || !offer.choice) reason = `no matching ${platform} device choice`;
-			else if (offer.resources.memoryPressure !== "normal") reason = "host memory pressure unknown or elevated";
-			else if (offer.capacity.available === 0) reason = "no hosted device capacity available";
-			else if (!cannotTake && (offer.resources.loadPerCore === null || offer.resources.loadPerCore >= here.loadPerCore)) reason = offer.resources.loadPerCore === null ? "host load unknown while this Mac has room" : "host is not less loaded than this Mac";
+			if (offer.declined !== null) [code, reason] = ["declined", `declined: ${offer.declined}`];
+			else if (offer.platform !== platform || !offer.choice) [code, reason] = ["no-matching-device", `no matching ${platform} device choice`];
+			else if (offer.resources.memoryPressure !== "normal") [code, reason] = ["memory", "host memory pressure unknown or elevated"];
+			else if (offer.capacity.available === 0) [code, reason] = ["no-capacity", "no hosted device capacity available"];
+			else if (!cannotTake && (offer.resources.loadPerCore === null || offer.resources.loadPerCore >= here.loadPerCore)) [code, reason] = ["load", offer.resources.loadPerCore === null ? "host load unknown while this Mac has room" : "host is not less loaded than this Mac"];
 			else admitted.push({
 				machine: probe.machine,
 				offer,
@@ -92,17 +96,19 @@ function decideDevicePlacement(inputs) {
 		}
 		if (reason) skipped.push({
 			machine: probe.machine,
+			code,
 			reason
 		});
 	});
 	admitted.sort((a, b) => Number(b.machine === buildMachine) - Number(a.machine === buildMachine) || (a.offer.resources.loadPerCore ?? Infinity) - (b.offer.resources.loadPerCore ?? Infinity) || b.offer.resources.memoryFreeBytes - a.offer.resources.memoryFreeBytes || a.index - b.index);
-	if (!admitted.length) return local$1(`${localReason}; no host admits${cannotTake && !noWait ? "; waiting locally if needed" : ""}`, skipped);
+	if (!admitted.length) return local$1("no-host-admits", `${localReason}; no host admits${cannotTake && !noWait ? "; waiting locally if needed" : ""}`, skipped);
 	const machines = admitted.map(({ machine, offer }) => ({
 		machine,
 		reason: `${localReason}; ${machine}${machine === buildMachine ? " is the explicit remote Mac," : ""} load ${offer.resources.loadPerCore === null ? "unknown" : offer.resources.loadPerCore.toFixed(1) + "/core"}`
 	}));
 	return {
 		kind: "host",
+		code: "placed",
 		machines,
 		reason: machines[0].reason,
 		skipped
@@ -160,7 +166,7 @@ async function probeHost(machine, platform, selectors) {
 		host?.connection.close();
 	}
 }
-function hosted(target, reason, skipped = []) {
+function hosted(target, code, reason, skipped = []) {
 	target.selection = {
 		selected: "auto",
 		reason
@@ -172,16 +178,18 @@ function hosted(target, reason, skipped = []) {
 			machine: target.host.machine,
 			reason
 		},
+		code,
 		skipped
 	};
 }
-function local(reason, skipped = []) {
+function local(code, reason, skipped = []) {
 	return {
 		target: null,
 		placement: {
 			decision: "local",
 			reason
 		},
+		code,
 		skipped
 	};
 }
@@ -200,6 +208,7 @@ async function automaticDevicePlacement({ root, slot, platform, selectors, build
 				machine: recorded.machine,
 				reason: recorded.reason ?? decideDevicePlacement({ sticky: { machine: recorded.machine } }).reason
 			},
+			code: "sticky",
 			skipped: [],
 			sticky: true
 		};
@@ -207,7 +216,7 @@ async function automaticDevicePlacement({ root, slot, platform, selectors, build
 	}
 	const devices = peek();
 	if (devices.localLive) return {
-		...local(decideDevicePlacement({ sticky: { local: true } }).reason),
+		...local("sticky", decideDevicePlacement({ sticky: { local: true } }).reason),
 		sticky: true
 	};
 	const entries = machines();
@@ -232,7 +241,7 @@ async function automaticDevicePlacement({ root, slot, platform, selectors, build
 		buildMachine,
 		noWait
 	});
-	if (early.kind === "local" && early.skipped.length === 0) return local(early.reason);
+	if (early.kind === "local" && early.skipped.length === 0) return local(early.code, early.reason);
 	const probes = await Promise.all(entries.map((machine) => probe(machine, platform, selectors)));
 	const decision = decideDevicePlacement({
 		platform,
@@ -241,9 +250,9 @@ async function automaticDevicePlacement({ root, slot, platform, selectors, build
 		buildMachine,
 		noWait
 	});
-	if (decision.kind === "local") return local(decision.reason, decision.skipped);
+	if (decision.kind === "local") return local(decision.code, decision.reason, decision.skipped);
 	const target = probes.find((each) => each.probe.machine === decision.machines[0].machine).target;
-	return hosted(target, decision.reason, decision.skipped);
+	return hosted(target, decision.code, decision.reason, decision.skipped);
 }
 function devicePlacementLine(placement, skipped) {
 	return `${placement.machine ?? "local"}, ${placement.reason}${placement.decision !== "hosted" && skipped.length ? "; " + skipped.map((each) => `${each.machine}: ${each.reason}`).join("; ") : ""}`;
@@ -891,7 +900,7 @@ async function ensureAndroidBooted({ device, deviceSlotWait, projectPath, slot,
 function didSetUpDevice(device, remote) {
 	return remote ? void 0 : Boolean(device.setup || device.booting);
 }
-async function ensureOwnedDevice({ platform, project, projectPath, slot, settingsRoot = projectPath, label = ownedDeviceLabel(projectPath), settings, flags = {}, note = () => {}, out = () => {}, logFile = null, alive = pidExists, configureAvd = configureNewOwnedAvd, teardownAvd = teardownOwnedAvd, reconcileIosSimulator = reconcileSimSlim }) {
+async function ensureOwnedDevice({ platform, project, projectPath, slot, settingsRoot = projectPath, label = ownedDeviceLabel(projectPath), settings, flags = {}, note = () => {}, out = () => {}, logFile = null, alive = pidExists, configureAvd = configureNewOwnedAvd, teardownAvd = teardownOwnedAvd, reconcileIosSimulator = reconcileSimSlim, simSnapshot }) {
 	clearDeviceIdleShutdown(projectPath, platform, slot);
 	if (slot && slot !== "default") label = `${label}-${slot}`;
 	const record = deviceSlotPlatforms(project, slot)?.[platform] ?? null;
@@ -905,7 +914,8 @@ async function ensureOwnedDevice({ platform, project, projectPath, slot, setting
 		flags,
 		note,
 		out,
-		reconcileIosSimulator
+		reconcileIosSimulator,
+		simSnapshot
 	});
 	return ensureOwnedAndroidDevice({
 		record,
@@ -1753,6 +1763,7 @@ function printPlan(plan, json) {
 	}
 	const slot = plan.slot ? ` [${plan.slot}]` : "";
 	console.log(phaseLine("plan", `${plan.platform}${slot} ${shortHash(plan.fingerprint)} -> ${cacheLine(plan)}`));
+	if (plan.placement) console.log(phaseLine("placement", plan.placement));
 	if (plan.missReason) console.log(phaseLine("cache", `miss: ${plan.missReason.summary}`));
 	if (plan.refusal) {
 		console.log(phaseLine("error", plan.refusal.message));
@@ -1782,4 +1793,67 @@ function planFlagRefusal(flag) {
 	};
 }
 //#endregion
-export { AvdRecoveryError as _, refusePlan as a, devicePlacementLine as b, skippedMissReason as c, refreshUpdatesManifestFile as d, swapJsBundle as f, AvdBootError as g, ensureOwnedDevice as h, printPlan as i, UPDATES_MANIFEST_NAME as l, ensureBooted as m, planFlagRefusal as n, explainBuildMiss as o, didSetUpDevice as p, planPayload as r, fingerprintErrorMissReason as s, planCachedBuild as t, detectEntryFile as u, warmMetro as v, automaticDevicePlacement as y };
+//#region src/device-host/plan-placement.ts
+/**
+* Where `--plan` assumes the next run puts its simulator or emulator, with no session, reservation or state write.
+* A named Mac, or the Mac a recorded session already holds, answers with the device its `device-host.offer` would
+* give; `auto` repeats the placement decision a run makes now and, when that stays on this Mac, notes any Mac
+* whose device would key differently. The result predicts the cache key only; a run reads its own device.
+*/
+async function planHostedDevice({ root, slot, platform, machine, selectors, sameKey, deps = {} }) {
+	const { automatic = automaticDevicePlacement, probe = probeHost, machines = hostingMachines } = deps;
+	const named = async (name) => {
+		const result = await probe(name, platform, selectors);
+		if ("failure" in result.probe) return {
+			kind: "unknown",
+			reason: `${name} did not give a ${platform} device (${result.probe.failure})`
+		};
+		const { choice, declined } = result.probe.offer;
+		if (!choice) return {
+			kind: "unknown",
+			reason: `${name} has no ${platform} device for this selection${declined ? ` (${declined})` : ""}`
+		};
+		return {
+			kind: "hosted",
+			choice,
+			placement: `on ${name}`
+		};
+	};
+	if (machine !== "auto") return named(machine);
+	try {
+		const recorded = readHostedNative(root, platform, slot)[slot];
+		if (recorded) return await named(recorded.machine);
+		const placed = await automatic({
+			root,
+			slot,
+			platform,
+			selectors,
+			noWait: false
+		}, {
+			read: () => ({}),
+			write: () => {}
+		});
+		if (placed.target) return {
+			kind: "hosted",
+			choice: placed.target.choice,
+			placement: `on ${placed.target.host.machine}, as auto would now`
+		};
+		const names = machines() ?? [];
+		const differs = (await Promise.all(names.map((name) => probe(name, platform, selectors)))).flatMap(({ probe: each }) => "offer" in each && each.offer.choice && sameKey(each.offer.choice) === false ? [each.machine] : []);
+		if (differs.length) return {
+			kind: "local",
+			placement: `this Mac; auto may use ${differs.join(", ")}, which builds for another architecture, so its key differs`
+		};
+		return {
+			kind: "local",
+			placement: names.length ? `this Mac; auto may use ${names.join(", ")}` : "this Mac"
+		};
+	} catch (error) {
+		return {
+			kind: "unknown",
+			reason: error.message
+		};
+	}
+}
+//#endregion
+export { AvdBootError as _, printPlan as a, automaticDevicePlacement as b, fingerprintErrorMissReason as c, detectEntryFile as d, refreshUpdatesManifestFile as f, ensureOwnedDevice as g, ensureBooted as h, planPayload as i, skippedMissReason as l, didSetUpDevice as m, planCachedBuild as n, refusePlan as o, swapJsBundle as p, planFlagRefusal as r, explainBuildMiss as s, planHostedDevice as t, UPDATES_MANIFEST_NAME as u, AvdRecoveryError as v, devicePlacementLine as x, warmMetro as y };

package/dist/{ports-4nYqxPWC.mjs → ports-BLTtfBq-.mjs}

@@ -1,6 +1,6 @@
-import { p as getProject } from "./config-D0DbpZtM.mjs";
-import { o as findCommandWorkspace } from "./project-D47Rh0ly.mjs";
-import { n as getNamedPort, t as clearNamedPorts } from "./named-ports-C8m8EQs2.mjs";
+import { p as getProject } from "./config-CgYMahz7.mjs";
+import { o as findCommandWorkspace } from "./project-C3ChRLZy.mjs";
+import { n as getNamedPort, t as clearNamedPorts } from "./named-ports-BFIz1Shz.mjs";
 //#region src/commands/ports.ts
 async function inProject(action) {
 	try {

package/dist/{prebuild-D7RUMkwN.mjs → prebuild-juCyreaR.mjs}

@@ -1,9 +1,9 @@
-import { t as getExecutor } from "./exec-CaErVv7t.mjs";
+import { t as getExecutor } from "./exec-DWhCZDGm.mjs";
 import { n as stripAnsi, r as waitForChild, t as createLineReader } from "./process-output-Fpl8PYi8.mjs";
-import { r as detectIsExpo } from "./project-D47Rh0ly.mjs";
-import { a as updateWorkspaceState, r as readWorkspaceState } from "./workspace-state-DqcCbpE7.mjs";
-import { a as spawnDeclared } from "./spawn-claims-D0XfSe8u.mjs";
-import { i as expoBinRefusal, r as expoBinPath } from "./server-expo-CHTyXD0G.mjs";
+import { i as detectIsExpo } from "./project-C3ChRLZy.mjs";
+import { a as updateWorkspaceState, r as readWorkspaceState } from "./workspace-state-C59dqG-Z.mjs";
+import { a as spawnDeclared } from "./spawn-claims-Kqiifsk2.mjs";
+import { i as expoBinRefusal, r as expoBinPath } from "./server-expo-DoBHhuzK.mjs";
 import { existsSync } from "node:fs";
 import { join } from "node:path";
 //#region src/engine/prebuild.ts