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.Commons/OpcUa/DeferredAddressSpaceSink.cs

@@ -22,85 +22,49 @@ public sealed class DeferredAddressSpaceSink : IOpcUaAddressSpaceSink, ISurgical
     public void SetSink(IOpcUaAddressSpaceSink? sink) =>
         _inner = sink ?? NullOpcUaAddressSpaceSink.Instance;
 
-    /// <summary>Writes a value to the OPC UA address space through the inner sink.</summary>
-    /// <param name="nodeId">The node ID of the variable.</param>
-    /// <param name="value">The value to write.</param>
-    /// <param name="quality">The OPC UA quality value.</param>
-    /// <param name="sourceTimestampUtc">The source timestamp in UTC.</param>
+    /// <inheritdoc />
     public void WriteValue(string nodeId, object? value, OpcUaQuality quality, DateTime sourceTimestampUtc)
         => _inner.WriteValue(nodeId, value, quality, sourceTimestampUtc);
 
-    /// <summary>Writes a full alarm-condition state through the inner sink.</summary>
-    /// <param name="alarmNodeId">The node ID of the alarm condition.</param>
-    /// <param name="state">The full condition state to project onto the node.</param>
-    /// <param name="sourceTimestampUtc">The source timestamp in UTC.</param>
+    /// <inheritdoc />
     public void WriteAlarmCondition(string alarmNodeId, AlarmConditionSnapshot state, DateTime sourceTimestampUtc)
         => _inner.WriteAlarmCondition(alarmNodeId, state, sourceTimestampUtc);
 
-    /// <summary>Materialises a real Part 9 alarm-condition node through the inner sink.</summary>
-    /// <param name="alarmNodeId">The alarm node ID (== ScriptedAlarmId).</param>
-    /// <param name="equipmentNodeId">The equipment folder node ID the condition parents under.</param>
-    /// <param name="displayName">The human-readable condition name.</param>
-    /// <param name="alarmType">The domain alarm type.</param>
-    /// <param name="severity">The domain severity.</param>
-    /// <param name="isNative">True for a driver-fed (native) equipment-tag alarm; false (default) for a scripted alarm.</param>
+    /// <inheritdoc />
     public void MaterialiseAlarmCondition(string alarmNodeId, string equipmentNodeId, string displayName, string alarmType, int severity, bool isNative = false)
         => _inner.MaterialiseAlarmCondition(alarmNodeId, equipmentNodeId, displayName, alarmType, severity, isNative);
 
-    /// <summary>Ensures a folder exists in the address space through the inner sink.</summary>
-    /// <param name="folderNodeId">The node ID of the folder.</param>
-    /// <param name="parentNodeId">The node ID of the parent folder, or null for root.</param>
-    /// <param name="displayName">The display name of the folder.</param>
+    /// <inheritdoc />
     public void EnsureFolder(string folderNodeId, string? parentNodeId, string displayName)
         => _inner.EnsureFolder(folderNodeId, parentNodeId, displayName);
 
-    /// <summary>Ensures a variable exists in the address space through the inner sink.</summary>
-    /// <param name="variableNodeId">The node ID of the variable.</param>
-    /// <param name="parentFolderNodeId">The node ID of the parent folder, or null for root.</param>
-    /// <param name="displayName">The display name of the variable.</param>
-    /// <param name="dataType">The OPC UA data type of the variable.</param>
-    /// <param name="writable">When true the node is created read/write; otherwise read-only.</param>
-    /// <param name="historianTagname">null ⇒ not historized; non-null ⇒ create Historizing with the
-    /// HistoryRead access bit and register the historian tagname.</param>
-    /// <param name="isArray">When true the node is created as a 1-D array; when false (default) scalar.</param>
-    /// <param name="arrayLength">The declared length of the 1-D array when <paramref name="isArray"/> is true.</param>
+    /// <inheritdoc />
     public void EnsureVariable(string variableNodeId, string? parentFolderNodeId, string displayName, string dataType, bool writable, string? historianTagname = null, bool isArray = false, uint? arrayLength = null)
         => _inner.EnsureVariable(variableNodeId, parentFolderNodeId, displayName, dataType, writable, historianTagname, isArray, arrayLength);
 
