rnxsim 0.1.375 → 0.1.377

package/src/home-paths.ts

@@ -1,8 +1,8 @@
-// canonical filesystem layout under ~/.sootsim/. shared by the CLI and the
+// canonical filesystem layout under ~/.rnx/. shared by the CLI and the
 // electron main process so every surface agrees where runtimes, the daemon
 // lockfile, and caches live.
 //
-//   ~/.sootsim/
+//   ~/.rnx/
 //   ├── runtimes/
 //   │   ├── <version>/     unpacked dist/ of sootsim-engine
 //   │   └── active         text file with the active version string (win-safe
@@ -12,7 +12,7 @@
 //   ├── profiles/
 //   │   └── profiles.json  storage profile metadata
 //   ├── cache/
-//   │   └── sootsim-runtime-<version>.tar.gz
+//   │   └── rnx-runtime-<version>.tar.gz
 //   ├── daemon.json        lockfile: pid, ports, active runtime, heartbeat
 //   ├── dev-bridges/       live Vite dev bridge records, keyed by bound port
 //   ├── runtime-upgraded.json  one-shot notice written by the daemon's
@@ -28,17 +28,17 @@ import fs from 'node:fs'
 import { homedir } from 'node:os'
 import path from 'node:path'
 
-export const SOOTSIM_HOME_ENV = 'SOOTSIM_HOME'
+export const RNX_HOME_ENV = 'RNX_HOME'
 export const ACTIVE_RUNTIME_FILE = 'active'
 export const DAEMON_LOCKFILE = 'daemon.json'
 export const DEV_BRIDGES_DIR = 'dev-bridges'
 export const CONFIG_FILE = 'config.json'
 export const DAEMON_HEARTBEAT_STALE_MS = 30_000
 
