stim 1.3.0 → 1.3.1

package/dist/{guide-92CPA21s.mjs → guide-D95E0u3i.mjs}

@@ -62,6 +62,8 @@ warm checks for existing entries before copying, not during the copy. Do not
 edit files, install dependencies, or run another warm in that worktree until
 it finishes; concurrent files can be overwritten or removed.
 If warm fails or reports incomplete, resolve the reported failure first.
+A warm that cannot record its ownership claim refuses before copying. Follow
+the printed remedy and keep concurrent runs on the same STIM_HOME.
 
 Before native worktree work, run doctor for the platform in scope. It checks
 the source checkout from a linked worktree. Fix relevant findings and inspect the
@@ -80,6 +82,12 @@ current and highest observed pressure; a timeout does not establish OOM.
 Avoid repeated reboots under unchanged pressure; do not restart other
 workspaces' devices or close their apps without asking. That guide covers
 the recovery steps and profile tradeoffs.
+An Android boot timeout under observed elevated memory pressure gets one
+extra wait while the emulator process this run started is alive. It never
+launches a second emulator. For a timeout, read guide errors STIM_NO_DEVICE
+and free memory by stopping only unneeded devices in workspaces you own;
+ask before closing other apps or devices. Device count alone is not evidence
+of memory pressure.
 For a linked native library carrying Git metadata, add the printed .git entries to
 .fingerprintignore only when the native build does not read Git state.
 
@@ -180,8 +188,9 @@ RULES DURING THE LOOP
 - A clean logs --errors check requires exit code 0 AND no matching errors in
   captured logs. Exit code 0 alone means the query succeeded, even when errors
   were printed. Human output shows "No matching log records" on stderr for
-  zero matches; JSON mode prints zero bytes. This does not prove launch or log
-  capture succeeded. Do not read the NDJSON files directly.
+  zero matches; JSON mode prints zero bytes. A workspace with no captured
+  timeline refuses with STIM_NO_PROJECT and, in a monorepo, names the nearest
+  registered descendant app with logs. Do not read the NDJSON files directly.
 - Use stim status when resuming a workspace or recovering missing device,
   port, server, or build facts. A normal start and platform run already print
   them. Use stim doctor when a build is unexpectedly slow or the environment
@@ -196,6 +205,8 @@ the stim-<label> (<model> <runtime>) name. Never point Stim at a user-created
 emulator or simulator.
 
 worktree remove parks the workspace's simulator or emulator for later adoption.
+Before owned-device teardown, Stim best-effort closes local agent-device sessions
+on that exact device; failures warn and teardown continues (guide cleanup).
 A parked device is Stim-owned: never delete one by hand. gc --delete clears verified
 entries and keeps failures; see guide lifecycle pool. First launch on a
 physical iPhone can need the one-time taps named by the remedy.
@@ -898,10 +909,12 @@ discovered, not enumerated.
 
 EXIT 0 MEANS THE QUERY SUCCEEDED, whether or not records matched. A clean
 \`stim logs --errors\` check requires exit code 0 AND no matching errors in
-captured logs. An empty result does not prove launch or log capture succeeded;
-a workspace with no log directory also returns an empty result.
+captured logs. A workspace that has never produced a timeline refuses with
+STIM_NO_PROJECT instead of passing with an empty result. In a monorepo the
+refusal names the nearest registered descendant app with logs, when there is one.
 
-For zero matches: STDOUT IS EMPTY, exit code 0, and
+Once a timeline file exists, zero matches after filtering means STDOUT IS EMPTY,
+exit code 0, and
 one dim note on STDERR reading \`No matching log records in <logs dir>\`
 (human mode only -- \`--json\` prints nothing at all, on either stream).
 The only exit-1 paths are a malformed query and no project.
@@ -1404,14 +1417,13 @@ code, never on the message.`,
   \`worktree warm\` reports it for the repository-wide warm claim under
   ~/.stim/warm-locks on both paths, including a \`--refresh\` that spawned its
   install and was killed before recording which process: nothing was refreshed
-  and nothing was copied. One case is NOT this code for a plain warm: a
-  STIM_HOME (or a warm-locks path under it) that is a file rather than a
-  directory. No claim can be stored there at all, which is a filesystem state
-  that predates claims, so plain \`warm\` degrades to the unsynchronised copy it
-  performed before them and \`--refresh\` still refuses.`
+  and nothing was copied. A STIM_HOME or warm-locks ancestor that is a file
+  also refuses. The message names that blocking path and prints a shell-quoted
+  move-aside command. Inspect it first: the file may contain unrelated data.
+  An existing backup prompts before overwriting; preserve both files.`
 			},
 			STIM_CLAIM_UNAVAILABLE: {
-				summary: "this process has no recordable identity, so no build lock or build slot can be taken at all",
+				summary: "a process identity or warm claim store is unavailable, so the protected operation refuses",
 				body: () => `STIM_CLAIM_UNAVAILABLE
   Every ownership claim records the holder's process identity, captured through
   the \`unique-pid\` native module. This code is that capture failing: no
@@ -1423,16 +1435,15 @@ code, never on the message.`,
   the same fingerprint while each believed it was alone. Reinstall Stim so the
   module for this platform is present, then run the command again. Nothing was
   built, installed or removed.
