@paraharness/git 0.0.0-stage → 0.2.0

package/dist/executors/internal/git-cli-runner.js

@@ -0,0 +1,157 @@
+import { spawn } from 'node:child_process';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { withFileLock } from '@paraharness/lockfile';
+import writeFileAtomic from 'write-file-atomic';
+import { HarnessMetaSchema, } from '../../schemas/git-receipts.schema.js';
+import { HARNESS_GIT_IDENTITY_ENV } from './git-executor.constants.js';
+/**
+ * Constructs the isolated environment map for git and subprocess invocations inside a worktree.
+ *
+ * Sets `GIT_CEILING_DIRECTORIES=<dirname(worktreePath)>`, `GIT_CONFIG_NOSYSTEM=1`, `GIT_OPTIONAL_LOCKS=0`,
+ * disables GPG signing, and forces `core.hooksPath=/dev/null` per `SPEC.md` §4.4.
+ *
+ * @param {string}                                       worktreePath - Worktree directory path.
+ * @param {Readonly<Record<string, string | undefined>>} [extraEnv]   - Optional overrides merged on top.
+ *
+ * @returns {Readonly<Record<string, string>>} Frozen environment map for subprocess execution.
+ */
+export function buildIsolatedWorktreeGitEnv(worktreePath, extraEnv) {
+    const env = {};
+    for (const [key, value] of Object.entries(process.env)) {
+        if (value !== undefined)
+            env[key] = value;
+    }
+    Object.assign(env, HARNESS_GIT_IDENTITY_ENV, {
+        GIT_CEILING_DIRECTORIES: path.dirname(path.resolve(worktreePath)),
+        GIT_CONFIG_NOSYSTEM: '1',
+        GIT_OPTIONAL_LOCKS: '0',
+        GIT_TERMINAL_PROMPT: '0',
+        GIT_CONFIG_COUNT: '2',
+        GIT_CONFIG_KEY_0: 'commit.gpgsign',
+        GIT_CONFIG_VALUE_0: 'false',
+        GIT_CONFIG_KEY_1: 'core.hooksPath',
+        GIT_CONFIG_VALUE_1: '/dev/null',
+    });
+    if (extraEnv !== undefined) {
+        for (const [key, value] of Object.entries(extraEnv)) {
+            if (value !== undefined)
+                env[key] = value;
+        }
+    }
+    return Object.freeze(env);
+}
+/**
+ * Spawns a `git` CLI command inside `options.cwd` with isolated worktree environment settings.
+ *
+ * Pipes optional `stdin`, captures `stdoutBuffer` and `stderr`, cleans up `AbortSignal` listeners,
+ * and throws an actionable diagnostic `Error` when `exitCode !== 0` unless `allowNonZeroExit` is set.
+ *
+ * @param {GitCliCommandOptions} options - Command execution options.
+ *
+ * @returns {Promise<GitCliCommandResult>} Resolved exit code, decoded output strings, and raw stdout buffer.
+ *
+ * @throws {Error} If the `git` process exits non-zero and `allowNonZeroExit` is not `true`.
+ */
+export async function runGitCommand(options) {
+    options.signal?.throwIfAborted();
+    const env = buildIsolatedWorktreeGitEnv(options.cwd, options.env);
+    return new Promise((resolve, reject) => {
+        const child = spawn('git', [...options.args], { cwd: options.cwd, env, stdio: 'pipe' });
+        const stdoutChunks = [];
+        const stderrChunks = [];
+        const onAbort = () => {
+            child.kill('SIGTERM');
+        };
+        options.signal?.addEventListener('abort', onAbort, { once: true });
+        child.stdout.on('data', (chunk) => stdoutChunks.push(chunk));
+        child.stderr.on('data', (chunk) => stderrChunks.push(chunk));
+        child.on('error', (err) => {
+            options.signal?.removeEventListener('abort', onAbort);
+            reject(err);
+        });
+        child.on('close', (code) => {
+            options.signal?.removeEventListener('abort', onAbort);
+            const exitCode = code ?? 1;
+            const stdoutBuffer = Buffer.concat(stdoutChunks);
+            const stdout = stdoutBuffer.toString('utf8');
+            const stderr = Buffer.concat(stderrChunks).toString('utf8');
+            if (exitCode !== 0 && !options.allowNonZeroExit) {
+                reject(new Error(`git ${options.args.join(' ')} failed in '${options.cwd}' (exit ${exitCode}): ${stderr.trim() || stdout.trim()}`));
+                return;
+            }
+            resolve({ exitCode, stdout, stderr, stdoutBuffer });
+        });
+        if (options.stdin !== undefined)
+            child.stdin.end(options.stdin);
+        else
+            child.stdin.end();
+    });
+}
+/**
+ * Reads and validates `<gitDirPath>/harness-meta.json` using `HarnessMetaSchema`.
+ *
+ * Parses the persisted worktree lineage, unresolved conflict digests, and in-flight crash-recovery markers.
+ *
+ * @param {string} gitDirPath - Path to the worktree's isolated `<gitdir>` metadata directory.
+ *
+ * @returns {Promise<HarnessMetaRecord>} Validated `HarnessMetaRecord` object.
+ */
+export async function readHarnessMeta(gitDirPath) {
+    const metaPath = path.join(gitDirPath, 'harness-meta.json');
+    const rawJson = await readFile(metaPath, 'utf8');
+    return HarnessMetaSchema.parse(JSON.parse(rawJson));
+}
+/**
+ * Atomically writes and validates `<gitDirPath>/harness-meta.json` under a cross-process file lock.
+ *
+ * Acquires `<gitDirPath>/harness-meta.json.lock` via `withFileLock` and persists the validated JSON via `writeFileAtomic`.
+ *
+ * @param {string}            gitDirPath - Path to the worktree's isolated `<gitdir>` metadata directory.
+ * @param {HarnessMetaRecord} meta       - Metadata record to persist.
+ *
+ * @returns {Promise<void>} Resolves once `harness-meta.json` is durably updated.
+ */
+export async function writeHarnessMeta(gitDirPath, meta) {
+    const validated = HarnessMetaSchema.parse(meta);
+    const metaPath = path.join(gitDirPath, 'harness-meta.json');
+    const lockPath = path.join(gitDirPath, 'harness-meta.json.lock');
+    await withFileLock(lockPath, async () => {
+        await writeFileAtomic(metaPath, JSON.stringify(validated, null, 2), { encoding: 'utf8' });
+    });
+}
+/**
+ * Updates mutable `GitWorktreeHandle` properties in place when the caller passed a non-frozen handle.
+ *
+ * Avoids throwing `TypeError` when a caller passes a frozen `GitWorktreeHandle` fixture without
+ * using empty `try / catch` blocks.
+ *
+ * @param {GitWorktreeHandle}          handle - Target worktree handle to update.
+ * @param {Partial<GitWorktreeHandle>} patch  - Partial property updates to assign onto `handle`.
+ */
+export function updateWorktreeHandleInPlace(handle, patch) {
+    if (!Object.isFrozen(handle)) {
+        Object.assign(handle, patch);
+    }
+}
+/**
+ * Executes a host-repository worktree administrative operation (`worktree prune`, `worktree add`, `worktree remove`)
+ * under `<commonGitDir>/harness-worktree.lock` to prevent concurrent `git worktree` administrative races.
+ *
+ * @template T Result type returned by `fn`.
+ *
+ * @param {string}          cwd - Working directory inside the host repository or an attached worktree.
+ * @param {() => Promise<T>} fn  - Async callback performing `git worktree` administrative commands.
+ *
+ * @returns {Promise<T>} Result produced by `fn`.
+ */
+export async function withHostWorktreeLock(cwd, fn) {
+    const commonDirResult = await runGitCommand({
+        cwd,
+        args: ['rev-parse', '--git-common-dir'],
+    });
+    const commonGitDir = path.resolve(cwd, commonDirResult.stdout.trim());
+    const lockPath = path.join(commonGitDir, 'harness-worktree.lock');
+    return withFileLock(lockPath, fn);
+}
+//# sourceMappingURL=git-cli-runner.js.map

