@a11ign/screenreader-fleet 0.2.0 → 0.4.0

package/dist/guest-run.mjs

@@ -1,164 +0,0 @@
-// @ts-check
-// Run a script on a guest, elevated, and get its output back.
-//
-//   node packages/worker-fleet/src/guest-run.mjs <vm-name> <local-script.cmd> [--timeout=600]
-//
-// This exists because there was no reliable way to do it, and the workarounds each failed differently:
-//
-//   utmctl exec        runs as NT AUTHORITY\SYSTEM -- fully elevated -- but returns NO OUTPUT and exit
-//                      code 0 whether or not the command ran. Fine for firing something, useless for
-//                      knowing what happened.
-//   the worker's HTTP  unelevated. The worker task is RunLevel Limited on purpose (NVDA does not need
-//                      elevation), so DISM, sc.exe and Defender's registry keys are all closed to it.
-//   Register-ScheduledTask from the worker  "Access is denied" -- registering an elevated task itself
-//                      needs elevation.
-//   ssh / WinRM / RDP  not installed; ports 22, 5985, 5986, 3389 and 445 are all closed.
-//
-// The combination that works: `utmctl exec` (SYSTEM) registers a scheduled task at RunLevel HIGHEST,
-// starts it, and the task writes its output to a file we pull back. Elevation from the exec channel,
-// results through the file channel, neither depending on the other.
-//
-// TWO TRAPS, both of which produced wrong answers today and are handled here:
-//
-//   1. `utmctl exec ... -- a b c` passes a, b and c as SEPARATE argv entries. A cmd line containing
-//      parentheses, `&` or quotes gets split across them and cmd receives fragments. A `reg query`
-//      written that way reported "key not found" for a key that certainly existed, and nearly led to
-//      the conclusion that a real configuration drift was a false alarm. The command is passed as ONE
-//      argument here, always.
-//   2. A detached child dies with the exec that spawned it. `start /b` looked like it worked -- exit 0,
-//      no output -- and the child never ran. A scheduled task survives because the Task Scheduler
-//      service owns it.
-import { execFile } from "node:child_process";
-import { createReadStream, readFileSync, existsSync } from "node:fs";
-import { pathToFileURL } from "node:url";
-import { basename, resolve } from "node:path";
-import { promisify } from "node:util";
-import { refuseUnknownFlags } from "./cli-flags.mjs";
-import { warnUtmDeprecated } from "./utm-deprecated.mjs";
-/**
- * takes a VM name and a script POSITIONALLY, which this guard does not touch, plus `--timeout=`;
- * a mistyped timeout silently falls back to 600s on an operation that may legitimately need longer.
- *
- * An unrecognised flag is otherwise IGNORED, so it runs the default and reports success.
- */
-refuseUnknownFlags(["--timeout="], { entry: import.meta.url, command: "npm run guest:run" });
-const run = promisify(execFile);
-const UTMCTL = "/Applications/UTM.app/Contents/MacOS/utmctl";
-const GUEST_DIR = "C:\\Users\\witness\\a11y-witness";
-const TASK_NAME = "a11yguestrun";
-/** Written by the wrapper as its last act. Absent means still running, or it died. */
-export const DONE_SENTINEL = "---GUEST-RUN-DONE---";
-const POLL_MS = 5_000;
-/**
- * The cmd line that registers and starts the elevated task.
- *
- * Built as a single string on purpose -- see trap 1 above. Exported so the quoting is testable without
- * a guest, because it is the part that silently produces wrong answers rather than errors.
- */
-/** @param {{ scriptPath: string, taskName?: string }} where */
-export function scheduleCommand({ scriptPath, taskName = TASK_NAME }) {
-    return `schtasks /create /tn ${taskName} /tr "${scriptPath}" /sc once /st 00:00 ` +
-        `/ru SYSTEM /rl HIGHEST /f >nul 2>&1 & schtasks /run /tn ${taskName} >nul 2>&1`;
-}
-/**
- * Wrap a caller's script so it always terminates with the sentinel.
- *
- * Without this there is no way to distinguish "still running" from "died on line one" -- which is
- * exactly how a trim that crashed immediately looked identical to a trim in progress, for three boots.
- */
-/** @param {string} body @param {string} outputFile */
-export function wrapScript(body, outputFile) {
-    const lines = [
-        "@echo off",
-        `cd /d ${GUEST_DIR}`,
-        `set OUT=${outputFile}`,
-        `> ${outputFile} echo === guest-run ===`,
-        ...body.split(/\r?\n/).filter((/** @type {string} */ l) => !/^@echo off\s*$/i.test(l)).map((/** @type {string} */ l) => l.trimEnd()),
-        `>> ${outputFile} echo ${DONE_SENTINEL}`,
-    ];
-    return lines.join("\r\n") + "\r\n";
-}
-/** Did the run finish? Exported because "no sentinel" and "no file" are different failures. */
-/** @param {string} output */
-/** @param {string | null} output */
-export function isComplete(output) {
-    return typeof output === "string" && output.includes(DONE_SENTINEL);
-}
-/** @param {string} vmName */
-async function uuidFor(vmName) {
-    const { stdout } = await run(UTMCTL, ["list"]);
-    const line = stdout.split("\n").find((l) => l.trim().endsWith(` ${vmName}`) || l.trim().endsWith(`\t${vmName}`));
-    const uuid = line?.trim().split(/\s+/)[0];
-    if (!uuid)
-        throw new Error(`no VM named '${vmName}'`);
-    return uuid;
-}
-/** @param {string} uuid @param {string} guestPath @param {string} localPath @returns {Promise<void>} */
-function push(uuid, guestPath, localPath) {
-    return new Promise((done, fail) => {
-        const child = execFile(UTMCTL, ["file", "push", uuid, guestPath], (error) => error ? fail(new Error(`push failed: ${ /** @type {Error} */(error).message}`)) : done());
-        if (child.stdin)
-            createReadStream(localPath).pipe(child.stdin);
-    });
-}
-/** @param {string} uuid @param {string} guestPath */
-async function pull(uuid, guestPath) {
-    try {
-        const { stdout } = await run(UTMCTL, ["file", "pull", uuid, guestPath], { maxBuffer: 1 << 24 });
-        return stdout;
-    }
-    catch {
-        return null; // not written yet
-    }
-}
-async function main() {
-    warnUtmDeprecated("node packages/worker-fleet/src/guest-run.mjs");
-    const args = process.argv.slice(2);
-    const [vmName, scriptFile] = args.filter((a) => !a.startsWith("--"));
-    const timeoutS = Number(args.find((a) => a.startsWith("--timeout="))?.split("=")[1] ?? 600);
-    if (!vmName || !scriptFile) {
-        process.stderr.write("usage: node packages/worker-fleet/src/guest-run.mjs <vm-name> <script.cmd> [--timeout=600]\n");
-        process.exit(2);
-    }
-    const local = resolve(scriptFile);
-    if (!existsSync(local))
-        throw new Error(`no such script: ${local}`);
-    const name = basename(scriptFile).replace(/\.[^.]+$/, "");
-    const guestScript = `${GUEST_DIR}\\${name}.cmd`;
-    const guestOutput = `${GUEST_DIR}\\.${name}.out`;
-    const wrapped = resolve(process.env.TMPDIR ?? "/tmp", `${name}.wrapped.cmd`);
-    const { writeFileSync } = await import("node:fs");
-    writeFileSync(wrapped, wrapScript(readFileSync(local, "utf8"), guestOutput), "utf8");
-    const uuid = await uuidFor(vmName);
-    process.stdout.write(`==> ${vmName} (${uuid})\n`);
-    await push(uuid, guestScript, wrapped);
-    process.stdout.write(`    pushed ${name}.cmd\n`);
-    // One argument. See trap 1.
-    await run(UTMCTL, ["exec", uuid, "--cmd", "cmd.exe", "--", "/c",
-        scheduleCommand({ scriptPath: guestScript })]);
-    process.stdout.write("    running as SYSTEM at RunLevel HIGHEST\n");
-    const deadline = Date.now() + timeoutS * 1000;
-    while (Date.now() < deadline) {
-        await new Promise((r) => setTimeout(r, POLL_MS));
-        const output = await pull(uuid, guestOutput);
-        if (isComplete(output)) {
-            process.stdout.write((output ?? "").replace(DONE_SENTINEL, "").trimEnd() + "\n");
-            process.stdout.write("    done\n");
-            return;
-        }
-    }
-    throw new Error(`no ${DONE_SENTINEL} within ${timeoutS}s — the script may still be running; ` +
-        `pull ${guestOutput} to see how far it got`);
-}
-// `import.meta.url === pathToFileURL(process.argv[1])`, not `endsWith("guest-run.mjs")`. The old form
-// worked but matched on a SUFFIX, so any entry point whose path happened to end that way -- a
-// `my-guest-run.mjs`, a copy under another directory -- would have run this file's main instead of its own.
-// Every other entry point in this repo now uses the exact comparison; one idiom, so there is one thing to
-// get right.
-if (import.meta.url === pathToFileURL(process.argv[1] ?? "").href) {
-    main().catch((error) => {
-        process.stderr.write(`guest-run failed: ${error.message}\n`);
-        process.exit(1);
-    });
-}
-//# sourceMappingURL=guest-run.mjs.map

