v1alpha1

type Alerting struct {
	// budgetErrorAlerts configures error budget threshold alerts.
	// +optional
	BudgetErrorAlerts *BudgetErrors `json:"budgetErrorAlerts,omitempty"`

	// burnRateAlerts configures burn rate alerting rules.
	// +optional
	BurnRateAlerts *BurnRates `json:"burnRateAlerts,omitempty"`
}

type BudgetAlert struct {
	// name is the unique identifier for this budget alert.
	// +kubebuilder:validation:MinLength=1
	// +required
	Name string `json:"name"`

	// percent is the error budget remaining threshold below which the alert fires (e.g., 10.0 means < 10%).
	// +kubebuilder:validation:Minimum=0
	// +kubebuilder:validation:Maximum=100
	// +required
	Percent float64 `json:"percent"`

	// severity is the alert severity level (e.g., "critical", "warning").
	// +kubebuilder:validation:Enum=critical;warning;info
	// +required
	Severity string `json:"severity"`
}

type BudgetErrors struct {
	// enabled controls whether budget error alerts are generated.
	// +required
	Enabled bool `json:"enabled"`

	// alerts is a list of budget alerting rules.
	// Each alert specifies a threshold percentage and severity level.
	// +optional
	Alerts []BudgetAlert `json:"alerts,omitempty"`
}

type BurnRateAlert struct {
	// +kubebuilder:validation:MinLength=1
	// +required
	Name string `json:"name"`

	// consumePercent is the percentage of error budget that would be consumed
	// within the consumeWindow at the current burn rate to trigger the alert (e.g., 2.0 means 2%).
	// +kubebuilder:validation:Minimum=0
	// +required
	ConsumePercent float64 `json:"consumePercent"`

	// consumeWindow is the time window used to compute the burn rate threshold (e.g., "1h", "6h").
	// +kubebuilder:validation:Pattern=`^(\d+d|\d+h|\d+m|\d+s)$`
	// +required
	ConsumeWindow string `json:"consumeWindow"`

	// longWindow is the long observation window for the burn rate query (e.g., "1h").
	// +kubebuilder:validation:Pattern=`^(\d+d|\d+h|\d+m|\d+s)$`
	// +required
	LongWindow string `json:"longWindow"`

	// shortWindow is the short observation window for the burn rate query (e.g., "5m").
	// +kubebuilder:validation:Pattern=`^(\d+d|\d+h|\d+m|\d+s)$`
	// +required
	ShortWindow string `json:"shortWindow"`

	// severity is the alert severity level (e.g., "critical", "warning").
	// +kubebuilder:validation:Enum=critical;warning;info
	// +required
	Severity string `json:"severity"`
}

type BurnRateStatus struct {
	// shortWindow is the duration of the short observation window (e.g., "5m").
	ShortWindow string `json:"shortWindow"`

	// shortBurnRate is the burn rate computed over the short observation window.
	ShortBurnRate float64 `json:"shortBurnRate"`

	// longWindow is the duration of the long observation window (e.g., "1h").
	LongWindow string `json:"longWindow"`

	// longBurnRate is the burn rate computed over the long observation window.
	LongBurnRate float64 `json:"longBurnRate"`
}

type BurnRates struct {
	// enabled controls whether burn rate alerts are generated.
	// +required
	Enabled bool `json:"enabled"`

	// alerts is a list of custom burn rate alerting rules.
	// +optional
	Alerts []BurnRateAlert `json:"alerts,omitempty"`
}

type Composition struct {
	// +required
	// +kubebuilder:validation:Enum=AND_MIN;WEIGHTED_ROUTES
	Type string `json:"type"`
	// +optional
	Params *CompositionParams `json:"params,omitempty"`
}

type CompositionParams struct {
	Routes []Route `json:"routes,omitempty"`
}

