peachsim 0.1.527 → 0.1.571

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "peachsim",
-  "version": "0.1.527",
-  "description": "Vite and Metro plugins, testing drivers, and SDK exports for rnx.",
+  "version": "0.1.571",
+  "description": "Vite and Metro plugins, testing drivers, and SDK exports for peach.",
   "author": "Tamagui LLC",
   "license": "SEE LICENSE IN LICENSE",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/sootbean/soot.git",
-    "directory": "packages/sootsim"
+    "directory": "packages/peachsim"
   },
   "type": "module",
   "publishConfig": {
@@ -46,6 +46,20 @@
       "import": "./dist-lib/swift-submit.mjs",
       "default": "./dist-lib/swift-submit.cjs"
     },
+    "./swift-package": {
+      "types": "./src/swift-package.ts",
+      "source": "./src/swift-package.ts",
+      "bun": "./src/swift-package.ts",
+      "import": "./dist-lib/swift-package.mjs",
+      "default": "./dist-lib/swift-package.cjs"
+    },
+    "./swift-compile": {
+      "types": "./src/swift-compile.ts",
+      "source": "./src/swift-compile.ts",
+      "bun": "./src/swift-compile.ts",
+      "import": "./dist-lib/swift-compile.mjs",
+      "default": "./dist-lib/swift-compile.cjs"
+    },
     "./metro": {
       "source": "./src/metro-plugin.ts",
       "default": "./dist-lib/metro.cjs"
@@ -150,6 +164,13 @@
       "import": "./dist-lib/cloud-contract.mjs",
       "default": "./dist-lib/cloud-contract.cjs"
     },
+    "./cloud-test-args": {
+      "types": "./src/cloud-test-args.ts",
+      "source": "./src/cloud-test-args.ts",
+      "bun": "./src/cloud-test-args.ts",
+      "import": "./dist-lib/cloud-test-args.mjs",
+      "default": "./dist-lib/cloud-test-args.cjs"
+    },
     "./cloud": {
       "types": "./src/cloud.ts",
       "source": "./src/cloud.ts",
@@ -275,14 +296,14 @@
   },
   "devDependencies": {
     "@contrast/runtime-delivery": "workspace:*",
-    "@rnx/box": "workspace:*",
-    "@rnx/globals": "workspace:*",
-    "@rnx/skills": "workspace:*",
-    "@sootsim/compat": "workspace:*",
+    "@peach/box": "workspace:*",
+    "@peach/globals": "workspace:*",
+    "@peach/skills": "workspace:*",
+    "@peach/compat": "workspace:*",
     "@types/ws": "^8.5.13",
     "contrast-kit": "workspace:*",
-    "rnx-cloud-box": "workspace:*",
-    "sootsim-engine": "workspace:*",
+    "peach-cloud-box": "workspace:*",
+    "peach-engine": "workspace:*",
     "typescript": "7.0.2",
     "vite": "^8.2.2",
     "yaml": "^2.8.3"

package/scripts/dev-server-scanner.ts

@@ -35,7 +35,7 @@ import {
   readAppSettingsBundle,
 } from '../src/settings-bundle.ts'
 import { loadOptionalDemoApps, optionalDemoAppsSync } from './optional-demo-registry.ts'
-import type { AppSettingsSpecifier } from '@rnx/globals'
+import type { AppSettingsSpecifier } from '@peach/globals'
 
 // how long past a command's own budget we wait before deciding its exit event is
 // never coming. generous, because this only fires when the child is already
@@ -629,7 +629,7 @@ async function resolveLocalIconPath(
       localIconPathCache.set(port, candidate)
       // the identified result caches as a strong entry and won't re-probe on
       // its own; drop it so the next scan republishes with the working url.
-      portCache.delete(port)
+      invalidatePortCache(port)
       return
     }
   }
@@ -828,7 +828,7 @@ async function fetchManifestEnrichment(
   })
   // the nameless result cached as a strong entry and won't re-probe on its own;
   // drop it so the next scan re-runs probePort and publishes the enriched name.
-  portCache.delete(result.port)
+  invalidatePortCache(result.port)
 }
 
 // ports confirmed to be running a non-sootsim dev server — safe to skip the
