edge-latency-aware-cross-ve.../AGENTS.md

24 lines
944 B
Markdown

# 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