# Agents and Architecture

- Core language: Python 3.8+
- Tech stack: Python standard libs + small, dependency-light packages
- Architecture:
  - LocalProblem, SharedSignals, PlanDelta data models (src/idea161_civicpulse_privacy_preserving/models.py)
  - OfflineEngine: islanded operation + delta-sync mock (src/idea161_civicpulse_privacy_preserving/engine.py)
  - GovernanceLedger: tamper-evident logging (src/idea161_civicpulse_privacy_preserving/governance.py)
  - Adapters: MarketDataFeedAdapter, EdgeComputeAdapter (src/idea161_civicpulse_privacy_preserving/adapters.py)
  - Policy DSL: tiny parser (src/idea161_civicpulse_privacy_preserving/policy.py)
  - API facade (optional): src/idea161_civicpulse_privacy_preserving/api.py
- Testing: tests/test_core.py (basic unit tests)
- Build/test automation: test.sh (pytest + python -m build)
- Publishing: READY_TO_PUBLISH empty file when ready

Rules:
- Do not push to remote unless user explicitly asks.
- Keep changes minimal and cohesive; prefer small, correct patches.
- All code paths should have deterministic behavior for tests.