Fix fragile sys.path hacks in backend services

- Replaces hardcoded string replacement in main.py with robust pathlib logic
- Fixes potential startup crash in Docker where file paths don't match source structure
- Handles imports via PYTHONPATH (Docker default) or local relative path fallback

Author: TamTunnel

backend/ai-agents/app/main.py

@@ -7,8 +7,13 @@
 from fastapi import FastAPI, Request
 from fastapi.middleware.cors import CORSMiddleware
 
-# Add common module to path
-sys.path.insert(0, str(__file__).replace('/ai-agents/app/main.py', ''))
+# Add common module to path (fallback for local run, handled by PYTHONPATH in Docker)
+try:
+    import common
+except ImportError:
+    import sys
+    from pathlib import Path
+    sys.path.insert(0, str(Path(__file__).resolve().parent.parent.parent))
 
 from .routes import router
 

backend/core-orbits/app/main.py

@@ -8,8 +8,13 @@
 from fastapi import FastAPI, Request
 from fastapi.middleware.cors import CORSMiddleware
 
-# Add common module to path
-sys.path.insert(0, str(__file__).replace('/core-orbits/app/main.py', ''))
+# Add common module to path (fallback for local run, handled by PYTHONPATH in Docker)
+try:
+    import common
+except ImportError:
+    import sys
+    from pathlib import Path
+    sys.path.insert(0, str(Path(__file__).resolve().parent.parent.parent))
 
 from .routes import router
 from .demo_routes import router as demo_router

backend/ground-scheduler/app/main.py

@@ -7,8 +7,13 @@
 from fastapi import FastAPI, Request
 from fastapi.middleware.cors import CORSMiddleware
 
-# Add common module to path
-sys.path.insert(0, str(__file__).replace('/ground-scheduler/app/main.py', ''))
+# Add common module to path (fallback for local run, handled by PYTHONPATH in Docker)
+try:
+    import common
+except ImportError:
+    import sys
+    from pathlib import Path
+    sys.path.insert(0, str(Path(__file__).resolve().parent.parent.parent))
 
 from .routes import router
 from .db import init_db, get_db

backend/routing/app/main.py

@@ -8,8 +8,13 @@
 from fastapi import FastAPI, Request
 from fastapi.middleware.cors import CORSMiddleware
 
-# Add common module to path
-sys.path.insert(0, str(__file__).replace('/routing/app/main.py', ''))
+# Add common module to path (fallback for local run, handled by PYTHONPATH in Docker)
+try:
+    import common
+except ImportError:
+    import sys
+    from pathlib import Path
+    sys.path.insert(0, str(Path(__file__).resolve().parent.parent.parent))
 
 from .routes import router
 from .db import init_db, get_db