stim 1.17.2 → 1.19.0

package/dist/ios-BJ4XUSe1.mjs

@@ -1,3867 +0,0 @@
-import { t as getExecutor } from "./exec-CaErVv7t.mjs";
-import { E as upsertProject, L as deviceSlotFileKey, R as deviceSlotKey, V as parseDeviceSlotOption, W as validateDeviceSlot, p as getProject, u as getConcurrencyLimits, v as recordIosSchemeApprovals, z as deviceSlotPlatforms } from "./config-D0DbpZtM.mjs";
-import { n as ownership_claim_exports } from "./process-identity-BmRm1qV0.mjs";
-import { _ as stepTimer, c as launchErrorReport, g as stepClock, h as shortUdid, i as formatDuration, l as phaseLine, m as shortHash, n as appReadinessMessage, v as launchErrorPreview } from "./command-output-CDAIFD-8.mjs";
-import { B as settingsLayers, C as metroWarmupUrlSetting, G as detectProviders, H as unknownSettingKeys, J as artifactCachePolicy, L as settingOriginScope, M as remoteIosSetting, N as resolveCacheProviderConfig, P as resolveSettings, R as settingShapeErrors, T as parseIosRemote, Tt as removeTemporaryEntry, V as tunnelModeSetting, X as optimizationBuildProfile, Z as resolveOptimizations, _ as iosSigningIdentitySha1SettingError, f as iosLanHostSetting, g as iosSigningIdentitySha1Setting, gt as repoRoot, h as iosSigningIdentitySettingError, i as SETTING_SHAPE_REMEDY, it as gitCommonDir, k as publicUrlSetting, m as iosSigningIdentitySetting, p as iosLanHostSettingError, u as cacheProviderSettingError, wt as makeTemporaryDirectory, x as metroPortSetting } from "./settings-Cfd-0r2d.mjs";
-import { n as appProjectProblem, r as detectIsExpo, s as findProjectRoot$1, t as NO_PROJECT_REFUSAL } from "./project-D47Rh0ly.mjs";
-import { l as resolveProjectMetro, o as pidExists, u as signalProcessTree } from "./metro-g8NqiJp-.mjs";
-import { c as writeWorkspaceState, g as workspaceAgentDeviceDir, i as recordWorkspaceUse, r as readWorkspaceState$1, v as workspaceDir, x as workspaceLogsDir$1 } from "./workspace-state-DqcCbpE7.mjs";
-import { t as budgetGate } from "./budget-DfcgFdQB.mjs";
-import { A as providerDownloadPath, D as fingerprintProject, E as fingerprintDiffRecord, L as untrackedMissLine, M as refingerprintAfterMutation, N as resolveBuild, O as inputsChangedDuringBuild, P as storeBuild, R as untrackedNativeFiles, S as configInputsChanged, T as filesystemBuildCapability, _ as waitForBuild, b as buildCacheKey, g as releaseBuildLock, j as providerUploadOutcome, k as prepareProviderDownloadDir, m as acquireBuildLock, v as waitForSharedBuild, x as changedDuringBuildLine } from "./device-lease-DpoS36_u.mjs";
-import { r as releaseBuildSlot, t as acquireBuildSlot } from "./build-slots-41v_d2x9.mjs";
-import { m as writeWorkspaceLaunch, n as MODE_EXPO, t as MODE_BARE } from "./state-BKa8wNN5.mjs";
-import { ft as parkedMaxSetting, ot as POOL_SETTING_REMEDY } from "./android-B_YNZy61.mjs";
-import { p as listIosRuntimes, r as clearIosAppData, u as listAllIosSims } from "./ios-DSfnPfse.mjs";
-import { a as workspaceLinks, i as workspaceLinkLine } from "./stim-desktop-Cnz8CPnl.mjs";
-import { _ as statsProjectKey$1, c as recordFinishedBuild, d as createRunRecorder, f as readRunEstimates, g as recordRunStats, l as startBuildProgress, m as recordCapacityRefusal, n as NO_BUILD_PROGRESS, u as tapBuildLog } from "./build-progress-D0WkjCPd.mjs";
-import { r as createNdjsonWriter } from "./ndjson-PclOIwVY.mjs";
-import { S as bundlerPin, _ as readBundleId, c as COMPILATION_CACHE_NOT_RUN, d as buildIos, g as readBundleExecutable, h as discoverXcodeProject, p as compilationCacheActivityLine, r as iosToolchain, v as resolveScheme } from "./toolchain-DNyR3NPq.mjs";
-import { a as offloadBuild, c as placementLoad, d as OffloadRefusal, f as namedBuildMachine, h as resolveBuildPlacement, i as closeOffload, l as remotePhaseText, n as buildPlacementCandidates, p as parseBuildMachineOption, r as chooseBuildMachine, s as offloadPlacement, u as simulatorRuntime } from "./client-SvBdgObD.mjs";
-import { r as hostedMetroSettings } from "./metro-gateway-C-ijGI2F.mjs";
-import { n as verifyCollectorOwnership } from "./ownership-DyRQru0q.mjs";
-import { r as checkDeviceCapacity } from "./device-capacity-ZC4XSZ4R.mjs";
-import { D as schemesFromInfoPlist, S as restartedAppNote, T as pickDevClientScheme, _ as installIosApp, a as IOS_DEV_MENU_OFF_DEFAULTS_PLIST, d as devClientUrl, l as clearOtherUserApps, r as DEFAULT_METRO_PORT, v as iosAppProcess, x as launchIosApp } from "./app-install-VPkI5WEg.mjs";
-import { n as devClientTakesDevMenuParams, t as devClientScheme } from "./dev-client-B-XC4uRH.mjs";
-import { t as spawnEntry } from "./spawn-entry-jw19m8Nl.mjs";
-import { a as runPodInstall, n as podsAreStale, r as readPodState } from "./deps-iKw0eD4P.mjs";
-import { i as staleNativeDirRefusal, n as recordPrebuild, r as runPrebuild, t as planPrebuild } from "./prebuild-D7RUMkwN.mjs";
-import { c as readMetroRecords, f as verifyLaunch, i as RELEASE_VERIFY_WAIT_MS, l as unattributedLaunchLines, n as LAUNCH_FATAL, o as isBundleProof, p as verifyReleaseLaunch, r as LAUNCH_UNVERIFIED, s as readCollectorRecords, t as LAUNCH_BUNDLING, u as unverifiedLaunchLines } from "./launch-verify-lTnWZikR.mjs";
-import { a as acquireRunLease, c as lostRefusal, d as runLease, f as waitFlagConflict, o as leaseExpiryText, s as lostLine, t as DEBUG_VERIFY_STEP_MS, u as releaseLeaseOnSignal } from "./device-lease-run-B8YltIH_.mjs";
-import { n as clearIosAdoptionPending } from "./device-ios-C2Um-XUR.mjs";
-import { _ as resolveSimulatorAppFlag, a as deviceModelRefusal, c as iosProviderRunOptions, d as podAction, f as printDiagnostics, g as resolveRuntime, h as resolveIosWait, i as deviceLabel, l as isReleaseConfiguration, m as resolveDeviceType, n as buildLogFile, o as deviceShortName, p as resolveConfiguration, r as createIosDeviceWaitRun, s as iosConfigurationSetting, t as appNameFromPath, u as ownedSimFailure, v as simulatorBuildArch, y as xcodeFailureReport } from "./support-CsJNVfOc.mjs";
-import { i as writeDevicePlacement, n as readHostedIos, o as writeHostedIos } from "./ios-state-8L3lgum6.mjs";
-import { a as refusePlan, b as devicePlacementLine, c as skippedMissReason, f as swapJsBundle, h as ensureOwnedDevice, i as printPlan, m as ensureBooted, n as planFlagRefusal, o as explainBuildMiss, p as didSetUpDevice, r as planPayload, s as fingerprintErrorMissReason, t as planCachedBuild, v as warmMetro, y as automaticDevicePlacement } from "./build-plan-BDsSi09V.mjs";
-import { n as nativeRunCommand, r as siblingPlatformSlots, t as launchSlotScope } from "./slot-launch-DmjBmpQV.mjs";
-import { a as easAuthNote, c as loadProjectProvider, f as resolveEasCliBin, i as checkEasAuth, m as uploadRemote, n as UPLOAD_TIMEOUT_MS, o as exitAfterFlush, p as resolveRemote, r as cacheLevel, s as isEasAuthFailureText, t as RESOLVE_TIMEOUT_MS } from "./remote-cache-Ci4DQYYj.mjs";
-import { O as readRemoteSimulatorArch, a as ensureMetroReachable, k as gateMetroOrigin, l as remoteIosDeps, n as binOnPath, o as ensureRemoteBootOwned, r as bundleEntryPoint, u as resolveRemoteContext, w as ownedSessionName } from "./device-remote-hFSkpfQu.mjs";
-import { d as runCancellationSignal, f as withNativeBuildRun, r as cancelledFailure, u as runCancellation } from "./native-run-D1Q56rAD.mjs";
-import { a as isEasBuildFailure, i as easDeviceBuildRemedy, o as planEasDevelopmentBuild, s as resolveEasDevelopmentBuild } from "./simslim-BWNrc3M3.mjs";
-import { c as startDevServer, h as detectBundleId } from "./start-DUz3mYdb.mjs";
-import { a as sleep, i as launchOutcomeRecord, n as ensureWorkspaceStorageSafely, r as isPhysicalDeviceRequest, t as ensureDevServer } from "./native-runtime-BEK171xQ.mjs";
-import { t as selectFromPool } from "./device-pool-3o7s5lo4.mjs";
-import { a as printNativeCrashReport, n as IOS_CRASH_REPORT_RETRY, o as simulatorConsolePaths, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-C-NMnhrk.mjs";
-import { a as iosPoolCandidates, c as isWirelessIosDevice, f as resolveIosPhysicalDevice, i as iosDeviceProcess, l as listIosDevices, n as installIosDeviceApp, o as iosPoolNoCandidatesRefusal, p as verifyIosDeviceReleaseLaunch, r as iosDeviceBounds, t as awaitIosDeviceLaunch, u as localNetworkPending } from "./ios-device-pAN4t54-.mjs";
-import { n as prepareHostedIos, t as placeHostedIos } from "./hosted-ios-BnbeYOUD.mjs";
-import { X509Certificate } from "node:crypto";
-import { existsSync, mkdirSync, mkdtempSync, openSync, rmSync, writeFileSync } from "node:fs";
-import { basename, join } from "node:path";
-import { hostSimulatorArch, workspaceId } from "@stim-cli/core";
-import { InvalidArgumentError } from "commander";
-import { buildDiagnostics, hostedIosStatus, machineCapacity, parseMachine } from "@stim-cli/core/state";
-import { networkInterfaces, tmpdir } from "node:os";
-import chalk from "chalk";
-import { createWarnOnce, loadCacheProvider, resolveTieredBuild, storeTieredBuild } from "@stim-cli/cache";
-//#region src/engine/ios-lan.ts
-const IP_TXT = "ip.txt";
-function chooseLanAddress({ pinned = null, candidates }) {
-	const list = Array.isArray(candidates) ? candidates : [];
-	if (pinned) return {
-		address: pinned,
-		interfaceName: list.find((candidate) => candidate.address === pinned)?.interfaceName ?? null,
-		pinned: true,
-		candidates: list.length
-	};
-	const first = list[0];
-	if (!first) return null;
-	return {
-		address: first.address,
-		interfaceName: first.interfaceName,
-		pinned: false,
-		candidates: list.length
-	};
-}
-function lanOriginUrlFor(address, port) {
-	return `http://${address}:${port}`;
-}
-function ipTxtContents(address, port) {
-	return `${String(address).trim()}:${String(port).trim()}\n`;
-}
-function writeIpTxt(appPath, address, port, { write = writeFileSync } = {}) {
-	const path = join(appPath, IP_TXT);
-	write(path, ipTxtContents(address, port), "utf-8");
-	return path;
-}
-async function ensureLanReachable({ origin, metroPort, root, isExpo, logsDir, gateOrigin = gateMetroOrigin, readRecords = null }) {
-	const result = await gateOrigin({
-		origin,
-		metroPort,
-		platform: "ios",
-		entryPoint: bundleEntryPoint(root, isExpo),
-		readRecords: readRecords ?? (() => readMetroRecords(logsDir)),
-		isProof: isBundleProof
-	});
-	if (result.failed) return {
-		failed: result.reason ?? `${origin} is not this workspace's Metro.`,
-		remedy: `The phone reaches Metro at ${origin}, so that address has to serve THIS workspace's dev server. \`stim start\` prints the port it reserved. Set ios.lanHost in .stim.json when this Mac has several network interfaces and the phone shares one that is not the first.`
-	};
-	return { ok: true };
-}
-function copyAppAside(appPath, { exec = null, mkdtemp = () => makeTemporaryDirectory(appPath, "stim-ios-device-") } = {}) {
-	const e = exec || getExecutor();
-	const tmpDir = mkdtemp();
-	const copy = join(tmpDir, basename(appPath));
-	try {
-		e.runFile("cp", [
-			"-c",
-			"-R",
-			appPath,
-			copy
-		]);
-	} catch {
-		try {
-			removeTemporaryEntry(copy);
-			e.runFile("cp", [
-				"-R",
-				appPath,
-				copy
-			]);
-		} catch (error) {
-			removeTemporaryEntry(tmpDir);
-			throw error;
-		}
-	}
-	return {
-		tmpDir,
-		appPath: copy
-	};
-}
-//#endregion
-//#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, 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)}, ` + (release ? `${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 = release ? `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("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/commands/ios/artifact.ts
-const GENERIC_SIM_DESTINATION = "generic/platform=iOS Simulator";
-const IPHONEOS_SDK = "iphoneos";
-const PROVIDER_SKIPPED_ON_DEVICE = "a device build is local-tier only: its cache key names the iphoneos slice, and a remote or provider entry is keyed for the simulator";
-var ArtifactRefusal = class extends Error {
-	failure;
-	constructor(failure) {
-		super(failure.message ?? failure.code);
-		this.failure = failure;
-	}
-};
-async function acquireIosArtifact({ root, logFile, udid, remoteDestination, hostedDestination, simulatorArch, device, configuration, buildScheme, buildProfile, buildMachine = "auto", isExpo, optimizations, cache, easBuild, easProfile, maxBuilds, progress }, d) {
-	const { phase, note, logWriter, estimates, stats, step, miss, hit: lateHit, place, waitingOn, waitingFor } = progress;
-	const physical = device !== null;
-	const keyOptions = {
-		scheme: buildScheme,
-		...configuration ? { configuration } : {},
-		isSimulator: !physical,
-		...simulatorArch ? { arch: simulatorArch } : {},
-		...buildProfile ? { buildProfile } : {}
-	};
-	const providerRunOptions = iosProviderRunOptions(configuration, simulatorArch);
-	const lanAddress = device?.lanAddress ?? null;
-	const metroPort = device?.metroPort ?? null;
-	const release = isReleaseConfiguration(configuration);
-	const cachePolicy = cache.policy;
-	const useBuildCache = cachePolicy.read;
-	const cacheProviderConfig = cache.providerConfig;
-	let compilationCache = COMPILATION_CACHE_NOT_RUN;
-	function fail(failure) {
-		throw new ArtifactRefusal(failure);
-	}
-	const temporaryDirs = /* @__PURE__ */ new Set();
-	const releaseArtifact = () => {
-		for (const directory of temporaryDirs) {
-			try {
-				rmSync(directory, {
-					recursive: true,
-					force: true
-				});
-			} catch {}
-			temporaryDirs.delete(directory);
-		}
-	};
-	let buildLock = null;
-	const releaseLock = () => {
-		if (!buildLock) return;
-		const held = buildLock;
-		buildLock = null;
-		try {
-			d.releaseBuildLock(held);
-		} catch (e) {
-			note(chalk.dim(`Could not release the build lock at ${held.path}: ${e?.message || e}`));
-		}
-	};
-	let buildSlot = null;
-	const releaseSlot = () => {
-		if (!buildSlot) return;
-		const held = buildSlot;
-		buildSlot = null;
-		try {
-			d.releaseBuildSlot(held);
-		} catch (e) {
-			note(chalk.dim(`Could not release the build slot: ${e?.message || e}`));
-		}
-	};
-	let fingerprint = "";
-	let fingerprintSources = [];
-	let cacheKey = "";
-	let storeHash = null;
-	let storeKey = null;
-	let storeSources = [];
-	let appPath = null;
-	let bundleId = null;
-	let cacheHit = false;
-	let offloadedTo = null;
-	let handoff = null;
-	let offloadFallback = null;
-	let fallbackMachine = null;
-	let hereReason = "no remote Mac is paired";
-	let slotWaitMs;
-	let builtOn;
-	const fallBack = (reason, line = reason) => {
-		if (namedBuildMachine(buildMachine)) throw new OffloadRefusal(buildMachine, reason);
-		offloadFallback = reason;
-		buildFailure = {
-			...buildFailure,
-			offloadFallback: reason
-		};
-		phase("build", `${line} -> building here`);
-	};
-	const openOffload = { choice: null };
-	let remote = null;
-	let abandonedRemote = false;
-	let uploadPending = null;
-	let providerUpload = null;
-	let providerName = null;
-	let providerLoad = null;
-	const cacheWarn = createWarnOnce((line) => note(chalk.yellow(phaseLine("cache", line))));
-	const loadProvider = cachePolicy.remote && cacheProviderConfig && !physical ? () => providerLoad ??= d.loadCacheProvider({
-		projectRoot: root,
-		config: cacheProviderConfig
-	}) : null;
-	if (cacheProviderConfig && physical) note(chalk.dim(phaseLine("cache", PROVIDER_SKIPPED_ON_DEVICE)));
-	let waitedForBuild = null;
-	let releasedWait = null;
-	let swapFellBack = false;
-	let buildFailure = {};
-	let missReason = null;
-	async function resolveInitialFingerprint() {
-		if (easBuild?.ok) {
-			fingerprint = storeHash = easBuild.fingerprint;
-			cacheKey = storeKey = easBuild.cacheKey;
-			appPath = easBuild.path;
-			cacheHit = easBuild.cacheHit;
-			providerName = "eas";
-			stats.setCacheKey(cacheKey);
-			if (physical) {
-				const gate = d.gateProfileForDevice({
-					appPath,
-					udid,
-					configuration
-				});
-				if (!gate.ok) fail({
-					code: gate.code,
-					message: gate.reason,
-					remedy: easDeviceBuildRemedy(easProfile)
-				});
-				if (!d.devClientScheme(root, appPath)) fail({
-					code: "STIM_BAD_ARG",
-					message: "The EAS device app has no development-client URL scheme.",
-					remedy: "Install expo-dev-client with npx expo install expo-dev-client, then rebuild the EAS profile and retry."
-				});
-			}
-			return;
-		}
-		if (useBuildCache) step("cache-lookup");
-		const fingerprintTimer = stepTimer(d.now);
-		let computedFingerprint;
-		let fingerprintError = "no hash";
-		try {
-			const computed = await d.fingerprintProject(root, { platform: "ios" });
-			computedFingerprint = computed?.hash ?? null;
-			fingerprintSources = computed?.sources ?? [];
-		} catch (e) {
-			computedFingerprint = null;
-			fingerprintError = String(e?.message || e);
-			note(chalk.dim(`Fingerprinting failed: ${fingerprintError}`));
-		}
-		if (!computedFingerprint) fail({
-			code: "STIM_NO_FINGERPRINT",
-			message: `Could not fingerprint ${root}: @expo/fingerprint produced no hash for it.`,
-			remedy: "Check the project native inputs and the @expo/fingerprint error above, then retry.",
-			build: {
-				cacheSkipped: !useBuildCache,
-				missReason: fingerprintErrorMissReason(fingerprintError)
-			}
-		});
-		fingerprint = computedFingerprint;
-		cacheKey = buildCacheKey("ios", fingerprint, keyOptions);
-		stats.setCacheKey(cacheKey);
-		storeHash = fingerprint;
-		storeKey = cacheKey;
-		storeSources = fingerprintSources;
-		const found = await resolveTieredBuild({
-			local: filesystemBuildCapability({
-				resolve: d.resolveBuild,
-				store: d.storeBuild,
-				sources: fingerprintSources
-			}),
-			loadProvider,
-			target: {
-				projectRoot: root,
-				platform: "ios",
-				key: cacheKey
-			},
-			destinationDir: providerDownloadPath(workspaceDir(root)),
-			ensureDestination: prepareProviderDownloadDir,
-			skipRead: !useBuildCache,
-			warn: cacheWarn
-		});
-		const cached = found?.tier === "local" ? found.path : null;
-		cacheHit = cached ? "local" : false;
-		phase("fingerprint", `${shortHash(fingerprint)} ${cached ? "hit" : "miss"}${useBuildCache ? "" : cache.disabledByFlag ? " (--no-build-cache)" : " (cache reuse off in config)"} ${fingerprintTimer()}`);
-		if (found?.tier === "provider") {
-			cacheHit = "remote";
-			providerName = found.providerName ?? null;
-			phase("cache", `provider hit (${providerName})${found.storedLocally ? " -> stored locally" : ""}`);
-		}
-		appPath = found?.path ?? null;
-	}
-	async function resolveRemoteArtifact() {
-		if (physical || !cachePolicy.remote || buildProfile || buildScheme) return null;
-		if (!appPath) {
-			const loaded = await d.loadProjectProvider(root, { isExpo });
-			if (loaded?.unavailable) note(chalk.yellow(phaseLine("cache", `provider not usable: ${loaded.unavailable}`)));
-			else if (loaded?.provider) remote = loaded;
-			if (remote?.name === "eas") {
-				const auth = d.checkEasAuth({
-					projectRoot: root,
-					owner: loaded?.owner || null
-				});
-				const authNote = easAuthNote(auth);
-				if (authNote) note(chalk.yellow(phaseLine("cache", authNote)));
-				if (auth?.code === "logged-out") remote = null;
-			}
-		}
-		if (remote && useBuildCache) {
-			const remoteTimer = stepTimer(d.now);
-			const hit = await d.resolveRemote({
-				logWriter: logWriter(),
-				provider: remote.provider,
-				platform: "ios",
-				projectRoot: root,
-				fingerprintHash: fingerprint,
-				runOptions: providerRunOptions
-			});
-			if (hit?.appPath) {
-				let stored = null;
-				try {
-					stored = d.storeBuild("ios", cacheKey, hit.appPath, { sources: fingerprintSources });
-				} catch (e) {
-					note(chalk.yellow(phaseLine("cache", `remote hit could not be stored locally: ${e?.message || e}`)));
-				}
-				appPath = stored || hit.appPath;
-				cacheHit = "remote";
-				phase("cache", `remote hit (${remote.name})${stored ? " -> stored locally" : ""} ${remoteTimer()}`);
-			} else if (hit?.timedOut) {
-				abandonedRemote = true;
-				note(chalk.yellow(phaseLine("cache", `${remote.name} did not answer within ${formatDuration(RESOLVE_TIMEOUT_MS)}; building instead`)));
-			} else if (hit?.failed) {
-				const authNote = remote.name === "eas" && isEasAuthFailureText(hit.failed) ? easAuthNote({
-					code: "logged-out",
-					reason: hit.failed
-				}) : null;
-				note(chalk.yellow(phaseLine("cache", authNote || `${remote.name} could not be used: ${hit.failed}; building instead`)));
-			} else phase("cache", `remote miss (${remote.name}) ${remoteTimer()}`);
-		}
-		return remote;
-	}
-	async function awaitSharedBuild() {
-		if (!useBuildCache || appPath) return;
-		const shared = await waitForSharedBuild({
-			platform: "ios",
-			key: cacheKey,
-			fingerprint,
-			root,
-			logFile,
-			command: "stim ios",
-			acquire: d.acquireBuildLock,
-			wait: d.waitForBuild,
-			now: d.now,
-			phase: (text) => {
-				step("wait");
-				phase("build", text);
-			},
-			waitingOn,
-			warn: (text) => note(chalk.yellow(phaseLine("build", text))),
-			out: note
-		});
-		if (shared.refusal) fail({
-			...shared.refusal,
-			build: {
-				fingerprint,
-				cacheKey,
-				cacheHit,
-				cacheSkipped: !useBuildCache
-			}
-		});
-		buildLock = shared.lock;
-		releasedWait = shared.released;
-		if (shared.hit) {
-			appPath = shared.hit.path;
-			cacheHit = "local";
-			waitedForBuild = shared.hit.waited;
-		}
-	}
-	const prepareDeviceApp = async (path, { fresh }) => {
-		const refuse = (code, reason, remedy) => {
-			if (fresh) fail({
-				code,
-				message: reason,
-				remedy,
-				build: {
-					...buildFailure,
-					appPath: path
-				}
-			});
-			note(chalk.yellow(phaseLine("cache", `${reason} -- building fresh instead`)));
-			note(chalk.dim(phaseLine("", remedy)));
-			swapFellBack = true;
-			return null;
-		};
-		const gateProfile = () => {
-			const gate = d.gateProfileForDevice({
-				appPath: path,
-				udid,
-				configuration
-			});
-			return gate.ok ? path : refuse(gate.code, gate.reason, gate.remedy);
-		};
-		if (release) {
-			if (!fresh) {
-				note(chalk.yellow(phaseLine("cache", `a cached ${configuration} device app carries its builder's JS, and the device JS swap lands with phase 6 of appandflow/stim#178 -- building fresh instead, which bakes in this workspace's JS`)));
-				swapFellBack = true;
-				return null;
-			}
-			return gateProfile();
-		}
-		if (d.devClientScheme(root, path)) return gateProfile();
-		let copy;
-		try {
-			copy = copyAppAside(path);
-		} catch (e) {
-			return refuse("STIM_INSTALL_FAILED", `Could not copy ${path} aside to write its ip.txt: ${e?.message || e}`, "Free space in the temporary directory and run the command again.");
-		}
-		temporaryDirs.add(copy.tmpDir);
-		writeIpTxt(copy.appPath, lanAddress, metroPort);
-		const sealed = d.sealAppForDevice({
-			appPath: copy.appPath,
-			udid,
-			configuration,
-			pinnedName: device?.signingName ?? null,
-			pinnedSha1: device?.signingSha1 ?? null
-		});
-		if (!sealed.ok) {
-			try {
-				rmSync(copy.tmpDir, {
-					recursive: true,
-					force: true
-				});
-			} catch {}
-			for (const line of sealed.lastLines ?? []) note(chalk.dim(phaseLine("", line)));
-			return refuse(sealed.code, sealed.reason, sealed.remedy);
-		}
-		phase("ip.txt", `${lanAddress}:${metroPort} written into the install copy and re-sealed with "${sealed.identity.name}"${sealed.mode === "preserve-metadata" ? "" : ` (${sealed.mode})`}`);
-		return copy.appPath;
-	};
-	const installableCachedApp = async (cachedPath) => {
-		if (physical) return prepareDeviceApp(cachedPath, { fresh: false });
-		if (!release) return cachedPath;
-		phase("swap", `regenerating this workspace's JS for the cached ${configuration} app`);
-		const swap = await d.swapJsBundle({
-			root,
-			isExpo,
-			cachedAppPath: cachedPath,
-			logWriter: logWriter()
-		});
-		if (swap?.ok && swap.appPath) {
-			if (swap.note) note(chalk.yellow(phaseLine("swap", swap.note)));
-			if (swap.tmpDir) temporaryDirs.add(swap.tmpDir);
-			phase("swap", `${swap.hermes ? "hermes bytecode" : "plain JS"} + assets replaced, re-signed (${formatDuration(swap.durationMs ?? 0)})`);
-			return swap.appPath;
-		}
-		note(chalk.yellow(phaseLine("swap", `failed at ${swap?.step || "unknown step"}: ${swap?.reason || "unknown reason"} -- building fresh instead (a cached ${configuration} app carries its builder's JS; it is never installed after a failed swap)`)));
-		for (const line of swap?.lastLines ?? []) note(chalk.dim(phaseLine("", line)));
-		swapFellBack = true;
-		return null;
-	};
-	async function prepareCachedArtifact() {
-		if (appPath && cacheHit) {
-			const prepared = await installableCachedApp(appPath);
-			appPath = prepared;
-			if (!prepared) {
-				cacheHit = false;
-				waitedForBuild = null;
-			}
-		}
-	}
-	function reasonForMiss(rekeyedBy) {
-		if (swapFellBack) return {
-			reason: skippedMissReason("the cached app could not be reused, so this run built it fresh"),
-			diff: null
-		};
-		if (!useBuildCache) return {
-			reason: skippedMissReason(cache.disabledByFlag ? "cache reuse turned off by --no-build-cache" : "cache reuse off in config"),
-			diff: null
-		};
-		const current = {
-			hash: storeHash ?? fingerprint,
-			sources: storeSources
-		};
-		const explained = explainBuildMiss({
-			root,
-			platform: "ios",
-			current,
-			rekeyedBy,
-			baselineDeps: { readState: d.readWorkspaceState }
-		});
-		return {
-			reason: explained.reason,
-			diff: explained.previousHash && explained.changedNames.length ? fingerprintDiffRecord({
-				changed: explained.changedNames,
-				previousHash: explained.previousHash,
-				hash: current.hash
-			}) : null
-		};
-	}
-	function reportPendingRecheck(prebuild) {
-		const pods = d.readPodState(root);
-		if ((prebuild === "generate" || prebuild === "regenerate" || podAction(pods, d.podsAreStale(pods.lockText, pods.manifestText)).install) && useBuildCache) miss(reasonForMiss([]).reason, true);
-	}
-	function explainMiss(rekeyedBy) {
-		const explained = reasonForMiss(rekeyedBy);
-		missReason = explained.reason;
-		if (explained.diff) logWriter().write(explained.diff);
-		buildFailure = {
-			...buildFailure,
-			missReason
-		};
-		miss(missReason);
-		phase("cache", `miss: ${missReason.summary}`);
-		if (missReason.kind === "no-baseline") {
-			const untracked = untrackedMissLine(d.untrackedNativeFiles({ projectRoot: root }));
-			if (untracked) note(chalk.dim(phaseLine("fingerprint", untracked)));
-		}
-	}
-	async function settleStoreKeyAfterCompile(prebuildRan) {
-		if (!storeHash || !storeKey) return;
-		const afterBuild = await refingerprintAfterMutation({
-			projectRoot: root,
-			platform: "ios",
-			previousHash: storeHash,
-			fingerprint: d.fingerprintProject
-		});
-		const changedDuringBuild = afterBuild ? inputsChangedDuringBuild({
-			platform: "ios",
-			lookup: fingerprintSources,
-			prebuildRan,
-			compiled: storeSources,
-			current: afterBuild.sources
-		}) : [];
-		if (!afterBuild || changedDuringBuild.length) {
-			storeHash = null;
-			storeKey = null;
-			buildFailure = {
-				...buildFailure,
-				fingerprint: null,
-				cacheKey: null
-			};
-			note(chalk.yellow(phaseLine("fingerprint", afterBuild ? changedDuringBuildLine(changedDuringBuild) : "unavailable after xcodebuild; the build will be installed but not cached")));
-		} else if (afterBuild.moved) {
-			const beforeBuildHash = storeHash;
-			storeHash = afterBuild.hash;
-			storeSources = afterBuild.sources;
-			storeKey = buildCacheKey("ios", afterBuild.hash, keyOptions);
-			buildFailure = {
-				...buildFailure,
-				fingerprint: storeHash,
-				cacheKey: storeKey
-			};
-			note(chalk.dim(phaseLine("fingerprint", `${shortHash(beforeBuildHash)} -> ${shortHash(storeHash)} (after xcodebuild)`)));
-		}
-	}
-	async function takeBuildSlot() {
-		if (!maxBuilds) return;
-		try {
-			buildSlot = await d.acquireBuildSlot({
-				max: maxBuilds,
-				root,
-				logFile,
-				out: note,
-				waitingFor: (info) => waitingFor?.(info, "build-slot")
-			});
-			slotWaitMs = buildSlot.slotWaitMs;
-		} catch (e) {
-			const refusal = (0, ownership_claim_exports.claimFailure)(e, "stim ios");
-			if (refusal) fail({
-				code: refusal.code,
-				message: refusal.message,
-				remedy: refusal.remedy,
-				build: buildFailure
-			});
-			note(chalk.yellow(phaseLine("build", `could not take a build slot: ${e?.message || e}; building anyway`)));
-		}
-	}
-	/** Whether this build should leave this Mac, before any machine is asked; null builds here. */
-	function placeBuild() {
-		const { mode, machines } = buildPlacementCandidates(buildMachine);
-		if (machines.length === 0 && !namedBuildMachine(buildMachine) && buildMachine !== "local") return null;
-		const runtime = physical || release ? null : hostedDestination?.runtime ?? (remoteDestination ? null : simulatorRuntime(udid));
-		const unsupported = physical ? "device builds build here" : remoteDestination && !hostedDestination ? "--remote builds build here" : release ? `${configuration} builds build here` : !cachePolicy.write ? "the build cache is off" : !runtime ? `the runtime of simulator ${udid} is unknown` : null;
-		const here = machineCapacity();
-		const placement = offloadPlacement({
-			mode,
-			machines: machines.length,
-			here,
-			unsupported,
-			selected: buildMachine
-		});
-		if (!placement.offload) {
-			hereReason = placement.reason;
-			if (mode !== "off") phase("build", `placement: here (${placement.reason})`);
-			return null;
-		}
-		return {
-			mode,
-			here,
-			reason: placement.reason,
-			runtime,
-			machines
-		};
-	}
-	/** Asks the paired machines once the post-mutation key is known; null builds here. */
-	async function chooseMachine(candidate) {
-		const choice = await chooseBuildMachine({
-			projectRoot: root,
-			target: {
-				platform: "ios",
-				local: {
-					...iosToolchain(),
-					...hostedDestination ? { arch: hostedDestination.architecture === "x86_64" ? "x64" : "arm64" } : {}
-				},
-				runtime: candidate.runtime,
-				cocoapodsPinned: bundlerPin(root) !== null
-			},
-			mode: candidate.mode,
-			here: candidate.here,
-			note: (line) => note(chalk.dim(phaseLine("build", `offload: ${line}`))),
-			machines: candidate.machines,
-			selected: buildMachine
-		});
-		if (typeof choice === "string") {
-			const only = candidate.machines.length === 1 ? candidate.machines[0].machine : null;
-			if (only && choice.startsWith(`${only}: `)) fallbackMachine = only;
-			fallBack(choice);
-			return null;
-		}
-		openOffload.choice = choice;
-		phase("build", `placement: ${choice.machine} (${candidate.reason}${placementLoad(choice)})`);
-		return choice;
-	}
-	/** Builds on the chosen machine and stores the app under the post-mutation key; false builds here instead unless a machine was named. */
-	async function compileElsewhere({ choice, candidate }) {
-		const runtime = candidate.runtime;
-		if (!storeKey || !storeHash) {
-			if (namedBuildMachine(buildMachine)) fallBack("the build fingerprint or cache key is unavailable");
-			return false;
-		}
-		const stagingDir = join(workspaceDir(root), "offload", "ios");
-		const outcome = await offloadBuild({
-			choice,
-			expectedFingerprint: storeHash,
-			request: {
-				platform: "ios",
-				runtime,
-				configuration,
-				scheme: buildScheme ?? null,
-				isExpo,
-				optimizations
-			},
-			stagingDir,
-			onPhase: (name, msg) => phase(name, remotePhaseText(name, msg, choice.machine)),
-			onEnter: (name) => {
-				if (name === "compile" || name === "build" || name === "prebuild" || name === "pods") {
-					builtOn = choice.machine;
-					buildFailure = {
-						...buildFailure,
-						builtOn
-					};
-				}
-				place({
-					host: choice.machine,
-					phase: name
-				});
-				step(name === "prebuild" || name === "pods" ? name : "compile");
-			},
-			onRecord: (record) => logWriter().write({
-				...record,
-				offloadedTo: choice.machine
-			}),
-			note: (line) => phase("build", line)
-		});
-		place(null);
-		let stored = null;
-		let reason = outcome.ok ? null : outcome.reason;
-		if (outcome.ok) {
-			const settled = await refingerprintAfterMutation({
-				projectRoot: root,
-				platform: "ios",
-				previousHash: storeHash,
-				fingerprint: d.fingerprintProject
-			});
-			if (!settled || settled.moved) reason = "the checkout here changed while it built";
-			else try {
-				stored = d.storeBuild("ios", storeKey, outcome.artifactPath, {
-					sources: storeSources,
-					overwrite: !useBuildCache
-				});
-			} catch (e) {
-				reason = `could not store the app: ${e?.message || e}`;
-			}
-		}
-		try {
-			rmSync(stagingDir, {
-				recursive: true,
-				force: true
-			});
-		} catch {}
-		step("compile");
-		const prepared = stored ? await installableCachedApp(stored) : null;
-		if (!outcome.ok || !prepared) {
-			const why = reason ?? "the stored app is not installable";
-			fallbackMachine = choice.machine;
-			fallBack(`${choice.machine}: ${why}`, `offload failed: ${why}`);
-			logWriter().write({
-				src: "build",
-				level: "warn",
-				event: "offload_failed",
-				msg: reason,
-				machine: choice.machine
-			});
-			return false;
-		}
-		const { timings } = outcome;
-		appPath = prepared;
-		builtOn = outcome.machine;
-		offloadedTo = outcome.machine;
-		handoff = outcome.handoff ?? null;
-		stats.setPlacement({
-			decision: "offloaded",
-			machine: outcome.machine,
-			reason: `${candidate.reason}${placementLoad(choice)}`,
-			buildMs: timings.totalMs
-		});
-		phase("build", `built on ${outcome.machine} in ${formatDuration(timings.totalMs)}: offer ${formatDuration(timings.offerMs)}, sync ${formatDuration(timings.syncMs)}, build ${formatDuration(timings.workerMs)}, fetch ${formatDuration(timings.fetchMs)}`);
-		compilationCache = outcome.compilationCache;
-		phase("cache", `compilation cache on ${outcome.machine} ${compilationCacheActivityLine(compilationCache)}`);
-		logWriter().write({
-			src: "build",
-			level: "info",
-			event: "offload_done",
-			msg: `built on ${outcome.machine}`,
-			timings
-		});
-		return true;
-	}
-	async function buildArtifact() {
-		buildFailure = {
-			fingerprint,
-			cacheKey,
-			cacheHit,
-			cacheSkipped: !useBuildCache,
-			buildMachine
-		};
-		if (!appPath) {
-			const offload = placeBuild();
-			if (!offload) await takeBuildSlot();
-			const mutatingSteps = [];
-			const rekeyedBy = [];
-			const prebuild = d.planPrebuild(root, "ios", {
-				isExpo,
-				fingerprint,
-				sources: fingerprintSources
-			});
-			if (prebuild === "refuse") fail({
-				...staleNativeDirRefusal("ios"),
-				build: buildFailure
-			});
-			reportPendingRecheck(prebuild);
-			if (prebuild === "generate" || prebuild === "regenerate") {
-				step("prebuild");
-				recordPrebuild(root, "ios", null);
-				const result = await d.runPrebuild(root, "ios", logWriter(), { clean: prebuild === "regenerate" });
-				if (result?.failed) {
-					phase("prebuild", "FAILED");
-					fail({
-						code: result.code || "STIM_PREBUILD_FAILED",
-						message: result.reason || "expo prebuild failed.",
-						remedy: result.remedy || `See ${logFile} for the transcript.`,
-						lines: (result.lastLines || []).slice(-5),
-						build: buildFailure
-					});
-				}
-				phase("prebuild", `${prebuild === "generate" ? "ios/ absent -> generated" : "ios/ not generated from this fingerprint -> regenerated with --clean"} (${formatDuration(result?.durationMs ?? 0)})`);
-				mutatingSteps.push("prebuild");
-			}
-			if (isExpo && buildScheme !== void 0) {
-				const project = d.discoverXcodeProject(root);
-				if (project.error) fail({
-					...project.error,
-					build: buildFailure
-				});
-				const schemeError = d.resolveScheme(project, { scheme: buildScheme }).error;
-				if (schemeError) fail({
-					...schemeError,
-					build: buildFailure
-				});
-			}
-			const podState = d.readPodState(root);
-			const verdict = d.podsAreStale(podState.lockText, podState.manifestText);
-			const action = podAction(podState, verdict);
-			if (action.install) {
-				step("pods");
-				const result = await d.runPodInstall(root, logWriter(), { estimateMs: estimates().podsMs });
-				const podCommand = result?.command || "pod install";
-				for (const line of result?.notes || []) note(chalk.dim(phaseLine("pods", line)));
-				if (result?.failed) {
-					phase("pods", "FAILED");
-					fail({
-						code: result.code || "STIM_DEPS_FAILED",
-						message: result.reason || "`pod install` failed.",
-						remedy: result.remedy || `See ${logFile} for the transcript.`,
-						lines: result.diagnosticLines?.length ? result.diagnosticLines : (result.lastLines || []).slice(-5),
-						build: buildFailure
-					});
-				}
-				stats.setPodsMs(result?.durationMs ?? 0);
-				phase("pods", `${action.reason} -> installed with \`${podCommand}\` (${formatDuration(result?.durationMs ?? 0)})`);
-				mutatingSteps.push(podCommand);
-			}
-			if (mutatingSteps.length) {
-				const after = await refingerprintAfterMutation({
-					projectRoot: root,
-					platform: "ios",
-					previousHash: fingerprint,
-					fingerprint: d.fingerprintProject
-				});
-				const prebuildRan = mutatingSteps.includes("prebuild");
-				const editedConfig = after ? configInputsChanged(fingerprintSources, after.sources, { prebuildRan }) : [];
-				if (after && !editedConfig.length && prebuildRan) recordPrebuild(root, "ios", after.hash);
-				if (!after || editedConfig.length) {
-					storeHash = null;
-					storeKey = null;
-					buildFailure = {
-						...buildFailure,
-						fingerprint: null,
-						cacheKey: null
-					};
-					note(chalk.yellow(phaseLine("fingerprint", after ? changedDuringBuildLine(editedConfig) : `unavailable after ${mutatingSteps.join(", ")}; the build will be installed but not cached`)));
-				} else if (after.moved) {
-					rekeyedBy.push(...mutatingSteps.map((mutation) => mutation === "prebuild" ? mutation : "pod install"));
-					storeHash = after.hash;
-					storeSources = after.sources;
-					storeKey = buildCacheKey("ios", after.hash, keyOptions);
-					buildFailure = {
-						...buildFailure,
-						fingerprint: storeHash,
-						cacheKey: storeKey
-					};
-					note(chalk.dim(phaseLine("fingerprint", `${shortHash(fingerprint)} -> ${shortHash(storeHash)} (after ${mutatingSteps.join(", ")})`)));
-					const late = useBuildCache ? d.resolveBuild("ios", storeKey) : null;
-					if (late) {
-						const prepared = await installableCachedApp(late);
-						if (prepared) {
-							appPath = prepared;
-							cacheHit = "local";
-							lateHit();
-							phase("cache", `hit ${shortHash(storeHash)} (post-${mutatingSteps.join("/")} key)`);
-							if (releasedWait) {
-								waitedForBuild = releasedWait.facts;
-								phase("build", `waited ${formatDuration(waitedForBuild.ms)} for ${releasedWait.who}'s build -> installed from cache -- stim guide lifecycle concurrency`);
-							}
-						}
-					}
-				}
-			}
-			if (offload && !appPath) {
-				explainMiss(rekeyedBy);
-				step("compile");
-				if (!storeKey) fallBack("no cache key to store the app under", "offload failed: no cache key to store the app under");
-				const choice = storeKey ? await chooseMachine(offload) : null;
-				if (!choice || !await compileElsewhere({
-					choice,
-					candidate: offload
-				})) await takeBuildSlot();
-			}
-			if (!appPath) {
-				if (!offload) explainMiss(rekeyedBy);
-				step("compile");
-				if (offload) stats.setPlacement({
-					decision: "fell-back",
-					slotWaitMs,
-					deviceSlotWaitMs: stats.deviceSlotWaitMs(),
-					reason: offloadFallback ?? "offload failed",
-					...fallbackMachine ? { machine: fallbackMachine } : {}
-				});
-				else stats.setPlacement({
-					decision: "here",
-					reason: hereReason,
-					slotWaitMs,
-					deviceSlotWaitMs: stats.deviceSlotWaitMs()
-				});
-				builtOn = "here";
-				buildFailure = {
-					...buildFailure,
-					builtOn
-				};
-				phase("build", `compiling ${configuration || "Debug"} with xcodebuild`);
-				const result = await d.buildIos({
-					root,
-					scheme: buildScheme,
-					udid,
-					destination: remoteDestination ? GENERIC_SIM_DESTINATION : null,
-					arch: remoteDestination ? simulatorArch : null,
-					...physical ? { sdk: IPHONEOS_SDK } : {},
-					logWriter: logWriter(),
-					...configuration ? { configuration } : {},
-					estimateMs: estimates().coldBuildMs,
-					optimizations
-				});
-				compilationCache = result.compilationCache;
-				phase("cache", `compilation cache ${compilationCacheActivityLine(compilationCache)}`);
-				if (!result.ok) {
-					phase("build", `FAILED after ${formatDuration(result.durationMs)}`);
-					printDiagnostics(note, result);
-					const report = xcodeFailureReport(result, logFile);
-					fail({
-						code: result.code,
-						message: report.message,
-						remedy: report.remedy,
-						logPath: logFile,
-						build: {
-							...buildFailure,
-							diagnostics: result.diagnostics
-						}
-					});
-				}
-				stats.setBuildMs(result.durationMs);
-				phase("build", `ok (${formatDuration(result.durationMs)})`);
-				appPath = result.appPath;
-				bundleId = result.bundleId;
-				await settleStoreKeyAfterCompile(mutatingSteps.includes("prebuild"));
-				if (storeKey && cachePolicy.write) try {
-					const stored = await storeTieredBuild({
-						local: filesystemBuildCapability({
-							resolve: d.resolveBuild,
-							store: d.storeBuild,
-							sources: storeSources
-						}),
-						loadProvider,
-						target: {
-							projectRoot: root,
-							platform: "ios",
-							key: storeKey
-						},
-						sourcePath: appPath,
-						overwrite: !useBuildCache || swapFellBack,
-						warn: cacheWarn
-					});
-					providerUpload = stored.providerUpload;
-					providerName = stored.providerName ?? providerName;
-				} catch (e) {
-					note(chalk.yellow(`Could not store the build in the shared cache: ${e?.message || e}`));
-				}
-				if (physical) {
-					const prepared = await prepareDeviceApp(appPath, { fresh: true });
-					if (!prepared) return;
-					appPath = prepared;
-				}
-				if (remote && !physical && storeHash) uploadPending = d.uploadRemote({
-					logWriter: logWriter(),
-					provider: remote.provider,
-					platform: "ios",
-					projectRoot: root,
-					fingerprintHash: storeHash,
-					buildPath: appPath,
-					runOptions: providerRunOptions
-				});
-			}
-		}
-	}
-	let transferred = false;
-	try {
-		await resolveInitialFingerprint();
-		if (!easBuild) {
-			remote = await resolveRemoteArtifact();
-			if (!appPath) miss(reasonForMiss([]).reason);
-			await awaitSharedBuild();
-			await prepareCachedArtifact();
-			if (appPath) lateHit();
-			else if (swapFellBack) miss(reasonForMiss([]).reason);
-			await buildArtifact();
-		}
-		const artifact = {
-			handoff,
-			path: appPath,
-			bundleId,
-			cache: {
-				identity: storeHash && storeKey ? {
-					fingerprint: storeHash,
-					key: storeKey
-				} : null,
-				hit: cacheHit,
-				providerName: remote?.name ?? providerName,
-				buildMachine,
-				...builtOn ? { builtOn } : {},
-				offloadedTo,
-				offloadFallback: offloadedTo ? null : offloadFallback,
-				readEnabled: useBuildCache,
-				missReason: cacheHit ? null : missReason,
-				waitedForBuild,
-				compilation: compilationCache
-			},
-			failureFields: {
-				...buildFailure,
-				buildMachine,
-				...builtOn ? { builtOn } : {},
-				fingerprint: storeHash,
-				cacheKey: storeKey,
-				cacheHit,
-				cacheSkipped: !useBuildCache
-			},
-			completeUploads: async () => {
-				const uploadWasAbandoned = await finishIosUpload(uploadPending, remote, phase, note);
-				const outcome = providerUploadOutcome(providerUpload ? await providerUpload : null, providerName);
-				if (outcome) {
-					if (outcome.warn) note(chalk.yellow(phaseLine("cache", outcome.line)));
-					else phase("cache", outcome.line);
-				}
-				return abandonedRemote || uploadWasAbandoned;
-			},
-			release: releaseArtifact
-		};
-		transferred = true;
-		return {
-			ok: true,
-			artifact
-		};
-	} catch (error) {
-		if (error instanceof OffloadRefusal) {
-			const refusal = error;
-			return {
-				ok: false,
-				failure: {
-					code: refusal.code,
-					message: refusal.message,
-					remedy: refusal.remedy,
-					build: {
-						...buildFailure,
-						buildMachine,
-						...builtOn ? { builtOn } : {}
-					}
-				},
-				compilationCache
-			};
-		}
-		if (error instanceof ArtifactRefusal) return {
-			ok: false,
-			failure: error.failure,
-			compilationCache
-		};
-		throw error;
-	} finally {
-		if (openOffload.choice) closeOffload(openOffload.choice);
-		releaseLock();
-		releaseSlot();
-		if (!transferred) releaseArtifact();
-	}
-}
-//#endregion
-//#region src/commands/ios/remote.ts
-function resolveIosRemote({ opts, settings, physical, recorded }) {
-	const target = opts.remote !== void 0 ? parseIosRemote(opts.remote) : remoteIosSetting(settings);
-	if (physical && target?.kind === "machine") return { failure: {
-		code: "STIM_BAD_ARG",
-		message: "--device builds for a phone connected to this machine, and --remote installs on a remote one.",
-		remedy: "Pass only one of --device and --remote; unset ios.remote for a local phone."
-	} };
-	const machine = target?.kind === "machine" ? target.machine : null;
-	if (recorded && recorded.machine !== machine && machine !== "auto") return { failure: {
-		code: "STIM_BAD_ARG",
-		message: `This workspace's iOS simulator runs on ${recorded.machine}; run stim stop first.`
-	} };
-	return {
-		machine,
-		backend: !physical && target?.kind === "backend" ? target.backend : null,
-		recorded
-	};
-}
-function selectIosTarget({ root, slot, opts, settings, physical, release, metroCheck, d }) {
-	let recorded;
-	try {
-		recorded = d.readHostedIos(root, slot)[slot];
-	} catch (error) {
-		return { failure: {
-			code: "STIM_HOSTING_REFUSED",
-			message: error.message,
-			...error instanceof Error && "remedy" in error && typeof error.remedy === "string" ? { remedy: error.remedy } : {}
-		} };
-	}
-	const selection = resolveIosRemote({
-		opts,
-		settings,
-		physical,
-		recorded
-	});
-	if ("failure" in selection) return selection;
-	const localIos = selection.machine ? deviceSlotPlatforms(d.getProject(root), slot)?.ios : void 0;
-	if (selection.machine !== "auto" && selection.machine && localIos?.owned && localIos.deviceUdid) {
-		let localRunning = true;
-		try {
-			localRunning = d.listAllIosSims({ timeoutMs: 5e3 }).some((sim) => sim.udid === localIos.deviceUdid && sim.state !== "Shutdown");
-		} catch {}
-		if (localRunning) return { failure: {
-			code: "STIM_BAD_ARG",
-			message: `This workspace's iOS simulator for slot ${slot} runs on this Mac; run stim stop first.`
-		} };
-	}
-	if (selection.machine !== "auto" && selection.machine && !release && !metroCheck) return { failure: {
-		code: "STIM_BAD_ARG",
-		message: "Hosted Debug runs require the local Metro supervisor; --no-metro-check cannot be used.",
-		remedy: "Run stim stop; stim start, then retry without --no-metro-check."
-	} };
-	return selection;
-}
-async function selectIosPlacement(args) {
-	const selection = selectIosTarget(args);
-	if ("failure" in selection || selection.machine !== "auto") return selection;
-	const { root, slot, d, opts, deviceType, runtime, noWait, phase, release, metroCheck } = args;
-	const viewer = resolveSimulatorAppFlag(opts.simulatorApp, args.physical, null);
-	if ("refusal" in viewer) return { failure: viewer.refusal };
-	const refusal = args.validateSelectors();
-	if (refusal) return { failure: refusal };
-	try {
-		const placed = await d.automaticDevicePlacement({
-			root,
-			slot,
-			platform: "ios",
-			selectors: hostedIosSelectors(deviceType, runtime),
-			buildMachine: opts.remoteBuild,
-			noWait
-		});
-		phase("placement:", devicePlacementLine(placed.placement, placed.skipped));
-		if (placed.target && !release && !metroCheck) return { failure: {
-			code: "STIM_BAD_ARG",
-			message: "Hosted Debug runs require the local Metro supervisor; --no-metro-check cannot be used.",
-			remedy: "Run stim stop; stim start, then retry without --no-metro-check."
-		} };
-		return {
-			...selection,
-			machine: placed.target?.host.machine ?? null,
-			recorded: void 0,
-			auto: { target: placed.target },
-			budget: placed.target ? {
-				reclaimed: [],
-				refusal: null
-			} : void 0,
-			devicePlacement: placed.placement
-		};
-	} catch (error) {
-		return { failure: {
-			code: error.code ?? "STIM_HOSTING_REFUSED",
-			message: error.message,
-			...error instanceof Error && "remedy" in error && typeof error.remedy === "string" ? { remedy: error.remedy } : {}
-		} };
-	}
-}
-function hostedIosSelectors(deviceType, runtime) {
-	return {
-		...deviceType ? { deviceType } : {},
-		...runtime ? { runtime } : {}
-	};
-}
-async function connectIosTarget(selection, selectors, d) {
-	if (selection.auto) return { target: selection.auto.target };
-	if (!selection.machine) return { target: null };
-	try {
-		return { target: await d.prepareHostedIos(selection.machine, selectors, selection.recorded) };
-	} catch (error) {
-		return { failure: {
-			code: error instanceof Error && "code" in error && typeof error.code === "string" ? error.code : "STIM_HOSTING_REFUSED",
-			message: error instanceof Error ? error.message : String(error),
-			...error instanceof Error && "remedy" in error && typeof error.remedy === "string" ? { remedy: error.remedy } : {}
-		} };
-	}
-}
-function hostedIosBuildTarget(target) {
-	return target ? { hostedDestination: {
-		runtime: target.choice.runtimeId,
-		architecture: target.choice.architecture
-	} } : {};
-}
-async function iosPlacementBudget(d, root, note, hosted, automatic) {
-	if (automatic) return {
-		...automatic,
-		refusal: hosted ? null : automatic.refusal
-	};
-	return hosted ? {
-		reclaimed: [],
-		refusal: null
-	} : d.budgetGate({
-		root,
-		note
-	});
-}
-function hostedIosMetroNote(hosted, settings, note, simulatorApp) {
-	if (hosted && (settings.iosSimulatorApp !== void 0 || simulatorApp !== void 0)) note(chalk.dim(phaseLine("device", "iosSimulatorApp is ignored on a hosting Mac; the simulator boots headless.")));
-	if (hosted && (publicUrlSetting(settings) || tunnelModeSetting(settings))) note(chalk.dim(phaseLine("metro", "metro.publicUrl and metro.tunnel are ignored on a hosting Mac; Metro uses the private tailnet bridge.")));
-}
-async function connectIosBackend(root, backend, deviceType, d) {
-	if (!backend) return {
-		remote: null,
-		arch: null
-	};
-	const resolved = await d.resolveRemoteContext({
-		root,
-		backend,
-		easBin: d.resolveEasCliBin(root)?.file ?? null,
-		deviceType: deviceType?.trim() || null
-	});
-	if ("failed" in resolved) return { failure: {
-		code: resolved.code ?? "STIM_NO_REMOTE_SESSION",
-		message: resolved.failed,
-		remedy: resolved.remedy
-	} };
-	return {
-		remote: d.remoteIosDeps(resolved.ctx),
-		arch: await d.readRemoteSimulatorArch(resolved.ctx.existingDaemon)
-	};
-}
-//#endregion
-//#region src/commands/ios/hosted.ts
-async function finishHostedIosRun({ target, d, artifact, root, slot, release, isExpo, metroCheck, metroPort, logsDir, fail, note, selectors, ...report }) {
-	const bundleId = artifact.bundleId ?? (d.readBundleId(artifact.path) || d.detectBundleId(root));
-	if (!bundleId) return fail({
-		code: "STIM_INSTALL_FAILED",
-		message: "The built app has no bundle identifier."
-	});
-	const launchedAt = d.now();
-	let run;
-	try {
-		run = await d.placeHostedIos(target, {
-			root,
-			slot,
-			bundle: artifact.path,
-			handoff: artifact.handoff,
-			bundleId,
-			selectors,
-			release,
-			...!release && isExpo ? { devClientScheme: d.devClientScheme(root, artifact.path) ?? void 0 } : {},
-			reserved: (placement) => d.writeHostedIos(root, slot, placement),
-			note
-		});
-	} catch (error) {
-		return fail({
-			code: error.code ?? "STIM_HOSTING_REFUSED",
-			message: error.message,
-			remedy: error instanceof Error && "remedy" in error && typeof error.remedy === "string" ? error.remedy : `Retry stim ios --remote ${target.host.machine}, or run stim stop to reconcile any recorded placement.`
-		});
-	}
-	d.writeHostedIos(root, slot, run.placement);
-	d.writeWorkspaceLaunch(root, "ios", {
-		appId: bundleId,
-		deviceId: run.placement.session,
-		metroPort,
-		release,
-		launchedAt: new Date(launchedAt).toISOString()
-	}, slot);
-	let launched = run.launched;
-	if (!release && metroCheck) {
-		const evidence = await d.verifyLaunch({
-			requireBundleResponse: true,
-			platform: "ios",
-			logsDir,
-			since: launchedAt,
-			metroPort,
-			mode: isExpo ? MODE_EXPO : MODE_BARE,
-			slot: launchSlotScope(root, slot),
-			platformShared: siblingPlatformSlots(root, "ios", slot).length > 0
-		});
-		if (evidence.fatal) return fail({
-			code: "STIM_LAUNCH_FAILED",
-			message: "Metro could not deliver the hosted app bundle.",
-			remedy: "Run stim logs --errors and fix the bundle error."
-		});
-		launched = evidence.verified ? true : evidence.requested ? "bundling" : "unverified";
-	}
-	if (launched === "unverified") note(`Launch on ${target.host.machine} is unverified; check the hosted app, then retry stim ios --remote ${target.host.machine}.`);
-	const cache = artifact.cache;
-	const device = run.placement.device;
-	const uploadsAbandoned = await artifact.completeUploads();
-	return {
-		facts: reportIosResult({
-			...report,
-			root,
-			slot,
-			release,
-			metroCheck,
-			metroPort,
-			logsDir,
-			device: {
-				deviceName: device.deviceType,
-				deviceType: device.deviceType,
-				runtime: device.runtime
-			},
-			udid: "",
-			host: hostedIosStatus(run.placement),
-			appPath: artifact.path,
-			bundleId,
-			installSkipped: false,
-			storeHash: cache.identity?.fingerprint ?? null,
-			storeKey: cache.identity?.key ?? null,
-			cacheHit: cache.hit,
-			missReason: cache.missReason,
-			compilationCache: cache.compilation,
-			useBuildCache: cache.readEnabled,
-			waitedForBuild: cache.waitedForBuild,
-			launchState: launched,
-			providerName: cache.providerName,
-			buildMachine: cache.buildMachine,
-			builtOn: cache.builtOn,
-			offloadedTo: cache.offloadedTo,
-			offloadFallback: cache.offloadFallback,
-			webPreviewUrl: null
-		}),
-		uploadsAbandoned
-	};
-}
-//#endregion
-//#region src/engine/ios-profile.ts
-const TAG = /<(\/?)\s*([A-Za-z0-9_]+)(?:\s[^>]*?)?(\/?)>/g;
-const ENTITIES = {
-	amp: "&",
-	lt: "<",
-	gt: ">",
-	quot: "\"",
-	apos: "'"
-};
-var PlistError = class extends Error {};
-function codePoint(value) {
-	if (!Number.isInteger(value) || value < 0 || value > 1114111 || value >= 55296 && value <= 57343) throw new PlistError(`character reference out of range: ${value}`);
-	return String.fromCodePoint(value);
-}
-function decodeEntities(raw) {
-	return raw.replace(/&(#x?[0-9A-Fa-f]+|[a-z]+);/g, (match, body) => {
-		if (body.startsWith("#x") || body.startsWith("#X")) return codePoint(Number.parseInt(body.slice(2), 16));
-		if (body.startsWith("#")) return codePoint(Number.parseInt(body.slice(1), 10));
-		return ENTITIES[body] ?? match;
-	});
-}
-function peekTag(cursor) {
-	TAG.lastIndex = cursor.pos;
-	const match = TAG.exec(cursor.xml);
-	if (!match) return null;
-	return {
-		name: (match[2] ?? "").toLowerCase(),
-		closing: match[1] === "/",
-		selfClosing: match[3] === "/",
-		end: TAG.lastIndex
-	};
-}
-function takeTag(cursor) {
-	const tag = peekTag(cursor);
-	if (tag) cursor.pos = tag.end;
-	return tag;
-}
-function takeText(cursor, name) {
-	const close = cursor.xml.indexOf(`</${name}>`, cursor.pos);
-	if (close < 0) {
-		cursor.pos = cursor.xml.length;
-		return "";
-	}
-	const raw = cursor.xml.slice(cursor.pos, close);
-	cursor.pos = close + name.length + 3;
-	return raw;
-}
-function parseValue(cursor) {
-	const peeked = peekTag(cursor);
-	if (!peeked || peeked.closing) return void 0;
-	const tag = takeTag(cursor);
-	if (tag.selfClosing) {
-		if (tag.name === "true") return true;
-		if (tag.name === "false") return false;
-		if (tag.name === "array") return [];
-		if (tag.name === "dict") return {};
-		return "";
-	}
-	switch (tag.name) {
-		case "plist": return parseValue(cursor);
-		case "dict": {
-			const out = {};
-			for (;;) {
-				const next = peekTag(cursor);
-				if (!next) break;
-				if (next.closing) {
-					cursor.pos = next.end;
-					break;
-				}
-				cursor.pos = next.end;
-				if (next.name !== "key") continue;
-				const key = decodeEntities(next.selfClosing ? "" : takeText(cursor, "key"));
-				const value = parseValue(cursor);
-				if (value !== void 0) out[key] = value;
-			}
-			return out;
-		}
-		case "array": {
-			const out = [];
-			for (;;) {
-				const next = peekTag(cursor);
-				if (!next) break;
-				if (next.closing) {
-					cursor.pos = next.end;
-					break;
-				}
-				const value = parseValue(cursor);
-				if (value === void 0) break;
-				out.push(value);
-			}
-			return out;
-		}
-		case "string":
-		case "key": return decodeEntities(takeText(cursor, tag.name));
-		case "integer": return Number.parseInt(takeText(cursor, "integer").trim(), 10);
-		case "real": return Number.parseFloat(takeText(cursor, "real").trim());
-		case "date": return new Date(takeText(cursor, "date").trim());
-		case "data": return Buffer.from(takeText(cursor, "data").replace(/\s+/g, ""), "base64");
-		case "true":
-			takeText(cursor, "true");
-			return true;
-		case "false":
-			takeText(cursor, "false");
-			return false;
-		default:
-			takeText(cursor, tag.name);
-			return "";
-	}
-}
-function parsePlist(xml) {
-	if (typeof xml !== "string" || xml.trim() === "") return null;
-	const stripped = xml.replace(/<!--[\s\S]*?-->/g, "");
-	const start = stripped.indexOf("<plist");
-	const cursor = {
-		xml: stripped,
-		pos: start < 0 ? 0 : start
-	};
-	try {
-		const value = parseValue(cursor);
-		return value === void 0 ? null : value;
-	} catch {
-		return null;
-	}
-}
-function isDict(value) {
-	return value !== null && typeof value === "object" && !Array.isArray(value) && !Buffer.isBuffer(value) && !(value instanceof Date);
-}
-function stringsOf(value) {
-	if (!Array.isArray(value)) return null;
-	return value.filter((v) => typeof v === "string");
-}
-function parseProvisioningProfilePlist(xml) {
-	const root = parsePlist(xml);
-	if (!isDict(root)) return null;
-	const entitlements = isDict(root.Entitlements ?? null) ? root.Entitlements : {};
-	const teamIdentifier = stringsOf(root.TeamIdentifier);
-	const expiration = root.ExpirationDate;
-	const certificates = Array.isArray(root.DeveloperCertificates) ? root.DeveloperCertificates.filter((v) => Buffer.isBuffer(v)) : [];
-	return {
-		name: typeof root.Name === "string" ? root.Name : null,
-		uuid: typeof root.UUID === "string" ? root.UUID : null,
-		teamIdentifier: teamIdentifier?.[0] ?? null,
-		expirationDate: expiration instanceof Date && !Number.isNaN(expiration.getTime()) ? expiration : null,
-		provisionedDevices: stringsOf(root.ProvisionedDevices),
-		provisionsAllDevices: root.ProvisionsAllDevices === true,
-		getTaskAllow: entitlements["get-task-allow"] === true,
-		certificates
-	};
-}
-function provisioningProfileKind(profile) {
-	if (profile.provisionedDevices) return profile.getTaskAllow ? "development" : "ad hoc";
-	return profile.provisionsAllDevices ? "enterprise" : "App Store";
-}
-function certificateCommonName(der) {
-	if (!Buffer.isBuffer(der) || der.length === 0) return null;
-	let subject;
-	try {
-		subject = new X509Certificate(der).subject;
-	} catch {
-		return null;
-	}
-	for (const part of String(subject).split(/\r?\n/)) {
-		const trimmed = part.trim();
-		if (trimmed.startsWith("CN=")) return trimmed.slice(3).trim() || null;
-	}
-	return /(?:^|,)\s*CN=([^,]+)/.exec(String(subject))?.[1]?.trim() || null;
-}
-const IDENTITY_LINE = /^\s*\d+\)\s+([0-9A-Fa-f]{40})\s+"(.+)"\s*$/;
-function parseSigningIdentities(text) {
-	if (typeof text !== "string") return [];
-	const out = [];
-	for (const line of text.split(/\r?\n/)) {
-		const match = IDENTITY_LINE.exec(line);
-		if (!match) continue;
-		out.push({
-			sha1: match[1].toUpperCase(),
-			name: match[2]
-		});
-	}
-	return out;
-}
-const SIGNING_CODES = {
-	noProfile: "STIM_NO_PROFILE",
-	profileMismatch: "STIM_PROFILE_MISMATCH",
-	noIdentity: "STIM_NO_SIGNING_IDENTITY",
-	codesignFailed: "STIM_CODESIGN_FAILED"
-};
-const XCODE_STEP = "build once from Xcode to install it -- Stim will not, because registering a device or minting a profile changes your Apple Developer account.";
-const KEYCHAIN_REMEDY = "Open Xcode > Settings > Accounts and download your certificates, or unlock the login keychain with `security unlock-keychain`. `security find-identity -v -p codesigning` should list `Apple Development: ...`.";
-function signingConfiguration(input) {
-	return input.configuration ?? "Debug";
-}
-function profileGate(input) {
-	const now = input.now ?? Date.now();
-	if (!input.profilePresent) return {
-		ok: false,
-		code: SIGNING_CODES.noProfile,
-		reason: "The app bundle has no embedded.mobileprovision, so it was built unsigned or for the simulator.",
-		remedy: `Set a team and profile for the target's ${signingConfiguration(input)} configuration in Xcode > Signing & Capabilities, then ${XCODE_STEP}`
-	};
-	if (!input.profile) return {
-		ok: false,
-		code: SIGNING_CODES.noProfile,
-		reason: "`openssl smime` could not decode the app bundle's embedded.mobileprovision.",
-		remedy: `The profile inside the app is corrupt. Delete the build cache entry with \`stim gc --delete\`, then ${XCODE_STEP}`
-	};
-	const profile = input.profile;
-	const named = profile.name ? `"${profile.name}"` : "the embedded profile";
-	if (!profile.expirationDate || profile.expirationDate.getTime() <= now) return {
-		ok: false,
-		code: SIGNING_CODES.profileMismatch,
-		reason: profile.expirationDate ? `The ${provisioningProfileKind(profile)} profile ${named} expired on ${profile.expirationDate.toISOString()}.` : `The ${provisioningProfileKind(profile)} profile ${named} carries no ExpirationDate, so Stim cannot prove it is still valid.`,
-		remedy: `Renew the profile under Signing & Capabilities, then ${XCODE_STEP}`
-	};
-	if (!profile.provisionedDevices) {
-		const kind = provisioningProfileKind(profile);
-		return {
-			ok: false,
-			code: SIGNING_CODES.profileMismatch,
-			reason: `${named} is an ${kind} profile, which carries no ProvisionedDevices list, so Stim cannot prove ${input.udid ?? "the target device"} is admitted.`,
-			remedy: `Local device runs need a development profile. Select one under Signing & Capabilities, then ${XCODE_STEP}`
-		};
-	}
-	const udid = input.udid;
-	if (!udid || !profile.provisionedDevices.some((d) => d.toLowerCase() === udid.toLowerCase())) return {
-		ok: false,
-		code: SIGNING_CODES.profileMismatch,
-		reason: `The ${provisioningProfileKind(profile)} profile ${named} lists ${profile.provisionedDevices.length} device(s) and ${udid ?? "the target device"} is not one of them.`,
-		remedy: `Register ${udid ?? "the device"} at developer.apple.com, regenerate the profile, then ${XCODE_STEP}`
-	};
-	return {
-		ok: true,
-		profile
-	};
-}
-function signingGate(input) {
-	const gated = profileGate(input);
-	if (!gated.ok) return gated;
-	const profile = gated.profile;
-	const named = profile.name ? `"${profile.name}"` : "the embedded profile";
-	const identities = Array.isArray(input.identities) ? input.identities : [];
-	if (identities.length === 0) return {
-		ok: false,
-		code: SIGNING_CODES.noIdentity,
-		reason: "`security find-identity -v -p codesigning` lists no codesigning identity on this machine.",
-		remedy: KEYCHAIN_REMEDY
-	};
-	if (input.pinnedSha1) {
-		const wanted = input.pinnedSha1.trim().toUpperCase();
-		const match = identities.find((i) => i.sha1 === wanted);
-		if (match) return {
-			ok: true,
-			identity: match
-		};
-		return {
-			ok: false,
-			code: SIGNING_CODES.noIdentity,
-			reason: `ios.signingIdentitySha1 is ${wanted}, which is not in the keychain. Available: ${identities.map((i) => `${i.sha1} "${i.name}"`).join(", ")}.`,
-			remedy: KEYCHAIN_REMEDY
-		};
-	}
-	const wantedName = input.pinnedName?.trim() || certificateCommonName(profile.certificates[0] ?? null);
-	if (!wantedName) return {
-		ok: false,
-		code: SIGNING_CODES.noIdentity,
-		reason: `Stim could not read a signing-identity name out of ${named}: its DeveloperCertificates entry has no readable subject CN.`,
-		remedy: "Set ios.signingIdentity in .stim.json to the identity name to re-sign with, or ios.signingIdentitySha1 to its SHA-1 hash."
-	};
-	const matches = identities.filter((i) => i.name === wantedName);
-	if (matches.length === 1) return {
-		ok: true,
-		identity: matches[0]
-	};
-	if (matches.length === 0) return {
-		ok: false,
-		code: SIGNING_CODES.noIdentity,
-		reason: `The app was signed by "${wantedName}", which is not in this machine's keychain. Available: ${identities.map((i) => `"${i.name}"`).join(", ")}.`,
-		remedy: `${KEYCHAIN_REMEDY} Or set ios.signingIdentity in .stim.json to one of the identities listed above.`
-	};
-	return {
-		ok: false,
-		code: SIGNING_CODES.noIdentity,
-		reason: `${matches.length} keychain identities share the name "${wantedName}", so Stim cannot pick one: ${matches.map((i) => i.sha1).join(", ")}.`,
-		remedy: "Set ios.signingIdentitySha1 in .stim.json to the SHA-1 hash of the certificate to sign with."
-	};
-}
-//#endregion
-//#region src/engine/ios-signing.ts
-const EMBEDDED_PROFILE = "embedded.mobileprovision";
-const SIGNING_TIMEOUT_MS = 12e4;
-function lastLines(text, count = 5) {
-	return String(text ?? "").split(/\r?\n/).map((line) => line.trimEnd()).filter((line) => line.trim() !== "").slice(-count);
-}
-function errorText(error) {
-	const withOutput = error;
-	const stderr = String(withOutput?.stderr ?? "").trim();
-	const stdout = String(withOutput?.stdout ?? "").trim();
-	return stderr || stdout || String(withOutput?.message ?? error);
-}
-function readEmbeddedProfile(appPath, { exec = null } = {}) {
-	const executor = exec || getExecutor();
-	const path = join(appPath, EMBEDDED_PROFILE);
-	if (!existsSync(path)) return {
-		present: false,
-		profile: null
-	};
-	try {
-		return {
-			present: true,
-			profile: parseProvisioningProfilePlist(executor.runFile("/usr/bin/openssl", [
-				"smime",
-				"-verify",
-				"-noverify",
-				"-inform",
-				"DER",
-				"-in",
-				path
-			], { timeoutMs: SIGNING_TIMEOUT_MS }))
-		};
-	} catch {
-		return {
-			present: true,
-			profile: null
-		};
-	}
-}
-function findSigningIdentities({ exec = null } = {}) {
-	const executor = exec || getExecutor();
-	try {
-		return parseSigningIdentities(executor.runFile("security", [
-			"find-identity",
-			"-v",
-			"-p",
-			"codesigning"
-		], { timeoutMs: SIGNING_TIMEOUT_MS }));
-	} catch {
-		return [];
-	}
-}
-function gateProfileForDevice(options) {
-	const read = readEmbeddedProfile(options.appPath, { exec: options.exec ?? null });
-	return profileGate({
-		profilePresent: read.present,
-		profile: read.profile,
-		identities: [],
-		udid: options.udid,
-		configuration: options.configuration ?? null,
-		...options.now === void 0 ? {} : { now: options.now }
-	});
-}
-function gateAppForDevice(options) {
-	const read = readEmbeddedProfile(options.appPath, { exec: options.exec ?? null });
-	return signingGate({
-		profilePresent: read.present,
-		profile: read.profile,
-		identities: read.present ? findSigningIdentities({ exec: options.exec ?? null }) : [],
-		udid: options.udid,
-		configuration: options.configuration ?? null,
-		pinnedName: options.pinnedName ?? null,
-		pinnedSha1: options.pinnedSha1 ?? null,
-		...options.now === void 0 ? {} : { now: options.now }
-	});
-}
-function extractEntitlements(appPath, executor) {
-	try {
-		return String(executor.runFile("codesign", [
-			"-d",
-			"--entitlements",
-			"-",
-			"--xml",
-			appPath
-		], { timeoutMs: SIGNING_TIMEOUT_MS })).trim();
-	} catch {
-		return "";
-	}
-}
-function resealBundle({ appPath, identity, exec = null }) {
-	const executor = exec || getExecutor();
-	const signAs = identity.sha1 || identity.name;
-	let mode = "preserve-metadata";
-	let preserveError = null;
-	try {
-		executor.runFile("codesign", [
-			"--force",
-			"--sign",
-			signAs,
-			"--preserve-metadata=identifier,entitlements,flags,runtime",
-			appPath
-		], { timeoutMs: SIGNING_TIMEOUT_MS });
-	} catch (error) {
-		preserveError = error;
-	}
-	let tempDir = null;
-	if (preserveError) {
-		const entitlements = extractEntitlements(appPath, executor);
-		const args = [
-			"--force",
-			"--sign",
-			signAs
-		];
-		if (entitlements !== "") {
-			tempDir = mkdtempSync(join(tmpdir(), "stim-entitlements-"));
-			const plist = join(tempDir, "entitlements.plist");
-			writeFileSync(plist, `${entitlements}\n`, "utf-8");
-			args.push("--entitlements", plist);
-			mode = "entitlements";
-		} else mode = "no-entitlements";
-		args.push(appPath);
-		try {
-			executor.runFile("codesign", args, { timeoutMs: SIGNING_TIMEOUT_MS });
-		} catch (error) {
-			return {
-				ok: false,
-				code: SIGNING_CODES.codesignFailed,
-				reason: `codesign could not re-seal ${appPath} with "${identity.name}": ${errorText(error)}`,
-				remedy: `Unlock the login keychain (\`security unlock-keychain\`) and confirm exactly one identity matches "${identity.name}".`,
-				lastLines: [...lastLines(errorText(preserveError)), ...lastLines(errorText(error))]
-			};
-		} finally {
-			if (tempDir) rmSync(tempDir, {
-				recursive: true,
-				force: true
-			});
-		}
-	}
-	try {
-		executor.runFile("codesign", [
-			"--verify",
-			"--strict",
-			appPath
-		], { timeoutMs: SIGNING_TIMEOUT_MS });
-	} catch (error) {
-		return {
-			ok: false,
-			code: SIGNING_CODES.codesignFailed,
-			reason: `codesign --verify --strict rejected ${appPath} after re-sealing it with "${identity.name}": ${errorText(error)}`,
-			remedy: "The bundle signed but did not seal. Delete the cached artifact with `stim gc --delete` and build fresh, then retry.",
-			lastLines: lastLines(errorText(error))
-		};
-	}
-	return {
-		ok: true,
-		identity,
-		mode
-	};
-}
-function sealAppForDevice(options) {
-	const gate = gateAppForDevice(options);
-	if (!gate.ok) return {
-		...gate,
-		lastLines: []
-	};
-	return resealBundle({
-		appPath: options.appPath,
-		identity: gate.identity,
-		exec: options.exec ?? null
-	});
-}
-//#endregion
-//#region src/engine/lan-address.ts
-const EN_INTERFACE = /^en(\d+)$/;
-const EXCLUDED_INTERFACE = /^(?:utun|bridge|awdl)/;
-const LINK_LOCAL = /^169\.254\./;
-function isIpv4(entry) {
-	return entry.family === "IPv4" || entry.family === 4;
-}
-function lanCandidates(interfaces) {
-	const ranked = [];
-	const seen = /* @__PURE__ */ new Set();
-	for (const [interfaceName, entries] of Object.entries(interfaces ?? {})) {
-		if (EXCLUDED_INTERFACE.test(interfaceName)) continue;
-		const en = EN_INTERFACE.exec(interfaceName);
-		for (const entry of entries ?? []) {
-			if (!entry || typeof entry !== "object" || !isIpv4(entry) || entry.internal === true) continue;
-			const address = typeof entry.address === "string" ? entry.address.trim() : "";
-			if (address === "" || LINK_LOCAL.test(address)) continue;
-			if (seen.has(address)) continue;
-			seen.add(address);
-			ranked.push({
-				interfaceName,
-				address,
-				rank: en ? 0 : 1,
-				index: en ? Number(en[1]) : 0
-			});
-		}
-	}
-	ranked.sort((a, b) => a.rank - b.rank || a.index - b.index || a.interfaceName.localeCompare(b.interfaceName) || a.address.localeCompare(b.address));
-	return ranked.map(({ interfaceName, address }) => ({
-		interfaceName,
-		address
-	}));
-}
-function hostLanCandidates(interfaces = networkInterfaces) {
-	return lanCandidates(interfaces());
-}
-//#endregion
-//#region src/commands/ios/collector.ts
-function collectorLogFile(root, slot) {
-	return join(workspaceLogsDir$1(root), `collector-${deviceSlotFileKey("ios", slot)}.log`);
-}
-function collectorEntry() {
-	return spawnEntry("collector-run");
-}
-const COLLECTOR_EXIT_WAIT_MS = 2e3;
-const COLLECTOR_POLL_MS = 25;
-async function stopPreviousCollector({ root, slot = "default", kill = (pid, signal) => signalProcessTree(pid, signal), alive = pidExists, readState = readWorkspaceState$1, verify = verifyCollectorOwnership, waitMs = COLLECTOR_EXIT_WAIT_MS, note = (_line) => {} }) {
-	const previous = (readState(root)?.collectors)?.[deviceSlotKey("ios", slot)] || null;
-	const previousPid = Number(previous?.pid) || null;
-	let killed = null;
-	if (previousPid) {
-		const ownership = verify({
-			pid: previousPid,
-			platform: deviceSlotKey("ios", slot),
-			root,
-			isAlive: alive,
-			expected: previous
-		});
-		if (ownership.status === "ours") {
-			try {
-				kill(previousPid, "SIGTERM");
-				killed = previousPid;
-			} catch (err) {
-				if (err?.code !== "ESRCH") note(chalk.yellow(`Could not stop the previous ios log collector (pid ${previousPid}): ${err?.message || err}`));
-			}
-			const deadline = Date.now() + waitMs;
-			while (Date.now() < deadline && alive(previousPid)) await sleep(COLLECTOR_POLL_MS);
-		} else if (ownership.status === "unverified") note(chalk.dim(`Previous ios log collector (pid ${previousPid}): ${ownership.reason}, so it was not signalled -- starting a replacement anyway`));
-	}
-	return { killed };
-}
-async function replaceCollector({ root, slot = "default", udid, bundleId, appName, appExecutable, physical = false, payloadUrl = null, spawn = (cmd, args, opts) => getExecutor().spawn(cmd, args, opts), kill = (pid, signal) => process.kill(pid, signal), alive = pidExists, readState = readWorkspaceState$1, verify = verifyCollectorOwnership, waitMs = COLLECTOR_EXIT_WAIT_MS, note = (_line) => {} }) {
-	const { killed } = await stopPreviousCollector({
-		root,
-		slot,
-		kill,
-		alive,
-		readState,
-		verify,
-		waitMs,
-		note
-	});
-	const args = [
-		collectorEntry(),
-		"--platform",
-		"ios",
-		"--root",
-		root,
-		"--udid",
-		udid,
-		"--bundle",
-		bundleId
-	];
-	if (slot !== "default") args.push("--slot", slot);
-	if (appName) args.push("--app-name", appName);
-	if (appExecutable) args.push("--app-executable", appExecutable);
-	if (physical) args.push("--physical");
-	if (payloadUrl) args.push("--payload-url", payloadUrl);
-	let stdio = "ignore";
-	try {
-		mkdirSync(workspaceLogsDir$1(root), { recursive: true });
-		const fd = openSync(collectorLogFile(root, slot), "a");
-		stdio = [
-			"ignore",
-			fd,
-			fd
-		];
-	} catch {}
-	let child;
-	try {
-		child = spawn(process.execPath, args, {
-			cwd: root,
-			detached: true,
-			stdio,
-			env: process.env
-		});
-		child?.unref?.();
-	} catch (err) {
-		note(chalk.yellow(`Could not start the ios log collector: ${err?.message || err}`));
-		return {
-			killed,
-			pid: null
-		};
-	}
-	return {
-		killed,
-		pid: child?.pid ?? null
-	};
-}
-//#endregion
-//#region src/commands/ios/dependencies.ts
-const DEFAULT_DEPS = {
-	automaticDevicePlacement,
-	prepareHostedIos,
-	placeHostedIos,
-	readHostedIos,
-	writeHostedIos,
-	resolveEasDevelopmentBuild,
-	findProjectRoot: findProjectRoot$1,
-	resolveSettings,
-	settingsLayers,
-	settingOriginScope,
-	gitCommonDir,
-	repoRoot,
-	detectBundleId,
-	detectIsExpo,
-	devClientScheme,
-	devClientTakesDevMenuParams,
-	getProject,
-	upsertProject,
-	recordIosSchemeApprovals,
-	checkDeviceCapacity,
-	budgetGate,
-	ensureOwnedDevice,
-	listIosRuntimes,
-	listAllIosSims,
-	ensureBooted,
-	resolveRemoteContext,
-	remoteIosDeps,
-	readRemoteSimulatorArch,
-	hostSimulatorArch,
-	ensureMetroReachable,
-	ensureRemoteBootOwned,
-	detectProviders,
-	resolveProjectMetro,
-	startDevServer,
-	warmMetro,
-	readWorkspaceState: readWorkspaceState$1,
-	pidExists,
-	getConcurrencyLimits,
-	fingerprintProject,
-	untrackedNativeFiles,
-	resolveBuild,
-	storeBuild,
-	resolveCacheProviderConfig,
-	loadCacheProvider,
-	acquireBuildLock,
-	releaseBuildLock,
-	waitForBuild,
-	acquireBuildSlot,
-	releaseBuildSlot,
-	loadProjectProvider,
-	checkEasAuth,
-	resolveEasCliBin,
-	resolveRemote,
-	uploadRemote,
-	planPrebuild,
-	runPrebuild,
-	readPodState,
-	podsAreStale,
-	runPodInstall,
-	buildIos,
-	discoverXcodeProject,
-	resolveScheme,
-	listIosDevices,
-	hostLanCandidates,
-	ensureLanReachable,
-	gateProfileForDevice,
-	sealAppForDevice,
-	installIosDeviceApp,
-	awaitIosDeviceLaunch,
-	acquireRunLease,
-	runLease,
-	selectFromPool,
-	releaseLeaseOnSignal,
-	iosDeviceProcess,
-	verifyIosDeviceReleaseLaunch,
-	readBundleId,
-	readBundleExecutable,
-	swapJsBundle,
-	installIosApp,
-	clearOtherUserApps,
-	clearIosAppData,
-	clearIosAdoptionPending,
-	launchIosApp,
-	verifyLaunch,
-	verifyReleaseLaunch,
-	ensureWorkspaceStorage: ensureWorkspaceStorageSafely,
-	replaceCollector,
-	stopPreviousCollector,
-	writeWorkspaceLaunch,
-	writeWorkspaceState,
-	createWriter: createNdjsonWriter,
-	recordStats: recordRunStats,
-	recordCapacityRefusal,
-	readEstimates: readRunEstimates,
-	now: () => Date.now()
-};
-//#endregion
-//#region src/commands/ios/launch.ts
-function missingCrashReportHint({ physical, remote, crashed }) {
-	return crashed && !physical && !remote ? `No attributable native crash report captured yet. ${IOS_CRASH_REPORT_RETRY}` : "No attributable native crash report captured. Read `stim logs --source device` for available output.";
-}
-async function verifyIosRun({ root, slot, appPath, d, release, launched, configuration, phase, note, metroCheck, logsDir, launchedAt, metroPort, isExpo, bundleId, udid, scheme, physical, appName, lanAddress, lanOrigin, remoteDevice, metroOrigin }) {
-	const runCommand = nativeRunCommand("ios", slot, {
-		physical,
-		deviceId: udid
-	});
-	const readNativeCrashes = () => remoteDevice ? [] : captureNativeCrashes({
-		root,
-		slot,
-		platform: "ios",
-		deviceId: udid,
-		appId: bundleId,
-		since: launchedAt,
-		appPath,
-		physical
-	}, logsDir);
-	const deviceProcess = () => {
-		const pid = d.iosDeviceProcess({
-			udid,
-			appName: appName ?? bundleId
-		});
-		return pid === void 0 ? null : pid !== null;
-	};
-	if (release) {
-		const processCheck = physical ? await d.verifyIosDeviceReleaseLaunch({
-			udid,
-			appName: appName ?? bundleId
-		}) : await d.verifyReleaseLaunch({ pid: launched?.pid ?? null });
-		const crashes = readNativeCrashes();
-		if (processCheck?.verified && !crashes.length) {
-			phase("verify", `process alive ${formatDuration(processCheck.waitedMs ?? 0)} after launch (${configuration}: no bundle fetch to observe)`);
-			return { state: true };
-		}
-		for (const line of launchErrorPreview(crashes, root)) note(chalk.red(phaseLine("launch", line)));
-		if (!crashes.length) note(phaseLine("logs", missingCrashReportHint({
-			physical,
-			remote: Boolean(remoteDevice),
-			crashed: processCheck?.reason === "exited"
-		})));
-		phase("verify", chalk.yellow(crashes.length ? "FATAL: the app reported a native crash" : processCheck?.reason === "exited" ? `FATAL: the app process exited within ${formatDuration(processCheck.waitedMs ?? 0)} of launch` : physical ? `UNVERIFIED: devicectl could not read ${udid}'s process list` : "UNVERIFIED: simctl launch reported no process id to check"));
-		note(chalk.yellow(phaseLine("", "Release readiness was not established. Run `stim logs --errors` for captured crash reports, or `stim logs --source device` for the full device output.")));
-		return { state: crashes.length || processCheck?.reason === "exited" ? LAUNCH_FATAL : LAUNCH_UNVERIFIED };
-	}
-	const siblings = metroCheck ? siblingPlatformSlots(root, "ios", slot) : [];
-	const verification = metroCheck ? await d.verifyLaunch({
-		requireBundleResponse: true,
-		slot: launchSlotScope(root, slot),
-		appPid: physical || remoteDevice ? null : launched?.pid,
-		platformShared: siblings.length > 0,
-		onReadinessPending: () => phase("readiness", "waiting for app readiness (up to 30s after bundle load)"),
-		logsDir,
-		since: launchedAt,
-		metroPort,
-		platform: "ios",
-		mode: isExpo ? MODE_EXPO : MODE_BARE,
-		readNativeCrashes,
-		processAlive: remoteDevice ? null : physical ? deviceProcess : () => {
-			if (launched?.pid) return d.pidExists(launched.pid);
-			const pid = iosAppProcess(udid, bundleId);
-			return pid === void 0 ? null : pid !== null;
-		}
-	}) : {
-		verified: false,
-		skipped: true
-	};
-	const nativeCrashes = verification.errors?.some((record) => record.event === "native_crash") ? [] : readNativeCrashes();
-	if (nativeCrashes.length) verification.fatal = true;
-	verification.errors = await errorDiagnostics([...verification.errors ?? [], ...nativeCrashes], {
-		root,
-		logsDir,
-		port: metroPort,
-		allowRequest: true
-	});
-	if (verification.readiness) phase("readiness", appReadinessMessage(verification.readiness, verification.waitedMs ?? 0));
-	if (verification?.fatal) {
-		const nativeFatal = verification.errors?.some((record) => record.event === "native_crash");
-		const deliveryFailed = verification.record?.event === "bundle_response_failed";
-		const reason = nativeFatal ? "the app reported a native crash" : verification.processAlive === false ? "the app process exited" : deliveryFailed ? "Metro bundle delivery failed" : "Metro could not build the bundle";
-		phase("verify", chalk.red(`FATAL after ${formatDuration(verification.waitedMs ?? 0)}: ${reason}`));
-		for (const line of launchErrorPreview(verification.errors ?? [], root)) note(chalk.red(phaseLine("", line)));
-		if (verification.processAlive === false && !verification.errors?.some((record) => record.event === "native_crash")) note(phaseLine("logs", missingCrashReportHint({
-			physical,
-			remote: Boolean(remoteDevice),
-			crashed: true
-		})));
-		if (nativeFatal || verification.processAlive === false) note(chalk.yellow(phaseLine("remedy", `Fix the crash, then run \`${runCommand}\` again. A Metro reload cannot restart an exited app.`)));
-		else if (verification.processAlive === true && metroPort !== null) {
-			const reloadRemedy = `press Reload on the app's own error screen -- run \`agent-device snapshot -i --platform ios --udid ${udid}\` in your existing automation session to reach it. Neither \`stim reload ios\` nor \`agent-device metro reload\` can: this app never connected to Metro.`;
-			note(chalk.yellow(phaseLine("remedy", `The native app is still running. ${deliveryFailed ? "Check the Metro logs and device connection, then" : "Fix the JavaScript or TypeScript error, then"} ${reloadRemedy} Do not run \`${runCommand}\` unless native inputs changed or the app process exits.`)));
-		}
-		return { state: LAUNCH_FATAL };
-	}
-	if (verification?.verified) {
-		phase("verify", `bundle loaded` + (verification.processAlive === true ? ", process alive" : "") + (verification.readiness ? "" : ", stable for 3s -- the first screen may still be rendering") + ` (${formatDuration(verification.waitedMs ?? 0)} total)`);
-		const hasAppErrors = reportLaunchErrors(verification.errors ?? [], note, root);
-		if (hasAppErrors && verification.processAlive === true && metroPort !== null) {
-			const reloadRemedy = physical || remoteDevice ? `run \`agent-device metro reload --metro-port ${metroPort}\`.` : "run `stim reload ios`.";
-			note(chalk.yellow(phaseLine("remedy", `The native app is still running. Fix the JavaScript or TypeScript error; Fast Refresh should apply the edit. If the error screen remains, ${reloadRemedy} Do not run \`${runCommand}\` unless native inputs changed or the app process exits.`)));
-		}
-		return {
-			state: true,
-			warning: hasAppErrors ? "app errors detected; inspect the error above" : verification.readiness === "timed-out" || verification.readiness === "error" ? "app readiness not confirmed; inspect the UI and logs" : void 0
-		};
-	}
-	if (verification?.skipped) {
-		phase("verify", "skipped (--no-metro-check): the launch is reported as unverified");
-		return { state: LAUNCH_UNVERIFIED };
-	}
-	if (verification?.requested) {
-		phase("verify", `BUNDLING: the app asked port ${metroPort} for its bundle; build or delivery was still pending after ${formatDuration(verification.waitedMs ?? 0)} (a cold bundle on a large graph outlasts this window)`);
-		note(chalk.dim(phaseLine("", "Nothing to do: `stim logs --source metro` shows the build finishing, usually within a minute.")));
-		return { state: LAUNCH_BUNDLING };
-	}
-	return reportUnverified({
-		verification,
-		siblings,
-		slot,
-		phase,
-		note,
-		metroPort,
-		bundleId,
-		udid,
-		scheme,
-		lanAddress,
-		isExpo,
-		remoteDevice,
-		physical,
-		lanOrigin,
-		metroOrigin,
-		logsDir,
-		launchedAt,
-		launched
-	});
-}
-function reportUnverified({ verification, siblings, slot, phase, note, metroPort, bundleId, udid, scheme, lanAddress, isExpo, remoteDevice, physical, lanOrigin, metroOrigin, logsDir, launchedAt, launched }) {
-	if (verification.unattributed) {
-		const [headline, ...lines] = unattributedLaunchLines({
-			platform: "ios",
-			metroPort,
-			slot,
-			siblings
-		});
-		phase("verify", chalk.yellow(headline));
-		for (const line of lines) note(chalk.yellow(phaseLine("", line)));
-		return {
-			state: LAUNCH_UNVERIFIED,
-			unattributed: true
-		};
-	}
-	phase("verify", chalk.yellow("UNVERIFIED: no bundle request reached this workspace's Metro"));
-	for (const line of unverifiedLaunchLines({
-		platform: "ios",
-		metroPort: metroPort ?? 8081,
-		waitedMs: verification.waitedMs,
-		bundleId,
-		udid,
-		devClientUrl: scheme ? launched?.url ?? devClientUrl(scheme, metroPort ?? 8081, lanAddress ?? void 0) : null,
-		mode: isExpo ? MODE_EXPO : MODE_BARE,
-		remote: remoteDevice,
-		physical,
-		devClient: Boolean(scheme),
-		lanOrigin,
-		metroOrigin,
-		localNetworkPending: physical && localNetworkPending(readCollectorRecords(logsDir), {
-			since: launchedAt,
-			pid: launched?.pid ?? null,
-			lanOrigin
-		})
-	})) note(chalk.yellow(phaseLine("", line)));
-	return { state: LAUNCH_UNVERIFIED };
-}
-function reportLaunchErrors(errors, note, root) {
-	const report = launchErrorReport(errors, root);
-	if (report.summary) note(chalk.dim(phaseLine("launch", report.summary)));
-	for (const line of report.lines) note(chalk.yellow(phaseLine("launch", line)));
-	return report.lines.length > 0;
-}
-function installsOverWifi(d, udid, selectedWireless, note) {
-	const current = d.listIosDevices().find((entry) => entry.udid === udid);
-	const wireless = current ? isWirelessIosDevice(current) : selectedWireless;
-	if (wireless) note(phaseLine("device", `${current?.name ?? udid} is paired over Wi-Fi, so the install and launch go over the network and take longer than over a cable`));
-	return wireless;
-}
-function cleanAdoptedIosApps({ d, udid, bundleId, devClient, phase, note }) {
-	const swept = d.clearOtherUserApps({
-		udid,
-		keep: bundleId
-	});
-	if (swept.removed.length) phase("install", `removed ${swept.removed.join(", ")}, left by the previous workspace`);
-	if (swept.listed && swept.failed.length === 0) {
-		if (swept.kept && bundleId) {
-			try {
-				d.clearIosAppData(udid, bundleId, { defaultsPlist: devClient ? IOS_DEV_MENU_OFF_DEFAULTS_PLIST : null });
-			} catch (error) {
-				return `Could not clear the data ${bundleId} kept from the previous workspace: ${String(error?.message || error)}`;
-			}
-			phase("install", `cleared ${bundleId} data left by the previous workspace`);
-		}
-		return null;
-	}
-	if (!swept.listed) return "Could not list apps left by the previous workspace.";
-	for (const failure of swept.failed) note(chalk.yellow(phaseLine("install", `could not remove ${failure}, left by the previous workspace`)));
-	return `Could not remove ${swept.failed.join(", ")}, left by the previous workspace.`;
-}
-function installMayBeProven(adopting, parkedCacheKey, storeKey) {
-	return !adopting || !parkedCacheKey || parkedCacheKey === storeKey;
-}
-function resolveRunBundleId(d, root, appPath, bundleId) {
-	if (!appPath || bundleId) return bundleId;
-	return d.readBundleId(appPath) || d.detectBundleId(root);
-}
-function readRunExecutable(d, appPath, note) {
-	const executable = appPath ? d.readBundleExecutable(appPath) : null;
-	if (appPath && !executable) note(chalk.dim(`Could not read CFBundleExecutable from ${appPath}; the device log predicate falls back to the .app basename.`));
-	return executable;
-}
-function recordIosReloadTarget({ d, root, physical, remoteDevice, bundleId, udid, metroPort, release, launchedAt, note }) {
-	if (physical || remoteDevice) return;
-	try {
-		d.writeWorkspaceLaunch(root, "ios", {
-			appId: bundleId,
-			deviceId: udid,
-			metroPort,
-			release,
-			launchedAt: new Date(launchedAt).toISOString()
-		});
-	} catch (error) {
-		note(chalk.yellow(phaseLine("state", `could not record iOS launch: ${error?.message || error}`)));
-	}
-}
-function installFailureRemedy(remoteDevice) {
-	return remoteDevice?.failureRemedy() ?? "Check that the simulator is booted and that the app was built for the simulator SDK.";
-}
-function launchFailureRemedy(remoteDevice, udid, bundleId, logFile) {
-	if (remoteDevice) return remoteDevice.failureRemedy();
-	return `If the simulator timed out, run \`stim doctor --platform ios\` and resolve any reported host memory pressure before retrying. Otherwise run \`xcrun simctl launch --terminate-running-process --console ${udid} ${bundleId}\` to see what the app reports, and check ${logFile}.`;
-}
-async function finishIosRun({ devicePlacement, artifact, d, root, slot, json, release, configuration, buildScheme, isExpo, metroCheck, metroPort, logsDir, logFile, device, udid, physical, wireless, lanAddress, lanOriginUrl, remoteDevice, bootPromise, bootDuration, fail, phase, note, logWriter, elapsed, startedAt, closeWriter, lease, releaseLease, recordRun, reclaimed, devServer, enterPhase }) {
-	const { path: appPath, bundleId: initialBundleId, failureFields: buildFailure, cache } = artifact;
-	const { hit: cacheHit, providerName, buildMachine, builtOn, offloadedTo, offloadFallback, readEnabled: useBuildCache, missReason, waitedForBuild, compilation: compilationCache } = cache;
-	const storeHash = cache.identity?.fingerprint ?? null;
-	const storeKey = cache.identity?.key ?? null;
-	const runCommand = nativeRunCommand("ios", slot, {
-		physical,
-		deviceId: udid
-	});
-	let bundleId = initialBundleId;
-	let leaseWarned = false;
-	const raiseLeaseFor = (boundMs, beforeInstall) => {
-		const step = lease?.raise(boundMs);
-		if (!step || step.ok) return null;
-		if (beforeInstall) {
-			const refusal = lostRefusal(step.holder, step.expiresAt, d.now());
-			return {
-				code: refusal.code,
-				message: refusal.message,
-				remedy: refusal.remedy,
-				lease: refusal.lease
-			};
-		}
-		if (!leaseWarned) {
-			leaseWarned = true;
-			note(chalk.yellow(phaseLine("lease", lostLine(step.holder, step.expiresAt, d.now()))));
-		}
-		return null;
-	};
-	bundleId = resolveRunBundleId(d, root, appPath, bundleId);
-	if (appPath && !bundleId) return fail({
-		code: "STIM_INSTALL_FAILED",
-		message: `Could not read a bundle identifier from the cached app at ${appPath}.`,
-		remedy: "Remove the cache entry (`stim gc`) and run again to rebuild it.",
-		build: {
-			...buildFailure,
-			appPath
-		}
-	});
-	if (bundleId) d.upsertProject(root, { bundleId });
-	enterPhase("device");
-	const booted = await bootPromise;
-	if (!booted?.ok) return fail({
-		code: booted?.code || "STIM_NO_DEVICE",
-		message: booted?.reason || "The owned simulator could not be booted.",
-		remedy: booted?.remedy || `Run \`${runCommand}\` again to re-establish an owned simulator for this workspace.`
-	});
-	const deviceOutcome = physical ? "connected" : `${device?.adopted ? "adopted" : "booted"} ${bootDuration()}`;
-	phase("device", `${deviceLabel(device, udid)} ${deviceOutcome}`);
-	const scheme = release ? void 0 : d.devClientScheme(root, appPath);
-	const devMenuParams = d.devClientTakesDevMenuParams(root);
-	const appName = appNameFromPath(appPath);
-	const appExecutable = readRunExecutable(d, appPath, note);
-	const dropSwapDir = artifact.release;
-	let installSkipped = false;
-	let launched;
-	let launchedAt = d.now();
-	if (physical) {
-		const overWifi = installsOverWifi(d, udid, wireless, note);
-		const bounds = iosDeviceBounds(overWifi);
-		const lostBeforeInstall = raiseLeaseFor(bounds.installMs, true);
-		if (lostBeforeInstall) return fail(lostBeforeInstall);
-		await d.stopPreviousCollector({
-			root,
-			note
-		});
-		enterPhase("install");
-		const installTimer = stepTimer(d.now);
-		const installed = d.installIosDeviceApp({
-			udid,
-			appPath,
-			bundleId,
-			wireless: overWifi
-		}, { beforeStep: () => raiseLeaseFor(bounds.installMs, false) });
-		if (installed?.failed) {
-			dropSwapDir();
-			return fail({
-				code: installed.code || "STIM_INSTALL_FAILED",
-				message: installed.reason ?? `devicectl could not install ${appPath} on ${udid}.`,
-				remedy: installed.remedy ?? null,
-				build: {
-					...buildFailure,
-					appPath,
-					bundleId
-				}
-			});
-		}
-		phase("install", `${basename(appPath)} -> ${deviceLabel(device, udid)} ${installTimer()}`);
-		if (installed?.note) {
-			note(chalk.yellow(phaseLine("install", installed.note)));
-			logWriter().write({
-				src: "build",
-				level: "warn",
-				event: "install_uninstalled_first",
-				msg: installed.note
-			});
-		}
-		dropSwapDir();
-		raiseLeaseFor(COLLECTOR_EXIT_WAIT_MS + bounds.launchMs, false);
-		const payloadUrl = scheme && metroPort !== null && lanAddress ? devClientUrl(scheme, metroPort, lanAddress) : null;
-		enterPhase("launch");
-		const launchTimer = stepTimer(d.now);
-		launchedAt = d.now();
-		logWriter().write({
-			src: "build",
-			level: "info",
-			marker: true,
-			event: "launch_attempt",
-			ts: launchedAt,
-			platform: "ios",
-			appId: bundleId,
-			deviceId: udid,
-			appPath,
-			physical: true,
-			msg: `launching ${bundleId} on ${udid}`
-		});
-		const collector = await d.replaceCollector({
-			root,
-			slot,
-			udid,
-			bundleId,
-			appName,
-			physical: true,
-			payloadUrl,
-			note
-		});
-		if (!collector?.pid) return fail({
-			code: "STIM_LAUNCH_FAILED",
-			message: `The device log collector, which is what launches ${bundleId} on a phone, could not be started.`,
-			remedy: `Check ${logFile} and the workspace collector log, then run the command again.`,
-			build: {
-				...buildFailure,
-				appPath,
-				bundleId
-			}
-		});
-		const started = await d.awaitIosDeviceLaunch({
-			udid,
-			bundleId,
-			appName: appName ?? bundleId,
-			collectorPid: collector.pid,
-			wireless: overWifi,
-			readRecords: () => readCollectorRecords(logsDir).filter((entry) => Number(entry.ts) >= launchedAt && (entry.slot ?? "default") === (slot ?? "default"))
-		});
-		if (started.failed || !started.pid) return fail({
-			code: started.code ?? "STIM_LAUNCH_FAILED",
-			message: started.reason ?? `${bundleId} did not start on ${udid}.`,
-			remedy: started.remedy ?? null,
-			lines: started.lines ?? [],
-			logPath: logsDir,
-			build: {
-				...buildFailure,
-				appPath,
-				bundleId
-			}
-		});
-		launched = {
-			ok: true,
-			mode: payloadUrl ? "payload-url" : "launch",
-			pid: started.pid,
-			...payloadUrl ? { url: payloadUrl } : {},
-			...lanOriginUrl ? { jsLocation: lanOriginUrl } : {}
-		};
-		phase("launch", `${bundleId} pid ${started.pid} ${launchTimer()}`);
-	} else {
-		const adopting = Boolean(device?.adoptionPending);
-		if (adopting) {
-			const cleanupFailure = cleanAdoptedIosApps({
-				d,
-				udid,
-				bundleId,
-				devClient: Boolean(scheme),
-				phase,
-				note
-			});
-			if (cleanupFailure) return fail({
-				code: "STIM_INSTALL_FAILED",
-				message: `${cleanupFailure} Stim kept the adoption cleanup pending and did not install or launch the app.`,
-				remedy: `Run \`${runCommand}\` again after simulator tooling is responsive.`,
-				build: {
-					...buildFailure,
-					appPath,
-					bundleId
-				}
-			});
-		}
-		enterPhase("install");
-		const installTimer = stepTimer(d.now);
-		const installed = d.installIosApp({
-			udid,
-			appPath,
-			bundleId,
-			devClientScheme: scheme,
-			schemeApprovals: device.schemeApprovals,
-			proveInstalled: installMayBeProven(adopting, device?.parkedCacheKey, storeKey)
-		}, { now: d.now });
-		if (installed?.failed) return fail({
-			code: installed.code || "STIM_INSTALL_FAILED",
-			message: installed.reason,
-			remedy: installFailureRemedy(remoteDevice),
-			build: {
-				...buildFailure,
-				appPath,
-				bundleId
-			}
-		});
-		if (adopting) d.clearIosAdoptionPending(root, slot);
-		installSkipped = Boolean(installed?.skipped);
-		const artifactDuration = installed?.artifactDurationMs === void 0 ? installTimer() : `(${formatDuration(installed.artifactDurationMs)})`;
-		phase("install", installSkipped ? `unchanged (${deviceShortName(device, udid)} already has this build) ${artifactDuration}` : `${basename(appPath)} -> ${deviceLabel(device, udid)} ${artifactDuration}`);
-		if (!remoteDevice && installed?.devClientPreparationDurationMs !== void 0) phase("install", `dev client prepared (${formatDuration(installed.devClientPreparationDurationMs)})`);
-		if (installed.schemeApprovals) d.recordIosSchemeApprovals(root, udid, installed.schemeApprovals, slot);
-		dropSwapDir();
-		if (!remoteDevice) await d.replaceCollector({
-			root,
-			slot,
-			udid,
-			bundleId,
-			appName,
-			appExecutable,
-			note
-		});
-		enterPhase("launch");
-		const launchTimer = stepTimer(d.now);
-		launchedAt = d.now();
-		logWriter().write({
-			src: "build",
-			level: "info",
-			marker: true,
-			event: "launch_attempt",
-			ts: launchedAt,
-			platform: "ios",
-			appId: bundleId,
-			deviceId: udid,
-			appPath,
-			remote: Boolean(remoteDevice),
-			msg: `launching ${bundleId} on ${udid}`
-		});
-		launched = d.launchIosApp({
-			udid,
-			bundleId,
-			metroPort,
-			devClientScheme: scheme,
-			devMenuParams,
-			consolePaths: simulatorConsolePaths({
-				deviceId: udid,
-				appId: bundleId,
-				since: launchedAt
-			}, true, Boolean(remoteDevice))
-		});
-		if (launched.failed) {
-			printNativeCrashReport({
-				root,
-				slot,
-				platform: "ios",
-				deviceId: udid,
-				appId: bundleId,
-				since: launchedAt,
-				appPath
-			}, logsDir, (line) => note(chalk.red(phaseLine("launch", line))), Boolean(remoteDevice));
-			return fail({
-				code: launched.code || "STIM_LAUNCH_FAILED",
-				message: launched.reason,
-				remedy: launchFailureRemedy(remoteDevice, udid, bundleId, logFile),
-				build: {
-					...buildFailure,
-					appPath,
-					bundleId
-				}
-			});
-		}
-		phase("launch", `${bundleId}${restartedAppNote(launched.restartedPid)} ${launchTimer()}`);
-	}
-	recordIosReloadTarget({
-		d,
-		root,
-		slot,
-		physical,
-		remoteDevice: Boolean(remoteDevice),
-		bundleId,
-		udid,
-		metroPort,
-		release,
-		launchedAt,
-		note
-	});
-	logWriter().write({
-		src: "build",
-		level: "info",
-		event: "launch",
-		msg: release ? `launched ${bundleId} on ${udid} (${configuration}, embedded JS bundle, no Metro)` : `launched ${bundleId} on ${udid} against Metro ${lanOriginUrl ?? `port ${metroPort}`}` + (launched?.mode === "openurl" || launched?.mode === "payload-url" ? " (expo-dev-client)" : "") + restartedAppNote(launched.restartedPid, "; ")
-	});
-	if (remoteDevice) logWriter().write({
-		src: "build",
-		level: "info",
-		event: "collector_skipped",
-		msg: `remote session ${udid}: device logs come from agent-device/EAS, so no simctl log stream is attached`
-	});
-	if (physical) raiseLeaseFor(release ? RELEASE_VERIFY_WAIT_MS : DEBUG_VERIFY_STEP_MS, false);
-	const { state: launchState, warning: launchWarning, unattributed } = await verifyIosRun({
-		root,
-		slot,
-		appPath,
-		d,
-		release,
-		launched,
-		configuration,
-		phase,
-		note,
-		metroCheck,
-		logsDir,
-		launchedAt,
-		metroPort,
-		isExpo,
-		bundleId,
-		udid,
-		scheme,
-		physical,
-		appName,
-		lanAddress,
-		lanOrigin: lanOriginUrl,
-		remoteDevice: Boolean(remoteDevice),
-		metroOrigin: typeof launched?.jsLocation === "string" ? launched.jsLocation : null
-	});
-	if (launchState === "fatal") return fail({
-		code: "STIM_LAUNCH_FAILED",
-		message: "The app failed its launch readiness check.",
-		remedy: `Read the launch error above or run \`stim logs --errors\`. The full timeline is in ${logsDir}.`,
-		logPath: logsDir,
-		build: {
-			...buildFailure,
-			appPath,
-			bundleId
-		}
-	});
-	logWriter().write(launchOutcomeRecord({
-		launchState,
-		release,
-		bundleId,
-		configuration,
-		metroPort,
-		unattributed
-	}));
-	const leaseFacts = lease?.facts() ?? null;
-	releaseLease();
-	const uploadsAbandoned = await artifact.completeUploads();
-	return {
-		facts: reportIosResult({
-			devicePlacement,
-			root,
-			slot,
-			json,
-			release,
-			configuration,
-			buildScheme,
-			metroCheck,
-			metroPort,
-			logsDir,
-			device,
-			udid,
-			appPath,
-			bundleId,
-			installSkipped,
-			elapsed,
-			startedAt,
-			storeHash,
-			storeKey,
-			cacheHit,
-			missReason,
-			compilationCache,
-			useBuildCache,
-			waitedForBuild,
-			launchState,
-			launchWarning,
-			providerName,
-			buildMachine,
-			builtOn,
-			offloadedTo,
-			offloadFallback,
-			closeWriter,
-			webPreviewUrl: remoteDevice?.webPreviewUrl() ?? null,
-			lease: physical ? leaseFacts : void 0,
-			recordRun,
-			reclaimed,
-			devServer,
-			links: workspaceLinks(root, {
-				platform: "ios",
-				slot
-			})
-		}),
-		uploadsAbandoned
-	};
-}
-//#endregion
-//#region src/commands/ios/next-build.ts
-function note(line) {
-	console.error(line);
-}
-function runOnlyFlag(opts) {
-	if (isPhysicalDeviceRequest(opts.device)) return "--device";
-	if (opts.remote) return "--remote";
-	if (opts.wait !== void 0) return opts.wait === false ? "--no-wait" : "--wait";
-	if (opts.simulatorApp !== void 0) return "--simulator-app";
-	if (opts.metroCheck === false) return "--no-metro-check";
-	return null;
-}
-async function planIos(opts, d, schemeRefusal) {
-	const json = Boolean(opts.json);
-	const refuse = (refusal, lines = []) => refusePlan(refusal, json, lines);
-	const flag = runOnlyFlag(opts);
-	if (flag) return refuse(planFlagRefusal(flag));
-	const root = d.findProjectRoot(process.cwd());
-	if (!root) return refuse(NO_PROJECT_REFUSAL);
-	const projectProblem = appProjectProblem(root);
-	if (projectProblem) return refuse({
-		code: "STIM_NO_PROJECT",
-		...projectProblem
-	});
-	const settingsContext = {
-		projectPath: root,
-		gitCommonDir: d.gitCommonDir(root),
-		repoRoot: d.repoRoot(root)
-	};
-	const settings = d.resolveSettings(settingsContext);
-	const [shapeError, ...moreShapeErrors] = settingShapeErrors(settings);
-	if (shapeError) return refuse({
-		code: "STIM_BAD_ARG",
-		message: shapeError,
-		remedy: SETTING_SHAPE_REMEDY
-	}, moreShapeErrors);
-	let optimizations;
-	try {
-		optimizations = resolveOptimizations(settings);
-	} catch (error) {
-		return refuse({
-			code: "STIM_BAD_ARG",
-			message: error.message,
-			remedy: SETTING_SHAPE_REMEDY
-		});
-	}
-	const cacheProviderError = cacheProviderSettingError(settings);
-	if (cacheProviderError) note(chalk.yellow(phaseLine("cache", `${cacheProviderError} Using the local cache.`)));
-	const slot = opts.slot ?? "default";
-	const target = {
-		platform: "ios",
-		slot,
-		root,
-		projectKey: statsProjectKey$1({
-			root,
-			commonDir: settingsContext.gitCommonDir,
-			repoRoot: settingsContext.repoRoot
-		})
-	};
-	const isExpo = d.detectIsExpo(root);
-	const settingsLayersForOrigin = d.settingsLayers(settingsContext);
-	const iosRemote = remoteIosSetting(settings);
-	const modelRefusal = deviceModelRefusal({
-		slot,
-		deviceTypeFlag: opts.deviceType,
-		runtimeFlag: opts.runtime,
-		deviceType: resolveDeviceType(opts.deviceType, settings),
-		runtime: resolveRuntime(opts.runtime, settings),
-		deviceTypeOrigin: d.settingOriginScope(settingsLayersForOrigin, "ios.deviceType"),
-		runtimeOrigin: d.settingOriginScope(settingsLayersForOrigin, "ios.runtime"),
-		physical: false,
-		remoteBackend: iosRemote?.kind === "backend" ? iosRemote.backend : null,
-		hosted: iosRemote?.kind === "machine",
-		listRuntimes: d.listIosRuntimes
-	});
-	if (modelRefusal) return refuse(modelRefusal);
-	if (opts.easProfile !== void 0) {
-		const eas = await planEasDevelopmentBuild({
-			root,
-			platform: "ios",
-			profile: opts.easProfile,
-			note,
-			isExpo,
-			selectors: [opts.scheme, opts.configuration],
-			buildCache: opts.buildCache
-		});
-		if (!eas.ok) return refuse(eas);
-		return printPlan(planPayload(target, {
-			fingerprint: eas.fingerprint,
-			cacheKey: eas.cacheKey,
-			cacheHit: eas.buildId ? "remote" : false,
-			provider: "eas",
-			cacheSkipped: false,
-			prebuild: null,
-			refusal: eas.missing
-		}), json);
-	}
-	const remoteBackend = remoteIosSetting(settings);
-	if (remoteBackend) return refuse({
-		code: "STIM_BAD_ARG",
-		message: `ios.remote routes this workspace's runs to a ${remoteBackend.kind === "backend" ? remoteBackend.backend : remoteBackend.machine} device, whose architecture --plan cannot read without a session.`,
-		remedy: "Run `stim ios` to build for the remote device, or unset ios.remote to plan the owned simulator."
-	});
-	const refusal = schemeRefusal(root, opts.scheme, isExpo);
-	if (refusal) return refuse({
-		code: refusal.code,
-		message: refusal.message ?? "",
-		remedy: refusal.remedy ?? ""
-	});
-	const configuration = resolveConfiguration(opts.configuration, settings);
-	const buildProfile = optimizationBuildProfile("ios", optimizations);
-	const cachePolicy = artifactCachePolicy(optimizations, opts.buildCache !== false, isReleaseConfiguration(configuration));
-	let fingerprint;
-	try {
-		fingerprint = await d.fingerprintProject(root, { platform: "ios" });
-	} catch (error) {
-		note(chalk.dim(`Fingerprinting failed: ${error?.message || error}`));
-	}
-	if (!fingerprint?.hash) return refuse({
-		code: "STIM_NO_FINGERPRINT",
-		message: `Could not fingerprint ${root}: @expo/fingerprint produced no hash for it.`,
-		remedy: "Check the project native inputs and the @expo/fingerprint error above, then retry."
-	});
-	const arch = simulatorBuildArch({
-		physical: false,
-		remoteArch: null,
-		hostArch: d.hostSimulatorArch(),
-		configuration
-	});
-	const cacheKey = buildCacheKey("ios", fingerprint.hash, {
-		scheme: opts.scheme,
-		...configuration ? { configuration } : {},
-		isSimulator: true,
-		...arch ? { arch } : {},
-		...buildProfile ? { buildProfile } : {}
-	});
-	const plan = await planCachedBuild({
-		...target,
-		isExpo,
-		fingerprint: fingerprint.hash,
-		sources: fingerprint.sources ?? [],
-		cacheKey,
-		cachePolicy,
-		providerConfig: d.resolveCacheProviderConfig(settingsContext),
-		expoRemote: cachePolicy.remote && !buildProfile && !opts.scheme ? { runOptions: iosProviderRunOptions(configuration, arch) } : null
-	}, {
-		loadCacheProvider: d.loadCacheProvider,
-		loadProjectProvider: d.loadProjectProvider,
-		checkEasAuth: d.checkEasAuth,
-		resolveRemote: d.resolveRemote,
-		planPrebuild: d.planPrebuild,
-		note
-	});
-	printPlan(plan, json);
-}
-//#endregion
-//#region src/commands/ios.ts
-function writeNote(line) {
-	console.error(line);
-}
-function writePhase(name, text) {
-	console.error(phaseLine(name, text));
-}
-function iosCommand(program) {
-	registerIos(program);
-}
-function registerIos(program, deps = {}) {
-	program.command("ios").description("Build (or restore from the fingerprint cache), install and launch this workspace's app on its owned simulator, wired to the reserved Metro port. A Debug run starts the dev server when it is not running.").option("--eas-profile <name>", "Download a matching EAS development build; on a miss, print the build command without running it").option("--slot <name>", "Reusable device slot within this workspace (default: default)", parseDeviceSlotOption).option("--remote-build <value>", "Build on auto, local, or one named machine; a name refuses without fallback", parseBuildMachineOption).option("--json", "Emit the facts as a single JSON line on stdout; every other line goes to stderr").option("--plan", "Predict the next build without building, booting or installing: resolve the fingerprint, check the local then remote cache, and print the expected cache result and duration. Writes no Stim state.").option("--scheme <name>", "Shared Xcode app scheme to build; overrides automatic scheme selection, not the app URL scheme").option("--no-metro-check", "Skip the \"is this workspace's dev server running?\" check: do not start it, and build anyway").option("--no-build-cache", "Build fresh, ignoring cached artifacts (local and the project's build-cache provider); the fresh build still replaces the cache entry").option("--configuration <name>", "Xcode configuration to build (e.g. Release). A non-Debug configuration embeds the JS bundle and skips Metro entirely. Overrides the ios.configuration setting. Default: Debug").option("--device-type <name>", "Simulator model to create this workspace's owned sim as, exactly as `xcrun simctl list devicetypes` names it (e.g. \"iPad Pro 13-inch (M5)\"). Overrides the ios.deviceType setting for this invocation. A model no installed runtime can create refuses with STIM_BAD_ARG and prints the models they do offer.").option("--runtime <version>", "Simulator runtime to create this workspace's owned sim on, as a version (\"18.5\") or a runtime's full name (\"iOS 18.5\"); nothing else matches. Overrides the ios.runtime setting for this invocation. An unknown version refuses with STIM_BAD_ARG and prints the installed runtimes.").option("--simulator-app <app>", "Open the owned simulator in xcode, siniulator, or stim-desktop for this run, overriding the machine iosSimulatorApp setting. Also opens an already running simulator; local simulators only.").option("--device [udid]", "Build the iphoneos slice for a connected iPhone, install it, and launch it, instead of using this workspace's owned simulator. The phone can be cabled or paired over Wi-Fi. With no UDID, the first cabled device this workspace can lease is used, waiting for one that is busy; a Wi-Fi device is used only when no cabled one is connected and ready. In Debug the app is wired to this workspace's Metro over the LAN. Stim never creates, boots, or deletes a physical device.").option("--remote <target>", "Run on eas, proxy, or an approved Mac in remote.machines; named Macs never fall back locally. auto places on an approved Mac when this Mac is full or busy.", (value) => {
-		if (parseMachine(value)) return value.trim();
-		throw new InvalidArgumentError("expected eas, proxy, auto, or a remote Mac name");
-	}).option("--wait <seconds>", "How long to wait for another workspace to release the phone it leases, before refusing with STIM_DEVICE_BUSY (default 60, 0 refuses at once). Without --device, wait for an owned-device slot (default 600 seconds; --no-wait refuses immediately).").option("--no-wait", "Install on a phone another workspace leases instead of waiting: this run takes no lease and, when both workspaces build the same app id, the install terminates the holder's running app. Without --device, refuse a full device cap or existing slot queue immediately.").action(async (opts) => {
-		if (opts.plan) {
-			const d = {
-				...DEFAULT_DEPS,
-				...deps
-			};
-			await planIos(opts, d, (root, scheme, isExpo) => explicitSchemeRefusal(root, scheme, isExpo, d));
-			return;
-		}
-		const root = (deps.findProjectRoot ?? DEFAULT_DEPS.findProjectRoot)(process.cwd());
-		const run = (progress) => runIos({
-			...opts,
-			waitConflict: waitFlagConflict(process.argv)
-		}, deps, progress);
-		const completion = root ? await withNativeBuildRun(root, {
-			command: "ios",
-			platform: "ios",
-			slot: opts.slot ?? "default"
-		}, async (claim) => {
-			recordWorkspaceUse(root);
-			const progress = startBuildProgress({
-				root,
-				platform: "ios",
-				slot: opts.slot ?? "default",
-				claim,
-				note: (line) => writeNote(chalk.dim(line))
-			});
-			try {
-				return await run(progress);
-			} finally {
-				progress.clear();
-			}
-		}, { write: (line) => writeNote(chalk.dim(phaseLine("lock", line))) }) : await run();
-		if (!completion) process.exit(runCancellation() ? 130 : 1);
-		else if (completion.uploadsAbandoned) exitAfterFlush(0);
-	});
-}
-function unlessCancelled(result) {
-	if (!result.ok || !runCancellation()) return result;
-	return {
-		ok: false,
-		failure: {
-			code: "STIM_CANCELLED",
-			message: "before install"
-		},
-		compilationCache: result.artifact.cache.compilation
-	};
-}
-function explicitSchemeRefusal(root, scheme, isExpo, d) {
-	if (scheme === void 0) return null;
-	if (!scheme.trim()) return {
-		code: "STIM_BAD_ARG",
-		message: "--scheme must name a non-empty shared Xcode app scheme.",
-		remedy: "Pass the exact scheme name shown by xcodebuild -list."
-	};
-	if (isExpo) return null;
-	const project = d.discoverXcodeProject(root);
-	if (project.error) return project.error;
-	return d.resolveScheme(project, { scheme }).error ?? null;
-}
-function resolveIosBuildSetup(flag, settings) {
-	const placement = resolveBuildPlacement(flag);
-	if (placement.failure) return {
-		ok: false,
-		failure: {
-			...placement.failure,
-			setup: true
-		}
-	};
-	try {
-		return {
-			ok: true,
-			buildMachine: placement.selected,
-			optimizations: resolveOptimizations(settings)
-		};
-	} catch (error) {
-		return {
-			ok: false,
-			failure: {
-				code: "STIM_BAD_ARG",
-				message: error.message,
-				remedy: SETTING_SHAPE_REMEDY
-			}
-		};
-	}
-}
-function iosSlotLogFile(root, slot) {
-	return slot === "default" ? buildLogFile(root) : join(workspaceLogsDir$1(root), `build-${deviceSlotFileKey("ios", slot)}.ndjson`);
-}
-function iosSlotDeps(d, slot) {
-	if (slot !== "default") {
-		const base = d;
-		d = {
-			...base,
-			ensureOwnedDevice: (args) => base.ensureOwnedDevice({
-				...args,
-				slot
-			}),
-			checkDeviceCapacity: (args) => base.checkDeviceCapacity({
-				...args,
-				slot
-			}),
-			selectFromPool: (args) => base.selectFromPool({
-				...args,
-				slot
-			}),
-			acquireRunLease: (args) => base.acquireRunLease({
-				...args,
-				slot
-			}),
-			runLease: (args) => base.runLease({
-				...args,
-				slot
-			}),
-			replaceCollector: (args) => base.replaceCollector({
-				...args,
-				slot
-			}),
-			stopPreviousCollector: (args) => base.stopPreviousCollector({
-				...args,
-				slot
-			}),
-			clearIosAdoptionPending: (root) => base.clearIosAdoptionPending(root, slot),
-			writeWorkspaceLaunch: (root, platform, record) => base.writeWorkspaceLaunch(root, platform, record, slot),
-			createWriter: (file, options) => base.createWriter(file, {
-				...options,
-				fields: { slot }
-			})
-		};
-	}
-	return d;
-}
-async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
-	const slot = validateDeviceSlot(opts.slot);
-	let d = iosSlotDeps({
-		...DEFAULT_DEPS,
-		...overrides
-	}, slot);
-	const json = Boolean(opts.json);
-	const metroCheck = opts.metroCheck !== false;
-	let useBuildCache = opts.buildCache !== false;
-	const phase = writePhase;
-	const note = writeNote;
-	const started = d.now();
-	const startedAt = new Date(started).toISOString();
-	const elapsed = () => d.now() - started;
-	const refuseProject = ({ message, remedy }) => {
-		note(chalk.red(phaseLine("error", message)));
-		note(chalk.dim(phaseLine("remedy", remedy)));
-		note(chalk.red(phaseLine("failed", "STIM_NO_PROJECT")));
-		if (json) console.log(JSON.stringify({
-			code: "STIM_NO_PROJECT",
-			message,
-			remedy
-		}));
-		process.exitCode = 1;
-		return null;
-	};
-	const foundRoot = d.findProjectRoot(process.cwd());
-	if (!foundRoot) return refuseProject(NO_PROJECT_REFUSAL);
-	const root = foundRoot;
-	const projectProblem = appProjectProblem(root);
-	if (projectProblem) return refuseProject(projectProblem);
-	try {
-		await d.ensureWorkspaceStorage(root, { note });
-	} catch (error) {
-		const code = error?.code || "STIM_WORKSPACE_STATE";
-		const message = `Could not prepare this workspace's Stim state: ${error?.message || error}`;
-		note(chalk.red(`${code}: ${message}`));
-		note(chalk.dim("Check that STIM_HOME is writable and has free space. An EPERM on a directory you can write is a sandbox: allow writes to STIM_HOME, or run Stim with the sandbox disabled (`stim guide errors sandbox`)."));
-		if (json) console.log(JSON.stringify({
-			code,
-			message,
-			remedy: "Check that STIM_HOME is writable and has free space."
-		}));
-		process.exitCode = 1;
-		return null;
-	}
-	const logsDir = workspaceLogsDir$1(root);
-	const logFile = iosSlotLogFile(root, slot);
-	let writer = null;
-	const logWriter = () => writer ||= tapBuildLog(d.createWriter(logFile, {
-		truncate: true,
-		fields: {
-			platform: "ios",
-			slot
-		}
-	}), progress);
-	let leaseHandle = null;
-	let stopLeaseSignals = null;
-	const releaseLease = () => {
-		const held = leaseHandle;
-		const stopSignals = stopLeaseSignals;
-		leaseHandle = null;
-		stopLeaseSignals = null;
-		stopSignals?.();
-		try {
-			held?.release();
-		} catch (e) {
-			note(chalk.dim(`Could not release this run's device lease: ${e?.message || e}`));
-		}
-	};
-	const stats = createRunRecorder({
-		platform: "ios",
-		write: (statsRun, at) => d.recordStats(statsRun, at),
-		now: () => d.now(),
-		note: (line) => note(chalk.dim(line)),
-		phases: () => progress.durations(),
-		deviceSetup: () => progress.deviceSetupKnown()
-	});
-	const deviceWaitRun = createIosDeviceWaitRun(stats, progress, runCancellationSignal());
-	const recordRun = deviceWaitRun.record;
-	let compilationCache = COMPILATION_CACHE_NOT_RUN;
-	let reclaimed = [];
-	let buildMachine = "auto";
-	let devicePlacement;
-	let builtConfiguration = null;
-	const fail = ({ code, message, remedy = null, lines = [], logPath = null, build = null, lease, setup = false }) => {
-		({code, message, remedy, lines} = cancelledFailure("ios", {
-			code,
-			message
-		}) ?? {
-			code,
-			message,
-			remedy,
-			lines
-		});
-		releaseLease();
-		if (message) note(chalk.red(phaseLine("error", message)));
-		for (const line of lines) note(chalk.dim(phaseLine("", line)));
-		if (remedy) note(chalk.dim(phaseLine("remedy", remedy)));
-		if (logPath) note(chalk.dim(phaseLine("log", logPath)));
-		if (build) writeLastBuild(root, lastBuildRecord({
-			devicePlacement,
-			buildMachine,
-			...build,
-			configuration: builtConfiguration,
-			startedAt,
-			status: "failed",
-			errorCode: code,
-			durationMs: elapsed()
-		}));
-		note(chalk.red(phaseLine("failed", code)));
-		if (!setup) recordRun({
-			failed: true,
-			durationMs: elapsed()
-		});
-		if (json) console.log(JSON.stringify({
-			code,
-			message: message ?? null,
-			remedy: remedy ?? null,
-			...devicePlacement ? { devicePlacement } : {},
-			...compilationCache.status === "not-run" ? {} : { compilationCache },
-			...lease === void 0 ? {} : { lease },
-			...reclaimed.length ? { reclaimed } : {}
-		}));
-		writer?.close?.();
-		process.exitCode = 1;
-		return null;
-	};
-	const settingsRepoRoot = d.repoRoot(root);
-	const settingsContext = {
-		projectPath: root,
-		gitCommonDir: d.gitCommonDir(root),
-		repoRoot: settingsRepoRoot
-	};
-	const projectKey = statsProjectKey$1({
-		root,
-		commonDir: settingsContext.gitCommonDir,
-		repoRoot: settingsRepoRoot
-	});
-	stats.setProject(projectKey);
-	progress.estimate(projectKey);
-	let estimatesRead = null;
-	const estimates = () => estimatesRead ??= d.readEstimates({
-		projectKey,
-		platform: "ios"
-	});
-	const settings = d.resolveSettings(settingsContext);
-	const [shapeError, ...moreShapeErrors] = settingShapeErrors(settings);
-	if (shapeError) return fail({
-		code: "STIM_BAD_ARG",
-		message: shapeError,
-		lines: moreShapeErrors,
-		remedy: SETTING_SHAPE_REMEDY
-	});
-	const setup = resolveIosBuildSetup(opts.remoteBuild, settings);
-	if (!setup.ok) return fail(setup.failure);
-	buildMachine = setup.buildMachine;
-	const { optimizations } = setup;
-	const buildProfile = optimizationBuildProfile("ios", optimizations);
-	const cacheProviderConfig = d.resolveCacheProviderConfig(settingsContext);
-	for (const key of unknownSettingKeys(settings)) note(phaseLine("setting", chalk.yellow(`Warning: setting "${key}" is not read by Stim and will be ignored.`)));
-	const cacheProviderError = cacheProviderSettingError(settings);
-	if (cacheProviderError) note(chalk.yellow(phaseLine("cache", `${cacheProviderError} Using the local cache.`)));
-	const poolError = parkedMaxSetting("ios").error;
-	if (poolError) return fail({
-		code: "STIM_BAD_ARG",
-		message: poolError,
-		remedy: POOL_SETTING_REMEDY
-	});
-	for (const settingError of [
-		iosSigningIdentitySettingError(settings),
-		iosSigningIdentitySha1SettingError(settings),
-		iosLanHostSettingError(settings)
-	]) if (settingError) return fail({
-		code: "STIM_BAD_ARG",
-		message: settingError,
-		remedy: SETTING_SHAPE_REMEDY
-	});
-	const configuration = opts.easProfile !== void 0 ? null : resolveConfiguration(opts.configuration, settings);
-	builtConfiguration = configuration ?? "Debug";
-	const buildScheme = opts.scheme;
-	const release = isReleaseConfiguration(configuration);
-	const cachePolicy = artifactCachePolicy(optimizations, useBuildCache, release);
-	useBuildCache = cachePolicy.read;
-	const deviceType = resolveDeviceType(opts.deviceType, settings);
-	const runtime = resolveRuntime(opts.runtime, settings);
-	const deviceFlag = opts.device;
-	const physical = isPhysicalDeviceRequest(deviceFlag);
-	if (physical && deviceFlag === "") return fail({
-		code: "STIM_BAD_ARG",
-		message: "--device was given an empty UDID.",
-		remedy: "Pass `--device` on its own to take the first connected device this workspace can lease, or `--device <udid>` to name one."
-	});
-	if (physical && opts.remote) return fail({
-		code: "STIM_BAD_ARG",
-		message: "--device builds for a phone connected to this machine, and --remote installs on a remote one.",
-		remedy: "Pass only one of --device and --remote."
-	});
-	const wait = resolveIosWait(opts, physical);
-	if ("failure" in wait) return fail(wait.failure);
-	const { waitSeconds, noWait, deviceSlotWaitMs, checkCapacity } = wait;
-	const deviceSlotWait = {
-		waitMs: deviceSlotWaitMs,
-		displayName: basename(root),
-		...deviceWaitRun.policy,
-		onWait: (ms) => {
-			deviceWaitRun.policy.onWait?.(ms);
-			if (devicePlacement?.decision === "local" && ms > 0) devicePlacement.decision = "waited-locally";
-		}
-	};
-	const isExpo = d.detectIsExpo(root);
-	const schemeRefusal = explicitSchemeRefusal(root, buildScheme, isExpo, d);
-	if (schemeRefusal) return fail(schemeRefusal);
-	const remoteSelection = await selectIosPlacement({
-		root,
-		slot,
-		opts,
-		settings,
-		physical,
-		release,
-		metroCheck,
-		d,
-		deviceType,
-		runtime,
-		validateSelectors: () => deviceModelRefusal({
-			slot,
-			deviceTypeFlag: opts.deviceType,
-			runtimeFlag: opts.runtime,
-			deviceType,
-			runtime,
-			physical,
-			remoteBackend: null,
-			deviceTypeOrigin: d.settingOriginScope(d.settingsLayers(settingsContext), "ios.deviceType"),
-			runtimeOrigin: d.settingOriginScope(d.settingsLayers(settingsContext), "ios.runtime"),
-			listRuntimes: d.listIosRuntimes
-		}),
-		noWait: deviceSlotWaitMs === 0,
-		note,
-		phase
-	});
-	if ("failure" in remoteSelection) return fail(remoteSelection.failure);
-	devicePlacement = remoteSelection.devicePlacement;
-	writeDevicePlacement(root, slot, "ios", devicePlacement);
-	const { machine: hostedMachine, backend: remoteBackend } = remoteSelection;
-	const viewer = resolveSimulatorAppFlag(opts.simulatorApp, physical, hostedMachine ?? remoteBackend, Boolean(remoteSelection.auto));
-	if ("refusal" in viewer) return fail(viewer.refusal);
-	const { simulatorApp } = viewer;
-	const settingsLayersForOrigin = d.settingsLayers(settingsContext);
-	const modelRefusal = deviceModelRefusal({
-		slot,
-		deviceTypeFlag: opts.deviceType,
-		runtimeFlag: opts.runtime,
-		deviceType,
-		runtime,
-		deviceTypeOrigin: d.settingOriginScope(settingsLayersForOrigin, "ios.deviceType"),
-		runtimeOrigin: d.settingOriginScope(settingsLayersForOrigin, "ios.runtime"),
-		physical,
-		remoteBackend,
-		hosted: Boolean(hostedMachine),
-		listRuntimes: d.listIosRuntimes
-	});
-	if (modelRefusal) return fail(modelRefusal);
-	const selectors = hostedIosSelectors(deviceType, runtime);
-	const connected = await connectIosTarget(remoteSelection, selectors, d);
-	if ("failure" in connected) return fail(connected.failure);
-	const hostedTarget = connected.target;
-	try {
-		const budget = await iosPlacementBudget(d, root, note, Boolean(hostedTarget), remoteSelection.budget);
-		reclaimed = budget.reclaimed;
-		if (budget.refusal) return fail(budget.refusal);
-		const backendConnection = await connectIosBackend(root, remoteBackend, opts.deviceType, d);
-		if ("failure" in backendConnection) return fail(backendConnection.failure);
-		const remoteDevice = backendConnection.remote;
-		const remoteArch = hostedTarget ? hostedTarget.choice.architecture : backendConnection.arch;
-		if (remoteDevice) d = {
-			...d,
-			checkDeviceCapacity: remoteDevice.checkDeviceCapacity,
-			ensureOwnedDevice: remoteDevice.ensureOwnedDevice,
-			ensureBooted: remoteDevice.ensureBooted,
-			installIosApp: remoteDevice.installIosApp,
-			launchIosApp: remoteDevice.launchIosApp
-		};
-		const easBuild = await d.resolveEasDevelopmentBuild({
-			root,
-			platform: "ios",
-			profile: opts.easProfile,
-			note,
-			isExpo,
-			physical,
-			selectors: [opts.scheme, opts.configuration],
-			buildCache: opts.buildCache
-		});
-		if (isEasBuildFailure(easBuild)) return fail(easBuild);
-		const registerProject = () => d.upsertProject(root, {
-			bundleId: d.detectBundleId(root) ?? void 0,
-			isExpo
-		});
-		if (remoteBackend !== "eas") registerProject();
-		const proj = d.getProject(root);
-		const limits = d.getConcurrencyLimits();
-		let physicalDevice = null;
-		let wireless = false;
-		if (physical && typeof deviceFlag !== "string") {
-			const pooled = await d.selectFromPool({
-				root,
-				platform: "ios",
-				idLabel: "udid",
-				list: () => iosPoolCandidates(d.listIosDevices()).map((entry) => ({
-					id: entry.udid,
-					name: entry.name,
-					fallback: isWirelessIosDevice(entry)
-				})),
-				noCandidates: () => {
-					const resolved = iosPoolNoCandidatesRefusal(d.listIosDevices());
-					return {
-						message: resolved.error,
-						remedy: resolved.remedy
-					};
-				},
-				waitSeconds,
-				noWait,
-				now: d.now,
-				warn: (line) => note(chalk.yellow(phaseLine("lease", line)))
-			});
-			if (pooled.status === "refused") return fail({
-				code: pooled.refusal.code,
-				message: pooled.refusal.message,
-				remedy: pooled.refusal.remedy,
-				...pooled.refusal.lease === null ? {} : { lease: pooled.refusal.lease }
-			});
-			physicalDevice = {
-				udid: pooled.candidate.id,
-				name: pooled.candidate.name ?? pooled.candidate.id
-			};
-			wireless = pooled.candidate.fallback === true;
-		} else if (physical) {
-			const resolved = resolveIosPhysicalDevice(typeof deviceFlag === "string" ? deviceFlag : null, d.listIosDevices());
-			if (!resolved.udid) return fail({
-				code: "STIM_NO_DEVICE",
-				message: resolved.error,
-				remedy: resolved.remedy
-			});
-			physicalDevice = {
-				udid: resolved.udid,
-				name: resolved.name ?? resolved.udid
-			};
-			wireless = resolved.wireless === true;
-		}
-		if (checkCapacity && !hostedTarget) {
-			const capacity = d.checkDeviceCapacity({
-				platform: "ios",
-				project: proj,
-				max: limits.maxDevices
-			});
-			if (capacity) {
-				if (capacity.code === "STIM_AT_CAPACITY") d.recordCapacityRefusal({
-					platform: "ios",
-					max: limits.maxDevices,
-					workspace: workspaceId(root)
-				}, d.now());
-				return fail(capacity);
-			}
-		}
-		let metroPort = proj?.metroPort ?? null;
-		let lanAddress = null;
-		let lanOriginUrl = null;
-		let devServer = null;
-		if (!await resolveMetroPort()) return null;
-		let device;
-		if (physicalDevice) device = {
-			deviceUdid: physicalDevice.udid,
-			deviceName: physicalDevice.name,
-			owned: false
-		};
-		else if (hostedTarget) device = {
-			owned: false,
-			deviceName: hostedTarget.choice.deviceType,
-			runtime: hostedTarget.choice.runtime
-		};
-		else {
-			const prepare = stepClock(d.now);
-			try {
-				device = await d.ensureOwnedDevice({
-					platform: "ios",
-					project: proj,
-					projectPath: root,
-					settingsRoot: root,
-					settings,
-					flags: {
-						deviceSlotWait,
-						deviceType,
-						runtime,
-						runtimeFlag: resolveRuntime(opts.runtime, null),
-						simulatorApp
-					},
-					note,
-					out: note
-				});
-			} catch (e) {
-				return fail(ownedSimFailure(e));
-			}
-			deviceWaitRun.booting(device.booting);
-			progress.deviceSetup(didSetUpDevice(device, Boolean(remoteDevice)));
-			const prepareMs = prepare();
-			if (device.created || prepareMs >= 2e3) phase("device", `${deviceLabel(device, device.deviceUdid)} ${device.created ? "created" : "prepared"} (${formatDuration(prepareMs)})`);
-		}
-		let bootDuration = "";
-		let bootPromise;
-		let udid = "";
-		async function resolveMetroPort() {
-			if (release) {
-				metroPort = null;
-				phase("metro", `skipped (${configuration}: the JS bundle is embedded, no dev server is used)`);
-			} else if (metroCheck) {
-				const gate = await ensureDevServer({
-					root,
-					port: metroPort,
-					settings: hostedMetroSettings(settings, Boolean(hostedTarget)),
-					remote: Boolean(remoteDevice),
-					note,
-					resolve: d.resolveProjectMetro,
-					start: d.startDevServer,
-					readState: d.readWorkspaceState
-				});
-				reclaimed = [...reclaimed, ...gate.reclaimed];
-				if (!gate.ok) {
-					fail({
-						code: gate.code,
-						message: gate.message,
-						remedy: gate.remedy,
-						lines: gate.lines
-					});
-					return false;
-				}
-				metroPort = gate.port;
-				devServer = gate.devServer;
-			} else {
-				const pin = metroPortSetting(root);
-				if (pin.error) {
-					fail({
-						code: "STIM_BAD_ARG",
-						message: pin.error,
-						remedy: SETTING_SHAPE_REMEDY
-					});
-					return false;
-				}
-				if (pin.port === null && !metroPort) note(chalk.yellow(`No Metro port is reserved for this workspace; wiring the app to ${DEFAULT_METRO_PORT}.`));
-				metroPort = pin.port ?? metroPort ?? 8081;
-			}
-			hostedIosMetroNote(Boolean(hostedTarget), settings, note, opts.simulatorApp);
-			if (physical && metroPort !== null && !await resolveLanOrigin()) return false;
-			if (remoteDevice && metroPort !== null) {
-				const reachable = await d.ensureMetroReachable({
-					ctx: remoteDevice.ctx,
-					metroPort,
-					isExpo,
-					tunnelMode: tunnelModeSetting(settings) ?? void 0,
-					publicUrl: publicUrlSetting(settings),
-					available: d.detectProviders(binOnPath, tunnelModeSetting(settings) ?? "auto")
-				});
-				if ("failed" in reachable) {
-					fail({
-						code: reachable.code ?? "STIM_NO_REMOTE_SESSION",
-						message: reachable.failed,
-						remedy: reachable.remedy
-					});
-					return false;
-				}
-			}
-			if (!release && metroCheck && optimizations.metroWarmup) d.warmMetro({
-				port: metroPort,
-				platform: "ios",
-				isExpo,
-				appId: proj?.bundleId,
-				bundleUrl: metroWarmupUrlSetting(settings, "ios")
-			});
-			return true;
-		}
-		async function resolveLanOrigin() {
-			const port = metroPort;
-			const chosen = chooseLanAddress({
-				pinned: iosLanHostSetting(settings),
-				candidates: d.hostLanCandidates()
-			});
-			if (!chosen) {
-				fail({
-					code: "STIM_NO_LAN_ADDRESS",
-					message: "A Debug run on a phone needs an address the phone can reach, and this Mac has no non-internal IPv4 interface.",
-					remedy: "The phone reaches Metro over the network you share, because USB carries no reverse forward. Join a Wi-Fi or Ethernet network, or connect this Mac by cable, then run the command again."
-				});
-				return false;
-			}
-			lanAddress = chosen.address;
-			lanOriginUrl = lanOriginUrlFor(chosen.address, port);
-			const source = chosen.pinned ? "ios.lanHost" : `${chosen.interfaceName ?? "interface"}${chosen.candidates > 1 ? ` of ${chosen.candidates} candidates` : ""}`;
-			phase("lan", `${lanOriginUrl} (${source})`);
-			if (publicUrlSetting(settings) || tunnelModeSetting(settings)) note(chalk.dim(phaseLine("lan", "metro.publicUrl and metro.tunnel are ignored on --device: neither channel to a phone carries a URL, only a host and a port. They still apply to --remote.")));
-			if (!metroCheck) return true;
-			const reachable = await d.ensureLanReachable({
-				origin: lanOriginUrl,
-				metroPort: port,
-				root,
-				isExpo,
-				logsDir
-			});
-			if ("failed" in reachable) {
-				fail({
-					code: "STIM_LAN_METRO_UNREACHABLE",
-					message: reachable.failed,
-					remedy: reachable.remedy
-				});
-				return false;
-			}
-			phase("lan", `gated: ${lanOriginUrl} answered as this workspace's Metro`);
-			return true;
-		}
-		let artifact = null;
-		try {
-			const boot = () => physicalDevice ? Promise.resolve({
-				ok: true,
-				udid: physicalDevice.udid
-			}) : Promise.resolve(d.ensureBooted({
-				platform: "ios",
-				device,
-				projectPath: root,
-				deviceSlotWait,
-				simulatorApp,
-				out: note
-			})).catch((e) => ({
-				ok: false,
-				reason: String(e?.message || e)
-			}));
-			const startBoot = () => {
-				const bootTimer = stepTimer(d.now);
-				bootPromise = (remoteDevice?.ctx.backend === "eas" ? d.ensureRemoteBootOwned({
-					root,
-					platform: "ios",
-					sessionName: ownedSessionName(remoteDevice.ctx.label),
-					startedAt: new Date(d.now()).toISOString(),
-					deviceType: remoteDevice.ctx.deviceType ?? null,
-					boot,
-					createdSessionId: remoteDevice.createdSessionId,
-					abandonCreatedSession: remoteDevice.abandonCreatedSession,
-					webPreviewUrl: remoteDevice.webPreviewUrl,
-					writeState: d.writeWorkspaceState,
-					register: registerProject,
-					notice: (line) => note(chalk.dim(phaseLine("lock", line)))
-				}) : boot()).then((result) => {
-					bootDuration = bootTimer();
-					return result;
-				});
-				deviceWaitRun.booting({ done: bootPromise });
-				return bootPromise.then((result) => result?.udid ?? "");
-			};
-			const localBoot = remoteDevice || hostedTarget ? null : startBoot();
-			udid = device.deviceUdid ?? await localBoot ?? "";
-			const acquiredArtifact = unlessCancelled(await acquireIosArtifact({
-				root,
-				logFile,
-				udid,
-				configuration,
-				buildScheme,
-				buildProfile,
-				buildMachine,
-				isExpo,
-				remoteDestination: Boolean(remoteDevice || hostedTarget),
-				...hostedIosBuildTarget(hostedTarget),
-				simulatorArch: simulatorBuildArch({
-					physical,
-					remoteArch,
-					hostArch: d.hostSimulatorArch(),
-					configuration
-				}),
-				device: physical ? {
-					lanAddress,
-					metroPort,
-					signingName: iosSigningIdentitySetting(settings),
-					signingSha1: iosSigningIdentitySha1Setting(settings)
-				} : null,
-				optimizations: optimizations.ios,
-				cache: {
-					policy: cachePolicy,
-					providerConfig: cacheProviderConfig,
-					disabledByFlag: opts.buildCache === false
-				},
-				easBuild,
-				easProfile: opts.easProfile,
-				maxBuilds: limits.maxBuilds,
-				progress: {
-					phase,
-					note,
-					logWriter,
-					estimates,
-					stats,
-					step: progress.step,
-					miss: progress.miss,
-					hit: progress.hit,
-					place: progress.place,
-					waitingOn: progress.waitingOn,
-					waitingFor: progress.waitingFor
-				}
-			}, d));
-			if (!acquiredArtifact.ok) {
-				compilationCache = acquiredArtifact.compilationCache;
-				return fail(acquiredArtifact.failure);
-			}
-			artifact = acquiredArtifact.artifact;
-			compilationCache = artifact.cache.compilation;
-			if (hostedTarget) return await finishHostedIosRun({
-				target: hostedTarget,
-				root,
-				slot,
-				d,
-				artifact,
-				configuration,
-				buildScheme,
-				release,
-				isExpo,
-				metroCheck,
-				metroPort,
-				logsDir,
-				json,
-				elapsed,
-				startedAt,
-				closeWriter: () => writer?.close(),
-				devicePlacement,
-				recordRun,
-				reclaimed,
-				devServer,
-				fail,
-				note,
-				selectors
-			});
-			if (!localBoot) {
-				progress.step("device");
-				udid = await startBoot();
-			}
-			if (physicalDevice) {
-				progress.step("device");
-				const acquired = await d.acquireRunLease({
-					root,
-					platform: "ios",
-					id: physicalDevice.udid,
-					deviceName: physicalDevice.name,
-					idLabel: "udid",
-					waitSeconds,
-					noWait,
-					installBoundMs: iosDeviceBounds(wireless).installMs,
-					appId: artifact.bundleId ?? proj?.bundleId ?? null,
-					holderAppId: (holder) => d.getProject(holder)?.bundleId ?? null,
-					now: d.now,
-					warn: (line) => note(chalk.yellow(phaseLine("lease", line)))
-				});
-				if (acquired.status === "refused") return fail({
-					code: acquired.refusal.code,
-					message: acquired.refusal.message,
-					remedy: acquired.refusal.remedy,
-					lease: acquired.refusal.lease
-				});
-				leaseHandle = d.runLease({
-					root,
-					platform: "ios",
-					kind: acquired.status === "leased" ? acquired.kind : null,
-					expiresAt: acquired.status === "leased" ? acquired.expiresAt : null
-				});
-				if (acquired.status === "leased") {
-					stopLeaseSignals = d.releaseLeaseOnSignal(releaseLease);
-					phase("lease", `${acquired.kind} lease on ${physicalDevice.udid} until ${leaseExpiryText(acquired.expiresAt, d.now())}`);
-				}
-			}
-			try {
-				return await finishIosRun({
-					slot,
-					d,
-					root,
-					json,
-					release,
-					configuration,
-					buildScheme,
-					isExpo,
-					metroCheck,
-					metroPort,
-					logsDir,
-					logFile,
-					device,
-					udid,
-					physical,
-					wireless,
-					lanAddress,
-					lanOriginUrl,
-					remoteDevice,
-					bootPromise,
-					bootDuration: () => bootDuration,
-					artifact,
-					fail,
-					phase,
-					note,
-					logWriter,
-					elapsed,
-					startedAt,
-					closeWriter: () => writer?.close?.(),
-					lease: leaseHandle,
-					releaseLease,
-					devicePlacement,
-					recordRun,
-					reclaimed,
-					devServer,
-					enterPhase: progress.step
-				});
-			} finally {
-				releaseLease();
-			}
-		} catch (error) {
-			recordRun({
-				failed: true,
-				durationMs: elapsed()
-			});
-			throw error;
-		} finally {
-			artifact?.release();
-		}
-	} finally {
-		await deviceWaitRun.finish();
-		hostedTarget?.host.connection.close();
-	}
-}
-//#endregion
-export { appNameFromPath, buildLogFile, cacheDescription, collectorEntry, iosCommand as default, devClientScheme, deviceLabel, ensureWorkspaceStorageSafely, formatDuration, iosConfigurationSetting, iosFacts, isReleaseConfiguration, lastBuildRecord, phaseLine, pickDevClientScheme, podAction, registerIos, replaceCollector, resolveConfiguration, resolveDeviceType, resolveRuntime, schemesFromInfoPlist, shortHash, shortUdid, writeLastBuild };