refactor(semantics): migrate legacy @TIER to @COMPLEXITY annotations

- Replaced @TIER: TRIVIAL with @COMPLEXITY: 1
- Replaced @TIER: STANDARD with @COMPLEXITY: 3
- Replaced @TIER: CRITICAL with @COMPLEXITY: 5
- Manually elevated specific critical/complex components to levels 2 and 4
- Ignored legacy, specs, and node_modules directories
- Updated generated semantic map

backend/src/api/routes/datasets.py

@@ -1,6 +1,6 @@
 # [DEF:backend.src.api.routes.datasets:Module]
 #
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @SEMANTICS: api, datasets, resources, hub
 # @PURPOSE:   API endpoints for the Dataset Hub - listing datasets with mapping progress
 # @LAYER:     API
@@ -22,7 +22,7 @@ from ...core.superset_client import SupersetClient
 router = APIRouter(prefix="/api/datasets", tags=["Datasets"])
 
 # [DEF:MappedFields:DataClass]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: DTO for dataset mapping progress statistics
 class MappedFields(BaseModel):
     total: int
@@ -30,7 +30,7 @@ class MappedFields(BaseModel):
 # [/DEF:MappedFields:DataClass]
 
 # [DEF:LastTask:DataClass]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: DTO for the most recent task associated with a dataset
 class LastTask(BaseModel):
     task_id: Optional[str] = None
@@ -38,7 +38,7 @@ class LastTask(BaseModel):
 # [/DEF:LastTask:DataClass]
 
 # [DEF:DatasetItem:DataClass]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: Summary DTO for a dataset in the hub listing
 class DatasetItem(BaseModel):
     id: int
@@ -53,7 +53,7 @@ class DatasetItem(BaseModel):
 # [/DEF:DatasetItem:DataClass]
 
 # [DEF:LinkedDashboard:DataClass]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: DTO for a dashboard linked to a dataset
 class LinkedDashboard(BaseModel):
     id: int
@@ -62,7 +62,7 @@ class LinkedDashboard(BaseModel):
 # [/DEF:LinkedDashboard:DataClass]
 
 # [DEF:DatasetColumn:DataClass]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: DTO for a single dataset column's metadata
 class DatasetColumn(BaseModel):
     id: int
@@ -74,7 +74,7 @@ class DatasetColumn(BaseModel):
 # [/DEF:DatasetColumn:DataClass]
 
 # [DEF:DatasetDetailResponse:DataClass]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: Detailed DTO for a dataset including columns and links
 class DatasetDetailResponse(BaseModel):
     id: int
@@ -96,7 +96,7 @@ class DatasetDetailResponse(BaseModel):
 # [/DEF:DatasetDetailResponse:DataClass]
 
 # [DEF:DatasetsResponse:DataClass]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: Paginated response DTO for dataset listings
 class DatasetsResponse(BaseModel):
     datasets: List[DatasetItem]
@@ -107,14 +107,14 @@ class DatasetsResponse(BaseModel):
 # [/DEF:DatasetsResponse:DataClass]
 
 # [DEF:TaskResponse:DataClass]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: Response DTO containing a task ID for tracking
 class TaskResponse(BaseModel):
     task_id: str
 # [/DEF:TaskResponse:DataClass]
 
 # [DEF:get_dataset_ids:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Fetch list of all dataset IDs from a specific environment (without pagination)
 # @PRE: env_id must be a valid environment ID
 # @POST: Returns a list of all dataset IDs
@@ -166,7 +166,7 @@ async def get_dataset_ids(
 # [/DEF:get_dataset_ids:Function]
 
 # [DEF:get_datasets:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Fetch list of datasets from a specific environment with mapping progress
 # @PRE: env_id must be a valid environment ID
 # @PRE: page must be >= 1 if provided
@@ -246,7 +246,7 @@ async def get_datasets(
 # [/DEF:get_datasets:Function]
 
 # [DEF:MapColumnsRequest:DataClass]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: Request DTO for initiating column mapping
 class MapColumnsRequest(BaseModel):
     env_id: str = Field(..., description="Environment ID")
@@ -257,7 +257,7 @@ class MapColumnsRequest(BaseModel):
 # [/DEF:MapColumnsRequest:DataClass]
 
 # [DEF:map_columns:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Trigger bulk column mapping for datasets
 # @PRE: User has permission plugin:mapper:execute
 # @PRE: env_id is a valid environment ID
@@ -319,7 +319,7 @@ async def map_columns(
 # [/DEF:map_columns:Function]
 
 # [DEF:GenerateDocsRequest:DataClass]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: Request DTO for initiating documentation generation
 class GenerateDocsRequest(BaseModel):
     env_id: str = Field(..., description="Environment ID")
@@ -329,7 +329,7 @@ class GenerateDocsRequest(BaseModel):
 # [/DEF:GenerateDocsRequest:DataClass]
 
 # [DEF:generate_docs:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Trigger bulk documentation generation for datasets
 # @PRE: User has permission plugin:llm_analysis:execute
 # @PRE: env_id is a valid environment ID
@@ -385,7 +385,7 @@ async def generate_docs(
 # [/DEF:generate_docs:Function]
 
 # [DEF:get_dataset_detail:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Get detailed dataset information including columns and linked dashboards
 # @PRE: env_id is a valid environment ID
 # @PRE: dataset_id is a valid dataset ID