feat(stats): stat VoxelForge -- make tile skipping and the column memo observable

The plugin had ZERO stat counters, so every claim this refactor makes was
harness-only: "skipped correctly" and "skipped nothing" render identically.
CODEX-TASK-001 and -002, executed by Codex (gpt-5.6-luna xhigh), reviewed
against the source.

Eight DWORD counters in a new stat group:
  GenerateTileResult -- TilesClassified / SkippedAllSolid / SkippedAllAir / Meshed
  ClassifyTile bAnyCave exit -- TilesOpStackSolid / TilesOpStackAir
  FSurfaceColumnSource::GetColumn -- ColumnMemoHit / ColumnMemoMiss

The op-stack counters are separate from the lumped skip counters on purpose:
ClassifyTile also proves AllSolid on its hand-written bedrock-gap path with no
strate opted in, so the lumped number cannot show a before/after. The op-stack
pair is zero BY CONSTRUCTION until a strate ticks the flag.

GetColumn is instrumented and deliberately NOT fixed -- the instrument and the
fix in one build would make each other unreadable.

Verified against UE_5.7 Stats.h rather than assumed (first stats use in this
plugin, no in-repo precedent): all four macro arities, and INC_DWORD_STAT ->
FThreadStats::AddMessage, so the worker-thread safety both sites need holds by
mechanism. Not built -- Jahni builds.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Source/VoxelForge/Private/VoxelDensityOpStack.cpp

@@ -29,6 +29,7 @@
 #include "VoxelTerrainOpDefinition.h" // ApplyTo — l'override d'op PAR SALLE (étape C1)
 #include "VoxelStrateManager.h"       // EvaluateModifierSDF / AnyPassageNearBox
 #include "VoxelTypes.h"               // SmoothStep01, VOXEL_NOISE_SCALE
+#include "VoxelStats.h"
 
 #include <atomic>                     // l'id d'instance non recyclé du mémo de colonne
 
@@ -641,6 +642,7 @@ namespace
             FSlot& S = Slots[Idx];
             if (S.Key != ColumnKey || S.X != WorldX || S.Y != WorldY)
             {
+                INC_DWORD_STAT(STAT_VoxelForgeColumnMemoMiss);
                 S.Key = ColumnKey;  S.X = WorldX;  S.Y = WorldY;
                 FColumn& C = S.C;
 
@@ -700,6 +702,10 @@ namespace
                     if (Slope > KINDA_SMALL_NUMBER) { C.DirX = GX / Slope; C.DirY = GY / Slope; }
                 }
             }
+            else
+            {
+                INC_DWORD_STAT(STAT_VoxelForgeColumnMemoHit);
+            }
             return S.C;
         }
 

Source/VoxelForge/Private/VoxelGenerator.cpp

@@ -16,6 +16,7 @@
 #include "VoxelDensityPrimitives.h"   // spine / seal / passage — shared with the operator stack
 #include "VoxelDensityOpStack.h"      // OPSTACK Phase 1: the opt-in per-strate operator stack
 #include "VoxelHeightOp.h"            // IVoxelBiomeField — the adapter below implements it
+#include "VoxelStats.h"
 
 //=============================================================================
 // L'ADAPTATEUR DE CHAMP DE BIOMES / THE BIOME FIELD ADAPTER
@@ -3007,6 +3008,14 @@ EVoxelTileClass UVoxelGenerator::ClassifyTile(const FIntVector& OriginVoxels, in
         if (D.BridgeDensity > 0.0f || D.RidgeDensity > 0.0f) { bCanAir = false; }
 
         if (bCanSolid == bCanAir) { return EVoxelTileClass::Mixed; }
+        if (bCanSolid)
+        {
+            INC_DWORD_STAT(STAT_VoxelForgeTilesOpStackSolid);
+        }
+        else
+        {
+            INC_DWORD_STAT(STAT_VoxelForgeTilesOpStackAir);
+        }
         return bCanSolid ? EVoxelTileClass::AllSolid : EVoxelTileClass::AllAir;
     }
 

Source/VoxelForge/Private/VoxelStats.cpp

@@ -0,0 +1,14 @@
+// VoxelStats.cpp
+// Definitions for the VoxelForge runtime statistics.
+// Définitions des statistiques runtime de VoxelForge.
+
+#include "VoxelStats.h"
+
+DEFINE_STAT(STAT_VoxelForgeTilesClassified);
+DEFINE_STAT(STAT_VoxelForgeTilesSkippedAllSolid);
+DEFINE_STAT(STAT_VoxelForgeTilesSkippedAllAir);
+DEFINE_STAT(STAT_VoxelForgeTilesMeshed);
+DEFINE_STAT(STAT_VoxelForgeTilesOpStackSolid);
+DEFINE_STAT(STAT_VoxelForgeTilesOpStackAir);
+DEFINE_STAT(STAT_VoxelForgeColumnMemoHit);
+DEFINE_STAT(STAT_VoxelForgeColumnMemoMiss);

Source/VoxelForge/Private/VoxelWorld.cpp

