forge

type AccountConfig struct {
	// Name is a short identifier (e.g., "github-primary").
	Name string `yaml:"name"`

	// Provider selects the forge backend: "github" or "gitea".
	Provider string `yaml:"provider"`

	// Token is the API authentication token.
	Token string `yaml:"token"`

	// Owner is the default repository owner for unqualified repo references.
	Owner string `yaml:"owner"`

	// Username is the forge username for commit attribution.
	Username string `yaml:"username"`

	// URL is the API base URL. Required for gitea. Optional for GitHub
	// (defaults to https://api.github.com).
	URL string `yaml:"url"`
}

type ChangedFile struct {
	// Filename is the path of the changed file.
	Filename string
	// Status describes the change type: "added", "modified", "removed",
	// or "renamed".
	Status string
	// Additions is the number of lines added in this file.
	Additions int
	// Deletions is the number of lines removed in this file.
	Deletions int
	// Patch is the unified diff patch for this file, if available.
	Patch string
}

type CheckRun struct {
	// Name is the check run name (e.g., "CI / lint").
	Name string
	// Status is the check lifecycle: "queued", "in_progress", or
	// "completed".
	Status string
	// Conclusion is the outcome when completed: "success", "failure",
	// "neutral", "cancelled", "skipped", "timed_out", or
	// "action_required".
	Conclusion string
	// StartedAt is when the check run started, if available.
	StartedAt *time.Time
	// CompletedAt is when the check run finished, if available.
	CompletedAt *time.Time
	// DetailsURL links to the full check run output.
	DetailsURL string
}

type Comment struct {
	// ID is the forge-assigned comment identifier.
	ID int64
	// Body is the comment text in markdown.
	Body string
	// Author is the username who posted the comment.
	Author string
	// URL is the web URL for the comment.
	URL string
	// CreatedAt is when the comment was posted.
	CreatedAt time.Time
}

type Commit struct {
	// SHA is the abbreviated commit hash (typically 7 characters).
	SHA string
	// Message is the full commit message.
	Message string
	// Author is the commit author name.
	Author string
	// Date is when the commit was authored.
	Date time.Time
}

type Config struct {
	Accounts []AccountConfig `yaml:"accounts"`
}

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

type ForgeProvider interface {
	// Name returns the provider identifier (e.g., "github", "gitea").
	Name() string

	// CreateIssue creates a new issue and returns it with the
	// server-assigned number and URL.
	CreateIssue(ctx context.Context, repo string, issue *Issue) (*Issue, error)

	// UpdateIssue applies a partial update to an existing issue.
	// Only non-nil fields in the update are changed.
	UpdateIssue(ctx context.Context, repo string, number int, update *IssueUpdate) (*Issue, error)

	// GetIssue retrieves a single issue by number.
	GetIssue(ctx context.Context, repo string, number int) (*Issue, error)

	// ListIssues returns issues matching the given filters.
	ListIssues(ctx context.Context, repo string, opts *ListOptions) ([]*Issue, error)

	// AddComment posts a comment on an issue or pull request.
	AddComment(ctx context.Context, repo string, number int, body string) (*Comment, error)

	// ListPRs returns pull requests matching the given filters.
	ListPRs(ctx context.Context, repo string, opts *ListOptions) ([]*PullRequest, error)

	// GetPR retrieves a single pull request by number.
	GetPR(ctx context.Context, repo string, number int) (*PullRequest, error)

	// GetPRFiles returns the files changed in a pull request.
	GetPRFiles(ctx context.Context, repo string, number int) ([]*ChangedFile, error)

	// GetPRDiff returns the unified diff for a pull request.
	GetPRDiff(ctx context.Context, repo string, number int) (string, error)

	// ListPRCommits returns commits in a pull request.
	ListPRCommits(ctx context.Context, repo string, number int) ([]*Commit, error)

	// ListPRReviews returns reviews for a pull request, including
	// inline comments nested under each review.
	ListPRReviews(ctx context.Context, repo string, number int) ([]*Review, error)

	// SubmitReview creates a new review on a pull request.
	SubmitReview(ctx context.Context, repo string, number int, review *ReviewSubmission) (*Review, error)

	// AddReviewComment posts an inline comment on a pull request diff.
	AddReviewComment(ctx context.Context, repo string, number int, comment *ReviewComment) (*ReviewComment, error)

	// ListChecks returns CI check runs for a pull request.
	ListChecks(ctx context.Context, repo string, number int) ([]*CheckRun, error)

	// MergePR merges a pull request using the specified method.
	MergePR(ctx context.Context, repo string, number int, opts *MergeOptions) (*MergeResult, error)

	// AddReaction adds an emoji reaction to an issue/PR or a specific
	// comment. When commentID is 0, the reaction targets the
	// issue/PR itself.
	AddReaction(ctx context.Context, repo string, number int, commentID int64, emoji string) error

	// RequestReview requests reviews from the specified users.
	RequestReview(ctx context.Context, repo string, number int, reviewers []string) error

	// Search performs a forge-native search of the given kind.
	Search(ctx context.Context, query string, kind SearchKind, limit int) ([]SearchResult, error)
}

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