package/dist/executors/internal/git-cli-runner.js.map

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

package/dist/executors/internal/git-cross-test-import-scanner.d.ts

@@ -0,0 +1,68 @@
+import type { CrossVerifierBranchCandidate, GitPublicSurfaceCrossTesterNode, GitWorktreeHandle, StepExecutionContext } from '@paraharness/core';
+/**
+ * Extracts and normalizes relative module import paths from a test file's source text using `es-module-lexer`.
+ *
+ * Resolves `./` and `../` specifiers relative to `testFileRelPath` while ignoring fake imports in comments or string literals.
+ *
+ * @param {string} sourceCode      - Raw UTF-8 test file contents.
+ * @param {string} testFileRelPath - Posix-normalized repository-relative path of the test file.
+ *
+ * @returns {Promise<readonly string[]>} Normalized repository-relative imported file paths.
+ */
+export declare function extractRelativeImports(sourceCode: string, testFileRelPath: string): Promise<readonly string[]>;
+/**
+ * Pre-compiles all boundary glob patterns from `node.partitionMap` into a single predicate function.
+ *
+ * @param {GitPublicSurfaceCrossTesterNode<unknown>} node - Public-surface cross-tester AST node.
+ *
+ * @returns {(candidatePath: string) => boolean} Predicate returning `true` when `candidatePath` matches a public boundary glob.
+ */
+export declare function compileBoundaryGlobMatcher(node: GitPublicSurfaceCrossTesterNode<unknown>): (candidatePath: string) => boolean;
+/**
+ * Collects newly added or modified test files in `candidate` that import exclusively from `isBoundaryPath`.
+ *
+ * Inspects `git diff --name-only <baseRef> <headRef>` for test files and verifies their relative imports.
+ *
+ * @param {CrossVerifierBranchCandidate<GitWorktreeHandle>} candidate      - Speculative candidate descriptor.
+ * @param {(candidatePath: string) => boolean}              isBoundaryPath - Compiled boundary glob matcher.
+ *
+ * @returns {Promise<ReadonlyMap<string, string>>} Map of boundary-only test relative paths to their file contents.
+ */
+export declare function collectCandidateBoundaryTests(candidate: CrossVerifierBranchCandidate<GitWorktreeHandle>, isBoundaryPath: (candidatePath: string) => boolean): Promise<ReadonlyMap<string, string>>;
+/**
+ * Transplants `testsToRun` into `target` inside a checkpoint sandbox and executes each test file.
+ *
+ * Restores `target.scopeHandle` to its pre-test checkpoint in a `finally` block.
+ *
+ * @param {CrossVerifierBranchCandidate<GitWorktreeHandle>} target     - Target candidate branch receiving tests.
+ * @param {ReadonlyMap<string, string>}                     testsToRun - Boundary test files mapped to source content.
+ * @param {AbortSignal}                                     [signal]   - Optional cancellation signal forwarded to child processes.
+ *
+ * @returns {Promise<Record<string, unknown>>} Cross-test report for `target`.
+ */
+export declare function runTransplantedTestsOnTarget(target: CrossVerifierBranchCandidate<GitWorktreeHandle>, testsToRun: ReadonlyMap<string, string>, signal?: AbortSignal): Promise<Record<string, unknown>>;
+/**
+ * Executes cross-verification of public-surface tests across all speculative `candidates`.
+ *
+ * Collects boundary-only tests from each candidate and transplants them into every sibling candidate.
+ *
+ * @param {GitPublicSurfaceCrossTesterNode<unknown>}                       node       - Public-surface cross-tester AST node.
+ * @param {ReadonlyArray<CrossVerifierBranchCandidate<GitWorktreeHandle>>} candidates - Surviving speculative candidate branches.
+ * @param {AbortSignal}                                                    [signal]   - Optional cancellation signal forwarded to child processes.
+ *
+ * @returns {Promise<Readonly<Record<number, unknown>>>} Validated per-branch cross-testing report indexed by `branchIndex`.
+ */
+export declare function runPublicSurfaceCrossVerification(node: GitPublicSurfaceCrossTesterNode<unknown>, candidates: ReadonlyArray<CrossVerifierBranchCandidate<GitWorktreeHandle>>, signal?: AbortSignal): Promise<Readonly<Record<number, unknown>>>;
+/**
+ * Runs an arbitrary benchmark or evaluation command inside `candidateHandle` wrapped in a checkpoint rollback.
+ *
+ * Guarantees `candidateHandle` remains bit-for-bit identical after `command` finishes.
+ *
+ * @param {GitWorktreeHandle}                       candidateHandle - Target candidate worktree handle.
+ * @param {string | readonly string[]}              command         - Shell command string or argv tuple to execute.
+ * @param {StepExecutionContext<GitWorktreeHandle>} ctx             - Active step execution context.
+ *
+ * @returns {Promise<Record<string, unknown>>} Command execution result `{ exitCode, stdout, stderr }`.
+ */
+export declare function runEvalCommandInSandboxedCandidate(candidateHandle: GitWorktreeHandle, command: string | readonly string[], ctx: StepExecutionContext<GitWorktreeHandle>): Promise<Record<string, unknown>>;
+//# sourceMappingURL=git-cross-test-import-scanner.d.ts.map

