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/Cli/ZB.MOM.WW.OtOpcUa.Driver.FOCAS.Cli/Commands/ProbeCommand.cs

@@ -27,7 +27,6 @@ public sealed class ProbeCommand : FocasCommandBase
     public override async ValueTask ExecuteAsync(IConsole console)
     {
         ConfigureLogging();
-        // Driver.FOCAS.Cli-003: validate numeric option ranges before any driver work.
         ValidateOptions();
         var ct = console.RegisterCancellationHandler();
 
@@ -39,9 +38,6 @@ public sealed class ProbeCommand : FocasCommandBase
             Writable: false);
         var options = BuildOptions([probeTag]);
 
-        // Driver.FOCAS.Cli-004: `await using` is the sole disposal mechanism — FocasDriver.DisposeAsync
-        // already invokes ShutdownAsync, so a redundant explicit ShutdownAsync(CancellationToken.None)
-        // in a finally block ran shutdown twice. The await-using on the next line is enough.
         await using var driver = new FocasDriver(options, DriverInstanceId);
         try
         {
@@ -59,9 +55,6 @@ public sealed class ProbeCommand : FocasCommandBase
         }
         finally
         {
-            // Driver.FOCAS.Cli-006: flush Serilog before process exit so buffered log output
-            // emitted during driver shutdown is not silently dropped (matching DriverCommandBase
-            // docs and every sibling CLI — Modbus / AbCip / AbLegacy / TwinCAT).
             FlushLogging();
         }
     }

src/Drivers/Cli/ZB.MOM.WW.OtOpcUa.Driver.FOCAS.Cli/Commands/ReadCommand.cs

@@ -22,12 +22,11 @@ public sealed class ReadCommand : FocasCommandBase
         "Bit / Byte / Int16 / Int32 / Float32 / Float64 / String (default Int16).")]
     public FocasDataType DataType { get; init; } = FocasDataType.Int16;
 
-    /// <summary>Executes the read command against the FOCAS device.</summary>
     /// <inheritdoc />
     public override async ValueTask ExecuteAsync(IConsole console)
     {
         ConfigureLogging();
-        // Driver.FOCAS.Cli-003: validate numeric option ranges before any driver work.
+        // Validate numeric option ranges before any driver work.
         ValidateOptions();
         var ct = console.RegisterCancellationHandler();
 
@@ -40,7 +39,7 @@ public sealed class ReadCommand : FocasCommandBase
             Writable: false);
         var options = BuildOptions([tag]);
 
-        // Driver.FOCAS.Cli-004: `await using` is the sole disposal mechanism — FocasDriver.DisposeAsync
+        // `await using` is the sole disposal mechanism — FocasDriver.DisposeAsync
         // already invokes ShutdownAsync, so a redundant explicit ShutdownAsync(CancellationToken.None)
         // in a finally block ran shutdown twice. The await-using on the next line is enough.
         await using var driver = new FocasDriver(options, DriverInstanceId);
@@ -52,7 +51,7 @@ public sealed class ReadCommand : FocasCommandBase
         }
         finally
         {
-            // Driver.FOCAS.Cli-006: flush Serilog before process exit so buffered log output
+            // Flush Serilog before process exit so buffered log output
             // emitted during driver shutdown is not silently dropped (matching DriverCommandBase
             // docs and every sibling CLI — Modbus / AbCip / AbLegacy / TwinCAT).
             FlushLogging();
@@ -62,6 +61,7 @@ public sealed class ReadCommand : FocasCommandBase
     /// <summary>Constructs a tag name from address and data type.</summary>
     /// <param name="address">The FOCAS address.</param>
     /// <param name="type">The data type.</param>
+    /// <returns>The synthesised tag name in <c>address:type</c> form.</returns>
     internal static string SynthesiseTagName(string address, FocasDataType type)
         => $"{address}:{type}";
 }

src/Drivers/Cli/ZB.MOM.WW.OtOpcUa.Driver.FOCAS.Cli/Commands/SubscribeCommand.cs