type CorrelatedEvent struct {
	// kind is the Kubernetes resource kind (e.g., "Deployment", "ConfigMap")
	// +required
	Kind string `json:"kind"`

	// name is the name of the resource that changed
	// +required
	Name string `json:"name"`

	// namespace is the namespace of the resource
	// +required
	Namespace string `json:"namespace"`

	// timestamp is when the change occurred
	// +required
	Timestamp metav1.Time `json:"timestamp"`

	// changeType indicates what kind of change occurred (create, update, delete)
	// +kubebuilder:validation:Enum=create;update;delete
	// +required
	ChangeType string `json:"changeType"`

	// change describes what changed (e.g., "image: v1.4.2 → v1.4.3")
	// +optional
	Change string `json:"change,omitempty"`

	// actor is who or what triggered the change (e.g., "user@example.com", "argocd")
	// +optional
	Actor string `json:"actor,omitempty"`

	// confidence indicates how likely this event caused the SLO degradation
	// +kubebuilder:validation:Enum=high;medium;low
	// +required
	Confidence string `json:"confidence"`
}

type ErrorBudgetStatus struct {
	// Total error budget for the window (e.g., "43.2m" for 43.2 minutes)
	Total string `json:"total"`

	// Consumed error budget so far (e.g., "10.5m")
	Consumed string `json:"consumed"`

	// Remaining error budget (e.g., "32.7m")
	Remaining string `json:"remaining"`

	// PercentRemaining is the percentage of budget left (e.g., 75.69)
	PercentRemaining float64 `json:"percentRemaining"`
}

type Objective struct {
	// name is the unique name of the objective within the Service Level Objective.
	// +kubebuilder:validation:MinLength=1
	// +kubebuilder:validation:MaxLength=100
	// +required
	Name string `json:"name"`

	// target is the target percentage for the objective (e.g., 99.9).
	// +kubebuilder:validation:Minimum=0
	// +kubebuilder:validation:Maximum=200
	// +required
	Target float64 `json:"target"`

	// window is the time window over which the objective is measured (e.g., "30d" for 30 days).
	// Only days are supported (e.g., "7d", "30d").
	// +kubebuilder:validation:Pattern=`^\d+d$`
	// +required
	Window string `json:"window"`

	// sli defines the Service Level Indicator used to measure this objective.
	// +required
	Sli SLI `json:"sli"`

	// alerting configures alerting rules (budget and burn rate) for this objective.
	// +optional
	Alerting *Alerting `json:"alerting,omitempty"`
}

type ObjectiveStatus struct {
	// name of the objective (matches Objective.Name).
	Name string `json:"name"`

	// target percentage (copied from spec for convenience).
	Target float64 `json:"target"`

	// actual is the current SLI percentage (e.g., 99.87).
	Actual float64 `json:"actual"`

	// status indicates whether the objective is being met.
	// +kubebuilder:validation:Enum=met;warning;degraded;critical;violated;unknown
	Status string `json:"status"`

	// errorBudget contains details about error budget consumption.
	ErrorBudget ErrorBudgetStatus `json:"errorBudget"`

	// burnRate contains the observed burn rate metrics.
	// +optional
	BurnRate []BurnRateStatus `json:"burnRate,omitempty"`

	// lastQueried is the timestamp of the last Prometheus query for this objective.
	// +optional
	LastQueried metav1.Time `json:"lastQueried,omitempty"`
}

type Query struct {
	// totalQuery is the Prometheus metric selector for total events.
	// Example: http_requests_total{service="api"}
	// +kubebuilder:validation:MinLength=1
	// +required
	TotalQuery string `json:"totalQuery"`

	// errorQuery is the Prometheus metric selector for error events.
	// Example: http_requests_total{service="api",status=~"5.."}
	// +kubebuilder:validation:MinLength=1
	// +required
	ErrorQuery string `json:"errorQuery"`
}

type Route struct {
	Name   string   `json:"name"`
	Weight float64  `json:"weight"`
	Chain  []string `json:"chain"`
}

type SLI struct {
	// query contains the manual Prometheus metric selectors.
	// Required if template is not specified.
	// +optional
	Query *Query `json:"query,omitempty"`

	// template specifies a predefined SLI template.
	// When set, query must not be specified.
	// +optional
	Template *TemplateStruct `json:"template,omitempty"`
}

