feat(runtime): F11 — HistorianAdapterActor wired to IAlarmHistorianSink

Reshapes the placeholder buffered-counter actor into a thin fire-and-forget
bridge over the existing IAlarmHistorianSink contract. Default sink is
NullAlarmHistorianSink; production deployments override the DI binding to
SqliteStoreAndForwardSink wrapping WonderwareHistorianClient (the v1
components in src/Drivers/ZB.MOM.WW.OtOpcUa.Driver.Historian.Wonderware*
are reused verbatim — actor is just a mailbox-friendly entry point).

- HistorianAdapterActor.Props(IAlarmHistorianSink?) — null defaults to NullAlarmHistorianSink
- Receive<AlarmHistorianEvent>: fire-and-forget sink.EnqueueAsync
- Receive<GetStatus>: returns sink.GetStatus() (queue depth + drain state)
- ServiceCollectionExtensions.AddOtOpcUaRuntime registers the default sink
- WithOtOpcUaRuntimeActors spawns the actor + registers HistorianAdapterActorKey
- Program.cs calls AddOtOpcUaRuntime when hasDriver

Tests: 2 new (forward-to-sink + GetStatus). Runtime suite 17 → 18.

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

@@ -1,10 +1,14 @@
 using Akka.Actor;
 using Akka.Hosting;
 using Microsoft.EntityFrameworkCore;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.DependencyInjection.Extensions;
 using ZB.MOM.WW.OtOpcUa.Commons.Interfaces;
 using ZB.MOM.WW.OtOpcUa.Configuration;
+using ZB.MOM.WW.OtOpcUa.Core.AlarmHistorian;
 using ZB.MOM.WW.OtOpcUa.Runtime.Drivers;
 using ZB.MOM.WW.OtOpcUa.Runtime.Health;
+using ZB.MOM.WW.OtOpcUa.Runtime.Historian;
 
 namespace ZB.MOM.WW.OtOpcUa.Runtime;
 
@@ -14,11 +18,25 @@ public static class ServiceCollectionExtensions
 
     public const string DriverHostActorName = "driver-host";
     public const string DbHealthProbeActorName = "db-health";
+    public const string HistorianAdapterActorName = "historian-adapter";
+
+    /// <summary>
+    /// Registers shared runtime services. Currently binds <see cref="IAlarmHistorianSink"/>
+    /// to <see cref="NullAlarmHistorianSink"/> as the default; production deployments
+    /// override this with <c>SqliteStoreAndForwardSink</c> wrapping <c>WonderwareHistorianClient</c>.
+    /// Call this BEFORE <c>AddAkka</c>.
+    /// </summary>
+    public static IServiceCollection AddOtOpcUaRuntime(this IServiceCollection services)
+    {
+        services.TryAddSingleton<IAlarmHistorianSink>(NullAlarmHistorianSink.Instance);
+        return services;
+    }
 
     /// <summary>
     /// Spawns the per-node driver-role actors on the host's <see cref="ActorSystem"/>:
-    /// <see cref="DriverHostActor"/> (one per node) and <see cref="DbHealthProbeActor"/>
-    /// (consumed by the health endpoint + redundancy calc).
+    /// <see cref="DriverHostActor"/> (one per node), <see cref="DbHealthProbeActor"/>
+    /// (consumed by the health endpoint + redundancy calc), and
+    /// <see cref="HistorianAdapterActor"/> wrapping the registered <see cref="IAlarmHistorianSink"/>.
     ///
     /// Mirror of <c>WithOtOpcUaControlPlaneSingletons</c> for the driver role. Both must
     /// be registered on the same <see cref="AkkaConfigurationBuilder"/> as the cluster
@@ -26,8 +44,8 @@ public static class ServiceCollectionExtensions
     ///
     /// Wire from the fused Host's Program.cs when the node carries the <c>driver</c> role:
     /// <code>
-    /// if (hasDriver)
-    ///     ab.WithOtOpcUaRuntimeActors();
+    /// services.AddOtOpcUaRuntime();
+    /// services.AddAkka("otopcua", (ab, sp) => { ab.WithOtOpcUaClusterBootstrap(sp); if (hasDriver) ab.WithOtOpcUaRuntimeActors(); });
     /// </code>
     /// </summary>
     public static AkkaConfigurationBuilder WithOtOpcUaRuntimeActors(this AkkaConfigurationBuilder builder)
@@ -36,6 +54,8 @@ public static class ServiceCollectionExtensions
         {
             var dbFactory = resolver.GetService<IDbContextFactory<OtOpcUaConfigDbContext>>();
             var roleInfo = resolver.GetService<IClusterRoleInfo>();
+            // Fallback to NullAlarmHistorianSink if AddOtOpcUaRuntime wasn't called (e.g., test harnesses).
+            var historianSink = resolver.GetService<IAlarmHistorianSink>() ?? NullAlarmHistorianSink.Instance;
 
             var dbHealth = system.ActorOf(
                 DbHealthProbeActor.Props(dbFactory),
@@ -46,6 +66,11 @@ public static class ServiceCollectionExtensions
                 DriverHostActor.Props(dbFactory, roleInfo.LocalNode),
                 DriverHostActorName);
             registry.Register<DriverHostActorKey>(driverHost);
+
+            var historian = system.ActorOf(
+                HistorianAdapterActor.Props(historianSink),
+                HistorianAdapterActorName);
+            registry.Register<HistorianAdapterActorKey>(historian);
         });
 
         return builder;
@@ -55,3 +80,4 @@ public static class ServiceCollectionExtensions
 /// <summary>Marker key types used by <c>Akka.Hosting</c> to resolve runtime actors from the registry.</summary>
 public sealed class DriverHostActorKey { }
 public sealed class DbHealthProbeActorKey { }
+public sealed class HistorianAdapterActorKey { }