package/dist/executors/internal/git-cross-test-import-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-cross-test-import-scanner.d.ts","sourceRoot":"","sources":["../../../src/executors/internal/git-cross-test-import-scanner.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,4BAA4B,EAC5B,+BAA+B,EAC/B,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAU3B;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAkB5B;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,+BAA+B,CAAC,OAAO,CAAC,GAC7C,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAWpC;AAED;;;;;;;;;GASG;AACH,wBAAsB,6BAA6B,CACjD,SAAS,EAAE,4BAA4B,CAAC,iBAAiB,CAAC,EAC1D,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,GACjD,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAsBtC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,4BAA4B,CAAC,iBAAiB,CAAC,EACvD,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EACvC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAkClC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iCAAiC,CACrD,IAAI,EAAE,+BAA+B,CAAC,OAAO,CAAC,EAC9C,UAAU,EAAE,aAAa,CAAC,4BAA4B,CAAC,iBAAiB,CAAC,CAAC,EAC1E,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAiB5C;AAiBD;;;;;;;;;;GAUG;AACH,wBAAsB,kCAAkC,CACtD,eAAe,EAAE,iBAAiB,EAClC,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EACnC,GAAG,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,GAC3C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAsBlC"}

package/dist/executors/internal/git-cross-test-import-scanner.js

