stim 1.15.0 → 1.16.0

package/dist/device-pool-CUaEWMMm.mjs

@@ -0,0 +1,125 @@
+import { R as deviceSlotKey } from "./config-D0DbpZtM.mjs";
+import { a as parseLease, f as selectPoolDevice, n as fileLeaseIo, r as leaseIsExpired, t as deviceLeasePath } from "./device-lease-D-hLqx1b.mjs";
+import { i as DEVICE_WAIT_POLL_MS, n as DEVICE_BUSY, o as leaseExpiryText } from "./device-lease-run-CqjShqWW.mjs";
+//#region src/engine/device-pool.ts
+function heldPoolId(root, platform, now, io = fileLeaseIo, slot = "default") {
+	const record = io.readHolder(root)[deviceSlotKey(platform, slot)];
+	if (!record) return null;
+	const lease = parseLease(io.readLease(deviceLeasePath(platform, record.id)));
+	if (!lease || lease.token !== record.token || leaseIsExpired(lease, now)) return null;
+	return record.id;
+}
+function readPool(platform, candidates, io) {
+	const reading = {
+		usable: [],
+		leases: [],
+		unreadable: []
+	};
+	for (const candidate of candidates) {
+		const path = deviceLeasePath(platform, candidate.id);
+		const raw = io.readLease(path);
+		const lease = parseLease(raw);
+		if (raw !== null && !lease) {
+			reading.unreadable.push(path);
+			continue;
+		}
+		reading.usable.push(candidate);
+		if (lease) reading.leases.push(lease);
+	}
+	return reading;
+}
+function disconnectedHeldRefusal(id, idLabel) {
+	return {
+		code: "STIM_NO_DEVICE",
+		message: `This workspace leases ${id}, and it is not connected.`,
+		remedy: `Run \`stim device unlock\` to give it up, then run this command again. Naming another \`--device <${idLabel}>\` refuses the same way while this lease is held.`,
+		lease: null
+	};
+}
+const NO_LEASE_FACTS = {
+	platform: null,
+	id: null,
+	deviceName: null,
+	holder: null,
+	expiresAt: null
+};
+function unreadableSentence(unreadable) {
+	return unreadable.length ? ` Unreadable lease file, so no run may take that device around it: ${unreadable.join("; ")}.` : "";
+}
+function poolBusyRefusal(holders, leases, unreadable, now, waitSeconds, spare = [], idLabel = "id") {
+	const named = holders.map((holder) => `${holder.id} (${holder.holder}, until ${leaseExpiryText(holder.expiresAt, now)})`);
+	const first = holders[0];
+	const lease = first ? leases.find((entry) => entry.id === first.id) : void 0;
+	if (!first) return {
+		code: DEVICE_BUSY,
+		message: `Every connected device has an unreadable lease file, so Stim cannot tell who holds them: ${unreadable.join("; ")}.`,
+		remedy: "Read each file and, once you know no run depends on it, delete it. `stim gc` reports them on every run.",
+		lease: NO_LEASE_FACTS
+	};
+	return {
+		code: DEVICE_BUSY,
+		message: `Every connected device is leased by another workspace${waitSeconds > 0 ? `, and this run waited ${waitSeconds}s for one` : ""}: ${named.join("; ")}.${unreadableSentence(unreadable)}`,
+		remedy: (spare.length ? `Also connected and free: ${spare.join(", ")}. Name one with \`--device <${idLabel}>\` to use it now. ` : "") + "Wait longer with `--wait <seconds>`, connect another device, or pass `--no-wait` to install anyway -- which takes no lease and, when both workspaces build the same app id, terminates the holder's running app.",
+		lease: {
+			platform: lease?.platform ?? null,
+			id: first.id,
+			deviceName: lease?.deviceName ?? null,
+			holder: first.holder,
+			expiresAt: first.expiresAt
+		}
+	};
+}
+async function selectFromPool({ root, platform, slot = "default", idLabel, list, noCandidates, waitSeconds, deadline, noWait = false, now = Date.now, sleep = (ms) => new Promise((r) => setTimeout(r, ms)), warn = () => {}, io = fileLeaseIo }) {
+	const held = heldPoolId(root, platform, now(), io, slot);
+	const until = deadline ?? now() + waitSeconds * 1e3;
+	let lastLine = null;
+	for (;;) {
+		const { usable, leases, unreadable } = readPool(platform, list(), io);
+		const selection = selectPoolDevice({
+			candidates: usable,
+			leases,
+			held,
+			now: now()
+		});
+		if (selection.status === "selected") return selection;
+		if (selection.status === "held-disconnected") return {
+			status: "refused",
+			refusal: disconnectedHeldRefusal(selection.id, idLabel)
+		};
+		if (selection.status === "none") {
+			if (unreadable.length) return {
+				status: "refused",
+				refusal: poolBusyRefusal([], leases, unreadable, now(), waitSeconds)
+			};
+			const { message, remedy } = noCandidates();
+			return {
+				status: "refused",
+				refusal: {
+					code: "STIM_NO_DEVICE",
+					message,
+					remedy,
+					lease: null
+				}
+			};
+		}
+		const first = selection.holders[0];
+		if (noWait && first) {
+			const candidate = usable.find((entry) => entry.id === first.id);
+			if (candidate) return {
+				status: "selected",
+				candidate
+			};
+		}
+		if (now() >= until) return {
+			status: "refused",
+			refusal: poolBusyRefusal(selection.holders, leases, unreadable, now(), waitSeconds, selection.spare, idLabel)
+		};
+		if (lastLine === null || now() - lastLine >= 3e4) {
+			lastLine = now();
+			warn(`waiting for a free device; every connected one is leased: ${selection.holders.map((holder) => `${holder.id} (${holder.holder}, until ${leaseExpiryText(holder.expiresAt, now())})`).join("; ")}`);
+		}
+		await sleep(DEVICE_WAIT_POLL_MS);
+	}
+}
+//#endregion
+export { selectFromPool as t };

