# EnergiaMesh (Prototype MVP)

EnergiaMesh is a prototype for federated, contract-driven microgrid optimization with on-device forecasting. This MVP focuses on the core data primitives and two starter adapters to bootstrap the CatOpt bridge in a minimal, testable form.

What you can expect in this MVP:
- Core primitives: LocalProblem, SharedVariables, PlanDelta, DualVariables, AuditLog
- A simple Graph-of-Contracts registry for versioned adapters
- Two starter adapters: DER controller and Weather station
- A small DSL sketch placeholder for LocalProblem/SharedVariables/PlanDelta
- Basic tests and packaging scaffolding to enable pytest and python build

- MVP Blueprint (EnergiaMesh-CatOpt Integration)
- This repository ships a production-ready MVP that aligns with the contract-driven federation concept. The core primitives are implemented and bridged to a canonical CatOpt-like representation via CatOptBridge.
- Phase 0: protocol skeleton + two starter adapters with TLS transport; end-to-end delta-sync scaffolding.
- Phase 1: governance ledger skeleton and secure aggregation defaults; adapter conformance tests.
- Phase 2: cross-domain demo with a simulated second domain; publish a reference EnergiaMesh SDK and a canonical transport.
- Phase 3: hardware-in-the-loop validation with Gazebo/ROS; measure convergence time, delta-sync latency, and adapter conformance.
- Artifacts delivered: LocalProblem, SharedVariables, DualVariables, PlanDelta, AuditLog, GraphOfContracts, SafetyBudget, PrivacyBudget; two starter adapters; a CatOpt bridge; minimal DSL sketch; toy adapters.
- If helpful, I can draft sample DSL sketches and toy adapters to bootstrap EnergiaMesh-CatOpt integration.
- Getting started
- Install dependencies and run tests:
  - bash test.sh
- To explore the MVP, look under src/energiamesh/

Packaging and publishing
- This repository uses a Python packaging layout under src/ with pyproject.toml.
- See READY_TO_PUBLISH when you are ready to publish the MVP as a package.