stim 1.20.0 → 1.20.2

package/dist/{gc-PWp34zGb.mjs → gc-qWOMdnER.mjs}

@@ -1,24 +1,23 @@
-import { n as ownership_claim_exports, t as process_identity_exports } from "./process-identity-Biv3arCO.mjs";
-import { t as getExecutor } from "./exec-B81Qodjn.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 } from "./config-D0LhTY3S.mjs";
-import { d as removeExpiredLease, h as listBuildLocks } from "./device-lease-DHOBXGgS.mjs";
-import { D as withDirLock$1, E as workspaceStateFile, s as workspaceLastUsed, x as workspaceDir } from "./workspace-state-CSIFuuDa.mjs";
-import { h as shortUdid, o as formatLongDuration, u as plural } from "./command-output-BjPN99ZB.mjs";
-import { _ as detectIsExpo, r as findProjectRoot } from "./project-B8_duAzW.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 } from "./android-BsYNR81W.mjs";
-import { n as readCreatedDevices$1, t as forgetCreatedDevice } from "./created-devices-HU_DAb_Q.mjs";
-import { C as recordGcResult, I as listBuildSlots, T as canonicalPath, a as collectWorkspaceOutputs, c as listWorkspaceDirs, f as withIdleWorkspace, i as collectOrphanedWorkspaces, l as rootPresence, n as WORKSPACE_OUTPUT_DIRS, o as deleteOrphanedWorkspaces, p as workspaceInUse, r as clearWorkspaceOutputs, s as isInsideWorkspaces, t as REBUILD_COST, u as sizeText, w as takeGcResults } from "./workspaces-D2xSHBDY.mjs";
-import { $ as memoryWorkPending, A as findStaleProjectDevices, B as previewScopedEmptying, C as deleteProjectDevices, D as eraseParkedDevices, E as deviceSweepIsScoped, F as includesParkedDevices, H as selectsBeyondCaches, I as includesRecordings, L as includesWorkspaceOutputs, M as withAndroidAvdSizes, N as emptyCaches, O as findOrphanedDevices, P as includesArchives, Q as memorySweepIsScoped, R as isWorkspacesScope, S as deleteParkedSims, T as describeUnverifiableDevices, U as trimCaches, V as selectCaches, W as parseArchiveSelector, X as memoryLines, Y as memoryCacheKind, Z as memoryScope, _ as DEVICE_LIST_TIMEOUT_MS, at as discoverCaches, b as collectParkedSims, d as collectIdleDevices, et as reclaimMemory, h as shutDownIdleDevices, j as unverifiedDeviceCommand, k as findStaleDeviceRecords, m as parseIdleDuration, nt as phase, p as idleDeviceLines, q as collectMemoryReport, st as sizeCaches, tt as scopedMemoryReport, v as collectDeviceLeases, w as describeParkedSims, x as deleteParkedAvds, y as collectParkedAvds, z as planCacheEmptying } from "./budget-BONq9vXY.mjs";
-import { f as resolveEasCliBin } from "./remote-cache-Bsts6f6Y.mjs";
-import { d as listAllIosSims } from "./ios-CXLIUxXJ.mjs";
-import { C as parseSessionListPage, T as verifyStoppedSession, _ as findOrphanedOwnedSessions, b as isDefinitiveMissingSessionError, d as withRemoteSessionLock, f as withEasProjectLock, v as getSessionArgs, w as stopSessionArgs, x as listOwnedSessionsArgs, y as inspectSessionForTeardown } from "./device-remote-Bmg42063.mjs";
-import { a as removeEasSessionClaim, n as easMachineStateRoot$1, r as readEasSessionLedger$1 } from "./eas-session-ledger-DZlC-Fq3.mjs";
-import { r as readCollectors } from "./ownership-DXzMMSx6.mjs";
-import { c as removeWorktrees, l as worktreePullRequestNote, n as previewMaintenance, s as collectWorktreeSweep, u as worktreeRemovalReason } from "./preview-BaBJ72Al.mjs";
-import { _ as reclaimProject, g as describeDereferenced, v as deleteSelectedArchives, y as sweepArchiveStaging } from "./worktree-BxDqaTev.mjs";
-import { i as getSwiftpmCacheUsage, n as swiftpmCacheLines, r as getAgentDeviceUsage, t as agentDeviceLines } from "./agent-device-usage-output-DVyv_hWj.mjs";
+import { A as acquireAvdClaim, D as withConfigLock$1, F as listMountedVolumes, L as volumeRootFor, M as directorySize, N as formatBytes, P as isOnMountedVolume, S as removeProject, W as projectDeviceSlots, _ as loadConfig$1, j as ownership_claim_exports, k as process_identity_exports } from "./config-BYDxlMY3.mjs";
+import { t as getExecutor } from "./exec-DqKo9GKJ.mjs";
+import { d as removeExpiredLease, h as listBuildLocks } from "./device-lease-BX1sJQ2E.mjs";
+import { D as withDirLock$1, E as workspaceStateFile, s as workspaceLastUsed, x as workspaceDir } from "./workspace-state-DJt_MMvf.mjs";
+import { h as shortUdid, o as formatLongDuration, u as plural } from "./command-output-BTy8hZ0F.mjs";
+import { _ as detectIsExpo, r as findProjectRoot } from "./project-_phNIJfs.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 } from "./android-Mz_Inn3w.mjs";
+import { n as readCreatedDevices$1, t as forgetCreatedDevice } from "./created-devices-Dzd5C2LF.mjs";
+import { C as recordGcResult, I as listBuildSlots, T as canonicalPath, a as collectWorkspaceOutputs, c as listWorkspaceDirs, f as withIdleWorkspace, i as collectOrphanedWorkspaces, l as rootPresence, n as WORKSPACE_OUTPUT_DIRS, o as deleteOrphanedWorkspaces, p as workspaceInUse, r as clearWorkspaceOutputs, s as isInsideWorkspaces, t as REBUILD_COST, u as sizeText, w as takeGcResults } from "./workspaces-C36s2jb9.mjs";
+import { $ as memoryWorkPending, A as findStaleProjectDevices, B as previewScopedEmptying, C as deleteProjectDevices, D as eraseParkedDevices, E as deviceSweepIsScoped, F as includesParkedDevices, H as selectsBeyondCaches, I as includesRecordings, L as includesWorkspaceOutputs, M as withAndroidAvdSizes, N as emptyCaches, O as findOrphanedDevices, P as includesArchives, Q as memorySweepIsScoped, R as isWorkspacesScope, S as deleteParkedSims, T as describeUnverifiableDevices, U as trimCaches, V as selectCaches, W as parseArchiveSelector, X as memoryLines, Y as memoryCacheKind, Z as memoryScope, _ as DEVICE_LIST_TIMEOUT_MS, at as discoverCaches, b as collectParkedSims, d as collectIdleDevices, et as reclaimMemory, h as shutDownIdleDevices, j as unverifiedDeviceCommand, k as findStaleDeviceRecords, m as parseIdleDuration, nt as phase, p as idleDeviceLines, q as collectMemoryReport, st as sizeCaches, tt as scopedMemoryReport, v as collectDeviceLeases, w as describeParkedSims, x as deleteParkedAvds, y as collectParkedAvds, z as planCacheEmptying } from "./budget-f7516Zk0.mjs";
+import { f as resolveEasCliBin } from "./remote-cache-OyOyVIS3.mjs";
+import { d as listAllIosSims } from "./ios-RkW4pnQf.mjs";
+import { C as parseSessionListPage, T as verifyStoppedSession, _ as findOrphanedOwnedSessions, b as isDefinitiveMissingSessionError, d as withRemoteSessionLock, f as withEasProjectLock, v as getSessionArgs, w as stopSessionArgs, x as listOwnedSessionsArgs, y as inspectSessionForTeardown } from "./device-remote-xRT0Vmo9.mjs";
+import { a as removeEasSessionClaim, n as easMachineStateRoot$1, r as readEasSessionLedger$1 } from "./eas-session-ledger-Cm0Gwq2F.mjs";
+import { r as readCollectors } from "./ownership-DCtw_2IA.mjs";
+import { c as removeWorktrees, l as worktreePullRequestNote, n as previewMaintenance, s as collectWorktreeSweep, u as worktreeRemovalReason } from "./preview-78a9kR_-.mjs";
+import { _ as reclaimProject, g as describeDereferenced, v as deleteSelectedArchives, y as sweepArchiveStaging } from "./worktree-CgvJYJ-Q.mjs";
+import { i as getSwiftpmCacheUsage, n as swiftpmCacheLines, r as getAgentDeviceUsage, t as agentDeviceLines } from "./agent-device-usage-output-Dzgv6lgR.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync, rmSync, statSync } from "node:fs";
-import { basename, dirname, join } from "node:path";
+import { basename, dirname, isAbsolute, join } from "node:path";
 import { basename as basename$1, dirname as dirname$1, isAbsolute as isAbsolute$1, join as join$1 } from "path";
 import { assertHostedDeviceLedger, deviceHostArea, deviceHostRoot, hostedDeviceId, isJsonObject, listRecordedDevices, listStatusCacheEntries, maintenanceRunClaims, parseHostedPlatformDevice, readArchives, readHostedDevice, readHostedDeviceLedger, readHostedSessions, recordedBytes } from "@stim-cli/core/state";
 import { fileURLToPath } from "node:url";
