energiamesh-federated-contract-driven-mi/AGENTS.md

EnergiaMesh - Agent Collaboration Guide

Architecture

• Core primitives: LocalProblem, SharedVariables, PlanDelta, DualVariables, AuditLog
• Graph-of-Contracts registry with versioned adapters
• Lightweight starter adapters (DER controller, Weather station)
• Transport: TLS-enabled (stubbed in MVP)
• Adapter marketplace concept for pilots across vendors

Tech Stack (MVP)

• Python 3.9+
• Core: energiamesh.core
• Adapters: energiamesh.adapters
• DSL sketch: energiamesh.dsl
• Tests: pytest

Testing & Commands

• Run tests: pytest (in root, after pip install -e . or using build) via test.sh.
• Build: python3 -m build in a clean environment.
• Linting: not included in MVP to keep scope small; integrate later.

Development Rules

• Minimal, well-scoped changes. Avoid feature creep in this repository iteration.
• Add tests for every new public API surface.
• Use the src/ layout for packaging; keep imports stable.