rnxsim 0.1.335 → 0.1.337

package/skills/rnx-test/SKILL.md

@@ -9,7 +9,7 @@ rnx 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.
 
-> needs a connected, pinned sim. if `rnxsim describe` errors, load
+> needs a connected, pinned sim. if `rnx describe` errors, load
 > `/rnx-setup` first.
 
 ## route in (decision tree)
@@ -32,7 +32,7 @@ Do not invent a third runner for how a Maestro flow was authored.
   implementation and author flows against it.
 - **pin a sim before running a suite.** parallel CI jobs colliding
   on the default bridge port is the #1 flake source. pass `--port` in
-  CI and `rnxsim use <id>` locally.
+  CI and `rnx use <id>` locally.
 - **every flow ends with an assert, not a screenshot.** a screenshot
   passes as long as the flow didn't throw. `assertVisible` (or
   `expect(...).toBeVisible()`) actually verifies the happy path.
@@ -54,23 +54,23 @@ Write declarative Maestro YAML. The same command runs existing suites,
 generates tests, records live drafts, profiles, and uploads replayable results.
 
 ```sh
-rnxsim maestro test .maestro/login.yaml             # run one flow
-rnxsim maestro test .maestro/login.yaml --record    # record video
-rnxsim maestro test .maestro/login.yaml --profile   # include perf stats
-rnxsim maestro test .maestro/                       # run the suite
+rnx maestro test .maestro/login.yaml             # run one flow
+rnx maestro test .maestro/login.yaml --record    # record video
+rnx maestro test .maestro/login.yaml --profile   # include perf stats
+rnx maestro test .maestro/                       # run the suite
 ```
 
 Author from a live interaction:
 
 ```sh
-rnxsim maestro start                     # begin a draft
-rnxsim do tap-id loginButton             # drive the app via the CLI
-rnxsim maestro keep                      # save the step
-rnxsim do type "user@example.com"
-rnxsim maestro keep
-rnxsim do tap-id submit
-rnxsim maestro keep
-rnxsim maestro end --output .maestro/login.yaml --validate
+rnx maestro start                     # begin a draft
+rnx do tap-id loginButton             # drive the app via the CLI
+rnx maestro keep                      # save the step
+rnx do type "user@example.com"
+rnx maestro keep
+rnx do tap-id submit
+rnx maestro keep
+rnx maestro end --output .maestro/login.yaml --validate
 ```
 
 the recorder emits minimal YAML — no coordinate dumps, no `sleep` noise —
@@ -104,7 +104,7 @@ exemplar flow:
 run with env interpolation:
 
 ```sh
-rnxsim maestro --env USERNAME=alice --env PASSWORD=hunter2 \
+rnx maestro --env USERNAME=alice --env PASSWORD=hunter2 \
   test .maestro/login.yaml \
   --record --profile
 ```
@@ -119,7 +119,7 @@ CLI's `wait idle` with a generous budget. use it before any
 Generate and immediately run a Maestro flow from a plain-language goal:
 
 ```sh
-rnxsim maestro generate "log in with the demo account and verify the dashboard"
+rnx maestro generate "log in with the demo account and verify the dashboard"
 ```
 
 Generation writes the same deterministic Maestro artifact, uploads its replay,
@@ -136,19 +136,19 @@ command change:
 maestro test .maestro/login.yaml
 
 # after
-rnxsim maestro test .maestro/login.yaml
+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.
 
 ```sh
-rnxsim maestro                           # auto-discover .maestro/ or maestro/
-rnxsim maestro test .maestro/login.yaml
-rnxsim maestro test .maestro/            # every flow in a directory
-rnxsim maestro init                      # scaffold a starter flow
-rnxsim maestro --list-compat             # supported / partial / unsupported
-rnxsim maestro --env USERNAME=alice test .maestro/login.yaml
+rnx maestro                           # auto-discover .maestro/ or maestro/
+rnx maestro test .maestro/login.yaml
+rnx maestro test .maestro/            # every flow in a directory
+rnx maestro init                      # scaffold a starter flow
+rnx maestro --list-compat             # supported / partial / unsupported
+rnx maestro --env USERNAME=alice test .maestro/login.yaml
 ```
 
 ### supported verbs
@@ -182,7 +182,7 @@ these throw `unsupported maestro verb: X`:
 ### troubleshooting
 
 - **"no maestro flows found"** — pass an explicit path
