aline-ai 0.5.3__py3-none-any.whl → 0.5.5__py3-none-any.whl

realign/adapters/gemini.py

@@ -14,18 +14,18 @@ from ..triggers.gemini_trigger import GeminiTrigger
 
 class GeminiAdapter(SessionAdapter):
     """Adapter for Gemini CLI sessions."""
-    
+
     name = "gemini"
     trigger_class = GeminiTrigger
-    
+
     def discover_sessions(self) -> List[Path]:
         """Find all active Gemini CLI sessions."""
         sessions = []
         gemini_tmp = Path.home() / ".gemini" / "tmp"
-        
+
         if not gemini_tmp.exists():
             return sessions
-            
+
         try:
             for project_dir in gemini_tmp.iterdir():
                 if project_dir.is_dir():
@@ -34,13 +34,13 @@ class GeminiAdapter(SessionAdapter):
                         sessions.extend(chats_dir.glob("session-*.json"))
         except Exception:
             pass
-            
+
         return sessions
-    
+
     def discover_sessions_for_project(self, project_path: Path) -> List[Path]:
         """
         Find sessions for a specific project.
-        
+
         For Gemini CLI, project directories are hashed, so it's easier to scan all
         and check the encoded project path or project hash if we knew it.
         Actually GeminiTrigger might have some logic for this.
@@ -49,18 +49,18 @@ class GeminiAdapter(SessionAdapter):
         all_sessions = self.discover_sessions()
         matching = []
         abs_project = str(project_path.resolve())
-        
+
         for s in all_sessions:
             path = self.extract_project_path(s)
             if path and str(path.resolve()) == abs_project:
                 matching.append(s)
-                
+
         return matching
 
     def extract_project_path(self, session_file: Path) -> Optional[Path]:
         """
         Extract project path from Gemini session file.
-        
+
         Gemini CLI JSON files usually don't have the full path, but they might
         have a projectHash. Wait, let me check the GeminiTrigger logic again.
         """
@@ -72,5 +72,5 @@ class GeminiAdapter(SessionAdapter):
         """Check if this is a Gemini session file."""
         if not session_file.name.startswith("session-") or not session_file.name.endswith(".json"):
             return False
-            
+
         return super().is_session_valid(session_file)

realign/adapters/registry.py

@@ -22,7 +22,7 @@ class AdapterRegistry:
     def register(self, adapter_class: Type[SessionAdapter]):
         """
         Register an adapter class.
-        
+
         Args:
             adapter_class: The adapter class (not instance)
         """
@@ -34,11 +34,11 @@ class AdapterRegistry:
     def get_adapter(self, name: str, config: Optional[Dict] = None) -> Optional[SessionAdapter]:
         """
         Get an adapter instance by name.
-        
+
         Args:
             name: Adapter name
             config: Optional configuration
-            
+
         Returns:
             Adapter instance or None
         """
@@ -51,13 +51,15 @@ class AdapterRegistry:
         """List all registered adapter names."""
         return list(self._adapters.keys())
 
-    def discover_all_sessions(self, config: Optional[Dict] = None) -> List[Tuple[Path, SessionAdapter]]:
+    def discover_all_sessions(
+        self, config: Optional[Dict] = None
+    ) -> List[Tuple[Path, SessionAdapter]]:
         """
         Discover sessions from all registered adapters.
-        
+
         Args:
             config: Optional configuration (passed to adapters)
-            
+
         Returns:
             List of (session_path, adapter_instance) tuples
         """
@@ -72,17 +74,19 @@ class AdapterRegistry:
                     all_sessions.append((session_path, adapter))
             except Exception as e:
                 logger.warning(f"Error discovering sessions for adapter {name}: {e}")
-        
+
         return all_sessions
 
-    def auto_detect_adapter(self, session_file: Path, config: Optional[Dict] = None) -> Optional[SessionAdapter]:
+    def auto_detect_adapter(
+        self, session_file: Path, config: Optional[Dict] = None
+    ) -> Optional[SessionAdapter]:
         """
         Detect which adapter should handle a given session file.
-        
+
         Args:
             session_file: Path to the session file
             config: Optional configuration
