layer1: add namespace event helpers step 15

doc/thinking/2026-04-26-namespace-manager-step15.md

@@ -0,0 +1,16 @@
+# 2026-04-26 — NamespaceManager rewrite, step 15
+
+## Цель шага
+
+Добавить utility helper-методы для построения `NamespaceEvent`.
+
+## Что меняем
+
+1. Добавляем `NewNamespaceEvent()`.
+2. Добавляем `ManagedNamespaceEvent()`.
+3. Добавляем unit tests.
+
+## Что НЕ меняем
+
+- не подключаем event helpers к watcher-ам;
+- не меняем runtime behavior.

pkg/utils/namespace_manager_model.go

@@ -61,6 +61,22 @@ type NamespaceEvent struct {
 	ObservedAt time.Time
 }
 
+func NewNamespaceEvent(eventType NamespaceEventType, name string, labels map[string]string, source NamespaceSource, observedAt time.Time) NamespaceEvent {
+	return NamespaceEvent{
+		Type:       eventType,
+		Name:       name,
+		Labels:     cloneStringMap(labels),
+		Source:     source,
+		ObservedAt: observedAt,
+	}
+}
+
+func ManagedNamespaceEvent(eventType NamespaceEventType, name string, source NamespaceSource, observedAt time.Time) NamespaceEvent {
+	return NewNamespaceEvent(eventType, name, map[string]string{
+		ManagedNamespaceLabelKey: ManagedNamespaceLabelValue,
+	}, source, observedAt)
+}
+
 func (nr NamespaceRecord) Clone() NamespaceRecord {
 	clone := nr
 	clone.Labels = cloneStringMap(nr.Labels)

pkg/utils/namespace_manager_model_test.go

@@ -65,3 +65,24 @@ func TestNamespaceRecordIsTerminal(t *testing.T) {
 		}
 	}
 }
+
+func TestNewNamespaceEventClonesLabels(t *testing.T) {
+	now := time.Now().UTC()
+	labels := map[string]string{ManagedNamespaceLabelKey: ManagedNamespaceLabelValue}
+	event := NewNamespaceEvent(NamespaceEventAdd, "tenant-a", labels, NamespaceSourceWatcher, now)
+	labels[ManagedNamespaceLabelKey] = "false"
+
+	if event.Labels[ManagedNamespaceLabelKey] != ManagedNamespaceLabelValue {
+		t.Fatalf("expected namespace event labels to be cloned")
+	}
+}
+
+func TestManagedNamespaceEvent(t *testing.T) {
+	event := ManagedNamespaceEvent(NamespaceEventAdd, "tenant-a", NamespaceSourceWatcher, time.Now().UTC())
+	if event.Labels[ManagedNamespaceLabelKey] != ManagedNamespaceLabelValue {
+		t.Fatalf("expected managed namespace label in event")
+	}
+	if event.Name != "tenant-a" {
+		t.Fatalf("expected tenant-a event name")
+	}
+}