docs(6e): document CCTV source in the generator README

Add cctv.json row to the source-file table, /cctv to the calculator
list, CctvAsOf to the provenance constants list, and CCTV Notes bullet.
Also fix comment-rot (21→22 handler names) and apply jb cleanupcode
reformats to IItemDatabase.cs, CctvChoiceDriftTests.cs, DatasetValidator.cs.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: HandyS11

src/RustPlusBot.Features.ItemData/IItemDatabase.cs

@@ -9,6 +9,9 @@ public interface IItemDatabase
     /// <summary>Per-section provenance dates, for "data as of" display.</summary>
     DatasetSources Sources { get; }
 
+    /// <summary>All CCTV monument entries from the bundle.</summary>
+    IReadOnlyList<CctvMonument> CctvMonuments { get; }
+
     /// <summary>Gets the record for an item id, or null if unknown.</summary>
     /// <param name="id">The Rust item id.</param>
     ItemRecord? GetById(int id);
@@ -28,9 +31,6 @@ public interface IItemDatabase
     /// <returns>A match describing the outcome.</returns>
     SmeltMatch ResolveSmelter(string query);
 
-    /// <summary>All CCTV monument entries from the bundle.</summary>
-    IReadOnlyList<CctvMonument> CctvMonuments { get; }
-
     /// <summary>Resolves a user query (monument name) to a CCTV monument.</summary>
     /// <param name="query">The raw user input.</param>
     /// <returns>A match describing the outcome.</returns>

tests/RustPlusBot.Features.Commands.Tests/Help/CommandHelpCatalogTests.cs

@@ -5,7 +5,7 @@ namespace RustPlusBot.Features.Commands.Tests.Help;
 
 public sealed class CommandHelpCatalogTests
 {
-    /// <summary>The 21 registered in-game handler names (see AddCommands / CommandRegistrationTests).</summary>
+    /// <summary>The 22 registered in-game handler names (see AddCommands / CommandRegistrationTests).</summary>
     private static readonly string[] HandlerNames =
     [
         "mute", "unmute", "uptime", "pop", "wipe", "time",

tests/RustPlusBot.Features.Commands.Tests/Modules/CctvChoiceDriftTests.cs

@@ -12,8 +12,11 @@ private static IReadOnlyList<string> ChoiceValues()
         var parameter = typeof(ItemCommandModule)
             .GetMethod(nameof(ItemCommandModule.CctvAsync))!
             .GetParameters()[0];
-        return [..parameter.GetCustomAttributes<ChoiceAttribute>()
-            .Select(c => (string)c.Value!)];
+        return
+        [
+            ..parameter.GetCustomAttributes<ChoiceAttribute>()
+                .Select(c => (string)c.Value!)
+        ];
     }
 
     [Fact]

tools/RustPlusBot.ItemData.Generator/README.md

@@ -2,7 +2,7 @@
 
 A maintainer CLI that regenerates the embedded Rust item dataset
 (`src/RustPlusBot.Features.ItemData/Data/item-data.json`) consumed by the bot's
-`/item`, `/recycle`, `/craft`, `/research`, `/decay`, `/upkeep`, `/durability`, and `/smelt` calculators.
+`/item`, `/recycle`, `/craft`, `/research`, `/decay`, `/upkeep`, `/durability`, `/smelt`, and `/cctv` calculators.
 
 This tool is **not** part of the running bot — it is referenced by nothing in
 the application graph. It exists so the bundled item data can be refreshed when
@@ -39,6 +39,7 @@ garbage** if the upstream shape drifts.
    | `rustlabsUpkeepData.json` | upkeep cost (resource + quantity range) |
    | `rustlabsDurabilityData.json` | raid cost (explosives only — trimmed) |
    | `rustlabsSmeltingData.json` | smelting/cooking conversions (per smelter) |
+   | `cctv.json` | monument CCTV camera codes |
 
 2. Projects them into our own typed schema (`ItemDataset` /
    `ItemRecord` / …, defined in `RustPlusBot.Features.ItemData`), keyed by item id,
@@ -92,7 +93,7 @@ tests assert known items resolve correctly.
 
 The source dates stamped into the dataset are currently hard-coded constants in
 [`Program.cs`](Program.cs) (`NamesAsOf`, `RecycleAsOf`, `CraftAsOf`,
-`ResearchAsOf`, `DecayAsOf`, `UpkeepAsOf`, `DurabilityAsOf`, `SmeltingAsOf`).
+`ResearchAsOf`, `DecayAsOf`, `UpkeepAsOf`, `DurabilityAsOf`, `SmeltingAsOf`, `CctvAsOf`).
 Update them when you refresh from newer upstream data.
 
 ## Notes
@@ -112,6 +113,9 @@ Update them when you refresh from newer upstream data.
   resolved by name like raid targets. Its provenance (`SmeltingAsOf`,
   2023-11-05) lags the other rustlabs sources because the upstream file has not
   changed since then.
+- CCTV data (`cctv.json`, ~2 KB) is keyed by **monument name** and projected into a dedicated
+  `Cctv` table (`OfflineCctvSource`), resolved by name. Codes are un-escaped (`\*` → `*`) during the
+  transform. Its provenance (`CctvAsOf`, 2025-11-12) is the upstream last-change date for the file.
 
 ## Attribution
 

tools/RustPlusBot.ItemData.Generator/Validation/DatasetValidator.cs

@@ -7,7 +7,10 @@ namespace RustPlusBot.ItemData.Generator.Validation;
 /// <param name="MinRaidTargetCount">The minimum number of raid targets the dataset must contain.</param>
 /// <param name="MinSmelterCount">The minimum number of smelters the dataset must contain.</param>
 /// <param name="MinCctvCount">The minimum number of CCTV monuments the dataset must contain.</param>
-internal sealed record ValidationOptions(int MinItemCount, int MinRaidTargetCount = 0, int MinSmelterCount = 0,
+internal sealed record ValidationOptions(
+    int MinItemCount,
+    int MinRaidTargetCount = 0,
+    int MinSmelterCount = 0,
     int MinCctvCount = 0);
 
 /// <summary>Validates an <see cref="ItemDataset"/> for structural integrity.</summary>