-  (`rnxsim maestro test path/to/flow.yaml`) or run `rnxsim maestro
+  (`rnx maestro test path/to/flow.yaml`) or run `rnx maestro
   init` to scaffold one.
 - **"missing environment variable for flow placeholder: FOO"** — pass
   `--env FOO=bar` or export it. pick one mechanism per repo and document
@@ -230,14 +230,14 @@ works until your first hung shell.
 ### commands
 
 ```sh
-rnxsim detox                             # run e2e/, test/e2e/, or detox/
-rnxsim detox --config my.cjs             # use a specific jest config
-rnxsim detox --watch                     # jest watch mode
-rnxsim detox -t "login"                  # --testNamePattern
-rnxsim detox --headed                    # keep the shell window visible
-rnxsim detox --no-launch                 # don't auto-launch a shell
-rnxsim detox --port 5173                 # explicit bridge port for CI
-rnxsim detox init                        # scaffold config + e2e/example.test.ts
+rnx detox                             # run e2e/, test/e2e/, or detox/
+rnx detox --config my.cjs             # use a specific jest config
+rnx detox --watch                     # jest watch mode
+rnx detox -t "login"                  # --testNamePattern
+rnx detox --headed                    # keep the shell window visible
+rnx detox --no-launch                 # don't auto-launch a shell
+rnx detox --port 5173                 # explicit bridge port for CI
+rnx detox init                        # scaffold config + e2e/example.test.ts
 ```
 
 ### compat surface
@@ -263,12 +263,12 @@ rnxsim detox init                        # scaffold config + e2e/example.test.ts
 ### troubleshooting
 
 - **"no rnx shell reachable"** — start one yourself
-  (`rnxsim open <port>`) or pass `--port <n>`.
+  (`rnx open <port>`) or pass `--port <n>`.
 - **"jest cannot find module 'detox'"** — the preset isn't wired. confirm
   `preset: 'rnxsim/detox/jest-preset'` 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); `rnxsim describe` shows what the shell sees.
+  `by.id` (testID); `rnx describe` shows what the shell sees.
 - **passes locally, flakes in CI** — the shell boots asynchronously.
   bump jest `testTimeout` to 10–15 s and add a `waitFor(element(...))
   .toBeVisible().withTimeout(10000)` before the first assertion.
@@ -287,6 +287,6 @@ rnxsim detox init                        # scaffold config + e2e/example.test.ts
   failing Maestro runs land a recording next to the output.
 - **a flake reproduces but resists fixing** — don't paper over with
   `sleep`. open `/rnx-debug` against the same sim, capture
-  the timeline (`rnxsim timeline start` → reproduce → `rnxsim
+  the timeline (`rnx timeline start` → reproduce → `rnx
   what-happened`), and look for the missing animation-completion or
   the unresolved fetch that's racing the assertion.

package/skills/rnx-visual/SKILL.md

@@ -7,13 +7,13 @@ description: Pixel-level rendering comparison between rnx and native iOS — fon
 
 pixel-level rendering fidelity: does the rnx canvas match native iOS
 for text, gradients, shadows, blur, and image rendering? the `rnx`
-CLI gives you two primitives — **canvas capture** (`rnxsim screenshot`)
-and **structural diff** (`rnxsim debug snapshot`/`diff`). pixel
+CLI gives you two primitives — **canvas capture** (`rnx screenshot`)
+and **structural diff** (`rnx debug snapshot`/`diff`). pixel
 comparison itself is "capture both sides, diff the PNGs with a standard
 image tool" — there is no single oracle-diff command, and that's fine:
 the capture step is the hard part and it's fully reproducible.
 
-> needs a connected, pinned sim. if `rnxsim describe` errors,
+> needs a connected, pinned sim. if `rnx describe` errors,
 > load `/rnx-setup` first.
 
 ## route in
@@ -28,12 +28,12 @@ the capture step is the hard part and it's fully reproducible.
 
 ## anti-patterns (read first)
 
-- **run structural diff before pixel work.** `rnxsim debug snapshot` /
+- **run structural diff before pixel work.** `rnx debug snapshot` /
   `debug diff` (in `/rnx-debug`) is cheaper, deterministic, and
   points at the responsible nodes. only when it's empty (or the change is
   pure rendering) does a pixel comparison add information.
 - **don't single-screenshot animated surfaces.** a gradient
