stim 1.20.2 → 1.21.0

package/dist/{ios-Ce7bc7br.mjs → ios-ubFsBzwq.mjs}

@@ -1,42 +1,41 @@
-import { K as validateDeviceSlot, U as parseDeviceSlotOption, z as deviceSlotFileKey } from "./config-BYDxlMY3.mjs";
-import { C as iosSigningIdentitySha1Setting, I as projectSettingsContext, L as publicUrlSetting, N as metroWarmupUrlSetting, S as iosSigningIdentitySettingError, _ as iosLanHostSetting, a as SETTING_SHAPE_REMEDY, g as deviceReclaimIdleMinutesSetting, j as metroPortSetting, tt as tunnelModeSetting, v as iosLanHostSettingError, w as iosSigningIdentitySha1SettingError, x as iosSigningIdentitySetting } from "./settings-B717odTD.mjs";
-import { i as recordWorkspaceUse, w as workspaceLogsDir$1 } from "./workspace-state-DJt_MMvf.mjs";
-import { _ as stepTimer, g as stepClock, i as formatDuration, l as phaseLine } from "./command-output-BTy8hZ0F.mjs";
-import { I as workspaceDevServerMode, t as NO_PROJECT_REFUSAL } from "./project-_phNIJfs.mjs";
-import { at as POOL_SETTING_REMEDY, dt as parkedMaxSetting } from "./android-Mz_Inn3w.mjs";
-import { At as createRunRecorder, It as statsProjectKey$1, Ot as startBuildProgress, kt as tapBuildLog, yt as NO_BUILD_PROGRESS } from "./budget-f7516Zk0.mjs";
-import { S as withNativeBuildRun, b as runCancellation, p as cancelledFailure, x as runCancellationSignal } from "./tailnet-Dh-qiYzG.mjs";
-import { d as optimizationBuildProfile, l as artifactCachePolicy } from "./errors-DzkMYh8Q.mjs";
-import { o as exitAfterFlush } from "./remote-cache-OyOyVIS3.mjs";
-import { d as simulatorRuntime, f as setRemoteLogSink, g as parseBuildMachineOption } from "./client-qQAaXSUs.mjs";
-import { i as createIosSimSnapshot } from "./ios-RkW4pnQf.mjs";
-import { r as DEFAULT_METRO_PORT } from "./app-install-BIKtMfPq.mjs";
-import { r as isPhysicalDeviceRequest, t as ensureDevServer } from "./native-runtime-k8dTIrbK.mjs";
-import { _ as COMPILATION_CACHE_NOT_RUN } from "./toolchain-DxSsNssu.mjs";
-import "./dev-client-DAWVIGBu.mjs";
-import { f as waitFlagConflict, o as leaseExpiryText } from "./device-lease-run-Cw2M4z51.mjs";
-import { r as hostedMetroSettings } from "./metro-gateway-CX9Xlkq2.mjs";
-import { i as writeDevicePlacement } from "./ios-state-CBLe1xYw.mjs";
-import { a as refusePlan, i as printPlan, n as planFlagRefusal } from "./build-plan-B7SZsc2N.mjs";
-import { r as siblingPlatformSlots, t as launchSlotScope } from "./slot-launch-DPt0m9Nd.mjs";
-import { S as ownedSessionName, n as binOnPath } from "./device-remote-xRT0Vmo9.mjs";
-import { r as isEasBuildFailure } from "./eas-build-JyfqyHfC.mjs";
-import { t as didSetUpDevice } from "./device-BECOiufl.mjs";
+import { m as workspaceLogsDir$1 } from "./paths-DQtTgsBf.mjs";
+import { G as parseDeviceSlotOption, J as validateDeviceSlot, V as deviceSlotFileKey } from "./config-CYcBF478.mjs";
+import { _ as stepTimer, g as stepClock, i as formatDuration, l as phaseLine } from "./command-output-B1UrjZHL.mjs";
+import { i as recordWorkspaceUse } from "./workspace-state-Cjuigeeu.mjs";
+import { C as iosSigningIdentitySha1Setting, L as projectSettingsContextAsync, N as metroWarmupUrlSetting, R as publicUrlSetting, S as iosSigningIdentitySettingError, _ as iosLanHostSetting, a as SETTING_SHAPE_REMEDY, g as deviceReclaimIdleMinutesSetting, j as metroPortSetting, rt as tunnelModeSetting, v as iosLanHostSettingError, w as iosSigningIdentitySha1SettingError, x as iosSigningIdentitySetting } from "./settings-CsJDEXgK.mjs";
+import { L as workspaceDevServerMode, t as NO_PROJECT_REFUSAL } from "./project-BZNjmW_8.mjs";
+import { H as tapBuildLog, In as runProcessOperation, Lt as binOnPath, M as NO_BUILD_PROGRESS, Pn as exitAfterFlush, U as createRunRecorder, V as startBuildProgress, Y as statsProjectKey$1, cn as DEFAULT_METRO_PORT, rr as ownedSessionName } from "./budget-Bs6SxxzO.mjs";
+import { d as runCancellationSignal, f as withNativeBuildRun, r as cancelledFailure, u as runCancellation } from "./native-run-DY_RLx3C.mjs";
+import { ht as parkedMaxSetting, lt as POOL_SETTING_REMEDY } from "./android-DUYkNF4u.mjs";
+import { i as createIosSimSnapshot } from "./ios-CpByZy12.mjs";
+import { d as optimizationBuildProfile, l as artifactCachePolicy } from "./errors-ccaPc4ox.mjs";
+import { t as COMPILATION_CACHE_NOT_RUN } from "./xcode-Zlx3qjEs.mjs";
+import { d as simulatorRuntime, f as setRemoteLogSink } from "./client-UXD70ZbM.mjs";
+import { i as parseBuildMachineOption } from "./selection-CSl9i5qU.mjs";
+import { r as hostedMetroSettings } from "./metro-gateway-BMJNlj3E.mjs";
+import { i as writeDevicePlacement } from "./ios-state-DvFX-K_l.mjs";
+import { r as siblingPlatformSlots, t as launchSlotScope } from "./slot-launch-DF8VfT64.mjs";
+import { f as waitFlagConflict, o as leaseExpiryText } from "./device-lease-run-C8raGFoP.mjs";
+import { _ as resolveIosWait, a as deviceModelRefusal, b as resolveSimulatorAppFlag, c as iosProjectPathError, d as ownedSimFailure, g as resolveIosBuildSetup, h as resolveDeviceType, i as deviceLabel, m as resolveConfiguration, n as buildLogFile, r as createIosDeviceWaitRun, u as isReleaseConfiguration, v as resolveRuntime, x as simulatorBuildArch, y as resolveSchemeSelection } from "./support-Dlu37g6H.mjs";
+import { r as isEasBuildFailure } from "./eas-build-BomfRnFT.mjs";
+import { r as isPhysicalDeviceRequest, t as ensureDevServer } from "./native-runtime-Dg1Q7tfF.mjs";
+import "./dev-client-UOeESKm6.mjs";
+import { t as didSetUpDevice } from "./device-ExJq8Ei7.mjs";
 import { t as unsupportedPlan } from "./project-plan-BPwbLwQu.mjs";
