stim 1.5.0 → 1.7.0

package/dist/{guide-sAnoty2y.mjs → guide-CPmAG9me.mjs}

@@ -1,6 +1,6 @@
-import { a as findProjectRoot } from "./project-B_SDt4ip.mjs";
-import { t as ANDROID_AVD_CONFIG_HELP } from "./settings-kO2ZqIKy.mjs";
-import { t as guideStatus } from "./guide-status-BF6RsJJp.mjs";
+import { a as findProjectRoot } from "./project-DDZWf_16.mjs";
+import { t as ANDROID_AVD_CONFIG_HELP } from "./settings-BXXorVM2.mjs";
+import { t as guideStatus } from "./guide-status-Craq9z0t.mjs";
 import chalk from "chalk";
 //#endregion
 //#region src/guide/index.ts
@@ -516,7 +516,7 @@ line by design (see \`guide logs\`), not this single-payload contract.`,
                   the remedies all target -- read from the BUILT APK's
                   manifest, which on a flavored project is the flavor's
                   applicationId, not what the project files say
-  debugHttpHost   "10.0.2.2:<port>" on an emulator, "localhost:<port>" on a
+  debugHttpHost   "127.0.0.1:<port>" on an emulator, "localhost:<port>" on a
                   physical device, when the app's SharedPreferences were
                   pointed at this workspace's Metro; null when they were not.
                   A healthy run reverses only <port> -> <port>, which is what
@@ -927,8 +927,9 @@ metro is reserved; use stim start and stim stop for managed Metro.
 
 New allocations scan TCP ports 8900-8999. They skip registry reservations
 and existing listeners, announcing occupied ports and upward retries on
-stderr. Allocation requires lsof. All 100 ports occupied or reserved is a
-refusal; stop or release unused allocations in their owning workspaces.
+stderr. Listener checks require lsof, or netstat on Windows. All 100 ports
+occupied or reserved is a refusal; stop or release unused allocations in
+their owning workspaces.
 
 The machine registry, under STIM_HOME, serializes allocation and cleanup.
 The workspace is the nearest package.json directory, resolved through
@@ -940,9 +941,11 @@ supervise, or capture logs for these servers.
 
 ports lists named labels and ports, plus Metro marked managed.
 ports stop [label] kills TCP listeners on those named ports and releases
-the allocations. It sends SIGTERM, waits two seconds, then SIGKILL if needed.
-It prints the PID and command for each stopped process. The listener's cwd
-can be anywhere: the named reservation is permission to stop that listener.
+the allocations. It sends SIGTERM, waits two seconds, then SIGKILL if needed;
+on Windows it terminates the listener's process tree with taskkill.
+It prints the PID and command (the image name on Windows) for each stopped
+process. The listener's cwd can be anywhere: the named reservation is
+permission to stop that listener.
 Reserve only services this workspace may stop. --dry-run prints what would
 be stopped and released, without doing either. A failed inspection or stop
 keeps that allocation for retry; other labels are still processed.
@@ -1380,6 +1383,25 @@ code, never on the message.`,
   object, and upgrading the CLI does not clear it. Empty that one cache with
   \`gc --delete --cache "compilation cache"\`, then build again. The next
   build is a cold one.`
+			},
+			STIM_PATH_TOO_LONG: {
+				summary: "Windows only: the project root leaves no room for the NDK object paths ninja must open",
+				body: () => `STIM_PATH_TOO_LONG  (android, Windows only)
+  The NDK's ninja is not long-path aware, so every CMake object path has to
+  stay under Windows' MAX_PATH. React Native's codegen objects are named
+  after their mangled absolute source path, so each carries the project root
+  twice unless CMake shortens it, and CMake only shortens a name that then
+  fits the object path limit Stim's Gradle shim sets. The message names the
+  longest known object (measured on the e2e fixture, for the ABI being
+  built) and the longest root it leaves room for. Refused BEFORE Gradle runs
+  -- a cache hit still installs -- because the build would otherwise fail
+  deep inside ninja ("mkdir ... No such file or directory" or "Filename
+  longer than 260 characters"). Map the project to a drive letter (\`subst
+  X: <root>\`, then run Stim from X:\\) or move it under a shorter root.
+  A custom Gradle buildStagingDirectory can be shorter than the default; this
+  preflight does not inspect that configured path and may refuse it too.
+  \`doctor --platform android\` reports the same root as a finding for the
+  emulator's ABI.`
 			},
 			fallbacks: {
 				summary: "release cache-hit notes that are not codes: swap failure, asset gate, uninstall, device fallbacks",
@@ -2317,7 +2339,7 @@ not on any remote"  (worktree remove)
   the no-install form.
 
 "Unsupported engine" or a syntax error before Stim starts
-  Stim requires Node 20.19.4 or later on Node 20, or Node 22.12.0 or later.
+  Stim requires Node 22.12.0 or later.
   Switch Node versions, then run the command again.
 
 
@@ -2527,7 +2549,9 @@ from bundle delivery and readiness verification: it gives CoreSimulator time
 to accept the launch, not the app extra time to report readiness. A timeout
 still fails the launch; Stim does not automatically retry it.
 
-For an unverified Android launch, follow the emitted device-specific remedy.
+For an unverified local Android launch, follow the emitted device-specific remedy.
+Only a dev client gets the Expo development-server picker step; a bare app
+starts with the printed process restart.
 If the app is stuck before loading its first bundle, restart its process with
 the printed force-stop and launcher commands. Foregrounding the same process
 does not restart initialization. Confirm the bundle request and expected UI.
@@ -3077,8 +3101,13 @@ with machine or project optimization settings; see \`guide settings\`:
   ios      xcodebuild carries COMPILATION_CACHE_ENABLE_CACHING, a shared
            COMPILATION_CACHE_CAS_PATH and a clang prefix mapping of this
            workspace's root, so compiled output crosses worktrees with no
-           Podfile post_install block. Xcode 26+ only, and skipped entirely
-           when the project configured ccache (the two defeat each other).
+           Podfile post_install block. Swift joins in, with its own prefix
+           mapping, once xcrun swift reports 6.4 or newer (Xcode 27) and
+           react-native is 0.87 or newer; the cache line names Swift on or
+           off and why. Xcode still excludes Swift targets built without
+           explicit modules; the post-build cache line counts those.
+           Xcode 26+ only, and skipped entirely when the project
+           configured ccache (the two defeat each other).
   android  gradlew carries --build-cache, so task outputs cross worktrees with
            no org.gradle.caching=true in gradle.properties. Debug builds also
            carry -PreactNativeArchitectures=<target ABI>, using the owned
@@ -3606,9 +3635,8 @@ OPT-IN CONCURRENCY LIMITS (UNLIMITED BY DEFAULT)
   The build, the fingerprint, the build cache and the Metro port gate are
   unchanged. What is skipped is everything that manages an owned device:
   no capacity check, no AVD creation, no boot wait, and no owned-device
-  registry entry. The app is pointed at
-  localhost:<port>, which the adb reverse serves, instead of the emulator's
-  10.0.2.2. Stim never creates, boots, shuts down, or deletes hardware.
+  registry entry. A debug app uses localhost:<port> through adb reverse.
+  Stim never creates, boots, shuts down, or deletes hardware.
 
   \`ios --device [udid]\` selects a connected iPhone, the same way
   \`android --device\` selects a connected phone: with no UDID it takes the
@@ -3817,7 +3845,7 @@ THE POOL: WHICH DEVICE AN ID-LESS \`--device\` PICKS
   workspace's bundle with the project's own tools (\`expo export:embed\` /
   \`react-native bundle\`, then the project's own hermesc when
   \`hermesEnabled\` is not false in android/gradle.properties), re-packs it
-  into the copy with plain zip surgery (stored, not deflated -- the runtime
+  into the copy with the JDK's jar tool (stored, not deflated -- the runtime
   mmaps it), then zipaligns and re-signs with apksigner. The keystore defaults
   to android/app/debug.keystore with the standard password; android.keystore /
   android.keystorePassword override it (see \`guide settings\`). The cache
@@ -4542,9 +4570,10 @@ be setup steps are supplied by Stim on the command lines it composes itself:
 
   xcodebuild   COMPILATION_CACHE_ENABLE_CACHING / COMPILATION_CACHE_CAS_PATH /
                SWIFT_ENABLE_COMPILE_CACHE / CLANG_ENABLE_PREFIX_MAPPING /
-               CLANG_OTHER_PREFIX_MAPPINGS -- so no Podfile post_install block
-               (Xcode 26+ only, and skipped when the project configured ccache,
-               which defeats it)
+               CLANG_OTHER_PREFIX_MAPPINGS, plus SWIFT_ENABLE_PREFIX_MAPPING /
+               SWIFT_OTHER_PREFIX_MAPPINGS on a Swift 6.4+ toolchain -- so no
+               Podfile post_install block (Xcode 26+ only, and skipped when the
+               project configured ccache, which defeats it)
   gradlew      --build-cache -- so no org.gradle.caching=true in a committed
                gradle.properties. Debug builds add
                -PreactNativeArchitectures=<target ABI> when the owned
@@ -4582,7 +4611,6 @@ key inherits the next layer. Changes apply on the next build or Metro restart.
       "metroWarmup": true,
       "ios": {
         "compilationCache": true,
-        "swiftCompilationCache": false,
         "prefixMapping": true
       },
       "android": {
@@ -4619,7 +4647,18 @@ The example shows the defaults. Full setting names and behavior:
   optimizations.ios.compilationCache
     controls Xcode compilation caching (Xcode 26+).
   optimizations.ios.swiftCompilationCache
-    opts into experimental Swift caching, requiring compilationCache=true.
+    unset by default: Swift caching turns on, with Swift prefix mapping, when
+    xcrun swift reports Swift 6.4 or newer (Xcode 27), where swift-frontend no
+    longer crashes on prefix-mapped batches, and the project's react-native is
+    0.87 or newer. Older toolchains leave it off. React Native before 0.87
+    sets SWIFT_ENABLE_EXPLICIT_MODULES=NO on every target for its prebuilt
+    core, and Xcode refuses Swift caching without explicit modules, so those
+    projects stay off too; the cache line names which gate applied.
+    true forces it on any toolchain and React Native version, unmapped below
+    Swift 6.4, so entries only hit within one checkout. false keeps it off.
+    Requires compilationCache=true. A project that still disables explicit
+    modules itself sees the excluded target count on the post-build cache
+    line. Stim does not override that project setting.
   optimizations.ios.prefixMapping
     controls Clang source/DerivedData prefix mapping. false clears Stim's
     mappings. The existing Xcode version and project-ccache guards still apply.

package/dist/{guide-status-BF6RsJJp.mjs → guide-status-Craq9z0t.mjs}

@@ -1,8 +1,8 @@
-import { t as getExecutor } from "./exec-CyylIdq9.mjs";
-import { S as upsertProject, f as getProject, u as getConfigDir } from "./config-DMP7L7H6.mjs";
+import { t as getExecutor } from "./exec-B29XNuhP.mjs";
+import { S as upsertProject, f as getProject, u as getConfigDir } from "./config-B7iyKWkL.mjs";
 import { accessSync, constants, mkdirSync, readFileSync, realpathSync, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import { delimiter, join, resolve } from "node:path";
-//#region src/stim-installations.ts
+//#region src/diagnostics/stim-installations.ts
 const VERSION_OUTPUT_LIMIT = 4096;
 function parsedVersion(version) {
 	const match = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/.exec(version);

package/dist/{ios-BdpkncL6.mjs → ios-BRXYSxSc.mjs}

@@ -1,31 +1,31 @@
-import { t as getExecutor } from "./exec-CyylIdq9.mjs";
-import { E as ownership_claim_exports, P as deviceSlotKey, S as upsertProject, f as getProject, l as getConcurrencyLimits, z as validateDeviceSlot } from "./config-DMP7L7H6.mjs";
+import { t as getExecutor } from "./exec-B29XNuhP.mjs";
+import { B as validateDeviceSlot, E as ownership_claim_exports, F as deviceSlotKey, P as deviceSlotFileKey, S as upsertProject, f as getProject, l as getConcurrencyLimits } from "./config-B7iyKWkL.mjs";
 import { r as createNdjsonWriter } from "./ndjson-BZwI1NBv.mjs";
-import { _ as workspaceLogsDir, h as workspaceDir, o as writeWorkspaceState, r as readWorkspaceState } from "./workspace-state-WVwWw_hB.mjs";
-import { T as removeTemporaryEntry, g as repoRoot, s as gitCommonDir, w as makeTemporaryDirectory } from "./worktree-DJnBbQZ9.mjs";
-import { a as findProjectRoot, c as projectShortcut, i as detectIsExpo, r as detectBundleId, t as appProjectProblem } from "./project-B_SDt4ip.mjs";
-import { n as MODE_EXPO, p as writeWorkspaceLaunch, t as MODE_BARE } from "./state-CnWzvCWP.mjs";
-import { i as resolveProjectMetro, r as pidExists } from "./metro-ato6ef3J.mjs";
-import { n as verifyCollectorOwnership } from "./ownership-CD_XnpDu.mjs";
-import { _ as launchErrorPreview, c as launchErrorReport, g as stepTimer, h as stepClock, i as formatDuration, l as phaseLine, m as shortUdid, n as appReadinessMessage, p as shortHash } from "./command-output-BuIb_ZOI.mjs";
-import { $ as providerDownloadPath, G as buildCacheKey, J as filesystemBuildCapability, K as describeFingerprintMiss, Q as prepareProviderDownloadDir, R as WAIT_CEILING_MS, U as takeoverLine, V as releaseBuildLock, W as waitForBuild, X as fingerprintDiffSuffix, Y as fingerprintDiffRecord, Z as fingerprintProject, at as untrackedMissLine, et as providerUploadOutcome, nt as resolveBuild, ot as untrackedNativeFiles, rt as storeBuild, tt as refingerprintAfterMutation, z as acquireBuildLock } from "./android-DJWiTBkz.mjs";
-import { A as resolveSettings, B as artifactCachePolicy, D as remoteDeviceSettingError, F as tunnelModeSetting, H as optimizationBuildProfile, I as unknownSettingKeys, N as settingShapeErrors, O as remoteIosSetting, R as detectProviders, T as publicUrlSetting, U as resolveOptimizations, _ as iosSigningIdentitySha1SettingError, a as SETTING_SHAPE_REMEDY, d as cacheProviderSettingError, f as iosLanHostSetting, g as iosSigningIdentitySha1Setting, h as iosSigningIdentitySettingError, k as resolveCacheProviderConfig, m as iosSigningIdentitySetting, p as iosLanHostSettingError, r as REMOTE_DEVICE_BACKENDS, x as metroWarmupUrlSetting } from "./settings-kO2ZqIKy.mjs";
-import { C as resolveRemote, S as resolveEasCliBin, _ as exitAfterFlush, a as POOL_SETTING_REMEDY, f as RESOLVE_TIMEOUT_MS, g as easAuthNote, h as checkEasAuth, l as parkedMaxSetting, m as cacheLevel, p as UPLOAD_TIMEOUT_MS, v as isEasAuthFailureText, w as uploadRemote, y as loadProjectProvider } from "./teardown-CAVcWeRD.mjs";
-import { _ as easDeviceBuildRemedy, a as swapJsBundle, c as ensureWorkspaceStorageSafely, d as launchOutcomeRecord, f as noMetroMessage, g as warmMetro, h as sleep, l as gateShouldRetry, m as resolveMetroWithRetry, n as pickDevClientScheme, o as needsPrebuild, p as noMetroRemedy, r as schemesFromInfoPlist, s as runPrebuild, t as devClientScheme, u as isPhysicalDeviceRequest, v as isEasBuildFailure, y as resolveEasDevelopmentBuild } from "./dev-client-BoifdqkU.mjs";
-import { t as withWorkspaceProcessLock } from "./workspace-process-lock-Bz19_R9R.mjs";
-import { C as launchIosApp, E as unverifiedLaunchLines, O as verifyLaunch, T as readMetroRecords, b as isBundleProof, c as RELEASE_VERIFY_WAIT_MS, f as clearOtherUserApps, i as LAUNCH_BUNDLING, k as verifyReleaseLaunch, m as devClientUrl, n as DEFAULT_METRO_PORT, o as LAUNCH_FATAL, s as LAUNCH_UNVERIFIED, v as installIosApp, w as readCollectorRecords, y as iosAppProcess } from "./app-install--PAocWvq.mjs";
-import { f as listIosRuntimes } from "./ios-Deh5js5V.mjs";
-import { a as lostLine, c as releaseLeaseOnSignal, i as leaseExpiryText, l as runLease, n as DEBUG_VERIFY_STEP_MS, o as lostRefusal, r as acquireRunLease, s as parseDeviceWait, t as selectFromPool, u as waitFlagConflict } from "./device-pool-DU4FQKp5.mjs";
-import { r as releaseBuildSlot, t as acquireBuildSlot } from "./build-slots-CuPszJDu.mjs";
-import { a as statsProjectKey, i as recordRunStats, n as readRunEstimates, t as createRunRecorder } from "./stats-Fo9ACIv7.mjs";
-import { c as unknownIosRuntimeRefusal, i as ensureOwnedDevice, n as clearIosAdoptionPending, r as ensureBooted, s as unknownIosDeviceTypeRefusal, t as checkDeviceCapacity } from "./device-DvKJ454A.mjs";
-import { a as ensureMetroReachable, b as ownedSessionName, c as remoteIosDeps, l as resolveRemoteContext, n as binOnPath, o as ensureRemoteBootOwned, r as bundleEntryPoint, w as gateMetroOrigin } from "./device-remote-BTUqbl0i.mjs";
-import { a as compilationCacheActivityLine, c as readBundleExecutable, l as readBundleId, p as describeDiagnostic, r as buildIos, s as discoverXcodeProject, t as COMPILATION_CACHE_NOT_RUN, u as resolveScheme } from "./xcode-BqDeRkpT.mjs";
-import { n as nativeRunCommand, t as launchSlotScope } from "./slot-launch-BpHiHH6A.mjs";
+import { _ as workspaceLogsDir, h as workspaceDir, o as writeWorkspaceState, r as readWorkspaceState } from "./workspace-state-BT5E3SA2.mjs";
+import { T as removeTemporaryEntry, g as repoRoot, s as gitCommonDir, w as makeTemporaryDirectory } from "./worktree-FG_ZKKdb.mjs";
+import { a as findProjectRoot, c as projectShortcut, i as detectIsExpo, r as detectBundleId, t as appProjectProblem } from "./project-DDZWf_16.mjs";
+import { n as MODE_EXPO, p as writeWorkspaceLaunch, t as MODE_BARE } from "./state-DZobzxLW.mjs";
+import { a as resolveProjectMetro, i as pidExists, o as signalProcessTree } from "./metro-C7bcJ0uo.mjs";
+import { n as verifyCollectorOwnership } from "./ownership-Cp52QAK1.mjs";
+import { A as resolveSettings, B as artifactCachePolicy, D as remoteDeviceSettingError, F as tunnelModeSetting, H as optimizationBuildProfile, I as unknownSettingKeys, N as settingShapeErrors, O as remoteIosSetting, R as detectProviders, T as publicUrlSetting, U as resolveOptimizations, _ as iosSigningIdentitySha1SettingError, a as SETTING_SHAPE_REMEDY, d as cacheProviderSettingError, f as iosLanHostSetting, g as iosSigningIdentitySha1Setting, h as iosSigningIdentitySettingError, k as resolveCacheProviderConfig, m as iosSigningIdentitySetting, p as iosLanHostSettingError, r as REMOTE_DEVICE_BACKENDS, x as metroWarmupUrlSetting } from "./settings-BXXorVM2.mjs";
+import { _ as launchErrorPreview, c as launchErrorReport, g as stepTimer, h as stepClock, i as formatDuration, l as phaseLine, m as shortUdid, n as appReadinessMessage, p as shortHash } from "./command-output-B3ycpsYv.mjs";
+import { C as untrackedNativeFiles, S as untrackedMissLine, _ as providerUploadOutcome, b as storeBuild, c as buildCacheKey, d as filesystemBuildCapability, f as fingerprintDiffRecord, g as providerDownloadPath, h as prepareProviderDownloadDir, i as releaseBuildLock, l as describeFingerprintMiss, m as fingerprintProject, n as acquireBuildLock, o as takeoverLine, p as fingerprintDiffSuffix, s as waitForBuild, t as WAIT_CEILING_MS, v as refingerprintAfterMutation, y as resolveBuild } from "./build-lock-CgtsB6TV.mjs";
+import { C as resolveRemote, S as resolveEasCliBin, _ as exitAfterFlush, a as POOL_SETTING_REMEDY, f as RESOLVE_TIMEOUT_MS, g as easAuthNote, h as checkEasAuth, l as parkedMaxSetting, m as cacheLevel, p as UPLOAD_TIMEOUT_MS, v as isEasAuthFailureText, w as uploadRemote, y as loadProjectProvider } from "./teardown-5J5UXz2P.mjs";
+import { _ as easDeviceBuildRemedy, a as swapJsBundle, c as ensureWorkspaceStorageSafely, d as launchOutcomeRecord, f as noMetroMessage, g as warmMetro, h as sleep, l as gateShouldRetry, m as resolveMetroWithRetry, n as pickDevClientScheme, o as needsPrebuild, p as noMetroRemedy, r as schemesFromInfoPlist, s as runPrebuild, t as devClientScheme, u as isPhysicalDeviceRequest, v as isEasBuildFailure, y as resolveEasDevelopmentBuild } from "./dev-client-DDUkWgJL.mjs";
+import { t as withWorkspaceProcessLock } from "./workspace-process-lock-BYfZz_S-.mjs";
+import { C as launchIosApp, E as unverifiedLaunchLines, O as verifyLaunch, T as readMetroRecords, b as isBundleProof, c as RELEASE_VERIFY_WAIT_MS, f as clearOtherUserApps, i as LAUNCH_BUNDLING, k as verifyReleaseLaunch, m as devClientUrl, n as DEFAULT_METRO_PORT, o as LAUNCH_FATAL, s as LAUNCH_UNVERIFIED, v as installIosApp, w as readCollectorRecords, y as iosAppProcess } from "./app-install-DJg7bVv-.mjs";
+import { f as listIosRuntimes } from "./ios-lEJ5pKsq.mjs";
+import { a as lostLine, c as releaseLeaseOnSignal, i as leaseExpiryText, l as runLease, n as DEBUG_VERIFY_STEP_MS, o as lostRefusal, r as acquireRunLease, s as parseDeviceWait, t as selectFromPool, u as waitFlagConflict } from "./device-pool-DNSHL5z8.mjs";
+import { r as releaseBuildSlot, t as acquireBuildSlot } from "./build-slots-C-oAHRT1.mjs";
+import { a as statsProjectKey, i as recordRunStats, n as readRunEstimates, t as createRunRecorder } from "./stats-BYcZ6n1h.mjs";
+import { c as unknownIosRuntimeRefusal, i as ensureOwnedDevice, n as clearIosAdoptionPending, r as ensureBooted, s as unknownIosDeviceTypeRefusal, t as checkDeviceCapacity } from "./device-CLeDp-KH.mjs";
+import { a as ensureMetroReachable, b as ownedSessionName, c as remoteIosDeps, l as resolveRemoteContext, n as binOnPath, o as ensureRemoteBootOwned, r as bundleEntryPoint, w as gateMetroOrigin } from "./device-remote-BprxZp-m.mjs";
+import { a as compilationCacheActivityLine, c as readBundleExecutable, l as readBundleId, p as describeDiagnostic, r as buildIos, s as discoverXcodeProject, t as COMPILATION_CACHE_NOT_RUN, u as resolveScheme } from "./xcode-B6YaWeg0.mjs";
+import { n as nativeRunCommand, t as launchSlotScope } from "./slot-launch-DbLvyrup.mjs";
 import { t as spawnEntry } from "./spawn-entry-nCE6m770.mjs";
-import { a as printNativeCrashReport, n as IOS_CRASH_REPORT_RETRY, o as simulatorConsolePaths, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-CTePWAzW.mjs";
-import { a as iosDeviceProcess, c as listIosDevices, d as verifyIosDeviceReleaseLaunch, i as installIosDeviceApp, l as localNetworkPending, n as LAUNCH_PROBE_TIMEOUT_MS, o as iosPoolCandidates, r as awaitIosDeviceLaunch, s as iosPoolNoCandidatesRefusal, t as DEVICECTL_INSTALL_TIMEOUT_MS, u as resolveIosPhysicalDevice } from "./ios-device-DJOi9FR5.mjs";
-import { a as runPodInstall, n as podsAreStale, r as readPodState } from "./deps-BAGOnrc7.mjs";
+import { a as printNativeCrashReport, n as IOS_CRASH_REPORT_RETRY, o as simulatorConsolePaths, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-D1Kaf-eT.mjs";
+import { a as iosDeviceProcess, c as listIosDevices, d as verifyIosDeviceReleaseLaunch, i as installIosDeviceApp, l as localNetworkPending, n as LAUNCH_PROBE_TIMEOUT_MS, o as iosPoolCandidates, r as awaitIosDeviceLaunch, s as iosPoolNoCandidatesRefusal, t as DEVICECTL_INSTALL_TIMEOUT_MS, u as resolveIosPhysicalDevice } from "./ios-device-CDbvn5H2.mjs";
+import { a as runPodInstall, n as podsAreStale, r as readPodState } from "./deps-oCXVNEqQ.mjs";
 import { existsSync, mkdirSync, mkdtempSync, openSync, rmSync, writeFileSync } from "node:fs";
 import { InvalidArgumentError } from "commander";
 import { X509Certificate } from "node:crypto";
@@ -1503,14 +1503,14 @@ function hostLanCandidates(interfaces = networkInterfaces) {
 //#endregion
 //#region src/commands/ios/collector.ts
 function collectorLogFile(root, slot) {
-	return join(workspaceLogsDir(root), `collector-${deviceSlotKey("ios", slot)}.log`);
+	return join(workspaceLogsDir(root), `collector-${deviceSlotFileKey("ios", slot)}.log`);
 }
 function collectorEntry() {
 	return spawnEntry("collector-run");
 }
 const COLLECTOR_EXIT_WAIT_MS = 2e3;
 const COLLECTOR_POLL_MS = 25;
-async function stopPreviousCollector({ root, slot = "default", kill = (pid, signal) => process.kill(pid, signal), alive = pidExists, readState = readWorkspaceState, verify = verifyCollectorOwnership, waitMs = COLLECTOR_EXIT_WAIT_MS, note = (_line) => {} }) {
+async function stopPreviousCollector({ root, slot = "default", kill = (pid, signal) => signalProcessTree(pid, signal), alive = pidExists, readState = readWorkspaceState, verify = verifyCollectorOwnership, waitMs = COLLECTOR_EXIT_WAIT_MS, note = (_line) => {} }) {
 	const previous = (readState(root)?.collectors)?.[deviceSlotKey("ios", slot)] || null;
 	const previousPid = Number(previous?.pid) || null;
 	let killed = null;
@@ -2138,14 +2138,11 @@ async function finishIosRun({ artifact, d, root, slot, json, release, configurat
 		event: "launch",
 		msg: release ? `launched ${bundleId} on ${udid} (${configuration}, embedded JS bundle, no Metro)` : `launched ${bundleId} on ${udid} against Metro ${lanOriginUrl ?? `port ${metroPort}`}` + (launched?.mode === "openurl" || launched?.mode === "payload-url" ? " (expo-dev-client)" : "")
 	});
-	if (remoteDevice) await d.replaceCollector({
-		root,
-		slot,
-		udid,
-		bundleId,
-		appName,
-		appExecutable,
-		note
+	if (remoteDevice) logWriter().write({
+		src: "build",
+		level: "info",
+		event: "collector_skipped",
+		msg: `remote session ${udid}: device logs come from agent-device/EAS, so no simctl log stream is attached`
 	});
 	if (physical) raiseLeaseFor(release ? RELEASE_VERIFY_WAIT_MS : DEBUG_VERIFY_STEP_MS, false);
 	const { state: launchState, warning: launchWarning } = await verifyIosRun({
@@ -2272,7 +2269,7 @@ function explicitSchemeRefusal(root, scheme, isExpo, d) {
 	return d.resolveScheme(project, { scheme }).error ?? null;
 }
 function iosSlotLogFile(root, slot) {
-	return slot === "default" ? buildLogFile(root) : join(workspaceLogsDir(root), `build-${deviceSlotKey("ios", slot)}.ndjson`);
+	return slot === "default" ? buildLogFile(root) : join(workspaceLogsDir(root), `build-${deviceSlotFileKey("ios", slot)}.ndjson`);
 }
 function iosSlotDeps(d, slot) {
 	if (slot !== "default") {

package/dist/{ios-device-DJOi9FR5.mjs → ios-device-CDbvn5H2.mjs}

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

package/dist/{ios-device-D3pzTKQE.mjs → ios-device-CFXA46ez.mjs}

@@ -1,4 +1,4 @@
-import { t as getExecutor } from "./exec-CyylIdq9.mjs";
+import { t as getExecutor } from "./exec-B29XNuhP.mjs";
 //#region src/collector/ios-device.ts
 const CONSOLE_ENV = { OS_ACTIVITY_DT_MODE: "enable" };
 const DEV_MENU_LAUNCH_ARGS = [

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

@@ -1,5 +1,5 @@
-import { t as getExecutor } from "./exec-CyylIdq9.mjs";
-import { n as stripAnsi, r as waitForChild, t as createLineReader } from "./process-output-C7IlIzd7.mjs";
+import { t as getExecutor } from "./exec-B29XNuhP.mjs";
+import { n as stripAnsi, r as waitForChild, t as createLineReader } from "./process-output-Dl5uKE03.mjs";
 import { mkdtempSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { tmpdir } from "node:os";
@@ -22,7 +22,7 @@ function hostMemoryPressureAdvice(pressure) {
 	return `macOS reports ${pressure} host memory pressure. Simulator processes can stall even when the device is Booted. Free memory before retrying: use \`stim stop\` only in workspaces you own, and ask before closing other apps or devices. For parallel iOS work, consider a reviewed SimSlim profile (\`stim guide lifecycle simslim\`). This observation does not establish an OOM crash.`;
 }
 //#endregion
