idea143-crisisguard-federat.../AGENTS.md

1.0 KiB

CrisisGuard - Agents & Architecture

  • Architecture: modular Python package under crisisguard/ with a minimal Graph-of-Contracts, LocalPlan/SharedSignals/PlanDelta models, and two starter adapters. A governance log anchors actions via cryptographic hashes.

  • Tech stack: Python 3.8+, dataclasses, JSON, hashing, and a tiny in-memory registry. Adapters are plain Python modules intended to be swapped with real implementations.

  • Testing: pytest-based tests validating contract registry and delta application. test.sh runs pytest after optional build to verify packaging works.

  • Commands you should know:

  • Build: python -m build

  • Test: bash test.sh

  • Run quick checks: rg 'LocalPlan|PlanDelta' -n crisisguard -S

  • Run adapters locally: python -m crisisguard.toy_scenario.disaster_scenario

  • Rules:

  • Do not rely on network services for the core tests. The toy scenario runs in-memory.

  • Keep changes minimal and well-documented. Follow the small-change principle.

  • If you introduce new components, add tests and update AGENTS.md accordingly.