rnxsim 0.1.368 → 0.1.370

package/cli/commands/inspect.ts

@@ -17,6 +17,7 @@ import { rememberFlowCandidate } from '../flow-session'
 import { maybeHint } from '../hints'
 import { shouldPrintInspectNotice } from '../inspect-notice-state'
 import { TOP_LEVEL_RUNTIME_COMMANDS } from '../parse-args'
+import { rethrowIfExit, rnxExit } from '../run-rnx'
 import {
   callInBridge,
   callInBridgeWrite,
@@ -829,12 +830,12 @@ async function requireVisualKeyboard(bridge: WsBridge, actionLabel: string) {
     console.error(
       `  ${actionLabel} requires a focused editable control. the iOS keyboard is visible, but no input owns focus.`,
     )
-    process.exit(1)
+    rnxExit(1)
   }
   console.error(
     `  ${actionLabel} requires the iOS keyboard to be visible. focus an input first with rnx do tap-id/tap-text or rnx do type-into.`,
   )
-  process.exit(1)
+  rnxExit(1)
 }
 
 async function runShellVisualCommand(
@@ -1132,7 +1133,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
       const groupHelp = renderCliGroupHelp(invocationPrefix, docContext)
       if (groupHelp) {
         console.log(`${groupHelp}\n`)
-        process.exit(0)
+        rnxExit(0)
       }
     }
 
@@ -1140,7 +1141,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
       const shellHelp = renderCliCommandHelp('shell', docContext)
       if (shellHelp) {
         console.log(`${shellHelp}\n`)
-        process.exit(0)
+        rnxExit(0)
       }
     }
 
@@ -1150,7 +1151,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
       .filter((s): s is string => s != null)
       .join('\n\n')
     console.log(`${groupSections}\n`)
-    process.exit(0)
+    rnxExit(0)
   }
 
   const wsPort = parsed.wsPort
@@ -1593,7 +1594,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
     (args.includes('--verbose') || args.includes('-v')) && !args.includes('--json')
   if (invocationPrefix === 'do' && subcommand === 'shell') {
     console.error('  `rnx do shell` was removed. use `rnx shell ...` instead.')
-    process.exit(1)
+    rnxExit(1)
   }
   if (writeCommands.has(subcommand)) {
     await checkSimHealth(bridge)
@@ -1804,7 +1805,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
           console.error(
             '  samples an averaged color from the canvas. coords are logical rnx units.',
           )
-          process.exit(1)
+          rnxExit(1)
         }
         const result = await bridge.send({
           type: 'evaluate',
@@ -1837,7 +1838,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         if (!matcher) {
           console.error(inspectUsage('node', '<matcher>'))
           console.error('  resolves testID, id, then text — dumps full node info as JSON')
-          process.exit(1)
+          rnxExit(1)
         }
         // resolve in order: testID → id → text. first hit wins, includes the
         // resolved transform and a parent chain so agents can skip the usual
@@ -1940,11 +1941,11 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             if (target.mode === 'testid') {
               maybeHint('wait-selector-for-missing-testid', target.value)
             }
-            process.exit(1)
+            rnxExit(1)
           }
           if (!isTapSuccess(outcome.result)) {
             printTapFailure(`${target.mode} "${target.value}"`, outcome)
-            process.exit(1)
+            rnxExit(1)
           }
           const candidate = buildTapCandidateFromResult(
             payload.cx,
@@ -1970,7 +1971,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
           console.error(
             inspectUsage('tap', '<testid> | <x> <y> | --testid <id> | --text <t>'),
           )
-          process.exit(1)
+          rnxExit(1)
         }
         const result = await tapCoordinates(bridge, x, y)
         const candidate = buildTapCandidateFromResult(x, y, result)
@@ -2000,7 +2001,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
           !Number.isFinite(stepMs)
         ) {
           console.error(inspectUsage(subcommand, '<x1> <y1> <x2> <y2> [steps] [stepMs]'))
-          process.exit(1)
+          rnxExit(1)
         }
         const result = await performSingleStep(bridge, {
           type: 'drag',
@@ -2061,7 +2062,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
               "<x1> <y1> <x2> <y2> <x1'> <y1'> <x2'> <y2'> [steps] [stepMs]",
             ),
           )