-  mid-animation never matches. gate the capture behind `rnxsim wait
+  mid-animation never matches. gate the capture behind `rnx wait
   idle` first.
 - **a > 5% pixel threshold hides regressions.** ~1% is the right
   ballpark for catching real font / shadow / gradient drift without
@@ -44,18 +44,18 @@ the capture step is the hard part and it's fully reproducible.
 - **commit baselines alongside the code change that produced them.**
   baseline churn without code churn means someone captured noise.
 
-## capturing — `rnxsim screenshot`
+## capturing — `rnx screenshot`
 
 fast, no extra setup, works on any loaded app:
 
 ```sh
-rnxsim screenshot --output app.png            # full canvas
-rnxsim screenshot --area 0,200,393,400        # crop to a logical rect
-rnxsim screenshot --id loginButton -o btn.png # crop to a node by testID
-rnxsim screenshot --text "Sign in"            # crop to a node by text
-rnxsim screenshot --gallery --themes          # crawl screens → HTML gallery, light+dark
-rnxsim screenshot --no-shell -o tenant.png    # tenant surface only, no iOS chrome
-rnxsim screenshot --shell-only                # only the simulated iOS chrome
+rnx screenshot --output app.png            # full canvas
+rnx screenshot --area 0,200,393,400        # crop to a logical rect
+rnx screenshot --id loginButton -o btn.png # crop to a node by testID
+rnx screenshot --text "Sign in"            # crop to a node by text
+rnx screenshot --gallery --themes          # crawl screens → HTML gallery, light+dark
+rnx screenshot --no-shell -o tenant.png    # tenant surface only, no iOS chrome
+rnx screenshot --shell-only                # only the simulated iOS chrome
 ```
 
 `--gallery` crawls reachable screens and writes a browsable HTML gallery
@@ -68,9 +68,9 @@ capture both sides to PNGs, then diff with any standard image tool.
 **rnx vs rnx (regression across your own commits):**
 
 ```sh
-rnxsim screenshot -o before.png                      # baseline, before your change
+rnx screenshot -o before.png                      # baseline, before your change
 # … make the rendering change, let the sim hot-reload …
-rnxsim screenshot -o after.png                       # after your change
+rnx screenshot -o after.png                       # after your change
 npx pixelmatch before.png after.png diff.png 0.1      # writes diff.png
 # or: magick compare before.png after.png diff.png
 ```
@@ -81,7 +81,7 @@ npx pixelmatch before.png after.png diff.png 0.1      # writes diff.png
 # native side — capture from your booted iOS simulator
 xcrun simctl io booted screenshot native.png
 # rnx side — same screen, same appearance
-rnxsim screenshot -o rnx.png
+rnx screenshot -o rnx.png
 npx pixelmatch native.png rnx.png diff.png 0.1
 ```
 
@@ -92,7 +92,7 @@ under unrelated chrome.
 ## typical workflow
 
 1. structural diff first — confirm the change is genuinely visual.
-2. capture the affected screen with `rnxsim screenshot` (crop to the
+2. capture the affected screen with `rnx screenshot` (crop to the
    element if you can).
 3. diff against the baseline (previous commit, or a native capture).
 4. iterate the rendering until the diff is under threshold.
@@ -110,7 +110,7 @@ under unrelated chrome.
 ## recovery — common failure modes
 
 - **a single icon/glyph diffs** — font-load race or image not yet
-  cached. recapture after `rnxsim wait idle`, or navigate away and back
+  cached. recapture after `rnx wait idle`, or navigate away and back
   to seed the cache.
 - **everything diffs by a constant offset** — you captured the two sides
   on different devices or appearances. pin both, recapture.

package/src/agent-daemon-client.ts

@@ -361,7 +361,7 @@ export async function ensureDaemonRunning(
   }
   if (shouldSkipPersistentDaemon()) {
     throw new AgentDaemonError(
-      `no rnx bridge on port ${port}. run \`rnxsim setup\` to install the background daemon, or \`rnxsim serve\` in another shell.`,
+      `no rnx bridge on port ${port}. run \`rnx setup\` to install the background daemon, or \`rnx serve\` in another shell.`,
       'DEV_HOST_REFUSED',
     )
   }
@@ -386,7 +386,7 @@ export async function ensureDaemonRunning(
   }
   throw new AgentDaemonError(
     `spawned rnx daemon on port ${port} but it did not come up in time. ` +
-      `run \`rnxsim serve\` manually to diagnose.`,
+      `run \`rnx serve\` manually to diagnose.`,
     'SPAWN_TIMEOUT',
   )
 }

package/src/agent-sessions.ts

