@paraharness/git 0.0.0-stage → 0.1.0

package/dist/builders/git-namespace-contract.d.ts

@@ -0,0 +1,141 @@
+import type { AstBuilder, CrossVerifierBuilder, GitCandidateComparisonToolNode, GitDiscardBranchNode, GitKeepWorktreeNode, GitPatchEquivalenceNode, GitPublicSurfaceCrossTesterNode, GitRefReaderToolNode, GitScopeReceipt, GitSnapshotAndResetNode, GitWorktreeHandle, MaybeBuilder, NodeRunnerNode } from '@paraharness/core';
+import type { GitAbortMetaSchema, GitScopeReceiptSchema, GitSyncReceiptSchema } from '../schemas/git-receipts.schema.js';
+import type { GitCommitAndPushBuilder } from './git-commit-and-push-builder.js';
+import type { GitCommitAndPushOptions } from './git-commit-and-push-options.js';
+import type { GitCowWorktreeBuilder } from './git-cow-worktree-builder.js';
+import type { GitCowWorktreeOptions } from './git-cow-worktree-options.js';
+import type { GitMergeQueueBuilder } from './git-merge-queue-builder.js';
+import type { GitMergeQueueOptions } from './git-merge-queue-options.js';
+import type { GitPublicSurfaceCrossTesterOptions } from './git-public-surface-cross-tester-options.js';
+/**
+ * Public `git` builder and schema namespace contract (`import { git } from '@paraharness/git'`).
+ *
+ * Mounts `ScopeReceiptSchema`, `SyncReceiptSchema`, `AbortMetaSchema`, and all declarative
+ * Copy-on-Write worktree, hook, cross-verifier, tool, and delivery step builders.
+ */
+export interface GitNamespace {
+    /** Zod schema validating `GitScopeReceipt` objects returned by `inspect()` and `commitChild()`. */
+    readonly ScopeReceiptSchema: typeof GitScopeReceiptSchema;
+    /** Zod schema validating `GitSyncReceipt` objects returned by `syncChild()` and `syncRoot()`. */
+    readonly SyncReceiptSchema: typeof GitSyncReceiptSchema;
+    /** Zod schema validating `GitAbortMeta` objects returned by `git.snapshotAndReset()`. */
+    readonly AbortMetaSchema: typeof GitAbortMetaSchema;
+    /**
+     * Creates a fluent builder for a Tier-3 branchable Copy-on-Write Git worktree scope.
+     *
+     * Provisions disjoint sibling `<dir>/roots/<runId>` and `<dir>/forks/<runId>/<forkId>` worktrees at runtime.
+     *
+     * @param {GitCowWorktreeOptions} options - Host repository path and worktree base directory.
+     *
+     * @returns {GitCowWorktreeBuilder} Immutable fluent worktree scope builder.
+     */
+    cowWorktree(options: GitCowWorktreeOptions): GitCowWorktreeBuilder;
+    /**
+     * Creates a fluent builder for a retry-safe squash, rebase, verify, and push step.
+     *
+     * Compiles into a passive `GitCommitAndPushNode<TIn>` dispatched via `RuntimeExecutorRegistry.steps`.
+     *
+     * @template TIn Step input payload type.
+     *
+     * @param {string}                       id      - Unique step node identifier.
+     * @param {GitCommitAndPushOptions<TIn>} options - Remote branch and commit message projections.
+     *
+     * @returns {GitCommitAndPushBuilder<TIn>} Immutable fluent commit-and-push step builder.
+     */
+    commitAndPush<TIn = unknown>(id: string, options: GitCommitAndPushOptions<TIn>): GitCommitAndPushBuilder<TIn>;
+    /**
+     * Creates a fluent builder for a cumulative batch merge-train verification step.
+     *
+     * Constructs a speculative rebase chain $R_1 \dots R_k$ up to `maxBatchSize` and binary-bisects on failure.
+     *
+     * @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.
+     *
+     * @returns {GitMergeQueueBuilder<TIn, TOut>} Immutable fluent merge queue step builder.
+     */
+    mergeQueue<TIn = unknown, TOut = unknown>(id: string, options: GitMergeQueueOptions<TIn, TOut>): GitMergeQueueBuilder<TIn, TOut>;
+    /**
+     * Creates an idempotent abort hook builder snapshotting the dirty worktree to `refs/harness/aborted/<run-id>/<stepExecId>`.
+     *
+     * Resets the working tree to `handle.baseRef` and clears `unresolvedConflictPaths` after snapshotting.
+     *
+     * @param {string} [id] - Optional custom abort hook identifier.
+     *
+     * @returns {AstBuilder<GitSnapshotAndResetNode>} Immutable abort hook builder.
+     */
+    snapshotAndReset(id?: string): AstBuilder<GitSnapshotAndResetNode>;
+    /**
+     * Creates a rewind hook builder preserving the active worktree and topology overlay in-place (`resetsRunOverlay: false`).
+     *
+     * Used with `.rewindTo(stepId, { onRewind: git.keepWorktree() })` for live steering without discarding work.
+     *
+     * @param {string} [id] - Optional custom rewind hook identifier.
+     *
+     * @returns {AstBuilder<GitKeepWorktreeNode>} Immutable rewind hook builder.
+     */
+    keepWorktree(id?: string): AstBuilder<GitKeepWorktreeNode>;
+    /**
+     * Creates a rewind hook builder resetting the worktree to `targetStepBaseScopeCheckpoint` (`resetsRunOverlay: true`).
+     *
+     * Restores both the physical working tree and the run's Copy-on-Write topology overlay to the target step entry.
+     *
+     * @param {string} [id] - Optional custom rewind hook identifier.
+     *
+     * @returns {AstBuilder<GitDiscardBranchNode>} Immutable rewind hook builder.
+     */
+    resetWorktree(id?: string): AstBuilder<GitDiscardBranchNode>;
+    /**
+     * Alias for `git.resetWorktree()` compiling to `GitDiscardBranchNode` (`resetsRunOverlay: true`).
+     *
+     * Restores the worktree to `targetStepBaseScopeCheckpoint` and discards uncommitted overlay mutations.
+     *
+     * @param {string} [id] - Optional custom rewind hook identifier.
+     *
+     * @returns {AstBuilder<GitDiscardBranchNode>} Immutable rewind hook builder.
+     */
+    discardBranch(id?: string): AstBuilder<GitDiscardBranchNode>;
+    /**
+     * Creates a `CrossVerifierBuilder` transplanting boundary-only tests across speculative worktree candidates.
+     *
+     * Parses test imports against `partitionMap.partitions[*].boundaryGlobs` and cross-executes eligible tests.
+     *
+     * @param {GitPublicSurfaceCrossTesterOptions} options - Subprocess runner and partition map configuration.
+     *
+     * @returns {CrossVerifierBuilder<GitWorktreeHandle, GitScopeReceipt, Record<string, unknown>, GitPublicSurfaceCrossTesterNode>} Immutable cross-verifier builder.
+     */
+    publicSurfaceCrossTester(options: GitPublicSurfaceCrossTesterOptions): CrossVerifierBuilder<GitWorktreeHandle, GitScopeReceipt, Record<string, unknown>, GitPublicSurfaceCrossTesterNode>;
+    /**
+     * Creates a `CrossVerifierBuilder` grouping speculative candidates by normalized patch equivalence.
+     *
+     * Computes canonicalized patch digests and equivalence classes across surviving tournament branches.
+     *
+     * @param {string} [id] - Optional custom cross-verifier identifier.
+     *
+     * @returns {CrossVerifierBuilder<GitWorktreeHandle, GitScopeReceipt, Record<string, unknown>, GitPatchEquivalenceNode>} Immutable cross-verifier builder.
+     */
+    patchEquivalence(id?: string): CrossVerifierBuilder<GitWorktreeHandle, GitScopeReceipt, Record<string, unknown>, GitPatchEquivalenceNode>;
+    /**
+     * Creates the read-only git ref inspection tool bundle (`readRefFile`, `diffRefs`, `listRefFiles`).
+     *
+     * Enables actors to inspect `refs/harness/aborted/<run-id>/<stepExecId>` snapshots against the object store.
+     *
+     * @param {MaybeBuilder<NodeRunnerNode>} runner - Subprocess runner pool governing git command slots.
+     *
+     * @returns {readonly GitRefReaderToolNode<GitWorktreeHandle>[]} Frozen tuple of ref reader tool AST nodes.
+     */
+    refReaderTools(runner: MaybeBuilder<NodeRunnerNode>): readonly GitRefReaderToolNode<GitWorktreeHandle>[];
+    /**
+     * Creates the speculative candidate comparison tool bundle (`diffCandidates`, `readCandidateFile`, `evalInCandidates`).
+     *
+     * Enables `candidateArbiter` and `.refineWinnerWhen()` to compare candidate refs and run sandboxed benchmarks.
+     *
+     * @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.
+     */
+    candidateComparisonTools(runner: MaybeBuilder<NodeRunnerNode>): readonly GitCandidateComparisonToolNode<GitWorktreeHandle>[];
+}
+//# sourceMappingURL=git-namespace-contract.d.ts.map

