@react-native-harness/jest 1.5.0 → 1.7.0

package/dist/errors.js

@@ -1,4 +1,4 @@
-import { formatPath, HarnessError } from '@react-native-harness/tools';
+import { formatHostPressure, formatPath, HarnessError, isHostStarved, } from '@react-native-harness/tools';
 export { StartupStallError, } from '@react-native-harness/bundler-metro';
 export class NoRunnerSpecifiedError extends HarnessError {
     constructor() {
@@ -20,13 +20,28 @@ export class InitializationTimeoutError extends HarnessError {
         this.name = 'InitializationTimeoutError';
     }
 }
+const buildPlatformReadyTimeoutMessage = (timeout, hostPressure) => {
+    const prefix = `The platform did not become ready within ${timeout}ms.`;
+    if (hostPressure && isHostStarved(hostPressure)) {
+        return `${prefix} The host was starved for resources during startup (${formatHostPressure(hostPressure)}). A larger "platformReadyTimeout" is unlikely to help; reduce other load on the host or use a larger machine.`;
+    }
+    const suggestion = `Increase "platformReadyTimeout" if your device, simulator, or emulator needs more time to start.`;
+    return hostPressure
+        ? `${prefix} ${suggestion} Host during startup: ${formatHostPressure(hostPressure)}.`
+        : `${prefix} ${suggestion}`;
+};
 export class PlatformReadyTimeoutError extends HarnessError {
     timeout;
-    constructor(timeout) {
-        super(`The platform did not become ready within ${timeout}ms. Increase "platformReadyTimeout" if your device, simulator, or emulator needs more time to start.`);
+    hostPressure;
+    constructor(timeout, hostPressure = null) {
+        super(buildPlatformReadyTimeoutMessage(timeout, hostPressure));
         this.timeout = timeout;
+        this.hostPressure = hostPressure;
         this.name = 'PlatformReadyTimeoutError';
     }
+    get hostStarved() {
+        return this.hostPressure !== null && isHostStarved(this.hostPressure);
+    }
 }
 export class MetroPortRangeExhaustedError extends HarnessError {
     initialPort;
@@ -128,3 +143,14 @@ export class RuntimeDisconnectError extends HarnessError {
         return this.details.phase;
     }
 }
+// The runtime sends this name through the runTests RPC when its native host
+// surface is replaced while a test file is still running.
+export class HostSurfaceReplacedError extends HarnessError {
+    testFilePath;
+    constructor(testFilePath, cause) {
+        super(cause.message, { cause });
+        this.testFilePath = testFilePath;
+        this.name = 'HostSurfaceReplacedError';
+        this.stack = cause.stack;
+    }
+}

package/dist/execute-run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute-run.d.ts","sourceRoot":"","sources":["../src/execute-run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EACJ,WAAW,EACX,MAAM,EACN,UAAU,EACX,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,KAAK,cAAc,EAAwB,MAAM,sBAAsB,CAAC;AA8BjF,KAAK,aAAa,GAAG,CAAC,IAAI,SAAS,MAAM,UAAU,EACjD,SAAS,EAAE,IAAI,EACf,GAAG,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,KAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;AA+FnB,eAAO,MAAM,UAAU,GACrB,SAAS,cAAc,EACvB,OAAO,KAAK,CAAC,IAAI,CAAC,EAClB,SAAS,WAAW,EACpB,WAAW,aAAa,EACxB,cAAc,MAAM,CAAC,YAAY,KAChC,OAAO,CAAC,IAAI,CAsOd,CAAC"}
+{"version":3,"file":"execute-run.d.ts","sourceRoot":"","sources":["../src/execute-run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EACJ,WAAW,EACX,MAAM,EACN,UAAU,EACX,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,KAAK,cAAc,EAAwB,MAAM,sBAAsB,CAAC;AAsCjF,KAAK,aAAa,GAAG,CAAC,IAAI,SAAS,MAAM,UAAU,EACjD,SAAS,EAAE,IAAI,EACf,GAAG,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,KAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;AA8GnB,eAAO,MAAM,UAAU,GACrB,SAAS,cAAc,EACvB,OAAO,KAAK,CAAC,IAAI,CAAC,EAClB,SAAS,WAAW,EACpB,WAAW,aAAa,EACxB,cAAc,MAAM,CAAC,YAAY,KAChC,OAAO,CAAC,IAAI,CAsRd,CAAC"}

package/dist/execute-run.js

@@ -1,13 +1,13 @@
 import { randomUUID } from 'node:crypto';
-import path from 'node:path';
 import { runHarnessTestFile } from './run.js';
+import { toRelativePosixPath } from './relative-path.js';
 import { resolveResetStrategyKind } from './environment-reset.js';
-import { NativeCrashError, RuntimeDisconnectError, StartupStallError, } from './errors.js';
+import { HostSurfaceReplacedError, NativeCrashError, RuntimeDisconnectError, StartupStallError, } from './errors.js';
 import { AppBridgeDisconnectedError, DeviceNotRespondingError, } from '@react-native-harness/bridge/server';
 import { createPlatformSkippedTestResult, shouldRunHarnessTestFile, } from './test-file-platform-filter.js';
 import { formatHarnessErrorMessage } from './format-harness-error.js';
 import { logger } from '@react-native-harness/tools';
-import { printSummary, writeTraceFile } from './diagnostics/index.js';
+import { appendStepSummary, printSummary, summarizeRunKpis, writeSummaryFile, writeTraceFile, } from './diagnostics/index.js';
 import { toJestStatus } from './toJestStatus.js';
 const diagnosticsLogger = logger.child('diagnostics');
 const createRunSummary = () => ({ passed: 0, failed: 0, skipped: 0, todo: 0 });
@@ -23,13 +23,22 @@ class CancelRun extends Error {
         this.name = 'CancelRun';
     }
 }
-const buildTestFailure = (err) => {
-    if (err instanceof NativeCrashError ||
-        err instanceof RuntimeDisconnectError ||
-        err instanceof StartupStallError ||
-        err instanceof AppBridgeDisconnectedError ||
-        err instanceof DeviceNotRespondingError) {
-        return { message: err.message, stack: '' };
+const isRuntimeFailure = (err) => err instanceof NativeCrashError ||
+    err instanceof RuntimeDisconnectError ||
+    err instanceof StartupStallError ||
+    err instanceof AppBridgeDisconnectedError ||
+    err instanceof DeviceNotRespondingError;
+const formatRunningTest = (test) => `Running test: "${[...test.ancestorTitles, test.name].join(' › ')}"`;
+const buildTestFailure = (err, runningTest = null) => {
+    if (isRuntimeFailure(err)) {
+        if (!runningTest) {
+            return { message: err.message, stack: '' };
+        }
+        const [headline, ...details] = err.message.split('\n');
+        return {
+            message: [headline, formatRunningTest(runningTest), ...details].join('\n'),
+            stack: '',
+        };
     }
     return err;
 };
@@ -80,10 +89,19 @@ export const executeRun = async (session, tests, watcher, emitEvent, globalConfi
     const startTime = Date.now();
     const watchMode = globalConfig.watch || globalConfig.watchAll;
     const rootDir = globalConfig.rootDir ?? process.cwd();
-    const testFiles = tests.map((t) => path.relative(rootDir, t.path));
+    const testFiles = tests.map((t) => toRelativePosixPath(rootDir, t.path));
     const summary = createRunSummary();
     let caseEventChain = Promise.resolve();
+    // The device runs one test at a time, so a test that started and has not
+    // finished is the one the app was running if it crashes or disconnects.
+    let runningTest = null;
     const unsubscribe = session.onTestRunnerEvent((event) => {
+        if (event.type === 'test-started') {
+            runningTest = event;
+        }
+        else if (event.type === 'test-finished') {
+            runningTest = null;
+        }
         if (isHarnessCaseEvent(event)) {
             caseEventChain = caseEventChain.then(() => event.type === 'test-started'
                 ? emitHarnessTestStarted(emitEvent, event)
@@ -106,6 +124,11 @@ export const executeRun = async (session, tests, watcher, emitEvent, globalConfi
         return state;
     };
     updateRunState();
+    session.lifecycle.emit({
+        type: 'phase',
+        phase: 'run.start',
+        attrs: { runId },
+    });
     await session.callHook('run:started', {
         runId,
         startTime,
@@ -128,8 +151,9 @@ export const executeRun = async (session, tests, watcher, emitEvent, globalConfi
         for (const test of tests) {
             if (watcher.isInterrupted())
                 throw new CancelRun();
-            const relativeTestPath = path.relative(rootDir, test.path);
+            const relativeTestPath = toRelativePosixPath(rootDir, test.path);
             const fileStartedAt = Date.now();
+            runningTest = null;
             let emittedTestFileFinished = false;
             const emitTestFileFinished = async (options) => {
                 emittedTestFileFinished = true;
@@ -143,6 +167,11 @@ export const executeRun = async (session, tests, watcher, emitEvent, globalConfi
             };
             await session.callHook('test-file:started', { runId, file: relativeTestPath });
             const fileSpan = diagnostics.start('run.file', { file: relativeTestPath });
+            session.lifecycle.emit({
+                type: 'phase',
+                phase: 'test-file.start',
+                attrs: { file: relativeTestPath },
+            });
             let fileStatus = 'failed';
             try {
                 if (!shouldRunHarnessTestFile(test.path, platformId, knownPlatformIds)) {
@@ -216,7 +245,10 @@ export const executeRun = async (session, tests, watcher, emitEvent, globalConfi
                         shouldRestartAfterTimeout = false;
                     }
                 }
-                catch (err) {
+                catch (error) {
+                    const err = error instanceof Error && error.name === 'HostSurfaceReplacedError'
+                        ? new HostSurfaceReplacedError(test.path, error)
+                        : error;
                     fileStatus = 'failed';
                     if (!emittedTestFileFinished) {
                         await emitTestFileFinished({
@@ -225,25 +257,31 @@ export const executeRun = async (session, tests, watcher, emitEvent, globalConfi
                             result: null,
                         });
                     }
-                    const isRuntimeFailure = err instanceof NativeCrashError ||
-                        err instanceof RuntimeDisconnectError ||
-                        err instanceof StartupStallError ||
-                        err instanceof AppBridgeDisconnectedError ||
-                        err instanceof DeviceNotRespondingError;
-                    if (isRuntimeFailure) {
+                    const isFileRuntimeFailure = err instanceof HostSurfaceReplacedError || isRuntimeFailure(err);
+                    if (isFileRuntimeFailure) {
                         summary.failed += 1;
                         updateRunState();
                     }
                     if (err instanceof NativeCrashError || err instanceof RuntimeDisconnectError) {
                         session.resetCrashState();
                     }
-                    updateRunState({ error: isRuntimeFailure ? undefined : err });
+                    updateRunState({ error: isFileRuntimeFailure ? undefined : err });
                     await caseEventChain;
-                    await emitEvent('test-file-failure', test, buildTestFailure(err));
+                    await emitEvent('test-file-failure', test, buildTestFailure(err, runningTest));
+                    if (err instanceof HostSurfaceReplacedError) {
+                        // Abandoned async test work may still be running in this process.
+                        await session.restartApp(test.path);
+                        isFirstTest = true;
+                    }
                 }
             }
             finally {
                 fileSpan.end({ status: fileStatus });
+                session.lifecycle.emit({
+                    type: 'phase',
+                    phase: 'test-file.end',
+                    attrs: { file: relativeTestPath, status: fileStatus },
+                });
             }
         }
     }
@@ -267,12 +305,26 @@ export const executeRun = async (session, tests, watcher, emitEvent, globalConfi
         await caseEventChain;
         unsubscribe();
         runSpan.end({ runId, status: finalStatus });
+        // Idle time between runs (watch mode) is not part of any run's metrics.
+        session.lifecycle.emit({
+            type: 'phase',
+            phase: 'run.end',
+            attrs: { runId, status: finalStatus },
+        });
         if (session.diagnostics.enabled) {
             const entries = session.diagnostics.flush();
             try {
                 printSummary(entries, (line) => diagnosticsLogger.info(line));
                 const tracePath = await writeTraceFile(entries, { projectRoot: rootDir, runId });
                 diagnosticsLogger.info(`wrote diagnostics trace to ${tracePath}`);
+                const kpis = summarizeRunKpis(entries);
+                const summaryPath = await writeSummaryFile(kpis, {
+                    projectRoot: rootDir,
+                    runId,
+                    sessionId: session.sessionId,
+                });
+                diagnosticsLogger.info(`wrote diagnostics summary to ${summaryPath}`);
+                await appendStepSummary(kpis);
             }
             catch (reportError) {
                 diagnosticsLogger.warn('failed to write diagnostics report: %s', reportError);

package/dist/format-harness-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format-harness-error.d.ts","sourceRoot":"","sources":["../src/format-harness-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AA6CpE,eAAO,MAAM,yBAAyB,GACpC,OAAO,eAAe,GAAG,SAAS,EAClC,UAAS;IACP,aAAa,CAAC,EAAE,MAAM,CAAC;CACnB,KACL,MAAM,GAAG,SAsBX,CAAC"}
+{"version":3,"file":"format-harness-error.d.ts","sourceRoot":"","sources":["../src/format-harness-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AA6CpE,eAAO,MAAM,yBAAyB,GACpC,OAAO,eAAe,GAAG,SAAS,EAClC,UAAS;IACP,aAAa,CAAC,EAAE,MAAM,CAAC;CACnB,KACL,MAAM,GAAG,SA2BX,CAAC"}

package/dist/format-harness-error.js

@@ -30,6 +30,9 @@ export const formatHarnessErrorMessage = (error, options = {}) => {
         return undefined;
     }
     const parts = [error.message];
+    if (error.diff) {
+        parts.push(error.diff);
+    }
     const pendingPromiseDetails = error.diagnostics?.pendingPromises
         ? formatPendingPromises(error.diagnostics.pendingPromises, options.testStartedAt)
         : null;

package/dist/harness-session.d.ts

@@ -2,12 +2,13 @@ import { type HarnessBridge, type AppConnection } from '@react-native-harness/br
 import { type HarnessContext, type TestRunnerEvents, type TestExecutionOptions, type TestSuiteResult } from '@react-native-harness/bridge';
 import { type HarnessPlatform } from '@react-native-harness/platforms';
 import { type HarnessPluginManager, type HarnessRunStatus, type HarnessRunSummary } from '@react-native-harness/plugins';
-import { type Diagnostics } from '@react-native-harness/tools';
+import { type Diagnostics, type HostPressure } from '@react-native-harness/tools';
 import { type Config as HarnessConfig } from '@react-native-harness/config';
 import type { Config as JestConfig } from 'jest-runner';
 import { type CrashMonitor } from './crash-monitor.js';
 import { type ClientLogBuffer } from './client-log-handler.js';
 import { type ResourceLockManager } from './resource-lock.js';
+import { type SessionTelemetry } from './diagnostics/index.js';
 type DisconnectObservableBridge = {
     readonly connection: AppConnection | null;
     on: (event: 'disconnected', listener: () => void) => void;
@@ -38,6 +39,10 @@ export type HarnessSession = {
     readonly config: HarnessConfig;
     readonly context: HarnessContext;
     readonly diagnostics: Diagnostics;
+    /** Identifies this session; names its incremental diagnostics log. */
+    readonly sessionId: string;
+    /** Run lifecycle phases, for telemetry probes (see `SessionTelemetry`). */
+    readonly lifecycle: SessionTelemetry['lifecycle'];
     onTestRunnerEvent: (listener: (event: TestRunnerEvents) => void) => () => void;
     runTestFile: (path: string, options: HarnessRunTestsOptions) => Promise<TestSuiteResult>;
     ensureAppReady: (testFilePath: string) => Promise<void>;
@@ -54,6 +59,8 @@ export declare const withPlatformReadyTimeout: <T>(options: {
     timeout: number;
     signal: AbortSignal;
     work: (signal: AbortSignal) => Promise<T>;
+    /** Host pressure at the moment of the timeout, attached to the error. */
+    getHostPressure?: () => HostPressure | null;
 }) => Promise<T>;
 export declare const waitForStartupCrash: ({ crashMonitor, detectNativeCrashes, testFilePath, signal, }: {
     crashMonitor: CrashMonitor;

package/dist/harness-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"harness-session.d.ts","sourceRoot":"","sources":["../src/harness-session.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"harness-session.d.ts","sourceRoot":"","sources":["../src/harness-session.ts"],"names":[],"mappings":"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"}

package/dist/harness-session.js

@@ -3,7 +3,7 @@ import { HARNESS_BRIDGE_PATH, } from '@react-native-harness/bridge';
 import { createHarnessCache } from '@react-native-harness/cache';
 import { getMetroInstance, waitForMetroBackedAppReady, } from '@react-native-harness/bundler-metro';
 import { createHarnessPluginManager, } from '@react-native-harness/plugins';
-import { createCrashArtifactWriter, createDiagnostics, delay, logger, getTimeoutSignal, ensureSignalsDeliverable, waitForAbort, } from '@react-native-harness/tools';
+import { createCrashArtifactWriter, createDiagnostics, delay, logger, getTimeoutSignal, ensureSignalsDeliverable, waitForAbort, checkHostHealth, formatGitHubWarning, formatSaturatedHostMessage, isCI, readProcessUsage, } from '@react-native-harness/tools';
 import { getConfig, isDiagnosticsEnabled, resolveMetroCacheEnabled, ConfigSchema, } from '@react-native-harness/config';
 import { preRunMessage } from 'jest-util';
 import path from 'node:path';
@@ -15,7 +15,7 @@ import { createHookQueue } from './hook-queue.js';
 import { createClientLogCollector, } from './client-log-handler.js';
 import { createActionHooksPlugin } from './action-hooks.js';
 import { createResourceLockManager, } from './resource-lock.js';
-import { observeBridgeEvents, observeMetroEvents } from './diagnostics/index.js';
+import { observeBridgeEvents, observeMetroEvents, startSessionTelemetry, } from './diagnostics/index.js';
 import { resolveHarnessMetroPort } from './metro-port.js';
 import { getAdditionalCliArgs } from './cli-args.js';
 import { logMetroCacheReused, logMetroPortFallback, logNativeCoverageCollected, logRunnerStarting, logRunnerStillWaitingInQueue, logRunnerWaitingInQueue, logTestEnvironmentReady, logTestRunHeader, } from './logs.js';
@@ -25,6 +25,8 @@ const ignorePromiseRejection = () => undefined;
 const isBridgeDisconnectError = (error) => error instanceof Error && error.message === 'App bridge disconnected';
 const TEST_RUN_BRIDGE_STABILITY_WAIT_MS = 500;
 const DISPOSE_HOOK_TIMEOUT_MS = 5_000;
+// Upper bound on waiting for end-of-run telemetry before tearing resources down.
+const DISPOSE_TELEMETRY_TIMEOUT_MS = 10_000;
 const waitForBoundedSettlement = async (promise, timeoutMs) => {
     const timeout = delay(timeoutMs);
     try {
@@ -99,7 +101,7 @@ export const withPlatformReadyTimeout = async (options) => {
         return await Promise.race([
             options.work(options.signal),
             abortWait.promise.catch(() => {
-                throw new PlatformReadyTimeoutError(options.timeout);
+                throw new PlatformReadyTimeoutError(options.timeout, options.getHostPressure?.() ?? null);
             }),
         ]);
     }
@@ -107,6 +109,35 @@ export const withPlatformReadyTimeout = async (options) => {
         abortWait.cancel();
     }
 };
+// A saturated host is exactly where `ps` is slow; it took over 10s on CI.
+const HOST_HEALTH_PROCESS_LISTING_TIMEOUT_MS = 30_000;
+// Tells, before anything is booted, whether the host is already saturated by
+// something other than this run. Only a warning: a saturated runner can still
+// pass, but a later startup timeout then has an explanation.
+const reportSaturatedHost = async (diagnostics) => {
+    try {
+        const verdict = await checkHostHealth();
+        diagnostics.mark('telemetry.host_health', {
+            load1: verdict.load1,
+            cpuCount: verdict.cpuCount,
+            idlePct: verdict.idlePct ?? undefined,
+            saturated: verdict.saturated,
+        });
+        if (!verdict.saturated) {
+            return;
+        }
+        const processes = await readProcessUsage(AbortSignal.timeout(HOST_HEALTH_PROCESS_LISTING_TIMEOUT_MS)).catch(() => null);
+        const message = formatSaturatedHostMessage(verdict, processes?.topByCpu);
+        sessionLogger.warn(message);
+        const annotation = formatGitHubWarning('Saturated CI runner', message);
+        if (annotation) {
+            process.stdout.write(`${annotation}\n`);
+        }
+    }
+    catch (error) {
+        sessionLogger.debug('host health check failed: %s', error);
+    }
+};
 export const waitForStartupCrash = async ({ crashMonitor, detectNativeCrashes, testFilePath, signal, }) => {
     if (!detectNativeCrashes) {
         return await waitForAbort(signal).promise;
@@ -257,6 +288,9 @@ export const createHarnessSession = async (globalConfig, { lockManager = default
     preRunMessage.remove(process.stderr);
     const setupStartedAt = Date.now();
     const { harnessConfig, platform, projectRoot, configProjectRoot } = await loadConfig(globalConfig);
+    // Metro platform for prewarm and startup detection. Vega apps request
+    // "kepler" bundles while the harness platform id stays "vega".
+    const bundlePlatform = platform.bundlePlatform ?? platform.platformId;
     applyEnvVars(harnessConfig, globalConfig);
     const diagnostics = createDiagnostics({
         enabled: isDiagnosticsEnabled(harnessConfig),
@@ -265,6 +299,23 @@ export const createHarnessSession = async (globalConfig, { lockManager = default
         label: 'session.config.load',
         duration: Date.now() - setupStartedAt,
     });
+    // The one composition point for run telemetry. Everything below only emits
+    // lifecycle phases; probes translate them and polled data into diagnostics.
+    const telemetry = startSessionTelemetry({
+        diagnostics,
+        config: harnessConfig,
+        projectRoot,
+    });
+    telemetry.phase('session.created');
+    if (isCI()) {
+        void reportSaturatedHost(diagnostics);
+    }
+    // Telemetry runs timers and listens on `exit`, so a setup failure before the
+    // main try/catch below must still stop it.
+    const disposeTelemetryOnFailure = (work) => work.catch(async (error) => {
+        await telemetry.dispose();
+        throw error;
+    });
     sessionLogger.debug('creating session for runner=%s platform=%s', platform.name, platform.platformId);
     // Single, session-lifetime AbortController: it aborts on early SIGTERM/SIGINT
     // during setup (below) and, once the session is up, in dispose()'s finally
@@ -280,11 +331,11 @@ export const createHarnessSession = async (globalConfig, { lockManager = default
     };
     process.once('SIGTERM', onEarlySignal);
     process.once('SIGINT', onEarlySignal);
-    const resourceLockKey = await (platform.getResourceLockKey?.() ?? getDefaultResourceLockKey(platform));
+    const resourceLockKey = await disposeTelemetryOnFailure(Promise.resolve(platform.getResourceLockKey?.() ?? getDefaultResourceLockKey(platform)));
     let didWaitForResourceLock = false;
     let lastStillWaitingLogAt = 0;
     logTestRunHeader(platform);
-    const resourceLease = await diagnostics.measure('session.lock.wait', () => lockManager.acquire(resourceLockKey, {
+    const resourceLease = await disposeTelemetryOnFailure(diagnostics.measure('session.lock.wait', () => lockManager.acquire(resourceLockKey, {
         signal: sessionController.signal,
         onWait: () => {
             didWaitForResourceLock = true;
@@ -298,7 +349,7 @@ export const createHarnessSession = async (globalConfig, { lockManager = default
             logRunnerStillWaitingInQueue(platform);
             sessionLogger.debug('still waiting in queue for runner=%s key=%s elapsedMs=%d', platform.name, resourceLockKey, elapsedMs);
         },
-    }), { lockKey: resourceLockKey });
+    }), { lockKey: resourceLockKey }));
     if (didWaitForResourceLock)
         logRunnerStarting(platform);
     sessionLogger.debug('resource lock acquired for runner=%s key=%s', platform.name, resourceLockKey);
@@ -344,7 +395,10 @@ export const createHarnessSession = async (globalConfig, { lockManager = default
         let currentRun = null;
         const getCurrentRunId = () => currentRun?.runId;
         const clientLogCollector = createClientLogCollector();
-        const context = { platform };
+        const context = {
+            platform,
+            updateSnapshot: globalConfig.updateSnapshot,
+        };
         const crashArtifactWriter = createCrashArtifactWriter({
             runnerName: platform.name,
             platformId: platform.platformId,
@@ -354,6 +408,11 @@ export const createHarnessSession = async (globalConfig, { lockManager = default
             noServer: true,
             timeout: runtimeConfig.bridgeTimeout,
             context,
+            liveness: {
+                // Loading a test file runs user code that has no timeout of its
+                // own, so it gets the same allowance as starting the bundle.
+                jsBlockBudget: { fileLoadMs: runtimeConfig.bundleStartTimeout },
+            },
         }));
         sessionLogger.debug('bridge initialized on Metro websocket path %s', HARNESS_BRIDGE_PATH);
         let metroInstance;
@@ -365,6 +424,28 @@ export const createHarnessSession = async (globalConfig, { lockManager = default
         let initializationCancelled = false;
         // Noop until the Metro instance resolves and the deriver is attached.
         let disposeMetroDiagnostics = () => undefined;
+        const eagerPrewarm = runtimeConfig.eagerPrewarm !== false;
+        // On small hosts the bundle build and the platform boot compete for the
+        // same few cores, so the platform may ask to boot first.
+        const deferPrewarm = eagerPrewarm && (platform.deferMetroPrewarm?.() ?? false);
+        if (deferPrewarm) {
+            sessionLogger.debug('deferring Metro prewarm until the platform is ready');
+        }
+        const startPrewarm = (instance) => {
+            // prewarm() memoizes this first call, so its session-lifetime setup
+            // signal is the one that matters — later callers' signals cannot
+            // cancel it. Not awaited: callers must not wait for the bundle.
+            const prewarmSpan = diagnostics.start('metro.prewarm', { deferred: deferPrewarm });
+            instance
+                .prewarm({
+                platform: bundlePlatform,
+                signal: sessionController.signal,
+            })
+                .then((completed) => prewarmSpan.end({ completed }))
+                // Swallow AbortError on teardown so it never becomes an
+                // unhandled rejection; non-abort failures resolve false.
+                .catch((error) => prewarmSpan.fail(error));
+        };
         try {
             [metroInstance, platformInstance] = await Promise.all([
                 diagnostics.measure('metro.init', () => getMetroInstance({
@@ -383,30 +464,20 @@ export const createHarnessSession = async (globalConfig, { lockManager = default
                     }
                     initialized.metro = instance;
                     sessionLogger.debug('Metro initialized');
+                    telemetry.phase('metro.ready');
                     // Attach the Metro diagnostics deriver before the eager prewarm
                     // fires so its bundle build/request events land in the trace.
                     disposeMetroDiagnostics = observeMetroEvents(instance.events, diagnostics);
-                    if (runtimeConfig.eagerPrewarm !== false) {
+                    if (eagerPrewarm && !deferPrewarm) {
                         // Kick off the first bundle build while the platform is still booting.
-                        // prewarm() memoizes this first call, so its session-lifetime setup
-                        // signal is the one that matters — later callers' signals cannot
-                        // cancel it. Not awaited: metro.init must resolve immediately.
-                        const prewarmSpan = diagnostics.start('metro.prewarm');
-                        instance
-                            .prewarm({
-                            platform: platform.platformId,
-                            signal: sessionController.signal,
-                        })
-                            .then((completed) => prewarmSpan.end({ completed }))
-                            // Swallow AbortError on teardown so it never becomes an
-                            // unhandled rejection; non-abort failures resolve false.
-                            .catch((error) => prewarmSpan.fail(error));
+                        startPrewarm(instance);
                     }
                     return instance;
                 })),
                 diagnostics.measure('platform.init', () => withPlatformReadyTimeout({
                     timeout: runtimeConfig.platformReadyTimeout,
                     signal: sessionController.signal,
+                    getHostPressure: telemetry.hostPressure,
                     work: async (signal) => {
                         return await import(platform.runner).then((module) => module.default(platform.config, runtimeConfig, {
                             signal,
@@ -418,6 +489,8 @@ export const createHarnessSession = async (globalConfig, { lockManager = default
                             }
                             initialized.platform = instance;
                             sessionLogger.debug('platform runner initialized');
+                            telemetry.attachPlatform(instance);
+                            telemetry.phase('platform.ready');
                             return instance;
                         });
                     },
@@ -437,6 +510,9 @@ export const createHarnessSession = async (globalConfig, { lockManager = default
             ]);
             throw error;
         }
+        if (deferPrewarm) {
+            startPrewarm(metroInstance);
+        }
         const appLaunchOptions = platform.config.appLaunchOptions;
         let currentAppSession = null;
         const crashMonitor = createCrashMonitor();
@@ -462,7 +538,7 @@ export const createHarnessSession = async (globalConfig, { lockManager = default
         const appReadyBaseOptions = {
             metroInstance,
             bridge,
-            platformId: platform.platformId,
+            platformId: bundlePlatform,
             bundleStartTimeout: runtimeConfig.bundleStartTimeout ?? 60000,
             readyTimeout: runtimeConfig.bridgeTimeout,
             maxAppRestarts: runtimeConfig.maxAppRestarts ?? 2,
@@ -525,6 +601,7 @@ export const createHarnessSession = async (globalConfig, { lockManager = default
             // Abort only cancels finite/in-flight work. Ownership remains explicit
             // below, so this cannot race a platform or app-session disposal path.
             sessionController.abort();
+            telemetry.phase('dispose');
             const hookWork = (async () => {
                 await hooks.drain();
                 await pluginManager.callHook('harness:after-run', {
@@ -551,6 +628,9 @@ export const createHarnessSession = async (globalConfig, { lockManager = default
             else if (hookResult.status === 'rejected') {
                 hookError = hookResult.reason;
             }
+            // End-of-run telemetry has to observe the platform before it is torn
+            // down, but must never be able to hold teardown up for long.
+            await waitForBoundedSettlement(telemetry.settled(), DISPOSE_TELEMETRY_TIMEOUT_MS);
             if (runtimeConfig.forwardClientLogs) {
                 metroInstance.events.removeListener(clientLogListener);
             }
@@ -607,7 +687,7 @@ export const createHarnessSession = async (globalConfig, { lockManager = default
             disposeSpan.end();
         };
         const dispose = (reason = 'normal') => {
-            disposePromise ??= disposeOnce(reason);
+            disposePromise ??= disposeOnce(reason).finally(() => telemetry.dispose());
             return disposePromise;
         };
         // Switch from setup-phase signal handling to dispose-based handling now
@@ -664,6 +744,7 @@ export const createHarnessSession = async (globalConfig, { lockManager = default
             await hooks.drain();
             sessionLogger.debug('app is ready for %s', testFilePath);
             appReadySpan.end({ file: testFilePath, reused: false });
+            telemetry.phase('app.ready', { file: testFilePath });
         };
         // Shared by restartApp (crash/timeout recovery) and the 'process' reset
         // strategy: kill the current app session and either wait for a fresh one
@@ -789,6 +870,8 @@ export const createHarnessSession = async (globalConfig, { lockManager = default
             config: runtimeConfig,
             context,
             diagnostics,
+            sessionId: telemetry.sessionId,
+            lifecycle: telemetry.lifecycle,
             onTestRunnerEvent: (listener) => {
                 testRunnerEventListeners.add(listener);
                 return () => {
@@ -808,6 +891,9 @@ export const createHarnessSession = async (globalConfig, { lockManager = default
             },
             setRunState: (state) => {
                 currentRun = state;
+                if (state) {
+                    telemetry.trackRun(state.runId);
+                }
             },
             dispose: async (reason = 'normal') => {
                 try {
@@ -826,6 +912,7 @@ export const createHarnessSession = async (globalConfig, { lockManager = default
         // Cancels any inflight init work still holding sessionController.signal
         // (e.g. a platform init call abandoned after a readiness timeout race).
         sessionController.abort();
+        await telemetry.dispose();
         await Promise.allSettled([resourceLease.release(), metroPortLease?.release()]);
         if (receivedEarlySignal) {
             process.exit(1);

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,2BAA2B,EAC3B,IAAI,EACJ,UAAU,EACV,iBAAiB,EACjB,WAAW,EACZ,MAAM,aAAa,CAAC;AAMrB,KAAK,iBAAiB,CAAC,IAAI,SAAS,MAAM,UAAU,IAAI,CACtD,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,KACxB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,CAAC,OAAO,OAAO,WAAY,YAAW,2BAA2B;;IACrE,QAAQ,CAAC,QAAQ,QAAQ;IACzB,QAAQ,CAAC,qBAAqB,EAAG,IAAI,CAAU;gBAMnC,YAAY,EAAE,MAAM,CAAC,YAAY;IAI7C,EAAE,CAAC,IAAI,SAAS,MAAM,UAAU,EAC9B,SAAS,EAAE,IAAI,EACf,QAAQ,EAAE,iBAAiB,CAAC,IAAI,CAAC,GAChC,MAAM,IAAI;IAaP,QAAQ,CACZ,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC;CA6CjB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,2BAA2B,EAC3B,IAAI,EACJ,UAAU,EACV,iBAAiB,EACjB,WAAW,EACZ,MAAM,aAAa,CAAC;AAOrB,KAAK,iBAAiB,CAAC,IAAI,SAAS,MAAM,UAAU,IAAI,CACtD,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,KACxB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,CAAC,OAAO,OAAO,WAAY,YAAW,2BAA2B;;IACrE,QAAQ,CAAC,QAAQ,QAAQ;IACzB,QAAQ,CAAC,qBAAqB,EAAG,IAAI,CAAU;gBAKnC,YAAY,EAAE,MAAM,CAAC,YAAY;IAI7C,EAAE,CAAC,IAAI,SAAS,MAAM,UAAU,EAC9B,SAAS,EAAE,IAAI,EACf,QAAQ,EAAE,iBAAiB,CAAC,IAAI,CAAC,GAChC,MAAM,IAAI;IAaP,QAAQ,CACZ,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAClB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC;CA8CjB"}