build(agent): molt-by#23c260 iteration

AGENTS.md

@@ -11,6 +11,10 @@ Architecture
 - Adapters scaffold in `adapters/` for cross-domain interoperability (IEC61850, simulators, etc.).
 - Governance ledger scaffold for audit trails.
 
+- Interop MVP: AddedEnergiBridge bridge (src/gridresilience_studio/bridge.py) and starter adapters under `src/gridresilience_studio/adapters/` as a scaffold for cross-domain interoperability.
+- Adapters: `IEC61850Adapter` and `MicrogridSimulatorAdapter` provide contracts to plug into the offline-first runtime.
+- Package layout: adapters are exposed as a Python package `gridresilience_studio.adapters` within the core project to support packaging and testing.
+
 Testing & Build
 - Tests located in `tests/` using pytest.
 - `test.sh` runs tests and validates packaging via `python -m build`.

README.md

@@ -19,6 +19,8 @@ Usage
 
 - EnergiBridge & MVP Extensions
 - This repository now includes a lightweight EnergiBridge canonical bridge to map GridResilience primitives to vendor-agnostic representations and starter adapters for IEC 61850 and a microgrid simulator. These scaffolds enable cross-domain interoperability while preserving offline-first operation.
+- The EnergiBridge bridge lives at `src/gridresilience_studio/bridge.py` and adapters live under `src/gridresilience_studio/adapters/` as a Python package.
+- Adapters scaffold contains: `IEC61850Adapter` and `MicrogridSimulatorAdapter` as starter implementations.
 - The MVP wiring includes: 2 starter adapters, a minimal LocalProblem/SharedSignals/PlanDelta sketch, and a toy delta-sync surface that can replay deterministically. See src/gridresilience_studio/energi_bridge.py and adapters/ for details.
 - This remains a seed MVP; additional phases will introduce governance ledger, secure identities, and cross-domain dashboards in subsequent iterations.
 

docs/contract_sketch.md

@@ -0,0 +1,34 @@
+# 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.

src/gridresilience_studio/adapters/__init__.py

@@ -0,0 +1,9 @@
+"""Adapters package for GridResilience Studio.
+
+This is a lightweight, intentionally minimal namespace to host starter adapters
+used by the MVP plan. Each adapter exposes a small set of entry points that
+can be composed by orchestration logic.
+"""
+
+from .iec61850 import IEC61850Adapter  # noqa: F401
+from .simulator import MicrogridSimulatorAdapter  # noqa: F401

src/gridresilience_studio/adapters/iec61850.py

@@ -0,0 +1,32 @@
+"""Starter IEC 61850 adapter scaffold (TLS-ready wiring placeholder)."""
+from __future__ import annotations
+
+from typing import Dict, Any
+
+from gridresilience_studio.core import Object, PlanDelta, Morphism
+
+
+class IEC61850Adapter:
+    """Lightweight scaffold for an IEC 61850 DER controller adapter.
+
+    This class does not implement real transport logic. It serves as a contract
+    surface for integration and tests. Real TLS/mutual-TLS wiring would be
+    added in a production implementation.
+    """
+
+    def __init__(self, endpoint: str = "localhost", port: int = 1880):
+        self.endpoint = endpoint
+        self.port = port
+
+    def connect(self) -> bool:
+        # Placeholder: assume connection succeeds in this scaffold
+        return True
+
+    def apply_delta(self, delta: PlanDelta) -> PlanDelta:
+        # Placeholder: echo the delta as if it was applied, with a local tag update
+        delta.tags["applied_by"] = "IEC61850Adapter"
+        return delta
+
+    def read_object(self, obj: Object) -> Dict[str, Any]:
+        # Placeholder: return a minimal telemetry snapshot
+        return {"id": obj.id, "status": "ok"}

src/gridresilience_studio/adapters/simulator.py

@@ -0,0 +1,25 @@
+"""Starter microgrid simulator adapter scaffold."""
+from __future__ import annotations
+
+from typing import Dict, Any
+from gridresilience_studio.core import Object, PlanDelta
+
+
+class MicrogridSimulatorAdapter:
+    """Tiny simulator adapter scaffold for cross-domain testing."""
+
+    def __init__(self, model: str = "default-sim"):
+        self.model = model
+
+    def start(self) -> bool:
+        return True
+
+    def stop(self) -> None:
+        pass
+
+    def apply_delta(self, delta: PlanDelta) -> PlanDelta:
+        delta.tags["simulated"] = "yes"
+        return delta
+
+    def read_object(self, obj: Object) -> Dict[str, Any]:
+        return {"id": obj.id, "state": "simulated"}

src/gridresilience_studio/bridge.py

@@ -0,0 +1,54 @@
+"""EnergiBridge-style canonical bridge (skeleton).
+
+This module provides a tiny, vendor-agnostic mapping layer that translates
+GridResilience canonical primitives (Objects, Morphisms, PlanDelta) into a
+generic cross-domain representation and back. It is intentionally lightweight
+and meant as a starting point for interoperability adapters.
+"""
+from __future__ import annotations
+
+from typing import Dict, Any
+
+from .core import Object, Morphism, PlanDelta
+
+
+class EnergiBridge:
+    """A minimal bridge that maps GridResilience primitives to a cross-domain payload.
+
+    Note: This is a scaffold. Real implementations should enforce versioning,
+    signing, and privacy controls as per MVP plans.
+    """
+
+    @staticmethod
+    def to_cross_domain(obj: Object) -> Dict[str, Any]:
+        return {
+            "type": "LocalDevicePlan",
+            "id": obj.id,
+            "kind": obj.type,
+            "properties": obj.properties,
+        }
+
+    @staticmethod
+    def to_cross_domain_morphism(morph: Morphism) -> Dict[str, Any]:
+        return {
+            "type": "SharedSignal",
+            "id": morph.id,
+            "source": morph.source,
+            "target": morph.target,
+            "signals": morph.signals,
+            "version": morph.version,
+        }
+
+    @staticmethod
+    def to_cross_domain_delta(delta: PlanDelta) -> Dict[str, Any]:
+        return {
+            "type": "PlanDelta",
+            "delta_id": delta.delta_id,
+            "islanded": delta.islanded,
+            "actions": delta.actions,
+            "tags": delta.tags,
+        }
+
+    @staticmethod
+    def from_cross_domain(obj_payload: Dict[str, Any]) -> Object:
+        return Object(id=obj_payload["id"], type=obj_payload.get("kind", obj_payload.get("type", "Unknown")), properties=obj_payload.get("properties", {}))