# 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.