Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[0.3.0] - 2026-05-19

event_forwarder.py — forwards .IDFH (histogram) and .IDFW (waveform) event files plus their TXT/<basename>.txt sidecars to a seismo-relay SFM server's new /db/import/idf_file endpoint
Sha256-keyed thor_forwarded.json state file for idempotency across restarts and re-scans (default path: <log_dir>/thor_forwarded.json)
"SFM Forward" tab in Settings dialog: enable/URL/Test, forward interval, quiescence, missing-report grace, HTTP timeout, max forwards per pass, max event age, state file picker
Forwarder status line in tray menu: SFM OK | N fwd, M err | last 30s ago
Tray icon goes amber when the SFM forwarder is failing but the API heartbeat is still healthy
Re-pair logic: events forwarded without their TXT are re-forwarded once the sidecar appears so the relay can refresh DB rows with device-authoritative PPV/ZCFreq/peak values
event_forwarder.py --seed-state CLI for skipping historical backfill on a first deploy
Version badge: Thor Watcher vX.Y.Z shown at the top of the tray menu and in the Settings dialog title bar — operators no longer have to crack open the .exe properties to tell which version is running

Bumped VERSION to 0.3.0
Settings dialog tab order: Connection / Paths / Scanning / Logging / SFM Forward / Updates

thor_tray.py — system tray launcher with status icon (green/amber/red/grey), Settings and Open Log Folder menu items
thor_settings_dialog.py — Tkinter settings dialog with first-run wizard; tabs for Connection, Paths, Scanning, Logging, Updates
Hardened auto-updater: three-layer download validation (100 KB floor, 50% relative size floor, MZ magic bytes), safer swap bat with 5-retry cap and :fail exit, .exe.old backup
Configurable update source: update_source (gitea / url / disabled), update_url for custom server
Remote push support: update_available flag in API heartbeat response triggers update regardless of update_source setting
build.bat — PyInstaller build script; outputs versioned exe for Gitea and plain copy for Inno Setup
installer.iss — Inno Setup installer script with startup shortcut
_update_log() helper writes timestamped [updater] lines to the watcher log
log_tail included in heartbeat payload (last 25 lines) for terra-view display
run_watcher(state, stop_event) pattern in series4_ingest.py for background thread use from tray

series4_ingest.py refactored into tray-friendly background thread module; main() retained for standalone use
Config key sfm_endpoint renamed to api_url for consistency with series3-watcher
Heartbeat payload now uses source_id, source_type, version fields matching terra-view WatcherAgent model
AppData folder: ThorWatcher (was not previously defined)