-import { _ as resolveIosWait, a as deviceModelRefusal, b as resolveSimulatorAppFlag, c as iosProjectPathError, d as ownedSimFailure, g as resolveIosBuildSetup, h as resolveDeviceType, i as deviceLabel, m as resolveConfiguration, n as buildLogFile, r as createIosDeviceWaitRun, u as isReleaseConfiguration, v as resolveRuntime, x as simulatorBuildArch, y as resolveSchemeSelection } from "./support-CwjbFs9H.mjs";
-import { a as lastBuildRecord, o as reportIosResult, s as writeLastBuild } from "./ios-project-K9hY_Jab.mjs";
-import { t as acquireIosArtifact } from "./artifact-HSwkIWEQ.mjs";
-import { a as iosPlacementBudget, i as hostedIosSelectors, n as connectIosTarget, o as selectIosPlacement, r as hostedIosMetroNote, t as connectIosBackend } from "./remote-BiR6aYjy.mjs";
-import { a as iosPoolCandidates, c as isWirelessIosDevice, f as resolveIosPhysicalDevice, o as iosPoolNoCandidatesRefusal, r as iosDeviceBounds } from "./ios-device-D7pi2Sca.mjs";
-import { i as DEFAULT_DEPS, l as lanOriginUrlFor, s as chooseLanAddress, t as finishIosRun } from "./launch-C3qJ6Agb.mjs";
+import { a as refusePlan, i as printPlan, n as planFlagRefusal } from "./build-plan-CaFskB7_.mjs";
+import { a as lastBuildRecord, o as reportIosResult, s as writeLastBuild } from "./ios-project-WuwwBdvW.mjs";
+import { t as acquireIosArtifact } from "./artifact-B8T3S5gi.mjs";
+import { a as iosPlacementBudget, i as hostedIosSelectors, n as connectIosTarget, o as selectIosPlacement, r as hostedIosMetroNote, t as connectIosBackend } from "./remote-ByYkXdGD.mjs";
+import { a as iosPoolCandidates, c as isWirelessIosDevice, f as resolveIosPhysicalDevice, o as iosPoolNoCandidatesRefusal, r as iosDeviceBounds } from "./ios-device-CwFMehUS.mjs";
+import { i as DEFAULT_DEPS, l as lanOriginUrlFor, s as chooseLanAddress, t as finishIosRun } from "./launch-Zq2mOSDy.mjs";
 import { basename, join } from "node:path";
