health

type AgeBucket struct {
	Label string `json:"label"`
	Count int    `json:"count"`
}

type CongestionMetrics struct {
	Window     Window      `json:"window"`
	SampleSize int         `json:"sample_size"`
	OpenPRs    int         `json:"open_prs"`
	MedianAge  float64     `json:"median_age_hours"`
	P90Age     float64     `json:"p90_age_hours"`
	MaxAge     float64     `json:"max_age_hours"`
	AgeBuckets []AgeBucket `json:"age_buckets"`
	Coverage   string      `json:"coverage"`
}

type CoverageSummary struct {
	ThreadsLimit         int  `json:"threads_limit"`
	ThreadsTruncated     bool `json:"threads_truncated"`
	ThreadsSampleSize    int  `json:"threads_sample_size"`
	RepositoryProjection bool `json:"repository_projection"`
}

type ExternalContributorMetrics struct {
	Window         Window  `json:"window"`
	SampleSize     int     `json:"sample_size"`       // PRs considered within the window
	Known          int     `json:"known_association"` // PRs with a non-empty author association
	External       int     `json:"external"`          // PRs classified as external contributors
	Open           int     `json:"open"`
	Merged         int     `json:"merged"`
	ClosedUnmerged int     `json:"closed_unmerged"`
	MergeRate      float64 `json:"merge_rate"`
	Coverage       string  `json:"coverage"`
}

type IssueMetrics struct {
	Window     Window `json:"window"`
	SampleSize int    `json:"sample_size"`
	Open       int    `json:"open"`
	Closed     int    `json:"closed"`
	Coverage   string `json:"coverage"`
}

type Options struct {
	// Now is the reference time for staleness and age calculations.
	// Zero defaults to time.Now().UTC().
	Now time.Time
	// Start and End bound the activity window. Zero Start means all observed
	// history; zero End means Now.
	Start, End time.Time
	// StaleThreshold marks an open PR stale after this duration without activity.
	// Zero defaults to 14 days.
	StaleThreshold time.Duration
}

type PullRequestMetrics struct {
	Window         Window `json:"window"`
	SampleSize     int    `json:"sample_size"`
	Open           int    `json:"open"`
	Merged         int    `json:"merged"`
	ClosedUnmerged int    `json:"closed_unmerged"`
	Coverage       string `json:"coverage"`
}

type RepoRef = domain.RepoRef

type Report struct {
	Repo         domain.RepoRef             `json:"repo"`
	GeneratedAt  time.Time                  `json:"generated_at"`
	Window       Window                     `json:"window"`
	Repository   RepositoryMetrics          `json:"repository"`
	Issues       IssueMetrics               `json:"issues"`
	PullRequests PullRequestMetrics         `json:"pull_requests"`
	External     ExternalContributorMetrics `json:"external_contributors"`
	Congestion   CongestionMetrics          `json:"congestion"`
	Stale        StaleMetrics               `json:"stale"`
	Response     ResponseTimeDistributions  `json:"response_times"`
	Coverage     CoverageSummary            `json:"coverage"`
}

type RepositoryMetrics struct {
	Present       bool   `json:"present"`
	Stars         int    `json:"stars"`
	Watchers      int    `json:"watchers"`
	Forks         int    `json:"forks"`
	OpenIssues    int    `json:"open_issues"`
	Archived      bool   `json:"archived"`
	Fork          bool   `json:"fork"`
	DefaultBranch string `json:"default_branch,omitempty"`
	License       string `json:"license,omitempty"`
	Coverage      string `json:"coverage"`
}

type ResponseTimeDistributions struct {
	Issues       ResponseTimeMetric `json:"issues"`
	PullRequests ResponseTimeMetric `json:"pull_requests"`
}

type ResponseTimeMetric struct {
	Window     Window  `json:"window"`
	SampleSize int     `json:"sample_size"`
	Source     string  `json:"source"`
	Median     float64 `json:"median_hours"`
	P90        float64 `json:"p90_hours"`
	Mean       float64 `json:"mean_hours"`
	Min        float64 `json:"min_hours"`
	Max        float64 `json:"max_hours"`
	Coverage   string  `json:"coverage"`
}

type StaleMetrics struct {
	Window                 Window  `json:"window"`
	SampleSize             int     `json:"sample_size"`
	StaleCount             int     `json:"stale"`
	ActiveCount            int     `json:"active"`
	NoReviewOrCommentCount int     `json:"without_review_or_comment"`
	MissingCoverageCount   int     `json:"missing_coverage"`
	Threshold              float64 `json:"threshold_hours"`
	Coverage               string  `json:"coverage"`
}

type Window struct {
	Start time.Time `json:"start,omitempty"`
	End   time.Time `json:"end,omitempty"`
	Label string    `json:"label"`
}