edge-latency-aware-cross-venue-execution/AGENTS.md

ELAC-Plan Agents

Architecture overview:

• Primitives: LocalProblem, SharedVariables, DualVariables, PlanDelta, Governance/AuditLog
• Adapters: NBBOFeedAdapter (data feed), BrokerGatewayAdapter (execution gateway)
• Solver: LocalSolver (toy solver to generate PlanDelta from LocalProblem)
• API: FastAPI app exposing /problems and /status
• Audit: Governance/AuditLog stubs for future crypto-signed logging

Tech stack:

• Python 3.8+
• FastAPI + Uvicorn for REST API
• Pydantic for data modeling
• Lightweight, in-process Fed-Coord topology (ADMM-lite) via PlanDelta and DualVariables placeholders

Tests & packaging:

• Pytest for unit tests
• Build via python -m build
• Packaging metadata in pyproject.toml with package name edge_latency_aware_cross_venue_execution

How to contribute:

• Implement real adapters, enhance solver, and hook up a real consensus/secure-aggregation layer
• Add integration tests for end-to-end edge-to-edge flow