stim 1.14.0 → 1.16.0

package/dist/{gc-ko6mUAYD.mjs → gc-Bqy4bjEu.mjs}

@@ -1,29 +1,120 @@
-import { A as ownership_claim_exports, E as withConfigLock$1, I as volumeRootFor, M as formatBytes, N as isOnMountedVolume, P as listMountedVolumes, U as projectDeviceSlots, _ as loadConfig$1, j as directorySize, k as acquireAvdClaim, p as getProject, x as removeProject } from "./config-lvc7d3C2.mjs";
-import { t as getExecutor } from "./exec-DK8KaVHK.mjs";
-import { F as withDirLock, M as workspaceLogsDir, P as workspaceStateFile, k as workspaceDir, y as workspaceLastUsed } from "./metro-CcEo8Fl8.mjs";
-import { C as sourceCheckoutOf, b as resolveFullRef, d as hasUncommittedWork, l as hasPopulatedSubmodules, m as listWorktrees, o as dirtyPaths, w as unpushedCommits } from "./worktree-BVrHsYZG.mjs";
-import { a as findProjectRoot, r as detectIsExpo } from "./project-CWlvEaeN.mjs";
-import { h as shortUdid, o as formatLongDuration, u as plural } from "./command-output-DVcpw6eE.mjs";
-import { d as removeExpiredLease, h as listBuildLocks, i as listLeaseFiles, r as leaseIsExpired } from "./device-lease-5c3WrVRm.mjs";
-import { A as listInstalledSystemImages, B as parseAvdDeviceProfile, F as ownedAvdDirectory, R as ownedAvdSerialResolver, V as parseAvdSystemImage, a as androidHome, ct as parkedMaxSetting, f as avdIniPaths, g as avdStorageRoots, j as listOrphanedAvdDirectories, k as listAvds, lt as readParked, nt as isStimOwnedSim, p as avdNameAbsent, rt as POOL_SETTING_REMEDY, tt as isStimOwnedAvd, u as androidToolPath } from "./android-d6rGq1pA.mjs";
-import { n as readCreatedDevices$1, t as forgetCreatedDevice } from "./created-devices-CllH_8eb.mjs";
-import { l as listAllIosSims } from "./ios-BwDPrnYQ.mjs";
-import { a as parseIdleDuration, c as recordGcResult, l as takeGcResults, o as shutDownIdleDevices, r as idleDeviceLines, t as collectIdleDevices } from "./idle-DXtx3RbX.mjs";
-import { i as canonicalPath, n as withIdleWorkspace, o as listBuildSlots, r as workspaceInUse } from "./in-use-DlqBDKqY.mjs";
-import { r as readCollectors } from "./ownership-DyYDF5ww.mjs";
-import { f as resolveEasCliBin } from "./remote-cache-CcR6o6lI.mjs";
-import { A as findOrphanedOwnedSessions, C as withEasProjectLock, E as removeEasSessionClaim, I as parseSessionListPage, L as stopSessionArgs, M as inspectSessionForTeardown, N as isDefinitiveMissingSessionError, P as listOwnedSessionsArgs, R as verifyStoppedSession, T as readEasSessionLedger$1, d as withRemoteSessionLock, j as getSessionArgs, w as easMachineStateRoot$1 } from "./device-remote-D87zEzaq.mjs";
-import { A as includesWorkspaceOutputs, C as deviceSweepIsScoped, D as unverifiedDeviceCommand, E as findStaleProjectDevices, F as sizeCaches, M as selectCaches, N as trimCaches, O as withAndroidAvdSizes, P as discoverCaches, S as describeUnverifiableDevices, T as findStaleDeviceRecords, _ as collectParkedSims, a as REBUILD_COST, b as deleteProjectDevices, c as collectOrphanedWorkspaces, d as isInsideWorkspaces, f as listWorkspaceDirs, g as collectParkedAvds, h as collectDeviceLeases, i as machineNumber, j as planCacheEmptying, k as emptyCaches, l as collectWorkspaceOutputs, m as DEVICE_LIST_TIMEOUT_MS, o as WORKSPACE_OUTPUT_DIRS, p as sizeText, s as clearWorkspaceOutputs, u as deleteOrphanedWorkspaces, v as deleteParkedAvds, w as findOrphanedDevices, x as describeParkedSims, y as deleteParkedSims } from "./budget-CGDkhvv_.mjs";
-import { _ as reclaimProject, a as reclaimKeys, d as removeWorktreeTarget, g as describeDereferenced, h as pullRequestLookups, m as endedPullRequest, n as excludePodChurn, p as describePullRequest, r as matchWorktreeEntry } from "./worktree-UrQWXSeb.mjs";
-import { n as mergeState, t as fetchDefaultBranch } from "./merge-state-ytFQCeh4.mjs";
-import { existsSync, lstatSync, readFileSync, readdirSync, statSync } from "node:fs";
-import { InvalidArgumentError } from "commander";
-import { closeSync as closeSync$1, existsSync as existsSync$1, openSync as openSync$1, readFileSync as readFileSync$1, readSync as readSync$1, readdirSync as readdirSync$1, renameSync as renameSync$1, rmSync as rmSync$1, statSync as statSync$1, utimesSync, writeFileSync as writeFileSync$1 } from "fs";
-import { basename, dirname, isAbsolute, join } from "path";
+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, S as removeProject, _ as loadConfig$1, j as formatBytes, k as acquireAvdClaim, p as getProject } from "./config-D0DbpZtM.mjs";
+import { n as ownership_claim_exports } from "./process-identity-BmRm1qV0.mjs";
+import { n as describePullRequest, o as pullRequestLookups, r as endedPullRequest } from "./pull-request-pxnDCQzn.mjs";
+import { h as shortUdid, o as formatLongDuration, u as plural } from "./command-output-DnJMdEY-.mjs";
+import { _t as resolveFullRef, bt as sourceCheckoutOf, ct as hasUncommittedWork, dt as listWorktrees, ot as hasPopulatedSubmodules, rt as dirtyPaths, xt as unpushedCommits } from "./settings-oTSkkNrM.mjs";
+import { o as findProjectRoot$1, r as detectIsExpo } from "./project-Du91Ilvc.mjs";
+import { C as workspaceStateFile, s as workspaceLastUsed, v as workspaceDir, w as withDirLock$1, x as workspaceLogsDir$1 } from "./workspace-state-B8-aJ1_5.mjs";
+import { A as isWorkspacesScope, B as memoryCacheKind, C as unverifiedDeviceCommand, D as includesParkedDevices, E as includesArchives, F as trimCaches, G as reclaimMemory, H as memoryScope, K as scopedMemoryReport, M as previewScopedEmptying, N as selectCaches, O as includesRecordings, P as selectsBeyondCaches, R as collectMemoryReport, S as findStaleProjectDevices, T as emptyCaches, U as memorySweepIsScoped, V as memoryLines, W as memoryWorkPending, X as discoverCaches, Z as sizeCaches, _ as describeUnverifiableDevices, a as machineNumber, b as findOrphanedDevices, d as collectParkedAvds, f as collectParkedSims, g as describeParkedSims, h as deleteProjectDevices, j as planCacheEmptying, k as includesWorkspaceOutputs, l as DEVICE_LIST_TIMEOUT_MS, m as deleteParkedSims, p as deleteParkedAvds, q as phase, u as collectDeviceLeases, v as deviceSweepIsScoped, w as withAndroidAvdSizes, x as findStaleDeviceRecords, y as eraseParkedDevices } from "./budget-DjrURfQn.mjs";
+import { a as takeGcResults, i as recordGcResult, n as withIdleWorkspace, o as canonicalPath, r as workspaceInUse } from "./in-use-DvBw0Kxo.mjs";
+import { d as removeExpiredLease, h as listBuildLocks, i as listLeaseFiles, r as leaseIsExpired } from "./device-lease-D-hLqx1b.mjs";
+import { n as listBuildSlots } from "./build-slots-rUk77xqh.mjs";
+import { a as parseIdleDuration, o as shutDownIdleDevices, r as idleDeviceLines, t as collectIdleDevices } from "./idle-DYVymG92.mjs";
+import { n as readCreatedDevices$1, t as forgetCreatedDevice } from "./created-devices-D5owjN4C.mjs";
+import { A as listAvds, H as parseAvdSystemImage, I as ownedAvdDirectory, M as listOrphanedAvdDirectories, V as parseAvdDeviceProfile, _ as avdStorageRoots, at as isStimOwnedSim, d as androidToolPath, ft as parkedMaxSetting, it as isStimOwnedAvd, j as listInstalledSystemImages, m as avdNameAbsent, o as androidHome, ot as POOL_SETTING_REMEDY, p as avdIniPaths, pt as readParked, z as ownedAvdSerialResolver } from "./android-B_NumVyQ.mjs";
+import { u as listAllIosSims } from "./ios-BaInn3sW.mjs";
+import { a as collectWorkspaceOutputs, c as listWorkspaceDirs, i as collectOrphanedWorkspaces, l as rootPresence, n as WORKSPACE_OUTPUT_DIRS, o as deleteOrphanedWorkspaces, r as clearWorkspaceOutputs, s as isInsideWorkspaces, t as REBUILD_COST, u as sizeText } from "./workspaces-BV4pdHFz.mjs";
+import { n as previewMaintenance } from "./preview-DhVbvPAZ.mjs";
+import { r as readCollectors } from "./ownership-DiA16AsN.mjs";
+import { f as resolveEasCliBin } from "./remote-cache-C8-V13XN.mjs";
+import { C as listOwnedSessionsArgs, D as verifyStoppedSession, E as stopSessionArgs, S as isDefinitiveMissingSessionError, T as parseSessionListPage, b as getSessionArgs, d as withRemoteSessionLock, f as withEasProjectLock, h as removeEasSessionClaim, m as readEasSessionLedger$1, p as easMachineStateRoot$1, x as inspectSessionForTeardown, y as findOrphanedOwnedSessions } from "./device-remote-D5WVWqOq.mjs";
+import { o as fetchDefaultBranch, s as mergeState } from "./warm-progress-CpGv3Wb6.mjs";
+import { _ as deleteSelectedArchives, f as removeWorktreeTarget, g as reclaimProject, h as describeDereferenced, i as matchWorktreeEntry, n as excludePodChurn, o as reclaimKeys, r as excludeWatchmanCookies, v as sweepArchiveStaging } from "./worktree-K-xj9Db0.mjs";
+import { i as getSwiftpmCacheUsage, n as swiftpmCacheLines, r as getAgentDeviceUsage, t as agentDeviceLines } from "./agent-device-usage-output-Dpih1Tfa.mjs";
+import { existsSync, lstatSync, readFileSync, readdirSync, rmSync, statSync } from "node:fs";
+import { basename, dirname, join } from "node:path";
+import { closeSync as closeSync$1, existsSync as existsSync$1, openSync as openSync$1, readFileSync as readFileSync$1, readSync as readSync$1, readdirSync as readdirSync$1, renameSync as renameSync$1, rmSync as rmSync$1, statSync as statSync$1, utimesSync as utimesSync$1, writeFileSync as writeFileSync$1 } from "fs";
+import { basename as basename$1, dirname as dirname$1, isAbsolute as isAbsolute$1, join as join$1 } from "path";
 import { LOG_ROTATE_BYTES, rotatedLogPath } from "@stim-cli/core";
