regression

type Baseline interface {
	// Get retrieves the baseline for a component.
	// Returns ErrBaselineNotFound if no baseline exists.
	Get(ctx context.Context, component string) (*BaselineData, error)

	// Set stores a new baseline for a component.
	Set(ctx context.Context, component string, data *BaselineData) error

	// List returns all available baseline names.
	List(ctx context.Context) ([]string, error)

	// Delete removes a baseline.
	Delete(ctx context.Context, component string) error
}

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

type BaselineData struct {
	// Component is the name of the component.
	Component string `json:"component"`

	// Version identifies this baseline version.
	Version string `json:"version"`

	// CreatedAt is when the baseline was created.
	CreatedAt time.Time `json:"created_at"`

	// UpdatedAt is when the baseline was last updated.
	UpdatedAt time.Time `json:"updated_at"`

	// Latency holds latency metrics.
	Latency LatencyBaseline `json:"latency"`

	// Throughput holds throughput metrics.
	Throughput ThroughputBaseline `json:"throughput"`

	// Memory holds memory metrics.
	Memory MemoryBaseline `json:"memory"`

	// Error holds error rate metrics.
	Error ErrorBaseline `json:"error"`

	// SampleCount is the number of samples in this baseline.
	SampleCount int `json:"sample_count"`

	// Metadata holds arbitrary additional data.
	Metadata map[string]string `json:"metadata,omitempty"`
}

type CurrentMetrics struct {
	// Latency holds current latency metrics.
	Latency LatencyBaseline

	// Throughput holds current throughput metrics.
	Throughput ThroughputBaseline

	// Memory holds current memory metrics.
	Memory MemoryBaseline

	// ErrorRate is the current error rate.
	ErrorRate float64

	// SampleCount is the number of samples.
	SampleCount int
}

type DetectionResult struct {
	// Component is the component analyzed.
	Component string

	// Baseline is the baseline data used.
	Baseline *BaselineData

	// Regressions contains all detected regressions.
	Regressions []Regression

	// Warnings contains non-blocking issues.
	Warnings []Regression

	// Pass is true if no blocking regressions were found.
	Pass bool

	// MaxSeverity is the highest severity found.
	MaxSeverity Severity

	// AnalyzedAt is when detection was performed.
	AnalyzedAt time.Time
}

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

type DetectorConfig struct {
	// LatencyP50Threshold is the allowed P50 increase ratio (e.g., 0.05 = 5%).
	LatencyP50Threshold float64

	// LatencyP95Threshold is the allowed P95 increase ratio.
	LatencyP95Threshold float64

	// LatencyP99Threshold is the allowed P99 increase ratio.
	LatencyP99Threshold float64

	// ThroughputThreshold is the allowed throughput decrease ratio.
	ThroughputThreshold float64

	// MemoryThreshold is the allowed memory increase ratio.
	MemoryThreshold float64

	// ErrorRateThreshold is the allowed error rate increase (absolute).
	ErrorRateThreshold float64

	// WarnThresholdRatio is the ratio of threshold at which to warn.
	// E.g., 0.8 means warn at 80% of threshold.
	WarnThresholdRatio float64

	// MinSamples is the minimum samples required for valid comparison.
	MinSamples int
}

type ErrorBaseline struct {
	// Rate is the error rate (0 to 1).
	Rate float64 `json:"rate"`

	// Count is the typical error count.
	Count int64 `json:"count,omitempty"`
}

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

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

type GateConfig struct {
	// Detector configuration.
	DetectorConfig *DetectorConfig

	// UpdateBaselineOnPass updates baseline when check passes.
	// Default: false
	UpdateBaselineOnPass bool

	// RequireBaseline fails if no baseline exists.
	// Default: false (missing baseline = pass)
	RequireBaseline bool

	// AllowedRegressions is the maximum regressions before failing.
	// Default: 0 (any regression fails)
	AllowedRegressions int

	// FailOnWarnings fails the gate on warnings.
	// Default: false
	FailOnWarnings bool

	// Logger for output.
	Logger *slog.Logger
}

type GateDecision struct {
	// Pass is true if the gate allows deployment.
	Pass bool

	// Component is the checked component.
	Component string

	// Regressions contains detected regressions.
	Regressions []Regression

	// Warnings contains non-blocking warnings.
	Warnings []Regression

	// BaselineUpdated is true if baseline was updated.
	BaselineUpdated bool

	// Report is a human-readable summary.
	Report string

	// Duration is the check duration.
	Duration time.Duration

	// Timestamp is when the check was performed.
	Timestamp time.Time
}

type GateOption func(*GateConfig)

type LatencyBaseline struct {
	// P50 is the 50th percentile latency.
	P50 time.Duration `json:"p50"`

	// P95 is the 95th percentile latency.
	P95 time.Duration `json:"p95"`

	// P99 is the 99th percentile latency.
	P99 time.Duration `json:"p99"`

	// Mean is the average latency.
	Mean time.Duration `json:"mean"`

	// StdDev is the standard deviation.
	StdDev time.Duration `json:"std_dev"`
}

type MemoryBaseline struct {
	// AllocBytesPerOp is bytes allocated per operation.
	AllocBytesPerOp uint64 `json:"alloc_bytes_per_op"`

	// AllocsPerOp is number of allocations per operation.
	AllocsPerOp uint64 `json:"allocs_per_op"`

	// HeapInUse is the typical heap usage.
	HeapInUse uint64 `json:"heap_in_use,omitempty"`
}

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

type Regression struct {
	// Type identifies the regression type.
	Type RegressionType

	// Severity is the regression severity.
	Severity Severity

	// Component is the affected component.
	Component string

	// BaselineValue is the baseline metric value.
	BaselineValue float64

	// CurrentValue is the current metric value.
	CurrentValue float64

	// Change is the relative change (positive = regression).
	Change float64

	// Threshold is the threshold that was exceeded.
	Threshold float64

	// Message is a human-readable description.
	Message string
}

type RegressionType int

type Severity int

type StatisticalDetector struct {
	*Detector
	// contains filtered or unexported fields
}

type ThroughputBaseline struct {
	// OpsPerSecond is operations per second.
	OpsPerSecond float64 `json:"ops_per_second"`

	// BytesPerSecond is throughput in bytes.
	BytesPerSecond float64 `json:"bytes_per_second,omitempty"`
}