package/dist/builders/git-namespace-contract.d.ts.map

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

package/dist/builders/git-namespace-contract.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=git-namespace-contract.js.map

package/dist/builders/git-namespace-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-namespace-contract.js","sourceRoot":"","sources":["../../src/builders/git-namespace-contract.ts"],"names":[],"mappings":""}

package/dist/builders/git-namespace.d.ts

@@ -0,0 +1,6 @@
+import type { GitNamespace } from './git-namespace-contract.js';
+/**
+ * Frozen `git` DSL builder and receipt schema namespace (`@paraharness/git`).
+ */
+export declare const git: GitNamespace;
+//# sourceMappingURL=git-namespace.d.ts.map

package/dist/builders/git-namespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-namespace.d.ts","sourceRoot":"","sources":["../../src/builders/git-namespace.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,GAAG,EAAE,YAehB,CAAC"}

package/dist/builders/git-namespace.js

@@ -0,0 +1,32 @@
+import { GitAbortMetaSchema, GitScopeReceiptSchema, GitSyncReceiptSchema, } from '../schemas/git-receipts.schema.js';
+import { createGitCandidateComparisonTools } from './create-git-candidate-comparison-tools.js';
+import { createGitCommitAndPushBuilder } from './create-git-commit-and-push-builder.js';
+import { createGitCowWorktreeBuilder } from './create-git-cow-worktree-builder.js';
+import { createGitDiscardBranchBuilder } from './create-git-discard-branch-builder.js';
+import { createGitKeepWorktreeBuilder } from './create-git-keep-worktree-builder.js';
+import { createGitMergeQueueBuilder } from './create-git-merge-queue-builder.js';
+import { createGitPatchEquivalenceBuilder } from './create-git-patch-equivalence-builder.js';
+import { createGitPublicSurfaceCrossTesterBuilder } from './create-git-public-surface-cross-tester-builder.js';
+import { createGitRefReaderTools } from './create-git-ref-reader-tools.js';
+import { createGitResetWorktreeBuilder } from './create-git-reset-worktree-builder.js';
+import { createGitSnapshotAndResetBuilder } from './create-git-snapshot-and-reset-builder.js';
+/**
+ * Frozen `git` DSL builder and receipt schema namespace (`@paraharness/git`).
+ */
+export const git = Object.freeze({
+    ScopeReceiptSchema: GitScopeReceiptSchema,
+    SyncReceiptSchema: GitSyncReceiptSchema,
+    AbortMetaSchema: GitAbortMetaSchema,
+    cowWorktree: createGitCowWorktreeBuilder,
+    commitAndPush: createGitCommitAndPushBuilder,
+    mergeQueue: createGitMergeQueueBuilder,
+    snapshotAndReset: createGitSnapshotAndResetBuilder,
+    keepWorktree: createGitKeepWorktreeBuilder,
+    resetWorktree: createGitResetWorktreeBuilder,
+    discardBranch: createGitDiscardBranchBuilder,
+    publicSurfaceCrossTester: createGitPublicSurfaceCrossTesterBuilder,
+    patchEquivalence: createGitPatchEquivalenceBuilder,
+    refReaderTools: createGitRefReaderTools,
+    candidateComparisonTools: createGitCandidateComparisonTools,
+});
+//# sourceMappingURL=git-namespace.js.map

