perf: benchmark scheduler reflection dispatch (#71)

Add a protected GitHub-only JMH workload for Folia-style reflective scheduler dispatch and Paper fallback paths.

Author: TypeThe0ry

.github/workflows/ensure-labels.yml

@@ -28,6 +28,7 @@ jobs:
               { name: "performance-region-fingerprint", color: "bfdadc", description: "Use the table region fingerprint performance profile" },
               { name: "performance-display-spawn", color: "bfdadc", description: "Use the display entity spawn performance profile" },
               { name: "performance-region-queue", color: "bfdadc", description: "Use the region update queue performance profile" },
+              { name: "performance-scheduler-reflection", color: "bfdadc", description: "Use the scheduler reflection performance profile" },
               { name: "performance-ray-proxy", color: "bfdadc", description: "Use the client ray-proxy performance profile" }
             ];
 

.github/workflows/performance-ab.yml

@@ -36,6 +36,7 @@ on:
           - region-fingerprint
           - display-spawn
           - region-queue
+          - scheduler-reflection
           - ray-proxy
           - infra
       forks:
@@ -163,6 +164,7 @@ jobs:
               "performance-region-fingerprint": "region-fingerprint",
               "performance-display-spawn": "display-spawn",
               "performance-region-queue": "region-queue",
+              "performance-scheduler-reflection": "scheduler-reflection",
               "performance-ray-proxy": "ray-proxy",
           }
           selected = [profile for label, profile in choices.items() if label in labels]

docs/performance-testing.md

@@ -55,6 +55,8 @@ and exactly one profile label to a pure performance PR:
 - `performance-region-fingerprint` - a real started-table snapshot and layout, measuring the
   complete region map plus a batch of private/public hands, discards, melds and all 136 wall
   slots;
+- `performance-scheduler-reflection` - representative global, region and entity scheduling
+  bursts through both Folia-style reflective capabilities and standard Paper fallbacks;
 - `performance-ray-proxy` - 1, 4 and 32-viewer coordinator lifecycle and unchanged-geometry
   reuse. This CPU/allocation profile does not measure protocol bytes or client hit coverage.
 

perf/ab/gate-config.json

@@ -138,6 +138,23 @@
         "top/ellan/mahjong/table/render/TableRegionDisplayCoordinator.class"
       ]
     },
+    "scheduler-reflection": {
+      "include": "^top\\.ellan\\.mahjong\\.perf\\.ServerSchedulerReflectionBenchmark\\.schedule(?:Folia|Paper)Burst$",
+      "benchmark_ids": [
+        "scheduler.folia.time",
+        "scheduler.folia.alloc",
+        "scheduler.paper.time",
+        "scheduler.paper.alloc"
+      ],
+      "minimum_passes": 2,
+      "must_pass": [
+        "scheduler.folia.time",
+        "scheduler.paper.time"
+      ],
+      "required_classes": [
+        "top/ellan/mahjong/runtime/ServerScheduler.class"
+      ]
+    },
     "ray-proxy": {
       "include": "^top\\.ellan\\.mahjong\\.perf\\.RayProxyCoordinatorBenchmark\\.proxyPlan(?:1Viewer|4Viewers|32Viewers)$",
       "benchmark_ids": [
@@ -291,6 +308,30 @@
       "metric": "gc.alloc.rate.norm",
       "direction": "lower"
     },
+    {
+      "id": "scheduler.folia.time",
+      "benchmark": "top.ellan.mahjong.perf.ServerSchedulerReflectionBenchmark.scheduleFoliaBurst",
+      "metric": "primary",
+      "direction": "lower"
+    },
+    {
+      "id": "scheduler.folia.alloc",
+      "benchmark": "top.ellan.mahjong.perf.ServerSchedulerReflectionBenchmark.scheduleFoliaBurst",
+      "metric": "gc.alloc.rate.norm",
+      "direction": "lower"
+    },
+    {
+      "id": "scheduler.paper.time",
+      "benchmark": "top.ellan.mahjong.perf.ServerSchedulerReflectionBenchmark.schedulePaperBurst",
+      "metric": "primary",
+      "direction": "lower"
+    },
+    {
+      "id": "scheduler.paper.alloc",
+      "benchmark": "top.ellan.mahjong.perf.ServerSchedulerReflectionBenchmark.schedulePaperBurst",
+      "metric": "gc.alloc.rate.norm",
+      "direction": "lower"
+    },
     {
       "id": "ray.viewers1.time",
       "benchmark": "top.ellan.mahjong.perf.RayProxyCoordinatorBenchmark.proxyPlan1Viewer",