stim 1.15.0 → 1.16.0

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

@@ -2,31 +2,119 @@ 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 { C as workspaceLogsDir, E as withDirLock$1, T as workspaceStateFile, b as workspaceDir, s as workspaceLastUsed } from "./workspace-state-CL2V2Ons.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-C0c5Udwa.mjs";
-import { a as findProjectRoot$1, r as detectIsExpo } from "./project-CV3tDFHl.mjs";
-import { h as shortUdid, o as formatLongDuration, u as plural } from "./command-output-CliHHn7a.mjs";
-import { d as removeExpiredLease, h as listBuildLocks, i as listLeaseFiles, r as leaseIsExpired } from "./device-lease-W5Pi1q38.mjs";
-import { A as listAvds, H as parseAvdSystemImage, I as ownedAvdDirectory, M as listOrphanedAvdDirectories, V as parseAvdDeviceProfile, _ as avdStorageRoots, at as POOL_SETTING_REMEDY, d as androidToolPath, dt as parkedMaxSetting, ft as readParked, it as isStimOwnedSim, j as listInstalledSystemImages, m as avdNameAbsent, o as androidHome, p as avdIniPaths, rt as isStimOwnedAvd, z as ownedAvdSerialResolver } from "./android-Db2eEMaf.mjs";
-import { n as readCreatedDevices$1, t as forgetCreatedDevice } from "./created-devices-BwVb3liH.mjs";
-import { u as listAllIosSims } from "./ios-3CtCRhwr.mjs";
-import { d as parseIdleDuration, f as shutDownIdleDevices, h as takeGcResults, l as idleDeviceLines, m as recordGcResult, s as collectIdleDevices } from "./watchman-Bx0wceoF.mjs";
-import { i as canonicalPath, n as withIdleWorkspace, r as workspaceInUse } from "./in-use-CndPMilN.mjs";
-import { n as listBuildSlots } from "./build-slots-Df1ApSuH.mjs";
-import { r as readCollectors } from "./ownership-BkYxUtuj.mjs";
-import { f as resolveEasCliBin } from "./remote-cache-CO2elm_b.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-9ulPsdhY.mjs";
-import { $ as discoverCaches, A as withAndroidAvdSizes, B as trimCaches, C as describeUnverifiableDevices, D as findStaleDeviceRecords, E as findOrphanedDevices, F as isWorkspacesScope, G as memoryCacheKind, I as planCacheEmptying, J as memorySweepIsScoped, K as memoryLines, L as previewScopedEmptying, M as includesParkedDevices, N as includesRecordings, O as findStaleProjectDevices, P as includesWorkspaceOutputs, Q as phase, R as selectCaches, S as describeParkedSims, T as eraseParkedDevices, U as collectMemoryReport, X as reclaimMemory, Y as memoryWorkPending, Z as scopedMemoryReport, _ as collectParkedAvds, a as REBUILD_COST, b as deleteParkedSims, c as collectOrphanedWorkspaces, d as isInsideWorkspaces, et as sizeCaches, f as listWorkspaceDirs, g as collectDeviceLeases, h as DEVICE_LIST_TIMEOUT_MS, i as machineNumber, j as emptyCaches, k as unverifiedDeviceCommand, l as collectWorkspaceOutputs, m as sizeText, o as WORKSPACE_OUTPUT_DIRS, p as rootPresence, q as memoryScope, s as clearWorkspaceOutputs, u as deleteOrphanedWorkspaces, v as collectParkedSims, w as deviceSweepIsScoped, x as deleteProjectDevices, y as deleteParkedAvds, z as selectsBeyondCaches } from "./budget-CMiqghig.mjs";
-import { f as removeWorktreeTarget, g as reclaimProject, h as describeDereferenced, i as matchWorktreeEntry, n as excludePodChurn, o as reclaimKeys, r as excludeWatchmanCookies } from "./worktree-qXKzADSC.mjs";
-import { n as mergeState, t as fetchDefaultBranch } from "./merge-state-BnxLNQiM.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, writeFileSync as writeFileSync$1 } from "fs";
+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 { InvalidArgumentError } from "commander";
-import { listRecordedDevices, listStatusCacheEntries, recordedBytes, settingDefinition } from "@stim-cli/core/state";
+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;
@@ -608,7 +696,7 @@ 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$1(dir, name),
@@ -1142,7 +1230,19 @@ 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 formatGcReport({ skipped = [], deadProjects = [], orphanedPorts, invalidProjects = [], orphanedWorkspaces = [], parkedSims = [], parkedAvds = [], orphanedDevices = [], unverifiedDevices = [], staleDevices = [], staleDeviceRecords = [], staleLedgerEntries = [], staleStatusCaches = [], buildLocks = {
+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: []
@@ -1158,8 +1258,8 @@ function formatGcReport({ skipped = [], deadProjects = [], orphanedPorts, invali
 	orphaned: [],
 	notices: [],
 	deletionSafe: true
-}, caches = [], workspaceOutputs = null, workspaceLogs = [], recordings = [], worktreeSweep = null, memory, 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 ?? [];
@@ -1279,7 +1379,10 @@ function formatGcReport({ skipped = [], deadProjects = [], orphanedPorts, invali
 	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) {
@@ -1410,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 = [], staleStatusCaches = [], buildLocks = {
+function gcReportSections({ archives, skipped = [], deadProjects = [], orphanedPorts = [], invalidProjects = [], orphanedWorkspaces = [], worktreeSweep = null, parkedSims = [], parkedAvds = [], orphanedDevices = [], unverifiedDevices = [], staleDevices = [], staleDeviceRecords = [], staleLedgerEntries = [], staleStatusCaches = [], buildLocks = {
 	stale: [],
 	live: [],
 	unresolved: []
@@ -1426,8 +1529,12 @@ function gcReportSections({ skipped = [], deadProjects = [], orphanedPorts = [],
 	orphaned: [],
 	notices: [],
 	deletionSafe: true
-}, workspaceOutputs = null, workspaceLogs = [], recordings = [], caches = [], memory = null }) {
+}, 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 }) => ({
@@ -1597,6 +1704,8 @@ function gcReportSections({ skipped = [], deadProjects = [], orphanedPorts = [],
 			emptySkipped: c.emptySkipped ?? null,
 			scopedEmpty: c.scopedEmpty ?? null
 		})),
+		agentDevice: agentDeviceUsage,
+		swiftpmCache: swiftpmCacheUsage,
 		memory: memory?.processes ?? [],
 		watchmanRoots: memory?.watchmanRoots ?? [],
 		memoryNotices: (memory?.notices ?? []).map((message) => ({ message }))
@@ -1788,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 });
@@ -2153,6 +2262,7 @@ async function collectGcReport({ olderThan = null, cache = null, worktrees = fal
 	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: [],
@@ -2207,10 +2317,16 @@ async function collectGcReport({ olderThan = null, cache = null, worktrees = fal
 		}) : [],
 		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;
@@ -2387,6 +2503,8 @@ async function collectGcReport({ olderThan = null, cache = null, worktrees = fal
 			watchman: true,
 			gradle: true
 		}),
+		agentDeviceUsage,
+		swiftpmCacheUsage,
 		cacheScope: null,
 		olderThan,
 		all
@@ -2394,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";
@@ -2512,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}` });
@@ -2547,6 +2702,9 @@ 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";
@@ -2587,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) || 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 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;
@@ -2604,6 +2765,7 @@ async function runGcCore(opts, deps) {
 		actionable,
 		failures,
 		sections: gcReportSections(report),
+		...report.maintenance ? { maintenance: report.maintenance } : {},
 		results: takeGcResults(),
 		inventory
 	});
@@ -2613,6 +2775,7 @@ async function runGcCore(opts, deps) {
 		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 += deleteRecordings(report.recordings, {
@@ -2710,7 +2873,7 @@ function gcCommand(program) {
 		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, 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; all, workspaces, recordings, parked, 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. 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) => {
+	}).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) => {

package/dist/{gradle-CmdOBq1d.mjs → gradle-BsO1MdsH.mjs}

@@ -1,9 +1,9 @@
 import { t as getExecutor } from "./exec-CaErVv7t.mjs";
-import { a as spawnDeclared } from "./spawn-claims-D0XfSe8u.mjs";
 import { n as stripAnsi, r as waitForChild, t as createLineReader } from "./process-output-Fpl8PYi8.mjs";
-import { l as phaseLine } from "./command-output-CliHHn7a.mjs";
-import { o as androidHome } from "./android-Db2eEMaf.mjs";
-import { O as readCcacheActivity, T as CCACHE_UNAVAILABLE, u as HEARTBEAT_INTERVAL_MS, y as startBuildHeartbeat } from "./toolchain-DmeYjXD9.mjs";
+import { l as phaseLine } from "./command-output-DnJMdEY-.mjs";
+import { a as spawnDeclared } from "./spawn-claims-D0XfSe8u.mjs";
+import { o as androidHome } from "./android-B_NumVyQ.mjs";
+import { O as readCcacheActivity, T as CCACHE_UNAVAILABLE, u as HEARTBEAT_INTERVAL_MS, y as startBuildHeartbeat } from "./toolchain-DkUflduf.mjs";
 import { createHash } from "node:crypto";
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync } from "node:fs";
 import { dirname, isAbsolute, join, relative, sep } from "node:path";