package/dist/guest-run.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"guest-run.mjs","sourceRoot":"","sources":["../src/guest-run.mjs"],"names":[],"mappings":"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"}

package/dist/host-address.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"host-address.d.mts","sourceRoot":"","sources":["../src/host-address.mjs"],"names":[],"mappings":"AAiCA,kGAAkG;AAClG,yBAAyB;AACzB,8BADY,MAAM,iBAKjB;AAED;;;;;;;;GAQG;AACH,wCAHW,MAAM,GACJ,MAAM,GAAG,SAAS,CAiB9B;AAED;;;;;GAKG;AACH,gDAHW,MAAM,GACJ,MAAM,GAAG,SAAS,CAS9B;AAED;;;;;;;;;;GAUG;AACH,yCAJW,MAAM,SACN,MAAM,GAAG,MAAM,GACb,MAAM,CAWlB"}

package/dist/host-address.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"host-address.mjs","sourceRoot":"","sources":["../src/host-address.mjs"],"names":[],"mappings":"AAAA,YAAY;AACZ;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5C,MAAM,WAAW,GAAG,CAAC,CAAC;AAEtB,kGAAkG;AAClG,yBAAyB;AACzB,MAAM,UAAU,SAAS,CAAC,EAAE;IAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7G,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,OAAO;IACpC,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACrC,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC,EAAE,CAAC;QAC3D,KAAK,MAAM,CAAC,IAAI,SAAS,IAAI,EAAE,EAAE,CAAC;YAChC,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,QAAQ;gBAAE,SAAS;YAChD,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAClC,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAClC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI;gBAAE,SAAS;YAC7C,yFAAyF;YACzF,oBAAoB;YACpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;gBAAE,OAAO,CAAC,CAAC,OAAO,CAAC;QACzD,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAS;IAC5C,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;QACxC,OAAO,SAAS,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC7E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,SAAS,EAAE,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,IAAI;IACpF,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACzF,MAAM,OAAO,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,oDAAoD,SAAS,0CAA0C;cACrG,6EAA6E,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,UAAU,OAAO,IAAI,IAAI,EAAE,CAAC;AACrC,CAAC"}

