Add timeline and failure thumbnail to run history tab

The run history tab gains a Gantt-style strip showing every recent run
on a horizontal time axis (status drives bar colour) and a side preview
panel that surfaces the failure screenshot already captured by the
artifact manager. Selection syncs both ways between the table and the
strip so users can spot patterns by shape, then drill in by click.

Author: JE-Chen

je_auto_control/gui/language_wrapper/english.py

@@ -659,6 +659,10 @@
     "rh_open_artifact": "Open artifact",
     "rh_no_artifact": "Selected run has no artifact.",
     "rh_artifact_missing": "Artifact file no longer exists.",
+    "rh_timeline_heading": "Timeline (oldest left → newest right)",
+    "rh_preview_heading": "Preview",
+    "rh_preview_empty": "Select a run to preview.",
+    "rh_preview_no_artifact": "No screenshot for this run.",
 
     # Profiler tab
     "prof_enable": "Enable profiler",

je_auto_control/gui/language_wrapper/japanese.py

@@ -657,6 +657,10 @@
     "rh_open_artifact": "スクリーンショットを開く",
     "rh_no_artifact": "選択した実行にスクリーンショットはありません。",
     "rh_artifact_missing": "スクリーンショットファイルが存在しません。",
+    "rh_timeline_heading": "タイムライン（左:古い → 右:新しい）",
+    "rh_preview_heading": "プレビュー",
+    "rh_preview_empty": "実行を選択するとプレビューが表示されます。",
+    "rh_preview_no_artifact": "この実行のスクリーンショットはありません。",
 
     # Profiler tab
     "prof_enable": "プロファイラを有効化",

je_auto_control/gui/language_wrapper/simplified_chinese.py

@@ -647,6 +647,10 @@
     "rh_open_artifact": "打开截图",
     "rh_no_artifact": "所选记录没有截图。",
     "rh_artifact_missing": "截图文件已不存在。",
+    "rh_timeline_heading": "时间轴（左旧右新）",
+    "rh_preview_heading": "预览",
+    "rh_preview_empty": "请选择一条记录预览。",
+    "rh_preview_no_artifact": "此次执行没有截图。",
 
     # Profiler tab
     "prof_enable": "启用性能分析",

je_auto_control/gui/language_wrapper/traditional_chinese.py

@@ -648,6 +648,10 @@
     "rh_open_artifact": "開啟截圖",
     "rh_no_artifact": "所選紀錄沒有截圖。",
     "rh_artifact_missing": "截圖檔案已不存在。",
+    "rh_timeline_heading": "時間軸（左舊右新）",
+    "rh_preview_heading": "預覽",
+    "rh_preview_empty": "請選擇一筆紀錄以預覽。",
+    "rh_preview_no_artifact": "此次執行沒有截圖。",
 
     # Profiler tab
     "prof_enable": "啟用效能分析",

je_auto_control/gui/run_history_tab.py

@@ -1,23 +1,24 @@
 """Run History tab: browse past scheduler / trigger / hotkey fires."""
 import datetime as _dt
 from pathlib import Path
-from typing import Optional
+from typing import List, Optional
 
 from PySide6.QtCore import QTimer, Qt, QUrl
-from PySide6.QtGui import QDesktopServices
+from PySide6.QtGui import QDesktopServices, QPixmap
 from PySide6.QtWidgets import (
-    QAbstractItemView, QComboBox, QHBoxLayout, QHeaderView, QLabel,
-    QMessageBox, QPushButton, QTableWidget, QTableWidgetItem,
+    QAbstractItemView, QComboBox, QFrame, QHBoxLayout, QHeaderView, QLabel,
+    QMessageBox, QPushButton, QSplitter, QTableWidget, QTableWidgetItem,
     QVBoxLayout, QWidget,
 )
 
 from je_auto_control.gui._i18n_helpers import TranslatableMixin
 from je_auto_control.gui.language_wrapper.multi_language_wrapper import (
     language_wrapper,
 )
+from je_auto_control.gui.run_history_timeline import RunHistoryTimeline
 from je_auto_control.utils.run_history.history_store import (
     SOURCE_HOTKEY, SOURCE_MANUAL, SOURCE_REST, SOURCE_SCHEDULER,
-    SOURCE_TRIGGER, STATUS_ERROR, STATUS_OK, STATUS_RUNNING,
+    SOURCE_TRIGGER, STATUS_ERROR, STATUS_OK, STATUS_RUNNING, RunRecord,
     default_history_store,
 )
 
