@paraharness/git 0.0.0-stage → 0.2.0

package/dist/executors/internal/git-merge-train-bisect.js

@@ -0,0 +1,152 @@
+import { execFile } from 'node:child_process';
+import { MergeTrainStepInputSchema, } from '../../schemas/git-receipts.schema.js';
+import { buildIsolatedWorktreeGitEnv, runGitCommand, } from './git-cli-runner.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 async function evaluateWorktreeCheck(checkNode, ctx) {
+    const registered = ctx.registry?.checks?.[checkNode.type];
+    if (registered !== undefined) {
+        return registered(checkNode, undefined, ctx);
+    }
+    if ('command' in checkNode && typeof checkNode.command === 'string') {
+        const cmd = checkNode.command;
+        const cwd = ctx.scopeHandle.worktreePath;
+        const env = buildIsolatedWorktreeGitEnv(cwd);
+        return new Promise((resolve) => {
+            execFile('sh', ['-c', cmd], { cwd, env, signal: ctx.signal }, (err, stdout, stderr) => {
+                const ok = err === null;
+                const msg = (stderr ||
+                    stdout ||
+                    (err?.message ?? 'Check failed')).trim();
+                resolve({ ok, deficits: ok ? [] : [msg] });
+            });
+        });
+    }
+    throw new Error(`No CheckExecutor registered for '${checkNode.type}' (id '${checkNode.id}').`);
+}
+/**
+ * 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 async function extractMergeTrainCandidates(input, handle, maxBatchSize) {
+    const parsed = MergeTrainStepInputSchema.safeParse(input);
+    const rawItems = parsed.success
+        ? Array.isArray(parsed.data)
+            ? parsed.data
+            : (parsed.data.candidates ??
+                parsed.data.branches ??
+                parsed.data.refs ??
+                parsed.data.receipts ??
+                [])
+        : [];
+    if (rawItems.length === 0) {
+        const fallbackHead = handle.headRef ?? handle.baseRef;
+        return Object.freeze([
+            {
+                label: handle.branchName ?? fallbackHead,
+                headSha: fallbackHead,
+                baseSha: handle.baseRef,
+            },
+        ]);
+    }
+    const candidates = [];
+    const limit = Math.min(rawItems.length, Math.max(1, maxBatchSize));
+    for (let idx = 0; idx < limit; idx += 1) {
+        const raw = rawItems[idx];
+        if (raw === undefined)
+            continue;
+        const label = typeof raw === 'string'
+            ? raw
+            : (raw.branchName ?? raw.ref ?? raw.headRef ?? '');
+        const refInput = typeof raw === 'string' ? raw : (raw.headRef ?? label);
+        const headSha = (await runGitCommand({
+            cwd: handle.worktreePath,
+            args: ['rev-parse', refInput],
+        })).stdout.trim();
+        const explicitBase = typeof raw === 'string' ? undefined : raw.baseRef;
+        const parentLookup = (await runGitCommand({
+            cwd: handle.worktreePath,
+            args: ['rev-parse', `${headSha}^`],
+            allowNonZeroExit: true,
+        })).stdout.trim();
+        const baseSha = (explicitBase ?? parentLookup) || handle.baseRef;
+        candidates.push({ label, headSha, baseSha });
+    }
+    return Object.freeze(candidates);
+}
+/**
+ * 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 async function buildCumulativeRebaseChain(cwd, currentTargetSha, queue) {
+    const chain = [];
+    for (let i = 0; i < queue.length; i += 1) {
+        const cand = queue[i];
+        if (cand === undefined)
+            break;
+        const prevEntry = chain[chain.length - 1];
+        const prevSha = prevEntry === undefined ? currentTargetSha : prevEntry.rebasedSha;
+        await runGitCommand({ cwd, args: ['checkout', '--detach', '--force', cand.headSha] });
+        const rebaseOutput = await runGitCommand({ cwd, args: ['rebase', '--onto', prevSha, cand.baseSha, 'HEAD'], allowNonZeroExit: true });
+        if (rebaseOutput.exitCode !== 0) {
+            await runGitCommand({ cwd, args: ['rebase', '--abort'], allowNonZeroExit: true });
+            return [Object.freeze(chain), i];
+        }
+        const rebasedSha = (await runGitCommand({ cwd, args: ['rev-parse', 'HEAD'] })).stdout.trim();
+        chain.push({ candidate: cand, rebasedSha });
+    }
+    return [Object.freeze(chain), -1];
+}
+/**
+ * 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 async function gitMergeTrainBisect(chain, verifyWith, ctx) {
+    let low = 0;
+    let high = chain.length - 1;
+    let runs = 0;
+    while (low < high) {
+        const mid = Math.floor((low + high) / 2);
+        const midEntry = chain[mid];
+        if (midEntry === undefined)
+            break;
+        await runGitCommand({ cwd: ctx.scopeHandle.worktreePath, args: ['reset', '--hard', midEntry.rebasedSha] });
+        runs += 1;
+        const checkOutcome = await evaluateWorktreeCheck(verifyWith, ctx);
+        if (checkOutcome.ok)
+            low = mid + 1;
+        else
+            high = mid;
+    }
+    return [low, runs];
+}
+//# sourceMappingURL=git-merge-train-bisect.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git-merge-train-bisect.js","sourceRoot":"","sources":["../../../src/executors/internal/git-merge-train-bisect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAS9C,OAAO,EACL,yBAAyB,GAE1B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,2BAA2B,EAC3B,aAAa,GACd,MAAM,qBAAqB,CAAC;AAI7B;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,SAAsD,EACtD,GAA4C;IAE5C,MAAM,UAAU,GAAG,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,CACvC,SAAS,CAAC,IAA4B,CAQ3B,CAAC;IACd,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,SAAS,IAAI,SAAS,IAAI,OAAO,SAAS,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACpE,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC;QAC9B,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC,YAAY,CAAC;QACzC,MAAM,GAAG,GAAG,2BAA2B,CAAC,GAAG,CAAC,CAAC;QAC7C,OAAO,IAAI,OAAO,CAAwB,CAAC,OAAO,EAAE,EAAE;YACpD,QAAQ,CACN,IAAI,EACJ,CAAC,IAAI,EAAE,GAAG,CAAC,EACX,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAChC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;gBACtB,MAAM,EAAE,GAAG,GAAG,KAAK,IAAI,CAAC;gBACxB,MAAM,GAAG,GAAG,CACV,MAAM;oBACN,MAAM;oBACN,CAAC,GAAG,EAAE,OAAO,IAAI,cAAc,CAAC,CACjC,CAAC,IAAI,EAAE,CAAC;gBACT,OAAO,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC7C,CAAC,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,IAAI,KAAK,CACb,oCAAoC,SAAS,CAAC,IAAI,UAAU,SAAS,CAAC,EAAE,KAAK,CAC9E,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,KAAc,EACd,MAAyB,EACzB,YAAoB;IAEpB,MAAM,MAAM,GAAG,yBAAyB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAmC,MAAM,CAAC,OAAO;QAC7D,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;YAC1B,CAAC,CAAC,MAAM,CAAC,IAAI;YACb,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU;gBACvB,MAAM,CAAC,IAAI,CAAC,QAAQ;gBACpB,MAAM,CAAC,IAAI,CAAC,IAAI;gBAChB,MAAM,CAAC,IAAI,CAAC,QAAQ;gBACpB,EAAE,CAAC;QACP,CAAC,CAAC,EAAE,CAAC;IACP,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC;QACtD,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB;gBACE,KAAK,EAAE,MAAM,CAAC,UAAU,IAAI,YAAY;gBACxC,OAAO,EAAE,YAAY;gBACrB,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB;SACF,CAAC,CAAC;IACL,CAAC;IACD,MAAM,UAAU,GAA0B,EAAE,CAAC;IAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;IACnE,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,GAAG,KAAK,SAAS;YAAE,SAAS;QAChC,MAAM,KAAK,GACT,OAAO,GAAG,KAAK,QAAQ;YACrB,CAAC,CAAC,GAAG;YACL,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QACvD,MAAM,QAAQ,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC;QACxE,MAAM,OAAO,GAAG,CACd,MAAM,aAAa,CAAC;YAClB,GAAG,EAAE,MAAM,CAAC,YAAY;YACxB,IAAI,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC;SAC9B,CAAC,CACH,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,MAAM,YAAY,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC;QACvE,MAAM,YAAY,GAAG,CACnB,MAAM,aAAa,CAAC;YAClB,GAAG,EAAE,MAAM,CAAC,YAAY;YACxB,IAAI,EAAE,CAAC,WAAW,EAAE,GAAG,OAAO,GAAG,CAAC;YAClC,gBAAgB,EAAE,IAAI;SACvB,CAAC,CACH,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,CAAC,YAAY,IAAI,YAAY,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC;QACjE,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,GAAW,EACX,gBAAwB,EACxB,KAAqC;IAErC,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM;QAC9B,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC;QAClF,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACtF,MAAM,YAAY,GAAG,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;QACrI,IAAI,YAAY,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;YAClF,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAU,CAAC;QAC5C,CAAC;QACD,MAAM,UAAU,GAAG,CAAC,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC7F,KAAK,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAU,CAAC;AAC7C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,KAAsC,EACtC,UAAuD,EACvD,GAA4C;IAE5C,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAC5B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,OAAO,GAAG,GAAG,IAAI,EAAE,CAAC;QAClB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,QAAQ,KAAK,SAAS;YAAE,MAAM;QAClC,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAC3G,IAAI,IAAI,CAAC,CAAC;QACV,MAAM,YAAY,GAAG,MAAM,qBAAqB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAClE,IAAI,YAAY,CAAC,EAAE;YAAE,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;;YAC9B,IAAI,GAAG,GAAG,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,GAAG,EAAE,IAAI,CAAU,CAAC;AAC9B,CAAC"}

package/dist/executors/internal/git-tool-dispatchers.d.ts

@@ -0,0 +1,26 @@
+import type { GitCandidateComparisonToolNode, GitRefReaderToolNode, GitWorktreeHandle, StepExecutionContext, ToolExecutionResult } from '@paraharness/core';
+/**
+ * Dispatches a `GitRefReaderToolNode` invocation (`readRefFile`, `diffRefs`, `listRefFiles`) against the object store.
+ *
+ * Runs read-only `git show`, `git diff`, or `git ls-tree` inside `node.runner` concurrency slots.
+ *
+ * @param {GitRefReaderToolNode<GitWorktreeHandle>} node    - Ref-reader tool AST node.
+ * @param {unknown}                                 rawArgs - Unvalidated tool input arguments.
+ * @param {StepExecutionContext<GitWorktreeHandle>} ctx     - Active step execution context.
+ *
+ * @returns {Promise<ToolExecutionResult>} Serialized git output.
+ */
+export declare function dispatchRefReaderToolCall(node: GitRefReaderToolNode<GitWorktreeHandle>, rawArgs: unknown, ctx: StepExecutionContext<GitWorktreeHandle>): Promise<ToolExecutionResult>;
+/**
+ * Dispatches a `GitCandidateComparisonToolNode` invocation (`diffCandidates`, `readCandidateFile`, `evalInCandidates`).
+ *
+ * Wraps `evalInCandidates` benchmark runs in `serializeCheckpoint` + `try / finally { restoreCheckpoint }`.
+ *
+ * @param {GitCandidateComparisonToolNode<GitWorktreeHandle>} node    - Candidate comparison tool AST node.
+ * @param {unknown}                                           rawArgs - Unvalidated tool input arguments.
+ * @param {StepExecutionContext<GitWorktreeHandle>}           ctx     - Active step execution context.
+ *
+ * @returns {Promise<ToolExecutionResult>} Serialized candidate comparison or benchmark output.
+ */
+export declare function dispatchCandidateComparisonToolCall(node: GitCandidateComparisonToolNode<GitWorktreeHandle>, rawArgs: unknown, ctx: StepExecutionContext<GitWorktreeHandle>): Promise<ToolExecutionResult>;
+//# sourceMappingURL=git-tool-dispatchers.d.ts.map

