@rehearsal-labs/retest 0.2.0 → 0.3.0

package/dist/browser/firefox/process.d.ts

@@ -51,6 +51,11 @@ export declare class FirefoxProcess {
     get exit(): ProcessExit | undefined;
     /** True once the main process has exited. */
     get mainGone(): boolean;
+    /**
+     * Whether ending this process ends `pid`: when it is this process, or, where a job holds the launch, a process in that
+     * job, as the browser the Windows launcher starts and waits for is.
+     */
+    ends(pid: number, deadline?: Deadline): Promise<boolean>;
     /**
      * Records the processes Firefox started since the last look, while it is still there to be their parent, from a
      * reading that does not hold the thread.
@@ -68,7 +73,10 @@ export declare class FirefoxProcess {
      * it, such as `ws://127.0.0.1:50928`. Fails when the process ends first or the deadline passes.
      */
     waitForAddress(deadline: Deadline): Promise<string>;
-    /** Settles once the main process has exited, no recorded process is left and its output is in the log. */
+    /**
+     * Settles once the main process has exited, no recorded process is left and its output is in the log. Rejects, naming
+     * what still ran, when the rest is not gone `exitedGroupLimitMs` after the main process exited.
+     */
     gone(): Promise<void>;
     /**
      * Waits up to `graceMs` for the main process and every recorded one to end, kills the recorded ones still there after
@@ -86,6 +94,13 @@ export type ProcessTable = {
     /** Checks every recorded pid's birth and every group member without changing recorded commands. */
     endedAsync?(): Promise<boolean>;
 };
