From b5bc5f65ad29a580cd3e71f645b68c337bbcd86b Mon Sep 17 00:00:00 2001
From: RHCowan <50324595+RHCowan@users.noreply.github.com>
Date: Wed, 4 Mar 2026 14:49:55 +1300
Subject: [PATCH] feat(alerting): Add edge alert ingestion endpoint skeleton
 [R8S-895] (#1991)

---
 pkg/metrics/types.go | 46 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)
 create mode 100644 pkg/metrics/types.go

diff --git a/pkg/metrics/types.go b/pkg/metrics/types.go
new file mode 100644
index 000000000..c4dfc5aa7
--- /dev/null
+++ b/pkg/metrics/types.go
@@ -0,0 +1,46 @@
+package metrics
+
+// EdgeAlertBatch is the generic envelope pushed by edge agents.
+type EdgeAlertBatch struct {
+	EnvironmentName string       `json:"environment_name"`
+	Timestamp       int64        `json:"timestamp,omitempty"` // unix nanoseconds
+	FiredAlerts     []FiredAlert `json:"fired_alerts,omitempty"`
+	RawSignals      *RawSignals  `json:"raw_signals,omitempty"`
+}
+
+// FiredAlert represents a rule the agent has already evaluated and determined should fire.
+type FiredAlert struct {
+	RuleID   int    `json:"rule_id"`
+	Severity string `json:"severity"`
+	Message  string `json:"message"`
+}
+
+// RawSignals carries raw K8s cluster health data for future server-side evaluation.
+type RawSignals struct {
+	Workloads  []WorkloadItem  `json:"workloads,omitempty"`
+	Conditions []ConditionItem `json:"conditions,omitempty"`
+}
+
+// ResourceRef identifies a Kubernetes resource.
+type ResourceRef struct {
+	Kind      string `json:"kind"`
+	Name      string `json:"name"`
+	Namespace string `json:"namespace"`
+}
+
+// ConditionItem holds a single Kubernetes condition observation.
+type ConditionItem struct {
+	Ref      ResourceRef `json:"ref"`
+	Type     string      `json:"type"`
+	Status   int8        `json:"status"` // -1 unknown, 0 unhealthy, 1 healthy
+	Reason   string      `json:"reason"`
+	NodeName string      `json:"node_name,omitempty"`
+	PodName  string      `json:"pod_name,omitempty"`
+}
+
+// WorkloadItem holds a single Kubernetes workload replica observation.
+type WorkloadItem struct {
+	Ref       ResourceRef `json:"ref"`
+	Desired   int         `json:"desired"`
+	Available int         `json:"available"`
+}