Skip to content

fix(rust_brain): preserve HLC on snapshot restore and gossip receive#40

Draft
cursor[bot] wants to merge 1 commit into
mainfrom
cursor/critical-bug-investigation-0bb9
Draft

fix(rust_brain): preserve HLC on snapshot restore and gossip receive#40
cursor[bot] wants to merge 1 commit into
mainfrom
cursor/critical-bug-investigation-0bb9

Conversation

@cursor

@cursor cursor Bot commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

Bug and impact

After v0.6.0 added HLC monotonic enforcement, restore_from_file() and gossip.receive() still assigned fresh HLC timestamps instead of preserving causal ordering from snapshots or peer events.

Concrete trigger: Snapshot a node with hlc=(5000, 10, "nodeA"), restore, then apply a causal successor write hlc=(5000, 11, "nodeA"). The write raises TimestampRegression because restore assigned a fresh wall-clock HLC — causing silent data loss in disaster-recovery and gossip replication paths.

Gossip events without HLC could also overwrite fresher data by assigning a new timestamp.

Root cause

restore_from_file() constructed MemoryNode without reading the hlc field from the snapshot JSON. gossip.receive() called remember() without passing hlc from the event.

Fix

  • Add _parse_hlc() for snapshot/wire normalization with legacy fallback
  • Restore HLC and advance global clock (_hlc.update()) on snapshot restore
  • Pass HLC through bulk_write and gossip receive with stale rejection
  • Hold lock during restore_from_file and gc_expired to prevent races

Validation

  • Reproduced pre-fix: causal successor write failed after restore
  • pytest tests/test_enterprise_backup.py tests/test_gossip.py tests/test_rust_brain.py tests/test_rust_brain_concurrency.py — 37 passed
Open in Web View Automation 

After v0.6.0 added HLC monotonic enforcement, restore_from_file() and
gossip.receive() still assigned fresh HLC timestamps. Post-restore causal
writes were rejected (TimestampRegression) causing silent data loss; gossip
without HLC could overwrite fresher data.

- Add _parse_hlc() for snapshot/wire normalization with legacy fallback
- Restore HLC and advance global clock on snapshot restore
- Pass HLC through bulk_write and gossip receive with stale rejection
- Hold lock during restore_from_file and gc_expired to prevent races

Co-authored-by: Daniel <DJLougen@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant