idea135-crisisops-open-crisis/README.md

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.
• MVP demonstrates two domains with toy adapters and a minimal ADMM-like planner. It is designed to be production-ready in architecture, not just a proof-of-concept.

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.
• Tests validating planner behavior.
• 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

Architecture links

• Core primitives: crisisops.core
• Planner: crisisops.planner
• 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.