@paraharness/git 0.0.0-stage → 0.2.0

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

@@ -0,0 +1,38 @@
+import { DEFAULT_NODE_RUNNER_AST_NODE, extractAST, z, } from '@paraharness/core';
+/**
+ * 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 function createGitPublicSurfaceCrossTesterBuilder(options) {
+    const id = options.id ?? 'git-public-surface-cross-tester';
+    const reportSchema = z
+        .object({
+        passedCrossTests: z.number(),
+        failedCrossTests: z.number(),
+        crossTestDeficits: z.array(z.string()),
+        transplantedTestFiles: z.array(z.string()),
+    })
+        .passthrough();
+    return Object.freeze({
+        id,
+        reportSchema,
+        toAST() {
+            return Object.freeze({
+                type: 'git:public-surface-cross-tester',
+                id,
+                reportSchema,
+                runner: options.runner !== undefined
+                    ? extractAST(options.runner)
+                    : DEFAULT_NODE_RUNNER_AST_NODE,
+                partitionMap: extractAST(options.partitionMap),
+            });
+        },
+    });
+}
+//# sourceMappingURL=create-git-public-surface-cross-tester-builder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-git-public-surface-cross-tester-builder.js","sourceRoot":"","sources":["../../src/builders/create-git-public-surface-cross-tester-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,UAAU,EACV,CAAC,GAKF,MAAM,mBAAmB,CAAC;AAG3B;;;;;;;;;GASG;AACH,MAAM,UAAU,wCAAwC,CACtD,OAA2C;IAO3C,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,iCAAiC,CAAC;IAC3D,MAAM,YAAY,GAAuC,CAAC;SACvD,MAAM,CAAC;QACN,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;QAC5B,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;QAC5B,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACtC,qBAAqB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KAC3C,CAAC;SACD,WAAW,EAAE,CAAC;IACjB,OAAO,MAAM,CAAC,MAAM,CAOlB;QACA,EAAE;QACF,YAAY;QACZ,KAAK;YACH,OAAO,MAAM,CAAC,MAAM,CAAkC;gBACpD,IAAI,EAAE,iCAAiC;gBACvC,EAAE;gBACF,YAAY;gBACZ,MAAM,EACJ,OAAO,CAAC,MAAM,KAAK,SAAS;oBAC1B,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC;oBAC5B,CAAC,CAAC,4BAA4B;gBAClC,YAAY,EAAE,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC;aAC/C,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/builders/create-git-ref-reader-tools.d.ts

@@ -0,0 +1,14 @@
+import { type GitRefReaderToolNode, type GitWorktreeHandle, type MaybeBuilder, type NodeRunnerNode } from '@paraharness/core';
+/**
+ * Creates the read-only git object store inspection tool bundle (`git.refReaderTools(runner?)`).
+ *
+ * Emits passive `GitRefReaderToolNode` descriptors for `readRefFile`, `diffRefs`, and `listRefFiles`
+ * with `effectTracking: 'declared'` so actors can inspect `refs/harness/aborted/<run-id>/<stepExecId>`,
+ * defaulting `runner` to `DEFAULT_NODE_RUNNER_AST_NODE` when omitted.
+ *
+ * @param {MaybeBuilder<NodeRunnerNode>} [runner=DEFAULT_NODE_RUNNER_AST_NODE] - Optional subprocess runner pool governing git command slots.
+ *
+ * @returns {readonly GitRefReaderToolNode<GitWorktreeHandle>[]} Frozen tuple of `readRefFile`, `diffRefs`, and `listRefFiles` tool AST nodes.
+ */
+export declare function createGitRefReaderTools(runner?: MaybeBuilder<NodeRunnerNode>): readonly GitRefReaderToolNode<GitWorktreeHandle>[];
+//# sourceMappingURL=create-git-ref-reader-tools.d.ts.map

package/dist/builders/create-git-ref-reader-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-git-ref-reader-tools.d.ts","sourceRoot":"","sources":["../../src/builders/create-git-ref-reader-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAO3B;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,GAAE,YAAY,CAAC,cAAc,CAAgC,GAClE,SAAS,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,CA2BpD"}

package/dist/builders/create-git-ref-reader-tools.js

