stim 1.19.0 → 1.20.1

package/dist/{ios-DCrkgXEM.mjs → ios-VGvNdsv2.mjs}

@@ -1,4 +1,4 @@
-import { t as getExecutor } from "./exec-i8GDPwq9.mjs";
+import { t as getExecutor } from "./exec-B81Qodjn.mjs";
 //#region src/collector/ios.ts
 const MESSAGE_TYPE_LEVEL = {
 	Debug: "debug",

package/dist/{ios-device-CrW8aMb5.mjs → ios-device-B1B14xND.mjs}

@@ -1,4 +1,4 @@
-import { t as getExecutor } from "./exec-i8GDPwq9.mjs";
+import { t as getExecutor } from "./exec-B81Qodjn.mjs";
 //#region src/collector/ios-device.ts
 const CONSOLE_ENV = { OS_ACTIVITY_DT_MODE: "enable" };
 const DEV_MENU_LAUNCH_ARGS = [

package/dist/{ios-device-CJ_ZOGky.mjs → ios-device-BWHKGaJq.mjs}

@@ -1,6 +1,6 @@
-import { t as getExecutor } from "./exec-i8GDPwq9.mjs";
-import { i as INSTALL_ERROR } from "./app-install-CFI4ptUL.mjs";
-import { n as TOOL_ERROR_PREFIX } from "./ios-device-CrW8aMb5.mjs";
+import { t as getExecutor } from "./exec-B81Qodjn.mjs";
+import { n as TOOL_ERROR_PREFIX } from "./ios-device-B1B14xND.mjs";
+import { i as INSTALL_ERROR } from "./app-install-Cg9YJy3x.mjs";
 import { mkdtempSync, readFileSync, rmSync } from "node:fs";
 import { join } from "node:path";
 import { tmpdir } from "node:os";

package/dist/{ios-BWbHFZVz.mjs → ios-o896T9PE.mjs}

@@ -1,14 +1,14 @@
-import { t as getExecutor } from "./exec-i8GDPwq9.mjs";
+import { t as getExecutor } from "./exec-B81Qodjn.mjs";
+import { _ as loadConfig$1, j as formatBytes } from "./config-D0LhTY3S.mjs";
 import { n as stripAnsi, r as waitForChild, t as createLineReader } from "./process-output-Fpl8PYi8.mjs";
-import { _ as loadConfig$1 } from "./config-DC5jEtd1.mjs";
-import { r as recordCreatedDevice, t as forgetCreatedDevice } from "./created-devices-D0s26Hx5.mjs";
-import { at as isStimOwnedSim } from "./android-BdQC6zs1.mjs";
-import { n as settingDefault, t as STIM_DESKTOP_OPEN_OPTIONS } from "./stim-desktop-C65jk_q2.mjs";
+import { n as settingDefault, t as STIM_DESKTOP_OPEN_OPTIONS } from "./stim-desktop-8GQX2OV8.mjs";
+import { it as isStimOwnedSim } from "./android-DE8-JfGW.mjs";
+import { r as recordCreatedDevice, t as forgetCreatedDevice } from "./created-devices-CXBMtoj5.mjs";
 import { closeSync, existsSync, lstatSync, mkdtempSync, openSync, readSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import { dirname, isAbsolute, join, resolve } from "node:path";
-import { IOS_SIMULATOR_APPS, settingDefinition } from "@stim-cli/core/state";
-import { tmpdir } from "node:os";
+import { IOS_SIMULATOR_APPS, isJsonObject, settingDefinition } from "@stim-cli/core/state";
 import { createHash } from "node:crypto";
+import { tmpdir, totalmem } from "node:os";
 //#region src/engine/installed-artifact.ts
 const READ_CHUNK_BYTES = 1048576;
 const DEVICE_PATH_TIMEOUT_MS = 3e4;
@@ -139,6 +139,136 @@ function deviceHoldsBundle({ udid, bundleId, appPath }, { exec = null } = {}) {
 	return artifactsMatch(hashBundle(appPath), installed);
 }
 //#endregion
+//#region src/memory-culprits.ts
+const GIB = 1024 ** 3;
+const UNITS = {
+	B: 1,
+	K: 1024,
+	M: 1024 ** 2,
+	G: GIB,
+	T: 1024 * GIB
+};
+const GENERAL_FLOOR_BYTES = 8 * GIB;
+const GENERAL_SHARE_OF_RAM = .25;
+const TOP_ROWS = 20;
+const GRADLE_DAEMON = /\borg\.gradle\.launcher\.daemon\.bootstrap\.GradleDaemon\b/;
+const KOTLIN_DAEMON = /\bKotlinCompileDaemon\b/;
+const GRADLE_NOTE = "Stim stops only idle daemons; the next build starts a new one.";
+const RESTARTABLE = [
+	{
+		name: "fseventsd",
+		matches: ({ name }) => name === "fseventsd",
+		bytes: 2 * GIB,
+		command: "sudo killall fseventsd",
+		note: "launchd restarts it at once, and file watchers rescan their folders once."
+	},
+	{
+		name: "Watchman",
+		matches: ({ name }) => name === "watchman",
+		bytes: 2 * GIB,
+		command: "stim gc --delete --cache watchman",
+		note: "Stim stops the daemon only when no workspace uses it; the next Metro starts a fresh one."
+	},
+	{
+		name: "Gradle daemon",
+		matches: ({ name }, commandLine) => name === "java" && GRADLE_DAEMON.test(commandLine ?? ""),
+		command: "stim gc --delete --cache gradle-daemons",
+		note: GRADLE_NOTE
+	},
+	{
+		name: "Kotlin daemon",
+		matches: ({ name }, commandLine) => name === "java" && KOTLIN_DAEMON.test(commandLine ?? ""),
+		command: "stim gc --delete --cache gradle-daemons",
+		note: GRADLE_NOTE
+	}
+];
+/** Parses `top -l 1 -stats pid,mem,command` output: the rows after its `PID MEM COMMAND` header. */
+function parseTopMemory(output) {
+	const rows = [];
+	let header = false;
+	for (const line of output.split("\n")) {
+		if (!header) {
+			header = /^\s*PID\s+MEM\s+COMMAND\b/.test(line);
+			continue;
+		}
+		const match = /^\s*(\d+)\s+(\d+(?:\.\d+)?)([BKMGT])[+-]?\s+(\S.*?)\s*$/.exec(line);
+		if (match) rows.push({
+			pid: Number(match[1]),
+			bytes: Math.round(Number(match[2]) * UNITS[match[3]]),
+			name: match[4]
+		});
+	}
+	return rows;
+}
+function findMemoryCulprits(processes, totalBytes, commandLines = /* @__PURE__ */ new Map()) {
+	const general = Math.max(GENERAL_FLOOR_BYTES, totalBytes * GENERAL_SHARE_OF_RAM);
+	const culprits = [];
+	for (const row of processes) {
+		const known = RESTARTABLE.find((entry) => entry.matches(row, commandLines.get(row.pid)));
+		if (row.bytes < Math.min(general, known?.bytes ?? general)) continue;
+		culprits.push({
+			pid: row.pid,
+			name: known?.name ?? row.name,
+			bytes: row.bytes,
+			command: known?.command ?? null,
+			note: known?.note ?? null
+		});
+	}
+	return culprits.toSorted((a, b) => b.bytes - a.bytes);
+}
+function memoryCulpritAdvice(culprits) {
+	if (!culprits?.length) return null;
+	return culprits.map((culprit) => {
+		const uses = `${culprit.name} (pid ${culprit.pid}) uses ${formatBytes(culprit.bytes)} of memory`;
+		return culprit.command ? `${uses}; run \`${culprit.command}\` to free it: ${culprit.note}` : `${uses}; Stim knows no safe restart for it, so ask before quitting it.`;
+	}).join(" ");
+}
+/**
+* The abnormal processes by footprint, from the setuid `top`: unlike `proc_pid_rusage` without root, it reads
+* root-owned daemons such as fseventsd, and unlike `ps` RSS it counts compressed and swapped memory. Null off macOS
+* or when `top` fails.
+*/
+function readMemoryCulprits(exec = getExecutor(), platform = process.platform, totalBytes = totalmem()) {
+	if (platform !== "darwin") return null;
+	const output = exec.runFileQuiet("/usr/bin/top", [
+		"-l",
+		"1",
+		"-o",
+		"mem",
+		"-n",
+		String(TOP_ROWS),
+		"-stats",
+		"pid,mem,command"
+	], { timeoutMs: 1e4 });
+	if (output === null) return null;
+	const processes = parseTopMemory(output);
+	const java = processes.filter((entry) => entry.name === "java").map((entry) => entry.pid);
+	const commandLines = /* @__PURE__ */ new Map();
+	if (java.length) {
+		const listed = exec.runFileQuiet("/bin/ps", [
+			"-ww",
+			"-o",
+			"pid=,command=",
+			"-p",
+			java.join(",")
+		], { timeoutMs: 5e3 });
+		for (const line of listed?.split("\n") ?? []) {
+			const match = /^\s*(\d+)\s+(.*)$/.exec(line);
+			if (match) commandLines.set(Number(match[1]), match[2]);
+		}
+	}
+	return findMemoryCulprits(processes, totalBytes, commandLines);
+}
+function memoryCulpritFindings(culprits) {
+	return (culprits ?? []).filter((culprit) => culprit.name !== "Watchman").map((culprit) => ({
+		code: "memory-culprit",
+		level: "cost",
+		title: `${culprit.name} uses ${formatBytes(culprit.bytes)} of memory`,
+		detail: memoryCulpritAdvice([culprit]),
+		fix: culprit.command ? `Run \`${culprit.command}\`. ${culprit.note}` : "Stim knows no safe restart for this process. Ask before quitting it."
+	}));
+}
+//#endregion
 //#region src/host-memory.ts
 function readHostMemoryPressure(exec = getExecutor(), platform = process.platform) {
 	if (platform !== "darwin") return null;
@@ -153,9 +283,13 @@ function readHostMemoryPressure(exec = getExecutor(), platform = process.platfor
 		return null;
 	}
 }
-function hostMemoryPressureAdvice(pressure) {
+function memoryCulpritsUnder(pressure, exec = getExecutor()) {
+	return pressure === "warning" || pressure === "critical" ? readMemoryCulprits(exec) : null;
+}
+function hostMemoryPressureAdvice(pressure, culprits = null) {
 	if (pressure === null || pressure === "normal") return null;
-	return `macOS reports ${pressure} host memory pressure. Simulator processes can stall even when the device is Booted. Free memory before retrying: use \`stim stop\` only in workspaces you own, and ask before closing other apps or devices. For parallel iOS work, consider a reviewed SimSlim profile (\`stim guide lifecycle simslim\`). This observation does not establish an OOM crash.`;
+	const named = memoryCulpritAdvice(culprits);
+	return `macOS reports ${pressure} host memory pressure.${named ? ` ${named}` : ""} Simulator processes can stall even when the device is Booted. Free memory before retrying: use \`stim stop\` only in workspaces you own, and ask before closing other apps or devices. For parallel iOS work, consider a reviewed SimSlim profile (\`stim guide lifecycle simslim\`). This observation does not establish an OOM crash.`;
 }
 //#endregion
 //#region src/devices/ios-simulator-viewer.ts
@@ -291,7 +425,8 @@ const BOOTSTATUS_ATTEMPT_MS = 24e4;
 const BOOTSTATUS_ATTEMPT_FLOOR_MS = 1e3;
 const BOOT_STATE_LIST_TIMEOUT_MS = 3e4;
 function iosSimulatorFailureAdvice(exec = getExecutor()) {
-	return hostMemoryPressureAdvice(readHostMemoryPressure(exec)) ?? "The simulator may be unresponsive. Check Activity Monitor for memory pressure and free host memory before retrying.";
+	const pressure = readHostMemoryPressure(exec);
+	return hostMemoryPressureAdvice(pressure, memoryCulpritsUnder(pressure, exec)) ?? "The simulator may be unresponsive. Check Activity Monitor for memory pressure and free host memory before retrying.";
 }
 function bootstatusTimeout(command) {
 	const e = /* @__PURE__ */ new Error(`${command} timed out`);
@@ -418,15 +553,19 @@ async function bootIosSim(udid, { timeoutMs = IOS_BOOT_TIMEOUT_MS, attemptMs = B
 			if (deadline - Date.now() <= 0) throw new Error(`Simulator ${udid} did not finish booting within ${Math.round(timeoutMs / 1e3)}s.`);
 		}
 	} catch (error) {
-		sample();
-		throw new Error(`${error?.message || error} Last boot output: ${phase}. Highest observed memory pressure: ${worst ?? "unknown"}; unavailable samples: ${unknown}.${coverage()} ${recovery} These observations do not establish an OOM crash.`, { cause: error });
+		const named = memoryCulpritAdvice(memoryCulpritsUnder(sample(), exec));
+		throw new Error(`${error?.message || error} Last boot output: ${phase}. Highest observed memory pressure: ${worst ?? "unknown"}; unavailable samples: ${unknown}.${coverage()}${named ? ` ${named}` : ""} ${recovery} These observations do not establish an OOM crash.`, { cause: error });
 	} finally {
 		clearInterval(monitor);
 	}
 	if (openViewer) viewer.open(udid);
 }
 function shutdownIosSim(udid) {
-	getExecutor().runQuiet(`xcrun simctl shutdown ${udid}`, SIMCTL_OPTIONS);
+	getExecutor().runFileQuiet("xcrun", [
+		"simctl",
+		"shutdown",
+		udid
+	], SIMCTL_OPTIONS);
 }
 function listIosDeviceTypes() {
 	const out = getExecutor().runFile("xcrun", [
@@ -438,10 +577,15 @@ function listIosDeviceTypes() {
 		timeoutMs: 3e4,
 		killSignal: "SIGKILL"
 	});
-	return (JSON.parse(out).devicetypes || []).map((dt) => ({
-		identifier: dt.identifier,
-		name: dt.name
-	}));
+	const data = JSON.parse(out);
+	return isJsonObject(data) ? deviceTypesOf(data.devicetypes) : [];
+}
+function deviceTypesOf(value) {
+	if (!Array.isArray(value)) return [];
+	return value.flatMap((entry) => isJsonObject(entry) && typeof entry.identifier === "string" && typeof entry.name === "string" ? [{
+		identifier: entry.identifier,
+		name: entry.name
+	}] : []);
 }
 function rankIphone(name) {
 	const gen = /^iPhone\s+(\d+)/i.exec(name);
@@ -531,7 +675,13 @@ function createOwnedIosSim(label, { deviceType, runtime, suffix = "" } = {}, cho
 		model: choice.deviceType,
 		runtime: choice.runtime
 	}, suffix);
-	const udid = getExecutor().run(`xcrun simctl create "${name}" "${choice.deviceTypeId}" "${choice.runtimeId}"`, {
+	const udid = getExecutor().runFile("xcrun", [
+		"simctl",
+		"create",
+		name,
+		choice.deviceTypeId,
+		choice.runtimeId
+	], {
 		timeoutMs: SIMCTL_CREATE_TIMEOUT_MS,
 		killSignal: "SIGKILL"
 	}).trim();
@@ -690,7 +840,11 @@ function deleteIosSim(udid) {
 	const result = resolveOwnedIosSim(udid);
 	if (result.missing) return;
 	if (result.notOwned) throw new Error(`Refusing to delete simulator "${result.notOwned}" (${udid}): not a Stim-owned sim; Stim has no record of creating it.`);
-	getExecutor().run(`xcrun simctl delete ${udid}`, SIMCTL_OPTIONS);
+	getExecutor().runFile("xcrun", [
+		"simctl",
+		"delete",
+		udid
+	], SIMCTL_OPTIONS);
 	forgetCreatedDevice("ios", udid);
 }
 const PARKED_DELETE_TIMEOUT_MS = 3e4;
@@ -708,25 +862,31 @@ function deleteParkedIosSim(udid) {
 	], { timeoutMs: PARKED_DELETE_TIMEOUT_MS });
 	forgetCreatedDevice("ios", udid);
 }
+const LIST_RUNTIMES_ARGS = [
+	"simctl",
+	"list",
+	"runtimes",
+	"--json"
+];
+const LIST_RUNTIMES_OPTIONS = {
+	timeoutMs: 3e4,
+	killSignal: "SIGKILL"
+};
 function listIosRuntimes() {
-	const out = getExecutor().runFile("xcrun", [
-		"simctl",
-		"list",
-		"runtimes",
-		"--json"
-	], {
-		timeoutMs: 3e4,
-		killSignal: "SIGKILL"
-	});
-	return (JSON.parse(out).runtimes || []).filter((r) => r.isAvailable && r.platform === "iOS").map((r) => ({
+	return parseIosRuntimes(getExecutor().runFile("xcrun", LIST_RUNTIMES_ARGS, LIST_RUNTIMES_OPTIONS));
+}
+async function listIosRuntimesAsync() {
+	return parseIosRuntimes(await getExecutor().runFileAsync("xcrun", LIST_RUNTIMES_ARGS, LIST_RUNTIMES_OPTIONS));
+}
+function parseIosRuntimes(out) {
+	const data = JSON.parse(out);
+	if (!isJsonObject(data) || !Array.isArray(data.runtimes)) return [];
+	return data.runtimes.flatMap((r) => isJsonObject(r) && r.isAvailable === true && r.platform === "iOS" && typeof r.identifier === "string" && typeof r.name === "string" && typeof r.version === "string" ? [{
 		identifier: r.identifier,
 		name: r.name,
 		version: r.version,
-		supportedDeviceTypes: (r.supportedDeviceTypes || []).map((d) => ({
-			identifier: d.identifier,
-			name: d.name
-		}))
-	}));
+		supportedDeviceTypes: deviceTypesOf(r.supportedDeviceTypes)
+	}] : []);
 }
 //#endregion
-export { parseIosSimulatorApp as A, resetIosPrivacy as C, shutdownIosSim as D, sanitizeDeviceLabel as E, readHostMemoryPressure as M, deviceHoldsApk as N, uninstallIosApp as O, deviceHoldsBundle as P, resetIosKeychain as S, resolveOwnedIosSim as T, parkedSimName as _, createOwnedIosSim as a, pickDefaultIosCreation as b, eraseIosSim as c, listAllIosSims as d, listAllIosSimsAsync as f, ownedSimName as g, listUserApps as h, createIosSimSnapshot as i, hostMemoryPressureAdvice as j, configuredIosSimulatorViewer as k, iosRuntimeMatches as l, listIosRuntimes as m, bootIosSim as n, deleteIosSim as o, listIosDeviceTypes as p, clearIosAppData as r, deleteParkedIosSim as s, IOS_BOOT_TIMEOUT_MS as t, iosSimulatorFailureAdvice as u, parseRuntimeVersion as v, resolveIosCreation as w, renameIosSim as x, parseSimctlList as y };
+export { configuredIosSimulatorViewer as A, resetIosKeychain as C, sanitizeDeviceLabel as D, resolveOwnedIosSim as E, memoryCulpritAdvice as F, memoryCulpritFindings as I, readMemoryCulprits as L, hostMemoryPressureAdvice as M, memoryCulpritsUnder as N, shutdownIosSim as O, readHostMemoryPressure as P, deviceHoldsApk as R, renameIosSim as S, resolveIosCreation as T, ownedSimName as _, createOwnedIosSim as a, parseSimctlList as b, eraseIosSim as c, listAllIosSims as d, listAllIosSimsAsync as f, listUserApps as g, listIosRuntimesAsync as h, createIosSimSnapshot as i, parseIosSimulatorApp as j, uninstallIosApp as k, iosRuntimeMatches as l, listIosRuntimes as m, bootIosSim as n, deleteIosSim as o, listIosDeviceTypes as p, clearIosAppData as r, deleteParkedIosSim as s, IOS_BOOT_TIMEOUT_MS as t, iosSimulatorFailureAdvice as u, parkedSimName as v, resetIosPrivacy as w, pickDefaultIosCreation as x, parseRuntimeVersion as y, deviceHoldsBundle as z };

package/dist/ios-project-BeOXKPt2.mjs

@@ -0,0 +1,197 @@
+import { y as workspaceAgentDeviceDir } from "./workspace-state-CvgTFe-h.mjs";
+import { i as formatDuration, l as phaseLine } from "./command-output-CPDq_90S.mjs";
+import { i as workspaceLinkLine } from "./stim-desktop-8GQX2OV8.mjs";
+import { Dt as recordFinishedBuild } from "./budget-RFbwFpG5.mjs";
+import { a as easAuthNote, n as UPLOAD_TIMEOUT_MS, r as cacheLevel, s as isEasAuthFailureText } from "./remote-cache-fxcl5C-L.mjs";
+import "./launch-verify-Dl78EVgR.mjs";
+import { S as compilationCacheActivityLine, _ as COMPILATION_CACHE_NOT_RUN } from "./toolchain-SqehyPLw.mjs";
+import { i as deviceLabel } from "./support-Co0wk8Cv.mjs";
+import { buildDiagnostics } from "@stim-cli/core/state";
+import chalk from "chalk";
+//#region src/commands/ios/result.ts
+function lastBuildRecord({ devicePlacement, fingerprint = null, cacheKey = null, cacheHit = false, cacheSkipped = false, durationMs = 0, appPath = null, bundleId = null, startedAt, status, errorCode = null, missReason = null, diagnostics = null, configuration = null, buildMachine = "auto", builtOn, offloadedTo = null, offloadFallback = null }) {
+	const record = {
+		platform: "ios",
+		fingerprint,
+		cacheKey,
+		cacheHit: cacheLevel(cacheHit),
+		cacheSkipped: Boolean(cacheSkipped),
+		durationMs,
+		appPath,
+		bundleId,
+		startedAt,
+		status,
+		configuration
+	};
+	if (errorCode) record.errorCode = errorCode;
+	if (devicePlacement) record.devicePlacement = devicePlacement;
+	record.buildMachine = buildMachine;
+	if (builtOn) record.builtOn = builtOn;
+	if (offloadedTo) record.offloadedTo = offloadedTo;
+	if (offloadFallback) record.offloadFallback = offloadFallback;
+	if (missReason && !cacheLevel(cacheHit)) record.missReason = missReason;
+	const recorded = status === "failed" ? buildDiagnostics(diagnostics) : [];
+	if (recorded.length) record.diagnostics = recorded;
+	return record;
+}
+function iosFacts({ root, slot, udid, deviceName, deviceType = null, runtime = null, fingerprint, configuration = null, scheme = null, cacheKey, cacheHit, cacheSkipped = false, compilationCache = COMPILATION_CACHE_NOT_RUN, waitedForBuild = null, appPath, bundleId, installSkipped = false, metroPort, logsDir, durationMs, launched = true, webPreviewUrl = null, lease, devServer = null, buildMachine = "auto", builtOn, offloadedTo = null, offloadFallback = null }) {
+	return {
+		platform: "ios",
+		...slot && slot !== "default" ? { slot } : {},
+		udid,
+		deviceName: deviceName ?? null,
+		deviceType: deviceType ?? null,
+		runtime: runtime ?? null,
+		fingerprint,
+		configuration: configuration ?? null,
+		...scheme ? { scheme } : {},
+		cacheKey,
+		cacheHit: cacheLevel(cacheHit),
+		cacheSkipped: Boolean(cacheSkipped),
+		buildMachine,
+		...builtOn ? { builtOn } : {},
+		...offloadedTo ? { offloadedTo } : {},
+		...offloadFallback ? { offloadFallback } : {},
+		compilationCache,
+		waitedForBuild: waitedForBuild ? {
+			pid: waitedForBuild.pid ?? null,
+			ms: waitedForBuild.ms ?? 0
+		} : null,
+		appPath,
+		bundleId,
+		installSkipped: Boolean(installSkipped),
+		launched: launched === "unverified" || launched === "bundling" ? launched : Boolean(launched),
+		metroPort,
+		logs: { dir: logsDir },
+		...root ? { agentDevice: { stateDir: workspaceAgentDeviceDir(root) } } : {},
+		durationMs,
+		...webPreviewUrl ? { webPreviewUrl } : {},
+		...lease === void 0 ? {} : { lease },
+		...devServer ? { devServer } : {}
+	};
+}
+function writeLastBuild(root, record, { record: recordBuild = recordFinishedBuild } = {}) {
+	try {
+		recordBuild(root, record);
+	} catch {}
+	return record;
+}
+async function finishIosUpload(uploadPending, remote, phase, note) {
+	if (!uploadPending) return false;
+	const upload = await uploadPending;
+	if (upload?.uploaded) phase("cache", `uploaded (${remote?.name})`);
+	else if (upload?.timedOut) {
+		note(chalk.yellow(phaseLine("cache", `${remote?.name} upload still running after ${formatDuration(UPLOAD_TIMEOUT_MS)}; not waiting`)));
+		return true;
+	} else if (upload?.failed) {
+		const authNote = remote?.name === "eas" && isEasAuthFailureText(upload.failed) ? easAuthNote({
+			code: "logged-out",
+			reason: upload.failed,
+			phase: "upload"
+		}) : null;
+		note(chalk.yellow(phaseLine("cache", authNote || `${remote?.name} upload failed: ${upload.failed}`)));
+	}
+	return false;
+}
+function reportIosResult({ devicePlacement, host, slot, root, json, release, runtimeKind = release ? "embedded-js" : "metro", configuration, buildScheme = null, metroCheck, metroPort, logsDir, device, udid, appPath, bundleId, installSkipped, elapsed, startedAt, storeHash, storeKey, cacheHit, missReason, compilationCache, useBuildCache, waitedForBuild, launchState, launchWarning, providerName, buildMachine = "auto", builtOn, offloadedTo = null, offloadFallback = null, closeWriter, webPreviewUrl, lease, recordRun, reclaimed = [], devServer = null, links }) {
+	const durationMs = elapsed();
+	recordRun({
+		failed: false,
+		cacheHit,
+		waited: waitedForBuild,
+		durationMs,
+		offloadedTo
+	});
+	writeLastBuild(root, lastBuildRecord({
+		devicePlacement,
+		fingerprint: storeHash,
+		cacheKey: storeKey,
+		cacheHit,
+		cacheSkipped: !useBuildCache,
+		missReason,
+		durationMs,
+		appPath,
+		bundleId,
+		startedAt,
+		status: "ok",
+		configuration: configuration ?? "Debug",
+		buildMachine,
+		builtOn,
+		offloadedTo,
+		offloadFallback
+	}));
+	closeWriter();
+	const facts = iosFacts({
+		root,
+		slot,
+		udid,
+		deviceName: device?.deviceName ?? null,
+		deviceType: device?.deviceType,
+		runtime: device?.runtime,
+		fingerprint: storeHash,
+		configuration,
+		scheme: buildScheme,
+		cacheKey: storeKey,
+		cacheHit,
+		compilationCache,
+		cacheSkipped: !useBuildCache,
+		waitedForBuild,
+		appPath,
+		bundleId,
+		installSkipped,
+		metroPort,
+		logsDir,
+		durationMs,
+		launched: launchState,
+		webPreviewUrl,
+		lease,
+		devServer,
+		buildMachine,
+		builtOn,
+		offloadedTo,
+		offloadFallback
+	});
+	if (devicePlacement) facts.devicePlacement = devicePlacement;
+	if (host) facts.host = host;
+	if (json) console.log(JSON.stringify({
+		...facts,
+		...links ? { links } : {},
+		...reclaimed.length ? { reclaimed } : {}
+	}));
+	else {
+		const summary = `${launchWarning ? "WARNING" : "OK"}: ${bundleId} on ${host ? `${device.deviceName} (iOS ${device.runtime?.replace(/^iOS /, "")}) on ${host.machine}` : deviceLabel(device, udid)}, ` + (runtimeKind === "process" ? `${configuration ?? "Debug"} (native process, no Metro)` : runtimeKind === "embedded-js" ? `${configuration} (embedded JS, no Metro)` : `Metro port ${metroPort}`) + ` (${cacheDescription(cacheHit, providerName, offloadedTo)}, ${formatDuration(durationMs)})`;
+		const outcome = launchWarning ? chalk.yellow(`${summary} -- ${launchWarning}`) : launchState === "unverified" ? chalk.yellow(`${summary} -- launch UNVERIFIED`) : launchState === "bundling" ? chalk.green(`${summary} -- bundle requested, still building`) : chalk.green(summary);
+		const deviceName = device?.deviceName ?? device?.name ?? udid;
+		const cacheResult = useBuildCache ? cacheDescription(cacheHit, providerName, offloadedTo) : `bypassed; ${cacheDescription(false, null, offloadedTo)}`;
+		const metroResult = runtimeKind === "process" ? "native process (no Metro)" : runtimeKind === "embedded-js" ? `embedded (${configuration})` : !metroCheck ? `check skipped on port ${metroPort}` : launchState === "unverified" ? `state unverified on port ${metroPort}` : `running on port ${metroPort}${devServer ? ` (started: ${devServer.reason})` : ""}`;
+		console.log([
+			outcome,
+			phaseLine("device", host ? `${deviceName} (iOS ${device.runtime?.replace(/^iOS /, "")}) on ${host.machine}` : `${deviceName} (${udid})`),
+			phaseLine("app", bundleId),
+			phaseLine(runtimeKind === "process" ? "runtime" : "metro", metroResult),
+			phaseLine("cache", cacheResult),
+			...compilationCache.status === "not-run" ? [phaseLine("compilation cache", compilationCacheActivityLine(compilationCache))] : [],
+			phaseLine("logs", logsDir),
+			phaseLine("agent-device", `AGENT_DEVICE_STATE_DIR=${workspaceAgentDeviceDir(root)}`)
+		].join("\n"));
+		if (facts.webPreviewUrl) console.error(chalk.dim(`Watch this device: ${facts.webPreviewUrl}`));
+		if (links) console.error(chalk.dim(workspaceLinkLine(links)));
+	}
+	return facts;
+}
+function cacheDescription(cacheHit, providerName = null, offloadedTo = null) {
+	if (cacheHit === "remote") return `from ${providerName || "the remote cache"}`;
+	if (cacheHit === "local") return "from cache";
+	return offloadedTo ? `built on ${offloadedTo}` : "built";
+}
+//#endregion
+//#region src/integrations/ios-project.ts
+var IosRecipeRefusal = class extends Error {
+	failure;
+	constructor(failure) {
+		super(failure.message ?? failure.code);
+		this.failure = failure;
+	}
+};
+//#endregion
+export { lastBuildRecord as a, iosFacts as i, cacheDescription as n, reportIosResult as o, finishIosUpload as r, writeLastBuild as s, IosRecipeRefusal as t };

package/dist/{ios-state-By0XuLTQ.mjs → ios-state-BsXMwo5y.mjs}

@@ -1,4 +1,4 @@
-import { a as updateWorkspaceState, r as readWorkspaceState$1 } from "./workspace-state-CR9X86xJ.mjs";
+import { a as updateWorkspaceState, r as readWorkspaceState$1 } from "./workspace-state-CvgTFe-h.mjs";
 import { HOSTED_METRO_REQUESTS_KEY, hostedMetroRequests, hostedNativeRecords, isJsonObject, parseHostedNativePlacement, unreadableHostedNative } from "@stim-cli/core/state";
 //#region src/device-host/ios-state.ts
 function readHostedNative(root, platform, slot) {