@stim-cli/core 1.11.0 → 1.12.0

package/dist/state.d.mts

@@ -25,6 +25,7 @@ interface AndroidDeviceRecord {
   deviceName?: string | null;
   owned?: boolean;
   setupIncomplete?: boolean;
+  bootPending?: boolean;
   [key: string]: unknown;
 }
 type DeviceRecord = IosDeviceRecord | AndroidDeviceRecord;
@@ -296,6 +297,7 @@ type SettingType = {
  * `.stim.json` instead of the app's. A `sensitive` value is never printed and is
  * written to `.stim.json` only as an `env:` or `file:` reference. `scopedHomeValue`
  * replaces every layer and the default while STIM_HOME is set and `env` is not.
+ * `desktopDefault` replaces `default` on macOS while Stim Desktop is installed.
  */
 interface SettingDefinition {
   key: string;
@@ -307,6 +309,7 @@ interface SettingDefinition {
   sensitive?: boolean;
   committedAt?: "repository";
   scopedHomeValue?: number;
+  desktopDefault?: string;
 }
 interface SettingEntry {
   key: string;
@@ -318,6 +321,7 @@ interface SettingEntry {
     value: string;
   };
   sensitive?: true;
+  defaultReason?: string;
 }
 /** The payload `stim settings --json` prints. */
 interface SettingsPayload {
@@ -430,9 +434,11 @@ interface BuildMissChange {
 /**
  * Why a run compiled instead of installing a cached app. `changes` holds at most 20 entries,
  * ordered by importance; `changeCount` is the full number of changed fingerprint sources.
+ * Only a plan reports `prebuild-pending`: the run would prebuild before compiling, so the changes
+ * compare the fingerprint before that prebuild.
  */
 interface BuildMissReason {
-  kind: "changed" | "no-baseline" | "same-sources" | "cache-skipped" | "fingerprint-error";
+  kind: "changed" | "no-baseline" | "same-sources" | "cache-skipped" | "fingerprint-error" | "prebuild-pending";
   summary: string;
   changes: BuildMissChange[];
   changeCount: number;
@@ -457,6 +463,8 @@ interface BuildPlanPayload {
   outcome: RunOutcomeKind | null;
   expectedMs: number | null;
   basis: number;
+  /** On a predicted miss with cache reads on, why the cache has no app; `baseline` omits `cacheKey`. */
+  missReason?: BuildMissReason;
   refusal?: {
     code: string;
     message: string;
@@ -510,6 +518,21 @@ interface RemoteDeviceState {
   startedAt: string | null;
   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"];
+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
+ * for the default device slot. `warnings` carries the same issues as text.
+ */
+interface StatusIssue {
+  code: StatusIssueCode;
+  severity: "error" | "warning";
+  message: string;
+  remedy: string;
+  workspace: string;
+  slot?: string;
+}
 interface EnvironmentState {
   slots?: {
     slot: string;
@@ -520,6 +543,7 @@ interface EnvironmentState {
   live: boolean;
   memoryMb: number;
   warnings: string[];
+  issues: StatusIssue[];
   ios?: {
     name: string | null;
     udid: string;
@@ -533,6 +557,7 @@ interface EnvironmentState {
     physical: boolean;
     serial?: string | null;
     state?: AndroidRuntimeFacts["state"];
+    deviceProfile?: string | null;
     activity?: DeviceActivity;
   } | null;
   metro?: {
@@ -586,4 +611,4 @@ interface StatusPayload {
   simctlAvailable: boolean;
 }
 //#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, SettingDefinition, SettingEntry, SettingScope, SettingType, SettingsObject, SettingsPayload, StatsPlatform, StatusCapacity, 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, 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 };

package/dist/state.mjs

@@ -957,7 +957,8 @@ const SETTINGS = [
 		},
 		scopes: MACHINE,
 		default: "xcode",
-		description: "App that displays an owned iOS simulator"
+		desktopDefault: "stim-desktop",
+		description: "App that displays an owned iOS simulator; stim-desktop by default when Stim Desktop is installed"
 	},
 	{
 		key: "androidEmulatorApp",
@@ -967,7 +968,8 @@ const SETTINGS = [
 		},
 		scopes: MACHINE,
 		default: "emulator",
-		description: "App that displays an owned Android emulator Stim boots on macOS"
+		desktopDefault: "stim-desktop",
+		description: "App that displays an owned Android emulator Stim boots on macOS; stim-desktop by default when Stim Desktop is installed"
 	},
 	{
 		key: "concurrency.maxBuilds",
@@ -1019,6 +1021,14 @@ const SETTINGS = [
 		scopedHomeValue: 0,
 		description: "Live workspaces before idle ones are reclaimed; unset or 0 means no limit"
 	},
+	{
+		key: "gc.worktreeGraceMinutes",
+		type: CAPACITY,
+		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"
+	},
 	{
 		key: "pool.iosParkedMax",
 		type: PARKED_MAX,
@@ -1249,6 +1259,17 @@ const BUILD_PHASES = [
 	"install",
 	"launch"
 ];
+/** Every code a status issue can carry. */
+const STATUS_ISSUE_CODES = [
+	"port-not-ours",
+	"sim-missing",
+	"sim-without-metro",
+	"avd-serial-changed",
+	"avd-missing",
+	"avd-not-detected",
+	"avd-unchecked",
+	"supervisor-unverified"
+];
 //#endregion
 //#region state/workspace-state.ts
 const IDLE_STOP_KEY = "devServerStop";
@@ -1370,4 +1391,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, 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, 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 };

package/package.json

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