idea109-secureex-hardware-accelerated/AGENTS.md

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.