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

26 lines
1.1 KiB
Markdown

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