@@ -529,6 +528,40 @@ async function deleteEasSessions(easSessionSweep, deps) {
 	return deleteFailures;
 }
 //#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;
+	if (!isAbsolute(root) || exists(root)) return false;
+	return isOnMountedVolume(root, mountedVolumes);
+}
+function findStaleEasLedgerEntries(mountedVolumes, deps = {}) {
+	const ledger = readEasSessionLedger$1(deps.easLedgerRoot ?? easMachineStateRoot$1());
+	if (!ledger.safe) return [];
+	return [...ledger.claims.values()].filter((claim) => isStaleEasLedgerEntry(claim, mountedVolumes)).map(({ sessionId, workspaceRoot }) => ({
+		id: sessionId,
+		workspaceRoot
+	}));
+}
+function forgetStaleEasLedgerEntries(entries, mountedVolumes, deps = {}) {
+	let failures = 0;
+	const root = deps.easLedgerRoot ?? easMachineStateRoot$1();
+	const remove = deps.removeEasSessionClaim ?? removeEasSessionClaim;
+	for (const entry of entries) try {
+		if (remove(entry.id, root, (claim) => isStaleEasLedgerEntry(claim, mountedVolumes))) console.log(chalk.green(`Forgot the EAS ledger entry ${entry.id} (invalid id, ${entry.workspaceRoot} is gone)`));
+		else console.log(chalk.dim(`Kept the EAS ledger entry ${entry.id}: it changed since the report.`));
+	} catch (error) {
+		failures++;
+		console.log(chalk.red(`Could not forget the EAS ledger entry ${entry.id}: ${describeError(error)}`));
+	}
+	return failures;
+}
+//#endregion
 //#region src/commands/gc/status-caches.ts
 const KINDS = ["disk-usage", "pull-request"];
 const KEPT_REASON = {
@@ -809,7 +842,15 @@ function maintenanceReportLines(maintenance) {
 	}
 	return lines;
 }
