forge

type Actor struct {
	Login string
	IsBot bool
}

type CheckResult struct {
	Login              string
	Source             string
	RateLimitRemaining int
	RateLimitLimit     int
	RateLimitResetsAt  time.Time
}

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

type CommitReview struct {
	SHA string

	// PRNumber and PRURL are zero/empty when no pull request could be associated with the
	// commit at all.
	PRNumber int
	PRURL    string

	// Status is one of:
	//   approved          — a PR exists and someone other than the author approved it
	//   changes_requested — a PR exists and the last word on it was "no"
	//   review_required   — a PR exists and nobody approved it
	//   unknown           — no PR could be associated with this commit
	//
	// `unknown` and `review_required` are kept apart on purpose. One means "we could not
	// tell", the other means "we could tell, and it was not reviewed". Collapsing them turns
	// an absence of evidence into an accusation.
	Status string
}

type Credentials struct {
	Token  string
	Source string // GITHUB_TOKEN | GH_TOKEN | gh CLI
}

type Issue struct {
	Number      int
	URL         string
	Title       string
	Author      Actor
	State       string
	StateReason string
	Labels      []string

	CreatedAt       time.Time
	ClosedAt        time.Time
	FirstResponseAt time.Time
}

type PullRequest struct {
	Number int
	URL    string
	Title  string
	Author Actor
	State  string // open | closed | merged

	CreatedAt time.Time
	ClosedAt  time.Time
	MergedAt  time.Time // zero when the PR was closed without merging. Never a substitute for ClosedAt.
	MergedBy  Actor

	// ReadyForReviewAt is when the PR left draft, derived from its timeline. Response and
	// merge times anchor here rather than at CreatedAt, so time a PR spent as a draft is not
	// charged against the people who reviewed it once it was ready.
	ReadyForReviewAt time.Time

	// TimeInDraftSeconds is summed across *every* draft interval, not just the first — a PR
	// can be flipped back to draft, and pretending it cannot understates the wait.
	TimeInDraftSeconds int

	Additions    int
	Deletions    int
	ChangedFiles int

	FirstResponseAt time.Time // first comment or review by someone who is not the author, and not a bot
	FirstReviewAt   time.Time // first *submitted review*, which is not the same thing as a comment
	CommentCount    int

	Reviews []Review
}

type Repo struct {
	Owner         string
	Name          string
	DefaultBranch string
}

type Review struct {
	Reviewer    Actor
	State       string // approved | changes_requested | commented | dismissed
	SubmittedAt time.Time
}