stim 1.25.0 → 1.26.0

package/README.md

@@ -171,7 +171,7 @@ Cache providers must settle after cancellation. If cleanup cannot finish within
 35 seconds, the plan refuses with `STIM_CLAIM_UNAVAILABLE` and retains the download
 directory; it does not delete files a broken provider may still be writing.
 
-`doctor({ platform?, record? })` and `gc({ cache?, olderThan?, worktrees? })` read their CLI
+`doctor({ platform?, record? })` and `gc({ cache?, olderThan?, worktrees?, measureBuildState? })` read their CLI
 JSON reports with a 60 second execution budget and optional `signal`. Doctor
 never repairs; its `stim.runningPath` is null. By default it does not record a
 check. Pass `record: true` to register the supported iOS/Android project and record

package/dist/{acquire-artifact-zA4S7RHE.mjs → acquire-artifact-DVsvSwf7.mjs}

@@ -1,5 +1,5 @@
 import { l as WorkspaceProcessCleanupError } from "./exec-VFRpu1iA.mjs";
-import { I as waitForSharedBuild } from "./activity-BpjwrQXU.mjs";
+import { I as waitForSharedBuild } from "./activity-Lnb_EoRY.mjs";
 import { rmSync } from "node:fs";
 //#region src/engine/artifact-lifecycle.ts
 async function runArtifactLifecycle(phases) {

package/dist/{act-BbHS3oV8.mjs → act-C-BqJEpu.mjs}

@@ -1,22 +1,22 @@
-import { l as WorkspaceProcessCleanupError, n as isTimeoutError, t as getExecutor } from "./exec-VFRpu1iA.mjs";
-import { g as workspaceStateFile$1, m as workspaceLogsDir$1 } from "./paths-DQtTgsBf.mjs";
-import { F as isOnMountedVolume, G as projectDeviceSlots, I as listMountedVolumes, L as measuredDirectorySizeAsync, N as directorySizeAsync, P as formatBytes, _ as loadConfig$1, p as getProject } from "./config-BZhXY15H.mjs";
-import { o as formatLongDuration, u as plural } from "./command-output-BBvS1H6v.mjs";
+import { b as operationState, l as WorkspaceProcessCleanupError, n as isTimeoutError, t as getExecutor } from "./exec-VFRpu1iA.mjs";
+import { j as workspaceStateFile$1, k as workspaceLogsDir$1, r as readWorkspaceState$1, u as workspaceLastUsed } from "./workspace-state-pUg3_RRA.mjs";
+import { F as isOnMountedVolume, G as projectDeviceSlots, I as listMountedVolumes, L as measuredDirectorySizeAsync, N as directorySizeAsync, P as formatBytes, _ as loadConfig$1, p as getProject } from "./config-BktkY_zC.mjs";
+import { o as formatLongDuration, u as plural } from "./command-output-BF5AR2dL.mjs";
 import { c as gitQuiet, l as gitQuietAsync, n as runOperationFileQuiet, r as childEnvironment } from "./operation-exec-CUZifp6Z.mjs";
-import { r as readWorkspaceState$1, u as workspaceLastUsed } from "./workspace-state-CPSp3mav.mjs";
-import { Bt as unpushedCommitsAsync, Ct as hasUncommittedWorkAsync, D as maintenanceKeepSetting, Dt as listWorktreesAsync, Et as listWorktrees, Gt as removeTemporaryEntryAsync, It as resolveFullRefAsync, J as resolveProjectSettings, Lt as resolveSourceCheckoutAsync, Y as resolveProjectSettingsAsync, _t as dirtyPathsAsync, xt as hasPopulatedSubmodulesAsync, zt as sourceCheckoutOf } from "./settings-B5tCoq9N.mjs";
-import { i as findProjectRoot$1 } from "./project-BiC68mIp.mjs";
-import { F as listAvdsAsync, G as ownedAvdSerialResolverAsync, P as listAvds, V as ownedAvdDirectory, yt as readParked } from "./android-Cjcj8MCw.mjs";
-import { a as unregister, n as readManifest } from "./cache-manifest-BPXRONJz.mjs";
-import { A as workspaceBuildInProgress, Cr as discoverCaches, Ct as deleteParkedSims, Dt as deviceSweepIsScoped, E as collectOwnedDeviceActivityAsync, Q as emptyCaches, St as deleteParkedAvds, T as collectOwnedDeviceActivity, br as phase, bt as collectParkedAvds, d as trimmableCaches, f as stopOwnedMetro, hr as memorySweepIsScoped, ht as waitForGradleExit, i as enforceBudget, it as planCacheEmptying, jt as findStaleProjectDevices, lt as collectGradleVersions, o as machineNumber, r as cacheLabel, u as resolveBudget, ur as collectMemoryReport, ut as deleteGradleVersion, vt as DEVICE_LIST_TIMEOUT_MS, wr as pruneCache, wt as deleteProjectDevices, xt as collectParkedSims, yr as stopIdleGradleDaemons } from "./budget-HyShrIpL.mjs";
+import { Bt as unpushedCommitsAsync, Ct as hasUncommittedWorkAsync, D as maintenanceKeepSetting, Dt as listWorktreesAsync, Et as listWorktrees, Gt as removeTemporaryEntryAsync, It as resolveFullRefAsync, J as resolveProjectSettings, Lt as resolveSourceCheckoutAsync, Y as resolveProjectSettingsAsync, _t as dirtyPathsAsync, h as deviceIdleShutdownMinutesSetting, xt as hasPopulatedSubmodulesAsync, zt as sourceCheckoutOf } from "./settings-CosW5X-S.mjs";
+import { i as findProjectRoot$1 } from "./project-BUu6Is4k.mjs";
+import { F as listAvdsAsync, G as ownedAvdSerialResolverAsync, P as listAvds, V as ownedAvdDirectory, yt as readParked } from "./android-DTAcRwBC.mjs";
+import { a as unregister, n as readManifest } from "./cache-manifest-BEZ9Bpl1.mjs";
+import { A as collectOwnedDeviceActivityAsync, Cr as stopIdleGradleDaemons, Dr as discoverCaches, Dt as deleteParkedSims, Et as deleteParkedAvds, Ft as findStaleProjectDevices, Or as pruneCache, Ot as deleteProjectDevices, P as workspaceBuildInProgress, St as DEVICE_LIST_TIMEOUT_MS, Tt as collectParkedSims, ct as planCacheEmptying, d as trimmableCaches, f as stopOwnedMetro, i as enforceBudget, jt as deviceSweepIsScoped, k as collectOwnedDeviceActivity, mr as collectMemoryReport, mt as deleteGradleVersion, nt as emptyCaches, o as machineNumber, pt as collectGradleVersions, r as cacheLabel, u as resolveBudget, wr as phase, wt as collectParkedAvds, yr as memorySweepIsScoped, yt as waitForGradleExit } from "./budget-k2mZGvvk.mjs";
 import { t as canonicalPath } from "./paths-BsJMoPP2.mjs";
-import { B as GC_OUTPUT, H as takeGcResults, a as collectWorkspaceOutputs, c as listWorkspaceDirs, d as workspaceDirRemoved, h as workspaceInUseAsync, i as collectOrphanedWorkspaces, m as workspaceInUse, o as deleteOrphanedWorkspaces, p as withIdleWorkspace, r as clearWorkspaceOutputs, s as isInsideWorkspaces } from "./workspaces-C9w4aeXF.mjs";
-import { N as listBuildLocks, b as leaseIsExpired, g as workspaceActivity, x as listLeaseFiles } from "./activity-BpjwrQXU.mjs";
-import { d as listAllIosSims, f as listAllIosSimsAsync } from "./ios-BQzvJlzw.mjs";
+import { B as GC_OUTPUT, H as takeGcResults, a as collectWorkspaceOutputs, c as listWorkspaceDirs, d as workspaceDirRemoved, h as workspaceInUseAsync, i as collectOrphanedWorkspaces, m as workspaceInUse, o as deleteOrphanedWorkspaces, p as withIdleWorkspace, r as clearWorkspaceOutputs, s as isInsideWorkspaces } from "./workspaces-g2lhdBXF.mjs";
+import { N as listBuildLocks, _ as workspaceDeviceLastUseAt, b as leaseIsExpired, g as workspaceActivity, x as listLeaseFiles } from "./activity-Lnb_EoRY.mjs";
+import { d as listAllIosSims, f as listAllIosSimsAsync } from "./ios-WxpDJ5T1.mjs";
 import { s as metroStoreRoot } from "./errors-DHm_U5gv.mjs";
 import { t as resolveMaintenanceSettings } from "./settings-Djl-mpjX.mjs";
-import { A as measurePressureAsync, D as measureDisk, E as cacheBlocked, I as lowestFree, L as protectWindowMs, N as diskPressureLevel, O as measureDiskAsync, P as levelFloors, a as matchWorktreeEntry, c as reclaimKeys, i as excludeWatchmanCookies, k as measurePressure, m as removeWorktreeTarget, o as nestedWorktrees, r as excludePodChurn, s as porcelainPath } from "./worktree-CclFIe1Z.mjs";
-import { c as FETCH_FRESH_MS, d as localDefaultBranchAsync, l as fetchDefaultBranchAsync, o as recordPullRequestLookup, p as mergeStateAsync, u as lastFetchedAtAsync } from "./warm-progress-BV3ZPmcY.mjs";
+import { i as writeIdleShutdownEvent, n as dueIdleDevices, r as shutDownIdleDevices } from "./idle-shutdown-FfxL1KdG.mjs";
+import { A as measurePressureAsync, D as measureDisk, E as cacheBlocked, I as lowestFree, L as protectWindowMs, N as diskPressureLevel, O as measureDiskAsync, P as levelFloors, a as matchWorktreeEntry, c as reclaimKeys, i as excludeWatchmanCookies, k as measurePressure, m as removeWorktreeTarget, o as nestedWorktrees, r as excludePodChurn, s as porcelainPath } from "./worktree-BKuklFh_.mjs";
+import { c as FETCH_FRESH_MS, d as localDefaultBranchAsync, l as fetchDefaultBranchAsync, o as recordPullRequestLookup, p as mergeStateAsync, u as lastFetchedAtAsync } from "./warm-progress-DvhTX_eu.mjs";
 import { n as describePullRequest, r as endedPullRequest, s as pullRequestLookups } from "./pull-request-CbNlkFok.mjs";
 import { readClaimSet } from "@stim-cli/core/ownership-claim";
 import { existsSync, lstatSync, readdirSync, realpathSync, rmSync, statSync } from "node:fs";
@@ -28,6 +28,29 @@ import { isAbsolute as isAbsolute$1, join as join$1 } from "path";
 import chalk from "chalk";
 import { existsSync as existsSync$1, readdirSync as readdirSync$1, statSync as statSync$1 } from "fs";
 import { lstat, readdir, realpath, rename, stat } from "node:fs/promises";
+//#region src/commands/gc/limited.ts
+const isCleanupFailure = (error) => error instanceof WorkspaceProcessCleanupError || error instanceof Error && "reportCleanup" in error;
+async function eachLimited(items, limit, run) {
+	const queue = items[Symbol.iterator]();
+	let failed = false;
+	const worker = async () => {
+		for (const item of queue) {
+			if (failed) return;
+			try {
+				await run(item);
+			} catch (error) {
+				failed = true;
+				throw error;
+			}
+		}
+	};
+	const errors = (await Promise.allSettled(Array.from({ length: Math.min(limit, items.length) }, worker))).flatMap((result) => result.status === "rejected" ? [result.reason] : []);
+	if (errors.length) throw errors.find(isCleanupFailure) ?? errors[0];
+}
+function readConcurrency(operation) {
+	return operationState(operation).declaring.size ? 1 : 6;
+}
+//#endregion
 //#region src/commands/gc/worktrees.ts
 const DEFAULT_WORKTREE_IDLE_DAYS = 7;
 const DIRTY_PATHS_SHOWN = 3;
@@ -448,7 +471,7 @@ async function checkMergeStates(pending, idle, grace, noOwnCommitsIdleMs, refres
 		operation?.signal.throwIfAborted();
 		const target = refresh ? await fetchDefaultBranchAsync(repo, grace.now, execution) : await localDefaultBranchAsync(repo, execution);
 		const fetch = refresh ? null : await staleFetch(repo, grace.now, freshMs, execution);
-		for (const { candidate, facts } of entries) {
+		await eachLimited(entries, readConcurrency(operation), async ({ candidate, facts }) => {
 			operation?.signal.throwIfAborted();
 			const merge = "error" in target ? {
 				merged: false,
@@ -466,7 +489,7 @@ async function checkMergeStates(pending, idle, grace, noOwnCommitsIdleMs, refres
 				skipped: verdict ? note ? `${verdict.text}; ${note}` : verdict.text : null,
 				eligibleAt: verdict?.eligibleAt ?? null
 			});
-		}
+		});
 	}
 }
 /**
@@ -496,9 +519,13 @@ async function collectWorktreeSweep({ idle, olderThan, now, graceMs, removesNoOw
 	const outside = [];
 	const candidates = await candidateRootsAsync(operation);
 	if (candidates.length) phase("worktrees", `checking ${plural(candidates.length, "project")} for merged or idle worktrees`, operation);
-	for (const root of candidates) {
+	const matched = [];
+	await eachLimited([...candidates.entries()], readConcurrency(operation), async ([index, root]) => {
 		operation?.signal.throwIfAborted();
-		const entry = matchWorktreeEntry(await listWorktreesAsync(root, read), root);
+		matched[index] = matchWorktreeEntry(await listWorktreesAsync(root, read), root);
+	});
+	for (const [index, root] of candidates.entries()) {
+		const entry = matched[index];
 		if (!entry) {
 			outside.push({
 				path: root,
@@ -517,7 +544,7 @@ async function collectWorktreeSweep({ idle, olderThan, now, graceMs, removesNoOw
 		groups.set(entry.path, [...groups.get(entry.path) ?? [], root]);
 	}
 	const inspected = [];
-	for (const [path, roots] of groups) {
+	await eachLimited([...[...groups].entries()], readConcurrency(operation), async ([index, [path, roots]]) => {
 		operation?.signal.throwIfAborted();
 		const { entries, ...source } = await resolveSourceCheckoutAsync(path, read);
 		const entry = matchWorktreeEntry(entries, path);
@@ -541,7 +568,7 @@ async function collectWorktreeSweep({ idle, olderThan, now, graceMs, removesNoOw
 			pullRequest: null,
 			activity
 		};
-		inspected.push({
+		inspected[index] = {
 			candidate: {
 				path,
 				keys,
@@ -557,8 +584,8 @@ async function collectWorktreeSweep({ idle, olderThan, now, graceMs, removesNoOw
 			facts,
 			repo: "refusal" in source ? null : source.path,
 			branch: head && entry?.branch ? entry.branch : null
-		});
-	}
+		};
+	});
 	const linked = inspected.filter(({ facts }) => facts.source === "linked");
 	for (const { candidate, facts } of linked) for (const key of candidate.keys) facts.inUse.push(...await workspaceInUseAsync(key, { managedLocks: true }, operation?.signal, operation));
 	const devices = await reportDeviceReads(linked.flatMap(({ candidate }) => candidate.keys), operation);
@@ -1213,6 +1240,44 @@ function finishedWorkspaces(sweep, now) {
 		}));
 	});
 }
+/** Each workspace's effective devices.idleShutdownMinutes, or 0 when it cannot be resolved. */
+function idleShutdownMinutes(root) {
+	try {
+		return deviceIdleShutdownMinutesSetting(resolveProjectSettings(root).settings);
+	} catch {
+		return 0;
+	}
+}
+/**
+* Plans shutting down each booted owned simulator and emulator idle for its workspace's devices.idleShutdownMinutes,
+* whether or not a supervisor runs there. The devices are shut down, never deleted.
+*/
+function planIdleShutdown({ protectedRoot, now, env = process.env }) {
+	const plan = {
+		actions: [],
+		blocked: [],
+		skips: []
+	};
+	if (deviceSweepIsScoped(env)) return plan;
+	const minutes = new Map(Object.entries(loadConfig$1()?.projects ?? {}).flatMap(([root, project]) => {
+		const value = !projectDeviceSlots(project).some(({ platforms }) => platforms.ios?.owned === true || platforms.android?.owned === true) || canonicalPath(root) === protectedRoot ? 0 : idleShutdownMinutes(root);
+		return value > 0 ? [[root, value]] : [];
+	}));
+	if (minutes.size === 0) return plan;
+	for (const { device, idleForMs } of dueIdleDevices(void 0, Math.min(...minutes.values()) * 6e4, now)) {
+		const own = minutes.get(device.project);
+		if (own === void 0 || idleForMs < own * 6e4 || now - workspaceDeviceLastUseAt(device.project) < own * 6e4) continue;
+		const root = canonicalPath(device.project);
+		plan.actions.push({
+			kind: "would-shutdown-device",
+			target: device.id,
+			workspace: root,
+			bytes: 0,
+			reason: `${device.kind === "ios" ? "simulator" : "emulator"} ${device.name} idle ${formatLongDuration(idleForMs)}, over devices.idleShutdownMinutes ${own}`
+		});
+	}
+	return plan;
+}
 //#endregion
 //#region src/maintenance/sweep.ts
 async function planSweep({ settings, sizes, protectedRoot, pinned, now, devices = true, operation }) {
@@ -1220,13 +1285,13 @@ async function planSweep({ settings, sizes, protectedRoot, pinned, now, devices
 	const skips = [];
 	const blocked = [];
 	const days = settings.olderThanDays;
-	const outputs = await collectWorkspaceOutputs({
+	const outputs = days > 0 ? await collectWorkspaceOutputs({
 		olderThan: days,
 		now,
 		measure: false,
 		signal: operation?.signal,
 		operation
-	});
+	}) : { workspaces: [] };
 	for (const entry of outputs.workspaces) {
 		const root = entry.projectRoot === null ? null : canonicalPath(entry.projectRoot);
 		if (root === null || !entry.willClear || root === protectedRoot) continue;
@@ -1249,7 +1314,7 @@ async function planSweep({ settings, sizes, protectedRoot, pinned, now, devices
 			check: "sweep"
 		});
 	}
-	for (const cache of trimmableCaches(operation?.env, operation?.cwd).filter((candidate) => !isInsideWorkspaces(candidate.dir))) actions.push({
+	for (const cache of days > 0 ? trimmableCaches(operation?.env, operation?.cwd).filter((candidate) => !isInsideWorkspaces(candidate.dir)) : []) actions.push({
 		kind: "would-trim-cache",
 		target: cacheLabel(cache),
 		dir: cache.dir,
@@ -1298,6 +1363,19 @@ async function planSweep({ settings, sizes, protectedRoot, pinned, now, devices
 		actions.push(...reaped.actions);
 		skips.push(...reaped.skips);
 	}
+	if (devices && days > 0 && !deviceSweepIsScoped(operation?.env ?? process.env)) for (const kind of ["ios", "android"]) for (const record of readParked(kind)) {
+		const parkedDays = Math.floor((now - Date.parse(record.parkedAt)) / 864e5);
+		if (!(parkedDays >= days)) continue;
+		const label = `parked ${kind === "ios" ? "simulator" : "emulator"} ${record.name}`;
+		actions.push({
+			kind: "would-delete-parked-device",
+			target: kind === "ios" ? record.udid : record.name,
+			bytes: sizes.find((size) => size.category === "owned-devices" && !size.workspace && size.name === label)?.bytes ?? 0,
+			olderThanDays: days,
+			reason: `${label} unused for ${parkedDays} days, older than ${days} days (age sweep)`,
+			check: "sweep"
+		});
+	}
 	const mounted = listMountedVolumes();
 	for (const cache of readManifest().caches) {
 		if (!isAbsolute(cache.dir) || existsSync(cache.dir) || !isOnMountedVolume(cache.dir, mounted)) continue;
@@ -1316,10 +1394,10 @@ async function planSweep({ settings, sizes, protectedRoot, pinned, now, devices
 		skips
 	};
 }
-async function planWorktrees({ protectedRoot, pinned, now, level, graceMs, sizes, protectRecentMs = 0, refresh, operation }) {
+async function planWorktrees({ protectedRoot, pinned, now, level, graceMs, sizes, protectRecentMs = 0, refresh, idleDays = null, operation }) {
 	const sweep = await collectWorktreeSweep({
-		idle: false,
-		olderThan: null,
+		idle: idleDays !== null,
+		olderThan: idleDays,
 		now,
 		removesNoOwnCommits: level === 3,
 		operation,
@@ -1346,7 +1424,7 @@ async function planWorktrees({ protectedRoot, pinned, now, level, graceMs, sizes
 			target: worktree.path,
 			bytes: 0,
 			reason: worktreeRemovalReason(worktree, sweep),
-			check: "worktree",
+			check: level === void 0 && idleDays !== null && !worktree.merge?.merged && !endedPullRequest(worktree.pullRequest) ? "sweep" : "worktree",
 			...level ? { level } : {}
 		});
 	}
@@ -2256,7 +2334,7 @@ async function planPressureLevels(level, context) {
 function triggeringRoot(operation) {
 	return canonicalPath(findProjectRoot$1(operation?.cwd ?? process.cwd()) ?? join(configDir(), "maintenance", "no-project"));
 }
-async function plannedMaintenance(pressure, recordedSizes, settings, { devices = true, sweep = false, worktrees = false, refresh = true, operation } = {}) {
+async function plannedMaintenance(pressure, recordedSizes, settings, { devices = true, sweep = false, worktrees = false, idle = false, refresh = true, operation } = {}) {
 	const env = operation?.env ?? process.env;
 	const resolved = resolveBudget({ env });
 	if (resolved.error) throw new Error(resolved.error);
@@ -2353,11 +2431,17 @@ async function plannedMaintenance(pressure, recordedSizes, settings, { devices =
 			sizes: currentSizes,
 			protectRecentMs: settings.protectRecentHours * 36e5,
 			refresh,
+			idleDays: sweep && settings.removeIdleWorktrees && settings.olderThanDays > 0 ? settings.olderThanDays : null,
 			operation
 		});
 		merge(planned);
 		result.worktreeSweep = planned.sweep;
 	}
+	if (idle && devices) merge(planIdleShutdown({
+		protectedRoot: root,
+		now: Date.now(),
+		env
+	}));
 	if (pressure) {
 		const pressured = await planPressureLevels(diskPressureLevel(lowestFree(pressure.disk), budget, settings), {
 			settings,
@@ -2405,6 +2489,7 @@ async function previewMaintenance({ devices = true, refresh = true, operation }
 			...await plannedMaintenance(pressure, state?.sizes ?? [], settings, {
 				devices,
 				sweep: true,
+				idle: true,
 				refresh,
 				operation
 			}),
@@ -2583,11 +2668,47 @@ async function removeOrphan(action) {
 	const { results } = await quietly(() => deleteOrphanedWorkspaces([orphan]));
 	return outcomeOf(results, orphan.bytes ?? 0);
 }
+async function shutDownIdleDevice(action) {
+	if (deviceSweepIsScoped()) return kept("STIM_HOME scopes this config, and devices are machine-wide");
+	const root = action.workspace ?? action.target;
+	const minutes = idleShutdownMinutes(root);
+	if (minutes === 0) return kept("devices.idleShutdownMinutes is 0 for this workspace");
+	const idleMs = minutes * 6e4;
+	const due = dueIdleDevices(root, idleMs).find(({ device }) => device.id === action.target);
+	if (!due) return kept(`it is no longer idle for ${minutes} minutes`);
+	const failures = [];
+	const skips = [];
+	const log = (event) => {
+		writeIdleShutdownEvent(root, event);
+		if (event.event === "device_idle_shutdown_failed") (event.skipped ? skips : failures).push(event.msg);
+	};
+	const run = await withIdleWorkspace(root, () => shutDownIdleDevices(root, idleMs, log, Date.now(), { only: due.device }), {
+		purpose: "automatic maintenance idle shutdown",
+		supervisor: false,
+		managedLocks: false
+	});
+	if (!run.ran) return kept(`in use: ${run.reasons.join("; ")}`);
+	if (run.value) return {
+		status: "done",
+		bytes: 0,
+		detail: action.target
+	};
+	if (failures.length) return {
+		status: "failed",
+		bytes: 0,
+		detail: failures.join("; ")
+	};
+	return kept(skips.join("; ") || `it is no longer idle for ${minutes} minutes`);
+}
 async function deleteParkedDevice(action) {
 	if (deviceSweepIsScoped()) return kept("STIM_HOME scopes this config, and devices are machine-wide");
-	const sims = (await collectParkedSims({})).filter((sim) => sim.udid === action.target);
-	const avds = sims.length ? [] : (await collectParkedAvds({})).filter((avd) => avd.name === action.target);
-	if (!sims.length && !avds.length) return kept("it is no longer parked");
+	const age = {
+		olderThanDays: action.olderThanDays ?? null,
+		now: Date.now()
+	};
+	const sims = (await collectParkedSims({}, age)).filter((sim) => sim.udid === action.target);
+	const avds = sims.length ? [] : (await collectParkedAvds({}, age)).filter((avd) => avd.name === action.target);
+	if (!sims.length && !avds.length) return kept(action.olderThanDays === void 0 ? "it is no longer parked" : `it is no longer parked, or was parked within ${action.olderThanDays} days`);
 	const before = lowestFree(measureDisk());
 	const { results } = await quietly(async () => await deleteParkedSims(sims) + await deleteParkedAvds(avds));
 	return outcomeOf(results, freedSince(before));
@@ -2799,6 +2920,7 @@ async function executeAction(action, context) {
 		case "would-unregister-cache": return unregisterCache(action);
 		case "would-delete-parked-device": return deleteParkedDevice(action);
 		case "would-delete-devices": return deleteDevices(action, context);
+		case "would-shutdown-device": return action.check === "disk" ? kept("automatic maintenance does not stop devices or dev servers for disk") : shutDownIdleDevice(action);
 		case "would-stop-workspace": return action.level === 3 ? stopWorkspace(action, context) : kept("automatic maintenance stops dev servers only at disk pressure level 3");
 		case "would-clear-build-dirs":
 		case "would-delete-dependencies": return clearArtifacts(action, context);
@@ -2813,4 +2935,4 @@ function diskRecovered(budget) {
 	return measureDisk().every((disk) => disk.freeMb >= floor);
 }
 //#endregion
-export { collectWorktreeSweep as _, previewMaintenance as a, worktreeRemovalReason as b, deleteTempLeftovers as c, ARTIFACT_DIRS as d, appRoots as f, candidateRootsAsync as g, ownedDeviceUsage as h, plannedMaintenance as i, tempLeftoverLines as l, measureOwnedDevices as m, diskRecovered as n, triggeringRoot as o, finishedWorkspaces as p, executeAction as r, collectTempLeftovers as s, deleteIdleWorkspaceDevices as t, tempLeftoverSection as u, removeWorktrees as v, worktreePullRequestNote as y };
+export { readConcurrency as S, collectWorktreeSweep as _, previewMaintenance as a, worktreeRemovalReason as b, deleteTempLeftovers as c, ARTIFACT_DIRS as d, appRoots as f, candidateRootsAsync as g, ownedDeviceUsage as h, plannedMaintenance as i, tempLeftoverLines as l, measureOwnedDevices as m, diskRecovered as n, triggeringRoot as o, finishedWorkspaces as p, executeAction as r, collectTempLeftovers as s, deleteIdleWorkspaceDevices as t, tempLeftoverSection as u, removeWorktrees as v, eachLimited as x, worktreePullRequestNote as y };

package/dist/{activity-BpjwrQXU.mjs → activity-Lnb_EoRY.mjs}

@@ -1,10 +1,9 @@
 import { D as ownership_claim_exports, S as process_identity_exports, m as declareSpawnsOn, t as getExecutor, v as stopDeclaringSpawnsOn } from "./exec-VFRpu1iA.mjs";
-import { m as workspaceLogsDir$1, v as withDirLock$1, y as withDirLockAsync$1 } from "./paths-DQtTgsBf.mjs";
-import { U as parseDeviceSlotKey, V as deviceSlotKey, d as getConfigDir, q as validateDeviceSlot } from "./config-BZhXY15H.mjs";
-import { a as formatElapsed, i as formatDuration, m as shortHash } from "./command-output-BBvS1H6v.mjs";
+import { M as withDirLock$1, N as withDirLockAsync$1, c as withWorkspaceStateLock, d as writeWorkspaceState, k as workspaceLogsDir$1, l as withWorkspaceStateLockAsync, n as clearWorkspaceStateKeys, r as readWorkspaceState$1 } from "./workspace-state-pUg3_RRA.mjs";
+import { U as parseDeviceSlotKey, V as deviceSlotKey, d as getConfigDir, q as validateDeviceSlot } from "./config-BktkY_zC.mjs";
+import { a as formatElapsed, i as formatDuration, m as shortHash } from "./command-output-BF5AR2dL.mjs";
 import { n as runOperationFileQuiet } from "./operation-exec-CUZifp6Z.mjs";
-import { c as withWorkspaceStateLock, d as writeWorkspaceState, l as withWorkspaceStateLockAsync, n as clearWorkspaceStateKeys, r as readWorkspaceState$1 } from "./workspace-state-CPSp3mav.mjs";
-import { y as resolveBuild } from "./build-cache-CKCzxzxA.mjs";
+import { S as resolveBuild } from "./build-cache-DrXNCy3T.mjs";
 import { randomBytes } from "node:crypto";
 import { closeSync, fstatSync, mkdirSync, openSync, readFileSync, readSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";

package/dist/{agent-device-usage-output-Bnkerfod.mjs → agent-device-usage-output-DbXy5tg8.mjs}

@@ -1,8 +1,8 @@
 import { S as process_identity_exports } from "./exec-VFRpu1iA.mjs";
-import { P as formatBytes } from "./config-BZhXY15H.mjs";
-import { o as formatLongDuration } from "./command-output-BBvS1H6v.mjs";
-import { F as measureDu, I as writeUsageCache, P as canonical, c as listWorkspaceDirs } from "./workspaces-C9w4aeXF.mjs";
-import { c as parseAgentDeviceRecord, o as envDir, u as processMatches } from "./activity-BpjwrQXU.mjs";
+import { P as formatBytes } from "./config-BktkY_zC.mjs";
+import { o as formatLongDuration } from "./command-output-BF5AR2dL.mjs";
+import { F as measureDu, I as writeUsageCache, P as canonical, c as listWorkspaceDirs } from "./workspaces-g2lhdBXF.mjs";
+import { c as parseAgentDeviceRecord, o as envDir, u as processMatches } from "./activity-Lnb_EoRY.mjs";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { homedir } from "node:os";
 import { isAbsolute, join, relative, sep } from "node:path";

package/dist/{android-saBeB4lr.mjs → android-B5P81yI-.mjs}

@@ -1,5 +1,5 @@
 import { t as getExecutor } from "./exec-VFRpu1iA.mjs";
-import { u as androidToolCwd } from "./android-Cjcj8MCw.mjs";
+import { u as androidToolCwd } from "./android-DTAcRwBC.mjs";
 //#region src/collector/android.ts
 const LEVEL_BY_LETTER = {
 	V: "debug",

package/dist/{android-CNZgRC-4.mjs → android-CSbLRD53.mjs}

@@ -1,6 +1,6 @@
-import { i as formatDuration, l as phaseLine, m as shortHash } from "./command-output-BBvS1H6v.mjs";
-import { E as resolveVariant, T as resolveSystemImage, _ as findAapt, b as noDeviceDiagnostic, d as androidVariantSetting, f as apkDevClientFacts, g as dumpApkManifest, h as displayPath, i as NO_FINGERPRINT, p as apkPackage, r as NO_DEVICE, s as androidDevClientScheme, u as androidSystemImageSetting, x as parseXmltree, y as isReleaseVariant } from "./support-Cxj9CmII.mjs";
-import { r as lastBuildRecord, t as androidFacts } from "./result-CR2vk2cj.mjs";
-import { i as runAndroidOperation, n as registerAndroid, r as runAndroid, t as androidCommand } from "./android-BGwuK3Mc.mjs";
-import { a as killPreviousCollector, i as collectorLogFile, o as startCollector } from "./launch-D0lPvFFu.mjs";
+import { i as formatDuration, l as phaseLine, m as shortHash } from "./command-output-BF5AR2dL.mjs";
+import { E as resolveVariant, T as resolveSystemImage, _ as findAapt, b as noDeviceDiagnostic, d as androidVariantSetting, f as apkDevClientFacts, g as dumpApkManifest, h as displayPath, i as NO_FINGERPRINT, p as apkPackage, r as NO_DEVICE, s as androidDevClientScheme, u as androidSystemImageSetting, x as parseXmltree, y as isReleaseVariant } from "./support-BGSCBoib.mjs";
+import { r as lastBuildRecord, t as androidFacts } from "./result-7F5hEwQJ.mjs";
+import { i as runAndroidOperation, n as registerAndroid, r as runAndroid, t as androidCommand } from "./android-CiNQw3kq.mjs";
+import { a as collectorLogFile, o as killPreviousCollector, s as startCollector } from "./launch-DOp8RjDz.mjs";
 export { NO_DEVICE, NO_FINGERPRINT, androidDevClientScheme, androidFacts, androidSystemImageSetting, androidVariantSetting, apkDevClientFacts, apkPackage, collectorLogFile, androidCommand as default, displayPath, dumpApkManifest, findAapt, formatDuration, isReleaseVariant, killPreviousCollector, lastBuildRecord, noDeviceDiagnostic, parseXmltree, phaseLine, registerAndroid, resolveSystemImage, resolveVariant, runAndroid, runAndroidOperation, shortHash, startCollector };

package/dist/{android-BGwuK3Mc.mjs → android-CiNQw3kq.mjs}

@@ -1,41 +1,41 @@
 import { D as ownership_claim_exports, t as getExecutor } from "./exec-VFRpu1iA.mjs";
-import { m as workspaceLogsDir$1, t as emulatorLogFile } from "./paths-DQtTgsBf.mjs";
-import { B as deviceSlotFileKey, E as upsertProject, H as deviceSlotPlatforms, O as withConfigLockAsync$1, W as parseDeviceSlotOption, p as getProject, q as validateDeviceSlot, u as getConcurrencyLimits } from "./config-BZhXY15H.mjs";
-import { _ as stepTimer, f as refuseNoProject, g as stepClock, i as formatDuration, l as phaseLine } from "./command-output-BBvS1H6v.mjs";
-import { a as recordWorkspaceUseAsync, f as writeWorkspaceStateAsync, r as readWorkspaceState$1 } from "./workspace-state-CPSp3mav.mjs";
-import { K as resolveCacheProviderConfig, M as metroPortSetting, P as metroWarmupUrlSetting, R as projectSettingsContextAsync, U as remoteEasFallbackSetting, X as resolveSettings, Y as resolveProjectSettingsAsync, a as SETTING_SHAPE_REMEDY, g as deviceReclaimIdleMinutesSetting, it as tunnelModeSetting, lt as detectProviders, z as publicUrlSetting } from "./settings-B5tCoq9N.mjs";
-import { L as workspaceDevServerMode, f as projectRegistry, i as findProjectRoot$1, l as projectShortcut, t as NO_PROJECT_REFUSAL, z as writeWorkspaceLaunchAsync } from "./project-BiC68mIp.mjs";
-import { A as listAdbDevices, I as listInstalledSystemImages, St as configuredAndroidEmulatorApp, Y as physicalDeviceModel, Z as probeEmulatorSerial, a as androidDeviceAbi, ct as waitForBoot, nt as resolveOwnedAvdSerialAsync, rt as resolvePhysicalDevice } from "./android-Cjcj8MCw.mjs";
-import { c as pidExists, d as resolveProjectMetro } from "./metro-1pJgCX4U.mjs";
+import { a as recordWorkspaceUseAsync, f as writeWorkspaceStateAsync, g as emulatorLogFile, k as workspaceLogsDir$1, r as readWorkspaceState$1 } from "./workspace-state-pUg3_RRA.mjs";
+import { B as deviceSlotFileKey, E as upsertProject, H as deviceSlotPlatforms, O as withConfigLockAsync$1, W as parseDeviceSlotOption, p as getProject, q as validateDeviceSlot, u as getConcurrencyLimits } from "./config-BktkY_zC.mjs";
+import { _ as stepTimer, f as refuseNoProject, g as stepClock, i as formatDuration, l as phaseLine } from "./command-output-BF5AR2dL.mjs";
+import { K as resolveCacheProviderConfig, M as metroPortSetting, P as metroWarmupUrlSetting, R as projectSettingsContextAsync, U as remoteEasFallbackSetting, X as resolveSettings, Y as resolveProjectSettingsAsync, a as SETTING_SHAPE_REMEDY, g as deviceReclaimIdleMinutesSetting, it as tunnelModeSetting, lt as detectProviders, z as publicUrlSetting } from "./settings-CosW5X-S.mjs";
+import { f as projectRegistry, i as findProjectRoot$1, l as projectShortcut, t as NO_PROJECT_REFUSAL, z as writeWorkspaceLaunchAsync } from "./project-BUu6Is4k.mjs";
+import { A as listAdbDevices, Dt as configuredAndroidEmulatorApp, I as listInstalledSystemImages, Y as physicalDeviceModel, Z as probeEmulatorSerial, a as androidDeviceAbi, ct as waitForBoot, nt as resolveOwnedAvdSerialAsync, rt as resolvePhysicalDevice } from "./android-DTAcRwBC.mjs";
+import { c as pidExists, d as resolveProjectMetro } from "./metro-CjC10t6E.mjs";
 import { r as createNdjsonWriter } from "./ndjson-CgE_o3Dl.mjs";
-import { Dn as launchAndroidReleaseApp, En as launchAndroidApp, G as createRunRecorder, Gt as remoteAndroidDeps, H as startBuildProgress, Ht as ensureMetroReachable, J as recordCapacityRefusal, K as readRunEstimates, Ln as exitAfterFlush, M as NO_BUILD_PROGRESS, Qn as uploadRemote, Sn as installAndroidApp, U as tapBuildLog, Un as checkEasAuth, Ut as ensureRemoteBootOwned, V as runFailureRecord, W as thrownRunFailureRecord, X as recordRunStats, Xn as resolveEasCliBin, Z as statsProjectKey$1, Zn as resolveRemote, dn as DEFAULT_METRO_PORT, on as verifyAndroidReleaseLaunch, or as ownedSessionName, qt as resolveRemoteContext, sn as verifyLaunch, t as budgetGate, un as ADB_INSTALL_TIMEOUT_MS, zn as runProcessOperation, zt as binOnPath } from "./budget-HyShrIpL.mjs";
-import { d as runCancellationSignal, f as withNativeBuildRun, r as cancelledFailure, u as runCancellation } from "./native-run-D5OJsGwA.mjs";
-import { L as acquireBuildSlot, z as releaseBuildSlot } from "./workspaces-C9w4aeXF.mjs";
-import { F as waitForBuild, M as acquireBuildLock, P as releaseBuildLock } from "./activity-BpjwrQXU.mjs";
-import { x as storedAppId } from "./build-cache-CKCzxzxA.mjs";
-import { t as CCACHE_NOT_RUN } from "./ccache-h1FKhZeg.mjs";
-import { S as setRemoteLogSink } from "./client-BQsmyp_-.mjs";
-import { a as parseBuildMachineOption, c as resolveBuildPlacement } from "./selection-D5cxEl3t.mjs";
-import { r as hostedMetroSettings } from "./metro-gateway-Bp9gJQAN.mjs";
-import { a as writeHostedAndroidAsync, i as writeDevicePlacementAsync, t as readHostedAndroid } from "./ios-state-CT9nV5SP.mjs";
-import { n as prepareHostedAndroid, t as placeHostedAndroid } from "./hosted-android-Bvb2-ZxD.mjs";
-import { n as verifyCollectorOwnership } from "./ownership-jxxz-19m.mjs";
-import { r as siblingPlatformSlots, t as launchSlotScope } from "./slot-launch-QeuJMlnJ.mjs";
-import { c as startDevServer } from "./start-YMpNwLhh.mjs";
-import { a as acquireRunLease, d as runLease, f as waitFlagConflict, o as leaseExpiryText, u as releaseLeaseOnAbort } from "./device-lease-run-ogEeJ62K.mjs";
-import { n as DeviceAdmissionRefusal, r as checkDeviceCapacity } from "./device-capacity-ZYaRALv5.mjs";
-import { a as resolveEasDevelopmentBuild, r as isEasBuildFailure } from "./eas-build-CyDKNTBP.mjs";
-import { n as ensureWorkspaceStorageSafely, r as isPhysicalDeviceRequest, t as ensureDevServer } from "./native-runtime-B9w_Qyz3.mjs";
-import { n as devicePlacementRecord } from "./placement-log-DjOXJRIH.mjs";
-import { S as pooledAndroidDevice, a as PLATFORM, b as noDeviceDiagnostic, g as dumpApkManifest, h as displayPath, o as androidBuildOptions, p as apkPackage, r as NO_DEVICE, s as androidDevClientScheme } from "./support-Cxj9CmII.mjs";
-import { t as acquireAndroidArtifact } from "./artifact-Co8zixVx.mjs";
-import { a as persistLastBuild, c as androidDeviceSelectorRefusal, i as logPostBuildFailure, n as finishAndroidUpload, o as persistThrownBuild, s as reportAndroidResult, u as resolveAndroidRunPlan } from "./result-CR2vk2cj.mjs";
-import { n as automaticDevicePlacement, r as devicePlacementLine, t as checkEasFallback } from "./eas-fallback-gaZi-dJL.mjs";
-import { a as AvdRecoveryError, i as AvdBootError, n as ensureBooted, o as warmMetro, r as ensureOwnedDevice, t as didSetUpDevice } from "./device-B9FqTBYW.mjs";
-import { t as selectFromPool } from "./device-pool-BIg8MU8l.mjs";
-import { r as finishAndroidRun } from "./launch-D0lPvFFu.mjs";
+import { An as launchAndroidApp, En as installAndroidApp, G as runFailureRecord, I as NO_BUILD_PROGRESS, J as thrownRunFailureRecord, K as startBuildProgress, Kt as ensureMetroReachable, Q as recordCapacityRefusal, Un as runProcessOperation, Ut as binOnPath, Vn as exitAfterFlush, X as readRunEstimates, Y as createRunRecorder, Yt as remoteAndroidDeps, Zt as resolveRemoteContext, dn as verifyLaunch, er as resolveEasCliBin, et as recordRunStats, hn as DEFAULT_METRO_PORT, jn as launchAndroidReleaseApp, mn as ADB_INSTALL_TIMEOUT_MS, nr as uploadRemote, q as tapBuildLog, qn as checkEasAuth, qt as ensureRemoteBootOwned, t as budgetGate, tr as resolveRemote, tt as statsProjectKey$1, un as verifyAndroidReleaseLaunch, ur as ownedSessionName } from "./budget-k2mZGvvk.mjs";
+import { d as runCancellationSignal, f as withNativeBuildRun, r as cancelledFailure, u as runCancellation } from "./native-run-BfIDFKLH.mjs";
+import { L as acquireBuildSlot, z as releaseBuildSlot } from "./workspaces-g2lhdBXF.mjs";
+import { F as waitForBuild, M as acquireBuildLock, P as releaseBuildLock } from "./activity-Lnb_EoRY.mjs";
+import { w as storedAppId } from "./build-cache-DrXNCy3T.mjs";
+import { t as CCACHE_NOT_RUN } from "./ccache-Bx5TbxwG.mjs";
+import { S as setRemoteLogSink } from "./client-D9CaRks-.mjs";
+import { a as parseBuildMachineOption, l as resolveBuildPlacement } from "./selection-BNPBZ6T5.mjs";
+import { r as hostedMetroSettings } from "./metro-gateway-B6_PgD0L.mjs";
+import { a as writeHostedAndroidAsync, i as writeDevicePlacementAsync, t as readHostedAndroid } from "./ios-state-Cw7-WQf2.mjs";
+import { n as prepareHostedAndroid, t as placeHostedAndroid } from "./hosted-android-Bk54ej6n.mjs";
+import { n as verifyCollectorOwnership } from "./ownership-BjYvMNX_.mjs";
+import { c as startDevServer } from "./start-_BdJ32cZ.mjs";
+import { a as acquireRunLease, d as runLease, f as waitFlagConflict, o as leaseExpiryText, u as releaseLeaseOnAbort } from "./device-lease-run-BmvIl7bI.mjs";
+import { n as DeviceAdmissionRefusal, r as checkDeviceCapacity } from "./device-capacity-DCSvUF0l.mjs";
+import { a as resolveEasDevelopmentBuild, r as isEasBuildFailure } from "./eas-build-Dsj93iM9.mjs";
+import { t as followHostedLaunchLogs } from "./hosted-logs-sync-B0pvmOk-.mjs";
+import { f as settleFingerprintCheck } from "./prebuild-gmouvmJZ.mjs";
+import { n as ensureWorkspaceStorageSafely, r as isPhysicalDeviceRequest, t as ensureDevServer } from "./native-runtime-Dq3RBcON.mjs";
+import { n as devicePlacementRecord } from "./placement-log-DIFPQAXp.mjs";
+import { S as pooledAndroidDevice, a as PLATFORM, b as noDeviceDiagnostic, g as dumpApkManifest, h as displayPath, o as androidBuildOptions, p as apkPackage, r as NO_DEVICE, s as androidDevClientScheme } from "./support-BGSCBoib.mjs";
+import { t as acquireAndroidArtifact } from "./artifact-BxREhAaV.mjs";
+import { a as persistLastBuild, c as androidDeviceSelectorRefusal, i as logPostBuildFailure, n as finishAndroidUpload, o as persistThrownBuild, s as reportAndroidResult, u as resolveAndroidRunPlan } from "./result-7F5hEwQJ.mjs";
+import { n as automaticDevicePlacement, r as devicePlacementLine, t as checkEasFallback } from "./eas-fallback-FwkeqqGi.mjs";
+import { i as verifyAndroidMetroRun, r as finishAndroidRun } from "./launch-DOp8RjDz.mjs";
+import { a as AvdRecoveryError, i as AvdBootError, n as ensureBooted, o as warmMetro, r as ensureOwnedDevice, t as didSetUpDevice } from "./device-BK-zwyd_.mjs";
+import { t as selectFromPool } from "./device-pool-Dluix4H3.mjs";
 import { t as unsupportedPlan } from "./project-plan-BPwbLwQu.mjs";
-import { a as refusePlan, i as printPlan, n as planFlagRefusal } from "./build-plan-zCuHGlA8.mjs";
+import { a as refusePlan, i as printPlan, n as planFlagRefusal } from "./build-plan-DrMMdayj.mjs";
 import { basename, join } from "node:path";
 import { workspaceId } from "@stim-cli/core";
 import { hostedAndroidStatus, parseMachine } from "@stim-cli/core/state";
@@ -182,9 +182,10 @@ async function selectAndroidPlacement({ target: selected, automatic = automaticD
 }
 //#endregion
 //#region src/commands/android/hosted.ts
-async function finishHostedAndroidRun({ target, artifact, root, slot = "default", release, appMode = release ? "release" : "development", isExpo, metroPort, logsDir, selectors, place, writePlacement, verifyLaunch: verify, writeLaunch, readApkPackage, resolveDevClientScheme, now, started, startedAt, fail, phase, enterPhase, out, recordBuild, ...report }) {
+async function finishHostedAndroidRun({ target, artifact, root, slot = "default", release, appMode = release ? "release" : "development", isExpo, metroPort, logsDir, selectors, place, writePlacement, verifyLaunch: verify, followLogs, writeLaunch, readApkPackage, resolveDevClientScheme, now, started, startedAt, fail, phase, enterPhase, enterActivity, out, recordBuild, ...report }) {
 	const packageName = artifact.androidPackage ?? await readApkPackage(artifact.apkPath);
 	if (!artifact.apkPath || !packageName) return fail("STIM_INSTALL_FAILED", "The built APK has no package identity.");
+	const devClientScheme = appMode === "development" && isExpo ? await resolveDevClientScheme(root, artifact.apkPath) ?? void 0 : void 0;
 	const launchedAt = now();
 	try {
 		const run = await place(target, {
@@ -197,7 +198,7 @@ async function finishHostedAndroidRun({ target, artifact, root, slot = "default"
 			...appMode === "process" ? { mode: appMode } : {},
 			metroPort,
 			selectors,
-			...appMode === "development" && isExpo ? { devClientScheme: await resolveDevClientScheme(root, artifact.apkPath) ?? void 0 } : {},
+			...appMode === "development" && isExpo ? { devClientScheme } : {},
 			reserved: (placement) => writePlacement(root, slot, placement),
 			note: out,
 			enterPhase
@@ -212,19 +213,37 @@ async function finishHostedAndroidRun({ target, artifact, root, slot = "default"
 			launchedAt: new Date(launchedAt).toISOString()
 		}, slot);
 		let launched = run.launched;
+		let launchWarning;
 		if (appMode === "development") {
-			const evidence = await verify({
-				requireBundleResponse: true,
-				platform: "android",
-				logsDir: logsDir ?? void 0,
-				since: launchedAt,
-				metroPort,
-				mode: workspaceDevServerMode(root, isExpo),
-				slot: launchSlotScope(root, slot),
-				platformShared: (await siblingPlatformSlots(root, "android", slot)).length > 0
-			});
-			if (evidence.fatal) return fail("STIM_LAUNCH_FAILED", "Metro could not deliver the hosted app bundle.", "Run stim logs --errors and fix the bundle error.");
-			launched = evidence.verified ? true : evidence.requested ? "bundling" : "unverified";
+			const hostedLogs = followLogs(root, slot, "android", launchedAt);
+			let verification;
+			try {
+				verification = await verifyAndroidMetroRun({
+					root,
+					slot,
+					remoteDevice: false,
+					verifyLaunched: verify,
+					serial: run.placement.device?.serial ?? "",
+					androidPackage: packageName,
+					metroCheck: report.metroCheck,
+					logsDir: logsDir ?? "",
+					launchedAt,
+					metroPort,
+					isExpo,
+					physical: false,
+					device: {},
+					scheme: devClientScheme,
+					phase,
+					enterActivity,
+					hostedLogs,
+					hostedRunCommand: `stim android --remote ${run.placement.selected}${slot === "default" ? "" : ` --slot ${slot}`}`
+				});
+			} finally {
+				hostedLogs.stop();
+			}
+			if (verification.state === "fatal") return fail("STIM_LAUNCH_FAILED", "The app failed its launch readiness check.", `Read the launch error above or run \`stim logs --errors\`. The full timeline is in ${logsDir}.`, { lastBuildStatus: true });
+			launched = verification.state === true ? true : verification.state === "bundling" ? "bundling" : "unverified";
+			launchWarning = verification.warning;
 		}
 		if (launched === "unverified") out(`Launch on ${target.host.machine} is unverified; check the hosted app, then retry stim android --remote ${target.host.machine}.`);
 		const host = hostedAndroidStatus(run.placement);
@@ -241,6 +260,7 @@ async function finishHostedAndroidRun({ target, artifact, root, slot = "default"
 		});
 		await finishAndroidUpload(artifact.uploadPending, artifact.remote, phase);
 		await artifact.providerUpload;
+		await settleFingerprintCheck(artifact.fingerprintCheck, "android", (line) => phase("fingerprint", chalk.yellow(line)), (entry) => report.writer.write(entry));
 		return {
 			ok: true,
 			facts: reportAndroidResult({
@@ -261,6 +281,7 @@ async function finishHostedAndroidRun({ target, artifact, root, slot = "default"
 				remote: artifact.remote,
 				providerName: artifact.providerName,
 				launchState: launched,
+				launchWarning,
 				launched: {},
 				ccache: artifact.ccache,
 				durationMs: now() - started
@@ -1145,6 +1166,7 @@ async function runAndroid(options = {}) {
 			place: options.placeHostedAndroid ?? placeHostedAndroid,
 			writePlacement: options.writeHostedAndroid ?? writeHostedAndroidAsync,
 			verifyLaunch: verifyLaunched,
+			followLogs: options.followHostedLaunchLogs ?? followHostedLaunchLogs,
 			writeLaunch,
 			readApkPackage,
 			resolveDevClientScheme,
@@ -1155,6 +1177,7 @@ async function runAndroid(options = {}) {
 			fail,
 			phase,
 			enterPhase: progress.step,
+			enterActivity: progress.activity,
 			out,
 			json,
 			useBuildCache,
@@ -1263,6 +1286,7 @@ async function runAndroid(options = {}) {
 				waitedForBuild: artifact.waitedForBuild,
 				ccache: ccacheActivity,
 				uploadPending: artifact.uploadPending,
+				fingerprintCheck: artifact.fingerprintCheck,
 				providerUpload: artifact.providerUpload,
 				providerName: artifact.providerName,
 				remote: artifact.remote,