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/core/database.py

@@ -1,6 +1,6 @@
 # [DEF:backend.src.core.database:Module]
 #
-# @TIER:      STANDARD
+# @COMPLEXITY: 3
 # @SEMANTICS: database, postgresql, sqlalchemy, session, persistence
 # @PURPOSE:   Configures database connection and session management (PostgreSQL-first).
 # @LAYER:     Core
@@ -31,13 +31,13 @@ from pathlib import Path
 # [/SECTION]
 
 # [DEF:BASE_DIR:Variable]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: Base directory for the backend.
 BASE_DIR = Path(__file__).resolve().parent.parent.parent
 # [/DEF:BASE_DIR:Variable]
 
 # [DEF:DATABASE_URL:Constant]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: URL for the main application database.
 DEFAULT_POSTGRES_URL = os.getenv(
     "POSTGRES_URL",
@@ -47,20 +47,20 @@ DATABASE_URL = os.getenv("DATABASE_URL", DEFAULT_POSTGRES_URL)
 # [/DEF:DATABASE_URL:Constant]
 
 # [DEF:TASKS_DATABASE_URL:Constant]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: URL for the tasks execution database.
 # Defaults to DATABASE_URL to keep task logs in the same PostgreSQL instance.
 TASKS_DATABASE_URL = os.getenv("TASKS_DATABASE_URL", DATABASE_URL)
 # [/DEF:TASKS_DATABASE_URL:Constant]
 
 # [DEF:AUTH_DATABASE_URL:Constant]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: URL for the authentication database.
 AUTH_DATABASE_URL = os.getenv("AUTH_DATABASE_URL", auth_config.AUTH_DATABASE_URL)
 # [/DEF:AUTH_DATABASE_URL:Constant]
 
 # [DEF:engine:Variable]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: SQLAlchemy engine for mappings database.
 # @SIDE_EFFECT: Creates database engine and manages connection pool.
 def _build_engine(db_url: str):
@@ -73,40 +73,40 @@ engine = _build_engine(DATABASE_URL)
 # [/DEF:engine:Variable]
 
 # [DEF:tasks_engine:Variable]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: SQLAlchemy engine for tasks database.
 tasks_engine = _build_engine(TASKS_DATABASE_URL)
 # [/DEF:tasks_engine:Variable]
 
 # [DEF:auth_engine:Variable]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: SQLAlchemy engine for authentication database.
 auth_engine = _build_engine(AUTH_DATABASE_URL)
 # [/DEF:auth_engine:Variable]
 
 # [DEF:SessionLocal:Class]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: A session factory for the main mappings database.
 # @PRE: engine is initialized.
 SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)
 # [/DEF:SessionLocal:Class]
 
 # [DEF:TasksSessionLocal:Class]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: A session factory for the tasks execution database.
 # @PRE: tasks_engine is initialized.
 TasksSessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=tasks_engine)
 # [/DEF:TasksSessionLocal:Class]
 
 # [DEF:AuthSessionLocal:Class]
-# @TIER: TRIVIAL
+# @COMPLEXITY: 1
 # @PURPOSE: A session factory for the authentication database.
 # @PRE: auth_engine is initialized.
 AuthSessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=auth_engine)
 # [/DEF:AuthSessionLocal:Class]
 
 # [DEF:_ensure_user_dashboard_preferences_columns:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Applies additive schema upgrades for user_dashboard_preferences table.
 # @PRE: bind_engine points to application database where profile table is stored.
 # @POST: Missing columns are added without data loss.
@@ -173,7 +173,7 @@ def _ensure_user_dashboard_preferences_columns(bind_engine):
 
 
 # [DEF:_ensure_user_dashboard_preferences_health_columns:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Applies additive schema upgrades for user_dashboard_preferences table (health fields).
 def _ensure_user_dashboard_preferences_health_columns(bind_engine):
     with belief_scope("_ensure_user_dashboard_preferences_health_columns"):
@@ -217,7 +217,7 @@ def _ensure_user_dashboard_preferences_health_columns(bind_engine):
 
 
 # [DEF:_ensure_llm_validation_results_columns:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Applies additive schema upgrades for llm_validation_results table.
 def _ensure_llm_validation_results_columns(bind_engine):
     with belief_scope("_ensure_llm_validation_results_columns"):
@@ -257,7 +257,7 @@ def _ensure_llm_validation_results_columns(bind_engine):
 
 
 # [DEF:_ensure_git_server_configs_columns:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Applies additive schema upgrades for git_server_configs table.
 # @PRE: bind_engine points to application database.
 # @POST: Missing columns are added without data loss.
@@ -295,7 +295,7 @@ def _ensure_git_server_configs_columns(bind_engine):
 
 
 # [DEF:ensure_connection_configs_table:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Ensures the external connection registry table exists in the main database.
 # @PRE: bind_engine points to the application database.
 # @POST: connection_configs table exists without dropping existing data.
@@ -313,7 +313,7 @@ def ensure_connection_configs_table(bind_engine):
 
 
 # [DEF:init_db:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Initializes the database by creating all tables.
 # @PRE: engine, tasks_engine and auth_engine are initialized.
 # @POST: Database tables created in all databases.
@@ -331,7 +331,7 @@ def init_db():
 # [/DEF:init_db:Function]
 
 # [DEF:get_db:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Dependency for getting a database session.
 # @PRE: SessionLocal is initialized.
 # @POST:    Session is closed after use.
@@ -346,7 +346,7 @@ def get_db():
 # [/DEF:get_db:Function]
 
 # [DEF:get_tasks_db:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Dependency for getting a tasks database session.
 # @PRE: TasksSessionLocal is initialized.
 # @POST:    Session is closed after use.
@@ -361,7 +361,7 @@ def get_tasks_db():
 # [/DEF:get_tasks_db:Function]
 
 # [DEF:get_auth_db:Function]
-# @TIER: STANDARD
+# @COMPLEXITY: 3
 # @PURPOSE: Dependency for getting an authentication database session.
 # @PRE: AuthSessionLocal is initialized.
 # @POST: Session is closed after use.