@@ -0,0 +1,226 @@
+import { execFile } from 'node:child_process';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { stripTypeScriptTypes } from 'node:module';
+import path from 'node:path';
+import { init, parse } from 'es-module-lexer';
+import picomatch from 'picomatch';
+import { gitCheckpointRestore } from './git-checkpoint-restore.js';
+import { gitCheckpointSerialize } from './git-checkpoint-serialize.js';
+import { buildIsolatedWorktreeGitEnv, runGitCommand, } from './git-cli-runner.js';
+/**
+ * Extracts and normalizes relative module import paths from a test file's source text using `es-module-lexer`.
+ *
+ * Resolves `./` and `../` specifiers relative to `testFileRelPath` while ignoring fake imports in comments or string literals.
+ *
+ * @param {string} sourceCode      - Raw UTF-8 test file contents.
+ * @param {string} testFileRelPath - Posix-normalized repository-relative path of the test file.
+ *
+ * @returns {Promise<readonly string[]>} Normalized repository-relative imported file paths.
+ */
+export async function extractRelativeImports(sourceCode, testFileRelPath) {
+    await init();
+    let imports;
+    try {
+        [imports] = parse(sourceCode, testFileRelPath);
+    }
+    catch {
+        const stripped = stripTypeScriptTypes(sourceCode, { mode: 'strip' });
+        [imports] = parse(stripped, testFileRelPath);
+    }
+    const dir = path.posix.dirname(testFileRelPath);
+    const resolvedPaths = [];
+    for (const imp of imports) {
+        const specifier = imp.specifier;
+        if (typeof specifier === 'string' && specifier.startsWith('.')) {
+            resolvedPaths.push(path.posix.normalize(path.posix.join(dir, specifier)));
+        }
+    }
+    return Object.freeze(resolvedPaths);
+}
+/**
+ * Pre-compiles all boundary glob patterns from `node.partitionMap` into a single predicate function.
+ *
+ * @param {GitPublicSurfaceCrossTesterNode<unknown>} node - Public-surface cross-tester AST node.
+ *
+ * @returns {(candidatePath: string) => boolean} Predicate returning `true` when `candidatePath` matches a public boundary glob.
+ */
+export function compileBoundaryGlobMatcher(node) {
+    const matchers = [];
+    for (const part of Object.values(node.partitionMap.mapping)) {
+        for (const glob of part.boundaryGlobs)
+            matchers.push(picomatch(glob, { dot: true }));
+    }
+    return (candidatePath) => {
+        for (const isMatch of matchers) {
+            if (isMatch(candidatePath))
+                return true;
+        }
+        return false;
+    };
+}
+/**
+ * Collects newly added or modified test files in `candidate` that import exclusively from `isBoundaryPath`.
+ *
+ * Inspects `git diff --name-only <baseRef> <headRef>` for test files and verifies their relative imports.
+ *
+ * @param {CrossVerifierBranchCandidate<GitWorktreeHandle>} candidate      - Speculative candidate descriptor.
+ * @param {(candidatePath: string) => boolean}              isBoundaryPath - Compiled boundary glob matcher.
+ *
+ * @returns {Promise<ReadonlyMap<string, string>>} Map of boundary-only test relative paths to their file contents.
+ */
+export async function collectCandidateBoundaryTests(candidate, isBoundaryPath) {
+    const cwd = candidate.scopeHandle.worktreePath;
+    const headSha = typeof candidate.scopeReceipt['headRef'] === 'string'
+        ? candidate.scopeReceipt['headRef']
+        : (candidate.scopeHandle.headRef ?? candidate.scopeHandle.baseRef);
+    const diffOutput = await runGitCommand({
+        cwd,
+        args: ['diff', '--name-only', '--diff-filter=AM', candidate.scopeHandle.baseRef, headSha],
+        allowNonZeroExit: true,
+    });
+    const boundaryTests = new Map();
+    for (const rawLine of diffOutput.stdout.split('\n')) {
+        const relPath = rawLine.trim();
+        if (relPath.length === 0 || !/(?:\.test\.|\.spec\.|^test\/|\/test\/)/.test(relPath))
+            continue;
+        const content = await readFile(path.join(cwd, relPath), 'utf8').catch(() => undefined);
+        if (content === undefined)
+            continue;
+        const imports = await extractRelativeImports(content, relPath);
+        const allBoundary = imports.length > 0 && imports.every((imp) => isBoundaryPath(imp) || isBoundaryPath(imp.replace(/\.js$/, '.ts')) || isBoundaryPath(`${imp}/index.ts`));
+        if (allBoundary)
+            boundaryTests.set(relPath, content);
+    }
+    return boundaryTests;
+}
+/**
+ * Transplants `testsToRun` into `target` inside a checkpoint sandbox and executes each test file.
+ *
+ * Restores `target.scopeHandle` to its pre-test checkpoint in a `finally` block.
+ *
+ * @param {CrossVerifierBranchCandidate<GitWorktreeHandle>} target     - Target candidate branch receiving tests.
+ * @param {ReadonlyMap<string, string>}                     testsToRun - Boundary test files mapped to source content.
+ * @param {AbortSignal}                                     [signal]   - Optional cancellation signal forwarded to child processes.
+ *
+ * @returns {Promise<Record<string, unknown>>} Cross-test report for `target`.
+ */
+export async function runTransplantedTestsOnTarget(target, testsToRun, signal) {
+    if (testsToRun.size === 0) {
+        return { passedCrossTests: 0, failedCrossTests: 0, crossTestDeficits: [], transplantedTestFiles: [] };
+    }
+    const handle = target.scopeHandle;
+    const ckpt = await gitCheckpointSerialize(handle);
+    let passedCrossTests = 0;
+    let failedCrossTests = 0;
+    const crossTestDeficits = [];
+    const transplantedTestFiles = [];
+    try {
+        for (const [relPath, content] of testsToRun) {
+            signal?.throwIfAborted();
+            transplantedTestFiles.push(relPath);
+            const absPath = path.join(handle.worktreePath, relPath);
+            await mkdir(path.dirname(absPath), { recursive: true });
+            await writeFile(absPath, content, 'utf8');
+            const nodeArgs = relPath.endsWith('.ts') ? ['--experimental-strip-types', absPath] : [absPath];
+            const env = buildIsolatedWorktreeGitEnv(handle.worktreePath);
+            const errMsg = await new Promise((resolve) => {
+                execFile(process.execPath, nodeArgs, { cwd: handle.worktreePath, env, signal }, (err, stdout, stderr) => {
+                    resolve(err === null ? undefined : (stderr || stdout || err.message).trim());
+                });
+            });
+            if (errMsg === undefined)
+                passedCrossTests += 1;
+            else {
+                failedCrossTests += 1;
+                crossTestDeficits.push(`${relPath}: ${errMsg}`);
+            }
+        }
+    }
+    finally {
+        await gitCheckpointRestore(handle, ckpt);
+    }
+    return { passedCrossTests, failedCrossTests, crossTestDeficits, transplantedTestFiles };
+}
+/**
+ * Executes cross-verification of public-surface tests across all speculative `candidates`.
+ *
+ * Collects boundary-only tests from each candidate and transplants them into every sibling candidate.
+ *
+ * @param {GitPublicSurfaceCrossTesterNode<unknown>}                       node       - Public-surface cross-tester AST node.
+ * @param {ReadonlyArray<CrossVerifierBranchCandidate<GitWorktreeHandle>>} candidates - Surviving speculative candidate branches.
+ * @param {AbortSignal}                                                    [signal]   - Optional cancellation signal forwarded to child processes.
+ *
+ * @returns {Promise<Readonly<Record<number, unknown>>>} Validated per-branch cross-testing report indexed by `branchIndex`.
+ */
+export async function runPublicSurfaceCrossVerification(node, candidates, signal) {
+    const isBoundaryPath = compileBoundaryGlobMatcher(node);
+    const testsByBranch = new Map();
+    for (const cand of candidates) {
+        testsByBranch.set(cand.branchIndex, await collectCandidateBoundaryTests(cand, isBoundaryPath));
+    }
+    const reports = {};
+    for (const target of candidates) {
+        const mergedTests = new Map();
+        for (const [sourceIdx, testMap] of testsByBranch) {
+            if (sourceIdx === target.branchIndex)
+                continue;
+            for (const [relPath, content] of testMap)
+                mergedTests.set(relPath, content);
+        }
+        const rawReport = await runTransplantedTestsOnTarget(target, mergedTests, signal);
+        reports[target.branchIndex] = node.reportSchema.parse(rawReport);
+    }
+    return Object.freeze(reports);
+}
+/**
+ * Resolves a numeric process exit code from an `execFile` error callback argument.
+ *
+ * @param {ExecFileException | null} execError - Error object from `execFile`, or `null` on exit `0`.
+ *
+ * @returns {number} Numeric exit code (`0` on success, `execError.code` when numeric, or `1`).
+ */
+function resolveExecFileExitCode(execError) {
+    if (execError === null)
+        return 0;
+    if (typeof execError.code === 'number')
+        return execError.code;
+    return 1;
+}
+/**
+ * Runs an arbitrary benchmark or evaluation command inside `candidateHandle` wrapped in a checkpoint rollback.
+ *
+ * Guarantees `candidateHandle` remains bit-for-bit identical after `command` finishes.
+ *
+ * @param {GitWorktreeHandle}                       candidateHandle - Target candidate worktree handle.
+ * @param {string | readonly string[]}              command         - Shell command string or argv tuple to execute.
+ * @param {StepExecutionContext<GitWorktreeHandle>} ctx             - Active step execution context.
+ *
+ * @returns {Promise<Record<string, unknown>>} Command execution result `{ exitCode, stdout, stderr }`.
+ */
+export async function runEvalCommandInSandboxedCandidate(candidateHandle, command, ctx) {
+    const scope = ctx.scope !== undefined && 'serializeCheckpoint' in ctx.scope && 'restoreCheckpoint' in ctx.scope
+        ? ctx.scope
+        : undefined;
+    const ckpt = scope !== undefined
+        ? await scope.serializeCheckpoint(candidateHandle)
+        : await gitCheckpointSerialize(candidateHandle);
+    try {
+        const cwd = candidateHandle.worktreePath;
+        const env = buildIsolatedWorktreeGitEnv(cwd);
+        const bin = typeof command === 'string' ? 'sh' : (command[0] ?? 'true');
+        const args = typeof command === 'string' ? ['-c', command] : command.slice(1);
+        return await new Promise((resolve) => {
+            execFile(bin, args, { cwd, env, signal: ctx.signal }, (err, stdout, stderr) => {
+                const exitCode = resolveExecFileExitCode(err);
+                resolve({ exitCode, stdout, stderr });
+            });
+        });
+    }
+    finally {
+        if (scope !== undefined)
+            await scope.restoreCheckpoint(candidateHandle, ckpt);
+        else
+            await gitCheckpointRestore(candidateHandle, ckpt);
+    }
+}
+//# sourceMappingURL=git-cross-test-import-scanner.js.map

