forge

type Activity struct {
	Requests    []Touched
	QuietCount  int
	QuietOldest time.Time // the oldest quiet request's creation time
}

type CI struct {
	Red bool
	At  time.Time
}

type Event struct {
	Kind    string
	At      time.Time
	Actor   string
	Message string // a commit's whole message, trailers included
	State   string // a review's: Approved, ChangesRequested or Commented
}

type ForcePush struct {
	At     time.Time
	Before string
	After  string
	// SamePatches is whether every commit kept its patch, nil when git
	// cannot tell; the reader that owns the checkout fills it.
	SamePatches *bool
}

type Host struct {
	Name string // "gh" or "glab"
	Dir  string // the checkout the CLI reads the remote from
	// Repo names the repository when there is no checkout to read it from:
	// `owner/repo`, or `host/owner/repo` off the CLI's default host. Set,
	// every command carries it: a noun command as -R, an api call with its
	// placeholders filled in.
	Repo string
}

type PR struct {
	Number    int
	Title     string
	URL       string
	Status    string // Open, Merged or Closed
	Draft     bool
	Empty     bool // no changes yet: no changed files on GitHub, no commits on GitLab
	Head      string
	HeadSHA   string
	Base      string
	Author    string
	Assignees []string
	Reviewers []string // reviewers requested and not yet heard from
	CreatedAt time.Time
	UpdatedAt time.Time
	MergedAt  time.Time // zero unless merged
	ClosedAt  time.Time // zero unless closed
	MergedBy  string
	Body      string
	Decision  string     // Approved, ChangesRequested, ReviewRequired or ""
	Mergeable string     // Clean, Conflicts, Blocked or ""
	Checks    string     // Green, Red, Pending or "" with none
	Commits   []PRCommit // the commits the host lists for it, where asked for
	MergeSHA  []string   // the merge and squash commits it landed as
	Reviews   []Review   // where asked for

	ForcePushes []ForcePush // the requester's own, where asked for
}

type PRCommit struct {
	SHA     string
	Subject string
	Message string // the whole message, trailers included
	Email   string // the author's email, as the commit records it
	At      time.Time
	Parents int // more than one is a merge
}

type Review struct {
	Author string
	State  string // Approved, ChangesRequested, Commented or ""
	At     time.Time
}

type Touched struct {
	PR

	Events []Event
}