pluck

type Deps struct {
	Engine Engine
	Log    output.Logger
	actions.MutationDeps
}

type Engine interface {
	validation.BranchValidationEngine
	actions.OwnershipEngine
	Trunk() engine.Branch
	IsTrunk(branch engine.Branch) bool
	Graph(ctx context.Context, strategy engine.SortStrategy) *engine.StackGraph
	GetAllCommits(ctx context.Context, branch engine.Branch) (git.Commits, error)
	BatchRevisions(ctx context.Context, branches engine.Branches) engine.RevisionMap
	GetDivergencePoint(ctx context.Context, branchName string) (string, error)
	BatchDivergencePoints(ctx context.Context, branches engine.Branches) engine.RevisionMap
	ValidateRebases(ctx context.Context, specs []engine.RebaseSpec) (*engine.RebaseValidation, error)
	ReparentBranchesToParents(ctx context.Context, moves []engine.BranchParentMove, opts engine.ReparentOpts) error
	AssignBranchesToNewStack(ctx context.Context, root engine.Branch, branches engine.Branches) (string, error)
}

type Handler interface {
	// Start is called at the beginning of pluck
	Start(move basehandler.Reparent)

	// OnStep is called for each step in the pluck process
	OnStep(step Step, status basehandler.StepStatus, message string)

	// OnChildReparented is called when a child is reparented to the grandparent
	OnChildReparented(move basehandler.Reparent)

	// Complete is called when pluck finishes
	Complete(result Result)

	// Cleanup restores terminal state (may be no-op)
	Cleanup()

	// IsInteractive returns true if the handler supports interactive prompts
	IsInteractive() bool

	// PromptConfirmPluck displays a preview of the pluck and asks for confirmation.
	// Returns true to proceed with the pluck, false to cancel.
	// In non-interactive mode, returns true (auto-confirm).
	PromptConfirmPluck(preview Preview) (bool, error)
}

type NullHandler struct {
	basehandler.NullBase
	basehandler.NullProgress[Step]
}

type Options struct {
	Source      string // Branch to pluck (defaults to current branch)
	Onto        string // Branch to pluck onto
	SkipConfirm bool   // Skip confirmation prompt (--yes flag)
}

type Preview struct {
	SourceBranch   string   // Branch being plucked
	OldParent      string   // Current parent of source
	NewParent      string   // Target parent for source
	Children       []string // Direct children that will be reparented
	ChildNewParent string   // Where children will be reparented (grandparent)
	Commits        []string // Commit subjects on the source branch
}

type Result struct {
	SourceBranch       string   // Branch that was plucked
	OldParent          string   // Previous parent of source
	NewParent          string   // New parent of source
	ReparentedChildren []string // Children that were reparented to grandparent
}

type Step string