@@ -63,6 +64,7 @@ class RunHistoryTab(TranslatableMixin, QWidget):
     def __init__(self, parent: Optional[QWidget] = None) -> None:
         super().__init__(parent)
         self._tr_init()
+        self._records: List[RunRecord] = []
         self._filter = QComboBox()
         self._populate_filter()
         self._filter.currentIndexChanged.connect(self._refresh)
@@ -75,6 +77,17 @@ def __init__(self, parent: Optional[QWidget] = None) -> None:
         header.setSectionResizeMode(QHeaderView.Interactive)
         header.setStretchLastSection(True)
         self._count_label = QLabel()
+        self._timeline = RunHistoryTimeline()
+        self._timeline.run_clicked.connect(self._on_timeline_clicked)
+        self._thumb_label = QLabel()
+        self._thumb_label.setAlignment(Qt.AlignCenter)
+        self._thumb_label.setMinimumSize(220, 160)
+        self._thumb_label.setFrameShape(QFrame.StyledPanel)
+        self._thumb_label.setScaledContents(False)
+        self._thumb_caption = QLabel()
+        self._thumb_caption.setWordWrap(True)
+        self._thumb_caption.setAlignment(Qt.AlignTop)
+        self._thumb_caption.setTextInteractionFlags(Qt.TextSelectableByMouse)
         self._timer = QTimer(self)
         self._timer.setInterval(_REFRESH_INTERVAL_MS)
         self._timer.timeout.connect(self._refresh)
@@ -89,6 +102,10 @@ def retranslate(self) -> None:
         self._repopulate_filter_labels()
         self._refresh()
 
+    def resizeEvent(self, event) -> None:
+        super().resizeEvent(event)
+        self._refresh_preview()
+
     def _populate_filter(self) -> None:
         self._filter.blockSignals(True)
         for label_key, source_value in _SOURCES:
@@ -124,8 +141,27 @@ def _build_layout(self) -> None:
         clear_btn.clicked.connect(self._on_clear)
         top.addWidget(clear_btn)
         root.addLayout(top)
-        root.addWidget(self._table, stretch=1)
+
+        self._tr(QLabel(), "rh_timeline_heading")
+        timeline_label = self._tr(QLabel(), "rh_timeline_heading")
+        root.addWidget(timeline_label)
+        root.addWidget(self._timeline)
+
+        splitter = QSplitter(Qt.Horizontal)
+        splitter.addWidget(self._table)
+        preview = QWidget()
+        preview_layout = QVBoxLayout(preview)
+        preview_layout.setContentsMargins(0, 0, 0, 0)
+        preview_layout.addWidget(self._tr(QLabel(), "rh_preview_heading"))
+        preview_layout.addWidget(self._thumb_label, stretch=1)
+        preview_layout.addWidget(self._thumb_caption)
+        splitter.addWidget(preview)
+        splitter.setStretchFactor(0, 3)
+        splitter.setStretchFactor(1, 1)
+        root.addWidget(splitter, stretch=1)
+
         self._table.cellDoubleClicked.connect(self._on_cell_double_clicked)
+        self._table.itemSelectionChanged.connect(self._on_selection_changed)
         open_row = QHBoxLayout()
         self._open_artifact_btn = self._tr(QPushButton(), "rh_open_artifact")
         self._open_artifact_btn.clicked.connect(self._open_selected_artifact)
@@ -149,12 +185,15 @@ def _refresh(self) -> None:
             runs = default_history_store.list_runs(limit=500, source_type=source)
         except ValueError:
             runs = []
+        self._records = runs
         self._table.setRowCount(len(runs))
         for row, record in enumerate(runs):
             self._set_row(row, record)
         self._count_label.setText(
             _t("rh_count_label").replace("{n}", str(len(runs))),
         )
+        self._timeline.set_records(runs)
+        self._refresh_preview()
 
     def _set_row(self, row: int, record) -> None:
         status_key = _STATUS_LABEL_KEYS.get(record.status, record.status)
@@ -176,6 +215,54 @@ def _set_row(self, row: int, record) -> None:
             item.setFlags(item.flags() & ~Qt.ItemIsEditable)
             self._table.setItem(row, col, item)
 
