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

realign/hooks.py

@@ -25,12 +25,13 @@ from .llm_client import call_llm, call_llm_json, extract_json
 
 try:
     from .redactor import check_and_redact_session, save_original_session
+
     REDACTOR_AVAILABLE = True
 except ImportError:
     REDACTOR_AVAILABLE = False
 
 # Initialize logger for hooks
-logger = setup_logger('realign.hooks', 'hooks.log')
+logger = setup_logger("realign.hooks", "hooks.log")
 
 DEFAULT_METADATA_PROMPT_TEXT = """You are a metadata classifier for AI-assisted git commits.
 Determine two fields for the current turn:
@@ -61,7 +62,9 @@ def get_last_llm_error() -> Optional[str]:
     return _last_llm_error
 
 
-def _emit_llm_debug(callback: Optional[Callable[[Dict[str, Any]], None]], payload: Dict[str, Any]) -> None:
+def _emit_llm_debug(
+    callback: Optional[Callable[[Dict[str, Any]], None]], payload: Dict[str, Any]
+) -> None:
     if not callback:
         return
     try:
@@ -133,7 +136,9 @@ def _normalize_if_last_task(raw_value: Any) -> str:
             return "yes"
         if lower in ("no", "false", "0", "new", "fresh"):
             return "no"
-        if any(keyword in lower for keyword in ["still", "again", "continue", "follow-up", "follow up"]):
+        if any(
+            keyword in lower for keyword in ["still", "again", "continue", "follow-up", "follow up"]
+        ):
             return "yes"
     return "no"
 
@@ -147,9 +152,39 @@ def _normalize_satisfaction(raw_value: Any) -> str:
         lower = raw_value.lower().strip()
         if lower in ("good", "fine", "bad"):
             return lower
-        positive = ["great", "perfect", "excellent", "works", "thanks", "done", "awesome", "success", "completed"]
-        negative = ["bad", "fail", "error", "broken", "didn't work", "not working", "no,", "no ", "still broken"]
-        mixed = ["but", "still", "however", "almost", "not quite", "partial", "some", "kinda", "kind of"]
+        positive = [
+            "great",
+            "perfect",
+            "excellent",
+            "works",
+            "thanks",
+            "done",
+            "awesome",
+            "success",
+            "completed",
+        ]
+        negative = [
+            "bad",
+            "fail",
+            "error",
+            "broken",
+            "didn't work",
+            "not working",
+            "no,",
+            "no ",
+            "still broken",
+        ]
+        mixed = [
+            "but",
+            "still",
+            "however",
+            "almost",
+            "not quite",
+            "partial",
+            "some",
+            "kinda",
+            "kind of",
+        ]
         if any(keyword in lower for keyword in positive):
             return "good"
         if any(keyword in lower for keyword in negative):
@@ -198,10 +233,17 @@ def _classify_task_metadata(
                     logger.debug(f"Loaded user-customized metadata prompt from {user_prompt_path}")
                     return text
         except Exception:
-            logger.debug("Failed to load user-customized metadata prompt, falling back", exc_info=True)
+            logger.debug(
+                "Failed to load user-customized metadata prompt, falling back", exc_info=True
+            )
 
         # Fall back to built-in prompt (tools/commit_message_prompts/metadata_default.md)
-        candidate = Path(__file__).resolve().parents[2] / "tools" / "commit_message_prompts" / "metadata_default.md"
+        candidate = (
+            Path(__file__).resolve().parents[2]
+            / "tools"
+            / "commit_message_prompts"
+            / "metadata_default.md"
+        )
         try:
             text = candidate.read_text(encoding="utf-8").strip()
             if text:
@@ -270,6 +312,7 @@ def _classify_task_metadata(
 # Message Cleaning Utilities
 # ============================================================================
 
+
 def clean_user_message(text: str) -> str:
     """
     Clean user message by removing IDE context tags and other system noise.
@@ -298,16 +341,18 @@ def clean_user_message(text: str) -> str:
         return ""
 
     # Remove IDE opened file tags
