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.TwinCAT.Cli/Commands/BrowseCommand.cs

@@ -14,7 +14,7 @@ namespace ZB.MOM.WW.OtOpcUa.Driver.TwinCAT.Cli.Commands;
 ///     Inherits from <see cref="TwinCATCommandBase"/> rather than
 ///     <see cref="TwinCATTagCommandBase"/> so the <c>--poll-only</c> flag does NOT surface in
 ///     <c>browse --help</c>: browse never subscribes, the flag would be a no-op, and the help
-///     text would mislead users (Driver.TwinCAT.Cli-004).
+///     text would mislead users.
 /// </remarks>
 [Command("browse", Description = "Enumerate controller symbols via the driver's DiscoverAsync walk.")]
 public sealed class BrowseCommand : TwinCATCommandBase
@@ -91,6 +91,7 @@ public sealed class BrowseCommand : TwinCATCommandBase
     /// </summary>
     /// <param name="source">The source collection to filter.</param>
     /// <param name="prefix">The prefix to filter on, or null to keep everything.</param>
+    /// <returns>The subset of <paramref name="source"/> whose browse name starts with <paramref name="prefix"/>.</returns>
     internal static List<(string BrowseName, DriverAttributeInfo Info)> FilterByPrefix(
         IReadOnlyList<(string BrowseName, DriverAttributeInfo Info)> source, string? prefix)
         => source
@@ -103,6 +104,8 @@ public sealed class BrowseCommand : TwinCATCommandBase
     /// </summary>
     /// <param name="matchedCount">The number of matched items.</param>
     /// <param name="max">The maximum number to show, or 0 for unbounded.</param>
+    /// <returns>The number of items to print — <paramref name="matchedCount"/> if <paramref name="max"/>
+    ///     is unbounded, otherwise the smaller of the two.</returns>
     internal static int PrintLimit(int matchedCount, int max)
         => max <= 0 ? matchedCount : Math.Min(max, matchedCount);
 
@@ -113,6 +116,7 @@ public sealed class BrowseCommand : TwinCATCommandBase
     ///     authorization is enforced server-side.
     /// </summary>
     /// <param name="info">The attribute info to label.</param>
+    /// <returns><c>"RO"</c> when the attribute is view-only; otherwise <c>"RW"</c>.</returns>
     internal static string AccessTag(DriverAttributeInfo info)
         => info.SecurityClass == SecurityClassification.ViewOnly ? "RO" : "RW";
 

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

@@ -64,7 +64,7 @@ public sealed class SubscribeCommand : TwinCATTagCommandBase
             // write below and with subsequent change events if the PLC pushes faster than a
             // single console write completes. A TextWriter is not guaranteed thread-safe, so
             // we serialise every write through a lock to keep output clean for
-            // screen-recorded bug-report timelines (Driver.TwinCAT.Cli-002).
+            // screen-recorded bug-report timelines.
             var writeLock = new object();
 
             driver.OnDataChange += (_, e) =>
@@ -80,7 +80,7 @@ public sealed class SubscribeCommand : TwinCATTagCommandBase
 
             handle = await driver.SubscribeAsync([tagName], TimeSpan.FromMilliseconds(IntervalMs), ct);
 
-            // Driver.TwinCAT.Cli-003: derive the banner mechanism from the actual subscription
+            // Derive the banner mechanism from the actual subscription
             // handle the driver returned, not from --poll-only. The native ADS path tags its
             // handle with a "twincat-native-sub-*" DiagnosticId; anything else means we landed
             // on the shared PollGroupEngine. That way the line cannot disagree with what the

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

@@ -71,10 +71,11 @@ public sealed class WriteCommand : TwinCATTagCommandBase
     ///     Parse <c>--value</c> per <see cref="TwinCATDataType"/>, invariant culture. Wraps
     ///     <see cref="FormatException"/> and <see cref="OverflowException"/> in a
     ///     <see cref="CliFx.Exceptions.CommandException"/> so the operator sees a clean one-line
-    ///     error instead of a raw stack trace (Driver.TwinCAT.Cli-008).
+    ///     error instead of a raw stack trace.
     /// </summary>
     /// <param name="raw">The raw string value to parse.</param>
     /// <param name="type">The target TwinCAT data type.</param>
