analyze

type AnalysisContext struct {
	Details       []model.RunDetail               // filtered (success-only by default)
	AllDetails    []model.RunDetail               // unfiltered — includes failures, for reliability analysis
	RerunStats    map[int64]preprocess.RerunStats // per-workflow retry stats (computed before dedup)
	WorkflowNames map[int64]string                // WorkflowID → canonical name from ListWorkflows
}

type AnalysisResult struct {
	Findings    []Finding         `json:"findings"`
	Diagnostics []diag.Diagnostic `json:"diagnostics"`
	Meta        ResultMeta        `json:"meta"`
}

type Analyzer interface {
	Name() string
	Analyze(ctx context.Context, ac *AnalysisContext) ([]Finding, error)
}

type ChangePointAnalyzer struct {
	// ThresholdMultiplier controls CUSUM sensitivity (default: 4.0)
	ThresholdMultiplier float64
	// MinSegment is the minimum runs between change points (default: 5)
	MinSegment int
}

type ChangePointDetail struct {
	WorkflowName   string    `json:"workflow_name"`
	JobName        string    `json:"job_name"`
	ChangeIdx      int       `json:"change_idx"`
	BeforeMean     Duration  `json:"before_mean"`
	AfterMean      Duration  `json:"after_mean"`
	PctChange      float64   `json:"pct_change"`
	Direction      string    `json:"direction"`
	PValue         float64   `json:"p_value"`
	CommitSHA      string    `json:"commit_sha"`
	Date           time.Time `json:"date"`
	PostChangeRuns int       `json:"post_change_runs"`
	PostChangeCV   float64   `json:"post_change_cv"`
	Persistence    string    `json:"persistence"`
	OverlapRatio   float64   `json:"overlap_ratio"` // fraction of after-points within before-segment's IQR (0-1)
	Category       string    `json:"category,omitempty"`
}

type CostAnalyzer struct{}

type CostDetail struct {
	Workflow             string             `json:"workflow"`
	TotalRuns            int                `json:"total_runs"`
	BillableMinutes      float64            `json:"billable_minutes"`
	SelfHostedMinutes    float64            `json:"self_hosted_minutes"` // minutes on self-hosted runners (free)
	DailyRate            float64            `json:"daily_rate"`          // billable minutes per day
	PriorityScore        float64            `json:"priority_score"`      // higher = more optimization value
	DailySavingsEstimate float64            `json:"daily_savings_estimate"`
	Jobs                 []JobCostBreakdown `json:"jobs"`
}

type Duration time.Duration //nolint:recvcheck // MarshalJSON uses value receiver, UnmarshalJSON requires pointer

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

type FailingStep struct {
	JobName  string `json:"job_name"`
	StepName string `json:"step_name"`
	Count    int    `json:"count"`
	Category string `json:"category"`
}

type FailureAnalyzer struct{}

type FailureDetail struct {
	Workflow          string         `json:"workflow"`
	TotalRuns         int            `json:"total_runs"`
	FailureCount      int            `json:"failure_count"`
	FailureRate       float64        `json:"failure_rate"`
	FailureKind       string         `json:"failure_kind"`
	Trend             string         `json:"trend"`               // improving, worsening, stable
	RecentFailureRate float64        `json:"recent_failure_rate"` // failure rate in last 7 days
	CancellationCount int            `json:"cancellation_count"`
	CancellationRate  float64        `json:"cancellation_rate"`
	ByConclusion      map[string]int `json:"by_conclusion"`
	ByCategory        map[string]int `json:"by_category,omitempty"`
	FailingSteps      []FailingStep  `json:"failing_steps,omitempty"`
	RetriedRuns       int            `json:"retried_runs"`
	ExtraAttempts     int            `json:"extra_attempts"`
	RerunRate         float64        `json:"rerun_rate"`
}

type Finding struct {
	Type        string        `json:"type"`
	Severity    string        `json:"severity"`
	Title       string        `json:"title"`
	Description string        `json:"description"`
	Detail      FindingDetail `json:"detail"`
}

type FindingDetail interface {
	DetailType() string
}

type JobCostBreakdown struct {
	Name            string  `json:"name"`
	BillableMinutes float64 `json:"billable_minutes"`
	Multiplier      float64 `json:"multiplier"`
	Runs            int     `json:"runs"`
}

type JobSummary struct {
	Name  string       `json:"name"`
	Stats SummaryStats `json:"stats"`
}