-import { hostedIosStatus, parseMachine } from "@stim-cli/core/state";
 import { workspaceId } from "@stim-cli/core";
-import { InvalidArgumentError } from "commander";
+import { hostedIosStatus, parseMachine } from "@stim-cli/core/state";
 import chalk from "chalk";
+import { InvalidArgumentError } from "commander";
 //#region src/commands/ios/hosted.ts
 async function finishHostedIosRun({ target, d, artifact, root, slot, release, appMode, isExpo, metroCheck, metroPort, logsDir, fail, note, enterPhase, selectors, projectBundleId, ...report }) {
-	const bundleId = artifact.bundleId ?? (d.readBundleId(artifact.path) || projectBundleId());
+	const bundleId = artifact.bundleId ?? (await d.readBundleId(artifact.path) || await projectBundleId());
 	if (!bundleId) return fail({
 		code: "STIM_INSTALL_FAILED",
 		message: "The built app has no bundle identifier."
@@ -84,7 +83,7 @@ async function finishHostedIosRun({ target, d, artifact, root, slot, release, ap
 			metroPort,
 			mode: workspaceDevServerMode(root, isExpo),
 			slot: launchSlotScope(root, slot),
-			platformShared: siblingPlatformSlots(root, "ios", slot).length > 0
+			platformShared: (await siblingPlatformSlots(root, "ios", slot)).length > 0
 		});
 		if (evidence.fatal) return fail({
 			code: "STIM_LAUNCH_FAILED",
@@ -156,7 +155,7 @@ async function planIos(opts, d) {
 		code: "STIM_NO_PROJECT",
 		...selected.problem
 	}, json);
-	const context = projectSettingsContext(root, d);
+	const context = await projectSettingsContextAsync(root, d);
 	const settings = d.resolveSettings(context);
 	const project = await selected.load(settings);
 	if (!project.plan) return refusePlan(unsupportedPlan("ios"), json);
@@ -169,17 +168,11 @@ async function planIos(opts, d) {
 }
 //#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. React Native and Expo Debug runs start 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. local runs here, whatever ios.remote says.", (value) => {
+	program.command("ios").description("Build (or restore from the fingerprint cache), install and launch this workspace's app on its owned simulator. React Native and Expo Debug runs start 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 machine is full or busy. local runs here, whatever ios.remote says.", (value) => {
 		if (parseMachine(value)) return value.trim();
 		throw new InvalidArgumentError("expected eas, proxy, auto, local, 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) => {
@@ -190,38 +183,39 @@ function registerIos(program, deps = {}) {
 			});
 			return;
 		}
-		const completion = await runIosOperation((deps.findProjectRoot ?? DEFAULT_DEPS.findProjectRoot)(process.cwd()), {
+		const root = (deps.findProjectRoot ?? DEFAULT_DEPS.findProjectRoot)(process.cwd());
+		const { value: completion, interrupted } = await runProcessOperation(root ?? process.cwd(), (context) => runIosOperation(context, root, {
 			...opts,
 			waitConflict: waitFlagConflict(process.argv)
-		}, deps);
-		if (!completion) process.exit(runCancellation() ? 130 : 1);
+		}, deps));
+		if (!completion) process.exit(interrupted ?? 1);
 		else if (completion.uploadsAbandoned) exitAfterFlush(0);
 	});
 }
-function runIosOperation(root, opts = {}, deps = {}, onFailure = () => {}) {
-	const run = (progress) => runIos(root, opts, deps, progress, onFailure);
-	return root ? withNativeBuildRun(root, {
+function runIosOperation(context, root, opts = {}, deps = {}, onFailure = () => {}) {
+	const run = (progress) => runIos(context, root, opts, deps, progress, onFailure);
+	return root ? withNativeBuildRun(context, root, {
 		command: "ios",
 		platform: "ios",
 		slot: opts.slot ?? "default"
 	}, async (claim) => {
-		recordWorkspaceUse(root);
+		recordWorkspaceUse(root, /* @__PURE__ */ new Date(), context.env, context.cwd);
 		const progress = startBuildProgress({
 			root,
 			platform: "ios",
 			slot: opts.slot ?? "default",
 			claim,
-			note: (line) => writeNote(chalk.dim(line))
+			note: (line) => context.output("stderr", `${chalk.dim(line)}\n`)
 		});
 		try {
 			return await run(progress);
 		} finally {
 			progress.clear();
 		}
-	}, { write: (line) => writeNote(chalk.dim(phaseLine("lock", line))) }) : run();
+	}, { write: (line) => context.output("stderr", `${chalk.dim(phaseLine("lock", line))}\n`) }) : run();
 }
-function unlessCancelled(result) {
-	if (!result.ok || !runCancellation()) return result;
+function unlessCancelled(context, result) {
+	if (!result.ok || !runCancellation(context)) return result;
 	return {
 		ok: false,
 		failure: {
@@ -312,7 +306,7 @@ function iosSlotDeps(d, slot) {
 	}
 	return d;
 }
-async function runIos(projectRoot, opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS, onFailure) {
+async function runIos(context, projectRoot, opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS, onFailure) {
 	const slot = validateDeviceSlot(opts.slot);
 	let d = iosSlotDeps({
 		...DEFAULT_DEPS,
@@ -320,8 +314,9 @@ async function runIos(projectRoot, opts = {}, overrides = {}, progress = NO_BUIL
 	}, slot);
 	const json = Boolean(opts.json);
 	const metroCheck = opts.metroCheck !== false;
-	const phase = writePhase;
-	const note = writeNote;
+	const note = (line) => context.output("stderr", `${line}\n`);
+	const phase = (name, text) => note(phaseLine(name, text));
+	const emit = (line) => context.output("stdout", `${line}\n`);
 	const started = d.now();
 	const startedAt = new Date(started).toISOString();
 	const elapsed = () => d.now() - started;
@@ -329,7 +324,7 @@ async function runIos(projectRoot, opts = {}, overrides = {}, progress = NO_BUIL
 		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({
+		if (json) emit(JSON.stringify({
 			code: "STIM_NO_PROJECT",
 			message,
 			remedy
@@ -352,7 +347,7 @@ async function runIos(projectRoot, opts = {}, overrides = {}, progress = NO_BUIL
 		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({
+		if (json) emit(JSON.stringify({
 			code,
 			message,
 			remedy: "Check that STIM_HOME is writable and has free space."
@@ -374,7 +369,7 @@ async function runIos(projectRoot, opts = {}, overrides = {}, progress = NO_BUIL
 			slot
 		}
 	}), progress);
-	setRemoteLogSink((record) => logWriter().write(record));
+	setRemoteLogSink(context, (record) => logWriter().write(record));
 	let leaseHandle = null;
 	let stopLeaseSignals = null;
 	const releaseLease = () => {
@@ -397,7 +392,7 @@ async function runIos(projectRoot, opts = {}, overrides = {}, progress = NO_BUIL
 		phases: () => progress.durations(),
 		deviceSetup: () => progress.deviceSetupKnown()
 	});
-	const deviceWaitRun = createIosDeviceWaitRun(stats, progress, runCancellationSignal());
+	const deviceWaitRun = createIosDeviceWaitRun(stats, progress, runCancellationSignal(context));
 	const recordRun = deviceWaitRun.record;
 	let compilationCache = COMPILATION_CACHE_NOT_RUN;
 	let reclaimed = [];
@@ -405,7 +400,7 @@ async function runIos(projectRoot, opts = {}, overrides = {}, progress = NO_BUIL
 	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, remedy, lines} = cancelledFailure(context, "ios", {
 			code,
 			message
 		}) ?? {
@@ -434,7 +429,7 @@ async function runIos(projectRoot, opts = {}, overrides = {}, progress = NO_BUIL
 			failed: true,
 			durationMs: elapsed()
 		});
-		if (json) console.log(JSON.stringify({
+		if (json) emit(JSON.stringify({
 			code,
 			message: message ?? null,
 			remedy: remedy ?? null,
@@ -456,7 +451,21 @@ async function runIos(projectRoot, opts = {}, overrides = {}, progress = NO_BUIL
 		});
 		return null;
 	};
-	const settingsContext = projectSettingsContext(root, d);
+	const settingsSignal = runCancellationSignal(context) ?? context.signal;
+	let settingsContext;
+	try {
+		settingsContext = await projectSettingsContextAsync(root, d, {
+			env: context.env,
+			signal: settingsSignal
+		});
+	} catch (error) {
+		if (!settingsSignal.aborted) throw error;
+		return fail({
+			code: "STIM_CANCELLED",
+			message: "before resolving project settings",
+			setup: true
+		});
+	}
 	const projectKey = statsProjectKey$1({
 		root,
 		commonDir: settingsContext.gitCommonDir,
@@ -470,7 +479,7 @@ async function runIos(projectRoot, opts = {}, overrides = {}, progress = NO_BUIL
 		platform: "ios"
 	});
 	const settings = d.resolveSettings(settingsContext);
-	const setup = resolveIosBuildSetup(opts.remoteBuild, settings, (label, message) => note(phaseLine(label, chalk.yellow(message))));
+	const setup = resolveIosBuildSetup(opts.remoteBuild, settings, (label, message) => note(phaseLine(label, chalk.yellow(message))), context.env);
 	if (!setup.ok) return fail(setup.failure);
 	buildMachine = setup.buildMachine;
 	const { optimizations } = setup;
@@ -532,7 +541,7 @@ async function runIos(projectRoot, opts = {}, overrides = {}, progress = NO_BUIL
 		}
 	};
 	const isExpo = integration.isExpo;
-	const schemeRefusal = integration.schemeProblem(buildScheme, configuration);
+	const schemeRefusal = await integration.schemeProblem(buildScheme, configuration);
 	if (schemeRefusal) return fail(schemeRefusal);
 	const capabilityRefusal = iosProjectTargetRefusal(integration, {
 		physical,
@@ -541,6 +550,8 @@ async function runIos(projectRoot, opts = {}, overrides = {}, progress = NO_BUIL
 	if (capabilityRefusal) return fail(capabilityRefusal);
 	const remoteSelection = await selectIosPlacement({
 		root,
+		env: context.env,
+		operation: context,
 		slot,
 		opts,
 		settings,
@@ -603,10 +614,10 @@ async function runIos(projectRoot, opts = {}, overrides = {}, progress = NO_BUIL
 	const hostedTarget = connected.target;
 	try {
 		const simSnapshot = createIosSimSnapshot();
-		const budget = await iosPlacementBudget(d, root, note, Boolean(hostedTarget), remoteSelection.budget, simSnapshot);
+		const budget = await iosPlacementBudget(d, root, note, Boolean(hostedTarget), remoteSelection.budget, simSnapshot, context.env);
 		reclaimed = budget.reclaimed;
 		if (budget.refusal) return fail(budget.refusal);
-		const backendConnection = await connectIosBackend(root, remoteBackend, opts.deviceType, d);
+		const backendConnection = await connectIosBackend(root, remoteBackend, opts.deviceType, d, context.env, context);
 		if ("failure" in backendConnection) return fail(backendConnection.failure);
 		const remoteDevice = backendConnection.remote;
 		const remoteArch = hostedTarget ? hostedTarget.choice.architecture : backendConnection.arch;
@@ -615,10 +626,11 @@ async function runIos(projectRoot, opts = {}, overrides = {}, progress = NO_BUIL
 			checkDeviceCapacity: remoteDevice.checkDeviceCapacity,
 			ensureOwnedDevice: remoteDevice.ensureOwnedDevice,
 			ensureBooted: remoteDevice.ensureBooted,
-			installIosApp: remoteDevice.installIosApp,
-			launchIosApp: remoteDevice.launchIosApp
+			installIosApp: async (args) => remoteDevice.installIosApp(args),
+			launchIosApp: async (args) => remoteDevice.launchIosApp(args)
 		};
 		const easBuild = await d.resolveEasDevelopmentBuild({
+			context,
 			root,
 			platform: "ios",
 			profile: opts.easProfile,
@@ -626,14 +638,26 @@ async function runIos(projectRoot, opts = {}, overrides = {}, progress = NO_BUIL
 			isExpo,
 			physical,
 			selectors: [opts.scheme, opts.configuration],
-			buildCache: opts.buildCache
+			buildCache: opts.buildCache,
+			env: context.env,
+			signal: settingsSignal
+		}).catch((error) => {
+			const cancelled = cancelledFailure(context, "ios", {
+				code: "STIM_CANCELLED",
+				message: "during EAS lookup"
+			});
+			if (cancelled) return {
+				ok: false,
+				...cancelled
+			};
+			throw error;
 		});
 		if (isEasBuildFailure(easBuild)) return fail(easBuild);
-		const registerProject = () => d.upsertProject(root, {
-			bundleId: integration.bundleId() ?? void 0,
+		const registerProject = async () => d.upsertProject(root, {
+			bundleId: await integration.bundleId() ?? void 0,
 			isExpo
 		});
-		if (remoteBackend !== "eas") registerProject();
+		if (remoteBackend !== "eas") await registerProject();
 		const proj = d.getProject(root);
 		const limits = d.getConcurrencyLimits();
 		let physicalDevice = null;
@@ -643,13 +667,13 @@ async function runIos(projectRoot, opts = {}, overrides = {}, progress = NO_BUIL
 				root,
 				platform: "ios",
 				idLabel: "udid",
-				list: () => iosPoolCandidates(d.listIosDevices()).map((entry) => ({
+				list: async () => iosPoolCandidates(await d.listIosDevices()).map((entry) => ({
 					id: entry.udid,
 					name: entry.name,
 					fallback: isWirelessIosDevice(entry)
 				})),
-				noCandidates: () => {
-					const resolved = iosPoolNoCandidatesRefusal(d.listIosDevices());
+				noCandidates: async () => {
+					const resolved = iosPoolNoCandidatesRefusal(await d.listIosDevices());
 					return {
 						message: resolved.error,
 						remedy: resolved.remedy
@@ -672,7 +696,7 @@ async function runIos(projectRoot, opts = {}, overrides = {}, progress = NO_BUIL
 			};
 			wireless = pooled.candidate.fallback === true;
 		} else if (physical) {
-			const resolved = resolveIosPhysicalDevice(typeof deviceFlag === "string" ? deviceFlag : null, d.listIosDevices());
+			const resolved = resolveIosPhysicalDevice(typeof deviceFlag === "string" ? deviceFlag : null, await d.listIosDevices());
 			if (!resolved.udid) return fail({
 				code: "STIM_NO_DEVICE",
 				message: resolved.error,
@@ -769,6 +793,7 @@ async function runIos(projectRoot, opts = {}, overrides = {}, progress = NO_BUIL
 		async function prepareMetro() {
 			if (metroCheck) {
 				const gate = await ensureDevServer({
+					env: context.env,
 					root,
 					port: metroPort,
 					settings: hostedMetroSettings(settings, Boolean(hostedTarget)),
@@ -792,7 +817,7 @@ async function runIos(projectRoot, opts = {}, overrides = {}, progress = NO_BUIL
 				metroPort = gate.port;
 				devServer = gate.devServer;
 			} else {
-				const pin = metroPortSetting(settings);
+				const pin = metroPortSetting(settings, context.env);
 				if (pin.error) return {
 					ok: false,
 					error: {
@@ -815,6 +840,7 @@ async function runIos(projectRoot, opts = {}, overrides = {}, progress = NO_BUIL
 			if (remoteDevice && metroPort !== null) {
 				const reachable = await d.ensureMetroReachable({
 					ctx: remoteDevice.ctx,
+					env: context.env,
 					metroPort,
 					isExpo,
 					tunnelMode: tunnelModeSetting(settings) ?? void 0,
@@ -877,6 +903,21 @@ async function runIos(projectRoot, opts = {}, overrides = {}, progress = NO_BUIL
 			return null;
 		}
 		let artifact = null;
+		const reportRunFailure = (error) => {
+			const cancelled = cancelledFailure(context, "ios", {
+				code: "STIM_CANCELLED",
+				message: "while finishing the run"
+			});
+			if (cancelled) return fail({
+				...cancelled,
+				build: artifact?.failureFields
+			});
+			recordRun({
+				failed: true,
+				durationMs: elapsed()
+			});
+			throw error;
+		};
 		try {
 			const boot = () => physicalDevice ? Promise.resolve({
 				ok: true,
@@ -899,6 +940,7 @@ async function runIos(projectRoot, opts = {}, overrides = {}, progress = NO_BUIL
 					root,
 					platform: "ios",
 					sessionName: ownedSessionName(remoteDevice.ctx.label),
+					operation: context,
 					startedAt: new Date(d.now()).toISOString(),
 					deviceType: remoteDevice.ctx.deviceType ?? null,
 					boot,
@@ -924,13 +966,15 @@ async function runIos(projectRoot, opts = {}, overrides = {}, progress = NO_BUIL
 				hostArch: d.hostSimulatorArch(),
 				configuration
 			});
-			const acquiredArtifact = unlessCancelled(await acquireIosArtifact({
+			const acquiredArtifact = unlessCancelled(context, await acquireIosArtifact({
+				context,
 				root,
 				logFile,
 				configuration,
 				buildMachine,
 				physical,
 				recipe: integration.artifact({
+					operation: context,
 					root,
 					logFile,
 					configuration,
@@ -983,6 +1027,7 @@ async function runIos(projectRoot, opts = {}, overrides = {}, progress = NO_BUIL
 			artifact = acquiredArtifact.artifact;
 			compilationCache = artifact.cache.compilation;
 			if (hostedTarget) return await finishHostedIosRun({
+				output: context.output,
 				target: hostedTarget,
 				projectBundleId: integration.bundleId,
 				root,
@@ -1043,12 +1088,14 @@ async function runIos(projectRoot, opts = {}, overrides = {}, progress = NO_BUIL
 					expiresAt: acquired.status === "leased" ? acquired.expiresAt : null
 				});
 				if (acquired.status === "leased") {
-					stopLeaseSignals = d.releaseLeaseOnSignal(releaseLease);
+					stopLeaseSignals = d.releaseLeaseOnAbort(context, releaseLease);
 					phase("lease", `${acquired.kind} lease on ${physicalDevice.udid} until ${leaseExpiryText(acquired.expiresAt, d.now())}`);
 				}
 			}
 			try {
 				return await finishIosRun({
+					operation: context,
+					output: context.output,
 					projectBundleId: integration.bundleId,
 					runtime: appRuntime,
 					runtimePreparation,
@@ -1095,13 +1142,9 @@ async function runIos(projectRoot, opts = {}, overrides = {}, progress = NO_BUIL
 				releaseLease();
 			}
 		} catch (error) {
-			recordRun({
-				failed: true,
-				durationMs: elapsed()
-			});
-			throw error;
+			return reportRunFailure(error);
 		} finally {
-			artifact?.release();
+			await artifact?.release();
 		}
 	} finally {
 		await deviceWaitRun.finish();