GridResilience Studio

Offline-first cross-domain orchestration for disaster-resilient grids.

- Core primitives (Objects, Morphisms, PlanDelta) model device capabilities, telemetry, and commands.
- Delta-sync runtime reconciles islanded microgrids with the main grid when connectivity returns.
- Plug-and-play adapters marketplace (IEC 61850, inverters, pumps, HVAC, etc.) with TLS-friendly transports.
- Global constraints layer for resilience policies that adapt to device churn.
- Simulation and hardware-in-the-loop testing with KPI dashboards.
- Governance ledger and event sourcing for auditability.

### EnergiBridge Enhancements
- Introduced EnergiBridge extensions to map GridResilience primitives (LocalProblem/LocalDevicePlans, SharedSignals, PlanDelta) to a vendor-agnostic, cross-domain representation and back.
- Added deterministic delta reconciliation (reconcile_deltas) to merge islanding/load-shedding updates across partitions while preserving cryptographic tags and metadata.
- Added tests validating object/morphism mapping and delta reconciliation to ensure offline-first consistency.
- Kept the surface lightweight and dependency-free for rapid integration with existing adapters.

Project structure and packaging
- Python-based core with adapters under src/gridresilience_studio/adapters.
- Core primitives live in src/gridresilience_studio/core.py.
- Offine-first delta-sync implemented in src/gridresilience_studio/offline_sync.py.
- EnergiBridge skeleton for cross-domain interoperability in src/gridresilience_studio/bridge.py.
- Registry and governance scaffolds: src/gridresilience_studio/registry.py and governance.py.

How to run tests and build
- Install: pip install -e .
- Run tests: bash test.sh
- Build package: python3 -m build

Notes
- This repository is intentionally minimal yet production-ready with extension hooks for growth.
- See AGENTS.md for architectural guidelines and contribution rules.