Skip to content

Releases

v0.1.1 — moirae on npm

Choose a tag to compare

@pchrysostomou pchrysostomou released this 10 Sep 19:02
e6b3271

The first public release of moirae: deterministic simulation testing for distributed systems, in TypeScript.

npx moirae demo

runs five Raft nodes through a two-second partition and a crash, prints what happened, writes moirae-demo.jsonl, and opens it in the studio. It is seed 19, and it replays byte for byte on your machine.

What's in it

  • moirae-core 0.1.0 — the engine: clock, (time, seq) event queue, PRNG, network model (latency, loss, duplication, partitions), crashes and restarts, invariants, JSONL trace. Zero dependencies.
  • moirae-protocols 0.1.0 — Raft, transcribed from the paper, with its safety invariants. Each of the classically mis-implemented rules is tested against its naive form, Figure 8 included.
  • moirae 0.1.1 — the CLI: demo and replay, with the studio bundled. 0.1.1 is 0.1.0 republished so the registry matches the tag; there is no functional change.
  • The studio — a trace viewer that is a pure function of a trace file.

Determinism, enforced. CI hashes the example traces on Node 20, 22 and 24 on every push; an engine change that alters a single byte fails the build.

Node 20 or newer. Apache-2.0.

Changelog: https://github.com/pchrysostomou/moirae/blob/main/CHANGELOG.md