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/__tests__/test_assistant_api.py

@@ -1,5 +1,5 @@
 # [DEF:backend.src.api.routes.__tests__.test_assistant_api:Module]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @SEMANTICS: tests, assistant, api, confirmation, status
 # @PURPOSE: Validate assistant API endpoint logic via direct async handler invocation.
 # @LAYER: UI (API Tests)
@@ -26,7 +26,7 @@ from src.models.assistant import (
 
 
 # [DEF:_run_async:Function]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: Execute async endpoint handler in synchronous test context.
 # @PRE: coroutine is awaitable endpoint invocation.
 # @POST: Returns coroutine result or raises propagated exception.
@@ -36,7 +36,7 @@ def _run_async(coroutine):
 
 # [/DEF:_run_async:Function]
 # [DEF:_FakeTask:Class]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: Lightweight task stub used by assistant API tests.
 class _FakeTask:
     def __init__(self, task_id: str, status: str = "RUNNING", user_id: str = "u-admin"):
@@ -47,7 +47,7 @@ class _FakeTask:
 
 # [/DEF:_FakeTask:Class]
 # [DEF:_FakeTaskManager:Class]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: Minimal async-compatible TaskManager fixture for deterministic test flows.
 class _FakeTaskManager:
     def __init__(self):
@@ -71,7 +71,7 @@ class _FakeTaskManager:
 
 # [/DEF:_FakeTaskManager:Class]
 # [DEF:_FakeConfigManager:Class]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: Environment config fixture with dev/prod aliases for parser tests.
 class _FakeConfigManager:
     def get_environments(self):
@@ -87,7 +87,7 @@ class _FakeConfigManager:
         )
 # [/DEF:_FakeConfigManager:Class]
 # [DEF:_admin_user:Function]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: Build admin principal fixture.
 # @PRE: Test harness requires authenticated admin-like principal object.
 # @POST: Returns user stub with Admin role.
@@ -98,7 +98,7 @@ def _admin_user():
 
 # [/DEF:_admin_user:Function]
 # [DEF:_limited_user:Function]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: Build non-admin principal fixture.
 # @PRE: Test harness requires restricted principal for deny scenarios.
 # @POST: Returns user stub without admin privileges.
@@ -109,7 +109,7 @@ def _limited_user():
 
 # [/DEF:_limited_user:Function]
 # [DEF:_FakeQuery:Class]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: Minimal chainable query object for fake SQLAlchemy-like DB behavior in tests.
 class _FakeQuery:
     def __init__(self, rows):
@@ -141,7 +141,7 @@ class _FakeQuery:
 
 # [/DEF:_FakeQuery:Class]
 # [DEF:_FakeDb:Class]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: In-memory fake database implementing subset of Session interface used by assistant routes.
 class _FakeDb:
     def __init__(self):
@@ -191,7 +191,7 @@ class _FakeDb:
 
 # [/DEF:_FakeDb:Class]
 # [DEF:_clear_assistant_state:Function]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: Reset in-memory assistant registries for isolation between tests.
 # @PRE: Assistant module globals may contain residues from previous test runs.
 # @POST: In-memory conversation/confirmation/audit dictionaries are empty.

backend/src/api/routes/__tests__/test_assistant_authz.py

@@ -1,5 +1,5 @@
 # [DEF:backend.src.api.routes.__tests__.test_assistant_authz:Module]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @SEMANTICS: tests, assistant, authz, confirmation, rbac
 # @PURPOSE: Verify assistant confirmation ownership, expiration, and deny behavior for restricted users.
 # @LAYER: UI (API Tests)