package/dist/executors/internal/git-cross-test-import-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-cross-test-import-scanner.js","sourceRoot":"","sources":["../../../src/executors/internal/git-cross-test-import-scanner.ts"],"names":[],"mappings":"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"}

package/dist/executors/internal/git-executor.constants.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Default maximum file size in bytes (1 MiB) for untracked files staged directly into temporary git index checkpoints.
+ */
+export declare const DEFAULT_MAX_UNTRACKED_FILE_SIZE_BYTES = 1048576;
+/**
+ * Implicit glob patterns always excluded from clones and checkpoints when `repo` is `'.'`.
+ */
+export declare const IMPLICIT_REPO_EXCLUDE_GLOBS: readonly string[];
+/**
+ * Regular expression matching the opening `<<<<<<< ` conflict marker line.
+ */
+export declare const CONFLICT_START_REGEX: RegExp;
+/**
+ * Regular expression matching the middle `=======` conflict separator line (`^={7}( |$)`).
+ */
+export declare const CONFLICT_SEP_REGEX: RegExp;
+/**
+ * Regular expression matching the closing `>>>>>>> ` conflict marker line.
+ */
+export declare const CONFLICT_END_REGEX: RegExp;
+/**
+ * Deterministic git author and committer identity and epoch timestamps used when synthesizing internal worktree commits.
+ */
+export declare const HARNESS_GIT_IDENTITY_ENV: Readonly<Record<string, string>>;
+/**
+ * Memoized cache of compiled `picomatch` exclusion predicates keyed by null-delimited glob patterns.
+ */
+export declare const COMPILED_EXCLUDE_MATCHER_CACHE: Map<string, (relPath: string) => boolean>;
+//# sourceMappingURL=git-executor.constants.d.ts.map

