idea168-crisispulse-federated-resource/README.md

CrisisPulse: Federated Resource Orchestration (MVP)

This repository implements a production-grade MVP for CrisisPulse, a federated resource orchestration platform intended for disaster-relief camp networks. The MVP focuses on core primitives: local ledger with delta-sync, a contract registry (Graph-of-Contracts), adapters for domain-specific devices, a governance ledger, privacy-preserving summaries, and a testbed for cross-domain collaboration.

CrisisPulse also includes a tiny but extensible CrisisPolicy DSL (crisispolicy.py) to bootstrap interoperability across NGOs and humanitarian devices. This DSL is designed to be incrementally enhanced alongside the Graph-of-Contracts and adapters.

Structure overview:

• src/idea168_crisispulse_federated_resource/: Python package with core modules
• tests/: unit tests for core primitives
• AGENTS.md: architecture, tech stack, testing commands, and contribution rules
• test.sh: reproducible test runner that also builds the package
• READY_TO_PUBLISH: marker file indicating readiness for publish (created by intention when ready)

How to run locally:

• Install dependencies: python -m pip install -e .
• Run tests: bash test.sh
• Review README for project goals and architecture details.

This is a minimal, production-oriented MVP designed to be extended by follow-up iterations.