@@ -0,0 +1,42 @@
+import { DEFAULT_NODE_RUNNER_AST_NODE, extractAST, } from '@paraharness/core';
+import { DiffRefsInputSchema, ListRefFilesInputSchema, ReadRefFileInputSchema, } from '../schemas/git-receipts.schema.js';
+/**
+ * Creates the read-only git object store inspection tool bundle (`git.refReaderTools(runner?)`).
+ *
+ * Emits passive `GitRefReaderToolNode` descriptors for `readRefFile`, `diffRefs`, and `listRefFiles`
+ * with `effectTracking: 'declared'` so actors can inspect `refs/harness/aborted/<run-id>/<stepExecId>`,
+ * defaulting `runner` to `DEFAULT_NODE_RUNNER_AST_NODE` when omitted.
+ *
+ * @param {MaybeBuilder<NodeRunnerNode>} [runner=DEFAULT_NODE_RUNNER_AST_NODE] - Optional subprocess runner pool governing git command slots.
+ *
+ * @returns {readonly GitRefReaderToolNode<GitWorktreeHandle>[]} Frozen tuple of `readRefFile`, `diffRefs`, and `listRefFiles` tool AST nodes.
+ */
+export function createGitRefReaderTools(runner = DEFAULT_NODE_RUNNER_AST_NODE) {
+    const runnerNode = extractAST(runner);
+    const readRefFileNode = Object.freeze({
+        type: 'git:ref-reader-tool',
+        name: 'readRefFile',
+        description: 'Reads the contents of a repository-relative file at a specified git ref or commit SHA.',
+        inputSchema: ReadRefFileInputSchema,
+        effectTracking: 'declared',
+        runner: runnerNode,
+    });
+    const diffRefsNode = Object.freeze({
+        type: 'git:ref-reader-tool',
+        name: 'diffRefs',
+        description: 'Computes the unified git diff between two git refs or commit SHAs.',
+        inputSchema: DiffRefsInputSchema,
+        effectTracking: 'declared',
+        runner: runnerNode,
+    });
+    const listRefFilesNode = Object.freeze({
+        type: 'git:ref-reader-tool',
+        name: 'listRefFiles',
+        description: 'Lists tracked file paths inside the tree of a specified git ref or commit SHA.',
+        inputSchema: ListRefFilesInputSchema,
+        effectTracking: 'declared',
+        runner: runnerNode,
+    });
+    return Object.freeze([readRefFileNode, diffRefsNode, listRefFilesNode]);
+}
+//# sourceMappingURL=create-git-ref-reader-tools.js.map

package/dist/builders/create-git-ref-reader-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-git-ref-reader-tools.js","sourceRoot":"","sources":["../../src/builders/create-git-ref-reader-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,UAAU,GAKX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,mCAAmC,CAAC;AAE3C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB,CACrC,SAAuC,4BAA4B;IAEnE,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAA0C;QAC7E,IAAI,EAAE,qBAAqB;QAC3B,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,wFAAwF;QACrG,WAAW,EAAE,sBAAsB;QACnC,cAAc,EAAE,UAAU;QAC1B,MAAM,EAAE,UAAU;KACnB,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAA0C;QAC1E,IAAI,EAAE,qBAAqB;QAC3B,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,oEAAoE;QACjF,WAAW,EAAE,mBAAmB;QAChC,cAAc,EAAE,UAAU;QAC1B,MAAM,EAAE,UAAU;KACnB,CAAC,CAAC;IACH,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAA0C;QAC9E,IAAI,EAAE,qBAAqB;QAC3B,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,gFAAgF;QAC7F,WAAW,EAAE,uBAAuB;QACpC,cAAc,EAAE,UAAU;QAC1B,MAAM,EAAE,UAAU;KACnB,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,EAAE,YAAY,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAC1E,CAAC"}

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

