socratic-debug 0.0.1__py3-none-any.whl

ui/styles.py

@@ -0,0 +1,63 @@
+# Global QSS Theme for Socratic Terminal GUI
+SOCRATIC_DARK_THEME = """
+    QMainWindow {
+        background-color: #0d1117;
+    }
+    QWidget {
+        color: #e6edf3;
+        font-family: 'Segoe UI', 'Ubuntu', 'DejaVu Sans', 'Noto Sans Arabic', sans-serif;
+        font-size: 14px;
+    }
+    QFrame#crashBanner {
+        background-color: #1f1315;
+        border: 1px solid #da3633;
+        border-radius: 8px;
+        padding: 10px;
+    }
+    QTextEdit#chatArea {
+        background-color: #161b22;
+        border: 1px solid #30363d;
+        border-radius: 8px;
+        padding: 12px;
+        line-height: 1.6;
+    }
+    QLineEdit#inputField {
+        background-color: #161b22;
+        border: 1px solid #388bfd;
+        border-radius: 6px;
+        padding: 10px 14px;
+        font-size: 14px;
+        color: #ffffff;
+    }
+    QLineEdit#inputField:focus {
+        border: 2px solid #58a6ff;
+        background-color: #1c2128;
+    }
+    QPushButton#sendButton {
+        background-color: #238636;
+        color: #ffffff;
+        font-weight: bold;
+        border: none;
+        border-radius: 6px;
+        padding: 10px 24px;
+        font-size: 14px;
+    }
+    QPushButton#sendButton:hover {
+        background-color: #2ea043;
+    }
+    QPushButton#sendButton:disabled {
+        background-color: #21262d;
+        color: #8b949e;
+    }
+    QLabel#headerTitle {
+        font-size: 16px;
+        font-weight: bold;
+        color: #58a6ff;
+    }
+    QLabel#statusBadge {
+        font-size: 12px;
+        font-weight: bold;
+        padding: 4px 10px;
+        border-radius: 4px;
+    }
+"""

ui/templates.py

@@ -0,0 +1,102 @@
+import html
+import re
+
+
+class ChatTemplates:
+    """HTML templates for rendering styled chat bubbles in QTextEdit."""
+
+    @staticmethod
+    def format_markdown(text: str) -> str:
+        """Converts basic markdown code blocks and inline formatting to HTML."""
+        parts = []
+        lines = text.split("\n")
+        in_code = False
+        code_buffer = []
+
+        for line in lines:
+            if line.strip().startswith("```"):
+                if in_code:
+                    code_content = html.escape("\n".join(code_buffer))
+                    parts.append(
+                        f"<pre style='background: #0d1117; color: #58a6ff; padding: 10px; border-radius: 6px; font-family: monospace; font-size: 13px; text-align: left; direction: ltr;'>{code_content}</pre>"
+                    )
+                    code_buffer = []
+                    in_code = False
+                else:
+                    in_code = True
+                continue
+
+            if in_code:
+                code_buffer.append(line)
+            else:
+                escaped = html.escape(line)
+                escaped = re.sub(r'\*\*(.*?)\*\*', r'<b>\1</b>', escaped)
+                escaped = re.sub(
+                    r'`(.*?)`',
+                    r"<code style='background: #21262d; color: #79c0ff; padding: 2px 5px; border-radius: 4px; font-family: monospace; direction: ltr;'>\1</code>",
+                    escaped,
+                )
+                parts.append(escaped + "<br/>")
+
+        if in_code and code_buffer:
+            code_content = html.escape("\n".join(code_buffer))
+            parts.append(
+                f"<pre style='background: #0d1117; color: #58a6ff; padding: 10px; border-radius: 6px; font-family: monospace; font-size: 13px; text-align: left; direction: ltr;'>{code_content}</pre>"
+            )
+
+        return "".join(parts)
+
+    @staticmethod
+    def mentor_bubble(content: str, hint_level: int, mentor_name: str, hint_label: str, is_arabic: bool) -> str:
+        border_side = "border-right" if is_arabic else "border-left"
+        formatted_html = ChatTemplates.format_markdown(content)
+        return f"""
+        <div style='margin-bottom: 16px; background-color: #111a2e; {border_side}: 4px solid #388bfd; border-radius: 6px; padding: 12px;'>
+            <div style='color: #58a6ff; font-weight: bold; font-size: 13px; margin-bottom: 6px;'>
+                🤖 {mentor_name} <span style='color: #8b949e; font-size: 11px;'>({hint_label} {hint_level}/3)</span>
+            </div>
+            <div style='color: #f0f6fc; font-size: 14px; line-height: 1.6;'>
+                {formatted_html}
+            </div>
+        </div>
+        """
+
+    @staticmethod
+    def user_bubble(text: str, user_tag: str, is_arabic: bool) -> str:
+        border_side = "border-left" if is_arabic else "border-right"
+        escaped_text = html.escape(text)
+        return f"""
+        <div style='margin-bottom: 16px; background-color: #1b2128; {border_side}: 4px solid #f2cc60; border-radius: 6px; padding: 10px 14px;'>
+            <div style='color: #f2cc60; font-weight: bold; font-size: 12px; margin-bottom: 4px;'>
+                👤 {user_tag}
+            </div>
+            <div style='color: #ffffff; font-size: 14px;'>
+                {escaped_text}
+            </div>
+        </div>
+        """
+
+    @staticmethod
+    def verdict_badge(verdict: str) -> str:
+        color = "#3fb950" if "SOLVED" in verdict else ("#f85149" if "SURRENDER" in verdict else "#d29922")
+        return f"""
+        <div style='text-align: center; margin: 8px 0;'>
+            <span style='background-color: #161b22; color: {color}; border: 1px solid {color}; border-radius: 12px; padding: 3px 14px; font-size: 12px; font-weight: bold;'>
+                {verdict}
+            </span>
+        </div>
+        """
+
+    @staticmethod
+    def solution_bubble(content: str, wrapup_title: str) -> str:
+        formatted_html = ChatTemplates.format_markdown(content)
+        return f"""
+        <div style='margin-top: 14px; margin-bottom: 20px; background-color: #122119; border: 2px solid #238636; border-radius: 8px; padding: 14px;'>
+            <div style='color: #3fb950; font-weight: bold; font-size: 15px; margin-bottom: 8px;'>
+                {wrapup_title}
+            </div>
+            <div style='color: #e6edf3; font-size: 14px; line-height: 1.6;'>
+                {formatted_html}
+            </div>
+        </div>
+        """

