@mutineerjs/mutineer 0.2.3 → 0.3.2

package/dist/runner/pool/pool-redirect-loader.mjs

@@ -1,146 +0,0 @@
-/**
- * Dynamic ESM loader for persistent Vitest workers.
- *
- * Unlike the fast runner's static loader (which reads env vars at startup),
- * this loader reads the redirect target from globalThis.__mutineer_redirect__
- * on each resolution, allowing dynamic changes during the worker's lifetime.
- *
- * This enables the worker to test multiple mutations without restarting.
- */
-
-import { register, builtinModules } from 'node:module'
-import { pathToFileURL, fileURLToPath } from 'node:url'
-import path from 'node:path'
-import fs from 'node:fs'
-
-// Register this file as the loader hooks module
-register(import.meta.url, {
-	parentURL: import.meta.url,
-	data: { debug: process.env.MUTINEER_DEBUG === '1' }
-})
-
-let DEBUG = process.env.MUTINEER_DEBUG === '1'
-
-export function initialize(data) {
-	if (data?.debug !== undefined) {
-		DEBUG = data.debug
-	}
-}
-
-/**
- * Try to resolve a .js import to a .ts file (TypeScript ESM convention)
- */
-function tryResolveTsExtension(specifier, parentURL) {
-	if (!specifier.endsWith('.js') || !specifier.startsWith('.')) {
-		return null
-	}
-
-	let parentPath
-	try {
-		parentPath = fileURLToPath(parentURL)
-	} catch {
-		return null
-	}
-	const parentDir = path.dirname(parentPath)
-
-	// If the parent is in a __mutineer__ directory, also try the parent's parent
-	const dirsToTry = [parentDir]
-	if (path.basename(parentDir) === '__mutineer__') {
-		dirsToTry.push(path.dirname(parentDir))
-	}
-
-	const tsSpecifier = specifier.slice(0, -3) + '.ts'
-	const tsxSpecifier = specifier.slice(0, -3) + '.tsx'
-
-	for (const dir of dirsToTry) {
-		const tsPath = path.resolve(dir, tsSpecifier)
-		if (fs.existsSync(tsPath)) {
-			return pathToFileURL(tsPath).href
-		}
-
-		const tsxPath = path.resolve(dir, tsxSpecifier)
-		if (fs.existsSync(tsxPath)) {
-			return pathToFileURL(tsxPath).href
-		}
-	}
-
-	return null
-}
-
-/**
- * Get the current redirect config from globalThis (set by the worker)
- */
-function getRedirect() {
-	const redirect = globalThis.__mutineer_redirect__
-	if (!redirect?.from || !redirect?.to) {
-		return null
-	}
-	return {
-		from: path.resolve(redirect.from),
-		fromUrl: pathToFileURL(path.resolve(redirect.from)).href,
-		to: redirect.to,
-	}
-}
-
-export async function resolve(specifier, context, nextResolve) {
-	const redirect = getRedirect()
-	const isBuiltin = specifier.startsWith('node:') || builtinModules.includes(specifier)
-	const isNodeModulesSpec = specifier.includes('node_modules')
-
-	const shouldLog = DEBUG && !isBuiltin && !isNodeModulesSpec
-
-	if (shouldLog) {
-		console.error(`[pool-loader] resolve: ${specifier}`)
-		if (redirect) {
-			console.error(`[pool-loader] active redirect: ${redirect.from} -> ${redirect.to}`)
-		}
-	}
-
-	// Try to resolve .js -> .ts for TypeScript ESM imports
-	const tsResolved = tryResolveTsExtension(specifier, context.parentURL)
-	if (tsResolved) {
-		if (DEBUG) console.error(`[pool-loader] .js -> .ts: ${specifier} -> ${tsResolved}`)
-
-		// Check if this is our redirect target
-		if (redirect && tsResolved === redirect.fromUrl) {
-			if (DEBUG) console.error(`[pool-loader] REDIRECTING ${tsResolved} -> ${pathToFileURL(redirect.to).href}`)
-			return {
-				url: pathToFileURL(redirect.to).href,
-				shortCircuit: true
-			}
-		}
-
-		return {
-			url: tsResolved,
-			shortCircuit: true
-		}
-	}
-
-	// Let the default resolver handle it
-	let resolved
-	try {
-		resolved = await nextResolve(specifier, context)
-	} catch (e) {
-		throw e
-	}
-
-	const resolvedInNodeModules = resolved?.url?.includes('/node_modules/')
-	const resolvedBuiltin = resolved?.url?.startsWith('node:')
-	if (shouldLog && !resolvedInNodeModules && !resolvedBuiltin) console.error(`[pool-loader] resolved ${specifier} to ${resolved.url}`)
-
-	// Check if this resolves to our redirect target
-	if (redirect && resolved.url === redirect.fromUrl) {
-		if (DEBUG) console.error(`[pool-loader] REDIRECTING ${resolved.url} -> ${pathToFileURL(redirect.to).href}`)
-		return {
-			...resolved,
-			url: pathToFileURL(redirect.to).href,
-			shortCircuit: true
-		}
-	}
-
-	return resolved
-}
-
-export async function load(url, context, nextLoad) {
-	return nextLoad(url, context)
-}

