stim 1.25.0 → 1.27.0

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

@@ -1,18 +1,19 @@
-import { m as workspaceLogsDir$1 } from "./paths-DQtTgsBf.mjs";
-import { W as parseDeviceSlotOption, _ as loadConfig$1, g as isPathPrefix } from "./config-BZhXY15H.mjs";
-import { f as refuseNoProject, v as launchErrorPreview } from "./command-output-BBvS1H6v.mjs";
-import { r as readWorkspaceState$1 } from "./workspace-state-CPSp3mav.mjs";
-import { n as findCommandWorkspace } from "./project-BiC68mIp.mjs";
-import { n as SOURCES$1, t as LEVELS$1 } from "./ndjson-CgE_o3Dl.mjs";
-import { a as followAgentActions, i as followHostedLogs, n as openWorkspaceLogs } from "./logs-BsIRre8x.mjs";
-import { t as errorDiagnostics } from "./error-diagnostics-B1Mj_-7h.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, followLogs, logFiles, parseSince, queryLogs, 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 = "    ";
@@ -57,7 +58,9 @@ function parseTail(value) {
 function validateSources(sources) {
 	if (sources === void 0 || sources === null) return { sources: void 0 };
 	const list = Array.isArray(sources) ? sources : [sources];
-	if (list.includes("all")) return { sources: [...SOURCES$1] };
+	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("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 };
@@ -68,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;
@@ -97,39 +100,21 @@ 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").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();
+		const [only] = requested;
+		if (requested.length === 1 && only !== void 0 && MACHINE_SOURCES.includes(only)) {
+			const { minLevel, tail } = validateOptions(opts);
+			printMachineLog(only === "gc" ? GC_LOG : BUILD_LEDGER, opts, opts.errors ? "error" : minLevel, tail);
+			return;
+		}
 		const root = findCommandWorkspace(process.cwd());
 		if (!root) {
 			refuseNoProject({ json: false });
 			return;
 		}
 		const dir = workspaceLogsDir$1(root);
-		let sources;
-		if (opts.source !== void 0) {
-			const checked = validateSources(opts.source);
-			if (checked.error) fail(checked.error);
-			sources = checked.sources;
-		}
-		let minLevel;
-		if (opts.level !== void 0) {
-			const checked = validateLevel(opts.level);
-			if (checked.error) fail(checked.error);
-			minLevel = checked.level;
-		}
-		if (opts.since !== void 0) {
-			const parsed = parseSince(opts.since);
-			if (parsed.error) fail(parsed.error);
-		}
-		let tail;
-		if (opts.tail !== void 0) {
-			const parsed = parseTail(opts.tail);
-			if (parsed.error) fail(parsed.error);
-			tail = parsed.n;
-		}
-		if (opts.grep !== void 0) {
-			const compiled = compileGrep(opts.grep);
-			if (compiled.error) fail(compiled.error);
-		}
+		const { sources, minLevel, tail } = validateOptions(opts);
 		requireLogsWorkspace(root, dir);
 		const query = {
 			slot: opts.slot,
@@ -242,6 +227,95 @@ function logsCommand(program) {
 		process.on("SIGTERM", finish);
 	});
 }
+function validateOptions(opts) {
+	let sources;
+	if (opts.source !== void 0) {
+		const checked = validateSources(opts.source);
+		if (checked.error) fail(checked.error);
+		sources = checked.sources;
+	}
+	let minLevel;
+	if (opts.level !== void 0) {
+		const checked = validateLevel(opts.level);
+		if (checked.error) fail(checked.error);
+		minLevel = checked.level;
+	}
+	if (opts.since !== void 0) {
+		const parsed = parseSince(opts.since);
+		if (parsed.error) fail(parsed.error);
+	}
+	let tail;
+	if (opts.tail !== void 0) {
+		const parsed = parseTail(opts.tail);
+		if (parsed.error) fail(parsed.error);
+		tail = parsed.n;
+	}
+	if (opts.grep !== void 0) {
+		const compiled = compileGrep(opts.grep);
+		if (compiled.error) fail(compiled.error);
+	}
+	return {
+		sources,
+		minLevel,
+		tail
+	};
+}
+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: [log.source],
+		minLevel,
+		since: opts.since,
+		grep: opts.grep
+	};
+	const dir = log.dir();
+	const offsets = opts.follow ? fileSizes(dir) : null;
+	const all = log.read();
+	const records = queryLogs({
+		...query,
+		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 ${dir}`));
+		return;
+	}
+	const stop = followLogs({
+		dir,
+		offsets,
+		criteria: buildCriteria(query),
+		onRecord: emit
+	});
+	const finish = () => {
+		stop();
+		stopReader();
+		process.exit(0);
+	};
+	const stopReader = watchStdoutReader(finish);
+	process.on("SIGINT", finish);
+	process.on("SIGTERM", finish);
+}
 function fail(message) {
 	console.error(chalk.red(message));
 	process.exit(1);

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

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

package/dist/{macos-D477nfzH.mjs → macos-DlCBhMw5.mjs}

@@ -1,37 +1,37 @@
-import { _ as spawnDeclared, c as throwIfCancelled, t as getExecutor, u as withWorkspaceProcessLock, x as withDrainingCancellation } from "./exec-VFRpu1iA.mjs";
-import { d as workspaceDir, l as workspaceAgentDeviceDir, m as workspaceLogsDir$1, r as ensureWorkspaceStorageAsync } from "./paths-DQtTgsBf.mjs";
-import { E as upsertProject, O as withConfigLockAsync$1, u as getConcurrencyLimits } from "./config-BZhXY15H.mjs";
-import { l as phaseLine } from "./command-output-BBvS1H6v.mjs";
-import { a as recordWorkspaceUseAsync, f as writeWorkspaceStateAsync } from "./workspace-state-CPSp3mav.mjs";
-import { Y as resolveProjectSettingsAsync, a as SETTING_SHAPE_REMEDY, tt as settingShapeErrors } from "./settings-B5tCoq9N.mjs";
-import { f as projectRegistry, i as findProjectRoot$1, s as ownedDeviceLabel } from "./project-BiC68mIp.mjs";
-import { i as macosProcess, n as macosDir, o as requiredMacosRecord, r as macosLogFile } from "./state-DPaM3u5K.mjs";
-import { r as createNdjsonWriter } from "./ndjson-CgE_o3Dl.mjs";
-import { B as recordFinishedBuild, H as startBuildProgress, M as NO_BUILD_PROGRESS, Rn as processContext, U as tapBuildLog, z as recordBuildPhase, zn as runProcessOperation } from "./budget-HyShrIpL.mjs";
-import { d as runCancellationSignal, f as withNativeBuildRun } from "./native-run-D5OJsGwA.mjs";
-import { L as acquireBuildSlot, z as releaseBuildSlot } from "./workspaces-C9w4aeXF.mjs";
-import { D as sanitizeDeviceLabel } from "./ios-BQzvJlzw.mjs";
-import { S as setRemoteLogSink, c as offloadPlacement, i as closeOffload, l as placementLoad, n as buildPlacementCandidates, o as offloadBuild, r as chooseBuildMachine, u as remotePhaseText } from "./client-BQsmyp_-.mjs";
-import { a as parseBuildMachineOption, c as resolveBuildPlacement, i as namedBuildMachine, o as requireLocalBuild, t as OffloadRefusal } from "./selection-D5cxEl3t.mjs";
-import { l as connectHost } from "./hosted-client-rsRqysJc.mjs";
-import { t as placeHostedMacos } from "./hosted-macos-d0pv9Tth.mjs";
-import { r as stopMacosAppHeld, t as stopBundleInstances } from "./stop-COP6PQqw.mjs";
+import { _ as spawnDeclared, c as throwIfCancelled, t as getExecutor, u as withWorkspaceProcessLock, x as withDrainingCancellation } from "./exec-aULwtNly.mjs";
+import { E as workspaceDir, a as recordWorkspaceUseAsync, f as writeWorkspaceStateAsync, k as workspaceLogsDir$1, v as ensureWorkspaceStorageAsync, w as workspaceAgentDeviceDir } from "./workspace-state-BjqdjnJR.mjs";
+import { E as upsertProject, O as withConfigLockAsync$1, u as getConcurrencyLimits } from "./config-Cn94Jc0g.mjs";
+import { l as phaseLine } from "./command-output-Dj-WT4BP.mjs";
+import { Z as resolveProjectSettingsAsync, a as SETTING_SHAPE_REMEDY, it as settingValueAt, rt as settingShapeErrors } from "./settings-BDVI8Ivc.mjs";
+import { f as projectRegistry, i as findProjectRoot$1, s as ownedDeviceLabel } from "./project-DYj-HVx6.mjs";
+import { i as macosProcess, n as macosDir, o as requiredMacosRecord, r as macosLogFile } from "./state-CZxLyetD.mjs";
+import { i as createNdjsonWriter } from "./ndjson-Dy2W4vRa.mjs";
+import { En as runProcessOperation, Tn as processContext } from "./ccache-BWTze1Ls.mjs";
+import { K as recordBuildPhase, Q as errorRemedy, X as tapBuildLog, Y as startBuildProgress, q as recordFinishedBuild, xt as releaseBuildSlot, yt as acquireBuildSlot, z as NO_BUILD_PROGRESS } from "./workspaces-DFbj07jp.mjs";
+import { ot as runCancellationSignal, st as withNativeBuildRun } from "./toolchain-CbCG6C5Z.mjs";
+import { O as sanitizeDeviceLabel } from "./ios-E26qSpkb.mjs";
+import { S as setRemoteLogSink, c as offloadPlacement, i as closeOffload, l as placementLoad, n as buildPlacementCandidates, o as offloadBuild, r as chooseBuildMachine, u as remotePhaseText } from "./client-xsdxrhWA.mjs";
+import { d as resolveBuildPlacement, l as requireLocalBuild, n as automaticBuild, o as namedBuildMachine, s as parseBuildMachineOption, t as OffloadRefusal } from "./selection-Bs8phwhN.mjs";
+import { l as connectHost } from "./hosted-client-D7Pk_Oo1.mjs";
+import { t as placeHostedMacos } from "./hosted-macos-B9w4H8hc.mjs";
+import { r as stopMacosAppHeld, t as stopBundleInstances } from "./stop-CH79S3IZ.mjs";
 import { t as spawnEntry } from "./spawn-entry-jw19m8Nl.mjs";
-import { t as buildPlacementRecord } from "./placement-log-DjOXJRIH.mjs";
-import { t as reidentifyBundle } from "./stage-D8xlRU2D.mjs";
-import { t as validateMacosArtifactPlatform } from "./artifact-platform-CMRc0M_r.mjs";
-import { t as waitForMacosRegistration } from "./registration-CN6nlhcD.mjs";
+import { t as buildPlacementRecord } from "./placement-log-BXUbiZM6.mjs";
+import { n as devicePlacementLine, t as automaticDevicePlacement } from "./auto-placement-z-H5pJza.mjs";
+import { t as reidentifyBundle } from "./stage-F4cAfJGi.mjs";
+import { t as validateMacosArtifactPlatform } from "./artifact-platform-BO2Uvk_A.mjs";
+import { t as waitForMacosRegistration } from "./registration-BwCe64PH.mjs";
 import { createHash, randomUUID } from "node:crypto";
 import { closeSync, existsSync, openSync, promises, realpathSync, renameSync } from "node:fs";
 import { join } from "node:path";
 import { LOG_ROTATE_BYTES, ambientEnv } from "@stim-cli/core";
-import { machineCapacity, validHostedAppArguments } from "@stim-cli/core/state";
+import { machineCapacity, placementWord, validHostedAppArguments } from "@stim-cli/core/state";
 //#region src/macos/build.ts
 async function buildMacosBundle({ context, root, recipe, bundle, bundleId, displayName, scratch, writer, note, record, buildMachine, hostServerKey, progress = NO_BUILD_PROGRESS }) {
 	const signal = runCancellationSignal(context) ?? context.signal;
 	return withDrainingCancellation(context, signal, async () => {
 		throwIfCancelled(signal, "macOS build");
-		const { mode, machines, localEnabled } = buildPlacementCandidates(buildMachine);
+		const { machines, localEnabled } = buildPlacementCandidates(buildMachine);
 		const builder = namedBuildMachine(buildMachine) ? machines[0] : void 0;
 		const runsOnWorker = hostServerKey !== void 0 && builder?.serverKey === hostServerKey;
 		if (record) record.buildMachine = buildMachine;
@@ -64,7 +64,7 @@ async function buildMacosBundle({ context, root, recipe, bundle, bundleId, displ
 				}
 			}));
 			if (namedBuildMachine(buildMachine)) throw new OffloadRefusal(buildMachine, reason);
-			requireLocalBuild(buildMachine);
+			requireLocalBuild(buildMachine, reason);
 			offloadFallback = reason;
 			if (record) record.offloadFallback = reason;
 			writer.write({
@@ -162,7 +162,6 @@ async function buildMacosBundle({ context, root, recipe, bundle, bundleId, displ
 				};
 				const here = machineCapacity();
 				const placement = offloadPlacement({
-					mode,
 					localEnabled,
 					machines: machines.length,
 					here,
@@ -174,7 +173,6 @@ async function buildMacosBundle({ context, root, recipe, bundle, bundleId, displ
 					const chosen = await chooseBuildMachine({
 						projectRoot: root,
 						target: await recipe.offload.target(runsOnWorker),
-						mode,
 						here,
 						machines,
 						selected: buildMachine,
@@ -269,7 +267,7 @@ async function buildMacosBundle({ context, root, recipe, bundle, bundleId, displ
 			try {
 				slot = await acquireBuildSlot({
 					signal,
-					automatic: buildMachine === "auto",
+					automatic: automaticBuild(buildMachine),
 					max: getConcurrencyLimits().maxBuilds,
 					root,
 					logFile: writer.file,
@@ -346,7 +344,7 @@ async function planMacos(context, root, buildMachineFlag) {
 	if (selected.failure) throw Object.assign(new Error(selected.failure.message), selected.failure);
 	const macos = settings.macos;
 	if (!macos?.product || !macos.infoPlist) throw Object.assign(/* @__PURE__ */ new Error("Set macos.product and macos.infoPlist explicitly in .stim.json. See stim guide macos."), { code: "STIM_BAD_ARG" });
-	const { swiftpmMacosProject } = await import("./swiftpm-macos-Bp_sn9P4.mjs");
+	const { swiftpmMacosProject } = await import("./swiftpm-macos-Ch4YjY_A.mjs");
 	const recipe = await swiftpmMacosProject(root).prepare(context, settings);
 	let identity = null;
 	let cacheHit = false;
@@ -375,13 +373,11 @@ async function planMacos(context, root, buildMachineFlag) {
 //#endregion
 //#region src/commands/macos.ts
 /**
-* Builds the Debug app and launches it here, or with `remote` on that approved remote Mac. A named host never falls
-* back to a local launch.
+* Builds the Debug app and launches it where `remoteFlag` or `macos.remote` says: here, on one named approved remote
+* Mac with no fallback, or on the Mac an automatic placement word chooses. A recorded hosted app keeps its Mac.
 */
-async function runMacos(context, root, note = console.error, remote, buildMachineFlag) {
-	const backend = remote?.trim().toLowerCase();
-	if (backend === "eas" || backend === "proxy") throw Object.assign(/* @__PURE__ */ new Error("stim macos --remote takes a remote Mac name from remote.machines; macOS has no eas or proxy backend."), { code: "STIM_BAD_ARG" });
-	if (backend === "auto") throw Object.assign(/* @__PURE__ */ new Error("stim macos --remote auto is not available yet: automatic placement has not shipped. Name a hosting Mac from remote.machines."), { code: "STIM_BAD_ARG" });
+async function runMacos(context, root, note = console.error, remoteFlag, buildMachineFlag) {
+	refuseDeviceBackend(remoteFlag);
 	if (process.platform !== "darwin") throw new Error("stim macos requires a Mac with Swift installed.");
 	root = realpathSync(root);
 	const operation = projectRegistry.selectMacos(root);
@@ -398,6 +394,9 @@ async function runMacos(context, root, note = console.error, remote, buildMachin
 	const selected = resolveBuildPlacement(buildMachineFlag);
 	if (selected.failure) throw Object.assign(new Error(selected.failure.message), selected.failure);
 	const buildMachine = selected.selected;
+	const configured = settingValueAt(settings, "macos.remote");
+	const requested = remoteFlag ?? (typeof configured === "string" ? configured : void 0);
+	refuseDeviceBackend(requested);
 	const macos = await (await operation.load()).prepare(context, settings);
 	await ensureWorkspaceStorageAsync(root, context.signal);
 	return withNativeBuildRun(context, root, {
@@ -413,6 +412,14 @@ async function runMacos(context, root, note = console.error, remote, buildMachin
 		});
 		return withWorkspaceProcessLock(workspaceDir(root), "macos-launch", async () => {
 			const previous = requiredMacosRecord(root);
+			const remote = await macosHost({
+				requested,
+				previous,
+				root,
+				buildMachine,
+				note,
+				signal: context.signal
+			});
 			if (previous?.host && previous.host.machine !== remote) throw new Error(`This workspace's macOS app runs on ${previous.host.machine}. Run stim stop first, then stim macos${remote ? ` --remote ${remote}` : ""}.`);
 			if (remote && !validHostedAppArguments(macos.arguments)) throw new Error("macos.arguments is too large for a hosted app: at most 32 arguments of 1024 characters (8192 in total), without NUL or line breaks.");
 			let hostServerKey;
@@ -509,6 +516,29 @@ async function runMacos(context, root, note = console.error, remote, buildMachin
 		}).finally(() => progress.clear());
 	}, { write: note });
 }
