idea161-civicpulse-privacy-preserving/AGENTS.md

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.