+    /// <returns>The parsed value boxed as an <see cref="object"/> matching the given <paramref name="type"/>.</returns>
     internal static object ParseValue(string raw, TwinCATDataType type)
     {
         try

src/Drivers/Cli/ZB.MOM.WW.OtOpcUa.Driver.TwinCAT.Cli/TwinCATCommandBase.cs

@@ -28,20 +28,16 @@ public abstract class TwinCATCommandBase : DriverCommandBase
     [CommandOption("timeout-ms", Description = "Per-operation timeout in ms (default 5000).")]
     public int TimeoutMs { get; init; } = 5000;
 
-    /// <summary>
-    ///     Gets the per-operation timeout, projected from <see cref="TimeoutMs"/>. The CliFx
-    ///     <c>init</c> accessor required by the abstract base property is intentionally a
-    ///     no-op: <see cref="TimeoutMs"/> is the only source of truth, so any value an
-    ///     `init` initialiser supplies to this property directly is silently
-    ///     dropped. Do NOT add a backing field "fixing" the empty body — it would diverge
-    ///     from <see cref="TimeoutMs"/> and the two would drift on every refactor
-    ///     (Driver.TwinCAT.Cli-007).
-    /// </summary>
     /// <inheritdoc />
+    // Projected from TimeoutMs. The CliFx init accessor required by the abstract base property
+    // is intentionally a no-op: TimeoutMs is the only source of truth, so any value an init
+    // initialiser supplies to this property directly is silently dropped. Do NOT add a backing
+    // field "fixing" the empty body — it would diverge from TimeoutMs and the two would drift on
+    // every refactor.
     public override TimeSpan Timeout
     {
         get => TimeSpan.FromMilliseconds(TimeoutMs);
-        init { /* see XML summary — driven by TimeoutMs */ }
+        init { /* see comment above — driven by TimeoutMs */ }
     }
 
     /// <summary>
@@ -57,7 +53,7 @@ public abstract class TwinCATCommandBase : DriverCommandBase
     ///     Validates the numeric options every TwinCAT CLI command shares (timeout + AMS port).
     ///     Subclasses override and call <c>base.Validate()</c> first to add their own range
     ///     checks. Throwing here surfaces a clean CliFx one-line error before the driver gets
-    ///     a chance to fail with an opaque transport error (Driver.TwinCAT.Cli-001).
+    ///     a chance to fail with an opaque transport error.
     /// </summary>
     protected virtual void Validate()
     {
@@ -72,7 +68,7 @@ public abstract class TwinCATCommandBase : DriverCommandBase
     // ---- Test hooks ----
     // Protected members are exposed to the test assembly through these internal accessors so the
     // test project can cover Gateway / DriverInstanceId composition + range validation without
-    // needing reflection on every assertion (Driver.TwinCAT.Cli-006).
+    // needing reflection on every assertion.
     /// <summary>Gets the gateway string for testing.</summary>
     internal string GatewayForTest => Gateway;
 

src/Drivers/Cli/ZB.MOM.WW.OtOpcUa.Driver.TwinCAT.Cli/TwinCATTagCommandBase.cs

@@ -7,7 +7,7 @@ namespace ZB.MOM.WW.OtOpcUa.Driver.TwinCAT.Cli;
 ///     single-tag <see cref="TwinCATDriverOptions"/> — <c>probe</c>, <c>read</c>, <c>write</c>,
 ///     <c>subscribe</c>. Adds the <c>--poll-only</c> flag (relevant only when the driver is
 ///     about to register native ADS notifications, which is why it does NOT live on the
-///     <c>browse</c> command — Driver.TwinCAT.Cli-004) and the <c>BuildOptions</c> helper that
+///     <c>browse</c> command) and the <c>BuildOptions</c> helper that
 ///     assembles the driver-side options record.
 /// </summary>
 public abstract class TwinCATTagCommandBase : TwinCATCommandBase
@@ -24,6 +24,7 @@ public abstract class TwinCATTagCommandBase : TwinCATCommandBase
     ///     native notifications toggled by <see cref="PollOnly"/>.
     /// </summary>
     /// <param name="tags">Tag definitions for the driver.</param>
+    /// <returns>The built <see cref="TwinCATDriverOptions"/>.</returns>
     protected TwinCATDriverOptions BuildOptions(IReadOnlyList<TwinCATTagDefinition> tags) => new()
     {
         Devices = [new TwinCATDeviceOptions(
@@ -39,6 +40,7 @@ public abstract class TwinCATTagCommandBase : TwinCATCommandBase
     // ---- Test hook ----
     /// <summary>Test hook that exposes BuildOptions for unit testing.</summary>
     /// <param name="tags">Tag definitions for the driver.</param>
+    /// <returns>The built <see cref="TwinCATDriverOptions"/>.</returns>
     internal TwinCATDriverOptions BuildOptionsForTest(IReadOnlyList<TwinCATTagDefinition> tags)
         => BuildOptions(tags);
 }