package/dist/{device-remote-9ulPsdhY.mjs → device-remote-D5WVWqOq.mjs}

@@ -1,18 +1,18 @@
 import { t as getExecutor } from "./exec-CaErVv7t.mjs";
 import { d as getConfigDir } from "./config-D0DbpZtM.mjs";
-import { C as workspaceLogsDir, E as withDirLock, T as workspaceStateFile, b as workspaceDir, x as workspaceId } from "./workspace-state-CL2V2Ons.mjs";
-import { c as ownedDeviceLabel } from "./project-CV3tDFHl.mjs";
-import { a as clearRemoteSession, c as readMetroTunnel, u as readRemoteSession } from "./state-CaeaHbDA.mjs";
+import { a as formatElapsed } from "./command-output-DnJMdEY-.mjs";
+import { K as planMetroReach } from "./settings-oTSkkNrM.mjs";
+import { l as ownedDeviceLabel } from "./project-Du91Ilvc.mjs";
+import { o as pidExists } from "./metro-BeK1ZPz1.mjs";
+import { C as workspaceStateFile, v as workspaceDir, w as withDirLock, x as workspaceLogsDir$1, y as workspaceId } from "./workspace-state-B8-aJ1_5.mjs";
+import { a as clearRemoteSession, c as readMetroTunnel, u as readRemoteSession } from "./state-DcW6vOd_.mjs";
+import { T as sanitizeDeviceLabel } from "./ios-BaInn3sW.mjs";
 import { t as withWorkspaceProcessLock } from "./workspace-process-lock-BL7Q0HCO.mjs";
-import { a as formatElapsed } from "./command-output-CliHHn7a.mjs";
-import { o as pidExists } from "./metro-Di8EN2Tb.mjs";
-import { W as planMetroReach } from "./settings-CduVcoxj.mjs";
-import { T as sanitizeDeviceLabel } from "./ios-3CtCRhwr.mjs";
-import { y as probePublicHttp } from "./stop-cause-CZ_Mr-v9.mjs";
-import { i as INSTALL_ERROR, o as LAUNCH_ERROR, u as devClientDeepLink } from "./app-install-CAAplXAt.mjs";
-import { c as readMetroRecords, o as isBundleProof } from "./launch-verify-CLlofxRt.mjs";
+import { u as probePublicHttp } from "./ownership-hCkPzGmr.mjs";
+import { i as INSTALL_ERROR, o as LAUNCH_ERROR, u as devClientDeepLink } from "./app-install-CKWdbXIX.mjs";
+import { c as readMetroRecords, o as isBundleProof } from "./launch-verify-2DBRizjo.mjs";
 import { t as compareStimVersions } from "./stim-installations-QMEI32v1.mjs";