-    text = re.sub(r'<ide_opened_file>.*?</ide_opened_file>\s*', '', text, flags=re.DOTALL)
+    text = re.sub(r"<ide_opened_file>.*?</ide_opened_file>\s*", "", text, flags=re.DOTALL)
 
     # Remove IDE selection tags
-    text = re.sub(r'<ide_selection>.*?</ide_selection>\s*', '', text, flags=re.DOTALL)
+    text = re.sub(r"<ide_selection>.*?</ide_selection>\s*", "", text, flags=re.DOTALL)
 
     # Remove other common system tags if needed
     # text = re.sub(r'<system_context>.*?</system_context>\s*', '', text, flags=re.DOTALL)
 
     # Clean up extra whitespace
-    text = re.sub(r'\n\s*\n\s*\n+', '\n\n', text)  # Replace multiple blank lines with double newline
+    text = re.sub(
+        r"\n\s*\n\s*\n+", "\n\n", text
+    )  # Replace multiple blank lines with double newline
     text = text.strip()
 
     return text
@@ -356,7 +401,9 @@ def get_new_content_from_git_diff(repo_root: Path, session_relpath: str) -> str:
                 new_lines.append(line[1:])
 
         content = "\n".join(new_lines)
-        logger.info(f"Extracted {len(new_lines)} new lines ({len(content)} bytes) from {session_relpath}")
+        logger.info(
+            f"Extracted {len(new_lines)} new lines ({len(content)} bytes) from {session_relpath}"
+        )
         return content
 
     except subprocess.TimeoutExpired:
@@ -377,6 +424,7 @@ def get_claude_project_name(project_path: Path) -> str:
     For example: /Users/alice/Projects/MyApp -> -Users-alice-Projects-MyApp
     """
     from .claude_detector import get_claude_project_name as _get_name
+
     return _get_name(project_path)
 
 
@@ -413,7 +461,12 @@ def find_codex_latest_session(project_path: Path, days_back: int = 7) -> Optiona
     # 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
@@ -422,12 +475,12 @@ def find_codex_latest_session(project_path: Path, days_back: int = 7) -> Optiona
         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)
@@ -440,7 +493,9 @@ def find_codex_latest_session(project_path: Path, days_back: int = 7) -> Optiona
     matching_sessions.sort(key=lambda p: p.stat().st_mtime, reverse=True)
 
     if matching_sessions:
-        logger.info(f"Found {len(matching_sessions)} Codex session(s), using latest: {matching_sessions[0]}")
+        logger.info(
+            f"Found {len(matching_sessions)} Codex session(s), using latest: {matching_sessions[0]}"
+        )
     else:
         logger.debug("No matching Codex sessions found")
 
@@ -450,7 +505,7 @@ def find_codex_latest_session(project_path: Path, days_back: int = 7) -> Optiona
 def find_all_claude_sessions() -> List[Path]:
     """
     Find all active Claude Code sessions from ALL projects.
-    
+
     (Legacy wrapper for ClaudeAdapter)
     """
     adapter = get_adapter_registry().get_adapter("claude")
@@ -475,7 +530,7 @@ def find_all_codex_sessions(days_back: int = 1) -> List[Path]:
 def find_all_antigravity_sessions() -> List[Path]:
     """
     Find all active Antigravity IDE sessions.
-    
+
     (Legacy wrapper for AntigravityAdapter)
     """
     adapter = get_adapter_registry().get_adapter("antigravity")
@@ -487,7 +542,7 @@ def find_all_antigravity_sessions() -> List[Path]:
 def find_all_gemini_cli_sessions() -> List[Path]:
     """
     Find all active Gemini CLI sessions.
-    
+
     (Legacy wrapper for GeminiAdapter)
     """
     adapter = get_adapter_registry().get_adapter("gemini")
@@ -497,35 +552,40 @@ def find_all_gemini_cli_sessions() -> List[Path]:
 
 
 def find_all_active_sessions(
-    config: ReAlignConfig,
-    project_path: Optional[Path] = None
+    config: ReAlignConfig, project_path: Optional[Path] = None
 ) -> List[Path]:
     """
     Find all active session files based on enabled auto-detection options.