package/dist/executors/internal/git-tool-dispatchers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-tool-dispatchers.d.ts","sourceRoot":"","sources":["../../../src/executors/internal/git-tool-dispatchers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,8BAA8B,EAC9B,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAmH3B;;;;;;;;;;GAUG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,EAC7C,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,GAC3C,OAAO,CAAC,mBAAmB,CAAC,CAS9B;AAyDD;;;;;;;;;;GAUG;AACH,wBAAsB,mCAAmC,CACvD,IAAI,EAAE,8BAA8B,CAAC,iBAAiB,CAAC,EACvD,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,GAC3C,OAAO,CAAC,mBAAmB,CAAC,CAQ9B"}

package/dist/executors/internal/git-tool-dispatchers.js

@@ -0,0 +1,174 @@
+import { DiffCandidatesInputSchema, DiffRefsInputSchema, EvalInCandidatesInputSchema, ListRefFilesInputSchema, ReadCandidateFileInputSchema, ReadRefFileInputSchema, } from '../../schemas/git-receipts.schema.js';
+import { runGitCommand } from './git-cli-runner.js';
+import { runEvalCommandInSandboxedCandidate } from './git-cross-test-import-scanner.js';
+/**
+ * Resolves the git ref or commit SHA for a speculative candidate branch index.
+ *
+ * Prefers `refs/harness/candidates/<runId>/<branchIndex>` when pinned on the host repo, falling back to `candidateHandles`.
+ *
+ * @param {number}                                  branchIndex - Zero-based speculative candidate branch index.
+ * @param {StepExecutionContext<GitWorktreeHandle>} ctx         - Active step execution context.
+ *
+ * @returns {Promise<string>} Resolved git ref or commit SHA for `branchIndex`.
+ */
+async function resolveCandidateBranchRef(branchIndex, ctx) {
+    const pinnedRef = `refs/harness/candidates/${ctx.runId}/${String(branchIndex)}`;
+    const check = await runGitCommand({
+        cwd: ctx.scopeHandle.worktreePath,
+        args: ['rev-parse', '--verify', pinnedRef],
+        allowNonZeroExit: true,
+    });
+    if (check.exitCode === 0 && check.stdout.trim().length > 0) {
+        return check.stdout.trim();
+    }
+    const handle = ctx.candidateHandles?.get(branchIndex);
+    if (handle !== undefined)
+        return handle.headRef ?? handle.baseRef;
+    return pinnedRef;
+}
+/**
+ * Resolves the list of candidate branch indices targeted by an `evalInCandidates` tool invocation.
+ *
+ * @param {EvalInCandidatesInput}                   parsed - Validated `evalInCandidates` input payload.
+ * @param {StepExecutionContext<GitWorktreeHandle>} ctx    - Active step execution context.
+ *
+ * @returns {readonly number[]} Target zero-based candidate branch indices.
+ */
+function resolveEvalCandidateBranchIndices(parsed, ctx) {
+    if (parsed.branchIndices !== undefined) {
+        return parsed.branchIndices;
+    }
+    if (parsed.branchIndex !== undefined) {
+        return [parsed.branchIndex];
+    }
+    if (ctx.candidateHandles !== undefined) {
+        return [...ctx.candidateHandles.keys()];
+    }
+    return [0];
+}
+/**
+ * Executes the underlying Git CLI command for a `GitRefReaderToolNode` tool call.
+ *
+ * @param {GitRefReaderToolNode<GitWorktreeHandle>} node      - Ref-reader tool AST node.
+ * @param {unknown}                                 validated - Schema-validated tool input arguments.
+ * @param {string}                                  cwd       - Worktree directory path.
+ *
+ * @returns {Promise<ToolExecutionResult>} Serialized git command output.
+ */
+async function executeRefReaderGitCommand(node, validated, cwd) {
+    if (node.name === 'readRefFile') {
+        const parsed = ReadRefFileInputSchema.parse(validated);
+        const showOutput = await runGitCommand({
+            cwd,
+            args: ['show', `${parsed.ref}:${parsed.path}`],
+        });
+        return { content: showOutput.stdout };
+    }
+    if (node.name === 'diffRefs') {
+        const parsed = DiffRefsInputSchema.parse(validated);
+        const paths = parsed.paths ?? [];
+        const args = [
+            'diff',
+            parsed.fromRef,
+            parsed.toRef,
+            ...(paths.length > 0 ? ['--', ...paths] : []),
+        ];
+        const diffOutput = await runGitCommand({ cwd, args });
+        return { content: diffOutput.stdout };
+    }
+    const parsed = ListRefFilesInputSchema.parse(validated);
+    const prefix = parsed.prefix !== undefined && parsed.prefix.length > 0
+        ? parsed.prefix
+        : undefined;
+    const args = [
+        'ls-tree',
+        '-r',
+        '--name-only',
+        parsed.ref,
+        ...(prefix !== undefined ? ['--', prefix] : []),
+    ];
+    const lsTreeOutput = await runGitCommand({ cwd, args });
+    return { content: lsTreeOutput.stdout };
+}
+/**
+ * Dispatches a `GitRefReaderToolNode` invocation (`readRefFile`, `diffRefs`, `listRefFiles`) against the object store.
+ *
+ * Runs read-only `git show`, `git diff`, or `git ls-tree` inside `node.runner` concurrency slots.
+ *
+ * @param {GitRefReaderToolNode<GitWorktreeHandle>} node    - Ref-reader tool AST node.
+ * @param {unknown}                                 rawArgs - Unvalidated tool input arguments.
+ * @param {StepExecutionContext<GitWorktreeHandle>} ctx     - Active step execution context.
+ *
+ * @returns {Promise<ToolExecutionResult>} Serialized git output.
+ */
+export async function dispatchRefReaderToolCall(node, rawArgs, ctx) {
+    const validated = node.inputSchema.parse(rawArgs);
+    const cwd = ctx.scopeHandle.worktreePath;
+    const runCmd = () => executeRefReaderGitCommand(node, validated, cwd);
+    if (node.runner !== undefined && typeof ctx.getRunner === 'function') {
+        return ctx.getRunner(node.runner).withSlot(runCmd, ctx.signal);
+    }
+    return runCmd();
+}
+/**
+ * Executes the underlying Git CLI or sandboxed evaluation command for a `GitCandidateComparisonToolNode`.
+ *
+ * @param {GitCandidateComparisonToolNode<GitWorktreeHandle>} node      - Candidate comparison tool AST node.
+ * @param {unknown}                                           validated - Schema-validated tool input arguments.
+ * @param {StepExecutionContext<GitWorktreeHandle>}           ctx       - Active step execution context.
+ *
+ * @returns {Promise<ToolExecutionResult>} Serialized candidate comparison or benchmark output.
+ */
+async function executeCandidateComparisonGitCommand(node, validated, ctx) {
+    const cwd = ctx.scopeHandle.worktreePath;
+    if (node.name === 'diffCandidates') {
+        const parsed = DiffCandidatesInputSchema.parse(validated);
+        const leftRef = await resolveCandidateBranchRef(parsed.fromBranchIndex, ctx);
+        const rightRef = await resolveCandidateBranchRef(parsed.toBranchIndex, ctx);
+        const paths = parsed.paths ?? [];
+        const args = [
+            'diff',
+            leftRef,
+            rightRef,
+            ...(paths.length > 0 ? ['--', ...paths] : []),
+        ];
+        return { content: (await runGitCommand({ cwd, args })).stdout };
+    }
+    if (node.name === 'readCandidateFile') {
+        const parsed = ReadCandidateFileInputSchema.parse(validated);
+        const ref = await resolveCandidateBranchRef(parsed.branchIndex, ctx);
+        return {
+            content: (await runGitCommand({ cwd, args: ['show', `${ref}:${parsed.path}`] })).stdout,
+        };
+    }
+    const parsed = EvalInCandidatesInputSchema.parse(validated);
+    const branchIndices = resolveEvalCandidateBranchIndices(parsed, ctx);
+    const command = parsed.argv ?? parsed.command ?? '';
+    const outcomes = [];
+    for (const branchIndex of branchIndices) {
+        const candidateHandle = ctx.candidateHandles?.get(branchIndex) ?? ctx.scopeHandle;
+        const evalOutcome = await runEvalCommandInSandboxedCandidate(candidateHandle, command, ctx);
+        outcomes.push({ branchIndex, ...evalOutcome });
+    }
+    return { content: JSON.stringify(outcomes) };
+}
+/**
+ * Dispatches a `GitCandidateComparisonToolNode` invocation (`diffCandidates`, `readCandidateFile`, `evalInCandidates`).
+ *
+ * Wraps `evalInCandidates` benchmark runs in `serializeCheckpoint` + `try / finally { restoreCheckpoint }`.
+ *
+ * @param {GitCandidateComparisonToolNode<GitWorktreeHandle>} node    - Candidate comparison tool AST node.
+ * @param {unknown}                                           rawArgs - Unvalidated tool input arguments.
+ * @param {StepExecutionContext<GitWorktreeHandle>}           ctx     - Active step execution context.
+ *
+ * @returns {Promise<ToolExecutionResult>} Serialized candidate comparison or benchmark output.
+ */
+export async function dispatchCandidateComparisonToolCall(node, rawArgs, ctx) {
+    const validated = node.inputSchema.parse(rawArgs);
+    const runCmd = () => executeCandidateComparisonGitCommand(node, validated, ctx);
+    if (node.runner !== undefined && typeof ctx.getRunner === 'function') {
+        return ctx.getRunner(node.runner).withSlot(runCmd, ctx.signal);
+    }
+    return runCmd();
+}
+//# sourceMappingURL=git-tool-dispatchers.js.map

