worktree

Documentation

Index

• func ApplyPatch(repoPath, patch string) error
• func CheckPatch(repoPath, patch string) error
• type PatchConflictError
  • func (e *PatchConflictError) Error() string
• type Worktree
  • func Create(repoPath, ref string) (_ *Worktree, err error)
  • func (w *Worktree) CapturePatch() (string, error)
  • func (w *Worktree) Close()

Functions

func ApplyPatch

func ApplyPatch(repoPath, patch string) error

ApplyPatch applies a patch to a repository. Returns nil if patch is empty.

func CheckPatch

func CheckPatch(repoPath, patch string) error

CheckPatch does a dry-run apply to check if a patch applies cleanly. Returns a *PatchConflictError when the patch fails due to conflicts, or a plain error for other failures (malformed patch, etc.).

Types

type PatchConflictError

type PatchConflictError struct {
	Detail string
}

PatchConflictError indicates the patch does not apply due to merge conflicts. Other errors (malformed patch, permission errors) are returned as plain errors.

func (*PatchConflictError) Error

func (e *PatchConflictError) Error() string

type Worktree

type Worktree struct {
	Dir string // Path to the worktree directory
	// contains filtered or unexported fields
}

Worktree represents a temporary git worktree for isolated agent work. Call Close to remove the worktree and its directory.

func Create

func Create(repoPath, ref string) (_ *Worktree, err error)

Create creates a temporary git worktree detached at the given ref for isolated agent work. Pass "HEAD" for the current checkout.

func (*Worktree) CapturePatch

func (w *Worktree) CapturePatch() (string, error)

CapturePatch stages all changes in the worktree and returns the diff as a patch string. Returns empty string if there are no changes. Handles both uncommitted and committed changes by diffing the final tree state against the base SHA.

func (*Worktree) Close

func (w *Worktree) Close()

Close removes the worktree and its directory.