rnxsim 0.1.378 → 0.1.380

package/cli/commands/cpu-profile.ts

@@ -1,10 +1,10 @@
-// rnx perf cpu — capture a sampled CPU trace from the tenant worker.
+// rnx perf cpu — capture sampled CPU traces from the page and every worker.
 //
 // the JS Self-Profiler API (`new Profiler()`) cannot be constructed in a
 // dedicated-worker scope, and sootsim runs the guest app in the tenant worker,
 // so the old in-worker approach was unsupported (F28). this implementation
-// attaches Chromium's `Profiler` CDP domain to the worker target instead —
-// which works for workers and returns the .cpuprofile shape directly.
+// attaches Chromium's `Profiler` CDP domain to the page and worker targets —
+// which returns the .cpuprofile shape directly for every execution context.
 //
 // dedicated workers are not top-level CDP targets, so we connect to the page
 // target, `Target.setAutoAttach` to discover the worker child sessions, and
@@ -25,9 +25,12 @@
 // also drives the interaction itself lives at
 // scripts/debug/cdp-worker-cpu-profile.ts.
 
-import { mkdirSync, writeFileSync } from 'fs'
-import { dirname, resolve } from 'path'
+import { createHash } from 'node:crypto'
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { dirname, resolve } from 'node:path'
 import { WebSocket } from 'ws'
