# HopeMesh 2.0 (Skeleton)

This repository contains a production-ready skeleton for a federated, privacy-preserving humanitarian resource allocation platform as described in the HopeMesh 2.0 concept. The initial code focuses on:
- Defining canonical primitives: LocalProblem, SharedVariables, PlanDelta, Policy, AttestationHint, AuditLog, PrivacyBudget.
- A Graph-of-Contracts registry scaffold to manage data schemas and adapters.
- A minimal, deterministic SDK for building adapters that interoperate with the primitives.
- Packaging metadata and a test script that validates import/instantiation and packaging.

How to run
- Ensure Python 3.8+ is installed.
- Install build tooling and build the package:
  - python3 -m pip install --upgrade build
  - python3 -m build
- Smoke test:
  - python3 - << 'PY'
    from hopemesh.sdk import LocalProblem, SharedVariables
    lp = LocalProblem(name="RegionA Allocation")
    sv = SharedVariables(aggregate_type="sum")
    print(lp, sv)
    PY

This repo is intentionally minimal to bootstrap the architecture and testing workflow. A more complete implementation will grow the registry, adapters, and cryptographic governance features in subsequent commits.

Usage notes:
- Run tests via ./test.sh
- The test script builds the package and runs a smoke test importing and instantiating primitives.
- After successful tests, create a READY_TO_PUBLISH marker in the repo root.

READY_TO_PUBLISH is created when all checks pass.