Trinetra AI rebrand, Python 3.14 compatibility, local run support

- UI: Rebrand ScamShield AI to Trinetra AI; add tagline Detect. Engage. Expose.
- Backend: Avoid loading SQLAlchemy when POSTGRES_URL unset (Python 3.14 typing fix)
- Extractor: Fallback to regex-only when spaCy fails; resilient get_extractor()
- API docs: Update title/description to Trinetra AI
- Add requirements-local.txt for local Python 3.11+ install

Co-authored-by: Cursor <cursoragent@cursor.com>

app/api/endpoints.py

@@ -186,27 +186,27 @@ async def engage_honeypot(request_body: Dict[str, Any] = Body(default={})) -> En
         # Save session state to Redis (with in-memory fallback)
         save_session_state_with_fallback(session_id, result)
         
-        # Save conversation to PostgreSQL (optional, graceful degradation)
-        try:
-            from app.database.postgres import save_conversation
-            
-            conversation_data = {
-                "language": detected_language,
-                "persona": result.get("persona"),
-                "scam_confidence": confidence,
-                "turn_count": result.get("turn_count", 1),
-                "messages": result.get("messages", []),
-                "extracted_intel": intel,
-                "extraction_confidence": extraction_confidence,
-            }
-            
-            conversation_id = save_conversation(session_id, conversation_data)
-            if conversation_id > 0:
-                logger.debug(f"Conversation saved to PostgreSQL: id={conversation_id}")
-        except Exception as e:
-            # PostgreSQL save failed, but continue - Redis already saved the session
-            logger.warning(f"Failed to save conversation to PostgreSQL: {e}")
-            logger.info("Session state saved to Redis, continuing without PostgreSQL persistence")
+        # Save conversation to PostgreSQL only when configured (avoids loading SQLAlchemy on Python 3.14 when unused)
+        if settings.POSTGRES_URL:
+            try:
+                from app.database.postgres import save_conversation
+
+                conversation_data = {
+                    "language": detected_language,
+                    "persona": result.get("persona"),
+                    "scam_confidence": confidence,
+                    "turn_count": result.get("turn_count", 1),
+                    "messages": result.get("messages", []),
+                    "extracted_intel": intel,
+                    "extraction_confidence": extraction_confidence,
+                }
+
+                conversation_id = save_conversation(session_id, conversation_data)
+                if conversation_id > 0:
+                    logger.debug(f"Conversation saved to PostgreSQL: id={conversation_id}")
+            except Exception as e:
+                logger.warning(f"Failed to save conversation to PostgreSQL: {e}")
+                logger.info("Session state saved to Redis, continuing without PostgreSQL persistence")
         
         # Build conversation history for response
         conversation_history_response = []
@@ -397,11 +397,10 @@ async def get_session(session_id: str) -> SessionResponse:
     
     try:
         from app.database.redis_client import get_session_state_with_fallback
-        from app.database.postgres import get_conversation
-        
+
         # Try Redis first (active sessions)
         session_state = get_session_state_with_fallback(session_id)
-        
+
         if session_state:
             # Build response from Redis session state
             messages = session_state.get("messages", [])
@@ -451,9 +450,15 @@ async def get_session(session_id: str) -> SessionResponse:
                 updated_at=updated_at,
             )
         
-        # Try PostgreSQL for archived sessions
-        conversation = get_conversation(session_id)
-        
+        # Try PostgreSQL for archived sessions (only when configured; avoids loading SQLAlchemy when unused)
+        conversation = None
+        if settings.POSTGRES_URL:
+            try:
+                from app.database.postgres import get_conversation
+                conversation = get_conversation(session_id)
+            except Exception as e:
+                logger.warning(f"Failed to get conversation from PostgreSQL: {e}")
+
         if conversation:
             messages = conversation.get("messages", [])
             conversation_history = []
@@ -545,13 +550,14 @@ async def health_check() -> HealthResponse:
         logger.warning(f"Redis health check failed: {e}")
         redis_status = "offline"
     
