CrisisOps Open Crisis: Agent Guidelines

Architecture overview

Core: crisisops/core.py defines the Graph-of-Contracts primitives: Object, Morphism, PlanDelta, DualVariables.
Planner: crisisops/planner.py implements a lightweight ADMM-like planner for MVP orchestration between domains.
Adapters: crisisops/adapters_registry.py provides a registry; toy adapters live in crisisops/adapters/.
Governance: crisisops/governance.py offers a simple SQLite-backed governance ledger for auditability.
CLI: crisisops/cli.py exposes a tiny CLI for quick experiments.

Tech stack

Language: Python 3.8+.
Packaging: pyproject.toml configured for setuptools-based packaging; package name is idea135-crisisops-open-crisis.
Data stores: in-memory for MVP; governance ledger uses SQLite (persistable in memory or file).
Tests: pytest-based unit tests under tests/.

Testing commands

Run tests: ./test.sh
Run planner demo: python -m crisisops.cli plan (or pytest tests/test_planner.py)

Contribution rules

Implement small, composable features with clear interfaces.
Add tests for any new behavior.
Update AGENTS.md with details whenever scope or architecture changes significantly.

Notes

This repository is the starting point for a larger federation/GoC-based platform. The MVP demonstrates core primitives, a toy planner, and a minimal adapter ecosystem.