Add XML docs required by CommentChecker fixes

tests/ZB.MOM.WW.CBDDC.Sample.Console.Tests/LmdbOplogMigrationTests.cs

@@ -12,6 +12,9 @@ namespace ZB.MOM.WW.CBDDC.Sample.Console.Tests;
 
 public class LmdbOplogMigrationTests
 {
+    /// <summary>
+    ///     Verifies dual-write mode writes each entry to both Surreal and LMDB stores.
+    /// </summary>
     [Fact]
     public async Task FeatureFlags_DualWrite_WritesToBothStores()
     {
@@ -39,6 +42,9 @@ public class LmdbOplogMigrationTests
         (await lmdbStore.GetEntryByHashAsync(entry.Hash)).ShouldNotBeNull();
     }
 
+    /// <summary>
+    ///     Verifies preferred LMDB reads reconcile missing LMDB data from Surreal.
+    /// </summary>
     [Fact]
     public async Task FeatureFlags_PreferLmdbReads_ReconcilesFromSurrealWhenLmdbMissingEntries()
     {
@@ -78,6 +84,9 @@ public class LmdbOplogMigrationTests
         telemetry.ReconciledEntries.ShouldBeGreaterThanOrEqualTo(1);
     }
 
+    /// <summary>
+    ///     Verifies shadow validation records mismatches when LMDB and Surreal diverge.
+    /// </summary>
     [Fact]
     public async Task FeatureFlags_ShadowValidation_RecordsMismatchTelemetry()
     {
@@ -112,6 +121,9 @@ public class LmdbOplogMigrationTests
         snapshot.ShadowMismatches.ShouldBe(1);
     }
 
+    /// <summary>
+    ///     Verifies rollback to Surreal when dual-write is disabled uses Surreal for all writes and reads.
+    /// </summary>
     [Fact]
     public async Task FeatureFlags_RollbackToSurreal_UsesSurrealForWritesAndReads()
     {
@@ -143,6 +155,9 @@ public class LmdbOplogMigrationTests
         routedRead.Hash.ShouldBe(entry.Hash);
     }
 
+    /// <summary>
+    ///     Verifies backfill succeeds and records matching dataset counts.
+    /// </summary>
     [Fact]
     public async Task BackfillTool_BackfillAndValidate_ReportsSuccess()
     {
@@ -173,6 +188,9 @@ public class LmdbOplogMigrationTests
         report.DestinationCount.ShouldBe(4);
     }
 
+    /// <summary>
+    ///     Verifies backfill can target non-primary datasets successfully.
+    /// </summary>
     [Fact]
     public async Task BackfillTool_BackfillAndValidate_WorksPerDataset()
     {