# AGENTS.md

Architectural rules and contribution guidelines for HopeMesh 2.0 bootstrap.

- Language: Python. Packaging via `pyproject.toml` with setuptools.
- Core modules:
  - `hopemesh.core`: canonical primitives and fingerprinting helpers.
  - `hopemesh.contracts`: Graph-of-Contracts registry plus tamper-evident governance ledger.
  - `hopemesh.sdk`: DSL-style constructors and delta merge helpers.
  - `hopemesh.cli`: local registry and ledger CLI.
- Testing:
  - `test.sh` runs `python3 -m build`, a smoke import/instantiate check, and `python3 -m unittest discover -s tests -p 'test_*.py'`.
- Publishing:
  - Create `READY_TO_PUBLISH` only when the repo is fully green and the implementation scope matches the published description.

Keep changes small, deterministic, and standard-library only unless a new dependency is explicitly justified.