docs: backfill XML documentation across 756 files

Adds <summary>, <param>, <typeparam>, and <inheritdoc/> tags to public
members surfaced by commentchecker — resolves 5,847 of 5,869 issues
(99.6%) across three /fixdocs passes.

tests/Server/ZB.MOM.WW.OtOpcUa.Runtime.Tests/OpcUa/OpcUaPublishActorRebuildTests.cs

@@ -18,6 +18,7 @@ namespace ZB.MOM.WW.OtOpcUa.Runtime.Tests.OpcUa;
 
 public sealed class OpcUaPublishActorRebuildTests : RuntimeActorTestBase
 {
+    /// <summary>Tests that RebuildAddressSpace with dbFactory loads artifact, composes, and applies.</summary>
     [Fact]
     public void RebuildAddressSpace_with_dbFactory_loads_artifact_composes_and_applies()
     {
@@ -42,6 +43,7 @@ public sealed class OpcUaPublishActorRebuildTests : RuntimeActorTestBase
         }, duration: TimeSpan.FromSeconds(2));
     }
 
+    /// <summary>Tests that rebuild with no artifact is idempotent no-op.</summary>
     [Fact]
     public void Rebuild_with_no_artifact_is_idempotent_no_op()
     {
@@ -61,6 +63,7 @@ public sealed class OpcUaPublishActorRebuildTests : RuntimeActorTestBase
         sink.RebuildCalls.ShouldBe(0);
     }
 
+    /// <summary>Tests that second rebuild with same artifact is empty plan no-op.</summary>
     [Fact]
     public void Second_rebuild_with_same_artifact_is_empty_plan_no_op()
     {
@@ -81,6 +84,7 @@ public sealed class OpcUaPublishActorRebuildTests : RuntimeActorTestBase
         sink.RebuildCalls.ShouldBe(1);
     }
 
+    /// <summary>Tests that rebuild without dbFactory falls back to raw sink rebuild.</summary>
     [Fact]
     public void Rebuild_without_dbFactory_falls_back_to_raw_sink_rebuild()
     {
@@ -133,14 +137,31 @@ public sealed class OpcUaPublishActorRebuildTests : RuntimeActorTestBase
 
     private sealed class RecordingSink : IOpcUaAddressSpaceSink
     {
+        /// <summary>Gets the list of recorded sink calls.</summary>
         public ConcurrentQueue<string> Calls { get; } = new();
+        /// <summary>Gets or sets the count of rebuild address space calls.</summary>
         public int RebuildCalls;
+        /// <summary>Records a value write call.</summary>
+        /// <param name="nodeId">The OPC UA node ID.</param>
+        /// <param name="value">The value to write.</param>
+        /// <param name="quality">The OPC UA quality code.</param>
+        /// <param name="ts">The timestamp of the write.</param>
         public void WriteValue(string nodeId, object? value, OpcUaQuality quality, DateTime ts)
             => Calls.Enqueue($"WV:{nodeId}");
+        /// <summary>Records an alarm state write call.</summary>
+        /// <param name="alarmNodeId">The alarm node ID.</param>
+        /// <param name="active">Whether the alarm is active.</param>
+        /// <param name="acknowledged">Whether the alarm is acknowledged.</param>
+        /// <param name="ts">The timestamp of the state change.</param>
         public void WriteAlarmState(string alarmNodeId, bool active, bool acknowledged, DateTime ts)
             => Calls.Enqueue($"WA:{alarmNodeId}");
+        /// <summary>Records a folder ensure call.</summary>
+        /// <param name="folderNodeId">The folder node ID.</param>
+        /// <param name="parentNodeId">The parent node ID, or null if this is a root folder.</param>
+        /// <param name="displayName">The display name of the folder.</param>
         public void EnsureFolder(string folderNodeId, string? parentNodeId, string displayName)
             => Calls.Enqueue($"EF:{folderNodeId}");
+        /// <summary>Records a rebuild address space call.</summary>
         public void RebuildAddressSpace() => Interlocked.Increment(ref RebuildCalls);
     }
 }

