feat(mesh-phase5): tap the 4 telemetry publish seams into the local hub (DPS intact)

Each of the four telemetry publish seams now also emits its DPS payload into the
node-local ITelemetryLocalHub (Phase 5), leaving the existing DistributedPubSub
publish untouched:

- driver-health   AkkaDriverHealthPublisher            -> TelemetryItem.Health
- resilience      DriverResilienceStatusPublisherService -> TelemetryItem.Resilience
- alerts          ScriptedAlarmHostActor + DriverHostActor (native) -> TelemetryItem.Alarm
- script-logs     VirtualTagActor + DpsScriptLogPublisher -> TelemetryItem.Script

DI services take the hub as a required ctor param; actors take an optional
nullable hub threaded through their Props and the real spawn sites
(DriverHostActor <- ServiceCollectionExtensions; VirtualTagActor/ScriptedAlarmHostActor
<- DriverHostActor), so existing test Props constructions keep compiling and simply
do not emit. The hub is a no-op until a gRPC client subscribes, so the emit is safe
on every node.

Claude-Session: https://claude.ai/code/session_01GASWkNEi68FSCtvr6rLoEW

src/Server/ZB.MOM.WW.OtOpcUa.Runtime/Drivers/AkkaDriverHealthPublisher.cs

@@ -2,6 +2,7 @@ using Akka.Actor;
 using Akka.Cluster.Tools.PublishSubscribe;
 using ZB.MOM.WW.OtOpcUa.Commons.Messages.Drivers;
 using ZB.MOM.WW.OtOpcUa.Core.Abstractions;
+using ZB.MOM.WW.OtOpcUa.Runtime.Telemetry;
 
 namespace ZB.MOM.WW.OtOpcUa.Runtime.Drivers;
 
@@ -17,10 +18,16 @@ public sealed class AkkaDriverHealthPublisher : IDriverHealthPublisher
     public const string TopicName = DriverHealthChanged.TopicName;
 
     private readonly ActorSystem _system;
+    private readonly ITelemetryLocalHub _hub;
 
     /// <summary>Initializes a new instance of <see cref="AkkaDriverHealthPublisher"/>.</summary>
     /// <param name="system">The Akka actor system used to resolve the DPS mediator.</param>
-    public AkkaDriverHealthPublisher(ActorSystem system) => _system = system;
+    /// <param name="hub">The node-local live-telemetry hub each snapshot is also emitted into (Phase 5).</param>
+    public AkkaDriverHealthPublisher(ActorSystem system, ITelemetryLocalHub hub)
+    {
+        _system = system;
+        _hub = hub;
+    }
 
     /// <inheritdoc />
     public void Publish(string clusterId, string driverInstanceId, DriverHealth health, int errorCount5Min)
@@ -34,5 +41,8 @@ public sealed class AkkaDriverHealthPublisher : IDriverHealthPublisher
             errorCount5Min,
             DateTime.UtcNow);
         DistributedPubSub.Get(_system).Mediator.Tell(new Publish(TopicName, msg));
+        // Phase 5: fan the same snapshot into the node-local live-telemetry hub (no-op until a gRPC
+        // client subscribes). The DPS publish above is unchanged — the hub is a strictly additive tap.
+        _hub.Emit(new TelemetryItem.Health(msg));
     }
 }

src/Server/ZB.MOM.WW.OtOpcUa.Runtime/Drivers/DriverHostActor.cs

@@ -26,6 +26,7 @@ using ZB.MOM.WW.OtOpcUa.OpcUaServer;
 using ZB.MOM.WW.OtOpcUa.Runtime.DeploymentCache;
 using ZB.MOM.WW.OtOpcUa.Runtime.Redundancy;
 using ZB.MOM.WW.OtOpcUa.Runtime.ScriptedAlarms;
