rnxsim 0.1.381 → 0.1.382

package/src/capture-contract.ts

@@ -0,0 +1,423 @@
+// public, runtime-neutral screen capture contract. semantic evidence and pixel
+// evidence are separate because neither one proves the other.
+
+export const RNX_SCREEN_CAPTURE_VERSION = 1 as const
+
+export interface RnxCaptureRect {
+  x: number
+  y: number
+  width: number
+  height: number
+}
+
+export interface RnxCaptureAccessibilityState {
+  disabled: boolean
+  selected: boolean
+  checked: boolean | 'mixed'
+  busy: boolean
+  expanded: boolean
+}
+
+export interface RnxCaptureAccessibilityValue {
+  min?: number
+  max?: number
+  now?: number
+  text?: string
+}
+
+export interface RnxCaptureAccessibility {
+  accessible: boolean
+  label: string | null
+  role: string | null
+  hint: string | null
+  liveRegion: 'none' | 'polite' | 'assertive' | null
+  state: RnxCaptureAccessibilityState | null
+  value: RnxCaptureAccessibilityValue | null
+}
+
+export interface RnxCaptureInteractionState {
+  pressed: boolean
+  pressable: boolean
+  textInput: boolean
+  textSelection: { start: number | null; end: number | null } | null
+  secureTextEntry: boolean
+  placeholder: string | null
+  scrollOffset: { x: number; y: number }
+  zoomScale: number | null
+  nativePinchEnabled: boolean
+  contentOffsetProp: { x?: number; y?: number } | null
+  decelerationRateProp: unknown
+  strokeDashoffsetProp: number | null
+}
+
+export interface RnxCaptureStyleTokenBinding {
+  token: string
+  theme: string
+}
+
+export interface RnxCaptureTextSegment {
+  text: string
+  color?: string | number
+  fontFamily?: string
+  fontSize?: number
+  fontStyle?: string
+  fontWeight?: string | number
+  letterSpacing?: number
+  textDecorationLine?: string
+}
+
+export interface RnxCaptureTextLine {
+  text: string
+  x: number
+  y: number
+  width: number
+  height: number
+  baseline: number
+  segments?: RnxCaptureTextSegment[]
+}
+
+export interface RnxCaptureSource {
+  location?: string
+  file?: string
+  componentName?: string
+  componentStack?: string[]
+  react?: {
+    component?: string
+    owners?: string[]
+    source?: string
+    key?: string
+    hasRef?: boolean
+    hooks?: {
+      total: number
+      counts: Record<string, number>
+    }
+    contexts?: string[]
+    lastCommit?: {
+      ageMs: number
+      causes: string[]
+      propDiffs?: string[]
+      stateChanged?: boolean
+      actualDurationMs?: number
+    }
+  }
+}
+
+export interface RnxCaptureNode {
+  nodeId: number
+  parentNodeId: number | null
+  childNodeIds: number[]
+  paintIndex: number
+  type: string
+  id: string | null
+  testID: string | null
+  text: string | null
+  childCount: number
+  accessibility: RnxCaptureAccessibility
+  interaction: RnxCaptureInteractionState
+  layout: {
+    local: RnxCaptureRect
+    frame: RnxCaptureRect | null
+    absolutePosition: { x: number; y: number }
+    visibleFrame: RnxCaptureRect | null
+  }
+  style: {
+    resolved: Record<string, unknown>
+    authored: Record<string, unknown>
+    computed: Record<string, unknown>
+    tokenBindings: Record<string, RnxCaptureStyleTokenBinding>
+  }
+  source: RnxCaptureSource
+  props: Record<string, unknown>
+  textLines?: RnxCaptureTextLine[]
+  /** additional generic inspect fields preserved for tooling adapters */
+  inspection: Record<string, unknown>
+}
+
+export interface RnxCaptureTree {
+  viewport: { width: number; height: number }
+  rootNodeId: number
+  nodes: RnxCaptureNode[]
+}
+
+export interface RnxCaptureVisualEvidence {
+  kind: 'png'
+  /** names the runtime that produced these pixels without claiming visibility */
+  producer: 'headless-cpu-app-surface' | 'browser-compositor-app-surface'
+  dataUri: string
+  pixelWidth: number
+  pixelHeight: number
+}
+
+export interface RnxCaptureRegionRequest {
+  key: string
+  /** host node whose own subtree is rendered into this transparent atlas region */
+  nodeId: number
+  frame: RnxCaptureRect
+}
+
+export interface RnxCaptureAtlasRegion extends RnxCaptureRegionRequest {
+  /** source rectangle inside the packed atlas, in logical atlas coordinates */
+  source: RnxCaptureRect
+}
+
+export interface RnxCaptureRegionAtlas {
+  kind: 'png-atlas'
+  producer: 'headless-cpu-app-surface'
+  dataUri: string
+  /** logical atlas dimensions; the encoded PNG uses pixelWidth × pixelHeight */
+  width: number
+  height: number
+  pixelWidth: number
+  pixelHeight: number
+  regions: RnxCaptureAtlasRegion[]
+}
+
+export interface RnxCaptureFontRegistration {
+  url?: string
+  family: string
+  sourceLabel?: string
+  parsedFamily?: string | null
+  parsedPostScript?: string | null
+  fullName?: string | null
+}
+
+export interface RnxScreenCapture {
+  contractVersion: typeof RNX_SCREEN_CAPTURE_VERSION
+  capturedAt: number
+  tree: RnxCaptureTree
+  /** app fonts registered in the captured tenant, included only when requested */
+  fonts?: RnxCaptureFontRegistration[]
+  /** optional full-frame diagnostic evidence, never required by tree consumers */
+  visual?: RnxCaptureVisualEvidence
+}
+
+function captureRecord(value: unknown): value is Record<string, unknown> {
+  return value !== null && typeof value === 'object' && !Array.isArray(value)
+}
+
+function captureInteger(value: unknown): value is number {
+  return typeof value === 'number' && Number.isSafeInteger(value)
+}
+
+function captureNumber(value: unknown): value is number {
+  return typeof value === 'number' && Number.isFinite(value)
+}
+
+function captureNullableString(value: unknown): value is string | null {
+  return value === null || typeof value === 'string'
+}
+
+function captureRect(value: unknown): value is RnxCaptureRect {
+  return (
+    captureRecord(value) &&
+    captureNumber(value.x) &&
+    captureNumber(value.y) &&
+    captureNumber(value.width) &&
+    captureNumber(value.height)
+  )
+}
+
+function captureOptionalString(value: unknown): value is string | undefined {
+  return value === undefined || typeof value === 'string'
+}
+
+function captureOptionalNullableString(
+  value: unknown,
+): value is string | null | undefined {
+  return value === undefined || captureNullableString(value)
+}
+
+function captureFontRegistration(value: unknown): value is RnxCaptureFontRegistration {
+  return (
+    captureRecord(value) &&
+    typeof value.family === 'string' &&
+    value.family.length > 0 &&
+    captureOptionalString(value.url) &&
+    captureOptionalString(value.sourceLabel) &&
+    captureOptionalNullableString(value.parsedFamily) &&
+    captureOptionalNullableString(value.parsedPostScript) &&
+    captureOptionalNullableString(value.fullName)
+  )
+}
+
+function capturePoint(value: unknown): value is { x: number; y: number } {
+  return captureRecord(value) && captureNumber(value.x) && captureNumber(value.y)
+}
+
+function captureNode(value: unknown): value is RnxCaptureNode {
+  if (
+    !captureRecord(value) ||
+    !captureInteger(value.nodeId) ||
+    !(value.parentNodeId === null || captureInteger(value.parentNodeId)) ||
+    !Array.isArray(value.childNodeIds) ||
+    !value.childNodeIds.every(captureInteger) ||
+    !captureInteger(value.paintIndex) ||
+    typeof value.type !== 'string' ||
+    !captureNullableString(value.id) ||
+    !captureNullableString(value.testID) ||
+    !captureNullableString(value.text) ||
+    !captureInteger(value.childCount) ||
+    !captureRecord(value.accessibility) ||
+    !captureRecord(value.interaction) ||
+    !captureRecord(value.layout) ||
+    !captureRecord(value.style) ||
+    !captureRecord(value.source) ||
+    !captureRecord(value.props) ||
+    !captureRecord(value.inspection)
+  ) {
+    return false
+  }
+  const accessibility = value.accessibility
+  if (
+    typeof accessibility.accessible !== 'boolean' ||
+    !captureNullableString(accessibility.label) ||
+    !captureNullableString(accessibility.role) ||
+    !captureNullableString(accessibility.hint) ||
+    !(
+      accessibility.liveRegion === null ||
+      accessibility.liveRegion === 'none' ||
+      accessibility.liveRegion === 'polite' ||
+      accessibility.liveRegion === 'assertive'
+    ) ||
+    !(accessibility.state === null || captureRecord(accessibility.state)) ||
+    !(accessibility.value === null || captureRecord(accessibility.value))
+  ) {
+    return false
+  }
+  const interaction = value.interaction
+  if (
+    typeof interaction.pressed !== 'boolean' ||
+    typeof interaction.pressable !== 'boolean' ||
+    typeof interaction.textInput !== 'boolean' ||
+    !(interaction.textSelection === null || captureRecord(interaction.textSelection)) ||
+    typeof interaction.secureTextEntry !== 'boolean' ||
+    !captureNullableString(interaction.placeholder) ||
+    !capturePoint(interaction.scrollOffset) ||
+    !(interaction.zoomScale === null || captureNumber(interaction.zoomScale)) ||
+    typeof interaction.nativePinchEnabled !== 'boolean' ||
+    !(
+      interaction.contentOffsetProp === null ||
+      captureRecord(interaction.contentOffsetProp)
+    ) ||
+    !(
+      interaction.strokeDashoffsetProp === null ||
+      captureNumber(interaction.strokeDashoffsetProp)
+    )
+  ) {
+    return false
+  }
+  const layout = value.layout
+  if (
+    !captureRect(layout.local) ||
+    !(layout.frame === null || captureRect(layout.frame)) ||
+    !capturePoint(layout.absolutePosition) ||
+    !(layout.visibleFrame === null || captureRect(layout.visibleFrame))
+  ) {
+    return false
+  }
+  const style = value.style
+  return (
+    captureRecord(style.resolved) &&
+    captureRecord(style.authored) &&
+    captureRecord(style.computed) &&
+    captureRecord(style.tokenBindings) &&
+    (value.textLines === undefined || Array.isArray(value.textLines))
+  )
+}
+
+export function isRnxScreenCapture(value: unknown): value is RnxScreenCapture {
+  if (
+    !captureRecord(value) ||
+    value.contractVersion !== RNX_SCREEN_CAPTURE_VERSION ||
+    !captureInteger(value.capturedAt) ||
+    !captureRecord(value.tree) ||
+    !(
+      value.fonts === undefined ||
+      (Array.isArray(value.fonts) &&
+        value.fonts.length <= 200 &&
+        value.fonts.every(captureFontRegistration))
+    ) ||
+    !(value.visual === undefined || captureRecord(value.visual))
+  ) {
+    return false
+  }
+  const tree = value.tree
+  const visual = value.visual
+  return (
+    captureRecord(tree.viewport) &&
+    captureInteger(tree.viewport.width) &&
+    tree.viewport.width > 0 &&
+    captureInteger(tree.viewport.height) &&
+    tree.viewport.height > 0 &&
+    captureInteger(tree.rootNodeId) &&
+    Array.isArray(tree.nodes) &&
+    tree.nodes.every(captureNode) &&
+    (visual === undefined ||
+      (visual.kind === 'png' &&
+        (visual.producer === 'headless-cpu-app-surface' ||
+          visual.producer === 'browser-compositor-app-surface') &&
+        typeof visual.dataUri === 'string' &&
+        visual.dataUri.startsWith('data:image/png;base64,') &&
+        captureInteger(visual.pixelWidth) &&
+        visual.pixelWidth > 0 &&
+        captureInteger(visual.pixelHeight) &&
+        visual.pixelHeight > 0))
+  )
+}
+
+export function isRnxCaptureRegionAtlas(value: unknown): value is RnxCaptureRegionAtlas {
+  if (
+    !captureRecord(value) ||
+    value.kind !== 'png-atlas' ||
+    value.producer !== 'headless-cpu-app-surface' ||
+    typeof value.dataUri !== 'string' ||
+    !value.dataUri.startsWith('data:image/png;base64,') ||
+    !captureNumber(value.width) ||
+    value.width <= 0 ||
+    !captureNumber(value.height) ||
+    value.height <= 0 ||
+    !captureInteger(value.pixelWidth) ||
+    value.pixelWidth <= 0 ||
+    !captureInteger(value.pixelHeight) ||
+    value.pixelHeight <= 0 ||
+    !Array.isArray(value.regions) ||
+    value.regions.length === 0 ||
+    value.regions.length > 256
+  ) {
+    return false
+  }
+  const scale = value.pixelWidth / value.width
+  if (
+    !Number.isInteger(scale) ||
+    scale < 1 ||
+    scale > 4 ||
+    Math.abs(value.height * scale - value.pixelHeight) > 0.000_001
+  ) {
+    return false
+  }
+  const keys = new Set<string>()
+  for (const region of value.regions) {
+    if (
+      !captureRecord(region) ||
+      typeof region.key !== 'string' ||
+      region.key.length === 0 ||
+      keys.has(region.key) ||
+      !captureInteger(region.nodeId) ||
+      region.nodeId <= 0 ||
+      !captureRect(region.frame) ||
+      region.frame.width <= 0 ||
+      region.frame.height <= 0 ||
+      !captureRect(region.source) ||
+      region.source.x < 0 ||
+      region.source.y < 0 ||
+      region.source.width !== region.frame.width ||
+      region.source.height !== region.frame.height ||
+      region.source.x + region.source.width > value.width ||
+      region.source.y + region.source.height > value.height
+    ) {
+      return false
+    }
+    keys.add(region.key)
+  }
+  return true
+}