-  \`worktree warm --refresh\` refuses for the same reason, because it writes to
-  the source checkout. Plain \`worktree warm\` does NOT: it prints one dim
-  \`lock        unavailable (...)\` line and copies unsynchronised. A copy only
-  reads, so running it with no claim is what it did before the lock existed,
-  while refusing it would break a warm that works today -- an unwritable
-  STIM_HOME included.
-  It still reads the claim set first, which takes no claim: a live \`--refresh\`
-  claim, or a claim it cannot resolve, makes even the unsynchronised copy
-  refuse, and the line names what it found. Only a repository nothing is
-  warming is copied without a claim.`
+  Both plain \`worktree warm\` and \`worktree warm --refresh\` refuse before
+  copying for the same reason. A copy without a claim would be invisible to a
+  refresh starting after it, allowing the source dependencies to change while
+  they are read.
+  Warm also reports this code for EACCES, EPERM, EROFS and ENOENT while taking a claim.
+  The message names the claim path and original filesystem error. Restore write
+  access to the existing claim store, checking parent permissions, symlink
+  targets, mount access and sandbox rules, then retry. Do not switch STIM_HOME to evade a claim:
+  concurrent runs must coordinate through the same store.`
 			},
 			STIM_INSTALL_FAILED: {
 				summary: "simctl, adb, or devicectl refused the artifact; the one signer-conflict retry",
@@ -1717,6 +1728,20 @@ so a Debug run on one is wired to a LAN origin instead of localhost.`,
   normally live under ~/.android/avd, and a booted AVD can use several GB. A
   boot whose emulator process exited is also reported at once rather than after
   the full cold-boot timeout.
+  Before a local Android emulator boot, a memory phase line reports observed
+  warning or critical macOS host memory pressure. If the initial boot wait
+  times out under that pressure and the process this run started is still
+  alive, Stim retries the WAIT once for up to 240 seconds more on the same
+  serial; it never starts a second emulator. New-device preparation normally
+  waits 120 seconds first; the later boot check waits 240 seconds. There is
+  no extra wait for normal or unavailable pressure, a process that exited,
+  or a process whose liveness this run cannot check. adb probes are bounded;
+  final diagnostic queries share a separate budget of up to five seconds.
+  A timeout remedy reports observed pressure and the running owned-device
+  count when available. Device count alone does not establish memory pressure
+  or trigger the extra wait. Stop an unneeded device with \`stim stop\` only
+  in a workspace you own, then retry \`stim android\`; ask before closing
+  other apps or devices. Specific emulator log errors retain their remedies.
 
 "this project's sim is X, but --device-type asked for Y"
   The project already owns a simulator of a different model, and Stim will
@@ -1984,7 +2009,9 @@ captured"  (in metro.ndjson, bare RN)
   with no package.json above it, or one whose nearest package.json does not
   parse or depends on neither react-native nor expo, so the directory is not
   an app (the refusal names that package.json and says which of the two it
-  is; \`doctor\` reports the same directory as a finding), an
+  is; \`doctor\` reports the same directory as a finding), a \`logs\` query in
+  a workspace that has never produced a log timeline (the refusal names the
+  nearest registered descendant app with logs when one exists), an
   android/app/build.gradle that declares product flavors with
   no variant selected (the refusal names the debug variants), or a
   \`--device-type\`, \`--runtime\` or \`--system-image\` name that is BLANK or
@@ -2142,24 +2169,14 @@ not on any remote"  (worktree remove)
   which is usually the repository root, so every app of it reads the same one.`
 			},
 			warm: {
-				summary: "two warm refusals whose text is incomplete, known and not fixed",
-				body: () => `"Could not warm this worktree: EACCES: permission denied, mkdir
-'<home>/warm-locks/<name>.lock'"  (worktree warm --refresh)
-  A STIM_HOME that \`--refresh\` cannot write. The refusal itself is right -- it
-  writes to the source checkout, so it will not run without a claim -- but it
-  carries no \`failed: <CODE>\` line, because EACCES is not a Stim code, and no
-  fix line. Make STIM_HOME writable, or set STIM_HOME to somewhere writable,
-  then run it again. A plain warm degrades in this state rather than refusing.
-
-"... the claim path is a file, not a claim directory", with a \`rm -rf\` that
-changes nothing  (worktree warm --refresh)
-  When \`$STIM_HOME/warm-locks\` or STIM_HOME itself is a regular FILE, the
-  refusal names \`warm-locks/<name>.lock\` -- a path that cannot exist under a
-  file -- so running the printed removal does nothing and the next run refuses
-  identically. Remove the file that is in the way and run it again. A plain
-  warm copies unsynchronised in this state.
-
-  Both are documented rather than fixed: appandflow/stim#696.`
+				summary: "worktree warm claim storage refusals and recovery",
+				body: () => `Both plain warm and --refresh require an ownership claim.
+  Permission-denied or read-only claim storage reports STIM_CLAIM_UNAVAILABLE
+  and names the path. Restore access to the existing claim store and retry.
+  A non-directory claim ancestor reports STIM_CLAIM_REFUSED and names the
+  blocking file. Inspect it and use the printed move-aside command to preserve
+  its contents before retrying. See guide errors STIM_CLAIM_UNAVAILABLE and
+  guide errors STIM_CLAIM_REFUSED for the recovery details.`
 			},
 			carry: {
 				summary: "worktree warm copy results, lockfile mismatches, and remedies",
@@ -2340,6 +2357,7 @@ a seed belongs to this workflow.
   #    For a clean check, require exit 0 AND no matching errors.
   #    Human mode prints "No matching log records" on stderr for zero matches.
   #    Exit 0 alone means the query succeeded, even when it printed errors.
+  #    A workspace with no captured timeline refuses with STIM_NO_PROJECT.
   stim logs --errors
 
   # 5. Edit the JS. Fast Refresh applies it; no Stim command is involved.
@@ -2435,6 +2453,12 @@ ANDROID EMULATOR RESTARTS
   Rerun \`stim android\` with the same build options in that workspace to restore Metro
   forwarding, then reopen agent-device on the serial that run reports.
   Other workspaces' simulators and automation sessions remain theirs.
+  A local emulator boot reports observed warning or critical macOS memory
+  pressure before starting. A timeout under elevated pressure gets one
+  additional wait of up to 240 seconds only while the process this run
+  started is alive. Stim keeps waiting on the same emulator; it never
+  launches a duplicate. See \`stim guide errors STIM_NO_DEVICE\` for the
+  wait windows, diagnostics, and recovery steps.
 
 DESTRUCTIVE COMMANDS -- ask the user first
   gc --delete             deletes orphaned stim-* devices, tens of GB
@@ -2707,9 +2731,11 @@ result as proof instead of requiring an unrelated screenshot.`
 
   \`--refresh\` always prints a \`lock\` line, then its own facts, one per
   step, before those. A plain warm prints the \`lock\` line only when its copy
-  actually waited for another warm:
+  actually waited for another warm. A current refresh reports
+  \`lock        acquired shared (seed current)\`; a refresh needing changes
+  reports \`acquired exclusive\` with the reason from its initial check:
 
-    lock        acquired (waited 12s for stim worktree warm --refresh pid 41233) -- stim guide lifecycle options
+    lock        acquired exclusive (fast-forward 2 commits) (waited 12s for stim worktree warm --refresh pid 41233) -- stim guide lifecycle options
     checkout    janic/wip 2 commits behind origin/janic/wip -> fast-forwarded to 4b81e0c
                 not the default branch (main); worktrees seeded from this copy
                 carry janic/wip's dependencies
@@ -3129,6 +3155,20 @@ WHAT MAKES THE CACHE ACTUALLY HIT: .FINGERPRINTIGNORE
   Never ignore a real native input -- a Podfile, a gradle file, the app config
   -- to force a hit: that trades a slow build for a wrong one.
 
+
+  React Native Test App can generate checkout-specific Android output under
+  node_modules/react-native-test-app/android/support/build. If fingerprint
+  differences point only there, add these project-specific entries:
+
+    node_modules/react-native-test-app/android/support/build
+    node_modules/react-native-test-app/android/support/build/**/*
+
+  Put them in the app root's .fingerprintignore and use the path as it appears
+  in the fingerprint sources; a hoisted or linked dependency may differ.
+  Keep android/support/build.gradle and native sources included. Confirm equal
+  fingerprints across built worktrees, and confirm a real native input edit
+  still changes the hash. These exclusions are not Stim defaults.
+
   \`stim doctor\` measures this directly rather than reading the file: it
   fingerprints HEAD in a temporary clean worktree, compares, and reports a
   mismatch naming the differing sources. Untracked, non-gitignored files under
@@ -3274,8 +3314,9 @@ OPT-IN CONCURRENCY LIMITS (UNLIMITED BY DEFAULT)
   Running it in the source checkout refuses.
 
   \`--refresh\` WRITES TO THE SOURCE CHECKOUT before the copy, which is why it
-  is opt-in: it fetches, fast-forwards whatever branch is checked out there to
-  its \`@{upstream}\`, and installs what the new commits moved. It refuses a
+  is opt-in: it checks the upstream, fetches changes when needed, and fast-forwards
+  whatever branch is checked out there to its \`@{upstream}\`, and installs
+  what the new commits moved. It refuses a
   source checkout it cannot move -- uncommitted changes to tracked files or a
   rebase or merge in progress (STIM_MAIN_DIRTY), a detached HEAD
   (STIM_MAIN_DETACHED), or a branch that is both ahead and behind
@@ -3309,9 +3350,15 @@ OPT-IN CONCURRENCY LIMITS (UNLIMITED BY DEFAULT)
   writes no failure anywhere -- is recovered the same way a failed one is.
 
   One lock per repository serialises this, whether or not you pass the flag:
-  \`--refresh\` holds it exclusively, and every copy holds it shared, so a copy
-  can never read a node_modules a refresh is rewriting. Two plain warms of the
-  same repository run together. The lock is keyed on the repository root, so
+  \`--refresh\` first checks under a shared claim. It uses \`git ls-remote\`
+  to compare the upstream's advertised commit with the local tracking ref without
+  updating Git refs or FETCH_HEAD. When the checkout, dependencies and Pods are
+  current, it keeps that shared claim through the copy, overlapping other copies.
+  A changed or unconfirmed upstream, fast-forward, dependency install or Pods
+  install requires an exclusive claim. It releases shared before waiting for
+  exclusive, then checks the checkout again before fetching or writing. Every
+  copy holds shared, so no copy reads a node_modules a refresh is rewriting.
+  The lock is keyed on the repository root, so
   two apps of one monorepo share it. It is the same ownership claim the build
   locks take: the holder's process IDENTITY decides, so a holder that dies frees
   it, a recycled pid cannot keep it, and a refresh whose install runs in a
@@ -3319,20 +3366,13 @@ OPT-IN CONCURRENCY LIMITS (UNLIMITED BY DEFAULT)
   holder every 30s and gives up with STIM_LOCK_TIMEOUT; a claim Stim cannot
   resolve refuses with STIM_CLAIM_REFUSED and names the removal rather than
   waiting on it or removing it.
-  A plain warm that cannot record a claim at all -- an unwritable STIM_HOME, a
-  STIM_HOME on a read-only mount or under a dangling symlink, a STIM_HOME that
-  is a file, or no \`unique-pid\` build for this platform
-  (STIM_CLAIM_UNAVAILABLE) -- says so in one dim line and copies without it,
-  exactly as it did before the lock existed, because a copy only reads.
-  \`--refresh\` refuses instead, because it writes. Before that unsynchronised
-  copy starts, warm still READS the claim set, which needs no claim of its own:
-  if a refresh holds this repository, or a claim in it cannot be resolved, the
-  copy refuses rather than reading a tree that is being rewritten. That read is
-  not a lock, so a refresh that starts after it is not covered; it closes the
-  window in which one is already installing. Closing the rest needs a claim,
-  which is the one thing that state cannot record, so the residual is
-  documented rather than fixed (appandflow/stim#696), as is the
-  \`acquired (waited 0s ...)\` a contended-but-fast wait prints.
+  Both plain warm and --refresh refuse before copying when no claim can be
+  recorded. Missing process identity, denied write access and read-only storage
+  report STIM_CLAIM_UNAVAILABLE with recovery instructions. Restore access to the
+  same claim store before retrying; choosing a different STIM_HOME would hide
+  concurrent warm operations. A non-directory claim path reports
+  STIM_CLAIM_REFUSED and names the blocking file with a move-aside command that
+  preserves its contents. Sub-second waits omit the elapsed-time suffix.
 
   Wait for warm to exit successfully (exit code 0) before running start,
   ios, android, or a dependency install in that worktree. If a shell tool
@@ -3814,6 +3854,16 @@ Those are the only two commands that delete. \`stim stop\` shuts a device
 DOWN and leaves it assigned, which is what makes returning to a branch cost a
 boot rather than a create, a provision and a reinstall.
 
+Before shutting down, parking or deleting an owned device, Stim best-effort
+closes local agent-device sessions bound to its exact iOS UDID or live Android
+serial. It rechecks device ownership and uses agent-device's rejecting session
+target guard; sessions on other devices stay open. Physical devices are outside
+this cleanup. agent-device is optional: a missing binary skips this step, and a
+failed or timed-out list/close prints a device line on stderr while teardown
+continues. Cleanup allows at most 15 seconds of agent-device calls per device.
+A local daemon that cannot use socket transport or a CLI without the target guard
+skips cleanup with a warning; no remote daemon is used.
+
 Neither touches $STIM_HOME/stats.json: \`gc\` never reports or trims the run
 counters \`stats\` prints, and there is no reset flag. Delete that one file to
 start the counters over. A file this version cannot read -- unparseable, or

package/dist/{ios-BSXFeO5H.mjs → ios-DAju3TVy.mjs}

@@ -7,24 +7,24 @@ import { a as findProjectRoot, c as projectShortcut, i as detectIsExpo, r as det
 import { i as resolveProjectMetro, r as pidExists } from "./metro-CORqXyTL.mjs";
 import { n as verifyCollectorOwnership } from "./ownership-8O073GIC.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-8wHMEde0.mjs";
-import { r as claimFailure } from "./ownership-claim-Bf2CAfw3.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-BqVIJoG7.mjs";
+import { r as claimFailure } from "./ownership-claim-BtPtJVmq.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-hMj83VpN.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-DEJf6_kJ.mjs";
-import { C as uploadRemote, S as resolveRemote, _ as isEasAuthFailureText, a as POOL_SETTING_REMEDY, c as parkedMaxSetting, d as RESOLVE_TIMEOUT_MS, f as UPLOAD_TIMEOUT_MS, g as exitAfterFlush, h as easAuthNote, m as checkEasAuth, p as cacheLevel, v as loadProjectProvider, x as resolveEasCliBin } from "./teardown-ClFp1Aax.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-BjisHDB5.mjs";
-import { t as withWorkspaceProcessLock } from "./workspace-process-lock-3NcQnZ0X.mjs";
+import { C as uploadRemote, S as resolveRemote, _ as isEasAuthFailureText, a as POOL_SETTING_REMEDY, c as parkedMaxSetting, d as RESOLVE_TIMEOUT_MS, f as UPLOAD_TIMEOUT_MS, g as exitAfterFlush, h as easAuthNote, m as checkEasAuth, p as cacheLevel, v as loadProjectProvider, x as resolveEasCliBin } from "./teardown--gESs9ck.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-VfSZNLT4.mjs";
+import { t as withWorkspaceProcessLock } from "./workspace-process-lock-IBj1Towr.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-DIp9riNx.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-CPbLGfrB.mjs";
-import { r as releaseBuildSlot, t as acquireBuildSlot } from "./build-slots-C3-R4XQr.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-CcBNTvM7.mjs";
+import { r as releaseBuildSlot, t as acquireBuildSlot } from "./build-slots-C4AouyNz.mjs";
 import { a as statsProjectKey, i as recordRunStats, n as readRunEstimates, t as createRunRecorder } from "./stats-BR-kwj0B.mjs";
-import { T as unknownIosRuntimeRefusal, b as ensureBooted, c as discoverXcodeProject, d as resolveScheme, i as buildIos, l as readBundleExecutable, m as describeDiagnostic, n as COMPILATION_CACHE_UNAVAILABLE, o as compilationCacheActivityLine, t as COMPILATION_CACHE_NOT_RUN, u as readBundleId, v as checkDeviceCapacity, w as unknownIosDeviceTypeRefusal, x as ensureOwnedDevice, y as clearIosAdoptionPending } from "./xcode-D7sAp-Zy.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-AkYCKS8U.mjs";
-import { n as nativeRunCommand, t as launchSlotScope } from "./slot-launch-cci0xvmC.mjs";
+import { E as unknownIosRuntimeRefusal, S as ensureOwnedDevice, T as unknownIosDeviceTypeRefusal, b as clearIosAdoptionPending, c as discoverXcodeProject, d as resolveScheme, i as buildIos, l as readBundleExecutable, m as describeDiagnostic, n as COMPILATION_CACHE_UNAVAILABLE, o as compilationCacheActivityLine, t as COMPILATION_CACHE_NOT_RUN, u as readBundleId, x as ensureBooted, y as checkDeviceCapacity } from "./xcode-xnxyvJkD.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-DAA0Zm6Z.mjs";
+import { n as nativeRunCommand, t as launchSlotScope } from "./slot-launch-CZklomj6.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-DHC31rXA.mjs";
+import { a as printNativeCrashReport, n as IOS_CRASH_REPORT_RETRY, o as simulatorConsolePaths, r as captureNativeCrashes, t as errorDiagnostics } from "./error-diagnostics-DwhNBFDU.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-CWOM_S44.mjs";
-import { a as runPodInstall, n as podsAreStale, r as readPodState } from "./deps-Spz8ozgo.mjs";
+import { a as runPodInstall, n as podsAreStale, r as readPodState } from "./deps-0Yt0Inly.mjs";
 import { existsSync, mkdirSync, mkdtempSync, openSync, rmSync, writeFileSync } from "node:fs";
 import { InvalidArgumentError } from "commander";
 import { X509Certificate } from "node:crypto";

package/dist/{logs-DPNF4C9s.mjs → logs-CAdwW6c2.mjs}

@@ -1,10 +1,12 @@
-import { V as validateDeviceSlot } from "./config-CcefMY2Q.mjs";
+import { V as validateDeviceSlot, g as loadConfig, h as isPathPrefix } from "./config-CcefMY2Q.mjs";
 import { n as SOURCES, t as LEVELS } from "./ndjson-BZwI1NBv.mjs";
 import { D as workspaceLogsDir, p as readWorkspaceState } from "./state-B3XA2wp2.mjs";
 import { a as findProjectRoot } from "./project-fKmuIaMI.mjs";
 import { _ as launchErrorPreview } from "./command-output-8wHMEde0.mjs";
-import { i as captureWorkspaceCrashes, t as errorDiagnostics } from "./error-diagnostics-DHC31rXA.mjs";
-import { a as followLogs, i as fileSizes, n as buildCriteria, o as parseSince, r as compileGrep, s as queryLogs } from "./logs-query-R-Cqc6Qv.mjs";
+import { i as captureWorkspaceCrashes, t as errorDiagnostics } from "./error-diagnostics-DwhNBFDU.mjs";
+import { a as followLogs, c as queryLogs, i as fileSizes, n as buildCriteria, o as logFiles, r as compileGrep, s as parseSince } from "./logs-query-Cdp5aaCH.mjs";
+import { realpathSync } from "node:fs";
+import { relative, sep } from "node:path";
 import chalk from "chalk";
 //#region src/commands/logs.ts
 const LEVEL_WIDTH = 5;
@@ -61,6 +63,28 @@ function validateLevel(level) {
 	return { error: `Invalid --level value ${JSON.stringify(level)}. Use one of: ${LEVELS.join(", ")}.` };
 }
 const ERRORS_PRINT_CAP = 20;
+function nearestRegisteredLogsProject(root, candidates) {
+	return candidates.filter((candidate) => candidate !== root && isPathPrefix(root, candidate)).toSorted((a, b) => {
+		const depth = (path) => relative(root, path).split(sep).length;
+		return depth(a) - depth(b) || a.length - b.length || a.localeCompare(b);
+	})[0] ?? null;
+}
+function registeredDescendantWithLogs(root) {
+	const candidates = Object.keys(loadConfig()?.projects ?? {}).flatMap((path) => {
+		try {
+			const canonical = realpathSync(path);
+			return logFiles(workspaceLogsDir(canonical)).length > 0 ? [canonical] : [];
+		} catch {
+			return [];
+		}
+	});
+	return nearestRegisteredLogsProject(root, [...new Set(candidates)]);
+}
+function requireLogsWorkspace(root, dir) {
+	if (logFiles(dir).length > 0) return;
+	const descendant = registeredDescendantWithLogs(root);
+	fail(`STIM_NO_PROJECT: No Stim workspace has run in ${root}.${descendant ? ` The nearest registered app with logs is ${descendant}; run this command from there.` : " Run `stim start`, `stim ios`, or `stim android` in the app first."}`);
+}
 const LEVEL_COLOURS = {
 	debug: chalk.dim,
 	info: chalk.reset,
@@ -69,7 +93,7 @@ const LEVEL_COLOURS = {
 	fatal: chalk.bgRed
 };
 function logsCommand(program) {
-	program.command("logs").description("Query this workspace's merged NDJSON log timeline (bundler, client, device, build). Prints and exits; nothing matching is a successful, empty result. Use --follow to stream.").option("--slot <name>", "Only records attributed to this device slot", validateDeviceSlot).option("--source <s...>", "Only these sources: metro, client, device, build, or all").option("--level <l>", `Minimum level: ${LEVELS.join(", ")}`).option("--since <d>", "Only records newer than this, e.g. 30s, 5m, 2h").option("--grep <re>", "Only records whose message matches this regular expression").option("--tail <n>", "Only the last n matching records").option("--errors", "Errors and fatals since the last marker, from metro, client and build, plus confirmed native app-crash reports. Add --source device or --source all for general device errors.").option("--follow", "Keep streaming new records until interrupted").option("--json", "Emit the raw records, one per line (valid NDJSON; zero matches is zero bytes, exit 0)").action(async (opts) => {
+	program.command("logs").description("Query this workspace's merged NDJSON log timeline (bundler, client, device, build). Prints and exits; an existing timeline with nothing matching is a successful, empty result. Use --follow to stream.").option("--slot <name>", "Only records attributed to this device slot", validateDeviceSlot).option("--source <s...>", "Only these sources: metro, client, device, build, or all").option("--level <l>", `Minimum level: ${LEVELS.join(", ")}`).option("--since <d>", "Only records newer than this, e.g. 30s, 5m, 2h").option("--grep <re>", "Only records whose message matches this regular expression").option("--tail <n>", "Only the last n matching records").option("--errors", "Errors and fatals since the last marker, from metro, client and build, plus confirmed native app-crash reports. Add --source device or --source all for general device errors.").option("--follow", "Keep streaming new records until interrupted").option("--json", "Emit the raw records, one per line (valid NDJSON; zero matches is zero bytes, exit 0)").action(async (opts) => {
 		const root = findProjectRoot(process.cwd());
 		if (!root) {
 			console.error(chalk.red("Not in a React Native project (no package.json found)."));
@@ -102,6 +126,7 @@ function logsCommand(program) {
 			const compiled = compileGrep(opts.grep);
 			if (compiled.error) fail(compiled.error);
 		}
+		requireLogsWorkspace(root, dir);
 		const query = {
 			slot: opts.slot,
 			dir,

package/dist/{logs-query-R-Cqc6Qv.mjs → logs-query-Cdp5aaCH.mjs}

@@ -287,4 +287,4 @@ function sortByTs(records) {
 	});
 }
 //#endregion
-export { followLogs as a, readLogRecords as c, fileSizes as i, buildCriteria as n, parseSince as o, compileGrep as r, queryLogs as s, attachExpoErrorContext as t };
+export { followLogs as a, queryLogs as c, fileSizes as i, readLogRecords as l, buildCriteria as n, logFiles as o, compileGrep as r, parseSince as s, attachExpoErrorContext as t };

package/dist/{ownership-BpCKiRlQ.mjs → ownership-DXcol4oU.mjs}

@@ -2,7 +2,7 @@ import { t as getExecutor } from "./exec-CyylIdq9.mjs";
 import { E as inspectProcessIdentity, T as captureProcessToken, u as getConfigDir } from "./config-CcefMY2Q.mjs";
 import { t as createLineReader } from "./process-output-C7IlIzd7.mjs";
 import { r as pidExists } from "./metro-CORqXyTL.mjs";
-import { t as withWorkspaceProcessLock } from "./workspace-process-lock-3NcQnZ0X.mjs";
+import { t as withWorkspaceProcessLock } from "./workspace-process-lock-IBj1Towr.mjs";
 import { closeSync, mkdirSync, openSync, readFileSync, unlinkSync } from "node:fs";
 import { createHash, randomUUID } from "node:crypto";
 import { basename, join, resolve, sep } from "node:path";

package/dist/{ownership-claim-Bf2CAfw3.mjs → ownership-claim-BtPtJVmq.mjs}

@@ -6,12 +6,6 @@ import { dirname, join } from "node:path";
 //#region src/ownership-claim.ts
 const CLAIM_REFUSED = "STIM_CLAIM_REFUSED";
 const CLAIM_UNAVAILABLE = "STIM_CLAIM_UNAVAILABLE";
-/**
-* The refusal reason for a claim store whose own path is occupied by a file. It names a filesystem
-* state that predates any claim, so a caller that only reads can tell it apart from an unresolvable
-* claim record and fall back to what it did before claims existed.
-*/
-const CLAIM_PATH_NOT_A_DIRECTORY = "the claim path is a file, not a claim directory";
 const EXCLUSIVE_DIR = "exclusive";
 const SHARED_DIR = "shared";
 const CLAIM_SUFFIX = ".claim";
@@ -23,9 +17,9 @@ var ClaimRefusedError = class extends Error {
 	claimPath;
 	reason;
 	removeCommand;
-	constructor({ claimPath, root, reason, label }) {
-		const removeCommand = claimRemoveCommand(claimPath.startsWith(root) ? claimPath : root);
-		super(`Stim cannot tell whether the ${label} claim at ${claimPath} is still held: ${reason}. It will not remove a claim it cannot prove is dead, and it will not wait on one either. If nothing is using it, remove the claim and run the command again:\n  ${removeCommand}`);
+	constructor({ claimPath, root, reason, label, blockingFile = false }) {
+		const removeCommand = blockingFile ? `mv -i ${quotedPath(claimPath)} ${quotedPath(`${claimPath}.stim-backup`)}` : claimRemoveCommand(claimPath.startsWith(root) ? claimPath : root);
+		super(blockingFile ? `The ${label} claim store is blocked by a non-directory path at ${claimPath}. Inspect it before moving it aside; its contents may be unrelated to Stim. Preserve it with the command below (an existing backup prompts before overwriting), then run the command again:\n  ${removeCommand}` : `Stim cannot tell whether the ${label} claim at ${claimPath} is still held: ${reason}. It will not remove a claim it cannot prove is dead, and it will not wait on one either. If nothing is using it, remove the claim and run the command again:\n  ${removeCommand}`);
 		this.claimPath = claimPath;
 		this.reason = reason;
 		this.removeCommand = removeCommand;
@@ -34,9 +28,11 @@ var ClaimRefusedError = class extends Error {
 var ClaimUnavailableError = class extends Error {
 	code = CLAIM_UNAVAILABLE;
 	reason;
-	constructor(reason) {
-		super(`Stim could not record a process identity, so it cannot take an ownership claim: ${reason}.`);
+	remedy;
+	constructor(reason, { claimPath } = {}) {
+		super(claimPath ? `Stim could not write the ownership claim at ${claimPath}: ${reason}.` : `Stim could not record a process identity, so it cannot take an ownership claim: ${reason}.`);
 		this.reason = reason;
+		this.remedy = claimPath ? `Restore write access to the existing claim store at ${quotedPath(claimPath)} (check parent permissions, symlink targets, mount access and sandbox rules)` : "Reinstall Stim so the unique-pid native module for this platform is present";
 	}
 };
 /**
@@ -53,12 +49,7 @@ function isClaimRefusal(err) {
 function isClaimUnavailable(err) {
 	return err?.code === CLAIM_UNAVAILABLE;
 }
-/**
-* The refusal a command reports for either error the claim primitive raises, and null for anything else.
-* Both are refusals: a claim Stim cannot resolve and a process identity it cannot record are the two
-* states in which it holds no claim, and running the operation a claim serializes without one gives a
-* competing run no protection at all.
-*/
+/** Convert an unresolved claim, unavailable identity or inaccessible warm claim store into command recovery guidance. */
 function claimFailure(err, retryCommand) {
 	const retry = retryCommand === null ? "retry the same Stim command" : `run \`${retryCommand}\` again`;
 	if (isClaimRefusal(err)) return {
@@ -69,7 +60,7 @@ function claimFailure(err, retryCommand) {
 	if (isClaimUnavailable(err)) return {
 		code: CLAIM_UNAVAILABLE,
 		message: err.message,
-		remedy: `Reinstall Stim so the unique-pid native module for this platform is present, then ${retry}.`
+		remedy: `${err.remedy}, then ${retry}.`
 	};
 	return null;
 }
@@ -174,6 +165,29 @@ function refuse(root, claimPath, label, reason) {
 		reason
 	});
 }
