# CrisisOps: Open Crisis-Response Orchestrator (Prototype)

Overview
- CrisisOps provides a Graph-of-Contracts (GoC) primitive model to coordinate crisis-response operations across domains (e.g., field logistics, shelters) with offline-first delta-sync and auditability.
- The current implementation adds deterministic snapshots, replay helpers, and audit-ready plan hashes so field decisions can be replayed after an event.
- The planner now emits ordered dispatch actions with a lightweight utility score to make plan comparisons easier.

What’s inside
- Python package crisisops with core primitives, planner, adapters registry, and governance ledger.
- Toy adapters: inventory_portal and gis_dispatch (under crisisops/adapters).
- CLI scaffold for quick experiments and snapshot inspection.
- Tests validating planner behavior and deterministic replay.
- Packaging metadata and test script for CI compliance.

Getting started
- Install: python3 -m build (from pyproject.toml)
- Run tests: ./test.sh
- Explore planner: python3 -m crisisops.cli plan
- Inspect a snapshot: python3 -m crisisops.cli snapshot

Architecture links
- Core primitives: crisisops.core
- Planner: crisisops.planner
- Replay and snapshot utilities: crisisops.replay
- Adapters registry and toy adapters: crisisops.adapters_registry, crisisops.adapters.*
- Governance ledger: crisisops.governance

This repository follows the CrisisOps Open Crisis guidelines and is designed to be extended in small, well-scoped increments.