-            
+
         Returns:
             Matching Adapter instance or None
         """

realign/claude_detector.py

@@ -25,10 +25,10 @@ def get_claude_project_name(project_path: Path) -> str:
     # Remove leading '/' and replace all '/' and '_' with '-'
     # Claude Code replaces both slashes and underscores with dashes
     path_str = str(abs_path)
-    if path_str.startswith('/'):
+    if path_str.startswith("/"):
         path_str = path_str[1:]
 
-    return '-' + path_str.replace('/', '-').replace('_', '-')
+    return "-" + path_str.replace("/", "-").replace("_", "-")
 
 
 def find_claude_sessions_dir(project_path: Path) -> Optional[Path]:

realign/claude_hooks/__init__.py

@@ -10,7 +10,7 @@ This module contains hooks for integration with AI coding assistants:
 from pathlib import Path
 
 # Signal directory for inter-process communication
-SIGNAL_DIR = Path.home() / '.aline' / '.signals'
+SIGNAL_DIR = Path.home() / ".aline" / ".signals"
 
 
 def get_signal_dir() -> Path:
@@ -20,6 +20,6 @@ def get_signal_dir() -> Path:
 
 
 __all__ = [
-    'SIGNAL_DIR',
-    'get_signal_dir',
+    "SIGNAL_DIR",
+    "get_signal_dir",
 ]

realign/claude_hooks/permission_request_hook.py

@@ -25,7 +25,37 @@ stdin JSON format:
 import os
 import sys
 import json
+import time
 import subprocess
+from pathlib import Path
+
+
+def get_signal_dir() -> Path:
+    """Get the signal directory for permission requests."""
+    signal_dir = Path.home() / ".aline" / ".signals" / "permission_request"
+    signal_dir.mkdir(parents=True, exist_ok=True)
+    return signal_dir
+
+
+def write_signal_file(terminal_id: str, tool_name: str = "") -> None:
+    """Write a signal file to notify the dashboard of a permission request."""
+    try:
+        signal_dir = get_signal_dir()
+        timestamp_ms = int(time.time() * 1000)
+        signal_file = signal_dir / f"{terminal_id}_{timestamp_ms}.signal"
+        tmp_file = signal_dir / f"{terminal_id}_{timestamp_ms}.signal.tmp"
+
+        signal_data = {
+            "terminal_id": terminal_id,
+            "tool_name": tool_name,
+            "timestamp": time.time(),
+            "hook_event": "PermissionRequest",
+        }
+
+        tmp_file.write_text(json.dumps(signal_data, indent=2))
+        tmp_file.replace(signal_file)
+    except Exception:
+        pass  # Best effort
 
 
 def main():
@@ -142,6 +172,11 @@ def main():
         except Exception:
             pass
 
+        # Write signal file to notify dashboard (triggers file watcher refresh)
+        if terminal_id:
+            tool_name = data.get("tool_name", "")
+            write_signal_file(terminal_id, tool_name)
+
         # Exit 0 - don't block the permission request
         sys.exit(0)
 

realign/claude_hooks/permission_request_hook_installer.py

@@ -12,7 +12,7 @@ from typing import Optional
 
 from ..logging_config import setup_logger
 
-logger = setup_logger('realign.hooks.permission_request_installer', 'hooks_installer.log')
+logger = setup_logger("realign.hooks.permission_request_installer", "hooks_installer.log")
 
 # Marker to identify Aline hook for later uninstallation
 ALINE_HOOK_MARKER = "aline-permission-request-hook"
@@ -20,7 +20,7 @@ ALINE_HOOK_MARKER = "aline-permission-request-hook"
 
 def get_permission_request_hook_script_path() -> Path:
     """Get path to permission_request_hook.py script"""
-    return Path(__file__).parent / 'permission_request_hook.py'
+    return Path(__file__).parent / "permission_request_hook.py"
 
 
 def get_permission_request_hook_command() -> str:
@@ -44,8 +44,8 @@ def get_settings_path(project_path: Optional[Path] = None) -> Path:
         Path to settings.json
     """
     if project_path:
-        return project_path / '.claude' / 'settings.local.json'
-    return Path.home() / '.claude' / 'settings.json'
+        return project_path / ".claude" / "settings.local.json"
+    return Path.home() / ".claude" / "settings.json"
 
 
 def is_hook_installed(settings_path: Path) -> bool:
@@ -63,13 +63,13 @@ def is_hook_installed(settings_path: Path) -> bool:
 
     try:
         settings = json.loads(settings_path.read_text())
-        permission_hooks = settings.get('hooks', {}).get('PermissionRequest', [])
+        permission_hooks = settings.get("hooks", {}).get("PermissionRequest", [])
 
         for hook_config in permission_hooks:
-            hooks_list = hook_config.get('hooks', [])
+            hooks_list = hook_config.get("hooks", [])
             for h in hooks_list:
