refactor(shell): R08-T10 — bootstrap + tách TrayManager và LifecycleCoordinator

app.py 1356 -> 1293 dòng. presentation/shell/ có 3 file:

  bootstrap.py               Composition Root (đã vào ở commit trước)
  tray_manager.py            khay hệ thống + thông báo bong bóng
  lifecycle_coordinator.py   canh cửa sổ theo màn hình + tắt cho sạch

Vì sao tách khay: khay là thứ CÓ THỂ KHÔNG TỒN TẠI (một số môi trường Linux,
phiên RDP). Trước đây mỗi chỗ dùng phải tự nhớ kiểm `if self.tray is not None`
— có 6 chỗ như thế, và 3 chỗ còn phải tự bọc try/except quanh showMessage.
Gói lại thì chỗ gọi cứ gọi, không có khay thì không có gì xảy ra.

Vì sao tách vòng đời: hai việc trong đó không phải việc của giao diện. Canh
cửa sổ theo màn hình là số học thuần (anh Nam có hai màn khác độ phân giải và
khác tỉ lệ phóng — kéo qua lại là vùng làm việc đổi). Còn shutdown là thứ tự
dừng có ý nghĩa: bộ lập lịch trước để nó không kịp khởi động việc mới trong
lúc ta đang dừng việc cũ, rồi mới tới worker, rồi ngắt tiến trình MCP.

closeEvent/moveEvent/resizeEvent vẫn ở lớp cửa sổ vì Qt gọi thẳng vào đó,
nhưng phần quyết định đã chuyển đi. closeEvent từ 30 dòng còn 11.

Giữ self.tray thành property trỏ vào self._tray.icon — vài chỗ còn đọc tên cũ.

Đã lấy mốc trước khi bóc rồi so lại sau: 24/24 checker trong tools/ qua cả hai
lần. Đây là bộ đặc tả thật cho MainWindow (check_nav, check_rail_align,
check_layout_geometry, check_controls_alive... dựng cửa sổ thật offscreen trên
BẢN SAO của ~/.cowork_local, scheduler bị vô hiệu hoá). 632 test xanh.

CHƯA làm hết R08-T10: plan ghi tách thành main_window.py + tray_manager.py +
lifecycle_coordinator.py. Hai file sau đã xong, main_window.py thì chưa —
MainWindow vẫn nằm trong app.py và vẫn 1095 dòng. Đo lại thì khối lượng không
nằm ở ba cụm plan nêu mà ở hai cụm khác:

    nav rail    18 method, ~340 dòng
    topbar      8 method,  ~157 dòng
    __init__    279 dòng

Hai cụm đó dính chặt vào state của cửa sổ, chuyển đi cần đổi giao diện giữa
chúng chứ không phải dời chỗ, nên tôi dừng ở đây thay vì làm nửa vời.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

presentation/shell/lifecycle_coordinator.py

@@ -0,0 +1,110 @@
+"""Vòng đời cửa sổ chính — R08-T10.
+
+Bóc từ ``app.py::MainWindow``. Hai việc, đều không phải việc của giao diện:
+
+1. **Canh cửa sổ theo màn hình đang đứng.** Người dùng có hai màn khác độ phân
+   giải và khác tỉ lệ phóng; kéo cửa sổ sang màn kia là vùng làm việc đổi. Đây
+   là số học thuần, không đụng widget nào ngoài chính cửa sổ.
+2. **Tắt cho sạch.** Dừng bộ lập lịch, dừng mọi lượt chạy còn dở, ngắt tiến
+   trình MCP. Thiếu một bước là để lại tiến trình con chạy mồ côi sau khi
+   người dùng đã thoát.
+
+Các hàm ``closeEvent``/``moveEvent``/``resizeEvent`` vẫn phải nằm ở lớp cửa sổ
+— Qt gọi thẳng vào đó — nhưng phần quyết định thì ở đây.
+"""
+from __future__ import annotations
+
+from PySide6.QtGui import QGuiApplication
+
+#: Cửa sổ chiếm bao nhiêu phần màn hình khi mở lần đầu.
+SCREEN_SHARE_W, SCREEN_SHARE_H = 0.80, 0.85
+
+#: Chừa mép để cửa sổ không đụng thanh tác vụ.
+MARGIN = 60
+
+#: Kích thước tối thiểu mong muốn — vẫn phải nhỏ hơn màn hình thật.
+MIN_W, MIN_H = 820, 520
+
+
+class LifecycleCoordinator:
+    def __init__(self, window):
+        self.window = window
+        self._last_screen = None
+
+    # ---- canh theo màn hình ----------------------------------------------
+
+    def fit_to_screen(self, want_w: int, want_h: int) -> None:
+        w = self.window
+        screen = w.screen() or QGuiApplication.primaryScreen()
+        avail = screen.availableGeometry() if screen else None
+        if avail is None:
+            w.resize(want_w, want_h)
+            return
+
+        # Lấy một phần màn hình: không bao giờ nhỏ hơn kích thước yêu cầu, cũng
+        # không bao giờ lớn hơn thứ màn hình hiển thị nổi.
+        width = min(max(want_w, int(avail.width() * SCREEN_SHARE_W)),
+                    avail.width() - MARGIN)
+        height = min(max(want_h, int(avail.height() * SCREEN_SHARE_H)),
+                     avail.height() - MARGIN)
+        self._apply_minimum(avail)
+        w.resize(max(width, 1), max(height, 1))
+
+        frame = w.frameGeometry()
+        frame.moveCenter(avail.center())
+        w.move(frame.topLeft())
+
+    def screen_maybe_changed(self) -> bool:
+        """Gọi khi cửa sổ bị di chuyển. Trả True nếu đúng là đã đổi màn hình.
+
+        Trả về bool để chỗ gọi biết có cần xếp lại mấy thứ nổi hay không —
+        kéo cửa sổ trong cùng một màn thì không cần làm gì cả.
+        """
+        w = self.window
+        screen = w.screen()
+        if screen is self._last_screen:
+            return False
+        self._last_screen = screen
+        avail = screen.availableGeometry() if screen else None
+        if avail is not None:
+            self._apply_minimum(avail)
+        return True
+
+    def _apply_minimum(self, avail) -> None:
+        # Kích thước tối thiểu không bao giờ được vượt quá thứ màn hình hiển
+        # thị nổi — nếu không thì cửa sổ không thu nhỏ vừa màn được nữa.
+        self.window.setMinimumSize(min(MIN_W, avail.width() - MARGIN),
+                                   min(MIN_H, avail.height() - MARGIN))
+
+    # ---- đóng và tắt ------------------------------------------------------
+
+    def should_keep_running(self) -> bool:
+        """Đóng cửa sổ có nghĩa là chạy nền tiếp, hay là thoát hẳn?
+
+        Chạy nền tiếp chỉ khi có khay hệ thống để quay lại — không có khay mà
+        vẫn ẩn đi thì người dùng mất luôn đường vào app.
+        """
+        w = self.window
+        if w.tray is None or w._really_quit:
+            return False
+        return bool(w.ctx.config.data.get("tray", {}).get("minimize_on_close", True))
+
+    def shutdown(self) -> None:
+        """Dừng mọi thứ đang chạy. Thứ tự có ý nghĩa: bộ lập lịch trước, để nó
+        không kịp khởi động thêm việc mới trong lúc ta đang dừng việc cũ."""
+        w = self.window
+        w.task_scheduler.stop()          # dừng luôn các task đã lên lịch
+        if getattr(w, "routing_scheduler", None) is not None:
+            w.routing_scheduler.stop()
+
+        for tab in (w.cowork,):
+            for worker in tab.active_workers():
+                if worker.isRunning():
+                    worker.request_stop()
+                    worker.wait(1500)
+
+        if hasattr(w.structure, "stop_cmem_ui"):
+            w.structure.stop_cmem_ui()
+
+        # Không bao giờ để lại tiến trình MCP đã kết nối chạy mồ côi.
+        w.ctx.stop_mcp_connections()

