chore(release): v0.24.0 — waveform-shape metrics on events

CHANGELOG.md

@@ -8,6 +8,37 @@ All notable changes to seismo-relay are documented here.
 
 ---
 
+## v0.24.0 — 2026-08-22
+
+**Waveform-shape metrics on events.** The `events` table and the `/db/events`
+feed now carry per-event crest factor and points-near-peak, computed from the
+decoded waveform samples at ingest — groundwork for Terra-View's
+false-trigger detection (Phase B).
+
+### Added
+
+- **`events` columns** `shape_crest_factor`, `shape_near_peak_count`,
+  `shape_sample_count`, `shape_axis`. 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 them automatically (`SELECT *`).
+- **Populated at ingest** — crest factor + near-peak-count are computed from
+  the decoded samples in every save path (`shape_from_h5`/
+  `shape_from_samples`), and `insert_events` persists them on INSERT and
+  UPSERT.
+- **Backfill** `scripts/backfill_event_shape.py` — fills the columns for
+  existing events from their on-disk `.h5` waveform samples (idempotent,
+  UPDATE-only).
+
+### Upgrade Notes
+
+Run the backfill once after deploying, against the events DB + waveform store:
+`python3 scripts/backfill_event_shape.py --db-path <seismo_relay.db> --store-root <waveforms/>`
+Events with no decodable samples (or no waveform file) stay NULL and render
+"—" downstream.
+
+---
+
 ## v0.23.0 — 2026-08-04
 
 **Per-channel ZC frequency in the events store.** The `events` table and the