idea93-gridguard-verifiable-telemetry/README.md

GridGuard-Inspired EnergiBridge Skeleton (MVP)

This repository provides a production-ready skeleton for a canonical interop layer (EnergiBridge-like) to enable secure, verifiable telemetry and orchestration across multi-asset power facilities.

• Phase 0 MVP: skeleton protocol plus two starter adapters (solar_meter and der_aggregator) over TLS (stubbed), a lightweight ADMM-lite local solver, deterministic delta-sync with replay capability, and a toy mesh-energy-balance objective.
• Phase 1–3: governance, identity, cross-domain pilots, SDKs, and hardware-in-the-loop validation.

What you’ll find:

• energi_bridge: Python package containing core schema definitions (LocalProblem, SharedVariables, PlanDelta, DualVariables, AuditLog, PrivacyBudget)
• energi_bridge/adapters: two toy adapters to simulate a solar-meter feed and a DER-aggregator
• tests/: pytest-based tests for schema validation and adapter interactions
• test.sh: script to run tests and build the package
• AGENTS.md: project-wide architectural and testing guidelines

How to run

• Install dependencies and run tests: ./test.sh
• Build the package: python -m build

This is a minimal, production-oriented scaffold intended to be extended in subsequent sprint tasks.