# GridVerse MVP

A minimal, testable MVP scaffold for a cross-domain energy optimization platform with:
- Local problems (Objects), shared signals (Morphisms), and adapters (Functors)
- A small graph-contract registry to version contracts and schemas
- Starter adapters for DER controllers and building heating, with a toy ADMM-lite solver placeholder
- Lightweight delta-sync primitives and governance-ish metadata scaffolding

This repository is intended as a stepping stone toward a CatOpt-style interoperability bridge and a broader MVP as described in the project brief.

Usage
- Run tests: bash test.sh
- Package: python -m build

Note: This is intentionally minimal. It is designed to be extended with real adapters, TLS transport, and a fuller solver in subsequent iterations.

EnergiaBridge: Canonical interoperability bridge
- A lightweight, vendor-agnostic bridge skeleton that maps GridVerse primitives (Objects, Morphisms, PlanDelta) to a canonical representation that adapters and external runtimes can consume.
- Provides to_canonical and from_canonical helpers to translate between per-site local problems and a global, pluggable transport layer.
- Serves as the first integration point toward a CatOpt-style interoperability layer, enabling plug-and-play adapters across DERs, pumps, and building systems without re-deriving global models.
- This module is intentionally small and will be extended with versioning, validation, and transport glue in follow-on iterations.