forge

type AttachmentUploader interface {
	UploadAttachment(ctx context.Context, ref PullRequestRef, path string) (string, error)
}

type Comment struct {
	ID        int64
	Author    string
	Body      string
	CreatedAt time.Time
	URL       string
}

type Forge interface {
	PullRequest(ctx context.Context, ref PullRequestRef) (*PullRequest, error)
	Diff(ctx context.Context, ref PullRequestRef) ([]byte, error)
	Threads(ctx context.Context, ref PullRequestRef) ([]Thread, error)
	CreateReview(ctx context.Context, ref PullRequestRef, event ReviewEvent, summary string, comments []ReviewComment) (*SubmittedReview, error)
	// AddGeneralComment posts a conversation-level comment — one that
	// anchors to the request itself, not to a line (a GitHub issue comment,
	// a GitLab MR note).
	AddGeneralComment(ctx context.Context, ref PullRequestRef, body string) (*Comment, error)
	Reply(ctx context.Context, ref PullRequestRef, commentID int64, body string) (*Comment, error)
	// FileContent returns the raw content of path at rev (a commit id,
	// typically the PR head) — the full-file context view's data source.
	FileContent(ctx context.Context, ref PullRequestRef, path, rev string) ([]byte, error)
	// GeneralComments lists the PR's conversation-level comments (GitHub
	// issue comments, GitLab non-system notes), oldest first — review
	// discussion that anchors to the request itself rather than a line.
	GeneralComments(ctx context.Context, ref PullRequestRef) ([]Comment, error)
	// Attachment fetches an image/file referenced from a comment body (an
	// absolute attachment URL, or a host-relative /uploads path), using the
	// adapter's authentication where the host requires it.
	Attachment(ctx context.Context, ref PullRequestRef, url string) ([]byte, error)
}

type Kind uint8

type ListedRequest struct {
	Ref       PullRequestRef
	Title     string
	Author    string
	UpdatedAt time.Time
	URL       string
}

type Lister interface {
	List(ctx context.Context, filter string) ([]ListedRequest, error)
}

type PullRequest struct {
	Ref     PullRequestRef
	Title   string
	Body    string // description, as Markdown
	Author  string
	URL     string // browsable page; empty when the adapter did not report one
	HeadOID string
	// BaseOID is the base commit the diff is against, when the host reports
	// it — the revision old-side file content lives at.
	BaseOID string
	BaseRef string
	HeadRef string
}

type PullRequestRef struct {
	Host   string // e.g. "github.com"
	Owner  string
	Repo   string
	Number int
}

type ReviewComment struct {
	Path      string
	Body      string
	Line      int
	Side      string // "LEFT" or "RIGHT"
	StartLine int    // 0 when single-line
	StartSide string
}

type ReviewEvent string

type SubmittedReview struct {
	ID  int64
	URL string
}

type Thread struct {
	Root     Comment
	Replies  []Comment
	Resolved bool
	Outdated bool
	Location *diff.Location
}