rnxsim 0.1.380 → 0.1.382

package/cli/commands/box.ts

@@ -1,48 +1,40 @@
 // `rnx box` — the box environment.
 //
-// bare `rnx box` is LOCAL and mounts the current checkout at /project. `rnx box
-// create` provisions a durable cloud box. everything else in the namespace is
-// cloud lifecycle. the cloud side is not built yet; those verbs fail by name
-// and say what works instead, so nothing advertises a capability that always
-// fails.
+// bare `rnx box` is LOCAL and mounts the current checkout at /project. cloud
+// create provisions through the shared client and enters the same shell unless
+// --json asks for a noninteractive result. reconnect still needs an authorized
+// provider lookup from public box identity to the provider reference.
 
 import path from 'node:path'
 import { createInterface } from 'node:readline'
-import {
-  createHarnessShell,
-  HarnessProjectFs,
-  PROJECT_MOUNT,
-} from '@contrast/harness/shell'
+import { BoxClientError, createBoxClient } from '@rnx/box/client'
+import { createBoxHostProvider } from '@rnx/box/host'
+import { PROJECT_MOUNT } from '@rnx/box/shell'
+import { terminalBoxStack } from '@rnx/box/stack'
+import { BoxTemplateRegistry, terminalBoxTemplate } from '@rnx/box/template'
+import { createCloudBoxProvider, heartbeatSession } from 'rnx-cloud-box/client'
 import { rnxPublicBrand } from '../../src/public-brand'
 import { authHeaderOrExit } from '../auth'
 import { findRepositoryPackageRoot } from '../setup-repository'
 import { resolvePlacement } from '../ws-bridge'
 import { CheckoutFilePlane, CheckoutRequiresGitError } from './box/checkout-plane'
-import {
-  CloudBoxError,
-  connectCloudBox,
-  createCloudBox,
-  heartbeatSession,
-  listCloudBoxes,
-  stopCloudBox,
-} from './box/cloud-box'
 import { sharePlane } from './box/plane-share'
 import { createRnxCommand } from './box/rnx-command'
 import { createSearchCommand } from './box/search-command'
-import type { HarnessShellResult } from '@contrast/harness/shell'
+import type { BoxShellSession } from '@rnx/box/client'
+import type { BoxTemplateResolution } from '@rnx/box/template'
 
 interface BoxCommandOptions {
   port?: number
   verbose?: boolean
 }
 
-const CLOUD_SUBCOMMANDS = new Set(['connect'])
-
 // no default. a cloud box service has to be deployed before one can exist, and
 // defaulting to an origin that answers nothing would advertise a capability
 // that always fails.
 const ENDPOINT_ENV = 'RNX_BOX_ENDPOINT'
 const API_ORIGIN_ENV = 'RNX_API_ORIGIN'
