refactor: improve exception handling for better debuggability

- Include full traceback in engine crash events so errors are diagnosable
- Narrow primitives API base64 decoder to catch only expected exceptions
- Display traceback in console emitter when available

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

Author: 2 people

src/ralphify/_console_emitter.py

@@ -76,6 +76,9 @@ def _on_log_message(self, d: dict) -> None:
         level = d.get("level", "info")
         if level == "error":
             self._rprint(f"[red]{msg}[/red]")
+            tb = d.get("traceback")
+            if tb:
+                self._rprint(f"[dim]{tb}[/dim]")
         else:
             self._rprint(f"[dim]{msg}[/dim]")
 

src/ralphify/engine.py

@@ -10,6 +10,7 @@
 import subprocess
 import sys
 import time
+import traceback
 import threading
 from dataclasses import dataclass, field
 from datetime import datetime
@@ -491,10 +492,15 @@ def run_loop(
         pass
     except Exception as exc:
         state.status = RunStatus.FAILED
+        tb = traceback.format_exc()
         emitter.emit(Event(
             type=EventType.LOG_MESSAGE,
             run_id=state.run_id,
-            data={"message": f"Run crashed: {exc}", "level": "error"},
+            data={
+                "message": f"Run crashed: {exc}",
+                "level": "error",
+                "traceback": tb,
+            },
         ))
 
     if state.status == RunStatus.RUNNING:

src/ralphify/ui/api/primitives.py

@@ -36,7 +36,7 @@ def _decode_project_dir(encoded: str) -> Path:
     """Decode a base64-encoded project directory path."""
     try:
         return Path(base64.urlsafe_b64decode(encoded).decode())
-    except Exception:
+    except (ValueError, UnicodeDecodeError):
         raise HTTPException(status_code=400, detail="Invalid base64 project_dir")