semantic markup update

backend/tests/test_logger.py

@@ -2,6 +2,10 @@ import pytest
 from backend.src.core.logger import belief_scope, logger
 
 
+# [DEF:test_belief_scope_logs_entry_action_exit:Function]
+# @PURPOSE: Test that belief_scope generates [ID][Entry], [ID][Action], and [ID][Exit] logs.
+# @PRE: belief_scope is available. caplog fixture is used.
+# @POST: Logs are verified to contain Entry, Action, and Exit tags.
 def test_belief_scope_logs_entry_action_exit(caplog):
     """Test that belief_scope generates [ID][Entry], [ID][Action], and [ID][Exit] logs."""
     caplog.set_level("INFO")
@@ -15,8 +19,13 @@ def test_belief_scope_logs_entry_action_exit(caplog):
     assert any("[TestFunction][Entry]" in msg for msg in log_messages), "Entry log not found"
     assert any("[TestFunction][Action] Doing something important" in msg for msg in log_messages), "Action log not found"
     assert any("[TestFunction][Exit]" in msg for msg in log_messages), "Exit log not found"
+# [/DEF:test_belief_scope_logs_entry_action_exit:Function]
 
 
+# [DEF:test_belief_scope_error_handling:Function]
+# @PURPOSE: Test that belief_scope logs Coherence:Failed on exception.
+# @PRE: belief_scope is available. caplog fixture is used.
+# @POST: Logs are verified to contain Coherence:Failed tag.
 def test_belief_scope_error_handling(caplog):
     """Test that belief_scope logs Coherence:Failed on exception."""
     caplog.set_level("INFO")
@@ -30,8 +39,13 @@ def test_belief_scope_error_handling(caplog):
     assert any("[FailingFunction][Entry]" in msg for msg in log_messages), "Entry log not found"
     assert any("[FailingFunction][Coherence:Failed]" in msg for msg in log_messages), "Failed coherence log not found"
     # Exit should not be logged on failure
+# [/DEF:test_belief_scope_error_handling:Function]
 
 
+# [DEF:test_belief_scope_success_coherence:Function]
+# @PURPOSE: Test that belief_scope logs Coherence:OK on success.
+# @PRE: belief_scope is available. caplog fixture is used.
+# @POST: Logs are verified to contain Coherence:OK tag.
 def test_belief_scope_success_coherence(caplog):
     """Test that belief_scope logs Coherence:OK on success."""
     caplog.set_level("INFO")
@@ -41,4 +55,5 @@ def test_belief_scope_success_coherence(caplog):
 
     log_messages = [record.message for record in caplog.records]
 
-    assert any("[SuccessFunction][Coherence:OK]" in msg for msg in log_messages), "Success coherence log not found"
+    assert any("[SuccessFunction][Coherence:OK]" in msg for msg in log_messages), "Success coherence log not found"
+# [/DEF:test_belief_scope_success_coherence:Function]

backend/tests/test_models.py

@@ -1,49 +1,62 @@
 import pytest
 from superset_tool.models import SupersetConfig
+from superset_tool.utils.logger import belief_scope
 
+# [DEF:test_superset_config_url_normalization:Function]
+# @PURPOSE: Tests that SupersetConfig correctly normalizes the base URL.
+# @PRE: SupersetConfig class is available.
+# @POST: URL normalization is verified.
 def test_superset_config_url_normalization():
-    auth = {
-        "provider": "db",
-        "username": "admin",
-        "password": "password",
-        "refresh": "token"
-    }
-    
-    # Test with /api/v1 already present
-    config = SupersetConfig(
-        env="dev",
-        base_url="http://localhost:8088/api/v1",
-        auth=auth
-    )
-    assert config.base_url == "http://localhost:8088/api/v1"
-    
-    # Test without /api/v1
-    config = SupersetConfig(
-        env="dev",
-        base_url="http://localhost:8088",
-        auth=auth
-    )
-    assert config.base_url == "http://localhost:8088/api/v1"
-    
-    # Test with trailing slash
-    config = SupersetConfig(
-        env="dev",
-        base_url="http://localhost:8088/",
-        auth=auth
-    )
-    assert config.base_url == "http://localhost:8088/api/v1"
-
-def test_superset_config_invalid_url():
-    auth = {
-        "provider": "db",
-        "username": "admin",
-        "password": "password",
-        "refresh": "token"
-    }
-    
-    with pytest.raises(ValueError, match="Must start with http:// or https://"):
-        SupersetConfig(
+    with belief_scope("test_superset_config_url_normalization"):
+        auth = {
+            "provider": "db",
+            "username": "admin",
+            "password": "password",
+            "refresh": "token"
+        }
+        
+        # Test with /api/v1 already present
+        config = SupersetConfig(
             env="dev",
-            base_url="localhost:8088",
+            base_url="http://localhost:8088/api/v1",
             auth=auth
         )
+        assert config.base_url == "http://localhost:8088/api/v1"
+        
+        # Test without /api/v1
+        config = SupersetConfig(
+            env="dev",
+            base_url="http://localhost:8088",
+            auth=auth
+        )
+        assert config.base_url == "http://localhost:8088/api/v1"
+        
+        # Test with trailing slash
+        config = SupersetConfig(
+            env="dev",
+            base_url="http://localhost:8088/",
+            auth=auth
+        )
+        assert config.base_url == "http://localhost:8088/api/v1"
+# [/DEF:test_superset_config_url_normalization:Function]
+
+# [DEF:test_superset_config_invalid_url:Function]
+# @PURPOSE: Tests that SupersetConfig raises ValueError for invalid URLs.
+# @PRE: SupersetConfig class is available.
+# @POST: ValueError is raised for invalid URLs.
+def test_superset_config_invalid_url():
+    with belief_scope("test_superset_config_invalid_url"):
+        auth = {
+            "provider": "db",
+            "username": "admin",
+            "password": "password",
+            "refresh": "token"
+        }
+        
+        with pytest.raises(ValueError, match="Must start with http:// or https://"):
+            SupersetConfig(
+                env="dev",
+                base_url="localhost:8088",
+                auth=auth
+            )
+# [/DEF:test_superset_config_invalid_url:Function]