semantic cleanup

backend/src/plugins/git_plugin.py

@@ -31,6 +31,7 @@ class GitPlugin(PluginBase):
     
     # [DEF:__init__:Function]
     # @PURPOSE: Инициализирует плагин и его зависимости.
+    # @PRE: config.json exists or shared config_manager is available.
     # @POST: Инициализированы git_service и config_manager.
     def __init__(self):
         with belief_scope("GitPlugin.__init__"):
@@ -59,23 +60,49 @@ class GitPlugin(PluginBase):
     # [/DEF:__init__:Function]
 
     @property
+    # [DEF:id:Function]
+    # @PURPOSE: Returns the plugin identifier.
+    # @PRE: GitPlugin is initialized.
+    # @POST: Returns 'git-integration'.
     def id(self) -> str:
-        return "git-integration"
+        with belief_scope("GitPlugin.id"):
+            return "git-integration"
+    # [/DEF:id:Function]
 
     @property
+    # [DEF:name:Function]
+    # @PURPOSE: Returns the plugin name.
+    # @PRE: GitPlugin is initialized.
+    # @POST: Returns the human-readable name.
     def name(self) -> str:
-        return "Git Integration"
+        with belief_scope("GitPlugin.name"):
+            return "Git Integration"
+    # [/DEF:name:Function]
 
     @property
+    # [DEF:description:Function]
+    # @PURPOSE: Returns the plugin description.
+    # @PRE: GitPlugin is initialized.
+    # @POST: Returns the plugin's purpose description.
     def description(self) -> str:
-        return "Version control for Superset dashboards"
+        with belief_scope("GitPlugin.description"):
+            return "Version control for Superset dashboards"
+    # [/DEF:description:Function]
 
     @property
+    # [DEF:version:Function]
+    # @PURPOSE: Returns the plugin version.
+    # @PRE: GitPlugin is initialized.
+    # @POST: Returns the version string.
     def version(self) -> str:
-        return "0.1.0"
+        with belief_scope("GitPlugin.version"):
+            return "0.1.0"
+    # [/DEF:version:Function]
 
     # [DEF:get_schema:Function]
     # @PURPOSE: Возвращает JSON-схему параметров для выполнения задач плагина.
+    # @PRE: GitPlugin is initialized.
+    # @POST: Returns a JSON schema dictionary.
     # @RETURN: Dict[str, Any] - Схема параметров.
     def get_schema(self) -> Dict[str, Any]:
         with belief_scope("GitPlugin.get_schema"):
@@ -93,6 +120,7 @@ class GitPlugin(PluginBase):
 
     # [DEF:initialize:Function]
     # @PURPOSE: Выполняет начальную настройку плагина.
+    # @PRE: GitPlugin is initialized.
     # @POST: Плагин готов к выполнению задач.
     async def initialize(self):
         with belief_scope("GitPlugin.initialize"):
@@ -281,6 +309,8 @@ class GitPlugin(PluginBase):
     # [DEF:_get_env:Function]
     # @PURPOSE: Вспомогательный метод для получения конфигурации окружения.
     # @PARAM: env_id (Optional[str]) - ID окружения.
+    # @PRE: env_id is a string or None.
+    # @POST: Returns an Environment object from config or DB.
     # @RETURN: Environment - Объект конфигурации окружения.
     def _get_env(self, env_id: Optional[str] = None):
         with belief_scope("GitPlugin._get_env"):
@@ -341,5 +371,6 @@ class GitPlugin(PluginBase):
             raise ValueError("No environments configured. Please add a Superset Environment in Settings.")
     # [/DEF:_get_env:Function]
 
+    # [/DEF:initialize:Function]
 # [/DEF:GitPlugin:Class]
 # [/DEF:backend.src.plugins.git_plugin:Module]