deltatrace-deterministic-re.../AGENTS.md

1.1 KiB

DeltaTrace MVP: Deterministic Replayable Latency & Compliance Tracing

Architecture overview

  • delta_trace core: data models (LocalEvent, PlanDelta, OrderEvent, FillEvent, RiskCheck, AuditLog, PrivacyBudget, Metadata)
  • delta_trace replay: deterministic replay engine skeleton to reproduce a decision path
  • delta_trace adapters: starter adapters (FIX feed, exchange gateway) over TLS
  • delta_trace cli: toy dataset generator and replay runner

Tech stack

  • Python 3.9+ (core, replay, adapters, CLI)
  • Lightweight, pluggable architecture to support future ports and cross-ecosystem interoperability

How to run tests

  • If a test script exists, run: bash test.sh
  • For packaging checks (Python), verify: python3 -m build

Contribution guidelines

  • Add small, focused changes when possible
  • New features should include tests or toy demonstrations
  • Do not modify packaging metadata unless explicitly requested
  • Write code with clear, minimal, well-documented intent

Usage notes

  • This repo aims for cross-domain interoperability with a canonical TraceDSL and deterministic replay primitives
  • MVP is intentionally minimal to enable rapid onboarding and experimentation