-          process.exit(1)
+          rnxExit(1)
         }
         const result = await performSingleStep(bridge, {
           type: 'pinch',
@@ -2098,7 +2099,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         const query = positional[1]
         if (!query) {
           console.error(inspectUsage('tap-text', '<text>'))
-          process.exit(1)
+          rnxExit(1)
         }
 
         const findFlagValue = (name: string): string | null => {
@@ -2111,7 +2112,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         const nthIndex = nthArg !== null ? Number(nthArg) : null
         if (nthIndex !== null && !Number.isFinite(nthIndex)) {
           console.error(`  --nth/--index requires an integer, got: ${nthArg}`)
-          process.exit(1)
+          rnxExit(1)
         }
         const within = findFlagValue('--within')
         const roleFlag = findFlagValue('--role')
@@ -2129,7 +2130,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         ] as const) {
           if (val !== null && !Number.isFinite(Number(val))) {
             console.error(`  ${flag} requires a number, got: ${val}`)
-            process.exit(1)
+            rnxExit(1)
           }
         }
         const nearIdx = args.indexOf('--near')
@@ -2139,7 +2140,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
           const ny = Number(args[nearIdx + 2])
           if (!Number.isFinite(nx) || !Number.isFinite(ny)) {
             console.error('  --near requires two numbers: --near <x> <y>')
-            process.exit(1)
+            rnxExit(1)
           }
           near = { x: nx, y: ny }
         }
