27 lines
1.3 KiB
Markdown
27 lines
1.3 KiB
Markdown
# 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.
|