Fix audit findings for coverage, architecture checks, and XML docs

tests/CBDD.Tests/StorageEngineTransactionProtocolTests.cs

@@ -5,6 +5,9 @@ namespace ZB.MOM.WW.CBDD.Tests;
 
 public class StorageEngineTransactionProtocolTests
 {
+    /// <summary>
+    /// Verifies preparing an unknown transaction returns false.
+    /// </summary>
     [Fact]
     public void PrepareTransaction_Should_ReturnFalse_For_Unknown_Transaction()
     {
@@ -20,6 +23,9 @@ public class StorageEngineTransactionProtocolTests
         }
     }
 
+    /// <summary>
+    /// Verifies committing a detached transaction object throws.
+    /// </summary>
     [Fact]
     public void CommitTransaction_With_TransactionObject_Should_Throw_When_Not_Active()
     {
@@ -37,6 +43,9 @@ public class StorageEngineTransactionProtocolTests
         }
     }
 
+    /// <summary>
+    /// Verifies committing a transaction object persists writes and clears active state.
+    /// </summary>
     [Fact]
     public void CommitTransaction_With_TransactionObject_Should_Commit_Writes()
     {
@@ -65,6 +74,9 @@ public class StorageEngineTransactionProtocolTests
         }
     }
 
+    /// <summary>
+    /// Verifies committing by identifier with no writes does not throw.
+    /// </summary>
     [Fact]
     public void CommitTransaction_ById_With_NoWrites_Should_Not_Throw()
     {
@@ -80,6 +92,9 @@ public class StorageEngineTransactionProtocolTests
         }
     }
 
+    /// <summary>
+    /// Verifies committed transaction cache moves into readable state and active count is cleared.
+    /// </summary>
     [Fact]
     public void MarkTransactionCommitted_Should_Move_Cache_And_Clear_ActiveCount()
     {
@@ -108,6 +123,9 @@ public class StorageEngineTransactionProtocolTests
         }
     }
 
+    /// <summary>
+    /// Verifies rollback discards uncommitted page writes.
+    /// </summary>
     [Fact]
     public void RollbackTransaction_Should_Discard_Uncommitted_Write()
     {
@@ -140,6 +158,9 @@ public class StorageEngineTransactionProtocolTests
         }
     }
 
+    /// <summary>
+    /// Verifies marking a transaction committed transitions state correctly.
+    /// </summary>
     [Fact]
     public void Transaction_MarkCommitted_Should_Transition_State()
     {
@@ -169,6 +190,9 @@ public class StorageEngineTransactionProtocolTests
         }
     }
 
+    /// <summary>
+    /// Verifies preparing then committing writes WAL data and updates transaction state.
+    /// </summary>
     [Fact]
     public void Transaction_Prepare_Should_Write_Wal_And_Transition_State()
     {