aline-ai 0.5.4__py3-none-any.whl → 0.5.6__py3-none-any.whl

realign/dashboard/screens/help_screen.py

@@ -0,0 +1,114 @@
+"""Help screen modal for the dashboard."""
+
+from __future__ import annotations
+
+from textual.app import ComposeResult
+from textual.binding import Binding
+from textual.containers import Container, Vertical
+from textual.screen import ModalScreen
+from textual.widgets import Button, Static
+
+
+class HelpScreen(ModalScreen):
+    """Modal showing keyboard shortcuts and help information."""
+
+    BINDINGS = [
+        Binding("escape", "close", "Close", show=False),
+        Binding("?", "close", "Close", show=False),
+    ]
+
+    DEFAULT_CSS = """
+    HelpScreen {
+        align: center middle;
+    }
+
+    HelpScreen #help-root {
+        width: 50;
+        height: auto;
+        max-height: 80%;
+        padding: 1 2;
+        background: $background;
+        border: solid $accent;
+    }
+
+    HelpScreen #help-title {
+        height: auto;
+        margin-bottom: 1;
+        text-style: bold;
+        text-align: center;
+    }
+
+    HelpScreen .shortcut-section {
+        height: auto;
+        margin-bottom: 1;
+    }
+
+    HelpScreen .section-title {
+        height: auto;
+        color: $text-muted;
+        margin-bottom: 0;
+    }
+
+    HelpScreen .shortcut-row {
+        height: auto;
+        padding: 0 1;
+    }
+
+    HelpScreen .shortcut-key {
+        width: 14;
+        height: auto;
+        color: $accent;
+    }
+
+    HelpScreen .shortcut-desc {
+        width: 1fr;
+        height: auto;
+    }
+
+    HelpScreen #close-btn {
+        margin-top: 1;
+        width: 100%;
+    }
+    """
+
+    def compose(self) -> ComposeResult:
+        with Container(id="help-root"):
+            yield Static("Keyboard Shortcuts", id="help-title")
+
+            with Vertical(classes="shortcut-section"):
+                yield Static("Navigation", classes="section-title")
+                yield self._shortcut_row("Tab", "Next tab")
+                yield self._shortcut_row("Shift+Tab", "Previous tab")
+                yield self._shortcut_row("n", "Next page")
+                yield self._shortcut_row("p", "Previous page")
+
+            with Vertical(classes="shortcut-section"):
+                yield Static("Actions", classes="section-title")
+                yield self._shortcut_row("Enter", "Open selected item")
+                yield self._shortcut_row("Space", "Toggle selection")
+                yield self._shortcut_row("c", "Create event")
+                yield self._shortcut_row("l", "Load context")
+                yield self._shortcut_row("y", "Import share")
+                yield self._shortcut_row("s", "Switch view")
+                yield self._shortcut_row("r", "Refresh")
+
+            with Vertical(classes="shortcut-section"):
+                yield Static("General", classes="section-title")
+                yield self._shortcut_row("?", "Show this help")
+                yield self._shortcut_row("Ctrl+C x2", "Quit")
+
+            yield Button("Close", id="close-btn", variant="primary")
+
+    def _shortcut_row(self, key: str, description: str) -> Static:
+        """Create a shortcut row with key and description."""
+        return Static(f"[bold $accent]{key:<12}[/] {description}", classes="shortcut-row")
+
+    def on_mount(self) -> None:
+        self.query_one("#close-btn", Button).focus()
+
+    def action_close(self) -> None:
+        self.app.pop_screen()
+
+    def on_button_pressed(self, event: Button.Pressed) -> None:
+        if event.button.id == "close-btn":
+            self.app.pop_screen()

realign/dashboard/screens/session_detail.py

@@ -162,7 +162,9 @@ class SessionDetailScreen(ModalScreen):
         session_title = getattr(self._session, "session_title", None) if self._session else None
         session_type = getattr(self._session, "session_type", None) if self._session else None
         workspace_path = getattr(self._session, "workspace_path", None) if self._session else None