@@ -11,6 +11,7 @@
 #include "VoxelTerrainOpDefinition.h"
 #include "VoxelContentManager.h"
 #include "VoxelDensityVolume.h"
+#include "VoxelStats.h"
 // IWYU (FPSemantics = Precise ⇒ plus de PCH partagé) : GetPlayerPosition déréférence le pawn, donc
 // APawn doit être COMPLET — `Casts.h` n'en donne qu'une déclaration avant. APlayerController était
 // complet par transitivité seulement : on l'inclut explicitement, c'est exactement la fragilité
@@ -1502,11 +1503,24 @@ void AVoxelWorld::GenerateTileResult(const FVoxelTileKey& Tile, const FIntVector
     if (!bSheetTile && !bWantCapture && Generator && Mesher && Mesher->IsoLevel == 0.0f)
     {
         TRACE_CPUPROFILER_EVENT_SCOPE(VoxelForge_ClassifyTile);
-        bTrivialEmpty = (Generator->ClassifyTile(OriginVoxels, Step, Cells) != EVoxelTileClass::Mixed);
+        INC_DWORD_STAT(STAT_VoxelForgeTilesClassified);
+        const EVoxelTileClass Verdict = Generator->ClassifyTile(OriginVoxels, Step, Cells);
+        if (Verdict == EVoxelTileClass::AllSolid)
+        {
+            INC_DWORD_STAT(STAT_VoxelForgeTilesSkippedAllSolid);
+        }
+        else if (Verdict == EVoxelTileClass::AllAir)
+        {
+            INC_DWORD_STAT(STAT_VoxelForgeTilesSkippedAllAir);
+        }
+        bTrivialEmpty = (Verdict != EVoxelTileClass::Mixed);
     }
 
     // F18 — feuille : deux heightfields sol/cap échantillonnés par colonne (pas de marching
     // cubes, pas de classifieur — la classe de surface est vraie par construction).
+    // `TilesMeshed` peut dépasser `TilesClassified` : les tuiles qui ratent cette porte sont
+    // maillées sans classification. / `TilesMeshed` may exceed `TilesClassified`: tiles that
+    // fail this gate are meshed without classification.
     FVoxelMeshData MeshData;
     if (!bTrivialEmpty)
     {
@@ -1517,6 +1531,7 @@ void AVoxelWorld::GenerateTileResult(const FVoxelTileKey& Tile, const FIntVector
             : Mesher->GenerateMesh(OriginVoxels, Step, Cells,
                                    bWantCapture ? &Result.CaptureGrid : nullptr,
                                    BandVoxLo, BandVoxHi);
+        INC_DWORD_STAT(STAT_VoxelForgeTilesMeshed);
     }
 
     // T1.f — build the RMC geometry buffers HERE (worker), not on the game thread. Empty/all-air

Source/VoxelForge/Public/VoxelStats.h

@@ -0,0 +1,18 @@
+// VoxelStats.h
+// Per-frame runtime counters for tile classification and meshing.
+// Compteurs runtime par frame pour la classification et le meshing des tuiles.
+
+#pragma once
+
+#include "Stats/Stats.h"
+
+DECLARE_STATS_GROUP(TEXT("VoxelForge"), STATGROUP_VoxelForge, STATCAT_Advanced);
+
+DECLARE_DWORD_COUNTER_STAT_EXTERN(TEXT("Tiles Classified"), STAT_VoxelForgeTilesClassified, STATGROUP_VoxelForge, VOXELFORGE_API);
+DECLARE_DWORD_COUNTER_STAT_EXTERN(TEXT("Tiles Skipped All Solid"), STAT_VoxelForgeTilesSkippedAllSolid, STATGROUP_VoxelForge, VOXELFORGE_API);
+DECLARE_DWORD_COUNTER_STAT_EXTERN(TEXT("Tiles Skipped All Air"), STAT_VoxelForgeTilesSkippedAllAir, STATGROUP_VoxelForge, VOXELFORGE_API);
+DECLARE_DWORD_COUNTER_STAT_EXTERN(TEXT("Tiles Meshed"), STAT_VoxelForgeTilesMeshed, STATGROUP_VoxelForge, VOXELFORGE_API);
+DECLARE_DWORD_COUNTER_STAT_EXTERN(TEXT("Tiles Operator Stack Solid"), STAT_VoxelForgeTilesOpStackSolid, STATGROUP_VoxelForge, VOXELFORGE_API);
+DECLARE_DWORD_COUNTER_STAT_EXTERN(TEXT("Tiles Operator Stack Air"), STAT_VoxelForgeTilesOpStackAir, STATGROUP_VoxelForge, VOXELFORGE_API);
+DECLARE_DWORD_COUNTER_STAT_EXTERN(TEXT("Column Memo Hits"), STAT_VoxelForgeColumnMemoHit, STATGROUP_VoxelForge, VOXELFORGE_API);
+DECLARE_DWORD_COUNTER_STAT_EXTERN(TEXT("Column Memo Misses"), STAT_VoxelForgeColumnMemoMiss, STATGROUP_VoxelForge, VOXELFORGE_API);