stim 1.26.0 → 1.27.0

package/dist/{ios-project-Ty5pHl9O.mjs → ios-project-D8Jcy_br.mjs}

@@ -1,13 +1,14 @@
-import { w as workspaceAgentDeviceDir } from "./workspace-state-pUg3_RRA.mjs";
-import { i as formatDuration, l as phaseLine } from "./command-output-BF5AR2dL.mjs";
-import { a as workspaceLinkLine } from "./stim-desktop-6Dqp-gjX.mjs";
-import { Gn as UPLOAD_TIMEOUT_MS, Jn as easAuthNote, Kn as cacheLevel, W as recordFinishedBuild, Yn as isEasAuthFailureText } from "./budget-k2mZGvvk.mjs";
-import { P as compilationCacheActivityLine, k as COMPILATION_CACHE_NOT_RUN } from "./toolchain-J4J8MrAr.mjs";
-import { i as deviceLabel } from "./support-CVOCp0Ft.mjs";
+import { w as workspaceAgentDeviceDir } from "./workspace-state-BjqdjnJR.mjs";
+import { i as formatDuration, l as phaseLine } from "./command-output-Dj-WT4BP.mjs";
+import { a as workspaceLinkLine } from "./stim-desktop-CbWo21kb.mjs";
+import { Mn as isEasAuthFailureText, On as UPLOAD_TIMEOUT_MS, jn as easAuthNote, kn as cacheLevel } from "./ccache-BWTze1Ls.mjs";
+import { q as recordFinishedBuild } from "./workspaces-DFbj07jp.mjs";
+import { P as compilationCacheActivityLine, k as COMPILATION_CACHE_NOT_RUN } from "./toolchain-CbCG6C5Z.mjs";
+import { i as deviceLabel } from "./support-Be0UeVZU.mjs";
 import { buildDiagnostics } from "@stim-cli/core/state";
 import chalk from "chalk";
 //#region src/commands/ios/result.ts