-import { settingDefinition } from "@stim-cli/core/state";
-import { dirname as dirname$1, join as join$1 } from "node:path";
+import { InvalidArgumentError } from "commander";
+import { listRecordedDevices, listStatusCacheEntries, maintenanceRunClaims, readArchives, recordedBytes, settingDefinition } from "@stim-cli/core/state";
 import chalk from "chalk";
+//#region src/commands/gc/archives.ts
+function stagingOrNone() {
+	try {
+		return sweepArchiveStaging(false, 5e3);
+	} catch {
+		return [];
+	}
+}
+function collectArchives(scope, olderThan, now) {
+	const wanted = scope.trim().toLowerCase();
+	const records = readArchives();
+	const id = wanted.startsWith("archived:") ? scope.trim().slice(9) : null;
+	const kind = wanted === "archived-logs" ? "logs" : wanted === "archived-recordings" ? "recordings" : wanted === "archived-agent" ? "agentActions" : null;
+	const match = id !== null ? records.find((record) => record.id.toLowerCase() === id.toLowerCase()) : null;
+	return {
+		records: records.filter((record) => id === null || record.id === match?.id).map((record) => ({
+			id: record.id,
+			kinds: kind ? [kind] : [
+				"logs",
+				"recordings",
+				"agentActions",
+				"record"
+			].filter((key) => record.bytes[key] > 0),
+			bytes: kind ? record.bytes[kind] : record.bytes.total,
+			expires: record.expires,
+			willDelete: (id === null && olderThan !== null ? now - Date.parse(record.removedAt) >= olderThan * 864e5 : true) && (!kind || record.bytes[kind] > 0)
+		})),
+		staging: stagingOrNone(),
+		unknownId: id !== null && !match ? id : null,
+		knownIds: records.map((record) => record.id),
+		kind
+	};
+}
+function archiveLines(selection) {
+	if (!selection) return [];
+	return [
+		`Archived workspaces (${selection.records.length}):`,
+		...selection.records.map((record) => `  ${record.id}: ${record.kinds.join(", ")}, ${formatBytes(record.bytes)}, expires ${JSON.stringify(record.expires)}${record.willDelete ? "" : " (kept)"}`),
+		...selection.staging.map((entry) => `  ${entry.path}: ${entry.kept ? `kept: ${entry.reason}` : "abandoned staging"}${entry.removeCommand ? `; ${entry.removeCommand}` : ""}`)
+	];
+}
+function deleteArchives(selection) {
+	if (!selection) return 0;
+	let failures = 0;
+	for (const record of selection.records.filter((entry) => entry.willDelete)) try {
+		deleteSelectedArchives([record.id], selection.kind);
+		recordGcResult("archive", "done", record.id, {
+			id: record.id,
+			bytes: record.bytes
+		});
+	} catch (error) {
+		failures++;
+		recordGcResult("archive", "failed", record.id, {
+			id: record.id,
+			detail: error.message
+		});
+		console.error(`Could not delete ${record.id}: ${error.message}`);
+	}
+	try {
+		const remaining = new Set(sweepArchiveStaging(true, 5e3).map((entry) => entry.path));
+		for (const entry of selection.staging) if (!entry.kept && !remaining.has(entry.path)) recordGcResult("archive", "done", "archive staging", { id: entry.path });
+	} catch (error) {
+		failures++;
+		console.error(`Could not clear archive staging: ${error.message}`);
+	}
+	return failures;
+}
+function archiveRefusal(selection) {
+	if (selection?.unknownId === void 0 || selection.unknownId === null) return null;
+	process.exitCode = 1;
+	const message = `Unknown archive "${selection.unknownId}".`;
+	const remedy = `Known archive ids: ${selection.knownIds.join(", ") || "(none)"}`;
+	console.error(chalk.red(message));
+	console.error(chalk.dim(remedy));
+	console.error(chalk.red("failed: STIM_BAD_ARG"));
+	return {
+		code: "STIM_BAD_ARG",
+		message,
+		remedy
+	};
+}
+function archiveWorkPending(selection, otherWork) {
+	return otherWork || Boolean(selection?.records.some((record) => record.willDelete) || selection?.staging.some((entry) => !entry.kept));
+}
+//#endregion
 //#region src/commands/gc/eas-sessions.ts
 const EAS_OPERATION_TIMEOUT_MS = 3e4;
 const EAS_COLLECTION_TIMEOUT_MS = 6e4;
