semantic cleanup

frontend/src/components/git/GitManager.svelte

@@ -51,6 +51,8 @@
     // [DEF:checkStatus:Function]
     /**
      * @purpose Проверяет, инициализирован ли репозиторий для данного дашборда.
+     * @pre Component is mounted and has dashboardId.
+     * @post initialized state is set; configs loaded if not initialized.
      */
     async function checkStatus() {
         checkingStatus = true;
@@ -72,6 +74,8 @@
     // [DEF:handleInit:Function]
     /**
      * @purpose Инициализирует репозиторий для дашборда.
+     * @pre selectedConfigId and remoteUrl are provided.
+     * @post Repository is created on backend; initialized set to true.
      */
     async function handleInit() {
         if (!selectedConfigId || !remoteUrl) {
@@ -94,6 +98,8 @@
     // [DEF:handleSync:Function]
     /**
      * @purpose Синхронизирует состояние Superset с локальным Git-репозиторием.
+     * @pre Repository is initialized.
+     * @post Dashboard YAMLs are exported to Git and staged.
      */
     async function handleSync() {
         loading = true;
@@ -111,6 +117,11 @@
     // [/DEF:handleSync:Function]
 
     // [DEF:handlePush:Function]
+    /**
+     * @purpose Pushes local commits to the remote repository.
+     * @pre Repository is initialized and has commits.
+     * @post Changes are pushed to origin.
+     */
     async function handlePush() {
         loading = true;
         try {
@@ -125,6 +136,11 @@
     // [/DEF:handlePush:Function]
 
     // [DEF:handlePull:Function]
+    /**
+     * @purpose Pulls changes from the remote repository.
+     * @pre Repository is initialized.
+     * @post Local branch is updated with remote changes.
+     */
     async function handlePull() {
         loading = true;
         try {