# HopeMesh AGENTS

- Overview
  - A production-oriented skeleton for a cross-domain, offline-first resource allocation system with governance and adapters.

- Architecture
  - Core primitives: LocalProblem, SharedSignals, PlanDelta (GoC-style contracts).
  - Graph of Contracts (GoC): lightweight in-process graph to connect problems, signals, and actions.
  - Adapters: pluggable endpoints for field units, warehouses, transport hubs; starter adapters included.
  - Transport: TLS-backed channel abstraction for inter-device communication.
  - Governance: skeleton ledger for provenance with per-message signatures (extensible to DID-based identities).

- Tech Stack
  - Language: Python 3.9+
  - Packaging: pyproject.toml (setuptools)

- Testing and quality gates
  - Basic unit tests for core primitives.
  - test.sh to run pytest and python -m build for packaging checks.
  - AGENTS.md intentionally documents architecture so future agents can contribute without breaking it.

- How to run locally
  - python3 -m pytest
  - bash test.sh

- Publishing rules
  - Follow the publish checklist in the main task description; ensure READY_TO_PUBLISH exists when ready.