type SLOComposition struct {
	metav1.TypeMeta `json:",inline"`

	// metadata is a standard object metadata
	// +optional
	metav1.ObjectMeta `json:"metadata,omitempty,omitzero"`

	// spec defines the desired state of SLOComposition
	// +required
	Spec SLOCompositionSpec `json:"spec"`

	// status defines the observed state of SLOComposition
	// +optional
	Status SLOCompositionStatus `json:"status,omitempty,omitzero"`
}

type SLOCompositionList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []SLOComposition `json:"items"`
}

type SLOCompositionSpec struct {
	// target is the target percentage for the objective (e.g., 99.9).
	// +kubebuilder:validation:Minimum=0
	// +kubebuilder:validation:Maximum=200
	// +required
	Target float64 `json:"target"`

	// window is the time window over which the objective is measured (e.g., "30d" for 30 days).
	// Only days are supported (e.g., "7d", "30d").
	// +kubebuilder:validation:Pattern=`^\d+d$`
	// +required
	Window string `json:"window"`

	// description is an optional human-readable description of the SLO.
	// +optional
	Description string `json:"description,omitempty,omitzero"`

	// +required
	Objectives []SLORef `json:"objectives"`

	// +required
	Composition Composition `json:"composition"`

	// alerting configures alerting rules (budget and burn rate) for this composition.
	// +optional
	Alerting *Alerting `json:"alerting,omitempty"`
}

type SLOCompositionStatus struct {
	// objectiveComposition represents the current status of the composed objective.
	// +optional
	ObjectiveComposition ObjectiveStatus `json:"objectiveComposition,omitempty"`

	// lastUpdateTime indicates the last time the status was updated.
	// +optional
	LastUpdateTime metav1.Time `json:"lastUpdateTime,omitempty"`

	// conditions represent the current state of the SLOComposition resource.
	// Each condition has a unique type and reflects the status of a specific aspect of the resource.
	//
	// Standard condition types include:
	// - "Available": the resource is fully functional
	// - "Progressing": the resource is being created or updated
	// - "Degraded": the resource failed to reach or maintain its desired state
	//
	// The status of each condition is one of True, False, or Unknown.
	// +listType=map
	// +listMapKey=type
	// +optional
	Conditions []metav1.Condition `json:"conditions,omitempty"`
}

type SLOCorrelation struct {
	metav1.TypeMeta `json:",inline"`

	// metadata is standard object metadata
	// +optional
	metav1.ObjectMeta `json:"metadata,omitempty"`

	// spec defines the SLO reference
	// +required
	Spec SLOCorrelationSpec `json:"spec"`

	// status contains the correlation analysis results
	// +optional
	Status SLOCorrelationStatus `json:"status,omitempty"`
}

type SLOCorrelationList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []SLOCorrelation `json:"items"`
}

type SLOCorrelationSpec struct {
	// sloRef references the ServiceLevelObjective that triggered this correlation
	// +required
	SLORef SLOReference `json:"sloRef"`
}

type SLOCorrelationStatus struct {
	// detectedAt is when the burn rate spike was detected
	// +required
	DetectedAt metav1.Time `json:"detectedAt"`

	// burnRateAtDetection is the burn rate value when the spike was detected
	// +required
	BurnRateAtDetection float64 `json:"burnRateAtDetection"`

	// previousBurnRate is the burn rate from the previous reconcile
	// +optional
	PreviousBurnRate float64 `json:"previousBurnRate,omitempty"`

	// severity indicates the severity level that was triggered
	// +kubebuilder:validation:Enum=critical;degraded;warning
	// +required
	Severity string `json:"severity"`

	// window is the time range that was analyzed for correlations
	// +required
	Window TimeWindow `json:"window"`

	// correlatedEvents is the list of changes that may have caused the degradation
	// +optional
	CorrelatedEvents []CorrelatedEvent `json:"correlatedEvents,omitempty"`

	// summary is a human-readable description of the likely cause
	// +optional
	Summary string `json:"summary,omitempty"`

	// eventCount is the total number of events found in the window
	// +optional
	EventCount int `json:"eventCount,omitempty"`
}