+const BOX_TEMPLATES = new BoxTemplateRegistry([terminalBoxTemplate])
 
 function usage(): void {
   const rnx = rnxPublicBrand.commandName
@@ -53,9 +45,12 @@ function usage(): void {
     ${rnx} box                     start a local box over the current checkout
     ${rnx} box create              create a cloud box and enter its shell
     ${rnx} box create --name=<n>   create a named cloud box
+    ${rnx} box create --template=<id>
+                                   create from a registered Box template
     ${rnx} box create --endpoint=<url>
                                    the box service to create it in, or set
                                    ${ENDPOINT_ENV}
+    ${rnx} box create --json       create without entering the shell
     ${rnx} box ls                  cloud boxes running on this account
     ${rnx} box stop --name=<n>     stop a cloud box and its billing
     ${rnx} box delete --name=<n>   stop it and wipe its files
@@ -89,18 +84,18 @@ export async function runBox(
 
   const subcommand = args.find((arg) => !arg.startsWith('-'))
   if (subcommand === 'create') return runCloudBoxCreate(args, opts)
+  if (subcommand === 'connect') {
+    console.error(
+      `  ${rnxPublicBrand.commandName} box connect: the cloud provider cannot yet resolve a Box ID or name to an authorized Box reference.\n` +
+        `  the shared Box client requires that reference's access token, and the CLI does not persist Box tokens.`,
+    )
+    return 1
+  }
   if (subcommand === 'stop' || subcommand === 'delete') {
     return runCloudBoxStop(args, subcommand === 'delete')
   }
   if (subcommand === 'ls') return runCloudBoxList(args)
   if (subcommand !== undefined) {
-    if (CLOUD_SUBCOMMANDS.has(subcommand)) {
-      console.error(
-        `  ${rnxPublicBrand.commandName} box ${subcommand} needs a cloud box, which is not built yet.\n` +
-          `  \`${rnxPublicBrand.commandName} box\` runs the same shell locally over this checkout.`,
-      )
-      return 1
-    }
     console.error(
       `  unknown command: ${rnxPublicBrand.commandName} box ${subcommand}\n` +
         `  run \`${rnxPublicBrand.commandName} box --help\` to see the box surface.`,
@@ -108,6 +103,13 @@ export async function runBox(
     return 1
   }
 
+  if (args.includes('--json')) {
+    console.error(
+      `  ${rnxPublicBrand.commandName} box --json requires a noninteractive cloud subcommand such as create.`,
+    )
+    return 1
+  }
+
   return runLocalBox(opts)
 }
 
@@ -152,13 +154,14 @@ async function runCloudBoxStop(args: string[], purge: boolean): Promise<number>
     return 1
   }
   const { header } = authHeaderOrExit(`box ${label}`)
+  const apiKey = header.replace(/^Bearer /, '')
+  const client = createBoxClient(
+    createCloudBoxProvider({ endpoint, apiOrigin: apiOrigin(args), apiKey }),
+  )
   try {
-    const result = await stopCloudBox({
-      endpoint,
-      name,
-      apiKey: header.replace(/^Bearer /, ''),
-      purge,
-    })
+    const result = purge
+      ? await client.delete({ boxId: name })
+      : await client.stop({ boxId: name })
     console.log(
       purge
         ? `  deleted ${name}, freeing ${Number(result.freedBytes ?? 0)} bytes`
@@ -166,7 +169,7 @@ async function runCloudBoxStop(args: string[], purge: boolean): Promise<number>
     )
     return 0
   } catch (error) {
-    if (error instanceof CloudBoxError) {
+    if (error instanceof BoxClientError) {
       console.error(`  ${rnx} box ${label}: ${error.message}`)
       return 1
     }
@@ -177,22 +180,29 @@ async function runCloudBoxStop(args: string[], purge: boolean): Promise<number>
 async function runCloudBoxList(args: string[]): Promise<number> {
   const rnx = rnxPublicBrand.commandName
   const { header } = authHeaderOrExit('box ls')
-  try {
-    const boxes = await listCloudBoxes({
+  const apiKey = header.replace(/^Bearer /, '')
+  const client = createBoxClient(
+    createCloudBoxProvider({
+      endpoint: flag(args, 'endpoint') ?? process.env[ENDPOINT_ENV]?.trim() ?? '',
       apiOrigin: apiOrigin(args),
-      apiKey: header.replace(/^Bearer /, ''),
-    })
+      apiKey,
+    }),
+  )
+  try {
+    const boxes = await client.list()
     if (boxes.length === 0) {
       console.log(`  no cloud boxes running on this account`)
       return 0
     }
     for (const box of boxes) {
       const minutes = Math.round(box.meteredMs / 60_000)
-      console.log(`  ${box.name ?? box.id}  running ${minutes}m  since ${box.startedAt}`)
+      console.log(
+        `  ${box.name ?? box.boxId}  running ${minutes}m  since ${box.startedAt}`,
+      )
     }
     return 0
   } catch (error) {
-    if (error instanceof CloudBoxError) {
+    if (error instanceof BoxClientError) {
       console.error(`  ${rnx} box ls: ${error.message}`)
       return 1
     }
@@ -205,6 +215,7 @@ async function runCloudBoxCreate(
   opts: BoxCommandOptions,
 ): Promise<number> {
   const rnx = rnxPublicBrand.commandName
+  const json = args.includes('--json')
   const endpoint = flag(args, 'endpoint') ?? process.env[ENDPOINT_ENV]?.trim()
   if (!endpoint) {
     console.error(
@@ -215,6 +226,17 @@ async function runCloudBoxCreate(
     return 1
   }
 
+  const templateName = flag(args, 'template') ?? terminalBoxTemplate.name
+  let template: BoxTemplateResolution
+  try {
+    template = BOX_TEMPLATES.resolve({ name: templateName })
+  } catch (error) {
+    console.error(
+      `  ${rnx} box create: ${error instanceof Error ? error.message : String(error)}.`,
+    )
+    return 1
+  }
+
   const root = findRepositoryPackageRoot(process.cwd())
   if (!root) {
     console.error(
@@ -224,7 +246,7 @@ async function runCloudBoxCreate(
     return 1
   }
 
-  const plane = new CheckoutFilePlane(root)
+  const plane = new CheckoutFilePlane(root, { trackedOnly: true })
   try {
     await plane.refresh()
   } catch (error) {
@@ -242,36 +264,55 @@ async function runCloudBoxCreate(
   const { header } = authHeaderOrExit('box create')
   const apiKey = header.replace(/^Bearer /, '')
 
-  console.log(`  ...creating cloud box ${name}`)
-  let session: Awaited<ReturnType<typeof connectCloudBox>> | null = null
+  if (!json) console.log(`  ...creating cloud box ${name}`)
+  const client = createBoxClient(
+    createCloudBoxProvider({ endpoint, apiOrigin: apiOrigin(args), apiKey }),
+  )
+  let session: BoxShellSession | null = null
   let heartbeat: { stop: () => void } | null = null
   try {
-    const created = await createCloudBox({
-      endpoint,
+    const box = await client.create({
       name,
-      apiKey,
-      plane,
-      onProgress: opts.verbose
-        ? (seeded, total) => console.log(`  ...seeded ${seeded}/${total} files`)
-        : undefined,
+      stack: template.stack,
+      template: template.provenance,
+      source: plane,
+      onProgress:
+        opts.verbose && !json
+          ? (seeded, total) => console.log(`  ...seeded ${seeded}/${total} files`)
+          : undefined,
     })
-    console.log(`  ...seeded ${created.files} project files`)
+    if (json) {
+      console.log(
+        JSON.stringify({
+          ...box.description,
+          ...(box.accessToken ? { accessToken: box.accessToken } : {}),
+        }),
+      )
+      return 0
+    }
+    console.log(`  ...created Box ${box.id}`)
+    if (box.description.stableUrl) {
+      console.log(`  ...live ${box.description.stableUrl}`)
+    }
+    console.log(`  ...seeded ${box.description.files} project files`)
     // shown once and never stored: this process does not own a credential
     // store, and inventing one here would be a second place secrets live.
-    console.log(`  ...box token (shown once): ${created.token}`)
+    console.log(`  ...box token (shown once): ${box.accessToken}`)
     console.log(`  ...accessing shell\n`)
-    session = await connectCloudBox({ endpoint, name, token: created.token })
+    session = await box.connect()
     // bank the wall clock while the shell is open. the box holds no account
     // credential, so the client that is using it is what keeps the session
     // alive; when this process dies the sweep closes it at the last heartbeat.
+    const sessionId = box.description.sessionId
+    if (!sessionId) throw new BoxClientError('the box service returned no session id')
     heartbeat = heartbeatSession({
       apiOrigin: apiOrigin(args),
       apiKey,
-      sessionId: created.sessionId,
+      sessionId,
     })
     return await repl(session, '')
   } catch (error) {
-    if (error instanceof CloudBoxError) {
+    if (error instanceof BoxClientError) {
       console.error(`  ${rnx} box create: ${error.message}`)
       return 1
     }
@@ -311,13 +352,28 @@ async function runLocalBox(opts: BoxCommandOptions): Promise<number> {
     throw error
   }
 
-  const shell = createHarnessShell({
-    projectFs: new HarnessProjectFs(plane),
-    commands: [createRnxCommand({ root, shellCwd: () => shell.cwd })],
-    // just-bash's JavaScript rg reads every file body through the plane.
-    // see search-command.ts for the numbers.
-    builtInCommandOverrides: [createSearchCommand({ root })],
+  let session: BoxShellSession | null = null
+  const client = createBoxClient(
+    createBoxHostProvider({
+      shell: {
+        commands: [
+          createRnxCommand({
+            root,
+            shellCwd: () => session?.cwd ?? PROJECT_MOUNT,
+          }),
+        ],
+        // just-bash's JavaScript rg reads every file body through the plane.
+        // see search-command.ts for the numbers.
+        builtInCommandOverrides: [createSearchCommand({ root })],
+      },
+    }),
+  )
+  const box = await client.create({
+    name: path.basename(root),
+    stack: terminalBoxStack,
+    source: plane,
   })
+  session = await box.connect()
 
   const relative = path.relative(root, process.cwd())
   console.log(`  ...starting local box`)
@@ -362,26 +418,23 @@ async function runLocalBox(opts: BoxCommandOptions): Promise<number> {
 
   try {
     // the checkout is shared with editors, agents, and the user's own terminal.
-    // HarnessProjectFs arms a stale bit on each shell turn and refreshes the
+    // BoxProjectFs arms a stale bit on each shell turn and refreshes the
     // plane synchronously on the first actual file access, so commands that
     // never touch project files pay nothing, while reads always see fresh disk state.
-    return await repl(shell, relative)
+    return await repl(session, relative)
   } finally {
+    session.close()
     shared?.close()
   }
 }
 
 // the REPL drives whatever holds the shell. locally that is an in-process
-// HarnessShell over this checkout; for a cloud box it is a socket to the box,
+// BoxShell over this checkout; for a cloud box it is a socket to the box,
 // which holds both the files and the shell. same loop, because the only
 // difference is where exec runs.
-interface BoxSession {
-  readonly cwd: string
-  exec(command: string): Promise<HarnessShellResult>
-}
 
 async function repl(
-  session: BoxSession,
+  session: BoxShellSession,
   startRelative: string,
   beforeCommand?: () => Promise<void>,
 ): Promise<number> {

package/cli/commands/config.ts

@@ -9,8 +9,9 @@ usage:
   rnx config telemetry [on|off|status]
 
 environment:
-  RNX_HINTS=off       suppress CLI hints
-  RNX_HINTS=always    show every CLI hint every time
+  RNX_HINTS=off          suppress CLI hints
+  RNX_HINTS=always       show every CLI hint every time
+  RNX_UPDATE_CHECK=off   disable background CLI update checks and notices
 `)
 }
 

package/cli/commands/control.ts

@@ -339,7 +339,7 @@ function buildShellPathOpenUrl(target: string, baseUrl: string): string {
   return url.toString()
 }
 
-// SootSim share/preview/build links (e.g. https://sootsim.com/preview/<id>,
+// rnx share/preview/build links (e.g. https://rnxsim.com/preview/<id>,
 // https://contrast.dev/build/<owner>/<repo>/<branch>) are full player pages
 // served by the Contrast app — NOT Metro bundles and NOT driveable shell sims.
 // passing one to `rnx open` used to fall through to the bundle resolver,
@@ -942,7 +942,7 @@ export function printConnectedSims(sims: BridgeSimInfo[], selectedId?: string) {
 
 // classify which engine a sim is running so dev-vs-published is never ambiguous
 // to agents or humans reading `rnx list`. dev shell serves local source on
-// :5173; the Contrast app embeds sootsim on :3000; the bridge/daemon and the
+// :5173; the Contrast app embeds rnx on :3000; the bridge/daemon and the
 // /__soot plugin serve the active runtime dir — which, inside a dev checkout, is
 // the fresh dev-stack build (resolveDevCheckoutRuntimeRoot mode boundary), not a
 // published runtime. keep this label honest so it never says "published" while
@@ -1126,9 +1126,9 @@ async function waitForProcessExit(pid: number, timeoutMs = 2_500): Promise<boole
 
 // a sim record's host pid can outlive its process; after pid reuse the number
 // may point at an unrelated process (real incident 2026-07-14: a stale record
-// made `sootsim close` SIGTERM the shared vite shell dev server, taking the
+// made `rnx close` SIGTERM the shared vite shell dev server, taking the
 // whole dev stack down). only signal a pid whose argv proves it is still a
-// sootsim playwright host launcher.
+// rnx playwright host launcher.
 function isPlaywrightHostProcess(pid: number): boolean {
   // `ps eww` prints argv then the process ENVIRONMENT for same-user
   // processes. the marker must live in the env SUFFIX (everything past the
@@ -1530,9 +1530,9 @@ export async function runOpenCommand(
   }
 
   // metro HMR mode. interactive opens default to hot=true so edits hot-apply
-  // through sootsim's HmrClient — expo CLI's createBundleUrlSearchParams
+  // through rnx's HmrClient — expo CLI's createBundleUrlSearchParams
   // hardcodes hot=false on every launchAsset URL (a leftover toggle real iOS
-  // sims tolerate but sootsim couldn't until now), so without this flip the
+  // sims tolerate but rnx couldn't until now), so without this flip the
   // bundle prelude doesn't include metro's HMR runtime + react-refresh and
   // edits silently no-op. `--driver playwright` (agent / CI runs) defaults
   // to hot=false for deterministic e2e. explicit `--hot` / `--no-hmr` win.

package/cli/commands/cpu-profile.ts

@@ -1,7 +1,7 @@
 // rnx perf cpu — capture sampled CPU traces from the page and every worker.
 //
 // the JS Self-Profiler API (`new Profiler()`) cannot be constructed in a
-// dedicated-worker scope, and sootsim runs the guest app in the tenant worker,
+// dedicated-worker scope, and rnx runs the guest app in the tenant worker,
 // so the old in-worker approach was unsupported (F28). this implementation
 // attaches Chromium's `Profiler` CDP domain to the page and worker targets —
 // which returns the .cpuprofile shape directly for every execution context.
@@ -10,7 +10,7 @@
 // target, `Target.setAutoAttach` to discover the worker child sessions, and
 // route `Profiler.*` to each worker via its sessionId (flatten mode).
 //
-// the user's normal sootsim tab runs in plain Chrome without a debug port.
+// the user's normal rnx tab runs in plain Chrome without a debug port.
 // the easiest way to get a profilable sim is to open one with a CDP port —
 // it stays driveable over the WS bridge, so you can scroll/navigate while
 // profiling (the playwright driver passes --remote-debugging-port through):

package/cli/commands/daemon.ts

@@ -1,8 +1,8 @@
-// rnx daemon — manage the persistent sootsim bridge daemon
+// rnx daemon — manage the persistent rnx bridge daemon
 //
 // wraps `rnx serve` so it starts automatically on login and restarts if
-// it crashes. the agent is tied to whichever `sootsim` binary resolves at
-// registration time, so `npm update -g sootsim` + `rnx daemon restart`
+// it crashes. the agent is tied to whichever `rnxsim` binary resolves at
+// registration time, so `npm update -g rnxsim` + `rnx daemon restart`
 // picks up the upgrade without touching the plist/unit file.
 //
 // `daemonInstall` is shared by `rnx setup` and the explicit
@@ -104,10 +104,10 @@ function resolveSootsimInvocation(): SootsimInvocation {
   // launchd / systemd run agents with a stripped PATH (basically just
   // /usr/bin:/bin:/usr/sbin:/sbin), so a `#!/usr/bin/env node` shebang
   // resolves nothing and the daemon never starts. spawn the absolute node
-  // binary directly with the sootsim entry script as an argument.
+  // binary directly with the rnx entry script as an argument.
   //
   // process.execPath is whichever node ran the install command, which is
-  // also the node the user expects sootsim to run on.
+  // also the node the user expects rnx to run on.
   const npxInvocation = resolveNpxDaemonInvocation()
   if (npxInvocation) return npxInvocation
   const entry = resolveSootsimEntryScript()
@@ -433,7 +433,7 @@ export async function daemonInstall({ port, force }: { port: number; force: bool
 
     // user-scope systemd units are killed when the user's last session ends.
     // on most distros the daemon then disappears at logout — the unit is
-    // "active" until you log off, then silently dead, and `sootsim` looks
+    // "active" until you log off, then silently dead, and `rnx` looks
     // broken when you ssh back in. `loginctl enable-linger` keeps the user
     // bus alive across sessions, which is what every other long-running
     // user agent (gpg-agent, ssh-agent --systemd) also relies on.
@@ -513,7 +513,7 @@ export function teardownLegacyMacDaemonArtifacts(
  *  and its support files (mac .app bundle, log dir). does NOT touch user
  *  data under ~/.rnx. idempotent: each entry is checked before remove.
  *  exported for reuse by the npm preuninstall hook (scripts/preuninstall.cjs)
- *  via the bundled CLI so a `npm rm -g sootsim` tears down the daemon before
+ *  via the bundled CLI so a `npm rm -g rnxsim` tears down the daemon before
  *  the bin disappears. */
 export function teardownDaemonService(): TeardownReport {
   const removed: string[] = []

package/cli/commands/debug.ts

@@ -1,6 +1,6 @@
 // rnx debug — drive __sootsimDebug.* from the terminal
 //
-// connects to a running sootsim instance via the WebSocket bridge and forwards
+// connects to a running rnx instance via the WebSocket bridge and forwards
 // debug channel management, tree snapshots, and on-demand inspectors without
 // requiring a browser console.
 //
@@ -78,7 +78,7 @@ subcommands:
                                  scroll <id>, scroll-hit <x> <y>,
                                  hit <x> <y>, gesture <x> <y>
 
-  js <code>               execute javascript in the running app. SootSim
+  js <code>               execute javascript in the running app. rnx
                           is the canonical state object — reach into its
                           bridges / state / chrome / debug slots directly.
                           e.g. SootSim.bridges.test.findByText("Sign in")

package/cli/commands/detox.ts

@@ -1,10 +1,10 @@
-// sootsim detox — run existing detox suites against sootsim
+// rnx detox — run existing detox suites against rnx
 //
 // the command is a thin orchestration layer over `npx jest`:
 //  1. resolves a test dir (cwd e2e|test/e2e|detox, or the flag)
-//  2. makes sure a sootsim shell is reachable (auto-launches one if not)
+//  2. makes sure an rnx shell is reachable (auto-launches one if not)
 //  3. spawns jest with our preset baked in so `import ... from 'detox'`
-//     resolves to the sootsim driver
+//     resolves to the rnx driver
 //
 // it deliberately shells out to the user's own jest so their jest version,
 // transforms, and setupFiles keep working. the only thing we force is the
@@ -129,7 +129,7 @@ export async function runDetox(args: string[], opts: RunDetoxOpts = {}): Promise
     rnxExit(1)
   }
 
-  // auto-launch: make sure a sootsim shell is reachable before running jest.
+  // auto-launch: make sure an rnx shell is reachable before running jest.
   // Reuse the Maestro discovery path: scan local dev servers.
   // and `rnx open` the first match.
   if (!noLaunch) {
@@ -227,7 +227,7 @@ export async function runDetox(args: string[], opts: RunDetoxOpts = {}): Promise
 
   // jest owns the browsers, and it only reaps them from its own signal and exit
   // handlers. this process is the one a caller has a pid for, so a SIGTERM aimed
-  // at `sootsim detox` lands here and jest never hears about it: it is a
+  // at `rnx detox` lands here and jest never hears about it: it is a
   // grandchild (this -> npx -> jest), so it keeps running with no parent and
   // every chrome it launched is orphaned for good. forward the signal instead of
   // exiting out from under it, and let its exit code end this process.
@@ -362,8 +362,8 @@ function initDetoxProject(): void {
     writeFileSync(
       configPath,
       `// rnx detox jest config.
-// extends the sootsim preset, which rewrites \`import ... from 'detox'\`
-// to the sootsim driver and keeps your jest transforms intact.
+// extends the rnx preset, which rewrites \`import ... from 'detox'\`
+// to the rnx driver and keeps your jest transforms intact.
 
 /** @type {import('@jest/types').Config.InitialOptions} */
 module.exports = {

package/cli/commands/diagnose.ts

@@ -32,7 +32,7 @@ import type {
   SootSimTimelineEvent,
   SootSimTimelineQuery,
   SootSimTimelineQueryResult,
-} from '@sootsim/globals'
+} from '@rnx/globals'
 
 interface DiagnoseOptions {
   port?: number

package/cli/commands/electron.ts

@@ -1,4 +1,4 @@
-// sootsim desktop — launch the installed desktop companion via the
+// rnx desktop — launch the installed desktop companion via the
 // electron driver. the driver wraps findDesktopCompanion +
 // launchDesktopCompanion, so this command is a thin CLI surface that
 // parses options, prompts for install, and delegates everything else.

package/cli/commands/film.ts

@@ -148,7 +148,7 @@ examples:
     )
     if (!started) {
       console.error(
-        '  film: engine recording store did not start (is @sootsim/plugin-recording installed?)',
+        '  film: engine recording store did not start (is @rnx/plugin-recording installed?)',
       )
       return 1
     }

package/cli/commands/flow.ts

@@ -1,5 +1,5 @@
 // shared Maestro YAML playback and live-authoring implementation.
-// discovers a sootsim target when needed, then reuses the shared bridge action layer
+// discovers an rnx target when needed, then reuses the shared bridge action layer
 
 import * as fs from 'fs'
 import { createHash, randomUUID } from 'node:crypto'
@@ -82,7 +82,7 @@ export async function resolveAppFrontmatterTarget(
   return { target: trimmed }
 }
 
-// discover a sootsim shell URL — prefer patched servers, fall back to any match.
+// discover an rnx shell URL — prefer patched servers, fall back to any match.
 // exported so `detox.ts` and `maestro.ts` can reuse the same discovery logic.
 export async function discoverSootsimUrl(): Promise<string | null> {
   const servers = await scanDevServers()
@@ -143,7 +143,7 @@ options:
   --preview-origin <url>
                        upload target for --preview (default: auto)
   --preview-public-origin <url>
-                       public link origin for --preview (default: sootsim.com
+                       public link origin for --preview (default: rnxsim.com
                        for prod uploads)
   --billing-kind test_run
                        meter the chained preview upload as a test run
@@ -371,7 +371,7 @@ flow extension:
   ) {
     const discovered = await discoverSootsimUrl()
     if (!discovered) {
-      console.error('  error: no current sim and no sootsim target found')
+      console.error('  error: no current sim and no rnx target found')
       rnxExit(1)
     }
     openTarget = discovered