diff --git a/README.md b/README.md index bcb60f5..737cd4d 100644 --- a/README.md +++ b/README.md @@ -24,3 +24,21 @@ This repository includes starter adapters to bootstrap interoperability: Ready to publish signal - Once all MVP components are validated, a READY_TO_PUBLISH file will be created at the repo root. + +### EnergiBridge Interoperability (Optional Reference) + +- EnergiBridge provides a canonical, lightweight bridge between GridVerse primitives and a vendor-agnostic intermediate representation (IR). +- It enables plug-and-play adapters and a Graph-of-Contracts registry to interoperate with external backbones (e.g., Open-EnergyMesh, CatOpt). +- Core mappings (illustrative): + - Objects -> LocalProblems (per-site optimization tasks) + - Morphisms -> SharedVariables / DualVariables (signals and priors) + - PlanDelta -> incremental decisions with metadata (timestamp, contract_id, signature) + - Limits/Colimits -> global constraints layer and policy hooks + - AuditLog / PrivacyBudget -> governance and audit trails per message + +- MVP hook: EnergiBridge provides to_ir / from_ir translations and a minimal bootstrap_contracts helper to seed a registry with basic schemas. +- Starter adapters (DER, Building Load, etc.) wired through the Adapter Marketplace can consume/emit the canonical IR for cross-domain optimization. +- Next steps (phased): + 1) Integrate EnergiBridge mappings into the GraphContractRegistry conformance flows. + 2) Add lightweight tests for to_ir / from_ir translations. + 3) Expand the registry to support per-message metadata for auditability and replay protection.