# SunHub Agent Overview

Architecture
- SunHub is a modular, city-scale solar siting and DER coordination platform.
- Core abstractions:
  - Object: a neighborhood-level optimization target (Object in a city may map to a block or district).
  - SharedSignal: aggregated signals used for cross-neighborhood coordination (e.g., forecasted irradiance, storage state).
  - PlanDelta: incremental actions to advance planning (delta updates to per-neighborhood plans).
- GraphOfContracts: registry for adapters to external systems (GIS, weather, DER controllers).
- Lightweight federation: simplified ADMM-lite loop coordinating neighborhood plans while preserving locality.

Tech Stack (in this repo)
- Python 3.10+ with setuptools-based packaging (pyproject.toml).
- Tests powered by pytest.
- Lightweight in-memory data models for MVP; pluggable adapters via GraphOfContracts.

Testing and Commands
- Run tests: `bash test.sh` in repo root. This also builds the package (`python3 -m build`).
- Local development: import sunhub.core modules and run minimal scenarios via `pytest` tests.

Contribution Rules
- Use the AGENTS.md as a jump-off for new agents; implement features in small, well-scoped patches.
- All changes must pass tests before PRs; avoid breaking existing contracts in the in-repo API.

Notes
- This document will be updated as the project evolves and new agents are introduced.