type OutlierAnalyzer struct {
	// Method selects the outlier detection method: "log-iqr" (default) or "mad"
	Method string
	// MinPercentile is the minimum percentile to report (default: 95).
	// Outliers below this threshold are detected but not emitted as findings.
	MinPercentile float64
}

type OutlierDetail struct {
	RunID        int64    `json:"run_id"`
	CommitSHA    string   `json:"commit_sha"`
	Duration     Duration `json:"duration"`
	Percentile   float64  `json:"percentile"`
	WorkflowName string   `json:"workflow_name"`
	JobName      string   `json:"job_name,omitempty"`
}

type OutlierGroupDetail struct {
	WorkflowName    string   `json:"workflow_name"`
	JobName         string   `json:"job_name,omitempty"`
	Count           int      `json:"count"`
	WorstDuration   Duration `json:"worst_duration"`
	WorstPercentile float64  `json:"worst_percentile"`
	WorstCommitSHA  string   `json:"worst_commit_sha"`
	MaxSeverity     string   `json:"max_severity"`
}

type PipelineAnalyzer struct{}

type PipelineDetail struct {
	Workflow        string          `json:"workflow"`
	TotalRuns       int             `json:"total_runs"`
	MedianWallClock Duration        `json:"median_wall_clock"`
	MedianJobSum    Duration        `json:"median_job_sum"`
	Parallelism     float64         `json:"parallelism"` // 0-1: fraction of job time that runs in parallel
	Stages          []PipelineStage `json:"stages"`
	CriticalPath    string          `json:"critical_path"` // name of the slowest stage
}

type PipelineStage struct {
	Name          string   `json:"name"`
	Jobs          []string `json:"jobs"`
	Duration      Duration `json:"duration"` // median wall-clock duration of this stage
	PctOfPipeline float64  `json:"pct_of_pipeline"`
	Sequential    bool     `json:"sequential"` // true if this stage waits for the previous to finish
}

type QueueStats struct {
	Median Duration `json:"median"`
	P95    Duration `json:"p95"`
}

type ResultMeta struct {
	Repo        string       `json:"repo"`
	TotalRuns   int          `json:"total_runs"`
	TimeRange   [2]time.Time `json:"time_range"`
	WorkflowIDs []int64      `json:"workflow_ids"`
}

type RunnerAnalyzer struct{}

type RunnerDetail struct {
	WorkflowName string   `json:"workflow_name"`
	JobName      string   `json:"job_name"`
	RunnerLabel  string   `json:"runner_label"`
	Cores        int      `json:"cores"`
	MedianDur    Duration `json:"median_duration"`
	Runs         int      `json:"runs"`
	Multiplier   float64  `json:"multiplier"`
	Issue        string   `json:"issue"` // "oversized" or "undersized"
	Suggestion   string   `json:"suggestion"`
}

type StepAnalyzer struct {
	// TopN is the max number of steps to report per job (default: 3).
	TopN int
}

type StepSummary struct {
	Name       string   `json:"name"`
	Runs       int      `json:"runs"`
	Median     Duration `json:"median"`
	P95        Duration `json:"p95"`
	PctOfJob   float64  `json:"pct_of_job"`
	Volatility float64  `json:"volatility"`
}

type StepTimingDetail struct {
	WorkflowName string        `json:"workflow_name"`
	JobName      string        `json:"job_name"`
	TotalRuns    int           `json:"total_runs"`
	Steps        []StepSummary `json:"steps"`
}

type SummaryAnalyzer struct {
	// GroupMatrix groups matrix job variants (e.g. "test (ubuntu, 20)" and "test (macos, 20)")
	// under a single "test" entry with aggregate stats. Default: true.
	GroupMatrix *bool
}

type SummaryDetail struct {
	Workflow string       `json:"workflow"`
	Stats    SummaryStats `json:"stats"`
	Queue    QueueStats   `json:"queue"`
	Jobs     []JobSummary `json:"jobs"`
}

type SummaryStats struct {
	TotalRuns       int      `json:"total_runs"`
	Mean            Duration `json:"mean"`
	Median          Duration `json:"median"`
	P95             Duration `json:"p95"`
	P99             Duration `json:"p99"`
	Min             Duration `json:"min"`
	Max             Duration `json:"max"`
	TotalTime       Duration `json:"total_time"`
	Volatility      float64  `json:"volatility"`
	VolatilityLabel string   `json:"volatility_label"`
}