@@ -2164,7 +2165,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
 
         if (payload?.error === 'bridge-not-ready') {
           console.error('  rnx test bridge not ready')
-          process.exit(1)
+          rnxExit(1)
         }
 
         if (payload?.ambiguous) {
@@ -2213,23 +2214,23 @@ export async function runInspect(args: string[], opts: InspectOptions) {
           console.error(
             '    --first                 keep the old pick-first-silently behavior',
           )
-          process.exit(2)
+          rnxExit(2)
         }
 
         if (payload?.nthOutOfRange) {
           console.error(
             `  not found: nth ${payload.nth} of ${payload.total} match${payload.total === 1 ? '' : 'es'} for "${query}"`,
           )
-          process.exit(1)
+          rnxExit(1)
         }
 
         if (!payload || typeof payload.cx !== 'number') {
           console.error(`  not found: ${query}`)
-          process.exit(1)
+          rnxExit(1)
         }
         if (!isTapSuccess(outcome.result)) {
           printTapFailure(`text "${query}"`, outcome)
-          process.exit(1)
+          rnxExit(1)
         }
         const candidate = buildTapCandidateFromNode(
           query,
@@ -2289,7 +2290,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         const query = positional[1]
         if (!query) {
           console.error(inspectUsage('tap-best', '<query>'))
-          process.exit(1)
+          rnxExit(1)
         }
         const outcome = await tapBest(bridge, query, { agent: isAgentEnv() })
         const payload = outcome.payload as
@@ -2312,22 +2313,22 @@ export async function runInspect(args: string[], opts: InspectOptions) {
           console.error(
             `  tap-best: no testID or visible text matched "${query}". try \`rnx find --interactive-targets\` to list candidates.`,
           )
-          process.exit(1)
+          rnxExit(1)
         }
         if ('error' in payload) {
           console.error(`  ${payload.error}`)
-          process.exit(1)
+          rnxExit(1)
         }
         if (payload.strategy === 'none') {
           console.error(
             `  tap-best: no testID or visible text matched "${query}". try \`rnx find --interactive-targets\` to list candidates.`,
           )
-          process.exit(1)
+          rnxExit(1)
         }
         const node = payload.node
         if (!isTapSuccess(outcome.result)) {
           printTapFailure(`best "${query}"`, outcome)
-          process.exit(1)
+          rnxExit(1)
         }
         const candidate = buildTapCandidateFromNode(
           query,
@@ -2367,7 +2368,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         const query = positional[1]
         if (!query) {
           console.error(inspectUsage('tap-id', '<id>'))
-          process.exit(1)
+          rnxExit(1)
         }
 
         const outcome = await tapById(bridge, query, { agent: isAgentEnv() })
@@ -2378,11 +2379,11 @@ export async function runInspect(args: string[], opts: InspectOptions) {
           // nearby testIDs in the live tree so the agent can pick the
           // intended one without dumping the whole tree first.
           await printSimilarTestIds(bridge, query)
-          process.exit(1)
+          rnxExit(1)
         }
         if (!isTapSuccess(outcome.result)) {
           printTapFailure(`id "${query}"`, outcome)
-          process.exit(1)
+          rnxExit(1)
         }
         const candidate = buildTapCandidateFromNode(
           query,
@@ -2426,7 +2427,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         const text = positional.slice(2).join(' ')
         if (!targetId || !text) {
           console.error(inspectUsage('type-into', '<id> <text>'))
-          process.exit(1)
+          rnxExit(1)
         }
         // step 1: find the element
         const tiArg = JSON.stringify(targetId)
@@ -2451,7 +2452,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         })
         if (!tiPayload || typeof tiPayload.cx !== 'number') {
           console.error(`  not found: ${targetId}`)
-          process.exit(1)
+          rnxExit(1)
         }
         if (!tiPayload.isTextInput) {
           console.error(`  warning: ${targetId} is not a text input (isTextInput: false)`)
@@ -2475,7 +2476,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         })
         if (!keyboardState.visible) {
           console.error(`  keyboard did not open after tapping ${targetId}`)
-          process.exit(1)
+          rnxExit(1)
         }
         // step 2.5: confirm the tap actually focused the requested input.
         // the keyboard being visible is necessary but not sufficient — a
@@ -2495,7 +2496,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
                 focusCheck.testID ?? focusCheck.id ?? null,
               )}. did the tap land on an outer Pressable wrapper?`,
             )
-            process.exit(1)
+            rnxExit(1)
           }
         }
         // step 3: type through the visible keyboard so key pop animations render
@@ -2544,7 +2545,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         const text = positional.slice(1).join(' ')
         if (!text) {
           console.error(inspectUsage('type', '<text>'))
-          process.exit(1)
+          rnxExit(1)
         }
         const keyboardState = await requireVisualKeyboard(bridge, 'type')
         await bridge.send({ type: 'keyboard', action: 'type', text })
@@ -2568,7 +2569,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         const name = positional[1]
         if (!name) {
           console.error(inspectUsage('key', '<name>'))
-          process.exit(1)
+          rnxExit(1)
         }
         await requireVisualKeyboard(bridge, 'key')
         await bridge.send({ type: 'keyboard', action: 'press', text: name })
@@ -2581,7 +2582,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         const keys = positional.slice(1)
         if (keys.length === 0) {
           console.error(inspectUsage('key-sequence', '<key> [<key> ...]'))
-          process.exit(1)
+          rnxExit(1)
         }
         await requireVisualKeyboard(bridge, 'key-sequence')
         for (const key of keys) {
@@ -2600,7 +2601,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         const codes = positional.slice(1)
         if (codes.length === 0) {
           console.error(inspectUsage('keycode', '<code> [<code> ...]'))
-          process.exit(1)
+          rnxExit(1)
         }
         const keys = codes.map((code) => ({ code, key: keyCodeToVisualKey(code) }))
         const unsupported = keys.filter((entry) => !entry.key)
@@ -2608,7 +2609,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
           console.error(
             `  unsupported keycode(s): ${unsupported.map((entry) => entry.code).join(', ')}`,
           )
-          process.exit(1)
+          rnxExit(1)
         }
         await requireVisualKeyboard(bridge, 'keycode')
         for (const entry of keys) {
@@ -2627,7 +2628,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         const ch = positional[1]
         if (!ch) {
           console.error(inspectUsage('dispatch', '<char>'))
-          process.exit(1)
+          rnxExit(1)
         }
         await bridge.send({ type: 'keyboard', action: 'dispatchKey', text: ch })
         await recordInspectAction(
@@ -2661,7 +2662,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             if (target.mode === 'testid') {
               maybeHint('wait-selector-for-missing-testid', target.value)
             }
-            process.exit(1)
+            rnxExit(1)
           }
           x = resolved.x
           y = resolved.y
@@ -2671,7 +2672,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
           console.error(
             inspectUsage('double-tap', '<testid> | <x> <y> [gapMs] | --testid <id>'),
           )
-          process.exit(1)
+          rnxExit(1)
         }
         const waitMs = Math.max(0, Math.round(gapMs))
         const single = await performSingleStep(bridge, {
@@ -2708,7 +2709,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             if (target.mode === 'testid') {
               maybeHint('wait-selector-for-missing-testid', target.value)
             }
-            process.exit(1)
+            rnxExit(1)
           }
           x = resolved.x
           y = resolved.y
@@ -2724,7 +2725,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
           console.error(
             inspectUsage('long-press', '<testid> | <x> <y> [durationMs] | --testid <id>'),
           )
-          process.exit(1)
+          rnxExit(1)
         }
         const roundedDurationMs = Math.max(0, Math.round(durationMs))
         const result = await bridge.send({
@@ -2764,13 +2765,13 @@ export async function runInspect(args: string[], opts: InspectOptions) {
           console.error(
             inspectUsage('touch', '<down|move|up|cancel> <x> <y> [pointerId]'),
           )
-          process.exit(1)
+          rnxExit(1)
         }
         if (phase !== 'cancel' && (!Number.isFinite(x) || !Number.isFinite(y))) {
           console.error(
             inspectUsage('touch', '<down|move|up|cancel> <x> <y> [pointerId]'),
           )
-          process.exit(1)
+          rnxExit(1)
         }
         // the engine's perform executor emits the matching agent-cursor
         // action (tap for down, move for move) natively.
@@ -2808,12 +2809,12 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         if (!preset || !Number.isFinite(durationMs)) {
           console.error(inspectUsage('gesture', '<preset> [durationMs]'))
           console.error(`  presets: ${GESTURE_PRESETS.join(', ')}`)
-          process.exit(1)
+          rnxExit(1)
         }
         if (!(GESTURE_PRESETS as readonly string[]).includes(preset)) {
           console.error(`  unknown gesture preset: ${preset}`)
           console.error(`  presets: ${GESTURE_PRESETS.join(', ')}`)
-          process.exit(1)
+          rnxExit(1)
         }
         const frame = await bridge.send({
           type: 'evaluate',
@@ -2930,7 +2931,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
               '<id> <x> <y> | --testid <id> <x> <y> | --node-id <nodeId> <x> <y>',
             ),
           )
-          process.exit(1)
+          rnxExit(1)
         }
         // look up node position first so agent cursor can animate there
         const scrollNode = await bridge.send({
@@ -3105,7 +3106,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             const id = positional[2]
             if (!id) {
               console.error(`  usage: ${inspectCommand('state')} node <id>`)
-              process.exit(1)
+              rnxExit(1)
             }
             result =
               (await callTestBridge(bridge, 'findByTestId', id)) ||
@@ -3116,7 +3117,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             const id = positional[2]
             if (!id) {
               console.error(`  usage: ${inspectCommand('state')} scroll <id>`)
-              process.exit(1)
+              rnxExit(1)
             }
             result = await callTestBridge(bridge, 'getScrollState', id)
             break
@@ -3126,7 +3127,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             const y = Number(positional[3])
             if (!Number.isFinite(x) || !Number.isFinite(y)) {
               console.error(`  usage: ${inspectCommand('state')} scroll-hit <x> <y>`)
-              process.exit(1)
+              rnxExit(1)
             }
             result = await callTestBridge(bridge, 'getScrollStateAt', x, y)
             break
@@ -3136,7 +3137,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             const y = Number(positional[3])
             if (!Number.isFinite(x) || !Number.isFinite(y)) {
               console.error(`  usage: ${inspectCommand('state')} hit <x> <y>`)
-              process.exit(1)
+              rnxExit(1)
             }
             result = await callTestBridge(bridge, 'debugHitAt', x, y)
             break
@@ -3146,7 +3147,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             const y = Number(positional[3])
             if (!Number.isFinite(x) || !Number.isFinite(y)) {
               console.error(`  usage: ${inspectCommand('state')} gesture <x> <y>`)
-              process.exit(1)
+              rnxExit(1)
             }
             result = await callTestBridge(bridge, 'debugGestureAt', x, y)
             break
@@ -3191,7 +3192,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             break
           default:
             console.error(`  unknown state subcommand: ${stateCmd}`)
-            process.exit(1)
+            rnxExit(1)
         }
         console.log(JSON.stringify(result, null, 2))
         break
@@ -3247,7 +3248,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
                 : '<home|switcher> [settleMs]',
             ),
           )
-          process.exit(1)
+          rnxExit(1)
         }
 
         let ok = false
@@ -3260,7 +3261,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             console.error(
               inspectUsage('shell', 'launch <appId> [settleMs] [--clear-state]'),
             )
-            process.exit(1)
+            rnxExit(1)
           }
           if (clearState) {
             await bridge.send({
@@ -3325,7 +3326,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
           const appId = positional[2]
           if (!appId) {
             console.error(inspectUsage('shell', 'open-card <appId> [settleMs]'))
-            process.exit(1)
+            rnxExit(1)
           }
           ok = !!(await callShellCommandWhenReady(
             bridge,
@@ -3358,7 +3359,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
           const mode = positional[2]
           if (!mode || !['light', 'dark', 'auto', 'toggle'].includes(mode)) {
             console.error(inspectUsage('shell', 'appearance <light|dark|auto|toggle>'))
-            process.exit(1)
+            rnxExit(1)
           }
           const result = await runShellVisualCommand(bridge, 'appearance', mode)
           ok = !!result?.ok
@@ -3376,7 +3377,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
           state = { [shellCmd]: result }
         } else {
           console.error(`  unknown shell subcommand: ${shellCmd}`)
-          process.exit(1)
+          rnxExit(1)
         }
         console.log(JSON.stringify({ ok, settled, state }, null, 2))
         break
@@ -3620,7 +3621,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             `    ${inspectCommand('js')} SootSim.bridges.keyboard.type("hello")`,
           )
           console.error(`    ${inspectCommand('js')} SootSim.state.root.children.length`)
-          process.exit(1)
+          rnxExit(1)
         }
         // --tenant: evaluate inside the TENANT worker's global scope (guest
         // bundle, metro module table, compat stubs) via the test bridge's
@@ -3741,7 +3742,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
       case 'perf': {
         if (invocationPrefix === 'debug' && !opts.internalPerfCommand) {
           console.error('  `rnx debug perf` was removed. use `rnx perf shell ...`.')
-          process.exit(1)
+          rnxExit(1)
         }
         const perfCmd = positional[1]
         if (opts.internalPerfCommand === 'scroll') {
@@ -3772,7 +3773,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             const parsedLimit = limitValue === undefined ? 6000 : Number(limitValue)
             if (!Number.isFinite(parsedLimit) || parsedLimit < 120) {
               console.error('  error: --limit must be a number of at least 120')
-              process.exit(1)
+              rnxExit(1)
             }
             const result = await bridge.send({
               type: 'evaluate',
@@ -3785,7 +3786,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             })
             if (result?.error) {
               console.error(`  error: ${result.error}`)
-              process.exit(1)
+              rnxExit(1)
             }
             console.log(
               `  scroll profiling started: perform consecutive swipes, then run '${inspectCommand('perf')} stop'`,
@@ -3803,7 +3804,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             })
             if (result?.error) {
               console.error(`  error: ${result.error}`)
-              process.exit(1)
+              rnxExit(1)
             }
             const trace: SootSimScrollPerformanceTrace = result
             if (wantsJson(effectiveArgs)) {
@@ -3844,7 +3845,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             break
           }
           console.error(`  unknown scroll perf command: ${perfCmd}`)
-          process.exit(1)
+          rnxExit(1)
         }
         if (!perfCmd || perfCmd === '--help' || perfCmd === '-h') {
           console.log(`
