chore: add ruff and mypy configuration with auto-fixes

Author: Medalcode

backend/app/ai_client.py

@@ -1,7 +1,7 @@
-import os
 import logging
+import os
+
 import requests
-from typing import Dict
 
 logger = logging.getLogger("stackx.ai_client")
 logger.setLevel(logging.INFO)
@@ -10,7 +10,7 @@
 OLLAMA_TIMEOUT = int(os.getenv("OLLAMA_TIMEOUT", "10"))
 
 try:
-    from .skills_registry import get_skill, all_skills, load_all_skills
+    from .skills_registry import all_skills, get_skill, load_all_skills
     try:
         load_all_skills()
     except Exception:
@@ -24,7 +24,7 @@ def all_skills():
         return []
 
 
-def _build_prompt(user_input: Dict, top_stack: Dict) -> str:
+def _build_prompt(user_input: dict, top_stack: dict) -> str:
     proyecto = user_input.get("proyecto", "un proyecto")
     prioridades = user_input.get("weights", {})
     prompt = (
@@ -37,7 +37,7 @@ def _build_prompt(user_input: Dict, top_stack: Dict) -> str:
     return prompt
 
 
-def _run_skill_if_available(user_input: Dict, top_stack: Dict, skill_name: str = None) -> str:
+def _run_skill_if_available(user_input: dict, top_stack: dict, skill_name: str = None) -> str:
     """Intenta ejecutar una skill registrada para generar la justificación.
 
     Prioridad de selección de skill:
@@ -82,7 +82,7 @@ def _run_skill_if_available(user_input: Dict, top_stack: Dict, skill_name: str =
     return None
 
 
-def generate_justification(user_input: Dict, top_stack: Dict, skill_name: str = None) -> str:
+def generate_justification(user_input: dict, top_stack: dict, skill_name: str = None) -> str:
     # 1) Intentar skill registrado (puede pasar un nombre de skill explícito)
     text = _run_skill_if_available(user_input, top_stack, skill_name=skill_name)
     if text:

backend/app/ai_skills/content_generator.py

@@ -1,5 +1,4 @@
 # backend/app/ai_skills/content_generator.py
-import os
 
 SKILL_NAME = "content_generator"
 DESCRIPTION = "Super-Skill para generar contenido variable (justificaciones, resúmenes, trade-offs) basado en parámetros."
@@ -8,7 +7,7 @@ def run_skill(input: dict) -> dict:
     mode = input.get("mode", "full_justification")
     tech = input.get("tech", {})
     tech_name = tech.get("name", "tecnología seleccionada")
-    
+
     if mode == "full_justification":
         text = f"Justificación completa: {tech_name} es ideal por su escalabilidad y soporte de comunidad."
     elif mode == "concise_summary":
@@ -17,9 +16,9 @@ def run_skill(input: dict) -> dict:
         text = f"Comparativa: {tech_name} frente a alternativas destaca por su baja latencia."
     else:
         text = f"Contenido generado para {tech_name} en modo {mode}."
-        
+
     return {
-        "status": "ok", 
+        "status": "ok",
         "result": {
             "text": text,
             "mode_applied": mode

backend/app/ai_skills/data_analysis.py

@@ -1,20 +1,19 @@
 # backend/app/ai_skills/data_analysis.py
-from .. import recommender  # Reutilizamos lógica existente si es posible
 
 SKILL_NAME = "data_analysis"
 DESCRIPTION = "Super-Skill para análisis de datos, scoring y validación de compatibilidad."
 
 def run_skill(input: dict) -> dict:
     operation = input.get("operation", "calculate_stack_score")
-    
+
     if operation == "calculate_stack_score":
         # Podríamos llamar a recommender.calculate_score_for_tech aquí
         result = {"score": 0.85, "details": "Cálculo basado en pesos del usuario."}
     elif operation == "validate_compatibility":
         result = {"compatible": True, "conflict_level": "low"}
     else:
         result = {"error": f"Operación {operation} no soportada."}
-        
+
     return {
         "status": "ok",
         "result": result

backend/app/database.py

@@ -1,4 +1,5 @@
 import os
+
 from sqlalchemy import create_engine
 from sqlalchemy.orm import sessionmaker
 

backend/app/main.py

@@ -1,10 +1,12 @@
+import os
+
 from fastapi import FastAPI
+
+from . import sanity_sync
 from .database import engine
 from .models import Base
-from .routes import recommend, admin
-from . import sanity_sync
-from .sanity_sync import start_scheduler, shutdown_scheduler
-import os
+from .routes import admin, recommend
+from .sanity_sync import start_scheduler
 
 app = FastAPI(title='Stack Recommender')
 

backend/app/models.py

@@ -1,6 +1,5 @@
-from sqlalchemy import Column, Integer, String, Float, ForeignKey, Text, DateTime
-from sqlalchemy.orm import relationship, declarative_base
-from datetime import datetime
+from sqlalchemy import Column, Float, ForeignKey, Integer, String, Text
+from sqlalchemy.orm import declarative_base, relationship
 
 Base = declarative_base()
 

backend/app/recommender.py

@@ -1,8 +1,10 @@
+
 from sqlalchemy.orm import Session
+
 from .models import Technology
-from typing import List, Dict
 
-def calculate_score_for_tech(tech: Technology, user_weights: Dict[str, float]) -> float:
+
+def calculate_score_for_tech(tech: Technology, user_weights: dict[str, float]) -> float:
     total_score = 0.0
     total_weights = sum(user_weights.values()) if user_weights else 0.0
 
@@ -15,7 +17,7 @@ def calculate_score_for_tech(tech: Technology, user_weights: Dict[str, float]) -
         return 0.0
     return total_score / total_weights
 
-def get_recommendations(db: Session, user_weights: Dict[str, float], top_n: int = 3) -> List[Dict]:
+def get_recommendations(db: Session, user_weights: dict[str, float], top_n: int = 3) -> list[dict]:
     technologies = db.query(Technology).all()
     results = []
 

backend/app/routes/admin.py

@@ -1,5 +1,7 @@
-from fastapi import APIRouter, BackgroundTasks, Request, HTTPException
 import os
+
+from fastapi import APIRouter, BackgroundTasks, HTTPException, Request
+
 from .. import sanity_sync
 
 router = APIRouter()

backend/app/routes/recommend.py

@@ -1,8 +1,9 @@
-from fastapi import APIRouter, Depends, HTTPException, Header
+from fastapi import APIRouter, Depends, Header
 from sqlalchemy.orm import Session
+
+from .. import ai_client, recommender
 from ..database import get_db
-from .. import recommender, ai_client
-from ..schemas import UserWeights, RecommendationResponse, RecommendationItem
+from ..schemas import RecommendationItem, RecommendationResponse, UserWeights
 
 router = APIRouter()
 

backend/app/sanity_sync.py

@@ -1,7 +1,9 @@
 import os
+from collections.abc import Callable
+
 import requests
-from typing import Callable, Optional
 from sqlalchemy.orm import Session
+
 from .database import SessionLocal
 from .models import Category, Technology
 
@@ -67,7 +69,7 @@ def sync():
 except ImportError:
     _APScheduler = None
 
-_scheduler: Optional[object] = None
+_scheduler: object | None = None
 
 
 def start_scheduler(job_func: Callable):