@paraharness/git 0.0.0-stage → 0.1.0

package/LICENSE

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

package/README.md

@@ -1,3 +1,69 @@
-# Temporary Holding Version
+# @paraharness/git
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Copy-on-Write (CoW) hierarchical Git worktree isolation scope, git-index checkpointing, stateless 3-way `git merge-tree --write-tree` reconciliation, and candidate comparison tools for [Paraharness](https://github.com/paraharness/paraharness). This package isolates every flow run, subagent fork, and speculative branch inside its own worktree sharing the host repository's object store while providing deterministic post-flight rollback, abort snapshots, and retry-safe branch pushing.
+
+## Installation
+
+With npm:
+
+```bash
+npm install @paraharness/git @paraharness/core zod
+```
+
+With yarn:
+
+```bash
+yarn add @paraharness/git @paraharness/core zod
+```
+
+With pnpm:
+
+```bash
+pnpm add @paraharness/git @paraharness/core zod
+```
+
+## Usage
+
+```ts
+import { P, z } from '@paraharness/core';
+import { createExecutorRegistry } from '@paraharness/core/runtime';
+import { git, gitExecutors } from '@paraharness/git';
+import { local, nodeExecutors } from '@paraharness/node';
+
+const TaskInput = z.object({
+  id: z.string(),
+  title: z.string(),
+});
+
+const runner = local.runner({ slots: 4 });
+
+const worktreeScope = git
+  .cowWorktree({ repo: '.', dir: '.harness/worktrees' })
+  .excludeFromCloneGlobs(['dist/**', 'coverage/**'])
+  .lockfileGate('pnpm-lock.yaml')
+  .reconcileStrategy('rebase-onto-base');
+
+const landChanges = git
+  .commitAndPush('land-changes', {
+    branch: (item: z.infer<typeof TaskInput>) => `feat/${item.id}`,
+    message: (item: z.infer<typeof TaskInput>) => `feat(${item.id}): ${item.title}`,
+  })
+  .input(TaskInput)
+  .runner(runner);
+
+const flow = P.flow('git-delivery-flow')
+  .input(TaskInput)
+  .scope(worktreeScope)
+  .step('push', landChanges)
+  .exit('done');
+
+const registry = createExecutorRegistry(gitExecutors, nodeExecutors);
+```
+
+## Documentation
+
+See the [`@paraharness/git` API Reference](https://paraharness.github.io/paraharness/modules/_paraharness_git.html) for full type and builder specifications.
+
+## License
+
+[MIT](./LICENSE) © Tornike Tsomaia

package/dist/builders/create-git-candidate-comparison-tools.d.ts

@@ -0,0 +1,13 @@
+import { type GitCandidateComparisonToolNode, type GitWorktreeHandle, type MaybeBuilder, type NodeRunnerNode } from '@paraharness/core';
+/**
+ * Creates the speculative candidate comparison and benchmark tool bundle (`git.candidateComparisonTools(runner)`).
+ *
+ * Emits passive `GitCandidateComparisonToolNode` descriptors for `diffCandidates`, `readCandidateFile`,
+ * and checkpoint-sandboxed `evalInCandidates` over `refs/harness/candidates/<run-id>/<branch-index>`.
+ *
+ * @param {MaybeBuilder<NodeRunnerNode>} runner - Subprocess runner pool governing git and benchmark command slots.
+ *
+ * @returns {readonly GitCandidateComparisonToolNode<GitWorktreeHandle>[]} Frozen tuple of candidate comparison tool AST nodes.
+ */
+export declare function createGitCandidateComparisonTools(runner: MaybeBuilder<NodeRunnerNode>): readonly GitCandidateComparisonToolNode<GitWorktreeHandle>[];
+//# sourceMappingURL=create-git-candidate-comparison-tools.d.ts.map

package/dist/builders/create-git-candidate-comparison-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-git-candidate-comparison-tools.d.ts","sourceRoot":"","sources":["../../src/builders/create-git-candidate-comparison-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,8BAA8B,EACnC,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAO3B;;;;;;;;;GASG;AACH,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,YAAY,CAAC,cAAc,CAAC,GACnC,SAAS,8BAA8B,CAAC,iBAAiB,CAAC,EAAE,CA2B9D"}

package/dist/builders/create-git-candidate-comparison-tools.js

@@ -0,0 +1,41 @@
+import { extractAST, } from '@paraharness/core';
+import { DiffCandidatesInputSchema, EvalInCandidatesInputSchema, ReadCandidateFileInputSchema, } from '../schemas/git-receipts.schema.js';
+/**
+ * Creates the speculative candidate comparison and benchmark tool bundle (`git.candidateComparisonTools(runner)`).
+ *
+ * Emits passive `GitCandidateComparisonToolNode` descriptors for `diffCandidates`, `readCandidateFile`,
+ * and checkpoint-sandboxed `evalInCandidates` over `refs/harness/candidates/<run-id>/<branch-index>`.
+ *
+ * @param {MaybeBuilder<NodeRunnerNode>} runner - Subprocess runner pool governing git and benchmark command slots.
+ *
+ * @returns {readonly GitCandidateComparisonToolNode<GitWorktreeHandle>[]} Frozen tuple of candidate comparison tool AST nodes.
+ */
+export function createGitCandidateComparisonTools(runner) {
+    const runnerNode = extractAST(runner);
+    const diffCandidatesNode = Object.freeze({
+        type: 'git:candidate-comparison-tool',
+        name: 'diffCandidates',
+        description: 'Computes the unified diff between two speculative candidate branches.',
+        inputSchema: DiffCandidatesInputSchema,
+        effectTracking: 'declared',
+        runner: runnerNode,
+    });
+    const readCandidateFileNode = Object.freeze({
+        type: 'git:candidate-comparison-tool',
+        name: 'readCandidateFile',
+        description: 'Reads a file from a speculative candidate branch by branchIndex and path.',
+        inputSchema: ReadCandidateFileInputSchema,
+        effectTracking: 'declared',
+        runner: runnerNode,
+    });
+    const evalInCandidatesNode = Object.freeze({
+        type: 'git:candidate-comparison-tool',
+        name: 'evalInCandidates',
+        description: 'Executes a benchmark or check command across candidate worktrees inside a serialize/restore checkpoint sandbox.',
+        inputSchema: EvalInCandidatesInputSchema,
+        effectTracking: 'declared',
+        runner: runnerNode,
+    });
+    return Object.freeze([diffCandidatesNode, readCandidateFileNode, evalInCandidatesNode]);
+}
+//# sourceMappingURL=create-git-candidate-comparison-tools.js.map

package/dist/builders/create-git-candidate-comparison-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-git-candidate-comparison-tools.js","sourceRoot":"","sources":["../../src/builders/create-git-candidate-comparison-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,GAKX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,mCAAmC,CAAC;AAE3C;;;;;;;;;GASG;AACH,MAAM,UAAU,iCAAiC,CAC/C,MAAoC;IAEpC,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAoD;QAC1F,IAAI,EAAE,+BAA+B;QACrC,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,uEAAuE;QACpF,WAAW,EAAE,yBAAyB;QACtC,cAAc,EAAE,UAAU;QAC1B,MAAM,EAAE,UAAU;KACnB,CAAC,CAAC;IACH,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAoD;QAC7F,IAAI,EAAE,+BAA+B;QACrC,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,2EAA2E;QACxF,WAAW,EAAE,4BAA4B;QACzC,cAAc,EAAE,UAAU;QAC1B,MAAM,EAAE,UAAU;KACnB,CAAC,CAAC;IACH,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAoD;QAC5F,IAAI,EAAE,+BAA+B;QACrC,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,iHAAiH;QAC9H,WAAW,EAAE,2BAA2B;QACxC,cAAc,EAAE,UAAU;QAC1B,MAAM,EAAE,UAAU;KACnB,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,kBAAkB,EAAE,qBAAqB,EAAE,oBAAoB,CAAC,CAAC,CAAC;AAC1F,CAAC"}

package/dist/builders/create-git-commit-and-push-builder.d.ts

@@ -0,0 +1,18 @@
+import type { GitCommitAndPushBuilder } from './git-commit-and-push-builder.js';
+import type { GitCommitAndPushOptions } from './git-commit-and-push-options.js';
+/**
+ * Creates a fluent `GitCommitAndPushBuilder` (`git.commitAndPush(id, options)`).
+ *
+ * Compiles into a passive `GitCommitAndPushNode<TIn>` with zero import-time or declaration-time I/O.
+ *
+ * @template TIn Step input payload type.
+ *
+ * @param {string}                       id      - Unique step node identifier.
+ * @param {GitCommitAndPushOptions<TIn>} options - Branch projection, commit message projection, and optional bindings.
+ *
+ * @returns {GitCommitAndPushBuilder<TIn>} Immutable fluent `GitCommitAndPushBuilder` instance.
+ *
+ * @throws {Error} If `id` is empty.
+ */
+export declare function createGitCommitAndPushBuilder<TIn = unknown>(id: string, options: GitCommitAndPushOptions<TIn>): GitCommitAndPushBuilder<TIn>;
+//# sourceMappingURL=create-git-commit-and-push-builder.d.ts.map

package/dist/builders/create-git-commit-and-push-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-git-commit-and-push-builder.d.ts","sourceRoot":"","sources":["../../src/builders/create-git-commit-and-push-builder.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAEhF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,GAAG,OAAO,EACzD,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,uBAAuB,CAAC,GAAG,CAAC,GACpC,uBAAuB,CAAC,GAAG,CAAC,CAoD9B"}

package/dist/builders/create-git-commit-and-push-builder.js

@@ -0,0 +1,65 @@
+import { extractAST, z, } from '@paraharness/core';
+/**
+ * Creates a fluent `GitCommitAndPushBuilder` (`git.commitAndPush(id, options)`).
+ *
+ * Compiles into a passive `GitCommitAndPushNode<TIn>` with zero import-time or declaration-time I/O.
+ *
+ * @template TIn Step input payload type.
+ *
+ * @param {string}                       id      - Unique step node identifier.
+ * @param {GitCommitAndPushOptions<TIn>} options - Branch projection, commit message projection, and optional bindings.
+ *
+ * @returns {GitCommitAndPushBuilder<TIn>} Immutable fluent `GitCommitAndPushBuilder` instance.
+ *
+ * @throws {Error} If `id` is empty.
+ */
+export function createGitCommitAndPushBuilder(id, options) {
+    if (id.trim().length === 0) {
+        throw new Error("git.commitAndPush: 'id' must be a non-empty string.");
+    }
+    return Object.freeze({
+        input(schema) {
+            return createGitCommitAndPushBuilder(id, {
+                branch: options.branch,
+                message: options.message,
+                inputSchema: schema,
+                runner: options.runner,
+                env: options.env,
+            });
+        },
+        runner(runnerNode) {
+            return createGitCommitAndPushBuilder(id, {
+                ...options,
+                runner: runnerNode,
+            });
+        },
+        env(envMap) {
+            return createGitCommitAndPushBuilder(id, {
+                ...options,
+                env: Object.freeze({ ...envMap }),
+            });
+        },
+        toAST() {
+            const resolvedRunner = options.runner !== undefined
+                ? extractAST(options.runner)
+                : Object.freeze({
+                    type: 'node:runner',
+                    id: 'git-default-runner',
+                    slots: 4,
+                    maxDaemons: 2,
+                });
+            const inputSchema = options.inputSchema ?? z.custom(() => true);
+            return Object.freeze({
+                type: 'git:commit-and-push',
+                id,
+                inputSchema,
+                outputSchema: z.void(),
+                branch: options.branch,
+                message: options.message,
+                runner: resolvedRunner,
+                env: options.env,
+            });
+        },
+    });
+}
+//# sourceMappingURL=create-git-commit-and-push-builder.js.map

package/dist/builders/create-git-commit-and-push-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-git-commit-and-push-builder.js","sourceRoot":"","sources":["../../src/builders/create-git-commit-and-push-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,CAAC,GAKF,MAAM,mBAAmB,CAAC;AAI3B;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,6BAA6B,CAC3C,EAAU,EACV,OAAqC;IAErC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAA+B;QACjD,KAAK,CACH,MAA0B;YAE1B,OAAO,6BAA6B,CAAU,EAAE,EAAE;gBAChD,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,WAAW,EAAE,MAAM;gBACnB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,GAAG,EAAE,OAAO,CAAC,GAAG;aACjB,CAAC,CAAC;QACL,CAAC;QACD,MAAM,CAAC,UAAwC;YAC7C,OAAO,6BAA6B,CAAM,EAAE,EAAE;gBAC5C,GAAG,OAAO;gBACV,MAAM,EAAE,UAAU;aACnB,CAAC,CAAC;QACL,CAAC;QACD,GAAG,CAAC,MAAiD;YACnD,OAAO,6BAA6B,CAAM,EAAE,EAAE;gBAC5C,GAAG,OAAO;gBACV,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC;aAClC,CAAC,CAAC;QACL,CAAC;QACD,KAAK;YACH,MAAM,cAAc,GAClB,OAAO,CAAC,MAAM,KAAK,SAAS;gBAC1B,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC;gBAC5B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAiB;oBAC5B,IAAI,EAAE,aAAa;oBACnB,EAAE,EAAE,oBAAoB;oBACxB,KAAK,EAAE,CAAC;oBACR,UAAU,EAAE,CAAC;iBACd,CAAC,CAAC;YACT,MAAM,WAAW,GACf,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,MAAM,CAAM,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACnD,OAAO,MAAM,CAAC,MAAM,CAA4B;gBAC9C,IAAI,EAAE,qBAAqB;gBAC3B,EAAE;gBACF,WAAW;gBACX,YAAY,EAAE,CAAC,CAAC,IAAI,EAAE;gBACtB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,MAAM,EAAE,cAAc;gBACtB,GAAG,EAAE,OAAO,CAAC,GAAG;aACjB,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/builders/create-git-cow-worktree-builder.d.ts

@@ -0,0 +1,15 @@
+import type { GitCowWorktreeBuilder } from './git-cow-worktree-builder.js';
+import type { GitCowWorktreeOptions } from './git-cow-worktree-options.js';
+/**
+ * Creates a fluent `GitCowWorktreeBuilder` (`git.cowWorktree({ repo, dir })`).
+ *
+ * Validates that `repo` and `dir` are non-empty strings at declaration time without performing any filesystem I/O.
+ *
+ * @param {GitCowWorktreeOptions} options - Repository path, worktree base directory, and optional builder state.
+ *
+ * @returns {GitCowWorktreeBuilder} Immutable fluent worktree scope builder.
+ *
+ * @throws {Error} If `options.repo` or `options.dir` is empty.
+ */
+export declare function createGitCowWorktreeBuilder(options: GitCowWorktreeOptions): GitCowWorktreeBuilder;
+//# sourceMappingURL=create-git-cow-worktree-builder.d.ts.map

package/dist/builders/create-git-cow-worktree-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-git-cow-worktree-builder.d.ts","sourceRoot":"","sources":["../../src/builders/create-git-cow-worktree-builder.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,KAAK,EAEV,qBAAqB,EACtB,MAAM,+BAA+B,CAAC;AAOvC;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,qBAAqB,GAC7B,qBAAqB,CAoDvB"}

package/dist/builders/create-git-cow-worktree-builder.js

@@ -0,0 +1,64 @@
+import { extractAST, } from '@paraharness/core';
+import { buildGitCowWorktreeNode, resolveReconcileStrategyConfig, } from './internal/build-git-cow-worktree-node.js';
+/**
+ * Creates a fluent `GitCowWorktreeBuilder` (`git.cowWorktree({ repo, dir })`).
+ *
+ * Validates that `repo` and `dir` are non-empty strings at declaration time without performing any filesystem I/O.
+ *
+ * @param {GitCowWorktreeOptions} options - Repository path, worktree base directory, and optional builder state.
+ *
+ * @returns {GitCowWorktreeBuilder} Immutable fluent worktree scope builder.
+ *
+ * @throws {Error} If `options.repo` or `options.dir` is empty.
+ */
+export function createGitCowWorktreeBuilder(options) {
+    if (options.repo.trim().length === 0) {
+        throw new Error("git.cowWorktree: 'repo' must be a non-empty repository path.");
+    }
+    if (options.dir.trim().length === 0) {
+        throw new Error("git.cowWorktree: 'dir' must be a non-empty worktree base directory.");
+    }
+    return Object.freeze({
+        excludeFromCloneGlobs(globs) {
+            return createGitCowWorktreeBuilder({
+                ...options,
+                excludeFromCloneGlobs: Object.freeze([...globs]),
+            });
+        },
+        setup(...commands) {
+            const nextSetup = [...(options.setupCommands ?? [])];
+            for (const command of commands) {
+                nextSetup.push(extractAST(command));
+            }
+            return createGitCowWorktreeBuilder({
+                ...options,
+                setupCommands: Object.freeze(nextSetup),
+            });
+        },
+        lockfileGate(lockfilePath) {
+            if (lockfilePath.trim().length === 0) {
+                throw new Error("git.cowWorktree.lockfileGate: 'lockfilePath' must be non-empty.");
+            }
+            return createGitCowWorktreeBuilder({
+                ...options,
+                lockfileGatePath: lockfilePath,
+            });
+        },
+        checkpointPolicy(policy) {
+            return createGitCowWorktreeBuilder({
+                ...options,
+                checkpointPolicy: policy,
+            });
+        },
+        reconcileStrategy(modeOrOptions, strategyOptions) {
+            return createGitCowWorktreeBuilder({
+                ...options,
+                reconcileStrategy: resolveReconcileStrategyConfig(modeOrOptions, strategyOptions),
+            });
+        },
+        toAST() {
+            return buildGitCowWorktreeNode(options);
+        },
+    });
+}
+//# sourceMappingURL=create-git-cow-worktree-builder.js.map

package/dist/builders/create-git-cow-worktree-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-git-cow-worktree-builder.js","sourceRoot":"","sources":["../../src/builders/create-git-cow-worktree-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,GAOX,MAAM,mBAAmB,CAAC;AAO3B,OAAO,EACL,uBAAuB,EACvB,8BAA8B,GAC/B,MAAM,2CAA2C,CAAC;AAEnD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAA8B;IAE9B,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAwB;QAC1C,qBAAqB,CAAC,KAAwB;YAC5C,OAAO,2BAA2B,CAAC;gBACjC,GAAG,OAAO;gBACV,qBAAqB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;aACjD,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,GAAG,QAA8C;YACrD,MAAM,SAAS,GAAc,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC;YAChE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;YACtC,CAAC;YACD,OAAO,2BAA2B,CAAC;gBACjC,GAAG,OAAO;gBACV,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;aACxC,CAAC,CAAC;QACL,CAAC;QACD,YAAY,CAAC,YAAoB;YAC/B,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACrC,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;YACrF,CAAC;YACD,OAAO,2BAA2B,CAAC;gBACjC,GAAG,OAAO;gBACV,gBAAgB,EAAE,YAAY;aAC/B,CAAC,CAAC;QACL,CAAC;QACD,gBAAgB,CAAC,MAAsC;YACrD,OAAO,2BAA2B,CAAC;gBACjC,GAAG,OAAO;gBACV,gBAAgB,EAAE,MAAM;aACzB,CAAC,CAAC;QACL,CAAC;QACD,iBAAiB,CACf,aAAqF,EACrF,eAA6C;YAE7C,OAAO,2BAA2B,CAAC;gBACjC,GAAG,OAAO;gBACV,iBAAiB,EAAE,8BAA8B,CAAC,aAAa,EAAE,eAAe,CAAC;aAClF,CAAC,CAAC;QACL,CAAC;QACD,KAAK;YACH,OAAO,uBAAuB,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/builders/create-git-discard-branch-builder.d.ts

@@ -0,0 +1,13 @@
+import type { AstBuilder, GitDiscardBranchNode } from '@paraharness/core';
+/**
+ * Creates a fluent `AstBuilder<GitDiscardBranchNode>` (`git.discardBranch()`).
+ *
+ * Alias for `createGitResetWorktreeBuilder` compiling to a passive `GitDiscardBranchNode`
+ * (`type: 'git:discard-branch'`, `resetsRunOverlay: true`).
+ *
+ * @param {string} [id='git-discard-branch'] - Optional custom identifier for the rewind hook node.
+ *
+ * @returns {AstBuilder<GitDiscardBranchNode>} Immutable rewind hook builder instance.
+ */
+export declare function createGitDiscardBranchBuilder(id?: string): AstBuilder<GitDiscardBranchNode>;
+//# sourceMappingURL=create-git-discard-branch-builder.d.ts.map

package/dist/builders/create-git-discard-branch-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-git-discard-branch-builder.d.ts","sourceRoot":"","sources":["../../src/builders/create-git-discard-branch-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE1E;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAC3C,EAAE,SAAuB,GACxB,UAAU,CAAC,oBAAoB,CAAC,CAUlC"}

package/dist/builders/create-git-discard-branch-builder.js

@@ -0,0 +1,22 @@
+/**
+ * Creates a fluent `AstBuilder<GitDiscardBranchNode>` (`git.discardBranch()`).
+ *
+ * Alias for `createGitResetWorktreeBuilder` compiling to a passive `GitDiscardBranchNode`
+ * (`type: 'git:discard-branch'`, `resetsRunOverlay: true`).
+ *
+ * @param {string} [id='git-discard-branch'] - Optional custom identifier for the rewind hook node.
+ *
+ * @returns {AstBuilder<GitDiscardBranchNode>} Immutable rewind hook builder instance.
+ */
+export function createGitDiscardBranchBuilder(id = 'git-discard-branch') {
+    return Object.freeze({
+        toAST() {
+            return Object.freeze({
+                type: 'git:discard-branch',
+                id,
+                resetsRunOverlay: true,
+            });
+        },
+    });
+}
+//# sourceMappingURL=create-git-discard-branch-builder.js.map

package/dist/builders/create-git-discard-branch-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-git-discard-branch-builder.js","sourceRoot":"","sources":["../../src/builders/create-git-discard-branch-builder.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,UAAU,6BAA6B,CAC3C,EAAE,GAAG,oBAAoB;IAEzB,OAAO,MAAM,CAAC,MAAM,CAAmC;QACrD,KAAK;YACH,OAAO,MAAM,CAAC,MAAM,CAAuB;gBACzC,IAAI,EAAE,oBAAoB;gBAC1B,EAAE;gBACF,gBAAgB,EAAE,IAAI;aACvB,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/builders/create-git-keep-worktree-builder.d.ts

@@ -0,0 +1,13 @@
+import type { AstBuilder, GitKeepWorktreeNode } from '@paraharness/core';
+/**
+ * Creates a fluent `AstBuilder<GitKeepWorktreeNode>` (`git.keepWorktree()`).
+ *
+ * Compiles into a passive `GitKeepWorktreeNode` (`type: 'git:keep-worktree'`, `resetsRunOverlay: false`)
+ * that preserves the active worktree and uncommitted topology overlay across a `.rewindTo()` signal.
+ *
+ * @param {string} [id='git-keep-worktree'] - Optional custom identifier for the rewind hook node.
+ *
+ * @returns {AstBuilder<GitKeepWorktreeNode>} Immutable rewind hook builder instance.
+ */
+export declare function createGitKeepWorktreeBuilder(id?: string): AstBuilder<GitKeepWorktreeNode>;
+//# sourceMappingURL=create-git-keep-worktree-builder.d.ts.map

package/dist/builders/create-git-keep-worktree-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-git-keep-worktree-builder.d.ts","sourceRoot":"","sources":["../../src/builders/create-git-keep-worktree-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAEzE;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,EAAE,SAAsB,GACvB,UAAU,CAAC,mBAAmB,CAAC,CAUjC"}

package/dist/builders/create-git-keep-worktree-builder.js

@@ -0,0 +1,22 @@
+/**
+ * Creates a fluent `AstBuilder<GitKeepWorktreeNode>` (`git.keepWorktree()`).
+ *
+ * Compiles into a passive `GitKeepWorktreeNode` (`type: 'git:keep-worktree'`, `resetsRunOverlay: false`)
+ * that preserves the active worktree and uncommitted topology overlay across a `.rewindTo()` signal.
+ *
+ * @param {string} [id='git-keep-worktree'] - Optional custom identifier for the rewind hook node.
+ *
+ * @returns {AstBuilder<GitKeepWorktreeNode>} Immutable rewind hook builder instance.
+ */
+export function createGitKeepWorktreeBuilder(id = 'git-keep-worktree') {
+    return Object.freeze({
+        toAST() {
+            return Object.freeze({
+                type: 'git:keep-worktree',
+                id,
+                resetsRunOverlay: false,
+            });
+        },
+    });
+}
+//# sourceMappingURL=create-git-keep-worktree-builder.js.map

package/dist/builders/create-git-keep-worktree-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-git-keep-worktree-builder.js","sourceRoot":"","sources":["../../src/builders/create-git-keep-worktree-builder.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,UAAU,4BAA4B,CAC1C,EAAE,GAAG,mBAAmB;IAExB,OAAO,MAAM,CAAC,MAAM,CAAkC;QACpD,KAAK;YACH,OAAO,MAAM,CAAC,MAAM,CAAsB;gBACxC,IAAI,EAAE,mBAAmB;gBACzB,EAAE;gBACF,gBAAgB,EAAE,KAAK;aACxB,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/builders/create-git-merge-queue-builder.d.ts

@@ -0,0 +1,19 @@
+import type { GitMergeQueueBuilder } from './git-merge-queue-builder.js';
+import type { GitMergeQueueOptions } from './git-merge-queue-options.js';
+/**
+ * Creates a fluent `GitMergeQueueBuilder` (`git.mergeQueue(id, options)`).
+ *
+ * Compiles into a passive `GitMergeQueueNode<TIn, TOut>` configuring cumulative merge-train batching and binary bisection.
+ *
+ * @template TIn  Validated step input type.
+ * @template TOut Validated step output type.
+ *
+ * @param {string}                          id      - Unique merge queue step identifier.
+ * @param {GitMergeQueueOptions<TIn, TOut>} options - Target branch, batch size, and verification check configuration.
+ *
+ * @returns {GitMergeQueueBuilder<TIn, TOut>} Immutable fluent `GitMergeQueueBuilder` instance.
+ *
+ * @throws {Error} If `id` is empty or `maxBatchSize` is not a positive integer.
+ */
+export declare function createGitMergeQueueBuilder<TIn = unknown, TOut = unknown>(id: string, options: GitMergeQueueOptions<TIn, TOut>): GitMergeQueueBuilder<TIn, TOut>;
+//# sourceMappingURL=create-git-merge-queue-builder.d.ts.map

package/dist/builders/create-git-merge-queue-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-git-merge-queue-builder.d.ts","sourceRoot":"","sources":["../../src/builders/create-git-merge-queue-builder.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEzE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,GAAG,OAAO,EAAE,IAAI,GAAG,OAAO,EACtE,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,oBAAoB,CAAC,GAAG,EAAE,IAAI,CAAC,GACvC,oBAAoB,CAAC,GAAG,EAAE,IAAI,CAAC,CA+CjC"}

package/dist/builders/create-git-merge-queue-builder.js

@@ -0,0 +1,59 @@
+import { extractAST, z, } from '@paraharness/core';
+/**
+ * Creates a fluent `GitMergeQueueBuilder` (`git.mergeQueue(id, options)`).
+ *
+ * Compiles into a passive `GitMergeQueueNode<TIn, TOut>` configuring cumulative merge-train batching and binary bisection.
+ *
+ * @template TIn  Validated step input type.
+ * @template TOut Validated step output type.
+ *
+ * @param {string}                          id      - Unique merge queue step identifier.
+ * @param {GitMergeQueueOptions<TIn, TOut>} options - Target branch, batch size, and verification check configuration.
+ *
+ * @returns {GitMergeQueueBuilder<TIn, TOut>} Immutable fluent `GitMergeQueueBuilder` instance.
+ *
+ * @throws {Error} If `id` is empty or `maxBatchSize` is not a positive integer.
+ */
+export function createGitMergeQueueBuilder(id, options) {
+    if (id.trim().length === 0) {
+        throw new Error("git.mergeQueue: 'id' must be a non-empty string.");
+    }
+    const maxBatchSize = options.maxBatchSize ?? 4;
+    if (!Number.isInteger(maxBatchSize) || maxBatchSize < 1) {
+        throw new Error(`git.mergeQueue: 'maxBatchSize' must be a positive integer (received ${maxBatchSize}).`);
+    }
+    return Object.freeze({
+        input(schema) {
+            return createGitMergeQueueBuilder(id, {
+                targetBranch: options.targetBranch,
+                maxBatchSize: options.maxBatchSize,
+                verifyWith: options.verifyWith,
+                inputSchema: schema,
+                outputSchema: options.outputSchema,
+            });
+        },
+        output(schema) {
+            return createGitMergeQueueBuilder(id, {
+                targetBranch: options.targetBranch,
+                maxBatchSize: options.maxBatchSize,
+                verifyWith: options.verifyWith,
+                inputSchema: options.inputSchema,
+                outputSchema: schema,
+            });
+        },
+        toAST() {
+            const inputSchema = options.inputSchema ?? z.custom(() => true);
+            const outputSchema = options.outputSchema ?? z.custom(() => true);
+            return Object.freeze({
+                type: 'git:merge-queue',
+                id,
+                inputSchema,
+                outputSchema,
+                targetBranch: options.targetBranch ?? 'main',
+                maxBatchSize,
+                verifyWith: extractAST(options.verifyWith),
+            });
+        },
+    });
+}
+//# sourceMappingURL=create-git-merge-queue-builder.js.map

package/dist/builders/create-git-merge-queue-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-git-merge-queue-builder.js","sourceRoot":"","sources":["../../src/builders/create-git-merge-queue-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,CAAC,GAEF,MAAM,mBAAmB,CAAC;AAI3B;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,0BAA0B,CACxC,EAAU,EACV,OAAwC;IAExC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,uEAAuE,YAAY,IAAI,CAAC,CAAC;IAC3G,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAkC;QACpD,KAAK,CACH,MAA0B;YAE1B,OAAO,0BAA0B,CAAgB,EAAE,EAAE;gBACnD,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,WAAW,EAAE,MAAM;gBACnB,YAAY,EAAE,OAAO,CAAC,YAAY;aACnC,CAAC,CAAC;QACL,CAAC;QACD,MAAM,CACJ,MAA2B;YAE3B,OAAO,0BAA0B,CAAgB,EAAE,EAAE;gBACnD,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,YAAY,EAAE,MAAM;aACrB,CAAC,CAAC;QACL,CAAC;QACD,KAAK;YACH,MAAM,WAAW,GACf,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,MAAM,CAAM,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACnD,MAAM,YAAY,GAChB,OAAO,CAAC,YAAY,IAAI,CAAC,CAAC,MAAM,CAAO,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACrD,OAAO,MAAM,CAAC,MAAM,CAA+B;gBACjD,IAAI,EAAE,iBAAiB;gBACvB,EAAE;gBACF,WAAW;gBACX,YAAY;gBACZ,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,MAAM;gBAC5C,YAAY;gBACZ,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC;aAC3C,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/builders/create-git-patch-equivalence-builder.d.ts

@@ -0,0 +1,13 @@
+import { type CrossVerifierBuilder, type GitPatchEquivalenceNode, type GitScopeReceipt, type GitWorktreeHandle } from '@paraharness/core';
+/**
+ * Creates a `CrossVerifierBuilder` for normalized patch equivalence clustering (`git.patchEquivalence`).
+ *
+ * Exposes `.id`, `.reportSchema`, and `.toAST()` producing a passive `GitPatchEquivalenceNode`
+ * that groups surviving speculative branches with equivalent normalized diffs into equivalence classes.
+ *
+ * @param {string} [id='git-patch-equivalence'] - Optional unique identifier for the cross-verifier node.
+ *
+ * @returns {CrossVerifierBuilder<GitWorktreeHandle, GitScopeReceipt, Record<string, unknown>, GitPatchEquivalenceNode>} Immutable cross-verifier builder.
+ */
+export declare function createGitPatchEquivalenceBuilder(id?: string): CrossVerifierBuilder<GitWorktreeHandle, GitScopeReceipt, Record<string, unknown>, GitPatchEquivalenceNode>;
+//# sourceMappingURL=create-git-patch-equivalence-builder.d.ts.map

package/dist/builders/create-git-patch-equivalence-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-git-patch-equivalence-builder.d.ts","sourceRoot":"","sources":["../../src/builders/create-git-patch-equivalence-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;GASG;AACH,wBAAgB,gCAAgC,CAC9C,EAAE,SAA0B,GAC3B,oBAAoB,CACrB,iBAAiB,EACjB,eAAe,EACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvB,uBAAuB,CACxB,CA0BA"}

package/dist/builders/create-git-patch-equivalence-builder.js

@@ -0,0 +1,32 @@
+import { z, } from '@paraharness/core';
+/**
+ * Creates a `CrossVerifierBuilder` for normalized patch equivalence clustering (`git.patchEquivalence`).
+ *
+ * Exposes `.id`, `.reportSchema`, and `.toAST()` producing a passive `GitPatchEquivalenceNode`
+ * that groups surviving speculative branches with equivalent normalized diffs into equivalence classes.
+ *
+ * @param {string} [id='git-patch-equivalence'] - Optional unique identifier for the cross-verifier node.
+ *
+ * @returns {CrossVerifierBuilder<GitWorktreeHandle, GitScopeReceipt, Record<string, unknown>, GitPatchEquivalenceNode>} Immutable cross-verifier builder.
+ */
+export function createGitPatchEquivalenceBuilder(id = 'git-patch-equivalence') {
+    const reportSchema = z
+        .object({
+        equivalenceGroupIndex: z.number(),
+        equivalentBranchIndices: z.array(z.number()),
+        normalizedPatchDigest: z.string(),
+    })
+        .passthrough();
+    return Object.freeze({
+        id,
+        reportSchema,
+        toAST() {
+            return Object.freeze({
+                type: 'git:patch-equivalence',
+                id,
+                reportSchema,
+            });
+        },
+    });
+}
+//# sourceMappingURL=create-git-patch-equivalence-builder.js.map

package/dist/builders/create-git-patch-equivalence-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-git-patch-equivalence-builder.js","sourceRoot":"","sources":["../../src/builders/create-git-patch-equivalence-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,CAAC,GAKF,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;GASG;AACH,MAAM,UAAU,gCAAgC,CAC9C,EAAE,GAAG,uBAAuB;IAO5B,MAAM,YAAY,GAAuC,CAAC;SACvD,MAAM,CAAC;QACN,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE;QACjC,uBAAuB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC5C,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE;KAClC,CAAC;SACD,WAAW,EAAE,CAAC;IACjB,OAAO,MAAM,CAAC,MAAM,CAOlB;QACA,EAAE;QACF,YAAY;QACZ,KAAK;YACH,OAAO,MAAM,CAAC,MAAM,CAA0B;gBAC5C,IAAI,EAAE,uBAAuB;gBAC7B,EAAE;gBACF,YAAY;aACb,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/builders/create-git-public-surface-cross-tester-builder.d.ts

@@ -0,0 +1,14 @@
+import { type CrossVerifierBuilder, type GitPublicSurfaceCrossTesterNode, type GitScopeReceipt, type GitWorktreeHandle } from '@paraharness/core';
+import type { GitPublicSurfaceCrossTesterOptions } from './git-public-surface-cross-tester-options.js';
+/**
+ * Creates a `CrossVerifierBuilder` for AST-gated public-boundary cross-testing (`git.publicSurfaceCrossTester`).
+ *
+ * Exposes `.id`, `.reportSchema`, and `.toAST()` producing a passive `GitPublicSurfaceCrossTesterNode`
+ * that transplants boundary-only tests across surviving speculative candidate branches.
+ *
+ * @param {GitPublicSurfaceCrossTesterOptions} options - Runner pool and filesystem partition map configuration.
+ *
+ * @returns {CrossVerifierBuilder<GitWorktreeHandle, GitScopeReceipt, Record<string, unknown>, GitPublicSurfaceCrossTesterNode>} Immutable cross-verifier builder.
+ */
+export declare function createGitPublicSurfaceCrossTesterBuilder(options: GitPublicSurfaceCrossTesterOptions): CrossVerifierBuilder<GitWorktreeHandle, GitScopeReceipt, Record<string, unknown>, GitPublicSurfaceCrossTesterNode>;
+//# sourceMappingURL=create-git-public-surface-cross-tester-builder.d.ts.map

package/dist/builders/create-git-public-surface-cross-tester-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-git-public-surface-cross-tester-builder.d.ts","sourceRoot":"","sources":["../../src/builders/create-git-public-surface-cross-tester-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,+BAA+B,EACpC,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,8CAA8C,CAAC;AAEvG;;;;;;;;;GASG;AACH,wBAAgB,wCAAwC,CACtD,OAAO,EAAE,kCAAkC,GAC1C,oBAAoB,CACrB,iBAAiB,EACjB,eAAe,EACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvB,+BAA+B,CAChC,CA8BA"}