From 645c32e11cc54e7c56e45b64682f48e4a30c70eb Mon Sep 17 00:00:00 2001
From: gamer147 <gamer147@gmail.com>
Date: Tue, 9 Jun 2026 14:11:45 -0400
Subject: [PATCH] docs(inventory): annotate GrantSource gap + For() exception
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add comment above AdminGrant = 99 explaining the intentional 16–98 gap,
and add <exception> XML doc on GrantSourceMessages.For() so IDE tooling
surfaces the ArgumentOutOfRangeException.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 SVSim.Database/Services/Inventory/GrantSource.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/SVSim.Database/Services/Inventory/GrantSource.cs b/SVSim.Database/Services/Inventory/GrantSource.cs
index f3a383c..d721ef2 100644
--- a/SVSim.Database/Services/Inventory/GrantSource.cs
+++ b/SVSim.Database/Services/Inventory/GrantSource.cs
@@ -28,6 +28,7 @@ public enum GrantSource
     AchievementReward = 13,
     SerialCodeRedeem = 14,
     CardCosmeticCascade = 15,
+    // Reserved high to stay visually distinct from gameplay sources; 16–98 are intentionally unused.
     AdminGrant = 99,
 }
 
@@ -37,6 +38,7 @@ public enum GrantSource
 /// </summary>
 public static class GrantSourceMessages
 {
+    /// <exception cref="ArgumentOutOfRangeException">An unmapped <see cref="GrantSource"/> value was passed.</exception>
     public static string For(GrantSource source) => source switch
     {
         GrantSource.Unknown             => "Unknown",