stim 1.18.0 → 1.19.0

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

@@ -1,6 +1,6 @@
-import { t as getExecutor } from "./exec-DWhCZDGm.mjs";
-import { i as INSTALL_ERROR } from "./app-install-D-PUENug.mjs";
-import { n as TOOL_ERROR_PREFIX } from "./ios-device-Bn7jWDB1.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-Bn7jWDB1.mjs → ios-device-CrW8aMb5.mjs}

@@ -1,4 +1,4 @@
-import { t as getExecutor } from "./exec-DWhCZDGm.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-B2pES6Vs.mjs → ios-state-By0XuLTQ.mjs}

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

@@ -1,8 +1,8 @@
-import { t as getExecutor } from "./exec-DWhCZDGm.mjs";
-import { s as isAppLaunchError } from "./command-output-CBtzyIgF.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-D-PUENug.mjs";
-import { t as DEV_MENU_LAUNCH_ARGS } from "./ios-device-Bn7jWDB1.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-1Ylc1Ri6.mjs → logs-Bao1HOMy.mjs}

@@ -1,15 +1,15 @@
 import { t as process_identity_exports } from "./process-identity-Biv3arCO.mjs";
-import { f as refuseNoProject, l as phaseLine, v as launchErrorPreview } from "./command-output-CBtzyIgF.mjs";
-import { H as projectDeviceSlots, V as parseDeviceSlotOption, _ as loadConfig$1, g as isPathPrefix } from "./config-CgYMahz7.mjs";
-import { o as findCommandWorkspace } from "./project-C3ChRLZy.mjs";
-import { r as readWorkspaceState$1, x as workspaceLogsDir$1 } from "./workspace-state-C59dqG-Z.mjs";
-import { n as agentDeviceLiveness, u as readAgentDeviceRecords } from "./activity-BxnkDZDi.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-C-rMtppF.mjs";
-import { n as pullHostedNativeLogs, t as pullHostedMacosLogs } from "./hosted-logs-DN8Iz4mJ.mjs";
-import { n as readHostedIos, t as readHostedAndroid } from "./ios-state-B2pES6Vs.mjs";
-import { i as captureWorkspaceCrashes, t as errorDiagnostics } from "./error-diagnostics-BRXOqDzG.mjs";
-import "./hosted-macos-B-wEjlwG.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";

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

@@ -1,30 +1,26 @@
 import { t as process_identity_exports } from "./process-identity-Biv3arCO.mjs";
-import { t as getExecutor } from "./exec-DWhCZDGm.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-CBtzyIgF.mjs";
-import { E as upsertProject, u as getConcurrencyLimits } from "./config-CgYMahz7.mjs";
-import { s as gitCommonDir, y as repoRoot } from "./worktree-CsKYexJM.mjs";
-import { s as findProjectRoot$1, u as ownedDeviceLabel } from "./project-C3ChRLZy.mjs";
-import { c as writeWorkspaceState, g as workspaceAgentDeviceDir, i as recordWorkspaceUse, u as ensureWorkspaceStorage, v as workspaceDir, x as workspaceLogsDir$1 } from "./workspace-state-C59dqG-Z.mjs";
-import { F as recordFinishedBuild, I as startBuildProgress, L as tapBuildLog, O as NO_BUILD_PROGRESS, P as recordBuildPhase } from "./budget-DIhL2BKx.mjs";
-import { N as releaseBuildSlot, j as acquireBuildSlot } from "./workspaces-xXItD8Dj.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-B3SbOWdw.mjs";
-import { F as resolveSettings, i as SETTING_SHAPE_REMEDY, z as settingShapeErrors } from "./settings-CQyMElEP.mjs";
-import { a as withWorkspaceProcessLock } from "./named-ports-BFIz1Shz.mjs";
-import { a as requiredMacosRecord, n as macosLogFile, r as macosProcess, t as macosDir } from "./state-xnqpx3AD.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 { _ as resolveBuildPlacement, a as offloadBuild, c as placementLoad, d as setRemoteLogSink, f as OffloadRefusal, h as parseBuildMachineOption, i as closeOffload, l as remotePhaseText, m as namedBuildMachine, n as buildPlacementCandidates, r as chooseBuildMachine, s as offloadPlacement } from "./client-DzhapoMB.mjs";
-import { i as macosToolchain } from "./toolchain-Bnyd_K3A.mjs";
-import { o as connectHost } from "./hosted-client-C-rMtppF.mjs";
-import { t as buildPlacementRecord } from "./placement-log-BcPhRwR4.mjs";
-import { f as withNativeBuildRun } from "./native-run-B06FkmZx.mjs";
-import { t as placeHostedMacos } from "./hosted-macos-B-wEjlwG.mjs";
-import { t as logLines } from "./run-vhtDgpHO.mjs";
-import { i as validateInfoPlist, n as setBundleName, r as stageBundle, t as resolveBundleExtras } from "./stage-g_WqWeaE.mjs";
-import { n as stopMacosAppHeld } from "./stop-BGhKMOuH.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 { join } from "node:path";
 import { machineCapacity, readMacosRecord, validHostedAppArguments } from "@stim-cli/core/state";
 import { LOG_ROTATE_BYTES } from "@stim-cli/core";
 import { createHash, randomUUID } from "node:crypto";
