@mizchi/mutator-jest 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mizchi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/config.d.ts

@@ -0,0 +1,24 @@
+import type { InstrumentOptions } from '@mizchi/mutator-core';
+export declare const SETUP_FILE: string;
+export interface JestProject {
+    /** `jest/bin/jest.js` resolved from the project root. */
+    bin: string;
+    /** The project's config file, if any. */
+    configPath: string | undefined;
+    /** Raw (un-normalized) options as written by the user, with an absolute rootDir. */
+    raw: Record<string, unknown>;
+    /** Normalized transform entries: [pattern, absolute transformer path, options]. */
+    transform: [string, string, unknown][];
+    /** Absolute setupFiles / setupFilesAfterEnv / globalSetup / globalTeardown of the project. */
+    setupFiles: string[];
+}
+export declare function readJestProject(root: string, configFile?: string): Promise<JestProject>;
+export interface TransformerConfig {
+    inner: [string, unknown] | null;
+    root: string;
+    targets: string[];
+    pluginModules: string[];
+    arid?: InstrumentOptions['arid'];
+    excludedMutators?: readonly string[];
+}
+export declare function mutatorJestConfig(project: JestProject, transformer: Omit<TransformerConfig, 'inner'>, cacheDirectory: string): Record<string, unknown>;

package/dist/config.js

