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/Drivers/ZB.MOM.WW.OtOpcUa.Driver.FOCAS/Wire/FocasWireClient.cs

@@ -46,6 +46,7 @@ public sealed class FocasWireClient : IAsyncDisposable, IDisposable
     ///     Construct a disconnected client. Optional <paramref name="logger"/> receives
     ///     <c>Debug</c>-level entries per response block (command ID, RC, payload length).
     /// </summary>
+    /// <param name="logger">Optional logger for debug-level wire protocol entries.</param>
     public FocasWireClient(ILogger<FocasWireClient>? logger = null)
     {
         _logger = logger;
@@ -65,6 +66,10 @@ public sealed class FocasWireClient : IAsyncDisposable, IDisposable
     ///     call while already connected is a no-op. Sub-second timeouts require the
     ///     <see cref="ConnectAsync(string, int, TimeSpan, CancellationToken)"/> overload.
     /// </summary>
+    /// <param name="host">The CNC hostname or IP address.</param>
+    /// <param name="port">The FOCAS/2 TCP port (typically 8193).</param>
+    /// <param name="timeoutSeconds">Connection timeout in seconds; zero or negative disables the timeout.</param>
+    /// <param name="cancellationToken">Cancellation token for the connect operation.</param>
     public Task ConnectAsync(
         string host,
         int port,
@@ -81,6 +86,10 @@ public sealed class FocasWireClient : IAsyncDisposable, IDisposable
     ///     <see cref="TimeSpan.Zero"/> to disable the timeout entirely (rely on the caller's
     ///     <paramref name="cancellationToken"/> instead). Idempotent.
     /// </summary>
+    /// <param name="host">The CNC hostname or IP address.</param>
+    /// <param name="port">The FOCAS/2 TCP port (typically 8193).</param>
+    /// <param name="timeout">Connection timeout duration; <see cref="TimeSpan.Zero"/> disables the timeout.</param>
+    /// <param name="cancellationToken">Cancellation token for the connect operation.</param>
     public Task ConnectAsync(
         string host,
         int port,
@@ -206,6 +215,9 @@ public sealed class FocasWireClient : IAsyncDisposable, IDisposable
     ///     Read CNC identity via <c>cnc_sysinfo</c>. Cached from the connect-time exchange
     ///     unless a per-call <paramref name="pathId"/> override is supplied.
     /// </summary>
+    /// <param name="cancellationToken">Cancellation token for the read operation.</param>
+    /// <param name="timeout">Optional per-call timeout override.</param>
+    /// <param name="pathId">Optional path ID override; defaults to <see cref="PathId"/>.</param>
     public async Task<FocasResult<WireSysInfo>> ReadSysInfoAsync(
         CancellationToken cancellationToken = default,
         TimeSpan? timeout = null,
@@ -218,6 +230,9 @@ public sealed class FocasWireClient : IAsyncDisposable, IDisposable
     }
 
     /// <summary>Read CNC status bits via <c>cnc_statinfo</c> (3 command blocks aggregated into one <see cref="WireStatus"/>).</summary>
+    /// <param name="cancellationToken">Cancellation token for the read operation.</param>
+    /// <param name="timeout">Optional per-call timeout override.</param>
+    /// <param name="pathId">Optional path ID override; defaults to <see cref="PathId"/>.</param>
     public async Task<FocasResult<WireStatus>> ReadStatusAsync(
         CancellationToken cancellationToken = default,
         TimeSpan? timeout = null,
@@ -253,6 +268,10 @@ public sealed class FocasWireClient : IAsyncDisposable, IDisposable
     }
 
     /// <summary>Read configured axis names via <c>cnc_rdaxisname</c> (command <c>0x0089</c>).</summary>
+    /// <param name="maxCount">Maximum number of axis records to return.</param>
+    /// <param name="cancellationToken">Cancellation token for the read operation.</param>
+    /// <param name="timeout">Optional per-call timeout override.</param>
+    /// <param name="pathId">Optional path ID override; defaults to <see cref="PathId"/>.</param>
     public async Task<FocasResult<IReadOnlyList<WireAxisRecord>>> ReadAxisNamesAsync(
         short maxCount = 32,
         CancellationToken cancellationToken = default,
@@ -265,6 +284,10 @@ public sealed class FocasWireClient : IAsyncDisposable, IDisposable
     }
 
     /// <summary>Read configured spindle names via <c>cnc_rdspdlname</c> (command <c>0x008a</c>).</summary>
+    /// <param name="maxCount">Maximum number of spindle records to return.</param>
+    /// <param name="cancellationToken">Cancellation token for the read operation.</param>
+    /// <param name="timeout">Optional per-call timeout override.</param>
+    /// <param name="pathId">Optional path ID override; defaults to <see cref="PathId"/>.</param>
     public async Task<FocasResult<IReadOnlyList<WireSpindleRecord>>> ReadSpindleNamesAsync(
         short maxCount = 8,
         CancellationToken cancellationToken = default,
@@ -281,6 +304,10 @@ public sealed class FocasWireClient : IAsyncDisposable, IDisposable
     ///     one PDU and aggregates the replies — alarm flags, program/sequence numbers, feed
     ///     and spindle actuals, plus the four-slot position quadruple.
     /// </summary>
+    /// <param name="axis">The axis number to read from.</param>
+    /// <param name="cancellationToken">Cancellation token for the read operation.</param>
+    /// <param name="timeout">Optional per-call timeout override.</param>
+    /// <param name="pathId">Optional path ID override; defaults to <see cref="PathId"/>.</param>
     public async Task<FocasResult<WireDynamic>> ReadDynamic2Async(
         short axis = 1,
         CancellationToken cancellationToken = default,
@@ -322,6 +349,10 @@ public sealed class FocasWireClient : IAsyncDisposable, IDisposable
     }
 
     /// <summary>Read servo-meter load percentages via <c>cnc_rdsvmeter</c> (command <c>0x0056</c>).</summary>
+    /// <param name="maxCount">Maximum number of servo meter records to return.</param>
+    /// <param name="cancellationToken">Cancellation token for the read operation.</param>
+    /// <param name="timeout">Optional per-call timeout override.</param>
+    /// <param name="pathId">Optional path ID override; defaults to <see cref="PathId"/>.</param>
     public async Task<FocasResult<IReadOnlyList<WireServoMeter>>> ReadServoMeterAsync(
         short maxCount = 32,
         CancellationToken cancellationToken = default,
@@ -355,6 +386,10 @@ public sealed class FocasWireClient : IAsyncDisposable, IDisposable
     }
 
     /// <summary>Read per-spindle load percentages via <c>cnc_rdspload</c> (command <c>0x0040</c> with arg1=0).</summary>
+    /// <param name="spindleSelector">Spindle selector; -1 selects all spindles.</param>
+    /// <param name="cancellationToken">Cancellation token for the read operation.</param>
+    /// <param name="timeout">Optional per-call timeout override.</param>
+    /// <param name="pathId">Optional path ID override; defaults to <see cref="PathId"/>.</param>
     public Task<FocasResult<IReadOnlyList<WireSpindleMetric>>> ReadSpindleLoadAsync(
         short spindleSelector = -1,
         CancellationToken cancellationToken = default,
@@ -363,6 +398,10 @@ public sealed class FocasWireClient : IAsyncDisposable, IDisposable
         => ReadSpindleMetricAsync(0, spindleSelector, cancellationToken, timeout, pathId);
 
     /// <summary>Read per-spindle maximum RPMs via <c>cnc_rdspmaxrpm</c> (command <c>0x0040</c> with arg1=1).</summary>
+    /// <param name="spindleSelector">Spindle selector; -1 selects all spindles.</param>
+    /// <param name="cancellationToken">Cancellation token for the read operation.</param>
+    /// <param name="timeout">Optional per-call timeout override.</param>
+    /// <param name="pathId">Optional path ID override; defaults to <see cref="PathId"/>.</param>
     public Task<FocasResult<IReadOnlyList<WireSpindleMetric>>> ReadSpindleMaxRpmAsync(
         short spindleSelector = -1,
         CancellationToken cancellationToken = default,
@@ -375,6 +414,11 @@ public sealed class FocasWireClient : IAsyncDisposable, IDisposable
     ///     payload to the type declared in the per-series parameter catalog. <paramref name="axis"/>
     ///     selects an axis-scoped parameter; <c>0</c> means global.
     /// </summary>
+    /// <param name="dataNumber">The parameter data number.</param>
+    /// <param name="axis">Axis selector; zero means a global parameter.</param>
+    /// <param name="cancellationToken">Cancellation token for the read operation.</param>
+    /// <param name="timeout">Optional per-call timeout override.</param>
+    /// <param name="pathId">Optional path ID override; defaults to <see cref="PathId"/>.</param>
     public async Task<FocasResult<byte[]>> ReadParameterBytesAsync(
         short dataNumber,
         short axis = 0,
@@ -389,6 +433,11 @@ public sealed class FocasWireClient : IAsyncDisposable, IDisposable
     }
 
     /// <summary>Typed Int32 parameter read — convenience over <see cref="ReadParameterBytesAsync"/>.</summary>
+    /// <param name="dataNumber">The parameter data number.</param>
+    /// <param name="type">The FOCAS parameter type code.</param>
+    /// <param name="cancellationToken">Cancellation token for the read operation.</param>
+    /// <param name="timeout">Optional per-call timeout override.</param>
+    /// <param name="pathId">Optional path ID override; defaults to <see cref="PathId"/>.</param>
     public async Task<FocasResult<WireParameter>> ReadParameterAsync(
         short dataNumber,
         short type = 0,
@@ -404,6 +453,11 @@ public sealed class FocasWireClient : IAsyncDisposable, IDisposable
     }
 
     /// <summary>Typed 8-bit parameter read.</summary>
+    /// <param name="dataNumber">The parameter data number.</param>
+    /// <param name="axis">Axis selector; zero means a global parameter.</param>
+    /// <param name="cancellationToken">Cancellation token for the read operation.</param>
+    /// <param name="timeout">Optional per-call timeout override.</param>
+    /// <param name="pathId">Optional path ID override; defaults to <see cref="PathId"/>.</param>
     public async Task<FocasResult<byte>> ReadParameterByteAsync(short dataNumber, short axis = 0, CancellationToken cancellationToken = default, TimeSpan? timeout = null, ushort? pathId = null)
     {
         var result = await ReadParameterBytesAsync(dataNumber, axis, cancellationToken, timeout, pathId).ConfigureAwait(false);
@@ -413,6 +467,11 @@ public sealed class FocasWireClient : IAsyncDisposable, IDisposable
     }
 
     /// <summary>Typed 16-bit parameter read.</summary>
+    /// <param name="dataNumber">The parameter data number.</param>
+    /// <param name="axis">Axis selector; zero means a global parameter.</param>
+    /// <param name="cancellationToken">Cancellation token for the read operation.</param>
+    /// <param name="timeout">Optional per-call timeout override.</param>
+    /// <param name="pathId">Optional path ID override; defaults to <see cref="PathId"/>.</param>
     public async Task<FocasResult<short>> ReadParameterInt16Async(short dataNumber, short axis = 0, CancellationToken cancellationToken = default, TimeSpan? timeout = null, ushort? pathId = null)
     {
         var result = await ReadParameterBytesAsync(dataNumber, axis, cancellationToken, timeout, pathId).ConfigureAwait(false);
@@ -422,6 +481,11 @@ public sealed class FocasWireClient : IAsyncDisposable, IDisposable
     }
 
     /// <summary>Typed 32-bit parameter read.</summary>
+    /// <param name="dataNumber">The parameter data number.</param>
+    /// <param name="axis">Axis selector; zero means a global parameter.</param>
+    /// <param name="cancellationToken">Cancellation token for the read operation.</param>
+    /// <param name="timeout">Optional per-call timeout override.</param>
+    /// <param name="pathId">Optional path ID override; defaults to <see cref="PathId"/>.</param>
     public async Task<FocasResult<int>> ReadParameterInt32Async(short dataNumber, short axis = 0, CancellationToken cancellationToken = default, TimeSpan? timeout = null, ushort? pathId = null)
     {
         var result = await ReadParameterBytesAsync(dataNumber, axis, cancellationToken, timeout, pathId).ConfigureAwait(false);
@@ -431,6 +495,11 @@ public sealed class FocasWireClient : IAsyncDisposable, IDisposable
     }
 
     /// <summary>Typed IEEE-754 single-precision parameter read.</summary>
+    /// <param name="dataNumber">The parameter data number.</param>
+    /// <param name="axis">Axis selector; zero means a global parameter.</param>
+    /// <param name="cancellationToken">Cancellation token for the read operation.</param>
+    /// <param name="timeout">Optional per-call timeout override.</param>
+    /// <param name="pathId">Optional path ID override; defaults to <see cref="PathId"/>.</param>
     public async Task<FocasResult<float>> ReadParameterFloat32Async(short dataNumber, short axis = 0, CancellationToken cancellationToken = default, TimeSpan? timeout = null, ushort? pathId = null)
     {
         var result = await ReadParameterBytesAsync(dataNumber, axis, cancellationToken, timeout, pathId).ConfigureAwait(false);
@@ -440,6 +509,11 @@ public sealed class FocasWireClient : IAsyncDisposable, IDisposable
     }
 
     /// <summary>Typed IEEE-754 double-precision parameter read.</summary>
+    /// <param name="dataNumber">The parameter data number.</param>
+    /// <param name="axis">Axis selector; zero means a global parameter.</param>
+    /// <param name="cancellationToken">Cancellation token for the read operation.</param>
+    /// <param name="timeout">Optional per-call timeout override.</param>
+    /// <param name="pathId">Optional path ID override; defaults to <see cref="PathId"/>.</param>
     public async Task<FocasResult<double>> ReadParameterFloat64Async(short dataNumber, short axis = 0, CancellationToken cancellationToken = default, TimeSpan? timeout = null, ushort? pathId = null)
     {
         var result = await ReadParameterBytesAsync(dataNumber, axis, cancellationToken, timeout, pathId).ConfigureAwait(false);
@@ -449,6 +523,10 @@ public sealed class FocasWireClient : IAsyncDisposable, IDisposable
     }
 
     /// <summary>Read a single macro variable via <c>cnc_rdmacro</c> (command <c>0x0015</c>).</summary>
+    /// <param name="number">The macro variable number.</param>
+    /// <param name="cancellationToken">Cancellation token for the read operation.</param>
+    /// <param name="timeout">Optional per-call timeout override.</param>
+    /// <param name="pathId">Optional path ID override; defaults to <see cref="PathId"/>.</param>
     public Task<FocasResult<WireMacro>> ReadMacroAsync(
         short number,
         CancellationToken cancellationToken = default,
@@ -465,6 +543,13 @@ public sealed class FocasWireClient : IAsyncDisposable, IDisposable
     ///     is the width code (see <see cref="FocasPmcDataType"/>). Payload is decoded into
     ///     <see cref="WirePmcRange.Values"/> — one entry per slot of the requested width.
     /// </summary>
+    /// <param name="area">The PMC address-letter code numeric value.</param>
+    /// <param name="dataType">The PMC data width code numeric value.</param>
+    /// <param name="start">The starting address.</param>
+    /// <param name="end">The ending address; must be greater than or equal to start.</param>
+    /// <param name="cancellationToken">Cancellation token for the read operation.</param>
+    /// <param name="timeout">Optional per-call timeout override.</param>
+    /// <param name="pathId">Optional path ID override; defaults to <see cref="PathId"/>.</param>
     public async Task<FocasResult<WirePmcRange>> ReadPmcRangeAsync(
         short area,
         short dataType,
@@ -510,6 +595,13 @@ public sealed class FocasWireClient : IAsyncDisposable, IDisposable
     }
 
     /// <summary>Typed overload for <see cref="ReadPmcRangeAsync(short, short, ushort, ushort, CancellationToken, TimeSpan?, ushort?)"/>.</summary>
+    /// <param name="area">The PMC address-letter code.</param>
+    /// <param name="dataType">The PMC data width code.</param>
+    /// <param name="start">The starting address.</param>
+    /// <param name="end">The ending address; must be greater than or equal to start.</param>
+    /// <param name="cancellationToken">Cancellation token for the read operation.</param>
+    /// <param name="timeout">Optional per-call timeout override.</param>
+    /// <param name="pathId">Optional path ID override; defaults to <see cref="PathId"/>.</param>
     public Task<FocasResult<WirePmcRange>> ReadPmcRangeAsync(
         FocasPmcArea area,
         FocasPmcDataType dataType,
@@ -525,6 +617,11 @@ public sealed class FocasWireClient : IAsyncDisposable, IDisposable
     ///     the 76-byte vendor <c>ODBALMMSG2_data</c> layout and the 80-byte legacy wire
     ///     shape so the same managed surface works across firmware revisions.
     /// </summary>
+    /// <param name="type">Alarm type filter; -1 reads all active alarms.</param>
+    /// <param name="count">Maximum number of alarms to return.</param>
+    /// <param name="cancellationToken">Cancellation token for the read operation.</param>
+    /// <param name="timeout">Optional per-call timeout override.</param>
+    /// <param name="pathId">Optional path ID override; defaults to <see cref="PathId"/>.</param>
     public async Task<FocasResult<IReadOnlyList<WireAlarm>>> ReadAlarmsAsync(
         short type = -1,
         short count = 32,
@@ -541,6 +638,9 @@ public sealed class FocasWireClient : IAsyncDisposable, IDisposable
     }
 
     /// <summary>Read operation mode via <c>cnc_rdopmode</c>, returned as the typed <see cref="FocasOperationMode"/>.</summary>
+    /// <param name="cancellationToken">Cancellation token for the read operation.</param>
+    /// <param name="timeout">Optional per-call timeout override.</param>
+    /// <param name="pathId">Optional path ID override; defaults to <see cref="PathId"/>.</param>
     public Task<FocasResult<FocasOperationMode>> ReadOperationModeAsync(
         CancellationToken cancellationToken = default,
         TimeSpan? timeout = null,
@@ -555,6 +655,9 @@ public sealed class FocasWireClient : IAsyncDisposable, IDisposable
     ///     FOCAS <c>short</c> so callers storing the raw mode code (e.g. OtOpcUa's
     ///     <c>FocasProgramInfo.Mode</c> int field) don't have to cast the enum.
     /// </summary>
+    /// <param name="cancellationToken">Cancellation token for the read operation.</param>
+    /// <param name="timeout">Optional per-call timeout override.</param>
+    /// <param name="pathId">Optional path ID override; defaults to <see cref="PathId"/>.</param>
     public Task<FocasResult<short>> ReadOperationModeCodeAsync(
         CancellationToken cancellationToken = default,
         TimeSpan? timeout = null,
@@ -565,6 +668,9 @@ public sealed class FocasWireClient : IAsyncDisposable, IDisposable
             cancellationToken, timeout, EffectivePathId(pathId));
 
     /// <summary>Read the currently-executing program name + O-number via <c>cnc_exeprgname2</c> (command <c>0x00fc</c>).</summary>
+    /// <param name="cancellationToken">Cancellation token for the read operation.</param>
+    /// <param name="timeout">Optional per-call timeout override.</param>
+    /// <param name="pathId">Optional path ID override; defaults to <see cref="PathId"/>.</param>
     public Task<FocasResult<WireProgramName>> ReadExecutingProgramNameAsync(
         CancellationToken cancellationToken = default,
         TimeSpan? timeout = null,
@@ -572,6 +678,9 @@ public sealed class FocasWireClient : IAsyncDisposable, IDisposable
         => ReadSingleWithTimeoutAsync(0x00fc, ParseProgramName, cancellationToken, timeout, EffectivePathId(pathId));
 
     /// <summary>Read the executed block count via <c>cnc_rdblkcount</c>.</summary>
+    /// <param name="cancellationToken">Cancellation token for the read operation.</param>
+    /// <param name="timeout">Optional per-call timeout override.</param>
+    /// <param name="pathId">Optional path ID override; defaults to <see cref="PathId"/>.</param>
     public Task<FocasResult<int>> ReadBlockCountAsync(
         CancellationToken cancellationToken = default,
         TimeSpan? timeout = null,
@@ -585,6 +694,10 @@ public sealed class FocasWireClient : IAsyncDisposable, IDisposable
     ///     Read one cumulative timer via <c>cnc_rdtimer</c>. <paramref name="type"/> selects
     ///     PowerOn / Operating / Cutting / Cycle per the FOCAS spec (0..3).
     /// </summary>
+    /// <param name="type">Timer type selector (0=PowerOn, 1=Operating, 2=Cutting, 3=Cycle).</param>
+    /// <param name="cancellationToken">Cancellation token for the read operation.</param>
+    /// <param name="timeout">Optional per-call timeout override.</param>
+    /// <param name="pathId">Optional path ID override; defaults to <see cref="PathId"/>.</param>
     public Task<FocasResult<WireTimer>> ReadTimerAsync(
         short type,
         CancellationToken cancellationToken = default,