Add XML documentation across gateway, worker, and .NET client

src/MxGateway.IntegrationTests/Galaxy/GalaxyRepositoryLiveTests.cs

@@ -4,6 +4,7 @@ namespace MxGateway.IntegrationTests.Galaxy;
 
 public sealed class GalaxyRepositoryLiveTests
 {
+    /// <summary>Verifies that the Galaxy Repository can establish a live connection to the ZB database.</summary>
     [LiveGalaxyRepositoryFact]
     [Trait("Category", "LiveGalaxy")]
     public async Task TestConnection_AgainstZb_Succeeds()
@@ -15,6 +16,7 @@ public sealed class GalaxyRepositoryLiveTests
         Assert.True(ok, "TestConnectionAsync should return true against the ZB database.");
     }
 
+    /// <summary>Verifies that the last deploy time can be retrieved from the ZB database.</summary>
     [LiveGalaxyRepositoryFact]
     [Trait("Category", "LiveGalaxy")]
     public async Task GetLastDeployTime_AgainstZb_ReturnsTimestamp()
@@ -26,6 +28,7 @@ public sealed class GalaxyRepositoryLiveTests
         Assert.NotNull(lastDeploy);
     }
 
+    /// <summary>Verifies that the hierarchy can be retrieved from the ZB database.</summary>
     [LiveGalaxyRepositoryFact]
     [Trait("Category", "LiveGalaxy")]
     public async Task GetHierarchy_AgainstZb_ReturnsObjects()
@@ -43,6 +46,7 @@ public sealed class GalaxyRepositoryLiveTests
         });
     }
 
+    /// <summary>Verifies that object attributes can be retrieved from the ZB database.</summary>
     [LiveGalaxyRepositoryFact]
     [Trait("Category", "LiveGalaxy")]
     public async Task GetAttributes_AgainstZb_ReturnsAtLeastOneAttribute()

src/MxGateway.IntegrationTests/Galaxy/LiveGalaxyRepositoryFactAttribute.cs

@@ -1,10 +1,14 @@
 namespace MxGateway.IntegrationTests.Galaxy;
 
+/// <summary>Fact attribute that skips tests unless live Galaxy Repository tests are explicitly enabled.</summary>
 public sealed class LiveGalaxyRepositoryFactAttribute : FactAttribute
 {
+    /// <summary>Environment variable name to enable live Galaxy Repository tests.</summary>
     public const string EnableVariableName = "MXGATEWAY_RUN_LIVE_GALAXY_TESTS";
+    /// <summary>Environment variable name for the Galaxy Repository connection string.</summary>
     public const string ConnectionStringVariableName = "MXGATEWAY_LIVE_GALAXY_CONN";
 
+    /// <summary>Initializes a new instance of the LiveGalaxyRepositoryFactAttribute class.</summary>
     public LiveGalaxyRepositoryFactAttribute()
     {
         if (!Enabled)
@@ -13,12 +17,14 @@ public sealed class LiveGalaxyRepositoryFactAttribute : FactAttribute
         }
     }
 
+    /// <summary>Gets a value indicating whether live Galaxy Repository tests are enabled.</summary>
     public static bool Enabled =>
         string.Equals(
             Environment.GetEnvironmentVariable(EnableVariableName),
             "1",
             StringComparison.Ordinal);
 
+    /// <summary>Gets the Galaxy Repository connection string from environment or default.</summary>
     public static string ConnectionString =>
         Environment.GetEnvironmentVariable(ConnectionStringVariableName)
             ?? "Server=localhost;Database=ZB;Integrated Security=True;TrustServerCertificate=True;Encrypt=False;";