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/Server/ZB.MOM.WW.OtOpcUa.AdminUI/Uns/IUnsTreeService.cs

@@ -28,7 +28,7 @@ public sealed record LineEditDto(string UnsLineId, string UnsAreaId, string Name
 /// An equipment projected for editing: its system-generated id, the operator-editable identity and
 /// OPC 40010 identification fields, plus the concurrency token the edit modal must echo back on save.
 /// </summary>
-/// <param name="EquipmentId">The system-generated stable id (read-only — never operator-edited, decision #125).</param>
+/// <param name="EquipmentId">The system-generated stable id (read-only — never operator-edited).</param>
 /// <param name="Name">UNS level-5 segment name.</param>
 /// <param name="MachineCode">Operator colloquial id; unique fleet-wide.</param>
 /// <param name="UnsLineId">The owning line id (the UNS-line selection).</param>
@@ -54,7 +54,7 @@ public sealed record EquipmentEditDto(string EquipmentId, string Name, string Ma
 /// <summary>
 /// An equipment-bound tag projected for editing: its operator-editable fields, the owning equipment
 /// (so the host can scope the candidate-driver list and refresh the right node), plus the concurrency
-/// token the edit modal must echo back on save. Tree tags are always equipment-bound (decision #110),
+/// token the edit modal must echo back on save. Tree tags are always equipment-bound,
 /// so <c>FolderPath</c> never surfaces here.
 /// </summary>
 /// <param name="TagId">The tag's stable id (read-only on edit).</param>
@@ -73,7 +73,7 @@ public sealed record TagEditDto(string TagId, string EquipmentId, string Name, s
 /// <summary>
 /// An equipment-bound virtual tag projected for editing: its operator-editable fields, the owning
 /// equipment (so the host can refresh the right node), plus the concurrency token the edit modal must
-/// echo back on save. Virtual tags are always scoped to an equipment (plan decision #2), so the modal
+/// echo back on save. Virtual tags are always scoped to an equipment, so the modal
 /// never offers an equipment-change control.
 /// </summary>
 /// <param name="VirtualTagId">The virtual tag's stable id (read-only on edit).</param>
@@ -92,7 +92,7 @@ public sealed record VirtualTagEditDto(string VirtualTagId, string EquipmentId,
 /// <summary>
 /// The outcome of a bulk equipment CSV import: how many rows were inserted, how many were skipped
 /// (existing MachineCode — the importer is additive-only, never an update), and a per-row error list
-/// for rows that could not be inserted (unknown line, unknown driver, or a decision-#122 cluster
+/// for rows that could not be inserted (unknown line, unknown driver, or a cluster
 /// mismatch). Skipped rows never appear in <see cref="Errors"/>.
 /// </summary>
 /// <param name="Inserted">The count of new Equipment rows added.</param>
@@ -221,7 +221,7 @@ public interface IUnsTreeService
 
     /// <summary>
     /// Updates a UNS area's name, notes, and owning cluster. When the cluster changes, the
-    /// decision-#122 reassignment guard blocks the move if any driver-bound equipment under the
+    /// reassignment guard blocks the move if any driver-bound equipment under the
     /// area is bound to a driver in a different cluster than the target. Uses last-write-wins
     /// optimistic concurrency on <see cref="Configuration.Entities.UnsArea.RowVersion"/>.
     /// </summary>
@@ -231,7 +231,7 @@ public interface IUnsTreeService
     /// <param name="newClusterId">The target cluster (may equal the current one).</param>
     /// <param name="rowVersion">The concurrency token the caller last read.</param>
     /// <param name="ct">A token to cancel the operation.</param>
-    /// <returns>Success, a missing-row failure, a #122 guard failure, or a concurrency failure.</returns>
+    /// <returns>Success, a missing-row failure, a cluster-guard failure, or a concurrency failure.</returns>
     Task<UnsMutationResult> UpdateAreaAsync(string unsAreaId, string name, string? notes, string newClusterId, byte[] rowVersion, CancellationToken ct = default);
 
     /// <summary>
@@ -283,21 +283,21 @@ public interface IUnsTreeService
 
     /// <summary>
     /// Creates a new equipment under a UNS line. The <c>EquipmentId</c> is system-generated
-    /// (decision #125: <c>EQ-</c> + the first 12 hex chars of a fresh <c>EquipmentUuid</c>).
+    /// (<c>EQ-</c> + the first 12 hex chars of a fresh <c>EquipmentUuid</c>).
     /// Fails if the line is unset, if the MachineCode is already used fleet-wide, or if the
-    /// decision-#122 driver-cluster guard trips. Whitespace-only DriverInstanceId/ZTag/SAPID
+    /// driver-cluster guard trips. Whitespace-only DriverInstanceId/ZTag/SAPID
     /// collapse to <c>null</c>.
     /// </summary>
     /// <param name="input">The operator-editable equipment fields.</param>
     /// <param name="ct">A token to cancel the operation.</param>
-    /// <returns>Success, a missing-line failure, a duplicate-MachineCode failure, or a #122 guard failure.</returns>
+    /// <returns>Success, a missing-line failure, a duplicate-MachineCode failure, or a cluster-guard failure.</returns>
     Task<UnsMutationResult> CreateEquipmentAsync(EquipmentInput input, CancellationToken ct = default);
 
     /// <summary>
     /// Bulk-imports equipment from a parsed set of <see cref="EquipmentInput"/> rows in a single
     /// context, applying the same rules as the single-add path: a row whose <c>UnsLineId</c> does not
     /// exist is an error; a row whose <c>DriverInstanceId</c> is set but does not resolve is an error;
-    /// a driver-bound row whose driver is in a different cluster than its line fails the decision-#122
+    /// a driver-bound row whose driver is in a different cluster than its line fails the cluster
     /// guard; and a row whose <c>MachineCode</c> already exists in the DB <em>or</em> earlier in the
     /// same batch is silently skipped (additive-only — never an update). Inserted rows get a
     /// system-generated <c>EQ-</c> id and a fresh <c>EquipmentUuid</c>. All inserts are saved once at
@@ -310,7 +310,7 @@ public interface IUnsTreeService
 
     /// <summary>
     /// Updates an equipment's mutable fields (driver binding, line, name, MachineCode, external
-    /// ids, and the OPC 40010 identification fields). The decision-#122 driver-cluster guard blocks
+    /// ids, and the OPC 40010 identification fields). The driver-cluster guard blocks
     /// binding to a driver in a different cluster than the equipment's line. Uses last-write-wins
     /// optimistic concurrency on <see cref="Configuration.Entities.Equipment.RowVersion"/>.
     /// </summary>
@@ -318,7 +318,7 @@ public interface IUnsTreeService
     /// <param name="input">The new operator-editable equipment fields.</param>
     /// <param name="rowVersion">The concurrency token the caller last read.</param>
     /// <param name="ct">A token to cancel the operation.</param>
-    /// <returns>Success, a missing-row failure, a #122 guard failure, or a concurrency failure.</returns>
+    /// <returns>Success, a missing-row failure, a cluster-guard failure, or a concurrency failure.</returns>
     Task<UnsMutationResult> UpdateEquipmentAsync(string equipmentId, EquipmentInput input, byte[] rowVersion, CancellationToken ct = default);
 
     /// <summary>
@@ -361,7 +361,7 @@ public interface IUnsTreeService
     /// <summary>
     /// Loads the drivers eligible to back a tag on the given equipment: drivers in the equipment's
     /// cluster (<c>Equipment.UnsLine → UnsArea.ClusterId</c>) whose namespace is Equipment-kind
-    /// (decision #110 — tree tags are equipment-bound). Ordered by <c>DriverInstanceId</c>. Returns
+    /// (tree tags are equipment-bound). Ordered by <c>DriverInstanceId</c>. Returns
     /// an empty list when the equipment cannot be resolved to a cluster.
     /// </summary>
     /// <param name="equipmentId">The equipment whose candidate drivers to load.</param>
@@ -373,10 +373,10 @@ public interface IUnsTreeService
     Task<IReadOnlyList<(string DriverInstanceId, string Display, string DriverType, string DriverConfig)>> LoadTagDriversForEquipmentAsync(string equipmentId, CancellationToken ct = default);
 
     /// <summary>
-    /// Creates a new equipment-bound tag. <c>FolderPath</c> is always <c>null</c> (decision #110 —
-    /// the tree only edits equipment-bound tags). Fails on a duplicate <c>TagId</c>, invalid
+    /// Creates a new equipment-bound tag. <c>FolderPath</c> is always <c>null</c> (the tree
+    /// only edits equipment-bound tags). Fails on a duplicate <c>TagId</c>, invalid
     /// <c>TagConfig</c> JSON, an unknown driver, a driver whose namespace is not Equipment-kind, a
-    /// driver in a different cluster than the equipment (decision #122), or a name already used on
+    /// driver in a different cluster than the equipment, or a name already used on
     /// the equipment. Whitespace-only <c>PollGroupId</c> collapses to <c>null</c>.
     /// </summary>
     /// <param name="equipmentId">The owning equipment.</param>
@@ -388,8 +388,8 @@ public interface IUnsTreeService
     /// <summary>
     /// Updates an equipment-bound tag's driver binding, name, data type, access level, write-retry
     /// flag, poll group, and config. The owning <c>EquipmentId</c> and the <c>null</c>
-    /// <c>FolderPath</c> are preserved. Re-runs the JSON-validity, namespace-kind, and decision-#122
-    /// cluster guards against the tag's existing equipment, and enforces name uniqueness on that
+    /// <c>FolderPath</c> are preserved. Re-runs the JSON-validity, namespace-kind, and cluster
+    /// guards against the tag's existing equipment, and enforces name uniqueness on that
     /// equipment excluding this tag. Uses last-write-wins optimistic concurrency on
     /// <see cref="Configuration.Entities.Tag.RowVersion"/>.
     /// </summary>
@@ -432,7 +432,7 @@ public interface IUnsTreeService
     Task<UnsMutationResult> CreateScriptAsync(string name, CancellationToken ct = default);
 
     /// <summary>
-    /// Creates a new equipment-bound virtual tag (plan decision #2 — virtual tags are always scoped
+    /// Creates a new equipment-bound virtual tag (virtual tags are always scoped
     /// to an equipment). Fails if the equipment does not exist, if no script is chosen, if neither a
     /// change trigger nor a timer is set, if the timer is below the 50 ms minimum, on a duplicate
     /// <c>VirtualTagId</c>, or on a name already used on the equipment.