feat(vtags): wire IHistoryWriter through DriverHostActor (Null default; durable sink infra-gated) (H5d, stillpending §1)

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

@@ -21,6 +21,7 @@ using ZB.MOM.WW.OtOpcUa.Configuration.Enums;
 using ZB.MOM.WW.OtOpcUa.Core.Abstractions;
 using ZB.MOM.WW.OtOpcUa.Core.ScriptedAlarms;
 using ZB.MOM.WW.OtOpcUa.Core.Scripting;
+using ZB.MOM.WW.OtOpcUa.Core.VirtualTags;
 using ZB.MOM.WW.OtOpcUa.OpcUaServer;
 using ZB.MOM.WW.OtOpcUa.Runtime.ScriptedAlarms;
 using ZB.MOM.WW.OtOpcUa.Runtime.VirtualTags;
@@ -65,6 +66,7 @@ public sealed class DriverHostActor : ReceiveActor, IWithTimers
     private readonly IActorRef? _opcUaPublishActor;
     private readonly IDriverHealthPublisher _healthPublisher;
     private readonly IVirtualTagEvaluator _virtualTagEvaluator;
+    private readonly IHistoryWriter _historyWriter;
     private readonly IActorRef? _virtualTagHostOverride;
     private readonly ILoggerFactory _loggerFactory;
     private readonly ScriptRootLogger? _scriptRootLogger;
@@ -196,6 +198,10 @@ public sealed class DriverHostActor : ReceiveActor, IWithTimers
     /// <see cref="VirtualTagHostActor"/>'s children; defaults to <see cref="NullVirtualTagEvaluator"/>
     /// (the dev/Mac path where no expression is evaluated). Production passes the DI-resolved
     /// Roslyn evaluator.</param>
+    /// <param name="historyWriter">Optional sink handed to the spawned <see cref="VirtualTagHostActor"/>
+    /// for VirtualTag results whose plan opted into <c>Historize=true</c>; defaults to
+    /// <see cref="NullHistoryWriter"/> (the durable AVEVA sink is infra-gated, so no live-data historian
+    /// write RPC exists). A deployment that binds a real <see cref="IHistoryWriter"/> in DI overrides it.</param>
     /// <param name="virtualTagHostOverride">Test seam: when supplied, this actor is used as the
     /// VirtualTag host instead of spawning a real <see cref="VirtualTagHostActor"/> child, so tests
     /// can intercept the <see cref="VirtualTagHostActor.ApplyVirtualTags"/> message. Null in
@@ -220,13 +226,14 @@ public sealed class DriverHostActor : ReceiveActor, IWithTimers
         IActorRef? opcUaPublishActor = null,
         IDriverHealthPublisher? healthPublisher = null,
         IVirtualTagEvaluator? virtualTagEvaluator = null,
+        IHistoryWriter? historyWriter = null,
         IActorRef? virtualTagHostOverride = null,
         ILoggerFactory? loggerFactory = null,
         ScriptRootLogger? scriptRootLogger = null,
         IActorRef? scriptedAlarmHostOverride = null) =>
         Akka.Actor.Props.Create(() => new DriverHostActor(
             dbFactory, localNode, coordinator, driverFactory, localRoles, dependencyMux, opcUaPublishActor,
-            healthPublisher, virtualTagEvaluator, virtualTagHostOverride,
+            healthPublisher, virtualTagEvaluator, historyWriter, virtualTagHostOverride,
             loggerFactory, scriptRootLogger, scriptedAlarmHostOverride));
 
     /// <summary>Initializes a new DriverHostActor with the specified dependencies.</summary>
@@ -240,6 +247,8 @@ public sealed class DriverHostActor : ReceiveActor, IWithTimers
     /// <param name="healthPublisher">Optional driver-health publisher; defaults to <see cref="NullDriverHealthPublisher"/>.</param>
     /// <param name="virtualTagEvaluator">Optional evaluator handed to the VirtualTag host's children;
     /// defaults to <see cref="NullVirtualTagEvaluator"/>.</param>
+    /// <param name="historyWriter">Optional sink handed to the spawned <see cref="VirtualTagHostActor"/>
+    /// for historized VirtualTag results; defaults to <see cref="NullHistoryWriter"/>.</param>
     /// <param name="virtualTagHostOverride">Test seam: when supplied, used as the VirtualTag host
     /// instead of spawning a real <see cref="VirtualTagHostActor"/> child.</param>
     /// <param name="loggerFactory">Optional logger factory used to create the
