feat: implement API-first settings management and description history tracking

- Migrated settings persistence from localStorage to an API-first approach, ensuring consistency between Electron and web modes.
- Introduced `useSettingsSync` hook for automatic synchronization of settings to the server with debouncing.
- Enhanced feature update logic to track description changes with a history, allowing for better management of feature descriptions.
- Updated various components and services to utilize the new settings structure and description history functionality.
- Removed persist middleware from Zustand store, streamlining state management and improving performance.

apps/ui/src/components/views/board-view/dialogs/edit-feature-dialog.tsx

@@ -27,6 +27,7 @@ import {
   Sparkles,
   ChevronDown,
   GitBranch,
+  History,
 } from 'lucide-react';
 import { toast } from 'sonner';
 import { getElectronAPI } from '@/lib/electron';
@@ -55,6 +56,8 @@ import {
   DropdownMenuItem,
   DropdownMenuTrigger,
 } from '@/components/ui/dropdown-menu';
+import { Popover, PopoverContent, PopoverTrigger } from '@/components/ui/popover';
+import type { DescriptionHistoryEntry } from '@automaker/types';
 import { DependencyTreeDialog } from './dependency-tree-dialog';
 import { isCursorModel, PROVIDER_PREFIXES } from '@automaker/types';
 
@@ -78,7 +81,9 @@ interface EditFeatureDialogProps {
       priority: number;
       planningMode: PlanningMode;
       requirePlanApproval: boolean;
-    }
+    },
+    descriptionHistorySource?: 'enhance' | 'edit',
+    enhancementMode?: 'improve' | 'technical' | 'simplify' | 'acceptance'
   ) => void;
   categorySuggestions: string[];
   branchSuggestions: string[];
