docs(xmldoc): fill missing XML docs + strip tracking-ID comments across src

Adds <summary>/<param>/<returns>/<inheritdoc> where missing and removes
project bookkeeping IDs (task/tracking refs) from shipped code comments,
so the docs read cleanly and CommentChecker is quiet except for known
false positives (PLC/protocol terms, event/IEqualityComparer inheritdoc).
Doc/comment-only; no logic changed; solution builds clean.

src/Drivers/ZB.MOM.WW.OtOpcUa.Driver.FOCAS/IFocasClient.cs

@@ -20,6 +20,7 @@ public interface IFocasClient : IDisposable
     /// <param name="address">The CNC host address and port.</param>
     /// <param name="timeout">The connection timeout duration.</param>
     /// <param name="cancellationToken">The cancellation token.</param>
+    /// <returns>A task that represents the asynchronous operation.</returns>
     Task ConnectAsync(FocasHostAddress address, TimeSpan timeout, CancellationToken cancellationToken);
 
     /// <summary>True when the FWLIB handle is valid + the socket is up.</summary>
@@ -33,6 +34,7 @@ public interface IFocasClient : IDisposable
     /// <param name="address">The CNC memory address to read from.</param>
     /// <param name="type">The FOCAS data type to read.</param>
     /// <param name="cancellationToken">The cancellation token.</param>