presentation/shell/tray_manager.py

@@ -0,0 +1,76 @@
+"""Biểu tượng khay hệ thống — R08-T10.
+
+Bóc từ ``app.py::MainWindow``. Giữ biểu tượng khay, menu chuột phải của nó, và
+việc bắn thông báo bong bóng.
+
+Vì sao tách: khay là thứ **có thể không tồn tại**. Máy không có khay hệ thống
+(một số môi trường Linux, phiên RDP) thì ``isSystemTrayAvailable()`` trả False
+và mọi thứ ở đây phải im lặng chấp nhận. Trộn lẫn trong MainWindow thì mỗi chỗ
+dùng đều phải tự nhớ kiểm ``if self.tray is not None`` — đã có 6 chỗ như thế.
+Gói lại thì chỗ gọi cứ gọi, không có khay thì không có gì xảy ra.
+"""
+from __future__ import annotations
+
+from PySide6.QtGui import QAction
+from PySide6.QtWidgets import QMenu, QSystemTrayIcon
+
+
+class TrayManager:
+    """Khay hệ thống của một cửa sổ. An toàn khi máy không có khay."""
+
+    def __init__(self, window, *, icon, tooltip: str, tr):
+        self.window = window
+        self._tr = tr
+        self.icon: QSystemTrayIcon | None = None
+        self._open_act: QAction | None = None
+        self._quit_act: QAction | None = None
+        self._tooltip = tooltip
+        self._app_icon = icon
+
+    # ---- dựng ------------------------------------------------------------
+
+    def setup(self) -> None:
+        """Dựng biểu tượng khay. Không có khay thì lặng lẽ bỏ qua."""
+        if not QSystemTrayIcon.isSystemTrayAvailable():
+            return
+        w = self.window
+        self.icon = QSystemTrayIcon(self._app_icon(), w)
+        self.icon.setToolTip(self._tooltip)
+
+        menu = QMenu()
+        self._open_act = QAction(self._tr("app.tray.open"), w)
+        self._open_act.triggered.connect(w._show_window)
+        self._quit_act = QAction(self._tr("app.tray.quit"), w)
+        self._quit_act.triggered.connect(w._quit_app)
+        menu.addAction(self._open_act)
+        menu.addAction(self._quit_act)
+        self.icon.setContextMenu(menu)
+
+        self.icon.activated.connect(
+            lambda reason: w._show_window() if reason == QSystemTrayIcon.Trigger else None)
+        self.icon.show()
+
+    def retranslate(self) -> None:
+        if self.icon is not None:
+            self.icon.setToolTip(self._tooltip)
+        if self._open_act is not None:
+            self._open_act.setText(self._tr("app.tray.open"))
+            self._quit_act.setText(self._tr("app.tray.quit"))
+
+    def hide(self) -> None:
+        if self.icon is not None:
+            self.icon.hide()
+
+    # ---- thông báo -------------------------------------------------------
+
+    def show_message(self, title: str, body: str, *, error: bool = False,
+                     msec: int = 5000) -> None:
+        """Bắn bong bóng khay. Không có khay, hoặc hệ điều hành từ chối, thì
+        thôi — một thông báo không hiện được không đáng làm hỏng lượt chạy."""
+        if self.icon is None:
+            return
+        kind = QSystemTrayIcon.Critical if error else QSystemTrayIcon.Information
+        try:
+            self.icon.showMessage(title, body, kind, msec)
+        except Exception:  # noqa: BLE001
+            pass