feat(site): per-node startup reconciliation actor (self-heal missing/stale configs)

2026-06-26 16:35:57 -04:00
parent 96192950a0
commit eb59c4244f
4 changed files with 609 additions and 0 deletions
@@ -359,6 +359,34 @@ public class SiteCommunicationActor : ReceiveActor, IWithTimers
                new ClusterClient.Send("/user/central-communication", msg), Sender);
        });

+        // Site startup reconciliation (Task 18): forward the node's local-inventory
+        // ReconcileSiteRequest to the central cluster. The original Sender (the
+        // SiteReconciliationActor's Ask) is passed as the ClusterClient.Send sender so
+        // the ReconcileSiteResponse routes straight back to the waiting Ask, not here.
+        // Mirrors IngestAuditEventsCommand.
+        Receive<ReconcileSiteRequest>(msg =>
+        {
+            if (_centralClient == null)
+            {
+                // No ClusterClient registered yet (e.g. central contact points not
+                // configured, or registration not yet completed). Faulting the Ask makes
+                // the SiteReconciliationActor treat the pass as best-effort-failed; it
+                // logs a warning and retries reconcile on the next node startup.
+                _log.Warning(
+                    "Cannot forward ReconcileSiteRequest for site {0} node {1} — no central ClusterClient registered",
+                    msg.SiteIdentifier, msg.NodeId);
+                Sender.Tell(new Status.Failure(
+                    new InvalidOperationException("Central ClusterClient not registered")));
+                return;
+            }
+
+            _log.Debug(
+                "Forwarding ReconcileSiteRequest for site {0} node {1} ({2} local instance(s)) to central",
+                msg.SiteIdentifier, msg.NodeId, msg.LocalNameToRevisionHash.Count);
+            _centralClient.Tell(
+                new ClusterClient.Send("/user/central-communication", msg), Sender);
+        });
+
        // Internal: send heartbeat tick
        Receive<SendHeartbeat>(_ => SendHeartbeatToCentral());