@@ -48,46 +44,12 @@ function workspaceAppName(root, product) {
 }
 //#endregion
 //#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();
-}
-async function buildMacosBundle({ root, product, infoPlist, bundle, bundleId, displayName, scratch, writer, note, record, buildMachine, resources, assetCatalog, progress = NO_BUILD_PROGRESS }) {
+async function buildMacosBundle({ root, recipe, bundle, bundleId, displayName, scratch, writer, note, record, buildMachine, progress = NO_BUILD_PROGRESS }) {
 	if (record) record.buildMachine = buildMachine;
 	setRemoteLogSink((entry) => writer.write({
 		...entry,
 		platform: "macos"
 	}));
-	validateInfoPlist(root, product, infoPlist);
-	const repository = realpathSync(repoRoot(root) ?? root);
-	const extras = resolveBundleExtras(root, repository, resources, assetCatalog);
 	const write = (msg) => {
 		writer.write({
 			src: "build",
@@ -113,6 +75,7 @@ async function buildMacosBundle({ root, product, infoPlist, bundle, bundleId, di
 			}
 		}));
 		if (namedBuildMachine(buildMachine)) throw new OffloadRefusal(buildMachine, reason);
+		requireLocalBuild(buildMachine);
 		offloadFallback = reason;
 		if (record) record.offloadFallback = reason;
 		writer.write({
@@ -141,10 +104,11 @@ async function buildMacosBundle({ root, product, infoPlist, bundle, bundleId, di
 	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,
@@ -153,10 +117,7 @@ async function buildMacosBundle({ root, product, infoPlist, bundle, bundleId, di
 			if (placement.offload) {
 				const chosen = await chooseBuildMachine({
 					projectRoot: root,
-					target: {
-						platform: "macos",
-						local: macosToolchain()
-					},
+					target: recipe.offload.target(),
 					mode,
 					here,
 					machines,
@@ -179,14 +140,7 @@ async function buildMacosBundle({ root, product, infoPlist, bundle, bundleId, di
 				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) => {
@@ -211,30 +165,7 @@ async function buildMacosBundle({ root, product, infoPlist, bundle, bundleId, di
 				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}.`);
-				if (displayName !== void 0) {
-					setBundleName(join(outcome.artifactPath, "Contents", "Info.plist"), displayName);
-					getExecutor().runFile("codesign", [
-						"--force",
-						"--sign",
-						"-",
-						outcome.artifactPath
-					]);
-				}
-				getExecutor().runFile("codesign", [
-					"--verify",
-					"--strict",
-					outcome.artifactPath
-				]);
+				recipe.validateFetched(outcome.artifactPath, bundleId, displayName);
 				promote(outcome.artifactPath);
 				if (record) {
 					record.offloadedTo = outcome.machine;
@@ -264,36 +195,24 @@ async function buildMacosBundle({ root, product, infoPlist, bundle, bundleId, di
 		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, displayName);
+			const staged = join(staging, `${recipe.product}.app`);
+			recipe.stage(bin, staged, bundleId, displayName);
 			promote(staged);
 			return {
 				bundleId,
@@ -314,6 +233,41 @@ async function buildMacosBundle({ root, product, infoPlist, bundle, bundleId, di
 	}
 }
 //#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
@@ -325,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),
@@ -336,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",
@@ -353,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, {});
@@ -365,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",
@@ -377,7 +334,7 @@ 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");
 			const launched = () => {
 				try {
@@ -403,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;
@@ -443,19 +400,18 @@ 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,
@@ -464,9 +420,7 @@ async function buildBundle(root, infoPlist, record, hosted, note, extras, progre
 			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;
@@ -528,6 +482,7 @@ function recordMacosBuild(root, build, compileSteps) {
 	});
 }
 async function launchHere(root, record) {
+	await stopBundleInstances(root);
 	const fd = openSync(join(workspaceLogsDir$1(root), "macos-supervisor.log"), "a");
 	let child;
 	try {
@@ -580,8 +535,31 @@ 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 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;

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-vhtDgpHO.mjs";
+import { n as runMacosSupervisor, t as logLines } from "./run-lAkle1-c.mjs";
 export { logLines, runMacosSupervisor };

package/dist/maintenance-run.mjs

@@ -1,13 +1,13 @@
-import { M as isOnMountedVolume, N as listMountedVolumes, _ as loadConfig$1, j as formatBytes } from "./config-CgYMahz7.mjs";
-import { a as unregister, n as readManifest } from "./cache-manifest-BI7ozfmH.mjs";
-import { Qt as pruneCache, Zt as discoverCaches, l as resolveBudget, pt as planCacheEmptying, r as cacheLabel, st as emptyCaches } from "./budget-DIhL2BKx.mjs";
-import { F as takeGcResults, I as canonicalPath, a as collectWorkspaceOutputs, i as collectOrphanedWorkspaces, o as deleteOrphanedWorkspaces, r as clearWorkspaceOutputs } from "./workspaces-xXItD8Dj.mjs";
-import { D as projectMaintenancePinned } from "./settings-CQyMElEP.mjs";
+import { M as isOnMountedVolume, N as listMountedVolumes, _ as loadConfig$1, j as formatBytes } from "./config-DC5jEtd1.mjs";
+import { D as projectMaintenancePinned } from "./settings-CxgngUZk.mjs";
+import { a as unregister, n as readManifest } from "./cache-manifest-DiwKSyv9.mjs";
+import { Nt as discoverCaches, Pt as pruneCache, l as resolveBudget, pt as planCacheEmptying, r as cacheLabel, st as emptyCaches } from "./budget-Dz-kyXLv.mjs";
+import { I as takeGcResults, L as canonicalPath, a as collectWorkspaceOutputs, i as collectOrphanedWorkspaces, o as deleteOrphanedWorkspaces, r as clearWorkspaceOutputs } from "./workspaces-Djb2gfi9.mjs";
 import { r as createNdjsonWriter } from "./ndjson-LGZAMsqa.mjs";
-import { t as relaunchWithLogFile } from "./detached-entry-BLfcgc4O.mjs";
+import { t as relaunchWithLogFile } from "./detached-entry-pB_IPfV4.mjs";
 import { t as resolveMaintenanceSettings } from "./settings-Djl-mpjX.mjs";
 import { r as due, t as capChildLog } from "./attempt-DW-mQqM7.mjs";
-import { a as recentUse, d as measureDisk, f as measurePressure, i as cacheEntryProtection, m as sizeScanDeferred, p as measureSizes, r as triggeringRoot, s as removeWorktrees, t as plannedMaintenance, u as cacheBlocked } from "./preview-D5V07Nrl.mjs";
+import { a as recentUse, d as measureDisk, f as measurePressure, i as cacheEntryProtection, m as sizeScanDeferred, p as measureSizes, r as triggeringRoot, s as removeWorktrees, t as plannedMaintenance, u as cacheBlocked } from "./preview-BbSottmO.mjs";
 import { appendFileSync, existsSync, mkdirSync, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import { basename, join, resolve, sep } from "node:path";
 import { MAINTENANCE_LOG_NAME, maintenanceChildLogFile, maintenanceDir, maintenanceNdjsonFile, maintenanceRunClaims, maintenanceStateFile, readMaintenanceState, sharedCompilationCache, workspaceLogsDir } from "@stim-cli/core/state";

package/dist/manifest-CX0d1IkZ.mjs

@@ -0,0 +1,148 @@
+import { t as getExecutor } from "./exec-i8GDPwq9.mjs";
+import { l as phaseLine } from "./command-output-Bt8ygHE7.mjs";
+import { _ as loadConfig } from "./config-DC5jEtd1.mjs";
+import { f as sharedCcache, x as workspaceLogsDir } from "./workspace-state-CR9X86xJ.mjs";
+import { r as register } from "./cache-manifest-DiwKSyv9.mjs";
+import { o as machineNumber } from "./budget-Dz-kyXLv.mjs";
+import { readFileSync, realpathSync } from "node:fs";
+import { isAbsolute, join } from "node:path";
+import chalk from "chalk";
+import { createHash } from "node:crypto";
+const CCACHE_SLOPPINESS = "pch_defines,time_macros";
+const STATS_LOG_FILE = "ccache-stats.log";
+const CCACHE_UNAVAILABLE = {
+	status: "unavailable",
+	hits: null,
+	misses: null,
+	hitRatePercent: null
+};
+const CCACHE_NOT_RUN = {
+	status: "not-run",
+	hits: null,
+	misses: null,
+	hitRatePercent: null
+};
+function ccacheStatsLog(root) {
+	return join(workspaceLogsDir(root), STATS_LOG_FILE);
+}
+function ccacheMaxSize(config = loadConfig(), env = process.env) {
+	const { value, error } = machineNumber("caches.ccacheMaxGb", config, env);
+	return error || value === void 0 ? "5G" : `${value}G`;
+}
+function ccacheEnvironment({ binary, dir, workspaceRoot, statsLog, maxSize = "5G" }) {
+	return {
+		CMAKE_C_COMPILER_LAUNCHER: binary,
+		CMAKE_CXX_COMPILER_LAUNCHER: binary,
+		CCACHE_DIR: dir,
+		CCACHE_BASEDIR: workspaceRoot,
+		CCACHE_NOHASHDIR: "true",
+		CCACHE_SLOPPINESS,
+		CCACHE_MAXSIZE: maxSize,
+		CCACHE_STATSLOG: statsLog
+	};
+}
+function parseCcacheBinary(output) {
+	const first = String(output ?? "").split("\n")[0]?.trim();
+	if (!first || !isAbsolute(first)) return null;
+	return first;
+}
+const CMAKE_LAUNCHER = /CMAKE_(C|CXX)_COMPILER_LAUNCHER\b/;
+function projectCmakeLauncher(source) {
+	if (typeof source !== "string") return null;
+	const match = CMAKE_LAUNCHER.exec(source);
+	return match ? `CMAKE_${match[1]}_COMPILER_LAUNCHER` : null;
+}
+const HIT_COUNTERS = /* @__PURE__ */ new Set(["direct_cache_hit", "preprocessed_cache_hit"]);
+function parseCcacheStatsLog(text) {
+	if (typeof text !== "string") return null;
+	let hits = 0;
+	let misses = 0;
+	for (const raw of text.split("\n")) {
+		const line = raw.trim();
+		if (HIT_COUNTERS.has(line)) hits += 1;
+		else if (line === "cache_miss") misses += 1;
+	}
+	const total = hits + misses;
+	if (total === 0) return null;
+	return {
+		status: "reported",
+		hits,
+		misses,
+		hitRatePercent: Math.round(hits / total * 1e3) / 10
+	};
+}
+function readCcacheActivity(statsLog) {
+	let text;
+	try {
+		text = readFileSync(statsLog, "utf-8");
+	} catch {
+		return CCACHE_UNAVAILABLE;
+	}
+	return parseCcacheStatsLog(text) ?? CCACHE_UNAVAILABLE;
+}
+function ccacheActivityLine(activity) {
+	if (activity.status === "reported") return `${activity.hits} hits / ${activity.misses} misses (${activity.hitRatePercent}%)`;
+	if (activity.status === "not-run") return "not run; artifact cache supplied the app";
+	return "unavailable; no C++ compile went through ccache";
+}
+function lookupCcache() {
+	try {
+		return parseCcacheBinary(getExecutor().findExecutable("ccache"));
+	} catch {
+		return null;
+	}
+}
+function readOrNull(file) {
+	try {
+		return readFileSync(file, "utf-8");
+	} catch {
+		return null;
+	}
+}
+function canonical(root) {
+	try {
+		return realpathSync(root);
+	} catch {
+		return root;
+	}
+}
+function resolveCcache({ root, dir = sharedCcache(), lookup = lookupCcache, onNote = (line) => console.error(line) }) {
+	const binary = lookup();
+	if (!binary) {
+		onNote(chalk.dim(phaseLine("cache", "ccache off (not installed; brew install ccache)")));
+		return null;
+	}
+	const declared = projectCmakeLauncher(readOrNull(join(root, "android", "app", "build.gradle")));
+	if (declared) {
+		onNote(chalk.dim(phaseLine("cache", `ccache off (android/app/build.gradle sets ${declared} itself)`)));
+		return null;
+	}
+	const statsLog = ccacheStatsLog(root);
+	register({
+		dir,
+		name: "ccache",
+		prune: "atomic",
+		note: "ccache keeps itself under CCACHE_MAXSIZE, so it is emptied whole or not at all"
+	});
+	onNote(chalk.dim(phaseLine("cache", `ccache on (${dir})`)));
+	return {
+		dir,
+		statsLog,
+		env: ccacheEnvironment({
+			binary,
+			dir,
+			workspaceRoot: canonical(root),
+			statsLog,
+			maxSize: ccacheMaxSize()
+		})
+	};
+}
+//#endregion
+//#region src/offload/manifest.ts
+function manifestDigest(entries) {
+	const hash = createHash("sha256");
+	for (const entry of entries.toSorted((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0)) hash.update(`${entry.path}\0${entry.kind}\0${entry.sha256}\n`);
+	return hash.digest("hex");
+}
+//#endregion
+export { projectCmakeLauncher as a, ccacheActivityLine as i, CCACHE_NOT_RUN as n, readCcacheActivity as o, CCACHE_UNAVAILABLE as r, resolveCcache as s, manifestDigest as t };