Improve source XML docs and refresh profiling artifacts

This captures the iterative CommentChecker cleanup plus updated snapshot/report outputs used to validate and benchmark the latest JetStream and transport work.

src/NATS.Server/Mqtt/MqttParityModels.cs

@@ -6,8 +6,11 @@ namespace NATS.Server.Mqtt;
 /// </summary>
 public sealed class MqttJsa
 {
+    /// <summary>Account that owns the MQTT JetStream operations.</summary>
     public string AccountName { get; set; } = string.Empty;
+    /// <summary>Reply subject prefix used for MQTT JetStream API calls.</summary>
     public string ReplyPrefix { get; set; } = string.Empty;
+    /// <summary>Optional JetStream domain for cross-domain routing.</summary>
     public string? Domain { get; set; }
 }
 
@@ -17,8 +20,11 @@ public sealed class MqttJsa
 /// </summary>
 public sealed class MqttJsPubMsg
 {
+    /// <summary>Target NATS subject for the publish operation.</summary>
     public string Subject { get; set; } = string.Empty;
+    /// <summary>Published payload bytes.</summary>
     public byte[] Payload { get; set; } = [];
+    /// <summary>Optional reply subject for request/reply semantics.</summary>
     public string? ReplyTo { get; set; }
 }
 
@@ -28,7 +34,9 @@ public sealed class MqttJsPubMsg
 /// </summary>
 public sealed class MqttRetMsgDel
 {
+    /// <summary>MQTT topic whose retained message should be removed.</summary>
     public string Topic { get; set; } = string.Empty;
+    /// <summary>JetStream sequence of the retained message record.</summary>
     public ulong Sequence { get; set; }
 }
 
@@ -38,8 +46,11 @@ public sealed class MqttRetMsgDel
 /// </summary>
 public sealed class MqttPersistedSession
 {
+    /// <summary>MQTT client identifier for the persisted session.</summary>
     public string ClientId { get; set; } = string.Empty;
+    /// <summary>Last issued packet identifier for this session.</summary>
     public int LastPacketId { get; set; }
+    /// <summary>Maximum number of unacknowledged QoS deliveries allowed.</summary>
     public int MaxAckPending { get; set; }
 }
 
@@ -49,7 +60,9 @@ public sealed class MqttPersistedSession
 /// </summary>
 public sealed class MqttRetainedMessageRef
 {
+    /// <summary>JetStream sequence containing the retained MQTT payload.</summary>
     public ulong StreamSequence { get; set; }
+    /// <summary>NATS subject mapped from the retained MQTT topic.</summary>
     public string Subject { get; set; } = string.Empty;
 }
 
@@ -59,10 +72,15 @@ public sealed class MqttRetainedMessageRef
 /// </summary>
 public sealed class MqttSub
 {
+    /// <summary>MQTT topic filter for this subscription.</summary>
     public string Filter { get; set; } = string.Empty;
+    /// <summary>Requested MQTT QoS level.</summary>
     public byte Qos { get; set; }
+    /// <summary>Optional JetStream durable consumer name.</summary>
     public string? JsDur { get; set; }
+    /// <summary>Indicates whether this is a permanent subscription.</summary>
     public bool Prm { get; set; }
+    /// <summary>Reserved flag kept for Go protocol parity.</summary>
     public bool Reserved { get; set; }
 }
 
@@ -72,8 +90,11 @@ public sealed class MqttSub
 /// </summary>
 public sealed class MqttFilter
 {
+    /// <summary>Original MQTT topic filter.</summary>
     public string Filter { get; set; } = string.Empty;
+    /// <summary>QoS level attached to the filter.</summary>
     public byte Qos { get; set; }
+    /// <summary>Parsed token optimization hint used for dispatch lookups.</summary>
     public string? TopicToken { get; set; }
 }
 
@@ -83,8 +104,12 @@ public sealed class MqttFilter
 /// </summary>
 public sealed class MqttParsedPublishNatsHeader
 {
+    /// <summary>Subject extracted from MQTT publish headers, when present.</summary>
     public string? Subject { get; set; }
+    /// <summary>Mapped subject after account/topic translation.</summary>
     public string? Mapped { get; set; }
+    /// <summary>Indicates the packet represents a PUBLISH flow.</summary>
     public bool IsPublish { get; set; }
+    /// <summary>Indicates the packet represents a PUBREL flow.</summary>
     public bool IsPubRel { get; set; }
 }