stim 1.37.0 → 1.38.0

package/dist/{error-diagnostics-CXTT3bYC.mjs → error-diagnostics-CW9xl6ot.mjs}

@@ -1,12 +1,12 @@
 import { t as getExecutor } from "./exec-L37dbiIb.mjs";
-import { r as readWorkspaceState$1 } from "./workspace-state-DOPXG2Gp.mjs";
-import { v as launchErrorPreview } from "./command-output-ByEmIwur.mjs";
+import { r as readWorkspaceState$1 } from "./workspace-state-CHEN_xzy.mjs";
+import { v as launchErrorPreview } from "./command-output-DsjhOzJ3.mjs";
 import { ft as deviceSlotKey, m as getProject, pt as deviceSlotPlatforms } from "./config-CNmN-ndb.mjs";
-import { I as readWorkspaceLaunches } from "./project-BCtQz48d.mjs";
-import { o as androidHome, u as androidToolCwd } from "./android-CGctfYpv.mjs";
-import { d as resolveProjectMetro } from "./metro-TIQ1Wft-.mjs";
-import { i as parseLogcatLine, n as androidLogGroups, r as isAndroidCrashText } from "./android-BPBARZMR.mjs";
-import { S as parseLease, v as deviceLeasePath, y as fileLeaseIo } from "./activity-CdpXXSq2.mjs";
+import { I as readWorkspaceLaunches } from "./project-DIo71tGq.mjs";
+import { o as androidHome, u as androidToolCwd } from "./android-27_JgJ1T.mjs";
+import { d as resolveProjectMetro } from "./metro-Cj6W4qOO.mjs";
+import { i as parseLogcatLine, n as androidLogGroups, r as isAndroidCrashText } from "./android-DGLG_VQ3.mjs";
+import { S as parseLease, v as deviceLeasePath, y as fileLeaseIo } from "./activity-CANftndU.mjs";
 import { r as deviceConsoleLevel } from "./ios-device-ygijU78G.mjs";
 import { createHash, randomUUID } from "node:crypto";
 import { existsSync, readFileSync, renameSync } from "node:fs";

package/dist/{gc-0jdcnDHs.mjs → gc-3DHVCn-k.mjs}

@@ -1,24 +1,24 @@
 import { D as ownership_claim_exports, T as process_identity_exports, _ as declareSpawnsOn, d as throwIfCancelled, f as WorkspaceProcessCleanupError, t as getExecutor, w as withDrainingCancellation, x as stopDeclaringSpawnsOn } from "./exec-L37dbiIb.mjs";
-import { E as workspaceDir, u as workspaceLastUsed } from "./workspace-state-DOPXG2Gp.mjs";
-import { d as quotedPath$1, h as shortUdid, o as formatLongDuration, u as plural } from "./command-output-ByEmIwur.mjs";
+import { E as workspaceDir, u as workspaceLastUsed } from "./workspace-state-CHEN_xzy.mjs";
+import { d as quotedPath$1, h as shortUdid, o as formatLongDuration, u as plural } from "./command-output-DsjhOzJ3.mjs";
 import { A as withConfigLockAsync$1, C as removeProject, N as acquireAvdClaim, at as isAbsentPath, ct as measuredDirectorySizeAsync, d as getConfigDir, gt as projectDeviceSlots, it as formatBytes, ot as isOnMountedVolume, rt as directorySizeAsync, st as listMountedVolumes, v as loadConfig$1 } from "./config-CNmN-ndb.mjs";
 import { t as runOperationFile } from "./operation-exec-DNynwpqO.mjs";