-    
+
     Uses current adapter-based architecture.
     """
     logger.info("Searching for active AI sessions")
-    logger.debug(f"Config: auto_detect_codex={config.auto_detect_codex}, auto_detect_claude={config.auto_detect_claude}")
+    logger.debug(
+        f"Config: auto_detect_codex={config.auto_detect_codex}, auto_detect_claude={config.auto_detect_claude}"
+    )
     logger.debug(f"Project path: {project_path}")
 
     sessions = []
 
     # 1. Use AdapterRegistry for discovery
     registry = get_adapter_registry()
-    
+
     # Map config options to adapter names
     enabled_adapters = []
-    if config.auto_detect_claude: enabled_adapters.append("claude")
-    if config.auto_detect_codex: enabled_adapters.append("codex")
-    if config.auto_detect_gemini: enabled_adapters.append("gemini")
-    if config.auto_detect_antigravity: enabled_adapters.append("antigravity")
+    if config.auto_detect_claude:
+        enabled_adapters.append("claude")
+    if config.auto_detect_codex:
+        enabled_adapters.append("codex")
+    if config.auto_detect_gemini:
+        enabled_adapters.append("gemini")
+    if config.auto_detect_antigravity:
+        enabled_adapters.append("antigravity")
 
     for name in enabled_adapters:
         adapter = registry.get_adapter(name)
         if not adapter:
             continue
-            
+
         try:
             if project_path:
                 # Single-project mode
@@ -564,7 +624,9 @@ def find_latest_session(history_path: Path, explicit_path: Optional[str] = None)
         return None
 
     # Expand user path
-    history_path = Path(os.path.expanduser(history_path)) if isinstance(history_path, str) else history_path
+    history_path = (
+        Path(os.path.expanduser(history_path)) if isinstance(history_path, str) else history_path
+    )
 
     if not history_path.exists():
         return None
@@ -634,13 +696,14 @@ def _parse_antigravity_sections(content: str) -> Dict[str, str]:
 
     # Split by section markers
     import re
-    pattern = r'--- (task\.md|walkthrough\.md|implementation_plan\.md) ---\n?'
+
+    pattern = r"--- (task\.md|walkthrough\.md|implementation_plan\.md) ---\n?"
     parts = re.split(pattern, content)
 
     # parts will be: ['', 'task.md', '<content>', 'walkthrough.md', '<content>', ...]
     i = 1
     while i < len(parts) - 1:
-        filename = parts[i].replace('.md', '')
+        filename = parts[i].replace(".md", "")
         section_content = parts[i + 1].strip()
         if section_content:
             sections[filename] = section_content
@@ -717,7 +780,12 @@ def _generate_antigravity_summary(
         if _COMMIT_MESSAGE_PROMPT_CACHE is not None:
             system_prompt_to_use = _COMMIT_MESSAGE_PROMPT_CACHE
         else:
-            candidate = Path(__file__).resolve().parents[2] / "tools" / "commit_message_prompts" / "default.md"
+            candidate = (
+                Path(__file__).resolve().parents[2]
+                / "tools"
+                / "commit_message_prompts"
+                / "default.md"
+            )
             try:
                 text = candidate.read_text(encoding="utf-8").strip()
                 if text:
@@ -871,12 +939,18 @@ def filter_session_content(content: str) -> Tuple[str, str, str]:
                                 # Extract code changes from tool results
                                 elif item.get("type") == "tool_result":
                                     tool_use_result = obj.get("toolUseResult", {})
-                                    if "oldString" in tool_use_result and "newString" in tool_use_result:
+                                    if (
+                                        "oldString" in tool_use_result
+                                        and "newString" in tool_use_result
+                                    ):
                                         # This is an Edit operation
                                         new_string = tool_use_result.get("newString", "")
                                         if new_string:
                                             code_changes.append(f"Edit: {new_string[:300]}")
-                                    elif "content" in tool_use_result and "filePath" in tool_use_result:
+                                    elif (
+                                        "content" in tool_use_result
+                                        and "filePath" in tool_use_result
+                                    ):
                                         # This is a Write operation
                                         new_content = tool_use_result.get("content", "")
                                         if new_content:
@@ -938,7 +1012,10 @@ def filter_session_content(content: str) -> Tuple[str, str, str]:
                         content_list = payload.get("content", [])
                         if isinstance(content_list, list):
                             for content_item in content_list:
-                                if isinstance(content_item, dict) and content_item.get("type") == "input_text":
+                                if (
+                                    isinstance(content_item, dict)
+                                    and content_item.get("type") == "input_text"
+                                ):
                                     text = content_item.get("text", "").strip()
                                     if text:
                                         user_messages.append(text)
@@ -1105,13 +1182,19 @@ def generate_summary_with_llm(
                 text = user_prompt_path.read_text(encoding="utf-8").strip()
                 if text:
                     _COMMIT_MESSAGE_PROMPT_CACHE = text
-                    logger.debug(f"Loaded user-customized commit message prompt from {user_prompt_path}")
+                    logger.debug(
+                        f"Loaded user-customized commit message prompt from {user_prompt_path}"
+                    )
                     return text
         except Exception:
-            logger.debug("Failed to load user-customized commit message prompt, falling back", exc_info=True)
+            logger.debug(
+                "Failed to load user-customized commit message prompt, falling back", exc_info=True
+            )
 
         # Fall back to built-in prompt (tools/commit_message_prompts/default.md)
-        candidate = Path(__file__).resolve().parents[2] / "tools" / "commit_message_prompts" / "default.md"
+        candidate = (
+            Path(__file__).resolve().parents[2] / "tools" / "commit_message_prompts" / "default.md"
+        )
         try:
             text = candidate.read_text(encoding="utf-8").strip()
             if text:
@@ -1201,6 +1284,7 @@ Respond with JSON only."""
 
         # Try to extract partial information from the broken JSON
         import re
