fix: finalize semantic repair and test updates

backend/src/api/routes/connections.py

@@ -1,8 +1,9 @@
 # [DEF:ConnectionsRouter:Module]
 # @SEMANTICS: api, router, connections, database
 # @PURPOSE: Defines the FastAPI router for managing external database connections.
+# @COMPLEXITY: 3
 # @LAYER: UI (API)
-# @RELATION: Depends on SQLAlchemy session.
+# @RELATION: DEPENDS_ON -> Session
 # @CONSTRAINT: Must use belief_scope for logging.
 
 # [SECTION: IMPORTS]
@@ -21,15 +22,22 @@ router = APIRouter()
 
 # [DEF:_ensure_connections_schema:Function]
 # @PURPOSE: Ensures the connection_configs table exists before CRUD access.
+# @COMPLEXITY: 3
 # @PRE: db is an active SQLAlchemy session.
 # @POST: The current bind can safely query ConnectionConfig.
+# @RELATION: CALLS -> ensure_connection_configs_table
 def _ensure_connections_schema(db: Session):
     with belief_scope("ConnectionsRouter.ensure_schema"):
         ensure_connection_configs_table(db.get_bind())
+
+
 # [/DEF:_ensure_connections_schema:Function]
 
+
 # [DEF:ConnectionSchema:Class]
 # @PURPOSE: Pydantic model for connection response.
+# @COMPLEXITY: 3
+# @RELATION: BINDS_TO -> ConnectionConfig
 class ConnectionSchema(BaseModel):
     id: str
     name: str
@@ -42,10 +50,15 @@ class ConnectionSchema(BaseModel):
 
     class Config:
         orm_mode = True
+
+
 # [/DEF:ConnectionSchema:Class]
 
+
 # [DEF:ConnectionCreate:Class]
 # @PURPOSE: Pydantic model for creating a connection.
+# @COMPLEXITY: 3
+# @RELATION: BINDS_TO -> ConnectionConfig
 class ConnectionCreate(BaseModel):
     name: str
     type: str
@@ -54,60 +67,92 @@ class ConnectionCreate(BaseModel):
     database: Optional[str] = None
     username: Optional[str] = None
     password: Optional[str] = None
+
+
 # [/DEF:ConnectionCreate:Class]
 
+
 # [DEF:list_connections:Function]
 # @PURPOSE: Lists all saved connections.
+# @COMPLEXITY: 3
 # @PRE:     Database session is active.
 # @POST:    Returns list of connection configs.
 # @PARAM:   db (Session) - Database session.
 # @RETURN:  List[ConnectionSchema] - List of connections.
+# @RELATION: CALLS -> _ensure_connections_schema
+# @RELATION: DEPENDS_ON -> ConnectionConfig
 @router.get("", response_model=List[ConnectionSchema])
 async def list_connections(db: Session = Depends(get_db)):
     with belief_scope("ConnectionsRouter.list_connections"):
         _ensure_connections_schema(db)
         connections = db.query(ConnectionConfig).all()
         return connections
+
+
 # [/DEF:list_connections:Function]
 
+
 # [DEF:create_connection:Function]
 # @PURPOSE: Creates a new connection configuration.
+# @COMPLEXITY: 3
 # @PRE:     Connection name is unique.
 # @POST:    Connection is saved to DB.
 # @PARAM:   connection (ConnectionCreate) - Config data.
 # @PARAM:   db (Session) - Database session.
 # @RETURN:  ConnectionSchema - Created connection.
+# @RELATION: CALLS -> _ensure_connections_schema
+# @RELATION: DEPENDS_ON -> ConnectionConfig
 @router.post("", response_model=ConnectionSchema, status_code=status.HTTP_201_CREATED)
-async def create_connection(connection: ConnectionCreate, db: Session = Depends(get_db)):
+async def create_connection(
+    connection: ConnectionCreate, db: Session = Depends(get_db)
+):
     with belief_scope("ConnectionsRouter.create_connection", f"name={connection.name}"):
         _ensure_connections_schema(db)
         db_connection = ConnectionConfig(**connection.dict())
         db.add(db_connection)
         db.commit()
         db.refresh(db_connection)
-        logger.info(f"[ConnectionsRouter.create_connection][Success] Created connection {db_connection.id}")
+        logger.info(
+            f"[ConnectionsRouter.create_connection][Success] Created connection {db_connection.id}"
+        )
         return db_connection
+
+
 # [/DEF:create_connection:Function]
 
+
 # [DEF:delete_connection:Function]
 # @PURPOSE: Deletes a connection configuration.
+# @COMPLEXITY: 3
 # @PRE:     Connection ID exists.
 # @POST:    Connection is removed from DB.
 # @PARAM:   connection_id (str) - ID to delete.
 # @PARAM:   db (Session) - Database session.
 # @RETURN:  None.
+# @RELATION: CALLS -> _ensure_connections_schema
+# @RELATION: DEPENDS_ON -> ConnectionConfig
 @router.delete("/{connection_id}", status_code=status.HTTP_204_NO_CONTENT)
 async def delete_connection(connection_id: str, db: Session = Depends(get_db)):
     with belief_scope("ConnectionsRouter.delete_connection", f"id={connection_id}"):
         _ensure_connections_schema(db)
-        db_connection = db.query(ConnectionConfig).filter(ConnectionConfig.id == connection_id).first()
+        db_connection = (
+            db.query(ConnectionConfig)
+            .filter(ConnectionConfig.id == connection_id)
+            .first()
+        )
         if not db_connection:
-            logger.error(f"[ConnectionsRouter.delete_connection][State] Connection {connection_id} not found")
+            logger.error(
+                f"[ConnectionsRouter.delete_connection][State] Connection {connection_id} not found"
+            )
             raise HTTPException(status_code=404, detail="Connection not found")
         db.delete(db_connection)
         db.commit()
-        logger.info(f"[ConnectionsRouter.delete_connection][Success] Deleted connection {connection_id}")
+        logger.info(
+            f"[ConnectionsRouter.delete_connection][Success] Deleted connection {connection_id}"
+        )
         return
+
+
 # [/DEF:delete_connection:Function]
 
 # [/DEF:ConnectionsRouter:Module]