# AGENTS.md

## Repository Shape

- `src/idea109_secureex_hardware_accelerated/`: package code.
- `tests/`: unit tests.
- `test.sh`: canonical verification entrypoint.
- `README.md`: architecture and usage.

## Tech Stack

- Python 3.10+
- Standard library only for runtime code.
- SQLite for the governance ledger.
- Setuptools for packaging.

## Architecture

- `primitives.py`: canonical trading and governance dataclasses.
- `adapters.py`: FIX and WebSocket-to-canonical adapters.
- `enclave.py`: deterministic enclave execution and attestation model.
- `governance.py`: append-only, hash-chained SQLite ledger.
- `delta_sync.py`: deterministic reconciliation helpers.
- `replay.py`: offline deterministic replay harness and CLI.

## Rules

- Keep new logic deterministic unless explicit randomness is required and seeded.
- Preserve the hash chain in the governance ledger.
- Do not weaken validation in adapters or attestation verification.
- Prefer the smallest correct change.
- Update tests when changing canonical payload shapes or replay behavior.

## Verification

- `bash test.sh`
- The script must run unit tests and `python3 -m build`.