feat(vtags): forward historized vtag results to IHistoryWriter (H5c, stillpending §1)

src/Server/ZB.MOM.WW.OtOpcUa.Runtime/VirtualTags/VirtualTagHostActor.cs

@@ -2,6 +2,8 @@ using Akka.Actor;
 using Akka.Event;
 using ZB.MOM.WW.OtOpcUa.Commons.Engines;
 using ZB.MOM.WW.OtOpcUa.Commons.OpcUa;
+using ZB.MOM.WW.OtOpcUa.Core.Abstractions;
+using ZB.MOM.WW.OtOpcUa.Core.VirtualTags;
 using ZB.MOM.WW.OtOpcUa.OpcUaServer;
 using ZB.MOM.WW.OtOpcUa.Runtime.OpcUa;
 
@@ -33,6 +35,9 @@ public sealed class VirtualTagHostActor : ReceiveActor
     private readonly IActorRef _publishActor;
     private readonly IActorRef? _mux;
     private readonly IVirtualTagEvaluator _evaluator;
+    // Sink for historized VirtualTag results (plans with Historize=true). NullHistoryWriter when no
+    // durable historian is wired, so OnResult always has a non-null target.
+    private readonly IHistoryWriter _history;
     private readonly ILoggingAdapter _log = Context.GetLogger();
 
     // vtagId -> spawned child VirtualTagActor.
@@ -50,20 +55,27 @@ public sealed class VirtualTagHostActor : ReceiveActor
     /// <param name="mux">Optional dependency multiplexer; passed to each spawned child so it can
     /// register interest in its dependency refs. Null on the dev/Mac path (no live values).</param>
     /// <param name="evaluator">The evaluator each child uses to compute its expression.</param>
-    public static Props Props(IActorRef publishActor, IActorRef? mux, IVirtualTagEvaluator evaluator) =>
-        Akka.Actor.Props.Create(() => new VirtualTagHostActor(publishActor, mux, evaluator));
+    /// <param name="historyWriter">Sink for results whose plan has <c>Historize=true</c>. Null ⇒
+    /// <see cref="NullHistoryWriter.Instance"/> (no durable historian wired), so existing call sites
+    /// compile unchanged and never historize.</param>
+    public static Props Props(IActorRef publishActor, IActorRef? mux, IVirtualTagEvaluator evaluator,
+        IHistoryWriter? historyWriter = null) =>
+        Akka.Actor.Props.Create(() => new VirtualTagHostActor(publishActor, mux, evaluator, historyWriter));
 
     /// <summary>Initializes a new instance of the <see cref="VirtualTagHostActor"/> class.</summary>
     /// <param name="publishActor">The OPC UA publish actor results are bridged to.</param>
     /// <param name="mux">Optional dependency multiplexer passed to each spawned child.</param>
     /// <param name="evaluator">The evaluator each child uses to compute its expression.</param>
-    public VirtualTagHostActor(IActorRef publishActor, IActorRef? mux, IVirtualTagEvaluator evaluator)
+    /// <param name="historyWriter">Sink for historized results; null ⇒ <see cref="NullHistoryWriter.Instance"/>.</param>
+    public VirtualTagHostActor(IActorRef publishActor, IActorRef? mux, IVirtualTagEvaluator evaluator,
+        IHistoryWriter? historyWriter = null)
     {
         ArgumentNullException.ThrowIfNull(publishActor);
         ArgumentNullException.ThrowIfNull(evaluator);
         _publishActor = publishActor;
         _mux = mux;
         _evaluator = evaluator;
+        _history = historyWriter ?? NullHistoryWriter.Instance;
 
         Receive<ApplyVirtualTags>(OnApply);
         Receive<VirtualTagActor.EvaluationResult>(OnResult);
@@ -154,6 +166,15 @@ public sealed class VirtualTagHostActor : ReceiveActor
 
         _publishActor.Tell(new OpcUaPublishActor.AttributeValueUpdate(
             nodeId, result.Value, OpcUaQuality.Good, result.TimestampUtc));
+
+        // Historize iff the plan opted in. Reuses _planByVtag (kept in lock-step with _children), so
+        // no parallel map. The historian path key is the SAME folder-scoped NodeId we just published
+        // to. For a computed value source == server, so both timestamps are the evaluation time.
+        if (_planByVtag.TryGetValue(result.VirtualTagId, out var plan) && plan.Historize)
+        {
+            _history.Record(nodeId, new DataValueSnapshot(
+                result.Value, 0u /* StatusCodes.Good */, result.TimestampUtc, result.TimestampUtc));
+        }
     }
 
     private void OnChildTerminated(Terminated msg)

src/Server/ZB.MOM.WW.OtOpcUa.Runtime/ZB.MOM.WW.OtOpcUa.Runtime.csproj

@@ -32,6 +32,9 @@
         <!-- IScriptLogPublisher lives in Core.Scripting; DpsScriptLogPublisher implements it
              here so the concrete Akka DPS routing stays out of the Core layer. -->
         <ProjectReference Include="..\..\Core\ZB.MOM.WW.OtOpcUa.Core.Scripting\ZB.MOM.WW.OtOpcUa.Core.Scripting.csproj"/>
+        <!-- IHistoryWriter / NullHistoryWriter live in Core.VirtualTags; VirtualTagHostActor forwards
+             historized VirtualTag results to it (H5c). The durable sink is wired by the host's DI. -->
+        <ProjectReference Include="..\..\Core\ZB.MOM.WW.OtOpcUa.Core.VirtualTags\ZB.MOM.WW.OtOpcUa.Core.VirtualTags.csproj"/>
     </ItemGroup>
 
 </Project>