package/dist/executors/internal/git-executor.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-executor.constants.d.ts","sourceRoot":"","sources":["../../../src/executors/internal/git-executor.constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,qCAAqC,UAAY,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,SAAS,MAAM,EAIvD,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB,QAAW,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,kBAAkB,QAAiB,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,kBAAkB,QAAW,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOpE,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,8BAA8B,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAGlF,CAAC"}

package/dist/executors/internal/git-executor.constants.js

@@ -0,0 +1,40 @@
+/**
+ * Default maximum file size in bytes (1 MiB) for untracked files staged directly into temporary git index checkpoints.
+ */
+export const DEFAULT_MAX_UNTRACKED_FILE_SIZE_BYTES = 1_048_576;
+/**
+ * Implicit glob patterns always excluded from clones and checkpoints when `repo` is `'.'`.
+ */
+export const IMPLICIT_REPO_EXCLUDE_GLOBS = Object.freeze([
+    '.harness/state.sqlite*',
+    '.harness/lesson*',
+    '.git/**',
+]);
+/**
+ * Regular expression matching the opening `<<<<<<< ` conflict marker line.
+ */
+export const CONFLICT_START_REGEX = /^<{7} /;
+/**
+ * Regular expression matching the middle `=======` conflict separator line (`^={7}( |$)`).
+ */
+export const CONFLICT_SEP_REGEX = /^={7}(?: |$)/;
+/**
+ * Regular expression matching the closing `>>>>>>> ` conflict marker line.
+ */
+export const CONFLICT_END_REGEX = /^>{7} /;
+/**
+ * Deterministic git author and committer identity and epoch timestamps used when synthesizing internal worktree commits.
+ */
+export const HARNESS_GIT_IDENTITY_ENV = Object.freeze({
+    GIT_AUTHOR_NAME: 'Paraharness Runtime',
+    GIT_AUTHOR_EMAIL: 'runtime@paraharness.local',
+    GIT_COMMITTER_NAME: 'Paraharness Runtime',
+    GIT_COMMITTER_EMAIL: 'runtime@paraharness.local',
+    GIT_AUTHOR_DATE: '1700000000 +0000',
+    GIT_COMMITTER_DATE: '1700000000 +0000',
+});
+/**
+ * Memoized cache of compiled `picomatch` exclusion predicates keyed by null-delimited glob patterns.
+ */
+export const COMPILED_EXCLUDE_MATCHER_CACHE = new Map();
+//# sourceMappingURL=git-executor.constants.js.map

