@paraharness/git

Variables

Variable	Description
git	Frozen git DSL builder and receipt schema namespace (@paraharness/git).
GitAbortMetaSchema	Zod schema validating GitAbortMeta objects returned by git.snapshotAndReset().
gitExecutors	Default frozen RuntimeExecutorRegistrySlice instance for @paraharness/git.
GitScopeReceiptSchema	Zod schema validating GitScopeReceipt objects returned by inspect() and commitChild().
GitSyncReceiptSchema	Zod schema validating GitSyncReceipt objects returned by syncChild() and syncRoot().
HarnessMetaSchema	Zod schema validating persistent <gitdir>/harness-meta.json worktree lineage and recovery metadata.

Functions

Function	Description
createGitCandidateComparisonToolDrivers	Creates the ToolDriver handling GitCandidateComparisonToolNode (git:candidate-comparison-tool) invocations.
createGitCandidateComparisonTools	Creates the speculative candidate comparison and benchmark tool bundle (git.candidateComparisonTools(runner?)).
createGitCommitAndPushBuilder	Creates a fluent GitCommitAndPushBuilder (git.commitAndPush(id, options)).
createGitCowWorktreeBuilder	Creates a fluent GitCowWorktreeBuilder (git.cowWorktree(options?)).
createGitDiscardBranchBuilder	Creates a fluent AstBuilder<GitDiscardBranchNode> (git.discardBranch()).
createGitExecutors	Constructs a fresh RuntimeExecutorRegistrySlice registering all @paraharness/git scope, step, check, hook, cross-verifier, and tool executors.
createGitKeepWorktreeBuilder	Creates a fluent AstBuilder<GitKeepWorktreeNode> (git.keepWorktree()).
createGitMergeQueueBuilder	Creates a fluent GitMergeQueueBuilder (git.mergeQueue(id, options)).
createGitPatchEquivalenceBuilder	Creates a CrossVerifierBuilder for normalized patch equivalence clustering (git.patchEquivalence).
createGitPublicSurfaceCrossTesterBuilder	Creates a CrossVerifierBuilder for AST-gated public-boundary cross-testing (git.publicSurfaceCrossTester).
createGitRefReaderToolDrivers	Creates the ToolDriver handling GitRefReaderToolNode (git:ref-reader-tool) invocations.
createGitRefReaderTools	Creates the read-only git object store inspection tool bundle (git.refReaderTools(runner?)).
createGitResetWorktreeBuilder	Creates a fluent AstBuilder<GitDiscardBranchNode> (git.resetWorktree()).
createGitSnapshotAndResetBuilder	Creates a fluent AstBuilder<GitSnapshotAndResetNode> (git.snapshotAndReset()).
executeGitCleanWorkingTreeCheck	Evaluates a GitCleanWorkingTreeNode (git:clean-working-tree) conflict-clean check on ctx.scopeHandle.
executeGitCommitAndPushStep	Executes a GitCommitAndPushNode (git.commitAndPush) step against the active GitWorktreeHandle.
executeGitDiscardBranchHook	Executes a GitDiscardBranchNode (git.resetWorktree() / git.discardBranch()) rewind hook on input.handle.
executeGitKeepWorktreeHook	Executes a GitKeepWorktreeNode (git.keepWorktree()) rewind hook on input.handle.
executeGitMergeQueueStep	Executes a GitMergeQueueNode (git.mergeQueue) step using speculative cumulative rebase chains.
executeGitPatchEquivalence	Executes a GitPatchEquivalenceNode (git.patchEquivalence) across speculative worktree candidates.
executeGitPublicSurfaceCrossTester	Executes a GitPublicSurfaceCrossTesterNode (git.publicSurfaceCrossTester) across speculative candidates.
executeGitSnapshotAndResetHook	Executes a GitSnapshotAndResetNode (git.snapshotAndReset()) abort hook on input.handle.

Classes

