peachsim 0.1.570 → 0.1.572

package/cli/help-core.ts

@@ -38,10 +38,10 @@ function backendLabel(command: string, args: readonly string[]): string {
 }
 
 function renderPreviewHelp(command: 'web' | 'ios' | 'android'): string {
-  return `rnx ${command} — select or ensure the current branch's existing ${command} preview
+  return `peach ${command} — select or ensure the current branch's existing ${command} preview
 
 usage:
-  rnx ${command}
+  peach ${command}
 
 The browser backend selects the Factory-owned ${command} iframe. It never launches a
 host process or Cloudflare runtime.`
@@ -51,19 +51,19 @@ function renderFactoryBrowserLeaves(command: string): string | null {
   switch (command) {
     case 'do':
       return `Factory browser leaves:
-  rnx do navigate /route`
+  peach do navigate /route`
     case 'shell':
       return `Factory browser leaves:
-  rnx shell appearance light|dark`
+  peach shell appearance light|dark`
     case 'assert':
       return `Factory browser leaves:
-  rnx assert find (--testid <id>|--text <text>|--role <role>) [--exists|--empty] [--contains <text>]`
+  peach assert find (--testid <id>|--text <text>|--role <role>) [--exists|--empty] [--contains <text>]`
     case 'screenshot':
       return `Factory browser leaves:
-  rnx screenshot
-  rnx screenshot ask <question>
-  rnx screenshot appearance light|dark /route --by <query-kind> --value <target>
-  rnx screenshot motion <task-id> /route --trigger-by <kind> --trigger-value <target> --result-by <kind> --result-value <target> [--duration-ms <100..2000>]`
+  peach screenshot
+  peach screenshot ask <question>
+  peach screenshot appearance light|dark /route --by <query-kind> --value <target>
+  peach screenshot motion <task-id> /route --trigger-by <kind> --trigger-value <target> --result-by <kind> --result-value <target> [--duration-ms <100..2000>]`
     default:
       return null
   }
@@ -90,7 +90,7 @@ function renderRootAvailability(backend: RnxBackendKind): string {
   available:   ${available.join(', ')}
   unavailable: ${unavailable.join(', ')}
 
-Run \`rnx <command> --help\` for leaf availability and usage.`
+Run \`peach <command> --help\` for leaf availability and usage.`
 }
 
 export function renderRnxHelp(options: RnxHelpOptions): string {
@@ -100,9 +100,9 @@ export function renderRnxHelp(options: RnxHelpOptions): string {
     return `${renderCliIndexHelp(HELP_CONTEXT, formatFlagHelp()).trimEnd()}
 
 browser preview selectors:
-  rnx web                     select the existing Factory web preview
-  rnx ios                     select the existing Factory iOS preview
-  rnx android                 select the existing Factory Android preview
+  peach web                     select the existing Factory web preview
+  peach ios                     select the existing Factory iOS preview
+  peach android                 select the existing Factory Android preview
 
 ${renderRootAvailability(options.backend)}`
   }

package/cli/hints.ts

@@ -1,4 +1,4 @@
-// configurable, identity-scoped hint registry for the rnx CLI.
+// configurable, identity-scoped hint registry for the peach CLI.
 //
 // two problems this solves:
 //   1. the CLI scatters "hint: ..." console.logs across many command files,
@@ -46,11 +46,11 @@ interface HintStateFile {
 const STATE_VERSION = 1 as const
 
 function identityStatePath(): string {
-  return join(tmpdir(), `rnx-cli-hints-${getCliIdentityKey()}.json`)
+  return join(tmpdir(), `peach-cli-hints-${getCliIdentityKey()}.json`)
 }
 
 function globalStatePath(): string {
-  return join(tmpdir(), `rnx-cli-hints-global.json`)
+  return join(tmpdir(), `peach-cli-hints-global.json`)
 }
 
 function readState(path: string): HintStateFile {
@@ -76,7 +76,7 @@ function writeState(path: string, state: HintStateFile) {
 }
 
 function modeFromEnv(): 'normal' | 'always' | 'off' {
-  const v = (process.env.RNX_HINTS || '').toLowerCase()
+  const v = (process.env.PEACH_HINTS || '').toLowerCase()
   if (v === 'off' || v === '0' || v === 'false') return 'off'
   if (v === 'always' || v === 'verbose') return 'always'
   return 'normal'
@@ -119,7 +119,7 @@ function shouldShow(id: string, frequency: HintFrequency): boolean {
 export function maybeHint(id: string, ...args: unknown[]): boolean {
   const spec = registry.get(id)
   if (!spec) {
-    if (process.env.RNX_HINTS_DEBUG) {
+    if (process.env.PEACH_HINTS_DEBUG) {
       console.error(`  [hints] no hint registered for id "${id}"`)
     }
     return false
@@ -158,13 +158,13 @@ defineHint<[number]>('app-still-loading', {
   // bundle boots — telling the user about it again is useful, not noisy.
   frequency: { cooldownMs: 60_000 },
   render: (nodeCount) =>
-    `app may still be loading (${nodeCount} nodes). run \`rnx wait ready\` first.`,
+    `app may still be loading (${nodeCount} nodes). run \`peach wait ready\` first.`,
 })
 
 defineHint<[string]>('wait-selector-for-missing-testid', {
   // advice is stable; once per CLI identity is enough.
   frequency: 'once-per-identity',
-  render: (testId) => `rnx wait selector ${testId}`,
+  render: (testId) => `peach wait selector ${testId}`,
 })
 
 defineHint<[string[]]>('prefer-cli-over-eval', {
@@ -181,9 +181,9 @@ defineHint<[]>('describe-use-filters', {
   frequency: 'once-per-identity',
   render: () => [
     `describe output is long. narrow it with:`,
-    `  rnx describe --only '*Bottom Sheet*'`,
-    `  rnx describe --testid-like 'swap-*'`,
-    `  rnx describe --subtree <testID>`,
+    `  peach describe --only '*Bottom Sheet*'`,
+    `  peach describe --testid-like 'swap-*'`,
+    `  peach describe --subtree <testID>`,
   ],
 })
 
@@ -194,21 +194,21 @@ defineHint<[]>('describe-filter-context', {
   frequency: 'once-per-identity',
   render: () => [
     `filtered describe is search output, not current-route proof.`,
-    `run \`rnx describe\` without filters after navigation; clipped nodes are marked \`(clipped:...)\`.`,
+    `run \`peach describe\` without filters after navigation; clipped nodes are marked \`(clipped:...)\`.`,
   ],
 })
 
 defineHint<[string]>('subtree-root-not-found', {
   frequency: 'always',
   render: (id) =>
-    `no node with testID/id "${id}" — try \`rnx find --testid ${id}\` to discover available ids.`,
+    `no node with testID/id "${id}" — try \`peach find --testid ${id}\` to discover available ids.`,
 })
 
 defineHint<[]>('clean-uninstall', {
-  // shown once on the first `rnx --help` run so users learn the teardown path.
+  // shown once on the first `peach --help` run so users learn the teardown path.
   frequency: 'once-ever',
   render: () => [
-    `to remove the background daemon, run \`rnx daemon uninstall\`. it keeps your runtimes and device profiles; add \`--purge\` to delete ~/.rnx too.`,
+    `to remove the background daemon, run \`peach daemon uninstall\`. it keeps your runtimes and device profiles; add \`--purge\` to delete ~/.peach too.`,
     `the optional desktop app and its macOS preference plist are separate from the daemon.`,
   ],
 })

package/cli/inspect-notice-state.ts

@@ -23,7 +23,7 @@ interface InspectNoticeState {
 export function getInspectNoticeStatePath() {
   return resolve(
     process.env[INSPECT_NOTICE_PATH_ENV] ||
-      join(tmpdir(), 'rnx-inspect-notice-state.json'),
+      join(tmpdir(), 'peach-inspect-notice-state.json'),
   )
 }
 

package/cli/internal-child.ts

@@ -1,10 +1,10 @@
 // hidden child-process entry points.
 //
 // the CLI needs separate JS processes for a few jobs: a detached browser host
-// that outlives `rnx open`, playwright's own installer, and a blocking fetch
+// that outlives `peach open`, playwright's own installer, and a blocking fetch
 // worker for maestro's synchronous `http` API. each used to run as
 // `process.execPath -e '<source>'`, which cannot work once the CLI ships as a
-// compiled binary: there process.execPath is rnx, and rnx has no -e. a
+// compiled binary: there process.execPath is peach, and peach has no -e. a
 // shell-installed user has no node and no bun either, so there is nothing else
 // to reach for. the binary is the JS runtime, and it runs these itself.
 //

package/cli/maestro-js.ts

@@ -14,10 +14,10 @@
 //   time (maestro-orchestra-models util/Env.kt): regex (?<!\\)\$\{([^$]*)},
 //   result stringified, `\${...}` escapes to a literal, blank exprs become ''.
 //
-// divergences (deliberate, rnx-side ergonomics — keep this list short):
+// divergences (deliberate, peach-side ergonomics — keep this list short):
 //   1. envBinding is seeded from the full process.env, not just MAESTRO_*.
-//      rnx flows historically resolve `${SOOTSIM_*}` credentials from the
-//      shell environment and `rnx maestro --env K=V` writes process.env.
+//      peach flows historically resolve `${SOOTSIM_*}` credentials from the
+//      shell environment and `peach maestro --env K=V` writes process.env.
 //   2. a *bare identifier* template (`${NAME}`) that evaluates to undefined
 //      throws a loud "missing variable" error instead of interpolating the
 //      literal text "undefined" into a tap target or login form. complex
@@ -45,7 +45,7 @@ function executeSyncHttp(
   params?: HttpParams,
 ): { ok: boolean; status: number; body: string; headers: Record<string, string> } {
   if (params?.multipartForm) {
-    throw new Error('http: multipartForm is not supported by rnx yet')
+    throw new Error('http: multipartForm is not supported by peach yet')
   }
   // maestro's `http` API is synchronous (flows do `var res = http.post(...)`)
   // and there is no synchronous fetch, so each request round-trips through a

package/cli/maestro-report.ts

@@ -34,6 +34,8 @@ export interface JUnitCaseInput {
 export interface JUnitSuiteInput {
   device: string
   cases: JUnitCaseInput[]
+  // --test-suite-name; absent keeps the existing "Test Suite" name.
+  name?: string
 }
 
 function formatJUnitTime(seconds: number): string {
@@ -49,7 +51,7 @@ export function buildJUnitXml(suite: JUnitSuiteInput): string {
   const lines = [
     '<?xml version="1.0" encoding="UTF-8"?>',
     '<testsuites>',
-    `  <testsuite name="Test Suite" device="${escapeXml(suite.device)}" tests="${suite.cases.length}" failures="${failures}" time="${formatJUnitTime(totalTime)}">`,
+    `  <testsuite name="${escapeXml(suite.name ?? 'Test Suite')}" device="${escapeXml(suite.device)}" tests="${suite.cases.length}" failures="${failures}" time="${formatJUnitTime(totalTime)}">`,
   ]
   for (const c of suite.cases) {
     lines.push(
@@ -164,7 +166,7 @@ export function buildSessionLog(input: {
 }): string {
   const passed = input.flows.filter((flow) => flow.passed).length
   const lines = [
-    '# rnx maestro session log',
+    '# peach maestro session log',
     `# started: ${input.startedAtIso}`,
     `# root: ${input.root}`,
     `# device: ${input.device}`,

package/cli/main.ts

@@ -1,4 +1,4 @@
-// the rnx CLI proper: argv parsing, the one-time privacy choice, and the
+// the peach CLI proper: argv parsing, the one-time privacy choice, and the
 // single lazy-imported command a run dispatches to. `./bin` imports this only
 // when none of its hidden entry points claimed the process.
 
@@ -22,7 +22,7 @@ import { IS_STANDALONE } from './standalone'
 // don't paper over real bugs.
 function handleTopLevelError(err: unknown): never {
   const msg = err instanceof Error ? err.message : String(err)
-  // rnx's known top-level errors are all single-line, narrow strings.
+  // peach's known top-level errors are all single-line, narrow strings.
   // everything else gets the full stack so unexpected crashes still surface.
   const isKnownCliFailure =
     /^command timed out after \d+s$/.test(msg) ||
@@ -32,12 +32,12 @@ function handleTopLevelError(err: unknown): never {
     msg.startsWith('saved sim ') ||
     msg.startsWith('no sim connected with id ') ||
     msg.startsWith('could not connect to ws://') ||
-    msg.startsWith('rnx bridge daemon is not running') ||
-    msg.startsWith('rnx bridge lockfile is fresh') ||
-    msg.startsWith('rnx bridge exited before becoming ready') ||
+    msg.startsWith('peach bridge daemon is not running') ||
+    msg.startsWith('peach bridge lockfile is fresh') ||
+    msg.startsWith('peach bridge exited before becoming ready') ||
     msg.startsWith(`${rnxPublicBrand.commandName} open: requested bridge port`) ||
     msg.startsWith('background daemon setup is unavailable') ||
-    msg.startsWith('rnx bridge did not start within')
+    msg.startsWith('peach bridge did not start within')
   if (isKnownCliFailure && !process.env.SOOTSIM_VERBOSE) {
     process.stderr.write(`  ${msg}\n`)
     process.exit(1)
@@ -191,7 +191,7 @@ async function scheduleAutomaticCliUpdate(exitCode: number): Promise<void> {
   const update = takeCliUpdateNotification()
   if (update) {
     process.stderr.write(
-      `  update: rnx v${update.currentVersion} → v${update.latestVersion} · run \`rnx upgrade\`\n`,
+      `  update: peach v${update.currentVersion} → v${update.latestVersion} · run \`peach upgrade\`\n`,
     )
   }
   if (!claimAutomaticCliUpdateCheck()) return
@@ -223,7 +223,7 @@ if (parsed.version) {
   console.log(`${rnxPublicBrand.commandName} v${getCliVersion()}${suffix}`)
   // runtime version on its own line — keeps the first line parseable while
   // surfacing the (independently-versioned) engine runtime users actually
-  // render with. see `rnx upgrade`.
+  // render with. see `peach upgrade`.
   const { readActiveRuntime } = await import('../src/home-paths')
   const runtime = readActiveRuntime()
   console.log(runtime ? `runtime v${runtime}` : 'runtime not installed')
@@ -270,7 +270,7 @@ if (!parsed.command && parsed.commandArgs.length === 0) {
 }
 
 // route to command. an empty command at this point only happens if the
-// caller passed bare positional args without a verb (e.g. `rnx -- foo`),
+// caller passed bare positional args without a verb (e.g. `peach -- foo`),
 // which used to fall through to the bundler-wrap behavior in `dev`. now that
 // `dev` is gone, treat it as "show help".
 const command = parsed.command ?? ''
@@ -313,8 +313,8 @@ if (
     await exitWithFlush(await runReset(commandArgsWithSim, { port }))
   }
   // for grouping verbs, try to resolve per-verb help from the first
-  // positional arg. e.g. `rnx do tap --help` shows tap's help page,
-  // not the generic `do` grouping page. bare `rnx do --help` falls
+  // positional arg. e.g. `peach do tap --help` shows tap's help page,
+  // not the generic `do` grouping page. bare `peach do --help` falls
   // through to runInspect which has the full verb group listing.
   const isGroupingVerb =
     command === 'do' ||
@@ -328,7 +328,7 @@ if (
     // shell and perf subcommands are documented by their runtime dispatchers.
     // don't try to route through generated per-verb docs.
   } else if (isGroupingVerb && !subVerb) {
-    // bare `rnx <group> --help` — render from the registry.
+    // bare `peach <group> --help` — render from the registry.
     const { printGroupHelp } = await import('./help')
     if (printGroupHelp(command)) await exitWithFlush(0)
     // fall through — runInspect shows the full help for anything the
@@ -390,7 +390,7 @@ try {
         const { runMaestro } = await import('./commands/maestro')
         // Maestro forwards playback argv to the shared runner, so it must
         // receive the global `--sim`. passing the bare
-        // parsed.commandArgs dropped an explicit `rnx --sim <id> maestro
+        // parsed.commandArgs dropped an explicit `peach --sim <id> maestro
         // …`, silently falling back to the current/saved sim (QA F21-4).
         const code = await runMaestro(commandArgsWithSim, { port, verbose })
         // bridge + dynamic imports leave handles open that keep node alive.
@@ -539,7 +539,7 @@ try {
       case 'web': {
         const { getRnxCommandAvailability } = await import('./command-registry')
         const availability = getRnxCommandAvailability('web', parsed.commandArgs, 'node')
-        console.error(`  ${availability.reason ?? 'rnx web is unavailable'}`)
+        console.error(`  ${availability.reason ?? 'peach web is unavailable'}`)
         await exitWithFlush(1)
       }
 

package/cli/outbound-endpoints.ts

@@ -82,7 +82,7 @@ export const OUTBOUND_ENDPOINTS: Record<string, OutboundEndpointDeclaration> = {
   },
   same_origin_runtime: {
     category: 'same-origin-runtime',
-    destination: 'the origin already serving the rnx runtime',
+    destination: 'the origin already serving the peach runtime',
     preConsent: true,
     payload: 'runtime assets and shared local settings',
   },
@@ -90,7 +90,7 @@ export const OUTBOUND_ENDPOINTS: Record<string, OutboundEndpointDeclaration> = {
     category: 'guest-app-network',
     destination: 'URLs requested by the user app or supplied explicitly by the user',
     preConsent: true,
-    payload: 'the app request itself; rnx does not add telemetry fields',
+    payload: 'the app request itself; peach does not add telemetry fields',
   },
   remote_display_server: {
     category: 'explicit-user-action',
@@ -109,10 +109,10 @@ export const OUTBOUND_ENDPOINTS: Record<string, OutboundEndpointDeclaration> = {
   // the only egress that sends the CONTENTS of the user's project somewhere,
   // and to an operator-chosen host rather than a Contrast one, so it must not
   // be readable as "the usual Contrast call".
-  rnx_cloud_box: {
+  peach_cloud_box: {
     category: 'explicit-user-action',
     destination:
-      'the RNX cloud box service named by --endpoint or RNX_BOX_ENDPOINT; no default, so this call cannot happen unless the user names a host',
+      'the Peach Cloud box service named by --endpoint or PEACH_BOX_ENDPOINT; no default, so this call cannot happen unless the user names a host',
     preConsent: false,
     payload:
       'every file git reports for the current checkout, then shell commands and file reads and writes for as long as the box shell is open',
@@ -125,20 +125,20 @@ export const OUTBOUND_ENDPOINTS: Record<string, OutboundEndpointDeclaration> = {
     payload:
       'the project .swift sources, packed bundle resources and images, plus the signed preview token or ccdn_ api key that authorizes the compile',
   },
-  rnx_cloud_sim: {
+  peach_cloud_sim: {
     category: 'explicit-user-action',
     destination:
-      'https://rnxsim.com by default, or the test or disposable origin named by RNX_CLOUD_ORIGIN',
+      'https://rnxsim.com by default, or the test or disposable origin named by PEACH_CLOUD_ORIGIN',
     preConsent: false,
     payload:
-      'the Metro JavaScript bundle selected by rnx ios --remote, then structured simulator commands and lifecycle requests',
+      'the Metro JavaScript bundle selected by peach ios --remote, then structured simulator commands and lifecycle requests',
   },
   tunnel_tool_download: {
     category: 'explicit-user-action',
     destination: 'https://github.com/cloudflare/cloudflared/releases/latest/download/',
     preConsent: false,
     payload:
-      'platform and architecture only, carried in the release asset name; fires only for rnx test --cloud with a live dev stack when no cloudflared binary is installed',
+      'platform and architecture only, carried in the release asset name; fires only for peach test --cloud with a live dev stack when no cloudflared binary is installed',
   },
 }
 
@@ -152,50 +152,50 @@ export interface OutboundCallDeclaration {
 // fails the package test until its destination and consent behavior are declared.
 export const DECLARED_OUTBOUND_CALLS: Record<string, OutboundCallDeclaration> = {
   'packages/peachsim/cli/cloud-client.ts :: fetch :: `${apiOrigin}/v1/boxes`': {
-    category: 'rnx_cloud_sim',
+    category: 'peach_cloud_sim',
     count: 1,
   },
   'packages/peachsim/cli/cloud-client.ts :: fetch :: `${session.apiOrigin}/v1/sims/${encodeURIComponent()}/claim`':
-    { category: 'rnx_cloud_sim', count: 1 },
+    { category: 'peach_cloud_sim', count: 1 },
   // two call sites delete a box by id: closing a nano-box simulator, and
   // closing a box from a session that is not itself the box. one destination,
   // so one declaration.
   'packages/peachsim/cli/cloud-client.ts :: fetch :: `${session.apiOrigin}/v1/boxes/${encodeURIComponent()}`':
-    { category: 'rnx_cloud_sim', count: 2 },
+    { category: 'peach_cloud_sim', count: 2 },
   // closing an instance simulator deletes it by its own id with its own token.
   'packages/peachsim/cli/cloud-client.ts :: fetch :: `${session.apiOrigin}/v1/sims/${encodeURIComponent()}`':
-    { category: 'rnx_cloud_sim', count: 1 },
+    { category: 'peach_cloud_sim', count: 1 },
   // the box api mirrors the sim api for a micro box: the same destination and
   // the same box token, reached through the session rather than a loose id.
   // driving a box sends each command to its own box.
   'packages/peachsim/cli/cloud-client.ts :: fetch :: `${this.session.apiOrigin}/v1/boxes/${encodeURIComponent()}/commands`':
-    { category: 'rnx_cloud_sim', count: 1 },
+    { category: 'peach_cloud_sim', count: 1 },
   // stopping a box leaves it allocated, unlike the delete above.
   'packages/peachsim/cli/cloud-client.ts :: fetch :: `${session.apiOrigin}/v1/boxes/${encodeURIComponent()}/stop`':
-    { category: 'rnx_cloud_sim', count: 1 },
+    { category: 'peach_cloud_sim', count: 1 },
   // the display grant is polled until the box hands one back; the body is
   // empty, so the request carries no project or app data.
   'packages/peachsim/cli/cloud-client.ts :: fetch :: `${options.apiOrigin}/v1/boxes/${encodeURIComponent()}/display-grant`':
-    { category: 'rnx_cloud_sim', count: 1 },
-  // `rnx remote` creates through the instance api and lists what it made.
+    { category: 'peach_cloud_sim', count: 1 },
+  // `peach remote` creates through the instance api and lists what it made.
   // the create carries labels and wait=true in the query; the list filters
   // by the remote label.
   'packages/peachsim/cli/cloud-client.ts :: fetch :: `${apiOrigin}/v1/sims?${query}`': {
-    category: 'rnx_cloud_sim',
+    category: 'peach_cloud_sim',
     count: 1,
   },
   'packages/peachsim/cli/cloud-client.ts :: fetch :: `${apiOrigin}/v1/sims?${selector}`':
     {
-      category: 'rnx_cloud_sim',
+      category: 'peach_cloud_sim',
       count: 1,
     },
   // rereading one simulator and deleting one by id share the route: the
-  // reattach probe reads with either credential and `rnx remote stop`
+  // reattach probe reads with either credential and `peach remote stop`
   // deletes with the account credential.
   'packages/peachsim/cli/cloud-client.ts :: fetch :: `${apiOrigin}/v1/sims/${encodeURIComponent()}`':
-    { category: 'rnx_cloud_sim', count: 2 },
+    { category: 'peach_cloud_sim', count: 2 },
   'packages/peachsim/cli/cloud-client.ts :: fetch :: `${this.session.apiOrigin}/v1/sims/${encodeURIComponent()}/commands`':
-    { category: 'rnx_cloud_sim', count: 1 },
+    { category: 'peach_cloud_sim', count: 1 },
   'packages/peachsim/cli/cloud-client.ts :: fetch :: bundleUrl': {
     category: 'guest_app_network',
     count: 1,
@@ -225,7 +225,7 @@ export const DECLARED_OUTBOUND_CALLS: Record<string, OutboundCallDeclaration> =
     count: 1,
   },
   'packages/peachsim/src/cloud.ts :: fetch :: url': {
-    category: 'rnx_cloud_sim',
+    category: 'peach_cloud_sim',
     count: 1,
   },
   // maestro's flow `http` API. the url is whatever the flow author wrote, and
@@ -234,15 +234,15 @@ export const DECLARED_OUTBOUND_CALLS: Record<string, OutboundCallDeclaration> =
     category: 'guest_app_network',
     count: 1,
   },
-  // `rnx box create` uploads the checkout to the box service and then talks to
+  // `peach box create` uploads the checkout to the box service and then talks to
   // it. the destination is whatever the user named; there is no default.
   'packages/peach-cloud-box/src/client.ts :: fetch :: endpointOf(base, name, verb, search)':
     {
-      category: 'rnx_cloud_box',
+      category: 'peach_cloud_box',
       count: 1,
     },
   'packages/peach-cloud-box/src/client.ts :: websocket :: url': {
-    category: 'rnx_cloud_box',
+    category: 'peach_cloud_box',
     count: 1,
   },
   // a micro box's own Browser Run session, over the worker's BROWSER binding.
@@ -250,13 +250,13 @@ export const DECLARED_OUTBOUND_CALLS: Record<string, OutboundCallDeclaration> =
   // is a placeholder that exists only so URL can parse the search parameters.
   // nothing leaves Cloudflare and no project content is sent.
   'packages/peach-cloud-box/src/browser-run.ts :: fetch :: sessionEndpoint(undefined, { keepAliveMs, includeTargets: true })':
-    { category: 'rnx_cloud_box', count: 1 },
+    { category: 'peach_cloud_box', count: 1 },
   'packages/peach-cloud-box/src/browser-run.ts :: fetch :: `https://browser.invalid/v1/devtools/browser/${sessionId}/json/list`':
-    { category: 'rnx_cloud_box', count: 1 },
+    { category: 'peach_cloud_box', count: 1 },
   // twice: closing the session, and the CDP websocket upgrade that navigates a
   // target. both address the same session over the same binding.
   'packages/peach-cloud-box/src/browser-run.ts :: fetch :: `https://browser.invalid/v1/devtools/browser/${sessionId}`':
-    { category: 'rnx_cloud_box', count: 2 },
+    { category: 'peach_cloud_box', count: 2 },
   // the account's own session meter: starting, listing and heartbeating the
   // session a cloud box is billed against. no project content.
   "packages/peach-cloud-box/src/client.ts :: fetch :: `${options.apiOrigin.replace(/\\/+$/, '')}/api/v1/rnx/sessions${ options.accountId ? `?accountId=${encodeURIComponent()}` : '' }`":
@@ -265,7 +265,7 @@ export const DECLARED_OUTBOUND_CALLS: Record<string, OutboundCallDeclaration> =
     category: 'contrast_user_action',
     count: 1,
   },
-  // `rnx box connect` asks the account service which box that ID or name is
+  // `peach box connect` asks the account service which box that ID or name is
   // and for the box's own token. the account is the only thing that knows, so
   // this is the one call that turns a name into an authorized Box reference.
   'packages/peach-cloud-box/src/client.ts :: fetch :: connectUrl': {
@@ -325,6 +325,8 @@ export const DECLARED_OUTBOUND_CALLS: Record<string, OutboundCallDeclaration> =
     { category: 'contrast_user_action', count: 1 },
   'packages/peach-engine/src/auth/shared-session.ts :: fetch :: `${CONTRAST_ORIGIN}/api/auth/me`':
     { category: 'contrast_user_action', count: 1 },
+  'packages/peach-engine/src/auth/shared-session.ts :: fetch :: `${CONTRAST_ORIGIN}/api/preview/pair-token`':
+    { category: 'contrast_user_action', count: 1 },
   'packages/peach-engine/src/auth/shared-session.ts :: fetch :: `${CONTRAST_ORIGIN}/api/auth/sign-out`':
     { category: 'contrast_user_action', count: 1 },
   "packages/peach-engine/src/billing/client.ts :: fetch :: apiUrl('/api/sootsim/billing/checkout')":
@@ -404,7 +406,7 @@ export const DECLARED_OUTBOUND_CALLS: Record<string, OutboundCallDeclaration> =
     count: 2,
   },
   // the path is a parameter so one uploader serves both callers: recordings use
-  // /api/preview/upload/{init,finalize} (the default) and `rnx preview` passes
+  // /api/preview/upload/{init,finalize} (the default) and `peach preview` passes
   // /api/v1/previews{,/finalize}. both are first-party contrast endpoints.
   'packages/peach-engine/src/preview/presigned-upload.ts :: fetch :: `${origin}${endpoints.finalize}`':
     { category: 'contrast_user_action', count: 1 },

package/cli/parse-args.ts

@@ -35,7 +35,7 @@ const GLOBAL_FLAGS: Record<
 // whether it takes a value. a command that rejects unknown flags uses this to
 // tell a genuinely unknown flag apart from a global one typed after the
 // command, where nothing reads it, and to show how to pass that one: telling
-// someone to write `rnx --verbose <value>` earns them a second error.
+// someone to write `peach --verbose <value>` earns them a second error.
 export const GLOBAL_FLAG_TAKES_VALUE: ReadonlyMap<string, boolean> = new Map(
   Object.entries(GLOBAL_FLAGS).flatMap(([name, def]): [string, boolean][] => {
     const takesValue = def.type !== 'boolean'
@@ -50,9 +50,9 @@ export const GLOBAL_FLAG_TAKES_VALUE: ReadonlyMap<string, boolean> = new Map(
 
 // top-level verbs that route into runInspect. the surface is intentionally
 // tiny — everything else lives under one of the grouping verbs:
-//   - `rnx get <noun>`        reads
-//   - `rnx do <action>`       writes
-//   - `rnx debug <tool>`      instrumentation (handled by runDebug)
+//   - `peach get <noun>`        reads
+//   - `peach do <action>`       writes
+//   - `peach debug <tool>`      instrumentation (handled by runDebug)
 // `describe` and `find` stay at root as the most common entrypoints.
 // `list` stays at root because it's a sim-management read.
 export const TOP_LEVEL_RUNTIME_COMMANDS = new Set([
@@ -67,9 +67,9 @@ export const TOP_LEVEL_RUNTIME_COMMANDS = new Set([
   'shell',
 ])
 
-// grouping verbs that take a sub-verb (`rnx wait ready`,
-// `rnx do tap-id`). agents and humans very often type the hyphenated
-// form (`rnx wait-ready`, `rnx do-tap-id`) — it reads as one
+// grouping verbs that take a sub-verb (`peach wait ready`,
+// `peach do tap-id`). agents and humans very often type the hyphenated
+// form (`peach wait-ready`, `peach do-tap-id`) — it reads as one
 // command and matches the typed-tool names (rnx_wait_ready). bin.ts
 // normalizes `<verb>-<rest>` → `<verb> <rest>` for these so the intuitive
 // spelling just works instead of failing as "unknown command".

package/cli/privacy.ts

@@ -42,7 +42,7 @@ export async function ensurePrivacyChoice(options: {
   }
 
   const allowed = await confirm(
-    'Share anonymous package incompatibilities and error classes to improve rnx?',
+    'Share anonymous package incompatibilities and error classes to improve peach?',
     false,
   )
   // the engine's historical analytics and crash transports carry broader

package/cli/recording-access.ts

@@ -24,7 +24,7 @@ async function billingOriginFor(auth: CliAuth, originOverride?: string): Promise
   if (shared?.origin) {
     return shared.origin.replace(/\/$/, '')
   }
-  // api-key auth (RNX_API_KEY) carries no origin.
+  // api-key auth (PEACH_API_KEY) carries no origin.
   // resolve it the same way the upload itself does — probe a local Contrast
   // stack on :3000, else fall back to prod. this keeps the entitlement
   // check pointed at the *same* origin the recording will upload to (the
@@ -42,7 +42,7 @@ export interface RecordingEntitlementOptions {
    *  origin stored in the shared desktop session. */
   originOverride?: string
   /** allow GitHub installation/action auth to record for pr preview uploads.
-   *  this is intentionally opt-in so local `rnx record` stays tied to
+   *  this is intentionally opt-in so local `peach record` stays tied to
    *  the user's paid/trial desktop entitlement. */
   allowGitHubAuth?: boolean
 }
@@ -54,10 +54,10 @@ export async function ensureCliRecordingEntitlement(
   const auth = resolveCliAuth()
   if (!auth) {
     process.stderr.write(
-      `\n  rnx ${commandLabel} needs auth before it can check recording access.\n\n` +
+      `\n  peach  needs auth before it can check recording access.\n\n` +
         `  pick one:\n` +
-        `    • run \`rnx login\`\n` +
-        `    • set RNX_API_KEY=sk_rnx_... (recommended for CI)\n\n`,
+        `    • run \`peach login\`\n` +
+        `    • set PEACH_API_KEY=sk_rnx_... (recommended for CI)\n\n`,
     )
     rnxExit(1)
   }
@@ -72,7 +72,7 @@ export async function ensureCliRecordingEntitlement(
     })
   } catch (error) {
     process.stderr.write(
-      `\n  rnx ${commandLabel} couldn't verify recording access.\n` +
+      `\n  peach  couldn't verify recording access.\n` +
         `  ${error instanceof Error ? error.message : String(error)}\n\n`,
     )
     rnxExit(1)
@@ -80,8 +80,8 @@ export async function ensureCliRecordingEntitlement(
 
   if (res.status === 401) {
     process.stderr.write(
-      `\n  rnx ${commandLabel} couldn't verify recording access with the current auth against ${billingOrigin}.\n` +
-        `  sign in again for that origin, or provide a valid RNX_API_KEY.\n\n`,
+      `\n  peach  couldn't verify recording access with the current auth against ${billingOrigin}.\n` +
+        `  sign in again for that origin, or provide a valid PEACH_API_KEY.\n\n`,
     )
     rnxExit(1)
   }
@@ -89,7 +89,7 @@ export async function ensureCliRecordingEntitlement(
   if (!res.ok) {
     const text = await res.text().catch(() => '')
     process.stderr.write(
-      `\n  rnx ${commandLabel} couldn't verify recording access (${res.status}).\n` +
+      `\n  peach  couldn't verify recording access (${res.status}).\n` +
         `  ${text || 'unexpected billing response'}\n\n`,
     )
     rnxExit(1)
@@ -100,7 +100,7 @@ export async function ensureCliRecordingEntitlement(
 
   const plan = data.plan ?? 'free'
   process.stderr.write(
-    `\n  rnx ${commandLabel} recording requires Personal, Team, or an active trial.\n` +
+    `\n  peach  recording requires Personal, Team, or an active trial.\n` +
       `  current plan: ${plan}.\n` +
       `  free keeps basic 3d mode; the trial unlocks the full Personal surface.\n\n`,
   )

package/cli/resolve-assets.ts

@@ -1,4 +1,4 @@
-// resolve rnx's bundled assets (fonts, icons, sounds)
+// resolve peach's bundled assets (fonts, icons, sounds)
 // regardless of how the package was installed (source checkout, npm install, bunx).
 //
 // uses import.meta.url to derive the package root, then checks both
@@ -48,7 +48,7 @@ export function resolveAssets(): SootSimAssets {
   const soundsDir = resolve(publicDir, 'sounds')
 
   if (!existsSync(fontsDir)) {
-    console.warn(`[rnx] warning: fonts directory not found at ${fontsDir}`)
+    console.warn(`[peach] warning: fonts directory not found at ${fontsDir}`)
   }
 
   return {