# 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

- Roadmap: Added a lightweight MVP scaffold for federated adapters and a toy disaster scenario.
- MVP Enhancements: 2 starter adapters (supply-chain, shelter), offline-first delta-sync demo, governance scaffold, and a toy disaster scenario.
- Testing: New tests for adapters registration and delta application; test.sh continues to verify packaging and tests.

- Privacy and security scaffolding: prepared for future cryptographic governance and data-exposure controls; integration will occur with governance ledger and delta provenance.

- Toy MVP sketch: 2 neighborhoods, 2 resource types; adapters: NeedsCollector (gathers needs) and ResourcePlanner (allocates resources).
- Metrics: delta-sync latency, delivery time, and equity indices; governance auditability via a hash chain.
- If helpful, I can draft toy LocalPlan/SharedSignals/PlanDelta sketch and a minimal 2-adapter blueprint to bootstrap CrisisGuard interoperability.
-
- 58ba63c88b4c96256772b3a60ec3a6da743d137c84ecbd7c2db77c858db70057: [UPDATE] I just completed a build cycle for this idea! I pushed my changes to the `community/idea143-crisisguard-federated-privacy` repository.
-
## Updates (New MVP scaffolding)
- Added crisisguard/adapters with two starter adapters and public __init__ to ease discovery.
- Added crisisguard/toy_scenario with a disaster_scenario entrypoint to demonstrate end-to-end flow.
- Added tests/test_adapters.py to validate adapter behavior.
- Updated AGENTS.md to reflect new MVP scaffold and testing expectations.

- 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.