fix: linting #737

Author: MillenniumFalconMechanic

backend/controllers/facets_controller.py

@@ -2,7 +2,7 @@
 from pydantic import BaseModel
 
 from backend.services.facets_service import compute_facets_from_query
-from backend.services.facets_service import FacetsResponse
+from backend.services.models import FacetsResponse
 
 from backend.controllers.models import FacetsRequest
 
@@ -11,7 +11,7 @@
 
 @router.post("")
 def get_facets(payload: FacetsRequest) -> FacetsResponse:
-    # NOTE: Stubbed PoC implementation. This will be replaced by
-    # LLM-backed intent parsing and real facet resolution in a later step.
-    # For now, delegate to the service layer so the controller stays thin.
+    """
+    Return a stubbed query-to-facets response for PoC purposes.
+    """
     return compute_facets_from_query()

backend/controllers/models.py

@@ -1,6 +1,11 @@
 from pydantic import BaseModel
 
 
-# Model of the request body for the /api/v0/facets endpoint.
 class FacetsRequest(BaseModel):
+    """
+    Request model for the /api/v0/facets endpoint.
+    Attributes:
+        query (str): The search query string to retrieve facets for.
+    """
+
     query: str

backend/services/facets_service.py

@@ -1,8 +1,5 @@
 from __future__ import annotations
 
-from pydantic import BaseModel
-
-
 from backend.services.models import FacetsResponse
 
 

backend/services/models.py

@@ -10,6 +10,7 @@ class SelectedValue(BaseModel):
         term (str): The resolved facet value.
         mention (str): The original query text that resolved to the value.
     """
+
     term: str
     mention: str
 
@@ -23,6 +24,7 @@ class FacetSelection(BaseModel):
         facet (str): The name of the facet.
         selectedValues (list[SelectedValue]): The list of selected values for this facet.
     """
+
     facet: str
     selectedValues: list[SelectedValue]
 
@@ -36,5 +38,6 @@ class FacetsResponse(BaseModel):
         query (str): The original query string.
         facets (list[FacetSelection]): The list of selected facets and their values.
     """
+
     query: str
     facets: list[FacetSelection]