tests/Server/ZB.MOM.WW.OtOpcUa.Runtime.Tests/OpcUa/OpcUaPublishActorTests.cs

@@ -12,6 +12,7 @@ namespace ZB.MOM.WW.OtOpcUa.Runtime.Tests.OpcUa;
 
 public sealed class OpcUaPublishActorTests : RuntimeActorTestBase
 {
+    /// <summary>Verifies that message contracts are accepted without a pinned dispatcher in tests.</summary>
     [Fact]
     public void Accepts_message_contracts_without_pinned_dispatcher_in_tests()
     {
@@ -24,6 +25,7 @@ public sealed class OpcUaPublishActorTests : RuntimeActorTestBase
         ExpectNoMsg(TimeSpan.FromMilliseconds(200));
     }
 
+    /// <summary>Verifies that production props target the OPC UA synchronized dispatcher.</summary>
     [Fact]
     public void Production_Props_targets_opcua_synchronized_dispatcher()
     {
@@ -31,6 +33,7 @@ public sealed class OpcUaPublishActorTests : RuntimeActorTestBase
         props.Dispatcher.ShouldBe(OpcUaPublishActor.DispatcherId);
     }
 
+    /// <summary>Verifies that AttributeValueUpdate routes to sink WriteValue.</summary>
     [Fact]
     public void AttributeValueUpdate_routes_to_sink_WriteValue()
     {
@@ -50,6 +53,7 @@ public sealed class OpcUaPublishActorTests : RuntimeActorTestBase
         }, duration: TimeSpan.FromMilliseconds(500));
     }
 
+    /// <summary>Verifies that AlarmStateUpdate routes to sink WriteAlarmState.</summary>
     [Fact]
     public void AlarmStateUpdate_routes_to_sink_WriteAlarmState()
     {
@@ -67,6 +71,7 @@ public sealed class OpcUaPublishActorTests : RuntimeActorTestBase
         }, duration: TimeSpan.FromMilliseconds(500));
     }
 
+    /// <summary>Verifies that RebuildAddressSpace calls sink Rebuild.</summary>
     [Fact]
     public void RebuildAddressSpace_calls_sink_Rebuild()
     {
@@ -78,6 +83,7 @@ public sealed class OpcUaPublishActorTests : RuntimeActorTestBase
         AwaitAssert(() => sink.RebuildCalls.ShouldBe(1), duration: TimeSpan.FromMilliseconds(500));
     }
 
+    /// <summary>Verifies that ServiceLevelChanged publishes to IServiceLevelPublisher once per unique level.</summary>
     [Fact]
     public void ServiceLevelChanged_publishes_to_IServiceLevelPublisher_once_per_unique_level()
     {
@@ -92,6 +98,7 @@ public sealed class OpcUaPublishActorTests : RuntimeActorTestBase
             duration: TimeSpan.FromMilliseconds(500));
     }
 
+    /// <summary>Verifies that RedundancyStateChanged drives local ServiceLevel publish for primary leader.</summary>
     [Fact]
     public void RedundancyStateChanged_drives_local_ServiceLevel_publish_for_primary_leader()
     {
@@ -115,6 +122,7 @@ public sealed class OpcUaPublishActorTests : RuntimeActorTestBase
             duration: TimeSpan.FromMilliseconds(500));
     }
 
+    /// <summary>Verifies that RedundancyStateChanged for secondary publishes 100.</summary>
     [Fact]
     public void RedundancyStateChanged_for_secondary_publishes_100()
     {
@@ -135,32 +143,57 @@ public sealed class OpcUaPublishActorTests : RuntimeActorTestBase
             duration: TimeSpan.FromMilliseconds(500));
     }
 