-import { $t as TRASH_MANIFEST, Ft as matchWorktreeEntry, Wt as resolveSourceCheckoutAsync, Zt as TRASH_CLAIMS, en as deleteTrashEntry, jt as listWorktreesAsync } from "./settings-Ag4pbs0z.mjs";
-import { i as findProjectRoot$1, v as detectIsExpo } from "./project-BCtQz48d.mjs";
-import { B as listOrphanedAvdDirectories, Et as readCreatedDevices$1, R as listAvdsAsync, Tt as forgetCreatedDeviceAsync, U as ownedAvdDirectory, bt as parkedMaxSetting, h as avdNameAbsent, mt as POOL_SETTING_REMEDY } from "./android-CGctfYpv.mjs";
-import { Ar as sizeCaches, At as deleteParkedAvds, Bt as unverifiedDeviceCommand, Cr as scopedMemoryReport, Dt as collectDeviceLeases, Et as DEVICE_LIST_TIMEOUT_MS, Ft as deviceSweepIsScoped, Gt as withRemoteSessionGcLocks, Ht as collectEasSessionSweep, It as eraseParkedDevices, Lt as findOrphanedDevices, Mt as deleteProjectDevices, Or as discoverCaches, Ot as collectParkedAvds, Pt as describeUnverifiableDevices, Rt as findStaleDeviceRecords, Sr as reclaimMemory, St as includesGradleVersions, Tr as phase, Tt as collectInventory, Ut as deleteEasSessions, Vt as withAndroidAvdSizes, Wn as runProcessOperation, Wt as describeError, _r as memoryCacheKind, _t as collectGradleVersions, br as memorySweepIsScoped, bt as gradleVersionLines, ct as includesParkedDevices, dt as isWorkspacesScope, fr as parseArchiveSelector, ft as planCacheEmptying, gt as trimCaches, hr as collectMemoryReport, ht as selectsBeyondCaches, it as openGcLog, jt as deleteParkedSims, kt as collectParkedSims, lt as includesRecordings, mt as selectCaches, nn as withEasProjectLock, nt as gcOptionsOf, ot as emptyCaches, pt as previewScopedEmptying, st as includesArchives, ut as includesWorkspaceOutputs, vr as memoryLines, wt as getMachineCacheReport, xr as memoryWorkPending, xt as gradleVersionsPending, yr as memoryScope, yt as deleteGradleVersions, zt as findStaleProjectDevices } from "./device-capacity-DWUOvY13.mjs";
-import { n as easMachineStateRoot$1, o as removeEasSessionClaimAsync, r as readEasSessionLedger$1 } from "./eas-session-ledger-TE1miVz5.mjs";
-import { At as mapLimited, Dt as createGcResults, Et as GC_OUTPUT, I as idleDeviceLines, M as collectIdleDevices, Mt as sizeConcurrency, N as collectIdleDevicesAsync, R as parseIdleDuration, a as collectOrphanedWorkspaces, b as workspaceInUseAsync, c as isInsideWorkspaces, f as rootPresence, g as ARTIFACT_DIRS, i as clearWorkspaceOutputs, jt as readConcurrency, kt as eachLimited, n as REBUILD_COST, o as collectWorkspaceOutputs, p as sizeText, r as WORKSPACE_OUTPUT_DIRS, s as deleteOrphanedWorkspaces, t as LIGHTEN_AFTER_MS, u as listWorkspaceDirs, v as withIdleWorkspace, wt as listBuildSlots, z as shutDownIdleDevices } from "./workspaces-DCzDzydB.mjs";
-import { t as canonicalPath } from "./paths-BsJMoPP2.mjs";
-import { N as listBuildLocks, k as removeExpiredLease } from "./activity-CdpXXSq2.mjs";
-import { d as listAllIosSims, f as listAllIosSimsAsync } from "./ios-BveW7qK1.mjs";
+import { $t as TRASH_MANIFEST, Ft as matchWorktreeEntry, Wt as resolveSourceCheckoutAsync, Zt as TRASH_CLAIMS, en as deleteTrashEntry, jt as listWorktreesAsync } from "./settings-Cz8kQJzr.mjs";
+import { i as findProjectRoot$1, v as detectIsExpo } from "./project-DIo71tGq.mjs";
+import { B as listOrphanedAvdDirectories, Et as readCreatedDevices$1, R as listAvdsAsync, Tt as forgetCreatedDeviceAsync, U as ownedAvdDirectory, bt as parkedMaxSetting, h as avdNameAbsent, mt as POOL_SETTING_REMEDY } from "./android-27_JgJ1T.mjs";
+import { At as collectParkedSims, Bt as findOrphanedDevices, Cr as memorySweepIsScoped, Ct as includesGradleVersions, Dt as DEVICE_LIST_TIMEOUT_MS, Er as scopedMemoryReport, Et as collectInventory, Gt as collectEasSessionSweep, Ht as findStaleProjectDevices, It as describeUnverifiableDevices, Jt as withRemoteSessionGcLocks, Kt as deleteEasSessions, Lt as deviceSweepIsScoped, Mt as deleteParkedSims, Nr as sizeCaches, Nt as deleteProjectDevices, Or as phase, Ot as collectDeviceLeases, Pt as describeDeadProjectDevices, Rt as eraseParkedDevices, Sr as memoryScope, St as gradleVersionsPending, Tr as reclaimMemory, Tt as getMachineCacheReport, Ut as unverifiedDeviceCommand, Vt as findStaleDeviceRecords, Wt as withAndroidAvdSizes, _t as trimCaches, an as withEasProjectLock, br as memoryCacheKind, bt as deleteGradleVersions, ct as includesParkedDevices, dt as isWorkspacesScope, ft as markOverCapCompilationCache, gt as selectsBeyondCaches, hr as parseArchiveSelector, ht as selectCaches, it as openGcLog, jr as discoverCaches, jt as deleteParkedAvds, kt as collectParkedAvds, lt as includesRecordings, mt as previewScopedEmptying, nt as gcOptionsOf, ot as emptyCaches, pt as planCacheEmptying, qn as runProcessOperation, qt as describeError, st as includesArchives, ut as includesWorkspaceOutputs, vr as collectMemoryReport, vt as collectGradleVersions, wr as memoryWorkPending, xr as memoryLines, xt as gradleVersionLines, zt as findDeadProjectOwnedDevices } from "./device-capacity-D_IlxZRL.mjs";
+import { n as easMachineStateRoot$1, o as removeEasSessionClaimAsync, r as readEasSessionLedger$1 } from "./eas-session-ledger-BDpSdFDM.mjs";
+import { At as eachLimited, B as shutDownIdleDevices, Dt as GC_OUTPUT, L as idleDeviceLines, Mt as readConcurrency, N as collectIdleDevices, Nt as sizeConcurrency, Ot as createGcResults, P as collectIdleDevicesAsync, S as pruneEmptyProcessLockDirs, Tt as listBuildSlots, a as collectOrphanedWorkspaces, b as workspaceInUseAsync, c as isInsideWorkspaces, f as rootPresence, g as ARTIFACT_DIRS, i as clearWorkspaceOutputs, jt as mapLimited, n as REBUILD_COST, o as collectWorkspaceOutputs, p as sizeText, r as WORKSPACE_OUTPUT_DIRS, s as deleteOrphanedWorkspaces, t as LIGHTEN_AFTER_MS, u as listWorkspaceDirs, v as withIdleWorkspace, z as parseIdleDuration } from "./workspaces-BgAYIccE.mjs";
 import { t as resolveMaintenanceSettings } from "./settings-D9LtQaUw.mjs";
