worktree

type AttachOptions struct {
	Branch string // Any branch in the stack (we find the stack root)
	Name   string // Optional worktree name (defaults to stack root name)
}

type CreateOptions struct {
	Name  string // User-provided name for the worktree
	Scope string // Optional scope to set on the anchor branch
}

type DetachOptions struct {
	Selector WorktreeSelector // Worktree name or anchor branch
	Policy   RemovalPolicy    // Whether detach may discard uncommitted changes
}

type Entry struct {
	Name          engine.WorktreeName `json:"name"`          // User-provided name
	AnchorBranch  string              `json:"anchor_branch"` // Registered anchor branch name
	Path          WorktreePath        `json:"path"`
	StackSize     int                 `json:"stack_size"`               // Number of real branches in the stack
	CurrentBranch string              `json:"current_branch,omitempty"` // Branch currently checked out in this worktree
	RootBranches  []string            `json:"root_branches,omitempty"`  // Real stack roots visible to the user
	Lifecycle     WorktreeLifecycle   `json:"lifecycle"`
	StatusMessage string              `json:"status_message,omitempty"` // Human-readable summary of current state
	// contains filtered or unexported fields
}

type LifecycleCapability string

type ListOptions struct {
	Selector WorktreeSelector
}

type ListResult struct {
	Worktrees     []Entry
	CurrentAnchor string // Anchor branch of the worktree we're currently in (if any)
	// OwnershipWarnings report branches whose physical checkout location does
	// not agree with Stackit's derived ownership model. They are warnings so
	// `worktree list` remains useful for diagnosing a damaged repository.
	OwnershipWarnings []string `json:"ownership_warnings,omitempty"`
}

type OpenOptions struct {
	Selector WorktreeSelector // Worktree name or anchor branch
}

type PruneOptions struct {
	DryRun bool // If true, only show what would be pruned
}

type PruneResult struct {
	Pruned  []string       // Names of pruned worktrees
	Skipped []SkippedEntry // Worktrees that were skipped and why
}

type RegistrationState string

type RemovalPolicy = worktreeutil.RemovalPolicy

type RemoveOptions struct {
	Selector WorktreeSelector // Worktree name or anchor branch
	Policy   RemovalPolicy    // Whether removal may discard uncommitted changes
}

type RepairEntry struct {
	Name         string `json:"name"`
	Action       string `json:"action"`
	AnchorBranch string `json:"anchor_branch,omitempty"`
}

type RepairOptions struct {
	Selector WorktreeSelector
}

type RepairResult struct {
	Repaired []RepairEntry  `json:"repaired"`
	Skipped  []SkippedEntry `json:"skipped,omitempty"`
}

type SkippedEntry struct {
	Name   string
	Reason string
}

type WarmStartResult struct {
	Enabled         bool
	Copied          []string
	SkippedExisting []string
	// SkippedUnsafe lists files that could not be placed because something on
	// their path is not a plain directory — most often a tracked file on trunk
	// occupying a name the include file also selects as a directory.
	SkippedUnsafe []WarmStartSkip
}

type WarmStartSkip struct {
	Path   string
	Reason string
}

type WorktreeChanges string

type WorktreeCheckout string

type WorktreeLifecycle struct {
	Registration RegistrationState   `json:"registration_state"`
	Presence     WorktreePresence    `json:"presence"`
	Checkout     WorktreeCheckout    `json:"checkout"`
	Changes      WorktreeChanges     `json:"changes"`
	Remove       LifecycleCapability `json:"remove"`
	Detach       LifecycleCapability `json:"detach"`
}

type WorktreePath = engine.WorktreePath

type WorktreePresence string

type WorktreeResult struct {
	Name         string       // The name of the worktree
	AnchorBranch string       // The name of the anchor branch
	Path         WorktreePath // The path to the worktree
}

type WorktreeSelector string