gridverse-open-low-code-pla.../AGENTS.md

19 lines
828 B
Markdown

# 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