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/services/health_service.py

@@ -1,5 +1,5 @@
 # [DEF:health_service:Module]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @SEMANTICS: health, aggregation, dashboards
 # @PURPOSE: Business logic for aggregating dashboard health status from validation records.
 # @LAYER: Domain/Service
@@ -20,7 +20,7 @@ from ..core.task_manager.cleanup import TaskCleanupService
 from ..core.task_manager import TaskManager
 
 # [DEF:HealthService:Class]
-# @TIER: STANDARD
+# @COMPLEXITY: 4
 # @PURPOSE: Aggregate latest dashboard validation state and manage persisted health report lifecycle.
 # @RELATION: [DEPENDS_ON] ->[backend.src.models.llm.ValidationRecord]
 # @RELATION: [DEPENDS_ON] ->[backend.src.schemas.health.DashboardHealthItem]
@@ -35,7 +35,7 @@ class HealthService:
     @PURPOSE: Service for managing and querying dashboard health data.
     """
     # [DEF:HealthService.__init__:Function]
-    # @TIER: STANDARD
+    # @COMPLEXITY: 3
     # @PURPOSE: Initialize health service with DB session and optional config access for dashboard metadata resolution.
     # @PRE: db is a valid SQLAlchemy session.
     # @POST: Service is ready to aggregate summaries and delete health reports.
@@ -46,7 +46,7 @@ class HealthService:
     # [/DEF:HealthService.__init__:Function]
 
     # [DEF:HealthService._prime_dashboard_meta_cache:Function]
-    # @TIER: STANDARD
+    # @COMPLEXITY: 3
     # @PURPOSE: Warm dashboard slug/title cache with one Superset list fetch per environment.
     # @PRE: records may contain mixed numeric and slug dashboard identifiers.
     # @POST: Numeric dashboard ids for known environments are cached when discoverable.
@@ -127,7 +127,7 @@ class HealthService:
     # [/DEF:HealthService._prime_dashboard_meta_cache:Function]
 
     # [DEF:HealthService._resolve_dashboard_meta:Function]
-    # @TIER: TRIVIAL
+    # @COMPLEXITY: 1
     # @PURPOSE: Resolve slug/title for a dashboard referenced by persisted validation record.
     # @PRE: dashboard_id may be numeric or slug-like; environment_id may be empty.
     # @POST: Returns dict with `slug` and `title` keys, using cache when possible.
@@ -154,7 +154,7 @@ class HealthService:
     # [/DEF:HealthService._resolve_dashboard_meta:Function]
 
     # [DEF:HealthService.get_health_summary:Function]
-    # @TIER: STANDARD
+    # @COMPLEXITY: 3
     # @PURPOSE: Aggregate latest validation status per dashboard and enrich rows with dashboard slug/title.
     # @PRE: environment_id may be omitted to aggregate across all environments.
     # @POST: Returns HealthSummaryResponse with counts and latest record row per dashboard.
@@ -232,7 +232,7 @@ class HealthService:
     # [/DEF:HealthService.get_health_summary:Function]
 
     # [DEF:HealthService.delete_validation_report:Function]
-    # @TIER: STANDARD
+    # @COMPLEXITY: 3
     # @PURPOSE: Delete one persisted health report and optionally clean linked task/log artifacts.
     # @PRE: record_id is a validation record identifier.
     # @POST: Returns True only when a matching record was deleted.