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