package/dist/builders/git-namespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-namespace.js","sourceRoot":"","sources":["../../src/builders/git-namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,iCAAiC,EAAE,MAAM,4CAA4C,CAAC;AAC/F,OAAO,EAAE,6BAA6B,EAAE,MAAM,yCAAyC,CAAC;AACxF,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,6BAA6B,EAAE,MAAM,wCAAwC,CAAC;AACvF,OAAO,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAC;AACrF,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,EAAE,gCAAgC,EAAE,MAAM,2CAA2C,CAAC;AAC7F,OAAO,EAAE,wCAAwC,EAAE,MAAM,qDAAqD,CAAC;AAC/G,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,6BAA6B,EAAE,MAAM,wCAAwC,CAAC;AACvF,OAAO,EAAE,gCAAgC,EAAE,MAAM,4CAA4C,CAAC;AAG9F;;GAEG;AACH,MAAM,CAAC,MAAM,GAAG,GAAiB,MAAM,CAAC,MAAM,CAAe;IAC3D,kBAAkB,EAAE,qBAAqB;IACzC,iBAAiB,EAAE,oBAAoB;IACvC,eAAe,EAAE,kBAAkB;IACnC,WAAW,EAAE,2BAA2B;IACxC,aAAa,EAAE,6BAA6B;IAC5C,UAAU,EAAE,0BAA0B;IACtC,gBAAgB,EAAE,gCAAgC;IAClD,YAAY,EAAE,4BAA4B;IAC1C,aAAa,EAAE,6BAA6B;IAC5C,aAAa,EAAE,6BAA6B;IAC5C,wBAAwB,EAAE,wCAAwC;IAClE,gBAAgB,EAAE,gCAAgC;IAClD,cAAc,EAAE,uBAAuB;IACvC,wBAAwB,EAAE,iCAAiC;CAC5D,CAAC,CAAC"}

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

@@ -0,0 +1,16 @@
+import type { FsPartitionMapNode, MaybeBuilder, NodeRunnerNode } from '@paraharness/core';
+/**
+ * Configuration options for `git.publicSurfaceCrossTester(options)` (`createGitPublicSurfaceCrossTesterBuilder`).
+ *
+ * Binds the subprocess `runner` pool and `partitionMap` whose `boundaryGlobs` identify public surface
+ * contracts for cross-candidate test transplantation.
+ */
+export interface GitPublicSurfaceCrossTesterOptions {
+    /** Optional unique identifier for the cross-verifier node (defaults to `'git-public-surface-cross-tester'`). */
+    readonly id?: string;
+    /** Runner pool governing subprocess slot concurrency during cross-testing. */
+    readonly runner: MaybeBuilder<NodeRunnerNode>;
+    /** Filesystem partition map defining public `boundaryGlobs` per partition. */
+    readonly partitionMap: MaybeBuilder<FsPartitionMapNode<string>>;
+}
+//# sourceMappingURL=git-public-surface-cross-tester-options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git-public-surface-cross-tester-options.d.ts","sourceRoot":"","sources":["../../src/builders/git-public-surface-cross-tester-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACf,MAAM,mBAAmB,CAAC;AAE3B;;;;;GAKG;AACH,MAAM,WAAW,kCAAkC;IACjD,gHAAgH;IAChH,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC;IAC9C,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;CACjE"}

package/dist/builders/git-public-surface-cross-tester-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=git-public-surface-cross-tester-options.js.map

package/dist/builders/git-public-surface-cross-tester-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-public-surface-cross-tester-options.js","sourceRoot":"","sources":["../../src/builders/git-public-surface-cross-tester-options.ts"],"names":[],"mappings":""}

package/dist/builders/git-reconcile-strategy-options.d.ts

@@ -0,0 +1,16 @@
+import type { BaseCheckASTNode, GitWorktreeHandle, MaybeBuilder } from '@paraharness/core';
+/**
+ * Options for configuring branch landing reconciliation via `GitCowWorktreeBuilder.reconcileStrategy()`.
+ *
+ * Supports both `'rebase-onto-base'` (for PR-opening lanes) and `'batch-merge-train'` (for cumulative
+ * speculative merge queues), optionally binding a post-rebase verification check and maximum batch size.
+ */
+export interface GitReconcileStrategyOptions {
+    /** Reconciliation mode when passed via the single-object `.reconcileStrategy(options)` overload. */
+    readonly mode?: 'rebase-onto-base' | 'batch-merge-train';
+    /** Optional deterministic check executed after rebasing onto the target base branch. */
+    readonly verifyWith?: MaybeBuilder<BaseCheckASTNode<string, GitWorktreeHandle>>;
+    /** Optional maximum cumulative batch size when using `'batch-merge-train'`. */
+    readonly maxBatchSize?: number;
+}
+//# sourceMappingURL=git-reconcile-strategy-options.d.ts.map

package/dist/builders/git-reconcile-strategy-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-reconcile-strategy-options.d.ts","sourceRoot":"","sources":["../../src/builders/git-reconcile-strategy-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE3F;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC1C,oGAAoG;IACpG,QAAQ,CAAC,IAAI,CAAC,EAAE,kBAAkB,GAAG,mBAAmB,CAAC;IACzD,wFAAwF;IACxF,QAAQ,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAChF,+EAA+E;IAC/E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC"}

