# EdgeMind - Agent Documentation

Architecture overview:
- core: idea15_edgemind_verifiable_onboard
- modules:
  - planner.py: Lightweight MILP-free planner that matches goals to the cheapest providing action within energy budgets
  - contracts.py: SafetyContract primitives for pre/post validation
  - contract_layer.py: Data-contract layer scaffolding (Objects, Morphisms, Functors)
  - cli.py: Simple CLI to exercise the planner and contracts

Tech stack:
- Python 3.8+
- Numpy, Pydantic, PyYAML for data structures and serialization
- Lightweight, edge-friendly planning logic with open-ended extensibility

How to test:
- Run pytest to execute tests
- Use test.sh to run tests and packaging verification (_build_) locally

Testing commands:
- bash test.sh
- python3 -m build

Rules for contributors:
- Implement features with small, well-scoped patches
- Write tests for every new feature
- Keep interfaces backwards-compatible unless explicitly requested
- Update AGENTS.md with notable architectural changes