fix: commit semantic repair changes

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

@@ -51,10 +51,13 @@ client = TestClient(app)
 
 
 # [DEF:test_get_datasets_success:Function]
+# @RELATION: BINDS_TO -> DatasetsApiTests
 # @PURPOSE: Validate successful datasets listing contract for an existing environment.
 # @TEST: GET /api/datasets returns 200 and valid schema
 # @PRE: env_id exists
 # @POST: Response matches DatasetsResponse schema
+# [DEF:test_get_datasets_success:Function]
+# @RELATION: BINDS_TO -> DatasetsApiTests
 def test_get_datasets_success(mock_deps):
     # Mock environment
     mock_env = MagicMock()
@@ -89,10 +92,15 @@ def test_get_datasets_success(mock_deps):
 
 
 # [DEF:test_get_datasets_env_not_found:Function]
+# @RELATION: BINDS_TO -> DatasetsApiTests
 # @PURPOSE: Validate datasets listing returns 404 when the requested environment does not exist.
 # @TEST: GET /api/datasets returns 404 if env_id missing
 # @PRE: env_id does not exist
 # @POST: Returns 404 error
+# [/DEF:test_get_datasets_success:Function]
+
+# [DEF:test_get_datasets_env_not_found:Function]
+# @RELATION: BINDS_TO -> DatasetsApiTests
 def test_get_datasets_env_not_found(mock_deps):
     mock_deps["config"].get_environments.return_value = []
 
@@ -106,10 +114,15 @@ def test_get_datasets_env_not_found(mock_deps):
 
 
 # [DEF:test_get_datasets_invalid_pagination:Function]
+# @RELATION: BINDS_TO -> DatasetsApiTests
 # @PURPOSE: Validate datasets listing rejects invalid pagination parameters with 400 responses.
 # @TEST: GET /api/datasets returns 400 for invalid page/page_size
 # @PRE: page < 1 or page_size > 100
 # @POST: Returns 400 error
+# [/DEF:test_get_datasets_env_not_found:Function]
+
+# [DEF:test_get_datasets_invalid_pagination:Function]
+# @RELATION: BINDS_TO -> DatasetsApiTests
 def test_get_datasets_invalid_pagination(mock_deps):
     mock_env = MagicMock()
     mock_env.id = "prod"
@@ -135,10 +148,15 @@ def test_get_datasets_invalid_pagination(mock_deps):
 
 
 # [DEF:test_map_columns_success:Function]
+# @RELATION: BINDS_TO -> DatasetsApiTests
 # @PURPOSE: Validate map-columns request creates an async mapping task and returns its identifier.
 # @TEST: POST /api/datasets/map-columns creates mapping task
 # @PRE: Valid env_id, dataset_ids, source_type
 # @POST: Returns task_id
+# [/DEF:test_get_datasets_invalid_pagination:Function]
+
+# [DEF:test_map_columns_success:Function]
+# @RELATION: BINDS_TO -> DatasetsApiTests
 def test_map_columns_success(mock_deps):
     # Mock environment
     mock_env = MagicMock()
@@ -170,10 +188,15 @@ def test_map_columns_success(mock_deps):
 
 
 # [DEF:test_map_columns_invalid_source_type:Function]
+# @RELATION: BINDS_TO -> DatasetsApiTests
 # @PURPOSE: Validate map-columns rejects unsupported source types with a 400 contract response.
 # @TEST: POST /api/datasets/map-columns returns 400 for invalid source_type
 # @PRE: source_type is not 'postgresql' or 'xlsx'
 # @POST: Returns 400 error