package/dist/builders/git-reconcile-strategy-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=git-reconcile-strategy-options.js.map

package/dist/builders/git-reconcile-strategy-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-reconcile-strategy-options.js","sourceRoot":"","sources":["../../src/builders/git-reconcile-strategy-options.ts"],"names":[],"mappings":""}

package/dist/builders/internal/build-git-cow-worktree-node.d.ts

@@ -0,0 +1,35 @@
+import { type GitCowWorktreeNode, type GitReconcileStrategyConfig, type GitScopeReceipt, type GitSyncReceipt, type GitWorktreeHandle } from '@paraharness/core';
+import type { GitCowWorktreeCheckpointPolicy, GitCowWorktreeOptions } from '../git-cow-worktree-options.js';
+import type { GitReconcileStrategyOptions } from '../git-reconcile-strategy-options.js';
+/**
+ * Normalizes positional or object `.reconcileStrategy(...)` arguments into a frozen `GitReconcileStrategyConfig`.
+ *
+ * Extracts any `AstBuilder` passed as `verifyWith` into its passive `BaseCheckASTNode` representation.
+ *
+ * @param {'rebase-onto-base' | 'batch-merge-train' | GitReconcileStrategyOptions} modeOrOptions - Mode literal or options object.
+ * @param {GitReconcileStrategyOptions}                                            [options]     - Optional secondary options when first arg is mode.
+ *
+ * @returns {GitReconcileStrategyConfig<GitWorktreeHandle>} Frozen reconciliation strategy AST configuration.
+ */
+export declare function resolveReconcileStrategyConfig(modeOrOptions: 'rebase-onto-base' | 'batch-merge-train' | GitReconcileStrategyOptions, options?: GitReconcileStrategyOptions): GitReconcileStrategyConfig<GitWorktreeHandle>;
+/**
+ * Compiles optional `GitCowWorktreeCheckpointPolicy` builder options into a frozen AST checkpoint policy object.
+ *
+ * Unwraps `partitionMap` via `extractAST` and freezes `excludeGlobs` when present.
+ *
+ * @param {GitCowWorktreeCheckpointPolicy | undefined} policy - Builder checkpoint policy configuration.
+ *
+ * @returns {GitCowWorktreeNode['checkpointPolicy']} Frozen checkpoint policy AST configuration or `undefined`.
+ */
+export declare function buildCheckpointPolicyConfig(policy: GitCowWorktreeCheckpointPolicy | undefined): GitCowWorktreeNode['checkpointPolicy'];
+/**
+ * Compiles `GitCowWorktreeOptions` into an immutable, monomorphic `GitCowWorktreeNode` AST object.
+ *
+ * Populates default `conflictCleanCheck`, `receiptSchema`, and `syncSchema` fields while preserving V8 hidden classes.
+ *
+ * @param {GitCowWorktreeOptions} options - Accumulated builder configuration.
+ *
+ * @returns {GitCowWorktreeNode<GitWorktreeHandle, GitScopeReceipt, GitSyncReceipt>} Frozen `GitCowWorktreeNode` AST descriptor.
+ */
+export declare function buildGitCowWorktreeNode(options: GitCowWorktreeOptions): GitCowWorktreeNode<GitWorktreeHandle, GitScopeReceipt, GitSyncReceipt>;
+//# sourceMappingURL=build-git-cow-worktree-node.d.ts.map

package/dist/builders/internal/build-git-cow-worktree-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-git-cow-worktree-node.d.ts","sourceRoot":"","sources":["../../../src/builders/internal/build-git-cow-worktree-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAC/B,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACvB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EACV,8BAA8B,EAC9B,qBAAqB,EACtB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AAExF;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAC5C,aAAa,EAAE,kBAAkB,GAAG,mBAAmB,GAAG,2BAA2B,EACrF,OAAO,CAAC,EAAE,2BAA2B,GACpC,0BAA0B,CAAC,iBAAiB,CAAC,CAa/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,8BAA8B,GAAG,SAAS,GACjD,kBAAkB,CAAC,kBAAkB,CAAC,CAQxC;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,qBAAqB,GAC7B,kBAAkB,CAAC,iBAAiB,EAAE,eAAe,EAAE,cAAc,CAAC,CAyBxE"}

package/dist/builders/internal/build-git-cow-worktree-node.js

