exoroute-cross-venue-order-routing-orche/AGENTS.md

ExoRoute MVP: Cross-Venue Order Routing Orchestrator

Architecture overview

• Vendor-agnostic cross-venue routing orchestrator with deterministic replay-ready deltas.
• Privacy-first data handling: per-signal budgets and secure aggregation; raw signals stay local.
• Lightweight Graph-of-Contracts registry to map adapters to data contracts and engines.
• Deterministic offline replay via PlanDelta deltas; hash chains for auditability.
• Minimal, extensible DSL: LocalProblem, SharedVariables, PlanDelta, DualVariables, PrivacyBudget, AuditLog, Graph-of-Contracts.

Tech stack (current MVP)

• Language: Python 3.9+
• Core primitives (LocalProblem, SharedVariables, PlanDelta, DualVariables, PrivacyBudget, AuditLog, GraphOfContractsRegistry)
• Lightweight adapters (starter set): FIX/WebSocket price-feed and simulated venue adapters
• Deterministic replay: delta store and hash-based audit trail
• Minimal EnergiBridge-like interoperability layer (prototyping in this repo)

Testing and contribution

• Run tests with: ./test.sh
• Ensure python packaging builds with: python -m build
• Add unit tests for new primitives and basic flow
• Update AGENTS.md if architecture or tests shift

Branching and publishing

• This repo follows a strict, production-focused workflow. Do not publish until all tests pass.
• When ready to publish, ensure pyproject.toml or setup.py exists and README.md documents package usage.

End of document