From 45f0fd39b60e1700d9910bdee8354b8d0ecc4208 Mon Sep 17 00:00:00 2001 From: Ludovic Marie <136255825+ludovic111@users.noreply.github.com> Date: Sun, 4 Oct 2026 03:04:31 +0200 Subject: [PATCH] Document applied read cancellation evidence and final world recording --- .../linux-applied-hooks.json | 43 +++++++++++++++++++ .../local-applied-hooks.json | 41 ++++++++++++++++++ docs/culling-empty.md | 9 ++++ docs/terrain-read-wait.md | 14 ++++++ 4 files changed, 107 insertions(+) create mode 100644 benchmarks/terrain-read-2026-10-04/linux-applied-hooks.json create mode 100644 benchmarks/terrain-read-2026-10-04/local-applied-hooks.json diff --git a/benchmarks/terrain-read-2026-10-04/linux-applied-hooks.json b/benchmarks/terrain-read-2026-10-04/linux-applied-hooks.json new file mode 100644 index 000000000..1c3137e29 --- /dev/null +++ b/benchmarks/terrain-read-2026-10-04/linux-applied-hooks.json @@ -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" + } +} diff --git a/benchmarks/terrain-read-2026-10-04/local-applied-hooks.json b/benchmarks/terrain-read-2026-10-04/local-applied-hooks.json new file mode 100644 index 000000000..51b186dd7 --- /dev/null +++ b/benchmarks/terrain-read-2026-10-04/local-applied-hooks.json @@ -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" + } +} diff --git a/docs/culling-empty.md b/docs/culling-empty.md index 090c9a841..c1a45c3af 100644 --- a/docs/culling-empty.md +++ b/docs/culling-empty.md @@ -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. diff --git a/docs/terrain-read-wait.md b/docs/terrain-read-wait.md index 300c11274..399270684 100644 --- a/docs/terrain-read-wait.md +++ b/docs/terrain-read-wait.md @@ -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.