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/Core/ZB.MOM.WW.OtOpcUa.Configuration/Entities/ClusterNode.cs

@@ -20,7 +20,7 @@ public sealed class ClusterNode
 
     /// <summary>
     ///     OPC UA <c>ApplicationUri</c> — MUST be unique per node per OPC UA spec. Clients pin trust here.
-    ///     Fleet-wide unique index enforces no two nodes share a value (decision #86).
+    ///     Fleet-wide unique index enforces no two nodes share a value.
     ///     Stored explicitly, NOT derived from <see cref="Host"/> at runtime — silent rewrite on
     ///     hostname change would break all client trust.
     /// </summary>
@@ -31,7 +31,7 @@ public sealed class ClusterNode
 
     /// <summary>
     ///     Per-node override JSON keyed by DriverInstanceId, merged onto cluster-level DriverConfig
-    ///     at apply time. Minimal by intent (decision #81). Nullable when no overrides exist.
+    ///     at apply time. Minimal by intent. Nullable when no overrides exist.
     /// </summary>
     public string? DriverConfigOverridesJson { get; set; }
 

src/Core/ZB.MOM.WW.OtOpcUa.Configuration/Entities/ClusterNodeCredential.cs

@@ -4,7 +4,7 @@ namespace ZB.MOM.WW.OtOpcUa.Configuration.Entities;
 
 /// <summary>
 ///     Authenticates a <see cref="ClusterNode"/> to the central config DB.
