semantics update

backend/src/plugins/debug.py

@@ -87,6 +87,11 @@ class DebugPlugin(PluginBase):
     # [/DEF:DebugPlugin.execute:Function]
 
     # [DEF:DebugPlugin._test_db_api:Function]
+    # @PURPOSE: Tests database API connectivity for source and target environments.
+    # @PRE:     source_env and target_env params exist.
+    # @POST:    Returns DB counts for both envs.
+    # @PARAM:   params (Dict) - Plugin parameters.
+    # @RETURN:  Dict - Comparison results.
     async def _test_db_api(self, params: Dict[str, Any]) -> Dict[str, Any]:
         source_env_name = params.get("source_env")
         target_env_name = params.get("target_env")
@@ -112,8 +117,14 @@ class DebugPlugin(PluginBase):
             }
             
         return results
+    # [/DEF:DebugPlugin._test_db_api:Function]
 
     # [DEF:DebugPlugin._get_dataset_structure:Function]
+    # @PURPOSE: Retrieves the structure of a dataset.
+    # @PRE:     env and dataset_id params exist.
+    # @POST:    Returns dataset JSON structure.
+    # @PARAM:   params (Dict) - Plugin parameters.
+    # @RETURN:  Dict - Dataset structure.
     async def _get_dataset_structure(self, params: Dict[str, Any]) -> Dict[str, Any]:
         env_name = params.get("env")
         dataset_id = params.get("dataset_id")
@@ -132,6 +143,7 @@ class DebugPlugin(PluginBase):
         
         dataset_response = client.get_dataset(dataset_id)
         return dataset_response.get('result') or {}
+    # [/DEF:DebugPlugin._get_dataset_structure:Function]
 
 # [/DEF:DebugPlugin:Class]
 # [/DEF:DebugPluginModule:Module]