@@ -0,0 +1,13 @@
+import type { AstBuilder, GitDiscardBranchNode } from '@paraharness/core';
+/**
+ * Creates a fluent `AstBuilder<GitDiscardBranchNode>` (`git.resetWorktree()`).
+ *
+ * Compiles into a passive `GitDiscardBranchNode` (`type: 'git:discard-branch'`, `resetsRunOverlay: true`)
+ * that restores the worktree to `targetStepBaseScopeCheckpoint` and resets the run topology overlay on rewind.
+ *
+ * @param {string} [id='git-reset-worktree'] - Optional custom identifier for the rewind hook node.
+ *
+ * @returns {AstBuilder<GitDiscardBranchNode>} Immutable rewind hook builder instance.
+ */
+export declare function createGitResetWorktreeBuilder(id?: string): AstBuilder<GitDiscardBranchNode>;
+//# sourceMappingURL=create-git-reset-worktree-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-git-reset-worktree-builder.d.ts","sourceRoot":"","sources":["../../src/builders/create-git-reset-worktree-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-reset-worktree-builder.js

@@ -0,0 +1,22 @@
+/**
+ * Creates a fluent `AstBuilder<GitDiscardBranchNode>` (`git.resetWorktree()`).
+ *
+ * Compiles into a passive `GitDiscardBranchNode` (`type: 'git:discard-branch'`, `resetsRunOverlay: true`)
+ * that restores the worktree to `targetStepBaseScopeCheckpoint` and resets the run topology overlay on rewind.
+ *
+ * @param {string} [id='git-reset-worktree'] - Optional custom identifier for the rewind hook node.
+ *
+ * @returns {AstBuilder<GitDiscardBranchNode>} Immutable rewind hook builder instance.
+ */
+export function createGitResetWorktreeBuilder(id = 'git-reset-worktree') {
+    return Object.freeze({
+        toAST() {
+            return Object.freeze({
+                type: 'git:discard-branch',
+                id,
+                resetsRunOverlay: true,
+            });
+        },
+    });
+}
+//# sourceMappingURL=create-git-reset-worktree-builder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-git-reset-worktree-builder.js","sourceRoot":"","sources":["../../src/builders/create-git-reset-worktree-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-snapshot-and-reset-builder.d.ts

@@ -0,0 +1,13 @@
+import type { AstBuilder, GitSnapshotAndResetNode } from '@paraharness/core';
+/**
+ * Creates a fluent `AstBuilder<GitSnapshotAndResetNode>` (`git.snapshotAndReset()`).
+ *
+ * Compiles into a passive `GitSnapshotAndResetNode` (`type: 'git:snapshot-and-reset'`) that snapshots
+ * an aborted worktree to `refs/harness/aborted/<run-id>/<stepExecId>` and resets to `handle.baseRef`.
+ *
+ * @param {string} [id='git-snapshot-and-reset'] - Optional custom identifier for the abort hook node.
+ *
+ * @returns {AstBuilder<GitSnapshotAndResetNode>} Immutable abort hook builder instance.
+ */
+export declare function createGitSnapshotAndResetBuilder(id?: string): AstBuilder<GitSnapshotAndResetNode>;
+//# sourceMappingURL=create-git-snapshot-and-reset-builder.d.ts.map

package/dist/builders/create-git-snapshot-and-reset-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-git-snapshot-and-reset-builder.d.ts","sourceRoot":"","sources":["../../src/builders/create-git-snapshot-and-reset-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAG7E;;;;;;;;;GASG;AACH,wBAAgB,gCAAgC,CAC9C,EAAE,SAA2B,GAC5B,UAAU,CAAC,uBAAuB,CAAC,CAUrC"}

package/dist/builders/create-git-snapshot-and-reset-builder.js

@@ -0,0 +1,23 @@
+import { GitAbortMetaSchema } from '../schemas/git-receipts.schema.js';
+/**
+ * Creates a fluent `AstBuilder<GitSnapshotAndResetNode>` (`git.snapshotAndReset()`).
+ *
+ * Compiles into a passive `GitSnapshotAndResetNode` (`type: 'git:snapshot-and-reset'`) that snapshots
+ * an aborted worktree to `refs/harness/aborted/<run-id>/<stepExecId>` and resets to `handle.baseRef`.
+ *
+ * @param {string} [id='git-snapshot-and-reset'] - Optional custom identifier for the abort hook node.
+ *
+ * @returns {AstBuilder<GitSnapshotAndResetNode>} Immutable abort hook builder instance.
+ */
+export function createGitSnapshotAndResetBuilder(id = 'git-snapshot-and-reset') {
+    return Object.freeze({
+        toAST() {
+            return Object.freeze({
+                type: 'git:snapshot-and-reset',
+                id,
+                metaSchema: GitAbortMetaSchema,
+            });
+        },
+    });
+}
+//# sourceMappingURL=create-git-snapshot-and-reset-builder.js.map

