Harbor instrument · deterministic ledger

Tidal Ledger Observatory

Three warehouses exchange sealed cargo through an append-only event ledger. Reserve holds units at the source, commit moves them, and cancel releases the hold. Scrub any prefix, branch the journal, and inspect exactly where every unit is held.

Playhead 0 / 6
Transport Paused
Motion Full

Read me first

How to use the observatory

Initial inventory: A 8 · B 4 · C 0. Total 12 units. The ledger is the only source of truth; the boat is presentation.

  1. Scrub the prefix

    Move k from 0 to the journal length with the slider, the direct seek, or Previous and Next. Play advances one event per second; Pause stops it without applying anything extra. Every counter, card and ledger row is replayed from the initial inventory.

  2. Branch, then append

    Pause at any k and choose Branch here to keep exactly the first k sorted events and discard the suffix. At the journal end, append one schema-checked event. Semantic rejections are retained in the branch and marked in the ledger.

  3. Import or reset

    Paste up to 100 events as JSON. An accepted import replaces the journal, pauses playback and sets k=0; an invalid import changes nothing. Load example restores the fixture; Reset returns to an empty journal and the initial inventory.

Ledger rules. A reserve holds units at its source and does not move them; available = physical − active holds. A commit moves the reserved quantity and releases the hold; a cancel releases it without moving stock. Events are sorted by ascending seq, then ASCII id, and identical duplicate ids collapse. Unknown refs, insufficient stock, terminal refs and refs already in use are rejected individually without blocking later events.

Live state

Harbor

Solid crates are free physical stock; hatched crates are held. Dashed arcs show active hold routes. Counts below are computed from the evaluated prefix.

Harbor overview with three warehouses Warehouse A: 8 physical, 0 held, 8 available. Warehouse B: 4 physical, 0 held, 4 available. Warehouse C: 0 physical, 0 held, 0 available. No active holds. Total physical inventory 12 of 12 units.
  • Free physical crate
  • Held crate (reserved, still on the quay)
  • Active hold route
  • Commit transfer (presentation only)

Deterministic replay

Event ledger

0 of 6 evaluated · 0 applied · 0 rejected · 6 pending

0

Paused at k=0. 6 events pending.

    Rows are listed in sorted order: ascending seq, then ASCII id. id names the event record; ref names the reservation. Pending rows have not been evaluated and cannot affect the state above.