gridresilience-studio-offline-first-cros/docs/contract_sketch.md

Toy Contract Sketch: LocalDevicePlan / SharedSignals / PlanDelta

This document outlines a minimal, self-contained contract sketch to bootstrap interoperability between GridResilience primitives and cross-domain adapters.

• LocalDevicePlan (Object): Represents a DER/load/pump with id, kind, and properties.
• SharedSignals (Morphism): Represents telemetry/policy signals between two devices, with a version for consistency.
• PlanDelta: Incremental islanding and load-shedding updates, with an optional cryptographic tag for integrity.
• Example payload shapes (JSON-like):

Object example: { "id": "DER1", "type": "DER", "properties": {"rated_kW": 500} }

Morphism example: { "id": "SIG1", "source": "DER1", "target": "LOAD1", "signals": {"voltage": 1.02}, "version": 1 }

PlanDelta example: { "delta_id": "D1", "islanded": true, "actions": [{"type": "island", "target": "LOAD1"}], "tags": {"sig": "v1"} }

This sketch is intentionally lightweight and is meant to guide adapter implementations and API design. It is not a full specification.