package/dist/host-capacity.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"host-capacity.d.mts","sourceRoot":"","sources":["../src/host-capacity.mjs"],"names":[],"mappings":"AAkEA;;;;;;;;;;GAUG;AACH,uDAcC;AAED,mGAAmG;AACnG,4CAEC;AAED;;;;;;;;;;GAUG;AACH,6DAFa,MAAM,CAIlB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,4EAHW;IAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACtE,MAAM,CAOlB;AAED;;;;;GAKG;AACH,+DAHW;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC3D,MAAM,GAAG,IAAI,CASzB"}

package/dist/host-capacity.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"host-capacity.mjs","sourceRoot":"","sources":["../src/host-capacity.mjs"],"names":[],"mappings":"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"}

package/dist/host-metrics.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"host-metrics.d.mts","sourceRoot":"","sources":["../src/host-metrics.mjs"],"names":[],"mappings":"AAmDA;;;;;;;GAOG;AACH,oCAFW,MAAM;;;;;;;;SAkBhB;AAED;;;;;;;;GAQG;AACH,oCAHW,MAAM,GACJ,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAC,CAAC,CAiB3G;AAED;;;GAGG;AACH,yCAFW,MAAM;;;;SAKhB;AAED;;;;;;GAMG;AACH,6CAHW,MAAM,SACN,MAAM;;;;IAWhB;AAUD;;;;;;;;GAQG;AACH,8CAFW;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;gBA7DR,MAAM;uBAAiB,MAAM;4BAAsB,MAAM;qBAAe,MAAM;;;;;;;;;;;;EAwEzG;AA2BD;;;GAGG;AACH,iCAHW,YAAY,SACZ,YAAY;;;;;;;EAmBtB;;;;;;2BApCY;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,SAAS,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE"}

package/dist/host-metrics.mjs

