stim 1.8.0 → 1.9.0

package/dist/{build-lock-CgtsB6TV.mjs → build-lock-DPXPLgTc.mjs}

@@ -1,14 +1,15 @@
-import { t as getExecutor } from "./exec-B29XNuhP.mjs";
-import { E as ownership_claim_exports, u as getConfigDir } from "./config-B7iyKWkL.mjs";
-import { r as register } from "./cache-manifest-CYJi8-Hx.mjs";
-import { l as sharedBuildCache } from "./workspace-state-BT5E3SA2.mjs";
-import { a as formatElapsed } from "./command-output-B3ycpsYv.mjs";
+import { k as ownership_claim_exports, u as getConfigDir } from "./config-Cp9lM3wX.mjs";
+import { t as getExecutor } from "./exec-jIAlgilk.mjs";
+import { r as register } from "./cache-manifest-Dg7OnMrp.mjs";
+import { d as sharedBuildCache } from "./workspace-state-DF2gCFhx.mjs";
+import { a as formatElapsed, i as formatDuration, m as shortHash } from "./command-output-gByVmIjy.mjs";
+import { r as stopDeclaringSpawnsOn, t as declareSpawnsOn } from "./spawn-claims-Dn3C_N6w.mjs";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
-import { createHash } from "node:crypto";
-import { join } from "node:path";
 import { existsSync as existsSync$1, mkdirSync as mkdirSync$1, readFileSync as readFileSync$1, rmSync as rmSync$1, writeFileSync as writeFileSync$1 } from "fs";
-import { join as join$1 } from "path";
+import { join } from "path";
 import { buildCacheKey, resolveArtifact, storeArtifact } from "@stim-cli/core";
+import { join as join$1 } from "node:path";
+import { createHash } from "node:crypto";
 import * as expoFingerprint from "@expo/fingerprint";
 import { buildUploadTimeoutMs } from "@stim-cli/cache";
 const ASSET_MANIFEST_FILE = "assets-manifest.json";