package/dist/runner/pool/redirect-loader.d.ts

@@ -1,19 +0,0 @@
-/**
- * Dynamic ESM loader for persistent Vitest workers.
- *
- * Reads redirect targets from globalThis.__mutineer_redirect__ on each resolution
- * so workers can swap files without restarting.
- */
-declare global {
-    var __mutineer_redirect__: {
-        from: string | null;
-        to: string | null;
-    } | undefined;
-}
-export declare function initialize(data: {
-    debug?: boolean;
-} | undefined): void;
-export declare function resolve(specifier: string, context: {
-    parentURL?: string;
-}, nextResolve: (specifier: string, context: any) => Promise<any>): Promise<any>;
-export declare function load(url: string, context: unknown, nextLoad: (u: string, c: unknown) => Promise<unknown>): Promise<unknown>;

package/dist/runner/pool/redirect-loader.js

@@ -1,116 +0,0 @@
-/**
- * Dynamic ESM loader for persistent Vitest workers.
- *
- * Reads redirect targets from globalThis.__mutineer_redirect__ on each resolution
- * so workers can swap files without restarting.
- */
-import { register, builtinModules } from 'node:module';
-import { pathToFileURL, fileURLToPath } from 'node:url';
-import path from 'node:path';
-import fs from 'node:fs';
-// Register this file as the loader hooks module
-register(import.meta.url, {
-    parentURL: import.meta.url,
-    data: { debug: process.env.MUTINEER_DEBUG === '1' }
-});
-let DEBUG = process.env.MUTINEER_DEBUG === '1';
-export function initialize(data) {
-    if (data?.debug !== undefined) {
-        DEBUG = data.debug;
-    }
-}
-/**
- * Try to resolve a .js import to a .ts or .tsx file (TypeScript ESM convention)
- */
-function tryResolveTsExtension(specifier, parentURL) {
-    if (!specifier.endsWith('.js') || !specifier.startsWith('.')) {
-        return null;
-    }
-    let parentPath;
-    try {
-        parentPath = fileURLToPath(parentURL ?? '');
-    }
-    catch {
-        return null;
-    }
-    const parentDir = path.dirname(parentPath);
-    // If the parent is in a __mutineer__ directory, also try the parent's parent
-    const dirsToTry = [parentDir];
-    if (path.basename(parentDir) === '__mutineer__') {
-        dirsToTry.push(path.dirname(parentDir));
-    }
-    const tsSpecifier = specifier.slice(0, -3) + '.ts';
-    const tsxSpecifier = specifier.slice(0, -3) + '.tsx';
-    for (const dir of dirsToTry) {
-        const tsPath = path.resolve(dir, tsSpecifier);
-        if (fs.existsSync(tsPath)) {
-            return pathToFileURL(tsPath).href;
-        }
-        const tsxPath = path.resolve(dir, tsxSpecifier);
-        if (fs.existsSync(tsxPath)) {
-            return pathToFileURL(tsxPath).href;
-        }
-    }
-    return null;
-}
-function getRedirect() {
-    const redirect = globalThis.__mutineer_redirect__;
-    if (!redirect?.from || !redirect?.to) {
-        return null;
-    }
-    return {
-        from: path.resolve(redirect.from),
-        fromUrl: pathToFileURL(path.resolve(redirect.from)).href,
-        to: redirect.to,
-    };
-}
-export async function resolve(specifier, context, nextResolve) {
-    const redirect = getRedirect();
-    const isBuiltin = specifier.startsWith('node:') || builtinModules.includes(specifier);
-    const isNodeModulesSpec = specifier.includes('node_modules');
-    const shouldLog = DEBUG && !isBuiltin && !isNodeModulesSpec;
-    if (shouldLog) {
-        console.error(`[pool-loader] resolve: ${specifier}`);
-        if (redirect) {
-            console.error(`[pool-loader] active redirect: ${redirect.from} -> ${redirect.to}`);
-        }
-    }
-    // Try to resolve .js -> .ts for TypeScript ESM imports
-    const tsResolved = tryResolveTsExtension(specifier, context.parentURL);
-    if (tsResolved) {
-        if (shouldLog)
-            console.error(`[pool-loader] .js -> .ts: ${specifier} -> ${tsResolved}`);
-        // Check if this is our redirect target
-        if (redirect && tsResolved === redirect.fromUrl) {
-            if (DEBUG)
-                console.error(`[pool-loader] REDIRECTING ${tsResolved} -> ${pathToFileURL(redirect.to).href}`);
-            return {
-                url: pathToFileURL(redirect.to).href,
-                shortCircuit: true
-            };
-        }
-        return {
-            url: tsResolved,
-            shortCircuit: true
-        };
-    }
-    const resolved = await nextResolve(specifier, context);
-    const resolvedInNodeModules = resolved?.url?.includes('/node_modules/');
-    const resolvedBuiltin = resolved?.url?.startsWith('node:');
-    if (shouldLog && !resolvedInNodeModules && !resolvedBuiltin)
-        console.error(`[pool-loader] resolved ${specifier} to ${resolved.url}`);
-    // Check if this resolves to our redirect target
-    if (redirect && resolved.url === redirect.fromUrl) {
-        if (DEBUG)
-            console.error(`[pool-loader] REDIRECTING ${resolved.url} -> ${pathToFileURL(redirect.to).href}`);
-        return {
-            ...resolved,
-            url: pathToFileURL(redirect.to).href,
-            shortCircuit: true
-        };
-    }
-    return resolved;
-}
-export async function load(url, context, nextLoad) {
-    return nextLoad(url, context);
-}

