submit

type BranchInfo struct {
	Name     string
	Action   engine.SubmitAction
	PRNumber *git.PRNumber
}

type BranchPlanEvent struct {
	Regenerated *PRContentPreview // present for regeneration dry runs
	BranchName  string
	Action      engine.SubmitAction
	PRNumber    *git.PRNumber // existing PR number for updates, nil for creates
	IsCurrent   bool
	Empty       bool // branch has no commits relative to its parent
	Skipped     bool
	SkipReason  string
}

type BranchProgressEvent struct {
	BranchName string
	Status     BranchStatus
	URL        string // set on success
	Error      error  // set on failure
}

type BranchStatus string

type BranchWarningEvent struct {
	BranchName string
	Warning    string
}

type ChannelHandler struct {
	// contains filtered or unexported fields
}

type CompletionEvent struct {
	Outcome  CompletionOutcome
	Message  string        // human-readable detail, e.g. "All PRs up to date"
	Duration time.Duration // elapsed run time; set when branches were submitted
}

type CompletionOutcome string

type Config interface {
	GitHubStack() bool
	LinearStacks() bool
}

type Deps struct {
	Engine Engine
	Out    output.Output
	Log    output.Logger
	// GitHub returns the client, or nil when GitHub is unavailable. It is a
	// function so the client is only built when submit actually needs it.
	GitHub func() github.Client
	// GitHubError explains why GitHub returned nil, when known. May be nil.
	GitHubError func() error
	// GHRunner runs the GraphQL queries that sync PR info before validation.
	GHRunner github.GitCommandRunner
	// PRSync refreshes PR footers and titles after the submission phase.
	PRSync actions.PRSync
	// Restack is what --restack runs actions.RunRestack with.
	Restack   actions.RestackDeps
	Snapshots actions.Snapshots
	Prompts   handler.Prompter
	// Verify reflects the global --verify flag; false skips push hooks.
	Verify bool
	Config Config
}

type Engine interface {
	engine.BranchReader
	actions.MetadataPushEngine
	TrackBranch(ctx context.Context, branchName string, parentBranchName string) error
	ListManagedWorktrees(ctx context.Context) ([]engine.WorktreeInfo, error)
	GetStackRootForBranch(branch engine.Branch) string
	MarkBranchesSubmitPending(ctx context.Context, branchNames []string) error
	ClearBranchesSubmitPending(ctx context.Context, branchNames []string) error
	PushBranches(ctx context.Context, remote string, specs []git.PushSpec, opts git.PushOptions) git.PushResults
	UpsertPrInfo(ctx context.Context, branch engine.Branch, prInfo *engine.PrInfo) error
	BatchUpsertPrInfo(ctx context.Context, updates map[string]*engine.PrInfo) error
	GetStackIDsForBranches(branches engine.Branches) []string
	PushStackMetadata(ctx context.Context, stackIDs []string) error
}

type Event interface {
	// contains filtered or unexported methods
}

type GitHubStackSkippedEvent struct {
	Reason string
}

type GitHubStackSyncedEvent struct {
	Number       github.StackNumber
	PullRequests []git.PRNumber
	Action       github.StackSyncAction
}

type Handler interface {
	// OnEvent is called for each event during submission.
	// Handlers should use type switches to handle specific event types.
	OnEvent(event Event)

	// Confirm prompts for user confirmation when the --confirm flag is used.
	// Returns (confirmed, error).
	// Non-interactive handlers should return (defaultYes, nil).
	Confirm(message string, defaultYes bool) (bool, error)

	// IsInteractive returns true if the handler supports interactive prompts.
	// Used to determine whether to prompt for actions like tracking untracked branches.
	IsInteractive() bool
}

type Info struct {
	BranchName string
	Head       string
	Base       string
	HeadSHA    string
	BaseSHA    string
	Action     engine.SubmitAction
	PRNumber   *git.PRNumber
	Metadata   *PRMetadata
}

type JSONBranchResult struct {
	Branch      string            `json:"branch"`
	Action      string            `json:"action,omitempty"` // "create" or "update"
	Status      string            `json:"status"`           // pending, done, error, skipped
	PR          *git.PRNumber     `json:"pr,omitempty"`
	URL         string            `json:"url,omitempty"`
	SkipReason  string            `json:"skip_reason,omitempty"`
	Error       string            `json:"error,omitempty"`
	Warnings    []string          `json:"warnings,omitempty"`
	Regenerated *PRContentPreview `json:"regenerated,omitempty"`
}