+function refuseNonDirectory(root, path, label) {
+	let blocking = null;
+	for (let level = path;; level = dirname(level)) {
+		try {
+			if (!statSync(level).isDirectory()) {
+				blocking = level;
+				break;
+			}
+		} catch (error) {
+			const code = error?.code;
+			if (code !== "ENOENT" && code !== "ENOTDIR") break;
+		}
+		if (dirname(level) === level) break;
+	}
+	if (blocking === null) throw new ClaimUnavailableError("the non-directory path could not be identified; the claim store may have changed", { claimPath: root });
+	throw new ClaimRefusedError({
+		root,
+		claimPath: blocking,
+		label,
+		reason: "the claim path is a file, not a claim directory",
+		blockingFile: true
+	});
+}
 function names(dir) {
 	try {
 		return readdirSync(dir).toSorted();
@@ -405,7 +419,7 @@ function publishExclusive(root, payload, claimId, label) {
 		});
 		const code = err?.code;
 		if (contended(err)) return null;
-		if (code === "ENOTDIR") refuse(root, target, label, CLAIM_PATH_NOT_A_DIRECTORY);
+		if (code === "ENOTDIR") refuseNonDirectory(root, target, label);
 		throw err;
 	}
 }
@@ -439,7 +453,7 @@ function tryAcquireClaim({ root, mode, details = {}, label = "ownership" }) {
 			createClaimDir(root);
 		} catch (err) {
 			const code = err?.code;
-			if (code === "EEXIST" || code === "ENOTDIR") refuse(root, root, label, CLAIM_PATH_NOT_A_DIRECTORY);
+			if (code === "EEXIST" || code === "ENOTDIR") refuseNonDirectory(root, root, label);
 			if (contended(err)) continue;
 			throw err;
 		}