@@ -0,0 +1,54 @@
+// Reads the project's Jest config with its own jest-config and derives the config
+// the mutator runs Jest with: every transform wrapped by our transformer, our
+// runtime setup in front of setupFiles / setupFilesAfterEnv.
+import { createRequire } from 'node:module';
+import { dirname, isAbsolute, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+// Published builds run from dist/; the CommonJS helpers ship in src/.
+const own = (name) => fileURLToPath(new URL(import.meta.url.endsWith('.ts') ? `./${name}` : `../src/${name}`, import.meta.url));
+const TRANSFORMER = own('transformer.cjs');
+export const SETUP_FILE = own('setup.cjs');
+const HOOKS_FILE = own('hooks.cjs');
+/** Jest's own default pattern for JavaScript / TypeScript. */
+const SOURCE_PATTERN = '\\.[cm]?[jt]sx?$';
+export async function readJestProject(root, configFile) {
+    let jestPackage;
+    try {
+        jestPackage = createRequire(join(root, 'package.json')).resolve('jest/package.json');
+    }
+    catch (error) {
+        throw new Error(`mutator: cannot resolve jest from ${root}`, { cause: error });
+    }
+    const fromJest = createRequire(jestPackage);
+    const jestConfig = createRequire(fromJest.resolve('jest-cli/package.json'))('jest-config');
+    const { config: raw, configPath } = await jestConfig.readInitialOptions(configFile, { packageRootOrConfig: configFile ?? root });
+    if (raw.projects)
+        throw new Error('mutator: Jest `projects` are not supported');
+    const { options } = await jestConfig.normalize(raw, {});
+    const setupFiles = ['setupFiles', 'setupFilesAfterEnv', 'globalSetup', 'globalTeardown'].flatMap((key) => [options[key] ?? []].flat());
+    return {
+        bin: join(dirname(jestPackage), 'bin', 'jest.js'),
+        configPath: configPath && isAbsolute(configPath) && !configPath.endsWith('package.json') ? configPath : undefined,
+        raw,
+        transform: options.transform ?? [],
+        setupFiles: setupFiles.filter((f) => typeof f === 'string' && isAbsolute(f)),
+    };
+}
+export function mutatorJestConfig(project, transformer, cacheDirectory) {
+    const transform = {};
+    const entries = project.transform.length > 0 ? project.transform : [[SOURCE_PATTERN, null, {}]];
+    for (const [pattern, path, options] of entries) {
+        transform[pattern] = [TRANSFORMER, { ...transformer, inner: path ? [path, options] : null }];
+    }
+    const list = (key) => [project.raw[key] ?? []].flat();
+    return {
+        ...project.raw,
+        transform,
+        setupFiles: [SETUP_FILE, ...list('setupFiles')],
+        setupFilesAfterEnv: [HOOKS_FILE, ...list('setupFilesAfterEnv')],
+        cacheDirectory,
+        watchman: false,
+        collectCoverage: false,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { type JestSessionOptions, createJestSession } from './session.ts';
+export type { DryRunResult, MutantRunResult, RunMutantOptions, Session, TestLocation } from '@mizchi/mutator-core';

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createJestSession } from './session.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/session.d.ts

@@ -0,0 +1,16 @@
+import { type InstrumentOptions, type Session } from '@mizchi/mutator-core';
+export interface JestSessionOptions {
+    root: string;
+    /** Absolute paths of the source files to mutate. */
+    targets: readonly string[];
+    /** Jest config file; defaults to Jest's own lookup from `root`. */
+    configFile?: string;
+    arid?: InstrumentOptions['arid'];
+    excludedMutators?: InstrumentOptions['excludedMutators'];
+    /** Custom mutators / ignorers, used for `mutants()` in this process. */
+    mutators?: InstrumentOptions['mutators'];
+    ignorers?: InstrumentOptions['ignorers'];
+    /** Absolute paths of the plugin modules providing `mutators` / `ignorers`; Jest's transformer loads them itself. */
+    pluginModules?: readonly string[];
+}
+export declare function createJestSession(options: JestSessionOptions): Promise<Session>;

package/dist/session.js

@@ -0,0 +1,267 @@
+// Jest session: every dry run and every mutant run is a separate Jest child
+// process (native ESM via --experimental-vm-modules), so a mutant stuck in a
+// synchronous loop is killed with its process group instead of freezing the CLI.
+import { spawn } from 'node:child_process';
+import { mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, relative } from 'node:path';
+import { DEFAULT_HIT_LIMIT, HIT_LIMIT_MESSAGE, emptyDryRun, hash, instrument, numberDuplicates, } from '@mizchi/mutator-core';
+import { mutatorJestConfig, readJestProject } from './config.js';
+/** Jest start-up allowance added to every mutant timeout until a run has been measured. */
+const DEFAULT_STARTUP_MS = 3000;
+export async function createJestSession(options) {
+    const { root } = options;
+    if ((options.mutators?.length || options.ignorers?.length) && !options.pluginModules?.length) {
+        throw new Error('mutator: custom mutators / ignorers reach Jest only as plugin modules (pluginModules)');
+    }
+    const project = await readJestProject(root, options.configFile);
+    const dir = mkdtempSync(join(tmpdir(), 'mutator-jest-'));
+    const configPath = join(dir, 'jest.config.json');
+    const transformer = {
+        root,
+        targets: [...options.targets],
+        pluginModules: [...(options.pluginModules ?? [])],
+        ...(options.arid !== undefined ? { arid: options.arid } : {}),
+        ...(options.excludedMutators ? { excludedMutators: options.excludedMutators } : {}),
+    };
+    writeFileSync(configPath, JSON.stringify(mutatorJestConfig(project, transformer, join(dir, 'cache'))));
+    const locations = new Map();
+    let mutants;
+    let startupMs = DEFAULT_STARTUP_MS;
+    let runs = 0;
+    const jest = async (args, env, timeoutMs = Infinity) => {
+        const outputFile = join(dir, `report-${runs++}.json`);
+        const argv = [
+            '--experimental-vm-modules',
+            '--disable-warning=ExperimentalWarning',
+            project.bin,
+            '--config',
+            configPath,
+            '--ci',
+            '--silent',
+            '--json',
+            '--outputFile',
+            outputFile,
+            '--passWithNoTests',
+            '--forceExit',
+            ...args,
+        ];
+        const started = performance.now();
+        const child = spawn(process.execPath, argv, {
+            cwd: root,
+            detached: true,
+            stdio: ['ignore', 'ignore', 'pipe'],
+            env: { ...process.env, ...env },
+        });
+        let stderr = '';
+        child.stderr.on('data', (chunk) => {
+            if (stderr.length < 64 * 1024)
+                stderr += chunk.toString();
+        });
+        let timedOut = false;
+        const timer = Number.isFinite(timeoutMs)
+            ? setTimeout(() => {
+                timedOut = true;
+                killGroup(child.pid);
+            }, timeoutMs)
+            : undefined;
+        await new Promise((resolve) => child.on('close', () => resolve()));
+        clearTimeout(timer);
+        // Workers Jest forked are in the same group; make sure none outlives the run.
+        killGroup(child.pid);
+        let report;
+        try {
+            report = JSON.parse(readFileSync(outputFile, 'utf8'));
+        }
+        catch {
+            report = undefined;
+        }
+        rmSync(outputFile, { force: true });
+        return { report, timedOut, stderr, wallMs: performance.now() - started };
+    };
+    const measure = (outcome) => {
+        if (!outcome.report)
+            return;
+        const testsMs = outcome.report.testResults.flatMap((s) => s.assertionResults).reduce((sum, a) => sum + (a.duration ?? 0), 0);
+        startupMs = Math.max(1000, outcome.wallMs - testsMs);
+    };
+    return {
+        mutants() {
+            mutants ??= options.targets.flatMap((file) => instrument(file, readFileSync(file, 'utf8'), {
+                identity: relative(root, file),
+                ...(options.arid !== undefined ? { arid: options.arid } : {}),
+                ...(options.excludedMutators ? { excludedMutators: options.excludedMutators } : {}),
+                ...(options.mutators ? { mutators: options.mutators } : {}),
+                ...(options.ignorers ? { ignorers: options.ignorers } : {}),
+            }).mutants);
+            return mutants;
+        },
+        configFiles() {
+            return [...new Set([...(project.configPath ? [project.configPath] : []), ...project.setupFiles])].sort();
+        },
+        async testFiles() {
+            return listTests(project, configPath, root);
+        },
+        async dryRun(files) {
+            if (files && files.length === 0)
+                return emptyDryRun();
+            const coverageDir = join(dir, `coverage-${runs}`);
+            mkdirSync(coverageDir, { recursive: true });
+            const outcome = await jest(files ? ['--runTestsByPath', ...files] : [], {
+                MUTATOR_COVERAGE_DIR: coverageDir,
+                MUTATOR_HIT_LIMIT: String(DEFAULT_HIT_LIMIT),
+            });
+            if (!outcome.report)
+                throw new Error(`mutator: jest produced no report\n${outcome.stderr}`);
+            measure(outcome);
+            const coverage = new Map();
+            for (const name of readdirSync(coverageDir)) {
+                const file = JSON.parse(readFileSync(join(coverageDir, name), 'utf8'));
+                coverage.set(file.testPath, file);
+            }
+            rmSync(coverageDir, { recursive: true, force: true });
+            const dry = collectDryRun(outcome.report, coverage, root);
+            for (const [id, location] of dry.index)
+                locations.set(id, location);
+            return dry;
+        },
+        useTestIndex(index) {
+            locations.clear();
+            for (const [id, location] of index)
+                locations.set(id, location);
+        },
+        async runMutant(key, testIds, { timeoutMs, hitLimit = DEFAULT_HIT_LIMIT, earlyExit = true }) {
+            const byFile = new Map();
+            for (const id of testIds) {
+                const location = locations.get(id);
+                if (!location)
+                    continue;
+                const names = byFile.get(location.moduleId) ?? new Set();
+                names.add(location.taskId);
+                byFile.set(location.moduleId, names);
+            }
+            if (byFile.size === 0)
+                return { status: 'Survived', killedBy: [], durationMs: 0 };
+            const names = [...new Set([...byFile.values()].flatMap((s) => [...s]))];
+            const pattern = `^(?:${names.map(escapeRegExp).join('|')})$`;
+            const outcome = await jest(
+            // --bail stops after the first failing test file; without it every file runs (--kill-matrix).
+            ['--runInBand', ...(earlyExit ? ['--bail'] : []), '--testNamePattern', pattern, '--runTestsByPath', ...byFile.keys()], { MUTATOR_ACTIVE: key, MUTATOR_HIT_LIMIT: String(hitLimit) }, timeoutMs + startupMs);
+            const durationMs = outcome.wallMs;
+            if (outcome.timedOut)
+                return { status: 'Timeout', killedBy: [], durationMs };
+            if (!outcome.report)
+                return { status: 'RuntimeError', killedBy: [], durationMs };
+            measure(outcome);
+            return { ...classify(outcome.report, root, new Set(testIds)), durationMs };
+        },
+        async close() {
+            rmSync(dir, { recursive: true, force: true });
+        },
+    };
+}
+function killGroup(pid) {
+    if (pid === undefined)
+        return;
+    try {
+        process.kill(-pid, 'SIGKILL');
+    }
+    catch {
+        // already gone
+    }
+}
+async function listTests(project, configPath, root) {
+    const child = spawn(process.execPath, ['--experimental-vm-modules', '--disable-warning=ExperimentalWarning', project.bin, '--config', configPath, '--listTests', '--json'], { cwd: root, stdio: ['ignore', 'pipe', 'pipe'] });
+    let stdout = '';
+    let stderr = '';
+    child.stdout.on('data', (c) => (stdout += c.toString()));
+    child.stderr.on('data', (c) => (stderr += c.toString()));
+    const code = await new Promise((resolve) => child.on('close', resolve));
+    const json = stdout.slice(stdout.indexOf('['));
+    try {
+        return JSON.parse(json).sort();
+    }
+    catch {
+        throw new Error(`mutator: jest --listTests failed (exit ${code})\n${stderr}`);
+    }
+}
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\/]/g, '\\$&');
+}
+const SKIPPED = new Set(['pending', 'skipped', 'todo', 'disabled', 'focused']);
+/** Test ids with `#n` suffixes for duplicate full names, as the vitest session does. */
+function* identify(suite, root) {
+    const rel = relative(root, suite.name);
+    const distinct = numberDuplicates();
+    const executed = numberDuplicates();
+    for (const assertion of suite.assertionResults) {
+        const id = distinct(`${rel}#${assertion.fullName}`);
+        // The setup hooks only see executed tests; their counter skips skipped ones.
+        const coverageKey = SKIPPED.has(assertion.status) ? assertion.fullName : executed(assertion.fullName);
+        yield { id, assertion, coverageKey };
+    }
+}
+function collectDryRun(report, coverageByFile, root) {
+    const dry = emptyDryRun();
+    for (const suite of report.testResults) {
+        const rel = relative(root, suite.name);
+        const cov = coverageByFile.get(suite.name);
+        const fileStatic = new Set();
+        dry.staticByFile.set(rel, fileStatic);
+        for (const key of Object.keys(cov?.static ?? {})) {
+            dry.staticKeys.add(key);
+            fileStatic.add(key);
+        }
+        for (const [key, n] of Object.entries(cov?.counts ?? {}))
+            dry.hits.set(key, (dry.hits.get(key) ?? 0) + n);
+        if (suite.status === 'failed' && !suite.assertionResults.some((a) => a.status === 'failed'))
+            dry.failed.push(rel);
+        const fingerprint = hash(readFileSync(suite.name, 'utf8'));
+        for (const { id, assertion, coverageKey } of identify(suite, root)) {
+            dry.index.set(id, { moduleId: suite.name, taskId: assertion.fullName });
+            if (SKIPPED.has(assertion.status))
+                continue;
+            if (assertion.status === 'failed')
+                dry.failed.push(id);
+            const test = { id, fingerprint: hash(`${fingerprint}\0${id}`), durationMs: assertion.duration ?? 0 };
+            dry.tests.push(test);
+            const spawned = cov?.spawns?.[coverageKey];
+            if (spawned)
+                (dry.spawns ??= new Map()).set(id, spawned);
+            for (const key of Object.keys(cov?.perTest[coverageKey] ?? {})) {
+                const covering = dry.coverage.get(key) ?? [];
+                covering.push(id);
+                dry.coverage.set(key, covering);
+            }
+        }
+    }
+    return dry;
+}
+function classify(report, root, selected) {
+    const killedBy = [];
+    const messages = [];
+    let suiteError = false;
+    for (const suite of report.testResults) {
+        const failedTests = suite.assertionResults.some((a) => a.status === 'failed');
+        if (suite.status === 'failed' && !failedTests) {
+            suiteError = true;
+            killedBy.push(relative(root, suite.name));
+            messages.push(suite.message ?? '');
+        }
+        for (const { id, assertion } of identify(suite, root)) {
+            if (assertion.status !== 'failed' || !selected.has(id))
+                continue;
+            killedBy.push(id);
+            messages.push((assertion.failureMessages ?? []).join('\n'));
+        }
+    }
+    if (killedBy.length === 0)
+        return { status: 'Survived', killedBy };
+    // The hit limit guards against endless loops: a run stopped only by it is a timeout.
+    if (messages.every((m) => m.includes(HIT_LIMIT_MESSAGE)))
+        return { status: 'Timeout', killedBy: [] };
+    if (suiteError && killedBy.every((k) => !k.includes('#')))
+        return { status: 'RuntimeError', killedBy };
+    return { status: 'Killed', killedBy };
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/package.json

@@ -1,6 +1,52 @@
 {
   "name": "@mizchi/mutator-jest",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Jest adapter for @mizchi/mutator-core (experimental)",
+  "keywords": [
+    "mutation-testing",
+    "jest"
+  ],
+  "license": "MIT",
+  "author": "mizchi",
+  "homepage": "https://github.com/mizchi/mutator#readme",
+  "bugs": "https://github.com/mizchi/mutator/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mizchi/mutator.git",
+    "directory": "packages/jest"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "engines": {
+    "node": ">=24"
+  },
+  "peerDependencies": {
+    "jest": ">=30.0.0"
+  },
+  "peerDependenciesMeta": {
+    "jest": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@mizchi/mutator-core": "0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "jest": "30.5.2"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json"
+  }
 }

package/src/config.ts

@@ -0,0 +1,83 @@
+// Reads the project's Jest config with its own jest-config and derives the config
+// the mutator runs Jest with: every transform wrapped by our transformer, our
+// runtime setup in front of setupFiles / setupFilesAfterEnv.
+import { createRequire } from 'node:module';
+import { dirname, isAbsolute, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import type { InstrumentOptions } from '@mizchi/mutator-core';
+
+// Published builds run from dist/; the CommonJS helpers ship in src/.
+const own = (name: string) => fileURLToPath(new URL(import.meta.url.endsWith('.ts') ? `./${name}` : `../src/${name}`, import.meta.url));
+const TRANSFORMER = own('transformer.cjs');
+export const SETUP_FILE = own('setup.cjs');
+const HOOKS_FILE = own('hooks.cjs');
+
+/** Jest's own default pattern for JavaScript / TypeScript. */
+const SOURCE_PATTERN = '\\.[cm]?[jt]sx?$';
+
+export interface JestProject {
+  /** `jest/bin/jest.js` resolved from the project root. */
+  bin: string;
+  /** The project's config file, if any. */
+  configPath: string | undefined;
+  /** Raw (un-normalized) options as written by the user, with an absolute rootDir. */
+  raw: Record<string, unknown>;
+  /** Normalized transform entries: [pattern, absolute transformer path, options]. */
+  transform: [string, string, unknown][];
+  /** Absolute setupFiles / setupFilesAfterEnv / globalSetup / globalTeardown of the project. */
+  setupFiles: string[];
+}
+
+interface JestConfigModule {
+  readInitialOptions(config: string | undefined, options: { packageRootOrConfig: string }): Promise<{ config: Record<string, unknown>; configPath: string | null }>;
+  normalize(options: Record<string, unknown>, argv: Record<string, unknown>): Promise<{ options: Record<string, unknown> }>;
+}
+
+export async function readJestProject(root: string, configFile?: string): Promise<JestProject> {
+  let jestPackage: string;
+  try {
+    jestPackage = createRequire(join(root, 'package.json')).resolve('jest/package.json');
+  } catch (error) {
+    throw new Error(`mutator: cannot resolve jest from ${root}`, { cause: error });
+  }
+  const fromJest = createRequire(jestPackage);
+  const jestConfig = createRequire(fromJest.resolve('jest-cli/package.json'))('jest-config') as JestConfigModule;
+  const { config: raw, configPath } = await jestConfig.readInitialOptions(configFile, { packageRootOrConfig: configFile ?? root });
+  if (raw.projects) throw new Error('mutator: Jest `projects` are not supported');
+  const { options } = await jestConfig.normalize(raw, {});
+  const setupFiles = ['setupFiles', 'setupFilesAfterEnv', 'globalSetup', 'globalTeardown'].flatMap((key) => [options[key] ?? []].flat() as string[]);
+  return {
+    bin: join(dirname(jestPackage), 'bin', 'jest.js'),
+    configPath: configPath && isAbsolute(configPath) && !configPath.endsWith('package.json') ? configPath : undefined,
+    raw,
+    transform: (options.transform as [string, string, unknown][] | undefined) ?? [],
+    setupFiles: setupFiles.filter((f) => typeof f === 'string' && isAbsolute(f)),
+  };
+}
+
+export interface TransformerConfig {
+  inner: [string, unknown] | null;
+  root: string;
+  targets: string[];
+  pluginModules: string[];
+  arid?: InstrumentOptions['arid'];
+  excludedMutators?: readonly string[];
+}
+
+export function mutatorJestConfig(project: JestProject, transformer: Omit<TransformerConfig, 'inner'>, cacheDirectory: string): Record<string, unknown> {
+  const transform: Record<string, [string, TransformerConfig]> = {};
+  const entries: [string, string | null, unknown][] = project.transform.length > 0 ? project.transform : [[SOURCE_PATTERN, null, {}]];
+  for (const [pattern, path, options] of entries) {
+    transform[pattern] = [TRANSFORMER, { ...transformer, inner: path ? [path, options] : null }];
+  }
+  const list = (key: string) => [project.raw[key] ?? []].flat();
+  return {
+    ...project.raw,
+    transform,
+    setupFiles: [SETUP_FILE, ...list('setupFiles')],
+    setupFilesAfterEnv: [HOOKS_FILE, ...list('setupFilesAfterEnv')],
+    cacheDirectory,
+    watchman: false,
+    collectCoverage: false,
+  };
+}

package/src/hooks.cjs

@@ -0,0 +1,69 @@
+'use strict';
+// Prepended to `setupFilesAfterEnv`: attributes mutant hits to the running test
+// and, in a dry run, writes the file's coverage for the session to collect.
+const { createHash } = require('node:crypto');
+const { writeFileSync } = require('node:fs');
+const { join } = require('node:path');
+
+const ns = globalThis.__mutator__;
+// Duplicate full names get `#2`, `#3`, ... in execution (= declaration) order, like the session.
+const seen = new Map();
+// Test name -> processes it started (dry run only).
+const spawns = {};
+
+// Dry run only: record the processes each test starts (mutants applied in memory are not
+// seen there). The builtin is shared by the worker's test files: each file re-wraps the original.
+if (process.env.MUTATOR_COVERAGE_DIR) {
+  const { resolve } = require('node:path');
+  const { fileURLToPath } = require('node:url');
+  const childProcess = require('node:child_process');
+  const ORIGINAL = Symbol.for('mutator.original');
+  const record = (name, [command, second, third]) => {
+    if (ns.testId === null) return;
+    try {
+      const shell = name === 'exec' || name === 'execSync';
+      const list = !shell && Array.isArray(second) ? second.map(String) : [];
+      const options = shell || !Array.isArray(second) ? second : third;
+      const argv = shell ? String(command).trim().split(/\s+/) : [...(name === 'fork' ? ['node'] : []), String(command), ...list];
+      const cwd = options && typeof options === 'object' ? options.cwd : undefined;
+      (spawns[ns.testId] ??= []).push({ argv, cwd: resolve(cwd instanceof URL ? fileURLToPath(cwd) : typeof cwd === 'string' ? cwd : process.cwd()) });
+    } catch {
+      // Recording must never break the test.
+    }
+  };
+  for (const name of ['spawn', 'spawnSync', 'exec', 'execSync', 'execFile', 'execFileSync', 'fork']) {
+    const original = childProcess[name][ORIGINAL] ?? childProcess[name];
+    const wrap = (fn) =>
+      function (...args) {
+        record(name, args);
+        return fn.apply(this, args);
+      };
+    const wrapped = wrap(original);
+    wrapped[ORIGINAL] = original;
+    // util.promisify.custom (exec, execFile)
+    for (const key of Object.getOwnPropertySymbols(original)) wrapped[key] = typeof original[key] === 'function' ? wrap(original[key]) : original[key];
+    childProcess[name] = wrapped;
+  }
+  require('node:module').syncBuiltinESMExports();
+}
+
+beforeEach(() => {
+  const name = expect.getState().currentTestName ?? '';
+  const n = (seen.get(name) ?? 0) + 1;
+  seen.set(name, n);
+  ns.testId = n > 1 ? `${name}#${n}` : name;
+});
+
+afterEach(() => {
+  ns.testId = null;
+});
+
+afterAll(() => {
+  const dir = process.env.MUTATOR_COVERAGE_DIR;
+  if (!dir) return;
+  const testPath = expect.getState().testPath;
+  const name = createHash('sha256').update(testPath).digest('hex').slice(0, 32);
+  const counts = {};
+  for (const [keys, n] of ns.modules ?? []) for (let i = 0; i < keys.length; i++) if (n[i]) counts[keys[i]] = (counts[keys[i]] ?? 0) + n[i];
+  writeFileSync(join(dir, `${name}.json`), JSON.stringify({ testPath, static: ns.cov.static, perTest: ns.cov.perTest, counts, spawns }));
+});

package/src/index.ts

@@ -0,0 +1,2 @@
+export { type JestSessionOptions, createJestSession } from './session.ts';
+export type { DryRunResult, MutantRunResult, RunMutantOptions, Session, TestLocation } from '@mizchi/mutator-core';

package/src/session.ts

@@ -0,0 +1,337 @@
+// Jest session: every dry run and every mutant run is a separate Jest child
+// process (native ESM via --experimental-vm-modules), so a mutant stuck in a
+// synchronous loop is killed with its process group instead of freezing the CLI.
+import { spawn } from 'node:child_process';
+import { mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, relative } from 'node:path';
+import {
+  DEFAULT_HIT_LIMIT,
+  type DryRunResult,
+  HIT_LIMIT_MESSAGE,
+  type InstrumentOptions,
+  type Mutant,
+  type MutantRunResult,
+  type Session,
+  type SpawnedCommand,
+  type TestInfo,
+  type TestLocation,
+  emptyDryRun,
+  hash,
+  instrument,
+  numberDuplicates,
+} from '@mizchi/mutator-core';
+import { type JestProject, mutatorJestConfig, readJestProject } from './config.ts';
+
+export interface JestSessionOptions {
+  root: string;
+  /** Absolute paths of the source files to mutate. */
+  targets: readonly string[];
+  /** Jest config file; defaults to Jest's own lookup from `root`. */
+  configFile?: string;
+  arid?: InstrumentOptions['arid'];
+  excludedMutators?: InstrumentOptions['excludedMutators'];
+  /** Custom mutators / ignorers, used for `mutants()` in this process. */
+  mutators?: InstrumentOptions['mutators'];
+  ignorers?: InstrumentOptions['ignorers'];
+  /** Absolute paths of the plugin modules providing `mutators` / `ignorers`; Jest's transformer loads them itself. */
+  pluginModules?: readonly string[];
+}
+
+/** Jest start-up allowance added to every mutant timeout until a run has been measured. */
+const DEFAULT_STARTUP_MS = 3000;
+
+interface AssertionResult {
+  fullName: string;
+  status: string;
+  duration?: number | null;
+  failureMessages?: string[];
+}
+
+interface SuiteResult {
+  name: string;
+  status: string;
+  message?: string;
+  assertionResults: AssertionResult[];
+}
+
+interface JsonReport {
+  testResults: SuiteResult[];
+}
+
+interface FileCoverage {
+  testPath: string;
+  static: Record<string, number>;
+  perTest: Record<string, Record<string, number>>;
+  /** Hits per mutant summed over the file's modules. */
+  counts?: Record<string, number>;
+  /** Test name -> processes it started. */
+  spawns?: Record<string, SpawnedCommand[]>;
+}
+
+interface RunOutcome {
+  report: JsonReport | undefined;
+  timedOut: boolean;
+  stderr: string;
+  wallMs: number;
+}
+
+export async function createJestSession(options: JestSessionOptions): Promise<Session> {
+  const { root } = options;
+  if ((options.mutators?.length || options.ignorers?.length) && !options.pluginModules?.length) {
+    throw new Error('mutator: custom mutators / ignorers reach Jest only as plugin modules (pluginModules)');
+  }
+  const project: JestProject = await readJestProject(root, options.configFile);
+  const dir = mkdtempSync(join(tmpdir(), 'mutator-jest-'));
+  const configPath = join(dir, 'jest.config.json');
+  const transformer = {
+    root,
+    targets: [...options.targets],
+    pluginModules: [...(options.pluginModules ?? [])],
+    ...(options.arid !== undefined ? { arid: options.arid } : {}),
+    ...(options.excludedMutators ? { excludedMutators: options.excludedMutators } : {}),
+  };
+  writeFileSync(configPath, JSON.stringify(mutatorJestConfig(project, transformer, join(dir, 'cache'))));
+
+  const locations = new Map<string, TestLocation>();
+  let mutants: Mutant[] | undefined;
+  let startupMs = DEFAULT_STARTUP_MS;
+  let runs = 0;
+
+  const jest = async (args: readonly string[], env: Record<string, string>, timeoutMs = Infinity): Promise<RunOutcome> => {
+    const outputFile = join(dir, `report-${runs++}.json`);
+    const argv = [
+      '--experimental-vm-modules',
+      '--disable-warning=ExperimentalWarning',
+      project.bin,
+      '--config',
+      configPath,
+      '--ci',
+      '--silent',
+      '--json',
+      '--outputFile',
+      outputFile,
+      '--passWithNoTests',
+      '--forceExit',
+      ...args,
+    ];
+    const started = performance.now();
+    const child = spawn(process.execPath, argv, {
+      cwd: root,
+      detached: true,
+      stdio: ['ignore', 'ignore', 'pipe'],
+      env: { ...process.env, ...env },
+    });
+    let stderr = '';
+    child.stderr.on('data', (chunk: Buffer) => {
+      if (stderr.length < 64 * 1024) stderr += chunk.toString();
+    });
+    let timedOut = false;
+    const timer = Number.isFinite(timeoutMs)
+      ? setTimeout(() => {
+          timedOut = true;
+          killGroup(child.pid);
+        }, timeoutMs)
+      : undefined;
+    await new Promise<void>((resolve) => child.on('close', () => resolve()));
+    clearTimeout(timer);
+    // Workers Jest forked are in the same group; make sure none outlives the run.
+    killGroup(child.pid);
+    let report: JsonReport | undefined;
+    try {
+      report = JSON.parse(readFileSync(outputFile, 'utf8')) as JsonReport;
+    } catch {
+      report = undefined;
+    }
+    rmSync(outputFile, { force: true });
+    return { report, timedOut, stderr, wallMs: performance.now() - started };
+  };
+
+  const measure = (outcome: RunOutcome) => {
+    if (!outcome.report) return;
+    const testsMs = outcome.report.testResults.flatMap((s) => s.assertionResults).reduce((sum, a) => sum + (a.duration ?? 0), 0);
+    startupMs = Math.max(1000, outcome.wallMs - testsMs);
+  };
+
+  return {
+    mutants() {
+      mutants ??= options.targets.flatMap(
+        (file) =>
+          instrument(file, readFileSync(file, 'utf8'), {
+            identity: relative(root, file),
+            ...(options.arid !== undefined ? { arid: options.arid } : {}),
+            ...(options.excludedMutators ? { excludedMutators: options.excludedMutators } : {}),
+            ...(options.mutators ? { mutators: options.mutators } : {}),
+            ...(options.ignorers ? { ignorers: options.ignorers } : {}),
+          }).mutants,
+      );
+      return mutants;
+    },
+
+    configFiles() {
+      return [...new Set([...(project.configPath ? [project.configPath] : []), ...project.setupFiles])].sort();
+    },
+
+    async testFiles() {
+      return listTests(project, configPath, root);
+    },
+
+    async dryRun(files) {
+      if (files && files.length === 0) return emptyDryRun();
+      const coverageDir = join(dir, `coverage-${runs}`);
+      mkdirSync(coverageDir, { recursive: true });
+      const outcome = await jest(files ? ['--runTestsByPath', ...files] : [], {
+        MUTATOR_COVERAGE_DIR: coverageDir,
+        MUTATOR_HIT_LIMIT: String(DEFAULT_HIT_LIMIT),
+      });
+      if (!outcome.report) throw new Error(`mutator: jest produced no report\n${outcome.stderr}`);
+      measure(outcome);
+      const coverage = new Map<string, FileCoverage>();
+      for (const name of readdirSync(coverageDir)) {
+        const file = JSON.parse(readFileSync(join(coverageDir, name), 'utf8')) as FileCoverage;
+        coverage.set(file.testPath, file);
+      }
+      rmSync(coverageDir, { recursive: true, force: true });
+      const dry = collectDryRun(outcome.report, coverage, root);
+      for (const [id, location] of dry.index) locations.set(id, location);
+      return dry;
+    },
+
+    useTestIndex(index) {
+      locations.clear();
+      for (const [id, location] of index) locations.set(id, location);
+    },
+
+    async runMutant(key, testIds, { timeoutMs, hitLimit = DEFAULT_HIT_LIMIT, earlyExit = true }) {
+      const byFile = new Map<string, Set<string>>();
+      for (const id of testIds) {
+        const location = locations.get(id);
+        if (!location) continue;
+        const names = byFile.get(location.moduleId) ?? new Set();
+        names.add(location.taskId);
+        byFile.set(location.moduleId, names);
+      }
+      if (byFile.size === 0) return { status: 'Survived', killedBy: [], durationMs: 0 };
+      const names = [...new Set([...byFile.values()].flatMap((s) => [...s]))];
+      const pattern = `^(?:${names.map(escapeRegExp).join('|')})$`;
+      const outcome = await jest(
+        // --bail stops after the first failing test file; without it every file runs (--kill-matrix).
+        ['--runInBand', ...(earlyExit ? ['--bail'] : []), '--testNamePattern', pattern, '--runTestsByPath', ...byFile.keys()],
+        { MUTATOR_ACTIVE: key, MUTATOR_HIT_LIMIT: String(hitLimit) },
+        timeoutMs + startupMs,
+      );
+      const durationMs = outcome.wallMs;
+      if (outcome.timedOut) return { status: 'Timeout', killedBy: [], durationMs };
+      if (!outcome.report) return { status: 'RuntimeError', killedBy: [], durationMs };
+      measure(outcome);
+      return { ...classify(outcome.report, root, new Set(testIds)), durationMs };
+    },
+
+    async close() {
+      rmSync(dir, { recursive: true, force: true });
+    },
+  };
+}
+
+function killGroup(pid: number | undefined): void {
+  if (pid === undefined) return;
+  try {
+    process.kill(-pid, 'SIGKILL');
+  } catch {
+    // already gone
+  }
+}
+
+async function listTests(project: JestProject, configPath: string, root: string): Promise<string[]> {
+  const child = spawn(
+    process.execPath,
+    ['--experimental-vm-modules', '--disable-warning=ExperimentalWarning', project.bin, '--config', configPath, '--listTests', '--json'],
+    { cwd: root, stdio: ['ignore', 'pipe', 'pipe'] },
+  );
+  let stdout = '';
+  let stderr = '';
+  child.stdout.on('data', (c: Buffer) => (stdout += c.toString()));
+  child.stderr.on('data', (c: Buffer) => (stderr += c.toString()));
+  const code = await new Promise<number | null>((resolve) => child.on('close', resolve));
+  const json = stdout.slice(stdout.indexOf('['));
+  try {
+    return (JSON.parse(json) as string[]).sort();
+  } catch {
+    throw new Error(`mutator: jest --listTests failed (exit ${code})\n${stderr}`);
+  }
+}
+
+function escapeRegExp(s: string): string {
+  return s.replace(/[.*+?^${}()|[\]\\/]/g, '\\$&');
+}
+
+const SKIPPED = new Set(['pending', 'skipped', 'todo', 'disabled', 'focused']);
+
+/** Test ids with `#n` suffixes for duplicate full names, as the vitest session does. */
+function* identify(suite: SuiteResult, root: string): Generator<{ id: string; assertion: AssertionResult; coverageKey: string }> {
+  const rel = relative(root, suite.name);
+  const distinct = numberDuplicates();
+  const executed = numberDuplicates();
+  for (const assertion of suite.assertionResults) {
+    const id = distinct(`${rel}#${assertion.fullName}`);
+    // The setup hooks only see executed tests; their counter skips skipped ones.
+    const coverageKey = SKIPPED.has(assertion.status) ? assertion.fullName : executed(assertion.fullName);
+    yield { id, assertion, coverageKey };
+  }
+}
+
+function collectDryRun(report: JsonReport, coverageByFile: ReadonlyMap<string, FileCoverage>, root: string): DryRunResult {
+  const dry = emptyDryRun();
+  for (const suite of report.testResults) {
+    const rel = relative(root, suite.name);
+    const cov = coverageByFile.get(suite.name);
+    const fileStatic = new Set<string>();
+    dry.staticByFile.set(rel, fileStatic);
+    for (const key of Object.keys(cov?.static ?? {})) {
+      dry.staticKeys.add(key);
+      fileStatic.add(key);
+    }
+    for (const [key, n] of Object.entries(cov?.counts ?? {})) dry.hits.set(key, (dry.hits.get(key) ?? 0) + n);
+    if (suite.status === 'failed' && !suite.assertionResults.some((a) => a.status === 'failed')) dry.failed.push(rel);
+    const fingerprint = hash(readFileSync(suite.name, 'utf8'));
+    for (const { id, assertion, coverageKey } of identify(suite, root)) {
+      dry.index.set(id, { moduleId: suite.name, taskId: assertion.fullName });
+      if (SKIPPED.has(assertion.status)) continue;
+      if (assertion.status === 'failed') dry.failed.push(id);
+      const test: TestInfo = { id, fingerprint: hash(`${fingerprint}\0${id}`), durationMs: assertion.duration ?? 0 };
+      dry.tests.push(test);
+      const spawned = cov?.spawns?.[coverageKey];
+      if (spawned) (dry.spawns ??= new Map()).set(id, spawned);
+      for (const key of Object.keys(cov?.perTest[coverageKey] ?? {})) {
+        const covering = dry.coverage.get(key) ?? [];
+        covering.push(id);
+        dry.coverage.set(key, covering);
+      }
+    }
+  }
+  return dry;
+}
+
+function classify(report: JsonReport, root: string, selected: ReadonlySet<string>): Omit<MutantRunResult, 'durationMs'> {
+  const killedBy: string[] = [];
+  const messages: string[] = [];
+  let suiteError = false;
+  for (const suite of report.testResults) {
+    const failedTests = suite.assertionResults.some((a) => a.status === 'failed');
+    if (suite.status === 'failed' && !failedTests) {
+      suiteError = true;
+      killedBy.push(relative(root, suite.name));
+      messages.push(suite.message ?? '');
+    }
+    for (const { id, assertion } of identify(suite, root)) {
+      if (assertion.status !== 'failed' || !selected.has(id)) continue;
+      killedBy.push(id);
+      messages.push((assertion.failureMessages ?? []).join('\n'));
+    }
+  }
+  if (killedBy.length === 0) return { status: 'Survived', killedBy };
+  // The hit limit guards against endless loops: a run stopped only by it is a timeout.
+  if (messages.every((m) => m.includes(HIT_LIMIT_MESSAGE))) return { status: 'Timeout', killedBy: [] };
+  if (suiteError && killedBy.every((k) => !k.includes('#'))) return { status: 'RuntimeError', killedBy };
+  return { status: 'Killed', killedBy };
+}

package/src/setup.cjs

@@ -0,0 +1,14 @@
+'use strict';
+// Prepended to `setupFiles`: runs in each test file's environment before any
+// module under test, so static (module-level) mutants already see the active key.
+const limit = Number(process.env.MUTATOR_HIT_LIMIT);
+globalThis.__mutator__ = {
+  active: process.env.MUTATOR_ACTIVE || null,
+  // Coverage is only needed by the dry run; mutant runs skip the counters entirely.
+  collect: !process.env.MUTATOR_ACTIVE,
+  modules: [],
+  cov: { static: {}, perTest: {} },
+  testId: null,
+  hits: 0,
+  hitLimit: Number.isFinite(limit) && limit > 0 ? limit : Infinity,
+};

package/src/transformer.cjs

@@ -0,0 +1,115 @@
+'use strict';
+// Jest transformer wrapping the project's own transformer: target files are
+// instrumented with @mizchi/mutator-core first, then handed to the inner
+// transformer unchanged in module form (ESM stays ESM). Without an inner
+// transformer, TypeScript is stripped with Node's built-in type stripping.
+// CommonJS because Jest loads transformers with require.
+const { createHash } = require('node:crypto');
+const { stripTypeScriptTypes } = require('node:module');
+const { relative } = require('node:path');
+const { pathToFileURL } = require('node:url');
+
+const TS = /\.[cm]?tsx?$/;
+
+async function load(file) {
+  let mod;
+  try {
+    mod = require(file);
+  } catch (error) {
+    if (error && error.code !== 'ERR_REQUIRE_ESM' && error.code !== 'ERR_REQUIRE_ASYNC_MODULE') throw error;
+    mod = await import(pathToFileURL(file).href);
+  }
+  return mod;
+}
+
+function isTransformer(value) {
+  return value && (typeof value.process === 'function' || typeof value.processAsync === 'function' || typeof value.createTransformer === 'function');
+}
+
+async function loadInner(inner) {
+  if (!inner) return undefined;
+  const [file, options] = inner;
+  let mod = await load(file);
+  if (!isTransformer(mod) && isTransformer(mod && mod.default)) mod = mod.default;
+  if (!isTransformer(mod)) throw new Error(`mutator: ${file} is not a Jest transformer`);
+  return typeof mod.createTransformer === 'function' ? await mod.createTransformer(options) : mod;
+}
+
+/** Plugin modules (absolute paths) -> custom mutators and ignorers, like the CLI's loader. */
+async function loadPlugins(files) {
+  const mutators = [];
+  const ignorers = [];
+  const add = (value, origin) => {
+    if (Array.isArray(value)) return value.forEach((v) => add(v, origin));
+    if (value && typeof value.visit === 'function') return void mutators.push(value);
+    if (value && typeof value.shouldIgnore === 'function') return void ignorers.push(value);
+    if (value && typeof value.name === 'string') {
+      for (const m of value.mutators || []) add(m, origin);
+      for (const i of value.ignorers || []) add(i, origin);
+      return;
+    }
+    throw new Error(`mutator: plugin ${origin} has no plugin, mutator or ignorer as its default export`);
+  };
+  for (const file of files) {
+    const mod = await import(pathToFileURL(file).href);
+    add(mod.default ?? mod, file);
+  }
+  return { mutators, ignorers };
+}
+
+async function createTransformer(config) {
+  const { instrument } = await import('@mizchi/mutator-core');
+  const { mutators, ignorers } = await loadPlugins(config.pluginModules || []);
+  const inner = await loadInner(config.inner);
+  const targets = new Set(config.targets);
+  const instrumentOptions = {
+    ...(config.arid !== undefined ? { arid: config.arid } : {}),
+    ...(config.excludedMutators ? { excludedMutators: config.excludedMutators } : {}),
+    ...(mutators.length ? { mutators } : {}),
+    ...(ignorers.length ? { ignorers } : {}),
+  };
+  const innerOptions = (options) => ({ ...options, transformerConfig: config.inner ? config.inner[1] : {} });
+  const fingerprint = JSON.stringify({ ...config, targets: undefined });
+
+  const prepare = (source, file) => {
+    if (!targets.has(file)) return { code: source, map: undefined };
+    const result = instrument(file, source, { ...instrumentOptions, identity: relative(config.root, file) });
+    return { code: result.code, map: result.map };
+  };
+  const finish = (prepared, file) => {
+    if (!TS.test(file)) return prepared;
+    // Strip mode only blanks out types, so the instrumentation's sourcemap stays valid.
+    return { code: stripTypeScriptTypes(prepared.code, { mode: 'strip' }), map: prepared.map };
+  };
+  const cacheKey = (source, file, innerKey) =>
+    createHash('sha256')
+      .update([fingerprint, file, String(targets.has(file)), source, innerKey || ''].join('\0'))
+      .digest('hex');
+
+  return {
+    canInstrument: false,
+    getCacheKey(source, file, options) {
+      const innerKey = inner && typeof inner.getCacheKey === 'function' ? inner.getCacheKey(source, file, innerOptions(options)) : '';
+      return cacheKey(source, file, innerKey);
+    },
+    async getCacheKeyAsync(source, file, options) {
+      const get = inner && (inner.getCacheKeyAsync || inner.getCacheKey);
+      const innerKey = get ? await get.call(inner, source, file, innerOptions(options)) : '';
+      return cacheKey(source, file, innerKey);
+    },
+    process(source, file, options) {
+      const prepared = prepare(source, file);
+      if (!inner) return finish(prepared, file);
+      if (typeof inner.process !== 'function') throw new Error(`mutator: the transformer for ${file} only supports processAsync`);
+      return inner.process(prepared.code, file, innerOptions(options));
+    },
+    async processAsync(source, file, options) {
+      const prepared = prepare(source, file);
+      if (!inner) return finish(prepared, file);
+      const run = inner.processAsync || inner.process;
+      return run.call(inner, prepared.code, file, innerOptions(options));
+    },
+  };
+}
+
+module.exports = { createTransformer };

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.