@@ -0,0 +1,77 @@
+import { extractAST, } from '@paraharness/core';
+import { GitScopeReceiptSchema, GitSyncReceiptSchema } from '../../schemas/git-receipts.schema.js';
+/**
+ * Normalizes positional or object `.reconcileStrategy(...)` arguments into a frozen `GitReconcileStrategyConfig`.
+ *
+ * Extracts any `AstBuilder` passed as `verifyWith` into its passive `BaseCheckASTNode` representation.
+ *
+ * @param {'rebase-onto-base' | 'batch-merge-train' | GitReconcileStrategyOptions} modeOrOptions - Mode literal or options object.
+ * @param {GitReconcileStrategyOptions}                                            [options]     - Optional secondary options when first arg is mode.
+ *
+ * @returns {GitReconcileStrategyConfig<GitWorktreeHandle>} Frozen reconciliation strategy AST configuration.
+ */
+export function resolveReconcileStrategyConfig(modeOrOptions, options) {
+    const mode = typeof modeOrOptions === 'string'
+        ? modeOrOptions
+        : (modeOrOptions.mode ?? 'rebase-onto-base');
+    const mergedOptions = typeof modeOrOptions === 'string' ? options : modeOrOptions;
+    const verifyWith = mergedOptions?.verifyWith !== undefined ? extractAST(mergedOptions.verifyWith) : undefined;
+    return Object.freeze({
+        mode,
+        verifyWith,
+        maxBatchSize: mergedOptions?.maxBatchSize,
+    });
+}
+/**
+ * Compiles optional `GitCowWorktreeCheckpointPolicy` builder options into a frozen AST checkpoint policy object.
+ *
+ * Unwraps `partitionMap` via `extractAST` and freezes `excludeGlobs` when present.
+ *
+ * @param {GitCowWorktreeCheckpointPolicy | undefined} policy - Builder checkpoint policy configuration.
+ *
+ * @returns {GitCowWorktreeNode['checkpointPolicy']} Frozen checkpoint policy AST configuration or `undefined`.
+ */
+export function buildCheckpointPolicyConfig(policy) {
+    if (policy === undefined)
+        return undefined;
+    return Object.freeze({
+        partitionMap: policy.partitionMap !== undefined ? extractAST(policy.partitionMap) : undefined,
+        excludeGlobs: policy.excludeGlobs !== undefined ? Object.freeze([...policy.excludeGlobs]) : undefined,
+        maxUntrackedFileSizeBytes: policy.maxUntrackedFileSizeBytes,
+    });
+}
+/**
+ * Compiles `GitCowWorktreeOptions` into an immutable, monomorphic `GitCowWorktreeNode` AST object.
+ *
+ * Populates default `conflictCleanCheck`, `receiptSchema`, and `syncSchema` fields while preserving V8 hidden classes.
+ *
+ * @param {GitCowWorktreeOptions} options - Accumulated builder configuration.
+ *
+ * @returns {GitCowWorktreeNode<GitWorktreeHandle, GitScopeReceipt, GitSyncReceipt>} Frozen `GitCowWorktreeNode` AST descriptor.
+ */
+export function buildGitCowWorktreeNode(options) {
+    const defaultCleanCheck = Object.freeze({
+        type: 'git:clean-working-tree',
+        id: 'git-clean-working-tree',
+    });
+    return Object.freeze({
+        type: 'git:cow-worktree',
+        id: options.id ?? 'git-cow-worktree',
+        capabilityTier: 'branchable',
+        supportsCheckpoints: true,
+        supportsBranching: true,
+        receiptSchema: GitScopeReceiptSchema,
+        syncSchema: GitSyncReceiptSchema,
+        repo: options.repo,
+        dir: options.dir,
+        setupCommands: Object.freeze([...(options.setupCommands ?? [])]),
+        lockfileGatePath: options.lockfileGatePath,
+        excludeFromCloneGlobs: options.excludeFromCloneGlobs !== undefined
+            ? Object.freeze([...options.excludeFromCloneGlobs])
+            : undefined,
+        checkpointPolicy: buildCheckpointPolicyConfig(options.checkpointPolicy),
+        reconcileStrategy: options.reconcileStrategy,
+        conflictCleanCheck: options.conflictCleanCheck ?? defaultCleanCheck,
+    });
+}
+//# sourceMappingURL=build-git-cow-worktree-node.js.map

package/dist/builders/internal/build-git-cow-worktree-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-git-cow-worktree-node.js","sourceRoot":"","sources":["../../../src/builders/internal/build-git-cow-worktree-node.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,GAOX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAOnG;;;;;;;;;GASG;AACH,MAAM,UAAU,8BAA8B,CAC5C,aAAqF,EACrF,OAAqC;IAErC,MAAM,IAAI,GACR,OAAO,aAAa,KAAK,QAAQ;QAC/B,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,IAAI,kBAAkB,CAAC,CAAC;IACjD,MAAM,aAAa,GAAG,OAAO,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC;IAClF,MAAM,UAAU,GACd,aAAa,EAAE,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7F,OAAO,MAAM,CAAC,MAAM,CAAgD;QAClE,IAAI;QACJ,UAAU;QACV,YAAY,EAAE,aAAa,EAAE,YAAY;KAC1C,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,2BAA2B,CACzC,MAAkD;IAElD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS;QAC7F,YAAY,EACV,MAAM,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;QACzF,yBAAyB,EAAE,MAAM,CAAC,yBAAyB;KAC5D,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAA8B;IAE9B,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAA6C;QAClF,IAAI,EAAE,wBAAwB;QAC9B,EAAE,EAAE,wBAAwB;KAC7B,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,CAAyE;QAC3F,IAAI,EAAE,kBAAkB;QACxB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,kBAAkB;QACpC,cAAc,EAAE,YAAY;QAC5B,mBAAmB,EAAE,IAAI;QACzB,iBAAiB,EAAE,IAAI;QACvB,aAAa,EAAE,qBAAqB;QACpC,UAAU,EAAE,oBAAoB;QAChC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC;QAChE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,qBAAqB,EACnB,OAAO,CAAC,qBAAqB,KAAK,SAAS;YACzC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;YACnD,CAAC,CAAC,SAAS;QACf,gBAAgB,EAAE,2BAA2B,CAAC,OAAO,CAAC,gBAAgB,CAAC;QACvE,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;QAC5C,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,iBAAiB;KACpE,CAAC,CAAC;AACL,CAAC"}

package/dist/executors/create-git-executors.d.ts

@@ -0,0 +1,12 @@
+import type { RuntimeExecutorRegistrySlice } from '@paraharness/core';
+/**
+ * Constructs a fresh `RuntimeExecutorRegistrySlice` registering all `@paraharness/git` scope, step, check, hook, cross-verifier, and tool executors.
+ *
+ * Mounts `git:cow-worktree`, `git:commit-and-push`, `git:merge-queue`, `git:clean-working-tree`,
+ * `git:snapshot-and-reset`, `git:keep-worktree`, `git:discard-branch`, `git:public-surface-cross-tester`,
+ * `git:patch-equivalence`, `git:ref-reader-tool`, and `git:candidate-comparison-tool`.
+ *
+ * @returns {RuntimeExecutorRegistrySlice} Frozen registry slice for `@paraharness/git`.
+ */
+export declare function createGitExecutors(): RuntimeExecutorRegistrySlice;
+//# sourceMappingURL=create-git-executors.d.ts.map