@@ -567,4 +581,4 @@ function writeChild(handle, body) {
 	}
 }
 //#endregion
-export { clearClaimChild as a, isClaimUnavailable as c, readClaimSet as d, releaseClaim as f, tryAcquireClaim as h, claimRemoveCommand as i, markClaimChildPending as l, settleClaim as m, ClaimRefusedError as n, clearFreeClaimSet as o, setClaimChild as p, claimFailure as r, isClaimRefusal as s, CLAIM_PATH_NOT_A_DIRECTORY as t, processGroupAlive as u };
+export { clearClaimChild as a, markClaimChildPending as c, releaseClaim as d, setClaimChild as f, claimRemoveCommand as i, processGroupAlive as l, tryAcquireClaim as m, ClaimUnavailableError as n, clearFreeClaimSet as o, settleClaim as p, claimFailure as r, isClaimRefusal as s, ClaimRefusedError as t, readClaimSet as u };

package/dist/{reclaim-iW9Cad7k.mjs → reclaim-CUmwucWG.mjs}

@@ -2,10 +2,10 @@ import { D as sameProcessRecord, O as waitForProcessExit, f as getProject, v as
 import { T as workspaceDir, a as clearRemoteSession, c as readMetroTunnel, d as readRemoteSessionId, i as clearManagedMetroTunnel, p as readWorkspaceState } from "./state-B3XA2wp2.mjs";
 import { i as resolveProjectMetro, n as killMetroTree, r as pidExists } from "./metro-CORqXyTL.mjs";
 import { n as verifyCollectorOwnership } from "./ownership-8O073GIC.mjs";
-import { c as parkedMaxSetting, n as teardownOwnedIosSim, t as teardownOwnedAvd, x as resolveEasCliBin } from "./teardown-ClFp1Aax.mjs";
-import { l as releaseWorkspaceLeases } from "./device-lease-BJYybF-2.mjs";
-import { i as endRecordedSession } from "./device-remote-AkYCKS8U.mjs";
-import { r as stopTunnel, t as resolveSupervisorTarget } from "./ownership-BpCKiRlQ.mjs";
+import { c as parkedMaxSetting, n as teardownOwnedIosSim, t as teardownOwnedAvd, x as resolveEasCliBin } from "./teardown--gESs9ck.mjs";
+import { l as releaseWorkspaceLeases } from "./device-lease-CJwK7OZr.mjs";
+import { i as endRecordedSession } from "./device-remote-DAA0Zm6Z.mjs";
+import { r as stopTunnel, t as resolveSupervisorTarget } from "./ownership-DXcol4oU.mjs";
 import { existsSync, rmSync } from "node:fs";
 //#region src/reclaim.ts
 async function reapCollectors(root, { verify = verifyCollectorOwnership, collectors }) {

package/dist/{reload-DazHDSFA.mjs → reload-CWpXoOgN.mjs}

@@ -3,10 +3,10 @@ import { f as readWorkspaceLaunches } from "./state-B3XA2wp2.mjs";
 import { a as findProjectRoot } from "./project-fKmuIaMI.mjs";
 import { i as resolveProjectMetro } from "./metro-CORqXyTL.mjs";
 import { l as phaseLine } from "./command-output-8wHMEde0.mjs";
-import { N as resolveOwnedAvdSerial } from "./android-BqVIJoG7.mjs";
+import { N as resolveOwnedAvdSerial } from "./android-hMj83VpN.mjs";
 import { u as androidAppProcess, y as iosAppProcess } from "./app-install-DIp9riNx.mjs";
 import { x as resolveOwnedIosSim } from "./ios-Deh5js5V.mjs";
-import { n as nativeRunCommand } from "./slot-launch-cci0xvmC.mjs";
+import { n as nativeRunCommand } from "./slot-launch-CZklomj6.mjs";
 import chalk from "chalk";
 import { WebSocket } from "ws";
 //#region src/engine/reload.ts

package/dist/{slot-launch-cci0xvmC.mjs → slot-launch-CZklomj6.mjs}

@@ -1,7 +1,7 @@
 import { f as getProject } from "./config-CcefMY2Q.mjs";
 import { p as readWorkspaceState } from "./state-B3XA2wp2.mjs";
 import { h as deviceShellArg } from "./app-install-DIp9riNx.mjs";
-import { n as fileLeaseIo } from "./device-lease-BJYybF-2.mjs";
+import { n as fileLeaseIo } from "./device-lease-CJwK7OZr.mjs";
 //#region src/engine/slot-launch.ts
 function launchSlotScope(root, slot = "default") {
 	if (slot !== "default") return slot;

package/dist/{start-mObjQH2W.mjs → start-B5G4NjiA.mjs}

@@ -9,10 +9,10 @@ import { g as stepTimer, l as phaseLine } from "./command-output-8wHMEde0.mjs";
 import { A as resolveSettings, D as remoteDeviceSettingError, E as remoteAndroidSetting, F as tunnelModeSetting, I as unknownSettingKeys, L as PUBLIC_METRO_ENV, N as settingShapeErrors, O as remoteIosSetting, R as detectProviders, S as ngrokUrlSetting, T as publicUrlSetting, a as SETTING_SHAPE_REMEDY, b as metroTunnelSettingError, d as cacheProviderSettingError, k as resolveCacheProviderConfig, z as planMetroReach } from "./settings-DEJf6_kJ.mjs";
 import { n as expoMetroConfigPath } from "./metro-store-CDDZHtPl.mjs";
 import { o as expoSdkMajor } from "./server-expo-DizT4OMk.mjs";
-import { n as workspaceProcessLockError, t as withWorkspaceProcessLock } from "./workspace-process-lock-3NcQnZ0X.mjs";
+import { n as workspaceProcessLockError, t as withWorkspaceProcessLock } from "./workspace-process-lock-IBj1Towr.mjs";
 import { t as spawnEntry } from "./spawn-entry-nCE6m770.mjs";
-import { s as queryLogs } from "./logs-query-R-Cqc6Qv.mjs";
-import { a as withManagedRemoteWorktreeLock, i as terminateChild, n as startTunnelSequence, r as stopTunnel, s as withManagedTunnelLock, t as resolveSupervisorTarget } from "./ownership-BpCKiRlQ.mjs";
+import { c as queryLogs } from "./logs-query-Cdp5aaCH.mjs";
+import { a as withManagedRemoteWorktreeLock, i as terminateChild, n as startTunnelSequence, r as stopTunnel, s as withManagedTunnelLock, t as resolveSupervisorTarget } from "./ownership-DXcol4oU.mjs";
 import { mkdirSync, openSync, readFileSync } from "node:fs";
 import { randomUUID } from "node:crypto";
 import { dirname } from "node:path";