stim 1.17.2 → 1.19.0

package/dist/{ios-device-pAN4t54-.mjs → ios-device-CJ_ZOGky.mjs}

@@ -1,6 +1,6 @@
-import { t as getExecutor } from "./exec-CaErVv7t.mjs";
-import { n as TOOL_ERROR_PREFIX } from "./ios-device-Ee7sDXfp.mjs";
-import { i as INSTALL_ERROR } from "./app-install-VPkI5WEg.mjs";
+import { t as getExecutor } from "./exec-i8GDPwq9.mjs";
+import { i as INSTALL_ERROR } from "./app-install-CFI4ptUL.mjs";
+import { n as TOOL_ERROR_PREFIX } from "./ios-device-CrW8aMb5.mjs";
 import { mkdtempSync, readFileSync, rmSync } from "node:fs";
 import { join } from "node:path";
 import { tmpdir } from "node:os";

package/dist/{ios-device-Ee7sDXfp.mjs → ios-device-CrW8aMb5.mjs}

@@ -1,4 +1,4 @@
-import { t as getExecutor } from "./exec-CaErVv7t.mjs";
+import { t as getExecutor } from "./exec-i8GDPwq9.mjs";
 //#region src/collector/ios-device.ts
 const CONSOLE_ENV = { OS_ACTIVITY_DT_MODE: "enable" };
 const DEV_MENU_LAUNCH_ARGS = [

package/dist/{ios-state-8L3lgum6.mjs → ios-state-By0XuLTQ.mjs}

@@ -1,4 +1,4 @@
-import { a as updateWorkspaceState, r as readWorkspaceState$1 } from "./workspace-state-DqcCbpE7.mjs";
+import { a as updateWorkspaceState, r as readWorkspaceState$1 } from "./workspace-state-CR9X86xJ.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/{launch-verify-lTnWZikR.mjs → launch-verify-DCveSE6d.mjs}

@@ -1,8 +1,8 @@
-import { t as getExecutor } from "./exec-CaErVv7t.mjs";
-import { s as isAppLaunchError } from "./command-output-CDAIFD-8.mjs";
-import { o as readNdjsonGenerations } from "./ndjson-PclOIwVY.mjs";
-import { t as DEV_MENU_LAUNCH_ARGS } from "./ios-device-Ee7sDXfp.mjs";
-import { f as deviceShellArg, n as ANDROID_DISABLE_AUTO_LAUNCH_EXTRA, s as androidAppProcess } from "./app-install-VPkI5WEg.mjs";
+import { t as getExecutor } from "./exec-i8GDPwq9.mjs";
+import { s as isAppLaunchError } from "./command-output-Bt8ygHE7.mjs";
+import { o as readNdjsonGenerations } from "./ndjson-LGZAMsqa.mjs";
+import { f as deviceShellArg, n as ANDROID_DISABLE_AUTO_LAUNCH_EXTRA, s as androidAppProcess } from "./app-install-CFI4ptUL.mjs";
+import { t as DEV_MENU_LAUNCH_ARGS } from "./ios-device-CrW8aMb5.mjs";
 import { join } from "node:path";
 //#region src/engine/app-readiness.ts
 const APP_READINESS_TIMEOUT_MS = 3e4;

package/dist/{logs-BAaS7gS2.mjs → logs-Bao1HOMy.mjs}

@@ -1,15 +1,15 @@
-import { H as projectDeviceSlots, V as parseDeviceSlotOption, _ as loadConfig$1, g as isPathPrefix } from "./config-D0DbpZtM.mjs";
-import { t as process_identity_exports } from "./process-identity-BmRm1qV0.mjs";
-import { f as refuseNoProject, l as phaseLine, v as launchErrorPreview } from "./command-output-CDAIFD-8.mjs";
-import { o as findCommandWorkspace } from "./project-D47Rh0ly.mjs";
-import { r as readWorkspaceState$1, x as workspaceLogsDir$1 } from "./workspace-state-DqcCbpE7.mjs";
-import { n as agentDeviceLiveness, u as readAgentDeviceRecords } from "./activity-IRvJY_ru.mjs";
-import { n as SOURCES, t as LEVELS } from "./ndjson-PclOIwVY.mjs";
-import { o as connectHost } from "./hosted-client-Bp4knSwu.mjs";
-import { n as pullHostedNativeLogs, t as pullHostedMacosLogs } from "./hosted-logs-OcgIBvCT.mjs";
-import "./hosted-macos-DcxKjtfH.mjs";
-import { n as readHostedIos, t as readHostedAndroid } from "./ios-state-8L3lgum6.mjs";
-import { i as captureWorkspaceCrashes, t as errorDiagnostics } from "./error-diagnostics-C-NMnhrk.mjs";
+import { t as process_identity_exports } from "./process-identity-Biv3arCO.mjs";
+import { f as refuseNoProject, l as phaseLine, v as launchErrorPreview } from "./command-output-Bt8ygHE7.mjs";
+import { H as projectDeviceSlots, V as parseDeviceSlotOption, _ as loadConfig$1, g as isPathPrefix } from "./config-DC5jEtd1.mjs";
+import { r as readWorkspaceState$1, x as workspaceLogsDir$1 } from "./workspace-state-CR9X86xJ.mjs";
+import { n as findCommandWorkspace } from "./project-B5eQ1USs.mjs";
+import { n as agentDeviceLiveness, u as readAgentDeviceRecords } from "./activity-BSw0x84R.mjs";
+import { n as SOURCES, t as LEVELS } from "./ndjson-LGZAMsqa.mjs";
+import { o as connectHost } from "./hosted-client-C5G4h_OJ.mjs";
+import { n as pullHostedNativeLogs, t as pullHostedMacosLogs } from "./hosted-logs-CI9Az9a4.mjs";
+import { n as readHostedIos, t as readHostedAndroid } from "./ios-state-By0XuLTQ.mjs";
+import { i as captureWorkspaceCrashes, t as errorDiagnostics } from "./error-diagnostics--v5HGOU0.mjs";
+import "./hosted-macos-DABm3ScO.mjs";
 import { t as watchStdoutReader } from "./stdout-reader-C8yjre1x.mjs";
 import { realpathSync } from "node:fs";
 import { dirname, join, relative, resolve, sep } from "node:path";
@@ -251,7 +251,7 @@ 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, or all").option("--level <l>", `Minimum level: ${LEVELS.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").option("--level <l>", `Minimum level: ${LEVELS.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 root = findCommandWorkspace(process.cwd());
 		if (!root) {
 			refuseNoProject({ json: false });

package/dist/{macos-BIRQS90f.mjs → macos-ciyBdTY5.mjs}

@@ -1,67 +1,55 @@
-import { t as getExecutor } from "./exec-CaErVv7t.mjs";
-import { E as upsertProject, u as getConcurrencyLimits } from "./config-D0DbpZtM.mjs";
-import { t as process_identity_exports } from "./process-identity-BmRm1qV0.mjs";
-import { l as phaseLine } from "./command-output-CDAIFD-8.mjs";
-import { P as resolveSettings, R as settingShapeErrors, gt as repoRoot, i as SETTING_SHAPE_REMEDY, it as gitCommonDir } from "./settings-Cfd-0r2d.mjs";
-import { s as findProjectRoot$1 } from "./project-D47Rh0ly.mjs";
-import { c as writeWorkspaceState, g as workspaceAgentDeviceDir, i as recordWorkspaceUse, u as ensureWorkspaceStorage, v as workspaceDir, x as workspaceLogsDir$1 } from "./workspace-state-DqcCbpE7.mjs";
-import { a as spawnDeclared } from "./spawn-claims-D0XfSe8u.mjs";
-import { r as releaseBuildSlot, t as acquireBuildSlot } from "./build-slots-41v_d2x9.mjs";
-import { t as withWorkspaceProcessLock } from "./workspace-process-lock-2mNzOlaB.mjs";
-import { c as recordFinishedBuild, l as startBuildProgress, n as NO_BUILD_PROGRESS, u as tapBuildLog } from "./build-progress-D0WkjCPd.mjs";
-import { a as requiredMacosRecord, n as macosLogFile, r as macosProcess, t as macosDir } from "./state-DyaNTgfR.mjs";
-import { r as createNdjsonWriter } from "./ndjson-PclOIwVY.mjs";
-import { i as macosToolchain } from "./toolchain-DNyR3NPq.mjs";
-import { a as offloadBuild, c as placementLoad, d as OffloadRefusal, f as namedBuildMachine, h as resolveBuildPlacement, i as closeOffload, l as remotePhaseText, n as buildPlacementCandidates, p as parseBuildMachineOption, r as chooseBuildMachine, s as offloadPlacement } from "./client-SvBdgObD.mjs";
-import { o as connectHost } from "./hosted-client-Bp4knSwu.mjs";
-import { t as logLines } from "./run-CkE9y0nc.mjs";
-import { t as placeHostedMacos } from "./hosted-macos-DcxKjtfH.mjs";
-import { n as stopMacosAppHeld } from "./stop-BIiM49EY.mjs";
-import { t as spawnEntry } from "./spawn-entry-jw19m8Nl.mjs";
-import { n as stageBundle, r as validateInfoPlist, t as resolveBundleExtras } from "./stage-CzaiwFsI.mjs";
-import { f as withNativeBuildRun } from "./native-run-D1Q56rAD.mjs";
-import { createHash, randomUUID } from "node:crypto";
+import { t as process_identity_exports } from "./process-identity-Biv3arCO.mjs";
+import { t as getExecutor } from "./exec-i8GDPwq9.mjs";
+import { t as spawnEntry } from "./spawn-entry-Dcb7sDUz.mjs";
+import { l as phaseLine } from "./command-output-Bt8ygHE7.mjs";
+import { E as upsertProject, u as getConcurrencyLimits } from "./config-DC5jEtd1.mjs";
+import { c as writeWorkspaceState, g as workspaceAgentDeviceDir, i as recordWorkspaceUse, u as ensureWorkspaceStorage, v as workspaceDir, x as workspaceLogsDir$1 } from "./workspace-state-CR9X86xJ.mjs";
+import { d as projectRegistry, o as ownedDeviceLabel, r as findProjectRoot } from "./project-B5eQ1USs.mjs";
+import { B as settingShapeErrors, I as resolveSettings, i as SETTING_SHAPE_REMEDY, mt as repoRoot, nt as gitCommonDir } from "./settings-CxgngUZk.mjs";
+import { F as recordFinishedBuild, I as startBuildProgress, L as tapBuildLog, O as NO_BUILD_PROGRESS, P as recordBuildPhase } from "./budget-Dz-kyXLv.mjs";
+import { M as acquireBuildSlot, P as releaseBuildSlot } from "./workspaces-Djb2gfi9.mjs";
+import { a as spawnDeclared } from "./spawn-claims-Kqiifsk2.mjs";
+import { E as sanitizeDeviceLabel } from "./ios-BWbHFZVz.mjs";
+import { a as withWorkspaceProcessLock } from "./named-ports-B4iWH4E-.mjs";
+import { i as macosProcess, n as macosDir, o as requiredMacosRecord, r as macosLogFile } from "./state-Tp4uImDS.mjs";
+import { r as createNdjsonWriter } from "./ndjson-LGZAMsqa.mjs";
+import { A as resolveBuildPlacement, C as setRemoteLogSink, D as parseBuildMachineOption, E as namedBuildMachine, O as requireLocalBuild, S as withNativeBuildRun, a as offloadBuild, c as placementLoad, i as closeOffload, l as remotePhaseText, n as buildPlacementCandidates, r as chooseBuildMachine, s as offloadPlacement, w as OffloadRefusal } from "./client-CuUo8Nvg.mjs";
+import { o as connectHost } from "./hosted-client-C5G4h_OJ.mjs";
+import { t as buildPlacementRecord } from "./placement-log-Dxe34rJm.mjs";
+import { t as placeHostedMacos } from "./hosted-macos-DABm3ScO.mjs";
+import { i as validateInfoPlist, t as resolveBundleExtras } from "./stage-BgaZJVZY.mjs";
+import { r as stopMacosAppHeld, t as stopBundleInstances } from "./stop-D0UIpZuh.mjs";
 import { closeSync, existsSync, mkdirSync, mkdtempSync, openSync, realpathSync, renameSync, rmSync } from "node:fs";
-import { join, relative, resolve } from "node:path";
-import { LOG_ROTATE_BYTES } from "@stim-cli/core";
+import { join } from "node:path";
 import { machineCapacity, readMacosRecord, validHostedAppArguments } from "@stim-cli/core/state";
-//#region src/macos/build.ts
-async function tool(root, args, writer, note, capture = false) {
-	const child = spawnDeclared(() => getExecutor().spawn("swift", args, {
-		cwd: root,
-		detached: true,
-		stdio: [
-			"ignore",
-			"pipe",
-			"pipe"
-		]
-	}));
-	let stdout = "";
-	child.stdout?.on("data", (chunk) => {
-		if (capture) stdout += chunk.toString("utf8");
-	});
-	const write = (msg) => {
-		writer.write({
-			src: "build",
-			platform: "macos",
-			level: "debug",
-			msg
-		});
-		note(msg);
-	};
-	if (child.stdout) logLines(child.stdout, write);
-	if (child.stderr) logLines(child.stderr, write);
-	await new Promise((done, reject) => {
-		child.once("error", reject);
-		child.once("close", (code) => code === 0 ? done() : reject(/* @__PURE__ */ new Error(`swift ${args[0]} failed (${code}). See stim logs --source build.`)));
-	});
-	return stdout.trim();
+import { LOG_ROTATE_BYTES } from "@stim-cli/core";
+import { createHash, randomUUID } from "node:crypto";
+//#region src/macos/app-name.ts
+const DOT = String.fromCodePoint(183);
+const ELLIPSIS = String.fromCodePoint(8230);
+const LABEL_MAX = 24;
+const PRODUCT_MAX = 40;
+function clip(text, max) {
+	const chars = [...text];
+	return chars.length <= max ? text : `${chars.slice(0, max - 1).join("")}${ELLIPSIS}`;
+}
+/** The visible app name for a run: `<product> <dot> <label>`, or just the product when the label is empty. */
+function macosAppName(product, label) {
+	const name = clip(product.replace(/[\p{Cc}/:\\]+/gu, " ").trim(), PRODUCT_MAX) || "App";
+	const suffix = clip(sanitizeDeviceLabel(label), LABEL_MAX);
+	return suffix ? `${name} ${DOT} ${suffix}` : name;
 }
-async function buildMacosBundle({ root, product, infoPlist, bundle, bundleId, scratch, writer, note, record, buildMachine, resources, assetCatalog, progress = NO_BUILD_PROGRESS }) {
+function workspaceAppName(root, product) {
+	return macosAppName(product, ownedDeviceLabel(root));
+}
+//#endregion
+//#region src/macos/build.ts
+async function buildMacosBundle({ root, recipe, bundle, bundleId, displayName, scratch, writer, note, record, buildMachine, progress = NO_BUILD_PROGRESS }) {
 	if (record) record.buildMachine = buildMachine;
-	validateInfoPlist(root, product, infoPlist);
-	const repository = realpathSync(repoRoot(root) ?? root);
-	const extras = resolveBundleExtras(root, repository, resources, assetCatalog);
+	setRemoteLogSink((entry) => writer.write({
+		...entry,
+		platform: "macos"
+	}));
 	const write = (msg) => {
 		writer.write({
 			src: "build",
@@ -72,8 +60,22 @@ async function buildMacosBundle({ root, product, infoPlist, bundle, bundleId, sc
 		note(msg);
 	};
 	let offloadFallback = null;
+	let asked = [];
+	let failedMachine;
 	const fallBack = (reason) => {
+		writer.write(buildPlacementRecord({
+			platform: "macos",
+			buildMachine,
+			candidates: asked,
+			event: "placement_fallback",
+			fallback: {
+				code: failedMachine ? "offload-failed" : "no-remote-mac-took-it",
+				reason,
+				machine: failedMachine
+			}
+		}));
 		if (namedBuildMachine(buildMachine)) throw new OffloadRefusal(buildMachine, reason);
+		requireLocalBuild(buildMachine);
 		offloadFallback = reason;
 		if (record) record.offloadFallback = reason;
 		writer.write({
@@ -102,10 +104,11 @@ async function buildMacosBundle({ root, product, infoPlist, bundle, bundleId, sc
 	let choice = null;
 	try {
 		try {
-			const { mode, machines } = buildPlacementCandidates(buildMachine);
+			const { mode, machines, localEnabled } = buildPlacementCandidates(buildMachine);
 			const here = machineCapacity();
 			const placement = offloadPlacement({
 				mode,
+				localEnabled,
 				machines: machines.length,
 				here,
 				unsupported: null,
@@ -114,29 +117,30 @@ async function buildMacosBundle({ root, product, infoPlist, bundle, bundleId, sc
 			if (placement.offload) {
 				const chosen = await chooseBuildMachine({
 					projectRoot: root,
-					target: {
-						platform: "macos",
-						local: macosToolchain()
-					},
+					target: recipe.offload.target(),
 					mode,
 					here,
 					machines,
 					selected: buildMachine,
-					note: (line) => write(`offload: ${line}`)
+					note: (line) => write(`offload: ${line}`),
+					onCandidates: (each) => asked = each
 				});
 				if (typeof chosen === "string") throw new Error(chosen);
 				choice = chosen;
+				failedMachine = chosen.machine;
+				writer.write(buildPlacementRecord({
+					platform: "macos",
+					buildMachine,
+					candidates: asked,
+					chose: {
+						machine: chosen.machine,
+						reason: `${placement.reason}${placementLoad(chosen)}`
+					}
+				}));
 				write(`placement: ${choice.machine} (${placement.reason}${placementLoad(choice)})`);
 				const outcome = await offloadBuild({
 					choice,
-					request: {
-						platform: "macos",
-						product,
-						infoPlist: relative(root, resolve(root, infoPlist)),
-						bundleId,
-						resources: Object.fromEntries(Object.entries(extras.resources).map(([destination, source]) => [destination, relative(repository, source)])),
-						assetCatalog: extras.assetCatalog ? relative(repository, extras.assetCatalog) : null
-					},
+					request: recipe.offload.request(bundleId),
 					stagingDir: join(staging, "offload"),
 					onPhase: (phase, line) => note(remotePhaseText(phase, line, choice.machine)),
 					onEnter: (phase) => {
@@ -161,21 +165,7 @@ async function buildMacosBundle({ root, product, infoPlist, bundle, bundleId, sc
 				progress.place(null);
 				if (!outcome.ok) throw new Error(`${outcome.machine}: ${outcome.reason}`);
 				progress.step("install");
-				const executable = join(outcome.artifactPath, "Contents", "MacOS", product);
-				const plist = JSON.parse(getExecutor().runFile("plutil", [
-					"-convert",
-					"json",
-					"-o",
-					"-",
-					join(outcome.artifactPath, "Contents", "Info.plist")
-				]));
-				if (plist.CFBundleIdentifier !== bundleId || plist.CFBundleExecutable !== product || !existsSync(executable)) throw new Error("The fetched macOS bundle does not match the requested identity and executable.");
-				for (const destination of [...Object.keys(extras.resources), ...extras.assetCatalog ? ["Assets.car"] : []]) if (!existsSync(join(outcome.artifactPath, "Contents", "Resources", destination))) throw new Error(`The fetched macOS bundle lacks declared resource ${destination}.`);
-				getExecutor().runFile("codesign", [
-					"--verify",
-					"--strict",
-					outcome.artifactPath
-				]);
+				recipe.validateFetched(outcome.artifactPath, bundleId, displayName);
 				promote(outcome.artifactPath);
 				if (record) {
 					record.offloadedTo = outcome.machine;
@@ -188,6 +178,14 @@ async function buildMacosBundle({ root, product, infoPlist, bundle, bundleId, sc
 					handoff: outcome.handoff ?? null
 				};
 			}
+			writer.write(buildPlacementRecord({
+				platform: "macos",
+				buildMachine,
+				stays: {
+					code: placement.code,
+					reason: placement.reason
+				}
+			}));
 			write(`placement: here (${placement.reason})`);
 		} catch (error) {
 			fallBack(error instanceof Error ? error.message : String(error));
@@ -197,36 +195,24 @@ async function buildMacosBundle({ root, product, infoPlist, bundle, bundleId, sc
 		let slot;
 		try {
 			slot = await acquireBuildSlot({
+				automatic: buildMachine === "auto",
 				max: getConcurrencyLimits().maxBuilds,
 				root,
 				logFile: writer.file,
 				out: note,
 				waitingFor: (info) => progress.waitingFor(info, "build-slot")
 			});
+			requireLocalBuild(buildMachine);
 			if (record) record.builtOn = "here";
 			progress.step("compile");
-			await tool(root, [
-				"build",
-				"-c",
-				"debug",
-				"--product",
-				product,
-				"--scratch-path",
-				scratch,
-				"--jobs",
-				"2"
-			], writer, note);
-			const bin = await tool(root, [
-				"build",
-				"-c",
-				"debug",
-				"--scratch-path",
+			const bin = await recipe.compile({
 				scratch,
-				"--show-bin-path"
-			], writer, () => {}, true);
+				writer,
+				note
+			});
 			progress.step("install");
-			const staged = join(staging, `${product}.app`);
-			stageBundle(root, product, infoPlist, bin, staged, bundleId, extras);
+			const staged = join(staging, `${recipe.product}.app`);
+			recipe.stage(bin, staged, bundleId, displayName);
 			promote(staged);
 			return {
 				bundleId,
@@ -247,6 +233,41 @@ async function buildMacosBundle({ root, product, infoPlist, bundle, bundleId, sc
 	}
 }
 //#endregion
+//#region src/macos/plan.ts
+function planMacos(root, buildMachineFlag) {
+	if (process.platform !== "darwin") throw new Error("stim macos requires a Mac with Swift installed.");
+	root = realpathSync(root);
+	if (!existsSync(join(root, "Package.swift"))) throw new Error("Run stim macos from the directory containing Package.swift.");
+	const repository = repoRoot(root);
+	const settings = resolveSettings({
+		projectPath: root,
+		gitCommonDir: gitCommonDir(root),
+		repoRoot: repository
+	});
+	const [shape] = settingShapeErrors(settings);
+	if (shape) throw new Error(`${shape} ${SETTING_SHAPE_REMEDY}`);
+	const selected = resolveBuildPlacement(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" });
+	validateInfoPlist(root, macos.product, macos.infoPlist);
+	resolveBundleExtras(root, repository ?? root, macos.resources, macos.assetCatalog);
+	return {
+		platform: "macos",
+		product: macos.product,
+		buildMachine: selected.selected,
+		fingerprint: null,
+		cacheKey: null,
+		cacheHit: false,
+		provider: null,
+		cacheSkipped: false,
+		prebuild: null,
+		outcome: null,
+		expectedMs: null,
+		basis: 0
+	};
+}
+//#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
@@ -258,7 +279,11 @@ async function runMacos(root, note = console.error, remote, buildMachineFlag) {
 	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" });
 	if (process.platform !== "darwin") throw new Error("stim macos requires a Mac with Swift installed.");
 	root = realpathSync(root);
-	if (!existsSync(join(root, "Package.swift"))) throw new Error("Run stim macos from the directory containing Package.swift.");
+	const operation = projectRegistry.selectMacos(root);
+	if ("problem" in operation) throw Object.assign(new Error(operation.problem.message), {
+		code: "STIM_NO_PROJECT",
+		remedy: operation.problem.remedy
+	});
 	const settings = resolveSettings({
 		projectPath: root,
 		gitCommonDir: gitCommonDir(root),
@@ -269,8 +294,7 @@ async function runMacos(root, note = console.error, remote, buildMachineFlag) {
 	const selected = resolveBuildPlacement(buildMachineFlag);
 	if (selected.failure) throw Object.assign(new Error(selected.failure.message), selected.failure);
 	const buildMachine = selected.selected;
-	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 macos = (await operation.load()).prepare(settings);
 	ensureWorkspaceStorage(root);
 	return withNativeBuildRun(root, {
 		command: "macos",
@@ -286,7 +310,7 @@ async function runMacos(root, note = console.error, remote, buildMachineFlag) {
 		return withWorkspaceProcessLock(workspaceDir(root), "macos-launch", async () => {
 			const previous = requiredMacosRecord(root);
 			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.");
+			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.");
 			if (remote) (await connectHost(remote)).connection.close();
 			if (!previous?.host) await stopMacosAppHeld(root);
 			upsertProject(root, {});
@@ -298,7 +322,7 @@ async function runMacos(root, note = console.error, remote, buildMachineFlag) {
 				bundleId: "",
 				executable: join(bundle, "Contents", "MacOS", macos.product),
 				launchId: randomUUID(),
-				arguments: macos.arguments ?? [],
+				arguments: macos.arguments,
 				supervisor: macosProcess(process.pid),
 				build: {
 					state: "running",
@@ -310,9 +334,20 @@ async function runMacos(root, note = console.error, remote, buildMachineFlag) {
 					hostLaunched: previous.hostLaunched ?? false
 				} : {}
 			};
-			const handoff = await buildBundle(root, macos.infoPlist, record, remote !== void 0, note, macos, progress);
+			const handoff = await buildBundle(root, macos, record, remote !== void 0, note, progress);
 			progress.step("launch");
-			if (!remote) return launchHere(root, record);
+			const launched = () => {
+				try {
+					recordBuildPhase(root, "macos", record.build.startedAt, "launch", progress.durations().launch ?? 0);
+				} catch (error) {
+					note(`The launch time could not be recorded in the build history: ${error?.message || error}`);
+				}
+			};
+			if (!remote) {
+				const here = await launchHere(root, record);
+				launched();
+				return here;
+			}
 			const connection = await connectHost(remote);
 			const write = (patch) => writeWorkspaceState(root, { macos: {
 				...record,
@@ -325,7 +360,7 @@ async function runMacos(root, note = console.error, remote, buildMachineFlag) {
 					bundle: record.bundle,
 					bundleId: record.bundleId,
 					handoff,
-					arguments: macos.arguments ?? [],
+					arguments: macos.arguments,
 					recorded: previous?.host,
 					reserved: (reserved) => {
 						placement = reserved;
@@ -344,6 +379,7 @@ async function runMacos(root, note = console.error, remote, buildMachineFlag) {
 					hostLaunched: run.launched
 				};
 				writeWorkspaceState(root, { macos: placed });
+				launched();
 				return placed;
 			} catch (error) {
 				write({
@@ -364,30 +400,30 @@ async function runMacos(root, note = console.error, remote, buildMachineFlag) {
 		}).finally(() => progress.clear());
 	}, { write: note });
 }
-async function buildBundle(root, infoPlist, record, hosted, note, extras, progress = NO_BUILD_PROGRESS) {
+async function buildBundle(root, recipe, record, hosted, note, progress = NO_BUILD_PROGRESS) {
 	const started = Date.parse(record.build.startedAt);
 	const scratch = join(macosDir(root), "build");
 	writeWorkspaceState(root, { macos: record });
 	const writer = tapBuildLog(createNdjsonWriter(macosLogFile(root), { maxBytes: LOG_ROTATE_BYTES }), progress);
 	try {
-		const { bundleId: base } = validateInfoPlist(root, record.product, infoPlist);
+		const base = recipe.bundleId;
 		const bundleId = hosted ? base : `${base}.stim.${createHash("sha256").update(root).digest("hex").slice(0, 12)}`;
+		const displayName = workspaceAppName(root, record.product);
 		const built = await buildMacosBundle({
 			root,
-			product: record.product,
-			infoPlist,
+			recipe,
 			bundle: record.bundle,
 			bundleId,
+			displayName,
 			scratch,
 			writer,
 			note,
 			progress,
 			record: record.build,
-			buildMachine: record.build.buildMachine,
-			resources: extras.resources,
-			assetCatalog: extras.assetCatalog
+			buildMachine: record.build.buildMachine
 		});
 		record.bundleId = built.bundleId;
+		record.displayName = displayName;
 		record.bundle = realpathSync(record.bundle);
 		record.executable = realpathSync(join(record.bundle, "Contents", "MacOS", record.product));
 		record.build = {
@@ -397,7 +433,7 @@ async function buildBundle(root, infoPlist, record, hosted, note, extras, progre
 			durationMs: Date.now() - started
 		};
 		writeWorkspaceState(root, { macos: record });
-		recordMacosBuild(root, record.build);
+		recordMacosBuild(root, record.build, progress.steps());
 		return built.handoff;
 	} catch (error) {
 		const message = error instanceof Error ? error.message : String(error);
@@ -420,13 +456,13 @@ async function buildBundle(root, infoPlist, record, hosted, note, extras, progre
 			supervisor: void 0,
 			build
 		} });
-		recordMacosBuild(root, build);
+		recordMacosBuild(root, build, progress.steps());
 		throw error;
 	} finally {
 		writer.close();
 	}
 }
-function recordMacosBuild(root, build) {
+function recordMacosBuild(root, build, compileSteps) {
 	recordFinishedBuild(root, {
 		platform: "macos",
 		status: build.state === "ok" ? "ok" : "failed",
@@ -441,10 +477,12 @@ function recordMacosBuild(root, build) {
 		buildMachine: build.buildMachine,
 		builtOn: build.builtOn,
 		offloadedTo: build.offloadedTo,
-		offloadFallback: build.offloadFallback
+		offloadFallback: build.offloadFallback,
+		...compileSteps === null ? {} : { compileSteps }
 	});
 }
 async function launchHere(root, record) {
+	await stopBundleInstances(root);
 	const fd = openSync(join(workspaceLogsDir$1(root), "macos-supervisor.log"), "a");
 	let child;
 	try {
@@ -485,19 +523,43 @@ function launchPayload(root, record) {
 		platform: "macos",
 		...record
 	};
-	const { product, launchId, build, host } = record;
+	const { product, displayName, launchId, build, host } = record;
 	return {
 		agentDevice,
 		platform: "macos",
 		product,
+		displayName,
 		launchId,
 		build,
 		host
 	};
 }
 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 payload; build output goes to stderr").option("--remote <machine>", "run it on this approved remote Mac from remote.machines").action(async (options) => {
-		const root = findProjectRoot$1(process.cwd());
+	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) => {
+		const root = findProjectRoot(process.cwd());
+		if (options.plan) {
+			try {
+				if (!root) throw new Error("Run stim macos from the Swift Package directory.");
+				if (options.remote !== void 0) throw Object.assign(/* @__PURE__ */ new Error("--remote selects a launch host and does not apply to --plan."), { code: "STIM_BAD_ARG" });
+				const plan = planMacos(root, options.remoteBuild);
+				if (options.json) console.log(JSON.stringify(plan));
+				else {
+					console.log(phaseLine("plan", `macos ${plan.product}: SwiftPM Debug build, then stage and launch`));
+					console.log(phaseLine("build", `selection: ${plan.buildMachine}; worker availability is not checked`));
+					console.log(phaseLine("expect", "unknown: SwiftPM determines incremental work when the build runs"));
+				}
+			} catch (error) {
+				const failure = {
+					code: error.code ?? "STIM_BAD_ARG",
+					message: error instanceof Error ? error.message : String(error),
+					remedy: error.remedy ?? "Check the macOS project settings in stim guide macos."
+				};
+				console.error(failure.message);
+				if (options.json) console.log(JSON.stringify(failure));
+				process.exitCode = 1;
+			}
+			return;
+		}
 		if (!root) throw new Error("Run stim macos from the Swift Package directory.");
 		const record = await runMacos(root, console.error, options.remote, options.remoteBuild).catch((error) => {
 			const remedy = error.remedy;
@@ -511,4 +573,4 @@ function macosCommand(program) {
 	});
 }
 //#endregion
-export { macosCommand as default, runMacos };
+export { runMacos as n, macosCommand as t };

package/dist/macos-nIOATJmR.mjs

@@ -0,0 +1,2 @@
+import { n as runMacos, t as macosCommand } from "./macos-ciyBdTY5.mjs";
+export { macosCommand as default, runMacos };

package/dist/macos-run.mjs

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