package/dist/executors/internal/git-executor.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-executor.constants.js","sourceRoot":"","sources":["../../../src/executors/internal/git-executor.constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAAG,SAAS,CAAC;AAE/D;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAsB,MAAM,CAAC,MAAM,CAAC;IAC1E,wBAAwB;IACxB,kBAAkB;IAClB,SAAS;CACV,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,QAAQ,CAAC;AAE7C;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAC;AAEjD;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAE3C;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAqC,MAAM,CAAC,MAAM,CAAC;IACtF,eAAe,EAAE,qBAAqB;IACtC,gBAAgB,EAAE,2BAA2B;IAC7C,kBAAkB,EAAE,qBAAqB;IACzC,mBAAmB,EAAE,2BAA2B;IAChD,eAAe,EAAE,kBAAkB;IACnC,kBAAkB,EAAE,kBAAkB;CACvC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAA8C,IAAI,GAAG,EAG7F,CAAC"}

package/dist/executors/internal/git-merge-train-bisect.d.ts

@@ -0,0 +1,51 @@
+import type { BaseCheckASTNode, CheckEvaluationResult, GitWorktreeHandle, StepExecutionContext } from '@paraharness/core';
+import type { MergeTrainCandidate } from './merge-train-candidate.js';
+import type { MergeTrainChainEntry } from './merge-train-chain-entry.js';
+/**
+ * Evaluates a deterministic `CheckASTNode` against the active `GitWorktreeHandle`.
+ *
+ * Dispatches through `ctx.registry.checks` when registered, or executes `command` in the worktree environment.
+ *
+ * @param {BaseCheckASTNode<string, GitWorktreeHandle>} checkNode - Check AST node to evaluate.
+ * @param {StepExecutionContext<GitWorktreeHandle>}     ctx       - Active step execution context.
+ *
+ * @returns {Promise<CheckEvaluationResult>} Check pass/fail evaluation outcome.
+ */
+export declare function evaluateWorktreeCheck(checkNode: BaseCheckASTNode<string, GitWorktreeHandle>, ctx: StepExecutionContext<GitWorktreeHandle>): Promise<CheckEvaluationResult>;
+/**
+ * Normalizes candidate branch inputs for a batch merge-train step up to `maxBatchSize`.
+ *
+ * Resolves branch names, refs, or receipt objects into `{ label, headSha, baseSha }` descriptors.
+ *
+ * @param {unknown}           input        - Step input containing candidate branches/refs or `undefined`.
+ * @param {GitWorktreeHandle} handle       - Active worktree handle used for ref resolution.
+ * @param {number}            maxBatchSize - Maximum number of candidates per batch.
+ *
+ * @returns {Promise<readonly MergeTrainCandidate[]>} Normalized merge-train candidates.
+ */
+export declare function extractMergeTrainCandidates(input: unknown, handle: GitWorktreeHandle, maxBatchSize: number): Promise<readonly MergeTrainCandidate[]>;
+/**
+ * Constructs a cumulative speculative rebase chain $R_1 \dots R_m$ onto `currentTargetSha`.
+ *
+ * Halts and returns `[chain, conflictedIndex]` if a candidate fails to rebase cleanly onto the prior tip.
+ *
+ * @param {string}                          cwd              - Worktree directory path.
+ * @param {string}                          currentTargetSha - Base commit SHA for $R_1$.
+ * @param {readonly MergeTrainCandidate[]}  queue            - Remaining candidate branches to chain.
+ *
+ * @returns {Promise<readonly [readonly MergeTrainChainEntry[], number]>} Tuple of `[chain, conflictedIndex]`.
+ */
+export declare function buildCumulativeRebaseChain(cwd: string, currentTargetSha: string, queue: readonly MergeTrainCandidate[]): Promise<readonly [readonly MergeTrainChainEntry[], number]>;
+/**
+ * Binary-bisects a cumulative rebase chain $R_1 \dots R_m$ whose tip $R_m$ failed `verifyWith`.
+ *
+ * Isolates the first offending candidate index in $O(\log m)$ verification checks.
+ *
+ * @param {readonly MergeTrainChainEntry[]}             chain      - Cumulative speculative rebase chain entries.
+ * @param {BaseCheckASTNode<string, GitWorktreeHandle>} verifyWith - Verification check AST node.
+ * @param {StepExecutionContext<GitWorktreeHandle>}     ctx        - Active step execution context.
+ *
+ * @returns {Promise<readonly [number, number]>} Tuple of `[firstFailingIndex, verificationRunsUsed]`.
+ */
+export declare function gitMergeTrainBisect(chain: readonly MergeTrainChainEntry[], verifyWith: BaseCheckASTNode<string, GitWorktreeHandle>, ctx: StepExecutionContext<GitWorktreeHandle>): Promise<readonly [number, number]>;
+//# sourceMappingURL=git-merge-train-bisect.d.ts.map

package/dist/executors/internal/git-merge-train-bisect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-merge-train-bisect.d.ts","sourceRoot":"","sources":["../../../src/executors/internal/git-merge-train-bisect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAEhB,qBAAqB,EACrB,iBAAiB,EAEjB,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAS3B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEzE;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,CAAC,EACtD,GAAG,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,GAC3C,OAAO,CAAC,qBAAqB,CAAC,CAsChC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,iBAAiB,EACzB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC,CAiDzC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,MAAM,EACX,gBAAgB,EAAE,MAAM,EACxB,KAAK,EAAE,SAAS,mBAAmB,EAAE,GACpC,OAAO,CAAC,SAAS,CAAC,SAAS,oBAAoB,EAAE,EAAE,MAAM,CAAC,CAAC,CAiB7D;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,SAAS,oBAAoB,EAAE,EACtC,UAAU,EAAE,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,CAAC,EACvD,GAAG,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,GAC3C,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAepC"}