idea105-deltatrace/AGENTS.md

AGENTS.md

Architecture

• Python package: deltatrace
• Core modules:
  • event_graph.py for causal event DAGs
  • replay_engine.py for deterministic replay
  • audit_log.py for signed audit trails
  • adapters.py for market-data and exchange adapters
  • demo.py for an end-to-end pipeline example

Tech Stack

• Python 3.10+
• setuptools for packaging
• cryptography for Ed25519 signing
• pytest for test execution when available

Verification

• bash test.sh
• python -m build
• python -m pytest tests/ -v

Contribution Rules

• Keep changes minimal and focused.
• Preserve deterministic behavior in replay and tests.
• Prefer standard library code unless a dependency is clearly justified.
• Update this file when packaging, test commands, or module layout changes.