=== Summary: 675 files | 7 generated | 484 fresh | 4605 untracked | 4268 adopted | 355 marked | 466 validated-ok | 2+0 stale (sig+body) | 0 skipped | 0 failed | elapsed 11:08:11.442 (40091.44s) ===

adas-core.Domain/Models/MongoModels/HistoricalConfigChanges.cs

@@ -13,6 +13,7 @@ namespace adas_core.Domain.Models.MongoModels;
 /// <remarks>
 /// This converter extends <see cref="JsonConverter"/> to provide tailored JSON conversion behavior for historical config change data.
 /// </remarks>
+/// <!-- aidoc:v1 sig=232c10f -->
 public class HistoricalConfigChanges : JsonConverter
 {
     public DateTime Time;
@@ -34,6 +35,7 @@ public class HistoricalConfigChanges : JsonConverter
     /// <param name="writer">The <see cref="JsonWriter"/> that receives the serialized JSON output.</param>
     /// <param name="value">The object to serialize. If <c>null</c>, the method does nothing.</param>
     /// <param name="serializer">The <see cref="JsonSerializer"/> used during serialization.</param>
+    /// <!-- aidoc:v1 sig=0bafa81 body=a8323de -->
     public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer)
         {
             if (value != null)
@@ -50,6 +52,7 @@ public class HistoricalConfigChanges : JsonConverter
     /// </summary>
     /// <param name="value">The object instance whose type defines the target property.</param>
     /// <param name="propertyName">The name of the property to which the converter attribute should be added.</param>
+    /// <!-- aidoc:v1 sig=02b15d7 body=a196735 -->
     private static void AddStringEnumConverterAttribute(object value, string propertyName)
         {
             var prop = value.GetType().GetProperty(propertyName);
@@ -84,6 +87,7 @@ public class HistoricalConfigChanges : JsonConverter
     /// <param name="serializer">The <see cref="JsonSerializer"/> used to deserialize nested objects.</param>
     /// <returns>The deserialized object value.</returns>
     /// <exception cref="NotImplementedException">Always thrown because the method has not been implemented.</exception>
+    /// <!-- aidoc:v1 sig=c91c541 body=bfa6f2f -->
     public override object ReadJson(JsonReader reader, Type objectType, object? existingValue,
             JsonSerializer serializer)
         {
@@ -96,6 +100,8 @@ public class HistoricalConfigChanges : JsonConverter
     /// <param name="objectType">The type to evaluate for convertibility.</param>
     /// <returns><see langword="true"/> when the converter supports <paramref name="objectType"/>; otherwise, <see langword="false"/>.</returns>
     /// <exception cref="NotImplementedException">Thrown in all cases because the method body is not implemented.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "The method always throws NotImplementedException and never actually returns true or false; the <returns> tag implies a boolean outcome that never occurs." -->
     public override bool CanConvert(Type objectType)
         {
             throw new NotImplementedException();