type Issue struct {
	// Number is the issue number (e.g., #42).
	Number int
	// Title is the issue title.
	Title string
	// Body is the full issue body in markdown.
	Body string
	// State is the issue lifecycle state: "open" or "closed".
	State string
	// Labels lists the label names applied to this issue.
	Labels []string
	// Assignees lists the usernames assigned to this issue.
	Assignees []string
	// Author is the username who created the issue.
	Author string
	// URL is the web URL for the issue.
	URL string
	// CreatedAt is when the issue was created.
	CreatedAt time.Time
	// UpdatedAt is when the issue was last modified.
	UpdatedAt time.Time
	// CommentCount is the number of comments on the issue.
	CommentCount int
}

type IssueUpdate struct {
	// Title replaces the issue title when non-nil.
	Title *string
	// Body REPLACES the entire issue body when non-nil — it does not
	// append. Leave nil to keep the existing body unchanged.
	Body *string
	// State changes the issue state when non-nil: "open" or "closed".
	State *string
	// Labels REPLACES all labels when non-nil. Pass an empty slice to
	// remove all labels.
	Labels *[]string
	// Assignees REPLACES all assignees when non-nil.
	Assignees *[]string
}

type ListOptions struct {
	// State filters by lifecycle state: "open", "closed", or "all".
	State string
	// Labels is a comma-separated label filter for issues.
	Labels string
	// Assignee filters issues by assignee username.
	Assignee string
	// Base filters PRs by target branch.
	Base string
	// Head filters PRs by source branch.
	Head string
	// Sort controls result ordering: "created", "updated", or
	// "comments".
	Sort string
	// Direction controls sort direction: "asc" or "desc".
	Direction string
	// Limit caps the number of results per page (default 30, max 100).
	Limit int
	// Page selects the result page (1-indexed, default 1).
	Page int
}

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

type MergeOptions struct {
	// Method is the merge strategy: "squash" (default), "merge", or
	// "rebase".
	Method string
	// CommitTitle overrides the merge commit title.
	CommitTitle string
	// CommitMessage overrides the merge commit body. Supports
	// temp:LABEL references.
	CommitMessage string
}

type MergeResult struct {
	// SHA is the merge commit hash.
	SHA string
	// Message is the merge result message from the forge.
	Message string
}

type Operation struct {
	Tool      string    `json:"tool"`
	Account   string    `json:"account"`
	Repo      string    `json:"repo"`
	Ref       string    `json:"ref,omitempty"` // issue/PR number, search query, etc.
	Timestamp time.Time `json:"-"`             // formatted as delta at output time
}

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

type PullRequest struct {
	// Number is the PR number (e.g., #99).
	Number int
	// Title is the PR title.
	Title string
	// Body is the full PR description in markdown.
	Body string
	// State is the PR lifecycle state: "open", "closed", or "merged".
	State string
	// Draft indicates the PR is not ready for review.
	Draft bool
	// Author is the username who opened the PR.
	Author string
	// Head is the source branch name.
	Head string
	// Base is the target branch name.
	Base string
	// Mergeable indicates whether the PR can be merged cleanly. Nil
	// means the mergeability check has not completed yet.
	Mergeable *bool
	// Labels lists the label names applied to this PR.
	Labels []string
	// Assignees lists the usernames assigned to this PR.
	Assignees []string
	// RequestedReviewers lists usernames whose review is requested.
	RequestedReviewers []string
	// ReviewState is the aggregate review status (e.g., "approved").
	ReviewState string
	// CommentCount is the number of comments on the PR.
	CommentCount int
	// Additions is the total lines added across all files.
	Additions int
	// Deletions is the total lines removed across all files.
	Deletions int
	// ChangedFiles is the number of files modified.
	ChangedFiles int
	// URL is the web URL for the PR.
	URL string
	// CreatedAt is when the PR was opened.
	CreatedAt time.Time
	// UpdatedAt is when the PR was last modified.
	UpdatedAt time.Time
}

type Review struct {
	// ID is the forge-assigned review identifier.
	ID int64
	// Author is the username who submitted the review.
	Author string
	// State is the review verdict: "APPROVED", "CHANGES_REQUESTED",
	// "COMMENTED", or "DISMISSED".
	State string
	// Body is the review summary text.
	Body string
	// SubmittedAt is when the review was submitted.
	SubmittedAt time.Time
	// InlineComments are line-level comments attached to this review.
	InlineComments []*ReviewComment
}

type ReviewComment struct {
	// ID is the forge-assigned comment identifier (zero for new comments).
	ID int64
	// Body is the comment text.
	Body string
	// Path is the file path in the diff.
	Path string
	// Line is the line number in the diff.
	Line int
	// Side selects the diff side: "LEFT" or "RIGHT" (default "RIGHT").
	Side string
}

type ReviewSubmission struct {
	// Event is the review action: "APPROVE", "COMMENT", or
	// "REQUEST_CHANGES".
	Event string
	// Body is the review summary text.
	Body string
}

type SearchKind string

type SearchResult struct {
	// Number is the issue or PR number (zero for non-issue results).
	Number int
	// Title is the result title or abbreviated SHA for commits.
	Title string
	// URL is the web URL for the result.
	URL string
	// Body is a snippet for code results or description for issues.
	Body string
}

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