+
         record_match = re.search(r'"(?:record|title)"\s*:\s*"([^"]{10,})"', response_text)
         extracted_content = record_match.group(1)[:80] if record_match else None
 
@@ -1223,7 +1307,11 @@ Respond with JSON only."""
             error_detail += f"\n\nPartial content extracted: {extracted_content}..."
 
         # Add response preview for debugging
-        response_preview = response_text[:200].replace('\n', '\\n') if len(response_text) > 200 else response_text.replace('\n', '\\n')
+        response_preview = (
+            response_text[:200].replace("\n", "\\n")
+            if len(response_text) > 200
+            else response_text.replace("\n", "\\n")
+        )
         error_detail += f"\n\nResponse preview: {response_preview}"
         if len(response_text) > 200:
             error_detail += "..."
@@ -1297,7 +1385,7 @@ def extract_codex_rollout_hash(filename: str) -> Optional[str]:
     # Normalize filename (strip extension) and remove prefix
     stem = Path(filename).stem
     if stem.startswith("rollout-"):
-        stem = stem[len("rollout-"):]
+        stem = stem[len("rollout-") :]
 
     if not stem:
         return None
@@ -1384,10 +1472,7 @@ def get_username(session_relpath: str = "") -> str:
 
 
 def copy_session_to_repo(
-    session_file: Path,
-    repo_root: Path,
-    user: str,
-    config: Optional[ReAlignConfig] = None
+    session_file: Path, repo_root: Path, user: str, config: Optional[ReAlignConfig] = None
 ) -> Tuple[Path, str, bool, int]:
     """
     Copy session file to repository sessions/ directory (in ~/.aline/{project_name}/).