package/dist/executors/internal/git-tool-dispatchers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-tool-dispatchers.js","sourceRoot":"","sources":["../../../src/executors/internal/git-tool-dispatchers.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,2BAA2B,EAC3B,uBAAuB,EACvB,4BAA4B,EAC5B,sBAAsB,GAEvB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,kCAAkC,EAAE,MAAM,oCAAoC,CAAC;AAExF;;;;;;;;;GASG;AACH,KAAK,UAAU,yBAAyB,CACtC,WAAmB,EACnB,GAA4C;IAE5C,MAAM,SAAS,GAAG,2BAA2B,GAAG,CAAC,KAAK,IAAI,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;IAChF,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC;QAChC,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC,YAAY;QACjC,IAAI,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,SAAS,CAAC;QAC1C,gBAAgB,EAAE,IAAI;KACvB,CAAC,CAAC;IACH,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3D,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,CAAC,gBAAgB,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;IACtD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC;IAClE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,iCAAiC,CACxC,MAA6B,EAC7B,GAA4C;IAE5C,IAAI,MAAM,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACvC,OAAO,MAAM,CAAC,aAAa,CAAC;IAC9B,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,GAAG,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACvC,OAAO,CAAC,GAAG,GAAG,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,CAAC,CAAC,CAAC,CAAC;AACb,CAAC;AAED;;;;;;;;GAQG;AACH,KAAK,UAAU,0BAA0B,CACvC,IAA6C,EAC7C,SAAkB,EAClB,GAAW;IAEX,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,sBAAsB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACvD,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC;YACrC,GAAG;YACH,IAAI,EAAE,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;SAC/C,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;IACxC,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACpD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG;YACX,MAAM;YACN,MAAM,CAAC,OAAO;YACd,MAAM,CAAC,KAAK;YACZ,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9C,CAAC;QACF,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;IACxC,CAAC;IACD,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACxD,MAAM,MAAM,GACV,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QACrD,CAAC,CAAC,MAAM,CAAC,MAAM;QACf,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,IAAI,GAAG;QACX,SAAS;QACT,IAAI;QACJ,aAAa;QACb,MAAM,CAAC,GAAG;QACV,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KAChD,CAAC;IACF,MAAM,YAAY,GAAG,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,MAAM,EAAE,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,IAA6C,EAC7C,OAAgB,EAChB,GAA4C;IAE5C,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC,YAAY,CAAC;IACzC,MAAM,MAAM,GAAG,GAAiC,EAAE,CAChD,0BAA0B,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;IACnD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QACrE,OAAO,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,MAAM,EAAE,CAAC;AAClB,CAAC;AAED;;;;;;;;GAQG;AACH,KAAK,UAAU,oCAAoC,CACjD,IAAuD,EACvD,SAAkB,EAClB,GAA4C;IAE5C,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC,YAAY,CAAC;IACzC,IAAI,IAAI,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,yBAAyB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,MAAM,yBAAyB,CAAC,MAAM,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;QAC7E,MAAM,QAAQ,GAAG,MAAM,yBAAyB,CAAC,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;QAC5E,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG;YACX,MAAM;YACN,OAAO;YACP,QAAQ;YACR,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9C,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,CAAC,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAClE,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,4BAA4B,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC7D,MAAM,GAAG,GAAG,MAAM,yBAAyB,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QACrE,OAAO;YACL,OAAO,EAAE,CACP,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CACtE,CAAC,MAAM;SACT,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,2BAA2B,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC5D,MAAM,aAAa,GAAG,iCAAiC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrE,MAAM,OAAO,GACX,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAmC,EAAE,CAAC;IACpD,KAAK,MAAM,WAAW,IAAI,aAAa,EAAE,CAAC;QACxC,MAAM,eAAe,GACnB,GAAG,CAAC,gBAAgB,EAAE,GAAG,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,WAAW,CAAC;QAC5D,MAAM,WAAW,GAAG,MAAM,kCAAkC,CAC1D,eAAe,EACf,OAAO,EACP,GAAG,CACJ,CAAC;QACF,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,mCAAmC,CACvD,IAAuD,EACvD,OAAgB,EAChB,GAA4C;IAE5C,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,GAAiC,EAAE,CAChD,oCAAoC,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;IAC7D,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QACrE,OAAO,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,MAAM,EAAE,CAAC;AAClB,CAAC"}

