29 lines
1.5 KiB
Markdown
29 lines
1.5 KiB
Markdown
# 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.
|