-import { r as readCollectors } from "./ownership-CQTg6v1d.mjs";
-import { A as deleteSelectedArchives, O as classifyProjectEntries, j as sweepArchiveStaging, k as reclaimProject } from "./worktree-BAC43Kio.mjs";
-import { p as writeCacheFile } from "./warm-progress-CJQ8tk5O.mjs";
-import { a as restoreProblem, o as workspaceKeys } from "./lightened-Cdfmo8MO.mjs";
-import { C as candidateRootsAsync, D as worktreeRemovalReason, E as worktreePullRequestNote, S as maintenancePinned, T as removeWorktrees, _ as finishedWorkspaces, a as previewMaintenance, b as cachedDeviceActivity, c as deleteTempLeftovers, d as appRoots, f as artifactWorktrees, g as stopIdleWorkspace, h as planIdleStop, l as tempLeftoverLines, m as collectArtifactsAsync, o as triggeringRoot, p as clearArtifact, s as collectTempLeftovers, t as deleteIdleWorkspaceDevices, u as tempLeftoverSection, w as collectWorktreeSweep, x as cachedDeviceActivityAsync, y as ownedDeviceUsage } from "./act-BGAFjY8f.mjs";
-import { i as getSwiftpmCacheUsage, n as swiftpmCacheLines, r as getAgentDeviceUsage, t as agentDeviceLines } from "./agent-device-usage-output-D0582GHy.mjs";
+import { t as canonicalPath } from "./paths-BsJMoPP2.mjs";
+import { N as listBuildLocks, k as removeExpiredLease } from "./activity-CANftndU.mjs";
+import { d as listAllIosSims, f as listAllIosSimsAsync } from "./ios-DQEzde6f.mjs";
+import { r as readCollectors } from "./ownership-BLgOimfp.mjs";
+import { A as deleteSelectedArchives, O as classifyProjectEntries, j as sweepArchiveStaging, k as reclaimProject } from "./worktree-kGPE9Pcw.mjs";
+import { p as writeCacheFile } from "./warm-progress-D3a0KviW.mjs";
+import { a as restoreProblem, o as workspaceKeys } from "./lightened-KHWHmzGs.mjs";
+import { C as candidateRootsAsync, D as worktreeRemovalReason, E as worktreePullRequestNote, S as maintenancePinned, T as removeWorktrees, _ as finishedWorkspaces, a as previewMaintenance, b as cachedDeviceActivity, c as deleteTempLeftovers, d as appRoots, f as artifactWorktrees, g as stopIdleWorkspace, h as planIdleStop, l as tempLeftoverLines, m as collectArtifactsAsync, o as triggeringRoot, p as clearArtifact, s as collectTempLeftovers, t as deleteIdleWorkspaceDevices, u as tempLeftoverSection, w as collectWorktreeSweep, x as cachedDeviceActivityAsync, y as ownedDeviceUsage } from "./act-Bh3t-NuH.mjs";
+import { i as getSwiftpmCacheUsage, n as swiftpmCacheLines, r as getAgentDeviceUsage, t as agentDeviceLines } from "./agent-device-usage-output-CuROXefb.mjs";
 import { claimRemoveCommand, isClaimRefusal, isClaimUnavailable, readClaimSet, releaseClaim, tryAcquireClaim } from "@stim-cli/core/ownership-claim";
 import { existsSync, lstatSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
@@ -121,10 +121,6 @@ function archiveWorkPending(selection, otherWork) {
 //#endregion
 //#region src/commands/gc/eas-ledger.ts
 const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-/**
-* An entry is dropped only when its id cannot be an EAS session id and its workspace root is provably gone:
-* absolute, missing, and on a mounted volume, the same proof gc uses for dead project entries.
-*/
 function isStaleEasLedgerEntry(claim, mountedVolumes, exists = existsSync) {
 	if (UUID.test(claim.sessionId)) return false;
 	const root = claim.workspaceRoot;
@@ -238,7 +234,11 @@ function machineCacheLines(report, now = Date.now()) {
 }
 //#endregion
 //#region src/commands/gc/status-caches.ts
-const KINDS = ["disk-usage", "pull-request"];
+const KINDS = [
+	"disk-usage",
+	"pull-request",
+	"git-merge"
+];
 const KEPT_REASON = {
 	unreadable: "the file records no readable path of its own",
 	unknown: "Stim cannot tell whether the folder it measures still exists",
@@ -1000,7 +1000,7 @@ function orphanedWorkspaceLines(orphaned) {
 	const lines = [`Orphaned workspace directories (${orphaned.length}):`];
 	for (const entry of orphaned) {
 		lines.push(`  ${entry.dir}${entry.bytes === void 0 ? "" : ` - ${sizeText(entry.bytes)}`}`);
-		lines.push(`              recorded project root ${entry.projectRoot} is gone and no registry entry names it`);
+		lines.push(entry.projectRoot === null ? "              it is empty and has no workspace.json" : `              ${entry.residue ? "the project root its logs name" : "recorded project root"} ${entry.projectRoot} is gone and no registry entry names it`);
 	}
 	lines.push("              --delete re-checks each directory, then removes it whole.");
 	return lines;
@@ -2296,7 +2296,7 @@ async function collectGcReport({ olderThan = null, cache = null, worktrees = fal
 	const selected = selectCaches(discoverCaches(env, operation?.cwd), scope).filter((c) => !withWorkspaces || !isInsideWorkspaces(c.dir));
 	if (selected.length) phase("caches", `measuring ${plural(selected.length, "shared cache")}`, operation);
 	const sized = await sizeCaches(selected, operation);
-	const caches = scope === null ? previewScopedEmptying(sized, env) : planCacheEmptying(sized, all, env);
+	const caches = scope === null ? markOverCapCompilationCache(previewScopedEmptying(sized, env), env) : planCacheEmptying(sized, all, env);
 	if (scope) return {
 		archives: includesArchives(scope) ? await collectArchives(scope, olderThan, now, operation?.signal) : void 0,
 		skipped: [],
@@ -2446,14 +2446,14 @@ async function collectGcReport({ olderThan = null, cache = null, worktrees = fal
 	const unsweepableReason = cfg === null ? "no Stim config found" : deviceSweepIsScoped(env) ? "STIM_HOME scopes this config, but simulators and AVDs are machine-global" : null;
 	phase("devices", "listing simulators and emulators", operation);
 	if (unsweepableReason) {
-		let simNames = [];
+		let allSims = [];
 		let avdNames = [];
 		try {
-			simNames = (await listAllIosSimsAsync({
+			allSims = await listAllIosSimsAsync({
 				timeoutMs: DEVICE_LIST_TIMEOUT_MS,
 				operation,
 				signal: operation?.signal
-			})).map((s) => s.name);
+			});
 		} catch (error) {
 			if (error instanceof WorkspaceProcessCleanupError) throw error;
 			operation?.signal.throwIfAborted();
@@ -2468,7 +2468,14 @@ async function collectGcReport({ olderThan = null, cache = null, worktrees = fal
 			if (error instanceof WorkspaceProcessCleanupError) throw error;
 			operation?.signal.throwIfAborted();
 		}
-		deviceSweepNotices.push(...describeUnverifiableDevices(simNames, avdNames, { reason: unsweepableReason }));
+		const deadOwned = cfg === null ? [] : findDeadProjectOwnedDevices({
+			config: cfg,
+			deadProjects,
+			sims: allSims,
+			avds: avdNames
+		});
+		const deadOwnedIds = new Set(deadOwned.map((device) => device.id));
+		deviceSweepNotices.push(...describeDeadProjectDevices(deadOwned), ...describeUnverifiableDevices(allSims.filter((sim) => !deadOwnedIds.has(sim.udid)).map((sim) => sim.name), avdNames.filter((name) => !deadOwnedIds.has(name)), { reason: unsweepableReason }));
 	} else {
 		let sims = [];
 		let simsChecked = true;
@@ -2891,6 +2898,7 @@ async function pruneDeadProjects(deadProjects, output, operation) {
 		}
 		const result = await reclaimProject(path, {
 			archive: { removedBy: "gc" },
+			deleteOwnedDevices: deviceSweepIsScoped(operation?.env ?? process.env),
 			stopRequester: { by: "stim gc --delete" },
 			operation
 		}).catch((error) => {
@@ -2921,7 +2929,10 @@ async function pruneDeadProjects(deadProjects, output, operation) {
 		if (result.killedPid) output.log(chalk.dim(`  killed orphaned Metro pid ${result.killedPid}`));
 		if (result.stoppedSession) output.log(chalk.dim(`  stopped remote session ${result.stoppedSession}`));
 		if (result.stoppedTunnel) output.log(chalk.dim(`  stopped ${result.stoppedTunnel} tunnel`));
-		for (const name of result.deletedDevices) output.record("device", "done", name);
+		for (const name of result.deletedDevices) {
+			output.log(chalk.dim(`  deleted owned device ${name}`));
+			output.record("device", "done", name);
+		}
 		for (const s of result.skippedDevices) {
 			output.log(chalk.yellow(`  ${s.name}: ${s.reason}`));
 			output.record("device", result.failedDevices.includes(s) ? "failed" : "kept", s.name, {
@@ -2965,7 +2976,7 @@ async function reclaimParkedDevices(report, deps, output) {
 }
 function reportActionable(report) {
 	const { deadProjects, invalidProjects, orphanedDevices, staleDevices, staleDeviceRecords, buildLocks, buildSlots, deviceLeases, easSessionSweep, caches, olderThan, all, cacheScope: cache } = report;
-	return archiveWorkPending(report.archives, deadProjects.length + invalidProjects.length > 0 || report.orphanedWorkspaces.length > 0 || Boolean(report.workspaceOutputs?.workspaces.some((entry) => entry.willClear)) || Boolean(report.worktreeDependencies?.candidates.length) || report.workspaceLogs.some((entry) => entry.willTrim) || report.recordings.some((entry) => entry.willDelete && !entry.withWorkspace) || Boolean(report.tempLeftovers?.entries.some((entry) => entry.willDelete)) || Boolean(report.trash?.entries.some((entry) => entry.willDelete)) || Boolean(report.worktreeSweep?.worktrees.some((entry) => !entry.skipped)) || report.parkedSims.length > 0 || report.parkedAvds.length + report.parkedHostedDevices.filter((device) => device.listed !== false).length > 0 || orphanedDevices.length > 0 || staleDevices.length + report.finishedDevices.length > 0 || staleDeviceRecords.length > 0 || report.staleLedgerEntries.length + report.staleEasLedgerEntries.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 || scopedWorkPending(cache, report));
+	return archiveWorkPending(report.archives, deadProjects.length + invalidProjects.length > 0 || report.orphanedWorkspaces.length > 0 || Boolean(report.workspaceOutputs?.workspaces.some((entry) => entry.willClear)) || Boolean(report.worktreeDependencies?.candidates.length) || report.workspaceLogs.some((entry) => entry.willTrim) || report.recordings.some((entry) => entry.willDelete && !entry.withWorkspace) || Boolean(report.tempLeftovers?.entries.some((entry) => entry.willDelete)) || Boolean(report.trash?.entries.some((entry) => entry.willDelete)) || Boolean(report.worktreeSweep?.worktrees.some((entry) => !entry.skipped)) || report.parkedSims.length > 0 || report.parkedAvds.length + report.parkedHostedDevices.filter((device) => device.listed !== false).length > 0 || orphanedDevices.length > 0 || staleDevices.length + report.finishedDevices.length > 0 || staleDeviceRecords.length > 0 || report.staleLedgerEntries.length + report.staleEasLedgerEntries.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 || caches.some((entry) => entry.willEmpty) || scopedWorkPending(cache, report));
 }
 async function runGcCore(opts, deps, execution, reportOnly = false) {
 	const { output, takeResults } = execution;
@@ -3117,6 +3128,10 @@ async function runGcCore(opts, deps, execution, reportOnly = false) {
 		output.record("buildLock", "done", `${lock.platform} build lock`, { id: lock.path });
 		output.log(chalk.green(`Cleared the ${lock.platform} build lock left by pid ${lock.pid ?? "?"} (${lock.projectRoot || "unrecorded workspace"})`));
 	}
+	if (report.cacheScope === null) {
+		const emptyLockDirs = pruneEmptyProcessLockDirs();
+		if (emptyLockDirs > 0) output.log(chalk.dim(`Removed ${emptyLockDirs} empty process lock entries`));
+	}
 	for (const slot of buildSlots.stale) {
 		throwIfCancelled(signal, "GC");
 		const cleared = (0, ownership_claim_exports.clearFreeClaimSet)({
@@ -3171,12 +3186,13 @@ async function runGcCore(opts, deps, execution, reportOnly = false) {
 	throwIfCancelled(signal, "GC");
 	if (all) deleteFailures += await emptyCaches(caches, output, signal, deps.operation);
 	else if (olderThan === null) {
-		if (caches.length) output.log(chalk.dim("Shared caches left alone: pass --cache all to empty them, or --older-than <days> to trim them."));
-	} else deleteFailures += (await trimCaches(caches, olderThan, output, signal, deps.operation)).failures;
+		if (caches.some((entry) => !entry.willEmpty)) output.log(chalk.dim("Shared caches left alone: pass --cache all to empty them, or --older-than <days> to trim them."));
+	} else deleteFailures += (await trimCaches(caches.filter((entry) => !entry.willEmpty), olderThan, output, signal, deps.operation)).failures;
+	if (!all) deleteFailures += await emptyCaches(caches.filter((entry) => entry.willEmpty), output, signal, deps.operation);
 	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, the build outputs and logs of each workspace, the memory of watchman and of the Gradle and Kotlin daemons, and recognized leftovers in TMPDIR. 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, lighten every workspace that is not building and ran no ios, android or macos command in the last 15 minutes by clearing its build outputs, a running dev server or booted device included, trim its Metro, client and device logs to their newest 8 MiB, and, unless maintenance.mode is off, stop each workspace idle past maintenance.idleStopHours as stim stop does").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) => {
+	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, the memory of watchman and of the Gradle and Kotlin daemons, and recognized leftovers in TMPDIR. 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, lighten every workspace that is not building and ran no ios, android or macos command in the last 15 minutes by clearing its build outputs, a running dev server or booted device included, trim its Metro, client and device logs to their newest 8 MiB, and, unless maintenance.mode is off, stop each workspace idle past maintenance.idleStopHours as stim stop does, and shut down the shared watchman daemon (after removing its stale roots) when no client, subscription or trigger uses it").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;

package/dist/{gc-1ZLq1djg.mjs → gc-BQ5dXnC7.mjs}

@@ -1,3 +1,3 @@
-import { Lt as findOrphanedDevices, Nt as describeParkedSims, Pt as describeUnverifiableDevices, Rt as findStaleDeviceRecords, jt as deleteParkedSims, mt as selectCaches, zt as findStaleProjectDevices } from "./device-capacity-DWUOvY13.mjs";
-import { a as runGc, i as readGcReport, n as executeGc, o as withGcMaintenanceClaim, r as gcCommand, s as formatGcReport, t as collectGcReport } from "./gc-0jdcnDHs.mjs";
+import { Bt as findOrphanedDevices, Ft as describeParkedSims, Ht as findStaleProjectDevices, It as describeUnverifiableDevices, Mt as deleteParkedSims, Vt as findStaleDeviceRecords, ht as selectCaches } from "./device-capacity-D_IlxZRL.mjs";
+import { a as runGc, i as readGcReport, n as executeGc, o as withGcMaintenanceClaim, r as gcCommand, s as formatGcReport, t as collectGcReport } from "./gc-3DHVCn-k.mjs";
 export { collectGcReport, gcCommand as default, deleteParkedSims, describeParkedSims, describeUnverifiableDevices, executeGc, findOrphanedDevices, findStaleDeviceRecords, findStaleProjectDevices, formatGcReport, readGcReport, runGc, selectCaches, withGcMaintenanceClaim };

package/dist/{guide-COxIANZu.mjs → guide-DqJCc4vW.mjs}

@@ -1,8 +1,8 @@
-import { t as ANDROID_AVD_CONFIG_HELP } from "./settings-Ag4pbs0z.mjs";
-import { i as findProjectRoot$1 } from "./project-BCtQz48d.mjs";
-import { h as RECENT_LAUNCH_MS } from "./eas-session-ledger-TE1miVz5.mjs";
-import { o as guideStatus, t as WATCHMAN_NESTED_WORKTREES } from "./doctor-watchman-CPE4C8KV.mjs";
-import "./status-watch-DY0EZcmg.mjs";
+import { t as ANDROID_AVD_CONFIG_HELP } from "./settings-Cz8kQJzr.mjs";
+import { i as findProjectRoot$1 } from "./project-DIo71tGq.mjs";
+import { h as RECENT_LAUNCH_MS } from "./eas-session-ledger-BDpSdFDM.mjs";
+import { o as guideStatus, t as WATCHMAN_NESTED_WORKTREES } from "./doctor-watchman-B8e3s9ko.mjs";
+import "./status-watch-Cs18eFkQ.mjs";
 import { SETTINGS, SETTINGS_SCHEMA_URL, TUTORIAL_VERSION } from "@stim-cli/core/state";
 import chalk from "chalk";
 //#region src/guide/agent.ts
@@ -1641,7 +1641,8 @@ RULES
     invalidProjects         { path }  the registry key is not absolute
     orphanedPorts           { project, label, port }
     orphanedWorkspaces      { dir, projectRoot, bytes }  --delete removes the
-                              whole workspace directory
+                              whole workspace directory; projectRoot is null
+                              for an empty directory with no workspace.json
     linkedWorktrees         { path, idleDays, mergedInto, pullRequest,
                               pullRequestUnknown, willRemove, reason,
                               detail, eligibleAt, buildState }  mergedInto is the
@@ -1732,9 +1733,10 @@ RULES
                               whose absolute workspace root is missing on a
                               mounted volume; --delete forgets the entry
                               only and contacts no EAS session
-    staleStatusCaches       { kind: "disk-usage" | "pull-request", path,
-                              file, bytes }  entries of $STIM_HOME/disk-usage
-                              and pull-requests whose path is gone from a
+    staleStatusCaches       { kind: "disk-usage" | "pull-request" | "git-merge",
+                              path, file, bytes }  entries of
+                              $STIM_HOME/disk-usage, pull-requests and
+                              git-merge whose path is gone from a
                               mounted volume; --delete removes the file
     idleDevices             { kind, id, name, project, slot, lastActivityAt,
                               idleForMs, buildInProgress }  booted owned
@@ -1869,12 +1871,14 @@ RULES
                               "busy" | "unknown", reclaimable, reason,
                               detail }  without --cache, or with --cache
                               watchman or gradle-daemons; reclaimable marks
-                              the ones gc --delete --cache <cacheKind>
-                              would stop (\`guide cleanup memory\`)
+                              the ones gc --delete would stop (watchman) or
+                              gc --delete --cache gradle-daemons would
+                              (\`guide cleanup memory\`)
     watchmanRoots           { path, stale: "missing" | "pruned-worktree" |
                               null, subscriptions, triggers, removable,
                               detail }  removable marks the stale roots
-                              --cache watchman would watch-del
+                              gc --delete (or --cache watchman) would
+                              watch-del
     memoryNotices           { message }  why the memory sweep was skipped
   bytes is null when the size is unknown: not measured, or the measurement
   failed. idleDays is null when the last use is unknown. listed is false for
@@ -2860,6 +2864,9 @@ project's before exiting. You get your shell back with a bundler running: no
 backgrounding idiom, no sleep, no poll loop, and no chance of building against
 another worktree's bundler.
 
+If Expo cannot be resolved in a linked worktree, run \`stim worktree warm\`
+there before retrying. The refusal also names dependency installation.
+
   --json            one line of facts on stdout, everything else on stderr:
                       { port, supervisorPid, mode, logsDir, alreadyRunning }
   --wait <seconds>  how long to wait for server and remote tunnel readiness
@@ -3028,8 +3035,9 @@ WHAT THE SUPERVISOR IS
                  for the bundle lines.
 
   expo-child and command-child put the Node the app pins (.nvmrc,
-  .node-version, .tool-versions nodejs, or package.json volta.node) first
-  on PATH when an nvm, fnm, Volta, asdf, mise or linked Homebrew
+  .node-version, .tool-versions nodejs, or package.json volta.node), looking
+  from the app directory up to its repository or worktree root, first on PATH
+  when an nvm, fnm, Volta, asdf, mise or linked Homebrew
   node/node@NN install satisfies the pin and the node already on PATH does
   not; the metro log then records a project_node event naming it. When no
   install has the version the pin names, the newest install of the pinned
@@ -4057,7 +4065,8 @@ Branch on the code, never on the message.`,
   the first diagnostics are the phase names and the last error lines the
   script printed, ahead of the compiler diagnostics.
   Three Android refusals share this code without gradle itself failing:
-  - NO ANDROID SDK, before gradle starts: nothing exists at the SDK path
+  - NO ANDROID SDK, before gradle starts: local React Native emulator runs
+    refuse before Metro or device setup. Nothing exists at the SDK path
     Stim resolves (ANDROID_HOME, else ANDROID_SDK_ROOT, else the default
     location), and there is no android/local.properties. Set ANDROID_HOME to the SDK or write sdk.dir
     into android/local.properties; \`stim doctor --platform android\` reports
@@ -4299,7 +4308,9 @@ too old to speak protocol 2, incompatible
 toolchain/runtime/CPU, low disk, busy, sync/build failure, artifact failure,
 or a checkout that changed while it built. Unsupported build kinds also refuse.
 No local xcodebuild, Gradle or SwiftPM compile or alternate machine follows a
-refusal. For stim ios, a toolchain difference on the named machine, such as Xcode,
+refusal. For stim android, a known toolchain refusal on the named machine stops
+before prebuild; busy, low disk and unreachable are checked again afterward.
+For stim ios, a toolchain difference on the named machine, such as Xcode,
 the simulator runtime or the CPU, refuses before this machine runs prebuild or pod
 install, even when prebuild would have produced an app the local cache already holds, or the
 machine already holds the exact artifact. A
@@ -4794,7 +4805,8 @@ so a Debug run on one is wired to a LAN origin instead of localhost.`,
   owned by this Stim home, or it is not booted or running. Permission and push
   also refuse when no app is recorded for the device. Run the platform command
   the remedy names (\`stim ios\` or \`stim android\`, with \`--slot\` for a named
-  slot) and retry. No tool runs before this refusal.`
+  slot) and retry. A non-Mac client cannot run a local iOS simulator; run the
+  iOS tool on a Mac with a local Stim-owned simulator. No tool runs before this refusal.`
 		},
 		STIM_DEVICE_TOOL_UNSUPPORTED: {
 			summary: "that device tool has no equivalent on that platform",
@@ -5576,6 +5588,16 @@ not on any remote"  (worktree remove)
   source path and warm cannot move it, it prints "removed <dir>/Pods/Manifest.lock
   so pod install runs" and \`stim ios\` runs \`pod install\`.
 
+"carry       left out <app>/<platform>: <reason>"
+  The app is an Expo project whose ios/ or android/ Git ignores, and Stim
+  cannot show the source checkout's copy was generated from the app's current
+  inputs: Stim has no prebuild record for it, its last prebuild did not
+  finish, or the record names an earlier native fingerprint. Warm does not
+  copy it, so the first \`stim <platform>\` in this worktree generates it
+  fresh. Nothing to fix. To let later warms copy it, delete <platform>/ in
+  the source checkout and run \`stim <platform>\` there, so Stim generates it
+  fresh and records that.
+
 "carry       carried <dir>/Pods but there is no <dir>/Podfile.lock"
   Warm copied Pods but the destination has no Podfile.lock. Follow the printed
   pod-install command before building.
@@ -6203,7 +6225,9 @@ not the caller's. The returned fingerprint remains null; transfer digests never
 become reusable APK cache keys. Workers with native-gradle-peer-cache can offer a
 completed APK for declared source and resolved variant, ABI and build options,
 rechecking current private inputs against the saved receipt at offer and fetch.
-A hit skips source upload and compilation even while that worker is busy or
+When this machine has a JDK, native-gradle-peer-jdk also selects that exact
+JDK major for the private-input check. Older workers skip this lookup and use
+normal build placement. A hit skips source upload and compilation even while that worker is busy or
 this machine has room. A miss follows normal placement; older Gradle workers
 still build normally. Off mode, explicit local builds and disabled remote cache
 reads skip peer lookup. Hosts without native-gradle-build refuse before upload.
@@ -6232,6 +6256,7 @@ cleanup stops that workspace, including resources created before a build fails.
 
 Or install npm install --global @stim-cli/ci and use stim-ci directly.
 Platforms: ios, android, macos, web. Everything after -- is argv, not a shell.
+Without --, run installs and launches the app, then stops it with exit code 0.
 build is the only step that compiles (or restores from the cache, or with
 --eas-profile downloads an EAS development build). It records the app for this
 checkout, platform and selectors (iOS scheme and configuration, Android variant)
@@ -6714,8 +6739,10 @@ ${HOSTED_RECORDING("simulator")}
 
 If hosting.agentDriver is none, the driver cannot enforce its policy, or the
 host does not advertise hosted-ios-agent, agent reports
-{ driver: 'none', setting: 'hosting.agentDriver' }. Update the host and check
-its setting and agent-device installation. No other simulator becomes reachable.
+{ driver: 'none', setting: 'hosting.agentDriver' }. A run whose host disables
+the driver prints a notice; plain status also names the host setting when
+agent control is unavailable. Update the host and check its setting and
+agent-device installation. No other simulator becomes reachable.
 Client hello carries only name and version, not features, so the host cannot gate
 daemon startup or grant issuance on client support. The client checks the host's
 hosted-ios-agent feature before using a grant.
@@ -7759,7 +7786,7 @@ WHAT MAKES THE CACHE ACTUALLY HIT: .FINGERPRINTIGNORE
   looks exactly like a cache that is not there.
 
   Stim ignores paths a fresh checkout never has and no native Debug build
-  reads: android/local.properties, android/.idea, *.xcodeproj/xcuserdata, and,
+  reads: android/local.properties, android/.idea, *.xcodeproj/xcuserdata, .git (and its contents), .expo, and,
   while a .gitignore pattern matches them (even when committed), the
   \`react-native bundle\` output ios/main.jsbundle and ios/assets. A project
   does not repeat those.
@@ -8072,7 +8099,7 @@ OPT-IN CONCURRENCY LIMITS (UNLIMITED BY DEFAULT)
 			summary: "every flag per command, Android variants and flavors, the per-run simulator model, runtime and system image",
 			body: () => `THE OPTION SURFACE, IN FULL
   start           --json --wait <seconds> --remote --reset-cache
-  ios             --remote-build <local|auto|remote|remote-only|name> --slot <name> --json --plan --no-metro-check --no-build-cache --scheme <name> --configuration <name> --device-type <name> --runtime <version> --simulator-app <xcode|siniulator|stim-desktop> --device [udid] --wait <seconds> --no-wait --remote <eas|proxy|local|auto|remote|remote-only|machine>
+  ios             --remote-build <local|auto|remote|remote-only|name> --slot <name> --json --plan --no-metro-check --no-build-cache --scheme <name> --configuration <name> --device-type <name> --runtime <version> --install-runtime --simulator-app <xcode|siniulator|stim-desktop> --device [udid] --wait <seconds> --no-wait --remote <eas|proxy|local|auto|remote|remote-only|machine>
   android         --remote-build <local|auto|remote|remote-only|name> --slot <name> --json --plan --no-metro-check --no-build-cache --variant <name> --system-image <id> --device-profile <id> --device [serial] --wait <seconds> --no-wait --remote <proxy|eas|local|auto|remote|remote-only|machine>
   ios/android --wait bounds owned-device slot waits (default 600s), or physical
   leases with --device (default 60s). Remote targets do not join this local
@@ -8291,6 +8318,17 @@ OPT-IN CONCURRENCY LIMITS (UNLIMITED BY DEFAULT)
   cannot (stale node_modules, a leftover path, an error), warm deletes
   ios/Pods/Manifest.lock so \`stim ios\` runs \`pod install\`.
 
+  In an Expo project whose ios/ or android/ Git ignores, warm copies that
+  directory only when the source's last Stim prebuild of it ran on the app's
+  current native fingerprint, and records the same prebuild in the worktree.
+  Otherwise it leaves the directory out and prints
+  "carry       left out <app>/<platform>: <reason>"; the first
+  \`stim <platform>\` there generates it fresh. A directory generated outside
+  Stim has no record and is left out. To make it eligible, delete it in the
+  source checkout and run \`stim <platform>\` there so Stim generates it
+  fresh; running Stim over the existing directory records it as current even
+  when it came from an older template.
+
   Other generated state stays eligible: .gradle, .cxx, *.tsbuildinfo, build
   directories, and embedded JavaScript need project-specific decisions about
   regeneration. Native intermediates can record the source checkout's paths;
@@ -8354,6 +8392,26 @@ OPT-IN CONCURRENCY LIMITS (UNLIMITED BY DEFAULT)
   ios.runtime, android.systemImage, android.deviceProfile) for that one
   invocation, exactly as \`--configuration\` overrides ios.configuration.
 
+  \`stim ios --runtime 26.5 --install-runtime --remote local\` installs that
+  missing iOS runtime with Xcode, then continues the run. Use
+  \`--remote <mac>\` for a named approved hosting Mac, including from Linux.
+  ios.autoInstallRuntime enables the same opt-in for an explicit ios.runtime
+  or --runtime version; it defaults to false. Installation requires an exact
+  major.minor[.patch] version, about 8-10 GB to download (actual size varies),
+  and at least 20 GB free on the simulator volume for download and unpacking.
+  A child-aware ownership claim serializes Stim installs in this Mac's Stim
+  home and the installer takes an available build slot. Run output shows
+  Xcode progress locally and periodic waiting messages remotely; status shows
+  the install phase and remote machine. Without opt-in, a missing runtime
+  still refuses. Automatic placement, eas/proxy and physical-device runs do
+  not install runtimes: choose --remote local or one named Mac first.
+  Xcode Settings > Components lists downloadable versions supported by Xcode;
+  Stim retains Xcode's error for unavailable versions. Installed versions
+  appear in stim doctor and xcrun simctl list runtimes. Runtimes are shared
+  Xcode components, not Stim-owned devices: remove them manually through
+  Xcode Settings > Components after checking other workspaces no longer need
+  them. Stim does not prune them.
+
   A name that is not INSTALLED on this machine refuses with STIM_BAD_ARG
   before anything is created, and the message lists the installed names, so a
   wrong guess is one command, not a created simulator. A blank value is the
@@ -9085,8 +9143,9 @@ In on mode a pass runs, cheapest to rebuild first:
   3. build-cache and Metro entries, least recently used first, down to
      maintenance.capTargetPercent of caches.buildCacheMaxGb or
      caches.metroCacheMaxGb, and entries unused for olderThanDays
-  4. the Swift compilation cache, emptied whole, only below
-     budget.hardFloorDiskGb, and kept while an iOS build holds its shared
+  4. the Swift compilation cache, emptied whole once it is over
+     caches.swiftCompilationCacheMaxGb (default 0, no cap), whatever the free
+     disk, and kept while an iOS build holds its shared
      claim (taken for each xcodebuild run that compiles with it) or that
      claim is unresolved; the emptying holds the exclusive claim
   5. linked worktrees whose branch or pull request finished (gc's finished
@@ -9284,8 +9343,9 @@ WHAT RECLAIMS AN OWNED DEVICE
                             shuts DOWN (never deletes) owned devices with no
                             driver, claim or activity for that long
 
-\`gc --delete --cache watchman\` and \`gc --delete --cache gradle-daemons\`
-stop shared helper processes, not devices (\`guide cleanup memory\`).
+\`gc --delete\` also shuts down an unused watchman daemon, and \`gc --delete
+--cache gradle-daemons\` stops idle Gradle and Kotlin daemons. They are shared
+helper processes, not devices (\`guide cleanup memory\`).
 
 \`worktree remove\` and \`gc --delete\` are the only two commands that delete;
 \`gc --delete\` deletes worktrees only through \`worktree remove\`. \`gc
@@ -9758,8 +9818,15 @@ ORPHANED WORKSPACE DIRECTORIES
   "Orphaned workspace directories" when the recorded project root is gone,
   its volume is mounted, no registry key equals it or sits under it, and the
   workspace is not in use. \`gc --delete\` re-checks each one, then removes
-  it. A directory with a missing or unparseable workspace.json, or a root on
-  an unmounted volume, is reported under Skipped and never deleted.
+  it. A directory with an unparseable workspace.json, or a root on an
+  unmounted volume, is reported under Skipped and never deleted.
+  A directory with no workspace.json that holds only leftovers of a removed
+  workspace is reported the same way: maintenance.ndjson, log-error-index.json,
+  ended-agents.json, empty lock files and an agent-device directory with no
+  running daemon. It counts as gone when it is empty, or when the project
+  root its maintenance log names maps to the directory name and is gone. Any
+  other file (state.json, for one), a held lock or a log naming no root keeps
+  it under Skipped. The empty directory report has no project root.
 
 DELETED WORKTREES STILL REGISTERED
   A worktree deleted outside Stim keeps its registry entry; \`stim status\`
@@ -9794,9 +9861,11 @@ TMPDIR LEFTOVERS
 STALE STATUS CACHE ENTRIES
   \`stim status\` caches each folder's size under $STIM_HOME/disk-usage and
   each worktree's pull request under $STIM_HOME/pull-requests, which the
-  maintenance worktree check and \`gc --delete\` also write. \`worktree
+  maintenance worktree check and \`gc --delete\` also write. The merge check
+  caches each worktree's verdict under $STIM_HOME/git-merge. \`worktree
   remove\` drops the entries of the worktree it removed (its checkout,
-  node_modules and workspace folder, and its pull request), not the size
+  node_modules and workspace folder, its pull request and its merge
+  verdict), not the size
   entries of its owned devices' data folders. \`gc\` reports the
   entries of a folder or worktree that was removed some other way under "Stale
   status cache entries", and \`gc --delete\` removes them. An entry counts as
@@ -9855,6 +9924,10 @@ WHICH stim-* DEVICES gc DELETES
   \`rm -rf <dir>\` for AVD data with no registration), and
   never runs it. Boot, shutdown and teardown re-check ownership by the same
   rule, so a device that stops matching is left alone.
+  With STIM_HOME set, gc skips the device sweep because simulators and AVDs
+  are machine-global, but pruning a dead project still deletes the devices its
+  record marks as owned. gc lists them as to be deleted under "Device sweep
+  notices"; every other stim-* device is reported as not touched.
 
 ANDROID DATA WITHOUT A REGISTRATION
   \`gc\` also reports stim-*.avd directories whose .ini registration is
@@ -9874,6 +9947,9 @@ BUILD LOCKS
   \`gc --delete\` clears them. A lock whose builder IS running is a build in
   progress -- it is named in the report and touched by nothing, because
   removing it would put a second workspace on the same compile.
+  \`gc --delete\` also removes the empty directories under ~/.stim/process-locks
+  that removed projects and worktrees leave behind; it never touches a lock
+  that holds a claim.
 
 DEVICE LEASES
   A workspace can hold a timed lease on a physical device. The lease is one
@@ -10024,7 +10100,7 @@ THE ONE CASE GC WILL NOT REAP
   Wall-clock timestamps and command names are not ownership proof.`
 		},
 		memory: {
-			summary: "watchman and Gradle and Kotlin daemon memory in gc, and when gc --delete --cache watchman or gradle-daemons stops them",
+			summary: "watchman and Gradle and Kotlin daemon memory in gc, and when gc --delete and gc --delete --cache gradle-daemons stop them",
 			body: () => `MEMORY
   Every \`gc\` without --cache, and \`gc --cache watchman\` or
   \`gc --cache gradle-daemons\`, reports the long-lived helpers that grow while
@@ -10032,19 +10108,22 @@ THE ONE CASE GC WILL NOT REAP
   daemons. Each line gives the pid, physical footprint (the measure status
   uses; resident size when the footprint cannot be read), uptime and whether
   it is idle, and a kept one says why. The reclaimable line totals what
-  the two commands below would free now.
+  the commands below would free now.
 
-  Only these two commands stop anything, and each acts only on its own kind.
-  Neither a plain \`gc --delete\` nor \`--cache all\` touches them:
-    stim gc --delete --cache watchman
+  Watchman is stopped by a plain \`gc --delete\` and by \`gc --delete --cache
+  watchman\`; \`--cache all\` and every other \`--cache\` value leave it alone.
+  The Gradle and Kotlin daemons are stopped only by \`--cache gradle-daemons\`:
+    stim gc --delete              (or: stim gc --delete --cache watchman)
                                   runs \`watchman watch-del\` on each stale root
                                   with no subscription or trigger, then
                                   \`watchman shutdown-server\` only when
                                   \`debug-status\` lists no client but gc's own
-                                  call and no root has a trigger; otherwise
-                                  the daemon is kept and the report names
-                                  each client, as the Stim workspace whose
-                                  dev server it belongs to where it can
+                                  call, every root's subscriptions and
+                                  triggers were readable and no root has a
+                                  trigger; otherwise the daemon is kept and
+                                  the report names each client, as the Stim
+                                  workspace whose dev server it belongs to
+                                  where it can
     stim gc --delete --cache gradle-daemons
                                   stops each Gradle daemon its own
                                   \`gradle --status\` reports IDLE, then each
@@ -10271,8 +10350,13 @@ DEVICE RECORDINGS
   stays.
 
 SHARED BUILD CACHES
-  The caches that make a second workspace fast are alive by design and never
-  included in a plain \`gc --delete\`. Every \`gc\` run reports them anyway,
+  The caches that make a second workspace fast are alive by design and, with
+  one exception, not touched by a plain \`gc --delete\`. The exception is the
+  Swift compilation cache (the Xcode CAS under $STIM_HOME/compilation-cache):
+  once it is over caches.swiftCompilationCacheMaxGb (default 0, no cap), a
+  plain \`gc --delete\` empties it whole, since age trimming would corrupt its
+  index. It is kept, with the build named, while an iOS build holds its shared
+  claim or that claim is unresolved. Every \`gc\` run reports them anyway,
   each row tagged (registered) or (detected), with its size:
     stim gc                            # report, caches included
     stim gc --delete --older-than 30   # trim entries nothing has used
@@ -10399,6 +10483,15 @@ KEYS STIM READS
                         The \`--runtime\` flag overrides this per invocation,
                         and an uninstalled version refuses the same way,
                         naming the layer the value came from
+  ios.autoInstallRuntime false (default). With true and an explicit ios.runtime
+                        or --runtime version, install a missing iOS runtime
+                        with Xcode on the local or named approved Mac before
+                        continuing. --install-runtime opts in for one run.
+                        Requires 20 GB free for download and unpacking;
+                        typically downloads 8-10 GB (actual size varies).
+                        Automatic placement, eas/proxy and physical phones
+                        do not install runtimes. Shared runtimes are removed
+                        manually in Xcode Settings > Components.
   ios.scheme            e.g. "RNTester" -- the shared Xcode scheme to build
                         when the workspace lists several and none matches
                         its name, which otherwise refuses with
@@ -11366,7 +11459,7 @@ stats. A listed paired name with a cache hit compiles nothing, contacts no worke
 and records buildMachine with builtOn absent. Build failures retain the selected
 value; builtOn is here or the configured machine entry when compilation ran.
 Prebuild and pod install still run on this machine before a named offload; stim ios
-checks the machine's toolchain first. A refusal
+and stim android check the machine's toolchain first. A refusal
 starts no local xcodebuild, Gradle or SwiftPM compile.
 A React Native offload sends the tracked and untracked files, and the gitignored
 files the native fingerprint hashes or the Expo config reads, such as .env.local
@@ -11460,7 +11553,9 @@ do not query peer caches. Older workers continue normal placement. This peer
 lookup also covers declared native Gradle worker APKs when the worker supports
 native-gradle-peer-cache. It rechecks current private inputs against the saved
 receipt at offer and fetch for the requested source, resolved variant, ABI and
-build options. Caller fingerprints stay null; worker keys stay worker-scoped.
+build options. With a known local JDK, lookup also requires native-gradle-peer-jdk
+and rechecks on that exact JDK major; older workers use normal build placement.
+Caller fingerprints stay null; worker keys stay worker-scoped.
 React Native and Expo development builds also query enabled paired workers
 with react-native-peer-cache after local and configured-provider misses. Their
 post-mutation fingerprint, native build choices and compatible toolchain must