stim 1.17.2 → 1.19.0

package/dist/settings.schema.json

@@ -275,7 +275,7 @@
           }
         },
         "remote": {
-          "description": "Default iOS remote target: eas, proxy, or an approved Mac in remote.machines; auto places on an approved Mac when this Mac is full or busy",
+          "description": "Default iOS remote target: eas, proxy, or an approved Mac in remote.machines; auto places on an approved Mac when this Mac is full or busy; local runs here, overriding a lower layer",
           "type": "string",
           "pattern": "^[A-Za-z0-9][A-Za-z0-9.-]*(?::(?!0+$)(?:[0-5]?[0-9]{1,4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))?$",
           "x-stim": {
@@ -464,7 +464,7 @@
           }
         },
         "remote": {
-          "description": "Default Android remote target: eas, proxy, or an approved Mac in remote.machines; auto places on an approved Mac when this Mac is full or busy",
+          "description": "Default Android remote target: eas, proxy, or an approved Mac in remote.machines; auto places on an approved Mac when this Mac is full or busy; local runs here, overriding a lower layer",
           "type": "string",
           "pattern": "^[A-Za-z0-9][A-Za-z0-9.-]*(?::(?!0+$)(?:[0-5]?[0-9]{1,4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))?$",
           "x-stim": {
@@ -854,6 +854,47 @@
       },
       "additionalProperties": false
     },