@@ -3885,7 +3886,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             })
             if (result?.error) {
               console.error(`  error: ${result.error}`)
-              process.exit(1)
+              rnxExit(1)
             }
             console.log(
               `  shell profiling started — interact with the app, then run '${inspectCommand('perf')} stop'`,
@@ -3910,7 +3911,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
                   '  (shell worker did not answer within 5s — is a sim loaded?)',
                 )
               }
-              process.exit(1)
+              rnxExit(1)
             }
             if (wantsJson(effectiveArgs)) {
               printJson(result)
@@ -3966,7 +3967,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             })
             if (result?.error) {
               console.error(`  error: ${result.error}`)
-              process.exit(1)
+              rnxExit(1)
             }
             if (wantsJson(effectiveArgs)) {
               printJson(result)
@@ -3999,7 +4000,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
                 `  use 'perf start' / 'perf stop' (worst frames are in the stop report).`,
               )
             }
-            process.exit(1)
+            rnxExit(1)
         }
         break
       }
@@ -4104,12 +4105,12 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         const raw = positional[1]
         if (!raw || raw === '--help' || raw === '-h') {
           console.error(`  usage: ${inspectCommand('animation')} <id>`)
-          process.exit(1)
+          rnxExit(1)
         }
         const id = Number(raw)
         if (!Number.isFinite(id)) {
           console.error(`  invalid id: ${raw}`)
-          process.exit(1)
+          rnxExit(1)
         }
         const result = await callTestBridge(bridge, 'getAnimation', id)
         console.log(JSON.stringify(result, null, 2))