-    /// <summary>Rebuilds the address space through the inner sink.</summary>
+    /// <inheritdoc />
     public void RebuildAddressSpace() => _inner.RebuildAddressSpace();
 
-    /// <summary>Announces a runtime NodeAdded model-change (discovered-node injection) through the inner sink.</summary>
-    /// <param name="affectedNodeId">The node under which discovered nodes were added.</param>
+    /// <inheritdoc />
     public void RaiseNodesAddedModelChange(string affectedNodeId) => _inner.RaiseNodesAddedModelChange(affectedNodeId);
 
-    /// <summary>Forwards an in-place tag-attribute update (F10b) to the inner sink when it supports the
-    /// surgical capability. Returns false otherwise — before the real <c>SdkAddressSpaceSink</c> is
-    /// swapped in (inner is still the null sink), or any inner sink that isn't surgical — so the caller
-    /// (AddressSpaceApplier) falls back to a full rebuild. Without this forward the surgical optimization is
-    /// inert on every driver-role host, because actors inject THIS wrapper, not the inner sink. ALL six args
-    /// (including the FB-7 DataType/array-shape ones) MUST be forwarded — a partial forward silently drops the
-    /// shape update on every driver-role host.</summary>
-    /// <param name="variableNodeId">The node ID of the variable to update in place.</param>
-    /// <param name="writable">Whether the node should be read/write.</param>
-    /// <param name="historianTagname">null ⇒ not historized; non-null ⇒ Historizing + historian binding.</param>
-    /// <param name="dataType">The OPC UA built-in data type name to apply in place.</param>
-    /// <param name="isArray">When true the node becomes a 1-D array; when false scalar.</param>
-    /// <param name="arrayLength">The declared length of the 1-D array when <paramref name="isArray"/> is true.</param>
-    /// <returns>True when the inner sink applied the update; false when it lacks the capability or the node is missing.</returns>
+    /// <inheritdoc />
+    // Forwards to the inner sink when it supports the surgical capability; returns false otherwise —
+    // before the real SdkAddressSpaceSink is swapped in (inner is still the null sink), or any inner
+    // sink that isn't surgical — so the caller (AddressSpaceApplier) falls back to a full rebuild.
+    // Without this forward the surgical optimization is inert on every driver-role host, because
+    // actors inject THIS wrapper, not the inner sink. ALL six args (including the DataType/array-shape
+    // ones) MUST be forwarded — a partial forward silently drops the shape update on every driver-role host.
     public bool UpdateTagAttributes(string variableNodeId, bool writable, string? historianTagname, string dataType, bool isArray, uint? arrayLength)
         => _inner is ISurgicalAddressSpaceSink surgical
            && surgical.UpdateTagAttributes(variableNodeId, writable, historianTagname, dataType, isArray, arrayLength);
 
-    /// <summary>Forwards an in-place folder-display-name update (OpcUaServer-001 — UNS Area / Line
-    /// rename) to the inner sink when it supports the surgical capability. Returns false otherwise —
-    /// before the real <c>SdkAddressSpaceSink</c> is swapped in (inner is still the null sink), or any
-    /// inner sink that isn't surgical — so the caller (AddressSpaceApplier) falls back to a full rebuild.
-    /// Without this forward the rename-refresh optimization is inert on every driver-role host, because
-    /// actors inject THIS wrapper, not the inner sink.</summary>
-    /// <param name="folderNodeId">The folder node id whose display name to update in place.</param>
-    /// <param name="displayName">The new display name to apply.</param>
-    /// <returns>True when the inner sink applied the update; false when it lacks the capability or the folder is missing.</returns>
+    /// <inheritdoc />
+    // Forwards to the inner sink when it supports the surgical capability; returns false otherwise —
+    // before the real SdkAddressSpaceSink is swapped in (inner is still the null sink), or any inner
+    // sink that isn't surgical — so the caller (AddressSpaceApplier) falls back to a full rebuild.
+    // Without this forward the rename-refresh optimization is inert on every driver-role host, because
+    // actors inject THIS wrapper, not the inner sink.
     public bool UpdateFolderDisplayName(string folderNodeId, string displayName)
         => _inner is ISurgicalAddressSpaceSink surgical
            && surgical.UpdateFolderDisplayName(folderNodeId, displayName);