docs: complete XML doc comments via fixdocs (2757 to 131 findings)

Add missing <returns>/<param>/<summary>/<typeparam> tags and clean up
misused inheritdoc across 481 files so the documented API surface is
complete. Documentation-only (zero code lines changed). The 131 remaining
findings are inheritdoc-style warnings deliberately left to preserve
hand-written implementation rationale (plan-decision notes, race-condition
explanations).

tests/Drivers/ZB.MOM.WW.OtOpcUa.Driver.Galaxy.Tests/Runtime/ReconnectSupervisorTests.cs

@@ -28,6 +28,7 @@ public sealed class ReconnectSupervisorTests
     }
 
     /// <summary>Verifies that reporting a transport failure drives the supervisor through reopen and replay cycles back to healthy.</summary>
+    /// <returns>A task that represents the asynchronous operation.</returns>
     [Fact]
     public async Task ReportTransportFailure_DrivesThroughReopenReplay_BackToHealthy()
     {
@@ -57,6 +58,7 @@ public sealed class ReconnectSupervisorTests
     }
 
     /// <summary>Verifies that reopen failures trigger retries and the supervisor stays in reopening state between attempts.</summary>
+    /// <returns>A task that represents the asynchronous operation.</returns>
     [Fact]
     public async Task ReopenFailure_RetriesUntilSuccess_StaysInReopeningBetweenAttempts()
     {
@@ -75,6 +77,7 @@ public sealed class ReconnectSupervisorTests
     }
 
     /// <summary>Verifies that replay failures trigger a retry of the entire reopen-replay cycle.</summary>
+    /// <returns>A task that represents the asynchronous operation.</returns>
     [Fact]
     public async Task ReplayFailure_RetriesEntireCycle()
     {
@@ -95,6 +98,7 @@ public sealed class ReconnectSupervisorTests
     }
 
     /// <summary>Verifies that repeated failure reports during recovery do not spawn parallel recovery loops.</summary>
+    /// <returns>A task that represents the asynchronous operation.</returns>
     [Fact]
     public async Task RepeatedFailureReports_DuringRecovery_DoNotSpawnParallelLoops()
     {
@@ -122,6 +126,7 @@ public sealed class ReconnectSupervisorTests
     }
 
     /// <summary>Verifies that the last error reflects the most recent failure cause from recovery attempts.</summary>
+    /// <returns>A task that represents the asynchronous operation.</returns>
     [Fact]
     public async Task LastError_ReflectsMostRecentFailureCause()
     {
@@ -141,6 +146,7 @@ public sealed class ReconnectSupervisorTests
     }
 
     /// <summary>Verifies that disposing the supervisor cancels a running recovery loop cleanly.</summary>
+    /// <returns>A task that represents the asynchronous operation.</returns>
     [Fact]
     public async Task Dispose_CancelsRunningRecoveryLoop_Cleanly()
     {
@@ -170,6 +176,7 @@ public sealed class ReconnectSupervisorTests
     }
 
     /// <summary>Verifies that waiting for healthy state returns immediately when already healthy.</summary>
+    /// <returns>A task that represents the asynchronous operation.</returns>
     [Fact]
     public async Task WaitForHealthy_ReturnsImmediately_WhenAlreadyHealthy()
     {