open-energymesh-offline-first-distribute/AGENTS.md

Open-EnergyMesh Agents

• Architecture: Node.js in-memory MVP for offline-first mesh orchestration.
• Tech Stack: JavaScript (CommonJS), minimal data models for Device/DER/Forecast, simple data flow engine.
• Testing: node test/test.js; run via npm test.
• Commands:
• Install (if needed): npm install
• Run tests: npm test
• Publish readiness: not yet; see READY_TO_PUBLISH marker when ready.

Note: This repository now includes a minimal offline-first MVP scaffold with a tiny ADMM-lite integration path. See src/solver_admm.js and src/mesh.js for the integration points, and test/test.js for basic behavioral tests.

• Testing & CI guidance (current MVP):

• Run tests locally with npm test or via the wrapper ./test.sh.

• The test.sh wrapper also attempts a Python packaging build if a pyproject.toml or setup.py exists.

• Expected test suite coverage includes basic flow calculations, delta-sync, and a minimal ADMM integration path.

• When extending, add unit tests for new adapters or new math stability checks (e.g., ADMM convergence behavior).

• Architecture: Node.js in-memory MVP for offline-first mesh orchestration.

• Tech Stack: JavaScript (CommonJS), minimal data models for Device/DER/Forecast, simple flow engine.

• Testing: node test/test.js; run via npm test.

• Commands:

• Install (if needed): npm install

• Run tests: npm test

• Publish readiness: not yet; see READY_TO_PUBLISH marker when ready.