TraceDB Docs

TraceDB Benchmarks

Private staging repository for TraceDB benchmark workloads, runners, reports, remote execution plans, and proof-evidence tooling.

This repository is development evidence only. Public performance claims still require external controls, comparable runs, and explicit numbers to beat.

Remote execution is the default for benchmark, example, conformance, and release validation work. The canonical Modal-first plan is documented in `docs/benchmarks/remote-execution-modal-plan.md`; local Macs are editing and coordination workstations, not benchmark or CI hosts.

Ownership Boundary

This standalone repository owns benchmark methodology, workload definitions, real-world runner code, suite gates, report schemas, Modal/Railway proof tooling, and benchmark-specific docs. It does not own the core engine, protocol source of truth, SDK packages, or public product docs.

This repository is not a Rust crate and does not contain a `Cargo.toml`. TraceDB engine or CLI binaries used by benchmark jobs come from sibling repositories or from remote execution images, not from local Cargo commands in this checkout.

Sibling repositories own those surfaces:

  • `../tracedb`: core engine and product runtime.
  • `../tracedb-protocol`: executable protocol and HTTP contract source.
  • `../tracedb-js`, `../tracedb-python`, `../tracedb-rust`:

implemented standalone SDK packages and their SDK smoke evidence.

  • `../tracedb-go`: reserved/planned SDK package surface; no implementation or

smoke evidence is owned there yet.

Generated reports under `benchmarks/realworld/reports/` are local receipts and are intentionally git-ignored. Current Railway live receipt IDs such as `railway-live-preflight-20260602T015455Z`, `railway-live-postrestart-20260602T015850Z`, and `railway-live-final-20260602T020051Z` may be referenced in docs as internal Railway-lab evidence only. They are not committed artifacts, claim-ready performance evidence, or managed backup/DR proof. In short: they are not committed artifacts, not claim-ready performance evidence, and not managed backup/DR proof.