@@ -1400,6 +1485,7 @@ def copy_session_to_repo(
     logger.debug(f"Source: {session_file}, Repo root: {repo_root}, User: {user}")
 
     from realign import get_realign_dir
+
     realign_dir = get_realign_dir(repo_root)
     sessions_dir = realign_dir / "sessions"
     sessions_dir.mkdir(parents=True, exist_ok=True)
@@ -1410,16 +1496,14 @@ def copy_session_to_repo(
     # UUID format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.jsonl
     stem = session_file.stem  # filename without extension
     is_uuid_format = (
-        '-' in stem and
-        '_' not in stem and
-        len(stem) == 36  # UUID is 36 chars including hyphens
+        "-" in stem and "_" not in stem and len(stem) == 36  # UUID is 36 chars including hyphens
     )
     # Codex rollout exports always start with rollout-<timestamp>-
     is_codex_rollout = original_filename.startswith("rollout-")
 
     # Read session content first to detect agent type
     try:
-        with open(session_file, 'r', encoding='utf-8') as f:
+        with open(session_file, "r", encoding="utf-8") as f:
             content = f.read()
         logger.debug(f"Session file read: {len(content)} bytes")
     except Exception as e:
@@ -1427,7 +1511,7 @@ def copy_session_to_repo(
         print(f"Warning: Could not read session file: {e}", file=sys.stderr)
         # Fallback to simple copy with unknown agent
         if is_uuid_format:
-            short_id = stem.split('-')[0]
+            short_id = stem.split("-")[0]
             user_short = user.split()[0].lower() if user else "unknown"
             new_filename = f"{user_short}_unknown_{short_id}.jsonl"
             dest_path = sessions_dir / new_filename
@@ -1462,7 +1546,8 @@ def copy_session_to_repo(
     agent_type = "unknown"
     try:
         import json
-        for line in content.split('\n')[:10]:  # Check first 10 lines
+
+        for line in content.split("\n")[:10]:  # Check first 10 lines
             if not line.strip():
                 continue
             try:
@@ -1489,7 +1574,7 @@ def copy_session_to_repo(
     # If it's UUID format, rename to include username and agent type
     if is_uuid_format:
         # Extract short ID from UUID (first 8 chars)
-        short_id = stem.split('-')[0]
+        short_id = stem.split("-")[0]
         user_short = user.split()[0].lower() if user else "unknown"
         # Format: username_agent_shortid.jsonl (no timestamp for consistency)
         new_filename = f"{user_short}_{agent_type}_{short_id}.jsonl"
@@ -1526,8 +1611,7 @@ def copy_session_to_repo(
 
         # Perform redaction
         redacted_content, has_secrets, secrets = check_and_redact_session(
-            content,
-            redact_mode="auto"
+            content, redact_mode="auto"
         )
 
         if has_secrets:
@@ -1544,7 +1628,7 @@ def copy_session_to_repo(
     # Write content to destination (redacted or original)
     temp_path = dest_path.with_suffix(".tmp")
     try:
-        with open(temp_path, 'w', encoding='utf-8') as f:
+        with open(temp_path, "w", encoding="utf-8") as f:
             f.write(content)
         temp_path.rename(dest_path)
         try:
@@ -1580,6 +1664,7 @@ def save_session_metadata(repo_root: Path, session_relpath: str, content_size: i
         content_size: Size of session content when processed
     """
     from realign import get_realign_dir
+
     realign_dir = get_realign_dir(repo_root)
     metadata_dir = realign_dir / ".metadata"
     metadata_dir.mkdir(parents=True, exist_ok=True)
@@ -1595,7 +1680,7 @@ def save_session_metadata(repo_root: Path, session_relpath: str, content_size: i
     }
 
     try:
-        with open(metadata_file, 'w', encoding='utf-8') as f:
+        with open(metadata_file, "w", encoding="utf-8") as f:
             json.dump(metadata, f)
         logger.debug(f"Saved metadata for {session_relpath}: {content_size} bytes")
     except Exception as e:
@@ -1614,6 +1699,7 @@ def get_session_metadata(repo_root: Path, session_relpath: str) -> Optional[Dict
         Metadata dictionary or None if not found
     """
     from realign import get_realign_dir
+
     realign_dir = get_realign_dir(repo_root)
     metadata_dir = realign_dir / ".metadata"
     session_name = Path(session_relpath).name
@@ -1623,7 +1709,7 @@ def get_session_metadata(repo_root: Path, session_relpath: str) -> Optional[Dict
         return None
 
     try:
-        with open(metadata_file, 'r', encoding='utf-8') as f:
+        with open(metadata_file, "r", encoding="utf-8") as f:
             metadata = json.load(f)
         logger.debug(f"Loaded metadata for {session_relpath}: {metadata.get('content_size')} bytes")
         return metadata
@@ -1708,7 +1794,9 @@ def generate_summary_with_llm_from_turn_context(
             payload_lines = []
             if user_message:
                 payload_lines.append(
-                    json.dumps({"type": "user", "message": {"content": user_message}}, ensure_ascii=False)
+                    json.dumps(
+                        {"type": "user", "message": {"content": user_message}}, ensure_ascii=False
+                    )
                 )
 
             # Build a single assistant message with all components
@@ -1720,7 +1808,9 @@ def generate_summary_with_llm_from_turn_context(
 
             # Add the final conclusion from trigger (which is the authoritative summary)
             if assistant_summary:
-                assistant_parts.append(f"Turn status: {turn_status}\n\nFinal conclusion:\n{assistant_summary}")
+                assistant_parts.append(
+                    f"Turn status: {turn_status}\n\nFinal conclusion:\n{assistant_summary}"
+                )
 
             # Add previous records context (new format) or fallback to recent_commit_context
             if previous_records is not None:

realign/logging_config.py

@@ -22,15 +22,15 @@ def get_log_level() -> int:
     Returns:
         int: Logging level constant from logging module
     """
-    level_name = os.getenv('REALIGN_LOG_LEVEL', 'INFO').upper()
+    level_name = os.getenv("REALIGN_LOG_LEVEL", "INFO").upper()
 
     # Map string to logging constant
     level_map = {
-        'DEBUG': logging.DEBUG,
-        'INFO': logging.INFO,
-        'WARNING': logging.WARNING,
-        'ERROR': logging.ERROR,
-        'CRITICAL': logging.CRITICAL,
+        "DEBUG": logging.DEBUG,
+        "INFO": logging.INFO,
+        "WARNING": logging.WARNING,
+        "ERROR": logging.ERROR,
+        "CRITICAL": logging.CRITICAL,
     }
 
     return level_map.get(level_name, logging.INFO)
@@ -46,12 +46,12 @@ def get_log_directory() -> Path:
     Returns:
         Path: Log directory path
     """
-    log_dir_str = os.getenv('REALIGN_LOG_DIR')
+    log_dir_str = os.getenv("REALIGN_LOG_DIR")
 
     if log_dir_str:
         log_dir = Path(log_dir_str).expanduser()
     else:
-        log_dir = Path.home() / '.aline' / '.logs'
+        log_dir = Path.home() / ".aline" / ".logs"
 
     # Create directory if it doesn't exist
     log_dir.mkdir(parents=True, exist_ok=True)
@@ -64,7 +64,7 @@ def setup_logger(
     log_file: Optional[str] = None,
     max_bytes: int = 10 * 1024 * 1024,  # 10MB
     backup_count: int = 5,
-    console_output: bool = False
+    console_output: bool = False,
 ) -> logging.Logger:
     """
     Set up a logger with file rotation and optional console output.
@@ -95,8 +95,7 @@ def setup_logger(
 
     # Standard formatter with timestamp, level, name, and message
     formatter = logging.Formatter(
-        fmt='[%(asctime)s] [%(levelname)s] [%(name)s] %(message)s',
-        datefmt='%Y-%m-%d %H:%M:%S'
+        fmt="[%(asctime)s] [%(levelname)s] [%(name)s] %(message)s", datefmt="%Y-%m-%d %H:%M:%S"
     )
 
     # File handler with rotation
@@ -106,10 +105,7 @@ def setup_logger(
             log_path = log_dir / log_file
 
             file_handler = RotatingFileHandler(
-                log_path,
-                maxBytes=max_bytes,
-                backupCount=backup_count,
-                encoding='utf-8'
+                log_path, maxBytes=max_bytes, backupCount=backup_count, encoding="utf-8"
             )
             file_handler.setLevel(logging.DEBUG)  # Capture all levels to file
             file_handler.setFormatter(formatter)
@@ -119,6 +115,7 @@ def setup_logger(
             # If file logging fails, fall back to stderr only
             # Don't let logging setup break the application
             import sys
+
             print(f"Warning: Failed to set up file logging: {e}", file=sys.stderr)
 
     # Optional console handler (stderr)