# GridVerse Open Low-Code Platform for CRO (MVP)

This repository implements a minimal, Python-based MVP of GridVerse: a modular, cross-domain energy optimization platform with a graph-contract registry and an adapter marketplace.

- Core concepts: Objects, Morphisms, Functors
- Lightweight Registry for contracts and adapters
- Starter DER adapter and a small adapter marketplace scaffold
- Marketplace and Registry: lightweight in-process components for adapter discovery and contract validation.
  - AdapterMarketplace (gridverse_open_low_code_platform_for_cro.marketplace) registers and lists adapters.
  - ContractRegistry (gridverse_open_low_code_platform_for_cro.registry) validates and stores contract schemas.
- End-to-end tests and packaging skeleton
- MVP extensions in progress
- DeltaSync: lightweight delta-state helper for cross-domain messaging (gridverse_open_low_code_platform_for_cro/core.py)
- registry_contracts: minimal helpers for contract schema validation (gridverse_open_low_code_platform_for_cro/registry_contracts.py)


How to run
- bash test.sh

Philosophy
- Keep the MVP small, testable, and extensible. Build only what is necessary to validate the core ideas and provide a stable foundation for future adapters and modules.

This README hooks into the Python packaging metadata in pyproject.toml, enabling a public package registry entry once published.

## Roadmap (MVP Alignment)
- Phase 0 (2 weeks): protocol skeleton, LocalProblem/SharedVariables/PlanDelta contracts, two starter adapters, TLS transport, and a minimal ADMM-lite solver.
- Phase 1 (3-4 weeks): add Global Constraint Modules (Limits/Colimits), governance ledger scaffolding, and offline digital-twin simulations.
- Phase 2 (2-3 weeks): Adapter Marketplace onboarding, minimal codegen path, and a reference DSL sketch for composing graphs of devices and constraints.
- Phase 3 (3-4 weeks): hardware-in-the-loop validation with 2-domain cross-domain scenarios, performance metrics (convergence, latency, plan quality).
- Success criteria: end-to-end convergence on toy objectives, auditable reconciliation logs, and a working conformance test harness for adapters.