Expand XML docs across bridge and test code

tests/ZB.MOM.WW.LmxOpcUa.Tests/OpcUa/LmxNodeManagerBuildTests.cs

@@ -6,8 +6,15 @@ using ZB.MOM.WW.LmxOpcUa.Host.OpcUa;
 
 namespace ZB.MOM.WW.LmxOpcUa.Tests.OpcUa
 {
+    /// <summary>
+    /// Verifies the in-memory address-space model built from Galaxy hierarchy and attribute rows.
+    /// </summary>
     public class LmxNodeManagerBuildTests
     {
+        /// <summary>
+        /// Creates representative Galaxy hierarchy and attribute rows for address-space builder tests.
+        /// </summary>
+        /// <returns>The hierarchy and attribute rows used by the tests.</returns>
         private static (List<GalaxyObjectInfo> hierarchy, List<GalaxyAttributeInfo> attributes) CreateTestData()
         {
             var hierarchy = new List<GalaxyObjectInfo>
@@ -29,6 +36,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.OpcUa
             return (hierarchy, attributes);
         }
 
+        /// <summary>
+        /// Confirms that object and variable counts are computed correctly from the seeded Galaxy model.
+        /// </summary>
         [Fact]
         public void BuildAddressSpace_CreatesCorrectNodeCounts()
         {
@@ -39,6 +49,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.OpcUa
             model.VariableCount.ShouldBe(4); // MachineID, DownloadPath, JobStepNumber, BatchItems
         }
 
+        /// <summary>
+        /// Confirms that runtime tag references are populated for every published variable.
+        /// </summary>
         [Fact]
         public void BuildAddressSpace_TagReferencesPopulated()
         {
@@ -51,6 +64,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.OpcUa
             model.NodeIdToTagReference.ContainsKey("TestMachine_001.BatchItems[]").ShouldBe(true);
         }
 
+        /// <summary>
+        /// Confirms that array attributes are represented in the tag-reference map.
+        /// </summary>
         [Fact]
         public void BuildAddressSpace_ArrayVariable_HasCorrectInfo()
         {
@@ -60,6 +76,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.OpcUa
             model.NodeIdToTagReference.ContainsKey("TestMachine_001.BatchItems[]").ShouldBe(true);
         }
 
+        /// <summary>
+        /// Confirms that Galaxy areas are not counted as object nodes in the resulting model.
+        /// </summary>
         [Fact]
         public void BuildAddressSpace_Areas_AreNotCountedAsObjects()
         {
@@ -73,6 +92,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.OpcUa
             model.ObjectCount.ShouldBe(1); // Only Obj1, not Area1
         }
 
+        /// <summary>
+        /// Confirms that only top-level Galaxy nodes are returned as roots in the model.
+        /// </summary>
         [Fact]
         public void BuildAddressSpace_RootNodes_AreTopLevel()
         {
@@ -86,6 +108,9 @@ namespace ZB.MOM.WW.LmxOpcUa.Tests.OpcUa
             model.RootNodes.Count.ShouldBe(1); // Only Root1 is a root
         }
 
+        /// <summary>
+        /// Confirms that variables for multiple MX data types are included in the model.
+        /// </summary>
         [Fact]
         public void BuildAddressSpace_DataTypeMappings()
         {