package/dist/executors/create-git-executors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-git-executors.d.ts","sourceRoot":"","sources":["../../src/executors/create-git-executors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAiBV,4BAA4B,EAG7B,MAAM,mBAAmB,CAAC;AAmB3B;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,IAAI,4BAA4B,CAkFjE"}

package/dist/executors/create-git-executors.js

@@ -0,0 +1,43 @@
+import { executeGitCommitAndPushStep, executeGitMergeQueueStep, } from './git-commit-and-merge-steps.js';
+import { GitCowWorktreeScopeDriver } from './git-cow-worktree-scope.js';
+import { createGitCandidateComparisonToolDrivers, createGitRefReaderToolDrivers, executeGitPatchEquivalence, executeGitPublicSurfaceCrossTester, } from './git-cross-verifiers-and-tools.js';
+import { executeGitCleanWorkingTreeCheck, executeGitDiscardBranchHook, executeGitKeepWorktreeHook, executeGitSnapshotAndResetHook, } from './git-hooks-and-checks.js';
+/**
+ * Constructs a fresh `RuntimeExecutorRegistrySlice` registering all `@paraharness/git` scope, step, check, hook, cross-verifier, and tool executors.
+ *
+ * Mounts `git:cow-worktree`, `git:commit-and-push`, `git:merge-queue`, `git:clean-working-tree`,
+ * `git:snapshot-and-reset`, `git:keep-worktree`, `git:discard-branch`, `git:public-surface-cross-tester`,
+ * `git:patch-equivalence`, `git:ref-reader-tool`, and `git:candidate-comparison-tool`.
+ *
+ * @returns {RuntimeExecutorRegistrySlice} Frozen registry slice for `@paraharness/git`.
+ */
+export function createGitExecutors() {
+    return Object.freeze({
+        scopes: Object.freeze({
+            'git:cow-worktree': (node) => new GitCowWorktreeScopeDriver(node),
+        }),
+        steps: Object.freeze({
+            'git:commit-and-push': (node, input, ctx) => executeGitCommitAndPushStep(node, input, ctx),
+            'git:merge-queue': (node, input, ctx) => executeGitMergeQueueStep(node, input, ctx),
+        }),
+        checks: Object.freeze({
+            'git:clean-working-tree': (node, input, ctx) => executeGitCleanWorkingTreeCheck(node, input, ctx),
+        }),
+        abortHooks: Object.freeze({
+            'git:snapshot-and-reset': (node, input, ctx) => executeGitSnapshotAndResetHook(node, input, ctx),
+        }),
+        rewindHooks: Object.freeze({
+            'git:keep-worktree': (node, input, ctx) => executeGitKeepWorktreeHook(node, input, ctx),
+            'git:discard-branch': (node, input, ctx) => executeGitDiscardBranchHook(node, input, ctx),
+        }),
+        crossVerifiers: Object.freeze({
+            'git:public-surface-cross-tester': (node, candidates, ctx) => executeGitPublicSurfaceCrossTester(node, candidates, ctx),
+            'git:patch-equivalence': (node, candidates, ctx) => executeGitPatchEquivalence(node, candidates, ctx),
+        }),
+        tools: Object.freeze({
+            'git:ref-reader-tool': createGitRefReaderToolDrivers(),
+            'git:candidate-comparison-tool': createGitCandidateComparisonToolDrivers(),
+        }),
+    });
+}
+//# sourceMappingURL=create-git-executors.js.map

package/dist/executors/create-git-executors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-git-executors.js","sourceRoot":"","sources":["../../src/executors/create-git-executors.ts"],"names":[],"mappings":"AAqBA,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EACL,uCAAuC,EACvC,6BAA6B,EAC7B,0BAA0B,EAC1B,kCAAkC,GACnC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,+BAA+B,EAC/B,2BAA2B,EAC3B,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AAEnC;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,MAAM,CAAC,MAAM,CAA+B;QACjD,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;YACpB,kBAAkB,EAAE,CAAC,IAAwB,EAAE,EAAE,CAC/C,IAAI,yBAAyB,CAAC,IAAI,CAIjC;SACJ,CAAC;QACF,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;YACnB,qBAAqB,EAAE,CAAC,IAA0B,EAAE,KAAc,EAAE,GAAkC,EAAE,EAAE,CACxG,2BAA2B,CAAC,IAAI,EAAE,KAAK,EAAE,GAA8C,CAAC;YAC1F,iBAAiB,EAAE,CAAC,IAAuB,EAAE,KAAc,EAAE,GAAkC,EAAE,EAAE,CACjG,wBAAwB,CAAC,IAAI,EAAE,KAAK,EAAE,GAA8C,CAAC;SACxF,CAAC;QACF,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;YACpB,wBAAwB,EAAE,CAAC,IAA6B,EAAE,KAAW,EAAE,GAAkC,EAAE,EAAE,CAC3G,+BAA+B,CAAC,IAAI,EAAE,KAAK,EAAE,GAA8C,CAAC;SAC/F,CAAC;QACF,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;YACxB,wBAAwB,EAAE,CACxB,IAA6B,EAC7B,KAA8B,EAC9B,GAAkC,EAClC,EAAE,CACF,8BAA8B,CAC5B,IAAI,EACJ,KAAmD,EACnD,GAA8C,CAC/C;SACJ,CAAC;QACF,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC;YACzB,mBAAmB,EAAE,CACnB,IAAyB,EACzB,KAA+B,EAC/B,GAAkC,EAClC,EAAE,CACF,0BAA0B,CACxB,IAAI,EACJ,KAAoD,EACpD,GAA8C,CAC/C;YACH,oBAAoB,EAAE,CACpB,IAA0B,EAC1B,KAA+B,EAC/B,GAAkC,EAClC,EAAE,CACF,2BAA2B,CACzB,IAAI,EACJ,KAAoD,EACpD,GAA8C,CAC/C;SACJ,CAAC;QACF,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC;YAC5B,iCAAiC,EAAE,CACjC,IAA8C,EAC9C,UAAuD,EACvD,GAAkC,EAClC,EAAE,CACF,kCAAkC,CAChC,IAAI,EACJ,UAA4E,EAC5E,GAA8C,CAC/C;YACH,uBAAuB,EAAE,CACvB,IAAsC,EACtC,UAAuD,EACvD,GAAkC,EAClC,EAAE,CACF,0BAA0B,CACxB,IAAI,EACJ,UAA4E,EAC5E,GAA8C,CAC/C;SACJ,CAAC;QACF,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;YACnB,qBAAqB,EAAE,6BAA6B,EAA+C;YACnG,+BAA+B,EAC7B,uCAAuC,EAAyD;SACnG,CAAC;KACH,CAAC,CAAC;AACL,CAAC"}