-///     Per decision #83 — credentials bind to NodeId, not ClusterId.
+///     Credentials bind to NodeId, not ClusterId.
 /// </summary>
 public sealed class ClusterNodeCredential
 {

src/Core/ZB.MOM.WW.OtOpcUa.Configuration/Entities/DriverHostStatus.cs

@@ -11,8 +11,8 @@ namespace ZB.MOM.WW.OtOpcUa.Configuration.Entities;
 /// </summary>
 /// <remarks>
 ///     <para>
-///         Closes the data-layer piece of LMX follow-up #7 (per-AppEngine Admin dashboard
-///         drill-down). The publisher hosted service on the Server side subscribes to every
+///         Supports the per-AppEngine Admin dashboard drill-down. The publisher hosted
+///         service on the Server side subscribes to every
 ///         registered driver's <c>OnHostStatusChanged</c> and upserts rows on transitions +
 ///         periodic liveness heartbeats. <see cref="LastSeenUtc"/> advances on every
 ///         heartbeat so the Admin UI can flag stale rows from a crashed Server.

src/Core/ZB.MOM.WW.OtOpcUa.Configuration/Entities/DriverInstance.cs

@@ -14,7 +14,7 @@ public sealed class DriverInstance
 
     /// <summary>
     ///     Logical FK to <see cref="Namespace.NamespaceId"/>. Same-cluster binding enforced by
-    ///     <c>sp_ValidateDraft</c> per decision #122: Namespace.ClusterId must equal DriverInstance.ClusterId.
+    ///     <c>sp_ValidateDraft</c>: Namespace.ClusterId must equal DriverInstance.ClusterId.
     /// </summary>
     public required string NamespaceId { get; set; }
 
@@ -27,12 +27,12 @@ public sealed class DriverInstance
     /// <summary>Gets or sets a value indicating whether this driver instance is enabled.</summary>
     public bool Enabled { get; set; } = true;
 
-    /// <summary>Schemaless per-driver-type JSON config. Validated against registered JSON schema at draft-publish time (decision #91).</summary>
+    /// <summary>Schemaless per-driver-type JSON config. Validated against registered JSON schema at draft-publish time.</summary>
     public required string DriverConfig { get; set; }
 
     /// <summary>
     ///     Optional per-instance overrides for the Phase 6.1 shared Polly resilience pipeline.
-    ///     Null = use the driver's tier defaults (decision #143). When populated, expected shape:
+    ///     Null = use the driver's tier defaults. When populated, expected shape:
     ///     <code>
     ///     {
     ///       "bulkheadMaxConcurrent": 16,

src/Core/ZB.MOM.WW.OtOpcUa.Configuration/Entities/Equipment.cs

@@ -2,8 +2,6 @@ namespace ZB.MOM.WW.OtOpcUa.Configuration.Entities;
 
 /// <summary>
 ///     UNS level-5 entity. Only for drivers in Equipment-kind namespaces.
-///     Per decisions #109 (first-class), #116 (5-identifier model), #125 (system-generated EquipmentId),
-///     #138–139 (OPC 40010 Identification fields as first-class columns).
 /// </summary>
 public sealed class Equipment
 {
@@ -12,7 +10,7 @@ public sealed class Equipment
 
     /// <summary>
     ///     System-generated stable internal logical ID. Format: <c>'EQ-' + first 12 hex chars of EquipmentUuid</c>.
-    ///     NEVER operator-supplied, NEVER in CSV imports, NEVER editable in Admin UI (decision #125).
+    ///     NEVER operator-supplied, NEVER in CSV imports, NEVER editable in Admin UI.
     /// </summary>
     public required string EquipmentId { get; set; }
 
@@ -34,7 +32,7 @@ public sealed class Equipment
     /// <summary>UNS level 5 segment, matches <c>^[a-z0-9-]{1,32}$</c>.</summary>
     public required string Name { get; set; }
 
-    // Operator-facing / external-system identifiers (decision #116)
+    // Operator-facing / external-system identifiers
 
     /// <summary>Operator colloquial id (e.g. "machine_001"). Unique within cluster. Required.</summary>
     public required string MachineCode { get; set; }
@@ -45,7 +43,7 @@ public sealed class Equipment
     /// <summary>SAP PM equipment id. Unique fleet-wide via <see cref="ExternalIdReservation"/>.</summary>
     public string? SAPID { get; set; }
 
-    // OPC UA Companion Spec OPC 40010 Machinery Identification fields (decision #139).
+    // OPC UA Companion Spec OPC 40010 Machinery Identification fields.
     // All nullable so equipment can be added before identity is fully captured.
     /// <summary>Gets or sets the manufacturer name for this equipment.</summary>
     public string? Manufacturer { get; set; }
@@ -66,7 +64,7 @@ public sealed class Equipment
     /// <summary>Gets or sets the device manual URI for this equipment.</summary>
     public string? DeviceManualUri { get; set; }
 
-    /// <summary>Nullable hook for future schemas-repo template ID (decision #112).</summary>
+    /// <summary>Nullable hook for future schemas-repo template ID.</summary>
     public string? EquipmentClassRef { get; set; }
 
     /// <summary>Gets or sets whether this equipment is enabled.</summary>

src/Core/ZB.MOM.WW.OtOpcUa.Configuration/Entities/EquipmentImportBatch.cs

@@ -46,8 +46,8 @@ public sealed class EquipmentImportBatch
 }
 
 /// <summary>
-///     One staged row under an <see cref="EquipmentImportBatch"/>. Mirrors the decision #117
-///     + decision #139 columns from the CSV importer's output + an
+///     One staged row under an <see cref="EquipmentImportBatch"/>. Mirrors the required
+///     + optional columns from the CSV importer's output + an
 ///     <see cref="IsAccepted"/> flag + a <see cref="RejectReason"/> string the preview modal
 ///     renders.
 /// </summary>
@@ -68,7 +68,6 @@ public sealed class EquipmentImportRow
     /// <summary>Gets or sets the reason this row was rejected, if applicable.</summary>
     public string? RejectReason { get; set; }
 
-    // Required (decision #117)
     /// <summary>Gets or sets the Z tag identifier.</summary>
     public required string ZTag { get; set; }
 
@@ -93,7 +92,6 @@ public sealed class EquipmentImportRow
     /// <summary>Gets or sets the UNS line name.</summary>
     public required string UnsLineName { get; set; }
 
-    // Optional (decision #139 — OPC 40010 Identification)
     /// <summary>Gets or sets the manufacturer name.</summary>
     public string? Manufacturer { get; set; }
 

src/Core/ZB.MOM.WW.OtOpcUa.Configuration/Entities/ExternalIdReservation.cs

@@ -3,7 +3,7 @@ using ZB.MOM.WW.OtOpcUa.Configuration.Enums;
 namespace ZB.MOM.WW.OtOpcUa.Configuration.Entities;
 
 /// <summary>
-///     Fleet-wide rollback-safe reservation of ZTag and SAPID. Per decision #124 — NOT generation-versioned.
+///     Fleet-wide rollback-safe reservation of ZTag and SAPID. NOT generation-versioned.
 ///     Exists outside generation flow specifically because old generations and disabled equipment can
 ///     still hold the same external IDs; per-generation uniqueness indexes fail under rollback/re-enable.
 /// </summary>

src/Core/ZB.MOM.WW.OtOpcUa.Configuration/Entities/LdapGroupRoleMapping.cs

@@ -8,7 +8,7 @@ namespace ZB.MOM.WW.OtOpcUa.Configuration.Entities;
 ///     applies fleet-wide.
 /// </summary>
 /// <remarks>
-///     <para>Per <c>docs/v2/plan.md</c> decisions #105 and #150 — this entity is <b>control-plane
+///     <para>This entity is <b>control-plane
 ///     only</b>. The OPC UA data-path evaluator does not read these rows; it reads
 ///     <see cref="NodeAcl"/> joined directly against the session's resolved LDAP group
 ///     memberships. Collapsing the two would let a user inherit tag permissions via an

src/Core/ZB.MOM.WW.OtOpcUa.Configuration/Entities/Namespace.cs

@@ -3,7 +3,7 @@ using ZB.MOM.WW.OtOpcUa.Configuration.Enums;
 namespace ZB.MOM.WW.OtOpcUa.Configuration.Entities;
 
 /// <summary>
-///     OPC UA namespace served by a cluster. Generation-versioned per decision #123 —
+///     OPC UA namespace served by a cluster. Generation-versioned —
 ///     namespaces are content (affect what consumers see at the endpoint), not topology.
 /// </summary>
 public sealed class Namespace

src/Core/ZB.MOM.WW.OtOpcUa.Configuration/Entities/NodeAcl.cs

@@ -4,7 +4,7 @@ namespace ZB.MOM.WW.OtOpcUa.Configuration.Entities;
 
 /// <summary>
 ///     One ACL grant: an LDAP group gets a set of <see cref="NodePermissions"/> at a specific scope.
-///     Generation-versioned per decision #130. See <c>acl-design.md</c> for evaluation algorithm.
+///     Generation-versioned per decision. See <c>acl-design.md</c> for evaluation algorithm.
 /// </summary>
 public sealed class NodeAcl
 {

src/Core/ZB.MOM.WW.OtOpcUa.Configuration/Entities/Script.cs

@@ -1,7 +1,7 @@
 namespace ZB.MOM.WW.OtOpcUa.Configuration.Entities;
 
 /// <summary>
-///     Per Phase 7 plan decision #8 — user-authored C# script source, referenced by
+///     User-authored C# script source, referenced by
 ///     <see cref="VirtualTag"/> and <see cref="ScriptedAlarm"/>. One row per script,
 ///     per generation. <c>SourceHash</c> is the compile-cache key.
 /// </summary>

src/Core/ZB.MOM.WW.OtOpcUa.Configuration/Entities/ScriptedAlarm.cs

@@ -1,15 +1,15 @@
 namespace ZB.MOM.WW.OtOpcUa.Configuration.Entities;
 
 /// <summary>
-///     Per Phase 7 plan decisions #5, #13, #15 — a scripted OPC UA Part 9 alarm whose
+///     A scripted OPC UA Part 9 alarm whose
 ///     condition is the predicate <see cref="Script"/> referenced by
 ///     <see cref="PredicateScriptId"/>. Materialized by <c>Core.ScriptedAlarms</c> as a
 ///     concrete <c>AlarmConditionType</c> subtype per <see cref="AlarmType"/>.
 /// </summary>
 /// <remarks>
 ///     <para>
-///         Message tokens (<c>{TagPath}</c>) resolved at emission time per plan decision #13.
-///         <see cref="HistorizeToAveva"/> (plan decision #15) gates whether transitions
+///         Message tokens (<c>{TagPath}</c>) resolved at emission time.
+///         <see cref="HistorizeToAveva"/> gates whether transitions
 ///         route through the Core.AlarmHistorian SQLite queue + Galaxy.Host to the Aveva
 ///         Historian alarm schema.
 ///     </para>
@@ -41,7 +41,7 @@ public sealed class ScriptedAlarm
     public required string PredicateScriptId { get; set; }
 
     /// <summary>
-    ///     Plan decision #15 — when true, transitions route through the SQLite store-and-forward
+    ///     When true, transitions route through the SQLite store-and-forward
     ///     queue to the Aveva Historian. Defaults on for scripted alarms because they are the
     ///     primary motivation for the historian sink; operator can disable per alarm.
     /// </summary>

src/Core/ZB.MOM.WW.OtOpcUa.Configuration/Entities/ScriptedAlarmState.cs

@@ -1,8 +1,8 @@
 namespace ZB.MOM.WW.OtOpcUa.Configuration.Entities;
 
 /// <summary>
-///     Per Phase 7 plan decision #14 — persistent runtime state for each scripted alarm.
-///     Survives process restart so operators don't re-ack and ack history survives for
+///     Persistent runtime state for each scripted alarm. Survives process restart so
+///     operators don't re-ack and ack history survives for
 ///     GxP / 21 CFR Part 11 compliance. Keyed on <c>ScriptedAlarmId</c> logically (not
 ///     per-generation) because ack state follows the alarm's stable identity across
 ///     generations — a Modified alarm keeps its ack history.
@@ -24,7 +24,7 @@ public sealed class ScriptedAlarmState
     /// <summary>Logical FK — matches <see cref="ScriptedAlarm.ScriptedAlarmId"/>. One row per alarm identity.</summary>
     public required string ScriptedAlarmId { get; set; }
 
-    /// <summary>Enabled/Disabled. Persists across restart per plan decision #14.</summary>
+    /// <summary>Enabled/Disabled. Persists across restart.</summary>
     public required string EnabledState { get; set; } = "Enabled";
 
     /// <summary>Unacknowledged / Acknowledged.</summary>

src/Core/ZB.MOM.WW.OtOpcUa.Configuration/Entities/ServerCluster.cs

@@ -14,7 +14,7 @@ public sealed class ServerCluster
     /// <summary>Gets or sets the display name for the server cluster.</summary>
     public required string Name { get; set; }
 
-    /// <summary>UNS level 1. Canonical org value: "zb" per decision #140.</summary>
+    /// <summary>UNS level 1. Canonical org value: "zb".</summary>
     public required string Enterprise { get; set; }
 
     /// <summary>UNS level 2, e.g. "warsaw-west".</summary>

src/Core/ZB.MOM.WW.OtOpcUa.Configuration/Entities/Tag.cs

@@ -51,7 +51,7 @@ public sealed class Tag
     /// </summary>
     public required TagAccessLevel AccessLevel { get; set; }
 
-    /// <summary>Per decisions #44–45 — opt-in for write retry eligibility.</summary>
+    /// <summary>Opt-in for write retry eligibility.</summary>
     public bool WriteIdempotent { get; set; }
 
     /// <summary>

src/Core/ZB.MOM.WW.OtOpcUa.Configuration/Entities/UnsArea.cs

@@ -1,6 +1,6 @@
 namespace ZB.MOM.WW.OtOpcUa.Configuration.Entities;
 
-/// <summary>UNS level-3 segment. Generation-versioned per decision #115.</summary>
+/// <summary>UNS level-3 segment. Generation-versioned.</summary>
 public sealed class UnsArea
 {
     /// <summary>Gets or sets the unique row identifier.</summary>

src/Core/ZB.MOM.WW.OtOpcUa.Configuration/Entities/UnsLine.cs

@@ -1,6 +1,6 @@
 namespace ZB.MOM.WW.OtOpcUa.Configuration.Entities;
 
-/// <summary>UNS level-4 segment. Generation-versioned per decision #115.</summary>
+/// <summary>UNS level-4 segment. Generation-versioned.</summary>
 public sealed class UnsLine
 {
     /// <summary>Gets or sets the unique row identifier for this UNS line.</summary>

src/Core/ZB.MOM.WW.OtOpcUa.Configuration/Entities/VirtualTag.cs

@@ -1,20 +1,19 @@
 namespace ZB.MOM.WW.OtOpcUa.Configuration.Entities;
 
 /// <summary>
-///     Per Phase 7 plan decision #2 — a virtual (calculated) tag that lives in the
-///     Equipment tree alongside driver tags. Value is produced by the
-///     <see cref="Script"/> referenced by <see cref="ScriptId"/>.
+///     A virtual (calculated) tag that lives in the Equipment tree alongside driver tags.
+///     Value is produced by the <see cref="Script"/> referenced by <see cref="ScriptId"/>.
 /// </summary>
 /// <remarks>
 ///     <para>
 ///         <see cref="EquipmentId"/> is mandatory — virtual tags are always scoped to an
-///         Equipment node per plan decision #2 (unified Equipment tree, not a separate
+///         Equipment node (unified Equipment tree, not a separate
 ///         /Virtual namespace). <see cref="DataType"/> matches the shape used by
 ///         <c>Tag.DataType</c>.
 ///     </para>
 ///     <para>
 ///         <see cref="ChangeTriggered"/> and <see cref="TimerIntervalMs"/> together realize
-///         plan decision #3 (change + timer). At least one must produce evaluations; the
+///         change + timer evaluation. At least one must produce evaluations; the
 ///         Core.VirtualTags engine rejects an all-disabled tag at load time.
 ///     </para>
 /// </remarks>