# GridVerse DSL Sketch (Conceptual)

This document outlines a tiny, human-friendly DSL to describe a LocalProblem
and its associated SharedVariables that GridVerse adapters will map into a
canonical bundle for cross-domain optimization.

Core concepts
- LocalProblem (Objects): a local optimization task at a site with a set of
  tunable variables.
- SharedVariables (Morphisms): signals exchanged with other sites or global
  constraints.
- PlanDelta: incremental actions derived from solving the local/global problem.
- Governance/Audit: lightweight metadata for traceability (version/timestamp).

Tiny DSL example
site_id=siteA
description=DER and building load coordination
variables=pv_capacity=5,load=10,storage=2
variables=another_key=42

Notes
- This DSL is intentionally minimal to bootstrap interoperability without
  introducing a full language runtime.
- A real system would support richer types, validation, and versioning hooks.

EnergiaBridge notes
- Bridge: Canonical GridVerse -> vendor-agnostic form; map LocalProblem/SharedVariables/PlanDelta to interoperable contracts.
- The registry keeps contract schemas and adapter descriptors with per-message metadata (version, timestamp, nonce).
- A minimal example showing a translated LocalProblem into a CanonicalBundle via the EnergiaBridge.