stim 1.4.0 → 1.6.0

package/dist/{error-diagnostics-_VmkqRZo.mjs → error-diagnostics-B5STzxqN.mjs}

@@ -1,13 +1,13 @@
 import { t as getExecutor } from "./exec-CyylIdq9.mjs";
-import { D as withDirLock, F as deviceSlotPlatforms, P as deviceSlotKey, f as getProject } from "./config-6vdGngKa.mjs";
-import { r as readWorkspaceState } from "./workspace-state-Do1e2mOH.mjs";
-import { d as readWorkspaceLaunches } from "./state-CDbvmZdt.mjs";
+import { D as withDirLock, F as deviceSlotPlatforms, P as deviceSlotKey, f as getProject } from "./config-DMP7L7H6.mjs";
+import { r as readWorkspaceState } from "./workspace-state-WVwWw_hB.mjs";
+import { d as readWorkspaceLaunches } from "./state-CnWzvCWP.mjs";
 import { n as deviceConsoleLevel } from "./ios-device-D3pzTKQE.mjs";
-import { i as resolveProjectMetro } from "./metro-DFLmaVz8.mjs";
+import { i as resolveProjectMetro } from "./metro-ato6ef3J.mjs";
 import { n as parseLogcatLine, t as androidClockOffset } from "./android-BW8i_YxU.mjs";
 import { _ as launchErrorPreview } from "./command-output-BuIb_ZOI.mjs";
-import { n as androidHome } from "./android-BkM4qTaN.mjs";
-import { a as parseLease, n as fileLeaseIo, t as deviceLeasePath } from "./device-lease-DDJr85OK.mjs";
+import { n as androidHome } from "./android-BkYmndPp.mjs";
+import { a as parseLease, n as fileLeaseIo, t as deviceLeasePath } from "./device-lease-DBW-IL4p.mjs";
 import { l as readLogRecords, t as attachExpoErrorContext } from "./logs-query-Cdp5aaCH.mjs";
 import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import { createHash, randomUUID } from "node:crypto";

package/dist/{gc-0AyxmECv.mjs → gc-C-6grAQI.mjs}

@@ -1,18 +1,18 @@
 import { t as getExecutor } from "./exec-CyylIdq9.mjs";
-import { A as isOnMountedVolume, C as withConfigLock, E as ownership_claim_exports, F as deviceSlotPlatforms, L as projectDeviceSlots, M as volumeRootFor, O as directorySize, f as getProject, g as loadConfig, i as clearDevice, j as listMountedVolumes, k as formatBytes, u as getConfigDir, v as removeProject } from "./config-6vdGngKa.mjs";
-import { i as registeredCaches } from "./cache-manifest-D02TpYjA.mjs";
-import { h as workspaceDir, y as workspaceStateFile } from "./workspace-state-Do1e2mOH.mjs";
-import { _ as repoRoot, s as gitCommonDir } from "./worktree-DWNx4tUg.mjs";
-import { a as findProjectRoot, i as detectIsExpo } from "./project-CBFCwnN5.mjs";
+import { A as isOnMountedVolume, C as withConfigLock, E as ownership_claim_exports, F as deviceSlotPlatforms, L as projectDeviceSlots, M as volumeRootFor, O as directorySize, f as getProject, g as loadConfig, i as clearDevice, j as listMountedVolumes, k as formatBytes, u as getConfigDir, v as removeProject } from "./config-DMP7L7H6.mjs";
+import { i as registeredCaches } from "./cache-manifest-uoOKhgUD.mjs";
+import { h as workspaceDir, y as workspaceStateFile } from "./workspace-state-WVwWw_hB.mjs";
+import { g as repoRoot, s as gitCommonDir } from "./worktree-DJnBbQZ9.mjs";
+import { a as findProjectRoot, i as detectIsExpo } from "./project-B_SDt4ip.mjs";
 import { m as shortUdid, o as formatLongDuration, u as plural } from "./command-output-BuIb_ZOI.mjs";
-import { B as listBuildLocks, S as listOrphanedAvdDirectories, T as ownedAvdDirectory, b as listAvds } from "./android-BkM4qTaN.mjs";
-import { A as resolveSettings, N as settingShapeErrors, a as SETTING_SHAPE_REMEDY } from "./settings-DwfltIXQ.mjs";
-import { S as resolveEasCliBin, a as POOL_SETTING_REMEDY, i as teardownParkedIosSim, l as parkedMaxSetting, n as teardownOwnedIosSim, r as teardownParkedAvd, s as dropParked, t as teardownOwnedAvd, u as readParked } from "./teardown-KsPpvldq.mjs";
+import { B as listBuildLocks, S as listOrphanedAvdDirectories, T as ownedAvdDirectory, b as listAvds } from "./android-BkYmndPp.mjs";
+import { A as resolveSettings, N as settingShapeErrors, a as SETTING_SHAPE_REMEDY } from "./settings-CGHTt5vb.mjs";
+import { S as resolveEasCliBin, a as POOL_SETTING_REMEDY, i as teardownParkedIosSim, l as parkedMaxSetting, n as teardownOwnedIosSim, r as teardownParkedAvd, s as dropParked, t as teardownOwnedAvd, u as readParked } from "./teardown-sm1FwF6V.mjs";
 import { d as listIosDeviceTypes, g as parseRuntimeVersion, u as listAllIosSims } from "./ios-Deh5js5V.mjs";