package/dist/builders/create-git-snapshot-and-reset-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-git-snapshot-and-reset-builder.js","sourceRoot":"","sources":["../../src/builders/create-git-snapshot-and-reset-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAEvE;;;;;;;;;GASG;AACH,MAAM,UAAU,gCAAgC,CAC9C,EAAE,GAAG,wBAAwB;IAE7B,OAAO,MAAM,CAAC,MAAM,CAAsC;QACxD,KAAK;YACH,OAAO,MAAM,CAAC,MAAM,CAA0B;gBAC5C,IAAI,EAAE,wBAAwB;gBAC9B,EAAE;gBACF,UAAU,EAAE,kBAAkB;aAC/B,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,44 @@
+import type { AstBuilder, EnvRef, GitCommitAndPushNode, MaybeBuilder, NodeRunnerNode, z } from '@paraharness/core';
+/**
+ * Fluent builder for a retry-safe commit, rebase, and push domain step (`git.commitAndPush`).
+ *
+ * Compiles into a passive `GitCommitAndPushNode<TIn>` (`type: 'git:commit-and-push'`) dispatched
+ * via `RuntimeExecutorRegistry.steps['git:commit-and-push']`.
+ *
+ * @template TIn Step input payload type.
+ */
+export interface GitCommitAndPushBuilder<TIn = unknown> extends AstBuilder<GitCommitAndPushNode<TIn>> {
+    /**
+     * Binds a Zod schema validating the step input payload passed to `branch(input)` and `message(input)`.
+     *
+     * Narrows or updates the builder's `TIn` type parameter to match the supplied `schema`.
+     *
+     * @template TNextIn Updated step input payload type inferred from `schema`.
+     *
+     * @param {z.ZodType<TNextIn>} schema - Zod schema for step input validation.
+     *
+     * @returns {GitCommitAndPushBuilder<TNextIn>} Updated immutable step builder instance.
+     */
+    input<TNextIn extends TIn = TIn>(schema: z.ZodType<TNextIn>): GitCommitAndPushBuilder<TNextIn>;
+    /**
+     * Binds the `NodeRunnerNode` pool governing git and verification subprocess concurrency.
+     *
+     * Accepts either a compiled `NodeRunnerNode` or a fluent `AstBuilder<NodeRunnerNode>`.
+     *
+     * @param {MaybeBuilder<NodeRunnerNode>} runner - Runner pool descriptor or builder.
+     *
+     * @returns {GitCommitAndPushBuilder<TIn>} Updated immutable step builder instance.
+     */
+    runner(runner: MaybeBuilder<NodeRunnerNode>): GitCommitAndPushBuilder<TIn>;
+    /**
+     * Binds environment variables or symbolic `P.env(key)` references injected into git commands.
+     *
+     * Symbolic `EnvRef` values are preserved in the AST and resolved exclusively at runtime execution.
+     *
+     * @param {Readonly<Record<string, string | EnvRef>>} env - Environment map to attach to the step node.
+     *
+     * @returns {GitCommitAndPushBuilder<TIn>} Updated immutable step builder instance.
+     */
+    env(env: Readonly<Record<string, string | EnvRef>>): GitCommitAndPushBuilder<TIn>;
+}
+//# sourceMappingURL=git-commit-and-push-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git-commit-and-push-builder.d.ts","sourceRoot":"","sources":["../../src/builders/git-commit-and-push-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,MAAM,EACN,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,CAAC,EACF,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB,CAAC,GAAG,GAAG,OAAO,CACpD,SAAQ,UAAU,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAC7C;;;;;;;;;;OAUG;IACH,KAAK,CAAC,OAAO,SAAS,GAAG,GAAG,GAAG,EAC7B,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GACzB,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAEpC;;;;;;;;OAQG;IACH,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,cAAc,CAAC,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;IAE3E;;;;;;;;OAQG;IACH,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;CACnF"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=git-commit-and-push-builder.js.map

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

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

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