+function refuseDeviceBackend(requested) {
+	if (requested !== void 0 && ["eas", "proxy"].includes(requested.trim().toLowerCase())) throw Object.assign(/* @__PURE__ */ new Error("stim macos --remote and macos.remote take local, auto, remote, remote-only or a remote Mac name from remote.machines; macOS has no eas or proxy backend."), { code: "STIM_BAD_ARG" });
+}
+async function macosHost({ requested, previous, root, buildMachine, note, signal }) {
+	if (requested === void 0) return void 0;
+	const word = placementWord(requested);
+	if (word === "local") return void 0;
+	if (word === null) return requested.trim();
+	if (previous?.host) return previous.host.machine;
+	const placed = await automaticDevicePlacement({
+		root,
+		slot: "default",
+		platform: "macos",
+		placement: word,
+		selectors: {},
+		buildMachine,
+		noWait: false,
+		onWait: (line) => note(phaseLine("placement:", line)),
+		signal
+	});
+	note(phaseLine("placement:", devicePlacementLine(placed.placement, placed.skipped)));
+	return placed.placement.decision === "hosted" ? placed.placement.machine : void 0;
+}
 async function buildBundle(context, root, recipe, record, hosted, hostServerKey, note, progress = NO_BUILD_PROGRESS) {
 	const started = Date.parse(record.build.startedAt);
 	const scratch = join(macosDir(root), "build");
@@ -567,13 +597,13 @@ async function buildBundle(context, root, recipe, record, hosted, hostServerKey,
 			supervisor: void 0,
 			build
 		} });
