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.