package/dist/executors/git-checkpoint-payload.d.ts

@@ -0,0 +1,44 @@
+import type { HarnessMetaRecord } from '../schemas/git-receipts.schema.js';
+/**
+ * Metadata descriptor for an untracked file exceeding `maxUntrackedFileSizeBytes` spilled to `<gitdir>/harness-ckpt-blobs/`.
+ *
+ * Stores the content-addressed `blobKey`, POSIX file `mode`, and byte `size` so `restoreCheckpoint`
+ * can copy the oversized file back into the working tree without bloating the temporary Git index.
+ */
+export interface OversizedUntrackedBlobRecord {
+    /** Content-addressed filename inside `<gitdir>/harness-ckpt-blobs/` (`${size}_${mtimeNs}_${sha256}`). */
+    readonly blobKey: string;
+    /** POSIX file permission mode bits captured via `lstat(2)`. */
+    readonly mode: number;
+    /** File size in bytes captured via `lstat(2)`. */
+    readonly size: number;
+}
+/**
+ * Serialized checkpoint payload produced by `GitCowWorktreeScopeDriver.serializeCheckpoint()`.
+ *
+ * Captures worktree-local `.git` metadata (`headSha`, `headRawContent`, `indexTreeSha`, `infoExcludeContent`, `meta`),
+ * the porcelain v2 `statusMap`, the temporary-index `treeSha`, and any `oversizedUntrackedBlobs`.
+ */
+export interface GitCheckpointPayload {
+    /** Resolved commit SHA of `HEAD` (`git rev-parse HEAD`). */
+    readonly headSha: string;
+    /** Exact raw file content of `<gitdir>/HEAD`. */
+    readonly headRawContent: string;
+    /** Tree OID of the live `<gitdir>/index` at checkpoint time. */
+    readonly indexTreeSha: string;
+    /** Raw content of `<gitdir>/info/exclude`, or `null` when absent. */
+    readonly infoExcludeContent: string | null;
+    /** Snapshot of `<gitdir>/harness-meta.json` at checkpoint time. */
+    readonly meta: HarnessMetaRecord;
+    /** Map from repository-relative file path to `${mode}:${sha256}` (or `'DELETED'`). */
+    readonly statusMap: Readonly<Record<string, string>>;
+    /** Paths ignored at checkpoint time (used when a `.gitignore` file changes mid-step). */
+    readonly ignoredPaths: readonly string[];
+    /** Digest of `node_modules` tree state at checkpoint time for tamper detection in `diffEffects`. */
+    readonly nodeModulesDigest: string;
+    /** Git tree SHA capturing `headSha` plus all dirty tracked and non-oversized untracked files. */
+    readonly treeSha: string;
+    /** Map of untracked files exceeding `maxUntrackedFileSizeBytes` stored in `<gitdir>/harness-ckpt-blobs/`. */
+    readonly oversizedUntrackedBlobs: Readonly<Record<string, OversizedUntrackedBlobRecord>>;
+}
+//# sourceMappingURL=git-checkpoint-payload.d.ts.map

package/dist/executors/git-checkpoint-payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-checkpoint-payload.d.ts","sourceRoot":"","sources":["../../src/executors/git-checkpoint-payload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAE3E;;;;;GAKG;AACH,MAAM,WAAW,4BAA4B;IAC3C,yGAAyG;IACzG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,gEAAgE;IAChE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,qEAAqE;IACrE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,sFAAsF;IACtF,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,yFAAyF;IACzF,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,oGAAoG;IACpG,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,iGAAiG;IACjG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6GAA6G;IAC7G,QAAQ,CAAC,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC,CAAC;CAC1F"}

package/dist/executors/git-checkpoint-payload.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=git-checkpoint-payload.js.map

package/dist/executors/git-checkpoint-payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-checkpoint-payload.js","sourceRoot":"","sources":["../../src/executors/git-checkpoint-payload.ts"],"names":[],"mappings":""}

package/dist/executors/git-commit-and-merge-steps.d.ts

@@ -0,0 +1,33 @@
+import type { GitCommitAndPushNode, GitMergeQueueNode, GitWorktreeHandle, StepExecutionContext } from '@paraharness/core';
+/**
+ * Executes a `GitCommitAndPushNode` (`git.commitAndPush`) step against the active `GitWorktreeHandle`.
+ *
+ * Acquires a concurrency slot from `node.runner`, flushes uncommitted edits, squashes over `baseRef`,
+ * rebases onto `origin/${resolvedBaseBranch}`, runs `verifyWith`, and pushes with `--force-with-lease`.
+ *
+ * @template TIn Step input payload type.
+ *
+ * @param {GitCommitAndPushNode<TIn>}               node  - Passive commit-and-push step AST node.
+ * @param {TIn}                                     input - Step input payload.
+ * @param {StepExecutionContext<GitWorktreeHandle>} ctx   - Active step execution context.
+ *
+ * @returns {Promise<void>} Resolves once the branch is pushed and `rootHandle` lineage is updated.
+ */
+export declare function executeGitCommitAndPushStep<TIn = unknown>(node: GitCommitAndPushNode<TIn>, input: TIn, ctx: StepExecutionContext<GitWorktreeHandle>): Promise<void>;
+/**
+ * Executes a `GitMergeQueueNode` (`git.mergeQueue`) step using speculative cumulative rebase chains.
+ *
+ * Combines up to `node.maxBatchSize` candidate branches onto `node.targetBranch`, runs `node.verifyWith`
+ * once on the tip $R_k$, and binary-bisects on verification failure to isolate and evict offending branches.
+ *
+ * @template TIn  Step input payload type.
+ * @template TOut Step output payload type.
+ *
+ * @param {GitMergeQueueNode<TIn, TOut>}            node  - Passive merge-queue step AST node.
+ * @param {TIn}                                     input - Step input payload containing candidate branches or refs.
+ * @param {StepExecutionContext<GitWorktreeHandle>} ctx   - Active step execution context.
+ *
+ * @returns {Promise<TOut>} Validated merge-train execution summary.
+ */
+export declare function executeGitMergeQueueStep<TIn = unknown, TOut = unknown>(node: GitMergeQueueNode<TIn, TOut>, input: TIn, ctx: StepExecutionContext<GitWorktreeHandle>): Promise<TOut>;
+//# sourceMappingURL=git-commit-and-merge-steps.d.ts.map

