semantic markup update

backend/src/plugins/mapper.py

@@ -24,25 +24,57 @@ class MapperPlugin(PluginBase):
     """
 
     @property
+    # [DEF:id:Function]
+    # @PURPOSE: Returns the unique identifier for the mapper plugin.
+    # @PRE: Plugin instance exists.
+    # @POST: Returns string ID.
+    # @RETURN: str - "dataset-mapper"
     def id(self) -> str:
-        return "dataset-mapper"
+        with belief_scope("id"):
+            return "dataset-mapper"
+    # [/DEF:id:Function]
 
     @property
+    # [DEF:name:Function]
+    # @PURPOSE: Returns the human-readable name of the mapper plugin.
+    # @PRE: Plugin instance exists.
+    # @POST: Returns string name.
+    # @RETURN: str - Plugin name.
     def name(self) -> str:
-        return "Dataset Mapper"
+        with belief_scope("name"):
+            return "Dataset Mapper"
+    # [/DEF:name:Function]
 
     @property
+    # [DEF:description:Function]
+    # @PURPOSE: Returns a description of the mapper plugin.
+    # @PRE: Plugin instance exists.
+    # @POST: Returns string description.
+    # @RETURN: str - Plugin description.
     def description(self) -> str:
-        return "Map dataset column verbose names using PostgreSQL comments or Excel files."
+        with belief_scope("description"):
+            return "Map dataset column verbose names using PostgreSQL comments or Excel files."
+    # [/DEF:description:Function]
 
     @property
+    # [DEF:version:Function]
+    # @PURPOSE: Returns the version of the mapper plugin.
+    # @PRE: Plugin instance exists.
+    # @POST: Returns string version.
+    # @RETURN: str - "1.0.0"
     def version(self) -> str:
-        return "1.0.0"
+        with belief_scope("version"):
+            return "1.0.0"
+    # [/DEF:version:Function]
 
-    # [DEF:MapperPlugin.get_schema:Function]
+    # [DEF:get_schema:Function]
     # @PURPOSE: Returns the JSON schema for the mapper plugin parameters.
+    # @PRE: Plugin instance exists.
+    # @POST: Returns dictionary schema.
+    # @RETURN: Dict[str, Any] - JSON schema.
     def get_schema(self) -> Dict[str, Any]:
-        return {
+        with belief_scope("get_schema"):
+            return {
             "type": "object",
             "properties": {
                 "env": {
@@ -85,14 +117,16 @@ class MapperPlugin(PluginBase):
             },
             "required": ["env", "dataset_id", "source"]
         }
-    # [/DEF:MapperPlugin.get_schema:Function]
+    # [/DEF:get_schema:Function]
 
-    # [DEF:MapperPlugin.execute:Function]
+    # [DEF:execute:Function]
     # @PURPOSE: Executes the dataset mapping logic.
-    # @PRE: Params contain valid 'env', 'dataset_id', and 'source'.
+    # @PARAM: params (Dict[str, Any]) - Mapping parameters.
+    # @PRE: Params contain valid 'env', 'dataset_id', and 'source'. params must be a dictionary.
     # @POST: Updates the dataset in Superset.
+    # @RETURN: Dict[str, Any] - Execution status.
     async def execute(self, params: Dict[str, Any]) -> Dict[str, Any]:
-        with belief_scope("MapperPlugin.execute", f"params={params}"):
+        with belief_scope("execute"):
             env_name = params.get("env")
             dataset_id = params.get("dataset_id")
             source = params.get("source")
@@ -158,7 +192,7 @@ class MapperPlugin(PluginBase):
             except Exception as e:
                 logger.error(f"[MapperPlugin.execute][Failure] Mapping failed: {e}")
                 raise
-    # [/DEF:MapperPlugin.execute:Function]
+    # [/DEF:execute:Function]
 
 # [/DEF:MapperPlugin:Class]
 # [/DEF:MapperPluginModule:Module]