stim 1.9.0 → 1.10.0

package/dist/{ios-BzUJWk1K.mjs → ios-Dd-hYJBh.mjs}

@@ -1,32 +1,33 @@
-import { G as parseDeviceSlotOption, H as deviceSlotKey, J as validateDeviceSlot, V as deviceSlotFileKey, f as getProject, k as ownership_claim_exports, l as getConcurrencyLimits, w as upsertProject } from "./config-Cp9lM3wX.mjs";
-import { t as getExecutor } from "./exec-jIAlgilk.mjs";
-import { r as createNdjsonWriter } from "./ndjson-9uFNRwfe.mjs";
-import { _ as workspaceDir, b as workspaceLogsDir, c as writeWorkspaceState, i as recordWorkspaceUse, r as readWorkspaceState } from "./workspace-state-DF2gCFhx.mjs";
-import { E as removeTemporaryEntry, T as makeTemporaryDirectory, _ as repoRoot, s as gitCommonDir } from "./worktree-R_cUlE7s.mjs";
-import { a as detectIsExpo, i as detectBundleId, n as appProjectProblem, o as findProjectRoot, t as NO_PROJECT_REFUSAL } from "./project-DS112DYB.mjs";
-import { n as MODE_EXPO, p as writeWorkspaceLaunch, t as MODE_BARE } from "./state-NcJzMEBF.mjs";
-import { a as pidExists, c as resolveProjectMetro, l as signalProcessTree } from "./metro-DrLHaMn2.mjs";
-import { n as verifyCollectorOwnership } from "./ownership-D15Op8vN.mjs";
-import { D as remoteIosSetting, F as unknownSettingKeys, J as optimizationBuildProfile, K as artifactCachePolicy, L as REMOTE_DEVICE_BACKENDS, M as settingShapeErrors, O as resolveCacheProviderConfig, P as tunnelModeSetting, W as detectProviders, Y as resolveOptimizations, b as metroWarmupUrlSetting, d as iosLanHostSetting, f as iosLanHostSettingError, g as iosSigningIdentitySha1SettingError, h as iosSigningIdentitySha1Setting, i as SETTING_SHAPE_REMEDY, k as resolveSettings, m as iosSigningIdentitySettingError, p as iosSigningIdentitySetting, u as cacheProviderSettingError, w as publicUrlSetting } from "./settings-D030k0t4.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-gByVmIjy.mjs";
-import { S as untrackedNativeFiles, _ as refingerprintAfterMutation, a as waitForBuild, c as describeFingerprintMiss, d as fingerprintDiffRecord, f as fingerprintDiffSuffix, g as providerUploadOutcome, h as providerDownloadPath, m as prepareProviderDownloadDir, o as waitForSharedBuild, p as fingerprintProject, r as releaseBuildLock, s as buildCacheKey, t as acquireBuildLock, u as filesystemBuildCapability, v as resolveBuild, x as untrackedMissLine, y as storeBuild } from "./build-lock-DPXPLgTc.mjs";
-import { S as uploadRemote, _ as loadProjectProvider, b as resolveEasCliBin, d as UPLOAD_TIMEOUT_MS, f as cacheLevel, g as isEasAuthFailureText, h as exitAfterFlush, m as easAuthNote, o as parkedMaxSetting, p as checkEasAuth, t as POOL_SETTING_REMEDY, u as RESOLVE_TIMEOUT_MS, x as resolveRemote } from "./sim-pool-KaIsp2Ft.mjs";
-import { C as isEasBuildFailure, S as easDeviceBuildRemedy, _ as noMetroMessage, a as swapJsBundle, b as sleep, c as ensureBooted, f as clearIosAdoptionPending, g as launchOutcomeRecord, h as isPhysicalDeviceRequest, l as ensureOwnedDevice, m as gateShouldRetry, n as pickDevClientScheme, o as needsPrebuild, p as ensureWorkspaceStorageSafely, r as schemesFromInfoPlist, s as runPrebuild, t as devClientScheme, v as noMetroRemedy, w as resolveEasDevelopmentBuild, x as warmMetro, y as resolveMetroWithRetry } from "./dev-client-HyqISM0h.mjs";
-import { t as withWorkspaceProcessLock } from "./workspace-process-lock-DWaiRD0e.mjs";
-import { n as NO_BUILD_PROGRESS, s as startBuildProgress } from "./build-progress-CVqkfPC6.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-Q_OtW1Rf.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-Uf3a83Tv.mjs";
-import { O as parseIosSimulatorApp, p as listIosRuntimes } from "./ios-BL2NFckr.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-CnTAz8X1.mjs";
-import { a as compilationCacheActivityLine, c as readBundleExecutable, g as acquireBuildSlot, l as readBundleId, p as describeDiagnostic, r as buildIos, s as discoverXcodeProject, t as COMPILATION_CACHE_NOT_RUN, u as resolveScheme, v as releaseBuildSlot } from "./xcode-BZqyxh3e.mjs";
-import { a as statsProjectKey, i as recordRunStats, n as readRunEstimates, t as createRunRecorder } from "./stats-DG9e66Rz.mjs";
-import { c as unknownIosRuntimeRefusal, r as checkDeviceCapacity, s as unknownIosDeviceTypeRefusal } from "./simslim-B_LsGLuJ.mjs";
-import { a as ensureMetroReachable, b as ownedSessionName, c as remoteIosDeps, l as resolveRemoteContext, n as binOnPath, o as ensureRemoteBootOwned, r as bundleEntryPoint, w as gateMetroOrigin } from "./device-remote-AQ5rQPqr.mjs";
-import { n as nativeRunCommand, t as launchSlotScope } from "./slot-launch-DU9A-gYw.mjs";
-import { t as spawnEntry } from "./spawn-entry-nCE6m770.mjs";
-import { a as printNativeCrashReport, n as IOS_CRASH_REPORT_RETRY, o as simulatorConsolePaths, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-Vfz83GCF.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-D972i9wf.mjs";
-import { a as runPodInstall, n as podsAreStale, r as readPodState } from "./deps-Cip5vUm1.mjs";
+import { L as deviceSlotFileKey, R as deviceSlotKey, V as parseDeviceSlotOption, W as validateDeviceSlot, f as getProject, k as ownership_claim_exports, l as getConcurrencyLimits, w as upsertProject } from "./config-BEq0Qw_a.mjs";
+import { t as getExecutor } from "./exec-DK8KaVHK.mjs";
+import { r as createNdjsonWriter } from "./ndjson-CDY9IkVC.mjs";
+import { O as workspaceDir, c as signalProcessTree, h as recordWorkspaceUse, i as pidExists, j as workspaceLogsDir, m as readWorkspaceState, s as resolveProjectMetro, y as writeWorkspaceState } from "./metro-BWLOJ_Wr.mjs";
+import { D as makeTemporaryDirectory, O as removeTemporaryEntry, s as gitCommonDir, y as repoRoot } from "./worktree-BlizKDpZ.mjs";
+import { a as detectIsExpo, i as detectBundleId, n as appProjectProblem, o as findProjectRoot, t as NO_PROJECT_REFUSAL } from "./project-BXZzOABt.mjs";
+import { n as MODE_EXPO, p as writeWorkspaceLaunch, t as MODE_BARE } from "./state-WGdIbi_d.mjs";
+import { t as withWorkspaceProcessLock } from "./workspace-process-lock-BXA96myD.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-D5z2_bcF.mjs";
+import { A as resolveBuild, C as fingerprintDiffRecord, D as providerDownloadPath, E as prepareProviderDownloadDir, N as untrackedMissLine, O as providerUploadOutcome, P as untrackedNativeFiles, S as filesystemBuildCapability, T as fingerprintProject, _ as waitForBuild, b as describeFingerprintMiss, g as releaseBuildLock, j as storeBuild, k as refingerprintAfterMutation, m as acquireBuildLock, v as waitForSharedBuild, w as fingerprintDiffSuffix, y as buildCacheKey } from "./device-lease-CbEaIk7b.mjs";
+import { n as NO_BUILD_PROGRESS, s as startBuildProgress } from "./build-progress-BXx-ZBe4.mjs";
+import { A as resolveCacheProviderConfig, E as publicUrlSetting, I as tunnelModeSetting, L as unknownSettingKeys, P as settingShapeErrors, S as metroWarmupUrlSetting, U as optimizationBuildProfile, V as artifactCachePolicy, W as resolveOptimizations, _ 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, z as detectProviders } from "./settings-DOugPlPz.mjs";
+import { h as POOL_SETTING_REMEDY, y as parkedMaxSetting } from "./ownership-DZjdx8Gq.mjs";
+import { D as parseIosSimulatorApp, f as listIosRuntimes } from "./ios-B2Fpqvlb.mjs";
+import { a as acquireBuildSlot, s as releaseBuildSlot } from "./in-use-CjUluqIX.mjs";
+import { n as verifyCollectorOwnership } from "./ownership-D2xbLVoz.mjs";
+import { A as UPLOAD_TIMEOUT_MS, B as resolveRemote, F as isEasAuthFailureText, I as loadProjectProvider, M as checkEasAuth, N as easAuthNote, O as gateMetroOrigin, P as exitAfterFlush, V as uploadRemote, a as ensureMetroReachable, j as cacheLevel, k as RESOLVE_TIMEOUT_MS, l as remoteIosDeps, n as binOnPath, o as ensureRemoteBootOwned, r as bundleEntryPoint, u as resolveRemoteContext, w as ownedSessionName, z as resolveEasCliBin } from "./device-remote-Dy1jGj3U.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-CrJ6t_bv.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-CQS_Kg-C.mjs";
+import { c as unknownIosRuntimeRefusal, d as isEasBuildFailure, f as resolveEasDevelopmentBuild, r as checkDeviceCapacity, s as unknownIosDeviceTypeRefusal, u as easDeviceBuildRemedy } from "./simslim-Ca3487H6.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-Di8Q-9Ro.mjs";
+import { _ as isPhysicalDeviceRequest, a as swapJsBundle, b as warmMetro, c as runPrebuild, d as ensureOwnedDevice, g as ensureWorkspaceStorageSafely, h as ensureDevServer, l as staleNativeDirRefusal, m as clearIosAdoptionPending, n as pickDevClientScheme, o as planPrebuild, r as schemesFromInfoPlist, s as recordPrebuild, t as devClientScheme, u as ensureBooted, v as launchOutcomeRecord, y as sleep } from "./dev-client-92U593KT.mjs";
+import { t as budgetGate } from "./budget-BP4jZZL4.mjs";
+import { f as spawnEntry, s as startDevServer } from "./start-F9gv5dcC.mjs";
+import { a as statsProjectKey, i as recordRunStats, n as readRunEstimates, t as createRunRecorder } from "./stats-BAgJaLA4.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-B2tBkf0m.mjs";
+import { n as nativeRunCommand, t as launchSlotScope } from "./slot-launch-C5cg0fmk.mjs";
+import { a as printNativeCrashReport, n as IOS_CRASH_REPORT_RETRY, o as simulatorConsolePaths, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-xxWKNO3-.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-CtRdEVjx.mjs";
+import { a as runPodInstall, n as podsAreStale, r as readPodState } from "./deps-DP4eWqea.mjs";
 import { existsSync, mkdirSync, mkdtempSync, openSync, rmSync, writeFileSync } from "node:fs";
 import { InvalidArgumentError } from "commander";
 import { basename, join } from "node:path";
@@ -250,7 +251,7 @@ function lastBuildRecord({ fingerprint = null, cacheKey = null, cacheHit = false
 	if (errorCode) record.errorCode = errorCode;
 	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 }) {
+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 }) {
 	return {
 		platform: "ios",
 		...slot && slot !== "default" ? { slot } : {},
@@ -277,7 +278,8 @@ function iosFacts({ slot, udid, deviceName, deviceType = null, runtime = null, f
 		logs: { dir: logsDir },
 		durationMs,
 		...webPreviewUrl ? { webPreviewUrl } : {},
-		...lease === void 0 ? {} : { lease }
+		...lease === void 0 ? {} : { lease },
+		...devServer ? { devServer } : {}
 	};
 }
 function writeLastBuild(root, record, { write = writeWorkspaceState } = {}) {
@@ -303,7 +305,7 @@ async function finishIosUpload(uploadPending, remote, phase, note) {
 	}
 	return false;
 }
-function reportIosResult({ slot, d, root, json, release, configuration, buildScheme = null, metroCheck, metroPort, logsDir, device, udid, appPath, bundleId, installSkipped, elapsed, startedAt, storeHash, storeKey, cacheHit, compilationCache, useBuildCache, waitedForBuild, launchState, launchWarning, providerName, closeWriter, webPreviewUrl, lease, recordRun }) {
+function reportIosResult({ slot, d, root, json, release, configuration, buildScheme = null, metroCheck, metroPort, logsDir, device, udid, appPath, bundleId, installSkipped, elapsed, startedAt, storeHash, storeKey, cacheHit, compilationCache, useBuildCache, waitedForBuild, launchState, launchWarning, providerName, closeWriter, webPreviewUrl, lease, recordRun, reclaimed = [], devServer = null }) {
 	const durationMs = elapsed();
 	recordRun({
 		failed: false,
@@ -345,15 +347,19 @@ function reportIosResult({ slot, d, root, json, release, configuration, buildSch
 		durationMs,
 		launched: launchState,
 		webPreviewUrl,
-		lease
+		lease,
+		devServer
 	});
-	if (json) console.log(JSON.stringify(facts));
+	if (json) console.log(JSON.stringify(reclaimed.length ? {
+		...facts,
+		reclaimed
+	} : facts));
 	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 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 metroResult = release ? `embedded (${configuration})` : !metroCheck ? `check skipped on port ${metroPort}` : launchState === "unverified" ? `state unverified on port ${metroPort}` : `running on port ${metroPort}`;
+		const metroResult = release ? `embedded (${configuration})` : !metroCheck ? `check skipped on port ${metroPort}` : launchState === "unverified" ? `state unverified on port ${metroPort}` : `running on port ${metroPort}${devServer ? ` (started: ${devServer.reason})` : ""}`;
 		console.log([
 			outcome,
 			phaseLine("device", `${deviceName} (${udid})`),
@@ -762,9 +768,19 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 				note(chalk.yellow(phaseLine("build", `could not take a build slot: ${e?.message || e}; building anyway`)));
 			}
 			const mutatingSteps = [];
-			if (d.needsPrebuild(root, "ios", isExpo)) {
+			const prebuild = d.planPrebuild(root, "ios", {
+				isExpo,
+				fingerprint,
+				sources: fingerprintSources
+			});
+			if (prebuild === "refuse") fail({
+				...staleNativeDirRefusal("ios"),
+				build: buildFailure
+			});
+			if (prebuild === "generate" || prebuild === "regenerate") {
 				step("prebuild");
-				const result = await d.runPrebuild(root, "ios", logWriter());
+				recordPrebuild(root, "ios", null);
+				const result = await d.runPrebuild(root, "ios", logWriter(), { clean: prebuild === "regenerate" });
 				if (result?.failed) {
 					phase("prebuild", "FAILED");
 					fail({
@@ -775,9 +791,21 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 						build: buildFailure
 					});
 				}
-				phase("prebuild", `ios/ absent -> generated (${formatDuration(result?.durationMs ?? 0)})`);
+				phase("prebuild", `${prebuild === "generate" ? "ios/ absent -> generated" : "ios/ not generated from this fingerprint -> regenerated with --clean"} (${formatDuration(result?.durationMs ?? 0)})`);
 				mutatingSteps.push("prebuild");
 			}
+			if (isExpo && buildScheme !== void 0) {
+				const project = d.discoverXcodeProject(root);
+				if (project.error) fail({
+					...project.error,
+					build: buildFailure
+				});
+				const schemeError = d.resolveScheme(project, { scheme: buildScheme }).error;
+				if (schemeError) fail({
+					...schemeError,
+					build: buildFailure
+				});
+			}
 			const podState = d.readPodState(root);
 			const action = podAction(podState, d.podsAreStale(podState.lockText, podState.manifestText));
 			if (action.install) {
@@ -806,6 +834,7 @@ async function acquireIosArtifact({ root, logFile, udid, remoteDestination, devi
 					previousHash: fingerprint,
 					fingerprint: d.fingerprintProject
 				});
+				if (after && mutatingSteps.includes("prebuild")) recordPrebuild(root, "ios", after.hash);
 				if (!after) {
 					storeHash = null;
 					storeKey = null;
@@ -1567,6 +1596,7 @@ const DEFAULT_DEPS = {
 	getProject,
 	upsertProject,
 	checkDeviceCapacity,
+	budgetGate,
 	ensureOwnedDevice,
 	listIosRuntimes,
 	ensureBooted,
@@ -1576,7 +1606,7 @@ const DEFAULT_DEPS = {
 	ensureRemoteBootOwned,
 	detectProviders,
 	resolveProjectMetro,
-	resolveMetroWithRetry,
+	startDevServer,
 	warmMetro,
 	readWorkspaceState,
 	pidExists,
@@ -1597,7 +1627,7 @@ const DEFAULT_DEPS = {
 	resolveEasCliBin,
 	resolveRemote,
 	uploadRemote,
-	needsPrebuild,
+	planPrebuild,
 	runPrebuild,
 	readPodState,
 	podsAreStale,
@@ -1822,10 +1852,14 @@ function recordIosReloadTarget({ d, root, physical, remoteDevice, bundleId, udid
 		note(chalk.yellow(phaseLine("state", `could not record iOS launch: ${error?.message || error}`)));
 	}
 }
-function simulatorLaunchFailureRemedy(remote, udid, bundleId, logFile) {
-	return `${remote ? "Run" : "If the simulator timed out, run `stim doctor --platform ios` and resolve any reported host memory pressure before retrying. Otherwise run"} \`xcrun simctl launch --terminate-running-process --console ${udid} ${bundleId}\` to see what the app reports, and check ${logFile}.`;
+function installFailureRemedy(remoteDevice) {
+	return remoteDevice?.failureRemedy() ?? "Check that the simulator is booted and that the app was built for the simulator SDK.";
+}
+function launchFailureRemedy(remoteDevice, udid, bundleId, logFile) {
+	if (remoteDevice) return remoteDevice.failureRemedy();
+	return `If the simulator timed out, run \`stim doctor --platform ios\` and resolve any reported host memory pressure before retrying. Otherwise run \`xcrun simctl launch --terminate-running-process --console ${udid} ${bundleId}\` to see what the app reports, and check ${logFile}.`;
 }
-async function finishIosRun({ 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, enterPhase }) {
+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, waitedForBuild, compilation: compilationCache } = cache;
 	const storeHash = cache.identity?.fingerprint ?? null;
@@ -2020,7 +2054,7 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 		if (installed?.failed) return fail({
 			code: installed.code || "STIM_INSTALL_FAILED",
 			message: installed.reason,
-			remedy: "Check that the simulator is booted and that the app was built for the simulator SDK.",
+			remedy: installFailureRemedy(remoteDevice),
 			build: {
 				...buildFailure,
 				appPath,
@@ -2081,7 +2115,7 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 			return fail({
 				code: launched.code || "STIM_LAUNCH_FAILED",
 				message: launched.reason,
-				remedy: simulatorLaunchFailureRemedy(Boolean(remoteDevice), udid, bundleId, logFile),
+				remedy: launchFailureRemedy(remoteDevice, udid, bundleId, logFile),
 				build: {
 					...buildFailure,
 					appPath,
@@ -2194,7 +2228,9 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 			closeWriter,
 			webPreviewUrl: remoteDevice?.webPreviewUrl() ?? null,
 			lease: physical ? leaseFacts : void 0,
-			recordRun
+			recordRun,
+			reclaimed,
+			devServer
 		}),
 		uploadsAbandoned
 	};
@@ -2211,7 +2247,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. Requires a running dev server (`stim start`).").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("--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?\" gate 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("--json", "Emit the facts as a single JSON line on stdout; every other line goes to stderr").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) => {
@@ -2250,7 +2286,7 @@ function explicitSchemeRefusal(root, scheme, isExpo, d) {
 		message: "--scheme must name a non-empty shared Xcode app scheme.",
 		remedy: "Pass the exact scheme name shown by xcodebuild -list."
 	};
-	if (d.needsPrebuild(root, "ios", isExpo)) return null;
+	if (isExpo) return null;
 	const project = d.discoverXcodeProject(root);
 	if (project.error) return project.error;
 	return d.resolveScheme(project, { scheme }).error ?? null;
@@ -2374,6 +2410,7 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 	});
 	const recordRun = stats.record;
 	let compilationCache = COMPILATION_CACHE_NOT_RUN;
+	let reclaimed = [];
 	const fail = ({ code, message, remedy = null, lines = [], logPath = null, build = null, lease }) => {
 		releaseLease();
 		if (message) note(chalk.red(phaseLine("error", message)));
@@ -2397,7 +2434,8 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 			message: message ?? null,
 			remedy: remedy ?? null,
 			...compilationCache.status === "not-run" ? {} : { compilationCache },
-			...lease === void 0 ? {} : { lease }
+			...lease === void 0 ? {} : { lease },
+			...reclaimed.length ? { reclaimed } : {}
 		}));
 		writer?.close?.();
 		process.exitCode = 1;
@@ -2514,23 +2552,12 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 		listRuntimes: d.listIosRuntimes
 	});
 	if (modelRefusal) return fail(modelRefusal);
-	const easBuild = await d.resolveEasDevelopmentBuild({
+	const budget = await d.budgetGate({
 		root,
-		platform: "ios",
-		profile: opts.easProfile,
-		note,
-		isExpo,
-		physical,
-		selectors: [opts.scheme, opts.configuration],
-		buildCache: opts.buildCache
-	});
-	if (isEasBuildFailure(easBuild)) return fail(easBuild);
-	const registerProject = () => d.upsertProject(root, {
-		bundleId: d.detectBundleId(root) ?? void 0,
-		isExpo
+		note
 	});
-	if (remoteBackend !== "eas") registerProject();
-	const proj = d.getProject(root);
+	reclaimed = budget.reclaimed;
+	if (budget.refusal) return fail(budget.refusal);
 	let remoteDevice = null;
 	if (remoteBackend) {
 		const resolved = await d.resolveRemoteContext({
@@ -2553,6 +2580,23 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 			launchIosApp: remoteDevice.launchIosApp
 		};
 	}
+	const easBuild = await d.resolveEasDevelopmentBuild({
+		root,
+		platform: "ios",
+		profile: opts.easProfile,
+		note,
+		isExpo,
+		physical,
+		selectors: [opts.scheme, opts.configuration],
+		buildCache: opts.buildCache
+	});
+	if (isEasBuildFailure(easBuild)) return fail(easBuild);
+	const registerProject = () => d.upsertProject(root, {
+		bundleId: d.detectBundleId(root) ?? void 0,
+		isExpo
+	});
+	if (remoteBackend !== "eas") registerProject();
+	const proj = d.getProject(root);
 	const limits = d.getConcurrencyLimits();
 	let physicalDevice = null;
 	let wireless = false;
@@ -2613,6 +2657,7 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 	let metroPort = proj?.metroPort ?? null;
 	let lanAddress = null;
 	let lanOriginUrl = null;
+	let devServer = null;
 	if (!await resolveMetroPort()) return null;
 	let device;
 	if (physicalDevice) device = {
@@ -2655,34 +2700,28 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 			metroPort = null;
 			phase("metro", `skipped (${configuration}: the JS bundle is embedded, no dev server is used)`);
 		} else if (metroCheck) {
-			if (!metroPort) {
-				fail({
-					code: "STIM_NO_METRO",
-					message: "No Metro port is reserved for this workspace, so there is no dev server to build against.",
-					remedy: "Run `stim start` first, or pass --no-metro-check."
-				});
-				return false;
-			}
-			const resolution = await d.resolveMetroWithRetry(d.resolveProjectMetro, metroPort, root, { onRetry: ({ delayMs }) => note(chalk.dim(phaseLine("metro", `port ${metroPort} did not verify yet; retrying in ${Math.round(delayMs / 1e3)}s (Metro may still be indexing)`))) });
-			if (!resolution?.metro) {
-				const supervisor = d.readWorkspaceState(root)?.supervisor ?? null;
-				const supervisorAlive = Boolean(supervisor?.pid && d.pidExists(supervisor.pid));
+			const gate = await ensureDevServer({
+				root,
+				port: metroPort,
+				settings,
+				remote: Boolean(remoteDevice),
+				note,
+				resolve: d.resolveProjectMetro,
+				start: d.startDevServer,
+				readState: d.readWorkspaceState
+			});
+			reclaimed = [...reclaimed, ...gate.reclaimed];
+			if (!gate.ok) {
 				fail({
-					code: "STIM_NO_METRO",
-					message: noMetroMessage({
-						port: metroPort,
-						resolution,
-						supervisor,
-						supervisorAlive
-					}),
-					remedy: noMetroRemedy({
-						port: metroPort,
-						supervisor,
-						supervisorAlive
-					})
+					code: gate.code,
+					message: gate.message,
+					remedy: gate.remedy,
+					lines: gate.lines
 				});
 				return false;
 			}
+			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}.`));
@@ -2889,6 +2928,8 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 				lease: leaseHandle,
 				releaseLease,
 				recordRun,
+				reclaimed,
+				devServer,
 				enterPhase: progress.step
 			});
 		} finally {
@@ -2905,4 +2946,4 @@ async function runIos(opts = {}, overrides = {}, progress = NO_BUILD_PROGRESS) {
 	}
 }
 //#endregion
-export { appNameFromPath, buildLogFile, cacheDescription, collectorEntry, iosCommand as default, devClientScheme, deviceLabel, ensureWorkspaceStorageSafely, formatDuration, gateShouldRetry, iosConfigurationSetting, iosFacts, isReleaseConfiguration, lastBuildRecord, noMetroMessage, phaseLine, pickDevClientScheme, podAction, registerIos, replaceCollector, resolveConfiguration, resolveDeviceType, resolveMetroWithRetry, resolveRuntime, schemesFromInfoPlist, shortHash, shortUdid, writeLastBuild };
+export { appNameFromPath, buildLogFile, cacheDescription, collectorEntry, iosCommand as default, devClientScheme, deviceLabel, ensureWorkspaceStorageSafely, formatDuration, iosConfigurationSetting, iosFacts, isReleaseConfiguration, lastBuildRecord, phaseLine, pickDevClientScheme, podAction, registerIos, replaceCollector, resolveConfiguration, resolveDeviceType, resolveRuntime, schemesFromInfoPlist, shortHash, shortUdid, writeLastBuild };

package/dist/{ios-device-DPsSm0v_.mjs → ios-device-BiOsSVzd.mjs}

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

package/dist/{ios-device-D972i9wf.mjs → ios-device-CtRdEVjx.mjs}

@@ -1,6 +1,6 @@
-import { t as getExecutor } from "./exec-jIAlgilk.mjs";
-import { n as TOOL_ERROR_PREFIX } from "./ios-device-DPsSm0v_.mjs";
-import { i as INSTALL_ERROR } from "./app-install-Uf3a83Tv.mjs";
+import { t as getExecutor } from "./exec-DK8KaVHK.mjs";
+import { n as TOOL_ERROR_PREFIX } from "./ios-device-BiOsSVzd.mjs";
+import { i as INSTALL_ERROR } from "./app-install-CrJ6t_bv.mjs";
 import { mkdtempSync, readFileSync, rmSync } from "node:fs";
 import { join } from "node:path";
 import { tmpdir } from "node:os";

package/dist/{launch-verify-Q_OtW1Rf.mjs → launch-verify-CQS_Kg-C.mjs}

@@ -1,8 +1,8 @@
-import { t as getExecutor } from "./exec-jIAlgilk.mjs";
-import { o as readNdjsonGenerations } from "./ndjson-9uFNRwfe.mjs";
-import { t as DEV_MENU_LAUNCH_ARGS } from "./ios-device-DPsSm0v_.mjs";
-import { s as isAppLaunchError } from "./command-output-gByVmIjy.mjs";
-import { d as deviceShellArg, n as ANDROID_DISABLE_AUTO_LAUNCH_EXTRA, o as androidAppProcess } from "./app-install-Uf3a83Tv.mjs";
+import { t as getExecutor } from "./exec-DK8KaVHK.mjs";
+import { o as readNdjsonGenerations } from "./ndjson-CDY9IkVC.mjs";
+import { s as isAppLaunchError } from "./command-output-D5z2_bcF.mjs";
+import { t as DEV_MENU_LAUNCH_ARGS } from "./ios-device-BiOsSVzd.mjs";
+import { d as deviceShellArg, n as ANDROID_DISABLE_AUTO_LAUNCH_EXTRA, o as androidAppProcess } from "./app-install-CrJ6t_bv.mjs";
 import { join } from "node:path";
 //#region src/engine/app-readiness.ts
 const APP_READINESS_TIMEOUT_MS = 3e4;

package/dist/{logs-CI9NQSK7.mjs → logs-MARIy6m9.mjs}

@@ -1,11 +1,11 @@
-import { G as parseDeviceSlotOption, g as loadConfig, h as isPathPrefix } from "./config-Cp9lM3wX.mjs";
-import { n as SOURCES, t as LEVELS } from "./ndjson-9uFNRwfe.mjs";
-import { b as workspaceLogsDir, r as readWorkspaceState } from "./workspace-state-DF2gCFhx.mjs";
-import { o as findProjectRoot } from "./project-DS112DYB.mjs";
-import { f as refuseNoProject, v as launchErrorPreview } from "./command-output-gByVmIjy.mjs";
-import { i as captureWorkspaceCrashes, t as errorDiagnostics } from "./error-diagnostics-Vfz83GCF.mjs";
-import { a as fileSizes, c as parseSince, i as compileGrep, l as queryLogs, o as followLogs, r as buildCriteria, s as logFiles, u as readLogRecords } from "./logs-query-Cqma3WIu.mjs";
+import { V as parseDeviceSlotOption, g as loadConfig$1, h as isPathPrefix } from "./config-BEq0Qw_a.mjs";
+import { n as SOURCES, t as LEVELS } from "./ndjson-CDY9IkVC.mjs";
+import { j as workspaceLogsDir, m as readWorkspaceState$1 } from "./metro-BWLOJ_Wr.mjs";
+import { o as findProjectRoot } from "./project-BXZzOABt.mjs";
+import { f as refuseNoProject, v as launchErrorPreview } from "./command-output-D5z2_bcF.mjs";
+import { i as captureWorkspaceCrashes, t as errorDiagnostics } from "./error-diagnostics-xxWKNO3-.mjs";
 import { realpathSync } from "node:fs";
+import { buildCriteria, compileGrep, fileSizes, followLogs, logFiles, parseSince, queryLogs, readLogRecords } from "@stim-cli/core/state";
 import { relative, sep } from "node:path";
 import chalk from "chalk";
 //#region src/commands/logs.ts
@@ -70,7 +70,7 @@ function nearestRegisteredLogsProject(root, candidates) {
 	})[0] ?? null;
 }
 function registeredDescendantWithLogs(root) {
-	const candidates = Object.keys(loadConfig()?.projects ?? {}).flatMap((path) => {
+	const candidates = Object.keys(loadConfig$1()?.projects ?? {}).flatMap((path) => {
 		try {
 			const canonical = realpathSync(path);
 			return logFiles(workspaceLogsDir(canonical)).length > 0 ? [canonical] : [];
@@ -157,7 +157,7 @@ function logsCommand(program) {
 			...query,
 			records: timeline
 		});
-		const supervisorPort = readWorkspaceState(root)?.supervisor?.port;
+		const supervisorPort = readWorkspaceState$1(root)?.supervisor?.port;
 		const records = opts.json ? rawRecords : await errorDiagnostics(rawRecords, {
 			root,
 			logsDir: dir,