@@ -959,16 +959,22 @@ export async function probePort(
     )
       ? 'one'
       : 'expo'
-    return applyManifest(
-      {
-        port,
-        framework,
-        bundleUrl: withRuntimeConfig(port, launchUrl, owner.cwd),
-        hmrUrl: `${buildLoopbackProbeBaseUrl('ws:', probeHostname, port)}/hot`,
-        lastSeen: Date.now(),
-        ...owner,
-      },
-      manifestRes,
+    // enrichWithManifest kicks the local-icon shape probe; without it the
+    // optimistic metro icon URL publishes forever and the confirmed shape
+    // never lands. every other identified return wraps it too.
+    return enrichWithManifest(
+      applyManifest(
+        {
+          port,
+          framework,
+          bundleUrl: withRuntimeConfig(port, launchUrl, owner.cwd),
+          hmrUrl: `${buildLoopbackProbeBaseUrl('ws:', probeHostname, port)}/hot`,
+          lastSeen: Date.now(),
+          ...owner,
+        },
+        manifestRes,
+        buildIconProxyUrl,
+      ),
       buildIconProxyUrl,
     )
   }
@@ -1123,6 +1129,17 @@ interface PortCacheEntry {
 }
 const portCache = new Map<number, PortCacheEntry>()
 
+// out-of-band completions (the icon-shape probe, manifest enrichment) land
+// while a scan's own probeAll is still in flight, and the scan's cache write
+// would resurrect the entry they just dropped. stamp every such invalidation
+// so a scan only caches ports whose verdicts are newer than its own start.
+const portCacheInvalidatedAt = new Map<number, number>()
+
+function invalidatePortCache(port: number): void {
+  portCache.delete(port)
+  portCacheInvalidatedAt.set(port, Date.now())
+}
+
 // negative-cache holds a node/bun port that isn't a bundler (e.g. Contrast's own
 // api server, Zero, SQLite sync host, a dev tool). at scan interval 3s and a 1.5s ttl
 // we used to re-probe every scan, which hits `/` on the port every 3s — that
@@ -1166,6 +1183,7 @@ export function __resetScannerCache() {
   knownOne.clear()
   enrichmentCache.clear()
   enrichmentInFlight.clear()
+  portCacheInvalidatedAt.clear()
   __resetAppSettingsBundleCacheForTests()
 }
 
@@ -1223,6 +1241,9 @@ export async function scanDevServers(
   for (const p of [...localIconPathCache.keys()]) {
     if (!currentPorts.has(p)) localIconPathCache.delete(p)
   }
+  for (const p of [...portCacheInvalidatedAt.keys()]) {
+    if (!currentPorts.has(p)) portCacheInvalidatedAt.delete(p)
+  }
 
   const results: DiscoveredServer[] = []
   const toProbe: ListeningProcess[] = []
@@ -1251,6 +1272,7 @@ export async function scanDevServers(
   }
 
   if (toProbe.length > 0) {
+    const scanStartedAt = Date.now()
     const probed = await Promise.all(
       toProbe.map((p) => probePort(p.port, opts.buildIconProxyUrl, p)),
     )
@@ -1258,7 +1280,12 @@ export async function scanDevServers(
       const { port, pid } = toProbe[i]
       // only cache when we have a real pid to key the entry against.
       // fallback-list ports (pid 0) always reprobe so we catch state changes.
-      if (pid !== 0) portCache.set(port, { pid, result, cachedAt: Date.now() })
+      // skip ports an out-of-band completion invalidated mid-scan, so the
+      // next scan re-probes instead of re-caching this scan's stale verdict.
+      const invalidatedAt = portCacheInvalidatedAt.get(port) ?? 0
+      if (pid !== 0 && invalidatedAt < scanStartedAt) {
+        portCache.set(port, { pid, result, cachedAt: Date.now() })
+      }
       if (result) results.push(result)
     })
   }

package/scripts/optional-demo-registry.ts

@@ -20,8 +20,8 @@ import { basename, dirname, join } from 'node:path'
 import { fileURLToPath, pathToFileURL } from 'node:url'
 
 // this module is emitted at three different depths — the source at