package/src/cloud-contract.ts

@@ -0,0 +1,15 @@
+export const RNX_CLOUD_MAX_ARTIFACT_BYTES = 20 * 1024 * 1024
+
+export interface RnxCloudClaim {
+  id: string
+  expiresAt: number
+}
+
+export interface RnxCloudCreateReceipt {
+  simId: string
+  artifact: {
+    id: `sha256:${string}`
+    bytes: number
+  }
+  claim: RnxCloudClaim
+}

package/src/home-paths.ts

@@ -18,6 +18,7 @@
 //   ├── runtime-upgraded.json  one-shot notice written by the daemon's
 //   │                      background updater, consumed (printed + deleted)
 //   │                      by the next interactive CLI run
+//   ├── cli-update.json    cached standalone CLI release check + notice state
 //   ├── automatic-cleanup-v1.json  completion marker for the one-time safe
 //   │                      cleanup introduced for legacy unbounded data
 //   └── config.json        user prefs: update channel, cdn origin override,
@@ -33,6 +34,7 @@ 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 CLI_UPDATE_FILE = 'cli-update.json'
 export const DAEMON_HEARTBEAT_STALE_MS = 30_000
 
 export function rnxHomeDir(): string {
@@ -93,8 +95,8 @@ export function isDevWorkstation(): boolean {
 // the persistent launchd / systemd daemon must never auto-install or run on a
 // dev checkout or a dev workstation. either makes the background agent point at
 // moving workspace artifacts / dev env and serve stale assets that shadow the
-// live dev stack. setup and the launchd-spawned `sootsim serve` boot consult
-// this; a foreground `sootsim serve` the dev starts
+// live dev stack. setup and the launchd-spawned `rnx serve` boot consult
+// this; a foreground `rnx serve` the dev starts
 // by hand is intentional and stays allowed.
 export function shouldSkipPersistentDaemon(): boolean {
   return isSootsimDevCheckout() || isDevWorkstation()
@@ -176,6 +178,10 @@ export function configFilePath(): string {
   return path.join(rnxHomeDir(), CONFIG_FILE)
 }
 
+export function cliUpdateFilePath(): string {
+  return path.join(rnxHomeDir(), CLI_UPDATE_FILE)
+}
+
 // --- shared rnx config ---------------------------------------------------
 //
 // ~/.rnx/config.json is the single user-level config file every rnx
@@ -291,7 +297,7 @@ export function readOrCreateAnonymousId(): string {
 // the only place its "updated to vX" line lands is the daemon's own stderr,
 // which nobody reads. it also drops a one-shot notice file here; the next
 // interactive CLI invocation prints it once and deletes it, so users learn
-// their engine moved without having to run `sootsim version`.
+// their engine moved without having to run `rnx version`.
 
 export interface RuntimeUpgradeNotice {
   from: string | null

package/src/host/agent-host.ts

@@ -67,7 +67,7 @@ interface PendingPromptEcho {
 export interface AgentHostOptions {
   /** callback so hosts with a Contrast-env context (electron, dev middleware)
    *  can inject their own exclude list. defaults to the env-derived list
-   *  the rest of the repo uses, so `sootsim serve` standalone does the
+   *  the rest of the repo uses, so `rnx serve` standalone does the
    *  right thing. */
   getExcludePorts?: () => number[]
   /** returns the active CLI lease for a sim. used only for prompt routing to

package/src/host/bridge-host.ts

@@ -165,7 +165,7 @@ interface BridgeCliLease {
 }
 
 // interactive commands change app state and must respect the lease.
-// observational/lifecycle commands (evaluate/tree/query/resolve/screenshot/focus/call/close)
+// observational/lifecycle commands (evaluate/tree/query/resolve/screenshot/capture/focus/call/close)
 // pass through without taking or checking a lease so cleanup never gets stuck
 // behind a stale cli owner.
 // `call` used to acquire a lease too, but most call paths are queries
@@ -228,7 +228,7 @@ export interface BridgeHostOptions {
   portFallbackCount?: number
   /** 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
+   *  `rnx 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
@@ -249,7 +249,7 @@ export interface BridgeHostOptions {
    *  resolves the daemon's own loopback host (localhost:<runtimePort>) to
    *  the dev `contrast.localhost:3000` stack, so a *prod* CLI user's preview
    *  recording would upload to a localhost stack that doesn't exist. the
-   *  `sootsim serve` command resolves this with the same probe the
+   *  `rnx serve` command resolves this with the same probe the
    *  upload itself uses (`resolveDefaultUploadOrigin`). */
   contrastOrigin?: string
   /** override the abandoned-sim GC TTL (ms). defaults to
@@ -325,7 +325,7 @@ const CAMERA_FIXTURE_NAME_RE = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/
  *     the same server on the same port, but a daemon whose preferred 7668
  *     was taken falls back to 7669+. without this the runtime page would
  *     hardcode the 7668 default in `resolveBridgePort` and register on a
- *     *different* daemon (or none), so `sootsim open` times out waiting for
+ *     *different* daemon (or none), so `rnx open` times out waiting for
  *     a sim that connected to the wrong bridge.
  *   - `window.__sootsimContrastOrigin` — the contrast origin for auth /
  *     billing / preview uploads. the daemon serves runtimes from its own
@@ -400,8 +400,8 @@ export class SootSimBridgeHost {
   private static USER_BOOT_LEASE_TTL_MS = 60_000
   private static SIM_RECONNECT_TTL_MS = 30_000
   // abandoned-tab GC. the ws heartbeat only reaps sims whose socket went
-  // dead — but a background tab from a prior `sootsim open` / QA / test run
-  // keeps its socket alive (the page still pongs) forever, so `sootsim list`
+  // dead — but a background tab from a prior `rnx open` / QA / test run
+  // keeps its socket alive (the page still pongs) forever, so `rnx list`
   // accretes dozens of zombie sims that all time out on every command (QA
   // F21-3, carried F19-2). reap a sim only when it is provably nobody's:
   // not primary, not user-focused, no CLI attached, no active lease, and no
@@ -409,7 +409,7 @@ export class SootSimBridgeHost {
   // terminal 4001 code, so the client closes the abandoned window instead
   // of reconnecting the zombie straight back in.
   private static SIM_IDLE_REAP_TTL_MS = 30 * 60_000
-  // automation sims (spawned by the playwright driver: `sootsim open --driver
+  // automation sims (spawned by the playwright driver: `rnx open --driver
   // playwright`, the factory/screenshot capture path — `meta.sootsimHostDriver
   // === 'playwright'`) are unattended one-shot browsers, never a human's tab. a
   // capture run opens one per slide/app/retry and the 30-min human/dev TTL lets
@@ -440,7 +440,7 @@ export class SootSimBridgeHost {
   // dropped, sim crashed) leave their server-side WebSocket sitting "open"
   // forever. ping every WS_HEARTBEAT_INTERVAL_MS; if the previous round's
   // ping was never answered, terminate(). that fires 'close' which runs the
-  // sim-cleanup path and stops `sootsim list` from showing 8 zombie
+  // sim-cleanup path and stops `rnx list` from showing 8 zombie
   // sims that all time out on every command.
   private wsHeartbeatTimer: NodeJS.Timeout | null = null
   private wsIsAlive = new WeakMap<WebSocket, boolean>()
@@ -462,7 +462,7 @@ export class SootSimBridgeHost {
   constructor(opts: BridgeHostOptions = {}) {
     this.preferredPort = opts.port || DEFAULT_SOOTSIM_BRIDGE_PORT
     this.port = this.preferredPort
-    // default off — callers that want the lockfile (sootsim serve) opt in.
+    // default off — callers that want the lockfile (rnx serve) opt in.
     this.shouldWriteLockfile = opts.writeLockfile === true
     this.shouldWriteDevLockfile = opts.writeDevLockfile === true
     this.getShellPort = opts.getShellPort ?? null
@@ -1920,7 +1920,7 @@ export class SootSimBridgeHost {
     this.reapIdleSims(now)
   }
 
-  // GC abandoned sims so `sootsim list` stays usable across long dev / QA /
+  // GC abandoned sims so `rnx list` stays usable across long dev / QA /
   // test sessions (F21-3). conservative on purpose: a sim is only reaped
   // when every "someone cares about this" signal is absent.
   //
@@ -1936,7 +1936,7 @@ export class SootSimBridgeHost {
   // using is the primary and/or holds a fresh user-active lease; one that is
   // none of those and idle past the TTL is abandoned regardless of a stale
   // focus flag.
-  // automation sims are spawned by the playwright driver (`sootsim open
+  // automation sims are spawned by the playwright driver (`rnx open
   // --driver playwright`, the factory/screenshot capture path), which tags them
   // with `meta.sootsimHostDriver === 'playwright'` via the host's addInitScript.
   // they are unattended one-shot browsers, never a human's tab, so they get a
@@ -2551,6 +2551,8 @@ export class SootSimBridgeHost {
         return 'evaluated page state'
       case 'screenshot':
         return 'captured screenshot'
+      case 'capture':
+        return 'captured app screen'
       case 'tap':
         return 'sent tap event'
       case 'keyboard':

package/src/host/plane-host.ts

@@ -17,9 +17,9 @@
 
 import fs from 'node:fs'
 import path from 'node:path'
-import { dispatchPlaneCommand, indexVersion } from '@contrast/harness/plane'
+import { dispatchPlaneCommand, indexVersion } from '@rnx/box/plane'
 import { CheckoutFilePlane } from '../../cli/commands/box/checkout-plane'
-import type { ProjectFilePlane } from '@contrast/harness/plane'
+import type { ProjectFilePlane } from '@rnx/box/plane'
 import type { WebSocket } from 'ws'
 
 const WS_OPEN = 1

package/src/index.ts

@@ -35,6 +35,27 @@ export type {
   SimSemanticResolveSelector,
   SimSemanticSelector,
 } from './bridge-contract'
+export {
+  isRnxCaptureRegionAtlas,
+  isRnxScreenCapture,
+  RNX_SCREEN_CAPTURE_VERSION,
+  type RnxCaptureAccessibility,
+  type RnxCaptureAccessibilityState,
+  type RnxCaptureAccessibilityValue,
+  type RnxCaptureAtlasRegion,
+  type RnxCaptureInteractionState,
+  type RnxCaptureNode,
+  type RnxCaptureRect,
+  type RnxCaptureRegionAtlas,
+  type RnxCaptureRegionRequest,
+  type RnxCaptureSource,
+  type RnxCaptureStyleTokenBinding,
+  type RnxCaptureTextLine,
+  type RnxCaptureTextSegment,
+  type RnxCaptureTree,
+  type RnxCaptureVisualEvidence,
+  type RnxScreenCapture,
+} from './capture-contract'
 
 export { rnxPlugin } from './vite-plugin-one'
 export { default as metroPlugin } from './metro-plugin'

package/src/native-dev-bundle-url.ts

@@ -42,7 +42,7 @@ export function alignLoopbackBundleUrlWithProbe(
 // unreliably on small CI runners (tens of seconds when metro is warm,
 // minutes cold, sometimes past any wait-ready budget). a minified bundle
 // parses/executes far faster and reboots reliably. gated on
-// SOOTSIM_PREVIEW_PROD_BUNDLE so normal interactive `sootsim open` keeps
+// SOOTSIM_PREVIEW_PROD_BUNDLE so normal interactive `rnx open` keeps
 // dev=true. app-agnostic: rewrites whatever metro/launchAsset advertised.
 function applyPreviewProdBundle(parsed: URL): void {
   if (!process.env.SOOTSIM_PREVIEW_PROD_BUNDLE) return
@@ -95,7 +95,7 @@ export function normalizeNativeDevBundleUrl(bundleUrl: string): string {
   }
 }
 
-// explicit override used by `sootsim open` to flip metro's `hot` query when
+// explicit override used by `rnx open` to flip metro's `hot` query when
 // the caller knows their context: interactive opens want `hot=true` so metro
 // includes its HMR/react-refresh runtime in the bundle prelude and pushes
 // edits as `update` events; `--driver playwright` / agent-test runs want

package/src/screenshots/orchestrate.ts

@@ -20,7 +20,7 @@ export interface RunScreenshotsOverrides {
   captureOnly?: boolean
   composeOnly?: boolean
   // copy/colors pulled from the team's org deck to overlay onto the plan's
-  // compose slides (sootsim screenshot appstore --org … --repo …).
+  // compose slides (rnx screenshot appstore --org … --repo …).
   orgDeckFrames?: OrgDeckFrame[] | null
 }
 

package/src/screenshots/org-deck.ts

@@ -1,6 +1,6 @@
 // fetch the team's screenshot deck (the copy / colors founders set up in the
 // org dashboard) and overlay it onto a screenshots plan, so the programmatic
-// `sootsim screenshot appstore --plan … --org … --repo …` flow renders the org's
+// `rnx screenshot appstore --plan … --org … --repo …` flow renders the org's
 // words + brand gradient instead of the local yaml's. the plan still owns
 // which screen each slide captures and the device frame; the deck owns copy +
 // colors. 3d scenes don't translate to the cli's 2d composer, so only copy and

package/src/settings-bundle.ts

@@ -1,7 +1,7 @@
 import { readFile, readdir, stat } from 'node:fs/promises'
 import { join } from 'node:path'
 import { parsePlistSource } from './plist.ts'
-import type { AppPreferenceValue, AppSettingsSpecifier } from '@sootsim/globals'
+import type { AppPreferenceValue, AppSettingsSpecifier } from '@rnx/globals'
 
 const MAX_PLIST_BYTES = 1_048_576
 const MAX_CHILD_DEPTH = 8