CrisisGuard: Federated Privacy-Preserving Crisis Response Sandbox

CrisisGuard is a federation-oriented platform for humanitarian crisis response. It defines canonical representations for plans, signals, and deltas, enables offline-first delta-sync, secure aggregation, and tamper-evident governance logs anchored by hashes. It includes a Graph-of-Contracts registry and adapters marketplace skeleton, a toy disaster scenario, and an SDK-friendly Python package structure for rapid prototyping and testing.

What you get in this repository

• Core data models: LocalPlan, SharedSignals, PlanDelta
• Tamper-evident governance log with hash chaining
• Lightweight Graph-of-Contracts registry for adapters
• Two starter adapters: NeedsCollector and ResourcePlanner
• Toy disaster scenario harness demonstrating offline delta-sync
• Basic tests validating contracts and delta application
• Packaging scaffold (pyproject.toml) and test runner (test.sh)
• Developer guide (AGENTS.md) describing architecture and testing commands

Notes on scope

• This is a production-minded scaffold (not a full MVP). It focuses on solid architecture, tests, and a clear path for plugging in adapters and governance components.
• All code is designed to be extended into a larger distributed system with TLS transport, DID-based identities, and crypto-enabled privacy primitives.

How to run locally (summary)

• Install dependencies for tests: see test.sh and requirements (pytest is used).
• Run tests: bash test.sh
• Build package: python3 -m build

This repository is meant to be extended by subsequent sprint agents in the SWARM workflow.