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

{aline_ai-0.5.6.dist-info → aline_ai-0.5.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aline-ai
-Version: 0.5.6
+Version: 0.5.8
 Summary: Shared AI memory; everyone knows everything in teams
 Author: Sharemind
 License: MIT

{aline_ai-0.5.6.dist-info → aline_ai-0.5.8.dist-info}/RECORD

@@ -1,7 +1,7 @@
-aline_ai-0.5.6.dist-info/licenses/LICENSE,sha256=H8wTqV5IF1oHw_HbBtS1PSDU8G_q81yblEIL_JfV8Vo,1077
-realign/__init__.py,sha256=0koKhfclqNXk2boQRfbLPBFyEmPnS5B07UmqTJ-o7iU,1623
+aline_ai-0.5.8.dist-info/licenses/LICENSE,sha256=H8wTqV5IF1oHw_HbBtS1PSDU8G_q81yblEIL_JfV8Vo,1077
+realign/__init__.py,sha256=r_zeipazrpik0MPgEERMIzrPFCcbvLypS_erc6wytjc,1623
 realign/claude_detector.py,sha256=ZLSJacMo6zzQclXByABKA70UNpstxqIv3fPGqdpA934,2792
-realign/cli.py,sha256=yeq_a3Peoqx8N13Jo2etjJtbTCZYpuqwoMMyAPdrANs,30569
+realign/cli.py,sha256=9VS3WbysZ78NRK5EvkJVg8s6Uh2TQjsGX1E9Pl81pHc,31234
 realign/codex_detector.py,sha256=N9ulgMgvTzDfXE4s4vLd6OoS0hT7R6h2bDFFXWa-2hE,4183
 realign/config.py,sha256=lIKZqeOwYc_gHo760lYYX6PnapuKrCWGqT5SA8-PbeA,12044
 realign/context.py,sha256=S1YEUn5HWSDTerDDMsSsRV871IZxoaxDjPTPI2z6-Xs,9976
@@ -19,7 +19,7 @@ realign/worker_daemon.py,sha256=LpJbQDY0Z4AMtq0LmpxvFeQM4puuoGDRBayKRafvKhc,3574
 realign/adapters/__init__.py,sha256=bpDm5aBxMdq4OA_beYahoUb4zfNaq3KOG6KghQJruRc,827
 realign/adapters/antigravity.py,sha256=geaYxAEswpgsVtERqsQ1OwvPFsy5tRkyjx2yQ-Uq9nM,5461
 realign/adapters/base.py,sha256=2IdAZKGjg5gPB3YLf_8r3V4XAdbK7fHpj06GjjsYEFY,7409
-realign/adapters/claude.py,sha256=sZD-W8nAOF-2jWwgEmJpnT2EpbVbF0NfSbnnW1X0wtg,5060
+realign/adapters/claude.py,sha256=ksTRwC5Z8AzUcB21LFjx6DETP08cv__fjgBzm-TeZdI,5444
 realign/adapters/codex.py,sha256=5ex3zJ5Hpb_StV2CcBSHVhHleygZxzVJjYsWw8qK1Bc,2051
 realign/adapters/gemini.py,sha256=NvtXQPWUtEY-DaAAMvLGvQW4FalTG-g0pD514HYnzF0,2540
 realign/adapters/registry.py,sha256=yM6nf9nGTJ1vaK2Uixp-VacseK7PmxZkCdKedmWI8MA,3255
@@ -37,14 +37,14 @@ realign/commands/config.py,sha256=nYnu_h2pk7GODcrzrV04K51D-s7v06FlRXHJ0HJ-gvU,67
 realign/commands/context.py,sha256=pM2KfZHVkB-ou4nBhFvKSwnYliLBzwN3zerLyBAbhfE,7095
 realign/commands/export_shares.py,sha256=Djy1aO7MoU1_ewzn6CZ43oNhSEEonV3sTkSQbHgiaKI,135806
 realign/commands/import_shares.py,sha256=ukX8huvLvEM5g0qEIoqrV1-imz1g-r0Jj2FqD-ojrIA,25297
-realign/commands/init.py,sha256=0wjutL1DxA0hYMt1aCfgUSf91ZBExXCXFrwuOyQNHLg,32060
+realign/commands/init.py,sha256=ef-q3Qz5D_0Eqld8qjtX26X2QrovBSYcva3uAjiJuwk,33015
 realign/commands/restore.py,sha256=s2BxQZHxQw9r12NzRVsK20KlGafy5AIoSjWMo5PcnHY,11173
-realign/commands/search.py,sha256=RUdseQsjy-SNfKFkGLWrE4IhxkzgkW9IIxAX33XnCHk,24589
+realign/commands/search.py,sha256=QJrC0hln9sCDFxXbpo0nPGMHXrud18qA5QfRyD0z6fQ,25926
 realign/commands/upgrade.py,sha256=L3PLOUIN5qAQTbkfoVtSsIbbzEezA_xjjk9F1GMVfjw,12781
 realign/commands/watcher.py,sha256=fWL3kaRkqE03-NtFLaXlx93hJAQrAuNPSoYhOyQZfq8,136273
 realign/commands/worker.py,sha256=K1DG1uZ--ebKwklHCyIFdN_axoLjL9Onx8Naq-DOZBs,23078
 realign/dashboard/__init__.py,sha256=QZkHTsGityH8UkF8rmvA3xW7dMXNe0swEWr443qfgCM,128
-realign/dashboard/app.py,sha256=LPgDXCqXHtJXzgFiwJvWolLJZ34EU4gejLrBIrgEk4Y,12233
+realign/dashboard/app.py,sha256=jyW6mqmItTy253CPSqInxctkWzkrGEikdy-ikuShQ14,13299
 realign/dashboard/tmux_manager.py,sha256=DdCiumQ7YQZnje5VfOQ60585C0X6Va_AhBQi_zmhE0Y,24035
 realign/dashboard/screens/__init__.py,sha256=US6sAmQs5VVkH2tFkH_z0WDT4H8cVhLL-JckfSR1yQY,446
 realign/dashboard/screens/create_agent.py,sha256=ugEs3IHrT7FsbuMEwyrqY3eoylp_pbftw42_Fu07tF4,7419
@@ -60,8 +60,8 @@ realign/dashboard/widgets/events_table.py,sha256=OG9RjwU4c50-RUMmdhXzmIMnYrt6_mC
 realign/dashboard/widgets/header.py,sha256=0HHCFXX7F3C6HII-WDwOJwWkJrajmKPWmdoMWyOkn9E,1587
 realign/dashboard/widgets/openable_table.py,sha256=GeJPDEYp0kRHShqvmPMzAePpYXRZHUNqcWNnxqsqxjA,1963
 realign/dashboard/widgets/search_panel.py,sha256=ZNJDfwDSxUFnCeltYQYsQsPJ6t4HDeNWpENoTOoBdVM,8951
-realign/dashboard/widgets/sessions_table.py,sha256=toHE96RLwddqXE9Ykocy6loqoGld_6gFawLwdiiJ2cA,32877
-realign/dashboard/widgets/terminal_panel.py,sha256=uXgPcgjWaQ2tTD6Mx6ikCXzq6wYqh-ft0Bait83_DKE,28290
+realign/dashboard/widgets/sessions_table.py,sha256=PohOkg-ESLBa-Sq0PdLPhV-YzVXOGpUo5ETs0MYO4u8,33415
+realign/dashboard/widgets/terminal_panel.py,sha256=S4UUMlFaBWDKZB_MR0jhBNvdwdGvPuRNHNxweFGDfks,28751
 realign/dashboard/widgets/watcher_panel.py,sha256=O_mdDacgc87xA-5KEfta53Ik_Xsk_B2OfwenMOTtGw8,19722
 realign/dashboard/widgets/worker_panel.py,sha256=F_jKWABuCNmjQgeeuCr4KnFRKdY4CLTNcEXMYwsNaSk,18691
 realign/db/__init__.py,sha256=-1d-Zc4IOUVokbdTXi3R-bIwlkFEPAz_qTHAdcsdp6g,1870
@@ -88,8 +88,8 @@ realign/triggers/next_turn_trigger.py,sha256=BpP0PWn4mU1MZd6mv89jWcjs8Jtv0zEWapW
 realign/triggers/registry.py,sha256=cb-AVLbYB2pqwfWL3q1DQxLv4kOw7g7m-GshTdfFESc,3827
 realign/triggers/turn_status.py,sha256=wAZEhXDAmDoX5F-ohWfSnZZ0eA6DAJ9svSPiSv_f6sg,6041
 realign/triggers/turn_summary.py,sha256=f3hEUshgv9skJ9AbfWpoYs417lsv_HK2A_vpPjgryO4,4467
-aline_ai-0.5.6.dist-info/METADATA,sha256=F8huCWnwasj2O7OA4fWD7o5s8HNT_0ErOSJEkLOefQc,1597
-aline_ai-0.5.6.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-aline_ai-0.5.6.dist-info/entry_points.txt,sha256=TvYELpMoWsUTcQdMV8tBHxCbEf_LbK4sESqK3r8PM6Y,78
-aline_ai-0.5.6.dist-info/top_level.txt,sha256=yIL3s2xv9nf1GwD5n71Aq_JEIV4AfzCIDNKBzewuRm4,8
-aline_ai-0.5.6.dist-info/RECORD,,
+aline_ai-0.5.8.dist-info/METADATA,sha256=S2cnGF2C84A28xQzAGz7nszWbBKErn4LazeX6KhAiBA,1597
+aline_ai-0.5.8.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+aline_ai-0.5.8.dist-info/entry_points.txt,sha256=TvYELpMoWsUTcQdMV8tBHxCbEf_LbK4sESqK3r8PM6Y,78
+aline_ai-0.5.8.dist-info/top_level.txt,sha256=yIL3s2xv9nf1GwD5n71Aq_JEIV4AfzCIDNKBzewuRm4,8
+aline_ai-0.5.8.dist-info/RECORD,,

realign/__init__.py

@@ -3,7 +3,7 @@
 import hashlib
 from pathlib import Path
 
-__version__ = "0.5.6"
+__version__ = "0.5.8"
 
 
 def get_realign_dir(project_root: Path) -> Path:

realign/adapters/claude.py

@@ -76,14 +76,13 @@ class ClaudeAdapter(SessionAdapter):
             project_path_str = "/" + parent_name[1:].replace("-", "/")
             project_path = Path(project_path_str)
 
-            # Validation: check if path exists
-            # We relax this slightly: if it's a valid-looking path, we return it,
-            # but ideally we check existence.
+            # If path exists locally, return it immediately
             if project_path.exists():
                 return project_path
 
             # Fallback: read cwd from the session JSONL (more reliable when the encoded
             # directory name is ambiguous due to '-' in real paths).
+            cwd_path: Optional[Path] = None
             try:
                 with session_file.open("r", encoding="utf-8") as f:
                     for i, line in enumerate(f):
@@ -98,13 +97,20 @@ class ClaudeAdapter(SessionAdapter):
                             continue
                         cwd = obj.get("cwd")
                         if isinstance(cwd, str) and cwd.strip():
-                            path = Path(cwd.strip())
-                            if path.exists():
-                                return path
+                            cwd_path = Path(cwd.strip())
+                            # If cwd exists locally, prefer it
+                            if cwd_path.exists():
+                                return cwd_path
+                            break  # Found cwd, stop searching
             except Exception:
                 pass
 
-            return None
+            # Return the best available path even if it doesn't exist locally.
+            # This allows importing sessions from other machines (e.g., SWEBench).
+            # Prefer cwd from JSONL as it's more accurate than path decoding.
+            if cwd_path is not None:
+                return cwd_path
+            return project_path
 
         except Exception:
             return None

realign/cli.py

@@ -819,18 +819,36 @@ def version():
 def dashboard(
     ctx: typer.Context,
     dev: bool = typer.Option(False, "--dev", help="Enable developer mode (shows Watcher and Worker tabs)"),
+    debug: bool = typer.Option(False, "--debug", help="Enable debug logging to ~/.aline/.logs/dashboard.log"),
 ):
     """Open the interactive TUI dashboard."""
+    import os
+    import traceback
+
+    # Set debug log level if requested
+    if debug:
+        os.environ["REALIGN_LOG_LEVEL"] = "DEBUG"
+
     from .dashboard.tmux_manager import bootstrap_dashboard_into_tmux
+    from .logging_config import setup_logger
+
+    # Initialize logger before dashboard
+    logger = setup_logger("realign.dashboard", "dashboard.log")
+    logger.info(f"Dashboard command invoked (dev={dev}, debug={debug})")
 
-    bootstrap_dashboard_into_tmux()
+    try:
+        bootstrap_dashboard_into_tmux()
 
-    from .dashboard.app import AlineDashboard
+        from .dashboard.app import AlineDashboard
 
-    # Use dev flag from this command or inherit from parent context
-    dev_mode = dev or (ctx.obj.get("dev", False) if ctx.obj else False)
-    dash = AlineDashboard(dev_mode=dev_mode)
-    dash.run()
+        # Use dev flag from this command or inherit from parent context
+        dev_mode = dev or (ctx.obj.get("dev", False) if ctx.obj else False)
+        dash = AlineDashboard(dev_mode=dev_mode)
+        dash.run()
+    except Exception as e:
+        logger.error(f"Dashboard crashed: {e}\n{traceback.format_exc()}")
+        # Re-raise so user sees the error
+        raise
 
 
 # Restore command group

realign/commands/init.py

@@ -18,10 +18,14 @@ console = Console()
 
 # tmux config template for Aline-managed dashboard sessions.
 # Stored at ~/.aline/tmux/tmux.conf and sourced by the dashboard tmux bootstrap.
+# Bump this version when the tmux config changes to trigger auto-update on `aline init`.
+_TMUX_CONFIG_VERSION = 2
+
+
 def _get_tmux_config() -> str:
     """Generate tmux config with Type-to-Exit bindings."""
-    conf = r"""# Aline tmux config
-#
+    conf = f"# Aline tmux config (v{_TMUX_CONFIG_VERSION})\n"
+    conf += r"""#
 # Goal: make mouse selection copy to the system clipboard (macOS Terminal friendly).
 # - Drag-select text with the mouse; when you release, it is copied to the clipboard.
 # - Paste anywhere with Cmd+V.
@@ -448,24 +452,46 @@ def _initialize_prompts_directory() -> None:
             file_path.write_text(content, encoding="utf-8")
 
 
+def _get_tmux_config_version(content: str) -> int:
+    """Extract version number from tmux config content. Returns 0 if not found."""
+    # Look for "# Aline tmux config (vN)" pattern
+    match = re.search(r"# Aline tmux config \(v(\d+)\)", content)
+    if match:
+        return int(match.group(1))
+    # Old configs without version marker are version 1
+    if "# Aline tmux config" in content:
+        return 1
+    return 0
+
+
 def _initialize_tmux_config() -> Path:
-    """Initialize ~/.aline/tmux/tmux.conf (best-effort, no overwrite)."""
+    """Initialize ~/.aline/tmux/tmux.conf with auto-update on version change."""
     tmux_conf_path = Path.home() / ".aline" / "tmux" / "tmux.conf"
     tmux_conf_path.parent.mkdir(parents=True, exist_ok=True)
+
     if not tmux_conf_path.exists():
         tmux_conf_path.write_text(_get_tmux_config(), encoding="utf-8")
         return tmux_conf_path
 
-    # Best-effort repair for older Aline-generated configs that used unquoted `#` keys.
-    # tmux parses `#` as a comment delimiter, turning `bind ... # ...` into `bind ...` (invalid).
+    # Check existing config
     try:
         existing = tmux_conf_path.read_text(encoding="utf-8")
     except Exception:
         return tmux_conf_path
 
+    # Only manage Aline-generated configs
     if "# Aline tmux config" not in existing:
         return tmux_conf_path
 
+    # Check version and update if outdated
+    existing_version = _get_tmux_config_version(existing)
+    if existing_version < _TMUX_CONFIG_VERSION:
+        # Auto-update to latest config
+        tmux_conf_path.write_text(_get_tmux_config(), encoding="utf-8")
+        return tmux_conf_path
+
+    # Best-effort repair for older Aline-generated configs that used unquoted `#` keys.
+    # tmux parses `#` as a comment delimiter, turning `bind ... # ...` into `bind ...` (invalid).
     repaired = existing
     repaired = _TMUX_CONF_REPAIR_TILDE_KEY_RE.sub(r"\1\\~\2\\~", repaired)
     repaired = _TMUX_CONF_REPAIR_KEY_NEEDS_QUOTE_RE.sub(r'\1"\2"\3"\2"', repaired)

realign/commands/search.py

@@ -528,6 +528,19 @@ def search_command(
 
             console.print(f"[dim]Found {', '.join(summary_parts)}.[/dim]")
 
+            # Check if any result count hits the limit - suggest increasing limit
+            hit_limit = (
+                event_count == limit
+                or turn_count == limit
+                or session_count == limit
+                or (type == "content" and len(results.get("content", [])) == limit)
+            )
+            if hit_limit:
+                console.print(
+                    f"[yellow]Results may be truncated (limit={limit}). "
+                    f"Use --limit N to see more results.[/yellow]"
+                )
+
         # === Original structured output for non-regex mode ===
         else:
             if type == "all":
@@ -624,6 +637,23 @@ def search_command(
                     "\n[dim]Tip: Use --verbose to see Markdown previews, or --no-regex for exact keyword match.[/dim]"
                 )
 
+                # Check if any result count hits the limit - suggest increasing limit
+                event_count = len(results.get("events", []))
+                turn_count = len(results.get("turns", []))
+                session_count = len(results.get("sessions", []))
+                content_count = len(results.get("content", []))
+                hit_limit = (
+                    event_count == limit
+                    or turn_count == limit
+                    or session_count == limit
+                    or content_count == limit
+                )
+                if hit_limit:
+                    console.print(
+                        f"[yellow]Results may be truncated (limit={limit}). "
+                        f"Use --limit N to see more results.[/yellow]"
+                    )
+
         return 0
 
     except Exception as e:

realign/dashboard/app.py

@@ -3,12 +3,14 @@
 import subprocess
 import sys
 import time
+import traceback
 from pathlib import Path
 
 from textual.app import App, ComposeResult
 from textual.binding import Binding
 from textual.widgets import Footer, TabbedContent, TabPane
 
+from ..logging_config import setup_logger
 from .widgets import (
     AlineHeader,
     WatcherPanel,
@@ -20,6 +22,9 @@ from .widgets import (
     TerminalPanel,
 )
 
+# Set up dashboard logger - logs to ~/.aline/.logs/dashboard.log
+logger = setup_logger("realign.dashboard", "dashboard.log")
+
 
 def _detect_system_dark_mode() -> bool:
     """Detect if the system is in dark mode.
@@ -77,28 +82,35 @@ class AlineDashboard(App):
         """
         super().__init__()
         self.dev_mode = dev_mode
+        logger.info(f"AlineDashboard initialized (dev_mode={dev_mode})")
 
     def compose(self) -> ComposeResult:
         """Compose the dashboard layout."""
-        yield AlineHeader()
-        tab_ids = self._tab_ids()
-        with TabbedContent(initial=tab_ids[0] if tab_ids else "terminal"):
-            with TabPane("Agents", id="terminal"):
-                yield TerminalPanel()
-            if self.dev_mode:
-                with TabPane("Watcher", id="watcher"):
-                    yield WatcherPanel()
-                with TabPane("Worker", id="worker"):
-                    yield WorkerPanel()
-            with TabPane("Contexts", id="sessions"):
-                yield SessionsTable()
-            with TabPane("Share", id="events"):
-                yield EventsTable()
-            with TabPane("Config", id="config"):
-                yield ConfigPanel()
-            with TabPane("Search", id="search"):
-                yield SearchPanel()
-        yield Footer()
+        logger.debug("compose() started")
+        try:
+            yield AlineHeader()
+            tab_ids = self._tab_ids()
+            with TabbedContent(initial=tab_ids[0] if tab_ids else "terminal"):
+                with TabPane("Agents", id="terminal"):
+                    yield TerminalPanel()
+                if self.dev_mode:
+                    with TabPane("Watcher", id="watcher"):
+                        yield WatcherPanel()
+                    with TabPane("Worker", id="worker"):
+                        yield WorkerPanel()
+                with TabPane("Contexts", id="sessions"):
+                    yield SessionsTable()
+                with TabPane("Share", id="events"):
+                    yield EventsTable()
+                with TabPane("Config", id="config"):
+                    yield ConfigPanel()
+                with TabPane("Search", id="search"):
+                    yield SearchPanel()
+            yield Footer()
+            logger.debug("compose() completed successfully")
+        except Exception as e:
+            logger.error(f"compose() failed: {e}\n{traceback.format_exc()}")
+            raise
 
     def _tab_ids(self) -> list[str]:
         if self.dev_mode:
@@ -107,10 +119,16 @@ class AlineDashboard(App):
 
     def on_mount(self) -> None:
         """Apply theme based on system settings and watch for changes."""
-        self._sync_theme()
-        # Check for system theme changes every 2 seconds
-        self.set_interval(2, self._sync_theme)
-        self._quit_confirm_deadline: float | None = None
+        logger.info("on_mount() started")
+        try:
+            self._sync_theme()
+            # Check for system theme changes every 2 seconds
+            self.set_interval(2, self._sync_theme)
+            self._quit_confirm_deadline: float | None = None
+            logger.info("on_mount() completed successfully")
+        except Exception as e:
+            logger.error(f"on_mount() failed: {e}\n{traceback.format_exc()}")
+            raise
 
     def _sync_theme(self) -> None:
         """Sync app theme with system theme."""
@@ -341,8 +359,14 @@ class AlineDashboard(App):
 
 def run_dashboard() -> None:
     """Run the Aline Dashboard."""
-    app = AlineDashboard()
-    app.run()
+    logger.info("Starting Aline Dashboard")
+    try:
+        app = AlineDashboard()
+        app.run()
+        logger.info("Aline Dashboard exited normally")
+    except Exception as e:
+        logger.error(f"Dashboard crashed: {e}\n{traceback.format_exc()}")
+        raise
 
 
 if __name__ == "__main__":

realign/dashboard/widgets/sessions_table.py

@@ -6,6 +6,7 @@ import json
 import os
 import shutil
 import subprocess
+import traceback
 from datetime import datetime
 from pathlib import Path
 from typing import List, Optional, Set
@@ -18,8 +19,11 @@ from textual.reactive import reactive
 from textual.worker import Worker, WorkerState
 from textual.widgets import Button, DataTable, Static
 
+from ...logging_config import setup_logger
 from .openable_table import OpenableDataTable
 
+logger = setup_logger("realign.dashboard.sessions", "dashboard.log")
+
 
 class SessionsListTable(OpenableDataTable):
     """Sessions list table with multi-select behavior."""
@@ -145,13 +149,19 @@ class SessionsTable(Container):
 
     def on_mount(self) -> None:
         """Set up the table on mount."""
-        table = self.query_one("#sessions-table", SessionsListTable)
-        table.owner = self
+        logger.debug("SessionsTable.on_mount() started")
+        try:
+            table = self.query_one("#sessions-table", SessionsListTable)
+            table.owner = self
 
-        self._setup_table_columns(table)
+            self._setup_table_columns(table)
 
-        # Calculate initial rows per page
-        self._calculate_rows_per_page()
+            # Calculate initial rows per page
+            self._calculate_rows_per_page()
+            logger.debug("SessionsTable.on_mount() completed")
+        except Exception as e:
+            logger.error(f"SessionsTable.on_mount() failed: {e}\n{traceback.format_exc()}")
+            raise
 
     def on_resize(self) -> None:
         """Handle window resize to adjust rows per page."""
@@ -793,6 +803,7 @@ class SessionsTable(Container):
                 }
 
                 # Get paginated sessions
+                # Use cached total_turns instead of subquery for performance
                 offset = (int(page) - 1) * int(rows_per_page)
                 rows = conn.execute(
                     """
@@ -802,7 +813,7 @@ class SessionsTable(Container):
                         s.workspace_path,
                         s.session_title,
                         s.last_activity_at,
-                        (SELECT COUNT(*) FROM turns WHERE session_id = s.id) AS turn_count
+                        s.total_turns
                     FROM sessions s
                     ORDER BY s.last_activity_at DESC
                     LIMIT ? OFFSET ?
@@ -847,7 +858,8 @@ class SessionsTable(Container):
                             "last_activity": activity_str,
                         }
                     )
-        except Exception:
+        except Exception as e:
+            logger.error(f"_collect_snapshot failed: {e}\n{traceback.format_exc()}")
             total_sessions = 0
             stats = {}
             sessions = []

realign/dashboard/widgets/terminal_panel.py

@@ -11,6 +11,7 @@ import asyncio
 import os
 import re
 import shlex
+import traceback
 from pathlib import Path
 from typing import Callable
 
@@ -21,6 +22,9 @@ from textual.widgets import Button, Static
 from rich.text import Text
 
 from .. import tmux_manager
+from ...logging_config import setup_logger
+
+logger = setup_logger("realign.dashboard.terminal", "dashboard.log")
 
 
 # Signal directory for permission request notifications
@@ -291,21 +295,27 @@ class TerminalPanel(Container, can_focus=True):
         self._signal_watcher: _SignalFileWatcher | None = None
 
     def compose(self) -> ComposeResult:
-        controls_enabled = self.supported()
-        with Horizontal(classes="summary"):
-            yield Button(
-                "＋ Create",
-                id="new-agent",
-                variant="primary",
-                disabled=not controls_enabled,
-            )
-        with Vertical(id="terminals", classes="list"):
-            if controls_enabled:
-                yield Static(
-                    "No terminals yet. Click 'Create' to open a new agent terminal."
+        logger.debug("TerminalPanel.compose() started")
+        try:
+            controls_enabled = self.supported()
+            with Horizontal(classes="summary"):
+                yield Button(
+                    "＋ Create",
+                    id="new-agent",
+                    variant="primary",
+                    disabled=not controls_enabled,
                 )
-            else:
-                yield Static(self._support_message())
+            with Vertical(id="terminals", classes="list"):
+                if controls_enabled:
+                    yield Static(
+                        "No terminals yet. Click 'Create' to open a new agent terminal."
+                    )
+                else:
+                    yield Static(self._support_message())
+            logger.debug("TerminalPanel.compose() completed")
+        except Exception as e:
+            logger.error(f"TerminalPanel.compose() failed: {e}\n{traceback.format_exc()}")
+            raise
 
     def on_show(self) -> None:
         # Don't `await refresh_data()` directly here: Textual may do an initial layout pass with