-import { i as listLeaseFiles, r as leaseIsExpired, u as removeExpiredLease } from "./device-lease-DDJr85OK.mjs";
-import { n as listBuildSlots } from "./build-slots-D6sDzOe-.mjs";
-import { C as verifyStoppedSession, S as stopSessionArgs, _ as inspectSessionForTeardown, d as withEasProjectLock, f as easMachineStateRoot, g as getSessionArgs, h as findOrphanedOwnedSessions, m as removeEasSessionClaim, p as readEasSessionLedger, u as withRemoteSessionLock, v as isDefinitiveMissingSessionError, x as parseSessionListPage, y as listOwnedSessionsArgs } from "./device-remote-CMfHhoc8.mjs";
-import { n as reclaimProject, t as describeDereferenced } from "./reclaim-DpDVo-AP.mjs";
+import { i as listLeaseFiles, r as leaseIsExpired, u as removeExpiredLease } from "./device-lease-DBW-IL4p.mjs";
+import { n as listBuildSlots } from "./build-slots-CuPszJDu.mjs";
+import { C as verifyStoppedSession, S as stopSessionArgs, _ as inspectSessionForTeardown, d as withEasProjectLock, f as easMachineStateRoot, g as getSessionArgs, h as findOrphanedOwnedSessions, m as removeEasSessionClaim, p as readEasSessionLedger, u as withRemoteSessionLock, v as isDefinitiveMissingSessionError, x as parseSessionListPage, y as listOwnedSessionsArgs } from "./device-remote-D9wN3CdE.mjs";
+import { n as reclaimProject, t as describeDereferenced } from "./reclaim-WXTbXPX4.mjs";
 import { InvalidArgumentError } from "commander";
 import { existsSync, readFileSync, readdirSync, realpathSync, rmSync, statSync } from "fs";
 import { homedir, tmpdir } from "os";

package/dist/{guide-CGxdmQ0K.mjs → guide-CYtd7xbA.mjs}

@@ -1,4 +1,6 @@
-import { t as ANDROID_AVD_CONFIG_HELP } from "./settings-DwfltIXQ.mjs";
+import { a as findProjectRoot } from "./project-B_SDt4ip.mjs";
+import { t as ANDROID_AVD_CONFIG_HELP } from "./settings-CGHTt5vb.mjs";
+import { t as guideStatus } from "./guide-status-BF6RsJJp.mjs";
 import chalk from "chalk";
 //#endregion
 //#region src/guide/index.ts
@@ -65,8 +67,12 @@ If warm fails or reports incomplete, resolve the reported failure first.
 A warm that cannot record its ownership claim refuses before copying. Follow
 the printed remedy and keep concurrent runs on the same STIM_HOME.
 
-Before native worktree work, run doctor for the platform in scope. It checks
-the source checkout from a linked worktree. Fix relevant findings and inspect the
+Before native worktree work, run doctor for the platform in scope. The STATUS
+block at the top of this topic says when it is due here: never run in this
+checkout, older than seven days, or run under another Stim version. No block
+means doctor is current and Stim is up to date; the same block names a newer
+Stim release when one exists. Doctor checks the source
+checkout from a linked worktree. Fix relevant findings and inspect the
 upstream gap; in the single-checkout workflow those seed findings do not
 appear. It also prints the running CLI version and the stim installation
 resolved from PATH. If that resolved installation is older than another one,
@@ -153,7 +159,7 @@ RULES DURING THE LOOP
   change does not need one.
 - For stale Metro transforms or file-map state, use stim start --reset-cache.
   It restarts only this app's verified owned Metro, preserving devices and other
-  apps' caches. See guide lifecycle for reset scope and Expo requirements.
+  apps' caches. See guide lifecycle for reset scope.
 - Reload is not part of the normal workflow. Use stim reload on an owned local
   simulator or emulator when an error screen remains after the fix, and on
   Android after a failed first bundle load. It reloads JavaScript and never
@@ -2425,12 +2431,11 @@ a seed belongs to this workflow.
 
   # If stale Metro transforms or file-map state require recovery:
   stim start --reset-cache
-  # Restarts only this app's verified owned Metro, retaining its port/devices.
-  # Uses a fresh persistent cache namespace, not deletion of shared cache files.
-  # Other apps and worktrees keep their caches. Subsequent starts reuse the new
-  # namespace; another reset changes it again. Native build caches are unchanged.
-  # Expo requires SDK 54+ and Stim's config adapter. Custom file-map cache
-  # managers must honor Metro's fileMapCacheDirectory for file-map invalidation.
+  # Restarts only this app's verified owned Metro, retaining its port/devices,
+  # with Metro's own reset (resetCache on a bare server, expo start --clear).
+  # That clears every store in the app's Metro config, including this app's
+  # shared transform store, so other worktrees of the SAME app rebuild their
+  # transforms too. Other apps and native build caches are unchanged.
 
   # 3. Owned device booted, native inputs fingerprinted, cached build
   #    installed (or built), app launched wired to port 8082, device-log
