gridverse-open-low-code-platform-for-cro/AGENTS.md

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

EnergiBridge Interoperability (Skeleton)

• Added gridverse/energi_bridge.py to provide a canonical bridge between GridVerse primitives and a vendor-agnostic intermediate representation (IR).
• This skeleton demonstrates verbs for translating contracts to IR, and a small mapper to illustrate adapter wiring without hard coupling to solvers.
• Use this as a reference when implementing cross-domain adapters and the Adapter Marketplace in Phase 0.

Next steps:

• Integrate EnergiBridge mappings into the GraphContractRegistry conformance flows.
• Add lightweight tests for to_ir / from_ir translations.
• Expand the registry to support per-message metadata for auditability and replay protection.