Skip to content

Interface: GitCowWorktreeNode<THandle, TReceipt, TSync> ​

Defined in: core/dist/ast/domain/git-cow-worktree-node.d.ts:34

Passive AST node configuring a Tier-3 branchable Copy-on-Write Git worktree scope (git.cowWorktree).

Provides isolated root and child worktrees, dirty-index checkpointing without mutating HEAD, 3-way child/root reconciliation, and automatic conflict cleanliness verification.

Extends ​

Type Parameters ​

Type ParameterDefault typeDescription
THandleGitWorktreeHandleWorktree scope handle type.
TReceipt extends Record<string, unknown>GitScopeReceiptValidated scope inspection receipt type.
TSync extends Record<string, unknown>GitSyncReceiptValidated scope synchronization receipt type.

Properties ​

PropertyModifierTypeDescriptionOverridesInherited fromDefined in
__handleBrand?readonlyBivariantCallback<[handle: THandle], void>Phantom type brand binding the scope node to its runtime handle type.-BaseIsolationScopeASTNode.__handleBrandcore/dist/ast/base/base-isolation-scope-ast-node.d.ts:35
capabilityTierreadonly"branchable"Declarative capability tier governing allowed flow and actor features.-BaseIsolationScopeASTNode.capabilityTiercore/dist/ast/base/base-isolation-scope-ast-node.d.ts:23
checkpointPolicy?readonlyobjectOptional dirty-index checkpointing configuration.--core/dist/ast/domain/git-cow-worktree-node.d.ts:46
checkpointPolicy.excludeGlobs?readonlyreadonly string[]Optional glob patterns excluded from dirty-tree checkpoint snapshots.--core/dist/ast/domain/git-cow-worktree-node.d.ts:50
checkpointPolicy.maxUntrackedFileSizeBytes?readonlynumberMaximum file size in bytes staged directly into the temporary git index before spilling to harness-ckpt-blobs/.--core/dist/ast/domain/git-cow-worktree-node.d.ts:52
checkpointPolicy.partitionMap?readonlyFsPartitionMapNode<string>Optional filesystem partition map associated with the checkpoint policy.--core/dist/ast/domain/git-cow-worktree-node.d.ts:48
conflictCleanCheckreadonlyGitCleanWorkingTreeNode<THandle>Built-in conflict cleanliness check enforced after conflicted merges or rebases.BaseIsolationScopeASTNode.conflictCleanCheck-core/dist/ast/domain/git-cow-worktree-node.d.ts:57
dirreadonlystringBase directory under which roots/<runId> and forks/<runId>/<forkId> worktrees are created.--core/dist/ast/domain/git-cow-worktree-node.d.ts:38
excludeFromCloneGlobs?readonlyreadonly string[]Optional glob patterns excluded when cloning dirty working-tree files into a worktree.--core/dist/ast/domain/git-cow-worktree-node.d.ts:44
idreadonlystringLogical identifier of the isolation scope configuration.-BaseIsolationScopeASTNode.idcore/dist/ast/base/base-isolation-scope-ast-node.d.ts:21
lockfileGatePath?readonlystringOptional lockfile path whose digest gates whether setupCommands can be skipped.--core/dist/ast/domain/git-cow-worktree-node.d.ts:42
receiptSchemareadonlyZodType<TReceipt>Zod schema validating scope receipts returned by inspect() and commitChild().-BaseIsolationScopeASTNode.receiptSchemacore/dist/ast/base/base-isolation-scope-ast-node.d.ts:29
reconcileStrategy?readonlyGitReconcileStrategyConfig<THandle>Optional branch landing reconciliation strategy ('rebase-onto-base' or 'batch-merge-train').--core/dist/ast/domain/git-cow-worktree-node.d.ts:55
reporeadonlystringPath to the host Git repository.--core/dist/ast/domain/git-cow-worktree-node.d.ts:36
setupCommandsreadonlyreadonly ASTNode[]Ordered setup step AST nodes executed when initializing a root worktree.--core/dist/ast/domain/git-cow-worktree-node.d.ts:40
supportsBranchingreadonlytrueCompile-time boolean brand indicating whether BranchableScope is supported.-BaseIsolationScopeASTNode.supportsBranchingcore/dist/ast/base/base-isolation-scope-ast-node.d.ts:27
supportsCheckpointsreadonlytrueCompile-time boolean brand indicating whether CheckpointableScope is supported.-BaseIsolationScopeASTNode.supportsCheckpointscore/dist/ast/base/base-isolation-scope-ast-node.d.ts:25
syncSchema?readonlyZodType<TSync, unknown, $ZodTypeInternals<TSync, unknown>>Optional Zod schema validating sync receipts returned by syncChild() and syncRoot().-BaseIsolationScopeASTNode.syncSchemacore/dist/ast/base/base-isolation-scope-ast-node.d.ts:31
typereadonly"git:cow-worktree"Unique string-literal discriminant of the isolation scope node.-BaseIsolationScopeASTNode.typecore/dist/ast/base/base-isolation-scope-ast-node.d.ts:19

Released under the MIT License.