github

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

type AutoMergeStatus struct {
	Enabled     bool
	EnabledAt   string
	EnabledBy   string
	MergeMethod string
}

type CheckConclusion string

type CheckDetail struct {
	Name       string
	Status     CheckRunStatus
	Conclusion CheckConclusion
	StartedAt  time.Time
	FinishedAt time.Time
}

type CheckRunStatus string

type CheckStatus struct {
	Passing        bool
	Pending        bool
	Checks         []CheckDetail
	ReviewDecision ReviewDecision // empty if none
	Author         string         // GitHub username of PR author
	State          git.PRState    // empty if unknown
}

type ChecksByBranch map[string]*CheckStatus

type Client interface {
	// CreatePullRequest creates a new pull request
	CreatePullRequest(ctx context.Context, opts CreatePROptions) (*PullRequestInfo, error)

	// UpdatePullRequest updates an existing pull request
	// Returns warnings (non-fatal issues like failed label/assignee additions) and error
	UpdatePullRequest(ctx context.Context, prNumber int, opts UpdatePROptions) (warnings []string, err error)

	// GetPullRequestByBranch gets a pull request for a branch
	GetPullRequestByBranch(ctx context.Context, branchName string) (*PullRequestInfo, error)

	// GetPullRequest gets a pull request by number
	GetPullRequest(ctx context.Context, prNumber int) (*PullRequestInfo, error)

	// MergePullRequest merges a pull request using the specified merge method
	MergePullRequest(ctx context.Context, branchName string, opts MergePROptions) error

	// GetAllowedMergeMethods returns the allowed merge methods for the repository
	GetAllowedMergeMethods(ctx context.Context) (*MergeMethodSettings, error)

	// GetPRChecksStatus returns the check status for a single branch
	GetPRChecksStatus(ctx context.Context, branchName string) (*CheckStatus, error)

	// BatchGetPRChecksStatus returns the check status for multiple branches
	BatchGetPRChecksStatus(ctx context.Context, branchNames []string) (ChecksByBranch, error)

	// BatchGetPRTitles returns titles for multiple PRs by number
	BatchGetPRTitles(ctx context.Context, prNumbers []int) (map[int]string, error)

	// Repo returns the repository the client is bound to
	Repo() Repo

	// ClosePullRequest closes a pull request
	ClosePullRequest(ctx context.Context, prNumber int) error

	// Comment methods for navigation location support
	// CreatePRComment creates a new comment on a pull request
	CreatePRComment(ctx context.Context, prNumber int, body string) (int64, error)

	// UpdatePRComment updates an existing pull request comment
	UpdatePRComment(ctx context.Context, commentID int64, body string) error

	// DeletePRComment deletes a pull request comment
	DeletePRComment(ctx context.Context, commentID int64) error

	// ListPRComments lists all comments on a pull request
	ListPRComments(ctx context.Context, prNumber int) ([]PRComment, error)

	// GetCurrentUser returns the authenticated GitHub username
	GetCurrentUser(ctx context.Context) (string, error)
}

type CreatePROptions struct {
	Title         string
	Body          string
	Head          string
	Base          string
	Draft         bool
	Reviewers     []string
	TeamReviewers []string
	Labels        []string
	Assignees     []string
}

type EnableAutoMergeOptions struct {
	MergeMethod MergeMethod
	CommitBody  string // optional — omit for default GitHub behavior
}

type GitCommandRunner interface {
	GetConfig(key string) (string, error)
	RunGHCommandWithContext(ctx context.Context, args ...string) (string, error)
}

type MergeMethod string

type MergeMethodSettings struct {
	AllowMergeCommit bool
	AllowSquashMerge bool
	AllowRebaseMerge bool
}

type MergePROptions struct {
	Method     MergeMethod
	CommitBody string // Optional commit body for merge/squash commit message.
}

type PRComment struct {
	ID   int64
	Body string
}

type PRContent struct {
	Title string
	Body  string
}

type PRMergeableState struct {
	Mergeable      bool   // True if PR can be merged without conflicts
	MergeStateText string // mergeStateStatus value: CLEAN, DIRTY, BLOCKED, UNKNOWN, etc.
	State          git.PRState
}

type PRStateBody struct {
	State git.PRState
	Body  string
}

type PullRequestInfo struct {
	Number  int
	NodeID  string
	HTMLURL string
	Title   string
	Body    string
	State   git.PRState
	Draft   bool
	Base    string
	Head    string
	// Warnings contains non-fatal issues that occurred during PR creation/update
	// (e.g., failed to add labels or assignees)
	Warnings []string
}

type Repo struct {
	Owner string
	Name  string
}

type RepoAccess struct {
	Owner         string
	Name          string
	DefaultBranch string
	CloneURL      string
	Private       bool
	CanPush       bool
}

type RepoInfo struct {
	Hostname string
	Owner    string
	Repo     string
}

type ReviewDecision string

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

type UpdatePROptions struct {
	Title           *string
	Body            *string
	Base            *string
	Draft           *bool
	Reviewers       []string
	TeamReviewers   []string
	Labels          []string
	Assignees       []string
	MergeWhenReady  *bool
	RerequestReview bool
}