# PolicyMesh: Policy-Driven Federated Optimization (MVP)

PolicyMesh is a scaffold for building a policy-driven, privacy-preserving, offline-first federated optimization platform across cross-domain assets (electric DERs, water pumps, heating systems). This MVP focuses on clear separation of concerns, a minimal Graph-of-Contracts (GoC) abstraction, a lightweight ADMM-like solver, and a governance ledger for auditable settlements.

What’s included in this MVP
- Core data models: LocalPolicySet, GlobalConstraints, DataExposurePolicy
- Lightweight PolicyMesh engine with local problem management and a tiny ADMM-lite step
- In-memory registry for adapters/contracts (extensible to persistent storage)
- Minimal solver utilities (policy aggregation and delta-sync scaffolding)
- Basic tests verifying a two-domain flow and ledger growth
- Packaging metadata and a test script that runs pytest and builds the package

How to run
- Install dependencies and run tests:
  - python3 -m pip install -r requirements.txt  (if you add dependencies)
  - bash test.sh

Notes
- This is an MVP scaffolding intended for extension. It focuses on architectural clarity and testability over full production features.