@@ -34,7 +35,7 @@ function readAssetManifest(root) {
 			return;
 		}
 		for (const name of names) {
-			const child = join(abs, name);
+			const child = join$1(abs, name);
 			let stat;
 			try {
 				stat = statSync(child);
@@ -106,16 +107,16 @@ function pickGeneratedResDir(names, variant, reactChildren = []) {
 	return null;
 }
 function androidModuleDirs(root, { list = safeList } = {}) {
-	const android = join(root, "android");
-	return ["app", ...list(android).filter((name) => name !== "app" && existsSync(join(android, name, "build", "generated", "res"))).toSorted()];
+	const android = join$1(root, "android");
+	return ["app", ...list(android).filter((name) => name !== "app" && existsSync(join$1(android, name, "build", "generated", "res"))).toSorted()];
 }
 function findGeneratedResDir(root, variant, { list = safeList } = {}) {
 	for (const module of androidModuleDirs(root, { list })) {
-		const base = join(root, "android", module, "build", "generated", "res");
+		const base = join$1(root, "android", module, "build", "generated", "res");
 		const names = list(base);
 		if (names.length === 0) continue;
-		const picked = pickGeneratedResDir(names, variant, names.includes("react") ? list(join(base, "react")) : []);
-		if (picked) return join(base, ...picked.split("/"));
+		const picked = pickGeneratedResDir(names, variant, names.includes("react") ? list(join$1(base, "react")) : []);
+		if (picked) return join$1(base, ...picked.split("/"));
 	}
 	return null;
 }
@@ -157,7 +158,7 @@ function safeList(dir) {
 //#endregion
 //#region src/cache/build-cache.ts
 function entryDir(platform, key, root = sharedBuildCache()) {
-	return join$1(root, platform, key);
+	return join(root, platform, key);
 }
 const FINGERPRINT_PLATFORMS = /* @__PURE__ */ new Set(["ios", "android"]);
 /**
@@ -209,17 +210,17 @@ function storeBuild(platform, key, buildPath, rootOrOptions = {}) {
 		overwrite: Boolean(options.overwrite),
 		writeMetadata: (staging) => {
 			if (Array.isArray(options.sources)) try {
-				writeFileSync$1(join$1(staging, SOURCES_FILE), JSON.stringify(options.sources));
+				writeFileSync$1(join(staging, SOURCES_FILE), JSON.stringify(options.sources));
 			} catch {}
 			if (options.assetManifest) try {
-				writeFileSync$1(join$1(staging, ASSET_MANIFEST_FILE), JSON.stringify(options.assetManifest));
+				writeFileSync$1(join(staging, ASSET_MANIFEST_FILE), JSON.stringify(options.assetManifest));
 			} catch {}
 		}
 	});
 }
 const PROVIDER_DOWNLOAD_DIR = "cache-provider";
 function providerDownloadPath(workspacePath) {
-	return join$1(workspacePath, PROVIDER_DOWNLOAD_DIR);
+	return join(workspacePath, PROVIDER_DOWNLOAD_DIR);
 }
 /**
 * Empties and registers the scratch directory a provider downloads into. It is
@@ -275,7 +276,7 @@ function providerUploadOutcome(result, name) {
 const SOURCES_FILE = "fingerprint-sources.json";
 function storedSources(platform, key, root = sharedBuildCache()) {
 	try {
-		const parsed = JSON.parse(readFileSync$1(join$1(entryDir(platform, key, root), SOURCES_FILE), "utf-8"));
+		const parsed = JSON.parse(readFileSync$1(join(entryDir(platform, key, root), SOURCES_FILE), "utf-8"));
 		return Array.isArray(parsed) ? parsed : null;
 	} catch {
 		return null;
@@ -283,7 +284,7 @@ function storedSources(platform, key, root = sharedBuildCache()) {
 }
 function storedAssetManifest(platform, key, root = sharedBuildCache()) {
 	try {
-		return parseAssetManifest(readFileSync$1(join$1(entryDir(platform, key, root), ASSET_MANIFEST_FILE), "utf-8"));
+		return parseAssetManifest(readFileSync$1(join(entryDir(platform, key, root), ASSET_MANIFEST_FILE), "utf-8"));
 	} catch {
 		return null;
 	}
@@ -435,10 +436,10 @@ function segment(value) {
 	return String(value).replace(/[^A-Za-z0-9._-]+/g, "-").replace(/^\.+/, "") || "unknown";
 }
 function buildLocksDir() {
-	return join(getConfigDir(), "build-locks");
+	return join$1(getConfigDir(), "build-locks");
 }
 function buildLockPath(platform, key) {
-	return join(buildLocksDir(), `${segment(platform)}-${segment(key)}${LOCK_SUFFIX}`);
+	return join$1(buildLocksDir(), `${segment(platform)}-${segment(key)}${LOCK_SUFFIX}`);
 }
 function label(platform) {
 	return `${platform} build`;
@@ -482,6 +483,7 @@ function acquireBuildLock({ platform, key, root = null, logFile = null }) {
 			},
 			claim: attempt.acquired
 		};
+		declareSpawnsOn(attempt.acquired);
 		return reaped ? {
 			...handle,
 			tookOver: toRecord(reaped)
@@ -495,6 +497,7 @@ function acquireBuildLock({ platform, key, root = null, logFile = null }) {
 	} : { path };
 }
 function releaseBuildLock(handle) {
+	stopDeclaringSpawnsOn(handle?.claim);
 	return (0, ownership_claim_exports.releaseClaim)(handle?.claim);
 }
 function listBuildLocks() {
@@ -508,7 +511,7 @@ function listBuildLocks() {
 	const locks = [];
 	for (const name of names) {
 		if (!name.endsWith(LOCK_SUFFIX)) continue;
-		const path = join(dir, name);
+		const path = join$1(dir, name);
 		try {
 			if (!statSync(path).isDirectory()) continue;
 		} catch {
@@ -600,5 +603,98 @@ async function waitForBuild({ platform, key, resolve = resolveBuild, intervalMs
 		await sleep(intervalMs);
 	}
 }
+async function waitForSharedBuild({ platform, key, fingerprint, root, logFile, command, acquire, wait, now, phase, warn, out }) {
+	const waitStarted = now();
+	let failedHolder;
+	let released = null;
+	for (;;) {
+		let attempt = null;
+		try {
+			attempt = acquire({
+				platform,
+				key,
+				root,
+				logFile
+			});
+		} catch (err) {
+			const refusal = (0, ownership_claim_exports.claimFailure)(err, command);
+			if (refusal) return { refusal };
+			warn(`could not take the build lock: ${err?.message || err}; building anyway`);
+		}
+		if (attempt?.acquired) {
+			const previous = attempt.tookOver ?? failedHolder;
+			if (previous) warn(takeoverLine(previous));
+			return {
+				refusal: null,
+				lock: attempt,
+				hit: null,
+				released
+			};
+		}
+		if (!attempt?.held) return {
+			refusal: null,
+			lock: null,
+			hit: null,
+			released
+		};
+		released = null;
+		const holder = attempt.held;
+		const who = holder.projectRoot || "another workspace";
+		phase(`${who} is already building ${shortHash(fingerprint)} (pid ${holder.pid})${holder.logFile ? ` -- tail ${holder.logFile}` : ""} -- stim guide lifecycle concurrency`);
+		let waited;
+		try {
+			const ceilingMs = WAIT_CEILING_MS - (now() - waitStarted);
+			if (ceilingMs <= 0) throw Object.assign(/* @__PURE__ */ new Error(`Waited ${formatDuration(now() - waitStarted)} for shared builds without an artifact; ${who} (pid ${holder.pid}) holds ${attempt.path}.`), {
+				code: "STIM_BUILD_WAIT_TIMEOUT",
+				lockPath: attempt.path
+			});
+			waited = await wait({
+				platform,
+				key,
+				out,
+				ceilingMs
+			});
+		} catch (err) {
+			const refusal = (0, ownership_claim_exports.claimFailure)(err, command);
+			if (refusal) return { refusal };
+			const timeout = err;
+			if (timeout?.code !== "STIM_BUILD_WAIT_TIMEOUT") throw err;
+			return { refusal: {
+				code: "STIM_BUILD_WAIT_TIMEOUT",
+				message: timeout.message,
+				remedy: `Check pid ${holder.pid}; if it is not really building, remove ${timeout.lockPath} and run \`${command}\` again.`
+			} };
+		}
+		if (waited.hit) {
+			phase(`waited ${formatDuration(waited.waitedMs)} for ${who}'s build -> installed from cache -- stim guide lifecycle concurrency`);
+			return {
+				refusal: null,
+				lock: null,
+				hit: {
+					path: waited.hit,
+					waited: {
+						pid: holder.pid,
+						ms: waited.waitedMs
+					}
+				},
+				released
+			};
+		}
+		if (waited.lockReleased) {
+			failedHolder = void 0;
+			released = {
+				facts: {
+					pid: holder.pid,
+					ms: waited.waitedMs
+				},
+				who
+			};
+			phase(`${who}'s build lock was released; rechecking this workspace before building`);
+		} else {
+			warn(`${who}'s build ended without an artifact (${waited.builderFailed}); retrying the build lock`);
+			failedHolder = holder;
+		}
+	}
+}
 //#endregion