package/dist/executors/internal/git-worktree-acquire-root.d.ts

@@ -0,0 +1,22 @@
+import type { GitCowWorktreeNode, GitWorktreeHandle } from '@paraharness/core';
+import type { HostRepositoryHeadState } from './host-repository-head-state.js';
+/**
+ * Resolves `baseRef` (`HEAD` commit SHA) and `baseBranch` (`symbolic-ref --short HEAD` or `'main'`) from `repoPath`.
+ *
+ * @param {string} repoPath - Absolute path to the host Git repository.
+ *
+ * @returns {Promise<HostRepositoryHeadState>} Resolved `baseRef` and `baseBranch`.
+ */
+export declare function resolveHostRepositoryHeadState(repoPath: string): Promise<HostRepositoryHeadState>;
+/**
+ * Provisions an isolated Task Root Worktree at `<dir>/roots/<runId>` via `git worktree add --detach`.
+ *
+ * Hydrates `node_modules` (honoring `.lockfileGate` and `.setup`) and initializes `<gitdir>/harness-meta.json`.
+ *
+ * @param {GitCowWorktreeNode} node  - Worktree scope AST node configuration.
+ * @param {string}             runId - Unique flow run identifier.
+ *
+ * @returns {Promise<GitWorktreeHandle>} Newly provisioned root `GitWorktreeHandle`.
+ */
+export declare function gitWorktreeAcquireRoot(node: GitCowWorktreeNode, runId: string): Promise<GitWorktreeHandle>;
+//# sourceMappingURL=git-worktree-acquire-root.d.ts.map

