@stim-cli/core 1.12.0 → 1.13.0

package/dist/{core-CJWLJIr6.mjs → core-CmZJEFj_.mjs}

@@ -1,4 +1,4 @@
-import { _ as releaseClaim, r as ClaimRefusedError, x as tryAcquireClaim } from "./ownership-claim-O31Y5iIb.mjs";
+import { S as quotedPath, _ as releaseClaim, r as ClaimRefusedError, x as tryAcquireClaim } from "./ownership-claim-O31Y5iIb.mjs";
 import fs, { existsSync, lstatSync, mkdirSync, readdirSync, renameSync, rmSync, rmdirSync, statSync, unlinkSync, utimesSync, writeFileSync } from "node:fs";
 import os from "node:os";
 import path, { basename, dirname, join } from "node:path";
@@ -76,7 +76,15 @@ function takeLockDirectory(lockPath, claim) {
 		if (!removeLockDirectory(lockPath, marker) || !createLockDirectory(lockPath)) return null;
 	}
 	const marker = join(lockPath, `.stim-claim-${claim.claimId}`);
-	writeFileSync(marker, "", { flag: "wx" });
+	try {
+		writeFileSync(marker, "", { flag: "wx" });
+	} catch (error) {
+		try {
+			rmSync(marker, { force: true });
+			rmdirSync(lockPath);
+		} catch {}
+		throw error;
+	}
 	return marker;
 }
 function acquireDirLock(lockPath, { waitMs, pollMs, ensureParent }) {
@@ -103,7 +111,7 @@ function acquireDirLock(lockPath, { waitMs, pollMs, ensureParent }) {
 				};
 			}
 			if (Date.now() >= deadline) {
-				const error = /* @__PURE__ */ new Error(`Timed out waiting for the lock at ${lockPath}. Another Stim process may be holding it; if none is running, remove that directory.`);
+				const error = /* @__PURE__ */ new Error(`Timed out waiting for the lock at ${lockPath}. ` + (claim ? `No current Stim holds it: the directory is empty, or an older Stim version holds or left it. If no older Stim is running, remove it and run the command again:\n  rm -rf ${quotedPath(lockPath)}` : "Another Stim process is holding it; wait for that command to finish and run the command again."));
 				error.code = "STIM_LOCK_TIMEOUT";
 				error.lockPath = lockPath;
 				throw error;

package/dist/index.mjs

@@ -1,3 +1,3 @@
 import { S as quotedPath } from "./ownership-claim-O31Y5iIb.mjs";
-import { C as artifactIn, E as withDirLock, S as workspaceStateDir, T as storeArtifact, _ as updateCacheManifest, a as buildCacheRoot, b as workspaceName, c as cachePathSetting, d as readCacheManifest, f as registerCache, g as tagSharedStore, h as sharedStoreRoot, i as buildCacheKey, l as configDir, m as rotatedLogPath, n as METRO_NAMED_CACHE_LAYOUT, o as cacheManifestLockPath, p as rotateLog, r as STORE_ROOT_TAG, s as cacheNameSegment, t as LOG_ROTATE_BYTES, u as metroCacheRoot, v as workspaceId, w as resolveArtifact, x as workspaceSlug, y as workspaceLogDir } from "./core-CJWLJIr6.mjs";
+import { C as artifactIn, E as withDirLock, S as workspaceStateDir, T as storeArtifact, _ as updateCacheManifest, a as buildCacheRoot, b as workspaceName, c as cachePathSetting, d as readCacheManifest, f as registerCache, g as tagSharedStore, h as sharedStoreRoot, i as buildCacheKey, l as configDir, m as rotatedLogPath, n as METRO_NAMED_CACHE_LAYOUT, o as cacheManifestLockPath, p as rotateLog, r as STORE_ROOT_TAG, s as cacheNameSegment, t as LOG_ROTATE_BYTES, u as metroCacheRoot, v as workspaceId, w as resolveArtifact, x as workspaceSlug, y as workspaceLogDir } from "./core-CmZJEFj_.mjs";
 export { LOG_ROTATE_BYTES, METRO_NAMED_CACHE_LAYOUT, STORE_ROOT_TAG, artifactIn, buildCacheKey, buildCacheRoot, cacheManifestLockPath, cacheNameSegment, cachePathSetting, configDir, metroCacheRoot, quotedPath, readCacheManifest, registerCache, resolveArtifact, rotateLog, rotatedLogPath, sharedStoreRoot, storeArtifact, tagSharedStore, updateCacheManifest, withDirLock, workspaceId, workspaceLogDir, workspaceName, workspaceSlug, workspaceStateDir };

package/dist/state.d.mts

@@ -112,15 +112,24 @@ declare function allMetroPorts(): number[];
 declare function findProjectByMetroPort(port: number): string | null;
 //#endregion
 //#region state/json-file.d.ts
+/**
+ * Runs `fn` with each state file read from disk at most once: inside it, including after an `await`, `readStateFile`
+ * returns the text of the first read of that path, and a path found missing stays missing. Callers still parse every time, so no two
+ * share a mutable object. Only for computations that write none of the files they read.
+ */
+declare function withStateReadCache<T>(fn: () => T): T;
+declare function readStateFile(path: string): string;
 declare function readJsonFile(path: string): unknown;
 declare function isJsonObject(value: unknown): value is Record<string, unknown>;
 declare function readJsonObject(path: string): Record<string, unknown> | null;
 //#endregion
 //#region state/ledgers.d.ts
-type CreatedDevicePlatform = "ios" | "android";
+type CreatedDevicePlatform = "ios" | "android" | "web";
+/** `web` lists the absolute paths of browser profile directories Stim created. */
 interface CreatedDevices {
   ios: ReadonlySet<string>;
   android: ReadonlySet<string>;
+  web: ReadonlySet<string>;
 }
 declare function readCreatedDevices(): CreatedDevices;
 interface EasSessionClaim {
@@ -146,6 +155,8 @@ interface NdjsonRecord {
   src?: string;
   level?: string;
   msg?: string;
+  /** With `logs --errors --json`: the code frame and stack lines Expo printed after this error. */
+  context?: string[];
   [key: string]: unknown;
 }
 declare const LEVELS: string[];
@@ -167,10 +178,11 @@ interface GrepResult {
 interface MarkerWindow {
   launchTs: number | null;
   bundleTs: number | null;
+  pageLoadTs: number | null;
 }
 interface QueryCriteria {
   slot?: string;
-  includeNativeCrashes?: boolean;
+  includeAppDeviceErrors?: boolean;
   sources?: string[];
   minLevel?: string;
   grep?: RegExp;
@@ -202,7 +214,12 @@ declare function buildCriteria({ slot, sources, minLevel, since, grep, errorsOnl
 declare function logFiles(dir: string): string[];
 declare function fileSizes(dir: string): Record<string, number>;
 declare function readLogRecords(dir: string, include?: (name: string) => boolean): NdjsonRecord[];
-declare function attachExpoErrorContext(all: NdjsonRecord[], matched: NdjsonRecord[]): NdjsonRecord[];
+type ExpoContextTarget = "msg" | "field";
+/**
+ * Adds the code frame and stack lines Expo printed after each Expo error record, either joined into
+ * `msg` or as a `context` string array.
+ */
+declare function attachExpoErrorContext(all: NdjsonRecord[], matched: NdjsonRecord[], into?: ExpoContextTarget): NdjsonRecord[];
 declare function queryLogs({ slot, dir, records, sources, minLevel, since, grep, tail, errorsOnly, errorContext, now }?: {
   slot?: string;
   dir?: string;
@@ -224,12 +241,14 @@ declare function advanceTail(prev: TailState | null | undefined, chunk: string |
   state: TailState;
   records: NdjsonRecord[];
 };
-declare function followLogs({ dir, onRecord, criteria, intervalMs, offsets }: {
+declare function followLogs({ dir, onRecord, criteria, intervalMs, offsets, errorContext }: {
   dir: string;
   onRecord: (record: NdjsonRecord) => void;
   criteria?: QueryCriteria;
   intervalMs?: number;
   offsets?: Record<string, number> | null;
+  /** Holds each Expo error until a poll adds no more of its code frame or stack lines, then attaches them. */
+  errorContext?: ExpoContextTarget;
 }): () => void;
 declare function sortByTs(records: NdjsonRecord[]): NdjsonRecord[];
 //#endregion
@@ -338,6 +357,8 @@ interface SettingsPayload {
 declare const REMOTE_DEVICE_BACKENDS: readonly RemoteDeviceBackend[];
 declare const IOS_SIMULATOR_APPS: readonly ["xcode", "siniulator", "stim-desktop"];
 declare const ANDROID_EMULATOR_APPS: readonly ["emulator", "stim-desktop"];
+declare const WEB_VIEWPORTS: readonly ["desktop", "phone"];
+type WebViewport = (typeof WEB_VIEWPORTS)[number];
 declare const SETTINGS: readonly SettingDefinition[];
 declare function settingDefinition(key: string): SettingDefinition | null;
 declare function isLayeredSetting(setting: SettingDefinition): boolean;
@@ -386,7 +407,16 @@ interface IdleStopRecord {
 declare function readIdleStop(state: WorkspaceState | null | undefined): IdleStopRecord | null;
 /** Each platform's latest run; `lastBuild` holds whichever platform ran last. */
 declare const LAST_BUILD_KEYS: Readonly<Record<StatsPlatform, string>>;
+declare const BUILD_HISTORY_KEY = "buildHistory";
+declare const BUILD_HISTORY_LIMIT = 10;
+/**
+ * The first diagnostics of a failed build in the shape a last-build record stores and `status` reports, the
+ * ones with a source position first.
+ */
+declare function buildDiagnostics(value: unknown): BuildDiagnostic[];
 declare function readLastBuilds(state: WorkspaceState | null | undefined): Partial<Record<StatsPlatform, LastBuildReport>>;
+/** Each platform's recorded runs, newest first, at most `BUILD_HISTORY_LIMIT` each. */
+declare function readBuildHistory(state: WorkspaceState | null | undefined): Partial<Record<StatsPlatform, BuildHistoryEntry[]>>;
 declare function readWorkspaceState(root: string): WorkspaceState | null;
 declare function lastUseFrom(state: WorkspaceState | null, logMtimes: readonly number[]): number;
 declare function workspaceLastUsed(root: string): number;
@@ -423,6 +453,31 @@ interface LastBuildReport {
   finishedAt: string | null;
   errorCode?: string;
   missReason?: BuildMissReason;
+  /** The first compiler diagnostics of a failed build, when the build tool reported any. */
+  diagnostics?: BuildDiagnostic[];
+}
+/** How a recorded build ended. `interrupted` is a run whose process ended without recording a result. */
+declare const BUILD_RESULTS: readonly ["succeeded", "failed", "cancelled", "interrupted"];
+type BuildResult = (typeof BUILD_RESULTS)[number];
+/**
+ * One run in a workspace's recent build history. `configuration` is the iOS configuration or the Android
+ * variant the run built, `Debug` or `debug` by default, and null when the run ended before resolving it.
+ * `phases` holds the milliseconds spent in each phase the run entered. An interrupted run has null
+ * `durationMs` and `finishedAt`, no cache facts, and 0 for the phase it stopped in.
+ */
+interface BuildHistoryEntry extends LastBuildReport {
+  result: BuildResult;
+  slot: string;
+  configuration: string | null;
+  cacheKey: string | null;
+  phases: Partial<Record<BuildPhase, number>>;
+}
+/** One compiler error from a failed build: where it is, when the tool said, and its message. */
+interface BuildDiagnostic {
+  file: string | null;
+  line: number | null;
+  column: number | null;
+  message: string;
 }
 /** What kind of native input a changed fingerprint source is. */
 type BuildMissCategory = "native-dependency" | "config-plugin" | "app-config" | "app-asset" | "package" | "native-dir" | "autolinking" | "package-scripts" | "file" | "other";
@@ -483,6 +538,17 @@ interface DeviceActivity {
   lastActivityAt?: string;
   basis: string[];
 }
+/** Every state a device's app process can report. */
+declare const APP_PROCESS_STATES: readonly ["running", "stopped", "unknown"];
+/**
+ * Whether the workspace's app process is alive on a device now. This is current process state, not launch evidence:
+ * `launched` in an `ios` or `android` result stays the record of one launch. `id` is the bundle identifier or
+ * package that was checked; `state` is "unknown" when the process listing could not be read.
+ */
+interface DeviceAppProcess {
+  id: string;
+  state: (typeof APP_PROCESS_STATES)[number];
+}
 /**
  * A linked worktree's `git status`. `changed` counts tracked paths with staged or unstaged changes, including
  * conflicts; `untracked` counts untracked entries as `git status` lists them, so an untracked directory counts once.
@@ -519,7 +585,7 @@ interface RemoteDeviceState {
   webPreviewUrl: string | null;
 }
 /** Every code a status issue can carry. */
-declare const STATUS_ISSUE_CODES: readonly ["port-not-ours", "sim-missing", "sim-without-metro", "avd-serial-changed", "avd-missing", "avd-not-detected", "avd-unchecked", "supervisor-unverified"];
+declare const STATUS_ISSUE_CODES: readonly ["port-not-ours", "sim-missing", "sim-without-metro", "avd-serial-changed", "avd-missing", "avd-not-detected", "avd-unchecked", "supervisor-unverified", "browser-unverified", "browser-orphaned"];
 type StatusIssueCode = (typeof STATUS_ISSUE_CODES)[number];
 /**
  * One thing in a workspace that needs the user. `remedy` is a command to run from `workspace`; `slot` is absent
@@ -533,6 +599,23 @@ interface StatusIssue {
   workspace: string;
   slot?: string;
 }
+/**
+ * The workspace's Stim-owned Chrome. `pid` is Chrome's process and `supervisorPid` the Stim process that holds
+ * its DevTools session. `cdpEndpoint` is the loopback DevTools HTTP endpoint agents can attach to, null when the
+ * browser is not running. `profile` is the Stim-owned user data directory.
+ */
+interface WebBrowserState {
+  browser: "chrome";
+  version: string | null;
+  running: boolean;
+  pid: number | null;
+  supervisorPid: number | null;
+  url: string;
+  headless: boolean;
+  viewport: WebViewport;
+  profile: string;
+  cdpEndpoint: string | null;
+}
 interface EnvironmentState {
   slots?: {
     slot: string;
@@ -541,6 +624,10 @@ interface EnvironmentState {
   }[];
   path: string;
   live: boolean;
+  /**
+   * A fixed estimate, not a measurement: a set amount per booted simulator, detected emulator, running Metro and
+   * running Chrome. `capacity.committedMb` sums it. What the workspace's processes use now is in `machine`.
+   */
   memoryMb: number;
   warnings: string[];
   issues: StatusIssue[];
@@ -550,6 +637,7 @@ interface EnvironmentState {
     owned: boolean;
     state: string;
     activity?: DeviceActivity;
+    app?: DeviceAppProcess;
   } | null;
   android?: {
     name: string | undefined;
@@ -559,6 +647,7 @@ interface EnvironmentState {
     state?: AndroidRuntimeFacts["state"];
     deviceProfile?: string | null;
     activity?: DeviceActivity;
+    app?: DeviceAppProcess;
   } | null;
   metro?: {
     port: number;
@@ -566,6 +655,7 @@ interface EnvironmentState {
     pid: number | null;
     idleStop?: IdleStopRecord;
   } | null;
+  web?: WebBrowserState | null;
   supervisor?: {
     pid: number | null;
     mode: string | null;
@@ -580,7 +670,10 @@ interface EnvironmentState {
   remoteDevices?: RemoteDeviceState[];
   build?: BuildReport | null;
   lastBuilds?: Partial<Record<StatsPlatform, LastBuildReport>>;
+  /** Each platform's recent runs, newest first, at most `BUILD_HISTORY_LIMIT` each. */
+  builds?: Partial<Record<StatsPlatform, BuildHistoryEntry[]>>;
 }
+/** `committedMb` sums the environments' estimated `memoryMb`; `overCapacity` is that sum over 60% of `totalMemoryMb`. */
 interface StatusCapacity {
   liveCount: number;
   committedMb: number;
@@ -600,6 +693,34 @@ interface DeviceLeaseState {
   expired: boolean;
   parsed: boolean;
 }
+/** Every kind of process owner the status machine section reports. */
+declare const MACHINE_OWNER_KINDS: readonly ["simulator", "emulator", "metro", "build", "browser", "server", "shared"];
+type MachineOwnerKind = (typeof MACHINE_OWNER_KINDS)[number];
+/**
+ * One thing using this Mac's CPU and memory now. Each process is counted in exactly one owner: the one whose root
+ * process is its nearest ancestor. `workspace` and `slot` (absent for the default slot) name the workspace a
+ * simulator, emulator, Metro, build or Chrome belongs to; a device no workspace records has a null workspace, and
+ * machine-wide processes are `shared`. `id` is the simulator's UDID, the emulator's AVD name, Metro's port as text,
+ * the build's platform, or null. `owned` is true only for what Stim started and stops: a workspace's owned device,
+ * Metro, build or Chrome. `cpuPercent` is `ps` %CPU summed over the owner's processes, where 100 is one core.
+ * `residentMb` sums their resident set sizes; pages shared between processes count once per process, so a
+ * simulator, whose processes all map the runtime's shared libraries, reports well above its physical footprint.
+ */
+interface MachineOwner {
+  kind: MachineOwnerKind;
+  name: string;
+  workspace: string | null;
+  slot?: string;
+  id: string | null;
+  owned: boolean;
+  cpuPercent: number;
+  residentMb: number;
+  processes: number;
+}
+/** Where this machine's CPU and resident memory go, from one pass over the host process table. */
+interface MachineUsageState {
+  owners: MachineOwner[];
+}
 /** The payload `stim status --json` prints, and `status --watch --json` prints on each change. */
 interface StatusPayload {
   environments: (EnvironmentState & {
@@ -609,6 +730,8 @@ interface StatusPayload {
   deviceLeases: DeviceLeaseState[];
   unprovisionedWorktrees: WorktreeFacts[];
   simctlAvailable: boolean;
+  /** Null when nothing runs that status attributes, so it read no process table, or when the table was unreadable. */
+  machine: MachineUsageState | null;
 }
 //#endregion
-export { ANDROID_COMPILER_CACHE_CHOICES, ANDROID_EMULATOR_APPS, ANDROID_PCH_CHOICES, ActiveBuildState, ActivityDriver, AndroidRuntimeFacts, BUILD_PHASES, BuildCacheHit, BuildMissCategory, BuildMissChange, BuildMissReason, BuildPhase, BuildPlanPayload, BuildReport, ConcurrencyLimits, Config, CreatedDevicePlatform, CreatedDevices, DeviceActivity, DeviceLeaseState, DeviceRecord, DoctorRunRecord, ERROR_SOURCES, EasSessionClaim, EasSessionLedgerRead, EnvironmentState, IDLE_STOP_KEY, IOS_SIMULATOR_APPS, IdleStopRecord, LAST_BUILD_KEYS, LEVELS, LastBuildReport, NdjsonRecord, PlatformRecords, ProjectRecord, QueryCriteria, REMOTE_DEVICE_BACKENDS, RemoteDeviceBackend, RemoteDeviceState, RepoRecord, RunOutcomeKind, SETTINGS, SETTINGS_SCHEMA_FILE, SETTINGS_SCHEMA_URL, SETTING_GROUPS, SETTING_SCOPES, SOURCES, STATUS_ISSUE_CODES, SettingDefinition, SettingEntry, SettingScope, SettingType, SettingsObject, SettingsPayload, StatsPlatform, StatusCapacity, StatusIssue, StatusIssueCode, StatusPayload, StimConfig, SupervisorRecord, TUNNEL_MODES, TunnelMode, WorkspaceState, WorktreeFacts, WorktreeGit, acceptsShape, advanceTail, allMetroPorts, attachExpoErrorContext, buildCriteria, coerceSettingText, compileGrep, configCorruptRepair, configLockPath, createdDevicesFile, createdDevicesLock, easMachineStateRoot, easSessionLedgerFile, easSessionLedgerLock, emulatorLogFile, expectedShape, fileSizes, findEnclosingWorktreeRoot, findProjectByMetroPort, followLogs, getConcurrencyLimits, getConfigPath, getProject, getProjectSetting, getProjectSettings, getRepoSettings, gitMergeCacheDir, isJsonObject, isLayeredSetting, isPathPrefix, isSensitiveReference, lastUseFrom, levelRank, loadConfig, logFiles, markerWindow, parseNdjsonLine, parseNdjsonText, parseSince, queryLogs, readCreatedDevices, readEasSessionLedger, readIdleStop, readJsonFile, readJsonObject, readLastBuilds, readLogRecords, readNdjsonGenerations, readWorkspaceState, recordMatches, settingDefinition, settingValueError, settingsJsonSchema, sharedCcache, sharedCompilationCache, sharedGradle, sharedPods, sortByTs, supervisorLogFile, supervisorPidFile, tailRead, validEasSessionClaim, withConfigLock, workspaceDerivedData, workspaceGradleBuild, workspaceLastUsed, workspaceLogErrorIndex, workspaceLogsDir, workspaceMetadataFile, workspaceStateFile, workspaceStateLock };
+export { ANDROID_COMPILER_CACHE_CHOICES, ANDROID_EMULATOR_APPS, ANDROID_PCH_CHOICES, APP_PROCESS_STATES, ActiveBuildState, ActivityDriver, AndroidRuntimeFacts, BUILD_HISTORY_KEY, BUILD_HISTORY_LIMIT, BUILD_PHASES, BUILD_RESULTS, BuildCacheHit, BuildDiagnostic, BuildHistoryEntry, BuildMissCategory, BuildMissChange, BuildMissReason, BuildPhase, BuildPlanPayload, BuildReport, BuildResult, ConcurrencyLimits, Config, CreatedDevicePlatform, CreatedDevices, DeviceActivity, DeviceAppProcess, DeviceLeaseState, DeviceRecord, DoctorRunRecord, ERROR_SOURCES, EasSessionClaim, EasSessionLedgerRead, EnvironmentState, IDLE_STOP_KEY, IOS_SIMULATOR_APPS, IdleStopRecord, LAST_BUILD_KEYS, LEVELS, LastBuildReport, MACHINE_OWNER_KINDS, MachineOwner, MachineOwnerKind, MachineUsageState, NdjsonRecord, PlatformRecords, ProjectRecord, QueryCriteria, REMOTE_DEVICE_BACKENDS, RemoteDeviceBackend, RemoteDeviceState, RepoRecord, RunOutcomeKind, SETTINGS, SETTINGS_SCHEMA_FILE, SETTINGS_SCHEMA_URL, SETTING_GROUPS, SETTING_SCOPES, SOURCES, STATUS_ISSUE_CODES, SettingDefinition, SettingEntry, SettingScope, SettingType, SettingsObject, SettingsPayload, StatsPlatform, StatusCapacity, StatusIssue, StatusIssueCode, StatusPayload, StimConfig, SupervisorRecord, TUNNEL_MODES, TunnelMode, WEB_VIEWPORTS, WebBrowserState, WebViewport, WorkspaceState, WorktreeFacts, WorktreeGit, acceptsShape, advanceTail, allMetroPorts, attachExpoErrorContext, buildCriteria, buildDiagnostics, coerceSettingText, compileGrep, configCorruptRepair, configLockPath, createdDevicesFile, createdDevicesLock, easMachineStateRoot, easSessionLedgerFile, easSessionLedgerLock, emulatorLogFile, expectedShape, fileSizes, findEnclosingWorktreeRoot, findProjectByMetroPort, followLogs, getConcurrencyLimits, getConfigPath, getProject, getProjectSetting, getProjectSettings, getRepoSettings, gitMergeCacheDir, isJsonObject, isLayeredSetting, isPathPrefix, isSensitiveReference, lastUseFrom, levelRank, loadConfig, logFiles, markerWindow, parseNdjsonLine, parseNdjsonText, parseSince, queryLogs, readBuildHistory, readCreatedDevices, readEasSessionLedger, readIdleStop, readJsonFile, readJsonObject, readLastBuilds, readLogRecords, readNdjsonGenerations, readStateFile, readWorkspaceState, recordMatches, settingDefinition, settingValueError, settingsJsonSchema, sharedCcache, sharedCompilationCache, sharedGradle, sharedPods, sortByTs, supervisorLogFile, supervisorPidFile, tailRead, validEasSessionClaim, withConfigLock, withStateReadCache, workspaceDerivedData, workspaceGradleBuild, workspaceLastUsed, workspaceLogErrorIndex, workspaceLogsDir, workspaceMetadataFile, workspaceStateFile, workspaceStateLock };

package/dist/state.mjs

@@ -1,11 +1,38 @@
-import { E as withDirLock, S as workspaceStateDir, b as workspaceName, l as configDir, m as rotatedLogPath } from "./core-CJWLJIr6.mjs";
+import { E as withDirLock, S as workspaceStateDir, b as workspaceName, l as configDir, m as rotatedLogPath } from "./core-CmZJEFj_.mjs";
 import { closeSync, existsSync, mkdirSync, openSync, readFileSync, readSync, readdirSync, statSync } from "node:fs";
 import { homedir } from "node:os";
 import { isAbsolute, join, relative, resolve, sep } from "node:path";
+import { AsyncLocalStorage } from "node:async_hooks";
 import { StringDecoder } from "node:string_decoder";
 //#region state/json-file.ts
+const readScope = new AsyncLocalStorage();
+/**
+* Runs `fn` with each state file read from disk at most once: inside it, including after an `await`, `readStateFile`
+* returns the text of the first read of that path, and a path found missing stays missing. Callers still parse every time, so no two
+* share a mutable object. Only for computations that write none of the files they read.
+*/
+function withStateReadCache(fn) {
+	return readScope.run(/* @__PURE__ */ new Map(), fn);
+}
+function readStateFile(path) {
+	const cache = readScope.getStore();
+	if (!cache) return readFileSync(path, "utf-8");
+	const cached = cache.get(path);
+	if (cached) {
+		if ("missing" in cached) throw cached.missing;
+		return cached.text;
+	}
+	try {
+		const text = readFileSync(path, "utf-8");
+		cache.set(path, { text });
+		return text;
+	} catch (error) {
+		if (error.code === "ENOENT") cache.set(path, { missing: error });
+		throw error;
+	}
+}
 function readJsonFile(path) {
-	return JSON.parse(readFileSync(path, "utf-8"));
+	return JSON.parse(readStateFile(path));
 }
 function isJsonObject(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -106,11 +133,12 @@ function configCorrupt(reason, path = getConfigPath()) {
 }
 function loadConfig() {
 	const p = getConfigPath();
-	if (!existsSync(p)) return null;
 	let parsed;
 	try {
 		parsed = readJsonFile(p);
 	} catch (err) {
+		const code = err.code;
+		if (code === "ENOENT" || code === "ENOTDIR") return null;
 		if (!(err instanceof SyntaxError)) throw err;
 		throw configCorrupt(`is not valid JSON: ${err.message}`, p);
 	}
@@ -211,15 +239,17 @@ function ids(value) {
 }
 function readCreatedDevices() {
 	try {
-		const parsed = JSON.parse(readFileSync(createdDevicesFile(), "utf8"));
+		const parsed = JSON.parse(readStateFile(createdDevicesFile()));
 		return {
 			ios: new Set(ids(parsed?.ios)),
-			android: new Set(ids(parsed?.android))
+			android: new Set(ids(parsed?.android)),
+			web: new Set(ids(parsed?.web))
 		};
 	} catch {
 		return {
 			ios: /* @__PURE__ */ new Set(),
-			android: /* @__PURE__ */ new Set()
+			android: /* @__PURE__ */ new Set(),
+			web: /* @__PURE__ */ new Set()
 		};
 	}
 }
@@ -380,24 +410,34 @@ const ERROR_SOURCES = [
 function markerWindow(records) {
 	let launchTs = null;
 	let bundleTs = null;
+	let pageLoadTs = null;
 	for (const r of records) {
 		if (r?.marker !== true) continue;
 		const ts = tsOf(r);
 		if (ts === null) continue;
 		if (r.src === "metro") {
 			if (bundleTs === null || ts > bundleTs) bundleTs = ts;
+		} else if (isWebPageRecord(r)) {
+			if (pageLoadTs === null || ts > pageLoadTs) pageLoadTs = ts;
 		} else if (launchTs === null || ts > launchTs) launchTs = ts;
 	}
 	return {
 		launchTs,
-		bundleTs
+		bundleTs,
+		pageLoadTs
 	};
 }
+function isWebPageRecord(record) {
+	return record.platform === "web" && record.src !== "metro";
+}
+function isAppDeviceRecord(record) {
+	return record.src === "device" && (record.event === "native_crash" || record.platform === "web");
+}
 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 (sources && sources.length > 0 && !sources.includes(record.src) && !(criteria.includeAppDeviceErrors && isAppDeviceRecord(record))) return false;
 	if (minLevel && levelRank(record.level) < levelRank(minLevel)) return false;
 	if (errorsOnly) {
 		if (record.level !== "error" && record.level !== "fatal") return false;
@@ -424,7 +464,7 @@ function buildCriteria({ slot, sources, minLevel, since, grep, errorsOnly, marke
 	const criteria = {
 		...slot === void 0 ? {} : { slot },
 		errorsOnly: Boolean(errorsOnly),
-		includeNativeCrashes: Boolean(errorsOnly && !sources?.length)
+		includeAppDeviceErrors: Boolean(errorsOnly && !sources?.length)
 	};
 	if (sources && sources.length > 0) criteria.sources = sources;
 	else if (criteria.errorsOnly) criteria.sources = ERROR_SOURCES;
@@ -468,24 +508,86 @@ function isExpoErrorContext(record, event) {
 	if (record.src !== "metro" || record.raw !== true || record.event !== event || typeof record.msg !== "string") return false;
 	return /^Code: \S/.test(record.msg) || /^\s*>?\s*\d+\s*\|/.test(record.msg) || /^\s*\|\s*\^/.test(record.msg) || /^Call Stack$/.test(record.msg) || /^\s+.+\([^()]+:\d+:\d+\)\s*$/.test(record.msg) || /^\s+at\s+\S+:\d+:\d+\s*$/.test(record.msg);
 }
-function attachExpoErrorContext(all, matched) {
+function isExpoError(record) {
+	return record.src === "metro" && record.raw === true && (record.level === "error" || record.level === "fatal") && typeof record.msg === "string";
+}
+function isSameExpoStream(record, error) {
+	return record.src === "metro" && record.raw === true && record.event === error.event;
+}
+function withExpoContext(record, context, into) {
+	if (context.length === 0) return record;
+	return into === "msg" ? {
+		...record,
+		msg: [record.msg, ...context].join("\n")
+	} : {
+		...record,
+		context
+	};
+}
+/**
+* Adds the code frame and stack lines Expo printed after each Expo error record, either joined into
+* `msg` or as a `context` string array.
+*/
+function attachExpoErrorContext(all, matched, into = "msg") {
 	return matched.map((record) => {
-		if (record.src !== "metro" || record.raw !== true || record.level !== "error" && record.level !== "fatal" || typeof record.msg !== "string") return record;
+		if (!isExpoError(record)) return record;
 		const index = all.findIndex((entry) => entry.ts === record.ts && entry.src === record.src && entry.msg === record.msg && entry.event === record.event);
 		if (index === -1) return record;
 		const context = [];
 		for (let i = index + 1; i < all.length; i += 1) {
 			const next = all[i];
-			if (next.src !== "metro") continue;
+			if (!isSameExpoStream(next, record)) continue;
 			if (!isExpoErrorContext(next, record.event)) break;
 			context.push(next.msg);
 		}
-		return context.length > 0 ? {
-			...record,
-			msg: [record.msg, ...context].join("\n")
-		} : record;
+		return withExpoContext(record, context, into);
 	});
 }
+function expoContextFollower(onRecord, into) {
+	let pending = null;
+	let grew = false;
+	function flush() {
+		if (!pending) return;
+		const { record, context, queued } = pending;
+		pending = null;
+		onRecord(withExpoContext(record, context, into));
+		for (const next of queued) onRecord(next);
+	}
+	function push(record, matches) {
+		if (pending && isSameExpoStream(record, pending.record)) {
+			if (!isExpoErrorContext(record, pending.record.event)) flush();
+			else {
+				pending.context.push(record.msg);
+				if (matches) pending.queued.push(record);
+				grew = true;
+				return;
+			}
+		}
+		if (pending) {
+			if (matches) pending.queued.push(record);
+			return;
+		}
+		if (matches && isExpoError(record)) {
+			pending = {
+				record,
+				context: [],
+				queued: []
+			};
+			grew = true;
+			return;
+		}
+		if (matches) onRecord(record);
+	}
+	function settle() {
+		if (!grew) flush();
+		grew = false;
+	}
+	return {
+		push,
+		settle,
+		flush
+	};
+}
 function includeBareErrorContext(all, matched, launchTs, sinceTs) {
 	if (!matched.some((record) => record.src === "client" && (record.level === "error" || record.level === "fatal"))) return matched;
 	const renderedContext = [];
@@ -505,7 +607,7 @@ function includeBareErrorContext(all, matched, launchTs, sinceTs) {
 function launchMarkersBySlot(records) {
 	const markers = /* @__PURE__ */ new Map();
 	for (const record of records) {
-		if (record.marker !== true || record.src === "metro") continue;
+		if (record.marker !== true || record.src === "metro" || isWebPageRecord(record)) continue;
 		const ts = tsOf(record);
 		const slot = record.slot ?? "default";
 		if (ts !== null && ts > (markers.get(slot) ?? -Infinity)) markers.set(slot, ts);
@@ -515,9 +617,10 @@ function launchMarkersBySlot(records) {
 function queryLogs({ slot, dir, records, sources, minLevel, since, grep, tail, errorsOnly, errorContext, now } = {}) {
 	const all = (records ?? readLogRecords(dir)).filter((record) => slot === void 0 || (record.slot ?? "default") === slot);
 	if (all.length === 0) return [];
-	const { launchTs, bundleTs } = errorsOnly ? markerWindow(all) : {
+	const { launchTs, bundleTs, pageLoadTs } = errorsOnly ? markerWindow(all) : {
 		launchTs: null,
-		bundleTs: null
+		bundleTs: null,
+		pageLoadTs: null
 	};
 	const criteria = buildCriteria({
 		slot,
@@ -531,9 +634,14 @@ function queryLogs({ slot, dir, records, sources, minLevel, since, grep, tail, e
 		bundleMarkerTs: bundleTs === null ? void 0 : bundleTs
 	});
 	const slotMarkers = launchMarkersBySlot(all);
+	const windowStart = (record) => {
+		if (pageLoadTs !== null && isWebPageRecord(record)) return pageLoadTs - 1;
+		if (record.src === "metro" || record.src === "client") return criteria.markerTs;
+		return slotMarkers.get(record.slot ?? "default");
+	};
 	let matched = all.filter((record) => recordMatches(record, {
 		...criteria,
-		markerTs: record.src === "metro" || record.src === "client" ? criteria.markerTs : slotMarkers.get(record.slot ?? "default")
+		markerTs: windowStart(record)
 	}));
 	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;
@@ -571,7 +679,8 @@ function advanceTail(prev, chunk, size) {
 		records
 	};
 }
-function followLogs({ dir, onRecord, criteria = {}, intervalMs = 500, offsets = null }) {
+function followLogs({ dir, onRecord, criteria = {}, intervalMs = 500, offsets = null, errorContext }) {
+	const follower = errorContext ? expoContextFollower(onRecord, errorContext) : null;
 	const state = /* @__PURE__ */ new Map();
 	const decoders = /* @__PURE__ */ new Map();
 	for (const [name, size] of Object.entries(offsets || fileSizes(dir))) {
@@ -582,7 +691,11 @@ function followLogs({ dir, onRecord, criteria = {}, intervalMs = 500, offsets =
 		decoders.set(name, new StringDecoder("utf8"));
 	}
 	function emit(records) {
-		for (const record of records) if (recordMatches(record, criteria)) onRecord(record);
+		for (const record of records) {
+			const matches = recordMatches(record, criteria);
+			if (follower) follower.push(record, matches);
+			else if (matches) onRecord(record);
+		}
 	}
 	function drainRotated(name, entry) {
 		const path = rotatedLogPath(join(dir, name));
@@ -611,10 +724,12 @@ function followLogs({ dir, onRecord, criteria = {}, intervalMs = 500, offsets =
 		for (const name of logFiles(dir)) try {
 			pollFile(name);
 		} catch {}
+		follower?.settle();
 	}
 	const timer = setInterval(poll, intervalMs);
 	return function stop() {
 		clearInterval(timer);
+		follower?.flush();
 	};
 }
 function readChunk(path, decoder, start, size) {
@@ -674,6 +789,7 @@ const IOS_SIMULATOR_APPS = [
 	"stim-desktop"
 ];
 const ANDROID_EMULATOR_APPS = ["emulator", "stim-desktop"];
+const WEB_VIEWPORTS = ["desktop", "phone"];
 const PROJECT = [
 	"workspace",
 	"repo",
@@ -923,6 +1039,33 @@ const SETTINGS = [
 		default: 60,
 		description: "Minutes without a bundle request, client log or Stim command before the dev server stops; 0 never"
 	},
+	{
+		key: "web.url",
+		type: {
+			kind: "string",
+			pattern: "^https?://",
+			patternHelp: "an http:// or https:// URL; {port:<label>} is replaced by a named or the Metro port"
+		},
+		scopes: PROJECT,
+		description: "Page `stim web` opens; unset opens the Metro URL for Expo web"
+	},
+	{
+		key: "web.ignoreCertificateErrors",
+		type: BOOLEAN,
+		scopes: PROJECT,
+		default: false,
+		description: "Accept self-signed dev certificates in Stim's owned Chrome profile"
+	},
+	{
+		key: "web.viewport",
+		type: {
+			kind: "choice",
+			choices: WEB_VIEWPORTS
+		},
+		scopes: PROJECT,
+		default: "desktop",
+		description: "Viewport of the owned Chrome page: desktop, or phone for a 390x844 touch screen"
+	},
 	{
 		key: "worktree.exclude",
 		type: { kind: "strings" },
@@ -1027,7 +1170,7 @@ const SETTINGS = [
 		scopes: MACHINE,
 		default: 120,
 		env: "STIM_GC_WORKTREE_GRACE_MINUTES",
-		description: "Minutes after a linked worktree last changed, or its branch merged, before gc removes it; 0 removes it at once"
+		description: "Minutes after a linked worktree last changed, or its branch or pull request finished, before gc removes it; 0 removes it at once"
 	},
 	{
 		key: "pool.iosParkedMax",
@@ -1259,6 +1402,19 @@ const BUILD_PHASES = [
 	"install",
 	"launch"
 ];
+/** How a recorded build ended. `interrupted` is a run whose process ended without recording a result. */
+const BUILD_RESULTS = [
+	"succeeded",
+	"failed",
+	"cancelled",
+	"interrupted"
+];
+/** Every state a device's app process can report. */
+const APP_PROCESS_STATES = [
+	"running",
+	"stopped",
+	"unknown"
+];
 /** Every code a status issue can carry. */
 const STATUS_ISSUE_CODES = [
 	"port-not-ours",
@@ -1268,7 +1424,19 @@ const STATUS_ISSUE_CODES = [
 	"avd-missing",
 	"avd-not-detected",
 	"avd-unchecked",
-	"supervisor-unverified"
+	"supervisor-unverified",
+	"browser-unverified",
+	"browser-orphaned"
+];
+/** Every kind of process owner the status machine section reports. */
+const MACHINE_OWNER_KINDS = [
+	"simulator",
+	"emulator",
+	"metro",
+	"build",
+	"browser",
+	"server",
+	"shared"
 ];
 //#endregion
 //#region state/workspace-state.ts
@@ -1287,6 +1455,8 @@ const LAST_BUILD_KEYS = {
 	ios: "lastIosBuild",
 	android: "lastAndroidBuild"
 };
+const BUILD_HISTORY_KEY = "buildHistory";
+const BUILD_HISTORY_LIMIT = 10;
 const MISS_KINDS = /* @__PURE__ */ new Set([
 	"changed",
 	"no-baseline",
@@ -1335,6 +1505,25 @@ function missReason(value) {
 		rekeyedBy: Array.isArray(record.rekeyedBy) ? record.rekeyedBy.filter((step) => typeof step === "string") : []
 	};
 }
+const DIAGNOSTIC_CAP = 5;
+const positive = (value) => typeof value === "number" && Number.isInteger(value) && value > 0 ? value : null;
+/**
+* The first diagnostics of a failed build in the shape a last-build record stores and `status` reports, the
+* ones with a source position first.
+*/
+function buildDiagnostics(value) {
+	return (Array.isArray(value) ? value : []).flatMap((item) => {
+		if (!item || typeof item !== "object") return [];
+		const { file, line, column, message } = item;
+		if (typeof message !== "string" || message === "") return [];
+		return [{
+			file: typeof file === "string" && file ? file : null,
+			line: positive(line),
+			column: positive(column),
+			message
+		}];
+	}).toSorted((a, b) => Number(b.file !== null) - Number(a.file !== null)).slice(0, DIAGNOSTIC_CAP);
+}
 function lastBuildReport(platform, value) {
 	if (!value || typeof value !== "object" || Array.isArray(value)) return null;
 	const record = value;
@@ -1343,6 +1532,7 @@ function lastBuildReport(platform, value) {
 	const durationMs = typeof record.durationMs === "number" && record.durationMs >= 0 ? record.durationMs : null;
 	const finished = new Date(Date.parse(record.startedAt) + (durationMs ?? NaN));
 	const reason = record.cacheHit === "local" || record.cacheHit === "remote" ? null : missReason(record.missReason);
+	const diagnostics = record.status === "failed" ? buildDiagnostics(record.diagnostics) : [];
 	return {
 		platform,
 		status: record.status,
@@ -1353,7 +1543,8 @@ function lastBuildReport(platform, value) {
 		startedAt: record.startedAt,
 		finishedAt: Number.isNaN(finished.getTime()) ? null : finished.toISOString(),
 		...typeof record.errorCode === "string" ? { errorCode: record.errorCode } : {},
-		...reason ? { missReason: reason } : {}
+		...reason ? { missReason: reason } : {},
+		...diagnostics.length ? { diagnostics } : {}
 	};
 }
 function readLastBuilds(state) {
@@ -1364,6 +1555,41 @@ function readLastBuilds(state) {
 	}
 	return reports;
 }
+function historyPhases(value) {
+	const phases = {};
+	if (!value || typeof value !== "object" || Array.isArray(value)) return phases;
+	for (const phase of BUILD_PHASES) {
+		const ms = value[phase];
+		if (typeof ms === "number" && Number.isFinite(ms) && ms >= 0) phases[phase] = Math.round(ms);
+	}
+	return phases;
+}
+function historyEntry(platform, value) {
+	const report = lastBuildReport(platform, value);
+	if (!report) return null;
+	const record = value;
+	const result = BUILD_RESULTS.includes(record.result) ? record.result : report.status === "ok" ? "succeeded" : "failed";
+	return {
+		...report,
+		result,
+		slot: typeof record.slot === "string" && record.slot ? record.slot : "default",
+		configuration: typeof record.configuration === "string" ? record.configuration : null,
+		cacheKey: typeof record.cacheKey === "string" ? record.cacheKey : null,
+		phases: historyPhases(record.phases)
+	};
+}
+/** Each platform's recorded runs, newest first, at most `BUILD_HISTORY_LIMIT` each. */
+function readBuildHistory(state) {
+	const history = state?.[BUILD_HISTORY_KEY];
+	const builds = {};
+	for (const platform of ["ios", "android"]) {
+		const list = history?.[platform];
+		if (!Array.isArray(list)) continue;
+		const entries = list.slice(0, 10).map((value) => historyEntry(platform, value)).filter((entry) => entry !== null);
+		if (entries.length) builds[platform] = entries;
+	}
+	return builds;
+}
 function readWorkspaceState(root) {
 	return readJsonObject(workspaceStateFile(root));
 }
@@ -1391,4 +1617,4 @@ function workspaceLastUsed(root) {
 	return lastUseFrom(readWorkspaceState(root), mtimes);
 }
 //#endregion
-export { ANDROID_COMPILER_CACHE_CHOICES, ANDROID_EMULATOR_APPS, ANDROID_PCH_CHOICES, BUILD_PHASES, ERROR_SOURCES, IDLE_STOP_KEY, IOS_SIMULATOR_APPS, LAST_BUILD_KEYS, LEVELS, REMOTE_DEVICE_BACKENDS, SETTINGS, SETTINGS_SCHEMA_FILE, SETTINGS_SCHEMA_URL, SETTING_GROUPS, SETTING_SCOPES, SOURCES, STATUS_ISSUE_CODES, TUNNEL_MODES, acceptsShape, advanceTail, allMetroPorts, attachExpoErrorContext, buildCriteria, coerceSettingText, compileGrep, configCorruptRepair, configLockPath, createdDevicesFile, createdDevicesLock, easMachineStateRoot, easSessionLedgerFile, easSessionLedgerLock, emulatorLogFile, expectedShape, fileSizes, findEnclosingWorktreeRoot, findProjectByMetroPort, followLogs, getConcurrencyLimits, getConfigPath, getProject, getProjectSetting, getProjectSettings, getRepoSettings, gitMergeCacheDir, isJsonObject, isLayeredSetting, isPathPrefix, isSensitiveReference, lastUseFrom, levelRank, loadConfig, logFiles, markerWindow, parseNdjsonLine, parseNdjsonText, parseSince, queryLogs, readCreatedDevices, readEasSessionLedger, readIdleStop, readJsonFile, readJsonObject, readLastBuilds, readLogRecords, readNdjsonGenerations, readWorkspaceState, recordMatches, settingDefinition, settingValueError, settingsJsonSchema, sharedCcache, sharedCompilationCache, sharedGradle, sharedPods, sortByTs, supervisorLogFile, supervisorPidFile, tailRead, validEasSessionClaim, withConfigLock, workspaceDerivedData, workspaceGradleBuild, workspaceLastUsed, workspaceLogErrorIndex, workspaceLogsDir, workspaceMetadataFile, workspaceStateFile, workspaceStateLock };
+export { ANDROID_COMPILER_CACHE_CHOICES, ANDROID_EMULATOR_APPS, ANDROID_PCH_CHOICES, APP_PROCESS_STATES, BUILD_HISTORY_KEY, BUILD_HISTORY_LIMIT, BUILD_PHASES, BUILD_RESULTS, ERROR_SOURCES, IDLE_STOP_KEY, IOS_SIMULATOR_APPS, LAST_BUILD_KEYS, LEVELS, MACHINE_OWNER_KINDS, REMOTE_DEVICE_BACKENDS, SETTINGS, SETTINGS_SCHEMA_FILE, SETTINGS_SCHEMA_URL, SETTING_GROUPS, SETTING_SCOPES, SOURCES, STATUS_ISSUE_CODES, TUNNEL_MODES, WEB_VIEWPORTS, acceptsShape, advanceTail, allMetroPorts, attachExpoErrorContext, buildCriteria, buildDiagnostics, coerceSettingText, compileGrep, configCorruptRepair, configLockPath, createdDevicesFile, createdDevicesLock, easMachineStateRoot, easSessionLedgerFile, easSessionLedgerLock, emulatorLogFile, expectedShape, fileSizes, findEnclosingWorktreeRoot, findProjectByMetroPort, followLogs, getConcurrencyLimits, getConfigPath, getProject, getProjectSetting, getProjectSettings, getRepoSettings, gitMergeCacheDir, isJsonObject, isLayeredSetting, isPathPrefix, isSensitiveReference, lastUseFrom, levelRank, loadConfig, logFiles, markerWindow, parseNdjsonLine, parseNdjsonText, parseSince, queryLogs, readBuildHistory, readCreatedDevices, readEasSessionLedger, readIdleStop, readJsonFile, readJsonObject, readLastBuilds, readLogRecords, readNdjsonGenerations, readStateFile, readWorkspaceState, recordMatches, settingDefinition, settingValueError, settingsJsonSchema, sharedCcache, sharedCompilationCache, sharedGradle, sharedPods, sortByTs, supervisorLogFile, supervisorPidFile, tailRead, validEasSessionClaim, withConfigLock, withStateReadCache, workspaceDerivedData, workspaceGradleBuild, workspaceLastUsed, workspaceLogErrorIndex, workspaceLogsDir, workspaceMetadataFile, workspaceStateFile, workspaceStateLock };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stim-cli/core",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "description": "Shared internal cache and runtime primitives for Stim packages.",
   "license": "MIT",
   "repository": {