-export { untrackedNativeFiles as C, readAssetManifest as D, compareAssetManifests as E, untrackedMissLine as S, captureAssetManifest as T, providerUploadOutcome as _, segment as a, storeBuild as b, buildCacheKey as c, filesystemBuildCapability as d, fingerprintDiffRecord as f, providerDownloadPath as g, prepareProviderDownloadDir as h, releaseBuildLock as i, describeFingerprintMiss as l, fingerprintProject as m, acquireBuildLock as n, takeoverLine as o, fingerprintDiffSuffix as p, listBuildLocks as r, waitForBuild as s, WAIT_CEILING_MS as t, diffFingerprintSources as u, refingerprintAfterMutation as v, assetDiffReason as w, storedAssetManifest as x, resolveBuild as y };
+export { assetDiffReason as C, readAssetManifest as E, untrackedNativeFiles as S, compareAssetManifests as T, refingerprintAfterMutation as _, waitForBuild as a, storedAssetManifest as b, describeFingerprintMiss as c, fingerprintDiffRecord as d, fingerprintDiffSuffix as f, providerUploadOutcome as g, providerDownloadPath as h, segment as i, diffFingerprintSources as l, prepareProviderDownloadDir as m, listBuildLocks as n, waitForSharedBuild as o, fingerprintProject as p, releaseBuildLock as r, buildCacheKey as s, acquireBuildLock as t, filesystemBuildCapability as u, resolveBuild as v, captureAssetManifest as w, untrackedMissLine as x, storeBuild as y };