-    # Check PostgreSQL
-    try:
-        from app.database.postgres import verify_schema
-        postgres_status = "online" if verify_schema() else "degraded"
-    except Exception as e:
-        logger.warning(f"PostgreSQL health check failed: {e}")
-        postgres_status = "offline"
+    # Check PostgreSQL (only when configured; avoids loading SQLAlchemy on Python 3.14 when unused)
+    if settings.POSTGRES_URL:
+        try:
+            from app.database.postgres import verify_schema
+            postgres_status = "online" if verify_schema() else "degraded"
+        except Exception as e:
+            logger.warning(f"PostgreSQL health check failed: {e}")
+            postgres_status = "offline"
     
     # Check Groq API (just check if API key is configured)
     try:

app/database/__init__.py

@@ -1,126 +1,85 @@
-"""
-Database Layer - Storage backends for conversations, sessions, and embeddings.
-
-This module provides:
-- PostgreSQL: Conversation logs and extracted intelligence
-- Redis: Session state management with TTL
-- ChromaDB: Vector embeddings for semantic search
-
-Task 6.2 Implementation:
-- AC-2.3.1: State persists across API calls
-- AC-2.3.2: Session expires after 1 hour
-- AC-2.3.3: PostgreSQL stores complete logs
-- AC-2.3.4: Redis failure degrades gracefully
-"""
-
-from app.database.postgres import (
-    # Connection management
-    get_db_connection,
-    get_db_session,
-    init_engine,
-    init_database,
-    verify_schema,
-    SessionLocal,
-    # Conversation CRUD
-    save_conversation,
-    get_conversation,
-    update_conversation,
-    delete_conversation,
-    get_conversations_by_date,
-    get_conversation_stats,
-    # Messages
-    save_messages,
-    # Intelligence
-    save_intelligence,
-    get_scammer_profiles,
-)
-from app.database.redis_client import (
-    # Connection management
-    get_redis_client,
-    init_redis_client,
-    health_check,
-    is_redis_available,
-    # Session state management
-    save_session_state,
-    get_session_state,
-    delete_session_state,
-    update_session_state,
-    # Graceful degradation with fallback
-    save_session_state_with_fallback,
-    get_session_state_with_fallback,
-    delete_session_state_with_fallback,
-    # Session utilities
-    extend_session_ttl,
-    get_session_ttl,
-    get_active_session_count,
-    clear_all_sessions,
-    reset_fallback_cache,
-    get_fallback_cache_stats,
-    # Rate limiting
-    increment_rate_counter,
-    check_rate_limit,
-    # Constants
-    DEFAULT_SESSION_TTL,
-)
-from app.database.chromadb_client import (
-    get_chromadb_client,
-    store_embedding,
-    search_similar,
-)
-from app.database.models import Conversation, Message, ExtractedIntelligence
-
-__all__ = [
-    # PostgreSQL - Connection
-    "get_db_connection",
-    "get_db_session",
-    "init_engine",
-    "init_database",
-    "verify_schema",
-    "SessionLocal",
-    # PostgreSQL - Conversation CRUD
-    "save_conversation",
-    "get_conversation",
-    "update_conversation",
-    "delete_conversation",
-    "get_conversations_by_date",
-    "get_conversation_stats",
-    # PostgreSQL - Messages
-    "save_messages",
-    # PostgreSQL - Intelligence
-    "save_intelligence",
-    "get_scammer_profiles",
-    # Redis - Connection
-    "get_redis_client",
-    "init_redis_client",
-    "health_check",
-    "is_redis_available",
-    # Redis - Session state
-    "save_session_state",
-    "get_session_state",
-    "delete_session_state",
-    "update_session_state",
-    # Redis - Graceful degradation
-    "save_session_state_with_fallback",
-    "get_session_state_with_fallback",
-    "delete_session_state_with_fallback",
-    # Redis - Utilities
-    "extend_session_ttl",
-    "get_session_ttl",
-    "get_active_session_count",
-    "clear_all_sessions",
-    "reset_fallback_cache",
-    "get_fallback_cache_stats",
-    # Redis - Rate limiting
-    "increment_rate_counter",
-    "check_rate_limit",
-    # Redis - Constants
-    "DEFAULT_SESSION_TTL",
-    # ChromaDB
-    "get_chromadb_client",
-    "store_embedding",
-    "search_similar",
-    # Models
-    "Conversation",
-    "Message",
-    "ExtractedIntelligence",
-]
+"""
+Database Layer - Storage backends for conversations, sessions, and embeddings.
+
+This module provides:
+- PostgreSQL: Conversation logs and extracted intelligence
+- Redis: Session state management with TTL
+- ChromaDB: Vector embeddings for semantic search
+
+Task 6.2 Implementation:
+- AC-2.3.1: State persists across API calls
+- AC-2.3.2: Session expires after 1 hour
+- AC-2.3.3: PostgreSQL stores complete logs
+- AC-2.3.4: Redis failure degrades gracefully
+
+Note: PostgreSQL is not imported here to avoid loading SQLAlchemy when POSTGRES_URL
+is unset (Python 3.14 typing compatibility). Import from app.database.postgres directly
+when POSTGRES_URL is configured.
+"""
+
+from app.database.redis_client import (
+    # Connection management
+    get_redis_client,
+    init_redis_client,
+    health_check,
+    is_redis_available,
+    # Session state management
+    save_session_state,
+    get_session_state,
+    delete_session_state,
+    update_session_state,
+    # Graceful degradation with fallback
+    save_session_state_with_fallback,
+    get_session_state_with_fallback,
+    delete_session_state_with_fallback,
+    # Session utilities
+    extend_session_ttl,
+    get_session_ttl,
+    get_active_session_count,
+    clear_all_sessions,
+    reset_fallback_cache,
+    get_fallback_cache_stats,
+    # Rate limiting
+    increment_rate_counter,
+    check_rate_limit,
+    # Constants
+    DEFAULT_SESSION_TTL,
+)
+from app.database.chromadb_client import (
+    get_chromadb_client,
+    store_embedding,
+    search_similar,
+)
+
+__all__ = [
+    # Redis - Connection
+    "get_redis_client",
+    "init_redis_client",
+    "health_check",
+    "is_redis_available",
+    # Redis - Session state
+    "save_session_state",
+    "get_session_state",
+    "delete_session_state",
+    "update_session_state",
+    # Redis - Graceful degradation
+    "save_session_state_with_fallback",
+    "get_session_state_with_fallback",
+    "delete_session_state_with_fallback",
+    # Redis - Utilities
+    "extend_session_ttl",
+    "get_session_ttl",
+    "get_active_session_count",
+    "clear_all_sessions",
+    "reset_fallback_cache",
+    "get_fallback_cache_stats",
+    # Redis - Rate limiting
+    "increment_rate_counter",
+    "check_rate_limit",
+    # Redis - Constants
+    "DEFAULT_SESSION_TTL",
+    # ChromaDB
+    "get_chromadb_client",
+    "store_embedding",
+    "search_similar",
+]