+using ZB.MOM.WW.OtOpcUa.Runtime.Telemetry;
 using ZB.MOM.WW.OtOpcUa.Runtime.VirtualTags;
 using CommonsNodeId = ZB.MOM.WW.OtOpcUa.Commons.Types.NodeId;
 
@@ -118,6 +119,11 @@ public sealed class DriverHostActor : ReceiveActor, IWithTimers
     /// </summary>
     private readonly IAlarmStateStore? _alarmStateStore;
 
+    /// <summary>Optional node-local live-telemetry hub (Phase 5): each Primary-gated native-alarm
+    /// <c>alerts</c> transition is also emitted here, and it is threaded into the spawned VirtualTag +
+    /// ScriptedAlarm hosts. Null (admin-only nodes / tests) skips the emit and passes null down.</summary>
+    private readonly ITelemetryLocalHub? _telemetryHub;
+
     private readonly CommonsNodeId _localNode;
     private readonly IActorRef? _ackRouter;
     private readonly IDriverFactory _driverFactory;
@@ -397,6 +403,9 @@ public sealed class DriverHostActor : ReceiveActor, IWithTimers
     /// driver-role node this is the replicated LocalDb store, so condition state persists with no
     /// ConfigDb; null skips spawning the alarm host (the ConfigDb-backed EF fallback was retired in
     /// Phase 4 Task 9). Defaults to null.</param>
+    /// <param name="telemetryHub">Per-cluster mesh Phase 5: optional node-local live-telemetry hub each
+    /// Primary-gated native-alarm transition is also emitted into, and which is threaded into the spawned
+    /// VirtualTag + ScriptedAlarm hosts. Defaults to null (admin-only nodes / tests skip the emit).</param>
     /// <returns>The Akka.NET <see cref="Akka.Actor.Props"/> used to spawn this actor.</returns>
     public static Props Props(
         IDbContextFactory<OtOpcUaConfigDbContext>? dbFactory,
@@ -420,7 +429,8 @@ public sealed class DriverHostActor : ReceiveActor, IWithTimers
         string? replicationPeerHost = null,
         bool fetchAndCacheMode = false,
         IDeploymentArtifactFetcher? artifactFetcher = null,
-        IAlarmStateStore? alarmStateStore = null) =>
+        IAlarmStateStore? alarmStateStore = null,
+        ITelemetryLocalHub? telemetryHub = null) =>
         // WARNING: this forwarding list is POSITIONAL, and Props.Create compiles it into an
         // expression tree. Six IActorRef? parameters and several interface-typed ones mean a
         // mis-ordered argument is usually type-compatible and therefore compiles clean, then binds
@@ -431,7 +441,7 @@ public sealed class DriverHostActor : ReceiveActor, IWithTimers
             healthPublisher, virtualTagEvaluator, historyWriter, virtualTagHostOverride,
             loggerFactory, scriptRootLogger, scriptedAlarmHostOverride, invokerFactory, driverMemberCountProvider,
             deploymentArtifactCache, redundancyRoleView, replicationPeerHost, fetchAndCacheMode, artifactFetcher,
-            alarmStateStore));
+            alarmStateStore, telemetryHub));
 
     /// <summary>Initializes a new DriverHostActor with the specified dependencies.</summary>
     /// <param name="dbFactory">Database context factory for configuration database access.</param>
@@ -469,6 +479,9 @@ public sealed class DriverHostActor : ReceiveActor, IWithTimers
     /// <param name="alarmStateStore">Per-cluster mesh Phase 4: scripted-alarm condition-state store. On a
     /// driver-role node this is the replicated LocalDb store; null skips spawning the alarm host (the
     /// ConfigDb-backed EF fallback was retired in Phase 4 Task 9).</param>
