38 lines
1.1 KiB
Markdown
38 lines
1.1 KiB
Markdown
# 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`.
|