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.

src/Core/ZB.MOM.WW.OtOpcUa.Core/Resilience/AlarmSurfaceInvoker.cs

@@ -29,6 +29,11 @@ public sealed class AlarmSurfaceInvoker
     private readonly IPerCallHostResolver? _hostResolver;
     private readonly string _defaultHost;
 
+    /// <summary>Initializes a new instance of the AlarmSurfaceInvoker class.</summary>
+    /// <param name="invoker">The capability invoker for resilience pipeline.</param>
+    /// <param name="alarmSource">The alarm source to invoke.</param>
+    /// <param name="defaultHost">The default host name for single-host scenarios.</param>
+    /// <param name="hostResolver">Optional per-call host resolver for multi-host dispatch.</param>
     public AlarmSurfaceInvoker(
         CapabilityInvoker invoker,
         IAlarmSource alarmSource,
@@ -52,6 +57,8 @@ public sealed class AlarmSurfaceInvoker
     ///     the driver's opaque handle together with its resolved host so <see cref="UnsubscribeAsync"/>
     ///     routes through the same host's pipeline that the subscription was created on.
     /// </summary>
+    /// <param name="sourceNodeIds">The source node IDs to subscribe to.</param>
+    /// <param name="cancellationToken">The cancellation token.</param>
     public async Task<IReadOnlyList<IAlarmSubscriptionHandle>> SubscribeAsync(
         IReadOnlyList<string> sourceNodeIds,
         CancellationToken cancellationToken)
@@ -80,6 +87,8 @@ public sealed class AlarmSurfaceInvoker
     ///     handles not created by this invoker so the method remains safe to call on any
     ///     <see cref="IAlarmSubscriptionHandle"/> implementation.
     /// </summary>
+    /// <param name="handle">The subscription handle to unsubscribe.</param>
+    /// <param name="cancellationToken">The cancellation token.</param>
     public ValueTask UnsubscribeAsync(IAlarmSubscriptionHandle handle, CancellationToken cancellationToken)
     {
         ArgumentNullException.ThrowIfNull(handle);
@@ -99,6 +108,8 @@ public sealed class AlarmSurfaceInvoker
     ///     AlarmAcknowledge pipeline (no-retry per decision #143 — an alarm-ack is not idempotent
     ///     at the plant-floor acknowledgement level even if the OPC UA spec permits re-issue).
     /// </summary>
+    /// <param name="acknowledgements">The alarm acknowledgement requests.</param>
+    /// <param name="cancellationToken">The cancellation token.</param>
     public async Task AcknowledgeAsync(
         IReadOnlyList<AlarmAcknowledgeRequest> acknowledgements,
         CancellationToken cancellationToken)
@@ -139,6 +150,11 @@ public sealed class AlarmSurfaceInvoker
         return result;
     }
 
+    /// <summary>
+    ///     Wraps an <see cref="IAlarmSubscriptionHandle"/> returned by the driver with the
+    ///     resolved host name used when the subscription was created. <see cref="UnsubscribeAsync"/>
+    ///     unwraps this to route the unsubscribe through the same host's resilience pipeline.
+    /// </summary>
     /// <summary>
     ///     Wraps an <see cref="IAlarmSubscriptionHandle"/> returned by the driver with the
     ///     resolved host name used when the subscription was created. <see cref="UnsubscribeAsync"/>
@@ -146,8 +162,11 @@ public sealed class AlarmSurfaceInvoker
     /// </summary>
     private sealed class HostBoundHandle(IAlarmSubscriptionHandle inner, string host) : IAlarmSubscriptionHandle
     {
+        /// <summary>Gets the inner subscription handle.</summary>
         public IAlarmSubscriptionHandle Inner { get; } = inner;
+        /// <summary>Gets the resolved host name.</summary>
         public string Host { get; } = host;
+        /// <summary>Gets the diagnostic ID from the inner handle.</summary>
         public string DiagnosticId => Inner.DiagnosticId;
     }
 }