chore(release): v0.25.0 — reviewed_real + twin review-propagation

CHANGELOG.md

@@ -8,6 +8,32 @@ All notable changes to seismo-relay are documented here.
 
 ---
 
+## v0.25.0 — 2026-08-25
+
+**reviewed_real 3-state review flag + twin review-propagation.** The
+`events` table and the `/db/events` feed now carry `reviewed_real`, a
+3-state review flag mutually exclusive with `false_trigger`, mirrored from
+the sidecar review block — plus histogram/waveform twin review-propagation
+(flagging one flags both, matched by serial + identical PVS + timestamp
+window).
+
+### Added
+
+- **`events` column** `reviewed_real` — `INTEGER NOT NULL DEFAULT 0`, added
+  via the existing incremental `_migrate` ADD COLUMN pass (auto-migrates on
+  `SeismoDb()` construction, no manual migration). `query_events` /
+  `get_event` (and thus `/db/events`) return it automatically (`SELECT *`).
+- **Mutual exclusivity with `false_trigger`** — setting `reviewed_real=1`
+  clears `false_trigger`, and vice versa, both via `set_false_trigger` /
+  the sidecar review PATCH path.
+- **`find_twins`** — matches an event's histogram/waveform twins by serial +
+  identical peak-vector-sum + a timestamp window.
+- **`propagate_review_to_twins`** — copies an event's `false_trigger`/
+  `reviewed_real` state onto its twins, wired into the
+  `PATCH /db/events/{id}/sidecar` review path so flagging one flags both.
+
+---
+
 ## v0.24.0 — 2026-08-22
 
 **Waveform-shape metrics on events.** The `events` table and the `/db/events`