Skip to content

Interface: GitCowWorktreeNode<THandle, TReceipt, TSync> ​

Defined in: ast/domain/git-cow-worktree-node.ts:36

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.__handleBrandast/base/base-isolation-scope-ast-node.ts:42
capabilityTierreadonly"branchable"Declarative capability tier governing allowed flow and actor features.-BaseIsolationScopeASTNode.capabilityTierast/base/base-isolation-scope-ast-node.ts:30
checkpointPolicy?readonlyobjectOptional dirty-index checkpointing configuration.--ast/domain/git-cow-worktree-node.ts:58
checkpointPolicy.excludeGlobs?readonlyreadonly string[]Optional glob patterns excluded from dirty-tree checkpoint snapshots.--ast/domain/git-cow-worktree-node.ts:62
checkpointPolicy.maxUntrackedFileSizeBytes?readonlynumberMaximum file size in bytes staged directly into the temporary git index before spilling to harness-ckpt-blobs/.--ast/domain/git-cow-worktree-node.ts:64
checkpointPolicy.partitionMap?readonlyFsPartitionMapNode<string>Optional filesystem partition map associated with the checkpoint policy.--ast/domain/git-cow-worktree-node.ts:60
conflictCleanCheckreadonlyGitCleanWorkingTreeNode<THandle>Built-in conflict cleanliness check enforced after conflicted merges or rebases.BaseIsolationScopeASTNode.conflictCleanCheck-ast/domain/git-cow-worktree-node.ts:69
dirreadonlystringBase directory under which roots/<runId> and forks/<runId>/<forkId> worktrees are created.--ast/domain/git-cow-worktree-node.ts:50
excludeFromCloneGlobs?readonlyreadonly string[]Optional glob patterns excluded when cloning dirty working-tree files into a worktree.--ast/domain/git-cow-worktree-node.ts:56
idreadonlystringLogical identifier of the isolation scope configuration.-BaseIsolationScopeASTNode.idast/base/base-isolation-scope-ast-node.ts:28
lockfileGatePath?readonlystringOptional lockfile path whose digest gates whether setupCommands can be skipped.--ast/domain/git-cow-worktree-node.ts:54
receiptSchemareadonlyZodType<TReceipt>Zod schema validating scope receipts returned by inspect() and commitChild().-BaseIsolationScopeASTNode.receiptSchemaast/base/base-isolation-scope-ast-node.ts:36
reconcileStrategy?readonlyGitReconcileStrategyConfig<THandle>Optional branch landing reconciliation strategy ('rebase-onto-base' or 'batch-merge-train').--ast/domain/git-cow-worktree-node.ts:67
reporeadonlystringPath to the host Git repository.--ast/domain/git-cow-worktree-node.ts:48
setupCommandsreadonlyreadonly ASTNode[]Ordered setup step AST nodes executed when initializing a root worktree.--ast/domain/git-cow-worktree-node.ts:52
supportsBranchingreadonlytrueCompile-time boolean brand indicating whether BranchableScope is supported.-BaseIsolationScopeASTNode.supportsBranchingast/base/base-isolation-scope-ast-node.ts:34
supportsCheckpointsreadonlytrueCompile-time boolean brand indicating whether CheckpointableScope is supported.-BaseIsolationScopeASTNode.supportsCheckpointsast/base/base-isolation-scope-ast-node.ts:32
syncSchema?readonlyZodType<TSync, unknown, $ZodTypeInternals<TSync, unknown>>Optional Zod schema validating sync receipts returned by syncChild() and syncRoot().-BaseIsolationScopeASTNode.syncSchemaast/base/base-isolation-scope-ast-node.ts:38
typereadonly"git:cow-worktree"Unique string-literal discriminant of the isolation scope node.-BaseIsolationScopeASTNode.typeast/base/base-isolation-scope-ast-node.ts:26

Released under the MIT License.