@@ -3072,8 +3077,13 @@ with machine or project optimization settings; see \`guide settings\`:
   ios      xcodebuild carries COMPILATION_CACHE_ENABLE_CACHING, a shared
            COMPILATION_CACHE_CAS_PATH and a clang prefix mapping of this
            workspace's root, so compiled output crosses worktrees with no
-           Podfile post_install block. Xcode 26+ only, and skipped entirely
-           when the project configured ccache (the two defeat each other).
+           Podfile post_install block. Swift joins in, with its own prefix
+           mapping, once xcrun swift reports 6.4 or newer (Xcode 27) and
+           react-native is 0.87 or newer; the cache line names Swift on or
+           off and why. Xcode still excludes Swift targets built without
+           explicit modules; the post-build cache line counts those.
+           Xcode 26+ only, and skipped entirely when the project
+           configured ccache (the two defeat each other).
   android  gradlew carries --build-cache, so task outputs cross worktrees with
            no org.gradle.caching=true in gradle.properties. Debug builds also
            carry -PreactNativeArchitectures=<target ABI>, using the owned
@@ -4537,9 +4547,10 @@ be setup steps are supplied by Stim on the command lines it composes itself:
 
   xcodebuild   COMPILATION_CACHE_ENABLE_CACHING / COMPILATION_CACHE_CAS_PATH /
                SWIFT_ENABLE_COMPILE_CACHE / CLANG_ENABLE_PREFIX_MAPPING /
-               CLANG_OTHER_PREFIX_MAPPINGS -- so no Podfile post_install block
-               (Xcode 26+ only, and skipped when the project configured ccache,
-               which defeats it)
+               CLANG_OTHER_PREFIX_MAPPINGS, plus SWIFT_ENABLE_PREFIX_MAPPING /
+               SWIFT_OTHER_PREFIX_MAPPINGS on a Swift 6.4+ toolchain -- so no
+               Podfile post_install block (Xcode 26+ only, and skipped when the
+               project configured ccache, which defeats it)
   gradlew      --build-cache -- so no org.gradle.caching=true in a committed
                gradle.properties. Debug builds add
                -PreactNativeArchitectures=<target ABI> when the owned
@@ -4577,7 +4588,6 @@ key inherits the next layer. Changes apply on the next build or Metro restart.
       "metroWarmup": true,
       "ios": {
         "compilationCache": true,
-        "swiftCompilationCache": false,
         "prefixMapping": true
       },
       "android": {
@@ -4614,7 +4624,18 @@ The example shows the defaults. Full setting names and behavior:
   optimizations.ios.compilationCache
     controls Xcode compilation caching (Xcode 26+).
   optimizations.ios.swiftCompilationCache
-    opts into experimental Swift caching, requiring compilationCache=true.
+    unset by default: Swift caching turns on, with Swift prefix mapping, when
+    xcrun swift reports Swift 6.4 or newer (Xcode 27), where swift-frontend no
+    longer crashes on prefix-mapped batches, and the project's react-native is
+    0.87 or newer. Older toolchains leave it off. React Native before 0.87
+    sets SWIFT_ENABLE_EXPLICIT_MODULES=NO on every target for its prebuilt
+    core, and Xcode refuses Swift caching without explicit modules, so those
+    projects stay off too; the cache line names which gate applied.
+    true forces it on any toolchain and React Native version, unmapped below
+    Swift 6.4, so entries only hit within one checkout. false keeps it off.
+    Requires compilationCache=true. A project that still disables explicit
+    modules itself sees the excluded target count on the post-build cache
+    line. Stim does not override that project setting.
   optimizations.ios.prefixMapping
     controls Clang source/DerivedData prefix mapping. false clears Stim's
     mappings. The existing Xcode version and project-ccache guards still apply.
@@ -4819,10 +4840,17 @@ function renderIndex(version) {
 	lines.push("", "Read one with:  stim guide <topic>   (sectioned topics: stim guide <topic> <section>)");
 	return lines.join("\n");
 }
-function guideCommand(program, version) {
-	program.command("guide [topic] [section]").description("Print reference documentation for THIS version of Stim (topics: " + topicNames().join(", ") + "). A topic with sections prints its section index; name a section to print only it, e.g. `stim guide errors STIM_NO_METRO` or `stim guide lifecycle builds`. Generated by the binary, so it cannot drift from the installed CLI.").action((topic, section) => {
+function guideCommand(program, version, status = (running) => guideStatus({
+	projectRoot: findProjectRoot(process.cwd()),
+	running
+})) {
+	program.command("guide [topic] [section]").description("Print reference documentation for THIS version of Stim (topics: " + topicNames().join(", ") + "). A topic with sections prints its section index; name a section to print only it, e.g. `stim guide errors STIM_NO_METRO` or `stim guide lifecycle builds`. Generated by the binary, so it cannot drift from the installed CLI.").action(async (topic, section) => {
+		const withStatus = async (body) => {
+			const block = await status(version);
+			return block ? `${block}\n\n${body}` : body;
+		};
 		if (!topic) {
-			console.log(renderIndex(version));
+			console.log(await withStatus(renderIndex(version)));
 			return;
 		}
 		const body = renderTopic(topic);
@@ -4834,7 +4862,7 @@ function guideCommand(program, version) {
 			process.exit(1);
 		}
 		if (!section) {
-			console.log(body);
+			console.log(topic === "agent" ? await withStatus(body) : body);
 			return;
 		}
 		const index = renderSectionIndex(topic);

package/dist/guide-status-BF6RsJJp.mjs

@@ -0,0 +1,271 @@
+import { t as getExecutor } from "./exec-CyylIdq9.mjs";
+import { S as upsertProject, f as getProject, u as getConfigDir } from "./config-DMP7L7H6.mjs";
+import { accessSync, constants, mkdirSync, readFileSync, realpathSync, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { delimiter, join, resolve } from "node:path";
+//#region src/stim-installations.ts
+const VERSION_OUTPUT_LIMIT = 4096;
+function parsedVersion(version) {
+	const match = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/.exec(version);
+	if (!match) return null;
+	const core = [
+		match[1],
+		match[2],
+		match[3]
+	];
+	if (core.some((part) => part.length > 1 && part.startsWith("0"))) return null;
+	const prereleaseParts = match[4]?.split(".");
+	if (prereleaseParts?.some((part) => !part || /^\d+$/.test(part) && part.length > 1 && part.startsWith("0"))) return null;
+	const prerelease = prereleaseParts?.map((part) => /^\d+$/.test(part) ? Number(part) : part);
+	return {
+		core: core.map(Number),
+		prerelease: prerelease ?? null
+	};
+}
+function compareStimVersions(left, right) {
+	const a = parsedVersion(left);
+	const b = parsedVersion(right);
+	if (!a || !b) return null;
+	for (let index = 0; index < a.core.length; index += 1) {
+		const difference = (a.core[index] ?? 0) - (b.core[index] ?? 0);
+		if (difference !== 0) return difference;
+	}
+	if (!a.prerelease && !b.prerelease) return 0;
+	if (!a.prerelease) return 1;
+	if (!b.prerelease) return -1;
+	for (let index = 0; index < Math.max(a.prerelease.length, b.prerelease.length); index += 1) {
+		const x = a.prerelease[index];
+		const y = b.prerelease[index];
+		if (x === void 0) return -1;
+		if (y === void 0) return 1;
+		if (x === y) continue;
+		if (typeof x === "number" && typeof y === "number") return x - y;
+		if (typeof x === "number") return -1;
+		if (typeof y === "number") return 1;
+		return x < y ? -1 : 1;
+	}
+	return 0;
+}
+function parseStimVersionOutput(output) {
+	const version = output?.split("\n")[0]?.trim() ?? "";
+	return parsedVersion(version) ? version.replace(/^v/, "") : null;
+}
+function executableNames(platform) {
+	return platform === "win32" ? [
+		"stim.cmd",
+		"stim.exe",
+		"stim"
+	] : ["stim"];
+}
+function stimExecutablePaths(pathValue, { platform = process.platform, cwd = process.cwd() } = {}) {
+	const found = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const entry of pathValue.split(delimiter)) {
+		const directory = resolve(cwd, entry || ".");
+		for (const name of executableNames(platform)) {
+			const path = join(directory, name);
+			try {
+				accessSync(path, platform === "win32" ? constants.F_OK : constants.X_OK);
+				if (!statSync(path).isFile()) continue;
+				const realPath = realpathSync(path);
+				if (seen.has(realPath)) continue;
+				seen.add(realPath);
+				found.push({
+					path,
+					realPath
+				});
+			} catch {}
+		}
+	}
+	return found;
+}
+function canonicalPath(path) {
+	if (!path) return null;
+	try {
+		return realpathSync(resolve(path));
+	} catch {
+		return resolve(path);
+	}
+}
+function analyzeStimVersions(runningVersion, runningPath, installations) {
+	const candidates = [runningVersion, ...installations.map((entry) => entry.version)];
+	const versions = [...new Set(candidates)].filter((version) => version !== null && compareStimVersions(version, version) !== null).toSorted((left, right) => -(compareStimVersions(left, right) ?? 0));
+	const highestVersion = versions[0] ?? null;
+	const resolved = installations[0] ?? null;
+	return {
+		runningVersion,
+		runningPath,
+		resolved,
+		installations,
+		versions,
+		highestVersion,
+		resolvedIsOlder: Boolean(resolved?.version && highestVersion && (compareStimVersions(resolved.version, highestVersion) ?? 0) < 0)
+	};
+}
+function probeStimVersion(path, timeoutMs) {
+	return new Promise((resolveProbe) => {
+		let settled = false;
+		let output = "";
+		const finish = (version) => {
+			if (settled) return;
+			settled = true;
+			clearTimeout(timer);
+			resolveProbe(version);
+		};
+		let child;
+		try {
+			child = getExecutor().spawn(path, ["--version"], {
+				stdio: [
+					"ignore",
+					"pipe",
+					"ignore"
+				],
+				detached: process.platform !== "win32"
+			});
+		} catch {
+			resolveProbe(null);
+			return;
+		}
+		const timer = setTimeout(() => {
+			try {
+				if (process.platform !== "win32" && child.pid) process.kill(-child.pid, "SIGKILL");
+				else child.kill("SIGKILL");
+			} catch {}
+			finish(null);
+		}, timeoutMs);
+		child.stdout?.on("data", (chunk) => {
+			if (output.length < VERSION_OUTPUT_LIMIT) output += String(chunk).slice(0, VERSION_OUTPUT_LIMIT - output.length);
+		});
+		child.on("error", () => finish(null));
+		child.on("close", (code) => finish(code === 0 ? parseStimVersionOutput(output) : null));
+	});
+}
+async function inspectStimVersions(runningVersion, { pathValue = process.env.PATH ?? "", runningPath = process.argv[1], probeTimeoutMs = 5e3 } = {}) {
+	const paths = stimExecutablePaths(pathValue);
+	const versions = await Promise.all(paths.map((entry) => probeStimVersion(entry.path, probeTimeoutMs)));
+	const installations = paths.map((entry, index) => ({
+		path: entry.path,
+		realPath: entry.realPath,
+		version: versions[index] ?? null
+	}));
+	return analyzeStimVersions(runningVersion, canonicalPath(runningPath), installations);
+}
+//#endregion
+//#region src/guide-status.ts
+const DAY_MS = 864e5;
+const DOCTOR_STALE_MS = 7 * DAY_MS;
+const UPDATE_CHECK_INTERVAL_MS = DAY_MS;
+const UPDATE_CHECK_TIMEOUT_MS = 2e3;
+const LATEST_URL = "https://registry.npmjs.org/stim/latest";
+const PLATFORMS = ["ios", "android"];
+function recordDoctorRun(projectRoot, platform, version, now = /* @__PURE__ */ new Date()) {
+	const run = {
+		at: now.toISOString(),
+		version
+	};
+	try {
+		upsertProject(projectRoot, (existing) => {
+			const doctorRuns = { ...existing.doctorRuns };
+			for (const target of platform ? [platform] : PLATFORMS) doctorRuns[target] = run;
+			return { doctorRuns };
+		});
+	} catch {}
+}
+function doctorDueReason(record, running, now) {
+	const at = record ? Date.parse(record.at) : NaN;
+	if (!record || Number.isNaN(at)) return "never run";
+	if (record.version !== running) return `last run with stim ${record.version}`;
+	const age = now.getTime() - at;
+	if (age > DOCTOR_STALE_MS) return `last run ${Math.floor(age / DAY_MS)} days ago`;
+	return null;
+}
+function updateCacheFile() {
+	return join(getConfigDir(), "update-check.json");
+}
+function readUpdateCache() {
+	try {
+		const parsed = JSON.parse(readFileSync(updateCacheFile(), "utf-8"));
+		if (typeof parsed?.checkedAt !== "string") return null;
+		return {
+			checkedAt: parsed.checkedAt,
+			latest: typeof parsed.latest === "string" ? parsed.latest : null
+		};
+	} catch {
+		return null;
+	}
+}
+function writeUpdateCache(cache) {
+	const target = updateCacheFile();
+	const tmp = `${target}.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`;
+	try {
+		mkdirSync(getConfigDir(), { recursive: true });
+		writeFileSync(tmp, `${JSON.stringify(cache)}\n`);
+		renameSync(tmp, target);
+	} catch {
+		try {
+			unlinkSync(tmp);
+		} catch {}
+	}
+}
+async function fetchLatest(fetchImpl) {
+	const res = await fetchImpl(LATEST_URL, { signal: AbortSignal.timeout(UPDATE_CHECK_TIMEOUT_MS) });
+	if (!res.ok) return null;
+	const body = await res.json();
+	return typeof body.version === "string" ? body.version : null;
+}
+async function checkForUpdate(running, { now = /* @__PURE__ */ new Date(), fetch: fetchImpl = fetch } = {}) {
+	if (process.env.STIM_NO_UPDATE_CHECK) return null;
+	const cached = readUpdateCache();
+	const checkedAt = cached ? Date.parse(cached.checkedAt) : NaN;
+	let latest = cached?.latest ?? null;
+	if (Number.isNaN(checkedAt) || now.getTime() - checkedAt > UPDATE_CHECK_INTERVAL_MS) {
+		try {
+			latest = await fetchLatest(fetchImpl);
+		} catch {
+			latest = null;
+		}
+		writeUpdateCache({
+			checkedAt: now.toISOString(),
+			latest
+		});
+	}
+	if (!latest) return null;
+	const comparison = compareStimVersions(latest, running);
+	return comparison !== null && comparison > 0 ? latest : null;
+}
+function renderGuideStatus({ running, doctor, latest }) {
+	const lines = [];
+	if (doctor.length) {
+		const named = doctor.map((due) => `${due.platform} (${due.reason})`).join(" and ");
+		const command = doctor.length === 1 ? `stim doctor --platform ${doctor[0]?.platform}` : "stim doctor";
+		lines.push(`  Doctor is due for ${named}.`, `  Run before native work:  ${command}`);
+	}
+	if (latest) lines.push(`  stim ${latest} is available (running ${running}):  npm install -g stim@latest`);
+	if (!lines.length) return null;
+	return ["STATUS", ...lines].join("\n");
+}
+async function guideStatus({ projectRoot, running, now = /* @__PURE__ */ new Date(), fetch: fetchImpl = fetch }) {
+	const doctor = [];
+	if (projectRoot) {
+		let runs = null;
+		try {
+			runs = getProject(projectRoot)?.doctorRuns ?? {};
+		} catch {}
+		if (runs) for (const platform of PLATFORMS) {
+			const reason = doctorDueReason(runs[platform], running, now);
+			if (reason) doctor.push({
+				platform,
+				reason
+			});
+		}
+	}
+	return renderGuideStatus({
+		running,
+		doctor,
+		latest: await checkForUpdate(running, {
+			now,
+			fetch: fetchImpl
+		})
+	});
+}
+//#endregion
+export { inspectStimVersions as i, recordDoctorRun as n, compareStimVersions as r, guideStatus as t };

package/dist/{ios-CtmGLx3X.mjs → ios-Ccm6c8Hj.mjs}

@@ -1,31 +1,31 @@
 import { t as getExecutor } from "./exec-CyylIdq9.mjs";
-import { E as ownership_claim_exports, P as deviceSlotKey, S as upsertProject, f as getProject, l as getConcurrencyLimits, z as validateDeviceSlot } from "./config-6vdGngKa.mjs";
+import { E as ownership_claim_exports, P as deviceSlotKey, S as upsertProject, f as getProject, l as getConcurrencyLimits, z as validateDeviceSlot } from "./config-DMP7L7H6.mjs";
 import { r as createNdjsonWriter } from "./ndjson-BZwI1NBv.mjs";
-import { _ as workspaceLogsDir, h as workspaceDir, o as writeWorkspaceState, r as readWorkspaceState } from "./workspace-state-Do1e2mOH.mjs";
-import { C as makeTemporaryDirectory, _ as repoRoot, s as gitCommonDir, w as removeTemporaryEntry } from "./worktree-DWNx4tUg.mjs";
-import { a as findProjectRoot, c as projectShortcut, i as detectIsExpo, r as detectBundleId, t as appProjectProblem } from "./project-CBFCwnN5.mjs";
-import { n as MODE_EXPO, p as writeWorkspaceLaunch, t as MODE_BARE } from "./state-CDbvmZdt.mjs";
-import { i as resolveProjectMetro, r as pidExists } from "./metro-DFLmaVz8.mjs";
-import { n as verifyCollectorOwnership } from "./ownership-BvSpZVBk.mjs";
+import { _ as workspaceLogsDir, h as workspaceDir, o as writeWorkspaceState, r as readWorkspaceState } from "./workspace-state-WVwWw_hB.mjs";
+import { T as removeTemporaryEntry, g as repoRoot, s as gitCommonDir, w as makeTemporaryDirectory } from "./worktree-DJnBbQZ9.mjs";
+import { a as findProjectRoot, c as projectShortcut, i as detectIsExpo, r as detectBundleId, t as appProjectProblem } from "./project-B_SDt4ip.mjs";
+import { n as MODE_EXPO, p as writeWorkspaceLaunch, t as MODE_BARE } from "./state-CnWzvCWP.mjs";
+import { i as resolveProjectMetro, r as pidExists } from "./metro-ato6ef3J.mjs";
+import { n as verifyCollectorOwnership } from "./ownership-CD_XnpDu.mjs";
 import { _ as launchErrorPreview, c as launchErrorReport, g as stepTimer, h as stepClock, i as formatDuration, l as phaseLine, m as shortUdid, n as appReadinessMessage, p as shortHash } from "./command-output-BuIb_ZOI.mjs";
-import { $ as providerDownloadPath, G as buildCacheKey, J as filesystemBuildCapability, K as describeFingerprintMiss, Q as prepareProviderDownloadDir, R as WAIT_CEILING_MS, U as takeoverLine, V as releaseBuildLock, W as waitForBuild, X as fingerprintDiffSuffix, Y as fingerprintDiffRecord, Z as fingerprintProject, at as untrackedMissLine, et as providerUploadOutcome, nt as resolveBuild, ot as untrackedNativeFiles, rt as storeBuild, tt as refingerprintAfterMutation, z as acquireBuildLock } from "./android-BkM4qTaN.mjs";
-import { A as resolveSettings, B as artifactCachePolicy, D as remoteDeviceSettingError, F as tunnelModeSetting, H as optimizationBuildProfile, I as unknownSettingKeys, N as settingShapeErrors, O as remoteIosSetting, R as detectProviders, T as publicUrlSetting, U as resolveOptimizations, _ as iosSigningIdentitySha1SettingError, a as SETTING_SHAPE_REMEDY, d as cacheProviderSettingError, f as iosLanHostSetting, g as iosSigningIdentitySha1Setting, h as iosSigningIdentitySettingError, k as resolveCacheProviderConfig, m as iosSigningIdentitySetting, p as iosLanHostSettingError, r as REMOTE_DEVICE_BACKENDS, x as metroWarmupUrlSetting } from "./settings-DwfltIXQ.mjs";
-import { C as resolveRemote, S as resolveEasCliBin, _ as exitAfterFlush, a as POOL_SETTING_REMEDY, f as RESOLVE_TIMEOUT_MS, g as easAuthNote, h as checkEasAuth, l as parkedMaxSetting, m as cacheLevel, p as UPLOAD_TIMEOUT_MS, v as isEasAuthFailureText, w as uploadRemote, y as loadProjectProvider } from "./teardown-KsPpvldq.mjs";
-import { _ as easDeviceBuildRemedy, a as swapJsBundle, c as ensureWorkspaceStorageSafely, d as launchOutcomeRecord, f as noMetroMessage, g as warmMetro, h as sleep, l as gateShouldRetry, m as resolveMetroWithRetry, n as pickDevClientScheme, o as needsPrebuild, p as noMetroRemedy, r as schemesFromInfoPlist, s as runPrebuild, t as devClientScheme, u as isPhysicalDeviceRequest, v as isEasBuildFailure, y as resolveEasDevelopmentBuild } from "./dev-client-Cd0v7iZk.mjs";
-import { t as withWorkspaceProcessLock } from "./workspace-process-lock-UEIrvZMJ.mjs";
+import { $ as providerDownloadPath, G as buildCacheKey, J as filesystemBuildCapability, K as describeFingerprintMiss, Q as prepareProviderDownloadDir, R as WAIT_CEILING_MS, U as takeoverLine, V as releaseBuildLock, W as waitForBuild, X as fingerprintDiffSuffix, Y as fingerprintDiffRecord, Z as fingerprintProject, at as untrackedMissLine, et as providerUploadOutcome, nt as resolveBuild, ot as untrackedNativeFiles, rt as storeBuild, tt as refingerprintAfterMutation, z as acquireBuildLock } from "./android-BkYmndPp.mjs";
+import { A as resolveSettings, B as artifactCachePolicy, D as remoteDeviceSettingError, F as tunnelModeSetting, H as optimizationBuildProfile, I as unknownSettingKeys, N as settingShapeErrors, O as remoteIosSetting, R as detectProviders, T as publicUrlSetting, U as resolveOptimizations, _ as iosSigningIdentitySha1SettingError, a as SETTING_SHAPE_REMEDY, d as cacheProviderSettingError, f as iosLanHostSetting, g as iosSigningIdentitySha1Setting, h as iosSigningIdentitySettingError, k as resolveCacheProviderConfig, m as iosSigningIdentitySetting, p as iosLanHostSettingError, r as REMOTE_DEVICE_BACKENDS, x as metroWarmupUrlSetting } from "./settings-CGHTt5vb.mjs";
+import { C as resolveRemote, S as resolveEasCliBin, _ as exitAfterFlush, a as POOL_SETTING_REMEDY, f as RESOLVE_TIMEOUT_MS, g as easAuthNote, h as checkEasAuth, l as parkedMaxSetting, m as cacheLevel, p as UPLOAD_TIMEOUT_MS, v as isEasAuthFailureText, w as uploadRemote, y as loadProjectProvider } from "./teardown-sm1FwF6V.mjs";
+import { _ as easDeviceBuildRemedy, a as swapJsBundle, c as ensureWorkspaceStorageSafely, d as launchOutcomeRecord, f as noMetroMessage, g as warmMetro, h as sleep, l as gateShouldRetry, m as resolveMetroWithRetry, n as pickDevClientScheme, o as needsPrebuild, p as noMetroRemedy, r as schemesFromInfoPlist, s as runPrebuild, t as devClientScheme, u as isPhysicalDeviceRequest, v as isEasBuildFailure, y as resolveEasDevelopmentBuild } from "./dev-client-BaTXAAnC.mjs";
+import { t as withWorkspaceProcessLock } from "./workspace-process-lock-Bz19_R9R.mjs";
 import { C as launchIosApp, E as unverifiedLaunchLines, O as verifyLaunch, T as readMetroRecords, b as isBundleProof, c as RELEASE_VERIFY_WAIT_MS, f as clearOtherUserApps, i as LAUNCH_BUNDLING, k as verifyReleaseLaunch, m as devClientUrl, n as DEFAULT_METRO_PORT, o as LAUNCH_FATAL, s as LAUNCH_UNVERIFIED, v as installIosApp, w as readCollectorRecords, y as iosAppProcess } from "./app-install--PAocWvq.mjs";
 import { f as listIosRuntimes } from "./ios-Deh5js5V.mjs";
-import { a as lostLine, c as releaseLeaseOnSignal, i as leaseExpiryText, l as runLease, n as DEBUG_VERIFY_STEP_MS, o as lostRefusal, r as acquireRunLease, s as parseDeviceWait, t as selectFromPool, u as waitFlagConflict } from "./device-pool-DJvbIBGW.mjs";
-import { r as releaseBuildSlot, t as acquireBuildSlot } from "./build-slots-D6sDzOe-.mjs";
-import { a as statsProjectKey, i as recordRunStats, n as readRunEstimates, t as createRunRecorder } from "./stats-C59QLKm2.mjs";
-import { c as unknownIosRuntimeRefusal, i as ensureOwnedDevice, n as clearIosAdoptionPending, r as ensureBooted, s as unknownIosDeviceTypeRefusal, t as checkDeviceCapacity } from "./device-CMDFzx7C.mjs";
-import { a as ensureMetroReachable, b as ownedSessionName, c as remoteIosDeps, l as resolveRemoteContext, n as binOnPath, o as ensureRemoteBootOwned, r as bundleEntryPoint, w as gateMetroOrigin } from "./device-remote-CMfHhoc8.mjs";
-import { a as compilationCacheActivityLine, c as readBundleExecutable, l as readBundleId, p as describeDiagnostic, r as buildIos, s as discoverXcodeProject, t as COMPILATION_CACHE_NOT_RUN, u as resolveScheme } from "./xcode-D9tVItl-.mjs";
-import { n as nativeRunCommand, t as launchSlotScope } from "./slot-launch-DeKen9e5.mjs";
+import { a as lostLine, c as releaseLeaseOnSignal, i as leaseExpiryText, l as runLease, n as DEBUG_VERIFY_STEP_MS, o as lostRefusal, r as acquireRunLease, s as parseDeviceWait, t as selectFromPool, u as waitFlagConflict } from "./device-pool-C0s_83Og.mjs";
+import { r as releaseBuildSlot, t as acquireBuildSlot } from "./build-slots-CuPszJDu.mjs";
+import { a as statsProjectKey, i as recordRunStats, n as readRunEstimates, t as createRunRecorder } from "./stats-Fo9ACIv7.mjs";
+import { c as unknownIosRuntimeRefusal, i as ensureOwnedDevice, n as clearIosAdoptionPending, r as ensureBooted, s as unknownIosDeviceTypeRefusal, t as checkDeviceCapacity } from "./device-XY_5eGdN.mjs";
+import { a as ensureMetroReachable, b as ownedSessionName, c as remoteIosDeps, l as resolveRemoteContext, n as binOnPath, o as ensureRemoteBootOwned, r as bundleEntryPoint, w as gateMetroOrigin } from "./device-remote-D9wN3CdE.mjs";
+import { a as compilationCacheActivityLine, c as readBundleExecutable, l as readBundleId, p as describeDiagnostic, r as buildIos, s as discoverXcodeProject, t as COMPILATION_CACHE_NOT_RUN, u as resolveScheme } from "./xcode-DUF7jrXj.mjs";
+import { n as nativeRunCommand, t as launchSlotScope } from "./slot-launch-BYjnljAs.mjs";
 import { t as spawnEntry } from "./spawn-entry-nCE6m770.mjs";
-import { a as printNativeCrashReport, n as IOS_CRASH_REPORT_RETRY, o as simulatorConsolePaths, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-_VmkqRZo.mjs";
+import { a as printNativeCrashReport, n as IOS_CRASH_REPORT_RETRY, o as simulatorConsolePaths, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-B5STzxqN.mjs";
 import { a as iosDeviceProcess, c as listIosDevices, d as verifyIosDeviceReleaseLaunch, i as installIosDeviceApp, l as localNetworkPending, n as LAUNCH_PROBE_TIMEOUT_MS, o as iosPoolCandidates, r as awaitIosDeviceLaunch, s as iosPoolNoCandidatesRefusal, t as DEVICECTL_INSTALL_TIMEOUT_MS, u as resolveIosPhysicalDevice } from "./ios-device-DJOi9FR5.mjs";
-import { a as runPodInstall, n as podsAreStale, r as readPodState } from "./deps-Ck4wuTwa.mjs";
+import { a as runPodInstall, n as podsAreStale, r as readPodState } from "./deps-C1zGnr61.mjs";
 import { existsSync, mkdirSync, mkdtempSync, openSync, rmSync, writeFileSync } from "node:fs";
 import { InvalidArgumentError } from "commander";
 import { X509Certificate } from "node:crypto";

package/dist/{logs-BF3qPA7w.mjs → logs-D4Poojxy.mjs}

@@ -1,9 +1,9 @@
-import { g as loadConfig, h as isPathPrefix, z as validateDeviceSlot } from "./config-6vdGngKa.mjs";
+import { g as loadConfig, h as isPathPrefix, z as validateDeviceSlot } from "./config-DMP7L7H6.mjs";
 import { n as SOURCES, t as LEVELS } from "./ndjson-BZwI1NBv.mjs";
-import { _ as workspaceLogsDir, r as readWorkspaceState } from "./workspace-state-Do1e2mOH.mjs";
-import { a as findProjectRoot } from "./project-CBFCwnN5.mjs";
+import { _ as workspaceLogsDir, r as readWorkspaceState } from "./workspace-state-WVwWw_hB.mjs";
+import { a as findProjectRoot } from "./project-B_SDt4ip.mjs";
 import { _ as launchErrorPreview } from "./command-output-BuIb_ZOI.mjs";
-import { i as captureWorkspaceCrashes, t as errorDiagnostics } from "./error-diagnostics-_VmkqRZo.mjs";
+import { i as captureWorkspaceCrashes, t as errorDiagnostics } from "./error-diagnostics-B5STzxqN.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";

package/dist/{metro-DFLmaVz8.mjs → metro-ato6ef3J.mjs}

@@ -1,7 +1,7 @@
 import { t as getExecutor } from "./exec-CyylIdq9.mjs";
-import { w as process_identity_exports } from "./config-6vdGngKa.mjs";
-import { r as readWorkspaceState } from "./workspace-state-Do1e2mOH.mjs";
-import { t as isMetroRunning } from "./ports-ClqG8GPt.mjs";
+import { w as process_identity_exports } from "./config-DMP7L7H6.mjs";
+import { r as readWorkspaceState } from "./workspace-state-WVwWw_hB.mjs";
+import { t as isMetroRunning } from "./ports-BZprTJRa.mjs";
 import { readlinkSync, realpathSync } from "fs";
 import { sep } from "path";
 //#region src/metro.ts

package/dist/{named-ports-BO7Zpjp0.mjs → named-ports-DH9SXd0f.mjs}

@@ -1,7 +1,7 @@
 import { t as getExecutor } from "./exec-CyylIdq9.mjs";
-import { C as withConfigLock, f as getProject, g as loadConfig, s as ensureConfig, u as getConfigDir, w as process_identity_exports, y as saveConfig } from "./config-6vdGngKa.mjs";
-import { n as isPortFree } from "./ports-ClqG8GPt.mjs";
-import { t as withWorkspaceProcessLock } from "./workspace-process-lock-UEIrvZMJ.mjs";
+import { C as withConfigLock, f as getProject, g as loadConfig, s as ensureConfig, u as getConfigDir, w as process_identity_exports, y as saveConfig } from "./config-DMP7L7H6.mjs";
+import { n as isPortFree } from "./ports-BZprTJRa.mjs";
+import { t as withWorkspaceProcessLock } from "./workspace-process-lock-Bz19_R9R.mjs";
 import { realpathSync } from "node:fs";
 //#region src/named-ports.ts
 const FIRST_PORT = 8900;

package/dist/{ownership-BvSpZVBk.mjs → ownership-CD_XnpDu.mjs}

@@ -1,6 +1,6 @@
-import { w as process_identity_exports } from "./config-6vdGngKa.mjs";
-import { a as withWorkspaceStateLock, o as writeWorkspaceState, r as readWorkspaceState } from "./workspace-state-Do1e2mOH.mjs";
-import { r as pidExists } from "./metro-DFLmaVz8.mjs";
+import { w as process_identity_exports } from "./config-DMP7L7H6.mjs";
+import { a as withWorkspaceStateLock, o as writeWorkspaceState, r as readWorkspaceState } from "./workspace-state-WVwWw_hB.mjs";
+import { r as pidExists } from "./metro-ato6ef3J.mjs";
 import { realpathSync } from "node:fs";
 //#region src/collector/state.ts
 function collectorRoot(root) {

package/dist/{ownership-C08Yzrp7.mjs → ownership-CVY9cqCr.mjs}

@@ -1,8 +1,8 @@
 import { t as getExecutor } from "./exec-CyylIdq9.mjs";
-import { u as getConfigDir, w as process_identity_exports } from "./config-6vdGngKa.mjs";
+import { u as getConfigDir, w as process_identity_exports } from "./config-DMP7L7H6.mjs";
 import { t as createLineReader } from "./process-output-C7IlIzd7.mjs";
-import { r as pidExists } from "./metro-DFLmaVz8.mjs";
-import { t as withWorkspaceProcessLock } from "./workspace-process-lock-UEIrvZMJ.mjs";
+import { r as pidExists } from "./metro-ato6ef3J.mjs";
+import { t as withWorkspaceProcessLock } from "./workspace-process-lock-Bz19_R9R.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/{ports-BiKqP92J.mjs → ports-A6uTJSPj.mjs}

@@ -1,6 +1,6 @@
-import { f as getProject } from "./config-6vdGngKa.mjs";
-import { a as findProjectRoot } from "./project-CBFCwnN5.mjs";
-import { n as getNamedPort, t as clearNamedPorts } from "./named-ports-BO7Zpjp0.mjs";
+import { f as getProject } from "./config-DMP7L7H6.mjs";
+import { a as findProjectRoot } from "./project-B_SDt4ip.mjs";
+import { n as getNamedPort, t as clearNamedPorts } from "./named-ports-DH9SXd0f.mjs";
 //#region src/commands/ports.ts
 async function inProject(action) {
 	try {

package/dist/{ports-ClqG8GPt.mjs → ports-BZprTJRa.mjs}

@@ -1,4 +1,4 @@
-import { A as isOnMountedVolume, g as loadConfig, j as listMountedVolumes, n as allMetroPorts, r as claimMetroPort, v as removeProject } from "./config-6vdGngKa.mjs";
+import { A as isOnMountedVolume, g as loadConfig, j as listMountedVolumes, n as allMetroPorts, r as claimMetroPort, v as removeProject } from "./config-DMP7L7H6.mjs";
 import { existsSync } from "fs";
 import { request } from "http";
 import { connect } from "net";

package/dist/{project-CBFCwnN5.mjs → project-B_SDt4ip.mjs}

@@ -1,5 +1,5 @@
-import { c as findEnclosingWorktreeRoot, f as getProject } from "./config-6vdGngKa.mjs";
-import { _ as repoRoot } from "./worktree-DWNx4tUg.mjs";
+import { c as findEnclosingWorktreeRoot, f as getProject } from "./config-DMP7L7H6.mjs";
+import { g as repoRoot } from "./worktree-DJnBbQZ9.mjs";
 import { existsSync, readFileSync, readdirSync, realpathSync } from "fs";
 import { basename, dirname, join, resolve } from "path";
 import { createRequire } from "module";