-// packages/sootsim/scripts/, the built CLI at packages/sootsim/dist-cli/chunks/,
-// and the electron main bundle at packages/sootsim-engine/dist-electron/ — so a
+// packages/peachsim/scripts/, the built CLI at packages/peachsim/dist-cli/chunks/,
+// and the electron main bundle at packages/peach-engine/dist-electron/ — so a
 // relative './demo-app-registry.ts' is only correct from the source copy. from
 // the other two it points at a file that does not exist, the catch below
 // swallows that, and every demo app then boots with no runtimeConfig at all
@@ -29,7 +29,7 @@ import { fileURLToPath, pathToFileURL } from 'node:url'
 // never reaches it). the one description that holds from every emit site is the
 // ancestor that holds the registry at its repo path, which in-repo is the
 // monorepo root.
-const REGISTRY_REPO_PATH = 'packages/sootsim/scripts/demo-app-registry.ts'
+const REGISTRY_REPO_PATH = 'packages/peachsim/scripts/demo-app-registry.ts'
 
 // the walk must never leave the installed package. `sootsim` publishes this
 // loader's source, so on a published install it runs from

package/skills/contrast/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: contrast
 description: >-
-  index of all Contrast and rnx agent skills and CLI commands.
+  index of all Contrast and Peach agent skills and CLI commands.
   auto-generated from the CLI info registry — do not edit by hand.
 ---
 
@@ -12,7 +12,7 @@ overview of all available skills and CLI commands in this repo.
 > this file is auto-generated by `bun scripts/generate-contrast-skill.ts`.
 > to update, edit the source registries and re-run the generator.
 
-## rnx CLI commands
+## Peach CLI commands
 
 the `rnx` CLI is the operational surface for booting shells, driving
 automation, inspecting the render tree, and managing sims.
@@ -87,17 +87,17 @@ run `rnx --help` to see the full list under each group.
 - `-t, --theme <scheme>` — override light, dark, or auto color scheme
 - `--headless` — run browser automation without a visible window where supported
 
-## bundled rnx agent skills
+## bundled Peach agent skills
 
-skills for working with the rnx native preview engine:
+skills for working with the Peach native preview engine:
 
 | skill | description |
 | --- | --- |