package/dist/executors/internal/git-worktree-acquire-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-worktree-acquire-root.d.ts","sourceRoot":"","sources":["../../../src/executors/internal/git-worktree-acquire-root.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAO/E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE/E;;;;;;GAMG;AACH,wBAAsB,8BAA8B,CAClD,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,uBAAuB,CAAC,CAUlC;AAED;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,kBAAkB,EACxB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,iBAAiB,CAAC,CAoC5B"}

package/dist/executors/internal/git-worktree-acquire-root.js

@@ -0,0 +1,67 @@
+import { mkdir, rm } from 'node:fs/promises';
+import path from 'node:path';
+import { hydrateWorktreeDependencies } from './cow-worktree-hydrator.js';
+import { runGitCommand, withHostWorktreeLock, writeHarnessMeta, } from './git-cli-runner.js';
+/**
+ * Resolves `baseRef` (`HEAD` commit SHA) and `baseBranch` (`symbolic-ref --short HEAD` or `'main'`) from `repoPath`.
+ *
+ * @param {string} repoPath - Absolute path to the host Git repository.
+ *
+ * @returns {Promise<HostRepositoryHeadState>} Resolved `baseRef` and `baseBranch`.
+ */
+export async function resolveHostRepositoryHeadState(repoPath) {
+    const baseRef = (await runGitCommand({ cwd: repoPath, args: ['rev-parse', 'HEAD'] })).stdout.trim();
+    const branchOutput = await runGitCommand({
+        cwd: repoPath,
+        args: ['symbolic-ref', '--short', 'HEAD'],
+        allowNonZeroExit: true,
+    });
+    const trimmedBranch = branchOutput.stdout.trim();
+    const baseBranch = branchOutput.exitCode === 0 && trimmedBranch.length > 0 ? trimmedBranch : 'main';
+    return { baseRef, baseBranch };
+}
+/**
+ * Provisions an isolated Task Root Worktree at `<dir>/roots/<runId>` via `git worktree add --detach`.
+ *
+ * Hydrates `node_modules` (honoring `.lockfileGate` and `.setup`) and initializes `<gitdir>/harness-meta.json`.
+ *
+ * @param {GitCowWorktreeNode} node  - Worktree scope AST node configuration.
+ * @param {string}             runId - Unique flow run identifier.
+ *
+ * @returns {Promise<GitWorktreeHandle>} Newly provisioned root `GitWorktreeHandle`.
+ */
+export async function gitWorktreeAcquireRoot(node, runId) {
+    const repoPath = path.resolve(node.repo);
+    const baseDir = path.isAbsolute(node.dir) ? node.dir : path.resolve(repoPath, node.dir);
+    const safeRunId = runId.replace(/[^a-zA-Z0-9._-]/g, '_');
+    const worktreePath = path.join(baseDir, 'roots', safeRunId);
+    await rm(worktreePath, { recursive: true, force: true });
+    await mkdir(path.dirname(worktreePath), { recursive: true });
+    const { baseRef, baseBranch } = await withHostWorktreeLock(repoPath, async () => {
+        await runGitCommand({
+            cwd: repoPath,
+            args: ['worktree', 'prune'],
+            allowNonZeroExit: true,
+        });
+        const headState = await resolveHostRepositoryHeadState(repoPath);
+        await runGitCommand({
+            cwd: repoPath,
+            args: ['worktree', 'add', '--detach', '--force', worktreePath, headState.baseRef],
+        });
+        return headState;
+    });
+    const rawGitDir = (await runGitCommand({ cwd: worktreePath, args: ['rev-parse', '--git-dir'] })).stdout.trim();
+    const gitDirPath = path.resolve(worktreePath, rawGitDir);
+    await hydrateWorktreeDependencies(node, repoPath, worktreePath);
+    const emptyConflicts = Object.freeze({});
+    await writeHarnessMeta(gitDirPath, { baseRef, baseBranch, unresolvedConflictPaths: emptyConflicts });
+    return {
+        worktreePath,
+        gitDirPath,
+        baseRef,
+        baseBranch,
+        headRef: baseRef,
+        unresolvedConflictPaths: emptyConflicts,
+    };
+}
+//# sourceMappingURL=git-worktree-acquire-root.js.map

