Expand XML docs across bridge and test code

tests/ZB.MOM.WW.LmxOpcUa.Tests/MxAccess/MxAccessClientSubscriptionTests.cs

@@ -11,6 +11,9 @@ using ZB.MOM.WW.LmxOpcUa.Tests.Helpers;
 
 namespace ZB.MOM.WW.LmxOpcUa.Tests.MxAccess
 {
+    /// <summary>
+    /// Verifies how the MXAccess client manages persistent subscriptions, reconnect replay, and probe-tag behavior.
+    /// </summary>
     public class MxAccessClientSubscriptionTests : IDisposable
     {
         private readonly StaComThread _staThread;
@@ -18,6 +21,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.MxAccess
         private readonly PerformanceMetrics _metrics;
         private readonly MxAccessClient _client;
 
+        /// <summary>
+        /// Initializes the subscription test fixture with a fake runtime proxy and STA thread.
+        /// </summary>
         public MxAccessClientSubscriptionTests()
         {
             _staThread = new StaComThread();
@@ -27,6 +33,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.MxAccess
             _client = new MxAccessClient(_staThread, _proxy, new MxAccessConfiguration(), _metrics);
         }
 
+        /// <summary>
+        /// Disposes the subscription test fixture and its supporting resources.
+        /// </summary>
         public void Dispose()
         {
             _client.Dispose();
@@ -34,6 +43,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.MxAccess
             _metrics.Dispose();
         }
 
+        /// <summary>
+        /// Confirms that subscribing creates a runtime item, advises it, and increments the active subscription count.
+        /// </summary>
         [Fact]
         public async Task Subscribe_CreatesItemAndAdvises()
         {
@@ -45,6 +57,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.MxAccess
             _client.ActiveSubscriptionCount.ShouldBe(1);
         }
 
+        /// <summary>
+        /// Confirms that unsubscribing clears the active subscription count after a tag was previously monitored.
+        /// </summary>
         [Fact]
         public async Task Unsubscribe_RemovesItemAndUnadvises()
         {
@@ -55,6 +70,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.MxAccess
             _client.ActiveSubscriptionCount.ShouldBe(0);
         }
 
+        /// <summary>
+        /// Confirms that runtime data changes are delivered to the per-subscription callback.
+        /// </summary>
         [Fact]
         public async Task OnDataChange_InvokesCallback()
         {
@@ -70,6 +88,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.MxAccess
             received.Value.Quality.ShouldBe(Quality.Good);
         }
 
+        /// <summary>
+        /// Confirms that runtime data changes are also delivered to the client's global tag-change event.
+        /// </summary>
         [Fact]
         public async Task OnDataChange_InvokesGlobalHandler()
         {
@@ -84,6 +105,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.MxAccess
             globalAddr.ShouldBe("TestTag.Attr");
         }
 
+        /// <summary>
+        /// Confirms that stored subscriptions are replayed after reconnect so live updates resume automatically.
+        /// </summary>
         [Fact]
         public async Task StoredSubscriptions_ReplayedAfterReconnect()
         {
@@ -102,6 +126,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.MxAccess
             callbackInvoked.ShouldBe(true);
         }
 
+        /// <summary>
+        /// Confirms that one-shot reads do not remove persistent subscriptions when the client reconnects.
+        /// </summary>
         [Fact]
         public async Task OneShotRead_DoesNotRemovePersistentSubscription_OnReconnect()
         {
@@ -122,6 +149,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.MxAccess
             _client.ActiveSubscriptionCount.ShouldBe(1);
         }
 
+        /// <summary>
+        /// Confirms that transient writes do not prevent later removal of a persistent subscription.
+        /// </summary>
         [Fact]
         public async Task OneShotWrite_DoesNotBreakPersistentUnsubscribe()
         {
@@ -138,6 +168,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.MxAccess
             _proxy.Items.Values.ShouldNotContain("TestTag.Attr");
         }
 
+        /// <summary>
+        /// Confirms that the configured probe tag is subscribed during connect so connectivity monitoring can start immediately.
+        /// </summary>
         [Fact]
         public async Task ProbeTag_SubscribedOnConnect()
         {
@@ -152,6 +185,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.MxAccess
             client.Dispose();
         }
 
+        /// <summary>
+        /// Confirms that the probe tag cannot be unsubscribed accidentally because it is reserved for connection monitoring.
+        /// </summary>
         [Fact]
         public async Task ProbeTag_ProtectedFromUnsubscribe()
         {