+    /// <param name="telemetryHub">Per-cluster mesh Phase 5: optional node-local live-telemetry hub each
+    /// Primary-gated native-alarm transition is also emitted into, and which is threaded into the spawned
+    /// VirtualTag + ScriptedAlarm hosts. Null (admin-only nodes / tests) skips the emit and passes null down.</param>
     public DriverHostActor(
         IDbContextFactory<OtOpcUaConfigDbContext>? dbFactory,
         CommonsNodeId localNode,
@@ -491,8 +504,10 @@ public sealed class DriverHostActor : ReceiveActor, IWithTimers
         string? replicationPeerHost = null,
         bool fetchAndCacheMode = false,
         IDeploymentArtifactFetcher? artifactFetcher = null,
-        IAlarmStateStore? alarmStateStore = null)
+        IAlarmStateStore? alarmStateStore = null,
+        ITelemetryLocalHub? telemetryHub = null)
     {
+        _telemetryHub = telemetryHub;
         _deploymentArtifactCache = deploymentArtifactCache;
         _redundancyRoleView = redundancyRoleView;
         _replicationPeerHost = replicationPeerHost;
@@ -577,7 +592,7 @@ public sealed class DriverHostActor : ReceiveActor, IWithTimers
         }
 
         _virtualTagHost = Context.ActorOf(
-            VirtualTagHostActor.Props(_opcUaPublishActor, _dependencyMux, _virtualTagEvaluator, _historyWriter),
+            VirtualTagHostActor.Props(_opcUaPublishActor, _dependencyMux, _virtualTagEvaluator, _historyWriter, _telemetryHub),
             "virtual-tag-host");
     }
 
@@ -630,7 +645,8 @@ public sealed class DriverHostActor : ReceiveActor, IWithTimers
         var engine = new ScriptedAlarmEngine(
             upstream, store, new ScriptLoggerFactory(_scriptRootLogger.Logger), _scriptRootLogger.Logger);
         _scriptedAlarmHost = Context.ActorOf(
-            ScriptedAlarmHostActor.Props(_opcUaPublishActor, _dependencyMux, upstream, engine, _localNode),
+            ScriptedAlarmHostActor.Props(
+                _opcUaPublishActor, _dependencyMux, upstream, engine, _localNode, telemetryHub: _telemetryHub),
             "scripted-alarm-host");
     }
 
@@ -1402,7 +1418,7 @@ public sealed class DriverHostActor : ReceiveActor, IWithTimers
             var meta = _alarmMetaByNodeId.TryGetValue(nodeId, out var m)
                 ? m : (EquipmentId: nodeId, Name: nodeId, AlarmType: "AlarmCondition", HistorizeToAveva: (bool?)null,
                     ReferencingEquipmentPaths: (IReadOnlyList<string>)Array.Empty<string>());
-            _mediator.Tell(new Publish(ScriptedAlarmHostActor.AlertsTopic, new AlarmTransitionEvent(
+            var alertEvent = new AlarmTransitionEvent(
                 AlarmId: nodeId,
                 EquipmentPath: meta.EquipmentId,
                 AlarmName: meta.Name,
@@ -1424,7 +1440,12 @@ public sealed class DriverHostActor : ReceiveActor, IWithTimers
                 HistorizeToAveva: meta.HistorizeToAveva,
                 // WP4: the Area/Line/Equipment UNS paths that reference this raw condition — the /alerts row
                 // renders them as the equipment list (empty for a raw condition no equipment references yet).
-                ReferencingEquipmentPaths: meta.ReferencingEquipmentPaths)));
+                ReferencingEquipmentPaths: meta.ReferencingEquipmentPaths);
+            _mediator.Tell(new Publish(ScriptedAlarmHostActor.AlertsTopic, alertEvent));
+            // Phase 5: fan the same transition into the node-local live-telemetry hub (no-op until a gRPC
+            // client subscribes). The DPS publish above is unchanged — a strictly additive tap, riding the
+            // same Primary gate (only reached when serviceAlertsAsPrimary).
+            _telemetryHub?.Emit(new TelemetryItem.Alarm(alertEvent));
         }
     }