@@ -29,7 +29,7 @@ public sealed class SubscribeCommand : FocasCommandBase
     public override async ValueTask ExecuteAsync(IConsole console)
     {
         ConfigureLogging();
-        // Driver.FOCAS.Cli-003: validate numeric option ranges (including the subscribe-only
+        // Validate numeric option ranges (including the subscribe-only
         // --interval-ms) before any driver work so a zero/negative interval surfaces as a
         // clean CommandException rather than a tight-spinning poll loop.
         ValidateOptions(IntervalMs);
@@ -44,12 +44,12 @@ public sealed class SubscribeCommand : FocasCommandBase
             Writable: false);
         var options = BuildOptions([tag]);
 
-        // Driver.FOCAS.Cli-004: `await using` is the sole driver-disposal mechanism — FocasDriver.DisposeAsync
+        // `await using` is the sole driver-disposal mechanism — FocasDriver.DisposeAsync
         // already invokes ShutdownAsync, so a redundant ShutdownAsync(CancellationToken.None) in finally
         // ran shutdown twice. Only UnsubscribeAsync stays in the finally block — that's a subscription
         // lifecycle concern that is not part of driver disposal.
         await using var driver = new FocasDriver(options, DriverInstanceId);
-        // Driver.FOCAS.Cli-002: serialize console writes from the PollGroupEngine background
+        // Serialize console writes from the PollGroupEngine background
         // thread so overlapping poll ticks (and the "Subscribed to ..." banner from the CliFx
         // invocation thread) can't interleave partial lines.
         var writeLock = new object();
@@ -58,7 +58,7 @@ public sealed class SubscribeCommand : FocasCommandBase
         {
             await driver.InitializeAsync("{}", ct);
 
-            // Driver.FOCAS.Cli-002: route every data-change event to the CliFx console (not
+            // Route every data-change event to the CliFx console (not
             // System.Console — the analyzer flags it + IConsole is the testable abstraction).
             // The handler is synchronous because OnDataChange is raised from a driver
             // background thread; the IConsole.Output writer is not documented as thread-safe
@@ -89,7 +89,7 @@ public sealed class SubscribeCommand : FocasCommandBase
 
             handle = await driver.SubscribeAsync([tagName], TimeSpan.FromMilliseconds(IntervalMs), ct);
 
-            // Driver.FOCAS.Cli-002: hold the lock around the banner write so the first
+            // Hold the lock around the banner write so the first
             // poll-driven change line from the driver tick thread can't interleave with
             // this banner.
             lock (writeLock)
@@ -110,7 +110,7 @@ public sealed class SubscribeCommand : FocasCommandBase
         {
             if (handle is not null)
             {
-                // Driver.FOCAS.Cli-002: stop the subscription before disposal — UnsubscribeAsync
+                // Stop the subscription before disposal — UnsubscribeAsync
                 // halts the poll-group ticker so no further OnDataChange events fire. The
                 // anonymous handler is never explicitly removed via -=; instead, driver disposal
                 // (via `await using` immediately after this finally) tears down the PollGroupEngine,
@@ -119,9 +119,9 @@ public sealed class SubscribeCommand : FocasCommandBase
                 try { await driver.UnsubscribeAsync(handle, CancellationToken.None); }
                 catch { /* teardown best-effort */ }
             }
-            // Driver.FOCAS.Cli-006: flush Serilog before process exit so buffered log output
-            // emitted during driver shutdown is not silently dropped (matching DriverCommandBase
-            // docs and every sibling CLI — Modbus / AbCip / AbLegacy / TwinCAT).
+            // Flush Serilog before process exit so buffered log output emitted during driver
+            // shutdown is not silently dropped (matching DriverCommandBase docs and every
+            // sibling CLI — Modbus / AbCip / AbLegacy / TwinCAT).
             FlushLogging();
         }
     }

src/Drivers/Cli/ZB.MOM.WW.OtOpcUa.Driver.FOCAS.Cli/Commands/WriteCommand.cs

