# 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.