github

type CICheckContext struct {
	CheckName string // Name of the status check
	State     string // State of the check (e.g., FAILURE, ERROR)
}

type Client struct{}

type ClientInterface interface {
	// GetPRStatus fetches comprehensive PR status information.
	GetPRStatus(ctx context.Context, prURL string) (*PRStatus, error)
	// GetPRMetadata fetches metadata for a PR suitable for import.
	GetPRMetadata(ctx context.Context, prURLOrNumber string, repo string) (*PRMetadata, error)
	// PostPRComment posts a comment on a PR issue.
	PostPRComment(ctx context.Context, prURL string, body string) error
	// PostReplyToComment posts a reply to a specific comment on a PR.
	PostReplyToComment(ctx context.Context, prURL string, commentID int, body string) error
	// PostReviewReply posts a reply to a review comment.
	PostReviewReply(ctx context.Context, prURL string, reviewCommentID int, body string) error
	// ResolveReviewThread resolves a review thread containing the specified comment.
	ResolveReviewThread(ctx context.Context, prURL string, commentID int) error
	// GetJobLogs fetches the logs for a specific job.
	GetJobLogs(ctx context.Context, repo string, jobID int64) (string, error)
	// WatchWorkflowRun blocks until a workflow run completes.
	// Returns nil on success, error on failure. If the workflow run itself fails
	// (non-zero exit status), the error will wrap an *exec.ExitError.
	WatchWorkflowRun(ctx context.Context, repo string, runID int64) error
}

type Comment struct {
	ID        int       `json:"id"`
	Body      string    `json:"body"`
	Author    string    `json:"author"`
	CreatedAt time.Time `json:"createdAt"`
	UpdatedAt time.Time `json:"updatedAt"`
}

type FeedbackContext struct {
	CI       *CICheckContext      `json:"ci,omitempty"`
	Workflow *WorkflowContext     `json:"workflow,omitempty"`
	Review   *ReviewContext       `json:"review,omitempty"`
	Comment  *IssueCommentContext `json:"comment,omitempty"`
}

type FeedbackItem struct {
	Type        FeedbackType
	Title       string
	Description string
	Source      SourceInfo // Structured source information
	Priority    int        // 0-4 (0=critical, 4=backlog)

	// Typed context fields (only one will be set based on Source.Type)
	CICheck      *CICheckContext      // Set when Source.Type == SourceTypeCI
	Workflow     *WorkflowContext     // Set when Source.Type == SourceTypeWorkflow
	Review       *ReviewContext       // Set when Source.Type == SourceTypeReviewComment
	IssueComment *IssueCommentContext // Set when Source.Type == SourceTypeIssueComment
}

type FeedbackType string

type GitHubClientMock struct {
	// GetJobLogsFunc mocks the GetJobLogs method.
	GetJobLogsFunc func(ctx context.Context, repo string, jobID int64) (string, error)

	// GetPRMetadataFunc mocks the GetPRMetadata method.
	GetPRMetadataFunc func(ctx context.Context, prURLOrNumber string, repo string) (*PRMetadata, error)

	// GetPRStatusFunc mocks the GetPRStatus method.
	GetPRStatusFunc func(ctx context.Context, prURL string) (*PRStatus, error)

	// PostPRCommentFunc mocks the PostPRComment method.
	PostPRCommentFunc func(ctx context.Context, prURL string, body string) error

	// PostReplyToCommentFunc mocks the PostReplyToComment method.
	PostReplyToCommentFunc func(ctx context.Context, prURL string, commentID int, body string) error

	// PostReviewReplyFunc mocks the PostReviewReply method.
	PostReviewReplyFunc func(ctx context.Context, prURL string, reviewCommentID int, body string) error

	// ResolveReviewThreadFunc mocks the ResolveReviewThread method.
	ResolveReviewThreadFunc func(ctx context.Context, prURL string, commentID int) error

	// WatchWorkflowRunFunc mocks the WatchWorkflowRun method.
	WatchWorkflowRunFunc func(ctx context.Context, repo string, runID int64) error
	// contains filtered or unexported fields
}

type IssueCommentContext struct {
	Author    string // Username of the comment author
	CommentID int64  // ID of the comment
}

