refactor(core): Add compatibility symlinks and organize backend modules (mrveiss#781)

- Add Python path setup in autobot-shared/__init__.py for imports
- Rename autobot-user-backend/logging to autobot_logging
- Add new monitoring/ module with prometheus_metrics
- Add new type_defs/ module with typed API definitions
- Add chat_exceptions.py utility
- Add backend/ and autobot_shared symlinks for backward compatibility
- Update redis_management imports

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

Author: mrveiss

autobot-shared/__init__.py

@@ -3,6 +3,14 @@
 # Author: mrveiss
 """AutoBot shared utilities - deployed with each backend component."""
 
+import sys
+from pathlib import Path
+
+# Add backend directory to Python path for imports (Issue #781 folder reorganization)
+_backend_path = Path(__file__).parent.parent / "backend"
+if _backend_path.exists() and str(_backend_path) not in sys.path:
+    sys.path.insert(0, str(_backend_path))
+
 from .redis_client import get_redis_client
 from .ssot_config import config
 

autobot-shared/error_boundaries.py

@@ -22,7 +22,7 @@
 import json
 
 # Re-export all public API from the package for backward compatibility
-from src.utils.error_boundaries import (
+from backend.utils.error_boundaries import (
     CRITICAL_ERROR_TYPES,
     FALLBACK_ERROR_TYPES,
     HIGH_SEVERITY_ERROR_TYPES,

autobot-shared/http_client.py

@@ -14,7 +14,7 @@
 import aiohttp
 from aiohttp import ClientSession, ClientTimeout, TCPConnector
 
-from src.constants.threshold_constants import TimingConstants
+from backend.constants.threshold_constants import TimingConstants
 
 logger = logging.getLogger(__name__)
 

autobot-shared/logging_manager.py

@@ -13,7 +13,7 @@
 from pathlib import Path
 from typing import Optional
 
-from src.config import config_manager
+from backend.config import config_manager
 
 # Module-level logger for logging_manager itself
 _logger = logging.getLogger(__name__)

autobot-shared/redis_client.py

@@ -46,7 +46,7 @@
 
 MANDATORY USAGE PATTERN:
 ========================
-from src.utils.redis_client import get_redis_client
+from backend.utils.redis_client import get_redis_client
 
 # Synchronous client
 redis_client = get_redis_client(database="main")
@@ -86,17 +86,21 @@
 import redis
 import redis.asyncio as async_redis
 
-from src.utils.redis_management.config import PoolConfig, RedisConfig, RedisConfigLoader
-from src.utils.redis_management.connection_manager import RedisConnectionManager
-from src.utils.redis_management.statistics import (
+from backend.utils.redis_management.config import (
+    PoolConfig,
+    RedisConfig,
+    RedisConfigLoader,
+)
+from backend.utils.redis_management.connection_manager import RedisConnectionManager
+from backend.utils.redis_management.statistics import (
     ConnectionMetrics,
     ManagerStats,
     PoolStatistics,
     RedisStats,
 )
 
 # Import all types, data models, and classes from the package (Issue #381 refactoring)
-from src.utils.redis_management.types import (
+from backend.utils.redis_management.types import (
     DATABASE_MAPPING,
     ConnectionState,
     RedisDatabase,
@@ -500,7 +504,7 @@ def __init__(self):
         """Initialize deprecated manager with deprecation warning."""
         logger.warning(
             "DEPRECATED: RedisDatabaseManager is deprecated. "
-            "Use get_redis_client() from src.utils.redis_client instead."
+            "Use get_redis_client() from backend.utils.redis_client instead."
         )
 
     def get_connection(

autobot-shared/ssot_config.py

@@ -13,7 +13,7 @@
 through Pydantic models for type safety and validation.
 
 Usage:
-    from src.config.ssot_config import get_config, config
+    from autobot_shared.ssot_config import get_config, config
 
     # Access VM IPs
     redis_ip = config.vm.redis

autobot-user-backend/api/terminal_handlers.py

@@ -28,6 +28,9 @@
 from datetime import datetime
 from typing import Awaitable, Callable, Dict, Optional
 
+from chat_history import ChatHistoryManager
+from constants.path_constants import PATH
+from constants.threshold_constants import TimingConstants
 from fastapi import WebSocket
 
 # Import models from dedicated module (Issue #185)
@@ -45,9 +48,6 @@
     LOGGING_SECURITY_LEVELS,
     SHELL_OPERATORS,
 )
-from chat_history import ChatHistoryManager
-from constants.path_constants import PATH
-from constants.threshold_constants import TimingConstants
 
 # Issue #380: Module-level frozenset for terminal close event types
 _TERMINAL_CLOSE_EVENTS = frozenset({"eo", "close"})
@@ -181,7 +181,7 @@ def __init__(
 
         # Initialize TerminalLogger for persistent command logging
         if conversation_id:
-            from logging.terminal_logger import TerminalLogger
+            from autobot_logging.terminal_logger import TerminalLogger
 
             self.terminal_logger = TerminalLogger(
                 redis_client=redis_client, data_dir="data/chats"
@@ -639,7 +639,6 @@ async def _write_to_transcript(self, text: str) -> None:
             from pathlib import Path
 
             import aiofiles
-
             from utils.encoding_utils import strip_ansi_codes
 
             # Strip ANSI escape codes before writing to transcript
@@ -1181,7 +1180,6 @@ async def _log_to_transcript(self, content: str) -> None:
         from pathlib import Path
 
         import aiofiles
-
         from utils.encoding_utils import strip_ansi_codes
 
         try:

autobot-user-backend/logging/__init__.py …user-backend/autobot_logging/__init__.pyautobot-user-backend/logging/__init__.py renamed to autobot-user-backend/autobot_logging/__init__.py autobot-user-backend/logging/__init__.py renamed to autobot-user-backend/autobot_logging/__init__.py

@@ -8,6 +8,6 @@
 - TerminalLogger: Terminal command logging with AUTOBOT/MANUAL markers
 """
 
-from logging.terminal_logger import TerminalLogger
+from autobot_logging.terminal_logger import TerminalLogger
 
 __all__ = ["TerminalLogger"]

…-user-backend/logging/terminal_logger.py …ckend/autobot_logging/terminal_logger.pyautobot-user-backend/logging/terminal_logger.py renamed to autobot-user-backend/autobot_logging/terminal_logger.py autobot-user-backend/logging/terminal_logger.py renamed to autobot-user-backend/autobot_logging/terminal_logger.py

@@ -0,0 +1 @@
+autobot-user-backend