+    /// <returns>A tuple of the boxed value read and the mapped OPC UA status code.</returns>
     Task<(object? value, uint status)> ReadAsync(
         FocasAddress address,
         FocasDataType type,
@@ -46,6 +48,7 @@ public interface IFocasClient : IDisposable
     /// <param name="type">The FOCAS data type to write.</param>
     /// <param name="value">The value to write.</param>
     /// <param name="cancellationToken">The cancellation token.</param>
+    /// <returns>The mapped OPC UA status code (0 = Good).</returns>
     Task<uint> WriteAsync(
         FocasAddress address,
         FocasDataType type,
@@ -57,6 +60,7 @@ public interface IFocasClient : IDisposable
     ///     responds with any valid status.
     /// </summary>
     /// <param name="cancellationToken">The cancellation token.</param>
+    /// <returns><c>true</c> when the CNC responds with a valid status; otherwise <c>false</c>.</returns>
     Task<bool> ProbeAsync(CancellationToken cancellationToken);
 
     /// <summary>
@@ -66,6 +70,7 @@ public interface IFocasClient : IDisposable
     ///     emits transitions (raise / clear) on the driver's <c>OnAlarmEvent</c>.
     /// </summary>
     /// <param name="cancellationToken">The cancellation token.</param>
+    /// <returns>The list of currently active alarms; empty when none are active.</returns>
     Task<IReadOnlyList<FocasActiveAlarm>> ReadAlarmsAsync(CancellationToken cancellationToken);
 
     // ---- Fixed-tree T1 (identity + axis discovery + fast-poll dynamic bundle) ----
@@ -76,6 +81,7 @@ public interface IFocasClient : IDisposable
     ///     values don't change across the session.
     /// </summary>
     /// <param name="cancellationToken">The cancellation token.</param>
+    /// <returns>The CNC identity snapshot.</returns>
     Task<FocasSysInfo> GetSysInfoAsync(CancellationToken cancellationToken);
 
     /// <summary>
@@ -84,6 +90,7 @@ public interface IFocasClient : IDisposable
     ///     <see cref="ReadDynamicAsync"/> calls.
     /// </summary>
     /// <param name="cancellationToken">The cancellation token.</param>
+    /// <returns>The CNC's configured axis names.</returns>
     Task<IReadOnlyList<FocasAxisName>> GetAxisNamesAsync(CancellationToken cancellationToken);
 
     /// <summary>
@@ -91,6 +98,7 @@ public interface IFocasClient : IDisposable
     ///     the <c>Spindle/{name}/</c> subtree.
     /// </summary>
     /// <param name="cancellationToken">The cancellation token.</param>
+    /// <returns>The CNC's configured spindle names.</returns>
     Task<IReadOnlyList<FocasSpindleName>> GetSpindleNamesAsync(CancellationToken cancellationToken);
 
     /// <summary>
@@ -101,6 +109,7 @@ public interface IFocasClient : IDisposable
     /// </summary>
     /// <param name="axisIndex">The axis index to read dynamics for.</param>
     /// <param name="cancellationToken">The cancellation token.</param>
+    /// <returns>The fast-poll dynamic bundle for the requested axis.</returns>
     Task<FocasDynamicSnapshot> ReadDynamicAsync(int axisIndex, CancellationToken cancellationToken);
 
     // ---- Fixed-tree T2 (program + operation mode) ----
@@ -113,6 +122,7 @@ public interface IFocasClient : IDisposable
     ///     on human-operator timescales.
     /// </summary>
     /// <param name="cancellationToken">The cancellation token.</param>
+    /// <returns>The aggregate program + operation-mode snapshot.</returns>
     Task<FocasProgramInfo> GetProgramInfoAsync(CancellationToken cancellationToken);
 
     // ---- Fixed-tree T3 (timers) ----
@@ -124,6 +134,7 @@ public interface IFocasClient : IDisposable
     /// </summary>
     /// <param name="kind">The timer kind to read.</param>
     /// <param name="cancellationToken">The cancellation token.</param>
+    /// <returns>The requested cumulative timer reading.</returns>
     Task<FocasTimer> GetTimerAsync(FocasTimerKind kind, CancellationToken cancellationToken);
 
     // ---- Fixed-tree T3.5 (servo meters) ----
@@ -134,6 +145,7 @@ public interface IFocasClient : IDisposable
     ///     disconnected session or unsupported CNC.
     /// </summary>
     /// <param name="cancellationToken">The cancellation token.</param>
+    /// <returns>The servo-load meter percentages across all configured axes.</returns>
     Task<IReadOnlyList<FocasServoLoad>> GetServoLoadsAsync(CancellationToken cancellationToken);
 
     // ---- Fixed-tree T3.6 (spindle meters) ----
@@ -145,6 +157,7 @@ public interface IFocasClient : IDisposable
     ///     series like 16i may return EW_FUNC).
     /// </summary>
     /// <param name="cancellationToken">The cancellation token.</param>
+    /// <returns>Per-spindle load percentages, indexed as per <see cref="GetSpindleNamesAsync"/>.</returns>
     Task<IReadOnlyList<int>> GetSpindleLoadsAsync(CancellationToken cancellationToken);
 
     /// <summary>
@@ -152,6 +165,7 @@ public interface IFocasClient : IDisposable
     ///     bootstrap. Index alignment as per <see cref="GetSpindleLoadsAsync"/>.
     /// </summary>
     /// <param name="cancellationToken">The cancellation token.</param>
+    /// <returns>Per-spindle maximum RPM values, indexed as per <see cref="GetSpindleLoadsAsync"/>.</returns>
     Task<IReadOnlyList<int>> GetSpindleMaxRpmsAsync(CancellationToken cancellationToken);
 
     /// <summary>
@@ -161,6 +175,7 @@ public interface IFocasClient : IDisposable
     ///     <c>PositionDecimalPlaces</c>. Values are clamped non-negative.
     /// </summary>
     /// <param name="cancellationToken">The cancellation token.</param>
+    /// <returns>Per-axis position decimal-place figures; empty when the CNC/backend doesn't report them.</returns>
     Task<IReadOnlyList<int>> GetPositionFiguresAsync(CancellationToken cancellationToken);
 }
 
@@ -317,17 +332,10 @@ public sealed class UnimplementedFocasClientFactory : IFocasClientFactory
         "FOCAS driver backend is 'unimplemented'. Switch to 'Backend: \"wire\"' in driver config " +
         "once the CNC is provisioned — see docs/drivers/FOCAS.md.";
 
-    /// <summary>
-    ///     Config-time probe — throws immediately so <see cref="FocasDriver.InitializeAsync"/>
-    ///     faults the driver before any background loops start. This prevents the footgun where
-    ///     the driver appears Healthy at init but every read/write/subscribe fails.
-    /// </summary>
-    /// <exception cref="NotSupportedException">Always thrown.</exception>
+    /// <inheritdoc />
     public void EnsureUsable() => throw new NotSupportedException(Message);
 
-    /// <summary>Creates a new client instance (always throws NotSupportedException).</summary>
-    /// <returns>Never returns; always throws NotSupportedException.</returns>
-    /// <exception cref="NotSupportedException">Always thrown to indicate backend is not yet provisioned.</exception>
+    /// <inheritdoc />
     public IFocasClient Create() => throw new NotSupportedException(Message);
 }
 
@@ -352,5 +360,5 @@ public static class FocasAlarmType
     public const short Servo = 4;       // ALM_S
     public const short DataIo = 5;      // ALM_T
     public const short MemoryCheck = 6; // ALM_M
-    public const short MacroAlarm = 13; // ALM_MC — used by #3006 etc.
+    public const short MacroAlarm = 13; // ALM_MC
 }