+# [/DEF:test_map_columns_success:Function]
+
+# [DEF:test_map_columns_invalid_source_type:Function]
+# @RELATION: BINDS_TO -> DatasetsApiTests
 def test_map_columns_invalid_source_type(mock_deps):
     response = client.post(
         "/api/datasets/map-columns",
@@ -192,10 +215,15 @@ def test_map_columns_invalid_source_type(mock_deps):
 
 
 # [DEF:test_generate_docs_success:Function]
+# @RELATION: BINDS_TO -> DatasetsApiTests
 # @TEST: POST /api/datasets/generate-docs creates doc generation task
 # @PRE: Valid env_id, dataset_ids, llm_provider
 # @PURPOSE: Validate generate-docs request creates an async documentation task and returns its identifier.
 # @POST: Returns task_id
+# [/DEF:test_map_columns_invalid_source_type:Function]
+
+# [DEF:test_generate_docs_success:Function]
+# @RELATION: BINDS_TO -> DatasetsApiTests
 def test_generate_docs_success(mock_deps):
     # Mock environment
     mock_env = MagicMock()
@@ -227,10 +255,15 @@ def test_generate_docs_success(mock_deps):
 
 
 # [DEF:test_map_columns_empty_ids:Function]
+# @RELATION: BINDS_TO -> DatasetsApiTests
 # @PURPOSE: Validate map-columns rejects empty dataset identifier lists.
 # @TEST: POST /api/datasets/map-columns returns 400 for empty dataset_ids
 # @PRE: dataset_ids is empty
 # @POST: Returns 400 error
+# [/DEF:test_generate_docs_success:Function]
+
+# [DEF:test_map_columns_empty_ids:Function]
+# @RELATION: BINDS_TO -> DatasetsApiTests
 def test_map_columns_empty_ids(mock_deps):
     """@PRE: dataset_ids must be non-empty."""
     response = client.post(
@@ -247,10 +280,15 @@ def test_map_columns_empty_ids(mock_deps):
 
 
 # [DEF:test_generate_docs_empty_ids:Function]
+# @RELATION: BINDS_TO -> DatasetsApiTests
 # @PURPOSE: Validate generate-docs rejects empty dataset identifier lists.
 # @TEST: POST /api/datasets/generate-docs returns 400 for empty dataset_ids
 # @PRE: dataset_ids is empty
 # @POST: Returns 400 error
+# [/DEF:test_map_columns_empty_ids:Function]
+
+# [DEF:test_generate_docs_empty_ids:Function]
+# @RELATION: BINDS_TO -> DatasetsApiTests
 def test_generate_docs_empty_ids(mock_deps):
     """@PRE: dataset_ids must be non-empty."""
     response = client.post(
@@ -267,10 +305,15 @@ def test_generate_docs_empty_ids(mock_deps):
 
 
 # [DEF:test_generate_docs_env_not_found:Function]
+# @RELATION: BINDS_TO -> DatasetsApiTests
 # @TEST: POST /api/datasets/generate-docs returns 404 for missing env
 # @PRE: env_id does not exist
 # @PURPOSE: Validate generate-docs returns 404 when the requested environment cannot be resolved.
 # @POST: Returns 404 error
+# [/DEF:test_generate_docs_empty_ids:Function]
+
+# [DEF:test_generate_docs_env_not_found:Function]
+# @RELATION: BINDS_TO -> DatasetsApiTests
 def test_generate_docs_env_not_found(mock_deps):
     """@PRE: env_id must be a valid environment."""
     mock_deps["config"].get_environments.return_value = []
@@ -288,8 +331,11 @@ def test_generate_docs_env_not_found(mock_deps):
 
 
 # [DEF:test_get_datasets_superset_failure:Function]
+# @RELATION: BINDS_TO -> DatasetsApiTests
 # @PURPOSE: Validate datasets listing surfaces a 503 contract when Superset access fails.
 # @TEST_EDGE: external_superset_failure -> {status: 503}
+# [/DEF:test_generate_docs_env_not_found:Function]
+
 def test_get_datasets_superset_failure(mock_deps):
     """@TEST_EDGE: external_superset_failure -> {status: 503}"""
     mock_env = MagicMock()