rnxsim 0.1.381 → 0.1.382

package/cli/commands/platform.ts

@@ -15,6 +15,7 @@ import {
 } from 'sootsim-engine/settings'
 import { settingsStore } from 'sootsim-engine/settings/store'
 import { rnxPublicBrand } from '../../src/public-brand'
+import { rethrowIfExit } from '../run-rnx'
 
 const PLATFORM_LABEL: Record<RuntimePlatform, string> = {
   ios: 'iOS',
@@ -25,6 +26,36 @@ function isDeviceModel(value: string): value is DeviceModel {
   return value in devices
 }
 
+function cloudBundleFromArgs(args: string[]): string | null {
+  const positional: string[] = []
+  for (let index = 0; index < args.length; index++) {
+    const arg = args[index]
+    if (arg === '--cloud') continue
+    if (arg === '--device') {
+      index++
+      continue
+    }
+    if (
+      arg === '--sim' ||
+      arg === '--session' ||
+      arg === '--tab' ||
+      arg.startsWith('--sim=') ||
+      arg.startsWith('--session=') ||
+      arg.startsWith('--tab=')
+    ) {
+      throw new Error('rnx ios --cloud creates a new simulator and cannot target --sim')
+    }
+    if (arg.startsWith('-')) {
+      throw new Error(`rnx ios --cloud does not support ${arg}`)
+    }
+    positional.push(arg)
+  }
+  if (positional.length !== 1) {
+    throw new Error('usage: rnx ios --cloud <local bundle.js> [--device <model>]')
+  }
+  return positional[0] ?? null
+}
+
 export async function runPlatformCommand(
   platform: RuntimePlatform,
   args: string[],
@@ -34,6 +65,7 @@ export async function runPlatformCommand(
   // contradiction shows up here as a platform mismatch. refuse it by name
   // rather than silently overriding whichever one the user meant.
   const explicitDevice = args.find((_, i) => args[i - 1] === '--device')
+  let selectedDevice: DeviceModel
   if (explicitDevice !== undefined) {
     if (!isDeviceModel(explicitDevice)) {
       console.error(
@@ -53,6 +85,7 @@ export async function runPlatformCommand(
       )
       return 1
     }
+    selectedDevice = explicitDevice
   } else {
     // keep the user's own device when it already belongs to the platform they
     // asked for, so `rnx ios` after `rnx device set iphone-16` does not
@@ -60,6 +93,64 @@ export async function runPlatformCommand(
     const current = settingsStore.get('deviceModel')
     if (getRuntimePlatform(current) !== platform) {
       settingsStore.apply({ deviceModel: DEFAULT_DEVICE_BY_PLATFORM[platform] })
+      selectedDevice = DEFAULT_DEVICE_BY_PLATFORM[platform]
+    } else {
+      selectedDevice = current
+    }
+  }
+
+  if (args.includes('--cloud')) {
+    if (platform !== 'ios') {
+      console.error(
+        `  ${rnxPublicBrand.commandName} android --cloud is not available; RNX Cloud currently supports iOS`,
+      )
+      return 1
+    }
+    try {
+      const bundlePath = cloudBundleFromArgs(args)
+      if (!bundlePath) throw new Error('rnx ios --cloud requires a local bundle.js')
+      const {
+        publishCloudSessionToShell,
+        readCloudSession,
+        requireCloudSessionShellUpdate,
+      } = await import('../cloud-session')
+      if (readCloudSession()) {
+        throw new Error(
+          'this shell already has an RNX Cloud simulator; run `rnx close` or create the next simulator in another shell',
+        )
+      }
+      const descriptor = requireCloudSessionShellUpdate()
+      const { authHeaderOrExit } = await import('../auth')
+      const { closeCloudSimulator, createCloudSimulator } =
+        await import('../cloud-client')
+      const { header } = authHeaderOrExit('ios --cloud')
+      const created = await createCloudSimulator({
+        bundlePath,
+        device: selectedDevice,
+        authorization: header,
+      })
+      try {
+        publishCloudSessionToShell(created.session, descriptor)
+      } catch (error) {
+        await closeCloudSimulator(created.session)
+        throw error
+      }
+      const receipt = created.receipt
+      console.log(`  cloud sim: ${receipt.simId}`)
+      console.log(`  artifact: ${receipt.artifact.id} (${receipt.artifact.bytes} bytes)`)
+      console.log(`  claim expires: ${receipt.claim.expiresAt}`)
+      console.log(
+        '  reads: describe, find, get tree|node|count, wait ready|selector, logs, state, screenshot',
+      )
+      return 0
+    } catch (error) {
+      rethrowIfExit(error)
+      console.error(
+        `  ${rnxPublicBrand.commandName} ios --cloud failed: ${
+          error instanceof Error ? error.message : String(error)
+        }`,
+      )
+      return 1
     }
   }
 

package/cli/commands/record.ts

@@ -1,6 +1,6 @@
 // rnx record — drives the engine's built-in canvas recorder over
 // the WS bridge. no playwright, no ffmpeg. encoding happens in the
-// running sootsim page (webm via MediaRecorder, mp4 via WebCodecs, gif
+// running rnx page (webm via MediaRecorder, mp4 via WebCodecs, gif
 // via gifenc, raw png frames via a shared bitmap sampler).
 
 import {
@@ -180,7 +180,7 @@ function readRepoScope(args: string[]): RepoScope {
 
 export async function runRecord(args: string[], opts: RecordOptions) {
   // note: `--help` / `-h` never reach here — bin.ts intercepts them and
-  // renders the registry-driven help page (packages/sootsim-skills meta.ts).
+  // renders the registry-driven help page (packages/rnx-skills meta.ts).
 
   const sub = findRecordSubcommand(args)
   if (sub) {
@@ -583,7 +583,7 @@ async function assertRecorderAvailable(bridge: WsBridge) {
 
 // frame-capturing recordings (video / gif / png / combined) drive their
 // encoder off requestAnimationFrame and throttled timers, which browsers
-// clamp to ~1fps when the sootsim tab is hidden (backgrounded, or its chrome
+// clamp to ~1fps when the rnx tab is hidden (backgrounded, or its chrome
 // window minimized). that silently produced a frozen-looking file and is
 // exactly why agents started pre-checking `document.hidden` by hand. refuse
 // up front with an actionable message instead. checkSimHealth already emits

package/cli/commands/report-issue.ts

@@ -1,4 +1,4 @@
-// sootsim report-issue — submit an explicitly approved compatibility report.
+// rnx report-issue — submit an explicitly approved compatibility report.
 
 import { existsSync, readFileSync } from 'node:fs'
 import { resolve } from 'node:path'

package/cli/commands/runtime.ts

@@ -136,7 +136,7 @@ async function activateVersion(version: string) {
   const notified = await tellDaemonRuntimeChanged(version)
   if (!notified) {
     console.log(
-      `  (no daemon running — next sootsim/electron launch will pick up ${version})`,
+      `  (no daemon running — next rnx/electron launch will pick up ${version})`,
     )
   }
 }

package/cli/commands/screenshot-mode.ts

@@ -1,5 +1,5 @@
 // rnx mode screenshot — toggle the "screenshot mode" chrome overlay
-// in the running sootsim sim. orthogonal to `--no-shell` on the
+// in the running rnx sim. orthogonal to `--no-shell` on the
 // `screenshot` command: this hides the DOM browser chrome (rail, menubar,
 // window controls) while still rendering the iOS shell inside the canvas.
 //

package/cli/commands/screenshot.ts

@@ -13,6 +13,7 @@ import { launchReapedChrome } from '../../../../scripts/lib/reap-browser'
 import { DEFAULT_SOOTSIM_BRIDGE_PORT } from '../../src/bridge-constants'
 import { composeFramedScreenshot } from '../../src/screenshots/frame-compose'
 import { buildResolveRectEval, type SampleRect } from '../browser-evals'
+import { createCloudBridgeForParsed } from '../cloud-client'
 import { rnxExit } from '../run-rnx'
 import {
   callInBridge,
@@ -120,6 +121,30 @@ examples:
     stripValueFlags: ['--output', '--area', '--id', '--text'],
   })
   const outputArg = resolveOutputPath(args)
+  const cloudBridge = createCloudBridgeForParsed(parsed)
+  if (cloudBridge) {
+    try {
+      const dataUrl: unknown = await cloudBridge.send({ type: 'screenshot' })
+      const pngPrefix = 'data:image/png;base64,'
+      if (typeof dataUrl !== 'string' || !dataUrl.startsWith(pngPrefix)) {
+        throw new Error('RNX Cloud screenshot returned invalid image data')
+      }
+      const outputPath = resolve(process.cwd(), outputArg || '/tmp/rnx-inspect.png')
+      mkdirSync(dirname(outputPath), { recursive: true })
+      const png = Buffer.from(dataUrl.slice(pngPrefix.length), 'base64')
+      if (png.length === 0) throw new Error('RNX Cloud screenshot returned no image data')
+      writeFileSync(outputPath, png)
+      console.log(`  saved: ${outputPath}`)
+    } catch (error) {
+      console.error(
+        `  screenshot failed: ${error instanceof Error ? error.message : String(error)}`,
+      )
+      rnxExit(1)
+    } finally {
+      cloudBridge.close()
+    }
+    return
+  }
   const rect = await parseRect(args)
   const usingBridge = await probeBridge(parsed.wsPort)
 

package/cli/commands/serve.ts

@@ -56,7 +56,7 @@ examples:
   }
   const quiet = args.includes('--quiet') || args.includes('-q')
 
-  // only one bridge per sootsim home. refuse to start a second one
+  // only one bridge per rnx home. refuse to start a second one
   // regardless of requested port, since both would try to write the same
   // daemon.json and electron/cli clients only read one lockfile.
   const existingLock = readDaemonLockfile()

package/cli/commands/skills.ts

@@ -216,7 +216,7 @@ function symlinkPointsTo(dest: string, src: string): boolean {
 }
 
 // a store entry left by an older CLI is safe to upgrade: either a real dir
-// whose only content is a SKILL.md symlink into a sootsim skills source (the
+// whose only content is a SKILL.md symlink into an rnx skills source (the
 // pre-dir-layout install — possibly broken after the source moved), or a dir
 // holding a byte-identical copy of the skill. only our installer creates
 // those shapes, so replacing them can't lose user work.

package/cli/commands/timeline.ts

@@ -2,7 +2,7 @@
 //
 // `rnx record` is for video/screen capture; `rnx debug record` is
 // for the engine-internal debug-channel ring; this command is the third
-// surface and explicitly distinct: it manages SootSim.bridges.timeline,
+// surface and explicitly distinct: it manages the SootSim.bridges.timeline API,
 // the unified, agent-facing semantic event stream across host / shell
 // worker / tenant worker.
 //

package/cli/commands/upgrade.ts

@@ -10,12 +10,15 @@ import { compareSemver } from '@contrast/runtime-delivery'
 import { getCliVersion } from '../../src/cli-version'
 import { isSootsimDevCheckout, readActiveRuntime, runtimeDir } from '../../src/home-paths'
 import { resolveRNXAppConfig } from '../app-config'
+import {
+  DEFAULT_CLI_RELEASE_ORIGIN,
+  fetchCliReleaseFile,
+  refreshCliUpdateCache,
+} from '../cli-update'
 import { fetchRuntimeReleaseNotes, formatRuntimeReleaseNotes } from '../runtime-notes'
 import { IS_STANDALONE } from '../standalone'
 import { runRuntime } from './runtime'
 
-const DEFAULT_CLI_RELEASE_ORIGIN = 'https://r2.rnxsim.com/rnx-cli'
-const CLI_VERSION_PATTERN = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/
 const SHA256_PATTERN = /^[a-f0-9]{64}$/
 
 export interface UpgradeOptions {
@@ -100,14 +103,7 @@ export async function upgradeCli(options: UpgradeOptions = {}): Promise<void> {
     '',
   )
   const current = getCliVersion()
-  const latest = (await fetchRequired(`${releaseOrigin}/channels/stable`, 8_000))
-    .toString('utf8')
-    .trim()
-  if (!CLI_VERSION_PATTERN.test(latest)) {
-    throw new Error(
-      `rnx update service returned an invalid version: ${latest || '(empty)'}`,
-    )
-  }
+  const { latestVersion: latest } = await refreshCliUpdateCache({ releaseOrigin })
   if (compareSemver(latest, current) <= 0) {
     console.log(`  v${current} (latest)`)
     return
@@ -115,7 +111,7 @@ export async function upgradeCli(options: UpgradeOptions = {}): Promise<void> {
 
   const artifact = cliArtifactName()
   const artifactUrl = `${releaseOrigin}/${latest}/${artifact}`
-  const expectedSha = (await fetchRequired(`${artifactUrl}.sha256`, 8_000))
+  const expectedSha = (await fetchCliReleaseFile(`${artifactUrl}.sha256`, 8_000))
     .toString('utf8')
     .trim()
   if (!SHA256_PATTERN.test(expectedSha)) {
@@ -124,7 +120,7 @@ export async function upgradeCli(options: UpgradeOptions = {}): Promise<void> {
 
   console.log(`  v${current} → v${latest}`)
   console.log(`  downloading ${artifact}...`)
-  const executable = await fetchRequired(artifactUrl, 120_000)
+  const executable = await fetchCliReleaseFile(artifactUrl, 120_000)
   const actualSha = createHash('sha256').update(executable).digest('hex')
   if (actualSha !== expectedSha) {
     throw new Error(
@@ -157,28 +153,6 @@ function cliArtifactName(): string {
   return `rnx-${platform}-${process.arch}`
 }
 
-async function fetchRequired(url: string, timeoutMs: number): Promise<Buffer> {
-  let response: Response
-  try {
-    response = await fetch(url, {
-      headers: { accept: 'application/octet-stream' },
-      signal: AbortSignal.timeout(timeoutMs),
-    })
-  } catch (error) {
-    throw new Error(
-      `could not reach the rnx update service: ${
-        error instanceof Error ? error.message : String(error)
-      }`,
-    )
-  }
-  if (!response.ok) {
-    throw new Error(
-      `rnx update download failed: ${response.status} ${response.statusText}`,
-    )
-  }
-  return Buffer.from(await response.arrayBuffer())
-}
-
 function verifyCandidate(candidatePath: string, expectedVersion: string): void {
   const result = spawnSync(candidatePath, ['--version'], {
     encoding: 'utf8',

package/cli/commands/upload.ts

@@ -1,5 +1,5 @@
 // rnx record upload — capture the currently-loaded bundle + device spec from
-// a running sootsim sim and POST it to the Contrast upload endpoint. returns a
+// a running rnx sim and POST it to the Contrast upload endpoint. returns a
 // /preview/<id> url that anyone can open to load this bundle in a frame.
 //
 // uploads are unlisted-public (unguessable id) but require a signed-in
@@ -29,7 +29,7 @@ import { openUrl } from '../open-url'
 import { resolveRunProvenance } from '../run-registry'
 import { rnxExit } from '../run-rnx'
 import { createBridgeFromParsed, evalInBridge, parseBridgeCliArgs } from '../ws-bridge'
-import type { SootSimTimelineEvent } from '@sootsim/globals'
+import type { SootSimTimelineEvent } from '@rnx/globals'
 
 interface UploadOptions {
   port?: number
@@ -110,7 +110,7 @@ function readSnapshotManifest(manifestPath: string): AttachedInteractionSnapshot
 
 const REMOTE_DEFAULT_ORIGIN = process.env.RNX_UPLOAD_ORIGIN || 'https://contrast.dev'
 // the canonical public preview link. Uploads go to the contrast backend, but
-// reviewers/users open SootSim preview pages on sootsim.com.
+// reviewers/users open rnx preview pages on rnxsim.com.
 const REMOTE_DEFAULT_PUBLIC_PREVIEW_ORIGIN =
   process.env.RNX_PREVIEW_ORIGIN || rnxPublicBrand.origin
 export async function resolveDefaultUploadOrigin(

package/cli/commands/version.ts

@@ -1,9 +1,9 @@
 // rnx version — one overview of both halves you're running.
 //
-// the `sootsim` CLI (npm package) and the engine runtime (versioned tarball
+// the rnx CLI and the engine runtime (versioned tarball
 // rendered in the browser/electron shell) are versioned independently, which
 // is a frequent "I upgraded but the version didn't change" trap. the terse
-// `sootsim --version` flag prints both for scripts; this command adds the
+// `rnx --version` flag prints both for scripts; this command adds the
 // channel, a "newer runtime available" hint, and a what's-new pointer.
 
 import fs from 'node:fs'
@@ -12,9 +12,14 @@ import { getCliVersion } from '../../src/cli-version'
 import { runtimeDir } from '../../src/home-paths'
 import { RNX_CHANGELOG_URL, rnxRuntime } from '../../src/runtime-delivery'
 import { resolveRNXAppConfig } from '../app-config'
+import { readCachedCliUpdate, refreshCliUpdateCache } from '../cli-update'
 import { getRuntimeSummary } from '../runtime-summary'
+import { IS_STANDALONE } from '../standalone'
 
 export async function runVersion(_args: string[]): Promise<void> {
+  const cliUpdatePromise = IS_STANDALONE
+    ? refreshCliUpdateCache().catch(() => readCachedCliUpdate())
+    : Promise.resolve(null)
   const { IS_BETA, BETA_LABEL } = await import('../../src/beta')
   const suffix = IS_BETA ? ` · ${BETA_LABEL}` : ''
   console.log(`rnx v${getCliVersion()}${suffix}`)
@@ -43,7 +48,13 @@ export async function runVersion(_args: string[]): Promise<void> {
   }
 
   // best-effort network check; never fail the command on a flaky network.
-  const check = await rnxRuntime.checkUpToDate({ channel })
+  const [check, cliUpdate] = await Promise.all([
+    rnxRuntime.checkUpToDate({ channel }),
+    cliUpdatePromise,
+  ])
+  if (cliUpdate?.outdated) {
+    console.log(`\n  ↑ CLI v${cliUpdate.latestVersion} available; run \`rnx upgrade\``)
+  }
   if (check.outdated && check.latest) {
     console.log(`\n  ↑ default runtime v${check.latest} available; run \`rnx upgrade\``)
   }

package/cli/commands/what-happened.ts

@@ -1,6 +1,6 @@
 // rnx what-happened — show recent events from the semantic timeline
 //
-// the agent-facing read verb for SootSim.bridges.timeline. by default
+// the agent-facing read verb for the SootSim.bridges.timeline API. by default
 // shows everything since the previous CLI call from the same agent
 // identity (cursor model). after rendering, advances the cursor past
 // the events it displayed so the next call shows only new events.
@@ -25,7 +25,7 @@ import {
   inspectTimelineSummary,
   NOISY_TIMELINE_KINDS,
 } from './inspect/core'
-import type { SootSimTimelineEvent, SootSimTimelineQuery } from '@sootsim/globals'
+import type { SootSimTimelineEvent, SootSimTimelineQuery } from '@rnx/globals'
 
 interface WhatHappenedOptions {
   port?: number

package/cli/current-sim.ts

@@ -1,13 +1,15 @@
-import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'fs'
+import { existsSync, readFileSync, rmSync } from 'fs'
 import { tmpdir } from 'os'
-import { dirname, join, resolve } from 'path'
+import { basename, dirname, join, resolve } from 'path'
 import { getParentPid, getProcessComm } from './parent-pid'
+import { writeSecureJsonAtomic } from './secure-file'
 
-const CURRENT_SIM_VERSION = 1 as const
+const CURRENT_SIM_VERSION = 2 as const
 const CURRENT_SIM_PATH_ENV = 'SOOTSIM_CLI_CURRENT_SIM_PATH'
 
-interface CurrentSimState {
-  version: 1
+export interface LocalCurrentTarget {
+  version: 2
+  plane: 'local'
   simId: string
   updatedAt: string
 }
@@ -148,55 +150,66 @@ export function getCurrentSimPath() {
   return join(tmpdir(), `rnx-current-sim-${key}.json`)
 }
 
-export function readCurrentSim(): CurrentSimState | null {
+function legacyCloudCredentialDirectory(filepath: string): string {
+  return join(dirname(filepath), `${basename(filepath)}.credentials`)
+}
+
+export function readCurrentTarget(): LocalCurrentTarget | null {
   const filepath = getCurrentSimPath()
+  rmSync(legacyCloudCredentialDirectory(filepath), { recursive: true, force: true })
   if (!existsSync(filepath)) return null
 
   try {
-    const parsed = JSON.parse(readFileSync(filepath, 'utf8')) as Partial<CurrentSimState>
+    const parsed: unknown = JSON.parse(readFileSync(filepath, 'utf8'))
+    if (parsed === null || typeof parsed !== 'object') {
+      rmSync(filepath, { force: true })
+      return null
+    }
+    const version = Reflect.get(parsed, 'version')
+    const plane = Reflect.get(parsed, 'plane')
+    const simId = Reflect.get(parsed, 'simId')
+    const updatedAt = Reflect.get(parsed, 'updatedAt')
     if (
-      parsed.version !== CURRENT_SIM_VERSION ||
-      typeof parsed.simId !== 'string' ||
-      !parsed.simId.trim() ||
-      typeof parsed.updatedAt !== 'string'
+      (version !== 1 && version !== CURRENT_SIM_VERSION) ||
+      (version === CURRENT_SIM_VERSION && plane !== 'local') ||
+      typeof simId !== 'string' ||
+      !simId.trim() ||
+      typeof updatedAt !== 'string'
     ) {
       rmSync(filepath, { force: true })
       return null
     }
 
-    return {
+    const target = {
       version: CURRENT_SIM_VERSION,
-      simId: parsed.simId.trim(),
-      updatedAt: parsed.updatedAt,
-    }
+      plane: 'local',
+      simId: simId.trim(),
+      updatedAt,
+    } satisfies LocalCurrentTarget
+    if (version === 1) writeSecureJsonAtomic(filepath, target)
+    return target
   } catch {
     rmSync(filepath, { force: true })
     return null
   }
 }
 
+export const readCurrentSim = readCurrentTarget
+
 export function readCurrentSimId() {
-  return readCurrentSim()?.simId || null
+  return readCurrentTarget()?.simId ?? null
 }
 
 export function saveCurrentSimId(simId: string) {
   const normalized = simId.trim()
   if (!normalized) return
 
-  const filepath = getCurrentSimPath()
-  mkdirSync(dirname(filepath), { recursive: true })
-  writeFileSync(
-    filepath,
-    JSON.stringify(
-      {
-        version: CURRENT_SIM_VERSION,
-        simId: normalized,
-        updatedAt: new Date().toISOString(),
-      } satisfies CurrentSimState,
-      null,
-      2,
-    ) + '\n',
-  )
+  writeSecureJsonAtomic(getCurrentSimPath(), {
+    version: CURRENT_SIM_VERSION,
+    plane: 'local',
+    simId: normalized,
+    updatedAt: new Date().toISOString(),
+  } satisfies LocalCurrentTarget)
 }
 
 export function clearCurrentSimId() {

package/cli/desktop-companion.ts

@@ -241,7 +241,7 @@ export interface LaunchCompanionOptions {
   profileId?: string
   ephemeralProfile?: boolean
   // set by `rnx open`, whose native window belongs to the launching
-  // session. `sootsim desktop` omits it and remains a persistent desktop app.
+  // session. `rnx desktop` omits it and remains a persistent desktop app.
   ownerPid?: number
 }
 

package/cli/drivers/electron.ts

@@ -1,5 +1,5 @@
 // electron driver — wraps the existing desktop-companion helper. availability
-// is "is the sootsim desktop app installed on this machine". launch delegates
+// is "is the rnx desktop app installed on this machine". launch delegates
 // to launchDesktopCompanion, which already handles mac `open -a`, linux
 // AppImage, and the --device seed.
 

package/cli/drivers/playwright.ts

@@ -9,7 +9,7 @@
 // returns the moment the sim connects, and playwright tears its browser
 // down when the launching process exits. an in-process launch would mean
 // the sim vanished the instant `open` finished. the detached host keeps the
-// test browser alive until the sim's page closes (e.g. via `sootsim close`).
+// test browser alive until the sim's page closes (e.g. via `rnx close`).
 
 import { spawn } from 'child_process'
 import { closeSync, mkdtempSync, openSync, readFileSync } from 'fs'
@@ -286,7 +286,7 @@ const cleanupProfile = () => {
   // we are spawned detached + unref'd so \`rnx open\` returns immediately,
   // which means nothing in the OS process tree ties Chrome's lifetime to the
   // session that asked for it. once the sim connects, the connect-timeout
-  // safety net is cleared, so absent an explicit \`sootsim close\` (or the
+  // safety net is cleared, so absent an explicit \`rnx close\` (or the
   // daemon's idle reaper closing the sim socket) the host would hold Chrome
   // open forever after its owner exits. poll the owning session's pid and tear
   // down when it's gone. ESRCH (kill throws) = owner exited; EPERM = alive but
@@ -601,7 +601,7 @@ async function launch(opts: DriverLaunchOptions): Promise<DriverLaunchResult> {
   const connectAckFile = `${errLog}.connected`
   const errFd = openSync(errLog, 'a')
   try {
-    // spawn the browser host detached so Chrome outlives `sootsim
+    // spawn the browser host detached so Chrome outlives `rnx
     // open`. stdout is dropped; stderr is captured to errLog so an early
     // crash (bad profile dir, missing browser binary) produces a real
     // message instead of a silent "timed out waiting for sim".

package/cli/drivers/types.ts

@@ -1,4 +1,4 @@
-// driver / runner abstraction for sootsim. browser sims run in an isolated
+// driver / runner abstraction for rnx. browser sims run in an isolated
 // playwright-owned profile. electron remains the native desktop surface.
 
 export type DriverId = 'electron' | 'playwright'
@@ -29,7 +29,7 @@ export interface DriverLaunchOptions {
   url?: string
   // run in headless mode where the driver supports it. ignored by electron.
   headless?: boolean
-  // initial device model seed forwarded to the sootsim shell. the electron
+  // initial device model seed forwarded to the rnx shell. the electron
   // driver forwards it via argv (--device=<model>); browser drivers receive
   // it already stamped on the URL (?device=<model>) by runOpenCommand.
   device?: string
@@ -51,7 +51,7 @@ export interface DriverLaunchOptions {
   // stable pid for the session that owns a CLI-opened host. electron closes
   // only that session's windows when the owner exits; playwright requires it
   // so a detached browser can never outlive its session. omitted only for the
-  // persistent `sootsim desktop` app lifecycle.
+  // persistent `rnx desktop` app lifecycle.
   ownerPid?: number
   // expose Chrome's remote-debugging endpoint on this port so a
   // bridge-driven sim can also be cpu-profiled. only the playwright driver
@@ -60,7 +60,7 @@ export interface DriverLaunchOptions {
   // maximum time the detached host should wait for the launched sim to
   // register with the bridge before it tears itself down.
   connectTimeoutMs?: number
-  // the sootsim WS bridge port the launched sim page should register with,
+  // the rnx WS bridge port the launched sim page should register with,
   // injected as window.__sootsimBridgePort. load-bearing when the dev bridge
   // drifted off the shell-port-implied default (e.g. :7668 taken at the shell's
   // boot -> bridge on :7669 while the shell kept :5173): the page's own

package/cli/flow-file.ts

@@ -9,7 +9,7 @@ export interface FlowFrontmatter {
   // theme-sensitive; a dark capture can never match a light baseline)
   theme?: 'light' | 'dark'
   electron?: boolean
-  // maestro-compatible: appId is accepted but not used by sootsim (ios bundle id)
+  // maestro-compatible: appId is accepted but not used by rnx (ios bundle id)
   appId?: string
   // maestro-compatible: flow-level env vars, defined into the flow's JS
   // context before the first step runs
@@ -20,10 +20,10 @@ export interface FlowFrontmatter {
 
 // parse flow file. accepts three shapes:
 //   1. plain yaml array of steps (no frontmatter)
-//   2. sootsim style: ---\n<fm>\n---\n<steps>
+//   2. rnx style: ---\n<fm>\n---\n<steps>
 //   3. maestro style: <fm>\n---\n<steps>   (multi-doc yaml, fm first)
 // maestro compat matters because real users have real .maestro/*.yaml files
-// and shouldn't have to rewrite them to drive sootsim.
+// and shouldn't have to rewrite them to drive rnx.
 //
 // `${...}` templates are NOT resolved here — interpolation happens per-step
 // at execution time in the flow runner's JS context (matching maestro), so