lock

type Deps struct {
	Engine Engine
	Out    output.Output
	// PRSync pushes the lock metadata and refreshes the affected PRs.
	PRSync actions.PRSync
	// Submit runs the nested submit offered before locking unpushed branches.
	Submit submit.Deps
}

type Engine interface {
	engine.BranchLookup
	Graph(ctx context.Context, strategy engine.SortStrategy) *engine.StackGraph
	ReadBranchRemoteStatuses(ctx context.Context, branches engine.Branches) engine.BranchRemoteStatuses
	SetLocked(ctx context.Context, branches engine.Branches, reason engine.LockReason) (engine.BatchLockResult, error)
}

type Handler interface {
	// PromptSubmitBeforeLock prompts user to submit unpushed changes before locking
	// Returns true to submit before locking, false to skip
	PromptSubmitBeforeLock(unpushedBranches []string) (bool, error)

	// PromptUnlockDownstack prompts user to also unlock downstack locked branches
	// Returns true to unlock downstack branches, false to skip
	PromptUnlockDownstack(lockedBranchNames []string) (bool, error)

	// GetSubmitHandler returns a handler for the nested submit operation
	SubmitHandler() submit.Handler

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

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

type NullHandler struct {
	handler.NullBase
}