@@ -117,7 +117,7 @@ export function resolveSootsimInvocation(): { cmd: string; prefixArgs: string[]
     // bin-shim case falls through to the error below instead of silently
     // running `node` without args.
     throw new Error(
-      'rnxsim CLI not found. set SOOTSIM_BIN to the path of the rnxsim binary, ' +
+      'rnx CLI not found. set SOOTSIM_BIN to the path of the rnx binary, ' +
         'or build the workspace CLI via `bun run --cwd packages/sootsim build:cli`.',
     )
   }
@@ -335,7 +335,7 @@ export async function startSession(opts: StartSessionOpts): Promise<StartSession
         'ALREADY_RUNNING',
         `session already running for project=${project.id} provider=${provider} ` +
           `(session ${existingLive.id}, pid ${existingLive.wrapperPid}). ` +
-          'end it first with `rnxsim agent end <sessionId>`.',
+          'end it first with `rnx agent end <sessionId>`.',
       )
     }
 

package/src/connect.ts

@@ -11,7 +11,7 @@ import { SimClient, SimConnectError } from './sim-client'
 export interface ConnectOptions {
   /** ws bridge port. default: the resolved bridge world (lockfiles). */
   port?: number
-  /** sim id to attach to (as shown by `rnxsim list`). default: the primary sim. */
+  /** sim id to attach to (as shown by `rnx list`). default: the primary sim. */
   sim?: string
   /** per-command bridge timeout in ms. default 15000. */
   timeoutMs?: number
@@ -30,13 +30,13 @@ function pickSim(
         `no sim connected with id ${wanted} on bridge :${port}` +
           (open.length
             ? ` — connected: ${open.map((sim) => sim.id).join(', ')}`
-            : ' — no sims connected; open one with `rnxsim open <port>`'),
+            : ' — no sims connected; open one with `rnx open <port>`'),
       )
     }
     return match
   }
-  // same session affinity as the CLI: a sim pinned by `rnxsim open` /
-  // `rnxsim use` in this terminal wins over the primary election, so a script
+  // same session affinity as the CLI: a sim pinned by `rnx open` /
+  // `rnx use` in this terminal wins over the primary election, so a script
   // run next to CLI commands drives the sim the terminal is working with. a
   // stale pin (sim gone) falls through to the primary.
   const pinned = readCurrentSimId()
@@ -47,7 +47,7 @@ function pickSim(
   const primary = open.find((sim) => sim.isPrimary) ?? open[0]
   if (!primary) {
     throw new SimConnectError(
-      `no sims connected on bridge :${port} — open one with \`rnxsim open <port>\``,
+      `no sims connected on bridge :${port} — open one with \`rnx open <port>\``,
     )
   }
   return primary
@@ -67,7 +67,7 @@ export async function connect(options: ConnectOptions = {}): Promise<SimClient>
     discovery.close()
     if (error instanceof SimConnectError) throw error
     const message = error instanceof Error ? error.message : String(error)
-    throw new SimConnectError(`${message} — is the rnxsim daemon or dev shell running?`)
+    throw new SimConnectError(`${message} — is the rnx daemon or dev shell running?`)
   }
   discovery.close()
 

package/src/disk-cleanup.ts

@@ -178,7 +178,7 @@ function collectRecordingEntries(
   })
 }
 
-// videos staged by `rnxsim camera play`. a fixture is only a copy of a file
+// videos staged by `rnx camera play`. a fixture is only a copy of a file
 // the user still has, so it is cheap to reclaim, but the automatic sweep must
 // not pull one out from under a sim that is playing it right now. aggressive
 // only, matching recordings.

package/src/home-paths.ts

@@ -128,7 +128,7 @@ export function profilesDir(): string {
   return path.join(sootsimHomeDir(), 'profiles')
 }
 