ui/translations.py

@@ -0,0 +1,31 @@
+# Multilingual Dictionary for Socratic UI
+TRANSLATIONS = {
+    "arabic": {
+        "app_title": "🧠 سُقراط ديبَج — المُرشد البرمجي التفاعلي",
+        "header_title": "🧠 المُرشد السقراطي للبرمجة",
+        "status_active": "● الجلسة نشطة",
+        "status_solved": "✔ تم الحل بنجاح",
+        "crash_location": "الموقع",
+        "crashing_line": "السطر المسبب للخطأ",
+        "placeholder": "اكتب إجابتك هنا، أو اكتب 'خروج' للإنهاء...",
+        "send_btn": "إرسال",
+        "mentor_tag": "المُرشد السقراطي",
+        "hint_level": "مستوى التلميح",
+        "user_tag": "إجابتك",
+        "wrapup_title": "🏆 الحل النهائي وأفضل الممارسات البرمجية",
+    },
+    "english": {
+        "app_title": "🧠 Socratic Debug — Autonomous Mentor",
+        "header_title": "🧠 SOCRATIC DEBUG MENTOR",
+        "status_active": "● ACTIVE SESSION",
+        "status_solved": "✔ SOLVED & CONCLUDED",
+        "crash_location": "Location",
+        "crashing_line": "Crashing Line",
+        "placeholder": "Type your answer here, or type 'exit' / 'q' to quit...",
+        "send_btn": "Send",
+        "mentor_tag": "Socratic Mentor",
+        "hint_level": "Hint Level",
+        "user_tag": "Your Response",
+        "wrapup_title": "🏆 Socratic Wrap-Up & Defensive Best Practice",
+    }
+}

ui/views.py

@@ -0,0 +1,52 @@
+import os
+from ui.app import bridge, wait_for_gui_user_input
+from ui.console import console
+from rich.panel import Panel
+from rich.markdown import Markdown
+
+
+class SocraticUI:
+    """Unified UI layer: seamlessly routes to PyQt6 Desktop Terminal or CLI Fallback."""
+
+    @staticmethod
+    def is_gui_active() -> bool:
+        return os.environ.get("SOCRATIC_GUI_ACTIVE") == "1"
+
+    @staticmethod
+    def display_crash_banner(error_type: str, error_message: str, file_path: str, line_number: int, line_content: str):
+        # In CLI fallback mode, print Rich banner
+        if not SocraticUI.is_gui_active():
+            console.print(f"\n[bold red]💥 {error_type}: {error_message}[/bold red]")
+            console.print(f"[dim]📍 {file_path}:{line_number}[/dim]\n")
+
+    @staticmethod
+    def display_mentor_message(content: str, hint_level: int = 1):
+        if SocraticUI.is_gui_active():
+            bridge.mentor_message_received.emit(content, hint_level)
+        else:
+            md = Markdown(content)
+            panel = Panel(md, title=f"Socratic Mentor (Level {hint_level}/3)", border_style="cyan")
+            console.print(panel)
+
+    @staticmethod
+    def prompt_user_input() -> str:
+        if SocraticUI.is_gui_active():
+            return wait_for_gui_user_input()
+        else:
+            return console.input("[bold yellow]❯❯ Your Response: [/bold yellow]").strip()
+
+    @staticmethod
+    def display_evaluator_verdict(verdict: str):
+        if SocraticUI.is_gui_active():
+            bridge.evaluator_verdict_received.emit(verdict)
+        else:
+            console.print(f"  [bold yellow]🔍 {verdict}[/bold yellow]\n")
+
+    @staticmethod
+    def display_solution(solution_content: str):
+        if SocraticUI.is_gui_active():
+            bridge.solution_received.emit(solution_content)
+        else:
+            md = Markdown(solution_content)
+            panel = Panel(md, title="🏆 Socratic Wrap-Up", border_style="green")
+            console.print(panel)

