Repository navigation
seedfall v0.2.0
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.0or 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.QuietForandSetupCompletefor liveness. - Antithesis SDK compatibility: code using
antithesis-sdk-go/assertruns 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 -reportwith findings tracked across runs (new, ongoing, resolved, regressed). - Zero-code networking:
net_overlayruns plainnetandnet/httpon 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.