package/dist/executors/internal/git-worktree-acquire-root.js.map

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

package/dist/executors/internal/git-worktree-commit-child.d.ts

@@ -0,0 +1,26 @@
+import type { GitScopeReceipt, GitWorktreeHandle, ReconcileResult } from '@paraharness/core';
+/**
+ * Captures a 100% non-mutating `GitScopeReceipt` for `handle` using a temporary index file.
+ *
+ * Reuses `HEAD` directly when the working tree is clean and `HEAD` descends from `baseRef`,
+ * and pins `refs/harness/candidates/<run-id>/<branch-index>` for child fork worktrees.
+ *
+ * @param {GitWorktreeHandle}             handle         - Active worktree handle to inspect.
+ * @param {readonly string[] | undefined} [excludeGlobs] - Optional glob patterns excluded from staging.
+ *
+ * @returns {Promise<GitScopeReceipt>} Validated `GitScopeReceipt` with `headRef`, `diffStat`, and `mutatedFiles`.
+ */
+export declare function gitWorktreeInspectNonMutating(handle: GitWorktreeHandle, excludeGlobs?: readonly string[]): Promise<GitScopeReceipt>;
+/**
+ * Reconciles `child` into `parent` via stateless 3-way `git merge-tree --write-tree` without polluting `parent` on conflict.
+ *
+ * Leaves `child.baseRef` untouched on a clean merge, or materializes conflicts into `child` and advances `child.baseRef = C_1` on conflict.
+ *
+ * @param {GitWorktreeHandle}             child          - Completed child worktree handle.
+ * @param {GitWorktreeHandle}             parent         - Target parent worktree handle.
+ * @param {readonly string[] | undefined} [excludeGlobs] - Optional glob patterns excluded from staging.
+ *
+ * @returns {Promise<ReconcileResult<GitScopeReceipt>>} Clean or conflicted reconciliation result.
+ */
+export declare function gitWorktreeCommitChild(child: GitWorktreeHandle, parent: GitWorktreeHandle, excludeGlobs?: readonly string[]): Promise<ReconcileResult<GitScopeReceipt>>;
+//# sourceMappingURL=git-worktree-commit-child.d.ts.map