-function formatGcReport({ maintenance, archives, skipped = [], deadProjects = [], orphanedPorts, invalidProjects = [], orphanedWorkspaces = [], parkedSims = [], parkedAvds = [], parkedHostedDevices, orphanedDevices = [], unverifiedDevices = [], staleDevices = [], staleDeviceRecords = [], staleLedgerEntries = [], staleStatusCaches = [], buildLocks = {
+function staleEasLedgerLines(entries = []) {
+	if (!entries.length) return [];
+	return [
+		`Stale EAS ledger entries (${entries.length}) - the id is not a valid EAS session id and the workspace is gone:`,
+		...entries.map((entry) => `  ${entry.id} (workspace ${entry.workspaceRoot})`),
+		"              --delete forgets the LEDGER ENTRY only; no EAS session is contacted."
+	];
+}
+function formatGcReport({ maintenance, archives, skipped = [], deadProjects = [], orphanedPorts, invalidProjects = [], orphanedWorkspaces = [], parkedSims = [], parkedAvds = [], parkedHostedDevices, orphanedDevices = [], unverifiedDevices = [], staleDevices = [], staleDeviceRecords = [], staleLedgerEntries = [], staleEasLedgerEntries, staleStatusCaches = [], buildLocks = {
 	stale: [],
 	live: [],
 	unresolved: []
@@ -828,6 +869,7 @@ function formatGcReport({ maintenance, archives, skipped = [], deadProjects = []
 }, agentDeviceUsage = null, swiftpmCacheUsage, caches = [], workspaceOutputs = null, workspaceLogs = [], recordings = [], worktreeSweep = null, memory, cacheScope = null, olderThan = null }, { now = Date.now() } = {}) {
 	const lines = archiveLines(archives);
 	const parkedHostedLines = formatParkedHostedDeviceReport(parkedHostedDevices, now);
+	const easLedgerLines = staleEasLedgerLines(staleEasLedgerEntries);
 	const staleLocks = buildLocks?.stale ?? [];
 	const liveLocks = buildLocks?.live ?? [];
 	const staleSlots = buildSlots?.stale ?? [];
@@ -844,6 +886,7 @@ function formatGcReport({ maintenance, archives, skipped = [], deadProjects = []
 		staleDevices,
 		staleDeviceRecords,
 		staleLedgerEntries,
+		easLedgerLines,
 		staleStatusCaches,
 		staleLocks,
 		staleSlots,
@@ -901,6 +944,7 @@ function formatGcReport({ maintenance, archives, skipped = [], deadProjects = []
 		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(...easLedgerLines);
 	lines.push(...statusCacheLines(staleStatusCaches));
 	if (easSessionSweep.orphaned.length) {
 		lines.push(`Orphaned EAS sessions (${easSessionSweep.orphaned.length}) - current EAS project only:`);
@@ -1083,7 +1127,7 @@ function jsonPullRequest(lookup) {
 		containsHead: pr.containsHead
 	} : null;
 }
-function gcReportSections({ archives, skipped = [], deadProjects = [], orphanedPorts = [], invalidProjects = [], orphanedWorkspaces = [], worktreeSweep = null, parkedSims = [], parkedAvds = [], parkedHostedDevices = [], orphanedDevices = [], unverifiedDevices = [], staleDevices = [], staleDeviceRecords = [], staleLedgerEntries = [], staleStatusCaches = [], buildLocks = {
+function gcReportSections({ archives, skipped = [], deadProjects = [], orphanedPorts = [], invalidProjects = [], orphanedWorkspaces = [], worktreeSweep = null, parkedSims = [], parkedAvds = [], parkedHostedDevices = [], orphanedDevices = [], unverifiedDevices = [], staleDevices = [], staleDeviceRecords = [], staleLedgerEntries = [], staleEasLedgerEntries = [], staleStatusCaches = [], buildLocks = {
 	stale: [],
 	live: [],
 	unresolved: []
@@ -1180,6 +1224,10 @@ function gcReportSections({ archives, skipped = [], deadProjects = [], orphanedP
 			kind,
 			id
 		})),
+		staleEasLedgerEntries: staleEasLedgerEntries.map(({ id, workspaceRoot }) => ({
+			id,
+			workspaceRoot
+		})),
 		staleStatusCaches: staleStatusCaches.map(({ kind, path, file, bytes }) => ({
 			kind,
 			path,
@@ -1526,7 +1574,7 @@ function parseSimRuntimeList(jsonOutput) {
 	if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error("Expected simctl runtime list to return a JSON object.");
 	const runtimes = [];
 	for (const [key, value] of Object.entries(parsed)) {
-		if (value === null || typeof value !== "object" || Array.isArray(value)) continue;
+		if (!isJsonObject(value)) continue;
 		const entry = value;
 		if (entry.platformIdentifier !== IOS_SIMULATOR_PLATFORM) continue;
 		runtimes.push({
@@ -2103,6 +2151,7 @@ async function collectGcReport({ olderThan = null, cache = null, worktrees = fal
 		staleDevices: [],
 		staleDeviceRecords: [],
 		staleLedgerEntries: [],
+		staleEasLedgerEntries: [],
 		staleStatusCaches: [],
 		buildLocks: {
 			stale: [],
@@ -2304,6 +2353,7 @@ async function collectGcReport({ olderThan = null, cache = null, worktrees = fal
 		staleDevices,
 		staleDeviceRecords,
 		staleLedgerEntries,
+		staleEasLedgerEntries: findStaleEasLedgerEntries(mountedVolumes, deps),
 		staleStatusCaches: statusCaches.stale,
 		buildLocks: {
 			stale: locks.filter((l) => !l.alive && !l.unresolved),
@@ -2588,7 +2638,7 @@ async function runGcCore(opts, deps) {
 	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 = 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 + report.parkedHostedDevices.filter((device) => device.listed !== false).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 + report.parkedHostedDevices.filter((device) => device.listed !== false).length > 0 || orphanedDevices.length > 0 || staleDevices.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 || 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;
@@ -2628,6 +2678,7 @@ async function runGcCore(opts, deps) {
 	deleteFailures += await deleteOrphanedWorkspaces(report.orphanedWorkspaces);
 	deleteFailures += deleteProjectDevices(orphanedDevices, staleDevices, staleDeviceRecords);
 	deleteFailures += forgetStaleLedgerEntries(report.staleLedgerEntries);
+	deleteFailures += forgetStaleEasLedgerEntries(report.staleEasLedgerEntries, listMountedVolumes(), deps);
 	deleteFailures += pruneStatusCaches(report);
 	for (const lock of buildLocks.stale) {
 		const cleared = (0, ownership_claim_exports.clearFreeClaimSet)({

package/dist/git-DDfFzkMm.mjs

@@ -0,0 +1,45 @@
+import { t as getExecutor } from "./exec-DqKo9GKJ.mjs";
+//#region src/workspace/git.ts
+const GIT_TIMEOUT_MS = 1e4;
+const GIT_CONCURRENCY = 6;
+function gitCall(cwd, args, { write, timeoutMs = GIT_TIMEOUT_MS, ...opts }) {
+	return {
+		args: [
+			...write ? [] : ["--no-optional-locks"],
+			"-C",
+			cwd,
+			...args
+		],
+		opts: {
+			...opts,
+			timeoutMs
+		}
+	};
+}
+/** Runs git in `cwd`, bounded by `timeoutMs` (10 s by default); throws like `runFile`. */
+function git(cwd, args, opts = {}) {
+	const call = gitCall(cwd, args, opts);
+	return getExecutor().runFile("git", call.args, call.opts);
+}
+/** `git`, returning null instead of throwing. */
+function gitQuiet(cwd, args, opts = {}) {
+	const call = gitCall(cwd, args, opts);
+	return getExecutor().runFileQuiet("git", call.args, call.opts);
+}
+const queue = [];
+let running = 0;
+/** `git` without blocking the event loop, at most six at a time; the budget starts when the call leaves the queue. */
+async function gitAsync(cwd, args, opts = {}) {
+	if (running < GIT_CONCURRENCY) running++;
+	else await new Promise((proceed) => queue.push(proceed));
+	try {
+		const call = gitCall(cwd, args, opts);
+		return await getExecutor().runFileAsync("git", call.args, call.opts);
+	} finally {
+		const next = queue.shift();
+		if (next) next();
+		else running--;
+	}
+}
+//#endregion
+export { gitAsync as n, gitQuiet as r, git as t };

package/dist/{gradle-C2OEKCCI.mjs → gradle-DSrXb6lG.mjs}

@@ -1,10 +1,10 @@
-import { t as getExecutor } from "./exec-B81Qodjn.mjs";
+import { t as getExecutor } from "./exec-DqKo9GKJ.mjs";
 import { n as stripAnsi, r as waitForChild, t as createLineReader } from "./process-output-Fpl8PYi8.mjs";
-import { l as phaseLine } from "./command-output-BjPN99ZB.mjs";
-import { o as androidHome } from "./android-BsYNR81W.mjs";
-import { a as spawnDeclared } from "./spawn-claims-Kqiifsk2.mjs";
-import { a as readCcacheActivity, n as CCACHE_UNAVAILABLE } from "./ccache-CjHQ5F8g.mjs";
-import { M as startBuildHeartbeat, y as HEARTBEAT_INTERVAL_MS } from "./toolchain-DqyDXs30.mjs";
+import { l as phaseLine } from "./command-output-BTy8hZ0F.mjs";
+import { o as androidHome } from "./android-Mz_Inn3w.mjs";
+import { a as spawnDeclared } from "./spawn-claims-DVS5RkMS.mjs";
+import { a as readCcacheActivity, n as CCACHE_UNAVAILABLE } from "./ccache-zdKiYQ3E.mjs";
+import { M as startBuildHeartbeat, y as HEARTBEAT_INTERVAL_MS } from "./toolchain-DxSsNssu.mjs";
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync } from "node:fs";
 import { dirname, isAbsolute, join, relative, sep } from "node:path";
 import { fileURLToPath } from "node:url";

package/dist/{guide-Dai9lphv.mjs → guide-G9cAbVAc.mjs}

@@ -1,8 +1,8 @@
-import { t as ANDROID_AVD_CONFIG_HELP } from "./settings-Bbztm4oV.mjs";
-import { r as findProjectRoot } from "./project-B8_duAzW.mjs";
-import { s as RECENT_LAUNCH_MS } from "./watchman-CQl51YZu.mjs";
-import { o as guideStatus, t as WATCHMAN_NESTED_WORKTREES } from "./doctor-watchman-CB4NnVZm.mjs";
-import "./status-watch-DvmI3SmN.mjs";
+import { t as ANDROID_AVD_CONFIG_HELP } from "./settings-B717odTD.mjs";
+import { r as findProjectRoot } from "./project-_phNIJfs.mjs";
+import { s as RECENT_LAUNCH_MS } from "./watchman-CPQFZLXY.mjs";
+import { o as guideStatus, t as WATCHMAN_NESTED_WORKTREES } from "./doctor-watchman-BRyV2adA.mjs";
+import "./status-watch-C23ILtf9.mjs";
 import { SETTINGS, SETTINGS_SCHEMA_URL, TUTORIAL_VERSION } from "@stim-cli/core/state";
 import chalk from "chalk";
 //#region src/guide/agent.ts
@@ -405,7 +405,7 @@ FULL TOPIC LIST
   stim guide cleanup              # what reclaims a device, and what deletes
   stim guide cleanup collector    # an unproven collector pid; why the app on a phone closed
   stim guide cleanup memory       # watchman and Gradle daemon memory; gc --cache watchman
-  stim guide tutorial             # tutorial sections and manual commands
+  stim guide tutorial             # tutorial sections
   stim guide tutorial run         # create the app and build in a tour worktree
   stim guide settings             # configuration files and supported keys`
 };
@@ -1360,6 +1360,11 @@ RULES
                               root, and browser profile paths whose
                               directory is gone; --delete forgets the
                               ledger entry only
+    staleEasLedgerEntries   { id, workspaceRoot }  entries of the machine
+                              EAS session ledger whose id is not a UUID and
+                              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
@@ -1506,6 +1511,8 @@ RULES
               absent until it has run.
   recording   { enabled }: whether stim-server may record the workspace's
               device screens for replay, from recording.enabled
+  hidden      true when workspace.hidden is set; absent otherwise. The next
+              command that uses the workspace clears it.
 
   Each environment also carries stage, where the workspace is as Stim
   Desktop and the phone app show it: { kind, since, platform, closedApps }.
@@ -6274,11 +6281,12 @@ A RUNNING APP IS RESTARTED, LIKE XCODE'S RUN
   A stop that fails refuses the launch rather than reusing the old process.
   When a simulator's process list cannot be read, Stim launches with
   \`simctl launch --terminate-running-process\`, which replaces any running
-  copy. When an emulator's cannot be read, Stim launches without stopping
-  anything and verification reports what it observes. An iPhone run
-  (\`ios --device\`) needs no extra step: its collector launches with
-  devicectl's \`--terminate-existing\`. Remote targets launch through
-  \`agent-device open --relaunch\`.
+  copy. When an Android device's cannot be read, Stim launches with
+  \`am start -S\`, which force-stops the app first; an app without a
+  launcher activity gets a best-effort \`am force-stop\` before \`monkey\`.
+  Neither claims a restart. An iPhone run (\`ios --device\`) needs no extra
+  step: its collector launches with devicectl's \`--terminate-existing\`.
+  Remote targets launch through \`agent-device open --relaunch\`.
 
 RUNTIME STATE AND BUILD INPUTS
 Runtime state is stored outside the project tree under
@@ -8076,6 +8084,14 @@ THE MIRROR IMAGE: A STALE DEVICE RECORD
   runs still counts as this home's; run \`gc\` after deleting a Stim AVD by
   hand.
 
+  The machine EAS session ledger (~/.stim/machine/eas/sessions.json) can hold
+  entries that no EAS session ever had, such as ids written by a test
+  fixture. \`gc\` reports an entry under "Stale EAS ledger entries" only when
+  its id is not a UUID AND its workspace root is an absolute path that is
+  missing on a mounted volume. A valid id, an existing root, or a root on an
+  unmounted volume keeps the entry. \`gc --delete\` re-checks each entry and
+  removes it under the ledger lock; it never contacts EAS.
+
 THE ONE CASE GC WILL NOT REAP
   If the config is gone entirely (deleted ~/.stim, or a throwaway
   STIM_HOME), gc cannot tell your stale devices from another config's LIVE
@@ -9163,8 +9179,10 @@ The same \`remote.machines\` list names the Macs that may build for this one:
 node in $STIM_HOME/build-machines.json. A person approves the request on that
 Mac with \`stim-server devices grant <id> --build\`; doctor prints the id.
 A person can instead run \`stim-server setup\` on the worker with a node,
-ticket and expiry, under the approval rule above. Build never includes read
-or control.
+ticket and expiry, under the approval rule above. A build grant is full access
+to the account stim-server runs as: project code runs there unsandboxed, so it
+can grant itself read and control. Revoking it does not undo what that code
+already did. Grant it only to Macs you trust.
 Stim connects to a named Mac only while its name still belongs to the pinned
 node and never sends the token to another node. \`doctor\` reports each
 remote Mac's build pairing state and, for an approved one, asks it for one build
@@ -9366,6 +9384,19 @@ them within seconds, as soon as \`stim status\` shows recording.enabled false
 for them. Turning it back on records from then on. See \`guide cleanup\` for
 how recordings are removed otherwise.
 
+HIDE A WORKSPACE IN THE APPS
+\`workspace.hidden\` is a boolean, false by default, set only at workspace
+scope, so it needs no --scope. Run it from the workspace:
+
+  stim settings set workspace.hidden true
+  stim settings unset workspace.hidden
+
+\`stim status --json\` then reports hidden: true on that environment, and
+clients that read it list the workspace under Hidden. The next start, ios,
+android, web, macos, reload or worktree warm in the workspace clears it, so
+a workspace in use is never hidden. \`worktree remove\` drops it with the
+workspace.
+
 STIM NEEDS NO PROJECT CHANGES TO RUN
 Nothing above is required to use Stim. The performance caches that used to
 be setup steps are supplied by Stim on the command lines it composes itself:
@@ -9592,7 +9623,11 @@ FileStore shards across 256 directories, a build cache is keyed
 platform instead of one entry. Pass prune: 'atomic' for a cache whose index
 references its own data (an LLVM CAS): it is then left alone by --older-than
 and emptied whole only by 'gc --delete --cache all'.
-Registration is idempotent and keyed on the directory.`
+Registration is idempotent and keyed on the directory.
+dir must be absolute (a leading ~ is expanded) and dedicated to the cache.
+register throws for a path that is or contains the home directory, the system
+temporary directory, the Stim config directory or a filesystem root, and gc
+never prunes or empties such a directory.`
 };
 //#endregion
 //#region src/guide/web.ts
@@ -9955,8 +9990,11 @@ attempt falls back here. Placement and failure reasons are in build logs.
 
 AGENT ACTIONS
 
-Launch through stim macos first. Use its isolated bundleId from the JSON
-launch record or status --json:
+Launch through stim macos first. Use its isolated bundleId from the JSON launch
+record or status --json. stim macos waits, for up to 20 seconds, until macOS
+LaunchServices lists the app, so agent-device open attaches to it instead of
+starting a second copy. If it is still unlisted, stim macos warns and returns;
+wait before opening. A --remote launch skips the wait:
 
   agent-device open <bundleId> --platform macos --surface app --foreground
   agent-device click <ref> --settle
@@ -10260,139 +10298,13 @@ const TUTORIAL_RESTART_PROMPT = "Restart the Stim tutorial.";
 const TUTORIAL_ASKS = {
 	begin: `Clone ${TUTORIAL_REPO} into {base} and follow stim guide tutorial run.`,
 	build: "Make the title purple in the Stim tutorial app and check it on the simulator.",
-	agent: "Open the app on the iOS simulator, take a screenshot and confirm the title color.",
+	parallel: "While that builds, make the Tap me button green in a new worktree and check it on the simulator.",
 	finish: "I'm done with these experiments in {base} and don't need the changes. Stop the apps and remove the worktrees {worktrees}, and keep the clone. Follow stim guide tutorial finish.",
-	delete: "Remove the Stim tutorial: remove its worktrees and the clone at {base} with stim worktree remove, then delete {base}. Follow stim guide tutorial delete.",
+	delete: "Remove the test app: run stim worktree remove on {base}, then delete the folder. Follow stim guide tutorial delete.",
 	share: `Open a pull request to ${TUTORIAL_REPO} with my title color change, with before and after screenshots from the simulator. See stim guide tutorial share.`,
 	retry: "The first iOS build of the tutorial app in {tour} failed. Find out why and run it on iOS again."
 };
-const TUTORIAL_STEPS = [
-	{
-		id: "begin",
-		title: "Get the Test App",
-		who: "agent",
-		optional: false,
-		ask: TUTORIAL_ASKS.begin,
-		section: "run",
-		commands: []
-	},
-	{
-		id: "build",
-		title: "Make a Change",
-		who: "you",
-		optional: false,
-		ask: TUTORIAL_ASKS.build,
-		section: null,
-		commands: []
-	},
-	{
-		id: "parallel",
-		title: "Change It Again in Parallel",
-		who: "you",
-		optional: false,
-		ask: null,
-		section: null,
-		commands: []
-	},
-	{
-		id: "device",
-		title: "Live View and Control",
-		who: "you",
-		optional: true,
-		ask: null,
-		section: null,
-		commands: ["stim status"]
-	},
-	{
-		id: "agent",
-		title: "Agent Actions and Replay",
-		who: "agent",
-		optional: true,
-		ask: TUTORIAL_ASKS.agent,
-		section: null,
-		commands: [
-			"cd \"{tour}\"",
-			"export AGENT_DEVICE_STATE_DIR=\"{stateDir}\"",
-			`agent-device open ${TUTORIAL_BUNDLE_ID} --platform ios --udid {udid}`,
-			"agent-device screenshot tutorial.png",
-			"agent-device close",
-			"stim logs --source agent --tail 10"
-		]
-	},
-	{
-		id: "logs",
-		title: "App Logs",
-		who: "you",
-		optional: true,
-		ask: null,
-		section: null,
-		commands: ["stim logs --errors", "stim logs --grep stim:tutorial"]
-	},
-	{
-		id: "phone",
-		title: "Watch on Your Phone",
-		who: "you",
-		optional: true,
-		ask: null,
-		section: null,
-		commands: []
-	},
-	{
-		id: "share",
-		title: "Share Your Finish",
-		who: "you",
-		optional: true,
-		ask: TUTORIAL_ASKS.share,
-		section: "share",
-		commands: [
-			"cd \"{tour}\"",
-			"git commit -am \"<one-line summary>\"",
-			"mkdir -p .expo/screenshots",
-			"git checkout origin/main -- theme.js",
-			"xcrun simctl io {udid} screenshot .expo/screenshots/before.png",
-			"git checkout HEAD -- theme.js",
-			"xcrun simctl io {udid} screenshot .expo/screenshots/after.png",
-			"cp .github/pull_request_template.md .expo/screenshots/body.md",
-			`gh repo fork ${TUTORIAL_REPO} --remote --remote-name fork`,
-			"git push -u fork HEAD",
-			`gh pr create --repo ${TUTORIAL_REPO} --title "<one-line summary>" --body-file .expo/screenshots/body.md --attach ".expo/screenshots/before.png#Before" --attach ".expo/screenshots/after.png#After"`
-		]
-	},
-	{
-		id: "finish",
-		title: "Finish and Archive",
-		who: "agent",
-		optional: false,
-		ask: TUTORIAL_ASKS.finish,
-		section: "finish",
-		commands: [
-			"cd \"{tour}\"",
-			"stim stop",
-			"cd \"{second}\"",
-			"stim stop",
-			"cd \"{base}\"",
-			"stim worktree remove \"{tour}\"",
-			"stim worktree remove \"{second}\""
-		]
-	},
-	{
-		id: "delete",
-		title: "Delete the Test App",
-		who: "agent",
-		optional: true,
-		ask: TUTORIAL_ASKS.delete,
-		section: "delete",
-		commands: [
-			"cd \"{base}\"",
-			"grep stimTutorial app.json",
-			"git worktree list",
-			"stim stop",
-			"stim worktree remove \"{base}\"",
-			"cd ..",
-			"rm -rf \"{base}\""
-		]
-	}
-];
+TUTORIAL_ASKS.begin, TUTORIAL_ASKS.build, TUTORIAL_ASKS.parallel, TUTORIAL_ASKS.share, TUTORIAL_ASKS.finish, TUTORIAL_ASKS.delete;
 //#endregion
 //#region src/guide/tutorial.ts
 const paths = `Use {base} = ~/stim-tutorial unless the user named another folder. Expand ~
@@ -10420,9 +10332,6 @@ Without agent-device, use xcrun simctl io <ios.udid> screenshot
 never booted. Take both with the same tool so they match in size. .expo/ is
 ignored and outside the native fingerprint, so the files are never committed,
 never change the build, and never block stim worktree remove. Keep each PNG under 1 MB.`;
-function commands(id) {
-	return TUTORIAL_STEPS.find((step) => step.id === id).commands.join("\n");
-}
 //#endregion
 //#region src/guide/index.ts
 const TOPICS = {
@@ -10444,11 +10353,9 @@ const TOPICS = {
 		preamble: () => `STIM TUTORIAL
 
 The tutorial clones ${TUTORIAL_REPO}, a tiny Expo app, into {base}; the clone is
-never run, and only the optional delete step removes it. The user then asks for a visual change, and for another
-change while the first builds. Each change runs in its own linked worktree of
-{base}, so each has its own simulator and Metro port, and the second worktree's
-first iOS build reuses the first one's native build. Only the clone, the
-optional share and the cleanup need this guide: the changes are ordinary
+never run, and only the optional delete step removes it. The user then asks for a visual change, which runs in a
+linked worktree of {base} with its own simulator and Metro port. Only the clone,
+the optional share and the cleanup need this guide: the changes are ordinary
 requests, so follow stim guide agent for them, and check each change on the
 device.
 
@@ -10461,8 +10368,7 @@ ${local}
 
 ${paths}
 
-Never pair phones, approve machines, or grant access on the user's behalf.
-For commands to type yourself, read stim guide tutorial manual.`,
+Never pair phones, approve machines, or grant access on the user's behalf.`,
 		sections: {
 			run: {
 				summary: "Clone the test app into a fresh folder and install its dependencies",
@@ -10501,10 +10407,20 @@ ${local}
 
 ${screenshots}
 
+Check each change on the device with agent-device in that same session, after
+the after screenshot, so Stim Desktop records your actions and the user can
+replay them: tap tap-button, toggle dark-accent-switch, pick a size
+(size-s, size-m or size-l), then take a screenshot (agent-device screenshot
+.expo/screenshots/checked.png) and confirm the change. Refs expire after each
+action: run agent-device snapshot -i before every action and use the ref it
+reports for that testID. When agentDevice.installed is false in stim status
+--json, do not install agent-device unasked: check the change with the build
+result and stim logs --errors, and tell the user that agent-device would let
+you tap through the app.
+
 PAUSE: end the turn. Tell the user to ask for a visual change next, such as
-making the title purple, in their own words. Each change runs in a new linked
-worktree of {base} (stim guide agent), and its first iOS build takes a few
-minutes.`
+making the title purple, in their own words. It runs in a new linked worktree
+of {base} (stim guide agent), and its first iOS build takes a few minutes.`
 			},
 			finish: {
 				summary: "Stop and remove the two tutorial worktrees, keeping the clone",
@@ -10518,7 +10434,13 @@ as {tour} and {second}. Never touch any other worktree, an earlier tutorial
 clone, or the clone itself. For each, stop from its path, then remove it from
 the clone:
 
-${commands("finish")}
+  cd "{tour}"
+  stim stop
+  cd "{second}"
+  stim stop
+  cd "{base}"
+  stim worktree remove "{tour}"
+  stim worktree remove "{second}"
 
 Use a plain remove first. The user's finish request says they do not need the
 changes, which is the consent stim guide agent asks for before worktree remove
@@ -10631,25 +10553,6 @@ path; never use --force for them. Reuse the clone at {base} only if its
 stimTutorial marker equals ${TUTORIAL_VERSION}; otherwise follow stim guide
 tutorial run into a fresh folder. Pause as run instructs. Stim Desktop starts
 over: only worktrees and builds after the restart count.`
-			},
-			manual: {
-				summary: "The commands behind each step, for typing yourself",
-				body: () => `MANUAL TUTORIAL
-
-${paths}
-
-Replace {base}, {tour} and {second} with absolute paths: {base} is the clone,
-{tour} the first worktree and {second} the second. For Agent Actions, replace
-{stateDir} with agentDevice.stateDir from stim ios or stim status --json and
-{udid} with the workspace's ios.udid. Clone with git
-clone https://github.com/${TUTORIAL_REPO}.git into a fresh folder outside any
-repository. Each change runs in its own worktree of that clone (stim guide
-agent); the clone itself is never run. Run each worktree on iOS with
-stim ios --remote local --remote-build local so it stays on this Mac.
-
-${TUTORIAL_STEPS.map((step) => `${step.title}${step.optional ? " (optional)" : ""}\n\n${step.commands.length ? `\`\`\`sh\n${step.commands.join("\n")}\n\`\`\`` : "Ask your agent in your own words, or observe this step in Stim Desktop."}`).join("\n\n")}
-
-Finish removes only the two tutorial worktrees, never the clone; stim guide tutorial finish says when --force is allowed for them.`
 			}
 		}
 	}

package/dist/{hosted-android-DQ-Agsd8.mjs → hosted-android-C3MHGld1.mjs}

@@ -1,6 +1,6 @@
-import { o as call, s as connectHost } from "./hosted-client-Io01s5By.mjs";
-import { i as requestHostedMetro } from "./metro-gateway-BBJldOdi.mjs";
-import { n as prepareHostedNative, r as stopHostedNative, t as placeHostedNative } from "./hosted-native-BdAQi21M.mjs";
+import { c as connectHost, s as call } from "./hosted-client-ZEKpS9vw.mjs";
+import { i as requestHostedMetro } from "./metro-gateway-CX9Xlkq2.mjs";
+import { n as prepareHostedNative, r as stopHostedNative, t as placeHostedNative } from "./hosted-native-A4s1QPXe.mjs";
 //#region src/device-host/hosted-android.ts
 async function prepareHostedAndroid(machine, selectors, recorded, mode) {
 	return await prepareHostedNative(machine, selectors, recorded, "android", false, mode);