-//#region src/sim/ios.ts
+//#region src/devices/ios.ts
 function parseSimctlList(jsonOutput, { includeUnavailable = false } = {}) {
 	const parsed = JSON.parse(jsonOutput);
 	if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error("Expected simctl list to return a JSON object with a devices object.");

package/dist/{logs-BfQdIhiF.mjs → logs-CakdBTtm.mjs}

@@ -1,10 +1,10 @@
-import { g as loadConfig, h as isPathPrefix, z as validateDeviceSlot } from "./config-DMP7L7H6.mjs";
+import { B as validateDeviceSlot, g as loadConfig, h as isPathPrefix } from "./config-B7iyKWkL.mjs";
 import { n as SOURCES, t as LEVELS } from "./ndjson-BZwI1NBv.mjs";
-import { _ as workspaceLogsDir, r as readWorkspaceState } from "./workspace-state-WVwWw_hB.mjs";
-import { a as findProjectRoot } from "./project-B_SDt4ip.mjs";
-import { _ as launchErrorPreview } from "./command-output-BuIb_ZOI.mjs";
-import { i as captureWorkspaceCrashes, t as errorDiagnostics } from "./error-diagnostics-CTePWAzW.mjs";
-import { a as followLogs, c as queryLogs, i as fileSizes, n as buildCriteria, o as logFiles, r as compileGrep, s as parseSince } from "./logs-query-Cdp5aaCH.mjs";
+import { _ as workspaceLogsDir, r as readWorkspaceState } from "./workspace-state-BT5E3SA2.mjs";
+import { a as findProjectRoot } from "./project-DDZWf_16.mjs";
+import { _ as launchErrorPreview } from "./command-output-B3ycpsYv.mjs";
+import { i as captureWorkspaceCrashes, t as errorDiagnostics } from "./error-diagnostics-D1Kaf-eT.mjs";
+import { a as followLogs, c as queryLogs, i as fileSizes, n as buildCriteria, o as logFiles, r as compileGrep, s as parseSince } from "./logs-query-BGL-Pl12.mjs";
 import { realpathSync } from "node:fs";
 import { relative, sep } from "node:path";
 import chalk from "chalk";

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

@@ -2,7 +2,7 @@ import { a as parseNdjsonLine, i as levelRank, o as parseNdjsonText } from "./nd
 import { closeSync, openSync, readFileSync, readSync, readdirSync, statSync } from "fs";
 import { join } from "path";
 import { StringDecoder } from "string_decoder";
-//#region src/logs-query.ts
+//#region src/diagnostics/logs-query.ts
 const SINCE_UNITS = {
 	s: 1e3,
 	m: 6e4,

package/dist/metro-C7bcJ0uo.mjs

@@ -0,0 +1,233 @@
+import { t as getExecutor } from "./exec-B29XNuhP.mjs";
+import { A as isOnMountedVolume, g as loadConfig, j as listMountedVolumes, n as allMetroPorts, r as claimMetroPort, v as removeProject, w as process_identity_exports } from "./config-B7iyKWkL.mjs";
+import { r as readWorkspaceState } from "./workspace-state-BT5E3SA2.mjs";
+import { existsSync, readlinkSync, realpathSync } from "fs";
+import { sep } from "path";
+import { request } from "http";
+import { connect } from "net";
+//#region src/ports.ts
+function isMetroRunning(port) {
+	return new Promise((resolve) => {
+		const req = request({
+			hostname: "localhost",
+			port,
+			path: "/status",
+			timeout: 2e3
+		}, (res) => {
+			let data = "";
+			res.on("data", (chunk) => {
+				data += chunk;
+			});
+			res.on("end", () => resolve(data.includes("packager-status:running")));
+		});
+		req.on("error", () => resolve(false));
+		req.on("timeout", () => {
+			req.destroy();
+			resolve(false);
+		});
+		req.end();
+	});
+}
+function isPortFree(port, { timeoutMs = 400 } = {}) {
+	return new Promise((resolve) => {
+		const sock = connect({
+			port,
+			host: "127.0.0.1"
+		});
+		const done = (free) => {
+			sock.removeAllListeners();
+			sock.destroy();
+			resolve(free);
+		};
+		sock.setTimeout(timeoutMs);
+		sock.once("connect", () => done(false));
+		sock.once("error", () => done(true));
+		sock.once("timeout", () => done(false));
+	});
+}
+const FIRST_PORT = 8082;
+async function computeNextPort(isFree = isPortFree) {
+	const taken = new Set(allMetroPorts());
+	for (let port = FIRST_PORT; port < 8282; port++) {
+		if (taken.has(port)) continue;
+		if (await isFree(port)) return port;
+	}
+	throw new Error(`Found no free Metro port between ${FIRST_PORT} and 8281. Free one up, or stop a stale bundler (\`stim status\`, \`stim stop <port>\`).`);
+}
+async function findReclaimablePort(excludeProjectPath, probe = isMetroRunning, { isMounted = isOnMountedVolume, mountedVolumes } = {}) {
+	const cfg = loadConfig();
+	if (!cfg?.projects) return null;
+	const mounted = mountedVolumes || listMountedVolumes();
+	const candidates = [];
+	for (const [path, proj] of Object.entries(cfg.projects)) {
+		if (path === excludeProjectPath) continue;
+		if (Object.keys(proj.ports ?? {}).length) continue;
+		if (existsSync(path)) continue;
+		if (!isMounted(path, mounted)) continue;
+		if (typeof proj.metroPort === "number") candidates.push({
+			port: proj.metroPort,
+			ownerPath: path
+		});
+	}
+	for (const c of candidates) if (!await probe(c.port)) return c;
+	return null;
+}
+async function allocatePort(projectPath, probe = isMetroRunning, isFree = isPortFree) {
+	const reclaim = await findReclaimablePort(projectPath, probe);
+	if (reclaim && await isFree(reclaim.port)) {
+		removeProject(reclaim.ownerPath);
+		return reclaim.port;
+	}
+	return computeNextPort(isFree);
+}
+const RESERVE_ATTEMPTS = 5;
+async function reserveMetroPort(projectPath, probe = isMetroRunning, isFree = isPortFree) {
+	for (let attempt = 0; attempt < RESERVE_ATTEMPTS; attempt++) {
+		const port = await allocatePort(projectPath, probe, isFree);
+		const claimed = claimMetroPort(projectPath, port);
+		if (claimed !== null) return claimed;
+	}
+	throw new Error(`Could not reserve a Metro port after ${RESERVE_ATTEMPTS} attempts: another Stim run claimed each one first. Retry.`);
+}
+//#endregion
+//#region src/metro.ts
+/**
+* True when some process with this pid exists right now. It cannot tell a recycled pid from the
+* process that first held it, so it is only valid for a pid this run spawned and still holds a
+* handle on. For a pid read from a record on disk, decide with `inspectProcessIdentity` on that
+* record's process token, or take an ownership claim (`ownership-claim.ts`): this answer would keep
+* a dead holder's record looking live until some unrelated process exits.
+*/
+function pidExists(pid) {
+	if (!Number.isSafeInteger(pid) || pid <= 0) return false;
+	try {
+		process.kill(pid, 0);
+		return true;
+	} catch (error) {
+		return error.code !== "ESRCH";
+	}
+}
+function parseLsofPids(out) {
+	if (!out) return [];
+	return String(out).split("\n").map((s) => parseInt(s.trim(), 10)).filter((n) => Number.isFinite(n));
+}
+function addressPort(address) {
+	const colon = String(address ?? "").lastIndexOf(":");
+	return colon < 0 ? NaN : Number(String(address).slice(colon + 1));
+}
+function parseNetstatPids(out, port) {
+	const pids = [];
+	for (const line of String(out ?? "").split("\n")) {
+		const cols = line.trim().split(/\s+/);
+		if (cols.length < 5 || cols[0]?.toUpperCase() !== "TCP") continue;
+		if (addressPort(cols[1]) !== port || addressPort(cols[2]) !== 0) continue;
+		const pid = Number(cols.at(-1));
+		if (Number.isSafeInteger(pid) && pid > 0 && !pids.includes(pid)) pids.push(pid);
+	}
+	return pids;
+}
+function listeningPids(port, platform = process.platform) {
+	const pids = parseLsofPids(getExecutor().runQuiet(`lsof -nP -iTCP:${port} -sTCP:LISTEN -t`));
+	if (pids.length > 0 || platform !== "win32") return pids;
+	return parseNetstatPids(getExecutor().runQuiet("netstat -ano"), port);
+}
+function parseLsofCwd(out) {
+	if (!out) return null;
+	const lines = String(out).split("\n");
+	const idx = lines.findIndex((l) => l === "fcwd");
+	if (idx === -1) return null;
+	const nLine = lines.slice(idx + 1).find((l) => l.startsWith("n"));
+	return nLine ? nLine.slice(1) : null;
+}
+function processCwd(pid) {
+	if (process.platform === "linux") try {
+		return readlinkSync(`/proc/${pid}/cwd`);
+	} catch {}
+	return parseLsofCwd(getExecutor().runQuiet(`lsof -a -p ${pid} -d cwd -Fn`));
+}
+function canonicalPath(path) {
+	try {
+		return realpathSync(path);
+	} catch {
+		return path;
+	}
+}
+function isInsideProject(cwd, projectPath) {
+	if (!cwd || !projectPath) return false;
+	const a = canonicalPath(cwd);
+	const b = canonicalPath(projectPath);
+	return a === b || a.startsWith(b.endsWith(sep) ? b : b + sep);
+}
+const NOT_OURS_UNRESPONSIVE = "unresponsive";
+const NOT_OURS_UNREADABLE_CWD = "unreadable-cwd";
+const NOT_OURS_FOREIGN_CWD = "foreign-cwd";
+function ownedSupervisor(projectPath, port) {
+	const supervisor = readWorkspaceState(canonicalPath(projectPath))?.supervisor;
+	if (supervisor?.port !== port || (0, process_identity_exports.inspectProcessIdentity)(supervisor) !== "same") return null;
+	return supervisor;
+}
+async function resolveProjectMetro(port, projectPath, { probe = isMetroRunning, cwdOf = processCwd } = {}) {
+	const pid = listeningPids(port)[0];
+	if (pid === void 0) return { missing: true };
+	if (!await probe(port)) return {
+		notOurs: `pid ${pid} on port ${port} does not answer Metro's /status`,
+		kind: NOT_OURS_UNRESPONSIVE,
+		pid
+	};
+	const cwd = cwdOf(pid);
+	if (!cwd) {
+		const owner = ownedSupervisor(projectPath, port);
+		if (owner && (pid === owner.pid || pid === owner.serverPid)) return { metro: {
+			pid,
+			leader: owner.pid,
+			cwd: canonicalPath(projectPath),
+			processToken: owner.processToken
+		} };
+		return {
+			notOurs: `pid ${pid} on port ${port}: working directory could not be read`,
+			kind: NOT_OURS_UNREADABLE_CWD,
+			pid
+		};
+	}
+	if (!isInsideProject(cwd, projectPath)) return {
+		notOurs: `pid ${pid} on port ${port} runs from ${cwd}, outside ${projectPath}`,
+		kind: NOT_OURS_FOREIGN_CWD,
+		pid
+	};
+	const owner = ownedSupervisor(projectPath, port);
+	return { metro: {
+		pid,
+		leader: owner ? owner.pid : pid,
+		cwd,
+		...owner ? { processToken: owner.processToken } : {}
+	} };
+}
+/**
+* Terminate a process and everything it spawned. On POSIX `group` signals the process group, which
+* is what a detached leader owns. Windows has no process groups, and its SIGTERM is
+* TerminateProcess: no handler runs and no child is reached, so a spawned dev server or `adb
+* logcat` would outlive its parent. taskkill /T is the only route to the tree there, and it is
+* always forceful.
+*/
+function signalProcessTree(pid, signal = "SIGTERM", { group = false, platform = process.platform } = {}) {
+	if (platform !== "win32") return process.kill(group ? -pid : pid, signal);
+	return getExecutor().runFileQuiet("taskkill", [
+		"/PID",
+		String(pid),
+		"/T",
+		"/F"
+	]) !== null;
+}
+function killMetroTree(leader, processToken) {
+	if (!leader || leader === process.pid || (0, process_identity_exports.inspectProcessIdentity)({
+		pid: leader,
+		processToken
+	}) !== "same") return false;
+	try {
+		return signalProcessTree(leader, "SIGTERM", { group: true });
+	} catch {
+		return false;
+	}
+}
+//#endregion
+export { resolveProjectMetro as a, isPortFree as c, pidExists as i, reserveMetroPort as l, killMetroTree as n, signalProcessTree as o, listeningPids as r, isMetroRunning as s, NOT_OURS_FOREIGN_CWD as t };