# CivicPulse Privacy-Preserving Sandbox

This repository implements a production-ready skeleton for a privacy-preserving disaster response platform. It focuses on a small but coherent core: LocalProblem, SharedSignals, PlanDelta, an offline-first engine, a governance ledger, and two starter adapters. The goal is to provide a strong engineering scaffold that can be extended into a full MVP over multiple sprints.

Key components
- LocalProblem: per-neighborhood disaster response tasks with capacity and equity constraints.
- SharedSignals: privacy-preserving aggregated indicators.
- PlanDelta: incremental action plans with provenance and auditability.
- OfflineEngine: islanded operation with deterministic delta-sync and reconciliation.
- GovernanceLedger: tamper-evident log anchors for auditability.
- Adapters: MarketDataFeedAdapter and EdgeComputeAdapter to seed data and perform edge computation.
- Policy/DSL: minimal DSL to define LocalProblem and flows.

Getting started
- Python package: idea161-civicpulse-privacy-preserving
- Run tests: python3 test.sh
- Packaging: python -m build

This is a focused, production-oriented nucleus. Further expansion will add a real REST API, persistent storage, richer DSL, and more adapters.