testing-conventions 0.0.125 → 0.0.127

package/dist/mutation/mutation-cli.d.ts

@@ -1,5 +1,6 @@
 /**
  * The TypeScript mutation adapter: run Stryker over `argv`'s scope and emit the normalized results
- * as JSON, to `--out <path>` when given and to stdout otherwise.
+ * as JSON, to `--out <path>` when given and to stdout otherwise. Refuses outright on a vitest the
+ * runner silently mis-scores, so the gate never reports a survivor it did not actually judge.
  */
 export declare function mutationCLI(argv: string[]): Promise<void>;

package/dist/mutation/mutation-cli.js

@@ -1,12 +1,19 @@
 import { writeFile } from 'node:fs/promises';
 import { parseArgs } from './parse-args.js';
+import { readVitestVersion } from './read-vitest-version.js';
 import { runStryker } from './run-stryker.js';
+import { unsupportedVitestReason } from './unsupported-vitest-reason.js';
 /**
  * The TypeScript mutation adapter: run Stryker over `argv`'s scope and emit the normalized results
- * as JSON, to `--out <path>` when given and to stdout otherwise.
+ * as JSON, to `--out <path>` when given and to stdout otherwise. Refuses outright on a vitest the
+ * runner silently mis-scores, so the gate never reports a survivor it did not actually judge.
  */
 export async function mutationCLI(argv) {
     const { mutate, out, testFiles } = parseArgs(argv);
+    const unsupported = unsupportedVitestReason(readVitestVersion(process.cwd()));
+    if (unsupported !== null) {
+        throw new Error(unsupported);
+    }
     const results = await runStryker({
         ...(mutate === undefined ? {} : { mutate }),
         ...(testFiles === undefined ? {} : { testFiles }),

package/dist/mutation/mutation-cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"mutation-cli.js","sourceRoot":"","sources":["../../src/mutation/mutation-cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAc;IAC9C,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC;QAC/B,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3C,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;KAClD,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;IAC5C,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC"}
+{"version":3,"file":"mutation-cli.js","sourceRoot":"","sources":["../../src/mutation/mutation-cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAEzE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAc;IAC9C,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,uBAAuB,CAAC,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC9E,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC;QAC/B,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3C,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;KAClD,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;IAC5C,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC"}

package/dist/mutation/read-vitest-version.d.ts

@@ -0,0 +1,8 @@
+/** Loads `vitest/package.json` as resolved from a project root. Throws when the project has none. */
+export type LoadVitestPackage = (projectRoot: string) => unknown;
+/**
+ * The `version` of the vitest that the project at `projectRoot` resolves, or `null` when it
+ * resolves none or reports no version. Resolution runs from the project, not from this package, so
+ * a consumer's own vitest is the one measured — including one hoisted to a workspace root.
+ */
+export declare function readVitestVersion(projectRoot: string, load?: LoadVitestPackage): string | null;

package/dist/mutation/read-vitest-version.js

@@ -0,0 +1,18 @@
+import { createRequire } from 'node:module';
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+/**
+ * The `version` of the vitest that the project at `projectRoot` resolves, or `null` when it
+ * resolves none or reports no version. Resolution runs from the project, not from this package, so
+ * a consumer's own vitest is the one measured — including one hoisted to a workspace root.
+ */
+export function readVitestVersion(projectRoot, load = (root) => createRequire(pathToFileURL(join(root, 'package.json')))('vitest/package.json')) {
+    try {
+        const { version } = load(projectRoot);
+        return typeof version === 'string' ? version : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=read-vitest-version.js.map

package/dist/mutation/read-vitest-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-vitest-version.js","sourceRoot":"","sources":["../../src/mutation/read-vitest-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAKzC;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,WAAmB,EACnB,OAA0B,CAAC,IAAI,EAAE,EAAE,CACjC,aAAa,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC;IAEjF,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,WAAW,CAA0B,CAAC;QAC/D,OAAO,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/mutation/unsupported-vitest-reason.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Why the mutation gate refuses to run against `version`, or `null` when it will run. An absent or
+ * unparseable version yields `null` — the runner reports its own missing-vitest failure better than
+ * a guess here would.
+ */
+export declare function unsupportedVitestReason(version: string | null): string | null;

package/dist/mutation/unsupported-vitest-reason.js

@@ -0,0 +1,24 @@
+// Stryker's vitest runner completes zero tests per mutant from this major on: the dry run and
+// per-test coverage both still succeed, so every mutant scores as `survived` rather than erroring.
+// Verified against @stryker-mutator/vitest-runner 9.6.1 and 10.0.0; vitest 4 is unaffected.
+const FIRST_UNSUPPORTED_MAJOR = 5;
+/**
+ * Why the mutation gate refuses to run against `version`, or `null` when it will run. An absent or
+ * unparseable version yields `null` — the runner reports its own missing-vitest failure better than
+ * a guess here would.
+ */
+export function unsupportedVitestReason(version) {
+    if (version === null) {
+        return null;
+    }
+    const major = Number.parseInt(version, 10);
+    if (!Number.isInteger(major) || major < FIRST_UNSUPPORTED_MAJOR) {
+        return null;
+    }
+    return (`the mutation gate cannot judge mutants on vitest ${version}: Stryker's vitest runner runs no ` +
+        `tests per mutant on vitest ${FIRST_UNSUPPORTED_MAJOR} and above, so every mutant reports as ` +
+        `survived even when the suite kills it. Pin \`vitest\` and \`@vitest/coverage-v8\` to \`^4\` ` +
+        `to run this gate, or leave \`mutation\` out of the workflow's \`gates\` to skip it. ` +
+        `See https://github.com/thekevinscott/testing-conventions/issues/700.`);
+}
+//# sourceMappingURL=unsupported-vitest-reason.js.map

package/dist/mutation/unsupported-vitest-reason.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsupported-vitest-reason.js","sourceRoot":"","sources":["../../src/mutation/unsupported-vitest-reason.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,mGAAmG;AACnG,4FAA4F;AAC5F,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAElC;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAsB;IAC5D,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,uBAAuB,EAAE,CAAC;QAChE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,CACL,oDAAoD,OAAO,oCAAoC;QAC/F,8BAA8B,uBAAuB,yCAAyC;QAC9F,8FAA8F;QAC9F,sFAAsF;QACtF,sEAAsE,CACvE,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "testing-conventions",
-  "version": "0.0.125",
+  "version": "0.0.127",
   "description": "Enforce testing conventions in libraries (Python, TypeScript, and Rust).",
   "license": "MIT",
   "repository": "https://github.com/thekevinscott/testing-conventions",
@@ -55,10 +55,10 @@
     "vitest": "^3.2.4"
   },
   "optionalDependencies": {
-    "@testing-conventions/x86_64-unknown-linux-gnu": "0.0.125",
-    "@testing-conventions/aarch64-unknown-linux-gnu": "0.0.125",
-    "@testing-conventions/x86_64-apple-darwin": "0.0.125",
-    "@testing-conventions/aarch64-apple-darwin": "0.0.125",
-    "@testing-conventions/x86_64-pc-windows-msvc": "0.0.125"
+    "@testing-conventions/x86_64-unknown-linux-gnu": "0.0.127",
+    "@testing-conventions/aarch64-unknown-linux-gnu": "0.0.127",
+    "@testing-conventions/x86_64-apple-darwin": "0.0.127",
+    "@testing-conventions/aarch64-apple-darwin": "0.0.127",
+    "@testing-conventions/x86_64-pc-windows-msvc": "0.0.127"
   }
 }