12 lines
881 B
Markdown
12 lines
881 B
Markdown
# 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.
|