@@ -0,0 +1,22 @@
+import type { BivariantCallback, EnvRef, MaybeBuilder, NodeRunnerNode, z } from '@paraharness/core';
+/**
+ * Configuration options for `git.commitAndPush(id, options)` (`createGitCommitAndPushBuilder`).
+ *
+ * Defines the target remote branch projection (`branch`), commit message projection (`message`),
+ * and optional input schema, runner pool, and environment bindings.
+ *
+ * @template TIn Step input payload type.
+ */
+export interface GitCommitAndPushOptions<TIn = unknown> {
+    /** Pure projection deriving the target remote branch name from `TIn`. */
+    readonly branch: BivariantCallback<[input: TIn], string>;
+    /** Pure projection deriving the commit message from `TIn`. */
+    readonly message: BivariantCallback<[input: TIn], string>;
+    /** Optional Zod schema validating the step input payload. */
+    readonly inputSchema?: z.ZodType<TIn>;
+    /** Optional runner pool governing subprocess slot concurrency. */
+    readonly runner?: MaybeBuilder<NodeRunnerNode>;
+    /** Optional environment variables or symbolic `EnvRef` bindings injected into git commands. */
+    readonly env?: Readonly<Record<string, string | EnvRef>>;
+}
+//# sourceMappingURL=git-commit-and-push-options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git-commit-and-push-options.d.ts","sourceRoot":"","sources":["../../src/builders/git-commit-and-push-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,MAAM,EACN,YAAY,EACZ,cAAc,EACd,CAAC,EACF,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB,CAAC,GAAG,GAAG,OAAO;IACpD,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;IACzD,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;IAC1D,6DAA6D;IAC7D,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,kEAAkE;IAClE,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC;IAC/C,+FAA+F;IAC/F,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;CAC1D"}

package/dist/builders/git-commit-and-push-options.js

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

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

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

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

