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.OpcUaServer.Tests/Phase7ApplierTests.cs

@@ -8,6 +8,7 @@ namespace ZB.MOM.WW.OtOpcUa.OpcUaServer.Tests;
 
 public sealed class Phase7ApplierTests
 {
+    /// <summary>Verifies that an empty plan does not call the sink or trigger a rebuild.</summary>
     [Fact]
     public void Empty_plan_does_not_call_sink_and_does_not_trigger_rebuild()
     {
@@ -24,6 +25,7 @@ public sealed class Phase7ApplierTests
         sink.AlarmWrites.ShouldBeEmpty();
     }
 
+    /// <summary>Verifies that removed equipment writes inactive alarm state and triggers rebuild.</summary>
     [Fact]
     public void Removed_equipment_writes_inactive_alarm_state_per_id_and_triggers_rebuild()
     {
@@ -40,6 +42,7 @@ public sealed class Phase7ApplierTests
         sink.RebuildCalls.ShouldBe(1);
     }
 
+    /// <summary>Verifies that added equipment triggers rebuild without writing alarm state.</summary>
     [Fact]
     public void Added_equipment_triggers_rebuild_without_alarm_writes()
     {
@@ -65,6 +68,7 @@ public sealed class Phase7ApplierTests
         sink.RebuildCalls.ShouldBe(1);
     }
 
+    /// <summary>Verifies that driver-only changes do not trigger address space rebuild.</summary>
     [Fact]
     public void Driver_only_changes_do_not_trigger_address_space_rebuild()
     {
@@ -93,6 +97,7 @@ public sealed class Phase7ApplierTests
         sink.RebuildCalls.ShouldBe(0);
     }
 
+    /// <summary>Verifies that sink exceptions in WriteAlarmState do not propagate and rebuild still fires.</summary>
     [Fact]
     public void Sink_exception_in_WriteAlarmState_does_not_propagate_and_rebuild_still_fires()
     {
@@ -124,32 +129,70 @@ public sealed class Phase7ApplierTests
 
     private sealed class RecordingSink : IOpcUaAddressSpaceSink
     {
+        /// <summary>Gets the queue of alarm state write calls.</summary>
         public ConcurrentQueue<(string NodeId, bool Active, bool Acknowledged)> AlarmQueue { get; } = new();
+        /// <summary>Gets the queue of folder creation calls.</summary>
         public ConcurrentQueue<(string NodeId, string? Parent, string DisplayName)> FolderQueue { get; } = new();
+        /// <summary>Gets the number of rebuild calls made on this sink.</summary>
         public int RebuildCalls;
 
+        /// <summary>Gets the list of recorded alarm writes.</summary>
         public List<(string NodeId, bool Active, bool Acknowledged)> AlarmWrites => AlarmQueue.ToList();
+        /// <summary>Gets the list of recorded folder creation calls.</summary>
         public List<(string NodeId, string? Parent, string DisplayName)> FolderCalls => FolderQueue.ToList();
 
+        /// <summary>Records a value write (no-op in this recording sink).</summary>
+        /// <param name="nodeId">The node ID.</param>
+        /// <param name="value">The value to write.</param>
+        /// <param name="quality">The OPC UA quality.</param>
+        /// <param name="sourceTimestampUtc">The source timestamp in UTC.</param>
         public void WriteValue(string nodeId, object? value, OpcUaQuality quality, DateTime sourceTimestampUtc) { }
+        /// <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="sourceTimestampUtc">The source timestamp in UTC.</param>
         public void WriteAlarmState(string alarmNodeId, bool active, bool acknowledged, DateTime sourceTimestampUtc)
             => AlarmQueue.Enqueue((alarmNodeId, active, acknowledged));
+        /// <summary>Records a folder creation call.</summary>
+        /// <param name="folderNodeId">The folder node ID.</param>
+        /// <param name="parentNodeId">The parent folder node ID, if any.</param>
+        /// <param name="displayName">The display name for the folder.</param>
         public void EnsureFolder(string folderNodeId, string? parentNodeId, string displayName)
             => FolderQueue.Enqueue((folderNodeId, parentNodeId, displayName));
+        /// <summary>Records a rebuild address space call.</summary>
         public void RebuildAddressSpace() => Interlocked.Increment(ref RebuildCalls);
     }
 
     private sealed class ThrowingSink : IOpcUaAddressSpaceSink
     {
         private readonly bool _throwOnAlarmWrite;
+        /// <summary>Initializes a new instance of the ThrowingSink class.</summary>
+        /// <param name="throwOnAlarmWrite">Whether to throw on alarm state writes.</param>
         public ThrowingSink(bool throwOnAlarmWrite) { _throwOnAlarmWrite = throwOnAlarmWrite; }
 
+        /// <summary>Records a value write (no-op in this sink).</summary>
+        /// <param name="nodeId">The node ID.</param>
+        /// <param name="value">The value to write.</param>
+        /// <param name="quality">The OPC UA quality.</param>
+        /// <param name="sourceTimestampUtc">The source timestamp in UTC.</param>
         public void WriteValue(string nodeId, object? value, OpcUaQuality quality, DateTime sourceTimestampUtc) { }
+        /// <summary>Throws an exception if configured to do so.</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="sourceTimestampUtc">The source timestamp in UTC.</param>
+        /// <exception cref="InvalidOperationException">Thrown when configured to throw on alarm write.</exception>
         public void WriteAlarmState(string alarmNodeId, bool active, bool acknowledged, DateTime sourceTimestampUtc)
         {
             if (_throwOnAlarmWrite) throw new InvalidOperationException("simulated sink fault");
         }
+        /// <summary>No-op folder creation call.</summary>
+        /// <param name="folderNodeId">The folder node ID.</param>
+        /// <param name="parentNodeId">The parent folder node ID, if any.</param>
+        /// <param name="displayName">The display name for the folder.</param>
         public void EnsureFolder(string folderNodeId, string? parentNodeId, string displayName) { }
+        /// <summary>No-op rebuild address space call.</summary>
         public void RebuildAddressSpace() { }
     }
 }