Document applied read cancellation evidence and final world recording

2026-10-04 03:04:31 +02:00
parent 9a1b22aa56
commit 45f0fd39b6
4 changed files with 107 additions and 0 deletions
@@ -0,0 +1,43 @@
+{
+  "schema": 1,
+  "platform": "Linux-6.17.0-1022-azure-x86_64-with-glibc2.39",
+  "architecture": "x86_64",
+  "minecraft": "26.3",
+  "distant_horizons": "3.3.4",
+  "original_mod_sha256": "c506982631880604513de8ef85e3b4461fbb898702e60b4a6f74ca3b3d4a687f",
+  "results": [
+    {
+      "enabled": false,
+      "applied_io_worker_checked": true,
+      "ordinary_join_checked": true,
+      "shared_future_preserved": true,
+      "exception_identity_checked": true,
+      "completed_interrupt_checked": true,
+      "cancelled_completion_checked": true,
+      "preinterrupted_pending_checked": true
+    },
+    {
+      "enabled": true,
+      "applied_io_worker_checked": true,
+      "ordinary_join_checked": true,
+      "shared_future_preserved": true,
+      "exception_identity_checked": true,
+      "completed_interrupt_checked": true,
+      "cancelled_completion_checked": true,
+      "preinterrupted_pending_checked": true
+    }
+  ],
+  "notes": [
+    "Actual game IOWorker under Fabric, with controlled cached blending-read futures.",
+    "DH worker interruption releases only its waiter; the shared future remains consumable.",
+    "Ordinary callers retain join behavior; completed values, cancellation and exception identity are checked.",
+    "This is a shutdown correctness fixture, not an FPS or world-generation throughput benchmark."
+  ],
+  "provenance": {
+    "source_commit": "9a1b22aa56f58a3ee39a3564be859a662d2beedc",
+    "workflow_run": "https://github.com/ludovic111/minecraft-optimization-lab/actions/runs/37166150119",
+    "job": "portable-mod (ubuntu-latest)",
+    "artifact": "horizon-ubuntu-latest",
+    "command": "python tools/test_terrain_read.py"
+  }
+}
@@ -0,0 +1,41 @@
+{
+  "schema": 1,
+  "platform": "Linux-7.0.0-31-generic-x86_64-with-glibc2.43",
+  "architecture": "x86_64",
+  "minecraft": "26.3",
+  "distant_horizons": "3.3.4",
+  "original_mod_sha256": "c506982631880604513de8ef85e3b4461fbb898702e60b4a6f74ca3b3d4a687f",
+  "results": [
+    {
+      "enabled": false,
+      "applied_io_worker_checked": true,
+      "ordinary_join_checked": true,
+      "shared_future_preserved": true,
+      "exception_identity_checked": true,
+      "completed_interrupt_checked": true,
+      "cancelled_completion_checked": true,
+      "preinterrupted_pending_checked": true
+    },
+    {
+      "enabled": true,
+      "applied_io_worker_checked": true,
+      "ordinary_join_checked": true,
+      "shared_future_preserved": true,
+      "exception_identity_checked": true,
+      "completed_interrupt_checked": true,
+      "cancelled_completion_checked": true,
+      "preinterrupted_pending_checked": true
+    }
+  ],
+  "notes": [
+    "Actual game IOWorker under Fabric, with controlled cached blending-read futures.",
+    "DH worker interruption releases only its waiter; the shared future remains consumable.",
+    "Ordinary callers retain join behavior; completed values, cancellation and exception identity are checked.",
+    "This is a shutdown correctness fixture, not an FPS or world-generation throughput benchmark."
+  ],
+  "provenance": {
+    "source_commit": "9a1b22aa56f58a3ee39a3564be859a662d2beedc",
+    "environment": "local Linux x64 software graphics; actual Fabric fixture",
+    "command": "python tools/test_terrain_read.py"
+  }
+}
@@ -47,3 +47,12 @@ The [sanitized Linux CI result](../benchmarks/culling-empty-2026-10-04/linux-app
 includes its source/workflow provenance and independently checks live registration
 and the applied shortcut. CPU timings can include JIT folding of this empty loop;
 they are not per-check costs or estimates of game speed.
+
+The final candidate JAR (`c506982631880604513de8ef85e3b4461fbb898702e60b4a6f74ca3b3d4a687f`)
+then recorded 579 frame intervals and 2,408 integrated-server tick durations over
+120 seconds, with zero excluded frames and matching CSV counts/means. Its actual
+frame report retained custom graphics, render/simulation distances 12/12, DH radius
+128 at MEDIUM/MEDIUM quality, two workers at runtime ratio 0.5, compact headers,
+and both the culling shortcut and scoped terrain-read fix enabled. No captured
+visual setting changed. This verifies integration; it is not a repeated hardware
+performance comparison.
@@ -34,3 +34,17 @@ reads with an interrupt already set, cancelled
 futures, exceptional completion identity, and recognition by DH's shutdown
 exception utility. The private fixture does not enter release packs. This is a
 correctness check, not an FPS, throughput or Mac shutdown benchmark.
+
+The [sanitized Linux CI result](../benchmarks/terrain-read-2026-10-04/linux-applied-hooks.json)
+includes source/workflow provenance and the original mod checksum. The CI JAR
+matches the local candidate byte-for-byte. Windows and hosted Apple Silicon
+macOS 26 compile the fixture and pass the portable build/metrics checks; applied
+read interruption is exercised on Linux, not a live macOS game.
+
+The exact candidate also completed a 120-second local world recording, saved,
+and reloaded that world in the same client. After the first save, thread inspection
+found no remaining DH generation workers and no background workers blocked on a
+future. After reload, two generation workers existed and neither was waiting in
+blending metadata; no background metadata-scan wait was present at that snapshot.
+This is one software-rendered lifecycle observation, not proof that every
+shutdown race, world or platform is covered.