fix: only refresh sidebar tree when table comment actually changed

Previously the sidebar tree refresh was skipped entirely in EDIT mode because
the check was gated on activeTab.mode === 'data', which is never true when
the structure editor is open. Now we pass a commentChanged flag through the
event chain and only refresh the tree when the comment was modified.

apps/desktop/src/App.vue

@@ -925,13 +925,19 @@ onUnmounted(() => {
                     "
                     @object-schema-change="(schema) => activeTab && queryStore.updateSchema(activeTab.id, schema)"
                     @structure-editor-saved="
-                      activeTab &&
-                      onStructureEditorSaved(onReloadData, toast, {
-                        connectionId: activeTab.connectionId,
-                        database: activeTab.database,
-                        schema: activeTab.schema,
-                        tableName: activeTab.structureTableName || '',
-                      })
+                      (commentChanged) =>
+                        activeTab &&
+                        onStructureEditorSaved(
+                          onReloadData,
+                          toast,
+                          {
+                            connectionId: activeTab.connectionId,
+                            database: activeTab.database,
+                            schema: activeTab.schema,
+                            tableName: activeTab.structureTableName || '',
+                          },
+                          commentChanged,
+                        )
                     "
                     @structure-editor-close="activeTab && queryStore.closeTab(activeTab.id)"
                   />

apps/desktop/src/components/layout/ContentArea.vue

@@ -83,7 +83,7 @@ const emit = defineEmits<{
   clickTable: [tableName: string];
   openObjectTable: [target: { tableName: string; schema?: string }];
   objectSchemaChange: [schema: string | undefined];
-  structureEditorSaved: [];
+  structureEditorSaved: [commentChanged: boolean];
   structureEditorClose: [];
 }>();
 
@@ -690,7 +690,7 @@ defineExpose({ focusSearch, refreshData });
         :database="activeTab.database"
         :schema="activeTab.schema"
         :table-name="activeTab.structureTableName || ''"
-        @saved="emit('structureEditorSaved')"
+        @saved="(commentChanged) => emit('structureEditorSaved', commentChanged)"
         @close="emit('structureEditorClose')"
       />
     </template>

apps/desktop/src/components/structure/TableStructureEditor.vue

@@ -75,7 +75,7 @@ const props = defineProps<{
 }>();
 
 const emit = defineEmits<{
-  saved: [];
+  saved: [commentChanged: boolean];
   close: [];
 }>();
 
@@ -140,6 +140,8 @@ const indexColLabels = computed(() => [
 const targetSchema = computed(() => props.schema || props.database || "");
 const isCreateMode = computed(() => !props.tableName);
 const newTableName = ref("");
+const tableComment = ref("");
+const originalTableComment = ref("");
 const targetLabel = computed(() =>
   buildStructureTargetLabel(
     connection.value?.name,
@@ -160,6 +162,8 @@ async function refreshSqlPreview() {
     tableName: isCreateMode.value ? newTableName.value : props.tableName || "",
     columns: columns.value,
     indexes: indexes.value,
+    tableComment: tableComment.value,
+    originalTableComment: isCreateMode.value ? undefined : originalTableComment.value,
   };
   try {
     const result = isCreateMode.value
@@ -201,6 +205,8 @@ function resetState() {
   foreignKeys.value = [];
   triggers.value = [];
   newTableName.value = "";
+  tableComment.value = "";
+  originalTableComment.value = "";
 }
 
 async function loadStructure(silent = false) {
@@ -219,6 +225,16 @@ async function loadStructure(silent = false) {
     indexes.value = createIndexDrafts(nextIndexes);
     foreignKeys.value = nextForeignKeys;
     triggers.value = nextTriggers;
+    try {
+      const tables = await api.listTables(props.connectionId, props.database, targetSchema.value);
+      const table = tables.find(
+        (t) => t.name.toLowerCase() === props.tableName!.toLowerCase() && t.table_type !== "VIEW",
+      );
+      originalTableComment.value = table?.comment || "";
+      tableComment.value = table?.comment || "";
+    } catch {
+      /* ignore — table comment is optional */
+    }
   } catch (e: any) {
     errorMessage.value = e?.message || String(e);
   } finally {
@@ -385,7 +401,7 @@ async function applyChanges() {
   try {
     await api.executeBatch(props.connectionId, props.database, pendingStatements.value);
     toast(t("structureEditor.saved"), 2500);
-    emit("saved");
+    emit("saved", tableComment.value !== originalTableComment.value);
     if (isCreateMode.value) {
       emit("close");
     } else {
@@ -404,7 +420,7 @@ onMounted(() => {
 });
 
 watch(
-  [isCreateMode, databaseType, () => props.schema, () => props.tableName, newTableName, columns, indexes],
+  [isCreateMode, databaseType, () => props.schema, () => props.tableName, newTableName, tableComment, columns, indexes],
   () => {
     void refreshSqlPreview();
   },
@@ -444,6 +460,15 @@ watch(
       />
     </div>
 
+    <div class="flex shrink-0 items-center gap-2">
+      <label class="shrink-0 text-[11px] font-medium text-muted-foreground">{{ t("structureEditor.comment") }}</label>
+      <Input
+        v-model="tableComment"
+        :placeholder="t('structureEditor.commentPlaceholder')"
+        class="h-6 max-w-[320px] text-[11px]"
+      />
+    </div>
+
     <div v-if="loading" class="flex min-h-0 flex-1 items-center justify-center gap-2 text-sm text-muted-foreground">
       <Loader2 class="h-4 w-4 animate-spin" />
       {{ t("common.loading") }}

apps/desktop/src/composables/useNavigationTargets.ts

@@ -123,6 +123,7 @@ export function useNavigationTargets(dialogs: {
     reloadData: () => Promise<void>,
     toast: (msg: string, duration?: number) => void,
     context: { connectionId: string; database: string; schema?: string; tableName: string },
+    commentChanged?: boolean,
   ) {
     if (!context.tableName) {
       try {
@@ -134,6 +135,15 @@ export function useNavigationTargets(dialogs: {
       } catch {}
       return;
     }
+    if (commentChanged) {
+      try {
+        await connectionStore.refreshObjectListTreeNode(
+          context.connectionId,
+          context.database,
+          context.schema || undefined,
+        );
+      } catch {}
+    }
     const activeTab = queryStore.tabs.find((t) => t.id === queryStore.activeTabId);
     if (activeTab?.mode === "data" && activeTab.tableMeta?.tableName === context.tableName) {
       try {
@@ -148,11 +158,6 @@ export function useNavigationTargets(dialogs: {
           columns,
           primaryKeys: editablePrimaryKeys(connectionStore.getConfig(activeTab.connectionId)?.db_type, columns),
         });
-        await connectionStore.refreshObjectListTreeNode(
-          activeTab.connectionId,
-          activeTab.database,
-          activeTab.tableMeta.schema,
-        );
         await reloadData();
       } catch (e: any) {
         toast(e?.message || String(e), 5000);

apps/desktop/src/lib/tableStructureEditorSql.ts

@@ -33,6 +33,8 @@ export interface BuildTableStructureChangeSqlOptions {
   tableName: string;
   columns: EditableStructureColumn[];
   indexes: EditableStructureIndex[];
+  tableComment?: string;
+  originalTableComment?: string;
 }
 
 export interface TableStructureChangeSql {