-        last_activity_at = getattr(self._session, "last_activity_at", None) if self._session else None
+        last_activity_at = (
+            getattr(self._session, "last_activity_at", None) if self._session else None
+        )
         started_at = getattr(self._session, "started_at", None) if self._session else None
 
         source_map = {

realign/dashboard/screens/share_import.py

@@ -74,7 +74,9 @@ class ShareImportScreen(ModalScreen):
                         placeholder="Paste share URL (e.g. https://.../share/abc123)",
                     )
                 with Horizontal(classes="row"):
-                    yield Input(id="share-password", placeholder="Password (optional)", password=True)
+                    yield Input(
+                        id="share-password", placeholder="Password (optional)", password=True
+                    )
                 with Horizontal(classes="row"):
                     yield Checkbox("Force re-import (override duplicates)", id="share-force")
                 with Horizontal(id="share-import-actions", classes="row"):
@@ -107,7 +109,10 @@ class ShareImportScreen(ModalScreen):
         self.query_one("#cancel", Button).disabled = busy
 
     def _start_import(self) -> None:
-        if self._worker is not None and self._worker.state in (WorkerState.PENDING, WorkerState.RUNNING):
+        if self._worker is not None and self._worker.state in (
+            WorkerState.PENDING,
+            WorkerState.RUNNING,
+        ):
             return
 
         share_url = self.query_one("#share-url", Input).value.strip()
@@ -181,4 +186,3 @@ class ShareImportScreen(ModalScreen):
             message = f"{message}: {stderr_text}"
         status.update(f"[red]{message}[/red]")
         self.app.notify(message, title="Share Import", severity="error", timeout=6)
-

realign/dashboard/tmux_manager.py

@@ -96,7 +96,9 @@ def _run_tmux(args: Sequence[str], *, capture: bool = False) -> subprocess.Compl
     )
 
 
-def _run_outer_tmux(args: Sequence[str], *, capture: bool = False) -> subprocess.CompletedProcess[str]:
+def _run_outer_tmux(
+    args: Sequence[str], *, capture: bool = False
+) -> subprocess.CompletedProcess[str]:
     """Run tmux commands against the dedicated outer server socket."""
     return _run_tmux(["-L", OUTER_SOCKET, *args], capture=capture)
 