+    def _selected_record(self) -> Optional[RunRecord]:
+        row = self._table.currentRow()
+        if row < 0 or row >= len(self._records):
+            return None
+        return self._records[row]
+
+    def _on_selection_changed(self) -> None:
+        record = self._selected_record()
+        self._timeline.set_highlighted(record.id if record is not None else None)
+        self._refresh_preview()
+
+    def _on_timeline_clicked(self, run_id: int) -> None:
+        for row, record in enumerate(self._records):
+            if record.id == run_id:
+                self._table.selectRow(row)
+                return
+
+    def _refresh_preview(self) -> None:
+        record = self._selected_record()
+        if record is None:
+            self._thumb_label.clear()
+            self._thumb_label.setText(_t("rh_preview_empty"))
+            self._thumb_caption.setText("")
+            return
+        path = record.artifact_path
+        if not path:
+            self._thumb_label.clear()
+            self._thumb_label.setText(_t("rh_preview_no_artifact"))
+        else:
+            pixmap = QPixmap(path)
+            if pixmap.isNull():
+                self._thumb_label.clear()
+                self._thumb_label.setText(_t("rh_artifact_missing"))
+            else:
+                self._thumb_label.setPixmap(pixmap.scaled(
+                    self._thumb_label.size(), Qt.KeepAspectRatio,
+                    Qt.SmoothTransformation,
+                ))
+        caption = (
+            f"#{record.id} • {record.source_type}/{record.source_id}\n"
+            f"{record.script_path}\n"
+            f"{_format_time(record.started_at)} • "
+            f"{_format_duration(record.duration_seconds)}"
+        )
+        if record.error_text:
+            caption += f"\n{record.error_text}"
+        self._thumb_caption.setText(caption)
+
     def _selected_artifact_path(self) -> Optional[str]:
         row = self._table.currentRow()
         if row < 0:

je_auto_control/gui/run_history_timeline.py