app/main.py

@@ -1,260 +1,260 @@
-"""
-FastAPI Application Entry Point.
-
-ScamShield AI - Agentic Honeypot for Scam Detection and Intelligence Extraction.
-
-This module creates and configures the FastAPI application with:
-- API routes for honeypot endpoints
-- CORS middleware
-- Exception handlers
-- Startup/shutdown events
-"""
-
-from contextlib import asynccontextmanager
-from datetime import datetime
-import time
-
-from fastapi import FastAPI, Request
-from fastapi.middleware.cors import CORSMiddleware
-from fastapi.responses import JSONResponse
-from fastapi.staticfiles import StaticFiles
-from pathlib import Path
-
-from app.config import settings
-from app.api.endpoints import router
-from app.utils.logger import setup_logging, get_logger
-
-# Initialize logging
-setup_logging(level=settings.LOG_LEVEL)
-logger = get_logger(__name__)
-
-# Track startup time for uptime calculation
-_startup_time: float = 0
-
-
-@asynccontextmanager
-async def lifespan(app: FastAPI):
-    """
-    Application lifespan manager.
-    
-    Handles startup and shutdown events.
-    """
-    global _startup_time
-    
-    # Startup
-    logger.info("Starting ScamShield AI...")
-    _startup_time = time.time()
-    
-    # Pre-load ML models (prevents cold-start delays)
-    logger.info("Loading ML models...")
-    try:
-        from app.models.detector import get_detector
-        from app.models.extractor import get_extractor
-        
-        # Pre-initialize detector (loads IndicBERT)
-        detector = get_detector()
-        logger.info(f"Detector ready (model loaded: {detector._model_loaded})")
-        
-        # Pre-initialize extractor (loads spaCy)
-        extractor = get_extractor()
-        logger.info(f"Extractor ready (spaCy loaded: {extractor.nlp is not None})")
-        
-        logger.info("All ML models loaded successfully")
-    except Exception as e:
-        logger.error(f"Failed to load ML models: {e}")
-        logger.warning("Application will continue but may have degraded functionality")
-    
-    # Initialize PostgreSQL database
-    if settings.POSTGRES_URL:
-        try:
-            from app.database.postgres import init_engine, init_database, verify_schema
-            
-            logger.info("Initializing PostgreSQL connection...")
-            init_engine()
-            
-            # Initialize database schema if needed
-            if not verify_schema():
-                logger.info("Database schema not found, initializing...")
-                init_database()
-            else:
-                logger.info("Database schema verified")
-                
-            logger.info("PostgreSQL initialized successfully")
-        except Exception as e:
-            logger.error(f"Failed to initialize PostgreSQL: {e}")
-            logger.warning("PostgreSQL operations will fail. Application will continue with Redis only.")
-    else:
-        logger.warning("POSTGRES_URL not configured. PostgreSQL features disabled.")
-    
-    # Initialize Redis connection
-    if settings.REDIS_URL:
-        try:
-            from app.database.redis_client import init_redis_client, is_redis_available
-            
-            logger.info("Initializing Redis connection...")
-            init_redis_client()
-            
-            if is_redis_available():
-                logger.info("Redis initialized successfully")
-            else:
-                logger.warning("Redis connection failed. Will use in-memory fallback.")
-        except Exception as e:
-            logger.error(f"Failed to initialize Redis: {e}")
-            logger.warning("Redis operations will fail. Will use in-memory fallback.")
-    else:
-        logger.warning("REDIS_URL not configured. Will use in-memory session storage.")
-    
-    logger.info(f"ScamShield AI started in {settings.ENVIRONMENT} mode")
-    
-    yield
-    
-    # Shutdown
-    logger.info("Shutting down ScamShield AI...")
-    
-    # Cleanup resources
-    try:
-        from app.database.postgres import engine
-        if engine:
-            engine.dispose()
-            logger.info("PostgreSQL connections closed")
-    except Exception as e:
-        logger.warning(f"Error closing PostgreSQL connections: {e}")
-    
-    try:
-        from app.database.redis_client import redis_client
-        if redis_client:
-            redis_client.close()
-            logger.info("Redis connection closed")
-    except Exception as e:
-        logger.warning(f"Error closing Redis connection: {e}")
-    
-    logger.info("ScamShield AI shutdown complete")
-
-
-# Create FastAPI application
-app = FastAPI(
-    title="ScamShield AI",
-    description="Agentic Honeypot System for Scam Detection & Intelligence Extraction",
-    version="1.0.0",
-    lifespan=lifespan,
-    docs_url="/docs" if settings.DEBUG else None,
-    redoc_url="/redoc" if settings.DEBUG else None,
-)
-
-# Configure CORS
-app.add_middleware(
-    CORSMiddleware,
-    allow_origins=["*"],  # TODO: Restrict in production
-    allow_credentials=True,
-    allow_methods=["*"],
-    allow_headers=["*"],
-)
-
-# Include Phase 1 API routes
-app.include_router(router)
-
-# Conditionally include Phase 2 voice routes (opt-in, default disabled)
-if getattr(settings, "PHASE_2_ENABLED", False):
-    try:
-        from app.api.voice_endpoints import voice_router
-        app.include_router(voice_router)
-        logger.info("Phase 2 voice endpoints enabled")
-    except ImportError as e:
-        logger.warning(f"Phase 2 voice endpoints unavailable (missing dependencies): {e}")
-    except Exception as e:
-        logger.error(f"Failed to load Phase 2 voice endpoints: {e}")
-else:
-    logger.info("Phase 2 voice features disabled (PHASE_2_ENABLED=false)")
-
-# Mount static files for UI
-ui_path = Path(__file__).parent.parent / "ui"
-if ui_path.exists():
-    app.mount("/ui", StaticFiles(directory=str(ui_path), html=True), name="ui")
-    logger.info(f"UI mounted at /ui (from {ui_path})")
-    
-    # Serve index.html at root
-    @app.get("/", include_in_schema=False)
-    async def serve_ui():
-        """Serve the UI dashboard at root."""
-        from fastapi.responses import FileResponse
-        index_file = ui_path / "index.html"
-        if index_file.exists():
-            return FileResponse(index_file)
-        return {"message": "UI files not found"}
-    
-    # Serve GUVI Tester at /guvi-test
-    @app.get("/guvi-test", include_in_schema=False)
-    async def serve_guvi_tester():
-        """Serve the GUVI Format Tester UI."""
-        from fastapi.responses import FileResponse
-        guvi_test_file = ui_path / "guvi-test.html"
-        if guvi_test_file.exists():
-            return FileResponse(guvi_test_file)
-        return {"message": "GUVI Tester UI not found"}
-
-    # Serve Phase 2 Voice UI at /voice (only when Phase 2 is enabled)
-    if getattr(settings, "PHASE_2_ENABLED", False):
-        @app.get("/voice", include_in_schema=False)
-        async def serve_voice_ui():
-            """Serve the Phase 2 Voice Honeypot UI."""
-            from fastapi.responses import FileResponse
-            voice_file = ui_path / "voice.html"
-            if voice_file.exists():
-                return FileResponse(voice_file)
-            return {"message": "Voice UI not found"}
-
-
-@app.exception_handler(Exception)
-async def global_exception_handler(request: Request, exc: Exception):
-    """
-    Global exception handler for unhandled errors.
-    
-    Args:
-        request: FastAPI request
-        exc: Exception that was raised
-        
-    Returns:
-        JSON error response
-    """
-    logger.error(f"Unhandled exception: {exc}", exc_info=True)
-    
-    return JSONResponse(
-        status_code=500,
-        content={
-            "status": "error",
-            "error": {
-                "code": "INTERNAL_ERROR",
-                "message": "An unexpected error occurred while processing your request",
-                "details": {
-                    "timestamp": datetime.utcnow().isoformat() + "Z",
-                },
-            },
-        },
-    )
-
-
-# Root endpoint moved to serve UI (see above)
-
-
-def get_uptime_seconds() -> int:
-    """
-    Get application uptime in seconds.
-    
-    Returns:
-        Uptime in seconds
-    """
-    if _startup_time == 0:
-        return 0
-    return int(time.time() - _startup_time)
-
-
-# Export for uvicorn
-if __name__ == "__main__":
-    import uvicorn
-    
-    uvicorn.run(
-        "app.main:app",
-        host=settings.API_HOST,
-        port=settings.API_PORT,
-        reload=settings.is_development,
-    )
+"""
+FastAPI Application Entry Point.
+
+ScamShield AI - Agentic Honeypot for Scam Detection and Intelligence Extraction.
+
+This module creates and configures the FastAPI application with:
+- API routes for honeypot endpoints
+- CORS middleware
+- Exception handlers
+- Startup/shutdown events
+"""
+
+from contextlib import asynccontextmanager
+from datetime import datetime
+import time
+
+from fastapi import FastAPI, Request
+from fastapi.middleware.cors import CORSMiddleware
+from fastapi.responses import JSONResponse
+from fastapi.staticfiles import StaticFiles
+from pathlib import Path
+
+from app.config import settings
+from app.api.endpoints import router
+from app.utils.logger import setup_logging, get_logger
+
+# Initialize logging
+setup_logging(level=settings.LOG_LEVEL)
+logger = get_logger(__name__)
+
+# Track startup time for uptime calculation
+_startup_time: float = 0
+
+
+@asynccontextmanager
+async def lifespan(app: FastAPI):
+    """
+    Application lifespan manager.
+    
+    Handles startup and shutdown events.
+    """
+    global _startup_time
+    
+    # Startup
+    logger.info("Starting ScamShield AI...")
+    _startup_time = time.time()
+    
+    # Pre-load ML models (prevents cold-start delays)
+    logger.info("Loading ML models...")
+    try:
+        from app.models.detector import get_detector
+        from app.models.extractor import get_extractor
+        
+        # Pre-initialize detector (loads IndicBERT)
+        detector = get_detector()
+        logger.info(f"Detector ready (model loaded: {detector._model_loaded})")
+        
+        # Pre-initialize extractor (loads spaCy)
+        extractor = get_extractor()
+        logger.info(f"Extractor ready (spaCy loaded: {extractor.nlp is not None})")
+        
+        logger.info("All ML models loaded successfully")
+    except Exception as e:
+        logger.error(f"Failed to load ML models: {e}")
+        logger.warning("Application will continue but may have degraded functionality")
+    
+    # Initialize PostgreSQL database
+    if settings.POSTGRES_URL:
+        try:
+            from app.database.postgres import init_engine, init_database, verify_schema
+            
+            logger.info("Initializing PostgreSQL connection...")
+            init_engine()
+            
+            # Initialize database schema if needed
+            if not verify_schema():
+                logger.info("Database schema not found, initializing...")
+                init_database()
+            else:
+                logger.info("Database schema verified")
+                
+            logger.info("PostgreSQL initialized successfully")
+        except Exception as e:
+            logger.error(f"Failed to initialize PostgreSQL: {e}")
+            logger.warning("PostgreSQL operations will fail. Application will continue with Redis only.")
+    else:
+        logger.warning("POSTGRES_URL not configured. PostgreSQL features disabled.")
+    
+    # Initialize Redis connection
+    if settings.REDIS_URL:
+        try:
+            from app.database.redis_client import init_redis_client, is_redis_available
+            
+            logger.info("Initializing Redis connection...")
+            init_redis_client()
+            
+            if is_redis_available():
+                logger.info("Redis initialized successfully")
+            else:
+                logger.warning("Redis connection failed. Will use in-memory fallback.")
+        except Exception as e:
+            logger.error(f"Failed to initialize Redis: {e}")
+            logger.warning("Redis operations will fail. Will use in-memory fallback.")
+    else:
+        logger.warning("REDIS_URL not configured. Will use in-memory session storage.")
+    
+    logger.info(f"ScamShield AI started in {settings.ENVIRONMENT} mode")
+    
+    yield
+    
+    # Shutdown
+    logger.info("Shutting down ScamShield AI...")
+    
+    if settings.POSTGRES_URL:
+        try:
+            from app.database.postgres import engine
+            if engine:
+                engine.dispose()
+                logger.info("PostgreSQL connections closed")
+        except Exception as e:
+            logger.warning(f"Error closing PostgreSQL connections: {e}")
+    
+    try:
+        from app.database.redis_client import redis_client
+        if redis_client:
+            redis_client.close()
+            logger.info("Redis connection closed")
+    except Exception as e:
+        logger.warning(f"Error closing Redis connection: {e}")
+    
+    logger.info("ScamShield AI shutdown complete")
+
+
+# Create FastAPI application
+app = FastAPI(
+    title="Trinetra AI",
+    description="Detect. Engage. Expose. Agentic Honeypot for Scam Detection and Intelligence Extraction.",
+    version="1.0.0",
+    lifespan=lifespan,
+    docs_url="/docs" if settings.DEBUG else None,
+    redoc_url="/redoc" if settings.DEBUG else None,
+)
+
+# Configure CORS
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],  # TODO: Restrict in production
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+# Include Phase 1 API routes
+app.include_router(router)
+
+# Conditionally include Phase 2 voice routes (opt-in, default disabled)
+if getattr(settings, "PHASE_2_ENABLED", False):
+    try:
+        from app.api.voice_endpoints import voice_router
+        app.include_router(voice_router)
+        logger.info("Phase 2 voice endpoints enabled")
+    except ImportError as e:
+        logger.warning(f"Phase 2 voice endpoints unavailable (missing dependencies): {e}")
+    except Exception as e:
+        logger.error(f"Failed to load Phase 2 voice endpoints: {e}")
+else:
+    logger.info("Phase 2 voice features disabled (PHASE_2_ENABLED=false)")
+
+# Mount static files for UI
+ui_path = Path(__file__).parent.parent / "ui"
+if ui_path.exists():
+    app.mount("/ui", StaticFiles(directory=str(ui_path), html=True), name="ui")
+    logger.info(f"UI mounted at /ui (from {ui_path})")
+    
+    # Serve index.html at root
+    @app.get("/", include_in_schema=False)
+    async def serve_ui():
+        """Serve the UI dashboard at root."""
+        from fastapi.responses import FileResponse
+        index_file = ui_path / "index.html"
+        if index_file.exists():
+            return FileResponse(index_file)
+        return {"message": "UI files not found"}
+    
+    # Serve GUVI Tester at /guvi-test
+    @app.get("/guvi-test", include_in_schema=False)
+    async def serve_guvi_tester():
+        """Serve the GUVI Format Tester UI."""
+        from fastapi.responses import FileResponse
+        guvi_test_file = ui_path / "guvi-test.html"
+        if guvi_test_file.exists():
+            return FileResponse(guvi_test_file)
+        return {"message": "GUVI Tester UI not found"}
+
+    # Serve Phase 2 Voice UI at /voice (only when Phase 2 is enabled)
+    if getattr(settings, "PHASE_2_ENABLED", False):
+        @app.get("/voice", include_in_schema=False)
+        async def serve_voice_ui():
+            """Serve the Phase 2 Voice Honeypot UI."""
+            from fastapi.responses import FileResponse
+            voice_file = ui_path / "voice.html"
+            if voice_file.exists():
+                return FileResponse(voice_file)
+            return {"message": "Voice UI not found"}
+
+
+@app.exception_handler(Exception)
+async def global_exception_handler(request: Request, exc: Exception):
+    """
+    Global exception handler for unhandled errors.
+    
+    Args:
+        request: FastAPI request
+        exc: Exception that was raised
+        
+    Returns:
+        JSON error response
+    """
+    logger.error(f"Unhandled exception: {exc}", exc_info=True)
+    
+    return JSONResponse(
+        status_code=500,
+        content={
+            "status": "error",
+            "error": {
+                "code": "INTERNAL_ERROR",
+                "message": "An unexpected error occurred while processing your request",
+                "details": {
+                    "timestamp": datetime.utcnow().isoformat() + "Z",
+                },
+            },
+        },
+    )
+
+
+# Root endpoint moved to serve UI (see above)
+
+
+def get_uptime_seconds() -> int:
+    """
+    Get application uptime in seconds.
+    
+    Returns:
+        Uptime in seconds
+    """
+    if _startup_time == 0:
+        return 0
+    return int(time.time() - _startup_time)
+
+
+# Export for uvicorn
+if __name__ == "__main__":
+    import uvicorn
+    
+    uvicorn.run(
+        "app.main:app",
+        host=settings.API_HOST,
+        port=settings.API_PORT,
+        reload=settings.is_development,
+    )

