stim 1.13.0 → 1.15.0

package/dist/{ios-CcfCeZ19.mjs → ios-Chob8ny7.mjs}

@@ -1,39 +1,50 @@
-import { A as ownership_claim_exports, G as validateDeviceSlot, H as parseDeviceSlotOption, R as deviceSlotFileKey, T as upsertProject, p as getProject, u as getConcurrencyLimits, z as deviceSlotKey } from "./config-0jCcMM0E.mjs";
-import { t as getExecutor } from "./exec-DK8KaVHK.mjs";
+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 } from "./config-D0DbpZtM.mjs";
+import { n as ownership_claim_exports } from "./process-identity-BmRm1qV0.mjs";
 import { r as createNdjsonWriter } from "./ndjson-CDY9IkVC.mjs";
-import { M as workspaceLogsDir, a as pidExists, b as writeWorkspaceState, c as resolveProjectMetro, g as recordWorkspaceUse, h as readWorkspaceState$1, k as workspaceDir, l as signalProcessTree } from "./metro-BPeY1YMh.mjs";
-import { D as makeTemporaryDirectory, O as removeTemporaryEntry, s as gitCommonDir, y as repoRoot } from "./worktree-DeBQSVtR.mjs";
-import { a as findProjectRoot, n as appProjectProblem, r as detectIsExpo, t as NO_PROJECT_REFUSAL } from "./project-DGeclhvO.mjs";
-import { m as writeWorkspaceLaunch, n as MODE_EXPO, t as MODE_BARE } from "./state-DwAU2_-D.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-BIL7rlX7.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-CL9dZf73.mjs";
-import { ct as parkedMaxSetting, rt as POOL_SETTING_REMEDY } from "./android-qx_31wJo.mjs";
-import { A as resolveCacheProviderConfig, B as detectProviders, E as publicUrlSetting, G as resolveOptimizations, H as artifactCachePolicy, I as tunnelModeSetting, L as unknownSettingKeys, P as settingShapeErrors, S as metroWarmupUrlSetting, W as optimizationBuildProfile, _ as iosSigningIdentitySha1SettingError, a as SETTING_SHAPE_REMEDY, d as cacheProviderSettingError, f as iosLanHostSetting, g as iosSigningIdentitySha1Setting, h as iosSigningIdentitySettingError, j as resolveSettings, k as remoteIosSetting, m as iosSigningIdentitySetting, p as iosLanHostSettingError, r as REMOTE_DEVICE_BACKENDS } from "./settings-xB0Frkg6.mjs";
-import { D as parseIosSimulatorApp, f as listIosRuntimes } from "./ios-CmEzZiOj.mjs";
-import { c as recordFinishedBuild, l as startBuildProgress, n as NO_BUILD_PROGRESS } from "./build-progress-l7d-X-ZP.mjs";
-import { a as acquireBuildSlot, s as releaseBuildSlot } from "./in-use-wYEaKQM9.mjs";
-import { n as verifyCollectorOwnership } from "./ownership-Bz2kETAS.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--aehr4Pr.mjs";
-import { F as ownedSessionName, S as withNativeBuildRun, a as ensureMetroReachable, l as remoteIosDeps, m as cancelledFailure, n as binOnPath, o as ensureRemoteBootOwned, r as bundleEntryPoint, u as resolveRemoteContext, x as runCancellation, z as gateMetroOrigin } from "./device-remote-DT9ngZiD.mjs";
-import { c as clearOtherUserApps, h as iosAppProcess, m as installIosApp, r as DEFAULT_METRO_PORT, u as devClientUrl, v as launchIosApp } from "./app-install-CDFY2nUL.mjs";
-import { c as readMetroRecords, d as verifyLaunch, f as verifyReleaseLaunch, i as RELEASE_VERIFY_WAIT_MS, l as unverifiedLaunchLines, n as LAUNCH_FATAL, o as isBundleProof, r as LAUNCH_UNVERIFIED, s as readCollectorRecords, t as LAUNCH_BUNDLING } from "./launch-verify-CuJaBpEa.mjs";
-import { f as easDeviceBuildRemedy, h as resolveEasDevelopmentBuild, l as unknownIosDeviceTypeRefusal, m as planEasDevelopmentBuild, p as isEasBuildFailure, r as checkDeviceCapacity, u as unknownIosRuntimeRefusal } from "./simslim-Bbg9UWrt.mjs";
-import { f as spawnEntry, h as detectBundleId, s as startDevServer } from "./start-BZhItkiL.mjs";
-import { a as lostLine, c as releaseLeaseOnSignal, i as leaseExpiryText, l as runLease, n as DEBUG_VERIFY_STEP_MS, o as lostRefusal, r as acquireRunLease, s as parseDeviceWait, t as selectFromPool, u as waitFlagConflict } from "./device-pool-MuoiyRcu.mjs";
-import { C as warmMetro, S as clearIosAdoptionPending, _ as staleNativeDirRefusal, a as refusePlan, c as skippedMissReason, d as schemesFromInfoPlist, g as runPrebuild, h as recordPrebuild, i as printPlan, l as devClientScheme, m as planPrebuild, n as planFlagRefusal, o as explainBuildMiss, p as swapJsBundle, r as planPayload, s as fingerprintErrorMissReason, t as planCachedBuild, u as pickDevClientScheme, v as ensureBooted, y as ensureOwnedDevice } from "./build-plan-BTa93o_r.mjs";
-import { t as budgetGate } from "./budget-E5o91NR1.mjs";
-import { a as sleep, i as launchOutcomeRecord, n as ensureWorkspaceStorageSafely, r as isPhysicalDeviceRequest, t as ensureDevServer } from "./native-runtime-CiiFHt0e.mjs";
-import { a as statsProjectKey, i as recordRunStats, n as readRunEstimates, t as createRunRecorder } from "./stats-D8rUTPHd.mjs";
-import { a as compilationCacheActivityLine, c as readBundleExecutable, l as readBundleId, p as describeDiagnostic, r as buildIos, s as discoverXcodeProject, t as COMPILATION_CACHE_NOT_RUN, u as resolveScheme } from "./xcode-LM6A8cNZ.mjs";
-import { n as nativeRunCommand, t as launchSlotScope } from "./slot-launch-BIWEW-wI.mjs";
-import { a as printNativeCrashReport, n as IOS_CRASH_REPORT_RETRY, o as simulatorConsolePaths, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-BoiOhck8.mjs";
-import { a as iosPoolCandidates, c as listIosDevices, d as verifyIosDeviceReleaseLaunch, i as iosDeviceProcess, l as localNetworkPending, n as installIosDeviceApp, o as iosPoolNoCandidatesRefusal, r as iosDeviceBounds, s as isWirelessIosDevice, t as awaitIosDeviceLaunch, u as resolveIosPhysicalDevice } from "./ios-device-BW-t_Lkv.mjs";
-import { a as runPodInstall, n as podsAreStale, r as readPodState } from "./deps-2Wo81np9.mjs";
+import { C as workspaceLogsDir, b as workspaceDir, c as writeWorkspaceState, i as recordWorkspaceUse, r as readWorkspaceState$1 } from "./workspace-state-CL2V2Ons.mjs";
+import { D as makeTemporaryDirectory, O as removeTemporaryEntry, s as gitCommonDir, y as repoRoot } from "./worktree-C0c5Udwa.mjs";
+import { a as findProjectRoot$1, n as appProjectProblem, r as detectIsExpo, t as NO_PROJECT_REFUSAL } from "./project-CV3tDFHl.mjs";
+import { m as writeWorkspaceLaunch, n as MODE_EXPO, t as MODE_BARE } from "./state-CaeaHbDA.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-CliHHn7a.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-W5Pi1q38.mjs";
+import { a as workspaceLinks, i as workspaceLinkLine } from "./stim-desktop-Cnz8CPnl.mjs";
+import { at as POOL_SETTING_REMEDY, dt as parkedMaxSetting } from "./android-Db2eEMaf.mjs";
+import { l as resolveProjectMetro, o as pidExists, u as signalProcessTree } from "./metro-Di8EN2Tb.mjs";
+import { B as unknownSettingKeys, I as settingOriginScope, J as optimizationBuildProfile, K as artifactCachePolicy, L as settingShapeErrors, M as resolveCacheProviderConfig, N as resolveSettings, O as publicUrlSetting, R as settingsLayers, S as metroPortSetting, U as detectProviders, Y as resolveOptimizations, _ as iosSigningIdentitySha1Setting, a as SETTING_SHAPE_REMEDY, d as cacheProviderSettingError, g as iosSigningIdentitySettingError, h as iosSigningIdentitySetting, j as remoteIosSetting, m as iosLanHostSettingError, p as iosLanHostSetting, r as REMOTE_DEVICE_BACKENDS, v as iosSigningIdentitySha1SettingError, w as metroWarmupUrlSetting, z as tunnelModeSetting } from "./settings-CduVcoxj.mjs";
+import { p as listIosRuntimes, r as clearIosAppData } from "./ios-3CtCRhwr.mjs";
+import { c as recordFinishedBuild, d as createRunRecorder, f as readRunEstimates, h as statsProjectKey$1, l as startBuildProgress, m as recordRunStats, n as NO_BUILD_PROGRESS, u as tapBuildLog } from "./build-progress-C2Jv1AtA.mjs";
+import { r as releaseBuildSlot, t as acquireBuildSlot } from "./build-slots-Df1ApSuH.mjs";
+import { n as verifyCollectorOwnership } from "./ownership-BkYxUtuj.mjs";
+import { S as restartedAppNote, _ 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-CAAplXAt.mjs";
+import { t as checkDeviceCapacity } from "./device-capacity-DMuKC7nx.mjs";
+import { i as schemesFromInfoPlist, n as devClientTakesDevMenuParams, r as pickDevClientScheme, t as devClientScheme } from "./dev-client-CjzLoNs0.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-DmeYjXD9.mjs";
+import { a as offloadBuild, c as placementLoad, d as OffloadRefusal, f as namedBuildMachine, i as closeOffload, l as remotePhaseText, m as resolveBuildPlacement, n as buildPlacementCandidates, p as parseBuildMachineOption, r as chooseBuildMachine, s as offloadPlacement, u as simulatorRuntime } from "./client-C2IS36Qf.mjs";
+import { t as spawnEntry } from "./spawn-entry-DncpJvWL.mjs";
+import { a as runPodInstall, n as podsAreStale, r as readPodState } from "./deps-BFlKbOIp.mjs";
+import { i as staleNativeDirRefusal, n as recordPrebuild, r as runPrebuild, t as planPrebuild } from "./prebuild-BvxDlD6C.mjs";
+import { n as clearIosAdoptionPending } from "./device-ios-DMQBUPus.mjs";
+import { _ as xcodeFailureReport, a as deviceShortName, c as isReleaseConfiguration, d as printDiagnostics, f as resolveConfiguration, g as simulatorBuildArch, h as resolveSimulatorAppFlag, i as deviceModelRefusal, l as ownedSimFailure, m as resolveRuntime, n as buildLogFile, o as iosConfigurationSetting, p as resolveDeviceType, r as deviceLabel, s as iosProviderRunOptions, t as appNameFromPath, u as podAction } from "./support-WLOzVKUv.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-CO2elm_b.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-9ulPsdhY.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-CLlofxRt.mjs";
+import { d as withNativeBuildRun, r as cancelledFailure, u as runCancellation } from "./native-run-DFDoIRbY.mjs";
+import { a as isEasBuildFailure, i as easDeviceBuildRemedy, o as planEasDevelopmentBuild, s as resolveEasDevelopmentBuild } from "./simslim-Ciluxlq4.mjs";
+import { c as startDevServer, h as detectBundleId } from "./start-CUD9nasA.mjs";
+import { a as lostLine, c as releaseLeaseOnSignal, i as leaseExpiryText, l as runLease, n as DEBUG_VERIFY_STEP_MS, o as lostRefusal, r as acquireRunLease, s as parseDeviceWait, t as selectFromPool, u as waitFlagConflict } from "./device-pool-B2r38YjS.mjs";
+import { a as refusePlan, 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 } from "./build-plan-aeGMFX7e.mjs";
+import { t as budgetGate } from "./budget-CMiqghig.mjs";
+import { a as sleep, i as launchOutcomeRecord, n as ensureWorkspaceStorageSafely, r as isPhysicalDeviceRequest, t as ensureDevServer } from "./native-runtime-i6OkVg-w.mjs";
+import { n as nativeRunCommand, r as siblingPlatformSlots, t as launchSlotScope } from "./slot-launch-BY0BrOLh.mjs";
+import { a as printNativeCrashReport, n as IOS_CRASH_REPORT_RETRY, o as simulatorConsolePaths, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-Cb0P1WLS.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-DERmMmk-.mjs";
+import { X509Certificate } from "node:crypto";
 import { existsSync, mkdirSync, mkdtempSync, openSync, rmSync, writeFileSync } from "node:fs";
-import { InvalidArgumentError } from "commander";
-import { buildDiagnostics } from "@stim-cli/core/state";
 import { basename, join } from "node:path";
-import { X509Certificate } from "node:crypto";
+import { hostSimulatorArch } from "@stim-cli/core";
+import { InvalidArgumentError } from "commander";
+import { buildDiagnostics, machineCapacity } from "@stim-cli/core/state";
 import { networkInterfaces, tmpdir } from "node:os";
 import chalk from "chalk";
 import { createWarnOnce, loadCacheProvider, resolveTieredBuild, storeTieredBuild } from "@stim-cli/cache";
@@ -111,133 +122,9 @@ function copyAppAside(appPath, { exec = null, mkdtemp = () => makeTemporaryDirec
 		appPath: copy
 	};
 }
-function buildLogFile(root) {
-	return join(workspaceLogsDir(root), `build-ios.ndjson`);
-}
-const MAX_PRINTED_DIAGNOSTICS = 6;
-function deviceLabel(device, udid) {
-	const name = device?.deviceName || device?.name || null;
-	return name ? `${name} (${shortUdid(udid)})` : shortUdid(udid);
-}
-function deviceShortName(device, udid) {
-	return device?.deviceName || device?.name || shortUdid(udid);
-}
-function appNameFromPath(appPath) {
-	if (typeof appPath !== "string" || appPath.trim() === "") return null;
-	const name = basename(appPath).replace(/\.app$/i, "");
-	return name === "" ? null : name;
-}
-function iosConfigurationSetting(settings) {
-	const ios = settings?.["ios"];
-	if (!ios || typeof ios !== "object" || Array.isArray(ios)) return null;
-	const raw = ios["configuration"];
-	return typeof raw === "string" && raw.trim() !== "" ? raw.trim() : null;
-}
-function resolveConfiguration(flag, settings) {
-	return (typeof flag === "string" && flag.trim() !== "" ? flag.trim() : null) || iosConfigurationSetting(settings);
-}
-function iosStringSetting(settings, key) {
-	const ios = settings?.["ios"];
-	if (!ios || typeof ios !== "object" || Array.isArray(ios)) return null;
-	const raw = ios[key];
-	return typeof raw === "string" && raw.trim() !== "" ? raw.trim() : null;
-}
-function resolveDeviceType(flag, settings) {
-	return (typeof flag === "string" && flag.trim() !== "" ? flag.trim() : null) || iosStringSetting(settings, "deviceType");
-}
-function resolveRuntime(flag, settings) {
-	return (typeof flag === "string" && flag.trim() !== "" ? flag.trim() : null) || iosStringSetting(settings, "runtime");
-}
-function resolveSimulatorAppFlag(flag, physical, remoteBackend) {
-	if (flag === void 0) return {};
-	let simulatorApp;
-	try {
-		simulatorApp = parseIosSimulatorApp(flag, "--simulator-app");
-	} catch (error) {
-		return { refusal: {
-			code: "STIM_BAD_ARG",
-			message: error.message
-		} };
-	}
-	if (physical || remoteBackend) return { refusal: {
-		code: "STIM_BAD_ARG",
-		message: "--simulator-app only applies to a local owned iOS simulator.",
-		remedy: "Drop --simulator-app when using a physical or remote device."
-	} };
-	return { simulatorApp };
-}
-function deviceModelRefusal({ slot, deviceTypeFlag, runtimeFlag, deviceType, runtime, physical, remoteBackend, listRuntimes }) {
-	if (slot && slot !== "default" && remoteBackend) return {
-		code: "STIM_BAD_ARG",
-		message: "Named slots currently support local simulators and physical devices.",
-		remedy: "Use the default slot for a remote session."
-	};
-	if (typeof deviceTypeFlag === "string" && deviceTypeFlag.trim() === "") return {
-		code: "STIM_BAD_ARG",
-		message: "--device-type was given an empty name.",
-		remedy: "Pass `--device-type <name>` with a model `xcrun simctl list devicetypes` names, e.g. \"iPad Pro 13-inch (M5)\"."
-	};
-	if (typeof runtimeFlag === "string" && runtimeFlag.trim() === "") return {
-		code: "STIM_BAD_ARG",
-		message: "--runtime was given an empty version.",
-		remedy: "Pass `--runtime <version>` with a runtime `xcrun simctl list runtimes` reports, e.g. \"18.5\"."
-	};
-	if (physical || remoteBackend) return null;
-	if (!deviceType && !runtime) return null;
-	let runtimes;
-	try {
-		runtimes = listRuntimes();
-	} catch (error) {
-		return {
-			code: "STIM_NO_DEVICE",
-			message: `Could not read the installed simulator runtimes: ${error?.message || error}`,
-			remedy: "Run `stim doctor` to check the simulator toolchain, then try again."
-		};
-	}
-	const refusal = unknownIosRuntimeRefusal(runtime, runtimes) ?? unknownIosDeviceTypeRefusal(deviceType, runtimes, runtime);
-	return refusal ? {
-		code: "STIM_BAD_ARG",
-		message: refusal.message,
-		remedy: refusal.remedy
-	} : null;
-}
-function isReleaseConfiguration(configuration) {
-	return typeof configuration === "string" && configuration.trim() !== "" && configuration.trim().toLowerCase() !== "debug";
-}
-function podAction(podState, verdict) {
-	if (verdict?.stale) return {
-		install: true,
-		reason: verdict.reason
-	};
-	if (verdict?.noPods && podState?.hasPodfile) return {
-		install: true,
-		reason: "ios/Podfile exists but no pods are installed"
-	};
-	return { install: false };
-}
-function xcodeFailureReport(result, logPath) {
-	const diagnostics = result.diagnostics;
-	const code = result.exitCode;
-	const how = code === null ? "" : ` (exit code ${code})`;
-	return {
-		message: diagnostics.length ? `\`xcodebuild\` failed${how} with ${diagnostics.length} diagnostic${diagnostics.length === 1 ? "" : "s"}.` : `\`xcodebuild\` failed${how} with no recognizable diagnostic.`,
-		remedy: diagnostics.find((d) => d?.remedy)?.remedy || `See ${logPath} for the transcript.`
-	};
-}
-function printDiagnostics(note, result) {
-	const diagnostics = result.diagnostics;
-	const shown = diagnostics.slice(0, MAX_PRINTED_DIAGNOSTICS);
-	for (const diagnostic of shown) note(chalk.red(phaseLine("error", describeDiagnostic(diagnostic))));
-	const hidden = diagnostics.length - shown.length + result.truncated;
-	if (hidden > 0) note(chalk.dim(phaseLine("error", `... and ${hidden} more diagnostic${hidden === 1 ? "" : "s"} in the log`)));
-	if (diagnostics.length === 0) {
-		note(chalk.red(phaseLine("error", "xcodebuild failed with no recognizable diagnostic; last lines:")));
-		for (const line of result.tail.slice(-5)) note(chalk.dim(phaseLine("", line)));
-	}
-}
 //#endregion
 //#region src/commands/ios/result.ts
-function lastBuildRecord({ fingerprint = null, cacheKey = null, cacheHit = false, cacheSkipped = false, durationMs = 0, appPath = null, bundleId = null, startedAt, status, errorCode = null, missReason = null, diagnostics = null, configuration = null }) {
+function lastBuildRecord({ 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,
@@ -252,12 +139,16 @@ function lastBuildRecord({ fingerprint = null, cacheKey = null, cacheHit = false
 		configuration
 	};
 	if (errorCode) record.errorCode = errorCode;
+	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({ 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 }) {
+function iosFacts({ 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 } : {},
@@ -271,6 +162,10 @@ function iosFacts({ slot, udid, deviceName, deviceType = null, runtime = null, f
 		cacheKey,
 		cacheHit: cacheLevel(cacheHit),
 		cacheSkipped: Boolean(cacheSkipped),
+		buildMachine,
+		...builtOn ? { builtOn } : {},
+		...offloadedTo ? { offloadedTo } : {},
+		...offloadFallback ? { offloadFallback } : {},
 		compilationCache,
 		waitedForBuild: waitedForBuild ? {
 			pid: waitedForBuild.pid ?? null,
@@ -311,13 +206,14 @@ async function finishIosUpload(uploadPending, remote, phase, note) {
 	}
 	return false;
 }
-function reportIosResult({ 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, closeWriter, webPreviewUrl, lease, recordRun, reclaimed = [], devServer = null }) {
+function reportIosResult({ 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
+		durationMs,
+		offloadedTo
 	});
 	writeLastBuild(root, lastBuildRecord({
 		fingerprint: storeHash,
@@ -330,7 +226,11 @@ function reportIosResult({ slot, root, json, release, configuration, buildScheme
 		bundleId,
 		startedAt,
 		status: "ok",
-		configuration: configuration ?? "Debug"
+		configuration: configuration ?? "Debug",
+		buildMachine,
+		builtOn,
+		offloadedTo,
+		offloadFallback
 	}));
 	closeWriter();
 	const facts = iosFacts({
@@ -356,17 +256,22 @@ function reportIosResult({ slot, root, json, release, configuration, buildScheme
 		launched: launchState,
 		webPreviewUrl,
 		lease,
-		devServer
+		devServer,
+		buildMachine,
+		builtOn,
+		offloadedTo,
+		offloadFallback
 	});
-	if (json) console.log(JSON.stringify(reclaimed.length ? {
+	if (json) console.log(JSON.stringify({
 		...facts,
-		reclaimed
-	} : facts));
+		...links ? { links } : {},
+		...reclaimed.length ? { reclaimed } : {}
+	}));
 	else {
-		const summary = `${launchWarning ? "WARNING" : "OK"}: ${bundleId} on ${deviceLabel(device, udid)}, ` + (release ? `${configuration} (embedded JS, no Metro)` : `Metro port ${metroPort}`) + ` (${cacheDescription(cacheHit, providerName)}, ${formatDuration(durationMs)})`;
+		const summary = `${launchWarning ? "WARNING" : "OK"}: ${bundleId} on ${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) : "bypassed; built";
+		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,
@@ -378,13 +283,14 @@ function reportIosResult({ slot, root, json, release, configuration, buildScheme
 			phaseLine("logs", logsDir)
 		].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) {
+function cacheDescription(cacheHit, providerName = null, offloadedTo = null) {
 	if (cacheHit === "remote") return `from ${providerName || "the remote cache"}`;
 	if (cacheHit === "local") return "from cache";
-	return "built";
+	return offloadedTo ? `built on ${offloadedTo}` : "built";
 }
 //#endregion
 //#region src/commands/ios/artifact.ts
@@ -398,15 +304,17 @@ var ArtifactRefusal = class extends Error {
 		this.failure = failure;
 	}
 };
-async function acquireIosArtifact({ root, logFile, udid, remoteDestination, device, configuration, buildScheme, buildProfile, isExpo, optimizations, cache, easBuild, easProfile, maxBuilds, progress }, d) {
-	const { phase, note, logWriter, estimates, stats, step } = progress;
+async function acquireIosArtifact({ root, logFile, udid, remoteDestination, 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 } = 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);
@@ -460,6 +368,21 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 	let appPath = null;
 	let bundleId = null;
 	let cacheHit = false;
+	let offloadedTo = null;
+	let offloadFallback = null;
+	let fallbackMachine = null;
+	let hereReason = null;
+	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;
@@ -583,7 +506,7 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 				platform: "ios",
 				projectRoot: root,
 				fingerprintHash: fingerprint,
-				runOptions: configuration ? { configuration } : null
+				runOptions: providerRunOptions
 			});
 			if (hit?.appPath) {
 				let stored = null;
@@ -624,6 +547,7 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 				step("wait");
 				phase("build", text);
 			},
+			waitingOn,
 			warn: (text) => note(chalk.yellow(phaseLine("build", text))),
 			out: note
 		});
@@ -736,32 +660,48 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 			}
 		}
 	}
-	function explainMiss(rekeyedBy) {
-		if (swapFellBack) missReason = skippedMissReason("the cached app could not be reused, so this run built it fresh");
-		else if (!useBuildCache) missReason = skippedMissReason(cache.disabledByFlag ? "cache reuse turned off by --no-build-cache" : "cache reuse off in config");
-		else {
-			const current = {
-				hash: storeHash ?? fingerprint,
-				sources: storeSources
-			};
-			const explained = explainBuildMiss({
-				root,
-				platform: "ios",
-				current,
-				rekeyedBy,
-				baselineDeps: { readState: d.readWorkspaceState }
-			});
-			missReason = explained.reason;
-			if (explained.previousHash && explained.changedNames.length) logWriter().write(fingerprintDiffRecord({
+	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 }));
@@ -805,31 +745,194 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 			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
+			});
+		} 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 || remoteDestination || release ? null : simulatorRuntime(udid);
+		const unsupported = physical ? "device builds build here" : remoteDestination ? "--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(),
+				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;
+		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
+			cacheSkipped: !useBuildCache,
+			buildMachine
 		};
 		if (!appPath) {
-			if (maxBuilds) try {
-				buildSlot = await d.acquireBuildSlot({
-					max: maxBuilds,
-					root,
-					logFile,
-					out: note
-				});
-			} 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`)));
-			}
+			const offload = placeBuild();
+			if (!offload) await takeBuildSlot();
 			const mutatingSteps = [];
 			const rekeyedBy = [];
 			const prebuild = d.planPrebuild(root, "ios", {
@@ -841,6 +944,7 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 				...staleNativeDirRefusal("ios"),
 				build: buildFailure
 			});
+			reportPendingRecheck(prebuild);
 			if (prebuild === "generate" || prebuild === "regenerate") {
 				step("prebuild");
 				recordPrebuild(root, "ios", null);
@@ -871,7 +975,8 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 				});
 			}
 			const podState = d.readPodState(root);
-			const action = podAction(podState, d.podsAreStale(podState.lockText, podState.manifestText));
+			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 });
@@ -927,6 +1032,7 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 						if (prepared) {
 							appPath = prepared;
 							cacheHit = "local";
+							lateHit();
 							phase("cache", `hit ${shortHash(storeHash)} (post-${mutatingSteps.join("/")} key)`);
 							if (releasedWait) {
 								waitedForBuild = releasedWait.facts;
@@ -936,15 +1042,40 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 					}
 				}
 			}
-			if (!appPath) {
+			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",
+					reason: offloadFallback ?? "offload failed",
+					...fallbackMachine ? { machine: fallbackMachine } : {}
+				});
+				else if (hereReason) stats.setPlacement({
+					decision: "here",
+					reason: hereReason
+				});
+				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 } : {},
@@ -1007,7 +1138,7 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 					projectRoot: root,
 					fingerprintHash: storeHash,
 					buildPath: appPath,
-					runOptions: configuration ? { configuration } : null
+					runOptions: providerRunOptions
 				});
 			}
 		}
@@ -1017,8 +1148,11 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 		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 = {
@@ -1031,6 +1165,10 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 				} : null,
 				hit: cacheHit,
 				providerName: remote?.name ?? providerName,
+				buildMachine,
+				...builtOn ? { builtOn } : {},
+				offloadedTo,
+				offloadFallback: offloadedTo ? null : offloadFallback,
 				readEnabled: useBuildCache,
 				missReason: cacheHit ? null : missReason,
 				waitedForBuild,
@@ -1038,6 +1176,8 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 			},
 			failureFields: {
 				...buildFailure,
+				buildMachine,
+				...builtOn ? { builtOn } : {},
 				fingerprint: storeHash,
 				cacheKey: storeKey,
 				cacheHit,
@@ -1060,6 +1200,23 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 			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,
@@ -1067,6 +1224,7 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 		};
 		throw error;
 	} finally {
+		if (openOffload.choice) closeOffload(openOffload.choice);
 		releaseLock();
 		releaseSlot();
 		if (!transferred) releaseArtifact();
@@ -1665,15 +1823,19 @@ async function replaceCollector({ root, slot = "default", udid, bundleId, appNam
 //#region src/commands/ios/dependencies.ts
 const DEFAULT_DEPS = {
 	resolveEasDevelopmentBuild,
-	findProjectRoot,
+	findProjectRoot: findProjectRoot$1,
 	resolveSettings,
+	settingsLayers,
+	settingOriginScope,
 	gitCommonDir,
 	repoRoot,
 	detectBundleId,
 	detectIsExpo,
 	devClientScheme,
+	devClientTakesDevMenuParams,
 	getProject,
 	upsertProject,
+	recordIosSchemeApprovals,
 	checkDeviceCapacity,
 	budgetGate,
 	ensureOwnedDevice,
@@ -1681,6 +1843,8 @@ const DEFAULT_DEPS = {
 	ensureBooted,
 	resolveRemoteContext,
 	remoteIosDeps,
+	readRemoteSimulatorArch,
+	hostSimulatorArch,
 	ensureMetroReachable,
 	ensureRemoteBootOwned,
 	detectProviders,
@@ -1732,6 +1896,7 @@ const DEFAULT_DEPS = {
 	swapJsBundle,
 	installIosApp,
 	clearOtherUserApps,
+	clearIosAppData,
 	clearIosAdoptionPending,
 	launchIosApp,
 	verifyLaunch,
@@ -1793,9 +1958,12 @@ async function verifyIosRun({ root, slot, appPath, d, release, launched, configu
 		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,
@@ -1860,14 +2028,50 @@ async function verifyIosRun({ root, slot, appPath, d, release, launched, configu
 		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,
+		waitedMs: verification.waitedMs,
 		bundleId,
 		udid,
-		devClientUrl: scheme ? devClientUrl(scheme, metroPort ?? 8081, lanAddress ?? void 0) : null,
+		devClientUrl: scheme ? launched?.url ?? devClientUrl(scheme, metroPort ?? 8081, lanAddress ?? void 0) : null,
 		mode: isExpo ? MODE_EXPO : MODE_BARE,
 		remote: remoteDevice,
 		physical,
@@ -1894,20 +2098,30 @@ function installsOverWifi(d, udid, selectedWireless, note) {
 	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, root, slot, udid, bundleId, phase, note }) {
+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) {
-		d.clearIosAdoptionPending(root, slot);
+		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);
@@ -1940,7 +2154,7 @@ function launchFailureRemedy(remoteDevice, udid, bundleId, logFile) {
 }
 async function finishIosRun({ 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, readEnabled: useBuildCache, missReason, waitedForBuild, compilation: compilationCache } = cache;
+	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, {
@@ -1978,7 +2192,7 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 		}
 	});
 	if (bundleId) d.upsertProject(root, { bundleId });
-	enterPhase("install");
+	enterPhase("device");
 	const booted = await bootPromise;
 	if (!booted?.ok) return fail({
 		code: booted?.code || "STIM_NO_DEVICE",
@@ -1988,11 +2202,12 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 	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 = null;
+	let launched;
 	let launchedAt = d.now();
 	if (physical) {
 		const overWifi = installsOverWifi(d, udid, wireless, note);
@@ -2003,6 +2218,7 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 			root,
 			note
 		});
+		enterPhase("install");
 		const installTimer = stepTimer(d.now);
 		const installed = d.installIosDeviceApp({
 			udid,
@@ -2105,9 +2321,9 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 		if (adopting) {
 			const cleanupFailure = cleanAdoptedIosApps({
 				d,
-				root,
 				udid,
 				bundleId,
+				devClient: Boolean(scheme),
 				phase,
 				note
 			});
@@ -2122,13 +2338,15 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 				}
 			});
 		}
+		enterPhase("install");
 		const installTimer = stepTimer(d.now);
 		const installed = d.installIosApp({
 			udid,
 			appPath,
 			bundleId,
 			devClientScheme: scheme,
-			proveInstalled: !adopting || device?.parkedCacheKey === storeKey
+			schemeApprovals: device.schemeApprovals,
+			proveInstalled: installMayBeProven(adopting, device?.parkedCacheKey, storeKey)
 		}, { now: d.now });
 		if (installed?.failed) return fail({
 			code: installed.code || "STIM_INSTALL_FAILED",
@@ -2140,10 +2358,12 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 				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,
@@ -2175,13 +2395,14 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 			bundleId,
 			metroPort,
 			devClientScheme: scheme,
+			devMenuParams,
 			consolePaths: simulatorConsolePaths({
 				deviceId: udid,
 				appId: bundleId,
 				since: launchedAt
 			}, true, Boolean(remoteDevice))
 		});
-		if (launched?.failed) {
+		if (launched.failed) {
 			printNativeCrashReport({
 				root,
 				slot,
@@ -2202,7 +2423,7 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 				}
 			});
 		}
-		phase("launch", `${bundleId} ${launchTimer()}`);
+		phase("launch", `${bundleId}${restartedAppNote(launched.restartedPid)} ${launchTimer()}`);
 	}
 	recordIosReloadTarget({
 		d,
@@ -2221,7 +2442,7 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 		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)" : "")
+		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",
@@ -2230,7 +2451,7 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 		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 } = await verifyIosRun({
+	const { state: launchState, warning: launchWarning, unattributed } = await verifyIosRun({
 		root,
 		slot,
 		appPath,
@@ -2271,7 +2492,8 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 		release,
 		bundleId,
 		configuration,
-		metroPort
+		metroPort,
+		unattributed
 	}));
 	const leaseFacts = lease?.facts() ?? null;
 	releaseLease();
@@ -2304,12 +2526,20 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 			launchState,
 			launchWarning,
 			providerName,
+			buildMachine,
+			builtOn,
+			offloadedTo,
+			offloadFallback,
 			closeWriter,
 			webPreviewUrl: remoteDevice?.webPreviewUrl() ?? null,
 			lease: physical ? leaseFacts : void 0,
 			recordRun,
 			reclaimed,
-			devServer
+			devServer,
+			links: workspaceLinks(root, {
+				platform: "ios",
+				slot
+			})
 		}),
 		uploadsAbandoned
 	};
@@ -2368,19 +2598,22 @@ async function planIos(opts, d, schemeRefusal) {
 		platform: "ios",
 		slot,
 		root,
-		projectKey: statsProjectKey({
+		projectKey: statsProjectKey$1({
 			root,
 			commonDir: settingsContext.gitCommonDir,
 			repoRoot: settingsContext.repoRoot
 		})
 	};
 	const isExpo = d.detectIsExpo(root);
+	const settingsLayersForOrigin = d.settingsLayers(settingsContext);
 	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: remoteIosSetting(settings),
 		listRuntimes: d.listIosRuntimes
@@ -2407,6 +2640,12 @@ async function planIos(opts, d, schemeRefusal) {
 			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} 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,
@@ -2427,10 +2666,17 @@ async function planIos(opts, d, schemeRefusal) {
 		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({
@@ -2441,7 +2687,7 @@ async function planIos(opts, d, schemeRefusal) {
 		cacheKey,
 		cachePolicy,
 		providerConfig: d.resolveCacheProviderConfig(settingsContext),
-		expoRemote: cachePolicy.remote && !buildProfile && !opts.scheme ? { runOptions: configuration ? { configuration } : null } : null
+		expoRemote: cachePolicy.remote && !buildProfile && !opts.scheme ? { runOptions: iosProviderRunOptions(configuration, arch) } : null
 	}, {
 		loadCacheProvider: d.loadCacheProvider,
 		loadProjectProvider: d.loadProjectProvider,
@@ -2464,7 +2710,7 @@ 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("--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 <backend>", "Install and launch on a remote device with proxy or EAS. Builds are local unless --eas-profile selects an existing EAS build.", (value) => {
+	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("--build-machine <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 <backend>", "Install and launch on a remote device with proxy or EAS. Builds are local unless --eas-profile selects an existing EAS build.", (value) => {
 		if (REMOTE_DEVICE_BACKENDS.includes(value)) return value;
 		throw new InvalidArgumentError(`expected one of: ${REMOTE_DEVICE_BACKENDS.join(", ")}`);
 	}).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). Only with --device.").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. Only with --device.").action(async (opts) => {
@@ -2527,6 +2773,32 @@ function explicitSchemeRefusal(root, scheme, isExpo, d) {
 	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(root), `build-${deviceSlotFileKey("ios", slot)}.ndjson`);
 }
@@ -2622,7 +2894,13 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 	const logsDir = workspaceLogsDir(root);
 	const logFile = iosSlotLogFile(root, slot);
 	let writer = null;
-	const logWriter = () => writer ||= d.createWriter(logFile, { truncate: true });
+	const logWriter = () => writer ||= tapBuildLog(d.createWriter(logFile, {
+		truncate: true,
+		fields: {
+			platform: "ios",
+			slot
+		}
+	}), progress);
 	let leaseHandle = null;
 	let stopLeaseSignals = null;
 	const releaseLease = () => {
@@ -2642,13 +2920,15 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 		write: (statsRun, at) => d.recordStats(statsRun, at),
 		now: () => d.now(),
 		note: (line) => note(chalk.dim(line)),
-		phases: () => progress.durations()
+		phases: () => progress.durations(),
+		deviceSetup: () => progress.deviceSetupKnown()
 	});
 	const recordRun = stats.record;
 	let compilationCache = COMPILATION_CACHE_NOT_RUN;
 	let reclaimed = [];
+	let buildMachine = "auto";
 	let builtConfiguration = null;
-	const fail = ({ code, message, remedy = null, lines = [], logPath = null, build = null, lease }) => {
+	const fail = ({ code, message, remedy = null, lines = [], logPath = null, build = null, lease, setup = false }) => {
 		({code, message, remedy, lines} = cancelledFailure("ios", {
 			code,
 			message
@@ -2664,6 +2944,7 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 		if (remedy) note(chalk.dim(phaseLine("remedy", remedy)));
 		if (logPath) note(chalk.dim(phaseLine("log", logPath)));
 		if (build) writeLastBuild(root, lastBuildRecord({
+			buildMachine,
 			...build,
 			configuration: builtConfiguration,
 			startedAt,
@@ -2672,7 +2953,7 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 			durationMs: elapsed()
 		}));
 		note(chalk.red(phaseLine("failed", code)));
-		recordRun({
+		if (!setup) recordRun({
 			failed: true,
 			durationMs: elapsed()
 		});
@@ -2694,12 +2975,13 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 		gitCommonDir: d.gitCommonDir(root),
 		repoRoot: settingsRepoRoot
 	};
-	const projectKey = statsProjectKey({
+	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,
@@ -2713,16 +2995,10 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 		lines: moreShapeErrors,
 		remedy: SETTING_SHAPE_REMEDY
 	});
-	let optimizations;
-	try {
-		optimizations = resolveOptimizations(settings);
-	} catch (error) {
-		return fail({
-			code: "STIM_BAD_ARG",
-			message: error.message,
-			remedy: SETTING_SHAPE_REMEDY
-		});
-	}
+	const setup = resolveIosBuildSetup(opts.buildMachine, 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.`)));
@@ -2789,12 +3065,15 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 	const viewer = resolveSimulatorAppFlag(opts.simulatorApp, physical, remoteBackend);
 	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,
 		listRuntimes: d.listIosRuntimes
@@ -2807,11 +3086,13 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 	reclaimed = budget.reclaimed;
 	if (budget.refusal) return fail(budget.refusal);
 	let remoteDevice = null;
+	let remoteArch = null;
 	if (remoteBackend) {
 		const resolved = await d.resolveRemoteContext({
 			root,
 			backend: remoteBackend,
-			easBin: d.resolveEasCliBin(root)?.file ?? null
+			easBin: d.resolveEasCliBin(root)?.file ?? null,
+			deviceType: opts.deviceType?.trim() || null
 		});
 		if ("failed" in resolved) return fail({
 			code: resolved.code ?? "STIM_NO_REMOTE_SESSION",
@@ -2819,6 +3100,7 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 			remedy: resolved.remedy
 		});
 		remoteDevice = d.remoteIosDeps(resolved.ctx);
+		remoteArch = await d.readRemoteSimulatorArch(resolved.ctx.existingDaemon);
 		d = {
 			...d,
 			checkDeviceCapacity: remoteDevice.checkDeviceCapacity,
@@ -2932,12 +3214,9 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 				out: note
 			});
 		} catch (e) {
-			return fail({
-				code: "STIM_NO_DEVICE",
-				message: `Could not ensure an owned iOS simulator: ${e?.message || e}`,
-				remedy: "Run `stim doctor` to check the simulator toolchain, then try again."
-			});
+			return fail(ownedSimFailure(e));
 		}
+		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)})`);
 	}
@@ -2971,9 +3250,18 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 			}
 			metroPort = gate.port;
 			devServer = gate.devServer;
-		} else if (!metroPort) {
-			metroPort = DEFAULT_METRO_PORT;
-			note(chalk.yellow(`No Metro port is reserved for this workspace; wiring the app to ${metroPort}.`));
+		} 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;
 		}
 		if (physical && metroPort !== null && !await resolveLanOrigin()) return false;
 		if (remoteDevice && metroPort !== null) {
@@ -2983,7 +3271,7 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 				isExpo,
 				tunnelMode: tunnelModeSetting(settings) ?? void 0,
 				publicUrl: publicUrlSetting(settings),
-				available: d.detectProviders(binOnPath)
+				available: d.detectProviders(binOnPath, tunnelModeSetting(settings) ?? "auto")
 			});
 			if ("failed" in reachable) {
 				fail({
@@ -3062,6 +3350,7 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 				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,
@@ -3084,8 +3373,15 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 			configuration,
 			buildScheme,
 			buildProfile,
+			buildMachine,
 			isExpo,
 			remoteDestination: Boolean(remoteDevice),
+			simulatorArch: simulatorBuildArch({
+				physical,
+				remoteArch,
+				hostArch: d.hostSimulatorArch(),
+				configuration
+			}),
 			device: physical ? {
 				lanAddress,
 				metroPort,
@@ -3107,7 +3403,11 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 				logWriter,
 				estimates,
 				stats,
-				step: progress.step
+				step: progress.step,
+				miss: progress.miss,
+				hit: progress.hit,
+				place: progress.place,
+				waitingOn: progress.waitingOn
 			}
 		}, d));
 		if (!acquiredArtifact.ok) {
@@ -3117,10 +3417,11 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 		artifact = acquiredArtifact.artifact;
 		compilationCache = artifact.cache.compilation;
 		if (!localBoot) {
-			progress.step("install");
+			progress.step("device");
 			udid = await startBoot();
 		}
 		if (physicalDevice) {
+			progress.step("device");
 			const acquired = await d.acquireRunLease({
 				root,
 				platform: "ios",