package/dist/build-progress-CVqkfPC6.mjs

@@ -0,0 +1,188 @@
+import { k as ownership_claim_exports } from "./config-Cp9lM3wX.mjs";
+import { a as updateWorkspaceState, t as clearWorkspaceStateKey } from "./workspace-state-DF2gCFhx.mjs";
+import { a as formatElapsed, u as plural } from "./command-output-gByVmIjy.mjs";
+//#region src/engine/build-progress.ts
+const BUILD_PHASES = [
+	"prepare",
+	"cache-lookup",
+	"wait",
+	"prebuild",
+	"pods",
+	"compile",
+	"install",
+	"launch"
+];
+const ACTIVE_BUILD_KEY = "activeBuild";
+const NO_BUILD_PROGRESS = {
+	step: () => {},
+	durations: () => ({}),
+	clear: () => {}
+};
+const COLD_PHASES = [
+	"prebuild",
+	"pods",
+	"compile"
+];
+const DEVICE_PHASES = ["install", "launch"];
+function startBuildProgress({ root, platform, slot, claim, now = Date.now, note = () => {} }) {
+	const startedAt = new Date(now()).toISOString();
+	const record = {
+		platform,
+		slot,
+		startedAt,
+		phase: "prepare",
+		phaseStartedAt: startedAt,
+		phases: [{
+			phase: "prepare",
+			startedAt
+		}],
+		claim: {
+			root: claim.root,
+			path: claim.path,
+			claimId: claim.claimId,
+			pid: claim.owner.pid
+		}
+	};
+	let warned = false;
+	const guard = (fn) => {
+		try {
+			fn();
+		} catch (error) {
+			if (warned) return;
+			warned = true;
+			note(`Build progress could not be recorded in the workspace state: ${error?.message || error}`);
+		}
+	};
+	const write = () => guard(() => updateWorkspaceState(root, (state) => ({
+		...state,
+		[ACTIVE_BUILD_KEY]: record
+	})));
+	write();
+	return {
+		step(phase) {
+			if (phase === record.phase) return;
+			const at = new Date(now()).toISOString();
+			record.phase = phase;
+			record.phaseStartedAt = at;
+			record.phases.push({
+				phase,
+				startedAt: at
+			});
+			write();
+		},
+		durations() {
+			return phaseDurations(record.phases, now());
+		},
+		clear() {
+			guard(() => {
+				clearWorkspaceStateKey(root, ACTIVE_BUILD_KEY, (value) => parseActiveBuild(value)?.claim.claimId === record.claim.claimId);
+			});
+		}
+	};
+}
+function phaseDurations(phases, now) {
+	const out = {};
+	phases.forEach(({ phase, startedAt }, index) => {
+		const start = Date.parse(startedAt);
+		const next = phases[index + 1];
+		const end = next ? Date.parse(next.startedAt) : now;
+		if (!Number.isFinite(start) || !Number.isFinite(end)) return;
+		out[phase] = (out[phase] ?? 0) + Math.max(0, end - start);
+	});
+	return out;
+}
+function parseActiveBuild(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+	const record = value;
+	const claim = record.claim;
+	if (record.platform !== "ios" && record.platform !== "android") return null;
+	if (!isPhase(record.phase)) return null;
+	if (typeof record.startedAt !== "string" || typeof record.phaseStartedAt !== "string") return null;
+	if (!claim || typeof claim.root !== "string" || typeof claim.claimId !== "string") return null;
+	const phases = Array.isArray(record.phases) ? record.phases.filter((entry) => isPhase(entry?.phase) && typeof entry?.startedAt === "string") : [];
+	return {
+		platform: record.platform,
+		slot: typeof record.slot === "string" ? record.slot : "default",
+		startedAt: record.startedAt,
+		phase: record.phase,
+		phaseStartedAt: record.phaseStartedAt,
+		phases,
+		claim: {
+			root: claim.root,
+			path: typeof claim.path === "string" ? claim.path : "",
+			claimId: claim.claimId,
+			pid: typeof claim.pid === "number" ? claim.pid : 0
+		}
+	};
+}
+function isPhase(value) {
+	return BUILD_PHASES.includes(value);
+}
+function activeBuildState(claim, survey = (0, ownership_claim_exports.readClaimSet)(claim.root)) {
+	if (survey.live.some((holder) => holder.claimId === claim.claimId)) return "running";
+	if (survey.dead.some((holder) => holder.claimId === claim.claimId)) return "stale";
+	return survey.unresolved.length ? "unknown" : "stale";
+}
+function liveOutcome(record) {
+	const seen = new Set(record.phases.map((entry) => entry.phase));
+	if (COLD_PHASES.some((phase) => seen.has(phase))) return "cold";
+	if (DEVICE_PHASES.some((phase) => seen.has(phase))) return "hit";
+	return null;
+}
+function median(values) {
+	if (!values.length) return null;
+	const sorted = values.toSorted((a, b) => a - b);
+	const mid = Math.floor(sorted.length / 2);
+	return sorted.length % 2 ? sorted[mid] : Math.round((sorted[mid - 1] + sorted[mid]) / 2);
+}
+function estimateBuild(history, platform, known, phase) {
+	const lists = history?.[platform];
+	const outcome = known ?? latestOutcome(lists);
+	const samples = outcome && lists?.[outcome] || [];
+	const phaseSamples = samples.flatMap((sample) => phase in sample.phases ? [sample.phases[phase]] : []);
+	return {
+		outcome,
+		expectedMs: median(samples.map((sample) => sample.durationMs)),
+		expectedPhaseMs: median(phaseSamples),
+		basis: samples.length
+	};
+}
+function latestOutcome(lists) {
+	let latest = null;
+	for (const outcome of ["hit", "cold"]) {
+		const last = lists?.[outcome]?.at(-1);
+		const at = last ? Date.parse(last.at) : NaN;
+		if (Number.isFinite(at) && (!latest || at > latest.at)) latest = {
+			outcome,
+			at
+		};
+	}
+	return latest?.outcome ?? null;
+}
+function buildReport(record, { state, history }) {
+	return {
+		platform: record.platform,
+		slot: record.slot,
+		state,
+		phase: record.phase,
+		startedAt: record.startedAt,
+		phaseStartedAt: record.phaseStartedAt,
+		...estimateBuild(history, record.platform, liveOutcome(record), record.phase)
+	};
+}
+function remainingText(remainingMs) {
+	return remainingMs < 6e4 ? "under a minute left" : `about ${Math.ceil(remainingMs / 6e4)} min left`;
+}
+function buildStatusLine(report, now) {
+	const slot = report.slot === "default" ? "" : ` [${report.slot}]`;
+	if (report.state === "stale") return `build: stale ${report.platform}${slot} record from ${report.startedAt} (its run is gone; the next run replaces it)`;
+	const elapsedMs = Math.max(0, now - Date.parse(report.startedAt));
+	const head = `build: ${report.platform}${slot} ${report.phase}, ${formatElapsed(elapsedMs)} elapsed`;
+	if (report.state === "unknown") return `${head} (its native-run claim cannot be resolved, so it may not be running)`;
+	if (report.expectedMs === null) return head;
+	const basis = `median of ${plural(report.basis, `${report.outcome} run`)}`;
+	const remainingMs = report.expectedMs - elapsedMs;
+	return remainingMs > 0 ? `${head} -- ${remainingText(remainingMs)} (${basis})` : `${head} (usually ~${formatElapsed(report.expectedMs)}, ${basis})`;
+}
+//#endregion
+export { buildStatusLine as a, buildReport as i, NO_BUILD_PROGRESS as n, parseActiveBuild as o, activeBuildState as r, startBuildProgress as s, ACTIVE_BUILD_KEY as t };

