# GridVerse MVP Scaffold

This repository contains a minimal MVP scaffold for a cross-domain energy optimization platform inspired by the GridVerse vision. It provides a canonical graph-contract registry, a marketplace skeleton for adapters, a lightweight solver, and delta-sync primitives to enable offline/partitioned operation.

What's included
- In-memory ContractRegistry to version and validate contracts (Objects, Morphisms, PlanDelta, etc.).
- Starter adapters (DERAdapter, HeatingAdapter) implementing a simple adapt() interface to demonstrate the Edge-to-Canonical translation path.
- Tiny ADMM-like solver (gridverse.solver.admm_solve) suitable for wiring into a larger distributed stack.
- Delta-sync primitive (gridverse.delta_sync.reconcile) for merging divergent states.
- Tests validating basic wiring and interfaces (tests/test_basic.py).

How to run
- Install dependencies via pyproject.toml (requires setuptools, wheel).
- Run tests: bash test.sh
- Build package: python -m build

This MVP is intentionally small but designed to be extended into a full Graph-of-Contracts and Adapter Marketplace MVP over subsequent iterations.

License: MIT (example)