-function lastBuildRecord({ devicePlacement, fingerprint = null, cacheKey = null, cacheHit = false, cacheSkipped = false, durationMs = 0, appPath = null, bundleId = null, startedAt, status, errorCode = null, missReason = null, diagnostics = null, configuration = null, buildMachine = "auto", builtOn, offloadedTo = null, offloadFallback = null }) {
+function lastBuildRecord({ devicePlacement, fingerprint = null, cacheKey = null, cacheHit = false, cacheSkipped = false, durationMs = 0, appPath = null, bundleId = null, startedAt, status, errorCode = null, missReason = null, diagnostics = null, configuration = null, buildMachine = "auto", builtOn, offloadedTo = null, offloadFallback = null, ledger }) {
 	const record = {
 		platform: "ios",
 		fingerprint,
@@ -30,6 +31,7 @@ function lastBuildRecord({ devicePlacement, fingerprint = null, cacheKey = null,
 	if (missReason && !cacheLevel(cacheHit)) record.missReason = missReason;
 	const recorded = status === "failed" ? buildDiagnostics(diagnostics) : [];
 	if (recorded.length) record.diagnostics = recorded;
+	if (ledger) record.ledger = ledger;
 	return record;
 }
 function iosFacts({ root, slot, udid, deviceName, deviceType = null, runtime = null, fingerprint, configuration = null, scheme = null, cacheKey, cacheHit, cacheSkipped = false, compilationCache = COMPILATION_CACHE_NOT_RUN, waitedForBuild = null, appPath, bundleId, installSkipped = false, metroPort, logsDir, durationMs, launched = true, webPreviewUrl = null, lease, devServer = null, buildMachine = "auto", builtOn, offloadedTo = null, offloadFallback = null }) {
@@ -68,6 +70,13 @@ function iosFacts({ root, slot, udid, deviceName, deviceType = null, runtime = n
 		...devServer ? { devServer } : {}
 	};
 }
+function iosLedgerDevice(device) {
+	const name = device?.deviceName ?? device?.name;
+	return name && name !== device?.deviceUdid ? {
+		name,
+		runtime: device?.runtime ?? null
+	} : null;
+}
 function writeLastBuild(root, record, { record: recordBuild = recordFinishedBuild } = {}) {
 	try {
 		recordBuild(root, record);
@@ -118,7 +127,11 @@ function reportIosResult({ output, devicePlacement, host, slot, root, json, rele
 		buildMachine,
 		builtOn,
 		offloadedTo,
-		offloadFallback
+		offloadFallback,
+		ledger: {
+			scheme: buildScheme,
+			device: iosLedgerDevice(device)
+		}
 	}));
 	closeWriter();
 	const facts = iosFacts({
@@ -194,4 +207,4 @@ var IosRecipeRefusal = class extends Error {
 	}
 };
 //#endregion
-export { lastBuildRecord as a, iosFacts as i, cacheDescription as n, reportIosResult as o, finishIosUpload as r, writeLastBuild as s, IosRecipeRefusal as t };
+export { iosLedgerDevice as a, writeLastBuild as c, iosFacts as i, cacheDescription as n, lastBuildRecord as o, finishIosUpload as r, reportIosResult as s, IosRecipeRefusal as t };

package/dist/{ios-signing-4c_qXvQm.mjs → ios-signing-BJzvDPfU.mjs}

@@ -1,5 +1,5 @@
-import { c as throwIfCancelled, t as getExecutor } from "./exec-VFRpu1iA.mjs";
-import { a as killOnAbort, r as childEnvironment } from "./operation-exec-CUZifp6Z.mjs";
+import { c as throwIfCancelled, t as getExecutor } from "./exec-aULwtNly.mjs";
+import { a as killOnAbort, r as childEnvironment } from "./operation-exec-Dp4FuIGR.mjs";
 import { X509Certificate } from "node:crypto";
 import { existsSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";

package/dist/{ios-state-Cw7-WQf2.mjs → ios-state-BZ03NFgF.mjs}

@@ -1,4 +1,4 @@
-import { l as withWorkspaceStateLockAsync, o as updateWorkspaceState, r as readWorkspaceState$1 } from "./workspace-state-pUg3_RRA.mjs";
+import { l as withWorkspaceStateLockAsync, o as updateWorkspaceState, r as readWorkspaceState$1 } from "./workspace-state-BjqdjnJR.mjs";
 import { HOSTED_METRO_REQUESTS_KEY, hostedMetroRequests, hostedNativeRecords, isJsonObject, parseHostedNativePlacement, unreadableHostedNative } from "@stim-cli/core/state";
 //#region src/device-host/ios-state.ts
 function readHostedNative(root, platform, slot) {

package/dist/{js-swap-BMhXYVDS.mjs → js-swap-Dg2a945i.mjs}

@@ -1,10 +1,10 @@
-import { _ as spawnDeclared, b as operationState, c as throwIfCancelled, t as getExecutor } from "./exec-VFRpu1iA.mjs";
+import { _ as spawnDeclared, b as operationState, c as throwIfCancelled, t as getExecutor } from "./exec-aULwtNly.mjs";
 import { r as waitForChild, t as createLineReader } from "./process-output-Fpl8PYi8.mjs";
-import { a as killOnAbort, t as runOperationFile } from "./operation-exec-CUZifp6Z.mjs";
-import { Ut as makeTemporaryDirectory, Wt as removeTemporaryEntry } from "./settings-CosW5X-S.mjs";
-import { rr as bundleInvocation } from "./budget-k2mZGvvk.mjs";
-import { s as expoTelemetryEnv, t as cleanLine } from "./server-expo-eQfOdydb.mjs";
-import { G as tailLines, U as startBuildHeartbeat, j as HEARTBEAT_INTERVAL_MS } from "./toolchain-J4J8MrAr.mjs";
+import { a as killOnAbort, t as runOperationFile } from "./operation-exec-Dp4FuIGR.mjs";
+import { $t as makeTemporaryDirectory, en as removeTemporaryEntry } from "./settings-BDVI8Ivc.mjs";
+import { Bn as bundleInvocation } from "./ccache-BWTze1Ls.mjs";
+import { G as tailLines, U as startBuildHeartbeat, j as HEARTBEAT_INTERVAL_MS } from "./toolchain-CbCG6C5Z.mjs";
+import { s as expoTelemetryEnv, t as cleanLine } from "./server-expo-ABQs2XFA.mjs";
 import { randomUUID } from "node:crypto";
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import { basename, join } from "node:path";
@@ -120,7 +120,8 @@ async function readPlistKey(context, e, plist, key, format) {
 			plist
 		], { timeoutMs: 1e4 });
 	} catch (err) {
-		if (/No value at that key path/.test(describe(err))) return null;
+		const stdout = typeof err === "object" && err !== null && "stdout" in err ? String(err.stdout) : "";
+		if (/No value at that key path/.test(`${describe(err)}\n${stdout}`)) return null;
 		throw err;
 	}
 }

package/dist/{launch-DOp8RjDz.mjs → launch-CRyBeNsA.mjs}

@@ -1,23 +1,24 @@
-import { k as workspaceLogsDir } from "./workspace-state-pUg3_RRA.mjs";
-import { B as deviceSlotFileKey, C as saveConfig, E as upsertProject, H as deviceSlotPlatforms, O as withConfigLockAsync, P as formatBytes, V as deviceSlotKey, _ as loadConfig, w as setDevice } from "./config-BktkY_zC.mjs";
-import { _ as stepTimer, c as launchErrorReport, i as formatDuration, l as phaseLine, n as appReadinessMessage, v as launchErrorPreview } from "./command-output-BF5AR2dL.mjs";
-import { L as workspaceDevServerMode } from "./project-BUu6Is4k.mjs";
-import { o as workspaceLinks } from "./stim-desktop-6Dqp-gjX.mjs";
-import { i as androidDataFreeBytes, ot as trimAndroidCaches, tt as resetAdoptedAvd, u as androidToolCwd } from "./android-DTAcRwBC.mjs";
-import { c as pidExists, f as signalProcessTree } from "./metro-CjC10t6E.mjs";
-import { $t as LAUNCH_BUNDLING, Dn as installConflictKind, Nn as restartedAppNote, cn as unattributedLaunchLines, en as LAUNCH_FATAL, in as VERIFY_TIMEOUT_MS, ln as unverifiedLaunchLines, mn as ADB_INSTALL_TIMEOUT_MS, rn as RELEASE_VERIFY_WAIT_MS, tn as LAUNCH_UNVERIFIED, vn as androidAppProcess, yn as androidDevClientUrl } from "./budget-k2mZGvvk.mjs";
-import { O as teardownOwnedAvd } from "./workspaces-g2lhdBXF.mjs";
-import { b as providerUploadOutcome } from "./build-cache-DrXNCy3T.mjs";
-import { n as verifyCollectorOwnership, r as readCollectors } from "./ownership-BjYvMNX_.mjs";
-import { t as recordPhoneReverse } from "./phone-reverses-lmj6kcPm.mjs";
-import { n as nativeRunCommand, r as siblingPlatformSlots, t as launchSlotScope } from "./slot-launch-CYCEhfBY.mjs";
+import { x as withDrainingCancellation } from "./exec-aULwtNly.mjs";
+import { k as workspaceLogsDir } from "./workspace-state-BjqdjnJR.mjs";
+import { B as deviceSlotFileKey, C as saveConfig, E as upsertProject, H as deviceSlotPlatforms, O as withConfigLockAsync, P as formatBytes, V as deviceSlotKey, _ as loadConfig, w as setDevice } from "./config-Cn94Jc0g.mjs";
+import { _ as stepTimer, c as launchErrorReport, i as formatDuration, l as phaseLine, n as appReadinessMessage, v as launchErrorPreview } from "./command-output-Dj-WT4BP.mjs";
+import { L as workspaceDevServerMode } from "./project-DYj-HVx6.mjs";
+import { o as workspaceLinks } from "./stim-desktop-CbWo21kb.mjs";
+import { i as androidDataFreeBytes, ot as trimAndroidCaches, tt as resetAdoptedAvd, u as androidToolCwd } from "./android-DriNoAVy.mjs";
+import { c as pidExists, f as signalProcessTree } from "./metro-CvyD-xwe.mjs";
+import { Bt as RELEASE_VERIFY_WAIT_MS, Gt as unattributedLaunchLines, It as LAUNCH_BUNDLING, Kt as unverifiedLaunchLines, Lt as LAUNCH_FATAL, Rt as LAUNCH_UNVERIFIED, Vt as VERIFY_TIMEOUT_MS, Zt as ADB_INSTALL_TIMEOUT_MS, gn as restartedAppNote, nn as androidDevClientUrl, tn as androidAppProcess, un as installConflictKind } from "./ccache-BWTze1Ls.mjs";
+import { ut as teardownOwnedAvd } from "./workspaces-DFbj07jp.mjs";
+import { x as providerUploadOutcome } from "./build-cache-gBJ-WKzA.mjs";
+import { t as recordPhoneReverse } from "./phone-reverses-C9yAaKEv.mjs";
+import { n as verifyCollectorOwnership, r as readCollectors } from "./ownership-Bx-0cku-.mjs";
+import { n as nativeRunCommand, r as siblingPlatformSlots, t as launchSlotScope } from "./slot-launch-0l7RqSpr.mjs";
 import { t as spawnEntry } from "./spawn-entry-jw19m8Nl.mjs";
-import { c as lostRefusal, s as lostLine, t as DEBUG_VERIFY_STEP_MS } from "./device-lease-run-BmvIl7bI.mjs";
-import { a as printNativeCrashReport, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-BOOm9Db7.mjs";
-import { f as settleFingerprintCheck } from "./prebuild-gmouvmJZ.mjs";
-import { i as launchOutcomeRecord } from "./native-runtime-Dq3RBcON.mjs";
-import { a as PLATFORM, b as noDeviceDiagnostic, h as displayPath, n as LAUNCH_FAILED, r as NO_DEVICE, t as INSTALL_FAILED } from "./support-BGSCBoib.mjs";
-import { a as persistLastBuild, n as finishAndroidUpload, s as reportAndroidResult } from "./result-7F5hEwQJ.mjs";
+import { c as lostRefusal, s as lostLine, t as DEBUG_VERIFY_STEP_MS } from "./device-lease-run-DwsGfjUN.mjs";
+import { a as captureNativeCrashes, r as androidCrashClockOffset, s as printNativeCrashReport, t as errorDiagnostics } from "./error-diagnostics-snej9k4j.mjs";
+import { f as settleFingerprintCheck } from "./prebuild-BDpToDgR.mjs";
+import { i as launchOutcomeRecord } from "./native-runtime-DqaIBO5w.mjs";
+import { a as PLATFORM, b as noDeviceDiagnostic, h as displayPath, n as LAUNCH_FAILED, r as NO_DEVICE, t as INSTALL_FAILED } from "./support-CNg_YsOk.mjs";
+import { a as persistLastBuild, n as finishAndroidUpload, s as reportAndroidResult } from "./result-CTqBw2Te.mjs";
 import { mkdirSync, openSync, statSync } from "node:fs";
 import { basename, join } from "node:path";
 import { ambientEnv } from "@stim-cli/core";
@@ -104,17 +105,11 @@ async function startCollector({ root, slot = "default", serial, packageName, spa
 //#endregion
 //#region src/commands/android/launch.ts
 function androidLaunchOutcomeRecord(kind, args) {
-	if (kind !== "process") return launchOutcomeRecord({
+	return launchOutcomeRecord({
 		...args,
-		release: kind === "embedded-js"
+		release: kind === "embedded-js",
+		process: kind === "process"
 	});
-	const unverified = args.launchState === LAUNCH_UNVERIFIED;
-	return {
-		src: "build",
-		level: unverified ? "warn" : "info",
-		event: unverified ? "launch_unverified" : "launch_verified",
-		msg: unverified ? `${args.bundleId} could not be verified as running` : `${args.bundleId} is running its native process`
-	};
 }
 function androidProcessRuntime(prepare, kind = "process") {
 	return {
@@ -192,19 +187,28 @@ async function verifyAndroidMetroRun({ operation, root, slot, remoteDevice, veri
 		physical,
 		deviceId: serial
 	});
-	const readNativeCrashes = () => hostedLogs ? hostedLogs.readNativeCrashes() : remoteDevice ? [] : captureNativeCrashes({
-		root,
-		slot,
-		platform: "android",
-		deviceId: serial,
-		appId: androidPackage,
-		since: launchedAt
-	}, logsDir, operation?.signal, operation?.env);
+	let clockOffsetMs;
+	const readNativeCrashes = async () => {
+		if (hostedLogs) return hostedLogs.readNativeCrashes();
+		if (remoteDevice) return [];
+		const measured = clockOffsetMs ?? await androidCrashClockOffset(serial, operation?.signal);
+		if (measured !== null) clockOffsetMs = measured;
+		return captureNativeCrashes({
+			root,
+			slot,
+			platform: "android",
+			deviceId: serial,
+			appId: androidPackage,
+			since: launchedAt,
+			clockOffsetMs: measured
+		}, logsDir, operation?.signal, operation?.env);
+	};
 	const freshEmulator = Boolean((device.created || device.adoptionPending) && device.owned && !remoteDevice);
 	const timeoutMs = freshEmulator ? 6e4 : VERIFY_TIMEOUT_MS;
 	if (metroCheck && freshEmulator) phase("verify", `waiting up to 60s for bundle load (${device.created ? "new" : "adopted"} emulator)`);
 	const siblings = metroCheck ? await siblingPlatformSlots(root, "android", slot) : [];
-	const verification = metroCheck ? await verifyLaunched({
+	const verification = metroCheck ? await withDrainingCancellation(operation, operation?.signal, () => verifyLaunched({
+		signal: operation?.signal,
 		timeoutMs,
 		requireBundleResponse: true,
 		slot: launchSlotScope(root, slot),
@@ -223,7 +227,7 @@ async function verifyAndroidMetroRun({ operation, root, slot, remoteDevice, veri
 			const running = await androidAppProcess(serial, androidPackage);
 			return running.state === "unknown" ? null : running.state === "running";
 		}
-	}) : {
+	})) : {
 		verified: false,
 		skipped: true
 	};

package/dist/lightened-BCsdAGj_.mjs

@@ -0,0 +1,171 @@
+import { l as WorkspaceProcessCleanupError } from "./exec-aULwtNly.mjs";
+import { c as withWorkspaceStateLock } from "./workspace-state-BjqdjnJR.mjs";
+import { l as phaseLine } from "./command-output-Dj-WT4BP.mjs";
+import { Nt as podsOutOfSync, Ot as listCarryableIgnoredEntries, Pt as readWorktreeExclude, Q as resolveSettings, Wt as warmWorktreePaths, _t as depsOutOfSync } from "./settings-BDVI8Ivc.mjs";
+import { t as canonicalPath } from "./paths-BsJMoPP2.mjs";
+import { h as warmWorktreeTarget } from "./worktree-COAJ3-OD.mjs";
+import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { basename, dirname, join, relative } from "node:path";
+import { isJsonObject, readJsonObject, workspaceLightenedFile, workspaceMetadataFile } from "@stim-cli/core/state";
+//#region src/workspace/lightened.ts
+function strings(value) {
+	return Array.isArray(value) ? value.filter((entry) => typeof entry === "string") : [];
+}
+function readRecord(root) {
+	const record = readJsonObject(workspaceLightenedFile(root));
+	return isJsonObject(record) ? {
+		dirs: strings(record.dirs),
+		pending: strings(record.pending)
+	} : {
+		dirs: [],
+		pending: []
+	};
+}
+/** The keys among `keys` that have a Stim workspace, which is what restores a lightened worktree. */
+function workspaceKeys(keys) {
+	return keys.filter((key) => existsSync(workspaceMetadataFile(key)));
+}
+const LOCKFILES = [
+	"pnpm-lock.yaml",
+	"package-lock.json",
+	"yarn.lock",
+	"bun.lock",
+	"bun.lockb"
+];
+function readOrNull(path) {
+	try {
+		return readFileSync(path);
+	} catch {
+		return null;
+	}
+}
+async function sourceFacts(worktree, operation) {
+	try {
+		const { root: source, common } = await warmWorktreePaths(worktree, operation);
+		const settings = resolveSettings({
+			gitCommonDir: common,
+			repoRoot: source
+		}).worktree;
+		const configured = isJsonObject(settings) && Array.isArray(settings.exclude) ? settings.exclude.filter((entry) => typeof entry === "string") : [];
+		const excluded = readWorktreeExclude(source);
+		const patterns = excluded?.length ? excluded : configured;
+		return {
+			source,
+			carryable: new Set(await listCarryableIgnoredEntries(source, patterns, {
+				env: operation?.env,
+				signal: operation?.signal,
+				declareFor: operation
+			}))
+		};
+	} catch (error) {
+		operation?.signal.throwIfAborted();
+		if (error instanceof WorkspaceProcessCleanupError) throw error;
+		return null;
+	}
+}
+/**
+* Why `worktree warm` could not put back what is deleted at `path`, or null when it copies the same versions back: it
+* carries that directory from the source checkout, and both hold the same lockfile.
+*/
+async function restoreProblem({ worktree, path }, cache = /* @__PURE__ */ new Map(), operation) {
+	let pending = cache.get(worktree);
+	if (!pending) cache.set(worktree, pending = sourceFacts(worktree, operation));
+	const facts = await pending;
+	if (!facts) return "its source checkout cannot be resolved, so worktree warm could not restore it";
+	const rel = relative(worktree, path);
+	if (!facts.carryable.has(rel)) return `worktree warm would not copy ${rel} back from the source checkout`;
+	const pods = basename(rel) === "Pods";
+	if ((pods ? podsOutOfSync(facts.source, [rel]) : depsOutOfSync(facts.source, facts.source, [rel])).length) return `the source checkout's ${rel} was not installed from its own lockfile, so worktree warm would restore other versions`;
+	const differs = (pods ? [join(dirname(rel), "Podfile.lock")] : [.../* @__PURE__ */ new Set([".", dirname(rel)])].flatMap((dir) => LOCKFILES.map((name) => join(dir, name)))).find((lock) => {
+		const mine = readOrNull(join(worktree, lock));
+		const theirs = readOrNull(join(facts.source, lock));
+		return mine === null ? theirs !== null : theirs === null || !mine.equals(theirs);
+	});
+	return differs ? `its ${differs} differs from the source checkout's, so worktree warm would restore other versions` : null;
+}
+function writeRecord(key, update) {
+	withWorkspaceStateLock(key, () => {
+		const file = workspaceLightenedFile(key);
+		mkdirSync(dirname(file), { recursive: true });
+		const tmp = `${file}.tmp-${process.pid}`;
+		writeFileSync(tmp, `${JSON.stringify({
+			at: (/* @__PURE__ */ new Date()).toISOString(),
+			...update(readRecord(key))
+		}, null, 2)}\n`, { mode: 384 });
+		renameSync(tmp, file);
+	});
+}
+/**
+* Records in each Stim workspace among `keys` that `dir` is being deleted to lighten its worktree, before the deletion;
+* it stays pending until `finishLightened`, so a deletion that stops part-way is still restored.
+*/
+function recordLightened(keys, dir) {
+	for (const key of workspaceKeys(keys)) writeRecord(key, ({ dirs, pending }) => ({
+		dirs: [.../* @__PURE__ */ new Set([...dirs, dir])],
+		pending: [.../* @__PURE__ */ new Set([...pending, dir])]
+	}));
+}
+function finishLightened(keys, dir) {
+	for (const key of workspaceKeys(keys)) writeRecord(key, ({ dirs, pending }) => ({
+		dirs,
+		pending: pending.filter((entry) => entry !== dir)
+	}));
+}
+function depsFailure(root, message, remedy = `Run \`stim worktree warm\` in ${root}, or install the project's dependencies, then retry.`) {
+	return {
+		code: "STIM_DEPS_FAILED",
+		message: `gc lightened this worktree, and ${message}`,
+		remedy: `${remedy} If you installed them yourself, delete ${workspaceLightenedFile(root)} so Stim stops restoring them.`
+	};
+}
+/**
+* Restores the dependencies gc deleted from this workspace's worktree through `stim worktree warm`, or returns the
+* failure to report. A workspace gc never lightened is left alone.
+*/
+async function restoreLightenedDependencies(root, operation) {
+	const { dirs, pending } = readRecord(root);
+	if (!dirs.length) return null;
+	const missing = () => dirs.filter((dir) => pending.includes(dir) || !existsSync(dir));
+	if (missing().length) {
+		const cache = /* @__PURE__ */ new Map();
+		const worktree = (await warmWorktreePaths(root, operation).catch(() => null))?.target;
+		for (const dir of missing()) {
+			const problem = worktree ? await restoreProblem({
+				worktree,
+				path: dir
+			}, cache, operation) : "its worktree cannot be resolved";
+			if (problem) return depsFailure(root, `${dir} cannot be restored by worktree warm: ${problem}.`, `Install the project's dependencies in ${root} (for example \`pnpm install\` or \`pod install\`), then retry.`);
+		}
+		operation.output("stderr", `${phaseLine("deps", `gc lightened this worktree; restoring ${missing().join(", ")} with worktree warm`)}\n`);
+		for (const dir of pending) {
+			if (!worktree || canonicalPath(dir) !== join(canonicalPath(worktree), relative(worktree, dir))) return depsFailure(root, `${dir} is reached through a link or lies outside its worktree, so it was not removed.`);
+			rmSync(dir, {
+				recursive: true,
+				force: true
+			});
+		}
+		let exitCode;
+		try {
+			({exitCode} = await warmWorktreeTarget({
+				cwd: root,
+				operation
+			}));
+		} catch (error) {
+			operation.signal.throwIfAborted();
+			if (error instanceof WorkspaceProcessCleanupError) throw error;
+			return depsFailure(root, `worktree warm failed: ${error instanceof Error ? error.message : String(error)}`);
+		}
+		const left = dirs.filter((dir) => !existsSync(dir));
+		if (exitCode !== 0 || left.length) return depsFailure(root, `worktree warm did not restore ${left.join(", ") || "its dependencies"}.`);
+	}
+	withWorkspaceStateLock(root, () => rmSync(workspaceLightenedFile(root), { force: true }));
+	return null;
+}
+/** Prints a restore failure the way a native run reports a refusal, with the JSON line on stdout when asked. */
+function printLightenedFailure(operation, failure, json) {
+	operation.output("stderr", `${phaseLine("error", `${failure.code}: ${failure.message}`)}\n`);
+	operation.output("stderr", `${phaseLine("remedy", failure.remedy)}\n`);
+	if (json) operation.output("stdout", `${JSON.stringify(failure)}\n`);
+}
+//#endregion
+export { restoreProblem as a, restoreLightenedDependencies as i, printLightenedFailure as n, workspaceKeys as o, recordLightened as r, finishLightened as t };

package/dist/{logs-dQDki6Tt.mjs → logs-CC_-ZzEE.mjs}

@@ -1,9 +1,9 @@
-import { S as process_identity_exports } from "./exec-VFRpu1iA.mjs";
-import { k as workspaceLogsDir$1 } from "./workspace-state-pUg3_RRA.mjs";
-import { G as projectDeviceSlots, _ as loadConfig$1 } from "./config-BktkY_zC.mjs";
-import { f as readAgentDeviceRecordsAsync, n as agentDeviceLiveness, o as envDir } from "./activity-Lnb_EoRY.mjs";
-import { i as captureWorkspaceCrashes } from "./error-diagnostics-BOOm9Db7.mjs";
-import { n as followHostedLogs, r as syncHostedLogs } from "./hosted-logs-sync-B0pvmOk-.mjs";
+import { S as process_identity_exports } from "./exec-aULwtNly.mjs";
+import { k as workspaceLogsDir$1 } from "./workspace-state-BjqdjnJR.mjs";
+import { G as projectDeviceSlots, _ as loadConfig$1 } from "./config-Cn94Jc0g.mjs";
+import { f as readAgentDeviceRecordsAsync, n as agentDeviceLiveness, o as envDir } from "./activity-Cd-ysFes.mjs";
+import { o as captureWorkspaceCrashes } from "./error-diagnostics-snej9k4j.mjs";
+import { n as followHostedLogs, r as syncHostedLogs } from "./hosted-logs-sync-Dg3qrZmV.mjs";
 import { readdirSync, statSync, watch } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join, relative, resolve, sep } from "node:path";
@@ -264,7 +264,7 @@ async function readWorkspaceLogs(context, options = {}) {
 		await view.close();
 	}
 }
-const WORKSPACE_SOURCES = SOURCES.filter((source) => source !== "gc");
+const WORKSPACE_SOURCES = SOURCES.filter((source) => source !== "gc" && source !== "builds");
 function validateLogOptions(options) {
 	const invalid = (options.tail !== void 0 && (!Number.isSafeInteger(options.tail) || options.tail < 0) ? "tail must be a non-negative integer." : options.sources?.some((source) => !WORKSPACE_SOURCES.includes(source)) ? `sources must contain only ${WORKSPACE_SOURCES.join(", ")}.` : options.minLevel !== void 0 && !LEVELS.includes(options.minLevel) ? `minLevel must be one of ${LEVELS.join(", ")}.` : void 0) ?? (options.since !== void 0 ? parseSince(options.since).error : void 0) ?? (options.grep !== void 0 ? compileGrep(options.grep).error : void 0);
 	if (invalid) throw Object.assign(new Error(invalid), { code: "STIM_BAD_ARG" });

package/dist/{logs-s1dRIG1E.mjs → logs-aJQb-RDg.mjs}

@@ -1,18 +1,19 @@
-import { k as workspaceLogsDir$1, r as readWorkspaceState$1 } from "./workspace-state-pUg3_RRA.mjs";
-import { W as parseDeviceSlotOption, _ as loadConfig$1, g as isPathPrefix } from "./config-BktkY_zC.mjs";
-import { f as refuseNoProject, v as launchErrorPreview } from "./command-output-BF5AR2dL.mjs";
-import { n as findCommandWorkspace } from "./project-BUu6Is4k.mjs";
-import { n as SOURCES$1, t as LEVELS$1 } from "./ndjson-CgE_o3Dl.mjs";
-import { i as followAgentActions, n as openWorkspaceLogs } from "./logs-dQDki6Tt.mjs";
-import { t as errorDiagnostics } from "./error-diagnostics-BOOm9Db7.mjs";
-import { n as followHostedLogs } from "./hosted-logs-sync-B0pvmOk-.mjs";
+import { k as workspaceLogsDir$1, r as readWorkspaceState$1 } from "./workspace-state-BjqdjnJR.mjs";
+import { W as parseDeviceSlotOption, _ as loadConfig$1, g as isPathPrefix$1 } from "./config-Cn94Jc0g.mjs";
+import { f as refuseNoProject, v as launchErrorPreview } from "./command-output-Dj-WT4BP.mjs";
+import { n as findCommandWorkspace } from "./project-DYj-HVx6.mjs";
+import { n as SOURCES$1, t as LEVELS$1 } from "./ndjson-Dy2W4vRa.mjs";
+import { i as followAgentActions, n as openWorkspaceLogs } from "./logs-CC_-ZzEE.mjs";
+import { t as errorDiagnostics } from "./error-diagnostics-snej9k4j.mjs";
+import { n as followHostedLogs } from "./hosted-logs-sync-Dg3qrZmV.mjs";
 import { t as watchStdoutReader } from "./stdout-reader-C8yjre1x.mjs";
 import { realpathSync } from "node:fs";
 import { relative, sep } from "node:path";
 import { configDir } from "@stim-cli/core";
-import { buildCriteria, compileGrep, fileSizes, followLogs, gcLogDir, logFiles, parseSince, queryLogs, readGcLog, recordMatches, runId, sortByTs } from "@stim-cli/core/state";
+import { buildCriteria, buildLedgerDir, compileGrep, fileSizes, followLogs, gcLogDir, logFiles, parseSince, queryLogs, readBuildLedger, readGcLog, recordMatches, runId, sortByTs } from "@stim-cli/core/state";
 import chalk from "chalk";
 //#region src/commands/logs.ts
+const MACHINE_SOURCES = ["gc", "builds"];
 const LEVEL_WIDTH = 5;
 const SRC_WIDTH = 6;
 const INDENT = "    ";
@@ -58,7 +59,8 @@ function validateSources(sources) {
 	if (sources === void 0 || sources === null) return { sources: void 0 };
 	const list = Array.isArray(sources) ? sources : [sources];
 	if (list.includes("gc") && list.length > 1) return { error: "--source gc reads the machine-wide gc log and cannot be combined with other sources." };
-	if (list.includes("all")) return { sources: SOURCES$1.filter((source) => source !== "gc") };
+	if (list.includes("builds") && list.length > 1) return { error: "--source builds reads the machine-wide build ledger and cannot be combined with other sources." };
+	if (list.includes("all")) return { sources: SOURCES$1.filter((source) => !MACHINE_SOURCES.includes(source)) };
 	const unknown = list.filter((s) => !SOURCES$1.includes(s));
 	if (unknown.length > 0) return { error: `Unknown --source value(s): ${unknown.join(", ")}. Use one or more of: ${SOURCES$1.join(", ")}, or all.` };
 	return { sources: list };
@@ -69,7 +71,7 @@ function validateLevel(level) {
 }
 const ERRORS_PRINT_CAP = 20;
 function nearestRegisteredLogsProject(root, candidates) {
-	return candidates.filter((candidate) => candidate !== root && isPathPrefix(root, candidate)).toSorted((a, b) => {
+	return candidates.filter((candidate) => candidate !== root && isPathPrefix$1(root, candidate)).toSorted((a, b) => {
 		const depth = (path) => relative(root, path).split(sep).length;
 		return depth(a) - depth(b) || a.length - b.length || a.localeCompare(b);
 	})[0] ?? null;
@@ -98,11 +100,12 @@ const LEVEL_COLOURS = {
 	fatal: chalk.bgRed
 };
 function logsCommand(program) {
-	program.command("logs").description("Query this workspace's merged NDJSON log timeline (bundler, client, device, build, agent actions, maintenance). Prints and exits; an existing timeline with nothing matching is a successful, empty result. Use --follow to stream.").option("--slot <name>", "Only this device slot's records, plus the shared Metro and app client records once it has launched", parseDeviceSlotOption).option("--source <s...>", "Only these sources: metro, client, device, build, agent, maintenance, placement, or all; gc alone reads the machine-wide gc log of what gc and maintenance cleared").option("--level <l>", `Minimum level: ${LEVELS$1.join(", ")}`).option("--since <d>", "Only records newer than this, e.g. 30s, 5m, 2h").option("--grep <re>", "Only records whose message matches this regular expression").option("--tail <n>", "Only the last n matching records").option("--errors", "Errors and fatals since the last marker, from metro, client and build, plus confirmed native app-crash reports and stim web browser errors. Add --source maintenance for maintenance failures, or --source device or --source all for general device errors.").option("--follow", "Keep streaming new records until interrupted").option("--json", "Emit the raw records, one per line (valid NDJSON; zero matches is zero bytes, exit 0)").action(async (opts) => {
+	program.command("logs").description("Query this workspace's merged NDJSON log timeline (bundler, client, device, build, agent actions, maintenance). Prints and exits; an existing timeline with nothing matching is a successful, empty result. Use --follow to stream.").option("--slot <name>", "Only this device slot's records, plus the shared Metro and app client records once it has launched", parseDeviceSlotOption).option("--source <s...>", "Only these sources: metro, client, device, build, agent, maintenance, placement, or all; gc alone reads the machine-wide gc log of what gc and maintenance cleared, and builds alone reads the machine-wide ledger of native builds").option("--level <l>", `Minimum level: ${LEVELS$1.join(", ")}`).option("--since <d>", "Only records newer than this, e.g. 30s, 5m, 2h").option("--grep <re>", "Only records whose message matches this regular expression").option("--tail <n>", "Only the last n matching records").option("--errors", "Errors and fatals since the last marker, from metro, client and build, plus confirmed native app-crash reports and stim web browser errors. Add --source maintenance for maintenance failures, or --source device or --source all for general device errors.").option("--follow", "Keep streaming new records until interrupted").option("--json", "Emit the raw records, one per line (valid NDJSON; zero matches is zero bytes, exit 0)").action(async (opts) => {
 		const requested = [opts.source ?? []].flat();
-		if (requested.length === 1 && requested[0] === "gc") {
+		const [only] = requested;
+		if (requested.length === 1 && only !== void 0 && MACHINE_SOURCES.includes(only)) {
 			const { minLevel, tail } = validateOptions(opts);
-			printGcLog(opts, opts.errors ? "error" : minLevel, tail);
+			printMachineLog(only === "gc" ? GC_LOG : BUILD_LEDGER, opts, opts.errors ? "error" : minLevel, tail);
 			return;
 		}
 		const root = findCommandWorkspace(process.cwd());
@@ -257,27 +260,49 @@ function validateOptions(opts) {
 		tail
 	};
 }
-function printGcLog(opts, minLevel, tail) {
-	const emit = (record) => console.log(opts.json ? JSON.stringify(record) : formatRecord(record, { paint: record.level ? LEVEL_COLOURS[record.level] : void 0 }));
+const GC_LOG = {
+	source: "gc",
+	dir: gcLogDir,
+	read: readGcLog
+};
+const BUILD_LEDGER = {
+	source: "builds",
+	dir: buildLedgerDir,
+	read: readBuildLedger,
+	key: (record) => `${record.id}:${record.ts}`
+};
+function printMachineLog(log, opts, minLevel, tail) {
+	const printed = /* @__PURE__ */ new Set();
+	const emit = (record) => {
+		if (opts.follow && log.key) {
+			const key = log.key(record);
+			if (printed.has(key)) return;
+			printed.add(key);
+		}
+		console.log(opts.json ? JSON.stringify(record) : formatRecord(record, { paint: record.level ? LEVEL_COLOURS[record.level] : void 0 }));
+	};
 	const query = {
-		sources: ["gc"],
+		sources: [log.source],
 		minLevel,
 		since: opts.since,
 		grep: opts.grep
 	};
-	const offsets = opts.follow ? fileSizes(gcLogDir()) : null;
+	const dir = log.dir();
+	const offsets = opts.follow ? fileSizes(dir) : null;
+	const all = log.read();
 	const records = queryLogs({
 		...query,
-		records: readGcLog(),
+		records: all,
 		tail
 	});
 	for (const record of records) emit(record);
+	if (opts.follow && log.key) for (const record of all) printed.add(log.key(record));
 	if (!opts.follow) {
-		if (records.length === 0 && !opts.json) console.error(chalk.dim(`No matching log records in ${gcLogDir()}`));
+		if (records.length === 0 && !opts.json) console.error(chalk.dim(`No matching log records in ${dir}`));
 		return;
 	}
 	const stop = followLogs({
-		dir: gcLogDir(),
+		dir,
 		offsets,
 		criteria: buildCriteria(query),
 		onRecord: emit

package/dist/{macos-B0VEV3Gf.mjs → macos-BGmTpnv9.mjs}

@@ -1,2 +1,2 @@
-import { n as runMacos, r as waitForLaunchServices, t as macosCommand } from "./macos-DBBPNnIA.mjs";
+import { n as runMacos, r as waitForLaunchServices, t as macosCommand } from "./macos-DlCBhMw5.mjs";
 export { macosCommand as default, runMacos, waitForLaunchServices };