@@ -87,7 +178,7 @@ function readRecordedRemoteSessionIds(roots) {
 	};
 }
 function claimStateAbsence(claim) {
-	const stateDir = dirname(claim.stateFile);
+	const stateDir = dirname$1(claim.stateFile);
 	let entries;
 	try {
 		if (!statSync$1(stateDir).isDirectory()) throw new Error("path is not a directory");
@@ -98,7 +189,7 @@ function claimStateAbsence(claim) {
 			notice: `${stateDir} is not available for EAS ownership verification: ${describeError(error)}`
 		};
 	}
-	if (!entries.includes(basename(claim.stateFile))) return {
+	if (!entries.includes(basename$1(claim.stateFile))) return {
 		absent: true,
 		notice: null
 	};
@@ -135,7 +226,7 @@ function claimStateAbsence(claim) {
 	};
 }
 function collectEasSessionSweep(config, deps) {
-	const projectRoot = (deps.findProjectRoot ?? findProjectRoot)(process.cwd());
+	const projectRoot = (deps.findProjectRoot ?? findProjectRoot$1)(process.cwd());
 	const empty = (notices = []) => ({
 		projectScope: projectRoot,
 		orphaned: [],
@@ -230,7 +321,7 @@ function unavailableLockRootNotice(roots) {
 }
 function malformedRemoteSessionLockNotice(roots) {
 	for (const root of roots) {
-		const lockPath = join(workspaceDir(root), "remote-session.lock");
+		const lockPath = join$1(workspaceDir(root), "remote-session.lock");
 		if (!existsSync$1(lockPath)) continue;
 		if ((0, ownership_claim_exports.readClaimSet)(lockPath).unresolved.length === 0) continue;
 		return `EAS session sweep skipped: the remote-session lock at ${lockPath} has a malformed owner record.`;
@@ -443,7 +534,7 @@ async function deleteEasSessions(easSessionSweep, deps) {
 //#endregion
 //#region src/commands/gc/worktrees.ts
 const DEFAULT_WORKTREE_IDLE_DAYS = 7;
-const DAY_MS = 864e5;
+const DAY_MS$1 = 864e5;
 const MINUTE_MS = 6e4;
 const GRACE_SETTING = "gc.worktreeGraceMinutes";
 const MERGE_DECIDES = /* @__PURE__ */ new Set([
@@ -504,7 +595,7 @@ function removalBlocker(facts, olderThan) {
 	if (facts.locked) return skip("locked", "locked with git worktree lock");
 	if (facts.inUse.length) return skip("in-use", `in use: ${facts.inUse.join("; ")}`);
 	if (facts.porcelain === null) return skip("status-unreadable", "git status could not be read");
-	const dirty = excludePodChurn(facts.porcelain).lines.length;
+	const dirty = excludePodChurn(excludeWatchmanCookies(facts.porcelain).lines).lines.length;
 	if (dirty) return skip("dirty", `dirty: ${plural(dirty, "uncommitted or untracked file")}`);
 	if (facts.unpushed === null) return skip("unpushed-unchecked", "unpushed commits could not be checked");
 	const merged = facts.merge?.merged ? facts.merge : null;
@@ -536,7 +627,7 @@ function lastUsedOf(keys) {
 }
 function idleDaysOf(keys, now) {
 	const last = lastUsedOf(keys);
-	return Number.isFinite(last) ? Math.max(0, Math.floor((now - last) / DAY_MS)) : null;
+	return Number.isFinite(last) ? Math.max(0, Math.floor((now - last) / DAY_MS$1)) : null;
 }
 function deviceReads() {
 	let sims;
@@ -605,10 +696,10 @@ function newestMtime(paths) {
 	return newest;
 }
 function logFiles$1(key) {
-	const dir = workspaceLogsDir(key);
+	const dir = workspaceLogsDir$1(key);
 	try {
 		return readdirSync$1(dir).map((name) => ({
-			path: join(dir, name),
+			path: join$1(dir, name),
 			basis: "a Stim log write"
 		}));
 	} catch (error) {
@@ -627,15 +718,15 @@ function worktreeActivityOf(path, keys) {
 	if (!gitDir) return null;
 	const paths = [
 		{
-			path: join(gitDir, "index"),
+			path: join$1(gitDir, "index"),
 			basis: "a git index write"
 		},
 		{
-			path: join(gitDir, "HEAD"),
+			path: join$1(gitDir, "HEAD"),
 			basis: "a git HEAD change"
 		},
 		{
-			path: join(gitDir, "logs", "HEAD"),
+			path: join$1(gitDir, "logs", "HEAD"),
 			basis: "a git reflog entry"
 		}
 	];
@@ -666,7 +757,7 @@ function porcelainOf(path, gitAnswered) {
 	return lines.length ? lines : null;
 }
 function candidateRoots() {
-	const registered = Object.keys(loadConfig$1()?.projects ?? {}).filter(isAbsolute);
+	const registered = Object.keys(loadConfig$1()?.projects ?? {}).filter(isAbsolute$1);
 	const recorded = listWorkspaceDirs().flatMap((entry) => entry.projectRoot ? [entry.projectRoot] : []);
 	return [.../* @__PURE__ */ new Set([...registered, ...recorded])].filter((root) => existsSync$1(root)).toSorted();
 }
@@ -708,7 +799,9 @@ async function collectWorktreeSweep({ idle, olderThan, now }) {
 	};
 	const groups = /* @__PURE__ */ new Map();
 	const outside = [];
-	for (const root of candidateRoots()) {
+	const candidates = candidateRoots();
+	if (candidates.length) phase("worktrees", `checking ${plural(candidates.length, "project")} for merged or idle worktrees`);
+	for (const root of candidates) {
 		const entry = matchWorktreeEntry(listWorktrees(root), root);
 		if (!entry) {
 			outside.push({
@@ -879,6 +972,206 @@ async function removeWorktrees(sweep, { now = Date.now() } = {}) {
 	return failures;
 }
 //#endregion
+//#region src/commands/gc/status-caches.ts
+const KINDS = ["disk-usage", "pull-request"];
+const KEPT_REASON = {
+	unreadable: "the file records no readable path of its own",
+	unknown: "Stim cannot tell whether the folder it measures still exists",
+	unmounted: "the volume of the folder it measures is not mounted"
+};
+function witnessPath(path) {
+	return basename(path).startsWith("node_modules") ? dirname(path) : path;
+}
+function judge(path, mountedVolumes) {
+	if (path === null) return "unreadable";
+	const witness = witnessPath(path);
+	const present = rootPresence(witness);
+	if (present === null) return "unknown";
+	if (present) return "present";
+	return isOnMountedVolume(witness, mountedVolumes) ? "gone" : "unmounted";
+}
+function classifyStatusCaches(entries, mountedVolumes) {
+	const stale = [];
+	const kept = /* @__PURE__ */ new Map();
+	for (const { kind, file, path, bytes } of entries) {
+		const verdict = judge(path, mountedVolumes);
+		if (verdict === "present") continue;
+		if (verdict === "gone") {
+			stale.push({
+				kind,
+				file,
+				path,
+				bytes
+			});
+			continue;
+		}
+		const dir = dirname(file);
+		const key = `${dir}\n${verdict}`;
+		const seen = kept.get(key);
+		if (seen) seen.count++;
+		else kept.set(key, {
+			dir,
+			verdict,
+			count: 1
+		});
+	}
+	return {
+		stale,
+		skipped: [...kept.values()].map(({ dir, verdict, count }) => ({
+			dir,
+			reason: `${count} entr${count === 1 ? "y" : "ies"} kept: ${KEPT_REASON[verdict]}`
+		}))
+	};
+}
+function collectStaleStatusCaches(mountedVolumes) {
+	return classifyStatusCaches(listStatusCacheEntries(), mountedVolumes);
+}
+function statusCacheLines(stale) {
+	if (!stale.length) return [];
+	const total = stale.reduce((sum, entry) => sum + entry.bytes, 0);
+	const lines = [`Stale status cache entries (${stale.length}, ${formatBytes(total)}) - the folder or worktree they measure is gone:`];
+	for (const kind of KINDS) {
+		const count = stale.filter((entry) => entry.kind === kind).length;
+		if (count) lines.push(`  ${kind}: ${count}`);
+	}
+	lines.push("              --delete removes them; `stim status` measures a folder again if it comes back.");
+	return lines;
+}
+function deleteStaleStatusCaches(stale) {
+	const mountedVolumes = listMountedVolumes();
+	let failures = 0;
+	for (const kind of KINDS) {
+		let removed = 0;
+		let bytes = 0;
+		for (const entry of stale.filter((candidate) => candidate.kind === kind)) {
+			if (judge(entry.path, mountedVolumes) !== "gone") continue;
+			try {
+				rmSync(entry.file, { force: true });
+				removed++;
+				bytes += entry.bytes;
+			} catch (error) {
+				failures++;
+				const detail = error?.message || String(error);
+				console.log(chalk.red(`Could not remove ${entry.file}: ${detail}`));
+				recordGcResult("statusCache", "failed", `${kind} cache entry`, {
+					id: entry.file,
+					detail
+				});
+			}
+		}
+		if (!removed) continue;
+		const label = `${removed} stale ${kind} cache entr${removed === 1 ? "y" : "ies"}`;
+		console.log(chalk.green(`Removed ${label}`));
+		recordGcResult("statusCache", "done", label, { bytes });
+	}
+	return failures;
+}
+//#endregion
+//#region src/commands/gc/recordings.ts
+const DAY_MS = 864e5;
+function oldSegments(devices, olderThan, now) {
+	const cutoff = now - olderThan * DAY_MS;
+	return devices.flatMap((device) => device.segments).filter((segment) => !segment.open && segment.end < cutoff);
+}
+function planRecordings(entries, { whole, olderThan, now }) {
+	return entries.map(({ recordings, projectRoot, problem, gone, devices }) => {
+		const bytes = recordedBytes(devices);
+		const entry = {
+			dir: recordings,
+			projectRoot,
+			bytes,
+			withWorkspace: false
+		};
+		const kept = (keptCode, keptReason) => ({
+			...entry,
+			deleteBytes: 0,
+			willDelete: false,
+			keptCode,
+			keptReason
+		});
+		const remove = (deleteBytes, withWorkspace = false) => ({
+			...entry,
+			withWorkspace,
+			deleteBytes,
+			willDelete: true,
+			keptCode: null,
+			keptReason: null
+		});
+		if (projectRoot === null) return kept("unresolved", `workspace directory not resolved: ${problem ?? "unknown project root"}`);
+		if (gone) return remove(bytes, true);
+		if (whole) return remove(bytes);
+		if (olderThan !== null) {
+			const old = oldSegments(devices, olderThan, now);
+			return old.length ? remove(old.reduce((sum, segment) => sum + segment.bytes, 0)) : kept("recently-recorded", `nothing recorded more than ${olderThan}d ago`);
+		}
+		return kept("retained", "the last 15 minutes of footage per device stay until worktree remove, --cache recordings, --older-than or recording.enabled false");
+	});
+}
+/**
+* The device recordings of every workspace directory. Recordings in `gone` directories, which the orphaned
+* workspace and dead project sweeps remove whole, are listed with them; entries whose project root is on an
+* unmounted volume are left out.
+*/
+function collectRecordings(plan, gone = []) {
+	const mountedVolumes = listMountedVolumes();
+	return planRecordings(listWorkspaceDirs().filter((entry) => entry.projectRoot === null || isOnMountedVolume(entry.projectRoot, mountedVolumes)).map((entry) => Object.assign({}, entry, { recordings: join$1(entry.dir, "recordings") })).filter((entry) => existsSync$1(entry.recordings)).map((entry) => Object.assign({}, entry, {
+		gone: gone.includes(entry.dir),
+		devices: listRecordedDevices(entry.recordings)
+	})), plan);
+}
+/** Deletes what `planRecordings` chose, planning again from the files on disk. */
+function deleteRecordings(report, plan) {
+	let failures = 0;
+	for (const entry of report) {
+		const label = entry.projectRoot ?? entry.dir;
+		if (entry.withWorkspace) continue;
+		if (!entry.willDelete) {
+			if (entry.keptCode === "unresolved" || entry.keptCode === "recently-recorded") {
+				console.log(chalk.dim(`Kept the device recordings of ${label}: ${entry.keptReason}`));
+				recordGcResult("recording", "kept", label, {
+					bytes: entry.bytes,
+					detail: entry.keptReason
+				});
+			}
+			continue;
+		}
+		try {
+			let deleted = 0;
+			if (plan.whole) {
+				deleted = recordedBytes(listRecordedDevices(entry.dir));
+				rmSync$1(entry.dir, {
+					recursive: true,
+					force: true
+				});
+			} else if (plan.olderThan !== null) for (const segment of oldSegments(listRecordedDevices(entry.dir), plan.olderThan, plan.now)) {
+				rmSync$1(segment.file, { force: true });
+				deleted += segment.bytes;
+			}
+			console.log(chalk.green(`Deleted ${formatBytes(deleted)} of device recordings of ${label}`));
+			recordGcResult("recording", "done", label, { bytes: deleted });
+		} catch (error) {
+			failures++;
+			const detail = error?.message || String(error);
+			console.log(chalk.red(`Could not delete the device recordings of ${label}: ${detail}`));
+			recordGcResult("recording", "failed", label, {
+				bytes: entry.bytes,
+				detail
+			});
+		}
+	}
+	return failures;
+}
+function recordingLines(recordings) {
+	if (!recordings.length) return [];
+	const total = recordings.reduce((sum, entry) => sum + entry.bytes, 0);
+	const lines = [`Device recordings (${formatBytes(total)} in ${recordings.length}):`];
+	for (const entry of recordings) {
+		lines.push(`  ${formatBytes(entry.bytes).padStart(10)}  ${entry.projectRoot ?? entry.dir}`);
+		lines.push(entry.withWorkspace ? "              would be DELETED with its gone workspace directory" : entry.willDelete ? `              would DELETE ${formatBytes(entry.deleteBytes)}` : `              kept: ${entry.keptReason}`);
+	}
+	return lines;
+}
+//#endregion
 //#region src/commands/gc/report.ts
 function shortKey(key) {
 	const text = String(key ?? "");
@@ -889,7 +1182,12 @@ function parkedAge(parkedAt, now) {
 	if (!Number.isFinite(at)) return "parked at an unknown time";
 	return `parked ${formatLongDuration(Math.max(0, now - at))} ago`;
 }
-function formatParkedSimReport(parkedSims, now) {
+const PARKED_DELETE_NOTE = "              --delete attempts verified deletions and keeps failures.";
+const PARKED_ERASE_NOTE = "              --delete erases each verified device (apps and data) and keeps it parked.";
+function parkedApp(app) {
+	return app ? ` ${app}` : "";
+}
+function formatParkedSimReport(parkedSims, now, erase) {
 	if (parkedSims.length === 0) return [];
 	const known = parkedSims.filter((sim) => sim.bytes !== null);
 	const total = known.reduce((sum, sim) => sum + (sim.bytes ?? 0), 0);
@@ -900,20 +1198,20 @@ function formatParkedSimReport(parkedSims, now) {
 		const age = parkedAge(sim.parkedAt, now);
 		const bytes = sim.bytes === null ? "" : ` ${formatBytes(sim.bytes)}`;
 		const gone = sim.listed === false ? " - not on this machine" : sim.listed === null ? " - listing unavailable; kept" : "";
-		lines.push(`  ios ${sim.name} (${shortUdid(sim.udid)})${model ? ` ${model}` : ""} ${age}${bytes}${gone}`);
+		lines.push(`  ios ${sim.name} (${shortUdid(sim.udid)})${model ? ` ${model}` : ""} ${age}${parkedApp(sim.app)}${bytes}${gone}`);
 	}
-	lines.push("              --delete attempts verified deletions and keeps failures.");
+	lines.push(erase ? PARKED_ERASE_NOTE : PARKED_DELETE_NOTE);
 	return lines;
 }
-function formatParkedAvdReport(parkedAvds, now) {
+function formatParkedAvdReport(parkedAvds, now, erase) {
 	if (!parkedAvds.length) return [];
 	const lines = [];
 	lines.push(`Parked emulators (${parkedAvds.length}):`);
 	for (const avd of parkedAvds) {
 		const listed = avd.listed === false ? " - not on this machine" : avd.listed === null ? " - listing unavailable; kept" : "";
-		lines.push(`  android ${avd.name} ${avd.systemImage}${avd.deviceProfile ? ` ${avd.deviceProfile}` : ""} ${parkedAge(avd.parkedAt, now)}${avd.bytes === null ? "" : ` ${formatBytes(avd.bytes)}`}${listed}`);
+		lines.push(`  android ${avd.name} ${avd.systemImage}${avd.deviceProfile ? ` ${avd.deviceProfile}` : ""} ${parkedAge(avd.parkedAt, now)}${parkedApp(avd.app)}${avd.bytes === null ? "" : ` ${formatBytes(avd.bytes)}`}${listed}`);
 	}
-	lines.push("              --delete attempts verified deletions and keeps failures.");
+	lines.push(erase ? PARKED_ERASE_NOTE : PARKED_DELETE_NOTE);
 	return lines;
 }
 function projectEntryLines(header, paths) {
@@ -928,7 +1226,23 @@ function unresolvedLockLines(locks, slots) {
 		"              run that yourself once you know nothing is building with it"
 	];
 }
-function formatGcReport({ skipped = [], deadProjects = [], orphanedPorts, invalidProjects = [], orphanedWorkspaces = [], parkedSims = [], parkedAvds = [], orphanedDevices = [], unverifiedDevices = [], staleDevices = [], staleDeviceRecords = [], staleLedgerEntries = [], buildLocks = {
+function scopeLine(cacheScope) {
+	if (memoryCacheKind(cacheScope)) return `Cache scope: "${cacheScope}". Only these helper processes were inspected.`;
+	return includesParkedDevices(cacheScope) ? `Cache scope: "${cacheScope}". Unparked devices, project entries and locks were not inspected.` : `Cache scope: "${cacheScope}". Devices, project entries and locks were not inspected.`;
+}
+function maintenanceReportLines(maintenance) {
+	const lines = [];
+	if (maintenance) {
+		lines.push(`Automatic maintenance (${maintenance.mode === "report" ? "report only" : "off"}):`);
+		if (maintenance.note) lines.push(`  ${maintenance.note}`);
+		for (const action of maintenance.actions) lines.push(`  ${action.kind}: ${action.target} (${formatBytes(action.bytes)}): ${action.reason}`);
+		for (const skip of maintenance.skips) lines.push(`  kept ${skip.target}: ${skip.reason}`);
+		for (const reason of maintenance.blocked) lines.push(`  blocked: ${reason}`);
+		if (!maintenance.actions.length && !maintenance.blocked.length) lines.push("  no actions planned");
+	}
+	return lines;
+}
+function formatGcReport({ maintenance, archives, skipped = [], deadProjects = [], orphanedPorts, invalidProjects = [], orphanedWorkspaces = [], parkedSims = [], parkedAvds = [], orphanedDevices = [], unverifiedDevices = [], staleDevices = [], staleDeviceRecords = [], staleLedgerEntries = [], staleStatusCaches = [], buildLocks = {
 	stale: [],
 	live: [],
 	unresolved: []
@@ -944,13 +1258,13 @@ function formatGcReport({ skipped = [], deadProjects = [], orphanedPorts, invali
 	orphaned: [],
 	notices: [],
 	deletionSafe: true
-}, caches = [], workspaceOutputs = null, workspaceLogs = [], worktreeSweep = null, cacheScope = null, olderThan = null }, { now = Date.now() } = {}) {
-	const lines = [];
+}, agentDeviceUsage = null, swiftpmCacheUsage, caches = [], workspaceOutputs = null, workspaceLogs = [], recordings = [], worktreeSweep = null, memory, cacheScope = null, olderThan = null }, { now = Date.now() } = {}) {
+	const lines = archiveLines(archives);
 	const staleLocks = buildLocks?.stale ?? [];
 	const liveLocks = buildLocks?.live ?? [];
 	const staleSlots = buildSlots?.stale ?? [];
 	const expiredLeases = deviceLeases?.expired ?? [];
-	if (cacheScope) lines.push(`Cache scope: "${cacheScope}". Devices, project entries and locks were not inspected.`);
+	if (cacheScope) lines.push(scopeLine(cacheScope));
 	else if ([
 		deadProjects,
 		invalidProjects,
@@ -961,6 +1275,7 @@ function formatGcReport({ skipped = [], deadProjects = [], orphanedPorts, invali
 		staleDevices,
 		staleDeviceRecords,
 		staleLedgerEntries,
+		staleStatusCaches,
 		staleLocks,
 		staleSlots,
 		expiredLeases,
@@ -981,8 +1296,8 @@ function formatGcReport({ skipped = [], deadProjects = [], orphanedPorts, invali
 	lines.push(...namedPortLines(orphanedPorts));
 	lines.push(...orphanedWorkspaceLines(orphanedWorkspaces));
 	lines.push(...worktreeSweepLines(worktreeSweep));
-	lines.push(...formatParkedSimReport(parkedSims, now));
-	lines.push(...formatParkedAvdReport(parkedAvds, now));
+	lines.push(...formatParkedSimReport(parkedSims, now, cacheScope !== null));
+	lines.push(...formatParkedAvdReport(parkedAvds, now, cacheScope !== null));
 	if (orphanedDevices.length) {
 		lines.push(`Orphaned devices (${orphanedDevices.length}):`);
 		for (const d of orphanedDevices) lines.push(`  ${d.kind} ${d.name} (${d.id})${deviceSizeSuffix(d)}`);
@@ -1016,6 +1331,7 @@ function formatGcReport({ skipped = [], deadProjects = [], orphanedPorts, invali
 		for (const entry of staleLedgerEntries) lines.push(`  ${entry.kind} ${entry.id} is not on this machine`);
 		lines.push("              --delete forgets the LEDGER ENTRY only; there is no device left to touch.");
 	}
+	lines.push(...statusCacheLines(staleStatusCaches));
 	if (easSessionSweep.orphaned.length) {
 		lines.push(`Orphaned EAS sessions (${easSessionSweep.orphaned.length}) - current EAS project only:`);
 		for (const session of easSessionSweep.orphaned) {
@@ -1061,7 +1377,12 @@ function formatGcReport({ skipped = [], deadProjects = [], orphanedPorts, invali
 		for (const entry of skipped) lines.push(`  ${entry.dir}: ${entry.reason}`);
 	}
 	lines.push(...workspaceLogLines(workspaceLogs));
+	lines.push(...recordingLines(recordings));
 	lines.push(...cacheLines(caches, workspaceOutputs));
+	lines.push(...agentDeviceLines(agentDeviceUsage, true, now));
+	lines.push(...swiftpmCacheLines(swiftpmCacheUsage, now));
+	lines.push(...memoryLines(memory, memoryCacheKind(cacheScope), now));
+	lines.push(...maintenanceReportLines(maintenance));
 	return lines;
 }
 function workspaceLogLines(workspaceLogs) {
@@ -1117,7 +1438,7 @@ function workspaceOutputLines(outputs, bytes) {
 	const lines = [
 		`  ${formatBytes(bytes).padStart(10)}  Workspace build outputs (detected)`,
 		`              ${outputs.root}`,
-		`              ${WORKSPACE_OUTPUT_DIRS.join(", ")} of each workspace; workspace.json, state.json, logs and device records stay`,
+		`              ${WORKSPACE_OUTPUT_DIRS.join(", ")}, macOS Swift scratch and staged app bundles of each workspace; workspace.json, state.json, logs and device records stay`,
 		`              ${REBUILD_COST}`
 	];
 	for (const w of outputs.workspaces) {
@@ -1142,6 +1463,7 @@ function cacheLines(caches, workspaceOutputs) {
 			if (c.note) lines.push(`              ${c.note}`);
 			if (c.willEmpty) lines.push("              would be EMPTIED");
 			else if (c.emptySkipped) lines.push(`              would be left alone: ${c.emptySkipped}`);
+			else if (c.scopedEmpty?.emptySkipped) lines.push(`              --delete --cache would leave it alone: ${c.scopedEmpty.emptySkipped}`);
 		}
 		lines.push(`  total: ${formatBytes(total)}`);
 		const doomed = caches.filter((c) => c.willEmpty);
@@ -1191,7 +1513,7 @@ function jsonPullRequest(lookup) {
 		containsHead: pr.containsHead
 	} : null;
 }
-function gcReportSections({ skipped = [], deadProjects = [], orphanedPorts = [], invalidProjects = [], orphanedWorkspaces = [], worktreeSweep = null, parkedSims = [], parkedAvds = [], orphanedDevices = [], unverifiedDevices = [], staleDevices = [], staleDeviceRecords = [], staleLedgerEntries = [], buildLocks = {
+function gcReportSections({ archives, skipped = [], deadProjects = [], orphanedPorts = [], invalidProjects = [], orphanedWorkspaces = [], worktreeSweep = null, parkedSims = [], parkedAvds = [], orphanedDevices = [], unverifiedDevices = [], staleDevices = [], staleDeviceRecords = [], staleLedgerEntries = [], staleStatusCaches = [], buildLocks = {
 	stale: [],
 	live: [],
 	unresolved: []
@@ -1207,8 +1529,12 @@ function gcReportSections({ skipped = [], deadProjects = [], orphanedPorts = [],
 	orphaned: [],
 	notices: [],
 	deletionSafe: true
-}, workspaceOutputs = null, workspaceLogs = [], caches = [] }) {
+}, workspaceOutputs = null, workspaceLogs = [], recordings = [], agentDeviceUsage = null, swiftpmCacheUsage = null, caches = [], memory = null }) {
 	return {
+		...archives ? {
+			archived: archives.records,
+			archiveStaging: archives.staging
+		} : {},
 		deadProjects: deadProjects.map((path) => ({ path })),
 		invalidProjects: invalidProjects.map((path) => ({ path })),
 		orphanedPorts: orphanedPorts.map(({ project, label, port }) => ({
@@ -1232,20 +1558,22 @@ function gcReportSections({ skipped = [], deadProjects = [], orphanedPorts = [],
 			detail: w.skipped ?? worktreeRemovalReason(w),
 			eligibleAt: w.eligibleAt === null ? null : new Date(w.eligibleAt).toISOString()
 		})),
-		parkedSimulators: parkedSims.map(({ udid, name, model, runtime, parkedAt, bytes, listed }) => ({
+		parkedSimulators: parkedSims.map(({ udid, name, model, runtime, parkedAt, app, bytes, listed }) => ({
 			udid,
 			name,
 			model,
 			runtime,
 			parkedAt,
+			app,
 			bytes,
 			listed
 		})),
-		parkedEmulators: parkedAvds.map(({ name, systemImage, deviceProfile, parkedAt, bytes, listed }) => ({
+		parkedEmulators: parkedAvds.map(({ name, systemImage, deviceProfile, parkedAt, app, bytes, listed }) => ({
 			name,
 			systemImage,
 			deviceProfile,
 			parkedAt,
+			app,
 			bytes,
 			listed
 		})),
@@ -1281,6 +1609,12 @@ function gcReportSections({ skipped = [], deadProjects = [], orphanedPorts = [],
 			kind,
 			id
 		})),
+		staleStatusCaches: staleStatusCaches.map(({ kind, path, file, bytes }) => ({
+			kind,
+			path,
+			file,
+			bytes
+		})),
 		idleDevices: idleDevices.map(({ kind, id, name, project, slot, lastActivityAt, idleForMs, buildInProgress }) => ({
 			kind,
 			id,
@@ -1341,6 +1675,16 @@ function gcReportSections({ skipped = [], deadProjects = [], orphanedPorts = [],
 			reason: w.keptCode,
 			detail: w.keptReason
 		})),
+		recordings: recordings.map((r) => ({
+			dir: r.dir,
+			projectRoot: r.projectRoot,
+			bytes: r.bytes,
+			deleteBytes: r.deleteBytes,
+			willDelete: r.willDelete,
+			withWorkspace: r.withWorkspace,
+			reason: r.keptCode,
+			detail: r.keptReason
+		})),
 		workspaceBuildOutputs: (workspaceOutputs?.workspaces ?? []).map((w) => ({
 			dir: w.dir,
 			projectRoot: w.projectRoot,
@@ -1357,8 +1701,14 @@ function gcReportSections({ skipped = [], deadProjects = [], orphanedPorts = [],
 			bytes: c.bytes ?? null,
 			note: c.note || null,
 			willEmpty: Boolean(c.willEmpty),
-			emptySkipped: c.emptySkipped ?? null
-		}))
+			emptySkipped: c.emptySkipped ?? null,
+			scopedEmpty: c.scopedEmpty ?? null
+		})),
+		agentDevice: agentDeviceUsage,
+		swiftpmCache: swiftpmCacheUsage,
+		memory: memory?.processes ?? [],
+		watchmanRoots: memory?.watchmanRoots ?? [],
+		memoryNotices: (memory?.notices ?? []).map((message) => ({ message }))
 	};
 }
 //#endregion
@@ -1417,8 +1767,8 @@ function staleBrowserProfiles(ledger, exists = existsSync) {
 	}));
 }
 function isStaleProfile(path, exists) {
-	const workspace = dirname$1(dirname$1(path));
-	return !exists(path) && exists(dirname$1(workspace)) && !isDanglingLink(workspace);
+	const workspace = dirname(dirname(path));
+	return !exists(path) && exists(dirname(workspace)) && !isDanglingLink(workspace);
 }
 function isDanglingLink(path) {
 	try {
@@ -1464,7 +1814,7 @@ function fileSize(path) {
 }
 function cappedFiles(logsDir) {
 	return CAPPED_LOGS.flatMap((name) => {
-		const log = join(logsDir, name);
+		const log = join$1(logsDir, name);
 		return [{
 			file: log,
 			log
@@ -1490,14 +1840,14 @@ function collectWorkspaceLogs({ exclude = [] } = {}) {
 	for (const { dir, projectRoot, problem } of listWorkspaceDirs()) {
 		if (exclude.includes(dir)) continue;
 		if (projectRoot !== null && !isOnMountedVolume(projectRoot, mountedVolumes)) continue;
-		const logsDir = join(dir, "logs");
+		const logsDir = join$1(dir, "logs");
 		let names;
 		try {
 			names = readdirSync$1(logsDir);
 		} catch {
 			continue;
 		}
-		const bytes = names.reduce((sum, name) => sum + fileSize(join(logsDir, name)), 0);
+		const bytes = names.reduce((sum, name) => sum + fileSize(join$1(logsDir, name)), 0);
 		if (bytes === 0) continue;
 		const trimBytes = excess(logsDir);
 		let keptCode = null;
@@ -1532,7 +1882,7 @@ function collectWorkspaceLogs({ exclude = [] } = {}) {
 }
 function trimToNewest({ file, log }, maxBytes) {
 	if (!trimmable(fileSize(file))) return 0;
-	return withDirLock(`${log}.lock`, () => {
+	return withDirLock$1(`${log}.lock`, () => {
 		const { size, atime, mtime } = statSync$1(file);
 		if (!trimmable(size)) return 0;
 		const tail = Buffer.alloc(maxBytes);
@@ -1547,7 +1897,7 @@ function trimToNewest({ file, log }, maxBytes) {
 		const tmp = `${file}.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`;
 		try {
 			writeFileSync$1(tmp, kept);
-			utimesSync(tmp, atime, mtime);
+			utimesSync$1(tmp, atime, mtime);
 			renameSync$1(tmp, file);
 		} catch (error) {
 			rmSync$1(tmp, { force: true });
@@ -1575,7 +1925,7 @@ async function trimWorkspaceLogs(entries) {
 				};
 				return {
 					kept: null,
-					bytes: cappedFiles(join(entry.dir, "logs")).reduce((sum, capped) => sum + trimToNewest(capped, LOG_ROTATE_BYTES), 0)
+					bytes: cappedFiles(join$1(entry.dir, "logs")).reduce((sum, capped) => sum + trimToNewest(capped, LOG_ROTATE_BYTES), 0)
 				};
 			}, { purpose: "gc" });
 		} catch (error) {
@@ -1775,7 +2125,7 @@ function listAvdRecords(notices, roots = avdStorageRoots()) {
 			if (records.has(name)) continue;
 			let ini;
 			try {
-				ini = readFileSync(join$1(root, entry), "utf8");
+				ini = readFileSync(join(root, entry), "utf8");
 			} catch (error) {
 				if (!isMissing(error)) notices.push(unreadableNotice(`AVD ${name}`, error));
 				continue;
@@ -1784,7 +2134,7 @@ function listAvdRecords(notices, roots = avdStorageRoots()) {
 			let config = "";
 			let unreadable = null;
 			for (const candidate of avdIniPaths(root, ini)) try {
-				config = readFileSync(join$1(candidate, "config.ini"), "utf8");
+				config = readFileSync(join(candidate, "config.ini"), "utf8");
 				directory = candidate;
 				break;
 			} catch (error) {
@@ -1796,7 +2146,7 @@ function listAvdRecords(notices, roots = avdStorageRoots()) {
 				directory,
 				systemImage: parseAvdSystemImage(config),
 				deviceProfile: parseAvdDeviceProfile(config),
-				lastUsedAt: directory ? modifiedAt(join$1(directory, "hardware-qemu.ini")) : null
+				lastUsedAt: directory ? modifiedAt(join(directory, "hardware-qemu.ini")) : null
 			});
 		}
 	}
@@ -1837,10 +2187,10 @@ function collectInventory(config, deadProjects) {
 			notices.push(`simulator runtimes not listed: ${describeError(error)}`);
 		}
 	}
-	const imagesRoot = join$1(androidHome(), "system-images");
+	const imagesRoot = join(androidHome(), "system-images");
 	const images = listInstalledSystemImages((error) => notices.push(unreadableNotice("Android system images", error))).map((image) => ({
 		pkg: image.pkg,
-		directory: join$1(imagesRoot, `android-${image.api}`, image.tag, image.arch)
+		directory: join(imagesRoot, `android-${image.api}`, image.tag, image.arch)
 	}));
 	return {
 		...buildInventory({
@@ -1863,13 +2213,56 @@ function removeInvalidProjectEntries(invalidProjects) {
 		recordGcResult("project", "done", path);
 	}
 }
+function collectGcMemory(scope) {
+	return memorySweepIsScoped() ? Promise.resolve(scopedMemoryReport()) : collectMemoryReport(scope, true);
+}
+function classifyProjectEntries(cfg, mountedVolumes) {
+	const deadProjects = [];
+	const invalidProjects = [];
+	const skipped = [];
+	for (const [path, project] of Object.entries(cfg?.projects || {})) {
+		if (!isAbsolute$1(path)) {
+			const claimed = describeDereferenced(project);
+			if (claimed.length) skipped.push({
+				dir: path,
+				reason: `not an absolute path, so this record is invalid; kept because it still claims ${claimed.join(" and ")}; gc removes it once that claim is gone, or drop the entry from the config file by hand`
+			});
+			else invalidProjects.push(path);
+			continue;
+		}
+		if (existsSync$1(path)) continue;
+		if (!isOnMountedVolume(path, mountedVolumes)) {
+			const volume = volumeRootFor(path);
+			skipped.push({
+				dir: path,
+				reason: `volume ${volume} is not mounted`
+			});
+		} else deadProjects.push(path);
+	}
+	return {
+		deadProjects,
+		invalidProjects,
+		skipped
+	};
+}
+/** The workspace directories an unscoped run removes whole: those of dead projects and orphaned directories. */
+function removedWholeWorkspaceDirs() {
+	const mountedVolumes = listMountedVolumes();
+	const cfg = loadConfig$1();
+	const { deadProjects } = classifyProjectEntries(cfg, mountedVolumes);
+	const { orphaned } = collectOrphanedWorkspaces(Object.keys(cfg?.projects ?? {}), mountedVolumes, { measure: false });
+	return [...orphaned.map((entry) => entry.dir), ...deadProjects.map(workspaceDir)];
+}
 async function collectGcReport({ olderThan = null, cache = null, worktrees = false, now = Date.now(), lastTouched = workspaceLastUsed } = {}, deps = {}) {
 	const scope = typeof cache === "string" && cache.trim() ? cache : null;
 	const all = scope !== null && olderThan === null;
 	const withWorkspaces = includesWorkspaceOutputs(scope);
 	const selected = selectCaches(discoverCaches(), scope).filter((c) => !withWorkspaces || !isInsideWorkspaces(c.dir));
-	const caches = planCacheEmptying(sizeCaches(selected), all);
+	if (selected.length) phase("caches", `measuring ${plural(selected.length, "shared cache")}`);
+	const sized = sizeCaches(selected);
+	const caches = scope === null ? previewScopedEmptying(sized) : planCacheEmptying(sized, all);
 	if (scope) return {
+		archives: includesArchives(scope) ? collectArchives(scope, olderThan, now) : void 0,
 		skipped: [],
 		deadProjects: [],
 		invalidProjects: [],
@@ -1879,6 +2272,7 @@ async function collectGcReport({ olderThan = null, cache = null, worktrees = fal
 		staleDevices: [],
 		staleDeviceRecords: [],
 		staleLedgerEntries: [],
+		staleStatusCaches: [],
 		buildLocks: {
 			stale: [],
 			live: [],
@@ -1901,19 +2295,38 @@ async function collectGcReport({ olderThan = null, cache = null, worktrees = fal
 			notices: [],
 			deletionSafe: true
 		},
-		parkedSims: [],
-		parkedAvds: [],
+		parkedSims: includesParkedDevices(scope) ? collectParkedSims(deps, {
+			olderThanDays: olderThan,
+			now
+		}) : [],
+		parkedAvds: includesParkedDevices(scope) ? collectParkedAvds(deps, {
+			olderThanDays: olderThan,
+			now
+		}) : [],
 		caches,
 		workspaceOutputs: withWorkspaces ? collectWorkspaceOutputs({
 			olderThan,
-			now
+			now,
+			exclude: isWorkspacesScope(scope) ? removedWholeWorkspaceDirs() : []
 		}) : null,
 		workspaceLogs: [],
+		recordings: includesRecordings(scope) ? collectRecordings({
+			whole: all,
+			olderThan,
+			now
+		}) : [],
 		worktreeSweep: null,
+		memory: memoryCacheKind(scope) ? await collectGcMemory(memoryScope(scope)) : null,
+		agentDeviceUsage: null,
+		swiftpmCacheUsage: null,
 		cacheScope: scope,
 		olderThan,
 		all
 	};
+	phase("agent-device", "measuring report-only state");
+	const agentDeviceUsage = await getAgentDeviceUsage();
+	phase("SwiftPM cache", "measuring report-only state");
+	const swiftpmCacheUsage = await getSwiftpmCacheUsage();
 	const mountedVolumes = listMountedVolumes();
 	const cfg = loadConfig$1();
 	let easSessionSweep = deps.precollectedEasSessionSweep;
@@ -1935,30 +2348,11 @@ async function collectGcReport({ olderThan = null, cache = null, worktrees = fal
 		olderThanDays: olderThan,
 		now
 	});
-	const deadProjects = [];
-	const invalidProjects = [];
-	const skipped = [];
-	for (const [path, project] of Object.entries(cfg?.projects || {})) {
-		if (!isAbsolute(path)) {
-			const claimed = describeDereferenced(project);
-			if (claimed.length) skipped.push({
-				dir: path,
-				reason: `not an absolute path, so this record is invalid; kept because it still claims ${claimed.join(" and ")}; gc removes it once that claim is gone, or drop the entry from the config file by hand`
-			});
-			else invalidProjects.push(path);
-			continue;
-		}
-		if (existsSync$1(path)) continue;
-		if (!isOnMountedVolume(path, mountedVolumes)) {
-			const volume = volumeRootFor(path);
-			skipped.push({
-				dir: path,
-				reason: `volume ${volume} is not mounted`
-			});
-		} else deadProjects.push(path);
-	}
+	const { deadProjects, invalidProjects, skipped } = classifyProjectEntries(cfg, mountedVolumes);
 	const workspaceDirs = collectOrphanedWorkspaces(Object.keys(cfg?.projects ?? {}), mountedVolumes);
 	skipped.push(...workspaceDirs.skipped);
+	const statusCaches = collectStaleStatusCaches(mountedVolumes);
+	skipped.push(...statusCaches.skipped);
 	const deviceSweepNotices = [];
 	let orphanedDevices = [];
 	let unverifiedDevices = [];
@@ -1967,6 +2361,7 @@ async function collectGcReport({ olderThan = null, cache = null, worktrees = fal
 	let staleLedgerEntries = staleBrowserProfiles(readCreatedDevices$1());
 	let idleDevices = [];
 	const unsweepableReason = cfg === null ? "no Stim config found" : deviceSweepIsScoped() ? "STIM_HOME scopes this config, but simulators and AVDs are machine-global" : null;
+	phase("devices", "listing simulators and emulators");
 	if (unsweepableReason) {
 		let simNames = [];
 		let avdNames = [];
@@ -2072,6 +2467,7 @@ async function collectGcReport({ olderThan = null, cache = null, worktrees = fal
 		staleDevices,
 		staleDeviceRecords,
 		staleLedgerEntries,
+		staleStatusCaches: statusCaches.stale,
 		buildLocks: {
 			stale: locks.filter((l) => !l.alive && !l.unresolved),
 			live: locks.filter((l) => l.alive),
@@ -2093,11 +2489,22 @@ async function collectGcReport({ olderThan = null, cache = null, worktrees = fal
 			exclude: goneWorkspaceDirs
 		}),
 		workspaceLogs: collectWorkspaceLogs({ exclude: goneWorkspaceDirs }),
+		recordings: collectRecordings({
+			whole: false,
+			olderThan,
+			now
+		}, goneWorkspaceDirs),
 		worktreeSweep: await collectWorktreeSweep({
 			idle: worktrees,
 			olderThan,
 			now
 		}),
+		memory: await collectGcMemory({
+			watchman: true,
+			gradle: true
+		}),
+		agentDeviceUsage,
+		swiftpmCacheUsage,
 		cacheScope: null,
 		olderThan,
 		all
@@ -2105,19 +2512,53 @@ async function collectGcReport({ olderThan = null, cache = null, worktrees = fal
 }
 async function runGc(opts = {}, deps = {}) {
 	if (!opts.json) {
-		await sweep(opts, deps);
+		await maintenanceGuardedSweep(opts, deps);
 		return;
 	}
 	const log = console.log;
 	console.log = console.error;
 	let payload;
 	try {
-		payload = await sweep(opts, deps);
+		payload = await maintenanceGuardedSweep(opts, deps);
 	} finally {
 		console.log = log;
 	}
 	console.log(JSON.stringify(payload));
 }
+async function maintenanceGuardedSweep(opts, deps) {
+	if (!opts.delete) return sweep(opts, deps);
+	let claim;
+	try {
+		const root = maintenanceRunClaims();
+		const attempt = (0, ownership_claim_exports.tryAcquireClaim)({
+			root,
+			mode: "exclusive",
+			label: "maintenance",
+			details: { trigger: "gc --delete" }
+		});
+		if (attempt.pending) (0, ownership_claim_exports.releaseClaim)(attempt.pending);
+		claim = attempt.acquired;
+		if (!claim) {
+			const holder = attempt.held ?? attempt.waitingFor?.[0];
+			throw new ownership_claim_exports.ClaimRefusedError({
+				root,
+				claimPath: holder?.path ?? root,
+				label: "maintenance",
+				reason: `held by pid ${holder?.owner.pid ?? "?"} since ${holder?.startedAt ?? "?"} (${String(holder?.details.trigger ?? "maintenance")})`
+			});
+		}
+		return await sweep(opts, deps);
+	} catch (error) {
+		const failure = (0, ownership_claim_exports.claimFailure)(error, "stim gc --delete");
+		if (!failure) throw error;
+		console.error(`${failure.code}: ${failure.message}`);
+		console.error(failure.remedy);
+		process.exitCode = 1;
+		return failure;
+	} finally {
+		if (claim) (0, ownership_claim_exports.releaseClaim)(claim);
+	}
+}
 async function sweep(opts, deps) {
 	if (opts.cache && (opts.worktrees || opts.idle !== void 0)) {
 		const flag = opts.worktrees ? "--worktrees" : "--idle";
@@ -2133,6 +2574,20 @@ async function sweep(opts, deps) {
 			remedy
 		};
 	}
+	const memoryKind = memoryCacheKind(opts.cache);
+	if (memoryKind && opts.olderThan !== void 0) {
+		const message = `--older-than does not apply to --cache ${memoryKind}, which acts on running processes.`;
+		const remedy = `Run \`stim gc --cache ${memoryKind}\` without --older-than.`;
+		console.error(chalk.red(message));
+		console.error(chalk.dim(remedy));
+		console.error(chalk.red("failed: STIM_BAD_ARG"));
+		process.exitCode = 1;
+		return {
+			code: "STIM_BAD_ARG",
+			message,
+			remedy
+		};
+	}
 	const poolError = parkedMaxSetting("ios").error || parkedMaxSetting("android").error;
 	if (poolError) console.error(chalk.yellow(`${poolError} ${POOL_SETTING_REMEDY}`));
 	if (opts.cache) return runGcCore(opts, {
@@ -2146,7 +2601,7 @@ async function sweep(opts, deps) {
 	});
 	let projectRoot = null;
 	try {
-		projectRoot = (deps.findProjectRoot ?? findProjectRoot)(process.cwd());
+		projectRoot = (deps.findProjectRoot ?? findProjectRoot$1)(process.cwd());
 		if (!projectRoot) return runGcCore(opts, {
 			...deps,
 			precollectedEasSessionSweep: {
@@ -2209,7 +2664,10 @@ async function pruneDeadProjects(deadProjects) {
 			recordGcResult("project", "kept", path, { detail: "its absence can no longer be confirmed" });
 			continue;
 		}
-		const result = await reclaimProject(path, { stopRequester: { by: "stim gc --delete" } }).catch((error) => {
+		const result = await reclaimProject(path, {
+			archive: { removedBy: "gc" },
+			stopRequester: { by: "stim gc --delete" }
+		}).catch((error) => {
 			deleteFailures++;
 			console.log(chalk.red(`Could not prune ${path}; its registry entry was kept: ${error.message}`));
 			recordGcResult("project", "failed", path, { detail: `its registry entry was kept: ${error.message}` });
@@ -2244,6 +2702,28 @@ async function pruneDeadProjects(deadProjects) {
 	}
 	return deleteFailures;
 }
+async function attachMaintenancePreview(report, deleting, cache) {
+	if (!deleting) report.maintenance = await previewMaintenance({ devices: !cache });
+}
+function scopedDryRunAction(cache) {
+	const memory = memoryCacheKind(cache);
+	if (memory === "watchman") return "remove the stale roots and shut down the unused watchman";
+	if (memory === "gradle-daemons") return "stop the idle daemons";
+	return includesParkedDevices(cache) ? "erase the parked devices" : "empty the caches";
+}
+function dryRunHint(cache, all, actionable, caches) {
+	if (all && (!memoryCacheKind(cache) || actionable)) return `Dry run. Re-run with --delete to ${scopedDryRunAction(cache)} above.`;
+	if (actionable) return "Dry run. Re-run with --delete to reclaim.";
+	if (caches) return "Pass --delete --cache all to empty the caches above, or --delete --older-than <days> to trim them.";
+	return null;
+}
+function pruneStatusCaches(report) {
+	if (report.cacheScope !== null) return 0;
+	return deleteStaleStatusCaches(collectStaleStatusCaches(listMountedVolumes()).stale);
+}
+function reclaimParkedDevices(report, deps) {
+	return report.cacheScope ? eraseParkedDevices(report.parkedSims, report.parkedAvds) : deleteParkedSims(report.parkedSims, deps) + deleteParkedAvds(report.parkedAvds);
+}
 async function runGcCore(opts, deps) {
 	takeGcResults();
 	const olderThan = typeof opts.olderThan === "number" ? opts.olderThan : null;
@@ -2253,7 +2733,7 @@ async function runGcCore(opts, deps) {
 		cache,
 		worktrees: Boolean(opts.worktrees)
 	}, deps);
-	if (cache && report.caches.length === 0 && report.workspaceOutputs === null) {
+	if (cache && report.caches.length === 0 && report.workspaceOutputs === null && !selectsBeyondCaches(cache)) {
 		const names = [...new Set(discoverCaches().map((c) => c.name))];
 		const message = `No shared cache carries "${cache}" in its name or directory.`;
 		console.log(chalk.yellow(message));
@@ -2265,10 +2745,13 @@ async function runGcCore(opts, deps) {
 			remedy: names.length ? `Pass --cache all or a name from: ${names.join(", ")}.` : "No shared cache was found on this machine."
 		};
 	}
+	await attachMaintenancePreview(report, opts.delete === true, cache);
+	const refusal = archiveRefusal(report.archives);
+	if (refusal !== null) return refusal;
 	const all = report.all;
 	for (const line of formatGcReport(report)) console.log(line);
 	const { deadProjects, invalidProjects, orphanedDevices, staleDevices, staleDeviceRecords, buildLocks, buildSlots, deviceLeases, easSessionSweep, caches } = report;
-	const actionable = deadProjects.length + invalidProjects.length > 0 || report.orphanedWorkspaces.length > 0 || Boolean(report.workspaceOutputs?.workspaces.some((entry) => entry.willClear)) || report.workspaceLogs.some((entry) => entry.willTrim) || Boolean(report.worktreeSweep?.worktrees.some((entry) => !entry.skipped)) || report.parkedSims.length > 0 || report.parkedAvds.length > 0 || orphanedDevices.length > 0 || staleDevices.length > 0 || staleDeviceRecords.length > 0 || report.staleLedgerEntries.length > 0 || buildLocks.stale.length > 0 || buildSlots.stale.length > 0 || deviceLeases.expired.length > 0 || easSessionSweep.orphaned.length > 0 || (olderThan !== null || all) && caches.length > 0;
+	const actionable = archiveWorkPending(report.archives, deadProjects.length + invalidProjects.length > 0 || report.orphanedWorkspaces.length > 0 || Boolean(report.workspaceOutputs?.workspaces.some((entry) => entry.willClear)) || report.workspaceLogs.some((entry) => entry.willTrim) || report.recordings.some((entry) => entry.willDelete && !entry.withWorkspace) || Boolean(report.worktreeSweep?.worktrees.some((entry) => !entry.skipped)) || report.parkedSims.length > 0 || report.parkedAvds.length > 0 || orphanedDevices.length > 0 || staleDevices.length > 0 || staleDeviceRecords.length > 0 || report.staleLedgerEntries.length > 0 || report.staleStatusCaches.length > 0 || buildLocks.stale.length > 0 || buildSlots.stale.length > 0 || deviceLeases.expired.length > 0 || easSessionSweep.orphaned.length > 0 || (olderThan !== null || all) && caches.length > 0 || memoryWorkPending(cache, report.memory));
 	const idle = opts.idle ?? null;
 	const idleFailures = idle === null ? 0 : shutDownIdleDevices(report.idleDevices, idle, () => collectIdleDevices(loadConfig$1(), listAllIosSims({ timeoutMs: DEVICE_LIST_TIMEOUT_MS }), report.deadProjects)).failures;
 	if (idleFailures) process.exitCode = 1;
@@ -2282,24 +2765,32 @@ async function runGcCore(opts, deps) {
 		actionable,
 		failures,
 		sections: gcReportSections(report),
+		...report.maintenance ? { maintenance: report.maintenance } : {},
 		results: takeGcResults(),
 		inventory
 	});
 	if (!opts.delete) {
-		if (all) console.log(chalk.dim("\nDry run. Re-run with --delete to empty the caches above."));
-		else if (actionable) console.log(chalk.dim("\nDry run. Re-run with --delete to reclaim."));
-		else if (caches.length) console.log(chalk.dim("\nPass --delete --cache all to empty the caches above, or --delete --older-than <days> to trim them."));
+		const hint = dryRunHint(cache, all, actionable, caches.length > 0);
+		if (hint) console.log(chalk.dim(`\n${hint}`));
 		return payload(idle === null ? null : idleFailures);
 	}
 	let deleteFailures = idleFailures;
+	deleteFailures += deleteArchives(report.archives);
 	deleteFailures += report.workspaceOutputs ? (await clearWorkspaceOutputs(report.workspaceOutputs, { olderThan })).failures : 0;
 	deleteFailures += await trimWorkspaceLogs(report.workspaceLogs);
-	deleteFailures += deleteParkedSims(report.parkedSims, deps) + deleteParkedAvds(report.parkedAvds);
+	deleteFailures += deleteRecordings(report.recordings, {
+		whole: all,
+		olderThan,
+		now: Date.now()
+	});
+	deleteFailures += reclaimParkedDevices(report, deps);
+	deleteFailures += await reclaimMemory(cache, report.memory);
 	removeInvalidProjectEntries(invalidProjects);
 	deleteFailures += await pruneDeadProjects(deadProjects);
 	deleteFailures += await deleteOrphanedWorkspaces(report.orphanedWorkspaces);
 	deleteFailures += deleteProjectDevices(orphanedDevices, staleDevices, staleDeviceRecords);
 	deleteFailures += forgetStaleLedgerEntries(report.staleLedgerEntries);
+	deleteFailures += pruneStatusCaches(report);
 	for (const lock of buildLocks.stale) {
 		const cleared = (0, ownership_claim_exports.clearFreeClaimSet)({
 			root: lock.path,
@@ -2378,11 +2869,11 @@ async function runGcCore(opts, deps) {
 	return payload(deleteFailures);
 }
 function gcCommand(program) {
-	program.command("gc").description("Report what Stim has left behind: dead project entries, orphaned workspace directories, clean Stim-managed linked worktrees whose branch is merged or whose pull request was merged or closed, orphaned owned devices and EAS sessions, records of devices that no longer exist, build locks whose builder is gone, expired physical-device leases, the shared build caches, and the build outputs and logs of each workspace. Reports by default; pass --delete to act.").option("--worktrees", "also remove clean, idle Stim-managed linked worktrees, not only merged ones: with --delete run `stim worktree remove` (never --force) on each; idle means unused for --older-than days, 7 without it").option("--delete", "actually prune the reported entries, reap the reported devices, clear the build outputs of every workspace not in use, and trim its Metro, client and device logs to their newest 8 MiB").option("--older-than <days>", "also reap owned devices whose workspace has not been used this long, trim shared cache entries nothing has used in that time, and clear workspace build outputs only for workspaces idle this long and parked devices only once parked this long", (v) => {
+	program.command("gc").description("Report what Stim has left behind: dead project entries, orphaned workspace directories, clean Stim-managed linked worktrees whose branch is merged or whose pull request was merged or closed, orphaned owned devices and EAS sessions, records of devices that no longer exist, build locks whose builder is gone, expired physical-device leases, the shared build caches, the build outputs and logs of each workspace, and the memory of watchman and of the Gradle and Kotlin daemons. Reports by default; pass --delete to act.").option("--worktrees", "also remove clean, idle Stim-managed linked worktrees, not only merged ones: with --delete run `stim worktree remove` (never --force) on each; idle means unused for --older-than days, 7 without it").option("--delete", "actually prune the reported entries, reap the reported devices, clear the build outputs of every workspace not in use, and trim its Metro, client and device logs to their newest 8 MiB").option("--older-than <days>", "also reap owned devices whose workspace has not been used this long, trim shared cache entries nothing has used in that time and device recordings made before it, and clear workspace build outputs only for workspaces idle this long and parked devices only once parked this long", (v) => {
 		const n = parseInt(v, 10);
 		if (!Number.isFinite(n) || String(n) !== String(v).trim()) throw new InvalidArgumentError("must be a whole number of days, e.g. --older-than 30");
 		return n;
-	}).option("--cache <name>", "act on the shared caches whose name or directory contains <name>, every cache and the workspace build outputs with --cache all, or only the workspace build outputs with --cache workspaces; all and workspaces are reserved names that never select a single cache. With --delete they are emptied whole, which is the only way to clear an index-backed cache; add --older-than <days> to trim them by age instead. Only those caches are reported; devices and project entries are not inspected. Caches outside the config dir are refused while STIM_HOME is set.", (v) => {
+	}).option("--cache <name>", "act on the shared caches whose name or directory contains <name>, every cache, the workspace build outputs and the device recordings with --cache all, only the workspace build outputs with --cache workspaces, only the device recordings with --cache recordings, only the parked simulators and emulators with --cache parked, the watchman daemon and its stale roots with --cache watchman, or the Gradle and Kotlin compile daemons with --cache gradle-daemons; archived, archived:<id>, archived-logs, archived-recordings and archived-agent select archived history explicitly; --cache all excludes archives. all, workspaces, recordings, parked, archived, archived:<id>, archived-logs, archived-recordings, archived-agent, watchman and gradle-daemons are reserved names that never select a single cache, and --cache all never includes watchman or gradle-daemons. With --delete they are emptied whole (a parked device is erased and stays parked, watchman loses its stale roots and shuts down only when no client uses it, and only daemons proven idle stop), which is the only way to clear an index-backed cache; add --older-than <days> to trim them by age instead. Archive ids ignore --older-than; archived and per-kind archive selectors filter by removal age. Only those caches are reported; other devices and project entries are not inspected. Caches outside the config dir are refused while STIM_HOME is set.", (v) => {
 		if (!v.trim()) throw new InvalidArgumentError("must name a cache, e.g. --cache \"compilation cache\"");
 		return v;
 	}).option("--idle <duration>", "shut down (never delete) owned simulators and emulators that have had no driver, claim, or activity for at least <duration>, such as 30m, 2h, or 1d; acts without --delete", (v) => {