stim 1.2.0 → 1.3.1

package/dist/{ios-D1h1Di39.mjs → ios-Deh5js5V.mjs}

@@ -87,25 +87,22 @@ const BOOT_STATE_LIST_TIMEOUT_MS = 3e4;
 function iosSimulatorFailureAdvice(exec = getExecutor()) {
 	return hostMemoryPressureAdvice(readHostMemoryPressure(exec)) ?? "The simulator may be unresponsive. Check Activity Monitor for memory pressure and free host memory before retrying.";
 }
-function bootstatusTimeout(udid) {
-	const e = /* @__PURE__ */ new Error(`xcrun simctl bootstatus ${udid} -b timed out`);
+function bootstatusTimeout(command) {
+	const e = /* @__PURE__ */ new Error(`${command} timed out`);
 	e.code = "ETIMEDOUT";
 	return e;
 }
-async function awaitBootstatus(udid, attemptMs) {
+async function awaitBootCommand(args, attemptMs, onLine) {
+	const command = `xcrun ${args.join(" ")}`;
 	const lines = [];
 	const reader = createLineReader((raw) => {
 		const line = stripAnsi(raw).trim();
 		if (!line) return;
+		onLine(line);
 		lines.push(line);
 		if (lines.length > 10) lines.shift();
 	});
-	const child = getExecutor().spawn("xcrun", [
-		"simctl",
-		"bootstatus",
-		udid,
-		"-b"
-	], { stdio: [
+	const child = getExecutor().spawn("xcrun", args, { stdio: [
 		"ignore",
 		"pipe",
 		"pipe"
@@ -132,48 +129,89 @@ async function awaitBootstatus(udid, attemptMs) {
 			child.stdout?.destroy?.();
 			child.stderr?.destroy?.();
 			child.unref();
-			throw new Error(`Timed out waiting for simctl bootstatus ${udid}; its process could not be confirmed stopped. Inspect pid ${child.pid ?? "unknown"} before retrying.`);
+			throw new Error(`Timed out waiting for ${command}; its process could not be confirmed stopped. Inspect pid ${child.pid ?? "unknown"} before retrying.`);
 		}
-		throw bootstatusTimeout(udid);
+		throw bootstatusTimeout(command);
 	}
 	if (result.error) throw result.error;
 	if (result.code === 0) return;
 	const detail = lines.length ? `: ${lines.join(" | ")}` : "";
-	throw new Error(`xcrun simctl bootstatus ${udid} -b failed with exit code ${result.code ?? "unknown"}${detail}`);
+	throw new Error(`${command} failed with exit code ${result.code ?? "unknown"}${detail}`);
 }
-async function bootIosSim(udid, { timeoutMs = IOS_BOOT_TIMEOUT_MS, attemptMs = BOOTSTATUS_ATTEMPT_MS } = {}) {
+async function bootIosSim(udid, { timeoutMs = IOS_BOOT_TIMEOUT_MS, attemptMs = BOOTSTATUS_ATTEMPT_MS, label = udid, out = () => {} } = {}) {
 	const exec = getExecutor();
-	const deadline = Date.now() + timeoutMs;
+	const started = Date.now();
+	const deadline = started + timeoutMs;
+	let worst = null;
+	let unknown = 0;
+	let sampledAt = started;
+	let longestGapMs = 0;
+	let phase = "requesting boot";
+	const ranks = {
+		normal: 0,
+		warning: 1,
+		critical: 2
+	};
+	const sample = () => {
+		const now = Date.now();
+		longestGapMs = Math.max(longestGapMs, now - sampledAt);
+		sampledAt = now;
+		const pressure = readHostMemoryPressure(exec);
+		if (pressure === null) unknown++;
+		else if (worst === null || ranks[pressure] > ranks[worst]) worst = pressure;
+		return pressure;
+	};
+	const recovery = "Stop unused slots in workspaces you own with `stim stop --slot <name>`, reduce concurrent builds, and retry after pressure falls. Ask before closing other agents' devices or apps. Repeated reboots under unchanged pressure may stall again.";
+	const coverage = () => longestGapMs > 3e4 ? ` Observations were delayed: longest gap ${Math.round(longestGapMs / 1e3)}s. Pressure during gaps is unobserved; blocking CLI work can also delay progress and timeout handling.` : "";
+	const report = () => {
+		const pressure = sample();
+		out(`Simulator ${label} is still booting after ${Math.round((Date.now() - started) / 1e3)}s. Last boot output: ${phase}. Memory pressure: ${pressure ?? "unknown"}; highest observed: ${worst ?? "unknown"}. Boot deadline: ${Math.round(timeoutMs / 1e3)}s.${coverage()}${pressure === "warning" || pressure === "critical" ? ` Boot may be delayed or stalled. ${recovery}` : ""}`);
+	};
+	const onLine = (line) => {
+		phase = line.slice(0, 240);
+	};
+	sample();
+	const monitor = setInterval(report, 15e3);
+	monitor.unref();
 	try {
-		exec.runFile("xcrun", [
-			"simctl",
-			"boot",
-			udid
-		], {
-			timeoutMs,
-			killSignal: "SIGKILL"
-		});
-	} catch (e) {
-		if (!String(e?.message || e).includes("Booted")) throw e;
-	}
-	for (;;) {
-		const remaining = deadline - Date.now();
-		if (remaining > 0) try {
-			await awaitBootstatus(udid, Math.min(Math.max(remaining, BOOTSTATUS_ATTEMPT_FLOOR_MS), attemptMs));
-			break;
+		try {
+			await awaitBootCommand([
+				"simctl",
+				"boot",
+				udid
+			], Math.max(1, deadline - Date.now()), onLine);
+			phase = "waiting for boot completion";
 		} catch (e) {
-			if (e?.code !== "ETIMEDOUT") throw e;
+			if (!String(e?.message || e).includes("Booted")) throw e;
 		}
-		let state;
-		try {
-			state = listAllIosSims({ timeoutMs: BOOT_STATE_LIST_TIMEOUT_MS }).find((s) => s.udid === udid)?.state ?? null;
-		} catch {
-			state = void 0;
+		for (;;) {
+			const remaining = deadline - Date.now();
+			if (remaining > 0) try {
+				await awaitBootCommand([
+					"simctl",
+					"bootstatus",
+					udid,
+					"-b"
+				], Math.min(Math.max(remaining, BOOTSTATUS_ATTEMPT_FLOOR_MS), attemptMs), onLine);
+				break;
+			} catch (e) {
+				if (e?.code !== "ETIMEDOUT") throw e;
+			}
+			let state;
+			try {
+				state = listAllIosSims({ timeoutMs: BOOT_STATE_LIST_TIMEOUT_MS }).find((s) => s.udid === udid)?.state ?? null;
+			} catch {
+				state = void 0;
+			}
+			const waited = Math.round((timeoutMs - Math.max(0, deadline - Date.now())) / 1e3);
+			if (state !== "Booting" && state !== "Booted" && state !== void 0) throw new Error(`Simulator ${udid} reports "${state ?? "missing"}" after ${waited}s of boot wait.`);
+			if (deadline - Date.now() <= 0) throw new Error(`Simulator ${udid} did not finish booting within ${Math.round(timeoutMs / 1e3)}s.`);
 		}
-		if (state === "Booted") break;
-		const waited = Math.round((timeoutMs - Math.max(0, deadline - Date.now())) / 1e3);
-		if (state !== "Booting" && state !== void 0) throw new Error(`Simulator ${udid} reports "${state ?? "missing"}" after ${waited}s of boot wait.`);
-		if (deadline - Date.now() <= 0) throw new Error(`Simulator ${udid} did not finish booting within ${Math.round(timeoutMs / 1e3)}s.`);
+	} catch (error) {
+		sample();
+		throw new Error(`${error?.message || error} Last boot output: ${phase}. Highest observed memory pressure: ${worst ?? "unknown"}; unavailable samples: ${unknown}.${coverage()} ${recovery} These observations do not establish an OOM crash.`, { cause: error });
+	} finally {
+		clearInterval(monitor);
 	}
 	exec.runFileQuiet("open", ["-a", "Simulator"], {
 		timeoutMs: 5e3,

package/dist/{ios-device-xNt0Lg6v.mjs → ios-device-CWOM_S44.mjs}

@@ -1,5 +1,5 @@
 import { t as getExecutor } from "./exec-CyylIdq9.mjs";
-import { r as INSTALL_ERROR } from "./app-install-NFxUahnH.mjs";
+import { r as INSTALL_ERROR } from "./app-install-DIp9riNx.mjs";
 import { mkdtempSync, readFileSync, rmSync } from "node:fs";
 import { join } from "node:path";
 import { tmpdir } from "node:os";

package/dist/{logs-DcX9AvRF.mjs → logs-CAdwW6c2.mjs}

@@ -1,9 +1,12 @@
-import { n as SOURCES, t as LEVELS } from "./ndjson-DcAtEx_K.mjs";
-import { D as workspaceLogsDir, p as readWorkspaceState } from "./state-CZ-ER-8d.mjs";
-import { a as findProjectRoot } from "./project-BBTVABUz.mjs";
+import { V as validateDeviceSlot, g as loadConfig, h as isPathPrefix } from "./config-CcefMY2Q.mjs";
+import { n as SOURCES, t as LEVELS } from "./ndjson-BZwI1NBv.mjs";
+import { D as workspaceLogsDir, p as readWorkspaceState } from "./state-B3XA2wp2.mjs";
+import { a as findProjectRoot } from "./project-fKmuIaMI.mjs";
 import { _ as launchErrorPreview } from "./command-output-8wHMEde0.mjs";
-import { i as captureWorkspaceCrashes, t as errorDiagnostics } from "./error-diagnostics-Dw8Gn3yw.mjs";
-import { a as followLogs, i as fileSizes, n as buildCriteria, o as parseSince, r as compileGrep, s as queryLogs } from "./logs-query-oqn47Ffx.mjs";
+import { i as captureWorkspaceCrashes, t as errorDiagnostics } from "./error-diagnostics-DwhNBFDU.mjs";
+import { a as followLogs, c as queryLogs, i as fileSizes, n as buildCriteria, o as logFiles, r as compileGrep, s as parseSince } from "./logs-query-Cdp5aaCH.mjs";
+import { realpathSync } from "node:fs";
+import { relative, sep } from "node:path";
 import chalk from "chalk";
 //#region src/commands/logs.ts
 const LEVEL_WIDTH = 5;
@@ -60,6 +63,28 @@ function validateLevel(level) {
 	return { error: `Invalid --level value ${JSON.stringify(level)}. Use one of: ${LEVELS.join(", ")}.` };
 }
 const ERRORS_PRINT_CAP = 20;
+function nearestRegisteredLogsProject(root, candidates) {
+	return candidates.filter((candidate) => candidate !== root && isPathPrefix(root, candidate)).toSorted((a, b) => {
+		const depth = (path) => relative(root, path).split(sep).length;
+		return depth(a) - depth(b) || a.length - b.length || a.localeCompare(b);
+	})[0] ?? null;
+}
+function registeredDescendantWithLogs(root) {
+	const candidates = Object.keys(loadConfig()?.projects ?? {}).flatMap((path) => {
+		try {
+			const canonical = realpathSync(path);
+			return logFiles(workspaceLogsDir(canonical)).length > 0 ? [canonical] : [];
+		} catch {
+			return [];
+		}
+	});
+	return nearestRegisteredLogsProject(root, [...new Set(candidates)]);
+}
+function requireLogsWorkspace(root, dir) {
+	if (logFiles(dir).length > 0) return;
+	const descendant = registeredDescendantWithLogs(root);
+	fail(`STIM_NO_PROJECT: No Stim workspace has run in ${root}.${descendant ? ` The nearest registered app with logs is ${descendant}; run this command from there.` : " Run `stim start`, `stim ios`, or `stim android` in the app first."}`);
+}
 const LEVEL_COLOURS = {
 	debug: chalk.dim,
 	info: chalk.reset,
@@ -68,7 +93,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). Prints and exits; nothing matching is a successful, empty result. Use --follow to stream.").option("--source <s...>", "Only these sources: metro, client, device, build, 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. Add --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). Prints and exits; an existing timeline with nothing matching is a successful, empty result. Use --follow to stream.").option("--slot <name>", "Only records attributed to this device slot", validateDeviceSlot).option("--source <s...>", "Only these sources: metro, client, device, build, 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. Add --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 = findProjectRoot(process.cwd());
 		if (!root) {
 			console.error(chalk.red("Not in a React Native project (no package.json found)."));
@@ -101,7 +126,9 @@ function logsCommand(program) {
 			const compiled = compileGrep(opts.grep);
 			if (compiled.error) fail(compiled.error);
 		}
+		requireLogsWorkspace(root, dir);
 		const query = {
+			slot: opts.slot,
 			dir,
 			sources,
 			minLevel,
@@ -148,6 +175,7 @@ function logsCommand(program) {
 			return;
 		}
 		const criteria = buildCriteria({
+			slot: opts.slot,
 			sources,
 			minLevel,
 			since: opts.since,

package/dist/{logs-query-oqn47Ffx.mjs → logs-query-Cdp5aaCH.mjs}

@@ -1,4 +1,4 @@
-import { a as parseNdjsonLine, i as levelRank, o as parseNdjsonText } from "./ndjson-DcAtEx_K.mjs";
+import { a as parseNdjsonLine, i as levelRank, o as parseNdjsonText } from "./ndjson-BZwI1NBv.mjs";
 import { closeSync, openSync, readFileSync, readSync, readdirSync, statSync } from "fs";
 import { join } from "path";
 import { StringDecoder } from "string_decoder";
@@ -47,6 +47,7 @@ function markerWindow(records) {
 }
 function recordMatches(record, criteria = {}) {
 	if (!record) return false;
+	if (criteria.slot !== void 0 && (record.slot ?? "default") !== criteria.slot) return false;
 	const { sources, minLevel, grep, sinceTs, errorsOnly, markerTs, bundleMarkerTs } = criteria;
 	if (sources && sources.length > 0 && !sources.includes(record.src) && !(criteria.includeNativeCrashes && record.src === "device" && record.event === "native_crash")) return false;
 	if (minLevel && levelRank(record.level) < levelRank(minLevel)) return false;
@@ -71,8 +72,9 @@ function recordMatches(record, criteria = {}) {
 	}
 	return true;
 }
-function buildCriteria({ sources, minLevel, since, grep, errorsOnly, markerTs, bundleMarkerTs, now } = {}) {
+function buildCriteria({ slot, sources, minLevel, since, grep, errorsOnly, markerTs, bundleMarkerTs, now } = {}) {
 	const criteria = {
+		...slot === void 0 ? {} : { slot },
 		errorsOnly: Boolean(errorsOnly),
 		includeNativeCrashes: Boolean(errorsOnly && !sources?.length)
 	};
@@ -160,14 +162,25 @@ function includeBareErrorContext(all, matched, launchTs, sinceTs) {
 	}
 	return sortByTs([...matched, ...renderedContext]);
 }
-function queryLogs({ dir, sources, minLevel, since, grep, tail, errorsOnly, errorContext, now } = {}) {
-	const all = readLogRecords(dir);
+function launchMarkersBySlot(records) {
+	const markers = /* @__PURE__ */ new Map();
+	for (const record of records) {
+		if (record.marker !== true || record.src === "metro") continue;
+		const ts = tsOf(record);
+		const slot = record.slot ?? "default";
+		if (ts !== null && ts > (markers.get(slot) ?? -Infinity)) markers.set(slot, ts);
+	}
+	return markers;
+}
+function queryLogs({ slot, dir, sources, minLevel, since, grep, tail, errorsOnly, errorContext, now } = {}) {
+	const all = readLogRecords(dir).filter((record) => slot === void 0 || (record.slot ?? "default") === slot);
 	if (all.length === 0) return [];
 	const { launchTs, bundleTs } = errorsOnly ? markerWindow(all) : {
 		launchTs: null,
 		bundleTs: null
 	};
 	const criteria = buildCriteria({
+		slot,
 		sources,
 		minLevel,
 		since,
@@ -177,7 +190,11 @@ function queryLogs({ dir, sources, minLevel, since, grep, tail, errorsOnly, erro
 		markerTs: launchTs === null ? void 0 : launchTs,
 		bundleMarkerTs: bundleTs === null ? void 0 : bundleTs
 	});
-	let matched = all.filter((r) => recordMatches(r, criteria));
+	const slotMarkers = launchMarkersBySlot(all);
+	let matched = all.filter((record) => recordMatches(record, {
+		...criteria,
+		markerTs: record.src === "metro" || record.src === "client" ? criteria.markerTs : slotMarkers.get(record.slot ?? "default")
+	}));
 	if (typeof tail === "number" && tail >= 0 && matched.length > tail) matched = matched.slice(matched.length - tail);
 	return errorContext ? includeBareErrorContext(all, attachExpoErrorContext(all, matched), launchTs, criteria.sinceTs) : matched;
 }
@@ -270,4 +287,4 @@ function sortByTs(records) {
 	});
 }
 //#endregion
-export { followLogs as a, readLogRecords as c, fileSizes as i, buildCriteria as n, parseSince as o, compileGrep as r, queryLogs as s, attachExpoErrorContext as t };
+export { followLogs as a, queryLogs as c, fileSizes as i, readLogRecords as l, buildCriteria as n, logFiles as o, compileGrep as r, parseSince as s, attachExpoErrorContext as t };

package/dist/{metro-COslRK_F.mjs → metro-CORqXyTL.mjs}

@@ -1,6 +1,6 @@
 import { t as getExecutor } from "./exec-CyylIdq9.mjs";
-import { E as inspectProcessIdentity, M as isOnMountedVolume, N as listMountedVolumes, g as loadConfig, n as allMetroPorts, r as claimMetroPort, v as removeProject } from "./config-CMtIaTk9.mjs";
-import { p as readWorkspaceState } from "./state-CZ-ER-8d.mjs";
+import { E as inspectProcessIdentity, M as isOnMountedVolume, N as listMountedVolumes, g as loadConfig, n as allMetroPorts, r as claimMetroPort, v as removeProject } from "./config-CcefMY2Q.mjs";
+import { p as readWorkspaceState } from "./state-B3XA2wp2.mjs";
 import { existsSync, readlinkSync, realpathSync } from "fs";
 import { sep } from "path";
 import { request } from "http";

package/dist/{ndjson-DcAtEx_K.mjs → ndjson-BZwI1NBv.mjs}

@@ -49,7 +49,7 @@ function formatNdjsonLine(record) {
 		return null;
 	}
 }
-function createNdjsonWriter(file, { truncate = false } = {}) {
+function createNdjsonWriter(file, { truncate = false, fields = {} } = {}) {
 	let fd = null;
 	let freshFile = truncate;
 	let written = 0;
@@ -66,7 +66,10 @@ function createNdjsonWriter(file, { truncate = false } = {}) {
 			dropped += 1;
 			return false;
 		}
-		const line = formatNdjsonLine(stamp(record));
+		const line = formatNdjsonLine({
+			...stamp(record),
+			...fields
+		});
 		if (line === null) {
 			dropped += 1;
 			lastError = /* @__PURE__ */ new TypeError("record could not be serialized to JSON");

package/dist/{ownership-CGPart6T.mjs → ownership-8O073GIC.mjs}

@@ -1,6 +1,6 @@
-import { D as sameProcessRecord, E as inspectProcessIdentity } from "./config-CMtIaTk9.mjs";
-import { _ as writeWorkspaceState, m as withWorkspaceStateLock, p as readWorkspaceState } from "./state-CZ-ER-8d.mjs";
-import { r as pidExists } from "./metro-COslRK_F.mjs";
+import { D as sameProcessRecord, E as inspectProcessIdentity } from "./config-CcefMY2Q.mjs";
+import { _ as writeWorkspaceState, m as withWorkspaceStateLock, p as readWorkspaceState } from "./state-B3XA2wp2.mjs";
+import { r as pidExists } from "./metro-CORqXyTL.mjs";
 import { realpathSync } from "node:fs";
 //#region src/collector/state.ts
 function collectorRoot(root) {

package/dist/{ownership-CYOyqxUo.mjs → ownership-DXcol4oU.mjs}

@@ -1,8 +1,8 @@
 import { t as getExecutor } from "./exec-CyylIdq9.mjs";
-import { E as inspectProcessIdentity, T as captureProcessToken, u as getConfigDir } from "./config-CMtIaTk9.mjs";
+import { E as inspectProcessIdentity, T as captureProcessToken, u as getConfigDir } from "./config-CcefMY2Q.mjs";
 import { t as createLineReader } from "./process-output-C7IlIzd7.mjs";
-import { r as pidExists } from "./metro-COslRK_F.mjs";
-import { t as withWorkspaceProcessLock } from "./workspace-process-lock-BKfdys1q.mjs";
+import { r as pidExists } from "./metro-CORqXyTL.mjs";
+import { t as withWorkspaceProcessLock } from "./workspace-process-lock-IBj1Towr.mjs";
 import { closeSync, mkdirSync, openSync, readFileSync, unlinkSync } from "node:fs";
 import { createHash, randomUUID } from "node:crypto";
 import { basename, join, resolve, sep } from "node:path";

package/dist/{ownership-claim-7zRxxTfZ.mjs → ownership-claim-BtPtJVmq.mjs}

@@ -1,4 +1,4 @@
-import { E as inspectProcessIdentity, w as captureProcessIdentity } from "./config-CMtIaTk9.mjs";
+import { E as inspectProcessIdentity, w as captureProcessIdentity } from "./config-CcefMY2Q.mjs";
 import { d as quotedPath } from "./command-output-8wHMEde0.mjs";
 import { lstatSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, rmdirSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import { randomUUID } from "node:crypto";
@@ -6,12 +6,6 @@ import { dirname, join } from "node:path";
 //#region src/ownership-claim.ts
 const CLAIM_REFUSED = "STIM_CLAIM_REFUSED";
 const CLAIM_UNAVAILABLE = "STIM_CLAIM_UNAVAILABLE";
-/**
-* The refusal reason for a claim store whose own path is occupied by a file. It names a filesystem
-* state that predates any claim, so a caller that only reads can tell it apart from an unresolvable
-* claim record and fall back to what it did before claims existed.
-*/
-const CLAIM_PATH_NOT_A_DIRECTORY = "the claim path is a file, not a claim directory";
 const EXCLUSIVE_DIR = "exclusive";
 const SHARED_DIR = "shared";
 const CLAIM_SUFFIX = ".claim";
@@ -23,9 +17,9 @@ var ClaimRefusedError = class extends Error {
 	claimPath;
 	reason;
 	removeCommand;
-	constructor({ claimPath, root, reason, label }) {
-		const removeCommand = claimRemoveCommand(claimPath.startsWith(root) ? claimPath : root);
-		super(`Stim cannot tell whether the ${label} claim at ${claimPath} is still held: ${reason}. It will not remove a claim it cannot prove is dead, and it will not wait on one either. If nothing is using it, remove the claim and run the command again:\n  ${removeCommand}`);
+	constructor({ claimPath, root, reason, label, blockingFile = false }) {
+		const removeCommand = blockingFile ? `mv -i ${quotedPath(claimPath)} ${quotedPath(`${claimPath}.stim-backup`)}` : claimRemoveCommand(claimPath.startsWith(root) ? claimPath : root);
+		super(blockingFile ? `The ${label} claim store is blocked by a non-directory path at ${claimPath}. Inspect it before moving it aside; its contents may be unrelated to Stim. Preserve it with the command below (an existing backup prompts before overwriting), then run the command again:\n  ${removeCommand}` : `Stim cannot tell whether the ${label} claim at ${claimPath} is still held: ${reason}. It will not remove a claim it cannot prove is dead, and it will not wait on one either. If nothing is using it, remove the claim and run the command again:\n  ${removeCommand}`);
 		this.claimPath = claimPath;
 		this.reason = reason;
 		this.removeCommand = removeCommand;
@@ -34,9 +28,11 @@ var ClaimRefusedError = class extends Error {
 var ClaimUnavailableError = class extends Error {
 	code = CLAIM_UNAVAILABLE;
 	reason;
-	constructor(reason) {
-		super(`Stim could not record a process identity, so it cannot take an ownership claim: ${reason}.`);
+	remedy;
+	constructor(reason, { claimPath } = {}) {
+		super(claimPath ? `Stim could not write the ownership claim at ${claimPath}: ${reason}.` : `Stim could not record a process identity, so it cannot take an ownership claim: ${reason}.`);
 		this.reason = reason;
+		this.remedy = claimPath ? `Restore write access to the existing claim store at ${quotedPath(claimPath)} (check parent permissions, symlink targets, mount access and sandbox rules)` : "Reinstall Stim so the unique-pid native module for this platform is present";
 	}
 };
 /**
@@ -53,22 +49,18 @@ function isClaimRefusal(err) {
 function isClaimUnavailable(err) {
 	return err?.code === CLAIM_UNAVAILABLE;
 }
-/**
-* The refusal a command reports for either error the claim primitive raises, and null for anything else.
-* Both are refusals: a claim Stim cannot resolve and a process identity it cannot record are the two
-* states in which it holds no claim, and running the operation a claim serializes without one gives a
-* competing run no protection at all.
-*/
+/** Convert an unresolved claim, unavailable identity or inaccessible warm claim store into command recovery guidance. */
 function claimFailure(err, retryCommand) {
+	const retry = retryCommand === null ? "retry the same Stim command" : `run \`${retryCommand}\` again`;
 	if (isClaimRefusal(err)) return {
 		code: CLAIM_REFUSED,
 		message: err.message,
-		remedy: `Run \`${err.removeCommand}\`, then run \`${retryCommand}\` again.`
+		remedy: `Run \`${err.removeCommand}\`, then ${retry}.`
 	};
 	if (isClaimUnavailable(err)) return {
 		code: CLAIM_UNAVAILABLE,
 		message: err.message,
-		remedy: `Reinstall Stim so the unique-pid native module for this platform is present, then run \`${retryCommand}\` again.`
+		remedy: `${err.remedy}, then ${retry}.`
 	};
 	return null;
 }
@@ -173,6 +165,29 @@ function refuse(root, claimPath, label, reason) {
 		reason
 	});
 }
+function refuseNonDirectory(root, path, label) {
+	let blocking = null;
+	for (let level = path;; level = dirname(level)) {
+		try {
+			if (!statSync(level).isDirectory()) {
+				blocking = level;
+				break;
+			}
+		} catch (error) {
+			const code = error?.code;
+			if (code !== "ENOENT" && code !== "ENOTDIR") break;
+		}
+		if (dirname(level) === level) break;
+	}
+	if (blocking === null) throw new ClaimUnavailableError("the non-directory path could not be identified; the claim store may have changed", { claimPath: root });
+	throw new ClaimRefusedError({
+		root,
+		claimPath: blocking,
+		label,
+		reason: "the claim path is a file, not a claim directory",
+		blockingFile: true
+	});
+}
 function names(dir) {
 	try {
 		return readdirSync(dir).toSorted();
@@ -404,7 +419,7 @@ function publishExclusive(root, payload, claimId, label) {
 		});
 		const code = err?.code;
 		if (contended(err)) return null;
-		if (code === "ENOTDIR") refuse(root, target, label, CLAIM_PATH_NOT_A_DIRECTORY);
+		if (code === "ENOTDIR") refuseNonDirectory(root, target, label);
 		throw err;
 	}
 }
@@ -438,7 +453,7 @@ function tryAcquireClaim({ root, mode, details = {}, label = "ownership" }) {
 			createClaimDir(root);
 		} catch (err) {
 			const code = err?.code;
-			if (code === "EEXIST" || code === "ENOTDIR") refuse(root, root, label, CLAIM_PATH_NOT_A_DIRECTORY);
+			if (code === "EEXIST" || code === "ENOTDIR") refuseNonDirectory(root, root, label);
 			if (contended(err)) continue;
 			throw err;
 		}
@@ -566,4 +581,4 @@ function writeChild(handle, body) {
 	}
 }
 //#endregion
-export { clearClaimChild as a, isClaimUnavailable as c, readClaimSet as d, releaseClaim as f, tryAcquireClaim as h, claimRemoveCommand as i, markClaimChildPending as l, settleClaim as m, ClaimRefusedError as n, clearFreeClaimSet as o, setClaimChild as p, claimFailure as r, isClaimRefusal as s, CLAIM_PATH_NOT_A_DIRECTORY as t, processGroupAlive as u };
+export { clearClaimChild as a, markClaimChildPending as c, releaseClaim as d, setClaimChild as f, claimRemoveCommand as i, processGroupAlive as l, tryAcquireClaim as m, ClaimUnavailableError as n, clearFreeClaimSet as o, settleClaim as p, claimFailure as r, isClaimRefusal as s, ClaimRefusedError as t, readClaimSet as u };

package/dist/{project-BBTVABUz.mjs → project-fKmuIaMI.mjs}

@@ -1,5 +1,5 @@
-import { c as findEnclosingWorktreeRoot, f as getProject } from "./config-CMtIaTk9.mjs";
-import { g as repoRoot } from "./worktree-C79xx_kM.mjs";
+import { c as findEnclosingWorktreeRoot, f as getProject } from "./config-CcefMY2Q.mjs";
+import { g as repoRoot } from "./worktree-Eq6TLH8N.mjs";
 import { existsSync, readFileSync, readdirSync, realpathSync } from "fs";
 import { basename, dirname, join, resolve } from "path";
 import { createRequire } from "module";