@@ -0,0 +1,64 @@
+import type { ASTNode, AstBuilder, GitCowWorktreeNode, GitScopeReceipt, GitSyncReceipt, GitWorktreeHandle, MaybeBuilder } from '@paraharness/core';
+import type { GitCowWorktreeCheckpointPolicy } from './git-cow-worktree-options.js';
+import type { GitReconcileStrategyOptions } from './git-reconcile-strategy-options.js';
+/**
+ * Fluent builder for a Tier-3 branchable Copy-on-Write Git worktree scope (`git.cowWorktree`).
+ *
+ * Compiles into a passive `GitCowWorktreeNode` (`type: 'git:cow-worktree'`, `capabilityTier: 'branchable'`)
+ * with zero filesystem or subprocess I/O at builder declaration time.
+ */
+export interface GitCowWorktreeBuilder extends AstBuilder<GitCowWorktreeNode<GitWorktreeHandle, GitScopeReceipt, GitSyncReceipt>> {
+    /**
+     * Configures glob patterns excluded when cloning dirty working-tree files or caches into a worktree.
+     *
+     * Returns a new immutable `GitCowWorktreeBuilder` instance with `excludeFromCloneGlobs` set to a frozen copy of `globs`.
+     *
+     * @param {readonly string[]} globs - Repository-relative glob patterns to omit during worktree cloning.
+     *
+     * @returns {GitCowWorktreeBuilder} Updated immutable worktree builder instance.
+     */
+    excludeFromCloneGlobs(globs: readonly string[]): GitCowWorktreeBuilder;
+    /**
+     * Appends one or more setup command steps executed when provisioning a root worktree on a lockfile gate miss.
+     *
+     * Accepts either raw `ASTNode` descriptors or fluent `AstBuilder<ASTNode>` instances (such as `local.command(...)`).
+     *
+     * @param {...Array<MaybeBuilder<ASTNode>>} commands - Setup command steps to execute in declaration order.
+     *
+     * @returns {GitCowWorktreeBuilder} Updated immutable worktree builder instance.
+     */
+    setup(...commands: ReadonlyArray<MaybeBuilder<ASTNode>>): GitCowWorktreeBuilder;
+    /**
+     * Configures a lockfile path whose SHA-256 digest gates whether `.setup()` commands can be skipped.
+     *
+     * On a lockfile hash hit against the host repository, `node_modules` is CoW-cloned/hardlinked; on a miss,
+     * any hardlinked `node_modules` tree is unlinked and replaced before executing `.setup()` commands.
+     *
+     * @param {string} lockfilePath - Repository-relative path to the dependency lockfile (such as `'pnpm-lock.yaml'`).
+     *
+     * @returns {GitCowWorktreeBuilder} Updated immutable worktree builder instance.
+     */
+    lockfileGate(lockfilePath: string): GitCowWorktreeBuilder;
+    /**
+     * Configures dirty-index checkpointing exclusions, partition mapping, and untracked blob size limits.
+     *
+     * Controls how `serializeCheckpoint`, `diffEffects`, and `restoreCheckpoint` stage tracked and untracked files.
+     *
+     * @param {GitCowWorktreeCheckpointPolicy} policy - Checkpoint policy configuration.
+     *
+     * @returns {GitCowWorktreeBuilder} Updated immutable worktree builder instance.
+     */
+    checkpointPolicy(policy: GitCowWorktreeCheckpointPolicy): GitCowWorktreeBuilder;
+    /**
+     * Configures the branch landing reconciliation strategy (`'rebase-onto-base'` or `'batch-merge-train'`).
+     *
+     * Accepts either `(mode, options?)` positional arguments or a single `GitReconcileStrategyOptions` object.
+     *
+     * @param {'rebase-onto-base' | 'batch-merge-train' | GitReconcileStrategyOptions} modeOrOptions - Reconciliation mode or options object.
+     * @param {GitReconcileStrategyOptions}                                            [options]     - Optional verification check and batch size settings.
+     *
+     * @returns {GitCowWorktreeBuilder} Updated immutable worktree builder instance.
+     */
+    reconcileStrategy(modeOrOptions: 'rebase-onto-base' | 'batch-merge-train' | GitReconcileStrategyOptions, options?: GitReconcileStrategyOptions): GitCowWorktreeBuilder;
+}
+//# sourceMappingURL=git-cow-worktree-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git-cow-worktree-builder.d.ts","sourceRoot":"","sources":["../../src/builders/git-cow-worktree-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,YAAY,EACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AACpF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAEvF;;;;;GAKG;AACH,MAAM,WAAW,qBACf,SAAQ,UAAU,CAAC,kBAAkB,CAAC,iBAAiB,EAAE,eAAe,EAAE,cAAc,CAAC,CAAC;IAC1F;;;;;;;;OAQG;IACH,qBAAqB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,qBAAqB,CAAC;IAEvE;;;;;;;;OAQG;IACH,KAAK,CAAC,GAAG,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,GAAG,qBAAqB,CAAC;IAEhF;;;;;;;;;OASG;IACH,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,qBAAqB,CAAC;IAE1D;;;;;;;;OAQG;IACH,gBAAgB,CAAC,MAAM,EAAE,8BAA8B,GAAG,qBAAqB,CAAC;IAEhF;;;;;;;;;OASG;IACH,iBAAiB,CACf,aAAa,EAAE,kBAAkB,GAAG,mBAAmB,GAAG,2BAA2B,EACrF,OAAO,CAAC,EAAE,2BAA2B,GACpC,qBAAqB,CAAC;CAC1B"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=git-cow-worktree-builder.js.map

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

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

package/dist/builders/git-cow-worktree-options.d.ts

