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/settings.py

@@ -1,6 +1,6 @@
 # [DEF:SettingsRouter:Module]
 #
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @SEMANTICS: settings, api, router, fastapi
 # @PURPOSE:   Provides API endpoints for managing application settings and Superset environments.
 # @LAYER:     UI (API)
@@ -29,7 +29,7 @@ from sqlalchemy.orm import Session
 # [/SECTION]
 
 # [DEF:LoggingConfigResponse:Class]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: Response model for logging configuration with current task log level.
 # @SEMANTICS: logging, config, response
 class LoggingConfigResponse(BaseModel):
@@ -42,7 +42,7 @@ router = APIRouter()
 
 
 # [DEF:_normalize_superset_env_url:Function]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: Canonicalize Superset environment URL to base host/path without trailing /api/v1.
 # @PRE: raw_url can be empty.
 # @POST: Returns normalized base URL.
@@ -55,7 +55,7 @@ def _normalize_superset_env_url(raw_url: str) -> str:
 
 
 # [DEF:_validate_superset_connection_fast:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Run lightweight Superset connectivity validation without full pagination scan.
 # @PRE: env contains valid URL and credentials.
 # @POST: Raises on auth/API failures; returns None on success.
@@ -74,7 +74,7 @@ def _validate_superset_connection_fast(env: Environment) -> None:
 # [/DEF:_validate_superset_connection_fast:Function]
 
 # [DEF:get_settings:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Retrieves all application settings.
 # @PRE:     Config manager is available.
 # @POST:    Returns masked AppConfig.
@@ -96,7 +96,7 @@ async def get_settings(
 # [/DEF:get_settings:Function]
 
 # [DEF:update_global_settings:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Updates global application settings.
 # @PRE:     New settings are provided.
 # @POST:    Global settings are updated.
@@ -116,7 +116,7 @@ async def update_global_settings(
 # [/DEF:update_global_settings:Function]
 
 # [DEF:get_storage_settings:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Retrieves storage-specific settings.
 # @RETURN: StorageConfig - The storage configuration.
 @router.get("/storage", response_model=StorageConfig)
@@ -129,7 +129,7 @@ async def get_storage_settings(
 # [/DEF:get_storage_settings:Function]
 
 # [DEF:update_storage_settings:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Updates storage-specific settings.
 # @PARAM: storage (StorageConfig) - The new storage settings.
 # @POST: Storage settings are updated and saved.
@@ -152,7 +152,7 @@ async def update_storage_settings(
 # [/DEF:update_storage_settings:Function]
 
 # [DEF:get_environments:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Lists all configured Superset environments.
 # @PRE:     Config manager is available.
 # @POST:    Returns list of environments.
@@ -172,7 +172,7 @@ async def get_environments(
 # [/DEF:get_environments:Function]
 
 # [DEF:add_environment:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Adds a new Superset environment.
 # @PRE:     Environment data is valid and reachable.
 # @POST:    Environment is added to config.
@@ -200,7 +200,7 @@ async def add_environment(
 # [/DEF:add_environment:Function]
 
 # [DEF:update_environment:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Updates an existing Superset environment.
 # @PRE:     ID and valid environment data are provided.
 # @POST:    Environment is updated in config.
@@ -238,7 +238,7 @@ async def update_environment(
 # [/DEF:update_environment:Function]
 
 # [DEF:delete_environment:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Deletes a Superset environment.
 # @PRE:     ID is provided.
 # @POST:    Environment is removed from config.
@@ -255,7 +255,7 @@ async def delete_environment(
 # [/DEF:delete_environment:Function]
 
 # [DEF:test_environment_connection:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Tests the connection to a Superset environment.
 # @PRE:     ID is provided.
 # @POST:    Returns success or error status.
@@ -285,7 +285,7 @@ async def test_environment_connection(
 # [/DEF:test_environment_connection:Function]
 
 # [DEF:get_logging_config:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Retrieves current logging configuration.
 # @PRE:     Config manager is available.
 # @POST:    Returns logging configuration.
@@ -305,7 +305,7 @@ async def get_logging_config(
 # [/DEF:get_logging_config:Function]
 
 # [DEF:update_logging_config:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Updates logging configuration.
 # @PRE:     New logging config is provided.
 # @POST:    Logging configuration is updated and saved.
@@ -333,7 +333,7 @@ async def update_logging_config(
 # [/DEF:update_logging_config:Function]
 
 # [DEF:ConsolidatedSettingsResponse:Class]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: Response model for consolidated application settings.
 class ConsolidatedSettingsResponse(BaseModel):
     environments: List[dict]
@@ -346,7 +346,7 @@ class ConsolidatedSettingsResponse(BaseModel):
 # [/DEF:ConsolidatedSettingsResponse:Class]
 
 # [DEF:get_consolidated_settings:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Retrieves all settings categories in a single call
 # @PRE:     Config manager is available.
 # @POST:    Returns all consolidated settings.
@@ -400,7 +400,7 @@ async def get_consolidated_settings(
 # [/DEF:get_consolidated_settings:Function]
 
 # [DEF:update_consolidated_settings:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Bulk update application settings from the consolidated view.
 # @PRE:     User has admin permissions, config is valid.
 # @POST:    Settings are updated and saved via ConfigManager.
@@ -446,7 +446,7 @@ async def update_consolidated_settings(
 # [/DEF:update_consolidated_settings:Function]
 
 # [DEF:get_validation_policies:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Lists all validation policies.
 # @RETURN: List[ValidationPolicyResponse] - List of policies.
 @router.get("/automation/policies", response_model=List[ValidationPolicyResponse])
@@ -459,7 +459,7 @@ async def get_validation_policies(
 # [/DEF:get_validation_policies:Function]
 
 # [DEF:create_validation_policy:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Creates a new validation policy.
 # @PARAM: policy (ValidationPolicyCreate) - The policy data.
 # @RETURN: ValidationPolicyResponse - The created policy.
@@ -478,7 +478,7 @@ async def create_validation_policy(
 # [/DEF:create_validation_policy:Function]
 
 # [DEF:update_validation_policy:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Updates an existing validation policy.
 # @PARAM: id (str) - The ID of the policy to update.
 # @PARAM: policy (ValidationPolicyUpdate) - The updated policy data.
@@ -505,7 +505,7 @@ async def update_validation_policy(
 # [/DEF:update_validation_policy:Function]
 
 # [DEF:delete_validation_policy:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Deletes a validation policy.
 # @PARAM: id (str) - The ID of the policy to delete.
 @router.delete("/automation/policies/{id}")