v0.12.0 — 🔎 City Pulse Review Pipeline

🔎 v0.12.0 — City Pulse Review Pipeline

An admin-triggered AI agent that audits City Pulse's own operation — cost, translation, severity weights, status/trend usefulness, prompt quality, and cross-version comparison — and proposes concrete methodology improvements. Deterministic work is a script; judgment is the AI.

🏷️ Versioning

• 🧬 Stamp every pulse run with pulse_config_version — a hash of the prompt, weight table, and window/strategy config — so future reviews can attribute output changes to a specific methodology snapshot

⚙️ Deterministic reducer

• 📉 review/reduce.py turns days of cost_debug/translate_debug/pulse_debug logs plus radar.db into a compact digest — no LLM, no network
• 📊 Per-version metrics: status flap rate, trend-override rate, cost per pulse, coverage, and override rate (when human corrections exist)
• 🧾 Cost reconciliation against api_usage, pulse coverage gap detection, and event-log anomaly surfacing
• 🔒 subscribers table never queried — GDPR redaction by construction, not discipline

🤖 Gemini reviewer

• 📝 review/reviewer.py reasons over the digest only, producing a human-readable report plus machine-readable changes.json
• 💾 Reports and proposed edits written to the data volume (data/review_debug/), never the repo — reviewer never edits the running system

🖥️ Admin dashboard

• ✂️ Retire the standalone weight-review button — folded into the unified review
• 🎛️ New "Run review" control: days/drivers/samples knobs, high/low-detail presets, cost preview gating the run, and a past-reports list

🔀 CI draft PR

• 🔑 New X-Admin-Token header auth path (alongside session login) so CI can fetch a report's changes.json without a browser session — prod server still never holds a GitHub token
• 🌿 .github/workflows/review-pr.yml: manual workflow_dispatch job that applies unified-diff-shaped changes via git apply, writes anything else to PROPOSED_CHANGES.md for manual review, and opens a draft PR — never auto-merges

📚 Docs

• 📖 docs/review.md — full pipeline design, linked from analysis.md