@@ -0,0 +1,42 @@
+import type { ASTNode, FsPartitionMapNode, GitCleanWorkingTreeNode, GitReconcileStrategyConfig, GitWorktreeHandle, MaybeBuilder } from '@paraharness/core';
+/**
+ * Dirty-index checkpointing configuration accepted by `GitCowWorktreeBuilder.checkpointPolicy()`.
+ *
+ * Controls which partition map and glob exclusions apply when snapshotting or diffing a worktree,
+ * and sets the byte ceiling above which untracked files spill into `<gitdir>/harness-ckpt-blobs/`.
+ */
+export interface GitCowWorktreeCheckpointPolicy {
+    /** Optional filesystem partition map associated with the checkpoint policy. */
+    readonly partitionMap?: MaybeBuilder<FsPartitionMapNode<string>>;
+    /** Optional glob patterns excluded from dirty-tree checkpoint snapshots. */
+    readonly excludeGlobs?: readonly string[];
+    /** Maximum file size in bytes staged directly into the temporary git index before spilling to `harness-ckpt-blobs/`. */
+    readonly maxUntrackedFileSizeBytes?: number;
+}
+/**
+ * Configuration options for `git.cowWorktree(options)` (`createGitCowWorktreeBuilder`).
+ *
+ * Specifies the host Git repository root (`repo`), the disjoint sibling workspace directory (`dir`),
+ * and optional pre-populated builder state fields for immutable builder chaining.
+ */
+export interface GitCowWorktreeOptions {
+    /** Optional logical identifier for the isolation scope node (defaults to `'git-cow-worktree'`). */
+    readonly id?: string;
+    /** Path to the host Git repository (defaults to `'.'`). */
+    readonly repo?: string;
+    /** Base directory under which `roots/<runId>` and `forks/<runId>/<forkId>` worktrees are created (defaults to `'.paraharness/worktree'`). */
+    readonly dir?: string;
+    /** Optional ordered setup step AST nodes executed when initializing a root worktree. */
+    readonly setupCommands?: readonly ASTNode[];
+    /** Optional lockfile path whose SHA-256 digest gates whether `setupCommands` can be skipped. */
+    readonly lockfileGatePath?: string;
+    /** Optional glob patterns excluded when cloning dirty working-tree files into a worktree. */
+    readonly excludeFromCloneGlobs?: readonly string[];
+    /** Optional dirty-index checkpointing configuration. */
+    readonly checkpointPolicy?: GitCowWorktreeCheckpointPolicy;
+    /** Optional branch landing reconciliation strategy (`'rebase-onto-base'` or `'batch-merge-train'`). */
+    readonly reconcileStrategy?: GitReconcileStrategyConfig<GitWorktreeHandle>;
+    /** Optional custom conflict cleanliness check node overriding the default `git:clean-working-tree` check. */
+    readonly conflictCleanCheck?: GitCleanWorkingTreeNode<GitWorktreeHandle>;
+}
+//# sourceMappingURL=git-cow-worktree-options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git-cow-worktree-options.d.ts","sourceRoot":"","sources":["../../src/builders/git-cow-worktree-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,kBAAkB,EAClB,uBAAuB,EACvB,0BAA0B,EAC1B,iBAAiB,EACjB,YAAY,EACb,MAAM,mBAAmB,CAAC;AAE3B;;;;;GAKG;AACH,MAAM,WAAW,8BAA8B;IAC7C,+EAA+E;IAC/E,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;IACjE,4EAA4E;IAC5E,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,wHAAwH;IACxH,QAAQ,CAAC,yBAAyB,CAAC,EAAE,MAAM,CAAC;CAC7C;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,mGAAmG;IACnG,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,6IAA6I;IAC7I,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,wFAAwF;IACxF,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC5C,gGAAgG;IAChG,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,6FAA6F;IAC7F,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnD,wDAAwD;IACxD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,8BAA8B,CAAC;IAC3D,uGAAuG;IACvG,QAAQ,CAAC,iBAAiB,CAAC,EAAE,0BAA0B,CAAC,iBAAiB,CAAC,CAAC;IAC3E,6GAA6G;IAC7G,QAAQ,CAAC,kBAAkB,CAAC,EAAE,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;CAC1E"}

package/dist/builders/git-cow-worktree-options.js

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

package/dist/builders/git-cow-worktree-options.js.map

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

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