@@ -110,7 +112,11 @@ def _run_inner_tmux(
 def _python_dashboard_command() -> str:
     # Use the current interpreter for predictable environments (venv, editable installs).
     python_cmd = shlex.join(
-        [sys.executable, "-c", "from realign.dashboard.app import run_dashboard; run_dashboard()"]
+        [
+            sys.executable,
+            "-c",
+            "from realign.dashboard.app import run_dashboard; run_dashboard()",
+        ]
     )
     return f"{MANAGED_ENV}=1 {python_cmd}"
 
@@ -209,7 +215,16 @@ def _aline_tmux_conf_path() -> Path:
 def _source_aline_tmux_config(run_fn) -> None:  # type: ignore[no-untyped-def]
     """Best-effort source ~/.aline/tmux/tmux.conf if present."""
     try:
-        conf = _aline_tmux_conf_path()
+        # Ensure the config exists and is parseable.
+        # Users may run `aline dashboard` before `aline init`, or have older auto-generated configs
+        # that included unquoted `#` bindings (tmux treats `#` as a comment delimiter).
+        try:
+            from ..commands.init import _initialize_tmux_config
+
+            conf = _initialize_tmux_config()
+        except Exception:
+            conf = _aline_tmux_conf_path()
+
         if conf.exists():
             run_fn(["source-file", str(conf)])
     except Exception:
@@ -290,7 +305,11 @@ def _maximize_terminal_window() -> None:
 
         if front_app == "Terminal":
             proc = subprocess.run(
-                ["osascript", "-e", 'tell application "Terminal" to set zoomed of front window to true'],
+                [
+                    "osascript",
+                    "-e",
+                    'tell application "Terminal" to set zoomed of front window to true',
+                ],
                 capture_output=True,
                 text=True,
                 timeout=2,
@@ -377,6 +396,17 @@ def bootstrap_dashboard_into_tmux() -> None:
     # Enable mouse for the managed session only.
     _run_outer_tmux(["set-option", "-t", OUTER_SESSION, "mouse", "on"])
 
+    # Disable status bar for cleaner UI (Aline sessions only).
+    _run_outer_tmux(["set-option", "-t", OUTER_SESSION, "status", "off"])
+
+    # Pane border styling - use double lines for wider, more visible borders.
+    # This helps users identify the resizable border area more easily and reduces
+    # accidental drag-to-resize when trying to select text near the border.
+    _run_outer_tmux(["set-option", "-t", OUTER_SESSION, "pane-border-lines", "double"])
+    _run_outer_tmux(["set-option", "-t", OUTER_SESSION, "pane-border-style", "fg=brightblack"])
+    _run_outer_tmux(["set-option", "-t", OUTER_SESSION, "pane-active-border-style", "fg=blue"])
+    _run_outer_tmux(["set-option", "-t", OUTER_SESSION, "pane-border-indicators", "arrows"])
+
     # Ensure dashboard window exists.
     windows_out = (
         _run_outer_tmux(
@@ -422,6 +452,18 @@ def ensure_inner_session() -> bool:
 
     # Dedicated inner server; safe to enable mouse globally there.
     _run_inner_tmux(["set-option", "-g", "mouse", "on"])
+
+    # Disable status bar for cleaner UI.
+    _run_inner_tmux(["set-option", "-t", INNER_SESSION, "status", "off"])
+
+    # Pane border styling - use double lines for wider, more visible borders.
+    # This helps users identify the resizable border area more easily and reduces
+    # accidental drag-to-resize when trying to select text near the border.
+    _run_inner_tmux(["set-option", "-g", "pane-border-lines", "double"])
+    _run_inner_tmux(["set-option", "-g", "pane-border-style", "fg=brightblack"])
+    _run_inner_tmux(["set-option", "-g", "pane-active-border-style", "fg=blue"])
+    _run_inner_tmux(["set-option", "-g", "pane-border-indicators", "arrows"])
+
     _source_aline_tmux_config(_run_inner_tmux)
     return True
 
@@ -436,7 +478,13 @@ def ensure_right_pane(width_percent: int = 50) -> bool:
 
     panes_out = (
         _run_tmux(
-            ["list-panes", "-t", f"{OUTER_SESSION}:{OUTER_WINDOW}", "-F", "#{pane_index}"],
+            [
+                "list-panes",
+                "-t",
+                f"{OUTER_SESSION}:{OUTER_WINDOW}",
+                "-F",
+                "#{pane_index}",
+            ],
             capture=True,
         ).stdout
         or ""
@@ -647,10 +695,7 @@ def clear_attention(window_id: str) -> bool:
     """Clear the attention state for a window (e.g., after user acknowledges permission request)."""
     if not ensure_inner_session():
         return False
-    return (
-        _run_inner_tmux(["set-option", "-w", "-t", window_id, OPT_ATTENTION, ""]).returncode
-        == 0
-    )
+    return _run_inner_tmux(["set-option", "-w", "-t", window_id, OPT_ATTENTION, ""]).returncode == 0
 
 
 def get_active_claude_context_id() -> str | None:

realign/dashboard/widgets/config_panel.py

@@ -6,7 +6,9 @@ from typing import Optional
 
 from textual.app import ComposeResult
 from textual.containers import Horizontal
-from textual.widgets import Button, DataTable, Input, Static
+from textual.widgets import Button, DataTable, Input, Static, Switch
+
+from ..tmux_manager import _run_outer_tmux, OUTER_SESSION
 
 
 class ConfigPanel(Static):
@@ -51,6 +53,27 @@ class ConfigPanel(Static):
     ConfigPanel .button-row Button {
         margin-right: 1;
     }
+
+    ConfigPanel .tmux-settings {
+        height: auto;
+        margin-top: 1;
+        padding: 1;
+        border: solid $secondary;
+    }
+
+    ConfigPanel .tmux-settings .setting-row {
+        height: 3;
+        align: left middle;
+    }
+
+    ConfigPanel .tmux-settings .setting-label {
+        width: auto;
+        margin-right: 1;
+    }
+
+    ConfigPanel .tmux-settings Switch {
+        width: auto;
+    }
     """
 
     def __init__(self) -> None:
@@ -58,6 +81,8 @@ class ConfigPanel(Static):
         self._config_path: Optional[Path] = None
         self._config_data: dict = {}
         self._selected_key: Optional[str] = None
+        self._border_resize_enabled: bool = True  # Track tmux border resize state
+        self._syncing_switch: bool = False  # Flag to prevent recursive switch updates
 
     def compose(self) -> ComposeResult:
         """Compose the config panel layout."""
@@ -71,6 +96,13 @@ class ConfigPanel(Static):
             yield Button("Save", id="save-btn", variant="primary")
             yield Button("Reload", id="reload-btn", variant="default")
 
+        # Tmux settings section
+        with Static(classes="tmux-settings"):
+            yield Static("[bold]Tmux Settings[/bold]", classes="section-title")
+            with Horizontal(classes="setting-row"):
+                yield Static("Allow border resize:", classes="setting-label")
+                yield Switch(value=True, id="border-resize-switch")
+
     def on_mount(self) -> None:
         """Set up the panel on mount."""
         table = self.query_one("#config-table", DataTable)
@@ -80,6 +112,9 @@ class ConfigPanel(Static):
         # Load initial data
         self.refresh_data()
 
+        # Query and set the actual tmux border resize state
+        self._sync_border_resize_switch()
+
     def on_data_table_row_selected(self, event: DataTable.RowSelected) -> None:
         """Handle row selection in the config table."""
         table = self.query_one("#config-table", DataTable)
@@ -114,6 +149,55 @@ class ConfigPanel(Static):
             self.refresh_data()
             self.app.notify("Configuration reloaded", title="Config")
 
+    def on_switch_changed(self, event: Switch.Changed) -> None:
+        """Handle switch toggle events."""
+        if self._syncing_switch:
+            return  # Ignore events during sync
+        if event.switch.id == "border-resize-switch":
+            self._toggle_border_resize(event.value)
+
+    def _sync_border_resize_switch(self) -> None:
+        """Query tmux state and sync the switch to match."""
+        try:
+            # Check if MouseDrag1Border is bound by listing keys
+            result = _run_outer_tmux(["list-keys", "-T", "root"], capture=True)
+            output = result.stdout or ""
+
+            # If MouseDrag1Border is in the output, resize is enabled
+            is_enabled = "MouseDrag1Border" in output
+            self._border_resize_enabled = is_enabled
+
+            # Update switch without triggering the toggle action
+            self._syncing_switch = True
+            try:
+                switch = self.query_one("#border-resize-switch", Switch)
+                switch.value = is_enabled
+            finally:
+                self._syncing_switch = False
+        except Exception:
+            # If we can't query, assume enabled (default tmux behavior)
+            pass
+
+    def _toggle_border_resize(self, enabled: bool) -> None:
+        """Enable or disable tmux border resize functionality."""
+        try:
+            if enabled:
+                # Re-enable border resize by binding MouseDrag1Border to default resize behavior
+                _run_outer_tmux([
+                    "bind", "-n", "MouseDrag1Border", "resize-pane", "-M"
+                ])
+                self._border_resize_enabled = True
+                self.app.notify("Border resize enabled", title="Tmux")
+            else:
+                # Disable border resize by unbinding MouseDrag1Border
+                _run_outer_tmux([
+                    "unbind", "-n", "MouseDrag1Border"
+                ])
+                self._border_resize_enabled = False
+                self.app.notify("Border resize disabled", title="Tmux")
+        except Exception as e:
+            self.app.notify(f"Error toggling border resize: {e}", title="Tmux", severity="error")
+
     def _save_config(self) -> None:
         """Save the edited configuration."""
         if not self._selected_key: