stim 1.15.0 → 1.17.0

package/dist/{budget-CMiqghig.mjs → budget-DM984mnd.mjs}

@@ -1,80 +1,35 @@
 import { t as getExecutor } from "./exec-CaErVv7t.mjs";
-import { A as directorySize, D as withConfigLock$1, F as volumeRootFor, H as projectDeviceSlots, M as isOnMountedVolume, N as listMountedVolumes, P as measuredDirectorySize, _ as loadConfig$1, a as clearDevice, d as getConfigDir, g as isPathPrefix, j as formatBytes, o as clearSupervisor, p as getProject, z as deviceSlotPlatforms } from "./config-D0DbpZtM.mjs";
+import { A as directorySize, D as withConfigLock$1, F as volumeRootFor, H as projectDeviceSlots, M as isOnMountedVolume, P as measuredDirectorySize, _ as loadConfig$1, a as clearDevice, d as getConfigDir, j as formatBytes, o as clearSupervisor, p as getProject, z as deviceSlotPlatforms } from "./config-D0DbpZtM.mjs";
 import { t as process_identity_exports } from "./process-identity-BmRm1qV0.mjs";
 import { i as registeredCaches } from "./cache-manifest-DnUHBJaU.mjs";
-import { b as workspaceDir, m as sharedBuildCache, r as readWorkspaceState$1, s as workspaceLastUsed, w as workspaceName$1 } from "./workspace-state-CL2V2Ons.mjs";
+import { l as phaseLine, o as formatLongDuration, u as plural } from "./command-output-CDAIFD-8.mjs";
+import { l as resolveProjectMetro, r as killMetroTree } from "./metro-g8NqiJp-.mjs";
+import { d as sharedBuildCache, r as readWorkspaceState$1, v as workspaceDir } from "./workspace-state-DqcCbpE7.mjs";
+import { a as capacity, l as environmentState, u as formatSpace } from "./status-CzS4bPO9.mjs";
+import { i as recordGcResult, n as withIdleWorkspace, o as canonicalPath } from "./in-use-CvGOUn-x.mjs";
+import { i as createDeviceProcessTables, p as workspaceActivity } from "./activity-IRvJY_ru.mjs";
+import { h as listBuildLocks, i as listLeaseFiles, r as leaseIsExpired } from "./device-lease-DpoS36_u.mjs";
+import { n as listBuildSlots } from "./build-slots-41v_d2x9.mjs";
+import { l as readPidFile, s as clearWorkspaceSupervisor } from "./state-BKa8wNN5.mjs";
+import { a as parseWatchmanPid, i as parseWatchmanClients, n as parseTriggerCount, r as parseWatchRoots, t as parseSubscriberNames } from "./watchman-APYjXSQa.mjs";
+import { A as listAvds, I as ownedAvdDirectory, at as isStimOwnedSim, ct as dropParked, it as isStimOwnedAvd, pt as readParked, z as ownedAvdSerialResolver } from "./android-B_YNZy61.mjs";
+import { _ as parseRuntimeVersion, f as listIosDeviceTypes, u as listAllIosSims } from "./ios-DSfnPfse.mjs";
+import { _ as teardownParkedAvd, d as eraseParkedAvd, f as eraseParkedIosSim, g as teardownOwnedIosSim, m as teardownOwnedAvd, t as resolveSupervisorTarget, v as teardownParkedIosSim } from "./ownership-BMLqyBgJ.mjs";
+import { n as workspaceProcessLockError, t as withWorkspaceProcessLock } from "./workspace-process-lock-2mNzOlaB.mjs";
+import { i as idleShutdownCandidates, n as collectOwnedDeviceActivity, o as shutDownIdleDevices, s as workspaceBuildInProgress, t as collectIdleDevices } from "./idle-B2m-Ovod.mjs";
+import { a as collectWorkspaceOutputs, r as clearWorkspaceOutputs } from "./workspaces-Bcib97-6.mjs";
 import { n as supervisorError } from "./errors-B6W7FkxQ.mjs";
-import { l as readPidFile, s as clearWorkspaceSupervisor } from "./state-CaeaHbDA.mjs";
-import { n as workspaceProcessLockError, t as withWorkspaceProcessLock } from "./workspace-process-lock-BL7Q0HCO.mjs";
-import { l as workspaceActivity, r as createDeviceProcessTables } from "./activity-B2-kb7k0.mjs";
-import { l as phaseLine, o as formatLongDuration, u as plural } from "./command-output-CliHHn7a.mjs";
-import { h as listBuildLocks, i as listLeaseFiles, r as leaseIsExpired } from "./device-lease-W5Pi1q38.mjs";
-import { A as listAvds, I as ownedAvdDirectory, ft as readParked, it as isStimOwnedSim, rt as isStimOwnedAvd, st as dropParked, z as ownedAvdSerialResolver } from "./android-Db2eEMaf.mjs";
-import { l as resolveProjectMetro, r as killMetroTree } from "./metro-Di8EN2Tb.mjs";
-import { a as teardownOwnedBrowser, c as teardownParkedIosSim, i as teardownOwnedAvd, n as eraseParkedIosSim, o as teardownOwnedIosSim, s as teardownParkedAvd, t as eraseParkedAvd } from "./teardown-BYuQafiA.mjs";
-import { _ as parseRuntimeVersion, f as listIosDeviceTypes, u as listAllIosSims } from "./ios-3CtCRhwr.mjs";
-import { a as parseWatchmanPid, c as collectOwnedDeviceActivity, f as shutDownIdleDevices, i as parseWatchmanClients, m as recordGcResult, n as parseTriggerCount, p as workspaceBuildInProgress, r as parseWatchRoots, s as collectIdleDevices, t as parseSubscriberNames, u as idleShutdownCandidates } from "./watchman-Bx0wceoF.mjs";
-import { i as canonicalPath, n as withIdleWorkspace, r as workspaceInUse, t as emptyWorkspaceDir } from "./in-use-CndPMilN.mjs";
-import { n as listBuildSlots } from "./build-slots-Df1ApSuH.mjs";
-import { l as withdrawDevServerStopRequest, s as requestDevServerStop, u as resolveSupervisorTarget } from "./stop-cause-CZ_Mr-v9.mjs";
-import { a as capacity, l as environmentState, u as formatSpace } from "./status-l84Gbvp2.mjs";
-import { r as readFootprints, t as STIM_SERVER_COMMAND } from "./machine-usage-D_YYMzfR.mjs";
+import { l as withdrawDevServerStopRequest, s as requestDevServerStop } from "./stop-cause-rhmGfwvt.mjs";
 import { existsSync, readFileSync, statSync, statfsSync } from "node:fs";
-import { dirname, isAbsolute, join, resolve, sep } from "node:path";
-import { existsSync as existsSync$1, lstatSync as lstatSync$1, readdirSync as readdirSync$1, realpathSync as realpathSync$1, rmSync as rmSync$1, statSync as statSync$1 } from "fs";
+import { basename, dirname, isAbsolute, join, resolve, sep } from "node:path";
+import { existsSync as existsSync$1, readdirSync as readdirSync$1, realpathSync as realpathSync$1, rmSync as rmSync$1, statSync as statSync$1 } from "fs";
 import { homedir, tmpdir } from "os";
 import { basename as basename$1, dirname as dirname$1, isAbsolute as isAbsolute$1, join as join$1, relative as relative$1, resolve as resolve$1 } from "path";
-import { METRO_NAMED_CACHE_LAYOUT } from "@stim-cli/core";
-import { buildWorkerRoot, isJsonObject, loadConfig, readJsonFile, settingDefinition, settingValueError } from "@stim-cli/core/state";
+import { METRO_NAMED_CACHE_LAYOUT, compiledHelper, configDir } from "@stim-cli/core";
+import { MACHINE_OWNER_KINDS, buildWorkerRoot, loadConfig, settingDefinition, settingValueError } from "@stim-cli/core/state";
+import { fileURLToPath } from "node:url";
 import { homedir as homedir$1, platform, totalmem as totalmem$1 } from "node:os";
 import chalk from "chalk";
