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.