-export function sootsimHomeDir(): string {
-  const override = process.env[SOOTSIM_HOME_ENV]
+export function rnxHomeDir(): string {
+  const override = process.env[RNX_HOME_ENV]
   if (override && override.length > 0) return path.resolve(override)
-  return path.join(homedir(), '.sootsim')
+  return path.join(homedir(), '.rnx')
 }
 
 // detect when sootsim is running from a source checkout (the Contrast monorepo)
@@ -101,7 +101,7 @@ export function shouldSkipPersistentDaemon(): boolean {
 }
 
 export function runtimesDir(): string {
-  return path.join(sootsimHomeDir(), 'runtimes')
+  return path.join(rnxHomeDir(), 'runtimes')
 }
 
 export function runtimeDir(version: string): string {
@@ -113,7 +113,7 @@ export function activeRuntimeFile(): string {
 }
 
 export function electronDir(): string {
-  return path.join(sootsimHomeDir(), 'electron')
+  return path.join(rnxHomeDir(), 'electron')
 }
 
 export function electronUserDataDir(): string {
@@ -125,14 +125,14 @@ export function electronVersionDir(version: string): string {
 }
 
 export function profilesDir(): string {
-  return path.join(sootsimHomeDir(), 'profiles')
+  return path.join(rnxHomeDir(), 'profiles')
 }
 
 // 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 {
-  return path.join(sootsimHomeDir(), 'camera-fixtures')
+  return path.join(rnxHomeDir(), 'camera-fixtures')
 }
 
 // the launchd-managed daemon spawns ProgramArguments[0] directly, and macOS
@@ -142,27 +142,27 @@ export function cameraFixturesDir(): string {
 // an ad-hoc-signed .app bundle here gives BTM a CFBundleDisplayName to
 // read instead.
 export function daemonAppDir(): string {
-  return path.join(sootsimHomeDir(), 'daemon-app')
+  return path.join(rnxHomeDir(), 'daemon-app')
 }
 
 export function daemonAppBundlePath(): string {
-  return path.join(daemonAppDir(), 'SootSim Daemon.app')
+  return path.join(daemonAppDir(), 'RNX Daemon.app')
 }
 
 export function daemonAppLauncherPath(): string {
-  return path.join(daemonAppBundlePath(), 'Contents', 'MacOS', 'sootsim-daemon')
+  return path.join(daemonAppBundlePath(), 'Contents', 'MacOS', 'rnx-daemon')
 }
 
 export function cacheDir(): string {
-  return path.join(sootsimHomeDir(), 'cache')
+  return path.join(rnxHomeDir(), 'cache')
 }
 
 export function daemonLockfilePath(): string {
-  return path.join(sootsimHomeDir(), DAEMON_LOCKFILE)
+  return path.join(rnxHomeDir(), DAEMON_LOCKFILE)
 }
 
 export function devBridgesDir(): string {
-  return path.join(sootsimHomeDir(), DEV_BRIDGES_DIR)
+  return path.join(rnxHomeDir(), DEV_BRIDGES_DIR)
 }
 
 export function devBridgeLockfilePath(bridgePort: number): string {
@@ -173,12 +173,12 @@ export function devBridgeLockfilePath(bridgePort: number): string {
 }
 
 export function configFilePath(): string {
-  return path.join(sootsimHomeDir(), CONFIG_FILE)
+  return path.join(rnxHomeDir(), CONFIG_FILE)
 }
 
-// --- shared sootsim config -----------------------------------------------
+// --- shared rnx config ---------------------------------------------------
 //
-// ~/.sootsim/config.json is the single user-level config file every sootsim
+// ~/.rnx/config.json is the single user-level config file every rnx
 // surface (cli, electron renderer, dev browser via electron ipc) agrees on.
 //
 // privacy preferences live in the nested settings object so the cli, desktop
@@ -207,7 +207,7 @@ export function readSharedConfig(): SharedConfig {
  *  objects (currently just `settings`) are shallow-merged so partial writes
  *  don't clobber unrelated fields. returns the new full snapshot. */
 export function writeSharedConfig(patch: Partial<SharedConfig>): SharedConfig {
-  ensureSootsimHome()
+  ensureRnxHome()
   const current = readSharedConfig()
   const next: SharedConfig = { ...current, ...patch }
   if (patch.settings && typeof patch.settings === 'object') {
@@ -300,11 +300,11 @@ export interface RuntimeUpgradeNotice {
 }
 
 export function runtimeUpgradeNoticePath(): string {
-  return path.join(sootsimHomeDir(), 'runtime-upgraded.json')
+  return path.join(rnxHomeDir(), 'runtime-upgraded.json')
 }
 
 export function writeRuntimeUpgradeNotice(notice: RuntimeUpgradeNotice): void {
-  ensureSootsimHome()
+  ensureRnxHome()
   const tmp = `${runtimeUpgradeNoticePath()}.tmp`
   fs.writeFileSync(tmp, `${JSON.stringify(notice)}\n`, 'utf8')
   fs.renameSync(tmp, runtimeUpgradeNoticePath())
@@ -328,8 +328,8 @@ export function consumeRuntimeUpgradeNotice(): RuntimeUpgradeNotice | null {
   }
 }
 
-export function ensureSootsimHome(): void {
-  fs.mkdirSync(sootsimHomeDir(), { recursive: true })
+export function ensureRnxHome(): void {
+  fs.mkdirSync(rnxHomeDir(), { recursive: true })
   fs.mkdirSync(runtimesDir(), { recursive: true })
   fs.mkdirSync(electronDir(), { recursive: true })
   fs.mkdirSync(profilesDir(), { recursive: true })
@@ -434,7 +434,7 @@ interface DaemonClaim {
 export function readDaemonLockfile(): DaemonLockfile | null {
   try {
     // cap the read so a junk/large file on the lockfile path can't OOM
-    // the CLI when someone has been messing with ~/.sootsim/.
+    // the CLI when someone has been messing with ~/.rnx/.
     const fd = fs.openSync(daemonLockfilePath(), 'r')
     try {
       const buf = Buffer.alloc(DAEMON_LOCKFILE_MAX_BYTES)
@@ -577,7 +577,7 @@ export function readLiveRuntimeVersions(): string[] {
 }
 
 export function writeDaemonLockfile(data: DaemonLockfile): void {
-  ensureSootsimHome()
+  ensureRnxHome()
   const lockfilePath = daemonLockfilePath()
   const existing = readDaemonLockfile()
   if (!existing) {
@@ -723,7 +723,7 @@ function releaseDaemonClaim(owner: Pick<DaemonLockfile, 'pid' | 'startedAt'>): v
  *  process-owned election file serializes concurrent fallback-port binds;
  *  the complete lock snapshot is then installed with an exclusive hard link. */
 export function claimDaemonLockfile(data: DaemonLockfile): boolean {
-  ensureSootsimHome()
+  ensureRnxHome()
   if (!acquireDaemonClaim(data)) return false
   try {
     const existing = readDaemonLockfile()

package/src/host/bridge-host.ts

@@ -16,7 +16,7 @@ import { getCliVersion } from '../cli-version.ts'
 import {
   activeRuntimeDir as getActiveRuntimeDir,
   claimDaemonLockfile,
-  ensureSootsimHome,
+  ensureRnxHome,
   isSootsimDevCheckout,
   readActiveRuntime,
   readSharedConfig,
@@ -28,7 +28,7 @@ import {
   writeRuntimeUpgradeNotice,
   writeSharedConfig,
   cameraFixturesDir,
-  sootsimHomeDir,
+  rnxHomeDir,
   type DaemonLockfile,
   type DevBridgeLockfile,
   type SharedConfig,
@@ -39,7 +39,7 @@ import {
   resolveRuntimeRootForHostname,
   runtimeVersionFromHostname,
 } from '../runtime-assets.ts'
-import { sootsimRuntime } from '../runtime-delivery.ts'
+import { rnxRuntime } from '../runtime-delivery.ts'
 import { AgentHost, type AgentHostOptions } from './agent-host.ts'
 import {
   handleAppApiRequest,
@@ -226,13 +226,13 @@ export interface BridgeHostOptions {
   /** try preferred port, then port+1, port+2, …, up to this many attempts
    *  before giving up. defaults to 10. set 1 to disable fallback. */
   portFallbackCount?: number
-  /** when true, write ~/.sootsim/daemon.json on successful bind + update
+  /** when true, write ~/.rnx/daemon.json on successful bind + update
    *  it on a heartbeat interval + remove it on close. only the standalone
    *  `sootsim serve` process should set this — tests, vite plugin, and
    *  anything embedded should leave it off to avoid clobbering a real
    *  daemon's lockfile. defaults to false. */
   writeLockfile?: boolean
-  /** when true, write an owner-scoped record under ~/.sootsim/dev-bridges on
+  /** when true, write an owner-scoped record under ~/.rnx/dev-bridges on
    *  successful bind, update it on a heartbeat interval, and remove only that
    *  record on close. the Vite dev shell sets this so local CLI commands can
    *  address every live source bridge without concurrent worktrees replacing
@@ -303,7 +303,7 @@ const HTTP_MIME_TYPES: Record<string, string> = {
   '.mov': 'video/quicktime',
 }
 
-// `rnx camera play` stages a video under ~/.sootsim/camera-fixtures and the
+// `rnx camera play` stages a video under ~/.rnx/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/'
@@ -313,7 +313,7 @@ const CAMERA_FIXTURE_ROUTE = '/__camera-fixtures/'
 const CAMERA_FIXTURE_NAME_RE = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/
 
 /** inject host-provided globals into the served runtime html:
- *   - `window.__sootsimSharedConfig` — parsed `~/.sootsim/config.json`,
+ *   - `window.__sootsimSharedConfig` — parsed `~/.rnx/config.json`,
  *     read during engine settingsStore module init (see
  *     settings/persistence.ts). mirrors the inject-into-html plugin in the
  *     shell vite dev server so dev and prod surfaces both produce it.
@@ -684,7 +684,7 @@ export class SootSimBridgeHost {
         // are handled in-daemon; install runs entirely inside the CLI so
         // we don't need a daemon-side handler for it.
         if (msg.type === 'runtime:list') {
-          const versions = sootsimRuntime.listInstalled()
+          const versions = rnxRuntime.listInstalled()
           const active = this.getActiveRuntime()
           const reply = {
             type: 'runtime:list:ok',
@@ -700,7 +700,7 @@ export class SootSimBridgeHost {
         }
         if (msg.type === 'runtime:use') {
           const version = typeof msg.version === 'string' ? msg.version : ''
-          const installed = sootsimRuntime.listInstalled()
+          const installed = rnxRuntime.listInstalled()
           if (!installed.includes(version)) {
             try {
               ws.send(
@@ -809,7 +809,7 @@ export class SootSimBridgeHost {
             return
           }
 
-          // write a partial patch into ~/.sootsim/config.json. fired by the
+          // write a partial patch into ~/.rnx/config.json. fired by the
           // engine's settingsStore when a persisted key flips in a browser
           // tab (which has no fs access of its own). after the merge, we
           // broadcast the new full snapshot to every connected sim so any
@@ -1140,7 +1140,7 @@ export class SootSimBridgeHost {
 
     if (this.shouldWriteLockfile) {
       try {
-        ensureSootsimHome()
+        ensureRnxHome()
         // atomic claim: bail if another fresh daemon's lockfile already
         // exists (stale ones are overwritten). last line of defense
         // against two daemons clobbering the same file between the
@@ -1289,7 +1289,7 @@ export class SootSimBridgeHost {
   }
 
   // serves one staged camera fixture. addressed by basename inside
-  // ~/.sootsim/camera-fixtures, never by a caller-supplied path, so there is
+  // ~/.rnx/camera-fixtures, never by a caller-supplied path, so there is
   // no traversal surface to defend: a name that is not a plain basename is
   // rejected outright. range support is not optional here — chrome asks for
   // byte ranges on media and cannot seek or loop a fixture without it.
@@ -1409,14 +1409,14 @@ export class SootSimBridgeHost {
 
   private startRuntimeUpdater() {
     if (!this.shouldWriteLockfile || this.runtimeUpdateTimer) return
-    if (fs.existsSync(path.join(sootsimHomeDir(), 'runtime-update-disabled'))) return
-    // an isolated dev daemon (explicit SOOTSIM_HOME, dev checkout, nothing
+    if (fs.existsSync(path.join(rnxHomeDir(), 'runtime-update-disabled'))) return
+    // an isolated dev daemon (explicit RNX_HOME, dev checkout, nothing
     // staged) serves the repo's public/sootsim build. auto-installing the
     // published runtime here would stage it active and shadow that dev build
     // (runtime-assets prefers a staged runtime under an explicit home), so the
     // daemon would silently validate published code instead of the checkout.
     // local-publish writes the marker above when it stages a source build.
-    if (process.env.SOOTSIM_HOME && isSootsimDevCheckout() && !readActiveRuntime()) {
+    if (process.env.RNX_HOME && isSootsimDevCheckout() && !readActiveRuntime()) {
       return
     }
     void this.runRuntimeUpdate('startup')
@@ -1434,7 +1434,7 @@ export class SootSimBridgeHost {
         if (reason === 'startup') {
           process.stderr.write('rnx: checking for runtime updates…\n')
         }
-        const result = await sootsimRuntime.updateToLatest({
+        const result = await rnxRuntime.updateToLatest({
           protectVersions: this.connectedRuntimeVersions(),
         })
         if (!result.updated || !result.latestVersion) {

package/src/metro-plugin.ts

@@ -1,5 +1,5 @@
 // rnx metro plugin for opt-in dev shell and production bundle integration.
-// shell assets come from an engine runtime under ~/.sootsim/runtimes/, fetched
+// shell assets come from an engine runtime under ~/.rnx/runtimes/, fetched
 // by `rnx runtime install`. ordinary localhost requests
 // follow active; a version-owned localhost origin stays on its exact directory
 // when active changes, so one loaded shell cannot mix runtime chunk trees.
@@ -423,7 +423,7 @@ export function withRNX<T extends Record<string, unknown>>(
     },
   }
 
-  if (appName && !process.env.CI && !process.env.SOOTSIM_NO_OPEN) {
+  if (appName && !process.env.CI && !process.env.RNX_NO_OPEN) {
     void openRnxDesktopWhenMetroIsReady({
       port,
       bundleUrl: resolveRnxDesktopLaunchTarget(port, bundleUrl),

package/src/profiles.ts

@@ -1,6 +1,6 @@
 import fs from 'fs'
 import path from 'path'
-import { electronUserDataDir, ensureSootsimHome, profilesDir } from './home-paths'
+import { electronUserDataDir, ensureRnxHome, profilesDir } from './home-paths'
 
 export const DEFAULT_PROFILE_ID = 'default'
 const PROFILE_INDEX_FILE = 'profiles.json'
@@ -105,7 +105,7 @@ function withDefault(index: ProfileIndex): ProfileIndex {
 }
 
 function writeIndex(index: ProfileIndex): ProfileIndex {
-  ensureSootsimHome()
+  ensureRnxHome()
   const next = withDefault(index)
   const tmp = `${profileIndexPath()}.tmp`
   fs.writeFileSync(tmp, `${JSON.stringify(next, null, 2)}\n`, 'utf8')

package/src/runtime-assets.ts

@@ -1,6 +1,6 @@
 // helpers for serving the installed sootsim engine runtime from framework
 // dev servers. the runtime is managed by `sootsim runtime install` and lives
-// under ~/.sootsim/runtimes/<version>.
+// under ~/.rnx/runtimes/<version>.
 
 import fs from 'fs'
 import path from 'path'
@@ -20,13 +20,13 @@ export const SOOTSIM_RUNTIME_MISSING_MESSAGE =
 // boundary, not a preference or a runtime fallback chain — the check is
 // structural (the monorepo layout is present next to this module) and
 // deterministic (the dev build's files exist). it exists because the daemon and
-// the /__soot plugin otherwise serve ~/.sootsim/runtimes/<active>, a PUBLISHED
+// the /__soot plugin otherwise serve ~/.rnx/runtimes/<active>, a PUBLISHED
 // runtime that `bun dev` never refreshes, so local engine edits are invisible
 // until a manual publish — the silent trap that cost a full night of
 // already-fixed bugs re-reproducing.
 //
 // the isolated CI headless path (scripts/local-publish-runtime.sh) sets
-// SOOTSIM_HOME to a dedicated dir precisely to validate the published-runtime
+// RNX_HOME to a dedicated dir precisely to validate the published-runtime
 // code path; keying off that EXISTING isolation env keeps it (and packaged
 // electron with a custom home) on the installed runtime.
 let _monorepoRootCache: string | null | undefined
@@ -52,16 +52,16 @@ function findMonorepoRoot(): string | null {
 
 /** the fresh dev-stack engine build to serve when running inside the Contrast
  *  monorepo dev checkout, or null when the installed runtime should serve
- *  (published CLI, packaged electron, or an isolated SOOTSIM_HOME). */
+ *  (published CLI, packaged electron, or an isolated RNX_HOME). */
 export function resolveDevCheckoutRuntimeRoot(): string | null {
   // an explicit home that has a STAGED/active runtime is the isolation the
   // CI/local-publish path sets up to validate the installed-runtime code path —
   // honor that staged runtime. an explicit home with NO active runtime is just
-  // an isolated dev daemon (own lockfile, doesn't clobber ~/.sootsim), which
-  // still wants the dev build; and the default home (SOOTSIM_HOME unset) always
+  // an isolated dev daemon (own lockfile, doesn't clobber ~/.rnx), which
+  // still wants the dev build; and the default home (RNX_HOME unset) always
   // does. keying on "explicit home + a runtime deliberately staged there" keeps
   // it structural, not a bespoke toggle.
-  if (process.env.SOOTSIM_HOME && readActiveRuntime()) return null
+  if (process.env.RNX_HOME && readActiveRuntime()) return null
   const root = findMonorepoRoot()
   if (!root) return null
   const devBuild = path.join(root, 'public/sootsim')

package/src/runtime-delivery.ts

@@ -1,9 +1,9 @@
-// sootsim's binding of the shared runtime-delivery machinery.
+// rnx's binding of the shared runtime-delivery machinery.
 //
 // the machinery itself (hosted manifest, sha256-verified tarballs, channels,
 // channel resolution, and auto-update) lives in @contrast/runtime-delivery and
-// knows nothing about sootsim. this file supplies sootsim's identity: ~/.sootsim, the
-// SOOTSIM_* env overrides, and the contrast.dev/runtimes hosting layout.
+// knows nothing about rnx. this file supplies rnx's identity, public env
+// overrides, and the contrast.dev/runtimes hosting layout.
 //
 // @contrast/runtime-delivery is an internal workspace package that is never
 // published, so both the CLI bundle and dist-lib inline it (see the `alias`
@@ -14,7 +14,7 @@ import { createRuntimeDelivery, type RuntimeProduct } from '@contrast/runtime-de
 import {
   cacheDir,
   configFilePath,
-  ensureSootsimHome,
+  ensureRnxHome,
   readActiveRuntime,
   runtimeDir,
   runtimesDir,
@@ -25,12 +25,12 @@ import { rnxPublicBrand } from './public-brand.ts'
 export const DEFAULT_RUNTIME_CDN_ORIGIN = 'https://contrast.dev'
 
 /** the official curated changelog and the machine-readable release feed. the
- *  SootSim site is static, so its /api traffic is owned by contrast.dev. */
-export const SOOTSIM_CHANGELOG_URL = `${rnxPublicBrand.origin}/changelog`
-export const SOOTSIM_CHANGELOG_API_URL = 'https://contrast.dev/api/changelog/sootsim'
+ *  rnx site is static, so its /api traffic is owned by contrast.dev. */
+export const RNX_CHANGELOG_URL = `${rnxPublicBrand.origin}/changelog`
+export const RNX_CHANGELOG_API_URL = 'https://contrast.dev/api/changelog/sootsim'
 
-export const SOOTSIM_RUNTIME_PRODUCT: RuntimeProduct = {
-  id: 'sootsim',
+export const RNX_RUNTIME_PRODUCT: RuntimeProduct = {
+  id: 'rnx',
   defaultCdnOrigin: DEFAULT_RUNTIME_CDN_ORIGIN,
   manifestPath: '/runtimes/manifest.json',
   tarballPath: (version) => `/runtimes/sootsim-runtime-${version}.tar.gz`,
@@ -39,10 +39,10 @@ export const SOOTSIM_RUNTIME_PRODUCT: RuntimeProduct = {
   // vite/metro plugins serve, so its absence means the tarball is not one.
   installedMarker: 'index.html',
   env: {
-    cdnOrigin: 'SOOTSIM_CDN_ORIGIN',
-    channel: 'SOOTSIM_RUNTIME_CHANNEL',
+    cdnOrigin: 'RNX_CDN_ORIGIN',
+    channel: 'RNX_RUNTIME_CHANNEL',
   },
-  ensureHome: ensureSootsimHome,
+  ensureHome: ensureRnxHome,
   configFile: configFilePath,
   runtimesDir,
   runtimeDir,
@@ -51,4 +51,4 @@ export const SOOTSIM_RUNTIME_PRODUCT: RuntimeProduct = {
   writeActiveRuntime,
 }
 
-export const sootsimRuntime = createRuntimeDelivery(SOOTSIM_RUNTIME_PRODUCT)
+export const rnxRuntime = createRuntimeDelivery(RNX_RUNTIME_PRODUCT)

package/src/screenshots/orchestrate.ts

@@ -244,7 +244,7 @@ export async function runScreenshotsPlanFromExistingRaw(
   plan.capture.rawDir = rawDir
   plan.capture.flowPath = null
   plan.capture.fromDir = rawDir
-  const framedDir = path.join(tmpdir(), 'sootsim-screenshots-framed')
+  const framedDir = path.join(tmpdir(), 'rnx-screenshots-framed')
   plan.capture.framedDir = framedDir
   const framedSources = await buildFramedSources(plan)
   const capture = writeCaptureManifest(plan, framedSources, plan.deviceModel)

package/src/screenshots/schema.ts

@@ -246,7 +246,7 @@ export function loadScreenshotsPlan(planPath: string): NormalizedScreenshotsPlan
   const deviceModel = readDeviceModel(root.device, null)
   const captureOutDir = resolvePlanPath(
     planDir,
-    readString(capture.out, path.join('.sootsim', 'screenshots', 'capture')),
+    readString(capture.out, path.join('.rnx', 'screenshots', 'capture')),
   )
   const captureFrom = readOptionalString(capture.from)
   const flowPath = readOptionalString(capture.flow)
@@ -335,7 +335,7 @@ export function loadScreenshotsPlan(planPath: string): NormalizedScreenshotsPlan
     compose: {
       outDir: resolvePlanPath(
         planDir,
-        readString(compose.out, path.join('.sootsim', 'screenshots', 'exports')),
+        readString(compose.out, path.join('.rnx', 'screenshots', 'exports')),
       ),
       locale: readString(compose.locale, 'en'),
       canvases: normalizeCanvasList(compose.canvases),

package/src/skills/builtin/a11y-review.ts

@@ -1,9 +1,9 @@
 // built-in skill: accessibility audit
 
 import { launchReapedChrome } from '../../../../../scripts/lib/reap-browser'
-import type { SootSimSkill } from '../types'
+import type { RNXSkill } from '../types'
 
-export const skill: SootSimSkill = {
+export const skill: RNXSkill = {
   name: 'a11y-review',
   description: 'Check the app for accessibility issues',
   type: 'review',

package/src/skills/builtin/compat-check.ts

@@ -1,8 +1,8 @@
 // built-in skill: package compatibility check
 
-import type { SootSimSkill } from '../types'
+import type { RNXSkill } from '../types'
 
-export const skill: SootSimSkill = {
+export const skill: RNXSkill = {
   name: 'compat-check',
   description: 'Check package compatibility with rnx',
   type: 'review',

package/src/skills/builtin/maestro-test.ts

@@ -1,12 +1,12 @@
 // built-in skill: run Maestro tests against the app
 
-import type { SootSimSkill } from '../types'
+import type { RNXSkill } from '../types'
 
 function sleep(ms: number) {
   return new Promise((resolve) => setTimeout(resolve, ms))
 }
 
-export const skill: SootSimSkill = {
+export const skill: RNXSkill = {
   name: 'maestro-test',
   description: 'Run Maestro YAML tests against the app',
   type: 'testing',

package/src/skills/builtin/perf-profile.ts

@@ -1,7 +1,7 @@
 // built-in skill: performance profiling
 
 import { launchReapedChrome } from '../../../../../scripts/lib/reap-browser'
-import type { SootSimSkill } from '../types'
+import type { RNXSkill } from '../types'
 
 interface OverlayProfile {
   syncCount?: number
@@ -9,7 +9,7 @@ interface OverlayProfile {
   [key: string]: unknown
 }
 
-export const skill: SootSimSkill = {
+export const skill: RNXSkill = {
   name: 'perf-profile',
   description: 'Profile render performance of the app',
   type: 'performance',

package/src/skills/builtin/screenshot-all.ts

@@ -1,9 +1,9 @@
 // built-in skill: capture all screens in light/dark mode
 
 import { launchReapedChrome } from '../../../../../scripts/lib/reap-browser'
-import type { SootSimSkill } from '../types'
+import type { RNXSkill } from '../types'
 
-export const skill: SootSimSkill = {
+export const skill: RNXSkill = {
   name: 'screenshot-all',
   description: 'Capture screenshots of all screens in the app',
   type: 'screenshot',

package/src/skills/builtin/visual-diff.ts

@@ -1,9 +1,9 @@
 // built-in skill: visual diff against baselines
 
 import { launchReapedChrome } from '../../../../../scripts/lib/reap-browser'
-import type { SootSimSkill } from '../types'
+import type { RNXSkill } from '../types'
 
-export const skill: SootSimSkill = {
+export const skill: RNXSkill = {
   name: 'visual-diff',
   description: 'Compare current rendering against baseline screenshots',
   type: 'review',

package/src/skills/registry.ts

@@ -8,9 +8,9 @@ import { skill as maestroTestSkill } from './builtin/maestro-test'
 import { skill as perfProfileSkill } from './builtin/perf-profile'
 import { skill as screenshotAllSkill } from './builtin/screenshot-all'
 import { skill as visualDiffSkill } from './builtin/visual-diff'
-import type { SootSimSkill, SkillContext } from './types'
+import type { RNXSkill, SkillContext } from './types'
 
-const _skills: Map<string, SootSimSkill> = new Map()
+const _skills: Map<string, RNXSkill> = new Map()
 const BUILTIN_SKILLS = [
   a11yReviewSkill,
   compatCheckSkill,
@@ -21,20 +21,20 @@ const BUILTIN_SKILLS = [
 ]
 
 export const skillRegistry = {
-  register(skill: SootSimSkill) {
+  register(skill: RNXSkill) {
     _skills.set(skill.name, skill)
   },
 
-  get(name: string): SootSimSkill | undefined {
+  get(name: string): RNXSkill | undefined {
     return _skills.get(name)
   },
 
-  listAll(): SootSimSkill[] {
+  listAll(): RNXSkill[] {
     return Array.from(_skills.values())
   },
 
   // match skills by natural language query against triggers
-  match(query: string): SootSimSkill[] {
+  match(query: string): RNXSkill[] {
     const q = query.toLowerCase()
     return this.listAll().filter((skill) =>
       skill.triggers.some((trigger) => q.includes(trigger.toLowerCase())),
@@ -48,9 +48,9 @@ export const skillRegistry = {
     }
   },
 
-  // load skills from a project manifest (sootsim-skills.json)
+  // load skills from a project manifest (rnx-skills.json)
   async loadFromManifest(projectDir: string) {
-    const manifestPath = path.join(projectDir, 'sootsim-skills.json')
+    const manifestPath = path.join(projectDir, 'rnx-skills.json')
     if (!fs.existsSync(manifestPath)) return
 
     try {

package/src/skills/types.ts

@@ -29,7 +29,7 @@ export interface SkillArtifact {
   path: string
 }
 
-export interface SootSimSkill {
+export interface RNXSkill {
   name: string
   description: string
   type: SkillType

package/src/vite-plugin-one.ts

@@ -1,5 +1,5 @@
 // sootsim plugin for One/Vite — serves the installed sootsim runtime at /__soot/
-// from ~/.sootsim/runtimes/<version>. version-owned localhost origins remain
+// from ~/.rnx/runtimes/<version>. version-owned localhost origins remain
 // bound to that directory across an active-runtime update.
 //
 // usage in vite.config.ts:
@@ -36,7 +36,7 @@ export interface RnxPluginOptions {
   // disable sootsim
   enabled?: boolean
   // launch the sootsim simulator loading this server's bundle once the dev
-  // server is listening. skipped when CI or SOOTSIM_NO_OPEN is set.
+  // server is listening. skipped when CI or RNX_NO_OPEN is set.
   open?: RnxDesktopOpenOption
 }
 
@@ -220,7 +220,7 @@ export function rnxPlugin(options: RnxPluginOptions = {}): Plugin {
       const sootsimUrl = `http://localhost:${port}${prefix}/`
       console.log(`[rnx] serving at ${sootsimUrl}`)
 
-      if (appName && !process.env.CI && !process.env.SOOTSIM_NO_OPEN) {
+      if (appName && !process.env.CI && !process.env.RNX_NO_OPEN) {
         server.httpServer?.once('listening', () => {
           const openPort = listeningPort()
           launchRnxDesktop(