package/dist/executors/git-commit-and-merge-steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-commit-and-merge-steps.d.ts","sourceRoot":"","sources":["../../src/executors/git-commit-and-merge-steps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAK3B;;;;;;;;;;;;;GAaG;AACH,wBAAsB,2BAA2B,CAAC,GAAG,GAAG,OAAO,EAC7D,IAAI,EAAE,oBAAoB,CAAC,GAAG,CAAC,EAC/B,KAAK,EAAE,GAAG,EACV,GAAG,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,GAC3C,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,wBAAwB,CAAC,GAAG,GAAG,OAAO,EAAE,IAAI,GAAG,OAAO,EAC1E,IAAI,EAAE,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,EAClC,KAAK,EAAE,GAAG,EACV,GAAG,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,GAC3C,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/dist/executors/git-commit-and-merge-steps.js

@@ -0,0 +1,52 @@
+import { extractMergeTrainCandidates } from './internal/git-merge-train-bisect.js';
+import { executeBatchMergeTrainQueue } from './internal/merge-train-runner.js';
+import { runSquashRebaseAndPush } from './internal/squash-rebase-and-push.js';
+/**
+ * Executes a `GitCommitAndPushNode` (`git.commitAndPush`) step against the active `GitWorktreeHandle`.
+ *
+ * Acquires a concurrency slot from `node.runner`, flushes uncommitted edits, squashes over `baseRef`,
+ * rebases onto `origin/${resolvedBaseBranch}`, runs `verifyWith`, and pushes with `--force-with-lease`.
+ *
+ * @template TIn Step input payload type.
+ *
+ * @param {GitCommitAndPushNode<TIn>}               node  - Passive commit-and-push step AST node.
+ * @param {TIn}                                     input - Step input payload.
+ * @param {StepExecutionContext<GitWorktreeHandle>} ctx   - Active step execution context.
+ *
+ * @returns {Promise<void>} Resolves once the branch is pushed and `rootHandle` lineage is updated.
+ */
+export async function executeGitCommitAndPushStep(node, input, ctx) {
+    const parsedInput = node.inputSchema !== undefined ? node.inputSchema.parse(input) : input;
+    const runStep = () => runSquashRebaseAndPush(node, parsedInput, ctx);
+    if (node.runner !== undefined && typeof ctx.getRunner === 'function') {
+        const runner = ctx.getRunner(node.runner);
+        await runner.withSlot(runStep, ctx.signal);
+        return;
+    }
+    await runStep();
+}
+/**
+ * Executes a `GitMergeQueueNode` (`git.mergeQueue`) step using speculative cumulative rebase chains.
+ *
+ * Combines up to `node.maxBatchSize` candidate branches onto `node.targetBranch`, runs `node.verifyWith`
+ * once on the tip $R_k$, and binary-bisects on verification failure to isolate and evict offending branches.
+ *
+ * @template TIn  Step input payload type.
+ * @template TOut Step output payload type.
+ *
+ * @param {GitMergeQueueNode<TIn, TOut>}            node  - Passive merge-queue step AST node.
+ * @param {TIn}                                     input - Step input payload containing candidate branches or refs.
+ * @param {StepExecutionContext<GitWorktreeHandle>} ctx   - Active step execution context.
+ *
+ * @returns {Promise<TOut>} Validated merge-train execution summary.
+ */
+export async function executeGitMergeQueueStep(node, input, ctx) {
+    const parsedInput = node.inputSchema !== undefined ? node.inputSchema.parse(input) : input;
+    const candidates = await extractMergeTrainCandidates(parsedInput, ctx.scopeHandle, node.maxBatchSize);
+    const outcome = await executeBatchMergeTrainQueue(node, candidates, ctx);
+    if (node.outputSchema !== undefined) {
+        return node.outputSchema.parse(outcome);
+    }
+    return outcome;
+}
+//# sourceMappingURL=git-commit-and-merge-steps.js.map

package/dist/executors/git-commit-and-merge-steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-commit-and-merge-steps.js","sourceRoot":"","sources":["../../src/executors/git-commit-and-merge-steps.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAE9E;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,IAA+B,EAC/B,KAAU,EACV,GAA4C;IAE5C,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3F,MAAM,OAAO,GAAG,GAAkB,EAAE,CAClC,sBAAsB,CAAC,IAAqC,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;IAClF,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QACrE,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IACD,MAAM,OAAO,EAAE,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,IAAkC,EAClC,KAAU,EACV,GAA4C;IAE5C,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3F,MAAM,UAAU,GAAG,MAAM,2BAA2B,CAAC,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACtG,MAAM,OAAO,GAAG,MAAM,2BAA2B,CAC/C,IAA2C,EAC3C,UAAU,EACV,GAAG,CACJ,CAAC;IACF,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,OAAe,CAAC;AACzB,CAAC"}