Technician tool v0.3

Imported from the Google Drive folder 004-technician_tool/v0.3.

kota_tech/ui/main_window.py

@@ -22,13 +22,15 @@ from PySide6.QtWidgets import (
 
 from .. import __version__
 from ..core.logfile import read_log_file
-from ..core.logline import LineKind, LogLine
+from ..core.logline import LineKind, LogLine, host_event
 from ..core.session import SessionLog
 from ..diag.engine import DiagnosticsEngine
+from ..diag.guides import GuideRunner
 from ..serialio.manager import SerialManager, State
 from ..serialio.ports import PortInfo, list_serial_ports
 from .cheatsheet import cheatsheet_html
 from .diag_panel import DiagnosticsPanel
+from .guide_panel import GuidePanel
 
 MAX_LINES = 20000
 LEVEL_FILTERS = {"All lines": None, "Warnings + errors": {"W", "E"}, "Errors only": {"E"}}
@@ -63,6 +65,7 @@ class SerialTab(QWidget):
         self._counts = {"E": 0, "W": 0, "boots": 0}
         self._engine = DiagnosticsEngine()
         self._diag_dirty = True
+        self._runner = GuideRunner(self._engine, on_action=self._guide_action, on_log=self._guide_log)
 
         # --- controls
         self.port_combo = QComboBox(minimumWidth=320)
@@ -102,9 +105,13 @@ class SerialTab(QWidget):
         self.view.setStyleSheet("QPlainTextEdit { background:#1e1e1e; color:#d4d4d4; }")
 
         self.diag = DiagnosticsPanel()
+        self.guide = GuidePanel(self._runner, self._engine)
+        self.side_tabs = QTabWidget()
+        self.side_tabs.addTab(self.diag, "Diagnosis")
+        self.side_tabs.addTab(self.guide, "Guided troubleshooting")
         split = QSplitter(Qt.Orientation.Horizontal)
         split.addWidget(self.view)
-        split.addWidget(self.diag)
+        split.addWidget(self.side_tabs)
         split.setStretchFactor(0, 3)
         split.setStretchFactor(1, 2)
         split.setSizes([700, 480])
@@ -175,6 +182,7 @@ class SerialTab(QWidget):
             return
         self._counts = {"E": 0, "W": 0, "boots": 0}
         self._engine.reset()
+        self._runner.cancel()
         self._diag_dirty = True
         self._session.start(port.mac or port.device)
         self._manager.connect(port)
@@ -206,6 +214,7 @@ class SerialTab(QWidget):
     def _on_line(self, line: LogLine) -> None:
         self._session.write(line)
         self._engine.feed(line)
+        self._runner.feed(line)
         self._diag_dirty = True
         if line.kind == LineKind.BOOT:
             self._counts["boots"] += 1
@@ -240,6 +249,21 @@ class SerialTab(QWidget):
         if self._diag_dirty:
             self._diag_dirty = False
             self.diag.show_report(self._engine.report())
+        self.guide.refresh()   # countdowns and timeouts need a steady tick
+
+    # ---- guided troubleshooting hooks ------------------------------------
+    def _guide_action(self, action: str) -> bool:
+        if action == "reset" and self._manager.state == State.CONNECTED:
+            self._manager.reset_board()
+            return True
+        return False
+
+    def _guide_log(self, text: str) -> None:
+        # Technician answers go into the session log and the log view.
+        line = host_event(text)
+        self._session.write(line)
+        self._append(line)
+        self._diag_dirty = True
 
     def _copy_report(self) -> None:
         QGuiApplication.clipboard().setText(self._engine.report().to_text())
@@ -252,6 +276,7 @@ class SerialTab(QWidget):
         lines = read_log_file(Path(path))
         self.view.clear()
         self._engine.reset()
+        self._runner.cancel()
         self._counts = {"E": 0, "W": 0, "boots": 0}
         for line in lines:
             self._engine.feed(line)