# MediMesh

MediMesh is a federated coordination platform for disaster-affected health systems.
It keeps site-level data local, exchanges only aggregated signals, and uses a canonical contract registry to coordinate hospitals, clinics, EMS, pharmacies, and supply caches under privacy and governance constraints.

## What It Provides

- Graph-of-Contracts registry for schema and adapter governance
- Distributed allocator for scarce resources using policy-weighted coordination
- SQLite-backed tamper-evident governance log with cryptographic attestations
- Offline-first delta storage with deterministic replay for audits
- Starter hospital inventory and EMS/logistics adapters
- End-to-end toy scenario with a shortage shock

## Package Layout

- `medimesh.contracts`: canonical contracts and registry
- `medimesh.solver`: local and distributed allocation logic
- `medimesh.governance`: identities, credentials, and ledger
- `medimesh.sync`: offline delta sync and replay
- `medimesh.adapters`: reference controllers
- `medimesh.scenario`: demo orchestration

## Run

```bash
bash test.sh
python -m medimesh
```

## Packaging

- Python distribution name: `idea150-medimesh-federated-privacy`
- `readme = "README.md"` is wired into `pyproject.toml`