oxmutate 1.0.3 → 1.2.0

package/dist/scheduler.js

@@ -12,6 +12,8 @@ import { fork } from 'node:child_process';
 import { readFileSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { beatFile, classifyStall, CPU_WINDOW_MS, cpuShare, readBeat } from './heartbeat.js';
+import { env, stderr } from './runtime.js';
 const childJs = fileURLToPath(new URL('./child.js', import.meta.url));
 /** The tail of a server's stderr kept for an error message. */
 const STDERR_TAIL = 4000;
@@ -28,15 +30,23 @@ function inFlight(progress) {
         return undefined;
     }
 }
+const PERCENT = 100;
+/** How many CPU samples a server keeps: a little over the window. */
+const CPU_SAMPLES_KEPT = 8;
 class Server {
     child;
     ready;
     stderr = '';
+    /** Where this server's test workers beat (heartbeat.ts). */
+    beat;
+    /** The server's latest CPU readings, oldest first (child.ts sends them). */
+    cpu = [];
     onMessage;
     onExit;
     exited = false;
-    constructor(configFile, cwd, execArgv) {
+    constructor(configFile, cwd, execArgv, workDir) {
         this.child = fork(childJs, [configFile], { cwd, stdio: ['ignore', 'ignore', 'pipe', 'ipc'], execArgv });
+        this.beat = beatFile(workDir, this.child.pid);
         this.child.stderr?.on('data', (d) => (this.stderr = (this.stderr + d.toString()).slice(-STDERR_TAIL)));
         this.ready = new Promise((resolve) => {
             const first = (m) => {
@@ -48,7 +58,15 @@ class Server {
             this.child.on('message', first);
             this.child.once('exit', () => resolve(false));
         });
-        this.child.on('message', (m) => this.onMessage?.(m));
+        this.child.on('message', (m) => {
+            if (m.type === 'cpu') {
+                this.cpu.push({ at: m.at ?? 0, us: m.us ?? 0 });
+                if (this.cpu.length > CPU_SAMPLES_KEPT)
+                    this.cpu.shift();
+                return;
+            }
+            this.onMessage?.(m);
+        });
         this.child.once('exit', (code) => {
             this.exited = true;
             this.onExit?.(code);
@@ -78,9 +96,18 @@ class Server {
                 if (!line)
                     return;
                 const [id = '', since = '0'] = line.split(' ');
-                if (Date.now() - Number(since) > budget(id)) {
+                const now = Date.now();
+                if (now - Number(since) > budget(id)) {
+                    // Read before the kill: an idle stop is a Timeout as it stands, a busy one is re-run (heartbeat.ts).
+                    const beat = readBeat(this.beat, now);
+                    const share = cpuShare(this.cpu, now);
+                    const stall = classifyStall({ beat, cpuShare: share });
+                    if (env['OXMUTATE_DEBUG_WATCHDOG']) {
+                        const cpu = share === undefined ? '?' : `${String(Math.round(share * PERCENT))}%`;
+                        stderr.write(`oxmutate watchdog: stop ${id} after ${String(now - Number(since))} ms; ${stall}; beat ${Number.isFinite(beat.age) ? `${String(beat.age)} ms ago` : 'never'}${beat.inTest ? ' in a test' : ''}; cpu ${cpu} over ${String(CPU_WINDOW_MS)} ms\n`);
+                    }
                     this.child.kill('SIGKILL');
-                    finish({ killedFor: id, stderr: this.stderr });
+                    finish({ killedFor: id, stall, stderr: this.stderr });
                 }
             }, WATCHDOG_POLL_MS);
             this.onMessage = (m) => {
@@ -104,13 +131,21 @@ class Server {
 export function createPool(config, size, workDir, tag) {
     const configFile = path.join(workDir, `server-${tag}.json`);
     writeFileSync(configFile, JSON.stringify(config));
-    const stats = { spawned: 0, killed: 0, crashed: 0 };
+    const stats = { spawned: 0, killed: 0, idle: 0, crashed: 0 };
     const spawn = () => {
         stats.spawned++;
-        return new Server(configFile, config.root, config.nodeArgs ?? []);
+        return new Server(configFile, config.root, config.nodeArgs ?? [], workDir);
     };
     const servers = Array.from({ length: size }, spawn);
     let spare = spawn();
+    const tally = (outcome) => {
+        if (outcome.killedFor)
+            stats.killed++;
+        if (outcome.stall === 'idle')
+            stats.idle++;
+        if (outcome.crashed)
+            stats.crashed++;
+    };
     const replacement = () => {
         const next = spare ?? spawn();
         spare = spawn();
@@ -118,7 +153,7 @@ export function createPool(config, size, workDir, tag) {
     };
     return {
         stats,
-        async drain(units, budget, after) {
+        async drain(units, budget, after, prepare) {
             const queue = [...units];
             let busy = 0;
             const waiters = [];
@@ -126,9 +161,16 @@ export function createPool(config, size, workDir, tag) {
                 for (const w of waiters.splice(0))
                     w();
             };
+            /** The next unit `prepare` keeps, or undefined when the queue is empty. */
+            const take = () => {
+                for (let unit = queue.shift(); unit; unit = queue.shift())
+                    if (!prepare || prepare(unit))
+                        return unit;
+                return undefined;
+            };
             await Promise.all(servers.map(async (_, slot) => {
                 for (;;) {
-                    const unit = queue.shift();
+                    const unit = take();
                     if (!unit) {
                         if (busy === 0) {
                             signal();
@@ -145,10 +187,7 @@ export function createPool(config, size, workDir, tag) {
                         await server.ready;
                     }
                     const outcome = await server.run(unit, (id) => budget(unit, id));
-                    if (outcome.killedFor)
-                        stats.killed++;
-                    if (outcome.crashed)
-                        stats.crashed++;
+                    tally(outcome);
                     if (outcome.killedFor || outcome.crashed) {
                         servers[slot] = replacement();
                     }

package/dist/spec-oracle.js

@@ -45,6 +45,7 @@ const share = (n, of) => (of ? (PERCENT * n) / of : 0);
 const located = ({ id, file, line, mutatorName, replacement }) => ({ id, file, line, mutatorName, replacement });
 const median = (xs) => {
     const sorted = [...xs].sort((a, b) => a - b);
+    // Stryker disable next-line NumericLiteral: guarded by `sorted.length`, so the fallback never runs
     return sorted.length ? (sorted[Math.floor(sorted.length / 2)] ?? 0) : 0;
 };
 const testsMiss = (m) => m.status === 'Survived' || m.status === 'NoCoverage';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oxmutate",
-  "version": "1.0.3",
+  "version": "1.2.0",
   "description": "Mutation testing for JavaScript and TypeScript on the oxc engine, run warm inside the project's own Vitest, with CI lanes, SARIF and an agent surface. No dependency outside the burgee family. A Stryker migration path.",
   "license": "MIT",
   "repository": {