Implement M5.6 canonical world snapshots and edit journals

This commit is contained in:
dingo
2026-09-26 19:05:29 -04:00
parent 8b5bf48795
commit 207f9e6953
22 changed files with 1262 additions and 9 deletions
+35
View File
@@ -1532,3 +1532,38 @@ claimed. The source/replacement commit operations have compile-time nonthrowing
Linux CI and UBSan were not run locally. These are typed volume transfers, not a
validated density/mass/chemistry model. No deployment or World0 modification occurred.
Next: M5.6 canonical snapshots/edit journals preserving geometry, debris and retry state.
## M5.6 canonical world snapshots and edit journals - 2026-09-26
Added ADR-0047, byte schemas, canonical snapshot/restore and detached atomic journal
replay. State includes base versions, identity, membership, revisions, geometry,
debris, successful edit count and exact bounded retry records. No existing golden
or biological simulation format changed. New snapshot v1 has an independently encoded
132-byte empty fixture from tools/world_snapshot_reference.py.
Executed on Windows x64 / MSVC 19.44:
- Release configure/build and 46/46 CTest passed on the final source/tests.
- Analysis configure/build (clang-tidy 19) and 46/46 CTest passed after explicit
size/iterator conversion fixes. Final history-corruption additions rebuilt and
passed both tests selected by `ctest --test-dir build/analysis -R world-codec
--output-on-failure`.
- ASan configure/build and 46/46 CTest passed. After final size/iterator/golden and
history-corruption additions, rebuilt ASan and reran both world-codec tests: passed.
- `tools/windows-check.ps1 -Preset release -Action format`: passed.
- `python tools/world_snapshot_reference.py`: generated independent golden bytes;
encoder equality and decoder acceptance pass in CTest.
- `git diff --check`: passed.
New coverage includes 65-edit history rollover, deterministic continuation, historical
retry receipts, exact re-encoding, snapshot+journal replay, wrong predecessor/final
state, every fixture truncation, oversized/trailing data, version/identity/budget
rejection, recomputed-checksum geometry/debris/receipt/revision/history corruption,
and a deterministic 128-input semantic fuzz smoke. The fuzz harness mutates valid
fixtures and repairs checksums so validation below the envelope is exercised.
Linux libFuzzer/UBSan jobs are wired for 10000 cases but were not executed locally.
Native Windows ASan is not UBSan. Full-size throughput, allocation-failure injection
and crash-atomic files remain unverified/later gates. Codecs write no files, clear no
dirty flags and issue no durable acknowledgements. No Argo/World0 operation occurred.
Next: M5.7 local snapshot/journal publication, compaction and recovery.