Skip to content

seedfall v0.2.0

Choose a tag to compare

@kunalgoesbyken kunalgoesbyken released this 07 Nov 16:01
· 148 commits to main since this release

Deterministic simulation testing for unmodified Go programs. Your nodes run as WebAssembly under a seeded scheduler with a virtual clock, simulated disk and simulated network, so every failing seed replays exactly.

Install

go install github.com/kunalgoesbyken/seedfall/cmd/seedfall@v0.2.0

or download a binary below (Linux, macOS, Windows; amd64 and arm64).

What's in this release

  • Faults: crashes, partitions, torn writes, crash-on-IO, fsync EIO (fsyncgate semantics), process pauses, clock skew and clock jumps, and swarm mode (a random fault mix per seed).
  • Properties: Always, Sometimes, Reachable, Unreachable, AlwaysOrUnreachable, found in your source so a check that never runs fails the sweep. QuietFor and SetupComplete for liveness.
  • Antithesis SDK compatibility: code using antithesis-sdk-go/assert runs unchanged.
  • seedfall cause: branches a failing run at many moments to show when the failure became inevitable.
  • seedfall mutate: weakens fsync, directory fsync and O_SYNC to check your workload notices.
  • Triage reports: run -report with findings tracked across runs (new, ongoing, resolved, regressed).
  • Zero-code networking: net_overlay runs plain net and net/http on the simulated network.
  • Agents and CI: an MCP server (seedfall mcp) and a GitHub Action (kunalgoesbyken/seedfall@v0.2.0).

Bugs found with it

NATS JetStream, rosedblabs/wal, tidwall/buntdb, tidwall/wal and hashicorp/raft. Details and one-command replays are in docs/findings.