# HopeMesh: Federated, Privacy-Preserving Humanitarian Resource Allocation

Overview
- HopeMesh is a distributed, offline-first platform to coordinate humanitarian aid across agencies in crisis zones with intermittent connectivity.
- It models local needs as LocalProblem, supply signals as SharedSignals, and delta actions as PlanDelta within a Graph-of-Contracts (GoC) architecture.
- The MVP focuses on cross-domain adapters (supply-inventory tracker and field-needs collector) with TLS transport, governance ledger skeleton, and a small cross-domain objective.

Architecture (high level)
- Core primitives: LocalProblem, SharedSignals, PlanDelta
- Graph-of-Contracts (GoC): a lightweight graph of contracts and adapters
- Adapters: plug in domain-specific data sources and workflows (starter adapters included)
- Governance ledger: per-message provenance and signature trail (skeleton)
- TLS transport: secure channels between field units and hubs

Tech Stack (by component)
- Language: Python 3.9+
- Packaging: pyproject.toml (setuptools) with an executable test script
- API surface: lightweight Python classes and simple in-memory data stores

How to run (local dev)
- Install dependencies: (no heavy deps required yet)
- Run tests: ./test.sh
- Package and build: python3 -m build

Packaging hooks
- The project name in pyproject.toml is idea152-hopemesh-federated-privacy to satisfy publishing rules.
- The Python importable package is idea152_hopemesh_federated_privacy (underscore style) to align with Python packaging norms.

Contributing
- See AGENTS.md for architecture, testing commands, and contribution rules.

License: MIT (example)