@@ -121,6 +126,14 @@ export function EditFeatureDialog({
   const [requirePlanApproval, setRequirePlanApproval] = useState(
     feature?.requirePlanApproval ?? false
   );
+  // Track the source of description changes for history
+  const [descriptionChangeSource, setDescriptionChangeSource] = useState<
+    { source: 'enhance'; mode: 'improve' | 'technical' | 'simplify' | 'acceptance' } | 'edit' | null
+  >(null);
+  // Track the original description when the dialog opened for comparison
+  const [originalDescription, setOriginalDescription] = useState(feature?.description ?? '');
+  // Track if history dropdown is open
+  const [showHistory, setShowHistory] = useState(false);
 
   // Get worktrees setting from store
   const { useWorktrees } = useAppStore();
@@ -135,9 +148,15 @@ export function EditFeatureDialog({
       setRequirePlanApproval(feature.requirePlanApproval ?? false);
       // If feature has no branchName, default to using current branch
       setUseCurrentBranch(!feature.branchName);
+      // Reset history tracking state
+      setOriginalDescription(feature.description ?? '');
+      setDescriptionChangeSource(null);
+      setShowHistory(false);
     } else {
       setEditFeaturePreviewMap(new Map());
       setShowEditAdvancedOptions(false);
+      setDescriptionChangeSource(null);
+      setShowHistory(false);
     }
   }, [feature]);
 
@@ -183,7 +202,21 @@ export function EditFeatureDialog({
       requirePlanApproval,
     };
 
-    onUpdate(editingFeature.id, updates);
+    // Determine if description changed and what source to use
+    const descriptionChanged = editingFeature.description !== originalDescription;
+    let historySource: 'enhance' | 'edit' | undefined;
+    let historyEnhancementMode: 'improve' | 'technical' | 'simplify' | 'acceptance' | undefined;
+
+    if (descriptionChanged && descriptionChangeSource) {
+      if (descriptionChangeSource === 'edit') {
+        historySource = 'edit';
+      } else {
+        historySource = 'enhance';
+        historyEnhancementMode = descriptionChangeSource.mode;
+      }
+    }
+
+    onUpdate(editingFeature.id, updates, historySource, historyEnhancementMode);
     setEditFeaturePreviewMap(new Map());
     setShowEditAdvancedOptions(false);
     onClose();
@@ -247,6 +280,8 @@ export function EditFeatureDialog({
       if (result?.success && result.enhancedText) {
         const enhancedText = result.enhancedText;
         setEditingFeature((prev) => (prev ? { ...prev, description: enhancedText } : prev));
+        // Track that this change was from enhancement
+        setDescriptionChangeSource({ source: 'enhance', mode: enhancementMode });
         toast.success('Description enhanced!');
       } else {
         toast.error(result?.error || 'Failed to enhance description');
@@ -312,12 +347,16 @@ export function EditFeatureDialog({
               <Label htmlFor="edit-description">Description</Label>
               <DescriptionImageDropZone
                 value={editingFeature.description}
-                onChange={(value) =>
+                onChange={(value) => {
                   setEditingFeature({
                     ...editingFeature,
                     description: value,
-                  })
-                }
+                  });
+                  // Track that this change was a manual edit (unless already enhanced)
+                  if (!descriptionChangeSource || descriptionChangeSource === 'edit') {
+                    setDescriptionChangeSource('edit');
+                  }
+                }}
                 images={editingFeature.imagePaths ?? []}
                 onImagesChange={(images) =>
                   setEditingFeature({
@@ -400,6 +439,80 @@ export function EditFeatureDialog({
                 size="sm"
                 variant="icon"
               />
+
+              {/* Version History Button */}
+              {feature?.descriptionHistory && feature.descriptionHistory.length > 0 && (
+                <Popover open={showHistory} onOpenChange={setShowHistory}>
+                  <PopoverTrigger asChild>
+                    <Button type="button" variant="outline" size="sm" className="gap-2">
+                      <History className="w-4 h-4" />
+                      History ({feature.descriptionHistory.length})
+                    </Button>
+                  </PopoverTrigger>
+                  <PopoverContent className="w-80 p-0" align="start">
+                    <div className="p-3 border-b">
+                      <h4 className="font-medium text-sm">Version History</h4>
+                      <p className="text-xs text-muted-foreground mt-1">
+                        Click a version to restore it
+                      </p>
+                    </div>
+                    <div className="max-h-64 overflow-y-auto p-2 space-y-1">
+                      {[...(feature.descriptionHistory || [])]
+                        .reverse()
+                        .map((entry: DescriptionHistoryEntry, index: number) => {
+                          const isCurrentVersion = entry.description === editingFeature.description;
+                          const date = new Date(entry.timestamp);
+                          const formattedDate = date.toLocaleDateString(undefined, {
+                            month: 'short',
+                            day: 'numeric',
+                            hour: '2-digit',
+                            minute: '2-digit',
+                          });
+                          const sourceLabel =
+                            entry.source === 'initial'
+                              ? 'Original'
+                              : entry.source === 'enhance'
+                                ? `Enhanced (${entry.enhancementMode || 'improve'})`
+                                : 'Edited';
+
+                          return (
+                            <button
+                              key={`${entry.timestamp}-${index}`}
+                              onClick={() => {
+                                setEditingFeature((prev) =>
+                                  prev ? { ...prev, description: entry.description } : prev
+                                );
+                                // Mark as edit since user is restoring from history
+                                setDescriptionChangeSource('edit');
+                                setShowHistory(false);
+                                toast.success('Description restored from history');
+                              }}
+                              className={`w-full text-left p-2 rounded-md hover:bg-muted transition-colors ${
+                                isCurrentVersion ? 'bg-muted/50 border border-primary/20' : ''
+                              }`}
+                            >
+                              <div className="flex items-center justify-between gap-2">
+                                <span className="text-xs font-medium">{sourceLabel}</span>
+                                <span className="text-xs text-muted-foreground">
+                                  {formattedDate}
+                                </span>
+                              </div>
+                              <p className="text-xs text-muted-foreground mt-1 line-clamp-2">
+                                {entry.description.slice(0, 100)}
+                                {entry.description.length > 100 ? '...' : ''}
+                              </p>
+                              {isCurrentVersion && (
+                                <span className="text-xs text-primary font-medium mt-1 block">
+                                  Current version
+                                </span>
+                              )}
+                            </button>
+                          );
+                        })}
+                    </div>
+                  </PopoverContent>
+                </Popover>
+              )}
             </div>
             <div className="space-y-2">
               <Label htmlFor="edit-category">Category (optional)</Label>