prwatch

type Kind string

type Outcome struct {
	Task        string
	ClaimID     string
	Repository  string
	PullRequest int
	URL         string
	// Head is the pull request's exact head SHA observed at this tick — part
	// of Task 7's at-most-once delivery-intent key, alongside Task,
	// PullRequest, and Kind. Empty when Kind is KindUnavailable.
	Head string
	// Target is the pull request's exact base branch observed at this tick.
	Target string
	Kind   Kind
	// Terminal is true exactly when this Outcome is ready to act on. See the
	// Kind constants for which values can ever be Terminal.
	Terminal bool
	Reason   string
	// Checks, Failed, Failures, and Blocked are copied from the snapshot
	// unchanged, so Task 8's facts-only template can name a required check
	// (or a count) without re-deriving it from GitHub.
	Checks      map[string]int
	Failed      []string
	Failures    []orchestrate.CIFailureDetail
	Blocked     []string
	EvaluatedAt time.Time
	// Snapshot is the observation this Outcome was classified from, whole, so
	// a caller that shows pull-request state (the cockpit fleet) reads
	// prsnapshot's own facts (State, Merged, Draft, Mergeable, Green) rather
	// than re-deriving any of them. It is the zero value, with Err set, for
	// KindUnavailable.
	Snapshot prsnapshot.Snapshot
}

type PollResult struct {
	Binding worktrees.RegisteredPullRequestBinding
	Outcome Outcome
	Err     error
}

type Watcher struct {

	// Now stamps Outcome.EvaluatedAt. Tests inject a fixed function so they
	// never depend on a real clock; Evaluate itself takes exactly one
	// observation and makes no timing decision of its own — there is no
	// timer to inject because there is nothing here that waits.
	Now func() time.Time
	// Observe takes one observation; nil means prsnapshot.Observe. A test
	// injects a fake so no unit test reaches GitHub.
	Observe func(ctx context.Context, repository, selector string) prsnapshot.Snapshot
	// Reader, when set, answers every GitHub read of an evaluation instead of
	// the real observer: a test counts and answers them without a process or the
	// network.
	Reader *githubobserver.Reader
	// contains filtered or unexported fields
}