# ELAC-Plan (Edge-Latency Aware Cross-Venue Execution Planner)

This repository implements a production-oriented MVP of ELAC-Plan: an edge-native federation for cross-venue execution planning with privacy-preserving signals and deterministic delta-sync.

- Primitives map to canonical primitives used across adapters:
  - Objects: LocalProblem
  - Morphisms: SharedVariables
  - DualVariables: DualVariables
  - PlanDelta: PlanDelta
  - Governance/AuditLog: GovernanceAuditLog (stubbed for now)
- MVP adapters:
  - NBBOFeedAdapter: translates NBBO-like feeds into SharedVariables
  - BrokerGatewayAdapter: simulates broker API publishing of PlanDelta
- Solver: LocalSolver (toy solver)
- API: FastAPI app exposing /problems and /status to drive LocalProblem -> PlanDelta flow
- Packaging: Python packaging metadata in pyproject.toml; tests with pytest; build via python -m build

How to run (dev):
- Run tests: ./test.sh
- Run API locally (example): uvicorn elac_plan.api:app --reload

This is a minimal but production-conscious MVP intended to be extended by adding governance ledger, secure aggregation, and real adapters in subsequent iterations.

Interop and roadmap
- See docs/elac_plan_interop.md for a minimal DSL sketch and EnergiBridge-style interoperability planning (LocalProblem/SharedVariables/PlanDelta/DualVariables/AuditLog).
- The MVP already includes two adapters (NBBOFeedAdapter and BrokerGatewayAdapter) and a toy LocalSolver for end-to-end delta-sync.
- The plan includes phases for governance, secure aggregation, cross-venue demos, and HIL testing; reference SDK and sample DSL are provided for integration with other domains.