type SLOObjective struct {
	// name is the name of the objective (e.g., "availability", "latency").
	// +required
	Name string `json:"name"`

	// * optional namespace for the objective, if not specified it will be assumed to be in the same namespace as the SLOComposition.
	Namespace string `json:"namespace,omitempty"`
}

type SLORef struct {
	// name is the name of the SLO resource being referenced.
	// +required
	Name string `json:"name"`

	Ref SLOObjective `json:"ref"`
}

type SLOReference struct {
	// name is the name of the ServiceLevelObjective
	// +required
	Name string `json:"name"`

	// namespace is the namespace of the ServiceLevelObjective
	// +required
	Namespace string `json:"namespace"`
}

type ServiceLevelObjective struct {
	metav1.TypeMeta `json:",inline"`

	// metadata is a standard object metadata
	// +optional
	metav1.ObjectMeta `json:"metadata,omitempty,omitzero"`

	// spec defines the desired state of ServiceLevelObjective
	// +required
	Spec ServiceLevelObjectiveSpec `json:"spec"`

	// status defines the observed state of ServiceLevelObjective
	// +optional
	Status ServiceLevelObjectiveStatus `json:"status,omitempty,omitzero"`
}

type ServiceLevelObjectiveList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []ServiceLevelObjective `json:"items"`
}

type ServiceLevelObjectiveSpec struct {
	// displayName is the human-readable name for the Service Level Objective.
	// +kubebuilder:validation:MinLength=1
	// +kubebuilder:validation:MaxLength=255
	// +required
	DisplayName string `json:"displayName"`

	// objectives defines the objective for this Service Level Objective.
	// +required
	Objective Objective `json:"objective"`

	// workloadSelector defines which cluster workloads are related to this SLO.
	// Used by the correlation engine to filter relevant events during root cause analysis.
	// If not specified, all events in the SLO namespace are considered.
	// +optional
	WorkloadSelector *WorkloadSelector `json:"workloadSelector,omitempty"`
}

type ServiceLevelObjectiveStatus struct {
	// objectives represent the current status of each objective defined in the spec.
	// +optional
	Objective ObjectiveStatus `json:"objective,omitempty"`

	// lastUpdateTime indicates the last time the status was updated.
	// +optional
	LastUpdateTime metav1.Time `json:"lastUpdateTime,omitempty"`
	// conditions represent the current state of the ServiceLevelObjective resource.
	// Each condition has a unique type and reflects the status of a specific aspect of the resource.
	//
	// Standard condition types include:
	// - "Available": the resource is fully functional
	// - "Progressing": the resource is being created or updated
	// - "Degraded": the resource failed to reach or maintain its desired state
	//
	// The status of each condition is one of True, False, or Unknown.
	// +listType=map
	// +listMapKey=type
	// +optional
	Conditions []metav1.Condition `json:"conditions,omitempty"`
}

type TemplateStruct struct {
	// name is the name of the template to use for this SLI.
	// Available templates: http-availability, http-latency, kubernetes-apiserver
	// +kubebuilder:validation:Enum=http-availability;http-latency;kubernetes-apiserver
	// +required
	Name string `json:"name"`

	// labels are the Prometheus label selectors to filter metrics.
	// Example: {"service": "payment-api", "namespace": "production"}
	// +optional
	Labels map[string]string `json:"labels,omitempty"`

	// params are template-specific parameters.
	// For http-latency: threshold (e.g., "0.5" for 500ms)
	// +optional
	Params map[string]string `json:"params,omitempty"`
}

type TimeWindow struct {
	// start is the beginning of the analysis window
	// +required
	Start metav1.Time `json:"start"`

	// end is the end of the analysis window
	// +required
	End metav1.Time `json:"end"`
}

type WorkloadSelector struct {
	// labelSelector matches workloads by their labels.
	// Only resources with ALL specified labels will be included in correlation.
	// Example: {"app": "example-app", "team": "platform"}
	// +optional
	LabelSelector map[string]string `json:"labelSelector,omitempty"`

	// namespaces limits correlation to these namespaces.
	// If empty, only the SLO's namespace is used.
	// +optional
	Namespaces []string `json:"namespaces,omitempty"`
}