55 lines
1.4 KiB
Markdown
55 lines
1.4 KiB
Markdown
# AidMesh
|
|
|
|
AidMesh is a small offline-first planning engine for disaster response and humanitarian logistics.
|
|
|
|
This repository currently ships a production-shaped core slice focused on deterministic field coordination:
|
|
|
|
- `ContractScript` parsing into a canonical portable module
|
|
- bounded resource allocation for scarce field supplies
|
|
- signed plan deltas with replayable merge semantics
|
|
- starter adapters for inventory and drone routing
|
|
- deterministic replay for after-action review
|
|
|
|
## What It Does
|
|
|
|
- Models a site as capacities plus prioritized tasks.
|
|
- Compiles a tiny ContractScript into canonical JSON bytes and a stable digest.
|
|
- Solves tasks greedily under resource limits.
|
|
- Signs and verifies plan deltas with HMAC-SHA256.
|
|
- Merges and replays offline updates deterministically.
|
|
|
|
## Project Layout
|
|
|
|
- `src/idea153_aidmesh_mobile_first/contracts.py`
|
|
- `src/idea153_aidmesh_mobile_first/solver.py`
|
|
- `src/idea153_aidmesh_mobile_first/sync.py`
|
|
- `src/idea153_aidmesh_mobile_first/replay.py`
|
|
- `src/idea153_aidmesh_mobile_first/adapters.py`
|
|
- `tests/test_aidmesh.py`
|
|
|
|
## Install
|
|
|
|
```bash
|
|
python3 -m pip install -e .
|
|
```
|
|
|
|
## Test
|
|
|
|
```bash
|
|
bash test.sh
|
|
```
|
|
|
|
## ContractScript Example
|
|
|
|
```text
|
|
site "field-clinic-7"
|
|
capacity meds 10
|
|
capacity water 6
|
|
task triage priority 10 demand meds=4, water=2
|
|
task shelter priority 4 demand water=4
|
|
```
|
|
|
|
## Package Metadata
|
|
|
|
The distribution name is `idea153-aidmesh-mobile-first` and the long description is sourced from this `README.md`.
|