@@ -258,6 +267,7 @@ public sealed class DriverHostActor : ReceiveActor, IWithTimers
         IActorRef? opcUaPublishActor = null,
         IDriverHealthPublisher? healthPublisher = null,
         IVirtualTagEvaluator? virtualTagEvaluator = null,
+        IHistoryWriter? historyWriter = null,
         IActorRef? virtualTagHostOverride = null,
         ILoggerFactory? loggerFactory = null,
         ScriptRootLogger? scriptRootLogger = null,
@@ -272,6 +282,7 @@ public sealed class DriverHostActor : ReceiveActor, IWithTimers
         _opcUaPublishActor = opcUaPublishActor;
         _healthPublisher = healthPublisher ?? NullDriverHealthPublisher.Instance;
         _virtualTagEvaluator = virtualTagEvaluator ?? NullVirtualTagEvaluator.Instance;
+        _historyWriter = historyWriter ?? NullHistoryWriter.Instance;
         _virtualTagHostOverride = virtualTagHostOverride;
         _loggerFactory = loggerFactory ?? NullLoggerFactory.Instance;
         _scriptRootLogger = scriptRootLogger;
@@ -329,7 +340,7 @@ public sealed class DriverHostActor : ReceiveActor, IWithTimers
         }
 
         _virtualTagHost = Context.ActorOf(
-            VirtualTagHostActor.Props(_opcUaPublishActor, _dependencyMux, _virtualTagEvaluator),
+            VirtualTagHostActor.Props(_opcUaPublishActor, _dependencyMux, _virtualTagEvaluator, _historyWriter),
             "virtual-tag-host");
     }
 

src/Server/ZB.MOM.WW.OtOpcUa.Runtime/ServiceCollectionExtensions.cs

@@ -13,6 +13,7 @@ using ZB.MOM.WW.OtOpcUa.Configuration;
 using ZB.MOM.WW.OtOpcUa.Core.Abstractions;
 using ZB.MOM.WW.OtOpcUa.Core.AlarmHistorian;
 using ZB.MOM.WW.OtOpcUa.Core.Scripting;
+using ZB.MOM.WW.OtOpcUa.Core.VirtualTags;
 using ZB.MOM.WW.OtOpcUa.OpcUaServer;
 using ZB.MOM.WW.OtOpcUa.Runtime.Drivers;
 using ZB.MOM.WW.OtOpcUa.Runtime.Health;
@@ -43,6 +44,10 @@ public static class ServiceCollectionExtensions
     {
         services.TryAddSingleton<IAlarmHistorianSink>(NullAlarmHistorianSink.Instance);
         services.TryAddSingleton<IHistorianDataSource>(NullHistorianDataSource.Instance);
+        // VirtualTag historization sink. Null default — the durable AVEVA sink is infra-gated (there is
+        // no live-data historian write RPC). TryAddSingleton so a deployment that bound a real
+        // IHistoryWriter earlier wins.
+        services.TryAddSingleton<IHistoryWriter>(NullHistoryWriter.Instance);
         services.TryAddSingleton<IDriverFactory>(NullDriverFactory.Instance);
         services.TryAddSingleton<IOpcUaAddressSpaceSink>(NullOpcUaAddressSpaceSink.Instance);
         services.TryAddSingleton<IServiceLevelPublisher>(NullServiceLevelPublisher.Instance);
@@ -184,6 +189,10 @@ public static class ServiceCollectionExtensions
                 virtualTagEvaluator = NullVirtualTagEvaluator.Instance;
             }
 
+            // VirtualTag historization sink threaded to the spawned VirtualTagHostActor. Null default
+            // (durable AVEVA sink is infra-gated); a deployment binding a real IHistoryWriter overrides.
+            var historyWriter = resolver.GetService<IHistoryWriter>() ?? NullHistoryWriter.Instance;
+
             var dbHealth = system.ActorOf(
                 DbHealthProbeActor.Props(dbFactory),
                 DbHealthProbeActorName);
@@ -215,6 +224,7 @@ public static class ServiceCollectionExtensions
                     opcUaPublishActor: publishActor,
                     healthPublisher: healthPublisher,
                     virtualTagEvaluator: virtualTagEvaluator,
+                    historyWriter: historyWriter,
                     loggerFactory: loggerFactory,
                     scriptRootLogger: scriptRootLogger),
                 DriverHostActorName);