@@ -33,9 +33,9 @@ public sealed class WriteCommand : FocasCommandBase
     public override async ValueTask ExecuteAsync(IConsole console)
     {
         ConfigureLogging();
-        // Driver.FOCAS.Cli-003: validate numeric option ranges before any driver work so
-        // a zero/negative port/timeout surfaces as a clean CommandException rather than an
-        // opaque downstream exception.
+        // Validate numeric option ranges before any driver work so a zero/negative
+        // port/timeout surfaces as a clean CommandException rather than an opaque
+        // downstream exception.
         ValidateOptions();
         var ct = console.RegisterCancellationHandler();
 
@@ -50,8 +50,8 @@ public sealed class WriteCommand : FocasCommandBase
 
         var parsed = ParseValue(Value, DataType);
 
-        // Driver.FOCAS.Cli-004: `await using` is the sole disposal mechanism — FocasDriver.DisposeAsync
-        // already invokes ShutdownAsync, so a redundant explicit ShutdownAsync(CancellationToken.None)
+        // `await using` is the sole disposal mechanism — FocasDriver.DisposeAsync already
+        // invokes ShutdownAsync, so a redundant explicit ShutdownAsync(CancellationToken.None)
         // in a finally block ran shutdown twice. The await-using on the next line is enough.
         await using var driver = new FocasDriver(options, DriverInstanceId);
         try
@@ -62,16 +62,16 @@ public sealed class WriteCommand : FocasCommandBase
         }
         finally
         {
-            // Driver.FOCAS.Cli-006: flush Serilog before process exit so buffered log output
-            // emitted during driver shutdown is not silently dropped (matching DriverCommandBase
-            // docs and every sibling CLI — Modbus / AbCip / AbLegacy / TwinCAT).
+            // Flush Serilog before process exit so buffered log output emitted during driver
+            // shutdown is not silently dropped (matching DriverCommandBase docs and every
+            // sibling CLI — Modbus / AbCip / AbLegacy / TwinCAT).
             FlushLogging();
         }
     }
 
     /// <summary>Parse <c>--value</c> per <see cref="FocasDataType"/>, invariant culture throughout.</summary>
     /// <remarks>
-    ///     Driver.FOCAS.Cli-001: numeric parses are wrapped so that malformed input
+    ///     Numeric parses are wrapped so that malformed input
     ///     (<see cref="FormatException"/> / <see cref="OverflowException"/>) surfaces
     ///     as a clean <see cref="CliFx.Exceptions.CommandException"/> rather than a raw
     ///     .NET stack trace — matching the friendly message the Bit path already produces.

src/Drivers/Cli/ZB.MOM.WW.OtOpcUa.Driver.FOCAS.Cli/FocasCommandBase.cs

@@ -47,6 +47,7 @@ public abstract class FocasCommandBase : DriverCommandBase
     ///     as <c>BadCommunicationError</c>.
     /// </summary>
     /// <param name="tags">The tag definitions to include in the driver options.</param>
+    /// <returns>A <see cref="FocasDriverOptions"/> configured with a single device and the supplied tags.</returns>
     protected FocasDriverOptions BuildOptions(IReadOnlyList<FocasTagDefinition> tags) => new()
     {
         Devices = [new FocasDeviceOptions(
@@ -62,7 +63,7 @@ public abstract class FocasCommandBase : DriverCommandBase
     protected string DriverInstanceId => $"focas-cli-{CncHost}:{CncPort}";
 
     /// <summary>
-    ///     Driver.FOCAS.Cli-003: validate numeric option ranges at the CLI boundary so a
+    ///     Validates numeric option ranges at the CLI boundary so a
     ///     zero/negative <c>--cnc-port</c>, <c>--timeout-ms</c>, or <c>--interval-ms</c>
     ///     surfaces as a clean <see cref="CliFx.Exceptions.CommandException"/> rather than
     ///     either an opaque downstream exception (invalid <c>focas://host:&lt;n&gt;</c> /