type Job struct {
	ID         int64  `json:"id"`
	Name       string `json:"name"`
	Status     string `json:"status"`
	Conclusion string `json:"conclusion"`
	Steps      []Step `json:"steps"`
	URL        string `json:"url"`
}

type PRMetadata struct {
	Number      int       `json:"number"`
	URL         string    `json:"url"`
	Title       string    `json:"title"`
	Body        string    `json:"body"`
	State       string    `json:"state"`       // OPEN, CLOSED, MERGED
	HeadRefName string    `json:"headRefName"` // Branch name
	BaseRefName string    `json:"baseRefName"` // Target branch (e.g., main)
	HeadRefOid  string    `json:"headRefOid"`  // Head commit SHA
	Author      string    `json:"author"`
	Labels      []string  `json:"labels"`
	IsDraft     bool      `json:"isDraft"`
	Merged      bool      `json:"merged"`
	MergedAt    time.Time `json:"mergedAt,omitempty"`
	CreatedAt   time.Time `json:"createdAt"`
	UpdatedAt   time.Time `json:"updatedAt"`
	Repo        string    `json:"repo"` // owner/repo format
}

type PRStatus struct {
	URL            string        `json:"url"`
	State          string        `json:"state"`
	Mergeable      bool          `json:"mergeable"`
	MergeableState string        `json:"mergeableState"`
	StatusChecks   []StatusCheck `json:"statusCheckRollup"`
	Comments       []Comment     `json:"comments"`
	Reviews        []Review      `json:"reviews"`
	Workflows      []WorkflowRun `json:"workflows"`
}

type Review struct {
	ID        int             `json:"id"`
	State     string          `json:"state"` // APPROVED, CHANGES_REQUESTED, COMMENTED
	Body      string          `json:"body"`
	Author    string          `json:"author"`
	CreatedAt time.Time       `json:"createdAt"`
	Comments  []ReviewComment `json:"comments"`
}

type ReviewComment struct {
	ID           int       `json:"id"`
	Path         string    `json:"path"`
	Line         int       `json:"line"`
	OriginalLine int       `json:"originalLine"` // Fallback when Line is null
	Body         string    `json:"body"`
	Author       string    `json:"author"`
	CreatedAt    time.Time `json:"createdAt"`
	InReplyToID  int       `json:"inReplyToId"` // Non-zero if this is a reply to another comment
}

type ReviewContext struct {
	File        string // Path to the file being reviewed
	Line        int    // Line number in the file
	Reviewer    string // Username of the reviewer
	CommentID   int64  // ID of the review comment
	InReplyToID int64  // ID of parent comment if this is a reply (0 if not a reply)
}

type SourceInfo struct {
	Type SourceType // The type of source (CI, workflow, review, comment)
	ID   string     // Unique identifier (comment ID, check run ID, workflow run ID)
	Name string     // Human-readable name (check name, workflow name, reviewer username)
	URL  string     // Link to the specific item
}

type SourceType string

type StatusCheck struct {
	Context     string    `json:"context"`
	State       string    `json:"state"`
	Description string    `json:"description"`
	TargetURL   string    `json:"targetUrl"`
	CreatedAt   time.Time `json:"createdAt"`
}

type Step struct {
	Name       string `json:"name"`
	Status     string `json:"status"`
	Conclusion string `json:"conclusion"`
	Number     int    `json:"number"`
}

type WorkflowContext struct {
	WorkflowName  string // Name of the workflow
	FailureDetail string // Description of what failed
	RunID         int64  // Workflow run ID
	JobName       string // Name of the failed job (if available)
	StepName      string // Name of the failed step (if available)
}

type WorkflowRun struct {
	ID         int64     `json:"id"`
	Name       string    `json:"name"`
	Status     string    `json:"status"`     // completed, in_progress, queued
	Conclusion string    `json:"conclusion"` // success, failure, cancelled, skipped
	URL        string    `json:"url"`
	CreatedAt  time.Time `json:"createdAt"`
	UpdatedAt  time.Time `json:"updatedAt"`
	Jobs       []Job     `json:"jobs"`
}