oxmutate 2.2.0 → 2.3.0

package/dist/cli.js

@@ -62,6 +62,8 @@ function overridesFrom(o, root) {
         overrides.ignoreStatic = true;
     if (typeof o['staticGroup'] === 'number')
         overrides.staticGroup = Math.max(1, Math.floor(o['staticGroup']));
+    if (typeof o['staticBudget'] === 'number' && o['staticBudget'] >= 1)
+        overrides.staticBudgetMs = Math.floor(o['staticBudget']);
     if (o['incremental'] === true)
         overrides.incremental = true;
     if (typeof o['flakyReruns'] === 'number')
@@ -93,6 +95,7 @@ const runCommand = defineCommand({
         strykerCompat: { type: 'boolean', description: 'reproduce Stryker 10.0.0 skips (no mutants inside `as` casts or enums)' },
         ignoreStatic: { type: 'boolean', description: 'skip static mutants (module-level code): faster, and the score leaves them out' },
         staticGroup: { type: 'number', description: 'arm this many static mutants together in a file that is not their first (default 1; a heuristic, audited)' },
+        staticBudget: { type: 'number', description: 'the most the static phase may take, ms; static mutants still undecided then are left out of the score' },
         incremental: { type: 'boolean', description: 'reuse verdicts whose source and covering tests did not change' },
         flakyReruns: { type: 'number', description: 're-runs for verdicts with nondeterministic tests (default 2; 0 disables)' },
         reporter: { type: 'string', description: 'comma-separated: clear-text, json, sarif, html (default clear-text,json)' },

package/dist/config.d.ts

@@ -6,6 +6,8 @@ export interface Thresholds {
     /** Fail the run (exit 1) below this score. `null`: never fail on score. */
     break: number | null;
 }
+/** Why a static mutant is Ignored when `static.budgetMs` ran out before it was decided; the summary counts them by it. */
+export declare const STATIC_BUDGET_REASON = "static mutant (static budget spent)";
 /** Why a static mutant is Ignored under `ignoreStatic`; the summary counts them by it. */
 export declare const IGNORE_STATIC_REASON = "static mutant (ignoreStatic)";
 export interface Options {
@@ -25,6 +27,12 @@ export interface Options {
      * heuristic: two mutants can hide each other, so one in twenty group survivors is run again alone.
      */
     staticGroup: number;
+    /**
+     * The most the static phase may take, in milliseconds (`static.budgetMs`). No new static unit
+     * starts once it is spent; a static mutant still undecided then is Ignored, with a reason, and
+     * left out of the score. A kill found before that stands. Unset: no limit.
+     */
+    staticBudgetMs?: number | undefined;
     strykerCompat: boolean;
     reporters: string[];
     jsonReport: string;

package/dist/config.js

@@ -7,6 +7,11 @@ function staticGroupOf(group) {
     const asked = Math.floor(Number(group));
     return asked >= 2 ? asked : 1;
 }
+function staticBudgetOf(ms) {
+    const asked = Math.floor(Number(ms));
+    return asked >= 1 ? asked : undefined;
+}
+export const STATIC_BUDGET_REASON = 'static mutant (static budget spent)';
 export const IGNORE_STATIC_REASON = 'static mutant (ignoreStatic)';
 const NOT_NEEDED = {
     inPlace: 'oxmutate never copies or rewrites the project; instrumented sources are served from memory',
@@ -105,6 +110,7 @@ export async function loadOptions(root, overrides = {}, configFile) {
         excludedMutations: mutator.excludedMutations ?? [],
         ignoreStatic: raw['ignoreStatic'] === true,
         staticGroup: staticGroupOf(raw['static']?.group),
+        staticBudgetMs: staticBudgetOf(raw['static']?.budgetMs),
         strykerCompat: raw['strykerCompat'] === true,
         reporters: raw['reporters'] ?? ['clear-text', 'json'],
         jsonReport: path.resolve(root, json.fileName ?? 'reports/mutation/mutation.json'),

package/dist/coordinator.js

@@ -5,7 +5,7 @@ import path from 'node:path';
 import { ambientRuntime, run as spawn } from 'bellpull';
 import { checkSurvivors } from './checker.js';
 import { runCommandMutants } from './command-runner.js';
-import { IGNORE_STATIC_REASON, disables } from './config.js';
+import { IGNORE_STATIC_REASON, STATIC_BUDGET_REASON, disables } from './config.js';
 import { rangeDisables } from './directives.js';
 import { guardDisk, isClean } from './diskguard.js';
 import { globToRegExp, matchFiles } from './files.js';
@@ -43,6 +43,7 @@ const verdictOptions = (o) => ({
     excludedMutations: [...o.excludedMutations].sort(),
     ignoreStatic: o.ignoreStatic,
     staticGroup: o.staticGroup,
+    staticBudgetMs: o.staticBudgetMs,
     strykerCompat: o.strykerCompat,
     testOverrides: o.testOverrides,
     vitestConfig: o.vitestConfig && existsSync(o.vitestConfig) ? sha(readFileSync(o.vitestConfig, 'utf8')) : null,
@@ -649,7 +650,11 @@ export async function run(options) {
                             back.add(id);
                 return [];
             };
+            const deadline = options.staticBudgetMs === undefined ? Infinity : performance.now() + options.staticBudgetMs;
+            const spent = () => performance.now() >= deadline;
             const keepUndecided = (unit) => {
+                if (spent())
+                    return false;
                 unit.staticIds = (unit.staticIds ?? []).filter((id) => !killed.has(id) && !back.has(id));
                 if (unit.staticGroups)
                     unit.staticGroups = unit.staticGroups.map((g) => g.filter((id) => !killed.has(id) && !back.has(id))).filter((g) => g.length > 0);
@@ -671,6 +676,10 @@ export async function run(options) {
                     m.status = 'Survived';
                     m.testsCompleted = ran.get(m.id) ?? 0;
                 }
+                else if (spent()) {
+                    m.status = 'Ignored';
+                    m.statusReason = STATIC_BUDGET_REASON;
+                }
                 else
                     undecided.push(m);
             }

package/dist/reports.js

@@ -1,7 +1,7 @@
 import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import path from 'node:path';
-import { IGNORE_STATIC_REASON } from './config.js';
+import { IGNORE_STATIC_REASON, STATIC_BUDGET_REASON } from './config.js';
 export const VERSION = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version;
 const REPLACEMENT_WIDTH = 60;
 const ELLIPSIS = '...';
@@ -128,6 +128,9 @@ function staticLine(r) {
     if (ignored > 0)
         return [`  static mutants: ${String(ignored)} ignored (ignoreStatic), not scored`];
     const share = r.stats.wallMs > 0 ? r.stats.staticMs / r.stats.wallMs : 0;
+    const unspent = statics.filter((m) => m.statusReason === STATIC_BUDGET_REASON).length;
+    if (unspent > 0)
+        return [`  static mutants: ${String(statics.length - unspent)} decided in ${(r.stats.staticMs / MS_PER_S).toFixed(1)} s, ${String(unspent)} left undecided when the static budget ran out, not scored`];
     const hint = share >= STATIC_SHARE_WORTH_SAYING ? '; --ignore-static skips them, and the score then leaves them out' : '';
     return [`  static mutants: ${String(statics.length)} decided in ${(r.stats.staticMs / MS_PER_S).toFixed(1)} s, ${(share * PERCENT).toFixed(0)}% of the run${hint}`];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oxmutate",
-  "version": "2.2.0",
+  "version": "2.3.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",
   "author": "Ofri Peretz <ofriperetzdev@gmail.com>",