ui/window.py

@@ -0,0 +1,140 @@
+import platform
+import shutil
+import subprocess
+import sys
+import os
+from typing import List, Optional
+
+
+class TerminalWindowLauncher:
+    """
+    Cross-platform Terminal Launcher.
+    Spawns dedicated, styled GUI terminal popup windows on:
+    - Linux (GNOME Terminal, Kitty, Alacritty, Konsole, XFCE, etc.)
+    - macOS (Terminal.app, iTerm2 via AppleScript)
+    - Windows (Windows Terminal wt.exe, CMD, PowerShell)
+    """
+
+    LINUX_TERMINALS = [
+        "gnome-terminal",
+        "io.elementary.terminal",
+        "x-terminal-emulator",
+        "xfce4-terminal",
+        "mate-terminal",
+        "konsole",
+        "kitty",
+        "alacritty",
+        "xterm",
+    ]
+
+    @staticmethod
+    def spawn_session_window(command_args: List[str]) -> bool:
+        """
+        Spawns a new dedicated terminal window based on host OS.
+        Returns True on success, or False to fallback to in-process execution.
+        """
+        # Avoid recursive popup spawning
+        if os.environ.get("SOCRATIC_IN_POPUP") == "1":
+            return False
+
+        current_os = platform.system().lower()
+        env = os.environ.copy()
+        env["SOCRATIC_IN_POPUP"] = "1"
+
+        try:
+            if "windows" in current_os:
+                return TerminalWindowLauncher._spawn_windows(command_args, env)
+            elif "darwin" in current_os:
+                return TerminalWindowLauncher._spawn_macos(command_args, env)
+            elif "linux" in current_os:
+                return TerminalWindowLauncher._spawn_linux(command_args, env)
+        except Exception:
+            return False
+
+        return False
+
+    @staticmethod
+    def _spawn_windows(command_args: List[str], env: dict) -> bool:
+        cmd_str = " ".join(f'"{arg}"' if " " in arg else arg for arg in command_args)
+
+        # 1. Try modern Windows Terminal (wt.exe)
+        if shutil.which("wt.exe") or shutil.which("wt"):
+            subprocess.Popen(
+                ["wt.exe", "--title", "🧠 Socratic Debug Session", "cmd", "/c", cmd_str],
+                env=env,
+                creationflags=subprocess.CREATE_NEW_CONSOLE,
+            )
+            return True
+
+        # 2. Fallback to standard Windows cmd.exe
+        subprocess.Popen(
+            f'start "🧠 Socratic Debug Session" cmd /c "{cmd_str}"',
+            shell=True,
+            env=env,
+        )
+        return True
+
+    @staticmethod
+    def _spawn_macos(command_args: List[str], env: dict) -> bool:
+        cmd_str = " ".join(f'"{arg}"' if " " in arg else arg for arg in command_args)
+        escaped_cmd = cmd_str.replace('\\', '\\\\').replace('"', '\\"')
+
+        # Launch dedicated macOS Terminal.app via osascript
+        apple_script = f'''
+        tell application "Terminal"
+            do script "{escaped_cmd}"
+            activate
+        end tell
+        '''
+        subprocess.Popen(["osascript", "-e", apple_script], env=env)
+        return True
+
+    @staticmethod
+    def _spawn_linux(command_args: List[str], env: dict) -> bool:
+        terminal = None
+        for term in TerminalWindowLauncher.LINUX_TERMINALS:
+            if shutil.which(term):
+                terminal = term
+                break
+
+        if not terminal:
+            return False
+
+        if terminal in ("gnome-terminal", "io.elementary.terminal", "x-terminal-emulator", "mate-terminal", "xfce4-terminal"):
+            subprocess.Popen(
+                [
+                    terminal,
+                    "--title=🧠 Socratic Debug Session",
+                    "--geometry=84x24",
+                    "--",
+                    *command_args,
+                ],
+                env=env,
+            )
+            return True
+
+        elif terminal == "konsole":
+            subprocess.Popen(
+                [
+                    terminal,
+                    "-p", "tabtitle=🧠 Socratic Debug Session",
+                    "-e",
+                    *command_args,
+                ],
+                env=env,
+            )
+            return True
+
+        elif terminal in ("alacritty", "kitty", "xterm"):
+            subprocess.Popen(
+                [
+                    terminal,
+                    "-T", "🧠 Socratic Debug Session",
+                    "-e",
+                    *command_args,
+                ],
+                env=env,
+            )
+            return True
+
+        return False