stim 1.9.0 → 1.10.0

package/dist/{guide-status-BAMVU0ZA.mjs → stim-installations-CINXy_su.mjs}

@@ -1,7 +1,5 @@
-import { f as getProject, u as getConfigDir, w as upsertProject } from "./config-Cp9lM3wX.mjs";
-import { t as getExecutor } from "./exec-jIAlgilk.mjs";
-import { n as appProjectProblem } from "./project-DS112DYB.mjs";
-import { accessSync, constants, mkdirSync, readFileSync, realpathSync, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { t as getExecutor } from "./exec-DK8KaVHK.mjs";
+import { accessSync, constants, realpathSync, statSync } from "node:fs";
 import { delimiter, join, resolve } from "node:path";
 //#region src/diagnostics/stim-installations.ts
 const VERSION_OUTPUT_LIMIT = 4096;
@@ -151,123 +149,4 @@ async function inspectStimVersions(runningVersion, { pathValue = process.env.PAT
 	return analyzeStimVersions(runningVersion, canonicalPath(runningPath), installations);
 }
 //#endregion
-//#region src/guide-status.ts
-const DAY_MS = 864e5;
-const DOCTOR_STALE_MS = 7 * DAY_MS;
-const UPDATE_CHECK_INTERVAL_MS = DAY_MS;
-const UPDATE_CHECK_TIMEOUT_MS = 2e3;
-const LATEST_URL = "https://registry.npmjs.org/stim/latest";
-const PLATFORMS = ["ios", "android"];
-function recordDoctorRun(projectRoot, platform, version, now = /* @__PURE__ */ new Date()) {
-	const run = {
-		at: now.toISOString(),
-		version
-	};
-	try {
-		if (appProjectProblem(projectRoot)) return;
-		upsertProject(projectRoot, (existing) => {
-			const doctorRuns = { ...existing.doctorRuns };
-			for (const target of platform ? [platform] : PLATFORMS) doctorRuns[target] = run;
-			return { doctorRuns };
-		});
-	} catch {}
-}
-function doctorDueReason(record, running, now) {
-	const at = record ? Date.parse(record.at) : NaN;
-	if (!record || Number.isNaN(at)) return "never run";
-	if (record.version !== running) return `last run with stim ${record.version}`;
-	const age = now.getTime() - at;
-	if (age > DOCTOR_STALE_MS) return `last run ${Math.floor(age / DAY_MS)} days ago`;
-	return null;
-}
-function updateCacheFile() {
-	return join(getConfigDir(), "update-check.json");
-}
-function readUpdateCache() {
-	try {
-		const parsed = JSON.parse(readFileSync(updateCacheFile(), "utf-8"));
-		if (typeof parsed?.checkedAt !== "string") return null;
-		return {
-			checkedAt: parsed.checkedAt,
-			latest: typeof parsed.latest === "string" ? parsed.latest : null
-		};
-	} catch {
-		return null;
-	}
-}
-function writeUpdateCache(cache) {
-	const target = updateCacheFile();
-	const tmp = `${target}.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`;
-	try {
-		mkdirSync(getConfigDir(), { recursive: true });
-		writeFileSync(tmp, `${JSON.stringify(cache)}\n`);
-		renameSync(tmp, target);
-	} catch {
-		try {
-			unlinkSync(tmp);
-		} catch {}
-	}
-}
-async function fetchLatest(fetchImpl) {
-	const res = await fetchImpl(LATEST_URL, { signal: AbortSignal.timeout(UPDATE_CHECK_TIMEOUT_MS) });
-	if (!res.ok) return null;
-	const body = await res.json();
-	return typeof body.version === "string" ? body.version : null;
-}
-async function checkForUpdate(running, { now = /* @__PURE__ */ new Date(), fetch: fetchImpl = fetch } = {}) {
-	if (process.env.STIM_NO_UPDATE_CHECK) return null;
-	const cached = readUpdateCache();
-	const checkedAt = cached ? Date.parse(cached.checkedAt) : NaN;
-	let latest = cached?.latest ?? null;
-	if (Number.isNaN(checkedAt) || now.getTime() - checkedAt > UPDATE_CHECK_INTERVAL_MS) {
-		try {
-			latest = await fetchLatest(fetchImpl);
-		} catch {
-			latest = null;
-		}
-		writeUpdateCache({
-			checkedAt: now.toISOString(),
-			latest
-		});
-	}
-	if (!latest) return null;
-	const comparison = compareStimVersions(latest, running);
-	return comparison !== null && comparison > 0 ? latest : null;
-}
-function renderGuideStatus({ running, doctor, latest }) {
-	const lines = [];
-	if (doctor.length) {
-		const named = doctor.map((due) => `${due.platform} (${due.reason})`).join(" and ");
-		const command = doctor.length === 1 ? `stim doctor --platform ${doctor[0]?.platform}` : "stim doctor";
-		lines.push(`  Doctor is due for ${named}.`, `  Run before native work:  ${command}`);
-	}
-	if (latest) lines.push(`  stim ${latest} is available (running ${running}):  npm install -g stim@latest`);
-	if (!lines.length) return null;
-	return ["STATUS", ...lines].join("\n");
-}
-async function guideStatus({ projectRoot, running, now = /* @__PURE__ */ new Date(), fetch: fetchImpl = fetch }) {
-	const doctor = [];
-	if (projectRoot && !appProjectProblem(projectRoot)) {
-		let runs = null;
-		try {
-			runs = getProject(projectRoot)?.doctorRuns ?? {};
-		} catch {}
-		if (runs) for (const platform of PLATFORMS) {
-			const reason = doctorDueReason(runs[platform], running, now);
-			if (reason) doctor.push({
-				platform,
-				reason
-			});
-		}
-	}
-	return renderGuideStatus({
-		running,
-		doctor,
-		latest: await checkForUpdate(running, {
-			now,
-			fetch: fetchImpl
-		})
-	});
-}
-//#endregion
-export { inspectStimVersions as i, recordDoctorRun as n, compareStimVersions as r, guideStatus as t };
+export { inspectStimVersions as n, compareStimVersions as t };

package/dist/{stop-BO28HGqF.mjs → stop-Dj4pfmyv.mjs}

@@ -1,15 +1,13 @@
-import { D as process_identity_exports, G as parseDeviceSlotOption, J as validateDeviceSlot, K as projectDeviceSlots, T as withConfigLock, U as deviceSlotPlatforms, W as parseDeviceSlotKey, a as clearSupervisor, f as getProject, w as upsertProject } from "./config-Cp9lM3wX.mjs";
-import { _ as workspaceDir, c as writeWorkspaceState, n as clearWorkspaceStateKeys, o as withWorkspaceStateLock, r as readWorkspaceState } from "./workspace-state-DF2gCFhx.mjs";
-import { o as findProjectRoot } from "./project-DS112DYB.mjs";
-import { a as clearRemoteSession, i as clearManagedMetroTunnel, l as readRemoteSession, o as clearWorkspaceSupervisor, s as readMetroTunnel } from "./state-NcJzMEBF.mjs";
-import { a as pidExists, c as resolveProjectMetro, l as signalProcessTree, n as killMetroTree } from "./metro-DrLHaMn2.mjs";
-import { n as verifyCollectorOwnership } from "./ownership-D15Op8vN.mjs";
-import { f as refuseNoProject, l as phaseLine, p as releasedLeaseFact, u as plural } from "./command-output-gByVmIjy.mjs";
-import { b as resolveEasCliBin } from "./sim-pool-KaIsp2Ft.mjs";
-import { t as withWorkspaceProcessLock } from "./workspace-process-lock-DWaiRD0e.mjs";
-import { l as releaseWorkspaceLeases } from "./device-lease-Crs-HkJY.mjs";
-import { E as teardownOwnedIosSim, T as teardownOwnedAvd, i as endRecordedSession } from "./device-remote-AQ5rQPqr.mjs";
-import { i as stopTunnel, t as resolveSupervisorTarget } from "./ownership-DCQPuWEc.mjs";
+import { B as parseDeviceSlotKey, D as process_identity_exports, H as projectDeviceSlots, T as withConfigLock, V as parseDeviceSlotOption, W as validateDeviceSlot, a as clearSupervisor, f as getProject, w as upsertProject, z as deviceSlotPlatforms } from "./config-BEq0Qw_a.mjs";
+import { O as workspaceDir, _ as withWorkspaceStateLock, c as signalProcessTree, i as pidExists, m as readWorkspaceState, p as clearWorkspaceStateKeys, s as resolveProjectMetro, t as killMetroTree, y as writeWorkspaceState } from "./metro-BWLOJ_Wr.mjs";
+import { o as findProjectRoot } from "./project-BXZzOABt.mjs";
+import { a as clearRemoteSession, i as clearManagedMetroTunnel, l as readRemoteSession, o as clearWorkspaceSupervisor, s as readMetroTunnel } from "./state-WGdIbi_d.mjs";
+import { t as withWorkspaceProcessLock } from "./workspace-process-lock-BXA96myD.mjs";
+import { f as refuseNoProject, l as phaseLine, p as releasedLeaseFact, u as plural } from "./command-output-D5z2_bcF.mjs";
+import { u as releaseWorkspaceLeases } from "./device-lease-CbEaIk7b.mjs";
+import { d as teardownOwnedAvd, f as teardownOwnedIosSim, i as stopTunnel, t as resolveSupervisorTarget } from "./ownership-DZjdx8Gq.mjs";
+import { n as verifyCollectorOwnership } from "./ownership-D2xbLVoz.mjs";
+import { i as endRecordedSession, z as resolveEasCliBin } from "./device-remote-Dy1jGj3U.mjs";
 import chalk from "chalk";
 //#region src/commands/stop.ts
 const DEFAULT_WAIT_MS = 1e4;
@@ -597,7 +595,7 @@ function shutDownDevices(project, { teardownIos, teardownAvd, report }) {
 			} else device[iosKey] = reportDevice(iosUdid, teardownIos(iosUdid, {
 				del: false,
 				label: iosName
-			}), report);
+			}), report, "ios");
 		}
 		const android = platforms.android;
 		if (android?.avdName) {
@@ -609,12 +607,15 @@ function shutDownDevices(project, { teardownIos, teardownAvd, report }) {
 					reason: "Stim does not own this device"
 				};
 				report(chalk.dim(phaseLine("device", `${android.avdName} is not Stim-owned, leaving it running`)));
-			} else device[androidKey] = reportDevice(android.avdName, teardownAvd(android.avdName, { del: false }), report);
+			} else device[androidKey] = reportDevice(android.avdName, teardownAvd(android.avdName, { del: false }), report, "android");
 		}
 	}
 	return device;
 }
