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

tests/CBDD.Tests/DictionaryPersistenceTests.cs

@@ -13,12 +13,18 @@ public class DictionaryPersistenceTests : IDisposable
     private readonly string _dbPath;
     private readonly StorageEngine _storage;
 
+    /// <summary>
+    /// Initializes a new instance of the <see cref="DictionaryPersistenceTests"/> class.
+    /// </summary>
     public DictionaryPersistenceTests()
     {
         _dbPath = Path.Combine(Path.GetTempPath(), $"cbdd_dict_{Guid.NewGuid():N}.db");
         _storage = new StorageEngine(_dbPath, PageFileConfig.Default);
     }
 
+    /// <summary>
+    /// Disposes test resources and removes temporary files.
+    /// </summary>
     public void Dispose()
     {
         _storage.Dispose();
@@ -32,22 +38,41 @@ public class DictionaryPersistenceTests : IDisposable
         private readonly string _collectionName;
         private readonly List<string> _keys;
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="MockMapper"/> class.
+        /// </summary>
+        /// <param name="name">The collection name.</param>
+        /// <param name="keys">The mapper keys.</param>
         public MockMapper(string name, params string[] keys)
         {
             _collectionName = name;
             _keys = keys.ToList();
         }
 
+        /// <inheritdoc />
         public override string CollectionName => _collectionName;
+        /// <inheritdoc />
         public override IEnumerable<string> UsedKeys => _keys;
 
+        /// <inheritdoc />
         public override BsonSchema GetSchema() => new BsonSchema { Title = _collectionName };
+
+        /// <inheritdoc />
         public override ObjectId GetId(Dictionary<string, object> entity) => throw new NotImplementedException();
+
+        /// <inheritdoc />
         public override void SetId(Dictionary<string, object> entity, ObjectId id) => throw new NotImplementedException();
+
+        /// <inheritdoc />
         public override int Serialize(Dictionary<string, object> entity, BsonSpanWriter writer) => throw new NotImplementedException();
+
+        /// <inheritdoc />
         public override Dictionary<string, object> Deserialize(BsonSpanReader reader) => throw new NotImplementedException();
     }
 
+    /// <summary>
+    /// Verifies mapper registration adds all unique dictionary keys.
+    /// </summary>
     [Fact]
     public void RegisterMappers_Registers_All_Unique_Keys()
     {
@@ -73,6 +98,9 @@ public class DictionaryPersistenceTests : IDisposable
         ids.Count.ShouldBe(4);
     }
 
+    /// <summary>
+    /// Verifies dictionary keys persist across storage restarts.
+    /// </summary>
     [Fact]
     public void Dictionary_Keys_Persist_Across_Restarts()
     {
@@ -93,7 +121,10 @@ public class DictionaryPersistenceTests : IDisposable
 
     private class NestedMockMapper : DocumentMapperBase<ObjectId, object>
     {
+        /// <inheritdoc />
         public override string CollectionName => "Nested";
+
+        /// <inheritdoc />
         public override BsonSchema GetSchema()
         {
             var schema = new BsonSchema { Title = "Nested" };
@@ -109,12 +140,22 @@ public class DictionaryPersistenceTests : IDisposable
             return schema;
         }
 
+        /// <inheritdoc />
         public override ObjectId GetId(object entity) => throw new NotImplementedException();
+
+        /// <inheritdoc />
         public override void SetId(object entity, ObjectId id) => throw new NotImplementedException();
+
+        /// <inheritdoc />
         public override int Serialize(object entity, BsonSpanWriter writer) => throw new NotImplementedException();
+
+        /// <inheritdoc />
         public override object Deserialize(BsonSpanReader reader) => throw new NotImplementedException();
     }
 
+    /// <summary>
+    /// Verifies nested schema fields are registered as dictionary keys.
+    /// </summary>
     [Fact]
     public void RegisterMappers_Handles_Nested_Keys()
     {