@@ -1,201 +0,0 @@
-// @ts-check
-/**
- * What the HOST was doing while a measurement ran: CPU, disk, memory.
- *
- * ## Why this exists
- *
- * Every performance conclusion in this project has been drawn from wall-clock time and phase marks,
- * and the causes were misattributed three times in one day — first to memory, then to the guests
- * themselves, then to contention in the abstract. The actual bottleneck was **disk I/O from Chromium
- * cold-starting on three guests at once**, and it was invisible because nothing ever measured it.
- *
- * A timing number without the foundations underneath it does not identify a cause; it only says
- * something got slower. These are the four things that were being guessed at:
- *
- *   CPU     load average and the guests' own share. Ruled contention in or out.
- *   DISK    transfers/s and MB/s. The one that mattered, and the one never sampled.
- *   MEMORY  RESIDENT bytes, not `phys_footprint`.
- *   PAGING  pageouts and compressor size — the difference between "tight" and "thrashing".
- *
- * ## phys_footprint is a charge, not occupancy — this is the mistake it caused
- *
- * `MEMORY_PER_WORKER_MB` was set three times (7,600 then 8,100 then 5,600) from `top`'s memory column,
- * which on macOS is `phys_footprint`: it counts compressed and swapped-out pages as though they were
- * resident. Three guests showing 5.8 GB each — 17.4 GB "used" — held **3.8 GB of actual RAM** between
- * them, with 7.8 GB sitting in the compressor. The capacity model reserved roughly four times what a
- * worker occupies and concluded the Mac could only run two. Resident size is reported here for exactly
- * that reason.
- *
- * **FOOTPRINT IS NOT REPORTED, and this header claimed it was.** The sentence used to end "footprint is
- * reported alongside it so the gap between them stays visible", and `parseProcessMemory`'s own docstring
- * promised "Resident size AND footprint per process". Neither is true: the source is
- * `ps -o pid=,rss=,comm=`, which has no footprint column, and the returned records carry only `residentMb`.
- * A documented remedy that was never implemented, vouched for by two comments.
- *
- * That matters because RSS is the reading that lies in the one state worth detecting: a starved guest
- * showed `rss=0.4 GB` while its `phys_footprint` was 8.1 GB, its pages being in swap. So `residentMbTotal`
- * FALLS as a host gets sicker — the same self-defeating shape as reading `vm_stat` for available memory.
- *
- * Do not read it alone. `compressorMb` and the pageout DELTA come from `vm_stat` in the same snapshot and
- * are not distorted that way: low resident WITH a large compressor is a host absorbing pressure, and a
- * non-zero pageout delta is one that is swapping. `compare-workers.mjs` prints all three together and
- * labels the RSS column "<- RSS, not phys_footprint", which is why the missing field never misled anyone.
- *
- * Adding footprint means `top -l 1 -o mem -stats mem`, which costs a second and a fragile parse; the
- * pairing above answers the same question from a snapshot already being taken. Recorded rather than done,
- * so the next reader is not told a field exists that does not.
- */
-import { execFileSync } from "node:child_process";
-const BYTES_PER_MB = 1024 * 1024;
-/**
- * Parse `vm_stat`. Pure — the arithmetic is where this goes wrong, not the shelling out.
- *
- * The page size is read from the output rather than assumed: it is 16 KB on Apple Silicon and 4 KB on
- * Intel, and hardcoding 4096 would understate every figure on this machine by a factor of four.
- *
- * @param {string} output
- */
-export function parseVmStat(output) {
-    const pageSize = Number(/page size of (\d+) bytes/.exec(output)?.[1]);
-    if (!Number.isFinite(pageSize))
-        return null;
-    const pages = (/** @type {string} */ label) => Number(new RegExp(`${label}:\\s+(\\d+)`).exec(output)?.[1] ?? 0);
-    const mb = (/** @type {string} */ label) => Math.round((pages(label) * pageSize) / BYTES_PER_MB);
-    return {
-        freeMb: mb("Pages free"),
-        activeMb: mb("Pages active"),
-        inactiveMb: mb("Pages inactive"),
-        wiredMb: mb("Pages wired down"),
-        // Compressed pages live in RAM. A large compressor with low `free` is a host absorbing pressure,
-        // which is a different state from one that is swapping, and they need different responses.
-        compressorMb: mb("Pages occupied by compressor"),
-        pageins: pages("Pageins"),
-        pageouts: pages("Pageouts"),
-    };
-}
-/**
- * Parse `iostat -d -c 2` — the disk columns for each device.
- *
- * The FIRST sample from iostat is an average since boot and is meaningless for a measurement window;
- * callers must use the second. Getting that wrong reports a busy disk as idle and vice versa.
- *
- * @param {string} output
- * @returns {Array<{device: string, kbPerTransfer: number, transfersPerSecond: number, mbPerSecond: number}>}
- */
-export function parseIostat(output) {
-    const lines = String(output).trim().split(/\r?\n/);
-    const header = lines.findIndex((l) => /^\s*disk/.test(l));
-    if (header === -1)
-        return [];
-    const devices = lines[header].trim().split(/\s+/);
-    const samples = lines.slice(header + 2).filter((l) => /\d/.test(l));
-    const last = samples.at(-1);
-    if (!last)
-        return [];
-    const numbers = last.trim().split(/\s+/).map(Number);
-    return devices.map((device, i) => ({
-        device,
-        kbPerTransfer: numbers[i * 3] ?? 0,
-        transfersPerSecond: numbers[i * 3 + 1] ?? 0,
-        mbPerSecond: numbers[i * 3 + 2] ?? 0,
-    })).filter((d) => Number.isFinite(d.mbPerSecond));
-}
-/**
- * Load averages, or null.
- * @param {string} output
- */
-export function parseLoadAverage(output) {
-    const m = /([\d.]+)\s+([\d.]+)\s+([\d.]+)/.exec(String(output));
-    return m ? { one: Number(m[1]), five: Number(m[2]), fifteen: Number(m[3]) } : null;
-}
-/**
- * RESIDENT size per process. Not footprint — `ps` has no such column; see this module's header for why
- * that is a deliberate limit rather than an oversight, and what to read beside it.
- *
- * @param {string} psOutput output of `ps -o pid=,rss=,comm=`
- * @param {string} match substring of the command to keep
- */
-export function parseProcessMemory(psOutput, match) {
-    // `flatMap` rather than map -> filter -> map. The old shape checked `m &&` and was correct at runtime,
-    // but a filter cannot narrow a type for the two lines after it, so every field access read as a
-    // possible null. Doing the match and the decision in one place needs no narrowing to explain.
-    return String(psOutput).trim().split(/\r?\n/).flatMap((line) => {
-        const fields = line.trim().match(/^(\d+)\s+(\d+)\s+(.*)$/);
-        if (!fields || !fields[3].includes(match))
-            return [];
-        return [{ pid: Number(fields[1]), residentMb: Math.round(Number(fields[2]) / 1024), command: fields[3] }];
-    });
-}
-const run = (/** @type {string} */ cmd, /** @type {string[]} */ args) => {
-    try {
-        return execFileSync(cmd, args, { encoding: "utf8", timeout: 15_000 });
-    }
-    catch {
-        return ""; // a missing tool must never break a measurement; the field just reads null
-    }
-};
-/**
- * One snapshot of the foundations.
- *
- * `iostat -c 2 -w 1` deliberately takes two samples a second apart and uses the second, because the
- * first is a since-boot average. That makes this call cost ~1 s, which is why it is a snapshot taken
- * around a measurement rather than something polled continuously.
- *
- * @param {{ processMatch?: string }} options
- */
-export function sampleHost({ processMatch = "QEMU" } = {}) {
-    const memory = parseVmStat(run("vm_stat", []));
-    return {
-        at: new Date().toISOString(),
-        memory,
-        disk: parseIostat(run("iostat", ["-d", "-c", "2", "-w", "1"])),
-        load: parseLoadAverage(run("sysctl", ["-n", "vm.loadavg"])),
-        processes: parseProcessMemory(run("ps", ["-Ao", "pid=,rss=,comm="]), processMatch),
-    };
-}
-/**
- * What changed between two snapshots.
- *
- * Paging is reported as a DELTA because the absolute counters are since-boot and therefore enormous
- * and useless: 6.6 GB of swap left over from an incident hours ago looks identical to a host swapping
- * right now. Only the delta distinguishes them, and that distinction was worth an afternoon.
- */
-// Every `?.` and `??` is a branch, so six inlined reads of a possibly-absent snapshot pushed diffHost
-// to a complexity of 21 against a limit of 15 -- without being any clearer than naming the read once.
-/**
- * @typedef {{ memory?: Record<string, number>, processes?: { residentMb: number }[] }} HostSnapshot
- *
- * Named because the first attempt at annotating this called it `Record<string, number>` -- flat numbers,
- * which is what the CALL SITES read out of it and not what it is. A shape guessed from its uses is the
- * same defect as a type inferred from its defaults, one file over.
- */
-/**
- * @param {HostSnapshot} snapshot
- * @param {string} field
- * @param {number | null} fallback
- * @returns {number | null}
- */
-const reading = (snapshot, field, fallback) => snapshot?.memory?.[field] ?? fallback;
-/**
- * @param {HostSnapshot} before
- * @param {HostSnapshot} after
- */
-export function diffHost(before, after) {
-    // `?? 0` at the call, so these two stay plain numbers: a delta of two absent readings is 0, which is
-    // what "the host did not swap" has always meant here. `compressorMb` and `freeMb` below keep null,
-    // because an ABSENT reading and a reading of zero are different facts about the host and this file's
-    // whole purpose is that a number carries what it was computed from.
-    const pageouts = (reading(after, "pageouts", 0) ?? 0) - (reading(before, "pageouts", 0) ?? 0);
-    const pageins = (reading(after, "pageins", 0) ?? 0) - (reading(before, "pageins", 0) ?? 0);
-    return {
-        pageoutsDelta: pageouts,
-        pageinsDelta: pageins,
-        // The honest headline. Non-zero pageouts during a measurement means the host was swapping and the
-        // timing describes a constrained machine, not the software under test.
-        swappingDuringRun: pageouts > 0,
-        compressorMb: reading(after, "compressorMb", null),
-        freeMb: reading(after, "freeMb", null),
-        residentMbTotal: (after?.processes ?? []).reduce((sum, p) => sum + p.residentMb, 0),
-    };
-}
-//# sourceMappingURL=host-metrics.mjs.map