+import { getCliVersion } from '../../src/cli-version'
+import { IS_STANDALONE } from '../standalone'
 
 interface ProfileOptions {
   port?: number
@@ -41,8 +44,15 @@ const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms))
 class Cdp {
   private ws: WebSocket
   private nextId = 1
-  private pending = new Map<number, { res: (v: any) => void; rej: (e: any) => void }>()
-  private listeners = new Set<(method: string, params: any) => void>()
+  private pending = new Map<
+    number,
+    {
+      res: (v: any) => void
+      rej: (e: any) => void
+      timeout: ReturnType<typeof setTimeout>
+    }
+  >()
+  private listeners = new Set<(method: string, params: any, sessionId?: string) => void>()
   private ready: Promise<void>
 
   constructor(wsUrl: string) {
@@ -54,12 +64,20 @@ class Cdp {
     this.ws.on('message', (data) => {
       const msg = JSON.parse(data.toString())
       if (msg.id && this.pending.has(msg.id)) {
-        const { res, rej } = this.pending.get(msg.id)!
+        const { res, rej, timeout } = this.pending.get(msg.id)!
         this.pending.delete(msg.id)
+        clearTimeout(timeout)
         msg.error ? rej(new Error(JSON.stringify(msg.error))) : res(msg.result)
       } else if (msg.method) {
-        for (const l of this.listeners) l(msg.method, msg.params)
+        for (const l of this.listeners) l(msg.method, msg.params, msg.sessionId)
+      }
+    })
+    this.ws.on('close', () => {
+      for (const [id, request] of this.pending) {
+        clearTimeout(request.timeout)
+        request.rej(new Error(`CDP connection closed with request ${id} pending`))
       }
+      this.pending.clear()
     })
   }
 
@@ -67,7 +85,7 @@ class Cdp {
     return this.ready
   }
 
-  on(l: (method: string, params: any) => void) {
+  on(l: (method: string, params: any, sessionId?: string) => void) {
     this.listeners.add(l)
   }
 
@@ -78,7 +96,11 @@ class Cdp {
   ): Promise<any> {
     const id = this.nextId++
     return new Promise((res, rej) => {
-      this.pending.set(id, { res, rej })
+      const timeout = setTimeout(() => {
+        this.pending.delete(id)
+        rej(new Error(`CDP ${method} timed out after 5s`))
+      }, 5_000)
+      this.pending.set(id, { res, rej, timeout })
       this.ws.send(
         JSON.stringify({ id, method, params, ...(sessionId ? { sessionId } : {}) }),
       )
@@ -94,10 +116,135 @@ class Cdp {
 
 interface CdpTarget {
   type: string
+  title?: string
   url: string
   webSocketDebuggerUrl: string
 }
 
+interface AttachedTarget {
+  attachedAtMs: number
+  detached: boolean
+  detachedAtMs?: number
+  error?: string
+  profile?: any
+  profileStartedAtMs?: number
+  profileStoppedAtMs?: number
+  role: string
+  sessionId?: string
+  started: boolean
+  title: string
+  type: string
+  url: string
+}
+
+export interface CpuProfileInteractionBarrier {
+  marker: string
+  reachedAtEpochMs: number
+  releasedBy: string
+  releasedAtEpochMs: number
+}
+
+export interface CpuProfileCoverage {
+  coverageMs: number
+  coverageRatio: number
+  startedOffsetMs: number | null
+  stoppedOffsetMs: number | null
+}
+
+export function cpuProfileCoverage(
+  profileStartedAtMs: number | undefined,
+  profileStoppedAtMs: number | undefined,
+  windowStartedAtMs: number,
+  windowEndedAtMs: number,
+): CpuProfileCoverage {
+  const requestedMs = Math.max(0, windowEndedAtMs - windowStartedAtMs)
+  if (
+    profileStartedAtMs === undefined ||
+    profileStoppedAtMs === undefined ||
+    requestedMs === 0
+  ) {
+    return {
+      coverageMs: 0,
+      coverageRatio: 0,
+      startedOffsetMs:
+        profileStartedAtMs === undefined ? null : profileStartedAtMs - windowStartedAtMs,
+      stoppedOffsetMs:
+        profileStoppedAtMs === undefined ? null : profileStoppedAtMs - windowStartedAtMs,
+    }
+  }
+  const coverageMs = Math.max(
+    0,
+    Math.min(profileStoppedAtMs, windowEndedAtMs) -
+      Math.max(profileStartedAtMs, windowStartedAtMs),
+  )
+  return {
+    coverageMs,
+    coverageRatio: coverageMs / requestedMs,
+    startedOffsetMs: profileStartedAtMs - windowStartedAtMs,
+    stoppedOffsetMs: profileStoppedAtMs - windowStartedAtMs,
+  }
+}
+
+export function cpuProfileActionsWithinWindow(
+  actionEpochMs: readonly number[],
+  windowStartedAtEpochMs: number,
+  windowEndedAtEpochMs: number,
+): boolean {
+  return (
+    actionEpochMs.length > 0 &&
+    actionEpochMs.every(
+      (epochMs) =>
+        Number.isFinite(epochMs) &&
+        epochMs >= windowStartedAtEpochMs &&
+        epochMs <= windowEndedAtEpochMs,
+    )
+  )
+}
+
+export function cpuProfileInteractionBarrierValid(
+  barrier: CpuProfileInteractionBarrier | null,
+  windowStartedAtEpochMs: number,
+  windowEndedAtEpochMs: number,
+): boolean {
+  return (
+    barrier !== null &&
+    barrier.marker.length > 0 &&
+    barrier.releasedBy === 'profiler' &&
+    Number.isFinite(barrier.reachedAtEpochMs) &&
+    Number.isFinite(barrier.releasedAtEpochMs) &&
+    barrier.reachedAtEpochMs <= barrier.releasedAtEpochMs &&
+    barrier.releasedAtEpochMs >= windowStartedAtEpochMs &&
+    barrier.releasedAtEpochMs <= windowEndedAtEpochMs
+  )
+}
+
+function readInteractionBarrierState(
+  value: unknown,
+): CpuProfileInteractionBarrier | null {
+  if (!value || typeof value !== 'object') return null
+  const marker = Reflect.get(value, 'marker')
+  const reachedAtEpochMs = Reflect.get(value, 'reachedAtEpochMs')
+  const releasedBy = Reflect.get(value, 'releasedBy')
+  const releasedAtEpochMs = Reflect.get(value, 'releasedAtEpochMs')
+  if (
+    typeof marker !== 'string' ||
+    typeof reachedAtEpochMs !== 'number' ||
+    typeof releasedBy !== 'string' ||
+    typeof releasedAtEpochMs !== 'number'
+  ) {
+    return null
+  }
+  return { marker, reachedAtEpochMs, releasedBy, releasedAtEpochMs }
+}
+
+function readActionEpochs(value: unknown): number[] {
+  if (!Array.isArray(value)) return []
+  return value.filter(
+    (epochMs): epochMs is number =>
+      typeof epochMs === 'number' && Number.isFinite(epochMs),
+  )
+}
+
 export async function runCpuProfile(
   args: string[],
   opts: ProfileOptions,
@@ -108,6 +255,21 @@ export async function runCpuProfile(
     return 1
   }
   const sampleInterval = Number(valueOf(args, '--sample-interval') ?? '0.1') // ms
+  const interactionBarrierEnabled = args.includes('--interaction-barrier')
+  const interactionBarrierTimeoutSeconds = Number(
+    valueOf(args, '--interaction-barrier-timeout') ?? '90',
+  )
+  if (
+    !Number.isFinite(interactionBarrierTimeoutSeconds) ||
+    interactionBarrierTimeoutSeconds <= 0
+  ) {
+    console.error('  --interaction-barrier-timeout must be positive (seconds)')
+    return 1
+  }
+  const interactionBarrierLeaseMs = Math.min(
+    2_147_000_000,
+    Math.ceil((interactionBarrierTimeoutSeconds + duration + 5) * 1000),
+  )
   const cdpPort = Number(
     valueOf(args, '--cdp-port') ?? process.env.RNX_CDP_PORT ?? '9222',
   )
@@ -141,65 +303,396 @@ export async function runCpuProfile(
 
   const cdp = new Cdp(page.webSocketDebuggerUrl)
   await cdp.waitOpen()
+  let interactionBarrierInstalled = false
+  const evaluatePage = async (expression: string): Promise<unknown> => {
+    const response = await cdp.send('Runtime.evaluate', {
+      expression,
+      returnByValue: true,
+    })
+    if (response?.exceptionDetails) {
+      throw new Error(
+        `page evaluation failed: ${response.exceptionDetails.text ?? 'unknown error'}`,
+      )
+    }
+    return response?.result?.value
+  }
+  const releaseInteractionBarrier = (releasedBy: 'cleanup' | 'profiler') =>
+    evaluatePage(`(() => {
+      const release = Reflect.get(globalThis, '__sootsimReleaseCpuProfileBarrier')
+      return typeof release === 'function'
+        ? Reflect.apply(release, globalThis, [${JSON.stringify(releasedBy)}])
+        : null
+    })()`)
   try {
-    // discover worker child sessions via auto-attach.
-    const workers = new Map<string, string>() // sessionId -> url
+    if (interactionBarrierEnabled) {
+      const installed = await evaluatePage(`(() => {
+        const state = {
+          marker: null,
+          reachedAtEpochMs: null,
+          releasedBy: null,
+          releasedAtEpochMs: null,
+        }
+        let releaseGate = () => {}
+        const gate = new Promise((resolve) => {
+          releaseGate = resolve
+        })
+        Reflect.set(globalThis, '__sootsimCpuProfileBarrierState', state)
+        Reflect.set(globalThis, '__sootsimCpuProfileBarrier', async (marker) => {
+          if (state.marker === null) {
+            state.marker = String(marker)
+            state.reachedAtEpochMs = Date.now()
+          }
+          await gate
+        })
+        let lease = null
+        const releaseBarrier = (releasedBy) => {
+          if (state.releasedAtEpochMs === null) {
+            state.releasedAtEpochMs = Date.now()
+            state.releasedBy = String(releasedBy)
+            if (lease !== null) clearTimeout(lease)
+            releaseGate()
+          }
+          return { ...state }
+        }
+        lease = setTimeout(
+          () => releaseBarrier('lease'),
+          ${interactionBarrierLeaseMs},
+        )
+        Reflect.set(globalThis, '__sootsimReleaseCpuProfileBarrier', releaseBarrier)
+        return true
+      })()`)
+      if (installed !== true) {
+        console.error('  failed to install the interaction profile barrier')
+        return 1
+      }
+      interactionBarrierInstalled = true
+    }
+
+    // discover every child worker. keep detached entries in the manifest: a
+    // worker can exit during the capture, and deleting it used to make the
+    // command either mislabel the busiest survivor as "tenant" or lose the
+    // entire run when Profiler.stop hit the detached session first.
+    const workers = new Map<string, AttachedTarget>()
+    let captureStarted = false
+    let captureWindowClosed = false
+    const startPromises: Array<Promise<void>> = []
+    const discoveryPromises: Array<Promise<void>> = []
+    let attachmentGeneration = 0
+    let awaitedDiscoveryCount = 0
+    let awaitedStartCount = 0
+    const enableRecursiveAutoAttach = (sessionId?: string) =>
+      cdp.send(
+        'Target.setAutoAttach',
+        {
+          autoAttach: true,
+          waitForDebuggerOnStart: false,
+          flatten: true,
+        },
+        sessionId,
+      )
+    const startTarget = async (target: AttachedTarget) => {
+      try {
+        await cdp.send('Profiler.enable', {}, target.sessionId)
+        await cdp.send(
+          'Profiler.setSamplingInterval',
+          { interval: sampleInterval * 1000 },
+          target.sessionId,
+        )
+        await cdp.send('Profiler.start', {}, target.sessionId)
+        target.started = true
+        target.profileStartedAtMs = performance.now()
+      } catch (error) {
+        target.error = error instanceof Error ? error.message : String(error)
+      }
+    }
+    const waitForStableTargetSetup = async () => {
+      while (true) {
+        const observedGeneration = attachmentGeneration
+        if (awaitedDiscoveryCount < discoveryPromises.length) {
+          const pendingDiscoveries = discoveryPromises.slice(awaitedDiscoveryCount)
+          awaitedDiscoveryCount = discoveryPromises.length
+          await Promise.all(pendingDiscoveries)
+        }
+        if (awaitedStartCount < startPromises.length) {
+          const pendingStarts = startPromises.slice(awaitedStartCount)
+          awaitedStartCount = startPromises.length
+          await Promise.all(pendingStarts)
+        }
+        // recursive auto-attach notifications can arrive just after the CDP
+        // command resolves. require a quiet generation before releasing work.
+        await sleep(50)
+        if (
+          observedGeneration === attachmentGeneration &&
+          awaitedDiscoveryCount === discoveryPromises.length &&
+          awaitedStartCount === startPromises.length
+        ) {
+          return
+        }
+      }
+    }
     cdp.on((method, params) => {
       if (method === 'Target.attachedToTarget' && params.targetInfo?.type === 'worker') {
-        workers.set(params.sessionId, params.targetInfo.url)
+        if (captureWindowClosed) return
+        const sessionId = params.sessionId
+        const targetInfo = params.targetInfo
+        const target: AttachedTarget = {
+          attachedAtMs: performance.now(),
+          detached: false,
+          role: cpuProfileTargetRole(targetInfo.url, targetInfo.title),
+          sessionId,
+          started: false,
+          title: targetInfo.title ?? '',
+          type: targetInfo.type,
+          url: targetInfo.url,
+        }
+        workers.set(sessionId, target)
+        attachmentGeneration += 1
+        discoveryPromises.push(
+          enableRecursiveAutoAttach(sessionId).catch((error: unknown) => {
+            target.error = `recursive auto-attach failed: ${error instanceof Error ? error.message : String(error)}`
+          }),
+        )
+        if (captureStarted) startPromises.push(startTarget(target))
+      }
+      if (method === 'Target.detachedFromTarget') {
+        const target = workers.get(params.sessionId)
+        if (target) {
+          target.detached = true
+          target.detachedAtMs = performance.now()
+        }
       }
-      if (method === 'Target.detachedFromTarget') workers.delete(params.sessionId)
-    })
-    await cdp.send('Target.setAutoAttach', {
-      autoAttach: true,
-      waitForDebuggerOnStart: false,
-      flatten: true,
     })
+    await enableRecursiveAutoAttach()
     // auto-attach events arrive asynchronously after the call resolves.
     await sleep(500)
-    if (workers.size === 0) {
-      console.error('  no worker targets attached — is the app loaded in this tab?')
+    await waitForStableTargetSetup()
+    const pageTarget: AttachedTarget = {
+      attachedAtMs: performance.now(),
+      detached: false,
+      role: 'page',
+      started: false,
+      title: page.title ?? '',
+      type: 'page',
+      url: page.url,
+    }
+    if (interactionBarrierEnabled) {
+      console.log('  waiting for the workload interaction barrier…')
+      const deadline = performance.now() + interactionBarrierTimeoutSeconds * 1000
+      let reached = false
+      while (performance.now() < deadline) {
+        const value = await evaluatePage(`(() => {
+          const state = Reflect.get(globalThis, '__sootsimCpuProfileBarrierState')
+          if (!state || typeof state !== 'object') return null
+          return {
+            marker: Reflect.get(state, 'marker'),
+            reachedAtEpochMs: Reflect.get(state, 'reachedAtEpochMs'),
+          }
+        })()`)
+        if (
+          value &&
+          typeof value === 'object' &&
+          typeof Reflect.get(value, 'marker') === 'string' &&
+          typeof Reflect.get(value, 'reachedAtEpochMs') === 'number'
+        ) {
+          reached = true
+          break
+        }
+        await sleep(25)
+      }
+      if (!reached) {
+        console.error(
+          `  workload interaction barrier was not reached within ${interactionBarrierTimeoutSeconds}s`,
+        )
+        return 1
+      }
+    }
+    captureStarted = true
+    startPromises.push(startTarget(pageTarget))
+    for (const target of workers.values()) startPromises.push(startTarget(target))
+    await waitForStableTargetSetup()
+    const startedCount = [pageTarget, ...workers.values()].filter(
+      (target) => target.started,
+    ).length
+    if (startedCount === 0) {
+      console.error('  no CDP targets accepted Profiler.start')
       return 1
     }
-
-    for (const sid of workers.keys()) {
-      await cdp.send('Profiler.enable', {}, sid)
-      await cdp.send(
-        'Profiler.setSamplingInterval',
-        { interval: sampleInterval * 1000 },
-        sid,
-      ) // µs
-      await cdp.send('Profiler.start', {}, sid)
+    const captureWindowStartedAtMs = performance.now()
+    const captureWindowStartedAtEpochMs = Date.now()
+    const captureWindowEndedAtMs = captureWindowStartedAtMs + duration * 1000
+    const captureWindowEndedAtEpochMs = captureWindowStartedAtEpochMs + duration * 1000
+    const interactionBarrier = interactionBarrierEnabled
+      ? readInteractionBarrierState(await releaseInteractionBarrier('profiler'))
+      : null
+    if (opts.verbose) {
+      for (const target of [pageTarget, ...workers.values()]) {
+        console.log(
+          `  target ${target.role} ${target.type} ${target.title || '(untitled)'} ${target.url}`,
+        )
+      }
     }
     console.log(
-      `  recording ${duration}s across ${workers.size} worker(s) — interact now…`,
+      `  recording ${duration}s across ${startedCount} target(s) — interact now…`,
     )
-    await sleep(duration * 1000)
-
-    const results: Array<{ url: string; profile: any }> = []
-    for (const [sid, url] of workers) {
-      const { profile } = await cdp.send('Profiler.stop', {}, sid)
-      results.push({ url, profile })
-    }
-    results.sort((a, b) => b.profile.samples.length - a.profile.samples.length)
+    await sleep(Math.max(0, captureWindowEndedAtMs - performance.now()))
+    captureStarted = false
+    captureWindowClosed = true
+    await Promise.allSettled(startPromises)
+    const results = [pageTarget, ...workers.values()]
+    await Promise.all(
+      results.map(async (target) => {
+        if (!target.started) return
+        try {
+          const { profile } = await cdp.send('Profiler.stop', {}, target.sessionId)
+          target.profile = profile
+          target.profileStoppedAtMs = performance.now()
+        } catch (error) {
+          target.error = error instanceof Error ? error.message : String(error)
+          target.profileStoppedAtMs = target.detachedAtMs
+        }
+        await cdp.send('Profiler.disable', {}, target.sessionId).catch(() => {})
+      }),
+    )
+    // querying the page while five high-frequency profilers are still active
+    // can itself time out and lengthen the requested sampling interval. stop
+    // first, then read the already-recorded action timestamps.
+    const workloadActionEpochMs = interactionBarrierEnabled
+      ? readActionEpochs(
+          await evaluatePage(`(() => {
+            const partial = Reflect.get(globalThis, '__sootsimInteractionPartialResult')
+            const captures = partial && typeof partial === 'object'
+              ? Reflect.get(partial, 'captures')
+              : null
+            if (!Array.isArray(captures)) return []
+            return captures.map((capture) => {
+              if (!capture || typeof capture !== 'object') return null
+              const note = Reflect.get(capture, 'note')
+              return note && typeof note === 'object'
+                ? Reflect.get(note, 'actionEpochMs')
+                : null
+            })
+          })()`),
+        )
+      : []
 
     mkdirSync(dirname(outputPath), { recursive: true })
-    // save the busiest worker (the tenant during interaction) to the main path;
-    // others get a suffix so a multi-worker capture isn't lost.
-    results.forEach((r, i) => {
-      const path =
-        i === 0 ? outputPath : outputPath.replace(/(\.[^.]+)?$/, `.worker${i}$1`)
-      writeFileSync(path, JSON.stringify(r.profile))
-      console.log(`  ${shortUrl(r.url)}: ${r.profile.samples.length} samples → ${path}`)
-      if (opts.verbose && r.profile.samples.length > 0) {
-        for (const fn of topSelfTime(r.profile, 12)) {
+    const roleCounts = new Map<string, number>()
+    const manifest = results.map((target) => {
+      const coverage = cpuProfileCoverage(
+        target.profileStartedAtMs,
+        target.profileStoppedAtMs,
+        captureWindowStartedAtMs,
+        captureWindowEndedAtMs,
+      )
+      const priorCount = roleCounts.get(target.role) ?? 0
+      roleCounts.set(target.role, priorCount + 1)
+      const role = priorCount === 0 ? target.role : `${target.role}-${priorCount + 1}`
+      const profilePath = target.profile
+        ? outputPath.replace(/(\.[^.]+)?$/, `.${role}$1`)
+        : null
+      if (profilePath) {
+        writeFileSync(profilePath, JSON.stringify(target.profile))
+        console.log(
+          `  ${role} ${shortUrl(target.url)}: ${target.profile.samples.length} samples → ${profilePath}`,
+        )
+      } else {
+        console.error(
+          `  ${role} ${shortUrl(target.url)}: no profile${target.error ? ` — ${target.error}` : ''}`,
+        )
+      }
+      if (opts.verbose && target.profile?.samples.length > 0) {
+        for (const fn of topSelfTime(target.profile, 12)) {
           console.log(`      ${fn.pct.toFixed(1).padStart(5)}%  ${fn.name}  ${fn.url}`)
         }
       }
+      return {
+        role,
+        type: target.type,
+        title: target.title,
+        url: target.url,
+        detached: target.detached,
+        attachedOffsetMs: target.attachedAtMs - captureWindowStartedAtMs,
+        ...coverage,
+        samples: target.profile?.samples.length ?? 0,
+        profilePath,
+        error: target.error ?? null,
+      }
     })
+    const requiredRoles = ['page', 'shell', 'compositor', 'tenant']
+    const capturedRoles = new Set(
+      manifest
+        .filter((target) => target.profilePath !== null)
+        .map((target) => target.role),
+    )
+    const missingRoles = requiredRoles.filter((role) => !capturedRoles.has(role))
+    const interactionBarrierComplete =
+      !interactionBarrierEnabled ||
+      (cpuProfileInteractionBarrierValid(
+        interactionBarrier,
+        captureWindowStartedAtEpochMs,
+        captureWindowEndedAtEpochMs,
+      ) &&
+        cpuProfileActionsWithinWindow(
+          workloadActionEpochMs,
+          captureWindowStartedAtEpochMs,
+          captureWindowEndedAtEpochMs,
+        ))
+    const complete =
+      missingRoles.length === 0 &&
+      interactionBarrierComplete &&
+      manifest.length > 0 &&
+      manifest.every(
+        (target) =>
+          target.profilePath !== null &&
+          target.error === null &&
+          target.coverageRatio >= 0.99,
+      )
+    const manifestPath = outputPath.replace(/(\.[^.]+)?$/, '.manifest.json')
+    const executableSha256 = IS_STANDALONE
+      ? createHash('sha256').update(readFileSync(process.execPath)).digest('hex')
+      : null
+    writeFileSync(
+      manifestPath,
+      JSON.stringify(
+        {
+          cli: {
+            version: getCliVersion(),
+            standalone: IS_STANDALONE,
+            executablePath: process.execPath,
+            executableSha256,
+            argv: process.argv.slice(1),
+          },
+          page: page.url,
+          complete,
+          missingRoles,
+          requestedDurationMs: duration * 1000,
+          captureWindowStartedAt: new Date(captureWindowStartedAtEpochMs).toISOString(),
+          captureWindowEndedAt: new Date(captureWindowEndedAtEpochMs).toISOString(),
+          interactionBarrier,
+          workloadActionEpochMs,
+          manifest,
+        },
+        null,
+        2,
+      ),
+    )
+    console.log(`  manifest → ${manifestPath}`)
+    if (!complete) {
+      console.error(
+        `  incomplete attribution capture${missingRoles.length ? ` — missing ${missingRoles.join(', ')}` : ''}`,
+      )
+      if (!interactionBarrierComplete) {
+        console.error(
+          '  workload actions did not fall inside the interaction profile window',
+        )
+      }
+    }
     console.log('  open in chrome devtools → Performance → Load profile to inspect.')
-    return 0
+    return complete ? 0 : 1
   } finally {
+    if (interactionBarrierInstalled) {
+      await releaseInteractionBarrier('cleanup').catch(() => {})
+    }
     cdp.close()
   }
 }
@@ -242,6 +735,19 @@ function shortUrl(url: string): string {
     .slice(-50)
 }
 
+export function cpuProfileTargetRole(url: string, title = ''): string {
+  const identity = `${title} ${url}`.toLowerCase()
+  if (identity.includes('compositor-worker') || identity.includes('sootsim-compositor')) {
+    return 'compositor'
+  }
+  if (identity.includes('shell-worker')) return 'shell'
+  if (identity.includes('named-worklet')) return 'worklet'
+  if (identity.includes('render-worker') || identity.includes('tenant-worker')) {
+    return 'tenant'
+  }
+  return 'worker'
+}
+
 function topSelfTime(profile: any, topN: number) {
   const total = profile.samples.length || 1
   const byFn = new Map<string, { self: number; name: string; url: string }>()

package/cli/commands/perf.ts

@@ -38,6 +38,7 @@ usage:
 
 examples:
   rnx perf cpu --duration 5 --output /tmp/trace.cpuprofile
+    # writes page + every worker profile and a role-labelled manifest
   rnx perf react summary --limit 10
   rnx perf shell start
   rnx perf shell stop --json

package/cli/commands/upload.ts

@@ -528,7 +528,11 @@ export async function runUpload(
       const [mainManifest, workerManifest] = await Promise.all([
         evalInBridge<RecordedEntry[]>(
           bridge,
-          `(window.__sootsimPreviewRecorder?.list?.(${JSON.stringify(bundleOrigin)}) || [])`,
+          `(async () => {
+            const rec = window.__sootsimPreviewRecorder
+            await rec?.flush?.()
+            return rec?.list?.(${JSON.stringify(bundleOrigin)}) || []
+          })()`,
         ),
         evalInBridge<RecordedEntry[]>(
           bridge,
@@ -560,6 +564,7 @@ export async function runUpload(
         `(async () => {
           const rec = window.__sootsimPreviewRecorder
           const workerList = window.__sootsimListWorkerFetchRecorder
+          await rec?.flush?.()
           return {
             main: rec?.list ? rec.list() : [],
             worker: typeof workerList === 'function' ? await workerList() : [],
@@ -604,6 +609,7 @@ export async function runUpload(
             const rec = window.__sootsimPreviewRecorder
             const workerDump = window.__sootsimDumpWorkerFetchRecorder
             const bundleUrl = ${JSON.stringify(snapshot.bundleUrl)}
+            await rec?.flush?.()
             const keep = (r) => {
               try {
                 const u = new URL(r.url)

package/dist-lib/agent-daemon-client.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/agent-events.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/agent-identity.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/agent-sessions.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/attached-projects.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/auth/shared-session.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/backend-origin.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/beta.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/beta.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/beta.ts
 var IS_BETA = true;

package/dist-lib/bridge-constants.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/bridge-contract-input.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/bridge-contract-input.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/bridge-contract-input.ts
 var BridgeInputError = class extends Error {

package/dist-lib/bridge-contract.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/bridge-contract.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/bridge-contract.ts
 var SEMANTIC_READY_CONTENT_NODE_FLOOR = 100;

package/dist-lib/cli-constants.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/config.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/detox/index.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/dev-bundle-resolution.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/home-paths.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/host/bridge-host.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/host/fetch-proxy-handler.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/host/fetch-proxy-overrides.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/host/fetch-proxy-overrides.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/host/fetch-proxy-overrides.ts
 var FETCH_PROXY_BROWSER_USER_AGENT = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36";

package/dist-lib/host/replacement-module-handler.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/host/websocket-proxy.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/index.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/jump-to-source-babel.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/menu.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/menu.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/public-brand.ts
 var name = "rnx";

package/dist-lib/metro-production-bundle.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/metro-production-bundle.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/metro-production-bundle.ts
 var RNXSIM_METRO_PRODUCTION_BUNDLE_OPTION = "rnxsim";

package/dist-lib/metro.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/profiles.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/public-brand.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/react-native-host-modules.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/react-native-host-modules.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 
 // src/react-native-host-modules.ts
 var REACT_NATIVE_PASSTHROUGH_SPECIFIERS = [

package/dist-lib/render-mode.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/scripts/dev-server-scanner.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/sdk.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/sdk.mjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);

package/dist-lib/skills.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;
@@ -1787,8 +1787,8 @@ var init_registry = __esm({
             coverageSource: "estimated",
             capabilityCoverage: CAPABILITY_INVENTORY_PACKAGE_COVERAGE["react-native"],
             note: "React Native 0.86 root surface with useful core rendering, input, scrolling, animation, list, platform, and native-module behavior",
-            working: "all 99 React Native 0.86.2 public runtime root export names; flex and absolute layout, text shaping and wrapping, image loading and resize modes, touch and responder routing, controlled text input and keyboard presentation, vertical and horizontal scrolling with paging/snapping/sticky and maintained content, windowed/inverted/horizontal lists, common Animated graphs and composition, alerts and action sheets, live platform/dimension/appearance state, and explicit native-module lookup",
-            missing: "core LayoutAnimation create/update/delete geometry, arbitrary app-specific NativeModules and complete core module methods, exact automatic scroll insets and nested-scroll edge behavior, advanced TextInput selection/autofill, uncommon platform lifecycle and accessibility events, complete UIManager/system/dev-tool semantics, LogBox and Systrace behavior, and native virtual-collection visibility modes"
+            working: "all 99 React Native 0.86.2 public runtime root export names; flex and absolute layout, text shaping and wrapping, image loading and resize modes, touch and responder routing, controlled text input and keyboard presentation, vertical and horizontal scrolling with paging/snapping/sticky and maintained content, windowed/inverted/horizontal lists, common Animated graphs and composition, core LayoutAnimation create/update/delete geometry, alerts and action sheets, live platform/dimension/appearance state, and explicit native-module lookup",
+            missing: "arbitrary app-specific NativeModules and complete core module methods, exact automatic scroll insets and nested-scroll edge behavior, advanced TextInput selection/autofill, uncommon platform lifecycle and accessibility events, complete UIManager/system/dev-tool semantics, LogBox and Systrace behavior, and native virtual-collection visibility modes"
           }
         ]
       },
@@ -1843,8 +1843,8 @@ var init_registry = __esm({
             coverageSource: "estimated",
             capabilityCoverage: CAPABILITY_INVENTORY_PACKAGE_COVERAGE["react-native-screens"],
             note: "screen container, stack, header config, search bar, navigation props",
-            working: "Screen, ScreenContainer, ScreenStack, enableFreeze/freezeEnabled with delayed React freeze, Android modal/pageSheet push fallback, Android statusBarHidden/statusBarStyle/navigationBarHidden traits, push/pop slide, zoom/fade/fade_from_bottom transitions, edge swipe-back, parallax behind-screen, large title collapse, header (back button, inline/large title, custom left/center/right/search bar subviews, native header bar buttons/menus/badges, crossfade), formSheet custom initial detents/corner radius/grabber/undimmed range and stacked sheets, useHeaderHeight, useTransitionProgress, FullWindowOverlay, SearchBar, Tabs.Host/Screen, lifecycle callbacks (onAppear/onDisappear/onWillAppear/onWillDisappear), onDismissed",
-            missing: "replaceAnimation differentiation, interactive drag between formSheet detents, integrated search bar placements"
+            working: "Screen, ScreenContainer, ScreenStack, enableFreeze/freezeEnabled with delayed React freeze, Android modal/pageSheet push fallback, Android statusBarHidden/statusBarStyle/navigationBarHidden traits, push/pop slide, replaceAnimation push/pop direction, zoom/fade/fade_from_bottom transitions, edge swipe-back, parallax behind-screen, large title collapse, header (back button, inline/large title, custom left/center/right/search bar subviews, native header bar buttons/menus/badges, crossfade), formSheet custom initial detents/corner radius/grabber/undimmed range and stacked sheets, useHeaderHeight, useTransitionProgress, FullWindowOverlay, SearchBar, Tabs.Host/Screen, lifecycle callbacks (onAppear/onDisappear/onWillAppear/onWillDisappear), onDismissed",
+            missing: "interactive drag between formSheet detents, integrated search bar placements"
           }
         ]
       },
@@ -1990,8 +1990,8 @@ var init_registry = __esm({
             coverageSource: "estimated",
             capabilityCoverage: CAPABILITY_INVENTORY_PACKAGE_COVERAGE["react-native-keyboard-controller"],
             note: "native bindings stubbed (KeyboardControllerNative, KeyboardEvents, FocusedInputEvents, WindowDimensionsEvents, KeyboardControllerView + sibling native views); upstream pure-JS components, hooks, animated module, and KeyboardAvoidingView resolve from node_modules unchanged",
-            working: "every upstream JS export \u2014 KeyboardProvider, KeyboardAvoidingView, KeyboardStickyView, KeyboardAwareScrollView, KeyboardToolbar, KeyboardGestureArea, useReanimatedKeyboardAnimation, useKeyboardAnimation, useKeyboardHandler, useGenericKeyboardHandler, useKeyboardController, useKeyboardState, useKeyboardContext, useReanimatedFocusedInput, useFocusedInputHandler, useResizeMode, useWindowDimensions, KeyboardEvents, FocusedInputEvents, WindowDimensionsEvents resize events, KeyboardController (dismiss/setFocusTo/isVisible/state/preload/setInputMode/setDefaultMode), KeyboardControllerView, OverKeyboardView, KeyboardBackgroundView, KeyboardExtender, ClippingScrollView, KeyboardToolbarGroupView, AndroidSoftInputModes \u2014 all run upstream code through reanimated worklets",
-            missing: "preload is a noop; KeyboardGestureArea, OverKeyboardView, KeyboardBackgroundView, and KeyboardExtender are passthrough views without their native platform effects"
+            working: "every upstream JS export runs through reanimated worklets; Android KeyboardGestureArea drives the existing keyboard owner through drag progress, velocity/distance settling, cancellation, focus retention, and cleanup; supported exports include KeyboardProvider, KeyboardAvoidingView, KeyboardStickyView, KeyboardAwareScrollView, KeyboardToolbar, KeyboardGestureArea, useReanimatedKeyboardAnimation, useKeyboardAnimation, useKeyboardHandler, useGenericKeyboardHandler, useKeyboardController, useKeyboardState, useKeyboardContext, useReanimatedFocusedInput, useFocusedInputHandler, useResizeMode, useWindowDimensions, KeyboardEvents, FocusedInputEvents, WindowDimensionsEvents resize events, KeyboardController (dismiss/setFocusTo/isVisible/state/preload/setInputMode/setDefaultMode), KeyboardControllerView, OverKeyboardView, KeyboardBackgroundView, KeyboardExtender, ClippingScrollView, KeyboardToolbarGroupView, and AndroidSoftInputModes",
+            missing: "preload is a noop; KeyboardGestureArea lacks its iOS textInputNativeID/offset effect; OverKeyboardView, KeyboardBackgroundView, and KeyboardExtender are passthrough views without their native platform effects"
           }
         ]
       },

package/dist-lib/vite.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.378 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.380 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rnxsim",
-  "version": "0.1.378",
+  "version": "0.1.380",
   "description": "rnx CLI, Vite and Metro plugins, and agent skills for driving React Native apps in the browser.",
   "author": "Tamagui LLC",
   "license": "SEE LICENSE IN LICENSE",

package/skills/rnx-perf/SKILL.md

@@ -170,6 +170,43 @@ the report and how to read it:
 three runs minimum; single-run p95 is noise. a fresh `perf start` between
 runs clears the buffer.
 
+### browser-site interaction matrices
+
+for a browser-level regression, use three fresh documents per browser engine.
+within each document, capture cold then warm versions of the same interaction;
+do not call two independent fresh documents "cold versus warm." wait for the
+home surface's first compositor paint before starting—the compositor-ready flag
+only proves worker bootstrap and can precede the first visible layout.
+
+during a measured transition, use a fixed observation window. do not poll the
+shell state, test tree, or perf bridge while the animation is running; verify
+the positive control once after profiling stops. query a targeted id or text on
+large virtualized apps, never the full tree, because enumeration can dominate
+or terminate the browser process. for a remotely populated list, require the
+same scroll-container identity and content extent for a quiet window before the
+gesture; "a row exists" can still be true while the app replaces the tree.
+keep pointer down, moves, release, and the fixed settle window inside one
+uninterrupted profile. stopping or querying between drag and release changes
+velocity, cache state, and worker scheduling.
+
+the minimum browser matrix is home drag plus snapback, a cold/warm built-in app
+open, and a cold/warm app-switcher open. add one quiet heavy-app screen, one
+navigation transition, and one long-list scroll when those surfaces are in
+scope. use GPU-backed Chrome for Chromium claims. use installed WebKit in a
+visible nonpersistent WKWebView for Safari-engine claims; Playwright WebKit is
+not the installed Safari engine.
+
+every receipt must carry the exact page and frame URLs, browser user agent,
+harness-source identity, capture time, engine build identity and generation,
+runtime bundle receipt, system memory, runtime errors, and any partial failure.
+partial artifacts remain inadmissible until every requested run number for that
+scenario exists with one harness, engine, seed, and viewport identity. browser
+comparisons use the same css viewport and backing scale; finite but different
+device pixel ratios are not comparable.
+the host-clock `displayFrames`/`timerFrames` and shell-link
+`displayPumps`/`timerPumps` counters prove whether the visible-rAF fallback
+engaged. preserve failed receipts instead of retrying them out of the data set.
+
 ### confirm which build you measured, every time
 
 Against a dev-source sim, the FIRST reload after an engine edit serves the
@@ -196,11 +233,31 @@ rnx open 8089 --new --driver playwright --cdp-port 9222 # cpu-profile a driveabl
 rnx debug enable layout,render && rnx debug recent layout 40
 ```
 
+`rnx perf cpu` writes one profile for the page and one for every attached
+worker, plus a manifest that labels shell, compositor, tenant, worklet, and
+unknown workers. exit zero requires page, shell, compositor, and tenant plus
+every other discovered target, with each covering at least 99% of the requested
+window. inspect start/stop offsets as well as sample counts; a late-attached
+near-empty profile is incomplete. a profile of only the tenant—or a helper
+that relabels the busiest worker as tenant—cannot distinguish CPU saturation
+from sparse browser scheduling.
+
+for an automated interaction, pass `--interaction-barrier` and start the cpu
+command during the runner's pre-workload attachment delay, and give the runner
+a post-workload delay long enough to remain open through profiler stop. the
+pre-workload delay alone is not synchronization: it can end the profile while
+the workload is still preparing. barrier mode pauses the workload before its
+first measured capture until every discovered target is profiling, then rejects
+the manifest unless a recorded action timestamp falls inside the capture
+interval. the barrier also has a bounded page-side lease so an interrupted
+profiler cannot strand the workload; lease expiry releases the runner but
+invalidates the profile.
+
 ### the cadence block: frames that never happened
 
 work-per-painted-frame cannot see a frame that was never delivered — host
-rAF starved, shell worker descheduled, vsync message stuck behind a busy
-queue. the report shows low avg and zero jank while the user sees stutter.
+rAF starved, shell worker descheduled, or the compositor's shared-frame wait
+resumed late. the report shows low avg and zero jank while the user sees stutter.
 the `cadence` section of `perf shell stop` measures the delivery side and
 attributes a missing frame to its hop:
 
@@ -214,6 +271,14 @@ attributes a missing frame to its hop:
 - `idle breaks` — gaps >250ms, excluded from all three: demand-gated
   quiesce is legitimate, not starvation.
 
+the compositor `compositorHostFrameClock` separates display/timer ticks published into
+its shared latest-frame cell from ticks consumed during the acknowledged worker
+profile window. published timer ticks prove the renderer fallback won; sparse consumed ticks
+with low production time identifies worker scheduling starvation. many consumed
+ticks with sparse paints can be legitimate dirty-gating; correlate the frame
+series before treating it as a regression. shell-owned captures expose the
+corresponding `note.frameLink.sharedFrameClock` counters.
+
 compare baseline vs contended captures of the same scripted window; also
 compare **painted-frame counts**, the crudest and most robust signal.
 
@@ -276,6 +341,7 @@ which tier *should* absorb your cost and prove whether it does.
 | damage rects (`damage-rect.ts`) | repaint clips to changed region (opaque-backdrop gated) | worst-frame render bounded during small updates |
 | raster tier | stable rows become GPU textures; scroll skips recording | compositor block: promotions > 0 once warm, blits ≈ one per visible row (uniswap token list: ~13.7/frame) |
 | flood guard, pointer coalescing, vsync hysteresis | message-storm and pump-thrash protection | msgs/s sane during gestures and at rest |
+| resilient renderer-main frame clock | visible rAF holes do not stall pointer coalescing or worker vsync | compositor `published` / `consumed` display and timer frames; shell `displayPumps` / `timerPumps` |
 
 there is no whole-screen scroll blit. one existed for a few hours in June
 2026 and was reverted (`6706f3a014`): it shifted a surface RECTANGLE, so a