-                command = h.get('command', '')
-                if ALINE_HOOK_MARKER in command or 'permission_request_hook' in command:
+                command = h.get("command", "")
+                if ALINE_HOOK_MARKER in command or "permission_request_hook" in command:
                     return True
 
         return False
@@ -115,37 +115,35 @@ def install_permission_request_hook(
                 settings = {}
 
         # Ensure hooks structure exists
-        if 'hooks' not in settings:
-            settings['hooks'] = {}
-        if 'PermissionRequest' not in settings['hooks']:
-            settings['hooks']['PermissionRequest'] = []
+        if "hooks" not in settings:
+            settings["hooks"] = {}
+        if "PermissionRequest" not in settings["hooks"]:
+            settings["hooks"]["PermissionRequest"] = []
 
         # If force install, remove old Aline hook first
         if force:
-            permission_hooks = settings['hooks']['PermissionRequest']
+            permission_hooks = settings["hooks"]["PermissionRequest"]
             new_hooks = []
             for hook_config in permission_hooks:
-                hooks_list = hook_config.get('hooks', [])
+                hooks_list = hook_config.get("hooks", [])
                 filtered = [
-                    h for h in hooks_list
-                    if ALINE_HOOK_MARKER not in h.get('command', '')
-                    and 'permission_request_hook' not in h.get('command', '')
+                    h
+                    for h in hooks_list
+                    if ALINE_HOOK_MARKER not in h.get("command", "")
+                    and "permission_request_hook" not in h.get("command", "")
                 ]
                 if filtered:
-                    hook_config['hooks'] = filtered
+                    hook_config["hooks"] = filtered
                     new_hooks.append(hook_config)
-            settings['hooks']['PermissionRequest'] = new_hooks
+            settings["hooks"]["PermissionRequest"] = new_hooks
 
         # Append Aline hook with matcher for all tools
         hook_command = get_permission_request_hook_command()
         aline_hook = {
-            'matcher': '*',  # Match all tools
-            'hooks': [{
-                'type': 'command',
-                'command': f'{hook_command}  # {ALINE_HOOK_MARKER}'
-            }]
+            "matcher": "*",  # Match all tools
+            "hooks": [{"type": "command", "command": f"{hook_command}  # {ALINE_HOOK_MARKER}"}],
         }
-        settings['hooks']['PermissionRequest'].append(aline_hook)
+        settings["hooks"]["PermissionRequest"].append(aline_hook)
 
         # Write back settings
         settings_path.parent.mkdir(parents=True, exist_ok=True)
@@ -186,26 +184,27 @@ def uninstall_permission_request_hook(
             return True
 
         settings = json.loads(settings_path.read_text())
-        permission_hooks = settings.get('hooks', {}).get('PermissionRequest', [])
+        permission_hooks = settings.get("hooks", {}).get("PermissionRequest", [])
 
         # Filter out Aline hook
         new_hooks = []
         removed = False
         for hook_config in permission_hooks:
-            hooks_list = hook_config.get('hooks', [])
+            hooks_list = hook_config.get("hooks", [])
             filtered = [
-                h for h in hooks_list
-                if ALINE_HOOK_MARKER not in h.get('command', '')
-                and 'permission_request_hook' not in h.get('command', '')
+                h
+                for h in hooks_list
+                if ALINE_HOOK_MARKER not in h.get("command", "")
+                and "permission_request_hook" not in h.get("command", "")
             ]
             if len(filtered) < len(hooks_list):
                 removed = True
             if filtered:
-                hook_config['hooks'] = filtered
+                hook_config["hooks"] = filtered
                 new_hooks.append(hook_config)
 
         if removed:
-            settings['hooks']['PermissionRequest'] = new_hooks
+            settings["hooks"]["PermissionRequest"] = new_hooks
             settings_path.write_text(json.dumps(settings, indent=2))
             logger.info("Aline PermissionRequest hook uninstalled")
             if not quiet:

realign/claude_hooks/stop_hook.py

@@ -54,7 +54,10 @@ def main():
         session = data.get("session") or {}
         session_id = session.get("id") or data.get("session_id") or data.get("sessionId") or ""
         transcript_path = (
-            session.get("transcript_path") or data.get("transcript_path") or data.get("transcriptPath") or ""
+            session.get("transcript_path")
+            or data.get("transcript_path")
+            or data.get("transcriptPath")
+            or ""
         )
         cwd = data.get("cwd") or ""
 

realign/claude_hooks/stop_hook_installer.py

@@ -12,7 +12,7 @@ from typing import Optional
 
 from ..logging_config import setup_logger
 
-logger = setup_logger('realign.hooks.installer', 'hooks_installer.log')
+logger = setup_logger("realign.hooks.installer", "hooks_installer.log")
 
 # 用于标识 Aline hook 的标记，方便后续识别和卸载
 ALINE_HOOK_MARKER = "aline-stop-hook"
@@ -21,7 +21,7 @@ ALINE_HOOK_MARKER = "aline-stop-hook"
 def get_stop_hook_script_path() -> Path:
     """获取 stop_hook.py 脚本的路径"""
     # 脚本与此文件在同一目录
-    return Path(__file__).parent / 'stop_hook.py'
+    return Path(__file__).parent / "stop_hook.py"
 
 
 def get_stop_hook_command() -> str:
@@ -45,8 +45,8 @@ def get_settings_path(project_path: Optional[Path] = None) -> Path:
         settings.json 的路径
     """
     if project_path:
-        return project_path / '.claude' / 'settings.local.json'
-    return Path.home() / '.claude' / 'settings.json'
+        return project_path / ".claude" / "settings.local.json"
+    return Path.home() / ".claude" / "settings.json"
 
 
 def is_hook_installed(settings_path: Path) -> bool:
@@ -64,13 +64,13 @@ def is_hook_installed(settings_path: Path) -> bool:
 
     try:
         settings = json.loads(settings_path.read_text())
-        stop_hooks = settings.get('hooks', {}).get('Stop', [])
+        stop_hooks = settings.get("hooks", {}).get("Stop", [])
 
         for hook_config in stop_hooks:
-            hooks_list = hook_config.get('hooks', [])
+            hooks_list = hook_config.get("hooks", [])
             for h in hooks_list:
-                command = h.get('command', '')
-                if ALINE_HOOK_MARKER in command or 'realign.hooks.stop_hook' in command:
+                command = h.get("command", "")
+                if ALINE_HOOK_MARKER in command or "realign.hooks.stop_hook" in command:
                     return True
 
         return False
@@ -116,36 +116,34 @@ def install_stop_hook(
                 settings = {}
 
         # 确保 hooks 结构存在
-        if 'hooks' not in settings:
-            settings['hooks'] = {}
-        if 'Stop' not in settings['hooks']:
-            settings['hooks']['Stop'] = []
+        if "hooks" not in settings:
+            settings["hooks"] = {}
+        if "Stop" not in settings["hooks"]:
+            settings["hooks"]["Stop"] = []
 
         # 如果强制安装，先移除旧的 Aline hook
         if force:
-            stop_hooks = settings['hooks']['Stop']
+            stop_hooks = settings["hooks"]["Stop"]
             new_hooks = []
             for hook_config in stop_hooks:
-                hooks_list = hook_config.get('hooks', [])
+                hooks_list = hook_config.get("hooks", [])
                 filtered = [
-                    h for h in hooks_list
-                    if ALINE_HOOK_MARKER not in h.get('command', '')
-                    and 'realign.hooks.stop_hook' not in h.get('command', '')
+                    h
+                    for h in hooks_list
+                    if ALINE_HOOK_MARKER not in h.get("command", "")
+                    and "realign.hooks.stop_hook" not in h.get("command", "")
                 ]
                 if filtered:
-                    hook_config['hooks'] = filtered
+                    hook_config["hooks"] = filtered
                     new_hooks.append(hook_config)
-            settings['hooks']['Stop'] = new_hooks
+            settings["hooks"]["Stop"] = new_hooks
 
         # 追加 Aline hook
         hook_command = get_stop_hook_command()
         aline_hook = {
-            'hooks': [{
-                'type': 'command',
-                'command': f'{hook_command}  # {ALINE_HOOK_MARKER}'
-            }]
+            "hooks": [{"type": "command", "command": f"{hook_command}  # {ALINE_HOOK_MARKER}"}]
         }
-        settings['hooks']['Stop'].append(aline_hook)
+        settings["hooks"]["Stop"].append(aline_hook)
 
         # 写回设置
         settings_path.parent.mkdir(parents=True, exist_ok=True)
@@ -186,26 +184,27 @@ def uninstall_stop_hook(
             return True
 
         settings = json.loads(settings_path.read_text())
-        stop_hooks = settings.get('hooks', {}).get('Stop', [])
+        stop_hooks = settings.get("hooks", {}).get("Stop", [])
 
         # 过滤掉 Aline hook
         new_hooks = []
         removed = False
         for hook_config in stop_hooks:
-            hooks_list = hook_config.get('hooks', [])
+            hooks_list = hook_config.get("hooks", [])
             filtered = [
-                h for h in hooks_list
-                if ALINE_HOOK_MARKER not in h.get('command', '')
-                and 'realign.hooks.stop_hook' not in h.get('command', '')
+                h
+                for h in hooks_list
+                if ALINE_HOOK_MARKER not in h.get("command", "")
+                and "realign.hooks.stop_hook" not in h.get("command", "")
             ]
             if len(filtered) < len(hooks_list):
                 removed = True
             if filtered:
-                hook_config['hooks'] = filtered
+                hook_config["hooks"] = filtered
                 new_hooks.append(hook_config)
 
         if removed:
-            settings['hooks']['Stop'] = new_hooks
+            settings["hooks"]["Stop"] = new_hooks
             settings_path.write_text(json.dumps(settings, indent=2))
             logger.info("Aline Stop hook uninstalled")
             if not quiet:

realign/cli.py

@@ -26,6 +26,13 @@ def main(ctx: typer.Context):
     Run 'aline' without arguments to open the interactive dashboard.
     """
     if ctx.invoked_subcommand is None:
+        # Check for updates before launching dashboard
+        from .commands.upgrade import check_and_prompt_update
+
+        if check_and_prompt_update():
+            # Update was performed, exit so user can restart with new version
+            raise typer.Exit(0)
+
         # Launch the dashboard when no subcommand is provided
         from .dashboard.tmux_manager import bootstrap_dashboard_into_tmux
 
@@ -157,6 +164,23 @@ def add_skills_cli(
     raise typer.Exit(code=exit_code)
 
 
+@add_app.command(name="skills-dev")
+def add_skills_dev_cli(
+    force: bool = typer.Option(False, "--force", "-f", help="Overwrite existing skills"),
+):
+    """Install developer skills from skill-dev/ directory.
+
+    Scans skill-dev/ for SKILL.md files and installs them to ~/.claude/skills/.
+    This is for developer use only.
+
+    Examples:
+        aline add skills-dev           # Install dev skills
+        aline add skills-dev --force   # Reinstall/update dev skills
+    """
+    exit_code = add.add_skills_dev_command(force=force)
+    raise typer.Exit(code=exit_code)
+
+
 @context_app.command(name="load")
 def context_load_cli(
     sessions: Optional[str] = typer.Option(

realign/codex_detector.py

@@ -7,10 +7,7 @@ from pathlib import Path
 from typing import Optional, List
 
 
-def find_codex_sessions_for_project(
-    project_path: Path,
-    days_back: int = 7
-) -> List[Path]:
+def find_codex_sessions_for_project(project_path: Path, days_back: int = 7) -> List[Path]:
     """
     Find Codex sessions for a given project path.
 
@@ -38,7 +35,12 @@ def find_codex_sessions_for_project(
     # Search through recent days
     for days_ago in range(days_back + 1):
         target_date = datetime.now() - timedelta(days=days_ago)
-        date_path = codex_sessions_base / str(target_date.year) / f"{target_date.month:02d}" / f"{target_date.day:02d}"
+        date_path = (
+            codex_sessions_base
+            / str(target_date.year)
+            / f"{target_date.month:02d}"
+            / f"{target_date.day:02d}"
+        )
 
         if not date_path.exists():
             continue
@@ -47,12 +49,12 @@ def find_codex_sessions_for_project(
         for session_file in date_path.glob("rollout-*.jsonl"):
             try:
                 # Read first line to get session metadata
-                with open(session_file, 'r', encoding='utf-8') as f:
+                with open(session_file, "r", encoding="utf-8") as f:
                     first_line = f.readline()
                     if first_line:
                         data = json.loads(first_line)
-                        if data.get('type') == 'session_meta':
-                            session_cwd = data.get('payload', {}).get('cwd', '')
+                        if data.get("type") == "session_meta":
+                            session_cwd = data.get("payload", {}).get("cwd", "")
                             # Match the project path
                             if session_cwd == abs_project_path:
                                 matching_sessions.append(session_file)
@@ -93,9 +95,7 @@ def get_codex_sessions_dir() -> Optional[Path]:
 
 
 def auto_detect_codex_sessions(
-    project_path: Path,
-    fallback_path: Optional[str] = None,
-    days_back: int = 7
+    project_path: Path, fallback_path: Optional[str] = None, days_back: int = 7
 ) -> Optional[Path]:
     """
     Auto-detect the most recent Codex session for a project.