@@ -4120,12 +4121,12 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         const raw = positional[1]
         if (!raw || raw === '--help' || raw === '-h') {
           console.error(`  usage: ${inspectCommand('stop-animation')} <id|all>`)
-          process.exit(1)
+          rnxExit(1)
         }
         const target: number | 'all' = raw === 'all' ? 'all' : Number(raw)
         if (target !== 'all' && !Number.isFinite(target)) {
           console.error(`  invalid id: ${raw}`)
-          process.exit(1)
+          rnxExit(1)
         }
         const count = await callTestBridge<number>(bridge, 'stopAnimation', target)
         console.log(`  stopped ${count ?? 0} animation(s)`)
@@ -4228,7 +4229,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
           const id = positional[2]
           if (!id) {
             console.error('  usage: rnx network get <id>')
-            process.exit(1)
+            rnxExit(1)
           }
           const entry = (await bridge.send({
             type: 'evaluate',
@@ -4240,7 +4241,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
           })) as NetworkEntryPayload | null
           if (!entry) {
             console.error(`  no entry with id ${id}`)
-            process.exit(1)
+            rnxExit(1)
           }
           if (jsonOut) {
             console.log(JSON.stringify(entry, null, 2))
@@ -4259,7 +4260,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             `  invalid limit: ${sub} — \`network\` takes a numeric count (e.g. ${inspectCommand('network')} 100).\n` +
               `  to target a specific sim, use \`--sim ${sub}\` instead.`,
           )
