43 lines
2.8 KiB
Markdown
43 lines
2.8 KiB
Markdown
# ELAC-Plan Agents
|
||
|
||
Architecture and MVP changes
|
||
- Added a FastAPI-based MVP API (elac_plan.api) exposing /problems, /status, and /deltas endpoints to drive the LocalProblem -> PlanDelta flow locally.
|
||
- In-memory MVP storage for LocalProblem and PlanDelta with a toy LocalSolver and two starter adapters (NBBOFeedAdapter, BrokerGatewayAdapter).
|
||
- Public Python package surface updated: elac_plan.api is importable via elac_plan.api.app (FastAPI app), and re-exported from elac_plan for convenience.
|
||
- Tests: Added tests/test_api.py to validate problem creation and status endpoints using FastAPI TestClient.
|
||
- Test runner: test.sh added to execute pytest and python -m build for packaging validation.
|
||
- Documentation: README updated with MVP overview (next iteration to expand with Phase 1 governance, phase 2 cross-venue demos, etc.).
|
||
|
||
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
|
||
|
||
Enhancements plan (ELAC-Plan MVP refinement)
|
||
- Canonical primitives and interoperability: map ELAC primitives to a CatOpt-inspired canonical IR
|
||
- LocalProblem -> Object, SharedVariables -> Morphisms, PlanDelta -> PlanDelta, DualVariables -> DualVariables, AuditLog -> Governance/Provenance
|
||
- MVP wiring (8–12 weeks, 2–3 adapters): phase 0 skeleton + 2 adapters (venue-feed and broker gateway) over TLS; lightweight local solver; deterministic end-to-end delta-sync; toy cross-venue objective
|
||
- Phase 1: governance ledger scaffolding and identity layer; adapter conformance tests
|
||
- Phase 2: cross-domain demo in a simulated environment; publish a reference ELAC SDK
|
||
- Phase 3: hardware-in-the-loop testing; latency, plan quality, delta-sync costs, and privacy budgets
|
||
- Security and privacy: TEEs/hardware attestation for edge solvers; secure aggregation; possible zk-proofs
|
||
- Testing and metrics: latency, convergence, data-sharing volume, and governance auditability coverage
|
||
- Artifacts: draft DSL sketch (LocalProblem/SharedVariables/PlanDelta/DualVariables/AuditLog), toy adapters, minimal transport spec, RFC for registry surface
|