Class	Description
GitCowWorktreeScopeDriver	Tier-3 branchable Copy-on-Write Git worktree isolation scope driver (git.cowWorktree).

Interfaces

Interface	Description
GitAbortMeta	Validated abort metadata produced by git.snapshotAndReset().
GitCandidateComparisonToolNode	Passive AST node for speculative candidate comparison and benchmark tools (git.candidateComparisonTools).
GitCheckpointPayload	Serialized checkpoint payload produced by GitCowWorktreeScopeDriver.serializeCheckpoint().
GitCleanWorkingTreeNode	Passive AST node verifying that a GitWorktreeHandle has zero unresolved conflict paths or paired conflict markers.
GitCommitAndPushBuilder	Fluent builder for a retry-safe commit, rebase, and push domain step (git.commitAndPush).
GitCommitAndPushNode	Passive AST node squashing, rebasing, verifying, and pushing a worktree branch (git.commitAndPush).
GitCommitAndPushOptions	Configuration options for git.commitAndPush(id, options) (createGitCommitAndPushBuilder).
GitCowWorktreeBuilder	Fluent builder for a Tier-3 branchable Copy-on-Write Git worktree scope (git.cowWorktree).
GitCowWorktreeNode	Passive AST node configuring a Tier-3 branchable Copy-on-Write Git worktree scope (git.cowWorktree).
GitCowWorktreeOptions	Configuration options for git.cowWorktree(options) (createGitCowWorktreeBuilder).
GitDiscardBranchNode	Passive AST node resetting a worktree to targetStepBaseScopeCheckpoint and clearing uncommitted run topology overlay mutations during .rewindTo() (git.resetWorktree / git.discardBranch).
GitKeepWorktreeNode	Passive AST node preserving a worktree's current working tree and topology overlay in-place across a signal-driven .rewindTo() (git.keepWorktree).
GitMergeQueueBuilder	Fluent builder for cumulative batch merge-train verification (git.mergeQueue).
GitMergeQueueNode	Passive AST node executing cumulative batch merge-train verification (git.mergeQueue).
GitMergeQueueOptions	Configuration options for git.mergeQueue(id, options) (createGitMergeQueueBuilder).
GitNamespace	Public git builder and schema namespace contract (import { git } from '@paraharness/git').
GitPatchEquivalenceNode	Passive AST node comparing patch equivalence across speculative worktree candidates (git.patchEquivalence).
GitPublicSurfaceCrossTesterNode	Passive AST node cross-executing boundary-only tests across speculative worktree candidates (git.publicSurfaceCrossTester).
GitPublicSurfaceCrossTesterOptions	Configuration options for git.publicSurfaceCrossTester(options) (createGitPublicSurfaceCrossTesterBuilder).
GitReconcileStrategyConfig	Branch landing reconciliation strategy ('rebase-onto-base' or 'batch-merge-train') for GitCowWorktreeNode.
GitReconcileStrategyOptions	Options for configuring branch landing reconciliation via GitCowWorktreeBuilder.reconcileStrategy().
GitRefReaderToolNode	Passive AST node for read-only git object store inspection tools (git.refReaderTools).
GitScopeReceipt	Validated scope inspection receipt produced by git.cowWorktree (inspect and commitChild).
GitSnapshotAndResetNode	Passive AST node snapshotting an aborted worktree to refs/harness/aborted/<run-id>/<stepExecId> and resetting the working tree to handle.baseRef (git.snapshotAndReset).
GitSyncReceipt	Validated synchronization receipt produced by git.cowWorktree (syncChild and syncRoot).
GitWorktreeHandle	Runtime scope handle for an isolated Copy-on-Write Git worktree (git.cowWorktree).

Type Aliases

HarnessMetaRecord

type HarnessMetaRecord = z.infer<typeof HarnessMetaSchema>;

Defined in: git/src/schemas/git-receipts.schema.ts:61

Inferred TypeScript record shape for <gitdir>/harness-meta.json.