type JSONGitHubStackResult struct {
	Number       github.StackNumber `json:"number"`
	PullRequests []git.PRNumber     `json:"pull_requests"`
	Action       string             `json:"action"`
}

type JSONHandler struct {
	Result *JSONResult
	// contains filtered or unexported fields
}

type JSONResult struct {
	Outcome  CompletionOutcome  `json:"outcome"`
	Message  string             `json:"message,omitempty"`
	Error    string             `json:"error,omitempty"`
	Branches []JSONBranchResult `json:"branches"`
	// GitHubStacks contains every native GitHub Stack reconciled during submit.
	GitHubStacks []JSONGitHubStackResult `json:"github_stacks,omitempty"`
	// GitHubStackSkips contains every reason configured native Stack sync skipped
	// an otherwise submitted component.
	GitHubStackSkips []string `json:"github_stack_skips,omitempty"`
	// GitHubStack is retained for backwards compatibility when exactly one
	// native Stack was reconciled. Use GitHubStacks for new consumers.
	GitHubStack *JSONGitHubStackResult `json:"github_stack,omitempty"`
	// GitHubStackSkipped is retained for backwards compatibility when exactly
	// one component was skipped. Use GitHubStackSkips for new consumers.
	GitHubStackSkipped string `json:"github_stack_skipped,omitempty"`
}

type MetadataOptions struct {
	Text PRTextSource
	// EditTitle and EditBody are the resolved per-field prompt decisions.
	EditTitle       bool
	EditBody        bool
	Draft           bool
	Publish         bool
	Reviewers       string
	ReviewersPrompt bool
	// Config-driven options
	ConfigDraft     bool     // Default draft mode from config (used for new PRs)
	ConfigReviewers []string // Default reviewers from config
	ConfigLabels    []string // Default labels from config
	ConfigAssignees []string // Default assignees from config
}

type Options struct {
	Branch               string
	StackRange           engine.StackRange
	Force                bool
	DryRun               bool
	Confirm              bool
	UpdateOnly           bool
	Always               bool
	Text                 PRTextSource
	Restack              bool
	Draft                bool
	Publish              bool
	Edit                 bool
	EditTitle            bool
	EditDescription      bool
	NoEdit               bool
	NoEditTitle          bool
	NoEditDescription    bool
	Reviewers            string
	TeamReviewers        string
	MergeWhenReady       bool
	RerequestReview      bool
	View                 bool
	Web                  bool
	Comment              string
	TargetTrunk          string
	IgnoreOutOfSyncTrunk bool
	SubmitFooter         bool // Whether to include PR footer (from config)
	NoLabels             bool // Skip applying default labels from config
	NoAssignees          bool // Skip applying default assignees from config
	CreateGitHubStack    bool // Create native GitHub Stack metadata after submitting PRs

	// Config-driven options (these are merged with flags)
	ConfigDraft       bool     // Default draft mode from config
	ConfigGitHubStack bool     // Sync native GitHub Stack metadata for eligible submits
	ConfigWeb         string   // When to open browser from config (always/created/never)
	ConfigLabels      []string // Default labels from config
	ConfigReviewers   []string // Default reviewers from config
	ConfigAssignees   []string // Default assignees from config
}

type PRContentPreview struct {
	Title string `json:"title"`
	Body  string `json:"body"`
}

type PRMetadata struct {
	Title         string
	Body          string
	IsDraft       bool
	Reviewers     []string
	TeamReviewers []string
	Labels        []string // Labels to apply to the PR
	Assignees     []string // Assignees to apply to the PR
}

type PRTextSource int

type PlanningCompleteEvent struct{}

type PreparingEvent struct{}

type RestackBranchEvent struct {
	actions.RestackBranchEvent
}

type RestackEvent struct {
	Started   bool
	Completed bool
	Summary   actions.RestackSummary
}

type StackDisplayEvent struct {
	Stack StackSnapshot
}

type StackSnapshot struct {
	Branches      []string                       // branches in the stack, in order
	CurrentBranch string                         // currently checked out branch
	TrunkBranch   string                         // trunk/main branch name
	ParentMap     map[string]string              // branch -> parent
	FixedMap      map[string]bool                // branch -> is fixed (doesn't need restack)
	ScopeMap      map[string]string              // branch -> scope
	WorktreeMap   map[string]engine.WorktreePath // branch -> worktree path (for stack roots with managed worktrees)
}

type SubmissionStartEvent struct {
	Branches []BranchInfo
}