-//#region src/supervisor/cache-reset.ts
-async function stopOwnedMetro(root, requester) {
-	const project = getProject(root);
-	const port = project?.metroPort;
-	const target = resolveSupervisorTarget({
-		state: readWorkspaceState$1(root)?.supervisor,
-		record: project?.supervisor,
-		reservedPort: port
-	});
-	if (target.status === "unverified") return {
-		status: "unverified",
-		reason: target.reason ?? "unknown identity"
-	};
-	if (port && target.status !== "ours" && !(await resolveProjectMetro(port, root)).missing) return {
-		status: "external",
-		reason: `a dev server Stim did not start answers on port ${port}`
-	};
-	if (target.status !== "ours") return { status: "not-running" };
-	const expected = {
-		pid: target.pid,
-		processToken: target.processToken
-	};
-	requestDevServerStop(root, target.processToken, requester);
-	const signalled = killMetroTree(target.pid, target.processToken);
-	if (!signalled) withdrawDevServerStopRequest(root, target.processToken);
-	if (!signalled || !await (0, process_identity_exports.waitForProcessExit)(expected, 1e4)) return {
-		status: "stuck",
-		reason: `supervisor pid ${target.pid} did not exit`
-	};
-	if (port && !(await resolveProjectMetro(port, root)).missing) return {
-		status: "port-occupied",
-		reason: `port ${port} is still occupied after stopping Metro`
-	};
-	clearWorkspaceSupervisor(root, expected);
-	clearSupervisor(root, expected);
-	return { status: "stopped" };
-}
-async function stopOwnedMetroForReset(root) {
-	const stopped = await stopOwnedMetro(root, { by: "stim start --reset-cache" });
-	switch (stopped.status) {
-		case "unverified": throw supervisorError("STIM_SUPERVISOR_EXITED", `Cannot reset Metro: ${stopped.reason}.`, "Stop it with the tool that started it, then retry. Stim leaves unverified processes alone.");
-		case "external": throw supervisorError("STIM_SUPERVISOR_EXITED", "Cannot reset an externally started dev server.", "Stop it with the tool that started it, then retry `stim start --reset-cache`.");
-		case "stuck": throw supervisorError("STIM_SUPERVISOR_EXITED", "The owned Metro supervisor could not be stopped for a cache reset.", "Inspect `stim status` and `stim logs`, then retry. No cache reset was recorded.");
-		case "port-occupied": throw supervisorError("STIM_SUPERVISOR_EXITED", `Port ${getProject(root)?.metroPort} is still occupied after stopping Metro.`, "Inspect the listener before retrying. Stim does not terminate unrecorded processes.");
-	}
-}
-//#endregion
 //#region src/cache/caches.ts
 function xcodeDerivedDataRoot() {
 	return join$1(homedir(), "Library", "Developer", "Xcode", "DerivedData");
@@ -309,6 +264,283 @@ function entriesAtDepth(dir, depth) {
 	return level;
 }
 //#endregion
+//#region src/footprint.ts
+const SOURCE = "stim-footprint.swift";
+const COMPILE_TIMEOUT_MS = 12e4;
+const READ_TIMEOUT_MS = 5e3;
+function helperSource() {
+	const here = fileURLToPath(import.meta.url);
+	if (basename(dirname(here)) === "src") return fileURLToPath(new URL(`../helper/${SOURCE}`, import.meta.url));
+	return join(dirname(here), SOURCE);
+}
+async function buildHelper() {
+	const exec = getExecutor();
+	if (!exec.runFileQuiet("xcode-select", ["-p"], { timeoutMs: READ_TIMEOUT_MS })) return null;
+	const source = helperSource();
+	try {
+		return await compiledHelper({
+			dir: join(configDir(), "helpers"),
+			name: "stim-footprint",
+			inputs: [source],
+			version: "",
+			compile: async (output) => {
+				await exec.runFileAsync("xcrun", [
+					"swiftc",
+					"-O",
+					"-swift-version",
+					"5",
+					"-o",
+					output,
+					source
+				], { timeoutMs: COMPILE_TIMEOUT_MS });
+			}
+		});
+	} catch {
+		return null;
+	}
+}
+const RETRY_BACKOFF_INITIAL_MS = 1e4;
+const RETRY_BACKOFF_MAX_MS = 6e5;
+let built = null;
+let failure = null;
+/** The `stim-footprint` helper, compiled on first use. A success is kept for the process's life; a failure retries after a doubling backoff instead of being pinned forever. */
+function footprintHelper() {
+	const home = configDir();
+	if (built?.home === home) return built.promise;
+	if (failure?.home === home && Date.now() < failure.nextRetryAt) return Promise.resolve(null);
+	const promise = buildHelper().then((helper) => {
+		if (helper === null) {
+			const backoffMs = failure?.home === home ? Math.min(failure.backoffMs * 2, RETRY_BACKOFF_MAX_MS) : RETRY_BACKOFF_INITIAL_MS;
+			failure = {
+				home,
+				nextRetryAt: Date.now() + backoffMs,
+				backoffMs
+			};
+			if (built?.promise === promise) built = null;
+			return null;
+		}
+		return helper;
+	});
+	built = {
+		home,
+		promise
+	};
+	return promise;
+}
+/** Parses the helper's `<pid> <bytes>` lines into footprint bytes by pid. */
+function parseFootprints(output) {
+	const footprints = /* @__PURE__ */ new Map();
+	for (const line of output.split("\n")) {
+		const match = /^(\d+) (\d+)$/.exec(line.trim());
+		if (match) footprints.set(Number(match[1]), Number(match[2]));
+	}
+	return footprints;
+}
+/** Every readable process's physical footprint in bytes, or null when the helper is unavailable or fails. */
+async function readFootprints() {
+	const helper = await footprintHelper();
+	const output = helper ? getExecutor().runFileQuiet(helper, [], { timeoutMs: READ_TIMEOUT_MS }) : null;
+	return output === null ? null : parseFootprints(output);
+}
+//#endregion
+//#region src/machine-usage.ts
+const SHARED = [
+	{
+		name: "CoreSimulator services",
+		pattern: /\/CoreSimulator\.framework\/|\/Simulator\.app\/Contents\/MacOS\//
+	},
+	{
+		name: "adb server",
+		pattern: /(^|\/)adb\s.*\bfork-server\b/
+	},
+	{
+		name: "Android emulator services",
+		pattern: /\/emulator\/netsimd(\s|$)/
+	},
+	{
+		name: "Gradle daemon",
+		pattern: /\borg\.gradle\.launcher\.daemon\.bootstrap\.GradleDaemon\b/
+	},
+	{
+		name: "Kotlin daemon",
+		pattern: /\bKotlinCompileDaemon\b/
+	},
+	{
+		name: "Watchman",
+		pattern: /(^|\/)watchman(\s|$)/
+	}
+];
+const STIM_SERVER_COMMAND = /(^|[\s/])stim-server(\.mjs)?(\s|$)/;
+const LAUNCHD_SIM = /^launchd_sim\s.*\/Devices\/([^/\s]+)\//;
+const MAX_DEPTH = 64;
+const EMULATOR = /(?:^|\/)(?:qemu-system-[^\s/]+|emulator)(?:\s.*)?\s(?:-avd\s+|@)(\S+)/;
+function emulatorAvd(command) {
+	return EMULATOR.exec(command)?.[1] ?? null;
+}
+function workspaceOwner(kind, env, name, id) {
+	return {
+		kind,
+		name,
+		workspace: env.path,
+		id,
+		owned: true
+	};
+}
+function rank(owner) {
+	return MACHINE_OWNER_KINDS.indexOf(owner.kind);
+}
+/**
+* Attributes every process in `processes` to at most one owner: the owner of its nearest ancestor (itself included)
+* that is a root. Roots are each booted simulator's `launchd_sim`, each emulator launcher and qemu process, and each
+* workspace's verified supervisor and Metro, running build and Chrome. Only a process under none of those falls back
+* to stim-server or a machine-wide service in `SHARED`, so a `simctl` a workspace's log collector runs stays with the
+* workspace. An emulator counts in the workspace that records its AVD whenever its process runs, including while adb
+* does not list it. A process with no root ancestor is left out. `footprints` holds physical footprint bytes by pid,
+* or is null when they could not be read, and the owners' `memoryMb` then sums resident sizes. A process missing from
+* `footprints`, another user's or one that exited between the two reads, counts its resident size.
+*/
+function attributeMachineUsage({ processes, footprints, environments, roots, simNames }) {
+	const owners = /* @__PURE__ */ new Map();
+	const rootOf = /* @__PURE__ */ new Map();
+	const fallbackOf = /* @__PURE__ */ new Map();
+	const claim = (pid, key, owner, into = rootOf) => {
+		if (!owners.has(key)) owners.set(key, owner);
+		into.set(pid, key);
+	};
+	const sims = /* @__PURE__ */ new Map();
+	const emulators = /* @__PURE__ */ new Map();
+	for (const env of environments) for (const device of [{
+		slot: "default",
+		ios: env.ios,
+		android: env.android
+	}, ...env.slots ?? []]) {
+		const slot = device.slot === "default" ? {} : { slot: device.slot };
+		if (device.ios?.state === "Booted") sims.set(device.ios.udid.toUpperCase(), {
+			kind: "simulator",
+			name: device.ios.name ?? device.ios.udid,
+			workspace: env.path,
+			...slot,
+			id: device.ios.udid,
+			owned: device.ios.owned
+		});
+		if (device.android?.name && !device.android.physical) emulators.set(device.android.name, {
+			kind: "emulator",
+			name: device.android.name,
+			workspace: env.path,
+			...slot,
+			id: device.android.name,
+			owned: device.android.owned
+		});
+	}
+	for (const p of processes) {
+		const shared = SHARED.find(({ pattern }) => pattern.test(p.command));
+		if (shared) {
+			const owner = {
+				kind: "shared",
+				name: shared.name,
+				workspace: null,
+				id: null,
+				owned: false
+			};
+			claim(p.pid, `shared:${shared.name}`, owner, fallbackOf);
+			continue;
+		}
+		if (STIM_SERVER_COMMAND.test(p.command)) {
+			claim(p.pid, "server", {
+				kind: "server",
+				name: "stim-server",
+				workspace: null,
+				id: null,
+				owned: false
+			}, fallbackOf);
+			continue;
+		}
+		const udid = LAUNCHD_SIM.exec(p.command)?.[1]?.toUpperCase();
+		if (udid) {
+			const owner = sims.get(udid) ?? {
+				kind: "simulator",
+				name: simNames[udid] ?? udid,
+				workspace: null,
+				id: udid,
+				owned: false
+			};
+			claim(p.pid, `simulator:${udid}`, owner);
+			continue;
+		}
+		const avd = emulatorAvd(p.command);
+		if (avd) {
+			const owner = emulators.get(avd) ?? {
+				kind: "emulator",
+				name: avd,
+				workspace: null,
+				id: avd,
+				owned: false
+			};
+			claim(p.pid, `emulator:${avd}`, owner);
+		}
+	}
+	const present = new Set(processes.map((p) => p.pid));
+	const byPath = new Map(environments.map((env) => [env.path, env]));
+	for (const root of roots) {
+		const env = byPath.get(root.path);
+		if (!env) continue;
+		const metroPids = [root.supervisorPid, env.metro?.running ? env.metro.pid : null];
+		for (const pid of metroPids) if (pid && present.has(pid)) {
+			const port = env.metro?.port ?? null;
+			claim(pid, `metro:${env.path}`, workspaceOwner("metro", env, port ? `Metro :${port}` : "Metro", port ? String(port) : null));
+		}
+		if (root.build && present.has(root.build.pid)) {
+			const label = root.build.platform === "ios" ? "iOS build" : "Android build";
+			claim(root.build.pid, `build:${env.path}`, workspaceOwner("build", env, label, root.build.platform));
+		}
+		for (const pid of root.macosPids ?? []) if (present.has(pid)) claim(pid, `macos:${env.path}`, workspaceOwner("macos", env, env.macos?.product ?? "macOS app", null));
+		for (const pid of root.browserPids) if (present.has(pid)) claim(pid, `browser:${env.path}`, workspaceOwner("browser", env, "Chrome", null));
+	}
+	const parentOf = new Map(processes.map((p) => [p.pid, p.ppid]));
+	const totals = /* @__PURE__ */ new Map();
+	for (const p of processes) {
+		let pid = p.pid;
+		let key;
+		let fallback;
+		for (let depth = 0; pid !== void 0 && pid > 1 && depth < MAX_DEPTH; depth++) {
+			key = rootOf.get(pid);
+			if (key) break;
+			fallback ??= fallbackOf.get(pid);
+			pid = parentOf.get(pid);
+		}
+		key ??= fallback;
+		if (!key) continue;
+		const total = totals.get(key) ?? {
+			rssKb: 0,
+			memoryKb: 0,
+			cpu: 0,
+			processes: 0
+		};
+		total.rssKb += p.rssKb;
+		const footprint = footprints?.get(p.pid);
+		total.memoryKb += footprint === void 0 ? p.rssKb : footprint / 1024;
+		total.cpu += p.cpuPercent;
+		total.processes += 1;
+		totals.set(key, total);
+	}
+	const list = [];
+	for (const [key, owner] of owners) {
+		const total = totals.get(key);
+		if (total) list.push({
+			...owner,
+			cpuPercent: Math.round(total.cpu),
+			residentMb: Math.round(total.rssKb / 1024),
+			memoryMb: Math.round(total.memoryKb / 1024),
+			processes: total.processes
+		});
+	}
+	list.sort((x, y) => rank(x) - rank(y) || (x.workspace ?? "~").localeCompare(y.workspace ?? "~") || x.name.localeCompare(y.name));
+	return {
+		memorySource: footprints ? "footprint" : "rss",
+		owners: list
+	};
+}
+//#endregion
 //#region src/commands/gc/progress.ts
 function phase(label, text) {
 	console.error(chalk.dim(phaseLine(label, text)));
@@ -1187,7 +1419,7 @@ async function inspectWatchmanMemory() {
 }
 //#endregion
 //#region src/commands/gc/caches.ts
-const DAY_MS$2 = 864e5;
+const DAY_MS$1 = 864e5;
 function cacheSweepIsScoped() {
 	return Boolean(process.env.STIM_HOME);
 }
@@ -1207,6 +1439,14 @@ const EVERY_CACHE = "all";
 const WORKSPACE_OUTPUTS = "workspaces";
 const RECORDINGS = "recordings";
 const PARKED_DEVICES = "parked";
+function includesArchives(name) {
+	const wanted = name?.trim().toLowerCase();
+	return Boolean(wanted && (wanted === "archived" || wanted.startsWith("archived:") || [
+		"archived-logs",
+		"archived-recordings",
+		"archived-agent"
+	].includes(wanted)));
+}
 function includesParkedDevices(name) {
 	return name?.trim().toLowerCase() === PARKED_DEVICES;
 }
@@ -1223,13 +1463,13 @@ function includesWorkspaceOutputs(name) {
 }
 /** Whether a --cache name selects something besides shared caches: recordings, parked devices or a memory kind. */
 function selectsBeyondCaches(name) {
-	return includesRecordings(name) || includesParkedDevices(name) || memoryCacheKind(name) !== null;
+	return includesArchives(name) || includesRecordings(name) || includesParkedDevices(name) || memoryCacheKind(name) !== null;
 }
 function selectCaches(caches, name) {
 	if (!name) return caches;
 	const wanted = name.trim().toLowerCase();
 	if (wanted === EVERY_CACHE) return caches;
-	if (wanted === WORKSPACE_OUTPUTS || wanted === RECORDINGS || wanted === PARKED_DEVICES || memoryCacheKind(wanted)) return [];
+	if (includesArchives(wanted) || wanted === WORKSPACE_OUTPUTS || wanted === RECORDINGS || wanted === PARKED_DEVICES || memoryCacheKind(wanted)) return [];
 	return caches.filter((c) => c.name.toLowerCase().includes(wanted) || c.dir.toLowerCase().includes(wanted));
 }
 function emptyVerdict(c) {
@@ -1276,7 +1516,7 @@ function emptyCache(cache) {
 	};
 	if (cache.prune !== "atomic") return pruneCache(cache, {
 		olderThanDays: 0,
-		now: Date.now() + DAY_MS$2
+		now: Date.now() + DAY_MS$1
 	});
 	let names;
 	try {
@@ -1383,7 +1623,7 @@ function emptyCaches(caches) {
 //#region src/commands/gc/devices.ts
 const DEVICE_LIST_TIMEOUT_MS$1 = 3e4;
 const AVD_SIZE_TIMEOUT_MS = 5e3;
-const DAY_MS$1 = 864e5;
+const DAY_MS = 864e5;
 function describeKept(ref) {
 	return ref.mounted ? `referenced by ${ref.path}` : `referenced by ${ref.path} (volume not mounted; kept just in case)`;
 }
@@ -1475,7 +1715,7 @@ function unverifiedDeviceCommand(device) {
 }
 function findStaleProjectDevices({ config, sims = [], avds = [], olderThanDays, now = Date.now(), lastTouched, deadProjects = [] }) {
 	if (!Number.isFinite(olderThanDays) || typeof lastTouched !== "function") return [];
-	const cutoff = now - olderThanDays * DAY_MS$1;
+	const cutoff = now - olderThanDays * DAY_MS;
 	const dead = new Set(deadProjects);
 	const liveSims = new Map(sims.filter((s) => s?.name?.startsWith("stim-")).map((s) => [s.udid, s]));
 	const liveAvds = new Set(avds.filter((a) => typeof a === "string" && a.startsWith("stim-")));
@@ -1484,7 +1724,7 @@ function findStaleProjectDevices({ config, sims = [], avds = [], olderThanDays,
 		if (dead.has(path) || !isAbsolute$1(path)) continue;
 		const touched = lastTouched(path);
 		if (!Number.isFinite(touched) || touched >= cutoff) continue;
-		const idleDays = Math.floor((now - touched) / DAY_MS$1);
+		const idleDays = Math.floor((now - touched) / DAY_MS);
 		for (const { slot, platforms } of projectDeviceSlots(proj)) {
 			const ios = platforms.ios;
 			const sim = ios?.owned && ios.deviceUdid ? liveSims.get(ios.deviceUdid) : void 0;
@@ -1577,7 +1817,7 @@ function describeParkedSims(records, sims, deviceTypes, { simsChecked = true } =
 }
 function parkedAtLeast(records, { olderThanDays = null, now = Date.now() }) {
 	if (olderThanDays === null) return [...records];
-	const cutoff = now - olderThanDays * DAY_MS$1;
+	const cutoff = now - olderThanDays * DAY_MS;
 	return records.filter((record) => Date.parse(record.parkedAt) <= cutoff);
 }
 function collectParkedSims(deps, age = {}) {
@@ -1851,301 +2091,51 @@ function deleteProjectDevices(orphanedDevices, staleDevices, staleDeviceRecords)
 	return deleteFailures;
 }
 //#endregion
-//#region src/commands/gc/workspaces.ts
-function workspacesRoot() {
-	return join$1(getConfigDir(), "workspaces");
-}
-function isInsideWorkspaces(dir) {
-	const rel = relative$1(canonicalPath(workspacesRoot()), canonicalPath(dir));
-	return rel !== "" && !rel.startsWith("..") && !isAbsolute$1(rel);
-}
-function readRecordedRoot(dir, name) {
-	let parsed;
-	try {
-		parsed = readJsonFile(join$1(dir, "workspace.json"));
-	} catch (error) {
-		return {
-			projectRoot: null,
-			problem: error?.code === "ENOENT" ? "it has no workspace.json" : "its workspace.json does not parse"
-		};
-	}
-	const projectRoot = isJsonObject(parsed) ? parsed.projectRoot : void 0;
-	if (typeof projectRoot !== "string" || !isAbsolute$1(projectRoot)) return {
-		projectRoot: null,
-		problem: "its workspace.json records no absolute project root"
-	};
-	if (workspaceName$1(projectRoot) !== name) return {
-		projectRoot: null,
-		problem: `its workspace.json records ${projectRoot}, whose workspace directory has another name`
-	};
-	return {
-		projectRoot,
-		problem: null
+//#region src/supervisor/cache-reset.ts
+async function stopOwnedMetro(root, requester) {
+	const project = getProject(root);
+	const port = project?.metroPort;
+	const target = resolveSupervisorTarget({
+		state: readWorkspaceState$1(root)?.supervisor,
+		record: project?.supervisor,
+		reservedPort: port
+	});
+	if (target.status === "unverified") return {
+		status: "unverified",
+		reason: target.reason ?? "unknown identity"
 	};
-}
-function listWorkspaceDirs() {
-	const root = workspacesRoot();
-	let names;
-	try {
-		names = readdirSync$1(root).toSorted();
-	} catch {
-		return [];
-	}
-	const entries = [];
-	for (const name of names) {
-		const dir = join$1(root, name);
-		try {
-			if (!statSync$1(dir).isDirectory()) continue;
-		} catch {
-			continue;
-		}
-		entries.push({
-			dir,
-			...readRecordedRoot(dir, name)
-		});
-	}
-	return entries;
-}
-function classifyWorkspaceDirs(entries, { registryKeys, exists, isMounted, inUse }) {
-	const orphaned = [];
-	const skipped = [];
-	for (const { dir, projectRoot, problem } of entries) {
-		if (projectRoot === null) {
-			skipped.push({
-				dir,
-				reason: `workspace directory not resolved: ${problem ?? "unknown project root"}`
-			});
-			continue;
-		}
-		const present = exists(projectRoot);
-		if (present === null) {
-			skipped.push({
-				dir,
-				reason: `cannot tell whether its project root ${projectRoot} still exists`
-			});
-			continue;
-		}
-		if (present) continue;
-		if (registryKeys.some((key) => isPathPrefix(projectRoot, key))) continue;
-		if (!isMounted(projectRoot)) {
-			skipped.push({
-				dir,
-				reason: `the volume of its project root ${projectRoot} is not mounted`
-			});
-			continue;
-		}
-		const reasons = inUse(projectRoot);
-		if (reasons.length) {
-			skipped.push({
-				dir,
-				reason: `its project root ${projectRoot} is gone, but ${reasons.join("; ")}`
-			});
-			continue;
-		}
-		orphaned.push({
-			dir,
-			projectRoot
-		});
-	}
-	return {
-		orphaned,
-		skipped
+	if (port && target.status !== "ours" && !(await resolveProjectMetro(port, root)).missing) return {
+		status: "external",
+		reason: `a dev server Stim did not start answers on port ${port}`
 	};
-}
-function rootPresence(path) {
-	try {
-		lstatSync$1(path);
-		return true;
-	} catch (error) {
-		const code = error?.code;
-		return code === "ENOENT" || code === "ENOTDIR" ? false : null;
-	}
-}
-function collectOrphanedWorkspaces(registryKeys, mountedVolumes, { measure = true } = {}) {
-	const classified = classifyWorkspaceDirs(listWorkspaceDirs(), {
-		registryKeys,
-		exists: rootPresence,
-		isMounted: (path) => isOnMountedVolume(path, mountedVolumes),
-		inUse: (root) => workspaceInUse(root)
-	});
-	return {
-		orphaned: measure ? classified.orphaned.map((entry) => Object.assign({}, entry, { bytes: sizeOf(entry.dir) })) : classified.orphaned,
-		skipped: classified.skipped
+	if (target.status !== "ours") return { status: "not-running" };
+	const expected = {
+		pid: target.pid,
+		processToken: target.processToken
 	};
-}
-const REBUILD_COST = "The next build of an unchanged app installs from the shared build cache; after a native change the compilation cache speeds the rebuild, but on React Native 0.86 Swift does not use it (explicit modules are off), so that build recompiles Swift. The next stim macos in a cleared workspace is a full Swift build.";
-const WORKSPACE_OUTPUT_DIRS = [
-	"derived-data",
-	"gradle-build",
-	"android-cas",
-	"cache-provider"
-];
-const DAY_MS = 864e5;
-function planWorkspaceOutputs(entries, { olderThan, now }) {
-	return entries.map(({ dir, projectRoot, problem, bytes, lastUsed, inUse }) => {
-		const idleDays = Number.isFinite(lastUsed) ? Math.max(0, Math.floor((now - lastUsed) / DAY_MS)) : null;
-		const [keptCode, keptReason] = projectRoot === null ? ["unresolved", `workspace directory not resolved: ${problem ?? "unknown project root"}`] : inUse.length ? ["in-use", `in use: ${inUse.join("; ")}`] : olderThan === null ? [null, null] : idleDays === null ? ["last-use-unknown", "its last use is unknown"] : idleDays < olderThan ? ["recently-used", `used ${idleDays}d ago, within --older-than ${olderThan}`] : [null, null];
-		return {
-			dir,
-			projectRoot,
-			bytes,
-			idleDays,
-			willClear: keptCode === null,
-			keptCode,
-			keptReason
-		};
-	});
-}
-const SIZE_TIMEOUT_MS = 6e4;
-function sizeOf(dir) {
-	return measuredDirectorySize(dir, { timeoutMs: SIZE_TIMEOUT_MS });
-}
-function outputPaths(dir) {
-	const paths = WORKSPACE_OUTPUT_DIRS.map((name) => join$1(dir, name)).filter((path) => existsSync$1(path));
-	const macos = join$1(dir, "macos");
-	try {
-		if (!lstatSync$1(macos).isDirectory()) return paths;
-		for (const entry of readdirSync$1(macos, { withFileTypes: true })) if (entry.name === "build" || entry.name.endsWith(".app") || entry.name.startsWith("staging-") && entry.isDirectory()) paths.push(join$1(macos, entry.name));
-	} catch {}
-	return paths;
-}
-function outputBytes(paths) {
-	let total = 0;
-	for (const path of paths) {
-		const size = sizeOf(path);
-		if (size === null) return null;
-		total += size;
-	}
-	return total;
-}
-function collectWorkspaceOutputs({ olderThan, now, exclude = [], measure = true }) {
-	const mountedVolumes = listMountedVolumes();
-	const entries = listWorkspaceDirs().filter((entry) => !exclude.includes(entry.dir)).filter((entry) => entry.projectRoot === null || isOnMountedVolume(entry.projectRoot, mountedVolumes)).map((entry) => Object.assign({}, entry, { paths: outputPaths(entry.dir) })).filter((entry) => entry.paths.length > 0).map(({ paths, ...entry }) => Object.assign({}, entry, { bytes: measure ? outputBytes(paths) : null })).map((entry) => Object.assign({}, entry, {
-		lastUsed: entry.projectRoot === null ? NaN : workspaceLastUsed(entry.projectRoot),
-		inUse: entry.projectRoot === null ? [] : workspaceInUse(entry.projectRoot)
-	}));
-	return {
-		root: workspacesRoot(),
-		workspaces: planWorkspaceOutputs(entries, {
-			olderThan,
-			now
-		})
+	requestDevServerStop(root, target.processToken, requester);
+	const signalled = killMetroTree(target.pid, target.processToken);
+	if (!signalled) withdrawDevServerStopRequest(root, target.processToken);
+	if (!signalled || !await (0, process_identity_exports.waitForProcessExit)(expected, 1e4)) return {
+		status: "stuck",
+		reason: `supervisor pid ${target.pid} did not exit`
 	};
-}
-async function clearWorkspaceOutputs(report, { olderThan, now = Date.now() }) {
-	let failures = 0;
-	let cleared = 0;
-	const clearedRoots = [];
-	for (const entry of report.workspaces) {
-		const root = entry.projectRoot;
-		if (!entry.willClear || root === null) {
-			if (entry.keptReason) {
-				console.log(chalk.dim(`Kept the build outputs of ${root ?? entry.dir}: ${entry.keptReason}`));
-				recordGcResult("workspaceOutputs", "kept", root ?? entry.dir, {
-					bytes: entry.bytes,
-					detail: entry.keptReason
-				});
-			}
-			continue;
-		}
-		let run;
-		try {
-			run = await withIdleWorkspace(root, () => {
-				const [again] = planWorkspaceOutputs([{
-					...entry,
-					problem: null,
-					lastUsed: workspaceLastUsed(root),
-					inUse: []
-				}], {
-					olderThan,
-					now
-				});
-				if (again?.keptReason) return again.keptReason;
-				for (const path of outputPaths(entry.dir)) rmSync$1(path, {
-					recursive: true,
-					force: true
-				});
-				return null;
-			}, { purpose: "gc" });
-		} catch (error) {
-			failures++;
-			console.log(chalk.red(`Could not clear the build outputs of ${root}: ${error?.message || String(error)}`));
-			recordGcResult("workspaceOutputs", "failed", root, {
-				bytes: entry.bytes,
-				detail: error?.message || String(error)
-			});
-			continue;
-		}
-		const kept = run.ran ? run.value : `in use: ${run.reasons.join("; ")}`;
-		if (kept) {
-			console.log(chalk.yellow(`Kept the build outputs of ${root}: ${kept}`));
-			recordGcResult("workspaceOutputs", "kept", root, {
-				bytes: entry.bytes,
-				detail: kept
-			});
-			continue;
-		}
-		cleared += entry.bytes ?? 0;
-		clearedRoots.push(root);
-		console.log(chalk.green(`Cleared the build outputs of ${root} (${sizeText(entry.bytes)})`));
-		recordGcResult("workspaceOutputs", "done", root, { bytes: entry.bytes });
-	}
-	if (cleared) console.log(chalk.dim(`Cleared ${formatBytes(cleared)} of workspace build outputs. ${REBUILD_COST}`));
-	return {
-		failures,
-		cleared: clearedRoots
+	if (port && !(await resolveProjectMetro(port, root)).missing) return {
+		status: "port-occupied",
+		reason: `port ${port} is still occupied after stopping Metro`
 	};
+	clearWorkspaceSupervisor(root, expected);
+	clearSupervisor(root, expected);
+	return { status: "stopped" };
 }
-function stillOrphaned({ dir, projectRoot }) {
-	if (readRecordedRoot(dir, basename$1(dir)).projectRoot !== projectRoot || rootPresence(projectRoot) !== false || !isOnMountedVolume(projectRoot)) return false;
-	return !Object.keys(loadConfig$1()?.projects ?? {}).some((key) => isPathPrefix(projectRoot, key));
-}
-async function deleteOrphanedWorkspaces(orphaned) {
-	let failures = 0;
-	for (const entry of orphaned) {
-		if (!existsSync$1(entry.dir)) continue;
-		let run;
-		try {
-			run = await withIdleWorkspace(entry.projectRoot, async () => {
-				if (!stillOrphaned(entry)) return false;
-				const browser = await teardownOwnedBrowser(entry.projectRoot, { deleteProfile: true });
-				if (browser.status === "failed" || browser.status === "skipped") throw new Error(`its owned Chrome profile was kept: ${browser.reason}`);
-				emptyWorkspaceDir(entry.dir);
-				return true;
-			}, { purpose: "gc" });
-		} catch (error) {
-			failures++;
-			console.log(chalk.red(`Could not remove ${entry.dir}: ${error?.message || error}`));
-			recordGcResult("workspaceDirectory", "failed", entry.dir, {
-				bytes: entry.bytes ?? null,
-				detail: error?.message || String(error)
-			});
-			continue;
-		}
-		if (!run.ran) {
-			console.log(chalk.yellow(`Kept ${entry.dir}: ${run.reasons.join("; ")}`));
-			recordGcResult("workspaceDirectory", "kept", entry.dir, {
-				bytes: entry.bytes ?? null,
-				detail: run.reasons.join("; ")
-			});
-			continue;
-		}
-		if (!run.value) {
-			console.log(chalk.yellow(`Kept ${entry.dir}: it can no longer be confirmed orphaned.`));
-			recordGcResult("workspaceDirectory", "kept", entry.dir, {
-				bytes: entry.bytes ?? null,
-				detail: "it can no longer be confirmed orphaned"
-			});
-			continue;
-		}
-		const size = entry.bytes === void 0 ? "" : ` (${sizeText(entry.bytes)})`;
-		console.log(chalk.green(`Removed the orphaned workspace directory ${entry.dir}${size}`));
-		recordGcResult("workspaceDirectory", "done", entry.dir, { bytes: entry.bytes ?? null });
+async function stopOwnedMetroForReset(root) {
+	const stopped = await stopOwnedMetro(root, { by: "stim start --reset-cache" });
+	switch (stopped.status) {
+		case "unverified": throw supervisorError("STIM_SUPERVISOR_EXITED", `Cannot reset Metro: ${stopped.reason}.`, "Stop it with the tool that started it, then retry. Stim leaves unverified processes alone.");
+		case "external": throw supervisorError("STIM_SUPERVISOR_EXITED", "Cannot reset an externally started dev server.", "Stop it with the tool that started it, then retry `stim start --reset-cache`.");
+		case "stuck": throw supervisorError("STIM_SUPERVISOR_EXITED", "The owned Metro supervisor could not be stopped for a cache reset.", "Inspect `stim status` and `stim logs`, then retry. No cache reset was recorded.");
+		case "port-occupied": throw supervisorError("STIM_SUPERVISOR_EXITED", `Port ${getProject(root)?.metroPort} is still occupied after stopping Metro.`, "Inspect the listener before retrying. Stim does not terminate unrecorded processes.");
 	}
-	return failures;
-}
-function sizeText(bytes) {
-	return bytes === null ? "size unknown" : formatBytes(bytes);
 }
 //#endregion
 //#region src/budget.ts
@@ -2178,7 +2168,7 @@ function machineNumber(key, config, env) {
 			error: null
 		};
 	}
-	if (env.STIM_HOME && setting.scopedHomeValue !== void 0) return {
+	if (env.STIM_HOME && typeof setting.scopedHomeValue === "number") return {
 		value: setting.scopedHomeValue,
 		error: null
 	};
@@ -2624,6 +2614,22 @@ async function enforceBudget({ root, note, dryRun = false, budget: resolved }, o
 		short
 	};
 }
+async function peekBudget(root, overrides = {}) {
+	const outcome = await enforceBudget({
+		root,
+		note: () => {},
+		dryRun: true
+	}, {
+		...overrides,
+		step: async () => ({
+			targets: [],
+			failures: 0
+		})
+	});
+	if (outcome.status !== "ok") return outcome.refusal.message;
+	const shortfall = describeShortfall(outcome.budget, outcome.measure, outcome.short);
+	return shortfall.length ? shortfall.join("; ") : null;
+}
 async function budgetGate(args, overrides = {}) {
 	const outcome = await enforceBudget(args, overrides);
 	return {
@@ -2707,4 +2713,4 @@ function budgetLine(report) {
 	return `${report.volumes.length ? `${report.volumes.map((v) => `${v.freeGb} GB free on ${v.volume}`).join(", ")} (reclaims below ${Math.max(budget.minFreeDiskGb, budget.hardFloorDiskGb)} GB, ${budget.hardFloorDiskGb ? `refuses below ${budget.hardFloorDiskGb} GB` : "never refuses"})` : "disk budget off"}; ${report.memory ? `roughly ${report.memory.committedGb} GB of a ${budget.maxCommittedMemoryGb} GB memory budget committed` : "memory budget off"}`;
 }
 //#endregion
-export { discoverCaches as $, withAndroidAvdSizes as A, trimCaches as B, describeUnverifiableDevices as C, findStaleDeviceRecords as D, findOrphanedDevices as E, isWorkspacesScope as F, memoryCacheKind as G, WATCHMAN_KIND as H, planCacheEmptying as I, memorySweepIsScoped as J, memoryLines as K, previewScopedEmptying as L, includesParkedDevices as M, includesRecordings as N, findStaleProjectDevices as O, includesWorkspaceOutputs as P, phase as Q, selectCaches as R, describeParkedSims as S, eraseParkedDevices as T, collectMemoryReport as U, GRADLE_DAEMONS_KIND as V, inspectWatchmanMemory as W, reclaimMemory as X, memoryWorkPending as Y, scopedMemoryReport as Z, collectParkedAvds as _, REBUILD_COST as a, deleteParkedSims as b, collectOrphanedWorkspaces as c, isInsideWorkspaces as d, sizeCaches as et, listWorkspaceDirs as f, collectDeviceLeases as g, DEVICE_LIST_TIMEOUT_MS$1 as h, machineNumber as i, emptyCaches as j, unverifiedDeviceCommand as k, collectWorkspaceOutputs as l, sizeText as m, budgetLine as n, WORKSPACE_OUTPUT_DIRS as o, rootPresence as p, memoryScope as q, inspectBudget as r, clearWorkspaceOutputs as s, budgetGate as t, stopOwnedMetroForReset as tt, deleteOrphanedWorkspaces as u, collectParkedSims as v, deviceSweepIsScoped as w, deleteProjectDevices as x, deleteParkedAvds as y, selectsBeyondCaches as z };
+export { includesWorkspaceOutputs as A, inspectWatchmanMemory as B, findStaleProjectDevices as C, includesArchives as D, emptyCaches as E, selectsBeyondCaches as F, memoryWorkPending as G, memoryLines as H, trimCaches as I, phase as J, reclaimMemory as K, GRADLE_DAEMONS_KIND as L, planCacheEmptying as M, previewScopedEmptying as N, includesParkedDevices as O, selectCaches as P, sizeCaches as Q, WATCHMAN_KIND as R, findStaleDeviceRecords as S, withAndroidAvdSizes as T, memoryScope as U, memoryCacheKind as V, memorySweepIsScoped as W, readFootprints as X, attributeMachineUsage as Y, discoverCaches as Z, describeParkedSims as _, machineNumber as a, eraseParkedDevices as b, resolveBudget as c, collectDeviceLeases as d, collectParkedAvds as f, deleteProjectDevices as g, deleteParkedSims as h, inspectBudget as i, isWorkspacesScope as j, includesRecordings as k, stopOwnedMetroForReset as l, deleteParkedAvds as m, budgetLine as n, peekBudget as o, collectParkedSims as p, scopedMemoryReport as q, enforceBudget as r, readVolumeSpace as s, budgetGate as t, DEVICE_LIST_TIMEOUT_MS$1 as u, describeUnverifiableDevices as v, unverifiedDeviceCommand as w, findOrphanedDevices as x, deviceSweepIsScoped as y, collectMemoryReport as z };