Add XML documentation to all public APIs

Added comprehensive XML documentation comments to all public interfaces,
classes, constructors, methods, and fields to satisfy CS1591 requirements.

Changes:
- Documented 20 service interfaces with summary and method descriptions
- Documented 20 service implementations with class and method descriptions
- Added parameter and return value documentation for all public methods
- Documented public fields in HpService and MpService
- All 91 public members now have proper XML documentation

Author: claude

src/NosCore.Algorithm/CloseDefenceService/CloseDefenceService.cs

@@ -2,10 +2,16 @@
 
 namespace NosCore.Algorithm.CloseDefenceService
 {
+    /// <summary>
+    /// Provides close combat defence value calculations for different character classes and levels
+    /// </summary>
     public class CloseDefenceService : ICloseDefenceService
     {
         private readonly long[,] _closeDefence = new long[Constants.ClassCount, Constants.MaxLevel];
 
+        /// <summary>
+        /// Initializes a new instance of the CloseDefenceService and pre-calculates close defence values for all character classes and levels
+        /// </summary>
         public CloseDefenceService()
         {
             var adventurerDefence = 4;
@@ -34,6 +40,12 @@ public CloseDefenceService()
             }
         }
 
+        /// <summary>
+        /// Gets the close defence value for a character class at a specific level
+        /// </summary>
+        /// <param name="class">The character class type</param>
+        /// <param name="level">The character level</param>
+        /// <returns>The close defence value</returns>
         public long GetCloseDefence(CharacterClassType @class, byte level)
         {
             return _closeDefence![(byte)@class, level - 1];

src/NosCore.Algorithm/CloseDefenceService/ICloseDefenceService.cs

@@ -5,8 +5,17 @@
 
 namespace NosCore.Algorithm.CloseDefenceService
 {
+    /// <summary>
+    /// Service for calculating close combat defence values
+    /// </summary>
     public interface ICloseDefenceService
     {
+        /// <summary>
+        /// Gets the close defence value for a character class at a specific level
+        /// </summary>
+        /// <param name="entityClass">The character class type</param>
+        /// <param name="level">The character level</param>
+        /// <returns>The close defence value</returns>
         long GetCloseDefence(CharacterClassType entityClass, byte level);
     }
 }

src/NosCore.Algorithm/DamageService/DamageService.cs

@@ -8,10 +8,16 @@
 
 namespace NosCore.Algorithm.DamageService
 {
+    /// <summary>
+    /// Provides damage value calculations for different character classes and levels
+    /// </summary>
     public class DamageService : IDamageService
     {
         private readonly long[,] _minDamage = new long[Constants.ClassCount, Constants.MaxLevel];
 
+        /// <summary>
+        /// Initializes a new instance of the DamageService and pre-calculates damage values for all character classes and levels
+        /// </summary>
         public DamageService()
         {
             _minDamage[(byte)CharacterClassType.Adventurer, 0] = 10;
@@ -76,11 +82,23 @@ public DamageService()
             }
         }
 
+        /// <summary>
+        /// Gets the minimum damage value for a character class at a specific level
+        /// </summary>
+        /// <param name="class">The character class type</param>
+        /// <param name="level">The character level</param>
+        /// <returns>The minimum damage value</returns>
         public long GetMinDamage(CharacterClassType @class, byte level)
         {
             return _minDamage![(byte)@class, level - 1];
         }
 
+        /// <summary>
+        /// Gets the maximum damage value for a character class at a specific level
+        /// </summary>
+        /// <param name="class">The character class type</param>
+        /// <param name="level">The character level</param>
+        /// <returns>The maximum damage value</returns>
         public long GetMaxDamage(CharacterClassType @class, byte level) => GetMinDamage(@class, level);
     }
 }

src/NosCore.Algorithm/DamageService/IDamageService.cs

@@ -8,10 +8,25 @@
 
 namespace NosCore.Algorithm.DamageService
 {
+    /// <summary>
+    /// Service for calculating damage values for different character classes
+    /// </summary>
     public interface IDamageService
     {
+        /// <summary>
+        /// Gets the minimum damage value for a character class at a specific level
+        /// </summary>
+        /// <param name="entityClass">The character class type</param>
+        /// <param name="level">The character level</param>
+        /// <returns>The minimum damage value</returns>
         long GetMinDamage(CharacterClassType entityClass, byte level);
 
+        /// <summary>
+        /// Gets the maximum damage value for a character class at a specific level
+        /// </summary>
+        /// <param name="entityClass">The character class type</param>
+        /// <param name="level">The character level</param>
+        /// <returns>The maximum damage value</returns>
         long GetMaxDamage(CharacterClassType entityClass, byte level);
     }
 }

src/NosCore.Algorithm/DignityService/DignityService.cs

@@ -11,10 +11,16 @@
 
 namespace NosCore.Algorithm.DignityService
 {
+    /// <summary>
+    /// Provides dignity level and threshold calculations
+    /// </summary>
     public class DignityService : IDignityService
     {
         private readonly Dictionary<DignityType, short> _dignityData = new Dictionary<DignityType, short>();
 
+        /// <summary>
+        /// Initializes a new instance of the DignityService and sets up dignity thresholds for each dignity type
+        /// </summary>
         public DignityService()
         {
             _dignityData[DignityType.Default] = -99;
@@ -25,6 +31,11 @@ public DignityService()
             _dignityData[DignityType.Failed] = -1000;
         }
 
+        /// <summary>
+        /// Gets the dignity level type based on a dignity value
+        /// </summary>
+        /// <param name="dignity">The dignity value</param>
+        /// <returns>The dignity level type</returns>
         public DignityType GetLevelFromDignity(short dignity)
         {
             foreach (var reput in Enum.GetValues(typeof(DignityType)).Cast<DignityType>())
@@ -38,6 +49,11 @@ public DignityType GetLevelFromDignity(short dignity)
             return DignityType.Failed;
         }
 
+        /// <summary>
+        /// Gets the dignity value range for a specific dignity level
+        /// </summary>
+        /// <param name="level">The dignity level type</param>
+        /// <returns>A tuple containing the maximum and minimum dignity values for the level</returns>
         public (short, short) GetDignity(DignityType level)
         {
             return (level == DignityType.Default ? (short)200 : (short)(_dignityData[level - 1] - 1), _dignityData[level]);

src/NosCore.Algorithm/DignityService/IDignityService.cs

@@ -8,9 +8,23 @@
 
 namespace NosCore.Algorithm.DignityService
 {
+    /// <summary>
+    /// Service for calculating dignity levels and thresholds
+    /// </summary>
     public interface IDignityService
     {
+        /// <summary>
+        /// Gets the dignity level type based on a dignity value
+        /// </summary>
+        /// <param name="dignity">The dignity value</param>
+        /// <returns>The dignity level type</returns>
         DignityType GetLevelFromDignity(short dignity);
+
+        /// <summary>
+        /// Gets the dignity value range for a specific dignity level
+        /// </summary>
+        /// <param name="level">The dignity level type</param>
+        /// <returns>A tuple containing the maximum and minimum dignity values for the level</returns>
         (short, short) GetDignity(DignityType level);
     }
 }

src/NosCore.Algorithm/DistanceDefenceService/DistanceDefenceService.cs

@@ -2,10 +2,16 @@
 
 namespace NosCore.Algorithm.DistanceDefenceService
 {
+    /// <summary>
+    /// Provides distance combat defence value calculations for different character classes and levels
+    /// </summary>
     public class DistanceDefenceService : IDistanceDefenceService
     {
         private readonly long[,] _distanceDefence = new long[Constants.ClassCount, Constants.MaxLevel];
 
+        /// <summary>
+        /// Initializes a new instance of the DistanceDefenceService and pre-calculates distance defence values for all character classes and levels
+        /// </summary>
         public DistanceDefenceService()
         {
             var adventurerDefence = 4;
@@ -32,6 +38,12 @@ public DistanceDefenceService()
             }
         }
 
+        /// <summary>
+        /// Gets the distance defence value for a character class at a specific level
+        /// </summary>
+        /// <param name="class">The character class type</param>
+        /// <param name="level">The character level</param>
+        /// <returns>The distance defence value</returns>
         public long GetDistanceDefence(CharacterClassType @class, byte level)
         {
             return _distanceDefence![(byte)@class, level - 1];

src/NosCore.Algorithm/DistanceDefenceService/IDistanceDefenceService.cs

@@ -5,8 +5,17 @@
 
 namespace NosCore.Algorithm.DistanceDefenceService
 {
+    /// <summary>
+    /// Service for calculating distance combat defence values
+    /// </summary>
     public interface IDistanceDefenceService
     {
+        /// <summary>
+        /// Gets the distance defence value for a character class at a specific level
+        /// </summary>
+        /// <param name="entityClass">The character class type</param>
+        /// <param name="level">The character level</param>
+        /// <returns>The distance defence value</returns>
         long GetDistanceDefence(CharacterClassType entityClass, byte level);
     }
 }

src/NosCore.Algorithm/DistanceDodgeService/DistanceDodgeService.cs

@@ -2,10 +2,16 @@
 
 namespace NosCore.Algorithm.DistanceDodgeService
 {
+    /// <summary>
+    /// Provides distance combat dodge value calculations for different character classes and levels
+    /// </summary>
     public class DistanceDodgeService : IDistanceDodgeService
     {
         private readonly long[,] _distanceDodge = new long[Constants.ClassCount, Constants.MaxLevel];
 
+        /// <summary>
+        /// Initializes a new instance of the DistanceDodgeService and pre-calculates distance dodge values for all character classes and levels
+        /// </summary>
         public DistanceDodgeService()
         {
             var swordmanDodge = 8;
@@ -31,6 +37,12 @@ public DistanceDodgeService()
             }
         }
 
+        /// <summary>
+        /// Gets the distance dodge value for a character class at a specific level
+        /// </summary>
+        /// <param name="class">The character class type</param>
+        /// <param name="level">The character level</param>
+        /// <returns>The distance dodge value</returns>
         public long GetDistanceDodge(CharacterClassType @class, byte level)
         {
             return _distanceDodge![(byte)@class, level - 1];

src/NosCore.Algorithm/DistanceDodgeService/IDistanceDodgeService.cs

@@ -5,8 +5,17 @@
 
 namespace NosCore.Algorithm.DistanceDodgeService
 {
+    /// <summary>
+    /// Service for calculating distance combat dodge values
+    /// </summary>
     public interface IDistanceDodgeService
     {
+        /// <summary>
+        /// Gets the distance dodge value for a character class at a specific level
+        /// </summary>
+        /// <param name="entityClass">The character class type</param>
+        /// <param name="level">The character level</param>
+        /// <returns>The distance dodge value</returns>
         long GetDistanceDodge(CharacterClassType entityClass, byte level);
     }
 }