oxmutate 2.0.1 → 2.1.0

package/dist/cli.js

@@ -58,6 +58,8 @@ function overridesFrom(o, root) {
         overrides.timeoutMS = o['mutantTimeout'];
     if (o['strykerCompat'] === true)
         overrides.strykerCompat = true;
+    if (o['ignoreStatic'] === true)
+        overrides.ignoreStatic = true;
     if (o['incremental'] === true)
         overrides.incremental = true;
     if (typeof o['flakyReruns'] === 'number')
@@ -87,6 +89,7 @@ const runCommand = defineCommand({
         concurrency: { type: 'number', description: 'worker processes (default: cores - 1, at most 8)' },
         mutantTimeout: { type: 'number', description: 'absolute slack per mutant, ms (default 500; Stryker 5000)' },
         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' },
         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 under `ignoreStatic`; the summary counts them by it. */
+export declare const IGNORE_STATIC_REASON = "static mutant (ignoreStatic)";
 export interface Options {
     root: string;
     mutate: string[];

package/dist/config.js

@@ -3,6 +3,7 @@ import { availableParallelism } from 'node:os';
 import path from 'node:path';
 import { pathToFileURL } from 'node:url';
 import { resolveEsm } from './resolve.js';
+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',
     tempDirName: 'no sandbox directory exists',

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 { disables } from './config.js';
+import { IGNORE_STATIC_REASON, disables } from './config.js';
 import { rangeDisables } from './directives.js';
 import { guardDisk, isClean } from './diskguard.js';
 import { globToRegExp, matchFiles } from './files.js';
@@ -271,7 +271,7 @@ export async function run(options) {
                 m.static = true;
                 if (options.ignoreStatic) {
                     m.status = 'Ignored';
-                    m.statusReason = 'static mutant (ignoreStatic)';
+                    m.statusReason = IGNORE_STATIC_REASON;
                 }
             }
         }

package/dist/reports.js

@@ -1,6 +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';
 export const VERSION = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version;
 const REPLACEMENT_WIDTH = 60;
 const ELLIPSIS = '...';
@@ -116,10 +117,25 @@ function frozenLine(r) {
     const sign = f.delta >= 0 ? '+' : '';
     return [`  frozen oracle vs ${f.base}: ${f.headScore.toFixed(2)}% with the change's tests, ${f.baseScore.toFixed(2)}% with the base's (${sign}${f.delta.toFixed(2)}), ${String(f.weakened.length)} mutant(s) the change stopped detecting`];
 }
-function whereItWent(s) {
+const STATIC_SHARE_WORTH_SAYING = 0.5;
+const PERCENT = 100;
+function staticLine(r) {
+    const statics = r.mutants.filter((m) => m.static);
+    if (statics.length === 0)
+        return [];
+    const ignored = statics.filter((m) => m.statusReason === IGNORE_STATIC_REASON).length;
+    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 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}`];
+}
+function whereItWent(r) {
+    const s = r.stats;
     const lines = [];
     if (s.warmUnitMs > 0)
         lines.push(`  warm servers ran ${(s.warmUnitMs / MS_PER_S).toFixed(1)} s, ${(s.warmArmedMs / MS_PER_S).toFixed(1)} s of it inside test runs`);
+    lines.push(...staticLine(r));
     const c = s.isolatedByCause;
     const causes = [`static ${String(c.static)}`, `stopped ${String(c.stopped)}`, `unfinished ${String(c.unfinished)}`, `re-run ${String(c.rerun)}`, `survivors confirmed ${String(c.confirm)}`, `flaky ${String(c.flaky)}`];
     if (s.isolatedRuns > 0)
@@ -142,7 +158,7 @@ export function textSummary(r, opts = {}) {
     const corrected = corrections(s);
     if (corrected.length)
         lines.push(`  corrected: ${corrected.join(' · ')}`);
-    lines.push(...whereItWent(s));
+    lines.push(...whereItWent(r));
     lines.push(...frozenLine(r));
     lines.push(...specLines(r));
     const survivors = r.mutants.filter((m) => m.status === 'Survived' || m.status === 'NoCoverage');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oxmutate",
-  "version": "2.0.1",
+  "version": "2.1.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>",