package/dist/host-metrics.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"host-metrics.mjs","sourceRoot":"","sources":["../src/host-metrics.mjs"],"names":[],"mappings":"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"}

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EACL,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,oBAAoB,EAAE,iBAAiB,GAClG,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAItE;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEzD"}

package/dist/index.js

@@ -1,25 +0,0 @@
-/**
- * Host-side worker fleet: lease a Windows capture worker, judge its health, and know how many the host can
- * actually afford to run.
- *
- * None of this touches guidepup or NVDA — it runs on the machine that *drives* the workers, which is why it is
- * a separate package from `@a11ign/screenreader-worker` (ADR 0004). The split is not cosmetic: the worker is
- * Windows-only and the fleet is not.
- *
- * The measurement internals — `host-metrics`, `worker-stats`, `fleet-consistency` — are deliberately NOT
- * exported. Their shapes change every time something new gets measured, and this project's own history is a
- * record of that happening.
- */
-export { DEFAULT_WORKER, isAfterRun, leaseWorker, leaseWorkerPool, hostAddressForWorker, guestReachableUrl, } from "./local-vm.js";
-import { fleetScriptPaths as scriptPaths } from "./fleet-scripts.mjs";
-/**
- * The provisioning and lifecycle scripts, as absolute paths.
- *
- * They are shell and PowerShell, not JavaScript, so a consumer has to spawn them — and they can only be found
- * relative to the module. Delegated to `fleet-scripts.mjs` so this package has exactly ONE definition of where
- * they live: it had four, and one of them was wrong, which broke `leaseWorker` silently.
- */
-export function fleetScriptPaths() {
-    return scriptPaths();
-}
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EACL,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,oBAAoB,EAAE,iBAAiB,GAClG,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,gBAAgB,IAAI,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEtE;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,WAAW,EAAE,CAAC;AACvB,CAAC"}

package/dist/local-vm.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"local-vm.d.ts","sourceRoot":"","sources":["../src/local-vm.ts"],"names":[],"mappings":"AA0BA,oEAAoE;AACpE,eAAO,MAAM,cAAc,0BAA0B,CAAC;AAWtD,oDAAoD;AACpD,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAI9D,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,QAAQ,CAEnD;AAED,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,kEAAkE;IAClE,IAAI,EAAE,OAAO,CAAC;CACf;AAED,qFAAqF;AACrF,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,MAAM,EAAE,UAAU,GAAG,eAAe,GAAG,UAAU,GAAG,SAAS,CAAC;IAC9D;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAuCD;;;;GAIG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAY5D;AAuBD;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,CA2B5F;AAED,UAAU,YAAY;IACpB,kFAAkF;IAClF,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAsB,WAAW,CAC/B,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,YAAY,EAC/B,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,MAAM,EAAE,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAA;CAAO,GACtF,OAAO,CAAC,WAAW,CAAC,CAqBtB;AAED;;;;;;;;GAQG;AACH;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO1E;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,CAc7E;AAED,yFAAyF;AACzF,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAuCD;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CA8DhF"}