-// video fixtures staged for `rnxsim camera play`. the CLI copies the user's
+// video fixtures staged for `rnx camera play`. the CLI copies the user's
 // file in here and the daemon serves it by basename from this one directory,
 // so the route can never be talked into reading anywhere else on disk.
 export function cameraFixturesDir(): string {

package/src/host/bridge-host.ts

@@ -306,7 +306,7 @@ const HTTP_MIME_TYPES: Record<string, string> = {
   '.mov': 'video/quicktime',
 }
 
-// `rnxsim camera play` stages a video under ~/.sootsim/camera-fixtures and the
+// `rnx camera play` stages a video under ~/.sootsim/camera-fixtures and the
 // simulator plays it as the camera feed. the route below serves that one
 // directory, addressed by basename only.
 const CAMERA_FIXTURE_ROUTE = '/__camera-fixtures/'
@@ -1010,7 +1010,7 @@ export class SootSimBridgeHost {
                   ws.send(
                     JSON.stringify({
                       id: msg.id,
-                      error: `sim ${targetSim.id} is locked by another cli — use \`rnxsim claim ${targetSim.id} --force\` or \`rnxsim open --new\``,
+                      error: `sim ${targetSim.id} is locked by another cli — use \`rnx claim ${targetSim.id} --force\` or \`rnx open --new\``,
                       _locked: outcome.lock,
                     }),
                   )
@@ -1634,7 +1634,7 @@ export class SootSimBridgeHost {
       return
     }
 
-    // /__camera-fixtures/<name> — the staged video behind `rnxsim camera play`.
+    // /__camera-fixtures/<name> — the staged video behind `rnx camera play`.
     // the shell page is a different origin from this daemon (vite dev on 5173,
     // daemon on 7668+), and the camera pipeline draws the <video> to a canvas
     // and reads it back, so this needs real CORS or the canvas taints and
@@ -1766,8 +1766,8 @@ export class SootSimBridgeHost {
       res.writeHead(503, { 'Content-Type': 'text/plain; charset=utf-8' })
       res.end(
         versionedRuntimeRequest
-          ? `rnx: runtime ${requestedRuntime ?? '(invalid version origin)'} is not installed. run \`rnxsim open\` from that app again.`
-          : 'rnx: no active runtime installed. run `rnxsim runtime install` to fetch one.',
+          ? `rnx: runtime ${requestedRuntime ?? '(invalid version origin)'} is not installed. run \`rnx open\` from that app again.`
+          : 'rnx: no active runtime installed. run `rnx runtime install` to fetch one.',
       )
       return
     }
@@ -2472,7 +2472,7 @@ export class SootSimBridgeHost {
         if (candidates.length > 1) {
           throw new Error(
             `multiple sims are connected: ${candidates.map((sim) => sim.id).join(', ')}; ` +
-              'run `rnxsim use <sim>` or pass `--sim <sim>`',
+              'run `rnx use <sim>` or pass `--sim <sim>`',
           )
         }
         const candidate = candidates[0]

package/src/index.ts

@@ -29,7 +29,7 @@ export type {
   SimStateResult,
 } from './bridge-contract'
 
-export { sootsimPlugin } from './vite-plugin-one'
+export { rnxPlugin } from './vite-plugin-one'
 export { default as metroPlugin } from './metro-plugin'
 export { default as jumpToSourceBabelPlugin } from './jump-to-source-babel'
 export {

package/src/metro-host-modules/react-dom.js

@@ -0,0 +1,6 @@
+const name = 'react-dom'
+const host = globalThis.__contrastHostModules
+if (!host || !(name in host)) {
+  throw new Error(`rnxsim: runtime did not publish __contrastHostModules[${name}]`)
+}
+module.exports = host[name]

package/src/metro-host-modules/react-native-web.js

@@ -0,0 +1,6 @@
+const name = 'react-native-web'
+const host = globalThis.__contrastHostModules
+if (!host || !(name in host)) {
+  throw new Error(`rnxsim: runtime did not publish __contrastHostModules[${name}]`)
+}
+module.exports = host[name]

package/src/metro-host-modules/react-native.js

@@ -0,0 +1,6 @@
+const name = 'react-native'
+const host = globalThis.__contrastHostModules
+if (!host || !(name in host)) {
+  throw new Error(`rnxsim: runtime did not publish __contrastHostModules[${name}]`)
+}
+module.exports = host[name]

package/src/metro-host-modules/react.js

@@ -0,0 +1,6 @@
+const name = 'react'
+const host = globalThis.__contrastHostModules
+if (!host || !(name in host)) {
+  throw new Error(`rnxsim: runtime did not publish __contrastHostModules[${name}]`)
+}
+module.exports = host[name]

package/src/metro-host-modules/react__jsx-dev-runtime.js

@@ -0,0 +1,6 @@
+const name = 'react/jsx-dev-runtime'
+const host = globalThis.__contrastHostModules
+if (!host || !(name in host)) {
+  throw new Error(`rnxsim: runtime did not publish __contrastHostModules[${name}]`)
+}
+module.exports = host[name]

package/src/metro-host-modules/react__jsx-runtime.js

@@ -0,0 +1,6 @@
+const name = 'react/jsx-runtime'
+const host = globalThis.__contrastHostModules
+if (!host || !(name in host)) {
+  throw new Error(`rnxsim: runtime did not publish __contrastHostModules[${name}]`)
+}
+module.exports = host[name]