@@ -0,0 +1,159 @@
+"""Custom timeline widget for the Run History tab.
+
+Renders one colored bar per run on a horizontal time axis (newest on the
+right). Status drives the bar colour (green = ok, red = error, amber =
+still running). Clicking a bar emits ``run_clicked`` so the host tab can
+sync the row selection / thumbnail preview.
+
+Pure :mod:`PySide6` — the headless run history store has zero Qt deps.
+"""
+from dataclasses import dataclass
+from typing import List, Optional, Sequence, Tuple
+
+from PySide6.QtCore import QRectF, Qt, Signal
+from PySide6.QtGui import QColor, QFont, QFontMetrics, QMouseEvent, QPainter
+from PySide6.QtWidgets import QSizePolicy, QWidget
+
+from je_auto_control.utils.run_history.history_store import (
+    STATUS_ERROR, STATUS_OK, STATUS_RUNNING, RunRecord,
+)
+
+_STATUS_COLOURS = {
+    STATUS_OK: QColor("#4caf50"),
+    STATUS_ERROR: QColor("#e53935"),
+    STATUS_RUNNING: QColor("#ffb300"),
+}
+_DEFAULT_COLOUR = QColor("#9e9e9e")
+_GUTTER = 6
+_MIN_BAR_PX = 4
+_BAR_HEIGHT_FRACTION = 0.55
+
+
+@dataclass
+class _Bar:
+    record: RunRecord
+    rect: QRectF
+
+
+class RunHistoryTimeline(QWidget):
+    """Horizontal Gantt-style strip of run records."""
+
+    run_clicked = Signal(int)
+
+    def __init__(self, parent: Optional[QWidget] = None) -> None:
+        super().__init__(parent)
+        self.setMinimumHeight(96)
+        self.setSizePolicy(QSizePolicy.Expanding, QSizePolicy.Fixed)
+        self._records: List[RunRecord] = []
+        self._bars: List[_Bar] = []
+        self._range: Tuple[float, float] = (0.0, 0.0)
+        self._highlight_id: Optional[int] = None
+        self.setMouseTracking(True)
+
+    def set_records(self, records: Sequence[RunRecord]) -> None:
+        """Replace the displayed records and trigger a repaint."""
+        self._records = list(records)
+        self._range = self._compute_range(self._records)
+        self.update()
+
+    def set_highlighted(self, run_id: Optional[int]) -> None:
+        """Visually mark a single run id (called from external selection)."""
+        self._highlight_id = run_id
+        self.update()
+
+    def paintEvent(self, event) -> None:
+        del event
+        painter = QPainter(self)
+        try:
+            painter.setRenderHint(QPainter.Antialiasing, True)
+            painter.fillRect(self.rect(), self.palette().window())
+            self._bars = self._layout_bars()
+            self._draw_axis(painter)
+            for bar in self._bars:
+                self._draw_bar(painter, bar)
+        finally:
+            painter.end()
+
+    def mousePressEvent(self, event: QMouseEvent) -> None:
+        if event.button() != Qt.LeftButton:
+            super().mousePressEvent(event)
+            return
+        for bar in self._bars:
+            if bar.rect.contains(event.position()):
+                self._highlight_id = bar.record.id
+                self.update()
+                self.run_clicked.emit(bar.record.id)
+                return
+        super().mousePressEvent(event)
+
+    @staticmethod
+    def _compute_range(records: Sequence[RunRecord]) -> Tuple[float, float]:
+        if not records:
+            return (0.0, 0.0)
+        starts = [r.started_at for r in records]
+        ends = []
+        for r in records:
+            if r.finished_at is not None:
+                ends.append(r.finished_at)
+            else:
+                ends.append(r.started_at + 0.001)
+        lo = min(starts)
+        hi = max(ends)
+        if hi <= lo:
+            hi = lo + 1.0
+        return (lo, hi)
+
+    def _layout_bars(self) -> List[_Bar]:
+        if not self._records:
+            return []
+        lo, hi = self._range
+        span = max(hi - lo, 1e-6)
+        usable_w = max(1, self.width() - 2 * _GUTTER)
+        bar_height = max(8, int(self.height() * _BAR_HEIGHT_FRACTION))
+        y = (self.height() - bar_height) // 2
+        bars: List[_Bar] = []
+        for record in self._records:
+            start_frac = (record.started_at - lo) / span
+            end_at = record.finished_at if record.finished_at is not None \
+                else min(hi, record.started_at + 0.001)
+            end_frac = (end_at - lo) / span
+            x = _GUTTER + int(start_frac * usable_w)
+            width = max(_MIN_BAR_PX, int((end_frac - start_frac) * usable_w))
+            rect = QRectF(x, y, width, bar_height)
+            bars.append(_Bar(record=record, rect=rect))
+        return bars
+
+    def _draw_axis(self, painter: QPainter) -> None:
+        if not self._records:
+            painter.setPen(self.palette().text().color())
+            painter.drawText(self.rect(), Qt.AlignCenter, "no runs yet")
+            return
+        font = QFont(painter.font())
+        font.setPointSize(max(7, font.pointSize() - 1))
+        painter.setFont(font)
+        metrics = QFontMetrics(font)
+        lo, hi = self._range
+        baseline_y = self.height() - max(2, metrics.descent() + 2)
+        painter.setPen(QColor(120, 120, 120, 160))
+        painter.drawLine(_GUTTER, baseline_y,
+                         self.width() - _GUTTER, baseline_y)
+        painter.setPen(self.palette().text().color())
+        from datetime import datetime
+        try:
+            left_label = datetime.fromtimestamp(lo).strftime("%H:%M:%S")
+            right_label = datetime.fromtimestamp(hi).strftime("%H:%M:%S")
+        except (OSError, ValueError, OverflowError):
+            left_label, right_label = str(lo), str(hi)
+        painter.drawText(_GUTTER, baseline_y - 2, left_label)
+        right_w = metrics.horizontalAdvance(right_label)
+        painter.drawText(self.width() - _GUTTER - right_w,
+                         baseline_y - 2, right_label)
+
+    def _draw_bar(self, painter: QPainter, bar: _Bar) -> None:
+        colour = QColor(_STATUS_COLOURS.get(bar.record.status, _DEFAULT_COLOUR))
+        if bar.record.id == self._highlight_id:
+            painter.setPen(QColor(255, 255, 255, 220))
+        else:
+            painter.setPen(Qt.NoPen)
+        painter.setBrush(colour)
+        painter.drawRoundedRect(bar.rect, 3, 3)