-          process.exit(1)
+          rnxExit(1)
         }
 
         const fetchEntries = async () => {
@@ -4428,7 +4429,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
             `  invalid limit: ${sub} — \`logs\` takes a numeric count (e.g. ${inspectCommand('logs')} 100).\n` +
               `  to target a specific sim, use \`--sim ${sub}\` instead.`,
           )
-          process.exit(1)
+          rnxExit(1)
         }
 
         const fetchEntries = () => inspectLogs(bridge)
@@ -4486,7 +4487,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
 
       default:
         console.error(`  unknown subcommand: ${subcommand}`)
-        process.exit(1)
+        rnxExit(1)
     }
 
     // auto-settle after any write command so the next CLI call doesn't see
@@ -4529,6 +4530,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
       }
     }
   } catch (err: any) {
+    rethrowIfExit(err)
     const message = err instanceof Error ? err.message : String(err)
     console.error(`  ${subcommand ?? 'rnx'} failed: ${message}`)
     const unknownSim = /^no sim connected with id ([^;]+)(?:; connected sims: .+)?$/.exec(
@@ -4589,7 +4591,7 @@ export async function runInspect(args: string[], opts: InspectOptions) {
         // ignore secondary request summary errors while already failing the command
       }
     }
-    process.exit(1)
+    rnxExit(1)
   } finally {
     bridge.close()
   }