prsnapshot

type Snapshot struct {
	Repository string
	Number     string
	// State is GitHub's raw pull-request state, exactly as the API reports
	// it: "open" or "closed". It is never rewritten to "merged" here — Merged
	// carries that fact instead, so a caller decides for itself how to
	// present the two together (cmd/wb/wait.go's waitTarget.State keeps its
	// own pre-existing "merged" overlay for backward compatibility; a new
	// caller such as internal/prwatch reads Merged directly).
	State     string
	Merged    bool
	Draft     bool
	Head      string
	Base      string
	Mergeable string
	URL       string
	// Checks and Failed are populated only while the pull request is open —
	// a closed pull request's head checks are no longer read at all.
	Checks   map[string]int
	Failed   []string
	Failures []orchestrate.CIFailureDetail
	// Blocked names a required check with no passing observation on this
	// head (orchestrate.HeadObservation.Blocked) — the renamed-workflow
	// trap. It is fetched only when nothing is pending or failed and Green
	// is still false, matching the same reserved-reads discipline the rest
	// of this observation follows.
	Blocked []string
	// Green is orchestrate.ObservePullRequestHead's own verdict: every
	// observed check passed or was skipped, AND the target's required-check
	// policy is fully satisfied. It is the one fact that decides pass vs.
	// fail; nothing in this package re-derives it from the check counts.
	Green bool
	Err   error
}