package/dist/runner/pool/vitest/pool.d.ts

@@ -1,70 +0,0 @@
-/**
- * Vitest Worker Pool
- *
- * Manages a pool of persistent Vitest worker processes that can run
- * multiple mutations without restarting, providing significant speedup
- * over the per-spawn approach.
- *
- * Each worker:
- * - Starts Vitest in watch mode via programmatic API
- * - Receives mutations via stdin (JSON)
- * - Uses dynamic redirect loader to swap module at runtime
- * - Returns results via stdout (JSON)
- */
-import { EventEmitter } from 'node:events';
-import type { MutantPayload, MutantRunResult, MutantRunSummary } from '../../../types/mutant.js';
-declare class VitestWorker extends EventEmitter {
-    private readonly cwd;
-    private readonly vitestConfig?;
-    private readonly debug;
-    readonly id: string;
-    private process;
-    private rl;
-    private pendingTask;
-    private ready;
-    private shuttingDown;
-    constructor(id: string, cwd: string, vitestConfig?: string | undefined, debug?: boolean);
-    start(): Promise<void>;
-    private handleMessage;
-    private handleExit;
-    isReady(): boolean;
-    isBusy(): boolean;
-    run(mutant: MutantPayload, tests: string[], timeoutMs?: number): Promise<MutantRunSummary>;
-    shutdown(): Promise<void>;
-    kill(): void;
-    private log;
-}
-export interface VitestPoolOptions {
-    cwd: string;
-    concurrency: number;
-    vitestConfig?: string;
-    timeoutMs?: number;
-    debug?: boolean;
-    createWorker?: (id: string, opts: {
-        cwd: string;
-        vitestConfig?: string;
-        debug: boolean;
-    }) => VitestWorker;
-}
-export declare class VitestPool {
-    private workers;
-    private availableWorkers;
-    private waitingTasks;
-    private readonly options;
-    private initialized;
-    private shuttingDown;
-    constructor(options: VitestPoolOptions);
-    init(): Promise<void>;
-    private handleWorkerExit;
-    private acquireWorker;
-    private releaseWorker;
-    run(mutant: MutantPayload, tests: string[]): Promise<MutantRunSummary>;
-    shutdown(): Promise<void>;
-    private log;
-}
-/**
- * Run a single mutation using the pool.
- * Convenience function for integration with orchestrator.
- */
-export declare function runWithPool(pool: VitestPool, mutant: MutantPayload, tests: readonly string[]): Promise<MutantRunResult>;
-export type { MutantPayload, MutantRunResult, MutantRunSummary } from '../../../types/mutant.js';