-function reportDevice(label, r, report) {
+function deviceShutdownRemedy(kind, label) {
+	return kind === "ios" ? `check it with \`xcrun simctl list devices\`, then \`xcrun simctl shutdown ${label}\` yourself -- if it will not respond, \`stim gc --delete\` reclaims it` : `check it with \`adb devices\`, then \`adb -s <serial> emu kill\` yourself -- if it will not respond, \`stim gc --delete\` reclaims it`;
+}
+function reportDevice(label, r, report, kind) {
 	if (r.status === "torn-down") {
 		report(chalk.green(phaseLine("device", `shut down ${r.label ?? label}`)));
 		return {
@@ -639,11 +640,14 @@ function reportDevice(label, r, report) {
 			reason
 		};
 	}
-	report(chalk.red(phaseLine("device", `failed to shut down ${label}: ${r.reason}`)));
+	const remedy = deviceShutdownRemedy(kind, r.label ?? label);
+	report(chalk.red(phaseLine("device", `failed to shut down ${r.label ?? label}: ${r.reason}`)));
+	report(chalk.dim(phaseLine("", remedy)));
 	return {
 		status: "failed",
-		label,
-		reason: r.reason
+		label: r.label ?? label,
+		reason: r.reason,
+		remedy
 	};
 }
 function summarize(root, outcomes, ok) {

package/dist/{stop-T1R-cZRz.mjs → stop-ZvOeTmKb.mjs}

@@ -1,3 +1,3 @@
-import { t as resolveSupervisorTarget } from "./ownership-DCQPuWEc.mjs";
-import { a as resolveCollectorTargets, i as readSupervisorState, n as clearSupervisorState, o as runStop, r as readCollectorState, s as stopCommand, t as clearCollectorState } from "./stop-BO28HGqF.mjs";
+import { t as resolveSupervisorTarget } from "./ownership-DZjdx8Gq.mjs";
+import { a as resolveCollectorTargets, i as readSupervisorState, n as clearSupervisorState, o as runStop, r as readCollectorState, s as stopCommand, t as clearCollectorState } from "./stop-Dj4pfmyv.mjs";
 export { clearCollectorState, clearSupervisorState, stopCommand as default, readCollectorState, readSupervisorState, resolveCollectorTargets, resolveSupervisorTarget, runStop };

package/dist/supervisor-run.d.mts

@@ -1,4 +1,10 @@
-import { t as NdjsonWriter } from "./ndjson-DvHSsNU9.mjs";
+import { t as NdjsonWriter } from "./ndjson-Du3j0AQ9.mjs";
+import "@stim-cli/core/state";
+//#region src/supervisor/idle-stop.d.ts
+interface IdleProbe {
+  lastActivityAt(): number;
+  blocker(): string | null;
+}
 import * as import__stim_cli_core_process_identity from "@stim-cli/core/process-identity";
 //#endregion
 //#region src/supervisor/state.d.ts
@@ -15,6 +21,7 @@ interface ParsedSupervisorArgs {
   port?: number;
   tunnel?: boolean;
   resetCache?: boolean;
+  idleStopMinutes?: number;
   error?: string;
 }
 declare function parseArgs(argv: string[]): ParsedSupervisorArgs;
@@ -43,6 +50,8 @@ interface RunSupervisorOptions {
   port: number;
   tunnel?: boolean;
   resetCache?: boolean;
+  idleStopMinutes?: number;
+  idleProbe?: IdleProbe;
   isExpo?: (projectRoot: string) => boolean;
   startBare?: ServerStarter | null;
   startExpo?: ServerStarter | null;
@@ -51,7 +60,7 @@ interface RunSupervisorOptions {
   attachSignals?: boolean;
   stderr?: (line: string) => void;
 }
-declare function runSupervisor({ root, port, tunnel, resetCache, isExpo, startBare, startExpo, now, onExit, attachSignals, stderr }: RunSupervisorOptions): Promise<{
+declare function runSupervisor({ root, port, tunnel, resetCache, idleStopMinutes, idleProbe, isExpo, startBare, startExpo, now, onExit, attachSignals, stderr }: RunSupervisorOptions): Promise<{
   mode: string;
   server: ServerHandle | undefined;
   shutdown: (code: number, event: string, msg: string) => Promise<void>;

package/dist/supervisor-run.mjs

@@ -1,20 +1,139 @@
-import { C as setSupervisor, D as process_identity_exports, a as clearSupervisor } from "./config-Cp9lM3wX.mjs";
-import { r as createNdjsonWriter } from "./ndjson-9uFNRwfe.mjs";
-import { b as workspaceLogsDir, c as writeWorkspaceState, o as withWorkspaceStateLock, r as readWorkspaceState } from "./workspace-state-DF2gCFhx.mjs";
-import { a as detectIsExpo } from "./project-DS112DYB.mjs";
+import { B as parseDeviceSlotKey, C as setSupervisor, D as process_identity_exports, H as projectDeviceSlots, a as clearSupervisor, f as getProject } from "./config-BEq0Qw_a.mjs";
+import { r as createNdjsonWriter } from "./ndjson-CDY9IkVC.mjs";
+import { _ as withWorkspaceStateLock, j as workspaceLogsDir, m as readWorkspaceState$1, p as clearWorkspaceStateKeys, y as writeWorkspaceState } from "./metro-BWLOJ_Wr.mjs";
+import { a as detectIsExpo } from "./project-BXZzOABt.mjs";
 import { t as describeError } from "./errors-B6W7FkxQ.mjs";
-import { t as relaunchWithLogFile } from "./detached-entry-KEu0_AXL.mjs";
-import { c as readPidFile, f as writePidFile, n as MODE_EXPO, o as clearWorkspaceSupervisor, r as clearExpoMetroTunnel, t as MODE_BARE } from "./state-NcJzMEBF.mjs";
-import { existsSync, realpathSync } from "node:fs";
+import { t as relaunchWithLogFile } from "./detached-entry-DJHoca49.mjs";
+import { c as readPidFile, f as writePidFile, n as MODE_EXPO, o as clearWorkspaceSupervisor, r as clearExpoMetroTunnel, t as MODE_BARE } from "./state-WGdIbi_d.mjs";
+import { t as withWorkspaceProcessLock } from "./workspace-process-lock-BXA96myD.mjs";
+import { a as parseLease, r as leaseIsExpired, s as parseWorkspaceLeases, t as deviceLeasePath } from "./device-lease-CbEaIk7b.mjs";
+import { c as createActivityReader } from "./build-progress-BXx-ZBe4.mjs";
+import { N as ownedAvdSerialResolver } from "./android-787HhP5w.mjs";
+import { s as workspaceBuildInProgress } from "./idle-DpRLp5lj.mjs";
+import { n as withIdleWorkspace } from "./in-use-CjUluqIX.mjs";
+import { existsSync, readFileSync, realpathSync, statSync } from "node:fs";
 import { LOG_ROTATE_BYTES } from "@stim-cli/core";
-import { isAbsolute, join, resolve } from "node:path";
+import { IDLE_STOP_KEY } from "@stim-cli/core/state";
+import { dirname, isAbsolute, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
+//#region src/supervisor/idle-stop.ts
+const IDLE_CHECK_MS = 6e4;
+const MINUTE_MS = 6e4;
+function trackDevServerActivity(now) {
+	let last = now();
+	const open = /* @__PURE__ */ new Set();
+	return {
+		record(entry) {
+			const { event, requestId } = entry ?? {};
+			if (event === "bundle_response_started") {
+				if (typeof requestId === "string") open.add(requestId);
+			} else if (event === "bundle_response_finished" || event === "bundle_response_failed") {
+				if (typeof requestId === "string") open.delete(requestId);
+			} else if (event !== "expo_stdout") return;
+			last = now();
+		},
+		lastActivityAt: () => open.size > 0 ? now() : last
+	};
+}
+function deviceTargets(root) {
+	const serialOf = ownedAvdSerialResolver({ timeoutMs: 5e3 });
+	return projectDeviceSlots(getProject(root)).flatMap(({ slot, platforms }) => {
+		const targets = [];
+		if (platforms.ios?.deviceUdid) targets.push({
+			platform: "ios",
+			id: platforms.ios.deviceUdid,
+			slot
+		});
+		const android = platforms.android;
+		const serial = android?.avdName ? serialOf(android.avdName).serial : android?.serial;
+		if (serial) targets.push({
+			platform: "android",
+			id: serial,
+			slot
+		});
+		return targets;
+	});
+}
+function heldDeviceLease(root, now) {
+	for (const [key, record] of Object.entries(parseWorkspaceLeases(readWorkspaceState$1(root)?.deviceLeases))) {
+		const platform = parseDeviceSlotKey(key)?.platform;
+		if (!platform) continue;
+		let raw;
+		try {
+			raw = readFileSync(deviceLeasePath(platform, record.id), "utf8");
+		} catch (error) {
+			if (error.code === "ENOENT") continue;
+			return `${platform} device ${record.id} has a lease that cannot be read (${describeError(error)})`;
+		}
+		const lease = parseLease(raw);
+		if (!lease) return `${platform} device ${record.id} has a lease that cannot be read`;
+		if (lease.token !== record.token || leaseIsExpired(lease, now)) continue;
+		const by = record.kind === "declared" ? "stim device lock" : "a stim ios or android run";
+		return `${platform} device ${record.id} is leased by ${by} until ${lease.expiresAt}`;
+	}
+	return null;
+}
+function workspaceIdleProbe(root, { platform = process.platform } = {}) {
+	return {
+		lastActivityAt() {
+			const used = Date.parse(String(readWorkspaceState$1(root)?.lastUsedAt ?? ""));
+			let clientLog = NaN;
+			try {
+				clientLog = statSync(join(workspaceLogsDir(root), "client.ndjson")).mtimeMs;
+			} catch {}
+			const times = [used, clientLog].filter(Number.isFinite);
+			return times.length ? Math.max(...times) : NaN;
+		},
+		blocker() {
+			if (workspaceBuildInProgress(root)) return "a build is in progress";
+			const lease = heldDeviceLease(root, Date.now());
+			if (lease) return lease;
+			const readActivity = createActivityReader();
+			for (const target of deviceTargets(root)) {
+				const activity = readActivity({
+					...target,
+					workspace: root
+				});
+				if (activity.state === "driven") return `${target.platform} device ${target.id} is driven by ${activity.driver?.tool ?? "an unknown tool"}`;
+				const unknown = platform === "win32" ? activity.basis.filter((basis) => basis !== "driver-process") : activity.basis;
+				if (activity.state === "unknown" && unknown.length > 0) return `${target.platform} device ${target.id} has unknown activity (${unknown.join(", ")})`;
+			}
+			return null;
+		}
+	};
+}
+function watchIdleDevServer({ idleStopMs, now, serverActivityAt, probe, onIdle, checkMs = IDLE_CHECK_MS }) {
+	const idleMinutes = () => {
+		const last = Math.max(serverActivityAt(), ...[probe.lastActivityAt()].filter(Number.isFinite));
+		if (now() - last < idleStopMs) return null;
+		let blocker;
+		try {
+			blocker = probe.blocker();
+		} catch (error) {
+			blocker = describeError(error);
+		}
+		return blocker ? null : Math.floor((now() - last) / MINUTE_MS);
+	};
+	let deciding = false;
+	const timer = setInterval(() => {
+		if (deciding || idleMinutes() === null) return;
+		deciding = true;
+		onIdle(idleMinutes).finally(() => {
+			deciding = false;
+		});
+	}, Math.min(checkMs, idleStopMs));
+	timer.unref?.();
+	return () => clearInterval(timer);
+}
+//#endregion
 //#region src/supervisor/run.ts
+const USAGE = "Usage: run.js --root <path> --port <n> [--tunnel] [--reset-cache] [--idle-stop-minutes <n>]";
 function parseArgs(argv) {
 	let root;
 	let port;
 	let tunnel = false;
 	let resetCache = false;
+	let idleStopMinutes = "0";
 	for (let i = 0; i < argv.length; i++) {
 		const arg = argv[i];
 		if (arg === "--root") {
@@ -33,20 +152,26 @@ function parseArgs(argv) {
 			resetCache = true;
 			continue;
 		}
-		return { error: `Unknown supervisor argument "${arg}". Usage: run.js --root <path> --port <n> [--tunnel] [--reset-cache]` };
+		if (arg === "--idle-stop-minutes") {
+			idleStopMinutes = argv[++i] ?? "";
+			continue;
+		}
+		return { error: `Unknown supervisor argument "${arg}". ${USAGE}` };
 	}
-	if (!root) return { error: "Missing --root. Usage: run.js --root <path> --port <n> [--tunnel] [--reset-cache]" };
+	if (!root) return { error: `Missing --root. ${USAGE}` };
 	if (!isAbsolute(root)) return { error: `--root must be an absolute path, got "${root}".` };
 	const parsedPort = Number(port);
 	if (!Number.isInteger(parsedPort) || parsedPort <= 0 || parsedPort > 65535) return { error: `--port must be a TCP port number, got "${port}".` };
+	if (!/^\d+$/.test(idleStopMinutes)) return { error: `--idle-stop-minutes must be a whole number of minutes, got "${idleStopMinutes}".` };
 	return {
 		root: resolve(root),
 		port: parsedPort,
 		tunnel,
-		resetCache
+		resetCache,
+		idleStopMinutes: Number(idleStopMinutes)
 	};
 }
-async function runSupervisor({ root, port, tunnel = false, resetCache = false, isExpo = detectIsExpo, startBare = null, startExpo = null, now = Date.now, onExit = (code) => process.exit(code), attachSignals = true, stderr = (line) => console.error(line) }) {
+async function runSupervisor({ root, port, tunnel = false, resetCache = false, idleStopMinutes = 0, idleProbe, isExpo = detectIsExpo, startBare = null, startExpo = null, now = Date.now, onExit = (code) => process.exit(code), attachSignals = true, stderr = (line) => console.error(line) }) {
 	root = realpathSync(root);
 	const logsDir = workspaceLogsDir(root);
 	const writer = createNdjsonWriter(join(logsDir, "metro.ndjson"), { maxBytes: LOG_ROTATE_BYTES });
@@ -69,6 +194,7 @@ async function runSupervisor({ root, port, tunnel = false, resetCache = false, i
 	clearExpoMetroTunnel(root);
 	writePidFile(root, process.pid);
 	writeWorkspaceState(root, { supervisor: record });
+	clearWorkspaceStateKeys(root, [IDLE_STOP_KEY]);
 	try {
 		setSupervisor(root, record);
 	} catch (err) {
@@ -87,7 +213,9 @@ async function runSupervisor({ root, port, tunnel = false, resetCache = false, i
 		msg: `supervisor pid ${process.pid} starting the ${mode} dev server on port ${port} for ${root}`
 	});
 	let stopping = false;
+	let stopWatchingIdle = null;
 	const finish = (code, event, level, msg) => {
+		stopWatchingIdle?.();
 		writer.write({
 			src: "metro",
 			level,
@@ -108,6 +236,7 @@ async function runSupervisor({ root, port, tunnel = false, resetCache = false, i
 	const shutdown = async (code, event, msg) => {
 		if (stopping || !server) return;
 		stopping = true;
+		stopWatchingIdle?.();
 		try {
 			await server.close();
 		} catch (err) {
@@ -129,18 +258,23 @@ async function runSupervisor({ root, port, tunnel = false, resetCache = false, i
 		stopping = true;
 		finish(signal === "SIGINT" ? 130 : 143, "supervisor_stopped", "warn", `received ${signal} before the ${mode} dev server started; stopping`);
 	});
+	const serverActivity = trackDevServerActivity(now);
+	const serverWriter = Object.assign(Object.create(writer), { write(entry) {
+		serverActivity.record(entry);
+		return writer.write(entry);
+	} });
 	try {
-		server = await (mode === "expo-child" ? startExpo || (await import("./server-expo-CeILEu86.mjs")).startExpoServer : startBare || (await import("./server-bare-DWkkcIxV.mjs")).startBareServer)({
+		server = await (mode === "expo-child" ? startExpo || (await import("./server-expo-DBVTdult.mjs")).startExpoServer : startBare || (await import("./server-bare-DVbb7kXH.mjs")).startBareServer)({
 			root,
 			port,
 			logsDir,
-			writer,
+			writer: serverWriter,
 			tunnel,
 			resetCache,
 			onTunnelUrl: (url) => {
 				try {
 					withWorkspaceStateLock(root, () => {
-						if (readWorkspaceState(root)?.supervisor?.processToken === processToken) writeWorkspaceState(root, { metroTunnel: {
+						if (readWorkspaceState$1(root)?.supervisor?.processToken === processToken) writeWorkspaceState(root, { metroTunnel: {
 							kind: "expo",
 							url
 						} });
@@ -172,7 +306,7 @@ async function runSupervisor({ root, port, tunnel = false, resetCache = false, i
 	if (serverPid) {
 		const serverProcessToken = (0, process_identity_exports.captureProcessToken)(serverPid);
 		withWorkspaceStateLock(root, () => {
-			if (readWorkspaceState(root)?.supervisor?.processToken === processToken) writeWorkspaceState(root, { supervisor: {
+			if (readWorkspaceState$1(root)?.supervisor?.processToken === processToken) writeWorkspaceState(root, { supervisor: {
 				...record,
 				serverPid,
 				...serverProcessToken ? { serverProcessToken } : {}
@@ -185,6 +319,39 @@ async function runSupervisor({ root, port, tunnel = false, resetCache = false, i
 		event: "server_started",
 		msg: `${mode} dev server listening on port ${port}`
 	});
+	if (idleStopMinutes > 0) stopWatchingIdle = watchIdleDevServer({
+		idleStopMs: idleStopMinutes * 6e4,
+		now,
+		serverActivityAt: serverActivity.lastActivityAt,
+		probe: idleProbe ?? workspaceIdleProbe(root),
+		onIdle: async (idleMinutesNow) => {
+			const stopIfStillIdle = async () => {
+				const idleMinutes = idleMinutesNow();
+				if (stopping || idleMinutes === null) return;
+				withWorkspaceStateLock(root, () => {
+					if (readWorkspaceState$1(root)?.supervisor?.processToken === processToken) writeWorkspaceState(root, { [IDLE_STOP_KEY]: {
+						reason: "idle",
+						at: new Date(now()).toISOString(),
+						idleMinutes
+					} });
+				});
+				await shutdown(0, "supervisor_idle_stopped", `no bundle request, client log or Stim command for ${idleMinutes} minutes (metro.idleStopMinutes is ${idleStopMinutes}); stopped the ${mode} dev server`);
+			};
+			try {
+				await withIdleWorkspace(root, () => withWorkspaceProcessLock(dirname(logsDir), "metro-start", stopIfStillIdle, {
+					external: true,
+					waitMs: 0,
+					ownerPurpose: "idle stop"
+				}), {
+					purpose: "idle stop",
+					supervisor: false,
+					managedLocks: false
+				});
+			} catch (err) {
+				stderr(`Stim supervisor: could not stop the idle dev server: ${describeError(err)}`);
+			}
+		}
+	});
 	server.onExit?.((info) => {
 		if (stopping) return;
 		const detail = info?.signal ? `signal ${info.signal}` : `exit code ${info?.code ?? "unknown"}`;
@@ -219,7 +386,8 @@ async function main(argv = process.argv.slice(2)) {
 		root,
 		port: parsed.port,
 		tunnel: parsed.tunnel ?? false,
-		resetCache: parsed.resetCache ?? false
+		resetCache: parsed.resetCache ?? false,
+		idleStopMinutes: parsed.idleStopMinutes ?? 0
 	});
 }
 function invokedDirectly() {

package/dist/{workspace-process-lock-DWaiRD0e.mjs → workspace-process-lock-BXA96myD.mjs}

@@ -1,5 +1,5 @@
-import { k as ownership_claim_exports } from "./config-Cp9lM3wX.mjs";
-import { r as stopDeclaringSpawnsOn, t as declareSpawnsOn } from "./spawn-claims-Dn3C_N6w.mjs";
+import { k as ownership_claim_exports } from "./config-BEq0Qw_a.mjs";
+import { r as stopDeclaringSpawnsOn, t as declareSpawnsOn } from "./spawn-claims-CUleC2cM.mjs";
 import { join } from "node:path";
 //#region src/engine/workspace-process-lock.ts
 const DEFAULT_WAIT_MS = 6e4;