+/**
+ * The program a process runs, by its executable's own name. On Windows a reading gives the image's own path, spaces and
+ * all, and `ps` gives a command line, whose first word, or its quoted first part, is the program.
+ *
+ * @example programName('C:\\Program Files\\Mozilla Firefox\\firefox.exe') // 'firefox.exe'
+ */
+export declare function programName(command: string): string;
 /** A process a route claimed: its id, folder and profile, its ownership, its child handle on the spawn route, and its output. */
 type ClaimedFirefox = {
     pid: number;
@@ -99,6 +114,10 @@ type ClaimedFirefox = {
     /** Copies output the route left in a file of its own into the log, once the process is gone. */
     copyOutput?: () => Promise<string[]>;
     cancelOutput?: () => void;
+    /** Stops reading output whose launch was shown ended, keeping what was read; the spawn route's redacted output has it. */
+    finishOutput?: () => void;
+    /** Whether a process outside Retest, inside the launch or not, can still write to the output Retest reads. */
+    outputWritersRemain?: () => boolean;
     /** The process table the Launch Services route watches; the host's own unless a test gives one. */
     table?: ProcessTable;
     /** When the claimed process started, as the launch recorded it, which tells it from a later process with its pid. */

package/dist/browser/firefox/process.d.ts.map

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

package/dist/browser/firefox/process.js

@@ -2,7 +2,7 @@ import { execFile, spawn } from 'node:child_process';
 import { once } from 'node:events';
 import { rmSync } from 'node:fs';
 import { appendFile, mkdir, open, readFile, rm } from 'node:fs/promises';
-import { dirname, join } from 'node:path';
+import { basename, dirname, join, win32 } from 'node:path';
 import { Readable } from 'node:stream';
 import { setTimeout as sleep } from 'node:timers/promises';
 import { waitBeforeRead } from "../../assertions/wait-before-read.js";
@@ -11,13 +11,19 @@ import { Deadline } from "../../protocol/deadline.js";
 import { defaultTimeouts } from "../../protocol/timeouts.js";
 import { errorMessage } from "../../protocol/failures.js";
 import { s, parse } from "../../protocol/schema.js";
+import { withoutVariables } from "../../shared/environment.js";
+import { listWords } from "../../shared/list-words.js";
 import { describeExit } from "../../shared/process-exit.js";
 import { OwnedProcessGroup, unverifiedMembersProblem } from "../../shared/process-ownership.js";
+import { holdLaunch, launchesHeldByJob, prepareOwnedLaunch } from "../../shared/process-system.js";
+import { exitRemovalMs, groupEndsNow, outputWithin, removeOnceFree } from "../chromium-process.js";
 import { closeGraceMs, LaunchError } from "../contract.js";
 import { writeRedactedLog } from "../redacted-log.js";
-import { ownerIdentityAsync, writeOwnerRecord } from "./profile.js";
+import { ownerIdentityAsync, ownerStartVersion, writeOwnerRecord } from "./profile.js";
 import { isRunning, readProcessTable, readProcessIdentityAsync, readProcessIdentity, readProcessLivenessAsync, readProcessTableAsync } from "./process-table.js";
 const pollMs = 20;
+// How long what Firefox's main process leaves is waited for once it exited, as Chromium's group is.
+const exitedGroupLimitMs = 5 * closeGraceMs;
 // How often the Launch Services route reads the process table for a Firefox whose connection still stands. The
 // connection's end is the usual sign that the browser went; this rare look, taken without holding the thread, is for a
 // Firefox that went without closing it, and a look every `pollMs * 5` follows once the connection ended.
@@ -50,6 +56,8 @@ export class FirefoxProcess {
     #lastResort;
     #outputClosed;
     #cancelOutput;
+    #finishOutput;
+    #outputWritersRemain;
     #copyOutput;
     #table;
     #startedAt;
@@ -69,6 +77,8 @@ export class FirefoxProcess {
         this.#outputClosed = fields.output;
         this.#copyOutput = fields.copyOutput;
         this.#cancelOutput = fields.cancelOutput;
+        this.#finishOutput = fields.finishOutput;
+        this.#outputWritersRemain = fields.outputWritersRemain;
         this.#table = fields.table ?? { readAsync: readProcessTableAsync };
         this.#startedAt = fields.startedAt;
         const { child } = fields;
@@ -101,7 +111,7 @@ export class FirefoxProcess {
         const started = options.route === 'spawn' ? await spawnFirefox(options) : await openFirefox(options);
         const record = started.identity;
         try {
-            await writeOwnerRecord(options.folder, { version: 1, startTimeVersion: 1, owner, firefox: { pid: record.pid, startedAt: record.startedAt, command: record.command, route: options.route }, profile: options.profile });
+            await writeOwnerRecord(options.folder, { version: 1, startTimeVersion: ownerStartVersion, owner, firefox: { pid: record.pid, startedAt: record.startedAt, command: record.command, route: options.route }, profile: options.profile });
         }
         catch (error) {
             const problems = await started.stop(0);
@@ -117,6 +127,18 @@ export class FirefoxProcess {
     get mainGone() {
         return this.#mainGone;
     }
+    /**
+     * Whether ending this process ends `pid`: when it is this process, or, where a job holds the launch, a process in that
+     * job, as the browser the Windows launcher starts and waits for is.
+     */
+    async ends(pid, deadline) {
+        if (pid === this.pid)
+            return true;
+        if (!this.#ownership.heldByJob)
+            return false;
+        await this.recordDescendants(deadline);
+        return this.#ownership.verifiedIdentity(pid) !== undefined;
+    }
     /**
      * Records the processes Firefox started since the last look, while it is still there to be their parent, from a
      * reading that does not hold the thread.
@@ -139,6 +161,13 @@ export class FirefoxProcess {
         this.expectExit();
         const deadline = new Deadline(timeoutMs);
         const problems = [];
+        // A job ends every process at once, so none can start another meanwhile, and Windows has no stopped state to wait for.
+        if (this.#ownership.heldByJob) {
+            problems.push(...this.#ownership.signalNow('SIGKILL', deadline));
+            if (problems.length > 0)
+                throw new Error(problems.join(' '));
+            return;
+        }
         try {
             await this.#stopForCrash(deadline);
             // The Remote Agent ends before content, so a lost input cannot receive a content-process protocol error.
@@ -206,17 +235,44 @@ export class FirefoxProcess {
             await waitBeforeRead(deadline, pollMs);
         }
     }
-    /** Settles once the main process has exited, no recorded process is left and its output is in the log. */
+    /**
+     * Settles once the main process has exited, no recorded process is left and its output is in the log. Rejects, naming
+     * what still ran, when the rest is not gone `exitedGroupLimitMs` after the main process exited.
+     */
     gone() {
-        this.#gone ??= this.#awaitGone();
+        if (this.#gone === undefined) {
+            this.#gone = this.#awaitGone();
+            // Marks the rejection handled for a browser nobody waits on; every caller that awaits `gone` still receives it.
+            this.#gone.catch(() => undefined);
+        }
         return this.#gone;
     }
+    // The main process can run as long as its browser is used, so its exit is awaited as it comes. What it leaves is given
+    // the bound Chromium's processes get, so a process that never ends is a cleanup failure, never a wait without end.
     async #awaitGone() {
         await this.exited;
+        const deadline = new Deadline(exitedGroupLimitMs);
+        // Each reading keeps its own bound, as before, so the limit cuts no reading short into a failed one.
         await this.recordDescendants();
-        while (!(await this.#helpersGone()))
-            await sleep(pollMs * 5, undefined, { ref: false });
-        await this.outputSettled;
+        // What the newest reading that succeeded found still running, and why the readings after it failed, if they did: a
+        // process is named as still running only once a reading showed it.
+        let shown;
+        let failed;
+        while (!(await this.#helpersGone())) {
+            const look = this.#ownership.lastLook;
+            if (look !== undefined && 'running' in look)
+                [shown, failed] = [look.running, undefined];
+            else if (look !== undefined)
+                failed = look.problem;
+            if (deadline.reached)
+                throw new Error(stillRunning(this.pid, shown, failed));
+            await sleep(Math.min(pollMs * 5, deadline.remainingMs), undefined, { ref: false });
+        }
+        if (await settlesWithin(this.outputSettled, deadline))
+            return;
+        // The Launch Services route copies its output into the log as it stops, which its stop reports on.
+        if (this.#copyOutput === undefined)
+            throw new Error(`Firefox's output did not close within ${exitedGroupLimitMs} ms after its main process ${this.pid} exited.`);
     }
     /**
      * Waits up to `graceMs` for the main process and every recorded one to end, kills the recorded ones still there after
@@ -245,11 +301,13 @@ export class FirefoxProcess {
         catch (error) {
             problems.push(`Could not end Firefox's process group ${this.pid}: ${errorMessage(error)}`);
         }
-        if (!(await settlesWithin(this.#outputClosed, new Deadline(closeGraceMs)))) {
-            problems.push("Firefox's output did not close within the cleanup bound.");
-            this.#cancelOutput?.();
-        }
-        problems.push(...(await this.#outputClosed));
+        // The output's bound follows the launch's confirmed end, as a Chromium browser's does: once its close bound passes,
+        // waiting I/O is read, and once nothing can write to the output, or nothing of the launch is left, Retest's own
+        // writing of what it read gets a bound of its own.
+        const finishReading = this.#finishOutput;
+        const writersRemain = this.#outputWritersRemain;
+        const output = { closed: this.#outputClosed, cancel: () => this.#cancelOutput?.(), ...(finishReading === undefined ? {} : { finishReading }), ...(writersRemain === undefined ? {} : { writersRemain }) };
+        problems.push(...(await outputWithin(output, closeGraceMs, async () => this.#mainGone && !(await this.#ownership.remainsAsync(deadline)))));
         if (this.#copyOutput !== undefined)
             problems.push(...(await this.#copyOutput()));
         this.#settleCopied();
@@ -320,6 +378,32 @@ export class FirefoxProcess {
         });
     }
 }
+// What still ran of a Firefox whose main process exited, by pid and the name of its program, never its arguments, as the
+// newest look that succeeded showed it, or that Retest could not look: every look after the exit failed.
+function stillRunning(pid, shown, failed) {
+    if (shown === undefined)
+        return `Retest could not look for what Firefox ${pid} left running after it exited.`;
+    const named = shown.filter((entry) => entry.pid !== pid).map((entry) => `${entry.pid} (${programName(entry.command)})`);
+    if (named.length === 0)
+        return `Firefox ${pid} still has processes running ${exitedGroupLimitMs / 1000} seconds after it exited.`;
+    const listed = named.length <= 3 ? listWords(named, 'and') : `${named.slice(0, 3).join(', ')} and ${named.length - 3} more`;
+    const subject = `Firefox process${named.length === 1 ? '' : 'es'} ${listed}`;
+    if (failed !== undefined)
+        return `${subject} ${named.length === 1 ? 'was' : 'were'} still running when Retest could last look.`;
+    return `${subject} ${named.length === 1 ? 'is' : 'are'} still running ${exitedGroupLimitMs / 1000} seconds after Firefox ${pid} exited.`;
+}
+/**
+ * The program a process runs, by its executable's own name. On Windows a reading gives the image's own path, spaces and
+ * all, and `ps` gives a command line, whose first word, or its quoted first part, is the program.
+ *
+ * @example programName('C:\\Program Files\\Mozilla Firefox\\firefox.exe') // 'firefox.exe'
+ */
+export function programName(command) {
+    if (/^(?:[A-Za-z]:)?\\/.test(command))
+        return win32.basename(command);
+    const quoted = /^"([^"]+)"/.exec(command)?.[1];
+    return win32.basename(quoted ?? command.split(' ')[0] ?? command);
+}
 // Whether `promise` settles before the deadline passes.
 async function settlesWithin(promise, deadline) {
     let timer;
@@ -342,27 +426,35 @@ async function spawnFirefox(options) {
     const log = await openLog(logFile);
     let logHandedOn = false;
     try {
-        const hidden = new Set(options.hiddenVariables);
-        const environment = { ...Object.fromEntries(Object.entries(process.env).filter(([name]) => !hidden.has(name))), ...crashReporterOff };
+        const environment = { ...withoutVariables(process.env, options.hiddenVariables), ...crashReporterOff };
         // Output to redact comes through Retest; any other goes straight to the log.
         const redacting = redact !== undefined || redactStream !== undefined;
+        try {
+            prepareOwnedLaunch();
+        }
+        catch (error) {
+            throw new LaunchError(`Cannot start ${executable}: ${errorMessage(error)}`, { cause: error });
+        }
         const child = spawn(executable, firefoxArguments(profile, options.headless), { env: environment, detached: true, stdio: ['ignore', redacting ? 'pipe' : log.fd, redacting ? 'pipe' : log.fd] });
         await once(child, 'spawn').catch((error) => {
             throw new LaunchError(`Cannot start ${executable}: ${errorMessage(error)}`, { cause: error });
         });
-        const { ownership, table } = await claimOwnership(child.pid ?? 0, process.pid);
+        // Where a job holds the launch, its own process list is the table; the process table `ps` reads exists only on Unix.
+        // The folder's name is in the command line of the browser a Windows launcher starts, which may be in a job of its own.
+        const { ownership, table } = launchesHeldByJob ? { ownership: holdLaunch(child, { marker: basename(folder) }), table: undefined } : await claimOwnership(child.pid ?? 0, process.pid);
         const ownershipProblems = ownership.capture();
         // Without redaction Firefox writes to the log itself, until it exits.
         let output = child.exitCode !== null || child.signalCode !== null ? Promise.resolve([]) : new Promise((resolve) => child.once('exit', () => resolve([])));
-        let cancelOutput;
+        let reading;
         if (redacting) {
             const streams = [child.stdout, child.stderr].flatMap((stream) => (stream instanceof Readable ? [stream] : []));
             const writer = writeRedactedLog(streams, log, redact ?? ((text) => text), redactStream);
             output = writer.closed;
-            cancelOutput = writer.cancel;
+            // A pipe reaches its end only once every process holding its write end, inside the launch or not, has let go.
+            reading = { cancelOutput: writer.cancel, finishOutput: writer.finishReading, outputWritersRemain: () => streams.some((stream) => !stream.readableEnded && !stream.destroyed) };
             logHandedOn = true;
         }
-        const firefox = new FirefoxProcess({ pid: child.pid ?? 0, route: 'spawn', folder, profile, ownership, table, child, output, ...(cancelOutput === undefined ? {} : { cancelOutput }) });
+        const firefox = new FirefoxProcess({ pid: child.pid ?? 0, route: 'spawn', folder, profile, ownership, child, output, ...(table === undefined ? {} : { table }), ...reading });
         if (!redacting) {
             logHandedOn = true;
             await log.close().catch(() => undefined);
@@ -511,9 +603,19 @@ function parseJson(text) {
 // is why every launch first ends the Firefoxes of launchers that are gone.
 function killAtExit(ownership, folder) {
     try {
-        ownership.signalNow('SIGKILL');
-        if (!ownership.remains())
-            rmSync(folder, { recursive: true, force: true, maxRetries: 3 });
+        if (!launchesHeldByJob) {
+            ownership.signalNow('SIGKILL');
+            if (!ownership.remains())
+                rmSync(folder, { recursive: true, force: true, maxRetries: 3 });
+            return;
+        }
+        // On Windows the end also reads and ends what the launch's parent holds, each step a run of retest-supervisor that
+        // holds the exiting thread, so the end and its confirmation get the bound Chromium's exit gets, and the removal,
+        // which the folder refuses for a moment after its processes left their job, gets one of its own.
+        const deadline = new Deadline(closeGraceMs);
+        ownership.signalNow('SIGKILL', deadline);
+        if (groupEndsNow(ownership, deadline))
+            removeOnceFree(folder, new Deadline(exitRemovalMs));
     }
     catch {
         // Throwing here would replace the exit code Retest chose.

package/dist/browser/firefox/profile.d.ts

@@ -30,6 +30,11 @@ export type OwnerRecord = {
     };
     profile: string;
 };
+/**
+ * How the starts in a record this platform writes are read: 1 is `ps` in the C locale under UTC0, 2 the creation time
+ * Windows keeps, in 100 ns ticks since 1601. A record of another version is never compared.
+ */
+export declare const ownerStartVersion: number;
 /**
  * This process as `ps` reads it, read once: the owner every record of this process names.
  *

package/dist/browser/firefox/profile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../../src/browser/firefox/profile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAA;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAM9C,qHAAqH;AACrH,eAAO,MAAM,mBAAmB,oBAAoB,CAAA;AAEpD,iGAAiG;AACjG,eAAO,MAAM,eAAe,sBAAsB,CAAA;AAElD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAuBlF,CAAA;AAED,2FAA2F;AAC3F,MAAM,MAAM,aAAa,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/E;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG;IAAE,OAAO,EAAE,CAAC,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,aAAa,GAAG;QAAE,KAAK,EAAE,YAAY,CAAA;KAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAa5J;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,GAAE,MAAM,SAAS,oBAAoB,EAAqB,GAAG,aAAa,CAM5G;AAED,0FAA0F;AAC1F,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,aAAa,CAAC,CAIjE;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAepG;AAED,iHAAiH;AACjH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAIzF;AAED,4FAA4F;AAC5F,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAetF"}
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../../src/browser/firefox/profile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAA;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAO9C,qHAAqH;AACrH,eAAO,MAAM,mBAAmB,oBAAoB,CAAA;AAEpD,iGAAiG;AACjG,eAAO,MAAM,eAAe,sBAAsB,CAAA;AAElD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CA0BlF,CAAA;AAED,2FAA2F;AAC3F,MAAM,MAAM,aAAa,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/E;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG;IAAE,OAAO,EAAE,CAAC,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,aAAa,GAAG;QAAE,KAAK,EAAE,YAAY,CAAA;KAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAW5J;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAkC,CAAA;AAIlE;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,GAAE,MAAM,SAAS,oBAAoB,EAAqB,GAAG,aAAa,CAM5G;AAED,0FAA0F;AAC1F,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,aAAa,CAAC,CAUjE;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAepG;AAED,iHAAiH;AACjH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAIzF;AAED,4FAA4F;AAC5F,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAetF"}

package/dist/browser/firefox/profile.js

@@ -1,6 +1,7 @@
 import { mkdir, mkdtemp, readFile, realpath, rename, rm, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { s, parse } from "../../protocol/schema.js";
+import { launchesHeldByJob, readHeldProcess } from "../../shared/process-system.js";
 import { readProcessTable, readProcessTableAsync } from "./process-table.js";
 /** How the temporary folders of Firefox launches begin: `retest-firefox-<pid of the launching process>-<random>`. */
 export const firefoxFolderPrefix = 'retest-firefox-';
@@ -11,7 +12,7 @@ export const ownerRecordFile = 'retest-owner.json';
  * since `remote.prefs.recommended` is on by default; these name what Retest relies on instead of leaving it to that list.
  */
 export const firefoxPreferences = {
-    // WebDriver BiDi only. Firefox 133 still offers its deprecated CDP endpoint under other values.
+    // WebDriver BiDi only, the one protocol Retest speaks to Firefox.
     'remote.active-protocols': 1,
     // No update is downloaded or applied, and no restart is asked for, while a test runs.
     'app.update.disabledForTesting': true,
@@ -33,6 +34,9 @@ export const firefoxPreferences = {
     // No page is kept in the back-forward cache, so a move through the history always loads its document again and
     // Firefox tells of it as a navigation.
     'browser.sessionhistory.max_total_viewers': 0,
+    // Firefox 158 writes each error of a page's script to its output, with the script's address and query, which the
+    // browser log keeps; Firefox 133 wrote none.
+    'browser.dom.window.dump.enabled': false,
 };
 const identitySchema = s.object({ pid: s.number({ integer: true, min: 1 }), startedAt: s.string(), command: s.string() });
 const recordSchema = s.object({
@@ -42,6 +46,11 @@ const recordSchema = s.object({
     firefox: s.object({ pid: s.number({ integer: true, min: 2 }), startedAt: s.string(), command: s.string(), route: s.enum(['spawn', 'launch-services']) }),
     profile: s.string(),
 });
+/**
+ * How the starts in a record this platform writes are read: 1 is `ps` in the C locale under UTC0, 2 the creation time
+ * Windows keeps, in 100 ns ticks since 1601. A record of another version is never compared.
+ */
+export const ownerStartVersion = launchesHeldByJob ? 2 : 1;
 let ownIdentity;
 /**
  * This process as `ps` reads it, read once: the owner every record of this process names.
@@ -61,6 +70,13 @@ export function ownerIdentity(table = readProcessTable) {
 export async function ownerIdentityAsync() {
     if (ownIdentity !== undefined)
         return ownIdentity;
+    if (launchesHeldByJob) {
+        const own = readHeldProcess(process.pid);
+        if (own === undefined)
+            throw new Error(`Windows does not show this process, ${process.pid}, so no Firefox it launches could be recorded as its own.`);
+        ownIdentity = { pid: own.pid, startedAt: own.startedAt, command: own.image ?? '' };
+        return ownIdentity;
+    }
     const table = await readProcessTableAsync();
     return ownerIdentity(() => table);
 }

package/dist/browser/firefox/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/browser/firefox/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAA;AAS/F,2FAA2F;AAC3F,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;IACjB,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAkCD;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAI7H;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,YAAY,CAMvE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYhF;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAa7I;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAG/J;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAAC,CAAC,EAC9C,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EACrD,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,CAAC,EAAE,CAAC,CAwBd"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/browser/firefox/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAA;AAU/F,2FAA2F;AAC3F,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;IACjB,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAkCD;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAI7H;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,YAAY,CAMvE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYhF;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAa7I;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAG/J;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAAC,CAAC,EAC9C,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EACrD,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,CAAC,EAAE,CAAC,CAyBd"}

package/dist/browser/firefox/storage.js

@@ -4,6 +4,7 @@ import { readStorageFunction, writeStorageFunction } from "../page-scripts.js";
 import { webOrigin } from "../storage-state.js";
 import { readBidi } from "./bidi-client.js";
 import { callInSandbox } from "./sandbox.js";
+import { subscribedSchema, unsubscribeParameters } from "./subscriptions.js";
 import { inWindowOrder } from "./window-order.js";
 const cookiesSchema = s.object({
     cookies: s.array(s.object({
@@ -117,8 +118,9 @@ export async function inFirefoxOriginDocuments(client, userContext, origins, wor
     const { context } = await inWindowOrder(client, deadline, () => client.request('browsingContext.create', { type: 'tab', userContext, background: true }, contextSchema, { ...options(), keepErrorMessage: true }));
     const stop = client.on('network.beforeRequestSent', (params) => answerPaused(client, context, params, deadline));
     let intercept;
+    let subscription;
     try {
-        await client.request('session.subscribe', { events: ['network.beforeRequestSent'], contexts: [context] }, s.object({}), options());
+        subscription = (await client.request('session.subscribe', { events: ['network.beforeRequestSent'], contexts: [context] }, subscribedSchema, options())).subscription;
         intercept = (await client.request('network.addIntercept', { phases: ['beforeRequestSent'], contexts: [context] }, interceptSchema, options())).intercept;
         const results = [];
         for (const origin of origins) {
@@ -131,7 +133,7 @@ export async function inFirefoxOriginDocuments(client, userContext, origins, wor
         stop();
         if (intercept !== undefined)
             await client.send('network.removeIntercept', { intercept }, options()).catch(() => undefined);
-        await client.send('session.unsubscribe', { events: ['network.beforeRequestSent'], contexts: [context] }, options()).catch(() => undefined);
+        await client.send('session.unsubscribe', unsubscribeParameters({ id: subscription, events: ['network.beforeRequestSent'], contexts: [context] }), options()).catch(() => undefined);
         await inWindowOrder(client, deadline, () => client.send('browsingContext.close', { context }, options())).catch(() => {
             // Removing the user context closes the tab with it, and the error that matters is the work's own.
         });

package/dist/browser/firefox/subscriptions.d.ts

@@ -0,0 +1,26 @@
+import type { Schema } from '../../protocol/schema.ts';
+/** What `session.subscribe` answers: the subscription's id, from a Firefox later than 133, or nothing. */
+export type Subscribed = {
+    subscription?: string;
+};
+export declare const subscribedSchema: Schema<Subscribed>;
+/** One subscription as it was made: the id the browser gave it, if any, and the events and contexts it named. */
+export type Subscription = {
+    readonly id: string | undefined;
+    readonly events: readonly string[];
+    readonly contexts: readonly string[];
+};
+/** What `session.unsubscribe` is sent to end a subscription: its id, or its events and contexts. */
+export type UnsubscribeParameters = {
+    readonly subscriptions: readonly string[];
+} | {
+    readonly events: readonly string[];
+    readonly contexts: readonly string[];
+};
+/**
+ * The parameters that end `subscription`, by its id when the browser gave one.
+ *
+ * @example unsubscribeParameters({ id: undefined, events: ['script'], contexts: [context] }) // { events: ['script'], contexts: [context] }
+ */
+export declare function unsubscribeParameters(subscription: Subscription): UnsubscribeParameters;
+//# sourceMappingURL=subscriptions.d.ts.map

package/dist/browser/firefox/subscriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../../../src/browser/firefox/subscriptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AAWtD,0GAA0G;AAC1G,MAAM,MAAM,UAAU,GAAG;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAElD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAsD,CAAA;AAEtG,iHAAiH;AACjH,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAA;AAExI,oGAAoG;AACpG,MAAM,MAAM,qBAAqB,GAAG;IAAE,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAA;AAEhK;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,YAAY,GAAG,qBAAqB,CAEvF"}

package/dist/browser/firefox/subscriptions.js

@@ -0,0 +1,10 @@
+import { s } from "../../protocol/schema.js";
+export const subscribedSchema = s.object({ subscription: s.optional(s.string()) });
+/**
+ * The parameters that end `subscription`, by its id when the browser gave one.
+ *
+ * @example unsubscribeParameters({ id: undefined, events: ['script'], contexts: [context] }) // { events: ['script'], contexts: [context] }
+ */
+export function unsubscribeParameters(subscription) {
+    return subscription.id === undefined ? { events: subscription.events, contexts: subscription.contexts } : { subscriptions: [subscription.id] };
+}

package/dist/browser/launch.d.ts

@@ -13,6 +13,12 @@ import { CdpConnection } from './cdp/connection.ts';
  * @example const browser = await launchBrowser({ executablePath, logFile: 'logs/browser.log', headless: true })
  */
 export declare function launchBrowser(options: LaunchOptions, timeoutMs?: number, transport?: (pipe: PipeStreams) => Transport): Promise<WebRuntime>;
+/**
+ * The command line Retest starts Chromium with, the start page last.
+ *
+ * @example chromiumArguments(profile, true).at(-1) // 'about:blank'
+ */
+export declare function chromiumArguments(profile: string, headless: boolean): string[];
 /**
  * Asks the browser what it is, and splits its product into a name and a version.
  *

package/dist/browser/launch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../src/browser/launch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAIlD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAKlD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAgBnD;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,aAAa,EACtB,SAAS,GAAE,MAAwB,EACnC,SAAS,GAAE,CAAC,IAAI,EAAE,WAAW,KAAK,SAA6C,GAC9E,OAAO,CAAC,UAAU,CAAC,CAsCrB;AAgBD;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,CAOtG;AAcD,+EAA+E;AAC/E,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOhE;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAejF;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,aAAa,GAAG,MAAM,CAWpE;AAED,gHAAgH;AAChH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAQjE"}
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../src/browser/launch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAIlD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAKlD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAgBnD;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,aAAa,EACtB,SAAS,GAAE,MAAwB,EACnC,SAAS,GAAE,CAAC,IAAI,EAAE,WAAW,KAAK,SAA6C,GAC9E,OAAO,CAAC,UAAU,CAAC,CAsCrB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,EAAE,CAoB9E;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,CAOtG;AAcD,+EAA+E;AAC/E,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOhE;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAejF;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,aAAa,GAAG,MAAM,CAWpE;AAED,gHAAgH;AAChH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAQjE"}

package/dist/browser/launch.js

@@ -73,7 +73,12 @@ export async function launchBrowser(options, timeoutMs = launchTimeoutMs, transp
         throw new ProcessLaunchError(`${message}${cleanup}`, chromium.gone(), { cause: error, failureClass: problems.length > 0 ? 'cleanup_failed' : 'setup_failed' }, chromium.outputSettled);
     }
 }
-function chromiumArguments(profile, headless) {
+/**
+ * The command line Retest starts Chromium with, the start page last.
+ *
+ * @example chromiumArguments(profile, true).at(-1) // 'about:blank'
+ */
+export function chromiumArguments(profile, headless) {
     return [
         '--remote-debugging-pipe',
         `--user-data-dir=${profile}`,
@@ -81,6 +86,14 @@ function chromiumArguments(profile, headless) {
         '--no-first-run',
         '--no-default-browser-check',
         '--disable-background-networking',
+        // A page whose window another window covers, or that is not in front, keeps its renderer's priority and its
+        // timers: Chromium otherwise backgrounds an occluded window's renderer and throttles a background page's timers,
+        // and a step that waits for the page's next frame or its answer waits on them. These are Chromium's switches
+        // (content/public/common/content_switches.cc); Playwright's default Chromium switches pass the same three on every
+        // platform (packages/playwright-core/src/server/chromium/chromiumSwitches.ts, Apache-2.0, read 23 October 2026).
+        '--disable-backgrounding-occluded-windows',
+        '--disable-renderer-backgrounding',
+        '--disable-background-timer-throttling',
         // Keeps a fresh profile out of the login keychain that the person's own Chrome uses.
         ...(process.platform === 'darwin' ? ['--use-mock-keychain'] : []),
         'about:blank',

package/dist/cli/commands/doctor.js

@@ -10,7 +10,7 @@ import { parseArguments, value } from "../arguments.js";
 import { defaultConfigFile, findConfig, missingConfig } from "../config-file.js";
 import { runChecks } from "../doctor/checks.js";
 import { UsageError } from "../errors.js";
-import { shouldUseColor } from "../terminal.js";
+import { shouldUseColor, terminalMarks } from "../terminal.js";
 const options = {
     config: value({ placeholder: '<path>', description: `Config file. Default: ${defaultConfigFile}` }),
 };
@@ -43,7 +43,7 @@ export const doctorCommand = {
             removeLogs(logFolder);
         if (dependencies.signal.aborted)
             return interruptedExitCode(dependencies.signal);
-        const style = createStyle(shouldUseColor(dependencies.stdout, dependencies.env));
+        const style = createStyle(shouldUseColor(dependencies.stdout, dependencies.env), terminalMarks(dependencies.stdout, dependencies.env));
         dependencies.stdout.write(renderChecks(checks, config, style));
         return problems === 0 ? 0 : 2;
     },
@@ -71,7 +71,7 @@ export function renderChecks(checks, config, style) {
     for (const check of shown) {
         const shownGroup = check.group === group ? '' : check.group;
         group = check.group;
-        const mark = check.ok ? style.green('✓') : style.red('✗');
+        const mark = check.ok ? style.green(style.marks.passed) : style.red(style.marks.failed);
         const text = check.detail === undefined ? check.text : `${check.text.padEnd(textWidth)}${style.dim(check.detail)}`;
         lines.push(`  ${style.cyan(shownGroup.padEnd(groupWidth))}${check.subject.padEnd(subjectWidth)}${mark} ${text}`);
         if (check.fix !== undefined)

package/dist/cli/commands/inspect.js

@@ -14,7 +14,7 @@ import { CliError, UsageError } from "../errors.js";
 import { readTestDiagnostics, renderTestDiagnostics } from "../inspect/diagnostics.js";
 import { renderTimeline } from "../inspect/test-timeline.js";
 import { suggest } from "../suggest.js";
-import { shouldUseColor } from "../terminal.js";
+import { shouldUseColor, terminalMarks } from "../terminal.js";
 const listedTests = 10;
 const options = {
     json: flag('Print one JSON document: the run result, or the test with --test'),
@@ -82,7 +82,7 @@ function writeTest(request, dependencies) {
         stdout.write(`${JSON.stringify(report, null, 2)}\n`);
         return;
     }
-    const style = createStyle(shouldUseColor(stdout, dependencies.env));
+    const style = createStyle(shouldUseColor(stdout, dependencies.env), terminalMarks(stdout, dependencies.env));
     const targets = runTargets(record, folder.result);
     stdout.write(`\n${renderTimeline(test, events, { style, runFolder: shown, targets })}`);
     stdout.write(renderTestDiagnostics(diagnostics, events, { style, runFolder: shown }));
@@ -97,6 +97,7 @@ function writeRun(folder, shown, dependencies) {
         stdout: dependencies.stdout,
         stderr: dependencies.stderr,
         color: shouldUseColor(dependencies.stdout, dependencies.env),
+        marks: terminalMarks(dependencies.stdout, dependencies.env),
         runFolder: shown,
     });
     for (const event of folder.events)

package/dist/cli/commands/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AA4B5C,eAAO,MAAM,cAAc,EAAE,OAsE5B,CAAA"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AA+B5C,eAAO,MAAM,cAAc,EAAE,OA8E5B,CAAA"}