+    /// <summary>Test implementation of IOpcUaAddressSpaceSink that records calls.</summary>
     private sealed class RecordingSink : IOpcUaAddressSpaceSink
     {
+        /// <summary>Gets the queue of recorded value updates.</summary>
         public ConcurrentQueue<(string NodeId, object? Value, OpcUaQuality Quality, DateTime Ts)> ValueQueue { get; } = new();
+        /// <summary>Gets the queue of recorded alarm state updates.</summary>
         public ConcurrentQueue<(string AlarmNodeId, bool Active, bool Acknowledged, DateTime Ts)> AlarmQueue { get; } = new();
+        /// <summary>Count of rebuild calls.</summary>
         public int RebuildCalls;
 
+        /// <summary>Gets the list of recorded value updates.</summary>
         public List<(string NodeId, object? Value, OpcUaQuality Quality, DateTime Ts)> Values =>
             ValueQueue.ToList();
+        /// <summary>Gets the list of recorded alarm state updates.</summary>
         public List<(string AlarmNodeId, bool Active, bool Acknowledged, DateTime Ts)> Alarms =>
             AlarmQueue.ToList();
 
+        /// <summary>Records a value update.</summary>
+        /// <param name="nodeId">The OPC UA node identifier.</param>
+        /// <param name="value">The attribute value.</param>
+        /// <param name="quality">The OPC UA quality code.</param>
+        /// <param name="ts">The timestamp of the update.</param>
         public void WriteValue(string nodeId, object? value, OpcUaQuality quality, DateTime ts) =>
             ValueQueue.Enqueue((nodeId, value, quality, ts));
 
+        /// <summary>Records an alarm state update.</summary>
+        /// <param name="alarmNodeId">The OPC UA alarm node identifier.</param>
+        /// <param name="active">Whether the alarm is active.</param>
+        /// <param name="acknowledged">Whether the alarm is acknowledged.</param>
+        /// <param name="ts">The timestamp of the update.</param>
         public void WriteAlarmState(string alarmNodeId, bool active, bool acknowledged, DateTime ts) =>
             AlarmQueue.Enqueue((alarmNodeId, active, acknowledged, ts));
 
+        /// <summary>Ensures a folder exists (no-op in test).</summary>
+        /// <param name="folderNodeId">The OPC UA folder node identifier.</param>
+        /// <param name="parentNodeId">The parent folder node identifier, or null for root.</param>
+        /// <param name="displayName">The display name of the folder.</param>
         public void EnsureFolder(string folderNodeId, string? parentNodeId, string displayName) { }
 
+        /// <summary>Records a rebuild call.</summary>
         public void RebuildAddressSpace() => Interlocked.Increment(ref RebuildCalls);
     }
 
+    /// <summary>Test implementation of IServiceLevelPublisher that records publishes.</summary>
     private sealed class RecordingPublisher : IServiceLevelPublisher
     {
         private readonly ConcurrentQueue<byte> _q = new();
+        /// <summary>Gets the recorded service levels.</summary>
         public byte[] Levels => _q.ToArray();
+        /// <summary>Records a service level publish.</summary>
+        /// <param name="serviceLevel">The service level value to publish.</param>
         public void Publish(byte serviceLevel) => _q.Enqueue(serviceLevel);
     }
 }

tests/Server/ZB.MOM.WW.OtOpcUa.Runtime.Tests/OpcUa/ServiceLevelEndToEndTests.cs

@@ -24,6 +24,7 @@ public sealed class ServiceLevelEndToEndTests : RuntimeActorTestBase
 {
     private static CancellationToken Ct => CancellationToken.None;
 
+    /// <summary>Verifies that the primary cluster leader sets Server ServiceLevel to 240.</summary>
     [Fact]
     public async Task Primary_leader_drives_Server_ServiceLevel_to_240()
     {
@@ -63,6 +64,7 @@ public sealed class ServiceLevelEndToEndTests : RuntimeActorTestBase
         }
     }
 
+    /// <summary>Verifies that the secondary node sets Server ServiceLevel to 100.</summary>
     [Fact]
     public async Task Secondary_drives_Server_ServiceLevel_to_100()
     {