checkout

type Deps struct {
	Engine Engine
	Out    output.Output
	Log    output.Logger
	// Quiet skips the "already on" notice and the post-checkout branch info.
	Quiet bool
	Here  actions.Here
}

type Engine interface {
	engine.BranchLookup
	Trunk() engine.Branch
	CurrentBranch(ctx context.Context) *engine.Branch
	AllBranches() engine.Branches
	BranchNames() *engine.BranchSet
	GetScope(branch engine.Branch) engine.Scope
	SortBranchesTopologically(ctx context.Context, branches engine.Branches) engine.Branches
	Graph(ctx context.Context, strategy engine.SortStrategy) *engine.StackGraph
	ReadBranchStatuses(ctx context.Context, branches engine.Branches) engine.BranchStatuses
	GetStackRootForBranch(branch engine.Branch) string
	GetWorktreeForStack(ctx context.Context, stackRoot string) (*engine.WorktreeInfo, error)
	CheckoutBranch(ctx context.Context, branch engine.Branch) error
}

type Handler interface {
	// SelectBranch prompts the user to select a branch interactively.
	// Returns the selected branch name, or an error if selection failed or was canceled.
	SelectBranch(ctx context.Context, opts Options) (string, error)
}

type NullHandler struct{}

type Options struct {
	BranchName         string // Optional: branch to checkout directly
	ShowUntracked      bool   // Include untracked branches in selection
	All                bool   // Show all branches across trunks
	StackOnly          bool   // Only show current stack (ancestors + descendants)
	CheckoutTrunk      bool   // Checkout trunk directly
	SkipWorktreeSwitch bool   // Skip worktree switch logic (for fallback checkout)
}

type Result struct {
	WorktreeSwitchPath string
	RerunArgs          []string
	FallbackTips       []string
	TargetBranch       string
}