idea105-deltatrace/AGENTS.md

32 lines
808 B
Markdown

# 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.