@@ -28,7 +28,7 @@ from src.models.assistant import (
 
 
 # [DEF:_run_async:Function]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: Execute async endpoint handler in synchronous test context.
 # @PRE: coroutine is awaitable endpoint invocation.
 # @POST: Returns coroutine result or raises propagated exception.
@@ -38,7 +38,7 @@ def _run_async(coroutine):
 
 # [/DEF:_run_async:Function]
 # [DEF:_FakeTask:Class]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: Lightweight task model used for assistant authz tests.
 class _FakeTask:
     def __init__(self, task_id: str, status: str = "RUNNING", user_id: str = "u-admin"):
@@ -49,7 +49,7 @@ class _FakeTask:
 
 # [/DEF:_FakeTask:Class]
 # [DEF:_FakeTaskManager:Class]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: Minimal task manager for deterministic operation creation and lookup.
 class _FakeTaskManager:
     def __init__(self):
@@ -73,7 +73,7 @@ class _FakeTaskManager:
 
 # [/DEF:_FakeTaskManager:Class]
 # [DEF:_FakeConfigManager:Class]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: Provide deterministic environment aliases required by intent parsing.
 class _FakeConfigManager:
     def get_environments(self):
@@ -85,7 +85,7 @@ class _FakeConfigManager:
 
 # [/DEF:_FakeConfigManager:Class]
 # [DEF:_admin_user:Function]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: Build admin principal fixture.
 # @PRE: Test requires privileged principal for risky operations.
 # @POST: Returns admin-like user stub with Admin role.
@@ -96,7 +96,7 @@ def _admin_user():
 
 # [/DEF:_admin_user:Function]
 # [DEF:_other_admin_user:Function]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: Build second admin principal fixture for ownership tests.
 # @PRE: Ownership mismatch scenario needs distinct authenticated actor.
 # @POST: Returns alternate admin-like user stub.
@@ -107,7 +107,7 @@ def _other_admin_user():
 
 # [/DEF:_other_admin_user:Function]
 # [DEF:_limited_user:Function]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: Build limited principal without required assistant execution privileges.
 # @PRE: Permission denial scenario needs non-admin actor.
 # @POST: Returns restricted user stub.
@@ -118,7 +118,7 @@ def _limited_user():
 
 # [/DEF:_limited_user:Function]
 # [DEF:_FakeQuery:Class]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: Minimal chainable query object for fake DB interactions.
 class _FakeQuery:
     def __init__(self, rows):
@@ -150,7 +150,7 @@ class _FakeQuery:
 
 # [/DEF:_FakeQuery:Class]
 # [DEF:_FakeDb:Class]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: In-memory session substitute for assistant route persistence calls.
 class _FakeDb:
     def __init__(self):
@@ -197,7 +197,7 @@ class _FakeDb:
 
 # [/DEF:_FakeDb:Class]
 # [DEF:_clear_assistant_state:Function]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: Reset assistant process-local state between test cases.
 # @PRE: Assistant globals may contain state from prior tests.
 # @POST: Assistant in-memory state dictionaries are cleared.

backend/src/api/routes/__tests__/test_clean_release_api.py

@@ -1,5 +1,5 @@
 # [DEF:backend.tests.api.routes.test_clean_release_api:Module]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @SEMANTICS: tests, api, clean-release, checks, reports
 # @PURPOSE: Contract tests for clean release checks and reports endpoints.
 # @LAYER: Domain

backend/src/api/routes/__tests__/test_clean_release_legacy_compat.py

@@ -1,5 +1,5 @@
 # [DEF:backend.src.api.routes.__tests__.test_clean_release_legacy_compat:Module]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Compatibility tests for legacy clean-release API paths retained during v2 migration.
 # @LAYER: Tests
 # @RELATION: TESTS -> backend.src.api.routes.clean_release

backend/src/api/routes/__tests__/test_clean_release_source_policy.py

@@ -1,5 +1,5 @@
 # [DEF:backend.tests.api.routes.test_clean_release_source_policy:Module]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @SEMANTICS: tests, api, clean-release, source-policy
 # @PURPOSE: Validate API behavior for source isolation violations in clean release preparation.
 # @LAYER: Domain

backend/src/api/routes/__tests__/test_clean_release_v2_api.py

@@ -1,5 +1,5 @@
 # [DEF:test_clean_release_v2_api:Module]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: API contract tests for redesigned clean release endpoints.
 # @LAYER: Domain
 

backend/src/api/routes/__tests__/test_clean_release_v2_release_api.py

@@ -1,5 +1,5 @@
 # [DEF:test_clean_release_v2_release_api:Module]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: API contract test scaffolding for clean release approval and publication endpoints.
 # @LAYER: Domain
 # @RELATION: IMPLEMENTS -> clean_release_v2_release_api_contracts

backend/src/api/routes/__tests__/test_connections_routes.py

@@ -1,5 +1,5 @@
 # [DEF:backend.src.api.routes.__tests__.test_connections_routes:Module]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Verifies connection routes bootstrap their table before CRUD access.
 # @LAYER: API
 # @RELATION: VERIFIES -> backend.src.api.routes.connections

backend/src/api/routes/__tests__/test_dashboards.py

@@ -1,5 +1,5 @@
 # [DEF:backend.src.api.routes.__tests__.test_dashboards:Module]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Unit tests for Dashboards API endpoints
 # @LAYER: API
 # @RELATION: TESTS -> backend.src.api.routes.dashboards

backend/src/api/routes/__tests__/test_datasets.py

@@ -1,5 +1,5 @@
 # [DEF:backend.src.api.routes.__tests__.test_datasets:Module]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @SEMANTICS: datasets, api, tests, pagination, mapping, docs
 # @PURPOSE: Unit tests for Datasets API endpoints
 # @LAYER: API

backend/src/api/routes/__tests__/test_git_status_route.py

@@ -1,5 +1,5 @@
 # [DEF:backend.src.api.routes.__tests__.test_git_status_route:Module]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @SEMANTICS: tests, git, api, status, no_repo
 # @PURPOSE: Validate status endpoint behavior for missing and error repository states.
 # @LAYER: Domain (Tests)

backend/src/api/routes/__tests__/test_migration_routes.py

@@ -1,6 +1,6 @@
 # [DEF:backend.src.api.routes.__tests__.test_migration_routes:Module]
 #
-# @TIER:      STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE:   Unit tests for migration API route handlers.
 # @LAYER:     API
 # @RELATION:  VERIFIES -> backend.src.api.routes.migration

backend/src/api/routes/__tests__/test_profile_api.py

@@ -1,5 +1,5 @@
 # [DEF:backend.src.api.routes.__tests__.test_profile_api:Module]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @SEMANTICS: tests, profile, api, preferences, lookup, contract
 # @PURPOSE: Verifies profile API route contracts for preference read/update and Superset account lookup.
 # @LAYER: API

backend/src/api/routes/__tests__/test_reports_api.py

@@ -1,5 +1,5 @@
 # [DEF:backend.tests.test_reports_api:Module]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @SEMANTICS: tests, reports, api, contract, pagination, filtering
 # @PURPOSE: Contract tests for GET /api/reports defaults, pagination, and filtering behavior.
 # @LAYER: Domain (Tests)

backend/src/api/routes/__tests__/test_reports_detail_api.py

@@ -1,5 +1,5 @@
 # [DEF:backend.tests.test_reports_detail_api:Module]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @SEMANTICS: tests, reports, api, detail, diagnostics
 # @PURPOSE: Contract tests for GET /api/reports/{report_id} detail endpoint behavior.
 # @LAYER: Domain (Tests)

backend/src/api/routes/__tests__/test_reports_openapi_conformance.py

@@ -1,5 +1,5 @@
 # [DEF:backend.tests.test_reports_openapi_conformance:Module]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @SEMANTICS: tests, reports, openapi, conformance
 # @PURPOSE: Validate implemented reports payload shape against OpenAPI-required top-level contract fields.
 # @LAYER: Domain (Tests)