-| `/rnx-debug` | Debug rendering, animation, gesture, performance, and accessibility issues in a React Native app running under rnx. Reach for this whenever an animation looks wrong (janky, stutters, snaps, only updates once, or doesn't move at all), a swipe/transition/gesture misbehaves or feels broken, scrolling drops frames or feels slow, the UI renders the wrong tree/props, or a screen reader can't reach something — and drive the rnx CLI debug tooling first, not screenshots or ad-hoc logging. |
-| `/rnx-perf` | Optimize rnx engine and app performance — scroll jank, dropped frames, slow animation, idle CPU, memory growth, and "smooth normally but laggy under load" (video calls, busy machines). Covers measuring on the right thread with the right browser, proving each perf tier actually engages via its counters, a CPU-contention test harness, and the map of existing perf machinery so you improve it instead of reinventing it. For general app debugging load /rnx-debug first. |
-| `/rnx-setup` | Get rnx connected to your React Native app with no project setup |
-| `/rnx-test` | Run automated tests against your React Native app under rnx with Maestro YAML or Detox/Jest |
-| `/rnx-visual` | Pixel-level rendering comparison between rnx and native iOS — fonts, gradients, shadows, image fidelity |
+| `/rnx-debug` | Debug rendering, animation, gesture, performance, and accessibility issues in a React Native app running under Peach. Reach for this whenever an animation looks wrong (janky, stutters, snaps, only updates once, or doesn't move at all), a swipe/transition/gesture misbehaves or feels broken, scrolling drops frames or feels slow, the UI renders the wrong tree/props, or a screen reader can't reach something — and drive the rnx CLI debug tooling first, not screenshots or ad-hoc logging. |
+| `/rnx-perf` | Optimize Peach engine and app performance — scroll jank, dropped frames, slow animation, idle CPU, memory growth, and "smooth normally but laggy under load" (video calls, busy machines). Covers measuring on the right thread with the right browser, proving each perf tier actually engages via its counters, a CPU-contention test harness, and the map of existing perf machinery so you improve it instead of reinventing it. For general app debugging load /rnx-debug first. |
+| `/rnx-setup` | Get Peach connected to your React Native app with no project setup |
+| `/rnx-test` | Run automated tests against your React Native app under Peach with Maestro YAML or Detox/Jest |
+| `/rnx-visual` | Pixel-level rendering comparison between Peach and native iOS — fonts, gradients, shadows, image fidelity |
 
 ## automatic settling
 

package/skills/rnx-debug/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: rnx-debug
-description: Debug rendering, animation, gesture, performance, and accessibility issues in a React Native app running under rnx. Reach for this whenever an animation looks wrong (janky, stutters, snaps, only updates once, or doesn't move at all), a swipe/transition/gesture misbehaves or feels broken, scrolling drops frames or feels slow, the UI renders the wrong tree/props, or a screen reader can't reach something — and drive the rnx CLI debug tooling first, not screenshots or ad-hoc logging.
+description: Debug rendering, animation, gesture, performance, and accessibility issues in a React Native app running under Peach. Reach for this whenever an animation looks wrong (janky, stutters, snaps, only updates once, or doesn't move at all), a swipe/transition/gesture misbehaves or feels broken, scrolling drops frames or feels slow, the UI renders the wrong tree/props, or a screen reader can't reach something — and drive the rnx CLI debug tooling first, not screenshots or ad-hoc logging.
 ---
 
-# rnx debug
+# Peach debug
 
-the foundational skill for "something is wrong with my app in rnx".
+the foundational skill for "something is wrong with my app in Peach".
 covers debugging, performance, and accessibility — three branches that
 share the same CLI primitives, the same auto-settling contract, and the
 same diff/snapshot workflow. start here for any rendering, interaction,
@@ -49,7 +49,7 @@ regression test. a pile of ad-hoc logs helps no one and gets deleted.
 
 ## anti-patterns (apply to every branch)
 
-- **`a1`/`a2`/`b0` style ids mean rnx sims, never browser tabs.** when a user
+- **`a1`/`a2`/`b0` style ids mean Peach sims, never browser tabs.** when a user
   says "look at a3", that's the `rnx list` sim id. do not open chrome
   MCP unless the user explicitly says "use chrome" — the canvas has no
   DOM to inspect anyway.
@@ -76,6 +76,16 @@ regression test. a pile of ad-hoc logs helps no one and gets deleted.
   them*. a "fixed" behavior with a new console error is not fixed.
 - **"found a testID" is not done.** done is: reliable repro + identified
   root cause (specific node + prop, or event + handler) + verified fix.
+- **an empty `find --pressable` is not proof there is no affordance.** it
+  lists registered touch responders, and a tamagui `styled()` view whose
+  `onPress` comes from the call site is tappable without ever appearing there.
+  before concluding a screen has no way out, corroborate with `get a11y` or an
+  actual `do tap-text`.
+- **after an unexplained restart, re-establish which sim you are on.** a sim
+  that reconnected, or a dev stack that came back on a port another process now
+  holds, is a fresh instrument; a port answering 200 says something is
+  listening, not that it is yours. every Peach command prints its own `→ <sim>`
+  line, so reading that line is the check.
 
 ## the timeline ("what happened")
 

package/skills/rnx-perf/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: rnx-perf
-description: Optimize rnx engine and app performance — scroll jank, dropped frames, slow animation, idle CPU, memory growth, and "smooth normally but laggy under load" (video calls, busy machines). Covers measuring on the right thread with the right browser, proving each perf tier actually engages via its counters, a CPU-contention test harness, and the map of existing perf machinery so you improve it instead of reinventing it. For general app debugging load /rnx-debug first.
+description: Optimize Peach engine and app performance — scroll jank, dropped frames, slow animation, idle CPU, memory growth, and "smooth normally but laggy under load" (video calls, busy machines). Covers measuring on the right thread with the right browser, proving each perf tier actually engages via its counters, a CPU-contention test harness, and the map of existing perf machinery so you improve it instead of reinventing it. For general app debugging load /rnx-debug first.
 ---
 
-# rnx performance
+# Peach performance
 
-optimize performance in rnx: the shell frame pipeline, the compositor
+optimize performance in Peach: the shell frame pipeline, the compositor
 tiers, and the guest app. this skill exists because every real perf win in
 this engine followed the same loop — measure on the right thread, read the
 counters that prove machinery engaged, fix the one thing the counters
@@ -384,7 +384,7 @@ tier fire on feeds came entirely from rejection counters.
 - `Animated.Value` on `width`/`height` forces layout per frame — use
   `transform` (scale/translate).
 - per-frame React work from reanimated-style code is an engine conformance
-  bug (valid worklet apps must not commit per frame) — fix rnx core,
+  bug (valid worklet apps must not commit per frame) — fix Peach core,
   never add a divergent fast-path (upstream alignment overrides perf; see
   the `shouldFreezeOffscreenStackContent` incident).
 - render-storm loops (poll → remount) show up as commit-rate repaints and
@@ -396,4 +396,4 @@ done means: a named hot path + the counter or split that indicts it + the
 same capture re-run showing the number moved + no new errors (`get errors`)
 + nothing torn down left running (close sims you opened, kill load loops).
 for engine changes, run the affected integration tests exposed by the installed
-rnx version and capture stable screenshots of surfaces you touched.
+Peach version and capture stable screenshots of surfaces you touched.

package/skills/rnx-setup/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: rnx-setup
-description: Get rnx connected to your React Native app with no project setup
+description: Get Peach connected to your React Native app with no project setup
 ---
 
-# rnx setup
+# Peach setup
 
-you want to drive a React Native app with rnx from the CLI. this skill
+you want to drive a React Native app with Peach from the CLI. this skill
 takes you from a running development server to a connected, pinned sim that
-every other rnx skill assumes exists. rnx requires no project setup or per-app
+every other Peach skill assumes exists. Peach requires no project setup or per-app
 install. if
 `rnx describe` already
 returns a tree, you're past this skill — load `/rnx-debug` for
@@ -21,7 +21,7 @@ debugging or `/rnx-test` for writing tests.
 - **don't switch sims mid-investigation.** pin once with `rnx use
   <id>` and keep it pinned. an unpinned command refuses to choose when more
   than one driveable sim is live.
-- **an empty `rnx list` is not "broken rnx".** it usually means the
+- **an empty `rnx list` is not "broken Peach".** it usually means the
   daemon is down, the dev server port is wrong, or the runtime is missing.
   walk the recovery checklist before reinstalling.
 - **keep one sim for your whole session.** the first `rnx open <port>`
@@ -53,7 +53,7 @@ debugging or `/rnx-test` for writing tests.
 - **never retry-loop `rnx open` against a wedged or slow stack.** a
   connect timeout means diagnose the stack. do not retry. if the first launch
   never connects, each retry can create another browser tree before there is a
-  saved sim to reuse. verify the development server and rnx runtime, then
+  saved sim to reuse. verify the development server and Peach runtime, then
   retry once after fixing the cause.
 
 ## first move
@@ -69,7 +69,7 @@ rnx describe                 # smoke test — should print a render tree
 ```
 
 the background service keeps the local bridge and runtime ready between
-commands. without it, rnx still works by starting an on-demand bridge, but
+commands. without it, Peach still works by starting an on-demand bridge, but
 inspect, interaction, and test commands pay repeated startup cost. if the user
 declined it during onboarding, `rnx daemon install` is the direct way to enable
 it. CI does not need or install the service.
@@ -100,8 +100,8 @@ rnx open https://my-app.local  # load a hosted bundle
 ## compatibility feedback requires approval
 
 run `rnx compat --json` from the app project root during setup. if the scan
-identifies a plausible missing rnx seam, or the running app gives concrete
-evidence that behavior is missing or broken specifically in rnx, summarize
+identifies a plausible missing Peach seam, or the running app gives concrete
+evidence that behavior is missing or broken specifically in Peach, summarize
 the package, expected behavior, actual behavior, and runtime evidence for the
 user. then offer to send that finding with `rnx report-issue`.
 
@@ -133,7 +133,7 @@ if the daemon is not installed: run `rnx daemon install`. if the registered
 daemon is down, run `rnx daemon restart`, or `rnx serve` in another shell for
 a foreground bridge. if no runtime is installed, `rnx open` installs it
 before launching. if open errors with "port unreachable": confirm your dev
-server is actually serving — the bundler has to be up before rnx can
+server is actually serving — the bundler has to be up before Peach can
 attach.
 
 **two sims appear unexpectedly.** an earlier `rnx claim` didn't
@@ -151,7 +151,7 @@ Run `rnx runtime install`, then retry `rnx open <port>`.
 do not retry in a loop. verify the development server first: `__soot/` must
 respond and the engine watchers must be running. inspect the driver diagnostic
 path printed by the failed command. restart the broken development stack at its
-supervisor, then retry once. rnx owns the isolated browser profile and its
+supervisor, then retry once. Peach owns the isolated browser profile and its
 process tree; do not open the shell URL through an operating-system browser.
 
 **bridge disconnects mid-sim.** the WebSocket dropped (laptop slept,

package/skills/rnx-test/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: rnx-test
-description: Run automated tests against your React Native app under rnx with Maestro YAML or Detox/Jest
+description: Run automated tests against your React Native app under Peach with Maestro YAML or Detox/Jest
 ---
 
-# rnx tests
+# Peach tests
 
-rnx has two test runners. Maestro owns every YAML test, whether it was
+Peach has two test runners. Maestro owns every YAML test, whether it was
 hand-authored, generated from a goal, or recorded from live CLI actions.
-Detox runs existing imperative Jest suites through the rnx driver.
+Detox runs existing imperative Jest suites through the Peach driver.
 
 > needs a connected, pinned sim. if `rnx describe` errors, load
 > `/rnx-setup` first.
@@ -165,7 +165,7 @@ rnx maestro test .maestro/login.yaml
 ```
 
 no test rewrites, no detox config, no simulator. the runtime auto-launches
-an rnx shell if one isn't running.
+a Peach shell if one isn't running.
 
 ```sh
 rnx maestro                           # auto-discover .maestro/ or maestro/
@@ -190,10 +190,10 @@ interpolation.
 
 ### partial
 
-- `clearKeychain` — no keychain in rnx; logs a warning and continues.
+- `clearKeychain` — no keychain in Peach; logs a warning and continues.
   if a test depends on keychain state being reset, add an explicit
   in-app "sign out" step instead.
-- `when.platform` — rnx emulates iOS; android branches are skipped.
+- `when.platform` — Peach emulates iOS; android branches are skipped.
 - `openLink`: app routing works; there is no OS-level browser fallback.
 
 `stopApp` keeps the guest runtime stopped. The next `launchApp` starts a fresh
@@ -216,7 +216,7 @@ these throw `unsupported maestro verb: X`:
 - **"missing environment variable for flow placeholder: FOO"** — pass
   `--env FOO=bar` or export it. pick one mechanism per repo and document
   it in the flow directory's README.
-- **flow can't find an element** — rnx's matcher uses testID + visible
+- **flow can't find an element** — Peach's matcher uses testID + visible
   text. UIKit-only labels that real maestro scrapes from the host OS won't
   resolve here; switch to testID.
 - **flow runs but nothing renders** — confirm the bundler your flow
@@ -225,7 +225,7 @@ these throw `unsupported maestro verb: X`:
 
 ## branch — detox drop-in
 
-an existing detox suite runs against rnx with **one line** of jest
+an existing detox suite runs against Peach with **one line** of jest
 config and zero test changes.
 
 `import { by, device, element, expect, waitFor } from 'detox'` is
@@ -238,7 +238,7 @@ upstream detox surface.
 ```js
 // rnx-detox.config.cjs
 module.exports = {
-  preset: 'rnxsim/detox',
+  preset: 'peachsim/detox',
   rootDir: __dirname,
   testMatch: ['<rootDir>/e2e/**/*.test.ts'],
 }
@@ -248,7 +248,7 @@ or, if you already have a jest config, pull in just the module mapper:
 
 ```js
 moduleNameMapper: {
-  '^detox$': require.resolve('rnxsim/detox'),
+  '^detox$': require.resolve('peachsim/detox'),
 }
 ```
 
@@ -271,7 +271,7 @@ rnx detox init                        # scaffold config + e2e/example.test.ts
 
 ### compat surface
 
-| detox API                          | rnx |
+| detox API                          | Peach |
 | ---------------------------------- | ------- |
 | `element(by.id(...))`              | supported |
 | `element(by.text(...))`            | supported — but prefer `by.id` |
@@ -291,10 +291,10 @@ rnx detox init                        # scaffold config + e2e/example.test.ts
 
 ### troubleshooting
 
-- **"no rnx shell reachable"** — start one yourself
+- **"no Peach shell reachable"** — start one yourself
   (`rnx open <port>`) or pass `--port <n>`.
 - **"jest cannot find module 'detox'"** — the preset isn't wired. confirm
-  `preset: 'rnxsim/detox'` is in the jest config jest
+  `preset: 'peachsim/detox'` is in the jest config jest
   actually loaded (`--config` overrides package.json).
 - **matchers fail on elements that exist** — canvas has no DOM. use
   `by.id` (testID); `rnx describe` shows what the shell sees.

package/skills/rnx-visual/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: rnx-visual
-description: Pixel-level rendering comparison between rnx and native iOS — fonts, gradients, shadows, image fidelity
+description: Pixel-level rendering comparison between Peach and native iOS — fonts, gradients, shadows, image fidelity
 ---
 
-# rnx visual fidelity
+# Peach visual fidelity
 
-pixel-level rendering fidelity: does the rnx canvas match native iOS
+pixel-level rendering fidelity: does the Peach canvas match native iOS
 for text, gradients, shadows, blur, and image rendering? the `rnx`
 CLI gives you two primitives — **canvas capture** (`rnx screenshot`)
 and **structural diff** (`rnx debug snapshot`/`diff`). pixel
@@ -23,7 +23,7 @@ the capture step is the hard part and it's fully reproducible.
   diff` is faster, deterministic, and tells you *why*.
 - visual change (color, gradient, shadow, font metric, blur, image)? →
   continue here.
-- comparing rnx to your iOS simulator for fidelity? → continue.
+- comparing Peach to your iOS simulator for fidelity? → continue.
 - regressing your own app against itself across commits? → continue.
 
 ## anti-patterns (read first)
@@ -64,7 +64,7 @@ screen you want to inspect and capture it with a distinct output filename.
 
 capture both sides to PNGs, then diff with any standard image tool.
 
-**rnx vs rnx (regression across your own commits):**
+**Peach vs Peach (regression across your own commits):**
 
 ```sh
 rnx screenshot -o before.png                      # baseline, before your change
@@ -74,7 +74,7 @@ npx pixelmatch before.png after.png diff.png 0.1      # writes diff.png
 # or: magick compare before.png after.png diff.png
 ```
 
-**rnx vs native iOS (fidelity to the real thing):**
+**Peach vs native iOS (fidelity to the real thing):**
 
 ```sh
 # native side: lifecycle and UI use xcodebuildmcp with one claimed simulator

package/src/agent-sessions.ts

@@ -163,7 +163,7 @@ function tryWorkspaceSootsim(): RnxSelfInvocation | null {
 
 /** locate the workspace sootsim package directory. tries `require.resolve`
  *  first (works in most contexts), then walks up from this module file
- *  looking for `packages/sootsim/package.json` (works when sootsim is
+ *  looking for `packages/peachsim/package.json` (works when sootsim is
  *  loaded via vite's native TS resolution, where require.resolve doesn't
  *  know about the workspace). */
 function resolveSootsimPackageDir(): string | null {
@@ -172,8 +172,8 @@ function resolveSootsimPackageDir(): string | null {
     const resolved = require.resolve(`${rnxPublicBrand.packageName}/package.json`)
     return path.dirname(resolved)
   } catch {}
-  // walk up from this file: .../packages/sootsim/src/agent-sessions.ts
-  // → .../packages/sootsim/. the module path is whatever the runtime
+  // walk up from this file: .../packages/peachsim/src/agent-sessions.ts
+  // → .../packages/peachsim/. the module path is whatever the runtime
   // gave us; when bundled by esbuild this will be the bundle path, not
   // the source path, which is why we try require.resolve first.
   const here = fileFromImportMeta()

package/src/attached-projects.ts

@@ -501,7 +501,7 @@ export function deletePreviewAttachment(id: string): void {
 
 // --- seed from demo registry ---
 
-/** seed the store from packages/sootsim/scripts/demo-app-registry. only runs
+/** seed the store from packages/peachsim/scripts/demo-app-registry. only runs
  *  when the store is completely empty (never re-seeds) and only adds apps
  *  whose `dir` exists on disk (concern 6.4 — demo dirs vary per machine). */
 export async function seedFromDemoAppRegistry(): Promise<void> {

package/src/bridge-contract-input.ts

@@ -12,7 +12,7 @@ import type {
   SimStateOptions,
 } from './bridge-contract'
 import type { SimPerformStep, SimScreenshotOptions } from './sim-client'
-import type { SootSimReplayTarget } from '@rnx/globals'
+import type { SootSimReplayTarget } from '@peach/globals'
 
 /** the caller sent a value this bridge argument cannot be read from. */
 export class BridgeInputError extends Error {

package/src/bridge-contract.ts

@@ -1,11 +1,11 @@
 // the wire contract for the sootsim ws bridge. the engine implements it in
-// sootsim-engine/src/mcp/ws-bridge.ts; the rnxsim cli client, the SimClient
+// sootsim-engine/src/mcp/ws-bridge.ts; the peachsim cli client, the SimClient
 // sdk, and the flow runner speak it. it is the single owner of these shapes,
 // and neither side redeclares them.
 //
-// it lives in rnxsim rather than the engine because rnxsim is published and
-// sootsim-engine is `private: true`. the engine already depends on rnxsim
-// (see its `rnxsim` dependency and its `rnxsim/bridge-constants` import), so
+// it lives in peachsim rather than the engine because peachsim is published and
+// sootsim-engine is `private: true`. the engine already depends on peachsim
+// (see its `peachsim` dependency and its `peachsim/bridge-constants` import), so
 // this is the direction that ships.
 
 import type {
@@ -13,7 +13,7 @@ import type {
   SootSimCaptureFilter,
   SootSimExternalAppLifecycleOptions,
   SootSimStorageResetStrategy,
-} from '@rnx/globals'
+} from '@peach/globals'
 
 export type BridgeCommandType =
   | 'evaluate'
@@ -42,11 +42,29 @@ export type BridgeCommandType =
   | 'diagnostics'
   | 'storageSnapshot'
 
+// the bridge host answers these itself, before the engine's handleCommand ever
+// sees them. they are not engine commands and the cloud plane does not route
+// them, so they stay out of BridgeCommandType and out of its cloud scope table.
+export type BridgeHostCommandType = 'bridge:list-sims' | 'bridge:claim'
+
+// what a caller hands a bridge's `send`: the command minus the correlation id,
+// which the transport assigns. every send seam names this type rather than an
+// index-signature bag, because an index signature erases excess-property
+// checking and a field spelled wrong then compiles and arrives as `undefined`.
+export type WsBridgeCommand = Omit<WsCommand, 'id' | 'type'> & {
+  type: BridgeCommandType | BridgeHostCommandType
+}
+
 export interface WsCommand {
   id: string | number
   type: BridgeCommandType
   // local daemon routing; cloud transport strips it before execution.
   simId?: string
+  // take or refresh the cli lease on the target sim before running. reads omit
+  // it; anything that mutates user-facing state sets it. read in bridge-host.
+  acquireLock?: boolean
+  // bridge:claim — take the lease even when another cli holds it.
+  force?: boolean
   // flowStatus — live flow-runner progress payload (see flow-run-store)
   status?: Record<string, unknown>
   code?: string