package/dist/executors/internal/git-worktree-commit-child.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-worktree-commit-child.d.ts","sourceRoot":"","sources":["../../../src/executors/internal/git-worktree-commit-child.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAmB3B;;;;;;;;;;GAUG;AACH,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,iBAAiB,EACzB,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,GAC/B,OAAO,CAAC,eAAe,CAAC,CA4B1B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,iBAAiB,EACzB,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,GAC/B,OAAO,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC,CA4B3C"}

package/dist/executors/internal/git-worktree-commit-child.js

@@ -0,0 +1,88 @@
+import { GitScopeReceiptSchema } from '../../schemas/git-receipts.schema.js';
+import { gitCheckpointStatusMap } from './git-checkpoint-status-map.js';
+import { runGitCommand } from './git-cli-runner.js';
+import { gitWorktreeFlushCleanParentChanges, gitWorktreePruneResolvedConflicts, } from './git-worktree-flush-and-prune.js';
+import { executeStatelessMergeTree, gitWorktreeMaterializeMerge, synthesizeWorkingTreeCommitOverBase, } from './git-worktree-materialize-merge.js';
+import { fastForwardParentToTargetCommit, findWorktreeConflictMarkerPaths, pinCandidateRefIfSpeculativeBranch, } from './parent-fast-forward.js';
+/**
+ * Captures a 100% non-mutating `GitScopeReceipt` for `handle` using a temporary index file.
+ *
+ * Reuses `HEAD` directly when the working tree is clean and `HEAD` descends from `baseRef`,
+ * and pins `refs/harness/candidates/<run-id>/<branch-index>` for child fork worktrees.
+ *
+ * @param {GitWorktreeHandle}             handle         - Active worktree handle to inspect.
+ * @param {readonly string[] | undefined} [excludeGlobs] - Optional glob patterns excluded from staging.
+ *
+ * @returns {Promise<GitScopeReceipt>} Validated `GitScopeReceipt` with `headRef`, `diffStat`, and `mutatedFiles`.
+ */
+export async function gitWorktreeInspectNonMutating(handle, excludeGlobs) {
+    const snap = await gitCheckpointStatusMap(handle.worktreePath, { excludeGlobs });
+    const currentHead = (await runGitCommand({ cwd: handle.worktreePath, args: ['rev-parse', 'HEAD'] })).stdout.trim();
+    let headRef;
+    if (Object.keys(snap.statusMap).length === 0 && currentHead !== handle.baseRef) {
+        const ancestorCheck = await runGitCommand({
+            cwd: handle.worktreePath,
+            args: ['merge-base', '--is-ancestor', handle.baseRef, currentHead],
+            allowNonZeroExit: true,
+        });
+        headRef = ancestorCheck.exitCode === 0
+            ? currentHead
+            : (await synthesizeWorkingTreeCommitOverBase(handle, handle.baseRef, excludeGlobs)).commitSha;
+    }
+    else {
+        headRef = (await synthesizeWorkingTreeCommitOverBase(handle, handle.baseRef, excludeGlobs)).commitSha;
+    }
+    await pinCandidateRefIfSpeculativeBranch(handle, headRef);
+    const statOutput = await runGitCommand({ cwd: handle.worktreePath, args: ['diff', '--stat', handle.baseRef, headRef] });
+    const filesOutput = await runGitCommand({ cwd: handle.worktreePath, args: ['diff', '--name-only', '-z', handle.baseRef, headRef] });
+    const mutatedFiles = filesOutput.stdout.split('\0').filter((relPath) => relPath.length > 0);
+    return GitScopeReceiptSchema.parse({
+        headRef,
+        baseRef: handle.baseRef,
+        branchName: handle.branchName,
+        baseBranch: handle.baseBranch,
+        diffStat: statOutput.stdout.trim(),
+        mutatedFiles,
+    });
+}
+/**
+ * Reconciles `child` into `parent` via stateless 3-way `git merge-tree --write-tree` without polluting `parent` on conflict.
+ *
+ * Leaves `child.baseRef` untouched on a clean merge, or materializes conflicts into `child` and advances `child.baseRef = C_1` on conflict.
+ *
+ * @param {GitWorktreeHandle}             child          - Completed child worktree handle.
+ * @param {GitWorktreeHandle}             parent         - Target parent worktree handle.
+ * @param {readonly string[] | undefined} [excludeGlobs] - Optional glob patterns excluded from staging.
+ *
+ * @returns {Promise<ReconcileResult<GitScopeReceipt>>} Clean or conflicted reconciliation result.
+ */
+export async function gitWorktreeCommitChild(child, parent, excludeGlobs) {
+    const remainingConflicts = await gitWorktreePruneResolvedConflicts(child);
+    const markerPaths = await findWorktreeConflictMarkerPaths(child, excludeGlobs);
+    if (Object.keys(remainingConflicts).length > 0 || markerPaths.length > 0) {
+        const unresolved = [...new Set([...Object.keys(remainingConflicts), ...markerPaths])];
+        const receipt = await gitWorktreeInspectNonMutating(child, excludeGlobs);
+        return { status: 'conflict', conflictedSummary: `Unresolved conflicts on child worktree: ${unresolved.join(', ')}`, data: receipt };
+    }
+    const c1Sha = await gitWorktreeFlushCleanParentChanges(parent, excludeGlobs);
+    const childSynth = await synthesizeWorkingTreeCommitOverBase(child, child.baseRef, excludeGlobs);
+    if (child.baseRef === c1Sha) {
+        await fastForwardParentToTargetCommit(parent, c1Sha, childSynth.commitSha);
+        return { status: 'clean', data: await gitWorktreeInspectNonMutating(parent, excludeGlobs) };
+    }
+    const mergeOutcome = await executeStatelessMergeTree(child, c1Sha, childSynth.commitSha);
+    if (mergeOutcome.clean) {
+        const commitOutput = await runGitCommand({ cwd: parent.worktreePath, args: ['commit-tree', mergeOutcome.mergedTreeSha, '-p', c1Sha, '-m', 'harness: commit child merge'] });
+        await fastForwardParentToTargetCommit(parent, c1Sha, commitOutput.stdout.trim());
+        return { status: 'clean', data: await gitWorktreeInspectNonMutating(parent, excludeGlobs) };
+    }
+    await gitWorktreeMaterializeMerge(child, {
+        targetHeadSha: c1Sha,
+        mergedTreeSha: mergeOutcome.mergedTreeSha,
+        priorTreeSha: childSynth.treeSha,
+        conflictedPaths: mergeOutcome.conflictedPaths,
+    });
+    const receipt = await gitWorktreeInspectNonMutating(child, excludeGlobs);
+    return { status: 'conflict', conflictedSummary: `3-way merge conflict on paths: ${mergeOutcome.conflictedPaths.join(', ')}`, data: receipt };
+}
+//# sourceMappingURL=git-worktree-commit-child.js.map

