feat(db): update_event_review mirrors reviewed_real + enforces 3-state exclusivity

sfm/database.py

@@ -685,17 +685,23 @@ class SeismoDb:
         """
         Sync derived index columns from a sidecar's `review` block.
 
-        Currently the only derived index is `events.false_trigger` — kept
-        in sync so `/db/events?false_trigger=true` queries don't have to
-        scan every sidecar JSON on disk.  The sidecar JSON itself remains
-        the source of truth for the full review state.
+        The derived indexes are `events.false_trigger` and
+        `events.reviewed_real` — kept in sync so `/db/events` queries don't
+        have to scan every sidecar JSON on disk.  The sidecar JSON itself
+        remains the source of truth for the full review state.
+
+        The two columns are mutually exclusive: setting either one true
+        forces the other's column to 0.
 
         Returns True when the row exists, False otherwise.  No-op fields
-        (review without `false_trigger`) leave the column untouched.
+        (review without `false_trigger` or `reviewed_real`) leave both
+        columns untouched.
         """
         if not isinstance(review, dict):
             return False
-        if "false_trigger" not in review:
+        has_ft = "false_trigger" in review
+        has_real = "reviewed_real" in review
+        if not has_ft and not has_real:
             # Nothing derived to update; just confirm the row exists.
             with self._connect() as conn:
                 row = conn.execute(
@@ -703,12 +709,20 @@ class SeismoDb:
                 ).fetchone()
             return row is not None
 
-        flag = 1 if review.get("false_trigger") else 0
+        sets = {}
+        if has_ft:
+            sets["false_trigger"] = 1 if review.get("false_trigger") else 0
+        if has_real:
+            sets["reviewed_real"] = 1 if review.get("reviewed_real") else 0
+        # mutual exclusivity: a true in one forces the other column to 0
+        if sets.get("false_trigger") == 1:
+            sets["reviewed_real"] = 0
+        if sets.get("reviewed_real") == 1:
+            sets["false_trigger"] = 0
+        assign = ", ".join(f"{k}=?" for k in sets)
+        params = list(sets.values()) + [event_id]
         with self._connect() as conn:
-            cur = conn.execute(
-                "UPDATE events SET false_trigger=? WHERE id=?",
-                (flag, event_id),
-            )
+            cur = conn.execute(f"UPDATE events SET {assign} WHERE id=?", params)
         return cur.rowcount > 0
 
     # ── Monitor log ───────────────────────────────────────────────────────────