platform

type CheckService interface {
	// GetCombinedStatus returns the combined CI status for a ref (branch or SHA).
	// Returns "success", "failure", "pending", or "error".
	GetCombinedStatus(ctx context.Context, ref string) (string, error)

	// RerunFailedChecks re-runs failed check suites for a ref.
	RerunFailedChecks(ctx context.Context, ref string) error
}

type Comment struct {
	ID                int64
	Body              string
	AuthorLogin       string
	AuthorAssociation string // "OWNER", "MEMBER", "COLLABORATOR", "CONTRIBUTOR", "NONE", etc.
}

type Issue struct {
	Number    int
	Title     string
	Body      string
	State     string // "open", "closed"
	Labels    []string
	Milestone *Milestone
	Assignees []string
	URL       string
	UpdatedAt time.Time
}

type IssueFilters struct {
	State     string // "open", "closed", "all"
	Labels    []string
	Milestone *int
}

type IssueService interface {
	Create(ctx context.Context, title, body string, labels []string, milestone *int) (*Issue, error)
	Get(ctx context.Context, number int) (*Issue, error)
	List(ctx context.Context, filters IssueFilters) ([]*Issue, error)
	Update(ctx context.Context, number int, changes IssueUpdate) (*Issue, error)
	AddLabels(ctx context.Context, number int, labels []string) error
	RemoveLabels(ctx context.Context, number int, labels []string) error
	AddComment(ctx context.Context, number int, body string) error
	AddCommentReturningID(ctx context.Context, number int, body string) (int64, error)
	UpdateComment(ctx context.Context, commentID int64, body string) error
	DeleteComment(ctx context.Context, commentID int64) error
	ListComments(ctx context.Context, number int) ([]*Comment, error)
	CreateCommentReaction(ctx context.Context, commentID int64, reaction string) error
}

type IssueUpdate struct {
	Title     *string
	Body      *string
	State     *string // "open", "closed"
	Milestone *int    // 0 to clear
}

type Label struct {
	Name        string
	Color       string
	Description string
}

type LabelService interface {
	Create(ctx context.Context, name, color, description string) error
	List(ctx context.Context) ([]*Label, error)
	Delete(ctx context.Context, name string) error
}

type MergeMethod string

type MergeResult struct {
	SHA     string
	Merged  bool
	Message string
}

type Milestone struct {
	Number       int
	Title        string
	Description  string
	State        string // "open", "closed"
	DueDate      *time.Time
	OpenIssues   int
	ClosedIssues int
}

type MilestoneService interface {
	Create(ctx context.Context, title, description string, dueDate *time.Time) (*Milestone, error)
	Get(ctx context.Context, number int) (*Milestone, error)
	List(ctx context.Context) ([]*Milestone, error)
	Update(ctx context.Context, number int, changes MilestoneUpdate) (*Milestone, error)
}

type MilestoneUpdate struct {
	Title       *string
	Description *string
	State       *string // "open", "closed"
	DueDate     *time.Time
}

type PRFilters struct {
	State string // "open", "closed", "all"
	Head  string
	Base  string
}

type Platform interface {
	Issues() IssueService
	PullRequests() PullRequestService
	Workflows() WorkflowService
	Labels() LabelService
	Milestones() MilestoneService
	Runners() RunnerService
	Repository() RepositoryService
	Checks() CheckService
}

type PullRequest struct {
	Number         int
	Title          string
	Body           string
	State          string // "open", "closed", "merged"
	Head           string // branch name
	Base           string // target branch
	Labels         []string
	Mergeable      bool
	MergeableKnown bool // false when GitHub is still computing mergeability
	URL            string
	CreatedAt      time.Time
}

type PullRequestFile struct {
	Path         string
	PreviousPath string
	Status       string
	Additions    int
	Deletions    int
	Changes      int
	Patch        string
	SHA          string
	BlobURL      string
	RawURL       string
	ContentsURL  string
}

type PullRequestService interface {
	Create(ctx context.Context, title, body, head, base string) (*PullRequest, error)
	Get(ctx context.Context, number int) (*PullRequest, error)
	List(ctx context.Context, filters PRFilters) ([]*PullRequest, error)
	Update(ctx context.Context, number int, title, body *string) (*PullRequest, error)
	Merge(ctx context.Context, number int, method MergeMethod) (*MergeResult, error)
	UpdateBranch(ctx context.Context, number int) error
	CreateReview(ctx context.Context, number int, body string, event ReviewEvent) error
	AddComment(ctx context.Context, number int, body string) error
	ListReviewComments(ctx context.Context, number int) ([]*ReviewComment, error)
	ListFiles(ctx context.Context, number int) ([]*PullRequestFile, error)
	GetDiff(ctx context.Context, number int) (string, error)
	Close(ctx context.Context, number int) error
}

type RepoInfo struct {
	Owner         string
	Name          string
	DefaultBranch string
	Private       bool
	URL           string
}

type RepositoryService interface {
	GetInfo(ctx context.Context) (*RepoInfo, error)
	GetDefaultBranch(ctx context.Context) (string, error)
	CreateBranch(ctx context.Context, name, fromSHA string) error
	DeleteBranch(ctx context.Context, name string) error
	GetBranchSHA(ctx context.Context, name string) (string, error)
}

type ReviewComment struct {
	ID                int64
	Body              string
	AuthorLogin       string
	AuthorAssociation string // "OWNER", "MEMBER", "COLLABORATOR", "CONTRIBUTOR", "NONE", etc.
	Path              string // file path the comment is on
	Line              int    // line number in the diff (0 if not anchored)
	DiffHunk          string // short diff hunk surrounding the comment
}

type ReviewEvent string

type Run struct {
	ID           int64
	WorkflowID   int64
	WorkflowName string
	WorkflowPath string
	HeadBranch   string
	HeadSHA      string
	Status       string            // "queued", "in_progress", "completed"
	Conclusion   string            // "success", "failure", "cancelled"
	Inputs       map[string]string // workflow_dispatch inputs
	URL          string
	CreatedAt    time.Time
}

type RunFilters struct {
	WorkflowID              int64
	WorkflowFileName        string // e.g. "herd-worker.yml" — used to filter by workflow file
	Status                  string // "queued", "in_progress", "completed"
	Branch                  string
	ResolveWorkflowIdentity bool // resolve workflow_id to the canonical workflow name/path
}

type Runner struct {
	ID     int64
	Name   string
	Status string // "online", "offline"
	Labels []string
	Busy   bool
}

type RunnerService interface {
	List(ctx context.Context) ([]*Runner, error)
	Get(ctx context.Context, id int64) (*Runner, error)
}

type WorkflowJobDiagnostic struct {
	ID         int64
	Name       string
	URL        string
	Conclusion string
	Status     string
}

type WorkflowRunDiagnostics struct {
	RunID       int64
	Workflow    string
	URL         string
	Conclusion  string
	HeadBranch  string
	HeadSHA     string
	Jobs        []WorkflowJobDiagnostic
	Annotations []string
	LogExcerpt  string
	LogStatus   string
}

type WorkflowService interface {
	GetWorkflow(ctx context.Context, filename string) (workflowID int64, err error)
	Dispatch(ctx context.Context, workflowFile, ref string, inputs map[string]string) (*Run, error)
	GetRun(ctx context.Context, runID int64) (*Run, error)
	GetRunDiagnostics(ctx context.Context, runID int64) (*WorkflowRunDiagnostics, error)
	ListRuns(ctx context.Context, filters RunFilters) ([]*Run, error)
	CancelRun(ctx context.Context, runID int64) error
}