@rehearsal-labs/retest 0.2.0 → 0.3.0

package/dist/runner/app-server.d.ts

@@ -16,8 +16,9 @@ export type AppServerOptions = {
     hiddenVariables?: readonly string[];
 };
 /**
- * A server `start` made ready. One that already answered is `reused` and never stopped. One Retest `started` has
- * the process id of its shell. `stop` ends only processes whose launch ancestry and exact identity Retest recorded.
+ * A server `start` made ready. One that was already there, whose port took Retest's connection, is `reused` and never
+ * stopped. One Retest `started` has the process id of its shell. `stop` ends only processes whose launch ancestry and
+ * exact identity Retest recorded.
  */
 export type AppServerHandle = {
     readonly status: 'reused';
@@ -35,6 +36,21 @@ export declare class AppServerError extends Error {
     readonly failure: Failure;
     constructor(problem: Failure);
 }
+/**
+ * What one look at a server's `ready` address found. `answered`: an HTTP answer came, whatever its status.
+ * `accepted`: the port took the connection, so a server is there, but no HTTP answer came. `refused`: the connection
+ * was refused, or the host's name resolves to nothing, so no server is there. `unreached`: the connection neither opened
+ * nor was refused, or failed in another way first, or the address is not HTTP, so nothing is known.
+ */
+export type ReadyLook = 'answered' | 'accepted' | 'refused' | 'unreached';
+/**
+ * Asks `url` once with an HTTP GET and says what it found within `timeoutMs`, or before `signal` aborts. What came in
+ * while this process was held busy counts, as does a connection asked for just before: a limit that passed while the
+ * process was held is judged a moment after it wakes, once those events have been read.
+ *
+ * @example await lookAtReady('http://127.0.0.1:3000/health', 1000) // 'answered'
+ */
+export declare function lookAtReady(url: string, timeoutMs: number, signal?: AbortSignal): Promise<ReadyLook>;
 /**
  * Asks `url` once, within `timeoutMs`, whether a server answers there. Any HTTP answer counts, whatever its
  * status; a refused connection, a timeout or anything that is not HTTP does not.
@@ -43,17 +59,21 @@ export declare class AppServerError extends Error {
  */
 export declare function probeReady(url: string, timeoutMs: number): Promise<boolean>;
 /**
- * Makes an app's server ready within `timeoutMs`. When `ready` already answers, that server is reused. Otherwise
- * `command` runs in a shell, as its own process group, with its output in `logFile`, until `ready` answers. A
- * server that exits first, or never answers, is stopped and throws `AppServerError`. The parent's exit also ends
+ * Makes an app's server ready within `timeoutMs`. Whether a server is already there is a fact about the connection,
+ * not about how soon it answers. When the port at `ready` takes the connection, that server is reused: Retest waits
+ * for it to answer within `timeoutMs`, as it waits for one it starts, and one that never answers throws
+ * `AppServerError` and is left running. When the connection is refused, or neither opens nor is refused within a
+ * second, `command` runs in a shell, as its own process group, with its output in `logFile`, until `ready` answers.
+ * A server that exits first, or never answers, is stopped and throws `AppServerError`. The parent's exit also ends
  * every recorded process still running, after checking its exact identity again.
  *
  * @example const server = await startAppServer({ name: 'web', start, logFile }, 60_000); await server.stop(1000)
  */
 export declare function startAppServer(options: AppServerOptions, timeoutMs: number, dependencies?: AppServerDependencies): Promise<AppServerHandle>;
-/** Internal readiness seams; production uses the owned server and HTTP probe. */
+type ReadyLooker = (url: string, timeoutMs: number, signal?: AbortSignal) => Promise<ReadyLook>;
+/** Internal readiness seams; production uses the owned server and the HTTP look. */
 export type AppServerDependencies = {
-    readonly probe?: (url: string, timeoutMs: number) => Promise<boolean>;
+    readonly probe?: ReadyLooker;
     readonly launch?: (options: AppServerOptions) => Promise<Launched>;
 };
 type Launched = {

package/dist/runner/app-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-server.d.ts","sourceRoot":"","sources":["../../src/runner/app-server.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAiB7C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,WAAW,CAAA;IAClB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAA;IACf,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,wEAAwE;IACxE,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,4GAA4G;IAC5G,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACpC,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,GAClG;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAA;AAE7H,uGAAuG;AACvG,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAkB,IAAI,oBAAmB;IACzC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;gBAEb,OAAO,EAAE,OAAO;CAI7B;AAOD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAa3E;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAE,qBAA0B,GAAG,OAAO,CAAC,eAAe,CAAC,CA8BrJ;AAED,iFAAiF;AACjF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;CACnE,CAAA;AAED,KAAK,QAAQ,GAAG;IACd,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,CAAA;IACtC,8FAA8F;IAC9F,MAAM,IAAI,IAAI,CAAA;IACd,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtC,+CAA+C;IAC/C,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;CACvC,CAAA"}
+{"version":3,"file":"app-server.d.ts","sourceRoot":"","sources":["../../src/runner/app-server.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAmB7C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,WAAW,CAAA;IAClB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAA;IACf,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,wEAAwE;IACxE,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,4GAA4G;IAC5G,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACpC,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,GAClG;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAA;AAE7H,uGAAuG;AACvG,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAkB,IAAI,oBAAmB;IACzC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;gBAEb,OAAO,EAAE,OAAO;CAI7B;AAOD;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,CAAA;AAMzE;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CA4BpG;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEjF;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAE,qBAA0B,GAAG,OAAO,CAAC,eAAe,CAAC,CA6BrJ;AA2BD,KAAK,WAAW,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,SAAS,CAAC,CAAA;AAE/F,oFAAoF;AACpF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;CACnE,CAAA;AAED,KAAK,QAAQ,GAAG;IACd,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,CAAA;IACtC,8FAA8F;IAC9F,MAAM,IAAI,IAAI,CAAA;IACd,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtC,+CAA+C;IAC/C,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;CACvC,CAAA"}

package/dist/runner/app-server.js

@@ -9,9 +9,11 @@ import { closeGraceMs } from "../browser/contract.js";
 import { Deadline, elapsedMs, monotonicClock, smallestBudget } from "../protocol/deadline.js";
 import { errorMessage, failure, withAlso } from "../protocol/failures.js";
 import { isWebUrl, withoutCredentials } from "../protocol/url.js";
+import { withoutVariables } from "../shared/environment.js";
 import { errorCode } from "../shared/error-code.js";
 import { describeExit } from "../shared/process-exit.js";
 import { OwnedProcessGroup } from "../shared/process-ownership.js";
+import { consolesDetached, holdLaunch, launchOwnership, prepareOwnedLaunch, serverStopSignal } from "../shared/process-system.js";
 import { bounded } from "./bounded.js";
 /** Thrown when a server does not become ready. `failure.class` is `setup_failed`, or `interrupted`. */
 export class AppServerError extends Error {
@@ -26,46 +28,77 @@ const probeLimitMs = 1000;
 const pollIntervalMs = 100;
 const liveServers = new Set();
 let exitHookInstalled = false;
+// The errors that say no server is there: nothing listens on the port, or the name is no host's.
+const noServerCodes = new Set(['ECONNREFUSED', 'ENOTFOUND']);
+const wakeGraceMs = 50;
 /**
- * Asks `url` once, within `timeoutMs`, whether a server answers there. Any HTTP answer counts, whatever its
- * status; a refused connection, a timeout or anything that is not HTTP does not.
+ * Asks `url` once with an HTTP GET and says what it found within `timeoutMs`, or before `signal` aborts. What came in
+ * while this process was held busy counts, as does a connection asked for just before: a limit that passed while the
+ * process was held is judged a moment after it wakes, once those events have been read.
  *
- * @example await probeReady('http://127.0.0.1:3000/health', 1000) // true
+ * @example await lookAtReady('http://127.0.0.1:3000/health', 1000) // 'answered'
  */
-export function probeReady(url, timeoutMs) {
+export function lookAtReady(url, timeoutMs, signal) {
     const target = URL.parse(url);
     if (!isWebUrl(target))
-        return Promise.resolve(false);
+        return Promise.resolve('unreached');
     const get = target.protocol === 'https:' ? httpsGet : httpGet;
     const { promise, resolve } = Promise.withResolvers();
-    const request = get(target, { agent: false }, (response) => {
-        resolve(true);
+    let connected = false;
+    const request = get(target, { agent: false, ...(signal === undefined ? {} : { signal }) }, (response) => {
+        resolve('answered');
         response.destroy();
     });
-    const timer = setTimeout(() => request.destroy(), timeoutMs);
-    request.on('error', () => resolve(false));
-    request.on('close', () => resolve(false));
+    request.on('socket', (socket) => {
+        if (!socket.connecting) {
+            connected = socket.readyState === 'open';
+            return;
+        }
+        socket.once('connect', () => {
+            connected = true;
+        });
+    });
+    // A timer that came due while the process was held runs before the events that came in meanwhile, and Node sends a
+    // connection it was asked for only once the process is free; so a late timer gives the look a moment more.
+    const dueAt = monotonicClock() + timeoutMs;
+    let timer = setTimeout(() => {
+        timer = setTimeout(() => request.destroy(), monotonicClock() - dueAt > wakeGraceMs ? wakeGraceMs : 0);
+    }, timeoutMs);
+    request.on('error', (error) => resolve(connected ? 'accepted' : noServerCodes.has(errorCode(error) ?? '') ? 'refused' : 'unreached'));
+    request.on('close', () => resolve(connected ? 'accepted' : 'unreached'));
     return promise.finally(() => clearTimeout(timer));
 }
 /**
- * Makes an app's server ready within `timeoutMs`. When `ready` already answers, that server is reused. Otherwise
- * `command` runs in a shell, as its own process group, with its output in `logFile`, until `ready` answers. A
- * server that exits first, or never answers, is stopped and throws `AppServerError`. The parent's exit also ends
+ * Asks `url` once, within `timeoutMs`, whether a server answers there. Any HTTP answer counts, whatever its
+ * status; a refused connection, a timeout or anything that is not HTTP does not.
+ *
+ * @example await probeReady('http://127.0.0.1:3000/health', 1000) // true
+ */
+export async function probeReady(url, timeoutMs) {
+    return (await lookAtReady(url, timeoutMs)) === 'answered';
+}
+/**
+ * Makes an app's server ready within `timeoutMs`. Whether a server is already there is a fact about the connection,
+ * not about how soon it answers. When the port at `ready` takes the connection, that server is reused: Retest waits
+ * for it to answer within `timeoutMs`, as it waits for one it starts, and one that never answers throws
+ * `AppServerError` and is left running. When the connection is refused, or neither opens nor is refused within a
+ * second, `command` runs in a shell, as its own process group, with its output in `logFile`, until `ready` answers.
+ * A server that exits first, or never answers, is stopped and throws `AppServerError`. The parent's exit also ends
  * every recorded process still running, after checking its exact identity again.
  *
  * @example const server = await startAppServer({ name: 'web', start, logFile }, 60_000); await server.stop(1000)
  */
 export async function startAppServer(options, timeoutMs, dependencies = {}) {
     const interrupted = () => options.signal?.aborted === true;
-    const probe = dependencies.probe ?? probeReady;
+    const look = dependencies.probe ?? lookAtReady;
     const launchServer = dependencies.launch ?? launch;
     const startedAt = monotonicClock();
     const deadline = new Deadline(timeoutMs, { startedAt });
     const { name, start } = options;
     const ready = withoutCredentials(start.ready);
-    if (await probe(start.ready, smallestBudget(probeLimitMs, deadline.commandTimeoutMs))) {
-        return { status: 'reused', durationMs: elapsedMs(startedAt), stop: async () => undefined };
-    }
+    const found = await look(start.ready, smallestBudget(probeLimitMs, deadline.commandTimeoutMs), options.signal);
+    if (found === 'answered' || found === 'accepted')
+        return reuse({ options, timeoutMs, deadline, startedAt, look, found });
     const server = await launchServer(options);
     for (;;) {
         if (interrupted())
@@ -73,7 +106,7 @@ export async function startAppServer(options, timeoutMs, dependencies = {}) {
         if (server.exit !== undefined) {
             return server.fail(failure('setup_failed', `The server for ${name} exited with ${describeExit(server.exit)} before ${ready} answered. Its output is in ${options.logFile}.`));
         }
-        if (await probe(start.ready, smallestBudget(probeLimitMs, deadline.commandTimeoutMs))) {
+        if ((await look(start.ready, smallestBudget(probeLimitMs, deadline.commandTimeoutMs))) === 'answered') {
             server.settle();
             return { status: 'started', pid: server.pid, durationMs: elapsedMs(startedAt), stop: (budget) => server.stop(budget) };
         }
@@ -89,6 +122,21 @@ export async function startAppServer(options, timeoutMs, dependencies = {}) {
     }
     return server.fail(failure('setup_failed', `The server for ${name} did not answer at ${ready} within ${timeoutMs} ms. Its output is in ${options.logFile}.`));
 }
+// A server already there is waited for as long as one Retest starts, each look held open for the time left, so a
+// server slower than a look's second still answers. Retest started nothing, so it stops nothing, whatever the outcome.
+async function reuse({ options, timeoutMs, deadline, startedAt, look, found }) {
+    const { name, start, signal } = options;
+    for (let last = found; last !== 'answered'; last = await look(start.ready, deadline.commandTimeoutMs, signal)) {
+        await sleep(smallestBudget(pollIntervalMs, deadline.waitToEndMs));
+        if (signal?.aborted === true)
+            throw new AppServerError(failure('interrupted', `Waiting for the server for ${name} was interrupted.`));
+        if (deadline.reached) {
+            const ready = withoutCredentials(start.ready);
+            throw new AppServerError(failure('setup_failed', `Something was already listening at ${ready}, so Retest used it as the server for ${name} and started nothing, but it did not answer within ${timeoutMs} ms.`));
+        }
+    }
+    return { status: 'reused', durationMs: elapsedMs(startedAt), stop: async () => undefined };
+}
 /**
  * The server's processes as Retest recorded them. A shell may replace itself with the command it runs, as `sh -c
  * "node server.js"` does, keeping its pid and start under a new command line, and the ownership rule refuses a record
@@ -105,7 +153,7 @@ class ServerOwnership {
     constructor(child, pid) {
         this.#child = child;
         this.#pid = pid;
-        this.#group = new OwnedProcessGroup(pid);
+        this.#group = holdLaunch(child);
     }
     get group() {
         return this.#group;
@@ -117,7 +165,7 @@ class ServerOwnership {
         this.#settled = true;
         if (this.#child.exitCode !== null || this.#child.signalCode !== null)
             return;
-        const settled = new OwnedProcessGroup(this.#pid);
+        const settled = launchOwnership(this.#pid);
         if (settled.capture().length === 0)
             this.#group = settled;
     }
@@ -126,11 +174,13 @@ async function launch({ name, start, logFile, redactor, hiddenVariables }) {
     const folder = checkFolder(name, start.cwd);
     mkdirSync(dirname(logFile), { recursive: true });
     const log = openSync(logFile, 'a');
-    const hidden = new Set(hiddenVariables);
-    const env = Object.fromEntries(Object.entries(process.env).filter(([variable]) => !hidden.has(variable)));
+    const env = withoutVariables(process.env, hiddenVariables);
     let child;
     try {
-        child = spawn(start.command, { shell: true, cwd: folder, env, detached: true, stdio: ['ignore', 'pipe', 'pipe'] });
+        prepareOwnedLaunch();
+        // windowsHide gives the server, on Windows, a console of its own with no window, which Retest can send Ctrl+C to
+        // without reaching its own; Node ignores it elsewhere.
+        child = spawn(start.command, { shell: true, cwd: folder, env, detached: consolesDetached, windowsHide: true, stdio: ['ignore', 'pipe', 'pipe'] });
     }
     catch (error) {
         const problem = failure('setup_failed', `The server for ${name} could not start: ${outputErrorMessage(error, redactor)}`);
@@ -291,7 +341,7 @@ function outputErrorMessage(error, redactor) {
 async function stopGroup(server, timeoutMs) {
     server.settle();
     const ownership = server.group;
-    const problems = ownership.signal('SIGTERM');
+    const problems = ownership.signal(serverStopSignal);
     let gone = await groupGoneWithin(ownership, timeoutMs);
     if (!gone) {
         problems.push(...ownership.signal('SIGKILL'));

package/dist/runner/child.js

@@ -1,6 +1,10 @@
 import { enableCompileCache } from 'node:module';
 // The test file's process. Node compiles every module of an import graph before any of them runs, so the cache goes
 // on here, in a file that imports nothing, and the program is loaded only after. The parent shares the cache: both
-// use Node's default folder unless NODE_COMPILE_CACHE names one.
-enableCompileCache();
+// use Node's default folder unless NODE_COMPILE_CACHE names one. On Windows it stays off: Node writes the cache as the
+// process exits, and from an empty cache that write took longer there than the second the runner gives a process it
+// asked to close, and moved earlier, longer than collection's budget. NODE_COMPILE_CACHE would turn it on before this
+// line runs, so the runner leaves it out of this process's environment there (`testFileEnvironment`).
+if (process.platform !== 'win32')
+    enableCompileCache();
 await import("./child-program.js");

package/dist/runner/media-leftovers.d.ts

@@ -1,4 +1,7 @@
-/** A Retest process, by pid and start time as `ps` prints it, so a pid used again by another process is never taken for it. */
+/**
+ * A Retest process, by pid and start time as `ps` prints it, or on Windows as its creation time in 100 ns intervals, so a
+ * pid used again by another process is never taken for it.
+ */
 export type ProcessMark = {
     readonly startTimeVersion?: number;
     readonly pid: number;
@@ -24,8 +27,9 @@ export type UnfinishedRun = {
  */
 export declare function unfinishedRuns(runFolder: string): UnfinishedRun[];
 /**
- * Whether the process a mark names still runs: true for a confirmed current start, false only when a whole table
- * shows its pid absent; undefined for a present legacy or mismatched start, or an unreadable host. Unknowns stay alone.
+ * Whether the process a mark names still runs: true for a confirmed current start, false only when a whole table, or on
+ * Windows retest-supervisor's reading of the pid, shows it absent; undefined for a present legacy or mismatched start, or
+ * an unreadable host. Unknowns stay alone.
  *
  * @example await processRuns({ pid: 4242, startedAt: 'Mon Oct  6 10:00:01 2026' }) // false
  */

package/dist/runner/media-leftovers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"media-leftovers.d.ts","sourceRoot":"","sources":["../../src/runner/media-leftovers.ts"],"names":[],"mappings":"AAWA,+HAA+H;AAC/H,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA;AAE/H;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAA;AAQjJ;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,EAAE,CAsBjE;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CASjF;AAED;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAEhE;AAuED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKhF"}
+{"version":3,"file":"media-leftovers.d.ts","sourceRoot":"","sources":["../../src/runner/media-leftovers.ts"],"names":[],"mappings":"AAaA;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA;AAE/H;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAA;AAQjJ;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,EAAE,CAsBjE;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAWjF;AAED;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAQhE;AAgFD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKhF"}

package/dist/runner/media-leftovers.js

@@ -5,6 +5,7 @@ import { eventsFile, resultFile } from "../protocol/run-folder.js";
 import { parse } from "../protocol/schema.js";
 import { readMetadataProcessAsync } from "../shared/metadata-process.js";
 import { readProcessTableAsync } from "../shared/process-ownership.js";
+import { heldLaunches } from "../shared/process-system.js";
 import { createArtifactFolder, readArtifactFile, referenceProblem, resolveReference } from "../store/artifacts.js";
 // How many run folders beside this one are read, newest first, and how much of each one's events.
 const maxFolders = 16;
@@ -44,19 +45,22 @@ export function unfinishedRuns(runFolder) {
     });
 }
 /**
- * Whether the process a mark names still runs: true for a confirmed current start, false only when a whole table
- * shows its pid absent; undefined for a present legacy or mismatched start, or an unreadable host. Unknowns stay alone.
+ * Whether the process a mark names still runs: true for a confirmed current start, false only when a whole table, or on
+ * Windows retest-supervisor's reading of the pid, shows it absent; undefined for a present legacy or mismatched start, or
+ * an unreadable host. Unknowns stay alone.
  *
  * @example await processRuns({ pid: 4242, startedAt: 'Mon Oct  6 10:00:01 2026' }) // false
  */
 export async function processRuns(mark) {
     try {
-        const found = (await readProcessTableAsync()).find(entry => entry.pid === mark.pid);
-        if (found === undefined)
+        const launches = heldLaunches();
+        // Windows has no process table to read; retest-supervisor reads the one pid, and answers none when nothing runs under it.
+        const startedAt = launches !== undefined ? await heldStart(launches, mark.pid) : (await readProcessTableAsync()).find(entry => entry.pid === mark.pid)?.startedAt;
+        if (startedAt === undefined)
             return false;
         if (mark.startTimeVersion !== 1)
             return undefined;
-        return mark.startedAt === undefined || mark.startedAt === found.startedAt.replace(/\s+/g, ' ') ? true : undefined;
+        return mark.startedAt === undefined || mark.startedAt === startedAt.replace(/\s+/g, ' ') ? true : undefined;
     }
     catch {
         return undefined;
@@ -67,7 +71,24 @@ export async function processRuns(mark) {
  * Undefined when the host could not be read.
  */
 export async function ownStartTime() {
-    return (await processStartTimes([process.pid]))?.get(process.pid);
+    const launches = heldLaunches();
+    if (launches === undefined)
+        return (await processStartTimes([process.pid]))?.get(process.pid);
+    try {
+        return await heldStart(launches, process.pid);
+    }
+    catch {
+        return undefined;
+    }
+}
+// When the process under `pid` started, as retest-supervisor reads it without holding this thread, or undefined when
+// nothing runs under the pid. Throws when the runner is not held or the reading fails.
+async function heldStart(launches, pid) {
+    launches.prepare();
+    const supervisor = launches.supervisor;
+    if (supervisor === undefined)
+        throw new Error('The runner was not held, so no process could be read.');
+    return (await supervisor.processAsync(pid)).process?.startedAt;
 }
 // One reading for the pids asked; this process is always among those read, so `ps` succeeds when the others are gone.
 async function processStartTimes(pids) {

package/dist/runner/resources.d.ts

@@ -213,6 +213,14 @@ export declare class ResourceLease {
      */
     finish(timeoutMs: number): Promise<void>;
 }
+/**
+ * A part as an event of the attempt records it: a data folder's name with forward slashes on every platform, so a run on
+ * Windows records what a run on macOS records; any other part as it is. It takes the part once its name is redacted, so
+ * a secret is looked for in the name as the platform wrote it.
+ *
+ * @example recordedPart({ kind: 'data-folder', name: 'C:\\work\\.data\\desk', apps: ['desk'] }) // name 'C:/work/.data/desk' on Windows
+ */
+export declare function recordedPart(part: LeasePart): LeasePart;
 /** A need as a part of a lease record. */
 export declare function leasePart(need: ResourceNeed): LeasePart;
 //# sourceMappingURL=resources.d.ts.map

package/dist/runner/resources.d.ts.map

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

package/dist/runner/resources.js

@@ -5,6 +5,7 @@ import { failure } from "../protocol/failures.js";
 import { maxTimeout } from "../protocol/timeouts.js";
 import { variantKey } from "../protocol/variant.js";
 import { listWords } from "../shared/list-words.js";
+import { platformPath, posixPath } from "../shared/posix-path.js";
 import { bounded } from "./bounded.js";
 import { SharedLocks } from "./locks.js";
 import { sessionRefusal } from "./sessions.js";
@@ -109,7 +110,7 @@ export function describeLeasePart(part, variant) {
         case 'device':
             return `the simulator ${part.name}${of}`;
         case 'data-folder':
-            return `the data folder ${part.name}${of}`;
+            return `the data folder ${platformPath(part.name)}${of}`;
         case 'sessions': {
             const count = part.count ?? 1;
             return `${count} ${count === 1 ? 'session' : 'sessions'} of ${part.name}`;
@@ -304,6 +305,16 @@ export class ResourceLease {
             listener(this.#expiry);
     }
 }
+/**
+ * A part as an event of the attempt records it: a data folder's name with forward slashes on every platform, so a run on
+ * Windows records what a run on macOS records; any other part as it is. It takes the part once its name is redacted, so
+ * a secret is looked for in the name as the platform wrote it.
+ *
+ * @example recordedPart({ kind: 'data-folder', name: 'C:\\work\\.data\\desk', apps: ['desk'] }) // name 'C:/work/.data/desk' on Windows
+ */
+export function recordedPart(part) {
+    return part.kind === 'data-folder' ? { ...part, name: posixPath(part.name) } : part;
+}
 /** A need as a part of a lease record. */
 export function leasePart(need) {
     return { kind: need.kind, name: need.name, ...(need.apps.length === 0 ? {} : { apps: [...need.apps] }), ...(need.count === undefined ? {} : { count: need.count }) };

package/dist/runner/run-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-session.d.ts","sourceRoot":"","sources":["../../src/runner/run-session.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAkC,SAAS,EAAc,MAAM,uBAAuB,CAAA;AAGlG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAGxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAiC,MAAM,mBAAmB,CAAA;AACrH,OAAO,KAAK,EAAe,UAAU,EAAyB,MAAM,eAAe,CAAA;AAWnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAgChD,OAAO,KAAK,EAAE,cAAc,EAAqB,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAqCtF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,UAAU,CAAA;IACnB,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAA;IAC9B,MAAM,EAAE,aAAa,CAAA;IACrB,cAAc,EAAE,cAAc,CAAA;IAC9B,KAAK,EAAE,QAAQ,CAAA;IACf,oFAAoF;IACpF,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,wIAAwI;IACxI,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;QAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAA;KAAE,CAAA;IACnF,sHAAsH;IACtH,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,aAAa,CAAC,EAAE,OAAO,gBAAgB,EAAE,aAAa,CAAA;CACvD,CAAA;AAgGD;;;;;;GAMG;AACH,qBAAa,UAAU;;gBAmGT,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,EAAE,iBAAiB;IAkHjI,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC;CA88ChC"}
+{"version":3,"file":"run-session.d.ts","sourceRoot":"","sources":["../../src/runner/run-session.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAkC,SAAS,EAAc,MAAM,uBAAuB,CAAA;AAGlG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAGxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAiC,MAAM,mBAAmB,CAAA;AACrH,OAAO,KAAK,EAAe,UAAU,EAAyB,MAAM,eAAe,CAAA;AAWnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAkChD,OAAO,KAAK,EAAE,cAAc,EAAqB,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAqCtF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,UAAU,CAAA;IACnB,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAA;IAC9B,MAAM,EAAE,aAAa,CAAA;IACrB,cAAc,EAAE,cAAc,CAAA;IAC9B,KAAK,EAAE,QAAQ,CAAA;IACf,oFAAoF;IACpF,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,wIAAwI;IACxI,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;QAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAA;KAAE,CAAA;IACnF,sHAAsH;IACtH,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,aAAa,CAAC,EAAE,OAAO,gBAAgB,EAAE,aAAa,CAAA;CACvD,CAAA;AAgGD;;;;;;GAMG;AACH,qBAAa,UAAU;;gBAmGT,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,EAAE,iBAAiB;IAkHjI,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC;CAg9ChC"}

package/dist/runner/run-session.js

@@ -11,6 +11,7 @@ import { defaultAppPixelRules, PixelCapturePolicy } from "../media/policy.js";
 import { elapsedMs, monotonicClock } from "../protocol/deadline.js";
 import { retestEventSchema } from "../protocol/events.js";
 import { formatSessionId } from "../protocol/evidence.js";
+import { withoutVariables } from "../shared/environment.js";
 import { sha256Hex } from "../shared/sha256.js";
 import { attemptEnding, canonicalJson, withFinalBundle } from "../protocol/execution.js";
 import { errorMessage, failure, withAlso } from "../protocol/failures.js";
@@ -19,6 +20,7 @@ import { appLogFile, browserLogFile, childLogFile, stateFile, targetBrowserLogFi
 import { originOf, withoutCredentials } from "../protocol/url.js";
 import { variantKey } from "../protocol/variant.js";
 import { relativePosixPath } from "../shared/posix-path.js";
+import { runnerStrayProblems } from "../shared/process-system.js";
 import { applyRetention, recordingArtifactReferences, ArtifactSequences, downloadsFolder, inventoryArtifacts, planRetention } from "../store/artifacts.js";
 import { retestVersion } from "../version.js";
 import { AppServers } from "./app-servers.js";
@@ -51,7 +53,7 @@ import { attemptKey, phasesOf, scheduleRun } from "./schedule.js";
 import { AttemptScreenshots, pictureApp, ScreenshotBaselines } from "./screenshot-baselines.js";
 import { SecretFiller, secretValuesProblem, secretVariables } from "./secrets.js";
 import { emptySelectionFailure, selectionProblem, testSelected, variantSelected } from "./selection.js";
-import { acquireResources, hostResources, leasePart, partFree, resourceNeeds, sessionResource } from "./resources.js";
+import { acquireResources, hostResources, leasePart, partFree, recordedPart, resourceNeeds, sessionResource } from "./resources.js";
 import { sessionOptionsProblem } from "./sessions.js";
 import { searchSetups } from "./setup-search.js";
 import { skippedCheckFailures } from "./skipped-checks.js";
@@ -285,7 +287,7 @@ export class RunSession {
             ? new RunMedia({
                 location: startMedia !== undefined && discoverMedia === undefined && options.media !== undefined ? options.media : signal => (discoverMedia ?? discoverMediaLocation)(options.media, process.env, timeouts.setup, signal),
                 start: startMedia ?? startMediaProcess,
-                env: Object.fromEntries(Object.entries(process.env).filter(([name]) => !this.#hiddenVariables.includes(name))),
+                env: withoutVariables(process.env, this.#hiddenVariables),
                 signal: options.signal,
                 emit: (body) => void this.#events.emit(body),
                 timeouts: { start: timeouts.setup, close: timeouts.cleanup, leftovers: timeouts.cleanup },
@@ -702,7 +704,7 @@ export class RunSession {
             return;
         }
         if (stage.kind === 'resources') {
-            const resources = stage.needs.map((need) => ({ ...leasePart(need), name: redact(need.name) }));
+            const resources = stage.needs.map((need) => recordedPart({ ...leasePart(need), name: redact(need.name) }));
             const holders = { ...(stage.heldBy.length === 0 ? {} : { heldBy: [...stage.heldBy] }), ...(stage.heldElsewhere === 0 ? {} : { heldElsewhere: stage.heldElsewhere }) };
             this.#emitFor(described, { type: 'resource.acquired', testId, attemptId, resources, waitedMs: stage.waitedMs, ...holders });
             return;
@@ -721,7 +723,7 @@ export class RunSession {
         const { testId, attemptId } = described;
         this.#emitFor(described, { type: 'lease.taken', testId, attemptId, lease: record });
         lease.onExpired((expiry) => {
-            const parts = (needs) => needs.map((need) => ({ ...leasePart(need), name: redact(need.name) }));
+            const parts = (needs) => needs.map((need) => recordedPart({ ...leasePart(need), name: redact(need.name) }));
             this.#emitFor(described, { type: 'lease.expired', testId, attemptId, lease: record, held: parts(expiry.held), released: parts(expiry.released) });
         });
     }
@@ -1776,6 +1778,9 @@ export class RunSession {
     // reporter failure is part of the event record as well as result.json.
     async #finish(files) {
         await this.#events.flush();
+        // On Windows, what Retest's own job still holds that no launch's job does, by pid and name; empty elsewhere.
+        for (const problem of await runnerStrayProblems())
+            this.#events.reportFailure(failure('cleanup_failed', problem));
         const browsers = this.#browsers.started.map((started) => started.info);
         const evidence = this.#recordsApps ? { evidenceStatus: runEvidence(files.flatMap((file) => file.tests), [], this.#recording.required) } : {};
         const facts = {

package/dist/runner/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/runner/run.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtE,OAAO,KAAK,EAAiB,cAAc,EAAE,aAAa,EAAE,UAAU,EAAa,MAAM,eAAe,CAAA;AAuBxG,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAEtD;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,UAAU,EACnB,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,MAAM,GAAE,aAA6B,EACrC,cAAc,GAAE,cAAqC,GACpD,OAAO,CAAC,SAAS,CAAC,CAOpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAwBlF"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/runner/run.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtE,OAAO,KAAK,EAAiB,cAAc,EAAE,aAAa,EAAE,UAAU,EAAa,MAAM,eAAe,CAAA;AAwBxG,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAEtD;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,UAAU,EACnB,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,MAAM,GAAE,aAA6B,EACrC,cAAc,GAAE,cAAqC,GACpD,OAAO,CAAC,SAAS,CAAC,CAOpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAwBlF"}

package/dist/runner/run.js

@@ -5,6 +5,7 @@ import { judgeVariables } from "../evaluation/judges.js";
 import { withAlso } from "../protocol/failures.js";
 import { variantKey } from "../protocol/variant.js";
 import { relativePosixPath } from "../shared/posix-path.js";
+import { asOneRun } from "../shared/process-system.js";
 import { RunStore } from "../store/run-store.js";
 import { loadTests, missingFileFailure } from "./load-tests.js";
 import { collectedTest, planTests } from "./plan.js";
@@ -29,7 +30,7 @@ export { RunFolderError } from "../store/run-store.js";
 export async function runFiles(options, reporters, launch = launchBrowser, findExecutable = findTargetExecutable) {
     const store = RunStore.create(options.outputDir);
     try {
-        return await new RunSession({ options, reporters, launch, findExecutable, store }).run();
+        return await asOneRun(() => new RunSession({ options, reporters, launch, findExecutable, store }).run());
     }
     finally {
         store.close();

package/dist/runner/target-drivers.d.ts

@@ -35,14 +35,16 @@ export type TargetDriver = WebTargetDriver | {
  * The driver a target needs. Chromium, Chrome and Edge run on Retest's Chromium driver, and an Electron app on the
  * same driver over the app's own debugging pipe. Firefox runs on Retest's Firefox driver over WebDriver BiDi, and WebKit
  * on Retest's WebKit driver over the inspector pipe. An iOS simulator or macOS target is accepted in the config and
- * refused here, naming its app and target, when its driver is not given. No other driver runs it in its place, and no
- * browser stands in for an Electron app.
+ * refused here, naming its app and target, when its driver is not given, and on Windows, where its drivers do not run, by
+ * its key. No other driver runs it in its place, and no browser stands in for an Electron app. `platform` is the host
+ * the target would run on, this machine unless a caller asks as another would.
  *
  * @example targetDriver('web', { name: 'mac', platform: 'macos', appPath: '/Applications/Tasks.app' }).ok // false
  */
 export declare function targetDriver(app: string, target: LoadedTarget): WebTargetDriver;
 export declare function targetDriver(app: string, target: LoadedTarget, options: {
     native: true;
+    platform?: NodeJS.Platform;
 }): TargetDriver;
 /**
  * Why an attempt cannot run, decided before anything starts for it, or undefined when it can: a target with no
@@ -55,5 +57,6 @@ export declare function targetDriver(app: string, target: LoadedTarget, options:
  */
 export declare function attemptRefusal(targets: Variant, apps: ReadonlyMap<string, LoadedApp>, test?: {
     setup?: boolean;
+    platform?: NodeJS.Platform;
 }): Failure | undefined;
 //# sourceMappingURL=target-drivers.d.ts.map

package/dist/runner/target-drivers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"target-drivers.d.ts","sourceRoot":"","sources":["../../src/runner/target-drivers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAC3K,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAErD;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,GAC9D;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,GAC9D;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,GAC5D;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,GAC1D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAA;AAEnC,MAAM,MAAM,YAAY,GAAG,eAAe,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,CAAA;AAUxH;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,eAAe,CAAA;AAChF,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,GAAG,YAAY,CAAA;AASxG;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,GAAG,SAAS,CAoB1I"}
+{"version":3,"file":"target-drivers.d.ts","sourceRoot":"","sources":["../../src/runner/target-drivers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAC3K,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAErD;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,GAC9D;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,GAC9D;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,GAC5D;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,GAC1D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAA;AAEnC,MAAM,MAAM,YAAY,GAAG,eAAe,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,CAAA;AAUxH;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,eAAe,CAAA;AAChF,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAA;CAAE,GAAG,YAAY,CAAA;AAUpI;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAA;CAAO,GAAG,OAAO,GAAG,SAAS,CAoBtK"}

package/dist/runner/target-drivers.js

@@ -6,6 +6,8 @@ const driverNames = {
     macos: 'macOS apps',
 };
 export function targetDriver(app, target, options) {
+    if ('platform' in target && options?.native === true && (options.platform ?? process.platform) === 'win32')
+        return nativeOnWindows(app, target);
     if ('platform' in target)
         return options?.native === true ? { ok: true, driver: target.platform, target } : noDriver(app, target.name, target.platform);
     if (target.browser === 'firefox')
@@ -33,7 +35,7 @@ export function attemptRefusal(targets, apps, test = {}) {
         const target = apps.get(app)?.targets.get(name);
         if (target === undefined)
             continue;
-        const driver = targetDriver(app, target, { native: true });
+        const driver = targetDriver(app, target, { native: true, ...(test.platform === undefined ? {} : { platform: test.platform }) });
         if (!driver.ok)
             return driver.failure;
         if (test.setup === true) {
@@ -68,6 +70,13 @@ function setupRefusal(app, target) {
     const reason = isElectron ? `the Electron app ${app} keeps its own storage. Set userDataDir to keep the app's data from one launch to the next` : `the native app ${app} has no browser storage`;
     return { class: 'unsupported', message: `Not run: a setup saves a sign-in state from its app's browser storage, and ${reason}.`, details: { app, target: target.name } };
 }
+// The macOS and iOS drivers run on a Mac, as WebKit's does: on Windows a native target is refused at its own setup, before
+// anything starts for it, and the rest of the config runs. Its key is named as the config writes it.
+function nativeOnWindows(app, target) {
+    const key = target.name === target.platform ? `apps.${app}` : `apps.${app}.targets.${target.name}`;
+    const kind = target.platform === 'macos' ? 'a macOS app, which Retest runs only on a Mac' : 'an iOS simulator app, which Retest runs only on a Mac with Xcode';
+    return { ok: false, failure: { class: 'setup_failed', message: `${key} is ${kind}.`, details: { app, target: target.name, driver: target.platform } } };
+}
 function noDriver(app, target, driver) {
     const message = `Retest has no driver for ${driverNames[driver]} yet, so it cannot start the target ${target} of the app ${app}.`;
     return { ok: false, failure: { class: 'setup_failed', message, details: { app, target, driver } } };