-import { c as nativeRunWaitNotice } from "./native-run-DFDoIRbY.mjs";
+import { c as nativeRunWaitNotice } from "./native-run-NaBrRFtQ.mjs";
 import { existsSync, mkdirSync, realpathSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { easMachineStateRoot, easMachineStateRoot as easMachineStateRoot$1, easSessionLedgerFile, easSessionLedgerLock, readEasSessionLedger, readEasSessionLedger as readEasSessionLedger$1, readJsonObject, validEasSessionClaim } from "@stim-cli/core/state";
@@ -1293,7 +1293,7 @@ async function ensureMetroReachable({ ctx, metroPort, isExpo, tunnelMode = "auto
 		gate = recorded.provider !== "tailscale";
 	}
 	if (gate && resolvedUrl) {
-		const logsDir = workspaceLogsDir(root);
+		const logsDir = workspaceLogsDir$1(root);
 		const result = await gateOrigin({
 			origin: resolvedUrl,
 			metroPort,

package/dist/{doctor-BcE5xsBn.mjs → doctor-Cimf-gGB.mjs}

@@ -1,36 +1,36 @@
 import { t as getExecutor } from "./exec-CaErVv7t.mjs";
 import { _ as loadConfig$1, p as getProject, s as configCorruptRepair, u as getConcurrencyLimits } from "./config-D0DbpZtM.mjs";
-import { m as sharedBuildCache, y as workspaceDerivedData } from "./workspace-state-CL2V2Ons.mjs";
-import { D as makeTemporaryDirectory, E as filesystemDevice, a as dirtyFingerprintFiles, h as locallyKnownUpstream, k as temporaryRoot, m as listWorktrees, s as gitCommonDir, x as resolveSourceCheckout, y as repoRoot } from "./worktree-C0c5Udwa.mjs";
-import { a as findProjectRoot$1, n as appProjectProblem, r as detectIsExpo, s as isPackageResolvable } from "./project-CV3tDFHl.mjs";
-import { d as quotedPath, f as refuseNoProject, l as phaseLine, u as plural } from "./command-output-CliHHn7a.mjs";
-import { C as diffFingerprintSources, D as fingerprintProject, h as listBuildLocks } from "./device-lease-W5Pi1q38.mjs";
-import { D as hostSystemImageArch, O as listAdbDevices, at as POOL_SETTING_REMEDY, dt as parkedMaxSetting, o as androidHome } from "./android-Db2eEMaf.mjs";
-import { A as remoteAndroidSetting, B as unknownSettingKeys, D as projectOptimizations, F as settingOrigin, L as settingShapeErrors, N as resolveSettings, R as settingsLayers, V as webSettings, Y as resolveOptimizations, a as SETTING_SHAPE_REMEDY, b as mergeSettingsLayers, i as SETTINGS_WITH_RESOLVE_TIME_FALLBACK, j as remoteIosSetting, n as PATH_SETTINGS, q as compilerCacheFallbackMessage, y as iosSimSlimProfileSetting } from "./settings-CduVcoxj.mjs";
-import { A as hostMemoryPressureAdvice, c as iosRuntimeMatches, j as readHostMemoryPressure, p as listIosRuntimes, u as listAllIosSims, y as pickDefaultIosCreation } from "./ios-3CtCRhwr.mjs";
-import { n as listBuildSlots } from "./build-slots-Df1ApSuH.mjs";
+import { d as quotedPath, f as refuseNoProject, l as phaseLine, u as plural } from "./command-output-DnJMdEY-.mjs";
+import { B as settingsLayers, Ct as filesystemDevice, Et as temporaryRoot, H as unknownSettingKeys, I as settingOrigin, M as remoteIosSetting, O as projectOptimizations, P as resolveSettings, R as settingShapeErrors, U as webSettings, Y as compilerCacheFallbackMessage, Z as resolveOptimizations, a as SETTING_SHAPE_REMEDY, b as mergeSettingsLayers, dt as listWorktrees, ft as locallyKnownUpstream, gt as repoRoot, i as SETTINGS_WITH_RESOLVE_TIME_FALLBACK, it as gitCommonDir, j as remoteAndroidSetting, n as PATH_SETTINGS, nt as dirtyFingerprintFiles, vt as resolveSourceCheckout, wt as makeTemporaryDirectory, y as iosSimSlimProfileSetting } from "./settings-oTSkkNrM.mjs";
+import { c as isPackageResolvable, n as appProjectProblem, o as findProjectRoot$1, r as detectIsExpo } from "./project-Du91Ilvc.mjs";
+import { _ as workspaceDerivedData, d as sharedBuildCache } from "./workspace-state-B8-aJ1_5.mjs";
+import { i as inspectBudget, n as budgetLine, z as inspectWatchmanMemory } from "./budget-DjrURfQn.mjs";
+import { C as diffFingerprintSources, D as fingerprintProject, h as listBuildLocks } from "./device-lease-D-hLqx1b.mjs";
+import { n as listBuildSlots } from "./build-slots-rUk77xqh.mjs";
+import { D as hostSystemImageArch, O as listAdbDevices, ft as parkedMaxSetting, o as androidHome, ot as POOL_SETTING_REMEDY } from "./android-B_NumVyQ.mjs";
+import { A as hostMemoryPressureAdvice, c as iosRuntimeMatches, j as readHostMemoryPressure, p as listIosRuntimes, u as listAllIosSims, y as pickDefaultIosCreation } from "./ios-BaInn3sW.mjs";
+import { C as podInstallCommand, D as projectCmakeLauncher, S as bundlerPin, f as ccacheEnabled, i as macosToolchain, m as detectXcodeMajor, n as androidToolchain, r as iosToolchain, t as androidRequirements } from "./toolchain-DkUflduf.mjs";
+import { b as realIo, h as inspectBuildMachines, o as offloadCheck, u as simulatorRuntime } from "./client-BTY686R6.mjs";
+import { n as inspectDeviceHostMachines } from "./machines-BIBUdhpj.mjs";
 import { a as findChrome, t as CHROME_INSTALL_REMEDY } from "./chrome-BrcVWQyD.mjs";
-import { i as liveOwnedDeviceCount } from "./device-capacity-DMuKC7nx.mjs";
-import { C as podInstallCommand, D as projectCmakeLauncher, S as bundlerPin, f as ccacheEnabled, i as macosToolchain, m as detectXcodeMajor, n as androidToolchain, r as iosToolchain, t as androidRequirements } from "./toolchain-DmeYjXD9.mjs";
-import { h as inspectBuildMachines, o as offloadCheck, u as simulatorRuntime } from "./client-C2IS36Qf.mjs";
-import { n as inspectDeviceHostMachines } from "./machines-CYtOCqcj.mjs";
-import { d as androidPathRoomRemedy, l as androidPathRoom, n as apkOutputsDir, t as androidSdkRefusal, u as androidPathRoomMessage } from "./gradle-CmdOBq1d.mjs";
-import { m as resolveRuntime, p as resolveDeviceType } from "./support-WLOzVKUv.mjs";
-import { f as resolveEasCliBin, i as checkEasAuth$1, l as ownerFromConfig, u as providerFromConfig } from "./remote-cache-CO2elm_b.mjs";
-import { _ as easCliSupport, g as MIN_EAS_CLI_SIMULATOR_VERSION, s as readInstalledEasCliVersion, v as easCliUpgradeRemedy } from "./device-remote-9ulPsdhY.mjs";
+import { i as liveOwnedDeviceCount } from "./device-capacity-BHwxNBlu.mjs";
+import { d as androidPathRoomRemedy, l as androidPathRoom, n as apkOutputsDir, t as androidSdkRefusal, u as androidPathRoomMessage } from "./gradle-BsO1MdsH.mjs";
+import { h as resolveRuntime, p as resolveDeviceType } from "./support-D4aYJniO.mjs";
+import { f as resolveEasCliBin, i as checkEasAuth$1, l as ownerFromConfig, u as providerFromConfig } from "./remote-cache-C8-V13XN.mjs";
+import { _ as easCliSupport, g as MIN_EAS_CLI_SIMULATOR_VERSION, s as readInstalledEasCliVersion, v as easCliUpgradeRemedy } from "./device-remote-D5WVWqOq.mjs";
 import { n as inspectStimVersions, t as compareStimVersions } from "./stim-installations-QMEI32v1.mjs";
-import { n as simslimIsOnPath, r as MIN_EAS_CLI_BUILD_DOWNLOAD_VERSION } from "./simslim-Ciluxlq4.mjs";
-import { W as inspectWatchmanMemory, n as budgetLine, r as inspectBudget } from "./budget-CMiqghig.mjs";
-import { r as resolveAndroidCompilerCache, t as readAndroidCasToolchain } from "./android-cas-PnKfAdB2.mjs";
-import { n as recordDoctorRun } from "./guide-status-CIoWK6mG.mjs";
-import { n as hasInstalledDependencies, r as installedNpmTreeIsValid, t as dependencyState } from "./dependency-state-BmsjKZ2H.mjs";
+import { n as simslimIsOnPath, r as MIN_EAS_CLI_BUILD_DOWNLOAD_VERSION } from "./simslim-B8-7AoTI.mjs";
+import { r as resolveAndroidCompilerCache, t as readAndroidCasToolchain } from "./android-cas-8U4DPqeR.mjs";
+import { r as maintenanceStatus, t as maintenanceLine } from "./status-DlKvVJBE.mjs";
+import { n as recordDoctorRun } from "./guide-status-CjEZMAD4.mjs";
+import { n as hasInstalledDependencies, r as installedNpmTreeIsValid, t as dependencyState } from "./dependency-state-B6cMXZab.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync, realpathSync, rmSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { existsSync as existsSync$1, lstatSync as lstatSync$1, mkdirSync as mkdirSync$1, readFileSync as readFileSync$1, readdirSync as readdirSync$1, realpathSync as realpathSync$1, renameSync as renameSync$1, rmSync as rmSync$1, writeFileSync as writeFileSync$1 } from "fs";
 import { homedir } from "os";
 import { dirname as dirname$1, isAbsolute as isAbsolute$1, join as join$1, relative as relative$1, resolve as resolve$1, sep as sep$1 } from "path";
 import { InvalidArgumentError } from "commander";
-import { isJsonObject, readHostedAppMetadata, readHostedSessions, readJsonObject, settingDefinition } from "@stim-cli/core/state";
+import { isJsonObject, maintenanceNdjsonFile, readHostedAppMetadata, readHostedSessions, readJsonObject, readStats, settingDefinition } from "@stim-cli/core/state";
 import chalk from "chalk";
 import * as expoFingerprint from "@expo/fingerprint";
 //#region src/diagnostics/sandbox.ts
@@ -662,6 +662,33 @@ function finding(level, title, detail, fix) {
 		fix
 	};
 }
+function checkOffloadCandidate(placements, machines, peers, now) {
+	if (machines.length || !peers.some((peer) => isJsonObject(peer) && peer.OS === "macOS" && peer.Online === true)) return null;
+	const cold = placements.filter((placement) => {
+		const age = now - Date.parse(placement.at);
+		return placement.decision === "here" && !placement.failed && (placement.buildMs ?? 0) > 0 && age >= 0 && age <= 6048e5;
+	});
+	if (cold.length < 3) return null;
+	const average = cold.reduce((total, placement) => total + placement.buildMs, 0) / cold.length;
+	if (average <= 18e4) return null;
+	return {
+		code: "offload-candidate",
+		...finding("note", "Builds could run on another Mac", `Cold builds averaged ~${Math.round(average / 6e4)} min over ${cold.length} builds this week.`, "In Stim Desktop, open Settings > Build machines > Add.")
+	};
+}
+function readOffloadCandidate(tailnetStatus, now, host) {
+	if (host !== "darwin") return null;
+	try {
+		const entries = loadConfig$1()?.offload?.machines;
+		const machines = Array.isArray(entries) ? entries.filter((entry) => typeof entry === "string") : [];
+		const placements = readStats().record?.placements ?? [];
+		if (machines.length || placements.length < 3) return null;
+		const status = tailnetStatus();
+		return checkOffloadCandidate(placements, machines, isJsonObject(status) && isJsonObject(status.Peer) ? Object.values(status.Peer) : [], now);
+	} catch {
+		return null;
+	}
+}
 function mainCheckoutProjectRoot(projectRoot) {
 	const currentRepoRoot = repoRoot(projectRoot);
 	if (!currentRepoRoot) return projectRoot;
@@ -969,7 +996,11 @@ function checkXcodeEnvLineEndings(projectRoot, platform, host) {
 	if (!content.includes("\r")) return null;
 	return finding("cost", "ios/.xcode.env has CRLF line endings", "An EAS build uploads the working-tree bytes of ios/.xcode.env, and Xcode sources that file with sh on the build worker, where each carriage return becomes part of the line and the build fails with `: command not found`. On Windows the usual cause is core.autocrlf=true rewriting the file at checkout.", "Run `git config core.autocrlf input` then `git checkout -- ios/.xcode.env`, or add `ios/.xcode.env text eol=lf` to .gitattributes and check the file out again.");
 }
-function runDoctor(projectRoot, { readFile = readFileSync$1, xcodeMajor = null, easAuth = checkEasAuth$1, concurrency = getConcurrencyLimits, liveDevices = null, activeBuilds = null, remoteEnv = process.env, lookupAgentDevice = null, lookupEasCli = null, lookupSimSlim = null, memoryPressure = readHostMemoryPressure, lookupCcache = null, lookupChrome, platform, host = process.platform } = {}) {
+function configuredRemoteBackends(projectSettings, platform) {
+	const iosTarget = remoteIosSetting(projectSettings);
+	return [.../* @__PURE__ */ new Set([...platform !== "android" ? [iosTarget?.kind === "backend" ? iosTarget.backend : null] : [], ...platform !== "ios" ? [remoteAndroidSetting(projectSettings)] : []])].filter((backend) => backend !== null);
+}
+function runDoctor(projectRoot, { readFile = readFileSync$1, xcodeMajor = null, easAuth = checkEasAuth$1, concurrency = getConcurrencyLimits, liveDevices = null, activeBuilds = null, remoteEnv = process.env, lookupAgentDevice = null, lookupEasCli = null, lookupSimSlim = null, memoryPressure = readHostMemoryPressure, lookupCcache = null, lookupChrome, tailnetStatus = realIo.status, now = Date.now, platform, host = process.platform } = {}) {
 	const localIos = platform !== "android" && host === "darwin";
 	const read = (rel) => {
 		const p = join$1(projectRoot, rel);
@@ -1045,7 +1076,7 @@ function runDoctor(projectRoot, { readFile = readFileSync$1, xcodeMajor = null,
 		profileError: simslimProfileError,
 		onPath: simslimProfile ? lookupSimSlim ? lookupSimSlim() : simslimIsOnPath() : false
 	});
-	const remoteBackends = [.../* @__PURE__ */ new Set([...platform !== "android" ? [remoteIosSetting(projectSettings)] : [], ...platform !== "ios" ? [remoteAndroidSetting(projectSettings)] : []])].filter((backend) => backend !== null);
+	const remoteBackends = configuredRemoteBackends(projectSettings, platform);
 	const daemonInEnv = Boolean(remoteEnv.AGENT_DEVICE_DAEMON_BASE_URL?.trim() && remoteEnv.AGENT_DEVICE_DAEMON_AUTH_TOKEN?.trim());
 	const agentDeviceOnPath = remoteBackends.length ? lookupAgentDevice ? lookupAgentDevice() : agentDeviceIsOnPath() : false;
 	const easCliResolvable = remoteBackends.includes("eas") ? lookupEasCli ? lookupEasCli() : Boolean(resolveEasCliBin(projectRoot)) : false;
@@ -1085,6 +1116,7 @@ function runDoctor(projectRoot, { readFile = readFileSync$1, xcodeMajor = null,
 		easFinding,
 		easBuildDownloadFinding,
 		concurrencyFinding,
+		readOffloadCandidate(tailnetStatus, now(), host),
 		memoryAdvice ? finding("cost", "Host memory pressure can stall the iOS simulator", memoryAdvice, "Free host memory, then retry. Run `stim guide lifecycle simslim` for the optional memory reduction setup.") : null,
 		simslimFinding,
 		...remoteFindings,
@@ -1338,15 +1370,15 @@ function hostedAgentDriverFinding(driver, apps) {
 	return {
 		code: "hosted-agent-driver",
 		level: "note",
-		title: `${apps === 1 ? "A hosted macOS app runs" : `${apps} hosted macOS apps run`} with no agent driver`,
-		detail: "The client's coding agent cannot drive these apps because `hosting.agentDriver` is none, so stim-server starts no driver. agent-device starts only when its daemon offers the macos-app lease, which limits a client to one app.",
-		fix: "stim settings set hosting.agentDriver agent-device, with an agent-device that offers the macos-app lease"
+		title: `${apps === 1 ? "A hosted app runs" : `${apps} hosted apps run`} with no agent driver`,
+		detail: "The client's coding agent cannot drive these apps because `hosting.agentDriver` is none, so stim-server starts no driver. agent-device confines macOS control to one macos-app lease and iOS control to one simulator through its daemon policy.",
+		fix: "stim settings set hosting.agentDriver agent-device, with agent-device 0.21.20 or later"
 	};
 }
-function runningHostedMacosApps() {
+function runningHostedApps() {
 	try {
 		return readHostedSessions().filter((session) => {
-			if (session.platform !== "macos" || session.state !== "ready" || !session.appAttempt) return false;
+			if (!["macos", "ios"].includes(session.platform) || session.state !== "ready" || !session.appAttempt) return false;
 			try {
 				return readHostedAppMetadata(session.id, session.appAttempt).state === "installed";
 			} catch {
@@ -1357,10 +1389,10 @@ function runningHostedMacosApps() {
 		return 0;
 	}
 }
-/** Notes installed hosted macOS apps on this Mac while `hosting.agentDriver` starts no driver. */
+/** Notes installed hosted macOS and iOS apps on this Mac while `hosting.agentDriver` starts no driver. */
 function inspectHostedAgentDriver() {
 	const hosting = loadConfig$1()?.hosting;
-	return hostedAgentDriverFinding(isJsonObject(hosting) ? hosting.agentDriver : void 0, runningHostedMacosApps());
+	return hostedAgentDriverFinding(isJsonObject(hosting) ? hosting.agentDriver : void 0, runningHostedApps());
 }
 //#endregion
 //#region src/commands/doctor.ts
@@ -1560,12 +1592,22 @@ function doctorCommand(program, version, inspectVersions = inspectStimVersions,
 		findings.push(...deviceHosts.findings);
 		const agentDriver = inspectHostedAgentDriver();
 		if (agentDriver) findings.push(agentDriver);
+		const maintenance = maintenanceStatus();
+		const maintenanceLines = [
+			phaseLine("maintenance.mode", maintenance.mode),
+			phaseLine("maintenance log", maintenanceNdjsonFile()),
+			phaseLine("last pass", maintenanceLine(maintenance, false) ?? "no pass has run yet")
+		];
 		if (opts.json) {
 			console.log(JSON.stringify({
 				project: root,
 				platform: opts.platform ?? null,
 				stim,
 				budget: budget.report,
+				maintenance: {
+					...maintenance,
+					logPath: maintenanceNdjsonFile()
+				},
 				buildMachines: buildMachines.machines,
 				deviceHosts: deviceHosts.machines,
 				findings
@@ -1574,7 +1616,7 @@ function doctorCommand(program, version, inspectVersions = inspectStimVersions,
 			return;
 		}
 		if (findings.length === 0) {
-			const lines = doctorSuccessLines(opts.platform, stim, budget.report);
+			const lines = [...doctorSuccessLines(opts.platform, stim, budget.report), ...maintenanceLines];
 			for (const [index, line] of lines.entries()) if (index === 1) console.log(chalk.green(line));
 			else if (line && !line.startsWith("  ")) console.log(chalk.bold(line));
 			else console.log(chalk.dim(line));
@@ -1583,7 +1625,11 @@ function doctorCommand(program, version, inspectVersions = inspectStimVersions,
 		}
 		const ordered = findings.toSorted((a, b) => a.level === b.level ? 0 : a.level === "cost" ? -1 : 1);
 		console.log(chalk.bold(`Doctor (${doctorTarget(opts.platform)})`));
-		for (const line of [...stimVersionLines(stim), ...budgetLines(budget.report)]) console.log(chalk.dim(line));
+		for (const line of [
+			...stimVersionLines(stim),
+			...budgetLines(budget.report),
+			...maintenanceLines
+		]) console.log(chalk.dim(line));
 		for (const f of ordered) {
 			const tag = f.level === "cost" ? chalk.yellow("costs time") : chalk.dim("note");
 			console.log(`\n${tag}  ${chalk.bold(f.title)}`);

package/dist/{error-diagnostics-Cb0P1WLS.mjs → error-diagnostics-B9L4Ae0x.mjs}

@@ -1,17 +1,17 @@
 import { t as getExecutor } from "./exec-CaErVv7t.mjs";
 import { R as deviceSlotKey, p as getProject, z as deviceSlotPlatforms } from "./config-D0DbpZtM.mjs";
-import { E as withDirLock, r as readWorkspaceState$1 } from "./workspace-state-CL2V2Ons.mjs";
-import { f as readWorkspaceLaunches } from "./state-CaeaHbDA.mjs";
-import { v as launchErrorPreview } from "./command-output-CliHHn7a.mjs";
-import { a as parseLease, n as fileLeaseIo, t as deviceLeasePath } from "./device-lease-W5Pi1q38.mjs";
-import { o as androidHome, u as androidToolCwd } from "./android-Db2eEMaf.mjs";
-import { l as resolveProjectMetro } from "./metro-Di8EN2Tb.mjs";
+import { v as launchErrorPreview } from "./command-output-DnJMdEY-.mjs";
+import { l as resolveProjectMetro } from "./metro-BeK1ZPz1.mjs";
+import { r as readWorkspaceState$1, w as withDirLock } from "./workspace-state-B8-aJ1_5.mjs";
+import { a as parseLease, n as fileLeaseIo, t as deviceLeasePath } from "./device-lease-D-hLqx1b.mjs";
+import { f as readWorkspaceLaunches } from "./state-DcW6vOd_.mjs";
+import { o as androidHome, u as androidToolCwd } from "./android-B_NumVyQ.mjs";
 import { r as deviceConsoleLevel } from "./ios-device-Ee7sDXfp.mjs";
-import { n as parseLogcatLine, t as androidClockOffset } from "./android-CYmq0jNi.mjs";
+import { n as parseLogcatLine, t as androidClockOffset } from "./android-r2rBL8kV.mjs";
 import { createHash, randomUUID } from "node:crypto";
 import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, resolve, sep } from "node:path";
-import { attachExpoErrorContext, readLogRecords, sortByTs } from "@stim-cli/core/state";
+import { NATIVE_CRASH_LOG_PREFIX, attachExpoErrorContext, readLogRecords, readLogTimeline } from "@stim-cli/core/state";
 import { homedir } from "node:os";
 //#region src/diagnostics/diagnostic-store.ts
 /** Publishes an immutable diagnostic snapshot atomically; existing evidence wins. */
@@ -35,7 +35,6 @@ function writeDiagnosticOnce(path, content) {
 }
 //#endregion
 //#region src/diagnostics/native-crash.ts
-const CRASH_LOG_PREFIX = "native-crash-";
 const IOS_CRASH_REPORT_RETRY = "iOS crash reports can take about a minute or longer to appear. Run `stim logs --errors` again for the native stack.";
 /** Accepts only a report for this app, simulator and launch window. */
 function parseIosCrash(text, target) {
@@ -347,7 +346,7 @@ function captureNativeCrashes(target, logsDir) {
 				record.incident ?? record.deviceTs,
 				record.rawReport
 			])).digest("hex");
-			writeDiagnosticOnce(join(logsDir, `${CRASH_LOG_PREFIX}${key}.ndjson`), `${JSON.stringify(record)}\n`);
+			writeDiagnosticOnce(join(logsDir, `${NATIVE_CRASH_LOG_PREFIX}${key}.ndjson`), `${JSON.stringify(record)}\n`);
 		} catch {}
 	}
 	return records;
@@ -358,7 +357,7 @@ function printNativeCrashReport(target, logsDir, emit, remote) {
 }
 /** Captures native crash reports for this workspace's current launches and returns the whole timeline. */
 function captureWorkspaceCrashes(root, logsDir) {
-	const timeline = readLogRecords(logsDir, (name) => !isCrashLog(name));
+	const timeline = readLogRecords(logsDir, (name) => !name.startsWith(NATIVE_CRASH_LOG_PREFIX));
 	const attempts = timeline.filter((record) => record.event === "launch_attempt");
 	const launches = readWorkspaceLaunches(root);
 	const latest = /* @__PURE__ */ new Map();
@@ -409,10 +408,7 @@ function captureWorkspaceCrashes(root, logsDir) {
 			}, logsDir);
 		} catch {}
 	}
-	return sortByTs([...timeline, ...readLogRecords(logsDir, isCrashLog)]);
-}
-function isCrashLog(name) {
-	return name.startsWith(CRASH_LOG_PREFIX);
+	return readLogTimeline(logsDir, timeline);
 }
 //#endregion
 //#region src/diagnostics/error-symbolication.ts