feat(simulation): error handling and recovery — panic supervision, state hash, structured errors (#85)

Browse Source

Protocol v17: add state_hash (desync detection) and sim_errors
(structured error reporting) to ObserverSnapshot. Add SimError,
SimErrorKind, SimErrorBuffer types. Wrap main loop app.update() in
catch_unwind — on panic, send a final SimError snapshot before exit.
Report recoverable deserialization errors to client via SimErrorBuffer.
Compute per-tick state hash from player position + NPC count + tick.
Update all test fixtures and golden files for protocol v17.

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

...

This commit is contained in:

jpmschweitzer

2026-02-27 17:46:27 +01:00

co-authored by Claude Opus 4.6

parent c2cae1f618

commit d31ac1cc70

23 changed files with 557 additions and 7 deletions

Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL

Download Patch File Download Diff File Expand all files Collapse all files

client/tests/fixtures/msgpack/snapshot_boundary_tick_0.msgpack

Vendored

BIN

Binary file not shown.

client/tests/fixtures/msgpack/snapshot_boundary_tick_127.msgpack

Vendored

BIN

Binary file not shown.

client/tests/fixtures/msgpack/snapshot_boundary_tick_2b31m1.msgpack

Vendored

BIN

Binary file not shown.

client/tests/fixtures/msgpack/snapshot_boundary_tick_2b32.msgpack

Vendored

BIN

Binary file not shown.

client/tests/fixtures/msgpack/snapshot_boundary_tick_32767.msgpack

Vendored

BIN

Binary file not shown.

client/tests/fixtures/msgpack/snapshot_empty.msgpack

Vendored

BIN

Binary file not shown.

client/tests/fixtures/msgpack/snapshot_full.msgpack

Vendored

BIN

Binary file not shown.

client/tests/fixtures/msgpack/snapshot_minimal.msgpack

Vendored

BIN

Binary file not shown.

client/tests/fixtures/msgpack/snapshot_multi_entity.msgpack

Vendored

BIN

Binary file not shown.

client/tests/fixtures/msgpack/snapshot_one_npc.msgpack

Vendored

BIN

Binary file not shown.

client/tests/fixtures/msgpack/snapshot_player.msgpack

Vendored

BIN

Binary file not shown.

client/tests/fixtures/msgpack/snapshot_v2_full.msgpack

Vendored

BIN

Binary file not shown.