From 689a3a73d18945670ff2a233f61c6876fb43a48c Mon Sep 17 00:00:00 2001
From: Lucas Oliveira <lucas.edu.oli@hotmail.com>
Date: Mon, 1 Dec 2025 16:12:02 -0300
Subject: [PATCH] add fullscreen dialog on upgrade

---
 src/tui/screens/monitor.py                    |  21 +---
 src/tui/widgets/upgrade_instructions_modal.py | 112 ++++++++++++++++++
 2 files changed, 116 insertions(+), 17 deletions(-)
 create mode 100644 src/tui/widgets/upgrade_instructions_modal.py

diff --git a/src/tui/screens/monitor.py b/src/tui/screens/monitor.py
index d715b4d3..fe213d56 100644
--- a/src/tui/screens/monitor.py
+++ b/src/tui/screens/monitor.py
@@ -21,6 +21,7 @@ from ..utils.platform import RuntimeType
 from ..widgets.command_modal import CommandOutputModal
 from ..widgets.flow_backup_warning_modal import FlowBackupWarningModal
 from ..widgets.version_mismatch_warning_modal import VersionMismatchWarningModal
+from ..widgets.upgrade_instructions_modal import UpgradeInstructionsModal
 from ..widgets.diagnostics_notification import notify_with_diagnostics
 
 
@@ -432,23 +433,9 @@ class MonitorScreen(Screen):
                     timeout=5,
                 )
             else:
-                # Show upgrade instructions
-                upgrade_message = (
-                    f"Current version: {current_version}\n"
-                    f"Latest version: {latest_version}\n\n"
-                    "To upgrade the TUI:\n"
-                    "1. Exit TUI (press 'q')\n"
-                    "2. Run one of:\n"
-                    "   • pip install --upgrade openrag\n"
-                    "   • uv pip install --upgrade openrag\n"
-                    "   • uvx --from openrag openrag\n"
-                    "3. Restart: openrag\n\n"
-                    "After upgrading, containers will automatically use the new version."
-                )
-                self.notify(
-                    upgrade_message,
-                    severity="information",
-                    timeout=30,  # Show for 30 seconds
+                # Show upgrade instructions in a modal dialog
+                await self.app.push_screen_wait(
+                    UpgradeInstructionsModal(current_version, latest_version)
                 )
         except Exception as e:
             self.notify(
diff --git a/src/tui/widgets/upgrade_instructions_modal.py b/src/tui/widgets/upgrade_instructions_modal.py
new file mode 100644
index 00000000..9705c146
--- /dev/null
+++ b/src/tui/widgets/upgrade_instructions_modal.py
@@ -0,0 +1,112 @@
+"""Upgrade instructions modal for OpenRAG TUI."""
+
+from textual.app import ComposeResult
+from textual.containers import Container, Horizontal
+from textual.screen import ModalScreen
+from textual.widgets import Button, Static, Label
+
+
+class UpgradeInstructionsModal(ModalScreen[bool]):
+    """Modal dialog showing upgrade instructions when not on latest version."""
+
+    DEFAULT_CSS = """
+    UpgradeInstructionsModal {
+        align: center middle;
+    }
+
+    #dialog {
+        width: 75;
+        height: auto;
+        border: solid #3f3f46;
+        background: #27272a;
+        padding: 0;
+    }
+
+    #title {
+        background: #3f3f46;
+        color: #fafafa;
+        padding: 1 2;
+        text-align: center;
+        width: 100%;
+        text-style: bold;
+    }
+
+    #message {
+        padding: 2;
+        color: #fafafa;
+    }
+
+    #button-row {
+        width: 100%;
+        height: auto;
+        align: center middle;
+        padding: 1;
+        margin-top: 1;
+    }
+
+    #button-row Button {
+        margin: 0 1;
+        min-width: 16;
+        background: #27272a;
+        color: #fafafa;
+        border: round #52525b;
+        text-style: none;
+        tint: transparent 0%;
+    }
+
+    #button-row Button:hover {
+        background: #27272a !important;
+        color: #fafafa !important;
+        border: round #52525b;
+        tint: transparent 0%;
+        text-style: none;
+    }
+
+    #button-row Button:focus {
+        background: #27272a !important;
+        color: #fafafa !important;
+        border: round #ec4899;
+        tint: transparent 0%;
+        text-style: none;
+    }
+    """
+
+    def __init__(self, current_version: str, latest_version: str):
+        """Initialize the upgrade instructions modal.
+        
+        Args:
+            current_version: Current TUI version
+            latest_version: Latest available version
+        """
+        super().__init__()
+        self.current_version = current_version
+        self.latest_version = latest_version
+
+    def compose(self) -> ComposeResult:
+        """Create the modal dialog layout."""
+        with Container(id="dialog"):
+            yield Label("📦 Upgrade Available", id="title")
+            yield Static(
+                f"Current version: {self.current_version}\n"
+                f"Latest version: {self.latest_version}\n\n"
+                "To upgrade the TUI:\n"
+                "1. Exit TUI (press 'q')\n"
+                "2. Run one of:\n"
+                "   • pip install --upgrade openrag\n"
+                "   • uv pip install --upgrade openrag\n"
+                "   • uvx --from openrag openrag\n"
+                "3. Restart: openrag\n\n"
+                "After upgrading, containers will automatically use the new version.",
+                id="message"
+            )
+            with Horizontal(id="button-row"):
+                yield Button("Close", id="close-btn")
+
+    def on_mount(self) -> None:
+        """Focus the close button."""
+        self.query_one("#close-btn", Button).focus()
+
+    def on_button_pressed(self, event: Button.Pressed) -> None:
+        """Handle button presses."""
+        self.dismiss(True)  # Just close the modal
+