@@ -0,0 +1,37 @@
+import type { AstBuilder, GitMergeQueueNode, z } from '@paraharness/core';
+/**
+ * Fluent builder for cumulative batch merge-train verification (`git.mergeQueue`).
+ *
+ * Compiles into a passive `GitMergeQueueNode<TIn, TOut>` (`type: 'git:merge-queue'`) dispatched
+ * via `RuntimeExecutorRegistry.steps['git:merge-queue']`.
+ *
+ * @template TIn  Validated step input type.
+ * @template TOut Validated step output type.
+ */
+export interface GitMergeQueueBuilder<TIn = unknown, TOut = unknown> extends AstBuilder<GitMergeQueueNode<TIn, TOut>> {
+    /**
+     * Binds a Zod schema validating the step input payload.
+     *
+     * Narrows the builder's `TIn` type parameter to match the supplied `schema`.
+     *
+     * @template TNextIn Updated step input payload type inferred from `schema`.
+     *
+     * @param {z.ZodType<TNextIn>} schema - Zod schema for step input validation.
+     *
+     * @returns {GitMergeQueueBuilder<TNextIn, TOut>} Updated immutable merge queue builder instance.
+     */
+    input<TNextIn>(schema: z.ZodType<TNextIn>): GitMergeQueueBuilder<TNextIn, TOut>;
+    /**
+     * Binds a Zod schema validating the step output payload.
+     *
+     * Narrows the builder's `TOut` type parameter to match the supplied `schema`.
+     *
+     * @template TNextOut Updated step output payload type inferred from `schema`.
+     *
+     * @param {z.ZodType<TNextOut>} schema - Zod schema for step output validation.
+     *
+     * @returns {GitMergeQueueBuilder<TIn, TNextOut>} Updated immutable merge queue builder instance.
+     */
+    output<TNextOut>(schema: z.ZodType<TNextOut>): GitMergeQueueBuilder<TIn, TNextOut>;
+}
+//# sourceMappingURL=git-merge-queue-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git-merge-queue-builder.d.ts","sourceRoot":"","sources":["../../src/builders/git-merge-queue-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAE1E;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB,CAAC,GAAG,GAAG,OAAO,EAAE,IAAI,GAAG,OAAO,CACjE,SAAQ,UAAU,CAAC,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAChD;;;;;;;;;;OAUG;IACH,KAAK,CAAC,OAAO,EACX,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GACzB,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAEvC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,QAAQ,EACb,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,GAC1B,oBAAoB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;CACxC"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=git-merge-queue-builder.js.map

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

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

package/dist/builders/git-merge-queue-options.d.ts

@@ -0,0 +1,23 @@
+import type { BaseCheckASTNode, GitWorktreeHandle, MaybeBuilder, z } from '@paraharness/core';
+/**
+ * Configuration options for `git.mergeQueue(id, options)` (`createGitMergeQueueBuilder`).
+ *
+ * Specifies the upstream `targetBranch`, `maxBatchSize` for speculative cumulative merge trains,
+ * and the `verifyWith` check executed against the cumulative tip commit $R_k$.
+ *
+ * @template TIn  Validated step input type.
+ * @template TOut Validated step output type.
+ */
+export interface GitMergeQueueOptions<TIn = unknown, TOut = unknown> {
+    /** Target upstream branch into which approved runs are merged (defaults to `'main'`). */
+    readonly targetBranch?: string;
+    /** Maximum number of runs combined into a single speculative verification batch (defaults to `4`). */
+    readonly maxBatchSize?: number;
+    /** Deterministic verification check executed against the cumulative merge head. */
+    readonly verifyWith: MaybeBuilder<BaseCheckASTNode<string, GitWorktreeHandle>>;
+    /** Optional Zod schema validating the merge queue step input payload. */
+    readonly inputSchema?: z.ZodType<TIn>;
+    /** Optional Zod schema validating the merge queue step output payload. */
+    readonly outputSchema?: z.ZodType<TOut>;
+}
+//# sourceMappingURL=git-merge-queue-options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git-merge-queue-options.d.ts","sourceRoot":"","sources":["../../src/builders/git-merge-queue-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,CAAC,EACF,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB,CAAC,GAAG,GAAG,OAAO,EAAE,IAAI,GAAG,OAAO;IACjE,yFAAyF;IACzF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,sGAAsG;IACtG,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,mFAAmF;IACnF,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC/E,yEAAyE;IACzE,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,0EAA0E;IAC1E,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC"}

package/dist/builders/git-merge-queue-options.js

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

package/dist/builders/git-merge-queue-options.js.map

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