package/dist/{cache-manifest-CYJi8-Hx.mjs → cache-manifest-Dg7OnMrp.mjs}

@@ -1,8 +1,8 @@
-import { u as getConfigDir } from "./config-B7iyKWkL.mjs";
+import { u as getConfigDir } from "./config-Cp9lM3wX.mjs";
 import { existsSync } from "fs";
-import { homedir } from "os";
-import { join, resolve } from "path";
+import { isAbsolute, join, resolve } from "path";
 import { readCacheManifest, updateCacheManifest } from "@stim-cli/core";
+import { homedir } from "os";
 //#region src/cache/cache-manifest.ts
 function manifestPath() {
 	return join(getConfigDir(), "caches.json");
@@ -53,7 +53,7 @@ function unregister(dir, path = manifestPath()) {
 	return removed;
 }
 function registeredCaches(path = manifestPath()) {
-	return readManifest(path).caches.filter((c) => c.dir && existsSync(c.dir)).map((c) => ({
+	return readManifest(path).caches.filter((c) => isAbsolute(c.dir) && existsSync(c.dir)).map((c) => ({
 		name: c.name,
 		dir: c.dir,
 		prune: c.prune === "atomic" ? "atomic" : "entries",

package/dist/cache-manifest.mjs

@@ -1,2 +1,2 @@
-import { a as unregister, i as registeredCaches, n as readManifest, r as register, t as manifestPath } from "./cache-manifest-CYJi8-Hx.mjs";
+import { a as unregister, i as registeredCaches, n as readManifest, r as register, t as manifestPath } from "./cache-manifest-Dg7OnMrp.mjs";
 export { manifestPath, readManifest, register, registeredCaches, unregister };

package/dist/cli.mjs

@@ -1,27 +1,30 @@
 #!/usr/bin/env node
+import { _ as refuseRelativeStimPaths } from "./config-Cp9lM3wX.mjs";
 import { readFileSync } from "node:fs";
 import { Command } from "commander";
 //#region bin/cli.ts
 const commands = /* @__PURE__ */ new Map([
-	["doctor", () => import("./doctor-BMt156qe.mjs")],
-	["worktree", () => import("./worktree-CFLA-6MX.mjs")],
-	["start", () => import("./start-CmxtOKjU.mjs")],
-	["ports", () => import("./ports-BIbJaKNW.mjs")],
-	["stop", () => import("./stop-B1kOpYei.mjs")],
-	["ios", () => import("./ios-BP04pY5f.mjs")],
-	["android", () => import("./android-BRgBYzU0.mjs")],
-	["reload", () => import("./reload-BdypPbjM.mjs")],
-	["device", () => import("./device-RdujjHLB.mjs")],
-	["logs", () => import("./logs-CakdBTtm.mjs")],
-	["status", () => import("./status-DdkLki47.mjs")],
-	["stats", () => import("./stats-CLg5RuDS.mjs")],
-	["gc", () => import("./gc-v2YcoJvm.mjs")],
-	["guide", () => import("./guide-BTAlD1_y.mjs")]
+	["doctor", () => import("./doctor-B_Ei3bZu.mjs")],
+	["worktree", () => import("./worktree-DKhSF0UX.mjs")],
+	["start", () => import("./start-DYkkKF0s.mjs")],
+	["ports", () => import("./ports-BNKoWVWZ.mjs")],
+	["stop", () => import("./stop-T1R-cZRz.mjs")],
+	["ios", () => import("./ios-BzUJWk1K.mjs")],
+	["android", () => import("./android-BPGizezh.mjs")],
+	["reload", () => import("./reload-ZNJUo1pl.mjs")],
+	["device", () => import("./device-D4U-xLty.mjs")],
+	["logs", () => import("./logs-CI9NQSK7.mjs")],
+	["settings", () => import("./settings-BKNh5rl4.mjs")],
+	["status", () => import("./status-S6ehL4Ui.mjs")],
+	["stats", () => import("./stats-B63-JVAY.mjs")],
+	["gc", () => import("./gc-Ckw8RQHi.mjs")],
+	["guide", () => import("./guide-BiAbhs1J.mjs")]
 ]);
 const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
 const program = new Command();
 program.name("stim").description("Isolated React Native dev environments per project/worktree").version(pkg.version);
 try {
+	refuseRelativeStimPaths();
 	const first = process.argv[2];
 	const loadCommand = commands.get((first === "help" ? process.argv[3] : first) ?? "");
 	if (loadCommand) (await loadCommand()).default(program, pkg.version);
@@ -31,11 +34,11 @@ try {
 	}
 	await program.parseAsync();
 } catch (err) {
-	if (err?.code === "STIM_CONFIG_CORRUPT") {
-		console.error(err.message);
-		process.exit(1);
-	}
-	throw err;
+	const code = err?.code;
+	const message = err instanceof Error ? err.message : String(err);
+	if (typeof code === "string" && code.startsWith("STIM_")) console.error(`${code}: ${message}`);
+	else console.error(`Unexpected error: ${message.replace(/\.$/, "")}. Report it at ${pkg.bugs.url}`);
+	process.exit(1);
 }
 //#endregion
 export {};

package/dist/collector-run.d.mts

@@ -12,6 +12,8 @@ interface ExecOptions {
 interface Executor {
   run(cmd: string, opts?: ExecOptions): string;
   runFile(file: string, args?: string[], opts?: ExecOptions): string;
+  /** `runFile` without blocking the event loop; rejects where `runFile` throws. */
+  runFileAsync(file: string, args?: string[], opts?: ExecOptions): Promise<string>;
   runQuiet(cmd: string, opts?: ExecOptions): string | null;
   runFileQuiet(file: string, args?: string[], opts?: ExecOptions): string | null;
   spawn(cmd: string, args?: readonly string[], opts?: SpawnOptions): ChildProcess;

package/dist/collector-run.mjs

@@ -1,12 +1,13 @@
-import { t as getExecutor } from "./exec-B29XNuhP.mjs";
-import { B as validateDeviceSlot, F as deviceSlotKey, w as process_identity_exports } from "./config-B7iyKWkL.mjs";
-import { r as createNdjsonWriter } from "./ndjson-BZwI1NBv.mjs";
-import { _ as workspaceLogsDir } from "./workspace-state-BT5E3SA2.mjs";
-import { t as createLineReader } from "./process-output-Dl5uKE03.mjs";
-import { i as startIosDeviceConsole, r as parseDeviceConsoleLine } from "./ios-device-CFXA46ez.mjs";
-import { a as unregisterCollector, i as registerCollector, r as readCollectors, t as collectorProcessTitle } from "./ownership-Cp52QAK1.mjs";
-import { a as watchAppPid, i as waitForAppPid, n as parseLogcatLine, r as startAndroidLogcat, t as androidClockOffset } from "./android-DeYdjjBP.mjs";
+import { D as process_identity_exports, H as deviceSlotKey, J as validateDeviceSlot } from "./config-Cp9lM3wX.mjs";
+import { t as getExecutor } from "./exec-jIAlgilk.mjs";
+import { r as createNdjsonWriter } from "./ndjson-9uFNRwfe.mjs";
+import { b as workspaceLogsDir } from "./workspace-state-DF2gCFhx.mjs";
+import { t as createLineReader } from "./process-output-Fpl8PYi8.mjs";
+import { a as startIosDeviceConsole, i as parseDeviceConsoleLine } from "./ios-device-DPsSm0v_.mjs";
+import { a as unregisterCollector, i as registerCollector, r as readCollectors, t as collectorProcessTitle } from "./ownership-D15Op8vN.mjs";
+import { a as watchAppPid, i as waitForAppPid, n as parseLogcatLine, r as startAndroidLogcat, t as androidClockOffset } from "./android-DEgo4oCo.mjs";
 import { existsSync } from "node:fs";
+import { LOG_ROTATE_BYTES } from "@stim-cli/core";
 import { isAbsolute, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 //#region src/collector/ios.ts
@@ -299,7 +300,7 @@ async function runCollector({ slot = "default", platform, root, udid = null, app
 		slot,
 		deviceId: udid ?? serial
 	};
-	const writer = createNdjsonWriter(join(workspaceLogsDir(root), "device.ndjson"));
+	const writer = createNdjsonWriter(join(workspaceLogsDir(root), "device.ndjson"), { maxBytes: LOG_ROTATE_BYTES });
 	const startedAt = new Date(now()).toISOString();
 	const processToken = (0, process_identity_exports.captureProcessToken)(process.pid);
 	if (!processToken) {

package/dist/{command-output-B3ycpsYv.mjs → command-output-gByVmIjy.mjs}

@@ -1,5 +1,7 @@
-import { n as stripAnsi } from "./process-output-Dl5uKE03.mjs";
+import { t as NO_PROJECT_REFUSAL } from "./project-DS112DYB.mjs";
+import { n as stripAnsi } from "./process-output-Fpl8PYi8.mjs";
 import { quotedPath } from "@stim-cli/core";
+import chalk from "chalk";
 //#region src/diagnostics/launch-error-preview.ts
 function framePriority(frame, root) {
 	const normalized = frame.replaceAll("\\", "/");
@@ -245,6 +247,13 @@ function releasedLeaseFact(lease) {
 function phaseLine(label, text) {
 	return `  ${String(label).padEnd(LABEL_WIDTH)} ${text}`;
 }
+function refuseNoProject({ json }) {
+	const { code, message, remedy } = NO_PROJECT_REFUSAL;
+	console.error(chalk.red(phaseLine("error", `${code}: ${message}`)));
+	console.error(phaseLine("remedy", remedy));
+	if (json) console.log(JSON.stringify(NO_PROJECT_REFUSAL));
+	process.exitCode = 1;
+}
 function shortUdid(udid) {
 	const text = String(udid ?? "");
 	return text.length > 4 ? `${text.slice(0, 4)}..` : text;
@@ -283,4 +292,4 @@ function stepTimer(now = Date.now) {
 	return () => `(${formatDuration(elapsed())})`;
 }
 //#endregion
-export { launchErrorPreview as _, formatElapsed as a, launchErrorReport as c, quotedPath as d, releasedLeaseFact as f, stepTimer as g, stepClock as h, formatDuration as i, phaseLine as l, shortUdid as m, appReadinessMessage as n, formatLongDuration as o, shortHash as p, clockTime as r, isAppLaunchError as s, SLOW_STEP_MS as t, plural as u };
+export { stepTimer as _, formatElapsed as a, launchErrorReport as c, quotedPath as d, refuseNoProject as f, stepClock as g, shortUdid as h, formatDuration as i, phaseLine as l, shortHash as m, appReadinessMessage as n, formatLongDuration as o, releasedLeaseFact as p, clockTime as r, isAppLaunchError as s, SLOW_STEP_MS as t, plural as u, launchErrorPreview as v };