stim 1.25.0 → 1.27.0

package/dist/{cdp-BG3FJCCx.mjs → cdp-C3svvXiE.mjs}

@@ -1,4 +1,4 @@
-import { c as throwIfCancelled, s as cancelledError } from "./exec-VFRpu1iA.mjs";
+import { c as throwIfCancelled, s as cancelledError } from "./exec-aULwtNly.mjs";
 import { WebSocket } from "ws";
 //#region src/web/cdp.ts
 const COMMAND_TIMEOUT_MS = 15e3;

package/dist/{chrome-BvV8ssI3.mjs → chrome-DyDWurWG.mjs}

@@ -1,4 +1,4 @@
-import { t as getExecutor } from "./exec-VFRpu1iA.mjs";
+import { t as getExecutor } from "./exec-aULwtNly.mjs";
 import { existsSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";

package/dist/{cli-C4w607Pz.mjs → cli-ftXDLto1.mjs}

@@ -1,27 +1,27 @@
-import { E as debugLog } from "./exec-VFRpu1iA.mjs";
-import { y as refuseRelativeStimPaths } from "./config-BZhXY15H.mjs";
+import { E as debugLog } from "./exec-aULwtNly.mjs";
+import { y as refuseRelativeStimPaths } from "./config-Cn94Jc0g.mjs";
 import { readFileSync } from "node:fs";
-import { runId } from "@stim-cli/core/state";
+import { runId, trace } from "@stim-cli/core/state";
 import { Command } from "commander";
 //#region bin/cli.ts
 const commands = /* @__PURE__ */ new Map([
-	["doctor", () => import("./doctor-A_Nr_fDe.mjs")],
-	["worktree", () => import("./worktree-Ct9Gk3KL.mjs")],
-	["start", () => import("./start-C1JLjkNw.mjs")],
-	["ports", () => import("./ports-DtS1Amb0.mjs")],
-	["stop", () => import("./stop-Br7LKxBE.mjs")],
-	["ios", () => import("./ios-Dvt97HgQ.mjs")],
-	["android", () => import("./android-CNZgRC-4.mjs")],
-	["web", () => import("./web-DS4UDWvf.mjs")],
-	["macos", () => import("./macos-CcUlJPMu.mjs")],
-	["reload", () => import("./reload-Beftw2X3.mjs")],
-	["device", () => import("./device-F5-4z9ef.mjs")],
-	["logs", () => import("./logs-Crs9y34Z.mjs")],
-	["settings", () => import("./settings-DzH9mGQZ.mjs")],
-	["status", () => import("./status-cNw6i0_t.mjs")],
-	["stats", () => import("./stats-CP7STzZw.mjs")],
-	["gc", () => import("./gc-eaz403W6.mjs")],
-	["guide", () => import("./guide-DR0K0xW9.mjs")]
+	["doctor", () => import("./doctor-Dbx1ZpD2.mjs")],
+	["worktree", () => import("./worktree-JGUd_53L.mjs")],
+	["start", () => import("./start-DcqnF9p8.mjs")],
+	["ports", () => import("./ports-uUrghqWN.mjs")],
+	["stop", () => import("./stop-x1Yu3He4.mjs")],
+	["ios", () => import("./ios-Bk4mWbtS.mjs")],
+	["android", () => import("./android--HBgpvpW.mjs")],
+	["web", () => import("./web-Je6abcpz.mjs")],
+	["macos", () => import("./macos-BGmTpnv9.mjs")],
+	["reload", () => import("./reload-DJBeF_rC.mjs")],
+	["device", () => import("./device-BJm0irrq.mjs")],
+	["logs", () => import("./logs-aJQb-RDg.mjs")],
+	["settings", () => import("./settings-CMHhQNwI.mjs")],
+	["status", () => import("./status-Bj7ZYvvc.mjs")],
+	["stats", () => import("./stats-GxuCbles.mjs")],
+	["gc", () => import("./gc-BRwAY3qT.mjs")],
+	["guide", () => import("./guide-_rfEh_zM.mjs")]
 ]);
 const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
 const program = new Command();
@@ -37,9 +37,10 @@ try {
 		for (const module of modules) module.default(program, pkg.version);
 	}
 	program.hook("preAction", async (_command, action) => {
+		const path = [];
+		for (let each = action; each?.parent; each = each.parent) path.unshift(each.name());
+		trace.command(`stim ${path.join(" ")}`, { version: pkg.version });
 		if (debugLog.enabled()) {
-			const path = [];
-			for (let each = action; each?.parent; each = each.parent) path.unshift(each.name());
 			const started = Date.now();
 			debugLog.log("run_start", {
 				version: pkg.version,
@@ -52,7 +53,7 @@ try {
 			}));
 		}
 		try {
-			const { triggerMaintenance } = await import("./trigger-BLsHgAGR.mjs");
+			const { triggerMaintenance } = await import("./trigger-qp2ji5wE.mjs");
 			triggerMaintenance(action.name());
 		} catch {}
 	});

package/dist/cli.mjs

@@ -4,6 +4,6 @@ const encode = (version) => version.split(".", 3).reduce((sum, part) => sum * 1e
 if (encode(process.versions.node) < encode("22.12.0")) {
 	process.stderr.write(`STIM_NODE_UNSUPPORTED: Stim needs Node 22.12.0 or later; this is Node ${process.versions.node} at ${process.execPath}. To run Stim where a project pins an older Node, see https://stim.appandflow.com/docs/requirements#older-node-pins\n`);
 	process.exitCode = 1;
-} else import("./cli-C4w607Pz.mjs");
+} else import("./cli-ftXDLto1.mjs");
 //#endregion
 export {};

package/dist/{client-BQsmyp_-.mjs → client-xsdxrhWA.mjs}

@@ -1,69 +1,22 @@
-import { C as reportSignal, E as debugLog, b as operationState, c as throwIfCancelled, t as getExecutor } from "./exec-VFRpu1iA.mjs";
-import { Q as openAuthenticated, _ as loadConfig$1, it as sayHello, rt as resolveEndpoint } from "./config-BZhXY15H.mjs";
-import { o as git, s as gitAsync } from "./operation-exec-CUZifp6Z.mjs";
-import { r as createNdjsonWriter } from "./ndjson-CgE_o3Dl.mjs";
-import { Cr as discoverCaches, Q as emptyCaches, it as planCacheEmptying } from "./budget-HyShrIpL.mjs";
+import { C as reportSignal, E as debugLog, b as operationState, c as throwIfCancelled, t as getExecutor } from "./exec-aULwtNly.mjs";
+import { _ as loadConfig$1, ot as resolveEndpoint, st as sayHello, tt as openAuthenticated } from "./config-Cn94Jc0g.mjs";
+import { o as git, s as gitAsync } from "./operation-exec-Dp4FuIGR.mjs";
+import { G as planCacheEmptying, R as maintenanceLogger, n as CCACHE_UNAVAILABLE, t as CCACHE_NOT_RUN, ur as discoverCaches, z as emptyCaches } from "./ccache-BWTze1Ls.mjs";
 import { t as canonicalPath } from "./paths-BsJMoPP2.mjs";
-import { d as runCancellationSignal } from "./native-run-D5OJsGwA.mjs";
-import { n as CCACHE_UNAVAILABLE, t as CCACHE_NOT_RUN } from "./ccache-h1FKhZeg.mjs";
-import { n as COMPILATION_CACHE_UNAVAILABLE, t as COMPILATION_CACHE_NOT_RUN } from "./xcode-CiIIDnuD.mjs";
+import { A as COMPILATION_CACHE_UNAVAILABLE, E as readRubyVersion, a as cocoapodsDifference, k as COMPILATION_CACHE_NOT_RUN, ot as runCancellationSignal, s as iosToolchainAsync, v as toolchainMismatches, x as workerToolchain, y as toolchainNotes } from "./toolchain-CbCG6C5Z.mjs";
 import { t as resolveMaintenanceSettings } from "./settings-Djl-mpjX.mjs";
-import { a as iosToolchainAsync, d as toolchainMismatches, f as workerToolchain, g as readRubyVersion } from "./toolchain-VzLJzZ7O.mjs";
-import { i as namedBuildMachine, t as OffloadRefusal, u as pairedMachines } from "./selection-D5cxEl3t.mjs";
+import { f as workerFailureReason, m as pairedMachines, o as namedBuildMachine, t as OffloadRefusal } from "./selection-Bs8phwhN.mjs";
 import { n as fingerprintNativeInputs, r as manifestDigest } from "./native-inputs-TRTTTRxt.mjs";
-import { a as sourceManifest, i as nativeTransferManifest, n as gitVisiblePaths, r as nativeFileDigest, t as checkNativeTransferMembership } from "./native-source-D-4Dh4JU.mjs";
+import { a as sourceManifest, i as nativeTransferManifest, n as gitVisiblePaths, r as nativeFileDigest, t as checkNativeTransferMembership } from "./native-source-D1AzWiuP.mjs";
 import { createHash, webcrypto } from "node:crypto";
-import { closeSync, existsSync, lstatSync, mkdirSync, openSync, readFileSync, readdirSync, realpathSync, rmSync, statSync, unlinkSync, writeSync } from "node:fs";
+import { closeSync, existsSync, lstatSync, mkdirSync, openSync, readFileSync, readdirSync, realpathSync, rmSync, writeSync } from "node:fs";
 import { isDeepStrictEqual } from "node:util";
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
-import { LOG_ROTATE_BYTES, ambientContext, dependencyLockfile, reactNativeArtifactIdentity, reactNativeArtifactQuery, rotatedLogPath, swiftpmArtifactQuery, withDirLock } from "@stim-cli/core";
-import { MAINTENANCE_LOG_NAME, OFFLOAD_MODES, automaticMachineEnabled, isJsonObject, maintenanceDir, maintenanceNdjsonFile, requireAutomaticMachine, runId, saturation, workspaceLogsDir } from "@stim-cli/core/state";
+import { ambientContext, dependencyLockfile, reactNativeArtifactIdentity, reactNativeArtifactQuery, swiftpmArtifactQuery } from "@stim-cli/core";
+import { automaticMachineEnabled, isJsonObject, maintenanceDir, mayRunHere, placementWord, requireAutomaticMachine, runId, saturation } from "@stim-cli/core/state";
 import { WebSocket } from "ws";
 import { setTimeout as setTimeout$1 } from "node:timers/promises";
 import { access, lstat, readFile, readlink, realpath } from "node:fs/promises";
-//#region src/maintenance/log.ts
-function maintenanceLogger(settings, pass, trigger) {
-	const file = maintenanceNdjsonFile();
-	const rotated = rotatedLogPath(file);
-	withDirLock(`${file}.lock`, () => {
-		try {
-			if (Date.now() - statSync(rotated).mtimeMs > settings.logRetentionDays * 864e5) unlinkSync(rotated);
-		} catch {}
-	});
-	const writer = createNdjsonWriter(file, { maxBytes: settings.logMaxMb * 1024 ** 2 });
-	return {
-		write(event, level, msg, fields = {}) {
-			if (level === "debug" && !settings.logChecks) return null;
-			const record = {
-				...fields,
-				ts: Date.now(),
-				src: "maintenance",
-				level,
-				msg,
-				event,
-				pass,
-				trigger,
-				mode: settings.mode === "on" ? "on" : "report"
-			};
-			if (!writer.write(record)) throw writer.lastError ?? /* @__PURE__ */ new Error(`Could not append ${file}`);
-			if (typeof fields.workspace === "string" && [
-				"maintenance_action",
-				"maintenance_failure",
-				"maintenance_skip"
-			].includes(event)) {
-				const workspace = createNdjsonWriter(join(workspaceLogsDir(fields.workspace), MAINTENANCE_LOG_NAME), { maxBytes: LOG_ROTATE_BYTES });
-				try {
-					if (!workspace.write(record)) throw workspace.lastError ?? /* @__PURE__ */ new Error("Could not append workspace maintenance log");
-				} finally {
-					workspace.close();
-				}
-			}
-			return record;
-		},
-		close: () => writer.close()
-	};
-}
-//#endregion
 //#region src/cache/compilation-cache-corruption.ts
 const COMPILATION_CACHE_CORRUPT = "STIM_COMPILATION_CACHE_CORRUPT";
 async function emptyCompilationCache(dir) {
@@ -438,16 +391,12 @@ const PAGE_BYTES = 49152;
 const CHUNK_BYTES = 61440;
 const MAX_BUFFERED = 8388608;
 const DIGEST_BYTES = 32;
-function offloadMode(env = ambientContext()?.env ?? process.env) {
-	const raw = env.STIM_REMOTE_BUILD_MODE || loadConfig$1()?.remote?.buildMode;
-	return OFFLOAD_MODES.includes(raw) ? raw : "auto";
-}
 function buildPlacementCandidates(selected) {
 	const config = loadConfig$1();
+	const word = placementWord(selected);
 	return {
-		localEnabled: selected !== "auto" || automaticMachineEnabled("build", "local", config),
-		mode: selected === "local" ? "off" : offloadMode(),
-		machines: selected === "local" ? [] : namedBuildMachine(selected) ? pairedMachines([selected]).slice(0, 1) : pairedMachines().filter((entry) => automaticMachineEnabled("build", entry.machine, config))
+		localEnabled: word === null || word === "local" || mayRunHere(word) && automaticMachineEnabled("build", "local", config),
+		machines: word === "local" ? [] : word === null ? pairedMachines([selected]).slice(0, 1) : pairedMachines().filter((entry) => automaticMachineEnabled("build", entry.machine, config))
 	};
 }
 function remotePhaseText(name, msg, machine) {
@@ -471,10 +420,12 @@ function placementLoad(choice) {
 /**
 * Whether a build may go to a remote machine at all, before any machine is asked. `auto` keeps the build here while
 * this machine has a free `concurrency.maxBuilds` slot and its load per core is under `server.maxLoadPerCore`.
-* A named selection ignores local capacity and mode, and refuses an unsupported build or missing pairing.
+* `remote` always tries the remote machines first and `remote-only` never builds here. A named selection ignores
+* local capacity, and refuses an unsupported build or missing pairing.
 */
-function offloadPlacement({ mode, machines, here, unsupported, localEnabled = true, selected = "auto" }) {
-	if (namedBuildMachine(selected)) {
+function offloadPlacement({ machines, here, unsupported, localEnabled = true, selected = "auto" }) {
+	const word = placementWord(selected);
+	if (word === null) {
 		if (unsupported) throw new OffloadRefusal(selected, `${unsupported}, so a named remote machine cannot take it`);
 		if (machines === 0) throw new OffloadRefusal(selected, "no remote machine is paired");
 		return {
@@ -483,25 +434,21 @@ function offloadPlacement({ mode, machines, here, unsupported, localEnabled = tr
 			reason: `selected with --remote-build ${selected}`
 		};
 	}
-	if (selected === "local") return {
+	if (word === "local") return {
 		offload: false,
 		code: "local-selected",
 		reason: "--remote-build local"
 	};
-	if (!localEnabled) {
-		const reason = mode === "off" ? "remote.buildMode is off" : unsupported ?? (machines === 0 ? "no enabled remote machine is paired" : null);
-		if (reason) throw new OffloadRefusal("auto", `${reason}; local is disabled in remote.buildPoolDisabled`);
+	if (!localEnabled || !mayRunHere(word)) {
+		const why = word === "remote-only" ? "remote-only never builds here" : "local is disabled in remote.buildPoolDisabled";
+		const reason = unsupported ?? (machines === 0 ? "no enabled remote machine is paired" : null);
+		if (reason) throw new OffloadRefusal(selected, `${reason}; ${why}`);
 		return {
 			offload: true,
-			code: "local-disabled",
-			reason: "local is disabled in remote.buildPoolDisabled"
+			code: word === "remote-only" ? "remote-only" : "local-disabled",
+			reason: why
 		};
 	}
-	if (mode === "off") return {
-		offload: false,
-		code: "mode-off",
-		reason: "remote.buildMode is off"
-	};
 	if (machines === 0) return {
 		offload: false,
 		code: "no-remote-mac",
@@ -512,10 +459,10 @@ function offloadPlacement({ mode, machines, here, unsupported, localEnabled = tr
 		code: "unsupported",
 		reason: unsupported
 	};
-	if (mode === "force") return {
+	if (word === "remote") return {
 		offload: true,
-		code: "forced",
-		reason: "remote.buildMode is force"
+		code: "remote",
+		reason: "remote machines come first"
 	};
 	const busy = saturation(here);
 	return busy ? {
@@ -541,8 +488,10 @@ function matchingArtifact(offer, identity) {
 }
 const gb = (bytes) => (bytes / 1024 ** 3).toFixed(1);
 /** Every reason a machine's offer cannot take this build, in either mode; empty when it can. */
-function offerProblems(offer, target) {
+function offerProblems(offer, target, named = false) {
 	const problems = toolchainMismatches(target, offer.toolchain);
+	const pods = !named && target.platform === "ios" && !problems.some(({ code }) => code === "platform") ? cocoapodsDifference(target, offer.toolchain) : null;
+	if (pods) problems.push(pods);
 	const capacity = offer.capacity;
 	const { running, max, diskFreeBytes, minDiskFreeBytes, declined } = capacity;
 	if (diskFreeBytes !== null && diskFreeBytes < minDiskFreeBytes) problems.push({
@@ -564,14 +513,15 @@ function offerProblems(offer, target) {
 	return problems;
 }
 /**
-* The asked machines that can take the build, best first, and one reason per machine that cannot. A machine with any
-* `offerProblems` never takes it. In `auto`, a machine must also be expected to build faster than this machine: while
-* every local build slot is busy any machine that accepts will do, otherwise its load per core must be lower than
-* this machine's. A named selection considers only that machine and skips this local-capacity gating.
-* A machine that reports no load (a stim-server older than capacity) takes an `auto` build only while
-* every local slot is busy. Matching dependency installations rank first, then load.
+* The asked machines that can take the build, in the order they should be tried, and one reason per machine that
+* cannot. A machine with any `offerProblems` never takes it, nor does one whose load per core is at or above its own
+* `server.maxLoadPerCore` (this machine's setting stands in for a stim-server that does not report it). Machines that
+* can take it keep the order of `remote.machines`, so the first one with a free slot under its load threshold gets
+* the build; only a machine that already holds the exact completed artifact goes ahead of that order. A named
+* selection considers only that machine. In `auto` a machine that reports no load (a stim-server older than capacity)
+* takes the build only while every local slot is busy.
 */
-function pickOffer({ mode, here, offers, target, localEnabled = true, selected = "auto", artifact, cacheOnly = false }) {
+function pickOffer({ here, offers, target, localEnabled = true, selected = "auto", artifact, cacheOnly = false }) {
 	const slotsFull = here.maxBuilds > 0 && here.builds >= here.maxBuilds;
 	const reasons = [];
 	const candidates = [];
@@ -591,8 +541,7 @@ function pickOffer({ mode, here, offers, target, localEnabled = true, selected =
 		if (matchingArtifact(offer, artifact) && (artifact !== "swiftpm" || toolchainMismatches(target, offer.toolchain).length === 0)) {
 			ranked.push({
 				index,
-				score: Number.POSITIVE_INFINITY,
-				load: 0
+				cached: true
 			});
 			candidates.push({
 				machine,
@@ -602,26 +551,24 @@ function pickOffer({ mode, here, offers, target, localEnabled = true, selected =
 			return;
 		}
 		if (cacheOnly) return skip(machine, "artifact-miss", "no matching completed artifact");
-		const problems = offerProblems(offer, target);
+		const problems = offerProblems(offer, target, namedBuildMachine(selected));
 		if (problems.length) return skip(machine, problemCode(problems[0]), problems.map((problem) => problem.reason).join("; "), problems.map((problem) => problem.code));
-		const load = offer.capacity.loadPerCore;
-		if (selected === "auto" && localEnabled && mode === "auto" && !slotsFull) {
-			if (typeof load !== "number") return skip(machine, "load", "capacity unknown (older stim-server) while this machine has a free slot");
-			if (load >= here.loadPerCore) return skip(machine, "load", `no less loaded (load ${load}/core there, ${here.loadPerCore}/core here)`);
-		}
-		const score = Number(offer.warm.dependencies);
+		const { loadPerCore: load, maxLoadPerCore } = offer.capacity;
+		const ceiling = maxLoadPerCore ?? here.maxLoadPerCore;
+		if (typeof load === "number" && !namedBuildMachine(selected) && load >= ceiling) return skip(machine, "load", `saturated: load ${load}/core there, at or above ${ceiling}/core`);
+		if (selected === "auto" && localEnabled && !slotsFull && typeof load !== "number") return skip(machine, "load", "capacity unknown (older stim-server) while this machine has a free slot");
 		ranked.push({
 			index,
-			score,
-			load: typeof load === "number" ? load : Number.POSITIVE_INFINITY
+			cached: false
 		});
+		const notes = toolchainNotes(target, offer.toolchain).map((each) => each.reason);
 		candidates.push({
 			machine,
 			code: "accepted",
-			msg: typeof load === "number" ? `can take the build (load ${load}/core there)` : "can take the build"
+			msg: [typeof load === "number" ? `can take the build (load ${load}/core there)` : "can take the build", ...notes].join("; ")
 		});
 	});
-	ranked.sort((a, b) => b.score - a.score || a.load - b.load);
+	ranked.sort((a, b) => Number(b.cached) - Number(a.cached));
 	return {
 		order: ranked.map((each) => each.index),
 		reasons,
@@ -1004,7 +951,7 @@ async function probeMachine(credential, identity, { connectMs = CONNECT_TIMEOUT_
 * Asks every paired machine for an offer in parallel and keeps the connection to the one `pickOffer` chooses, or
 * returns why none takes the build. A named selection probes only its credential and skips auto load gating.
 */
-async function chooseBuildMachine({ projectRoot, target, mode, here, note, machines = pairedMachines(), selected = "auto", onCandidates, artifact, gradleArtifact, reactNativeArtifact, swiftpmArtifact, cacheOnly = false }) {
+async function chooseBuildMachine({ projectRoot, target, here, note, machines = pairedMachines(), selected = "auto", onCandidates, artifact, gradleArtifact, reactNativeArtifact, swiftpmArtifact, cacheOnly = false }) {
 	const started = Date.now();
 	let identity;
 	try {
@@ -1043,9 +990,8 @@ async function chooseBuildMachine({ projectRoot, target, mode, here, note, machi
 		...swiftpmQuery ? { swiftpmArtifact: swiftpmQuery } : {}
 	})));
 	const { order, reasons, candidates } = pickOffer({
-		localEnabled: selected !== "auto" || automaticMachineEnabled("build", "local"),
+		localEnabled: buildPlacementCandidates(selected).localEnabled,
 		selected,
-		mode,
 		here,
 		target,
 		artifact: swiftpmQuery ? "swiftpm" : reactNativeQuery ? `react-native-${reactNativeQuery.platform}` : gradleQuery ? "native-gradle" : artifact,
@@ -1073,19 +1019,22 @@ async function chooseBuildMachine({ projectRoot, target, mode, here, note, machi
 	});
 	return {
 		...first,
-		mode,
+		selected,
 		here,
 		target,
 		offerMs: Date.now() - started,
 		identity,
 		runnersUp: rest,
-		automatic: selected === "auto",
 		cacheOnly,
 		...gradleQuery ? { gradleArtifact: gradleQuery } : {},
 		...reactNativeQuery ? { reactNativeArtifact: reactNativeQuery } : {},
 		...swiftpmQuery ? { swiftpmArtifact: swiftpmQuery } : {}
 	};
 }
+function startJdk(choice) {
+	const { target, connection } = choice;
+	return target.platform === "android" && target.local.jdk && connection.supports("build-jdk") ? { jdk: target.local.jdk } : {};
+}
 function startCompat(choice) {
 	return choice.connection.supports("build-compat") ? { compat: choice.target.local.compat } : {};
 }
@@ -1421,11 +1370,10 @@ async function offloadBuild(input) {
 			});
 			if ("failure" in probe) return fail(probe.failure);
 			const placement = pickOffer({
-				mode: choice.mode,
 				here: choice.here,
 				target: choice.target,
-				selected: choice.automatic ? "auto" : choice.machine,
-				localEnabled: !choice.automatic || automaticMachineEnabled("build", "local"),
+				selected: choice.selected,
+				localEnabled: buildPlacementCandidates(choice.selected).localEnabled,
 				offers: [{
 					machine: choice.machine,
 					offer: probe.offer
@@ -1501,7 +1449,7 @@ async function offloadBuild(input) {
 			return true;
 		};
 		for (;;) {
-			if (choice.automatic && !automaticMachineEnabled("build", choice.machine)) {
+			if (!namedBuildMachine(choice.selected) && !automaticMachineEnabled("build", choice.machine)) {
 				const reason = `${choice.machine} is disabled in remote.buildPoolDisabled`;
 				if (moveOn(reason)) continue;
 				return fail(reason);
@@ -1536,7 +1484,7 @@ async function offloadBuild(input) {
 			workerStarted = Date.now();
 			early = [];
 			choice.connection.onProgress((event) => job === null ? early.push(event) : handle(event));
-			if (choice.automatic) requireAutomaticMachine("build", choice.machine);
+			if (!namedBuildMachine(choice.selected)) requireAutomaticMachine("build", choice.machine);
 			checkCancelled();
 			const reply = await choice.connection.request("build.start", {
 				repo: identity.repo,
@@ -1570,7 +1518,8 @@ async function offloadBuild(input) {
 					...request.platform === "android" ? { android: request.android } : {}
 				},
 				stimBuild: choice.target.local.stimBuild,
-				...startCompat(choice)
+				...startCompat(choice),
+				...startJdk(choice)
 			});
 			checkCancelled();
 			if ("result" in reply) {
@@ -1594,7 +1543,7 @@ async function offloadBuild(input) {
 		const { connection, machine } = choice;
 		connection.onProgress(null);
 		const workerMs = cacheHit ? 0 : Date.now() - workerStarted;
-		if (result.ok !== true) return keepCorruptCacheMessage(fail(`${String(result.code ?? "failed")}: ${String(result.message ?? "")}`), result);
+		if (result.ok !== true) return keepCorruptCacheMessage(fail(workerFailureReason(result.code, result.message)), result);
 		if (!cacheHit && native && (result.sourceDigest !== sourceDigest || result.fingerprint !== expectedFingerprint)) return fail("The worker returned a different native source or artifact identity.");
 		if (native?.provider === "gradle" && !ANDROID_PACKAGE.test(String(result.androidPackage ?? ""))) return fail("The worker returned no verified native APK package.");
 		const artifact = result.artifact;
@@ -1745,6 +1694,16 @@ function machineProblems(offer, targets) {
 	}
 	return problems;
 }
+/** What a build on a machine that would take it does beyond the match, for each of `targets`, labeled like `machineProblems`. */
+function machineNotes(offer, targets) {
+	const notes = [];
+	if (machineProblems(offer, targets).length) return notes;
+	for (const target of targets) for (const note of toolchainNotes(target, offer.toolchain)) notes.push(targets.length > 1 ? {
+		...note,
+		reason: `${PLATFORM_LABEL[target.platform]}: ${note.reason}`
+	} : note);
+	return notes;
+}
 const DOCTOR_CONNECT_MS = 5e3;
 const DOCTOR_OFFER_MS = 8e3;
 const PLATFORM_LABEL = {
@@ -1802,11 +1761,13 @@ function offloadCheck(projectRoot, targets) {
 		};
 		probe.connection.close();
 		resolved ??= targets();
+		const judged = await resolved;
 		return {
 			capacity: probe.offer.capacity,
-			problems: machineProblems(probe.offer, await resolved)
+			problems: machineProblems(probe.offer, judged),
+			notes: machineNotes(probe.offer, judged)
 		};
 	};
 }
 //#endregion
-export { COMPILATION_CACHE_CORRUPT as C, setRemoteLogSink as S, maintenanceLogger as T, nativeGradleLocalSourceDigest as _, nativeTransferRefusal as a, validateGradleManifest as b, offloadPlacement as c, simulatorRuntime as d, reactNativeArtifactReceipt as f, gradleStateDirectories as g, gradleOffloadInputs as h, closeOffload as i, placementLoad as l, reactNativeBuildQuery as m, buildPlacementCandidates as n, offloadBuild as o, reactNativeArtifactToolchain as p, chooseBuildMachine as r, offloadCheck as s, BuildConnection as t, remotePhaseText as u, nativeGradleOutputs as v, clearCorruptCompilationCache as w, verifyGradleTransfer as x, nativeGradleTransfer as y };
+export { COMPILATION_CACHE_CORRUPT as C, setRemoteLogSink as S, nativeGradleLocalSourceDigest as _, nativeTransferRefusal as a, validateGradleManifest as b, offloadPlacement as c, simulatorRuntime as d, reactNativeArtifactReceipt as f, gradleStateDirectories as g, gradleOffloadInputs as h, closeOffload as i, placementLoad as l, reactNativeBuildQuery as m, buildPlacementCandidates as n, offloadBuild as o, reactNativeArtifactToolchain as p, chooseBuildMachine as r, offloadCheck as s, BuildConnection as t, remotePhaseText as u, nativeGradleOutputs as v, clearCorruptCompilationCache as w, verifyGradleTransfer as x, nativeGradleTransfer as y };

package/dist/collector-run.d.mts

@@ -1,10 +1,6 @@
 import { n as NdjsonWriter, t as Executor } from "./exec-DnYc4HGH.mjs";
 import { ChildProcess } from "node:child_process";
 //#region src/collector/android.d.ts
-declare function androidClockOffset(serial: string, { exec, now }?: {
-  exec?: Executor;
-  now?: () => number;
-}): number | null;
 interface PidResolution {
   ok?: boolean;
   pid?: number;
@@ -13,19 +9,21 @@ interface PidResolution {
 }
 interface PidWatcher {
   stop(): void;
-  probe(): number | null;
+  probe(): Promise<number | null>;
   readonly pid: number | null;
 }
-declare function watchAppPid({ serial, packageName, pid, intervalMs, exec, onChange, resolve, setTimer, clearTimer }: {
+declare function watchAppPid({ serial, packageName, pid, intervalMs, exec, signal, onChange, resolve, setTimer, clearTimer }: {
   serial: string;
   packageName: string;
   pid: number | null;
   intervalMs?: number | null;
   exec?: Executor | null;
+  signal?: AbortSignal;
   onChange: (nextPid: number) => void | Promise<void>;
   resolve?: (serial: string, packageName: string, opts: {
     exec?: Executor | null;
-  }) => number | null;
+    signal?: AbortSignal;
+  }) => number | null | Promise<number | null>;
   setTimer?: (fn: () => void, ms: number) => ReturnType<typeof setTimeout>;
   clearTimer?: (t: ReturnType<typeof setTimeout>) => void;
 }): PidWatcher;
@@ -83,10 +81,13 @@ interface RunCollectorOptions {
   pidTimeoutMs?: number;
   pidOf?: ((serial: string, packageName: string, opts: {
     exec?: Executor | null;
-  }) => number | null) | null;
+  }) => number | null | Promise<number | null>) | null;
   pidWatchMs?: number | null;
   watchPid?: typeof watchAppPid;
-  resolveClockOffset?: typeof androidClockOffset;
+  resolveClockOffset?: (serial: string, opts: {
+    now?: () => number;
+    signal?: AbortSignal;
+  }) => number | null | Promise<number | null>;
   now?: () => number;
   onExit?: (code: number) => void;
   attachSignals?: boolean;