-		recordMacosBuild(root, build, progress.steps());
+		recordMacosBuild(root, build, progress.steps(), errorRemedy(error));
 		throw error;
 	} finally {
 		writer.close();
 	}
 }
-function recordMacosBuild(root, build, compileSteps) {
+function recordMacosBuild(root, build, compileSteps, remedy) {
 	recordFinishedBuild(root, {
 		platform: "macos",
 		status: build.state === "ok" ? "ok" : "failed",
@@ -589,7 +619,11 @@ function recordMacosBuild(root, build, compileSteps) {
 		builtOn: build.builtOn,
 		offloadedTo: build.offloadedTo,
 		offloadFallback: build.offloadFallback,
-		...compileSteps === null ? {} : { compileSteps }
+		...compileSteps === null ? {} : { compileSteps },
+		...build.error ? { ledger: {
+			message: build.error,
+			remedy
+		} } : {}
 	});
 }
 const LAUNCH_SERVICES_CALL_MS = 2e3;
@@ -660,7 +694,7 @@ function launchPayload(root, record) {
 	};
 }
 function macosCommand(program) {
-	program.command("macos").description("Build and launch an owned Swift Package macOS Debug app.").option("--remote-build <value>", "Build on auto, local, or one named machine; a name refuses without fallback", parseBuildMachineOption).option("--json", "print one launch or plan payload; build output goes to stderr").option("--plan", "validate the next SwiftPM Debug build without building or launching").option("--remote <machine>", "run it on this approved remote Mac from remote.machines").action(async (options) => {
+	program.command("macos").description("Build and launch an owned Swift Package macOS Debug app.").option("--remote-build <value>", "Build on local, auto, remote (remote machines first), remote-only (never here), or one named machine; a name refuses without fallback", parseBuildMachineOption).option("--json", "print one launch or plan payload; build output goes to stderr").option("--plan", "validate the next SwiftPM Debug build without building or launching").option("--remote <placement>", "run it here (local), on the Mac a placement word chooses (auto, remote, remote-only), or on one approved remote Mac from remote.machines").action(async (options) => {
 		const root = findProjectRoot$1(process.cwd());
 		if (options.plan) {
 			try {

package/dist/macos-run.mjs

@@ -1,2 +1,2 @@
-import { n as runMacosSupervisor, t as logLines } from "./run-BtzE09Dl.mjs";
+import { n as runMacosSupervisor, t as logLines } from "./run-DaCeNKRm.mjs";
 export { logLines, runMacosSupervisor };

package/dist/maintenance-run.mjs

@@ -1,12 +1,11 @@
-import { P as formatBytes } from "./config-BZhXY15H.mjs";
-import { Dt as deviceSweepIsScoped, u as resolveBudget } from "./budget-HyShrIpL.mjs";
-import { P as memoryCulpritsUnder, z as memoryCulpritAdvice } from "./ios-BQzvJlzw.mjs";
-import { T as maintenanceLogger } from "./client-BQsmyp_-.mjs";
+import { P as formatBytes } from "./config-Cn94Jc0g.mjs";
+import { A as diskPressureLevel, I as maintenanceItem, L as openGcLog, M as levelStillShort, N as lowestFree, R as maintenanceLogger, _ as resolveBudget, j as levelFloors, mt as deviceSweepIsScoped } from "./ccache-BWTze1Ls.mjs";
+import { I as memoryCulpritsUnder, V as memoryCulpritAdvice } from "./ios-E26qSpkb.mjs";
 import { t as resolveMaintenanceSettings } from "./settings-Djl-mpjX.mjs";
-import { t as relaunchWithLogFile } from "./detached-entry-KmieOKgN.mjs";
-import { D as measureDisk, F as levelStillShort, I as lowestFree, M as sizeScanDeferred, N as diskPressureLevel, P as levelFloors, j as measureSizes, k as measurePressure } from "./worktree-CclFIe1Z.mjs";
-import { i as plannedMaintenance, m as measureOwnedDevices, n as diskRecovered, o as triggeringRoot, r as executeAction } from "./act-BbHS3oV8.mjs";
-import { r as due, t as capChildLog } from "./attempt-DW-mQqM7.mjs";
+import { C as measureSizes, w as sizeScanDeferred, x as measurePressure, y as measureDisk } from "./worktree-COAJ3-OD.mjs";
+import { t as relaunchWithLogFile } from "./detached-entry-BPlSaCwC.mjs";
+import { g as measureOwnedDevices, i as plannedMaintenance, n as diskRecovered, o as triggeringRoot, r as executeAction } from "./act-ROviTF_t.mjs";
+import { r as due, t as capChildLog } from "./attempt-ClyJlZPT.mjs";
 import { releaseClaim, tryAcquireClaim } from "@stim-cli/core/ownership-claim";
 import { randomBytes } from "node:crypto";
 import { appendFileSync, mkdirSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync } from "node:fs";
@@ -82,6 +81,7 @@ const EXECUTION_ORDER = {
 	"would-clear-build-dirs": 3,
 	"would-empty-cache": 3,
 	"would-remove-worktree": 4,
+	"would-shutdown-device": 5,
 	"would-stop-workspace": 5,
 	"would-delete-devices": 5,
 	"would-delete-dependencies": 6,
@@ -118,6 +118,7 @@ function describeDone(action) {
 		case "would-stop-gradle-daemons": return "Stopped idle Gradle and Kotlin daemons";
 		case "would-delete-gradle-version": return `Deleted the unpinned Gradle ${action.target} caches and distributions`;
 		case "would-stop-workspace": return `Stopped ${name} and deleted its owned devices`;
+		case "would-shutdown-device": return `Shut down the idle device ${action.target} of ${name}`;
 		default: return `Unregistered the stale cache ${action.target}`;
 	}
 }
@@ -135,6 +136,7 @@ async function runMaintenance(trigger) {
 	}
 	if (!claim) return;
 	let logger;
+	let gcLog;
 	try {
 		const settings = resolveMaintenanceSettings();
 		if (settings.mode === "off") return;
@@ -165,6 +167,11 @@ async function runMaintenance(trigger) {
 		} catch (error) {
 			noteWriteError(error);
 		}
+		gcLog = openGcLog({
+			trigger: "maintenance",
+			runId: `p-${claim.claimId}`,
+			via: trigger
+		});
 		const record = (event, level, msg, fields = {}) => {
 			let entry = null;
 			try {
@@ -196,7 +203,7 @@ async function runMaintenance(trigger) {
 			delete state.deferredAt?.[check];
 			keepState();
 			try {
-				if (check === "worktree" || check === "sweep") continue;
+				if (check === "worktree" || check === "sweep" || check === "idle") continue;
 				if (check === "pressure") {
 					state.pressure = measurePressure(settings, state.pressure, state.lastAt[check]);
 					state.pressure.diskLevel = diskPressureLevel(lowestFree(state.pressure.disk), budget, settings);
@@ -245,11 +252,13 @@ async function runMaintenance(trigger) {
 				});
 			}
 		}
+		const plannedWorktrees = ran.has("worktree") || ran.has("sweep") && settings.removeFinishedWorktrees && settings.removeIdleWorktrees;
 		let result;
 		try {
 			result = await plannedMaintenance(state.pressure, state.sizes, settings, {
 				sweep: ran.has("sweep"),
-				worktrees: ran.has("worktree")
+				worktrees: plannedWorktrees,
+				idle: ran.has("idle")
 			});
 		} catch (error) {
 			const message = error instanceof Error ? error.message : String(error);
@@ -299,6 +308,7 @@ async function runMaintenance(trigger) {
 					action,
 					outcome
 				});
+				if (outcome.status !== "kept") gcLog?.record(maintenanceItem(action, outcome));
 				const fields = {
 					action: {
 						kind: executedKind(action),
@@ -308,7 +318,7 @@ async function runMaintenance(trigger) {
 					},
 					...action.workspace && action.kind !== "would-remove-worktree" ? { workspace: action.workspace } : {}
 				};
-				if (outcome.status === "done") record("maintenance_action", action.kind === "would-remove-worktree" ? "warn" : "info", `${describeDone(action)} (${formatBytes(outcome.bytes)}): ${action.reason}`, fields);
+				if (outcome.status === "done") record("maintenance_action", action.kind === "would-remove-worktree" ? "warn" : "info", `${describeDone(action)} (${formatBytes(outcome.bytes)}): ${action.kind === "would-remove-worktree" ? outcome.detail : action.reason}`, fields);
 				else if (outcome.status === "failed") {
 					failures.push(`${describeDone(action)} failed: ${outcome.detail}`);
 					record("maintenance_failure", "error", `Could not process ${action.target}: ${outcome.detail}`, {
@@ -318,6 +328,7 @@ async function runMaintenance(trigger) {
 					});
 				} else if (!loggedSkips.has(action.target)) {
 					loggedSkips.add(action.target);
+					gcLog?.record(maintenanceItem(action, outcome));
 					record("maintenance_skip", "info", `Kept ${action.target}: ${outcome.detail}`, {
 						target: action.target,
 						reason: outcome.detail,
@@ -327,7 +338,7 @@ async function runMaintenance(trigger) {
 			}
 			return results;
 		}
-		const retained = state.plan.filter((action) => (action.check === "sweep" || action.check === "worktree") && !ran.has(action.check));
+		const retained = state.plan.filter((action) => action.check === "sweep" && !ran.has("sweep") || action.check === "worktree" && !plannedWorktrees || action.kind === "would-shutdown-device" && action.check === void 0 && !ran.has("idle"));
 		const previousActions = new Set(state.plan.map(actionKey));
 		const previousSkips = new Set(state.skipKeys ?? []);
 		const nextSkips = new Set(result.skips.map((skip) => skip.target));
@@ -371,7 +382,13 @@ async function runMaintenance(trigger) {
 			if (done.length || measuredSizes || blockedChanged || (state.pressure?.diskLevel ?? 0) > 0) record("maintenance_pass", state.lastPass.blocked.length ? "warn" : "info", `Pass: ${done.length} actions, ${formatBytes(freedBytes)} freed${state.lastPass.blocked.length ? `; ${state.lastPass.blocked.join("; ")}` : ""}`, { ...state.lastPass });
 		} else {
 			const blocked = [...result.blocked, ...failures];
-			const planned = [...result.actions, ...retained];
+			const keys = /* @__PURE__ */ new Set();
+			const planned = [...result.actions, ...retained].filter((action) => {
+				const key = actionKey(action);
+				if (keys.has(key)) return false;
+				keys.add(key);
+				return true;
+			});
 			const nextActions = new Set(planned.map(actionKey));
 			const changed = !state.lastPass || !sameSet(previousActions, nextActions) || !sameSet(previousSkips, nextSkips) || !sameSet(new Set(state.lastPass.blocked.map(stableText)), new Set(blocked.map(stableText)));
 			for (const action of result.actions) {

package/dist/{metro-1pJgCX4U.mjs → metro-CvyD-xwe.mjs}

@@ -1,7 +1,7 @@
-import { S as process_identity_exports, l as WorkspaceProcessCleanupError, t as getExecutor } from "./exec-VFRpu1iA.mjs";
-import { F as isOnMountedVolume, I as listMountedVolumes, O as withConfigLockAsync, _ as loadConfig, n as allMetroPorts, r as claimMetroPort, x as releaseMetroPort } from "./config-BZhXY15H.mjs";
-import { t as runOperationFile } from "./operation-exec-CUZifp6Z.mjs";
-import { r as readWorkspaceState } from "./workspace-state-CPSp3mav.mjs";
+import { S as process_identity_exports, l as WorkspaceProcessCleanupError, t as getExecutor } from "./exec-aULwtNly.mjs";
+import { r as readWorkspaceState } from "./workspace-state-BjqdjnJR.mjs";
+import { F as isOnMountedVolume, I as listMountedVolumes, O as withConfigLockAsync, _ as loadConfig, n as allMetroPorts, r as claimMetroPort, x as releaseMetroPort } from "./config-Cn94Jc0g.mjs";
+import { t as runOperationFile } from "./operation-exec-Dp4FuIGR.mjs";
 import { sep } from "path";
 import { existsSync, readlinkSync, realpathSync } from "fs";
 import { readFile } from "node:fs/promises";

package/dist/{metro-gateway-Bp9gJQAN.mjs → metro-gateway-BnHdqMO_.mjs}

@@ -1,7 +1,6 @@
-import { S as process_identity_exports, c as throwIfCancelled, s as cancelledError } from "./exec-VFRpu1iA.mjs";
-import { g as workspaceStateFile$1 } from "./paths-DQtTgsBf.mjs";
-import { ot as tailscaleStatusAsync } from "./config-BZhXY15H.mjs";
-import { l as withWorkspaceStateLockAsync, o as updateWorkspaceState, r as readWorkspaceState$1, s as updateWorkspaceStateAsync } from "./workspace-state-CPSp3mav.mjs";
+import { S as process_identity_exports, c as throwIfCancelled, s as cancelledError } from "./exec-aULwtNly.mjs";
+import { j as workspaceStateFile$1, l as withWorkspaceStateLockAsync, o as updateWorkspaceState, r as readWorkspaceState$1, s as updateWorkspaceStateAsync } from "./workspace-state-BjqdjnJR.mjs";
+import { lt as tailscaleStatusAsync } from "./config-Cn94Jc0g.mjs";
 import { randomBytes, randomUUID } from "node:crypto";
 import { statSync, watch } from "node:fs";
 import { HOSTED_METRO_REQUESTS_KEY, findPeer, hostedMetroGateways, hostedMetroRequests, isJsonObject, parseMachine } from "@stim-cli/core/state";

package/dist/{named-ports-BVbn8SvC.mjs → named-ports-BCyMWA6b.mjs}

@@ -1,6 +1,6 @@
-import { S as process_identity_exports, t as getExecutor, u as withWorkspaceProcessLock } from "./exec-VFRpu1iA.mjs";
-import { C as saveConfig, O as withConfigLockAsync, _ as loadConfig, c as ensureConfig, d as getConfigDir, p as getProject } from "./config-BZhXY15H.mjs";
-import { f as signalProcessTree, m as createPortProbe, s as parseNetstatPids } from "./metro-1pJgCX4U.mjs";
+import { S as process_identity_exports, t as getExecutor, u as withWorkspaceProcessLock } from "./exec-aULwtNly.mjs";
+import { C as saveConfig, O as withConfigLockAsync, _ as loadConfig, c as ensureConfig, d as getConfigDir, p as getProject } from "./config-Cn94Jc0g.mjs";
+import { f as signalProcessTree, m as createPortProbe, s as parseNetstatPids } from "./metro-CvyD-xwe.mjs";
 import { realpathSync } from "node:fs";
 //#region src/named-ports.ts
 const FIRST_PORT = 8900;

package/dist/{native-android-BvMizJn1.mjs → native-android-DlpxCyOP.mjs}

@@ -1,21 +1,20 @@
-import { t as getExecutor } from "./exec-VFRpu1iA.mjs";
-import { d as workspaceDir, i as sharedBuildCache } from "./paths-DQtTgsBf.mjs";
-import { H as deviceSlotPlatforms, p as getProject, q as validateDeviceSlot } from "./config-BZhXY15H.mjs";
-import { nt as settingValueAt } from "./settings-B5tCoq9N.mjs";
-import { B as ownedAvdDeviceProfile, E as findBuildTool, I as listInstalledSystemImages, K as ownedAvdSystemImage, V as ownedAvdDirectory, X as pickDefaultSystemImage, l as androidSystemImageAbi, o as androidHome } from "./android-Cjcj8MCw.mjs";
-import { r as register } from "./cache-manifest-BPXRONJz.mjs";
-import { Z as statsProjectKey } from "./budget-HyShrIpL.mjs";
-import { d as runCancellationSignal } from "./native-run-D5OJsGwA.mjs";
-import { s as entryDir, t as artifactIn, y as resolveBuild } from "./build-cache-CKCzxzxA.mjs";
-import { o as resolveCcache } from "./ccache-h1FKhZeg.mjs";
-import { h as gradleOffloadInputs, y as nativeGradleTransfer } from "./client-BQsmyp_-.mjs";
-import { r as androidToolchainAsync } from "./toolchain-VzLJzZ7O.mjs";
-import { d as buildGradle, l as androidSdkRefusal } from "./react-native-build-CwZB-agu.mjs";
-import { s as explainBuildMiss, u as skippedMissReason } from "./prebuild-JUaqOLpc.mjs";
-import { u as resolveAndroidRunPlan } from "./result-CR2vk2cj.mjs";
-import { n as androidProcessRuntime } from "./launch-D0lPvFFu.mjs";
-import { n as planFlagRefusal, r as planPayload } from "./build-plan-zCuHGlA8.mjs";
-import { a as nativeGradleWorkerArtifactIdentity, n as gradleArtifactInputs, r as nativeGradleArtifactSnapshot, t as NATIVE_GRADLE_CACHE_LIMIT } from "./native-gradle-artifact-inputs-BJscK4vN.mjs";
+import { t as getExecutor } from "./exec-aULwtNly.mjs";
+import { E as workspaceDir, y as sharedBuildCache } from "./workspace-state-BjqdjnJR.mjs";
+import { H as deviceSlotPlatforms, p as getProject, q as validateDeviceSlot } from "./config-Cn94Jc0g.mjs";
+import { it as settingValueAt } from "./settings-BDVI8Ivc.mjs";
+import { B as ownedAvdDeviceProfile, E as findBuildTool, I as listInstalledSystemImages, K as ownedAvdSystemImage, V as ownedAvdDirectory, X as pickDefaultSystemImage, l as androidSystemImageAbi, o as androidHome } from "./android-DriNoAVy.mjs";
+import { s as resolveCcache } from "./ccache-BWTze1Ls.mjs";
+import { r as register } from "./cache-manifest-DEjqGGat.mjs";
+import { ot as statsProjectKey } from "./workspaces-DFbj07jp.mjs";
+import { ot as runCancellationSignal, r as androidToolchainAsync } from "./toolchain-CbCG6C5Z.mjs";
+import { C as resolveBuild, s as entryDir, t as artifactIn } from "./build-cache-gBJ-WKzA.mjs";
+import { h as gradleOffloadInputs, y as nativeGradleTransfer } from "./client-xsdxrhWA.mjs";
+import { d as buildGradle, l as androidSdkRefusal } from "./react-native-build-DaK2IFyP.mjs";
+import { s as explainBuildMiss, u as skippedMissReason } from "./prebuild-BDpToDgR.mjs";
+import { u as resolveAndroidRunPlan } from "./result-CTqBw2Te.mjs";
+import { n as androidProcessRuntime } from "./launch-CRyBeNsA.mjs";
+import { n as planFlagRefusal, r as planPayload } from "./build-plan-CBqYbzYM.mjs";
+import { a as nativeGradleWorkerArtifactIdentity, n as gradleArtifactInputs, r as nativeGradleArtifactSnapshot, t as NATIVE_GRADLE_CACHE_LIMIT } from "./native-gradle-artifact-inputs-C13qT7R_.mjs";
 import { createHash } from "node:crypto";
 import { createReadStream, createWriteStream, existsSync, readFileSync, statSync } from "node:fs";
 import { tmpdir } from "node:os";