# GridVerse MVP - Architectural Guidelines

- Language: Python 3.x
- Testing: pytest
- Packaging: python -m build (PEP 517/518)
- Quick run: `bash test.sh`

Architecture overview:
- gridverse.contracts: data classes for LocalProblem, SharedVariables, PlanDelta, ConstraintSet, DeviceInfo
- gridverse.registry: GraphContractRegistry - versioned, schema-validated registry
- gridverse.adapter_marketplace: starter adapters and a skeleton interface
- gridverse.solver: tiny ADMM-lite solver used for MVP planning
- gridverse.delta_sync: deterministic delta-sync stub for offline/partitioned operation

- Testing and CI hints:
- Tests cover contracts, simple solver, and delta-sync replay behavior
- Run: `bash test.sh` to verify pytest tests and packaging
- test.sh runs pytest and builds the package to ensure packaging integrity