Harden Surreal migration with retry/coverage fixes and XML docs cleanup

src/ZB.MOM.WW.CBDDC.Persistence/Surreal/SurrealPeerOplogConfirmationStore.cs

@@ -15,6 +15,12 @@ public class SurrealPeerOplogConfirmationStore : PeerOplogConfirmationStore
     private readonly ICBDDCSurrealSchemaInitializer _schemaInitializer;
     private readonly ISurrealDbClient _surrealClient;
 
+    /// <summary>
+    ///     Initializes a new instance of the <see cref="SurrealPeerOplogConfirmationStore"/> class.
+    /// </summary>
+    /// <param name="surrealEmbeddedClient">Embedded Surreal client wrapper.</param>
+    /// <param name="schemaInitializer">Schema initializer.</param>
+    /// <param name="logger">Optional logger.</param>
     public SurrealPeerOplogConfirmationStore(
         ICBDDCSurrealEmbeddedClient surrealEmbeddedClient,
         ICBDDCSurrealSchemaInitializer schemaInitializer,
@@ -26,6 +32,7 @@ public class SurrealPeerOplogConfirmationStore : PeerOplogConfirmationStore
         _logger = logger ?? NullLogger<SurrealPeerOplogConfirmationStore>.Instance;
     }
 
+    /// <inheritdoc />
     public override async Task EnsurePeerRegisteredAsync(
         string peerNodeId,
         string address,
@@ -68,6 +75,7 @@ public class SurrealPeerOplogConfirmationStore : PeerOplogConfirmationStore
         await UpsertAsync(existing, recordId, cancellationToken);
     }
 
+    /// <inheritdoc />
     public override async Task UpdateConfirmationAsync(
         string peerNodeId,
         string sourceNodeId,
@@ -118,6 +126,7 @@ public class SurrealPeerOplogConfirmationStore : PeerOplogConfirmationStore
         await UpsertAsync(existing, recordId, cancellationToken);
     }
 
+    /// <inheritdoc />
     public override async Task<IEnumerable<PeerOplogConfirmation>> GetConfirmationsAsync(
         CancellationToken cancellationToken = default)
     {
@@ -128,6 +137,7 @@ public class SurrealPeerOplogConfirmationStore : PeerOplogConfirmationStore
             .ToList();
     }
 
+    /// <inheritdoc />
     public override async Task<IEnumerable<PeerOplogConfirmation>> GetConfirmationsForPeerAsync(
         string peerNodeId,
         CancellationToken cancellationToken = default)
@@ -143,6 +153,7 @@ public class SurrealPeerOplogConfirmationStore : PeerOplogConfirmationStore
             .ToList();
     }
 
+    /// <inheritdoc />
     public override async Task RemovePeerTrackingAsync(string peerNodeId, CancellationToken cancellationToken = default)
     {
         if (string.IsNullOrWhiteSpace(peerNodeId))
@@ -167,6 +178,7 @@ public class SurrealPeerOplogConfirmationStore : PeerOplogConfirmationStore
         }
     }
 
+    /// <inheritdoc />
     public override async Task<IEnumerable<string>> GetActiveTrackedPeersAsync(
         CancellationToken cancellationToken = default)
     {
@@ -178,18 +190,21 @@ public class SurrealPeerOplogConfirmationStore : PeerOplogConfirmationStore
             .ToList();
     }
 
+    /// <inheritdoc />
     public override async Task DropAsync(CancellationToken cancellationToken = default)
     {
         await EnsureReadyAsync(cancellationToken);
         await _surrealClient.Delete(CBDDCSurrealSchemaNames.PeerOplogConfirmationsTable, cancellationToken);
     }
 
+    /// <inheritdoc />
     public override async Task<IEnumerable<PeerOplogConfirmation>> ExportAsync(CancellationToken cancellationToken = default)
     {
         var all = await SelectAllAsync(cancellationToken);
         return all.Select(c => c.ToDomain()).ToList();
     }
 
+    /// <inheritdoc />
     public override async Task ImportAsync(IEnumerable<PeerOplogConfirmation> items,
         CancellationToken cancellationToken = default)
     {
@@ -202,6 +217,7 @@ public class SurrealPeerOplogConfirmationStore : PeerOplogConfirmationStore
         }
     }
 
+    /// <inheritdoc />
     public override async Task MergeAsync(IEnumerable<PeerOplogConfirmation> items,
         CancellationToken cancellationToken = default)
     {