CityGrid Agent Architecture

Objective: Build a policy-driven, privacy-preserving federated optimization platform for cross-utility districts.
Core primitives (Canonical IR): LocalProblem, SharedVariables, DualVariables, PlanDelta, PrivacyBudget, AuditLog, PolicyBlock.
Graph-of-Contracts registry (GoC): versioned schemas for adapters and data contracts; conformance tests.
MVP Adapters: at least two starters (DER controller and district-chiller controller) translating to the canonical IR.
Transport: TLS-like, delta-sync with bounded staleness via EnergiBridge.
Privacy and governance: secure aggregation, privacy budgets, tamper-evident logs, DID-based identities.
Testing: unit tests for core data models, adapter interop tests, end-to-end demo hints.

This document serves as the architectural contract for contributors. See README for running instructions.