promtact

Deterministic verification for distributed systems

The failure happened once. Reproduce it every time.

Promtact turns race conditions, network faults and persistence failures into deterministic tests your team can replay locally, in CI and inside its own infrastructure.

OutcomeFrom incident reconstruction to a repeatable result release owners can inspect before the next change ships.

  • Self-hosted
  • Evidence-backed
  • No required control plane
One failure. Reproduced everywhere. A failure in a five-node cluster is captured as a seed, step and trace, then replayed with the same confirmed result on a laptop, in CI and by a teammate.

One failure. Reproduced everywhere.

01 · Failure

Five-node cluster

Rare safety failure

02 · Capture

Promtact coordinates

Seed
42
Step
318
Trace
7B3A

03 · Replay

Same trace. Same result.

Laptop7B3A · Confirmed
CI7B3A · Confirmed
Teammate7B3A · Confirmed
A failing execution becomes a stable coordinate that can be checked wherever the team works.

Run a real scenario

go run ./cmd/promtact simulate -config examples/leader-partition.json
See the complete workflow

Outcomes

What your team gets

Move correctness work from incident reconstruction into a repeatable engineering workflow with a result that can be shared, reviewed and rerun.

01

Reproduce the exact failure

Turn a rare production-like interleaving into a stable seed, step and trace your engineers can run again.

02

Make correctness a CI gate

Run declared faults and safety properties on every relevant change instead of relying on occasional manual fault testing.

03

Review evidence, not anecdotes

Keep versioned scenarios, traces and qualification results with clearly stated technical bounds.

Workflow

From protocol to reproducible evidence

Promtact focuses the campaign on the behavior that matters, then preserves any violation as an execution your team can revisit.

  1. 01

    Connect your system

    Model or adapt the protocol behavior that matters to your correctness boundary.

  2. 02

    Define properties and faults

    Describe what must never happen and which partitions, delays, losses or failures should be exercised.

  3. 03

    Replay every violation

    Return to the same seed, step and trace locally, in CI or during review.

Adoption

A controlled self-hosted verification model.

Use the Enterprise path when deployment and operations must fit a controlled self-hosted environment.

Enterprise

Operate a controlled self-hosted product

Run deterministic verification inside your own infrastructure, on a single host or Kubernetes, with controlled execution and replayable results.

  • Go, Rust, C++ and Java integration
  • single-host and Kubernetes deployment
  • PostgreSQL-backed operations and job history
  • share, replay and candidate-fix verification

Trust

Built to be checked

Promtact separates product claims from their evidence. Releases, scenarios and qualification results state which behavior was tested, on which commit, and within which bounds.

  • Deterministic replay
  • Bounded verification
  • Signed release artifacts
  • Self-hosted execution

The objective is not a blanket promise that distributed software cannot fail. It is a narrower and checkable contract: define the safety boundary, exercise declared faults, retain the exact execution and state what the resulting evidence does - and does not - establish.

Because execution remains inside the team’s environment, its scenarios and results stay available under the organization’s own access, retention and review controls.

Engineering record

Built by an upstream contributor

Review every pull request and upstream commit directly on GitHub. The record is engineering history, not a substitute for product evidence.

Review the public contribution profile
10 merged pull requests 3 curl · 3 libssh2 · 2 libuv · 1 quinn · 1 AWS s2n-quic Merged into five foundational networking projects.

Start with the hard case

Bring us the failure your current tests cannot reproduce.

Start with the protocol, failure mode and correctness property that matters most. We will determine whether Promtact fits directly or whether a scoped adapter and verification campaign is required.