init commit

python_app/gui/runtime/history.py

@@ -0,0 +1,53 @@
+"""Helpers for GUI-side runtime history management."""
+
+from __future__ import annotations
+
+from collections import deque
+
+from python_app.models.dataset_model import ResultCollection
+from python_app.models.run_config_model import RunConfigModel
+
+
+def record_result_history(
+    result_history: deque[ResultCollection],
+    collection: ResultCollection,
+) -> bool:
+    """Append new result or replace existing entry by stable collection key."""
+    for index in range(len(result_history) - 1, -1, -1):
+        existing = result_history[index]
+        if (
+            existing.collection_id == collection.collection_id
+            and existing.monotonic_ns == collection.monotonic_ns
+        ):
+            result_history[index] = collection
+            return True
+
+    result_history.append(collection)
+    return True
+
+
+def build_run_history_signature(
+    config: RunConfigModel,
+) -> tuple[object, ...]:
+    """Build deterministic signature to detect run-settings changes (excluding live processing params)."""
+    combos_signature = tuple((int(combo.input), int(combo.output)) for combo in config.combos)
+    return (
+        str(config.radar.driver_mode),
+        str(config.radar.serial),
+        float(config.radar.sweep.start_hz),
+        float(config.radar.sweep.stop_hz),
+        int(config.radar.sweep.points),
+        float(config.radar.sweep.if_bandwidth_hz),
+        float(config.radar.sweep.power_dbm),
+        str(config.input_switch.driver_mode),
+        str(config.input_switch.driver),
+        int(config.input_switch.positions),
+        bool(config.input_switch.invert_logic),
+        str(config.output_switch.driver_mode),
+        str(config.output_switch.driver),
+        int(config.output_switch.positions),
+        bool(config.output_switch.invert_logic),
+        str(config.preprocess.calibration_set),
+        str(config.preprocess.reference_set),
+        combos_signature,
+    )