+    "maintenance": {
+      "type": "object",
+      "properties": {
+        "keep": {
+          "description": "Pin this workspace: automatic maintenance never clears its build outputs or removes its worktree",
+          "type": "boolean",
+          "default": false,
+          "x-stim": {
+            "key": "maintenance.keep",
+            "kind": "boolean",
+            "scopes": [
+              "workspace",
+              "repo",
+              "committed"
+            ]
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "remote": {
+      "type": "object",
+      "properties": {
+        "easFallback": {
+          "description": "When ios.remote or android.remote is auto, this Mac is at its concurrency.maxDevices cap and no Mac in remote.machines takes the run, run the simulator or emulator on a billed EAS Simulator instead of waiting or refusing, when eas-cli can",
+          "type": "boolean",
+          "default": false,
+          "x-stim": {
+            "key": "remote.easFallback",
+            "kind": "boolean",
+            "scopes": [
+              "machine",
+              "workspace",
+              "repo",
+              "committed"
+            ]
+          }
+        }
+      },
+      "additionalProperties": false
+    },
     "$schema": {
       "type": "string"
     }
@@ -1119,7 +1160,7 @@
               }
             },
             "remote": {
-              "description": "Default iOS remote target: eas, proxy, or an approved Mac in remote.machines; auto places on an approved Mac when this Mac is full or busy",
+              "description": "Default iOS remote target: eas, proxy, or an approved Mac in remote.machines; auto places on an approved Mac when this Mac is full or busy; local runs here, overriding a lower layer",
               "type": "string",
               "pattern": "^[A-Za-z0-9][A-Za-z0-9.-]*(?::(?!0+$)(?:[0-5]?[0-9]{1,4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))?$",
               "x-stim": {
@@ -1169,7 +1210,7 @@
               }
             },
             "remote": {
-              "description": "Default Android remote target: eas, proxy, or an approved Mac in remote.machines; auto places on an approved Mac when this Mac is full or busy",
+              "description": "Default Android remote target: eas, proxy, or an approved Mac in remote.machines; auto places on an approved Mac when this Mac is full or busy; local runs here, overriding a lower layer",
               "type": "string",
               "pattern": "^[A-Za-z0-9][A-Za-z0-9.-]*(?::(?!0+$)(?:[0-5]?[0-9]{1,4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))?$",
               "x-stim": {
@@ -1528,13 +1569,14 @@
           "type": "object",
           "properties": {
             "mode": {
-              "description": "Automatic resource maintenance. report measures, plans and logs what it would do and never deletes or stops anything; off disables it. Off under STIM_HOME or CI unless STIM_MAINTENANCE is set",
+              "description": "Automatic resource maintenance. on removes what gc would remove under the caps and floors below and logs every action; report measures, plans and logs what it would do and never deletes anything; off disables it. Off under STIM_HOME or CI unless STIM_MAINTENANCE is set",
               "type": "string",
               "enum": [
                 "off",
-                "report"
+                "report",
+                "on"
               ],
-              "default": "report",
+              "default": "on",
               "x-stim": {
                 "key": "maintenance.mode",
                 "kind": "choice",
@@ -1687,6 +1729,75 @@
                 "env": "STIM_MAINTENANCE_CAP_TARGET_PERCENT"
               }
             },
+            "worktreeCheckMinutes": {
+              "description": "Finished-worktree check interval in minutes",
+              "type": "integer",
+              "minimum": 1,
+              "default": 15,
+              "x-stim": {
+                "key": "maintenance.worktreeCheckMinutes",
+                "kind": "number",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_MAINTENANCE_WORKTREE_CHECK_MINUTES"
+              }
+            },
+            "sweepHours": {
+              "description": "Age sweep interval in hours; 0 turns the age sweep off",
+              "type": "integer",
+              "minimum": 0,
+              "default": 24,
+              "x-stim": {
+                "key": "maintenance.sweepHours",
+                "kind": "number",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_MAINTENANCE_SWEEP_HOURS"
+              }
+            },
+            "olderThanDays": {
+              "description": "Age in days for the age sweep: unused workspace build outputs and shared cache entries",
+              "type": "integer",
+              "minimum": 1,
+              "default": 7,
+              "x-stim": {
+                "key": "maintenance.olderThanDays",
+                "kind": "number",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_MAINTENANCE_OLDER_THAN_DAYS"
+              }
+            },
+            "protectRecentHours": {
+              "description": "Cache entries used within this many hours are never evicted",
+              "type": "integer",
+              "minimum": 0,
+              "default": 2,
+              "x-stim": {
+                "key": "maintenance.protectRecentHours",
+                "kind": "number",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_MAINTENANCE_PROTECT_RECENT_HOURS"
+              }
+            },
+            "removeFinishedWorktrees": {
+              "description": "Remove clean linked worktrees whose branch or pull request finished, under gc.worktreeGraceMinutes",
+              "type": "boolean",
+              "default": true,
+              "x-stim": {
+                "key": "maintenance.removeFinishedWorktrees",
+                "kind": "boolean",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_MAINTENANCE_REMOVE_FINISHED_WORKTREES"
+              }
+            },
             "workspaceOutputsMaxGb": {
               "description": "Workspace build-output cap in GiB; 0 means no cap",
               "type": "number",
@@ -1749,6 +1860,20 @@
                 "env": "STIM_CACHES_SWIFT_COMPILATION_CACHE_MAX_GB"
               }
             },
+            "ccacheMaxGb": {
+              "description": "ccache size limit in GiB, passed to ccache as CCACHE_MAXSIZE; ccache evicts by itself",
+              "type": "number",
+              "exclusiveMinimum": 0,
+              "default": 5,
+              "x-stim": {
+                "key": "caches.ccacheMaxGb",
+                "kind": "number",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_CACHES_CCACHE_MAX_GB"
+              }
+            },
             "buildCache": {
               "description": "Absolute path of the shared build cache",
               "type": "string",
@@ -1832,6 +1957,25 @@
           },
           "additionalProperties": false
         },
+        "debug": {
+          "type": "object",
+          "properties": {
+            "logs": {
+              "description": "Debug-level logging. While on, the CLI records its commands, child processes and requests to other Macs, and stim-server records every request with its timings, under STIM_HOME/logs/debug/ with rotation. Nothing is sent anywhere, and records never carry arguments, tokens or tickets",
+              "type": "boolean",
+              "default": false,
+              "x-stim": {
+                "key": "debug.logs",
+                "kind": "boolean",
+                "scopes": [
+                  "machine"
+                ],
+                "env": "STIM_DEBUG"
+              }
+            }
+          },
+          "additionalProperties": false
+        },
         "hosting": {
           "type": "object",
           "properties": {
@@ -1928,8 +2072,53 @@
                 ]
               }
             },
+            "buildPoolDisabled": {
+              "description": "Members excluded from this requester's automatic build placement: local or exact remote.machines entries. Explicit placement and running builds are unaffected; at least one local or configured, approved remote member must stay enabled",
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "default": [],
+              "x-stim": {
+                "key": "remote.buildPoolDisabled",
+                "kind": "strings",
+                "scopes": [
+                  "machine"
+                ]
+              }
+            },
+            "devicePoolDisabled": {
+              "description": "Members excluded from this requester's automatic simulator and emulator placement: local or exact remote.machines entries. Explicit placement and existing sessions are unaffected; at least one local or configured, approved remote member must stay enabled",
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "default": [],
+              "x-stim": {
+                "key": "remote.devicePoolDisabled",
+                "kind": "strings",
+                "scopes": [
+                  "machine"
+                ]
+              }
+            },
+            "easFallback": {
+              "description": "When ios.remote or android.remote is auto, this Mac is at its concurrency.maxDevices cap and no Mac in remote.machines takes the run, run the simulator or emulator on a billed EAS Simulator instead of waiting or refusing, when eas-cli can",
+              "type": "boolean",
+              "default": false,
+              "x-stim": {
+                "key": "remote.easFallback",
+                "kind": "boolean",
+                "scopes": [
+                  "machine",
+                  "workspace",
+                  "repo",
+                  "committed"
+                ]
+              }
+            },
             "build": {
-              "description": "Build placement: auto follows remote.buildMode with local fallback; local always builds here; a name in remote.machines requires that remote Mac without fallback. The ios, android and macos --remote-build flag overrides this setting and its environment override",
+              "description": "Build placement: auto follows remote.buildMode within enabled automatic pool members; local always builds here; a name in remote.machines requires that remote Mac without fallback. The ios, android and macos --remote-build flag overrides this setting and its environment override",
               "type": "string",
               "pattern": "^[A-Za-z0-9][A-Za-z0-9.-]*(?::(?!0+$)(?:[0-5]?[0-9]{1,4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))?$",
               "default": "auto",
@@ -1943,7 +2132,7 @@
               }
             },
             "buildMode": {
-              "description": "When remote.build is auto, where iOS simulator Debug, Android emulator debug and macOS SwiftPM Debug builds run: auto builds here while this Mac has a free concurrency.maxBuilds slot and its load is under server.maxLoadPerCore, and otherwise builds on a less loaded Mac in remote.machines; force builds on a remote Mac whenever one can take the build; off always builds here",
+              "description": "When remote.build is auto, where iOS simulator Debug, Android emulator debug and macOS SwiftPM Debug builds run: auto builds here while this Mac has a free concurrency.maxBuilds slot and its load is under server.maxLoadPerCore, and otherwise builds on a less loaded Mac in remote.machines; force builds on an enabled remote Mac whenever one can take the build; off builds here when local is enabled in remote.buildPoolDisabled",
               "type": "string",
               "enum": [
                 "auto",

package/dist/{simslim-BWNrc3M3.mjs → simslim-D9LkJxIO.mjs}

@@ -1,13 +1,13 @@
-import { t as getExecutor } from "./exec-CaErVv7t.mjs";
-import { d as getConfigDir } from "./config-D0DbpZtM.mjs";
-import { n as ownership_claim_exports, t as process_identity_exports } from "./process-identity-BmRm1qV0.mjs";
+import { n as ownership_claim_exports, t as process_identity_exports } from "./process-identity-Biv3arCO.mjs";
+import { t as getExecutor } from "./exec-i8GDPwq9.mjs";
 import { n as stripAnsi, r as waitForChild, t as createLineReader } from "./process-output-Fpl8PYi8.mjs";
-import { g as releaseBuildLock, m as acquireBuildLock } from "./device-lease-DpoS36_u.mjs";
-import { f as resolveEasCliBin } from "./remote-cache-Ci4DQYYj.mjs";
-import { _ as easCliSupport, s as readInstalledEasCliVersion, v as easCliUpgradeRemedy } from "./device-remote-hFSkpfQu.mjs";
-import { createHash } from "node:crypto";
+import { d as getConfigDir } from "./config-DC5jEtd1.mjs";
+import { g as releaseBuildLock, m as acquireBuildLock } from "./device-lease-Cu7PtQpZ.mjs";
+import { f as resolveEasCliBin } from "./remote-cache-N3hAEaAL.mjs";
+import { s as readInstalledEasCliVersion, v as easCliSupport, y as easCliUpgradeRemedy } from "./device-remote-B5GiUifk.mjs";
 import { existsSync, realpathSync, statSync } from "node:fs";
 import { join } from "node:path";
+import { createHash } from "node:crypto";
 //#region src/engine/eas-build.ts
 const MIN_EAS_CLI_BUILD_DOWNLOAD_VERSION = "18.9.0";
 function isEasBuildFailure(result) {

package/dist/{slot-launch-DmjBmpQV.mjs → slot-launch-HV_KtPIw.mjs}

@@ -1,9 +1,9 @@
-import { B as parseDeviceSlotKey, H as projectDeviceSlots, p as getProject } from "./config-D0DbpZtM.mjs";
-import { r as readWorkspaceState$1 } from "./workspace-state-DqcCbpE7.mjs";
-import { n as fileLeaseIo } from "./device-lease-DpoS36_u.mjs";
-import { E as getAvdNameForSerial, O as listAdbDevices } from "./android-B_YNZy61.mjs";
-import { u as listAllIosSims } from "./ios-DSfnPfse.mjs";
-import { f as deviceShellArg } from "./app-install-VPkI5WEg.mjs";
+import { B as parseDeviceSlotKey, H as projectDeviceSlots, p as getProject } from "./config-DC5jEtd1.mjs";
+import { r as readWorkspaceState$1 } from "./workspace-state-CR9X86xJ.mjs";
+import { n as fileLeaseIo } from "./device-lease-Cu7PtQpZ.mjs";
+import { E as getAvdNameForSerial, O as listAdbDevices } from "./android-BdQC6zs1.mjs";
+import { d as listAllIosSims } from "./ios-BWbHFZVz.mjs";
+import { f as deviceShellArg } from "./app-install-CFI4ptUL.mjs";
 import { hostedNativeRecords } from "@stim-cli/core/state";
 //#region src/engine/slot-launch.ts
 function launchSlotScope(root, slot = "default") {

package/dist/{spawn-claims-D0XfSe8u.mjs → spawn-claims-Kqiifsk2.mjs}

@@ -1,4 +1,4 @@
-import { n as ownership_claim_exports, t as process_identity_exports } from "./process-identity-BmRm1qV0.mjs";
+import { n as ownership_claim_exports, t as process_identity_exports } from "./process-identity-Biv3arCO.mjs";
 //#region src/engine/spawn-claims.ts
 const declaring = /* @__PURE__ */ new Set();
 const running = /* @__PURE__ */ new Set();

package/dist/{spawn-entry-jw19m8Nl.mjs → spawn-entry-Dcb7sDUz.mjs}

@@ -2,6 +2,7 @@ import { basename, dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 //#region src/spawn-entry.ts
 const DEV_ENTRIES = {
+	"api-run": "./api-run.ts",
 	"supervisor-run": "./supervisor/run.ts",
 	"collector-run": "./collector/run.ts",
 	"web-run": "./web/run.ts",

package/dist/{stage-CzaiwFsI.mjs → stage-BgaZJVZY.mjs}

@@ -1,4 +1,4 @@
-import { t as getExecutor } from "./exec-CaErVv7t.mjs";
+import { t as getExecutor } from "./exec-i8GDPwq9.mjs";
 import { cpSync, existsSync, mkdirSync, readdirSync, realpathSync, rmSync, statSync } from "node:fs";
 import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { validMacosResourceDestination } from "@stim-cli/core";
@@ -19,6 +19,16 @@ function validateInfoPlist(root, product, infoPlist) {
 		minimumSystemVersion: plist.LSMinimumSystemVersion
 	};
 }
+function setBundleName(plistPath, name) {
+	const exec = getExecutor();
+	for (const key of ["CFBundleDisplayName", "CFBundleName"]) exec.runFile("plutil", [
+		"-replace",
+		key,
+		"-string",
+		name,
+		plistPath
+	]);
+}
 function resourceError(key, entry, reason) {
 	throw new Error(`${key} entry ${JSON.stringify(entry)}: ${reason}. See stim guide macos.`);
 }
@@ -73,7 +83,7 @@ function resolveBundleExtras(root, repository, resources = {}, assetCatalog) {
 		assetCatalog: catalog
 	};
 }
-function stageBundle(root, product, infoPlist, bin, bundle, bundleId, extras = { resources: {} }) {
+function stageBundle(root, product, infoPlist, bin, bundle, bundleId, extras = { resources: {} }, displayName) {
 	const { minimumSystemVersion } = validateInfoPlist(root, product, infoPlist);
 	for (const entry of readdirSync(bin).filter((name) => name.endsWith(".bundle"))) for (const [destination, source] of Object.entries(extras.resources)) if (overlaps(destination, entry)) resourceError(`macos.resources[${JSON.stringify(destination)}]`, source, `destination collides with ${entry}`);
 	const exec = getExecutor();
@@ -93,6 +103,7 @@ function stageBundle(root, product, infoPlist, bin, bundle, bundleId, extras = {
 		`Set :CFBundleIdentifier ${bundleId}`,
 		join(contents, "Info.plist")
 	]);
+	if (displayName !== void 0) setBundleName(join(contents, "Info.plist"), displayName);
 	for (const entry of readdirSync(bin)) if (entry.endsWith(".framework")) {
 		const target = join(contents, "Frameworks", entry);
 		cpSync(join(bin, entry), target, {
@@ -140,4 +151,4 @@ function stageBundle(root, product, infoPlist, bin, bundle, bundleId, extras = {
 	]);
 }
 //#endregion
-export { stageBundle as n, validateInfoPlist as r, resolveBundleExtras as t };
+export { validateInfoPlist as i, setBundleName as n, stageBundle as r, resolveBundleExtras as t };

package/dist/{start-AlfCPRVU.mjs → start-D8NbxNBb.mjs}

@@ -1,2 +1,2 @@
-import { a as registerStart, c as startDevServer, d as tailLines, f as wantsExpoOwnTunnel, i as readLogTail, l as startFacts, n as liveSupervisor, o as resolveWorkspaceMetroPort, r as parseWait, s as startCommand, t as failureEvidence, u as supervisorEntry } from "./start-DUz3mYdb.mjs";
+import { a as registerStart, c as startDevServer, d as tailLines, f as wantsExpoOwnTunnel, i as readLogTail, l as startFacts, n as liveSupervisor, o as resolveWorkspaceMetroPort, r as parseWait, s as startCommand, t as failureEvidence, u as supervisorEntry } from "./start-DtxthMfI.mjs";
 export { startCommand as default, failureEvidence, liveSupervisor, parseWait, readLogTail, registerStart, resolveWorkspaceMetroPort, startDevServer, startFacts, supervisorEntry, tailLines, wantsExpoOwnTunnel };

package/dist/{start-DUz3mYdb.mjs → start-DtxthMfI.mjs}

@@ -1,28 +1,27 @@
-import { t as getExecutor } from "./exec-CaErVv7t.mjs";
-import { E as upsertProject, p as getProject } from "./config-D0DbpZtM.mjs";
-import { t as process_identity_exports } from "./process-identity-BmRm1qV0.mjs";
-import { n as windowsLauncherArgs } from "./detached-entry-CiTEgMR1.mjs";
-import { _ as stepTimer, l as phaseLine } from "./command-output-CDAIFD-8.mjs";
-import { G as detectProviders, H as unknownSettingKeys, K as planMetroReach, M as remoteIosSetting, N as resolveCacheProviderConfig, P as resolveSettings, R as settingShapeErrors, S as metroTunnelSettingError, V as tunnelModeSetting, W as PUBLIC_METRO_ENV, b as metroIdleStopMinutesSetting, d as deviceIdleShutdownMinutesSetting, gt as repoRoot, i as SETTING_SHAPE_REMEDY, it as gitCommonDir, j as remoteAndroidSetting, k as publicUrlSetting, u as cacheProviderSettingError, w as ngrokUrlSetting, x as metroPortSetting } from "./settings-Cfd-0r2d.mjs";
-import { f as readAppConfigText, n as appProjectProblem, p as readAppJson, r as detectIsExpo, s as findProjectRoot$1, t as NO_PROJECT_REFUSAL } from "./project-D47Rh0ly.mjs";
-import { l as resolveProjectMetro, o as pidExists, p as reserveMetroPort, u as signalProcessTree } from "./metro-g8NqiJp-.mjs";
-import { c as writeWorkspaceState, g as workspaceAgentDeviceDir, i as recordWorkspaceUse, m as supervisorLogFile, n as clearWorkspaceStateKeys, r as readWorkspaceState$1, u as ensureWorkspaceStorage, x as workspaceLogsDir$1 } from "./workspace-state-DqcCbpE7.mjs";
-import { l as stopOwnedMetroForReset, t as budgetGate } from "./budget-DfcgFdQB.mjs";
-import { c as readMetroTunnel, i as clearManagedMetroTunnel } from "./state-BKa8wNN5.mjs";
-import { a as workspaceLinks, i as workspaceLinkLine } from "./stim-desktop-Cnz8CPnl.mjs";
-import { a as terminateChild, c as withManagedTunnelLock, i as stopTunnel, o as withManagedRemoteWorktreeLock, r as startTunnelSequence, t as resolveSupervisorTarget } from "./ownership-BMLqyBgJ.mjs";
-import { n as workspaceProcessLockError, t as withWorkspaceProcessLock } from "./workspace-process-lock-2mNzOlaB.mjs";
-import { i as levelRank } from "./ndjson-PclOIwVY.mjs";
-import { t as spawnEntry } from "./spawn-entry-jw19m8Nl.mjs";
-import { d as readProjectConfig } from "./remote-cache-Ci4DQYYj.mjs";
+import { t as process_identity_exports } from "./process-identity-Biv3arCO.mjs";
+import { t as getExecutor } from "./exec-i8GDPwq9.mjs";
+import { t as spawnEntry } from "./spawn-entry-Dcb7sDUz.mjs";
+import { _ as stepTimer, l as phaseLine } from "./command-output-Bt8ygHE7.mjs";
+import { E as upsertProject, p as getProject } from "./config-DC5jEtd1.mjs";
+import { c as writeWorkspaceState, g as workspaceAgentDeviceDir, i as recordWorkspaceUse, m as supervisorLogFile, n as clearWorkspaceStateKeys, r as readWorkspaceState$1, u as ensureWorkspaceStorage, x as workspaceLogsDir$1 } from "./workspace-state-CR9X86xJ.mjs";
+import { E as readMetroTunnel, S as clearManagedMetroTunnel, _ as readAppJson, g as readAppConfigText, p as detectIsExpo, r as findProjectRoot, s as projectProblem, t as NO_PROJECT_REFUSAL } from "./project-B5eQ1USs.mjs";
+import { A as publicUrlSetting, B as settingShapeErrors, F as resolveCacheProviderConfig, I as resolveSettings, J as planMetroReach, K as PUBLIC_METRO_ENV, M as remoteAndroidSetting, P as remoteIosSetting, S as metroTunnelSettingError, U as tunnelModeSetting, W as unknownSettingKeys, b as metroIdleStopMinutesSetting, d as deviceIdleShutdownMinutesSetting, i as SETTING_SHAPE_REMEDY, mt as repoRoot, nt as gitCommonDir, q as detectProviders, u as cacheProviderSettingError, w as ngrokUrlSetting, x as metroPortSetting } from "./settings-CxgngUZk.mjs";
+import { d as signalProcessTree, g as PortInspectionError, h as PORT_INSPECTION_REMEDY, m as reserveMetroPort, s as pidExists, u as resolveProjectMetro } from "./metro-DI2AjPF_.mjs";
+import { d as stopOwnedMetroForReset, t as budgetGate } from "./budget-Dz-kyXLv.mjs";
+import { _ as terminateChild, b as withManagedTunnelLock, g as stopTunnel, h as startTunnelSequence, m as resolveSupervisorTarget, v as withManagedRemoteWorktreeLock } from "./workspaces-Djb2gfi9.mjs";
+import { a as workspaceLinks, i as workspaceLinkLine } from "./stim-desktop-C65jk_q2.mjs";
+import { a as withWorkspaceProcessLock, o as workspaceProcessLockError } from "./named-ports-B4iWH4E-.mjs";
+import { i as levelRank } from "./ndjson-LGZAMsqa.mjs";
+import { d as readProjectConfig } from "./remote-cache-N3hAEaAL.mjs";
+import { n as windowsLauncherArgs } from "./detached-entry-pB_IPfV4.mjs";
 import { appendFileSync, mkdirSync, openSync, readFileSync } from "node:fs";
 import { dirname } from "node:path";
-import { EventEmitter } from "node:events";
-import { existsSync as existsSync$1, readFileSync as readFileSync$1, readdirSync as readdirSync$1 } from "fs";
 import { join as join$1 } from "path";
 import { IDLE_STOP_KEY, queryLogs } from "@stim-cli/core/state";
 import chalk from "chalk";
+import { existsSync as existsSync$1, readFileSync as readFileSync$1, readdirSync as readdirSync$1 } from "fs";
 import { CACHE_PROVIDER_ENV, cacheProviderEnv } from "@stim-cli/cache";
+import { EventEmitter } from "node:events";
 //#region src/workspace/app-id.ts
 function configString(config, platform, key) {
 	if (!config || typeof config !== "object") return null;
@@ -251,13 +250,13 @@ function registerStart(program, overrides = {}) {
 			remedy: "Pass a whole number of seconds, e.g. --wait 90."
 		});
 		const waitSeconds = wait.seconds;
-		const root = findProjectRoot$1(process.cwd());
+		const root = findProjectRoot(process.cwd());
 		if (!root) return fail(NO_PROJECT_REFUSAL);
-		const projectProblem = appProjectProblem(root);
-		if (projectProblem) return fail({
+		const problem = projectProblem(root, "dev-server");
+		if (problem) return fail({
 			code: "STIM_NO_PROJECT",
-			message: projectProblem.message,
-			remedy: projectProblem.remedy
+			message: problem.message,
+			remedy: problem.remedy
 		});
 		try {
 			ensureWorkspaceStorage(root);
@@ -973,7 +972,7 @@ async function resolveWorkspaceMetroPort(root, note, command, reserve = true) {
 	const pinned = setting.port;
 	const project = getProject(root);
 	const recorded = project?.metroPort;
-	if (pinned === null && command === "web") return recorded ?? await reserveMetroPort(root);
+	if (pinned === null && command === "web") return recorded ?? await reservePort(root, null);
 	if (recorded) {
 		const supervisor = resolveSupervisorTarget({
 			state: readWorkspaceState$1(root)?.supervisor,
@@ -1005,17 +1004,25 @@ async function resolveWorkspaceMetroPort(root, note, command, reserve = true) {
 	} else if (recorded) {
 		const held = await resolveProjectMetro(recorded, root);
 		if (!held.notOurs) return recorded;
-		const fresh = await reserveMetroPort(root);
-		if (fresh !== recorded) {
+		const fresh = await reservePort(root, null);
+		if (typeof fresh === "number" && fresh !== recorded) {
 			note(chalk.yellow(`Port ${recorded} is held by something else (${held.notOurs}).`));
 			note(chalk.dim(`Reserved port ${fresh} for this project instead.`));
 		}
 		return fresh;
 	}
 	if (!reserve && pinned !== null) return pinned;
+	return reservePort(root, pinned);
+}
+async function reservePort(root, pinned) {
 	try {
 		return await reserveMetroPort(root, void 0, void 0, pinned);
 	} catch (error) {
+		if (error instanceof PortInspectionError) return {
+			code: error.code,
+			message: error.reason,
+			remedy: PORT_INSPECTION_REMEDY
+		};
 		return {
 			code: "STIM_BAD_ARG",
 			message: error.message,

package/dist/{state-PeQiJuIu.mjs → state-D2KtnALG.mjs}

@@ -1,11 +1,11 @@
-import { n as ownership_claim_exports, t as process_identity_exports } from "./process-identity-BmRm1qV0.mjs";
-import { o as pidExists } from "./metro-g8NqiJp-.mjs";
-import { a as updateWorkspaceState, c as writeWorkspaceState, r as readWorkspaceState$1, t as clearWorkspaceStateKey, v as workspaceDir, x as workspaceLogsDir$1 } from "./workspace-state-DqcCbpE7.mjs";
+import { n as ownership_claim_exports, t as process_identity_exports } from "./process-identity-Biv3arCO.mjs";
+import { a as updateWorkspaceState, c as writeWorkspaceState, r as readWorkspaceState$1, t as clearWorkspaceStateKey, v as workspaceDir, x as workspaceLogsDir$1 } from "./workspace-state-CR9X86xJ.mjs";
+import { s as pidExists } from "./metro-DI2AjPF_.mjs";
 import { readFileSync, readlinkSync, rmSync } from "node:fs";
 import { join } from "node:path";
-import { rotatedLogPath } from "@stim-cli/core";
 import { WEB_VIEWPORTS } from "@stim-cli/core/state";
 import { hostname } from "node:os";
+import { rotatedLogPath } from "@stim-cli/core";
 //#region src/web/profile.ts
 const SINGLETON_FILES = [
 	"SingletonLock",

package/dist/{state-DyaNTgfR.mjs → state-Tp4uImDS.mjs}

@@ -1,11 +1,13 @@
-import { t as process_identity_exports } from "./process-identity-BmRm1qV0.mjs";
-import { a as updateWorkspaceState, r as readWorkspaceState$1, v as workspaceDir, x as workspaceLogsDir$1 } from "./workspace-state-DqcCbpE7.mjs";
+import { t as process_identity_exports } from "./process-identity-Biv3arCO.mjs";
+import { a as updateWorkspaceState, r as readWorkspaceState$1, v as workspaceDir, x as workspaceLogsDir$1 } from "./workspace-state-CR9X86xJ.mjs";
+import { existsSync } from "node:fs";
 import { join } from "node:path";
 import { readMacosRecord } from "@stim-cli/core/state";
 //#region src/macos/state.ts
 const macosDir = (root) => join(workspaceDir(root), "macos");
 const macosLogFile = (root) => join(workspaceLogsDir$1(root), "macos.ndjson");
 const macosRuntimeClaim = (root) => join(macosDir(root), "runtime.lock");
+const macosAppPresent = (root) => readWorkspaceState$1(root)?.macos !== void 0 || existsSync(macosDir(root));
 function macosProcess(pid) {
 	const processToken = (0, process_identity_exports.captureProcessToken)(pid);
 	const start = (0, process_identity_exports.processStartMicros)(pid);
@@ -38,4 +40,4 @@ function updateMacosRecord(root, owner, patch) {
 	return updated;
 }
 //#endregion
-export { requiredMacosRecord as a, macosRuntimeClaim as i, macosLogFile as n, updateMacosRecord as o, macosProcess as r, macosDir as t };
+export { macosRuntimeClaim as a, macosProcess as i, macosDir as n, requiredMacosRecord as o, macosLogFile as r, updateMacosRecord as s, macosAppPresent as t };

package/dist/{state-B4PQFXMW.d.mts → state-lKh8shBp.d.mts}

@@ -1,10 +1,9 @@
 import "@stim-cli/core/state";
-import * as import__stim_cli_core_process_identity from "@stim-cli/core/process-identity";
-//#endregion
+import { ProcessRecord } from "@stim-cli/core/process-identity";
 //#region src/supervisor/state.d.ts
 declare const MODE_BARE = "bare-inproc";
 declare const MODE_EXPO = "expo-child";
-declare function clearWorkspaceSupervisor(root: string, expected?: process_identity_d_exports.ProcessRecord | null): boolean;
+declare function clearWorkspaceSupervisor(root: string, expected?: ProcessRecord | null): boolean;
 declare function clearExpoMetroTunnel(root: string): void;
 declare function writePidFile(root: string, pid: number): string;
 declare function readPidFile(root: string): number | null;

package/dist/{stats-Bq4fJOdB.mjs → stats-8EJ5ivFT.mjs}

@@ -1,8 +1,8 @@
-import { j as formatBytes } from "./config-D0DbpZtM.mjs";
-import { o as formatLongDuration } from "./command-output-CDAIFD-8.mjs";
-import { gt as repoRoot, it as gitCommonDir } from "./settings-Cfd-0r2d.mjs";
-import { s as findProjectRoot$1 } from "./project-D47Rh0ly.mjs";
-import { i as getSwiftpmCacheUsage, n as swiftpmCacheLines, r as getAgentDeviceUsage, t as agentDeviceLines } from "./agent-device-usage-output-BK41vnzN.mjs";
+import { o as formatLongDuration } from "./command-output-Bt8ygHE7.mjs";
+import { j as formatBytes } from "./config-DC5jEtd1.mjs";
+import { r as findProjectRoot } from "./project-B5eQ1USs.mjs";
+import { mt as repoRoot, nt as gitCommonDir } from "./settings-CxgngUZk.mjs";
+import { i as getSwiftpmCacheUsage, n as swiftpmCacheLines, r as getAgentDeviceUsage, t as agentDeviceLines } from "./agent-device-usage-output-Bjxu_VmX.mjs";
 import { archivedUsage, readArchives, readStatsReport, statsProjectKey } from "@stim-cli/core/state";
 import chalk from "chalk";
 //#region src/commands/stats.ts
@@ -13,7 +13,7 @@ function statsCommand(program) {
 	program.command("stats").description("Show how many `ios` and `android` runs this project and this machine have recorded, how many hit the build cache, and an estimate of the time that cache saved.").option("--json", "print the aggregates as JSON").action(async (opts) => {
 		const agentDevice = await getAgentDeviceUsage();
 		const swiftpmCache = await getSwiftpmCacheUsage();
-		const root = findProjectRoot$1(process.cwd());
+		const root = findProjectRoot(process.cwd());
 		const key = root ? statsProjectKey({
 			root,
 			commonDir: gitCommonDir(root),

package/dist/{status-DlKvVJBE.mjs → status-BEeL6IKz.mjs}

@@ -1,4 +1,4 @@
-import { t as resolveMaintenanceSettings } from "./settings-BBpMcDbD.mjs";
+import { t as resolveMaintenanceSettings } from "./settings-Djl-mpjX.mjs";
 import { maintenanceRunClaims, readMaintenanceState } from "@stim-cli/core/state";
 import { claimRemoveCommand, readClaimSet } from "@stim-cli/core/ownership-claim";
 //#region src/maintenance/status.ts
@@ -17,7 +17,9 @@ function maintenanceStatus() {
 		} } : {},
 		lastChecks: {
 			pressure: state?.lastAt.pressure ?? null,
-			size: state?.lastAt.size ?? null
+			size: state?.lastAt.size ?? null,
+			worktree: state?.lastAt.worktree ?? null,
+			sweep: state?.lastAt.sweep ?? null
 		},
 		pressure: state?.pressure ?? null,
 		sizes: state?.sizes ?? [],
@@ -37,9 +39,9 @@ function maintenanceLine(status, includeLabel = true) {
 		minute: "2-digit"
 	}) : null;
 	const outputs = status.plan.filter((action) => action.kind === "would-clear-outputs");
-	const summary = outputs.length ? `would clear build outputs of ${outputs.length} ${outputs.length === 1 ? "workspace" : "workspaces"} (${(outputs.reduce((sum, action) => sum + action.bytes, 0) / 1024 ** 3).toFixed(1)} GB)` : `${status.plan.length} planned actions`;
+	const summary = status.mode === "on" && status.lastPass ? `${status.lastPass.actions} actions, ${(status.lastPass.freedBytes / 1024 ** 3).toFixed(1)} GB freed` : outputs.length ? `would clear build outputs of ${outputs.length} ${outputs.length === 1 ? "workspace" : "workspaces"} (${(outputs.reduce((sum, action) => sum + action.bytes, 0) / 1024 ** 3).toFixed(1)} GB)` : `${status.plan.length} planned actions`;
 	const disk = status.pressure?.disk.map((volume) => `disk ${(volume.freeMb / 1024).toFixed(1)} GB free on ${volume.volume}`).join(", ");
-	return `${includeLabel ? `Auto maintenance (${status.mode === "report" ? "report only" : "off"}): ` : ""}${at ? `${at}: ` : ""}${status.lastPass ? summary : "no pass has run yet"}${disk ? `; ${disk}` : ""}${status.running ? "; running" : ""}${status.lastPass?.blocked.length ? `; ${status.lastPass.blocked.join("; ")}` : ""}${status.invalid ? `; invalid: ${status.invalid}` : ""}${status.claim ? `; unresolved claim: ${status.claim.unresolved}; ${status.claim.removeCommand}` : ""}`;
+	return `${includeLabel ? `Auto maintenance (${status.mode === "report" ? "report only" : status.mode}): ` : ""}${at ? `${at}: ` : ""}${status.lastPass ? summary : "no pass has run yet"}${disk ? `; ${disk}` : ""}${status.running ? "; running" : ""}${status.lastPass?.blocked.length ? `; ${status.lastPass.blocked.join("; ")}` : ""}${status.invalid ? `; invalid: ${status.invalid}` : ""}${status.claim ? `; unresolved claim: ${status.claim.unresolved}; ${status.claim.removeCommand}` : ""}`;
 }
 function maintenanceLines(status) {
 	const line = maintenanceLine(status);