package/dist/executors/internal/git-worktree-commit-child.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-worktree-commit-child.js","sourceRoot":"","sources":["../../../src/executors/internal/git-worktree-commit-child.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EACL,kCAAkC,EAClC,iCAAiC,GAClC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,mCAAmC,GACpC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,+BAA+B,EAC/B,+BAA+B,EAC/B,kCAAkC,GACnC,MAAM,0BAA0B,CAAC;AAElC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,MAAyB,EACzB,YAAgC;IAEhC,MAAM,IAAI,GAAG,MAAM,sBAAsB,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;IACjF,MAAM,WAAW,GAAG,CAAC,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACnH,IAAI,OAAe,CAAC;IACpB,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,WAAW,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC;QAC/E,MAAM,aAAa,GAAG,MAAM,aAAa,CAAC;YACxC,GAAG,EAAE,MAAM,CAAC,YAAY;YACxB,IAAI,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC;YAClE,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;QACH,OAAO,GAAG,aAAa,CAAC,QAAQ,KAAK,CAAC;YACpC,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,CAAC,MAAM,mCAAmC,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;IAClG,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,CAAC,MAAM,mCAAmC,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;IACxG,CAAC;IACD,MAAM,kCAAkC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IACxH,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IACpI,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC5F,OAAO,qBAAqB,CAAC,KAAK,CAAC;QACjC,OAAO;QACP,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE;QAClC,YAAY;KACb,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,KAAwB,EACxB,MAAyB,EACzB,YAAgC;IAEhC,MAAM,kBAAkB,GAAG,MAAM,iCAAiC,CAAC,KAAK,CAAC,CAAC;IAC1E,MAAM,WAAW,GAAG,MAAM,+BAA+B,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IAC/E,IAAI,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzE,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QACtF,MAAM,OAAO,GAAG,MAAM,6BAA6B,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QACzE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,EAAE,2CAA2C,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACtI,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,kCAAkC,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC7E,MAAM,UAAU,GAAG,MAAM,mCAAmC,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACjG,IAAI,KAAK,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;QAC5B,MAAM,+BAA+B,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;QAC3E,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC;IAC9F,CAAC;IACD,MAAM,YAAY,GAAG,MAAM,yBAAyB,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACzF,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC;QACvB,MAAM,YAAY,GAAG,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,aAAa,EAAE,YAAY,CAAC,aAAa,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,6BAA6B,CAAC,EAAE,CAAC,CAAC;QAC5K,MAAM,+BAA+B,CAAC,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACjF,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC;IAC9F,CAAC;IACD,MAAM,2BAA2B,CAAC,KAAK,EAAE;QACvC,aAAa,EAAE,KAAK;QACpB,aAAa,EAAE,YAAY,CAAC,aAAa;QACzC,YAAY,EAAE,UAAU,CAAC,OAAO;QAChC,eAAe,EAAE,YAAY,CAAC,eAAe;KAC9C,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,MAAM,6BAA6B,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IACzE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,EAAE,kCAAkC,YAAY,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC/I,CAAC"}