app/models/extractor.py

@@ -140,6 +140,9 @@ class IntelligenceExtractor:
         except OSError:
             logger.warning("spaCy model 'en_core_web_sm' not found, using regex-only")
             self.nlp = None
+        except Exception as e:
+            logger.warning("spaCy load failed (%s), using regex-only extraction", e)
+            self.nlp = None
     
     def extract(self, text: str) -> Tuple[Dict[str, List[str]], float]:
         """
@@ -613,13 +616,15 @@ _extractor: Optional[IntelligenceExtractor] = None
 def get_extractor() -> IntelligenceExtractor:
     """
     Get singleton extractor instance.
-    
-    Returns:
-        IntelligenceExtractor instance
+    Falls back to regex-only if spaCy fails (e.g. Python 3.14 compatibility).
     """
     global _extractor
     if _extractor is None:
-        _extractor = IntelligenceExtractor()
+        try:
+            _extractor = IntelligenceExtractor(use_spacy=True)
+        except Exception as e:
+            logger.warning("Extractor init with spaCy failed (%s), using regex-only", e)
+            _extractor = IntelligenceExtractor(use_spacy=False)
     return _extractor
 
 

requirements-local.txt

@@ -0,0 +1,27 @@
+# Local run (Python 3.11+); uses PyPI-only and spacy 3.8+ for pre-built wheels
+torch>=2.0.0
+transformers==4.35.0
+sentence-transformers==2.2.2
+spacy>=3.8
+huggingface_hub>=0.16.4,<0.18
+langchain==0.1.0
+langchain-core>=0.1.0
+langgraph==0.0.20
+langchain-groq==0.0.1
+langsmith>=0.0.77
+groq>=0.4.0
+fastapi==0.104.1
+uvicorn[standard]==0.24.0
+pydantic>=2.6.0
+chromadb==0.4.18
+# psycopg2-binary optional for local run without Postgres (no py3.14 wheel)
+redis==5.0.1
+sqlalchemy==2.0.23
+langdetect==1.0.9
+nltk==3.8.1
+prometheus-client==0.19.0
+python-dotenv==1.0.0
+requests==2.31.0
+numpy>=1.24.3
+pandas>=2.2.0
+httpx==0.25.2

ui/app.js

@@ -45,7 +45,7 @@ let state = {
 // Initialization
 // ============================================================================
 document.addEventListener('DOMContentLoaded', () => {
-    console.log('🛡️ ScamShield AI Dashboard initialized');
+    console.log('Trinetra AI Dashboard initialized');
     checkHealth();
     
     // Auto-refresh health every 30 seconds
@@ -576,7 +576,7 @@ function downloadReport() {
     
     const a = document.createElement('a');
     a.href = url;
-    a.download = `scamshield-report-${state.sessionId || 'unknown'}.json`;
+    a.download = `trinetra-report-${state.sessionId || 'unknown'}.json`;
     document.body.appendChild(a);
     a.click();
     document.body.removeChild(a);

ui/guvi-test.html

@@ -3,7 +3,7 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>GUVI Format Tester - ScamShield AI</title>
+    <title>GUVI Format Tester - Trinetra AI</title>
     <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;600&family=Space+Grotesk:wght@400;500;600;700&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="/ui/guvi-test.css">
 </head>

ui/index.html

@@ -3,7 +3,7 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>ScamShield AI - Honeypot Dashboard</title>
+    <title>Trinetra AI - Honeypot Dashboard</title>
     <link rel="stylesheet" href="/ui/styles.css">
     <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;600&family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet">
 </head>
@@ -13,7 +13,8 @@
         <header class="header">
             <div class="logo">
                 <span class="logo-icon">🛡️</span>
-                <h1>ScamShield AI</h1>
+                <h1>Trinetra AI</h1>
+                <span class="tagline">Detect. Engage. Expose.</span>
                 <span class="badge">Honeypot Dashboard</span>
             </div>
             <div class="header-right">
@@ -202,7 +203,9 @@
         <!-- Footer -->
         <footer class="footer">
             <div class="footer-left">
-                <span>ScamShield AI v1.0.0</span>
+                <span>Trinetra AI v1.0.0</span>
+                <span class="separator">|</span>
+                <span class="tagline">Detect. Engage. Expose.</span>
                 <span class="separator">|</span>
                 <span>API: <a href="/docs" target="_blank">Swagger Docs</a></span>
             </div>

ui/styles.css

@@ -103,6 +103,13 @@ html, body {
     background-clip: text;
 }
 
+.tagline {
+    font-size: 0.8rem;
+    color: var(--text-secondary);
+    font-weight: 500;
+    letter-spacing: 0.02em;
+}
+
 .badge {
     padding: 4px 12px;
     background: var(--bg-tertiary);

ui/voice.css

@@ -107,6 +107,13 @@ html, body {
     background-clip: text;
 }
 
+.tagline {
+    font-size: 0.8rem;
+    color: var(--text-secondary);
+    font-weight: 500;
+    letter-spacing: 0.02em;
+}
+
 .badge {
     padding: 4px 12px;
     background: var(--bg-tertiary);

ui/voice.html

@@ -3,7 +3,7 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>ScamShield AI - Voice Honeypot (Phase 2)</title>
+    <title>Trinetra AI - Voice Honeypot (Phase 2)</title>
     <link rel="stylesheet" href="/ui/voice.css">
     <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;600&family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet">
 </head>
@@ -14,7 +14,8 @@
         <header class="header">
             <div class="logo">
                 <span class="logo-icon">&#x1F3A4;</span>
-                <h1>ScamShield AI</h1>
+                <h1>Trinetra AI</h1>
+                <span class="tagline">Detect. Engage. Expose.</span>
                 <span class="badge phase-2">Voice Honeypot &middot; Phase 2</span>
             </div>
             <div class="header-right">
@@ -168,7 +169,7 @@
         <!-- Footer -->
         <footer class="footer">
             <div>
-                <span>ScamShield AI v2.0.0 &middot; Phase 2 Voice</span>
+                <span>Trinetra AI v2.0.0 &middot; Phase 2 Voice</span>
                 <span class="separator">|</span>
                 <span>API: <a href="/docs" target="_blank">Swagger Docs</a></span>
                 <span class="separator">|</span>