@taskforcehq/taskforce 0.3.327 → 0.3.329

package/dist/hooks/tasks/useTaskFormActions.js

@@ -4,13 +4,18 @@ import { normalizeTaskFromApi } from '../../utils/taskNormalization.js';
 import { createCloudTaskHttpMutationClient, fetchTaskHttpMutation, isConclusiveTaskHttpResponse, } from './taskHttpMutation.js';
 import { canonicalWorkspaceSyncJson } from '../../sync/v3/canonicalWorkspaceSyncJson.js';
 export function useTaskFormActions(input) {
-    const { activeCategories, activeTab, apiEndpoint, assignee, attachments, attachmentsDirty, category, checklistItems, comments, complexity, description, dueDate, createTaskDurably, durableTaskHttpRootActivationEnabled = false, workspaceId, taskHttpMutationClient, updateTask, editingTaskId, fetchTasks, formTaxonomies, getDescriptionDraft: getDescriptionDraftInput, getPreferredCategoryValue, getTitleDraft: getTitleDraftInput, mergeTaskFromServer, onTaskCreated, workstreamInput, priority, pushNotice, queueWorkspaceSyncFromAuthoritativeTaskState, relationshipTasks, supplementalTasks = [], resetForm, resolveWorkstreamIdInput, scheduledDate, setActiveTab, setAttachmentsDirty, setComments, setError, setLastUsedCategory, setLoading, setNewCommentText, status, title, taxonomies, textDraftOccupied, type } = input;
+    const { activeCategories, activeTab, apiEndpoint, assignee, attachments, attachmentsDirty, category, checklistItems, comments, complexity, description, dueDate, createTaskDurably, durableTaskHttpRootActivationEnabled = false, workspaceId, taskHttpMutationClient, updateTask, editingTaskId, editorBaselineDraft = null, revisionConflict = false, fetchTasks, formTaxonomies, getAttachmentsDraft: getAttachmentsDraftInput, getDescriptionDraft: getDescriptionDraftInput, getPreferredCategoryValue, getTitleDraft: getTitleDraftInput, awaitPendingDescriptionImageUpload: awaitPendingDescriptionImageUploadInput, mergeTaskFromServer, onTaskCreated, onTaskCreateAccepted, workstreamInput, priority, pushNotice, queueWorkspaceSyncFromAuthoritativeTaskState, relationshipTasks, supplementalTasks = [], resetForm, resolveWorkstreamIdInput, scheduledDate, setActiveTab, setAttachmentsDirty, setComments, setError, setLastUsedCategory, setLoading, setNewCommentText, status, title, taxonomies, textDraftOccupied, type } = input;
     const getTitleDraft = getTitleDraftInput || (() => title);
     const getDescriptionDraft = getDescriptionDraftInput || (() => description);
+    const getAttachmentsDraft = getAttachmentsDraftInput || (() => attachments);
     const getTitleDraftRef = useRef(getTitleDraft);
     const getDescriptionDraftRef = useRef(getDescriptionDraft);
+    const getAttachmentsDraftRef = useRef(getAttachmentsDraft);
+    const awaitPendingDescriptionImageUploadRef = useRef(awaitPendingDescriptionImageUploadInput);
     getTitleDraftRef.current = getTitleDraft;
     getDescriptionDraftRef.current = getDescriptionDraft;
+    getAttachmentsDraftRef.current = getAttachmentsDraft;
+    awaitPendingDescriptionImageUploadRef.current = awaitPendingDescriptionImageUploadInput;
     const readTextDraft = useCallback(() => ({
         title: getTitleDraftRef.current(),
         description: getDescriptionDraftRef.current(),
@@ -48,30 +53,46 @@ export function useTaskFormActions(input) {
         }
         createDraftOccupiedRef.current = createDraftOccupied;
     }, [createDraftOccupied, createTaskDurably, workspaceId]);
-    const buildTaskDraftSignature = useCallback((textDraft = readTextDraft()) => JSON.stringify({
-        title: textDraft.title.trim(),
+    const buildTaskDraftSignatureFromEditorDraft = useCallback((draft) => JSON.stringify({
+        title: draft.title.trim(),
+        description: draft.description,
+        category: draft.category,
+        type: draft.type,
+        priority: Number(draft.priority),
+        complexity: Number(draft.complexity) || 3,
+        assignee: draft.assignee || 'agent',
+        scheduledDate: draft.scheduledDate || '',
+        dueDate: draft.dueDate || '',
+        workstreamId: draft.workstreamId || '',
+        checklistItems: draft.checklistItems,
+        taxonomies: draft.taxonomies,
+        attachments: draft.attachments,
+    }), []);
+    const buildTaskDraftSignature = useCallback((textDraft = readTextDraft(), attachmentDraft = getAttachmentsDraftRef.current()) => buildTaskDraftSignatureFromEditorDraft({
+        title: textDraft.title,
         description: textDraft.description,
         category: typeof category === 'string'
             ? category
             : category.label || getPreferredCategoryValue(activeCategories),
         type: typeof type === 'string' ? type : type.label || DEFAULT_TYPE_VALUE,
-        priority: Number(priority),
+        priority,
         complexity: Number(complexity) || 3,
+        status,
         assignee: assignee || 'agent',
-        scheduledDate: scheduledDate || '',
-        dueDate: dueDate || '',
-        workstreamInput: workstreamInput.trim(),
+        scheduledDate,
+        dueDate,
+        workstreamId: workstreamInput.trim()
+            ? (resolveWorkstreamIdInput(workstreamInput)?.id || workstreamInput.trim())
+            : '',
         checklistItems,
-        comments,
         taxonomies: formTaxonomies,
-        attachments,
+        attachments: attachmentDraft,
     }), [
         activeCategories,
         assignee,
-        attachments,
+        buildTaskDraftSignatureFromEditorDraft,
         category,
         checklistItems,
-        comments,
         complexity,
         description,
         dueDate,
@@ -79,7 +100,9 @@ export function useTaskFormActions(input) {
         getPreferredCategoryValue,
         priority,
         readTextDraft,
+        resolveWorkstreamIdInput,
         scheduledDate,
+        status,
         title,
         type,
         workstreamInput
@@ -90,6 +113,17 @@ export function useTaskFormActions(input) {
             autoSaveTimerRef.current = null;
         }
     }, []);
+    const hasUnsavedChangesNow = useCallback(() => Boolean(editingTaskId
+        && lastSavedDraftSignature !== null
+        && buildTaskDraftSignature() !== lastSavedDraftSignature), [buildTaskDraftSignature, editingTaskId, lastSavedDraftSignature]);
+    const hasUnsavedChanges = hasUnsavedChangesNow();
+    useEffect(() => {
+        if (!revisionConflict)
+            return;
+        clearAutoSaveTimer();
+        queuedAutoSaveRef.current = null;
+        setAutoSaveState('idle');
+    }, [clearAutoSaveTimer, revisionConflict]);
     const enqueueAutoSave = useCallback((request) => {
         if (activeAutoSaveSignatureRef.current === request.signature
             && queuedAutoSaveRef.current === null
@@ -123,9 +157,28 @@ export function useTaskFormActions(input) {
     const saveTask = useCallback(async (options) => {
         const quiet = options?.quiet ?? false;
         const source = options?.source ?? 'manual';
+        if (editingTaskId && revisionConflict) {
+            setError('');
+            setAutoSaveState('idle');
+            return false;
+        }
+        if (!editingTaskId && source === 'manual') {
+            try {
+                await awaitPendingDescriptionImageUploadRef.current?.();
+            }
+            catch (error) {
+                console.error('Description image upload did not settle before task creation.', error);
+                const message = 'Wait for the Description image upload to finish, then try again.';
+                setError(message);
+                if (!quiet)
+                    pushNotice(message, 'error');
+                return false;
+            }
+        }
         const textDraft = options?.textDraft ?? readTextDraft();
         const draftTitle = textDraft.title;
         const draftDescription = textDraft.description;
+        const draftAttachments = getAttachmentsDraftRef.current();
         if (!editingTaskId) {
             createdTaskRef.current = null;
         }
@@ -218,10 +271,13 @@ export function useTaskFormActions(input) {
             if (!editingTaskId)
                 body.comments = comments;
             if (!editingTaskId || attachmentsDirty) {
-                body.attachments = attachments;
+                body.attachments = draftAttachments;
             }
             if (editingTaskId && Object.keys(body).length > 0) {
                 body.saveSource = source;
+                if (existingTask?.detailRevision) {
+                    body.expectedDetailRevision = existingTask.detailRevision;
+                }
             }
             if (editingTaskId && updateTask) {
                 const saved = await updateTask(editingTaskId, body);
@@ -383,7 +439,6 @@ export function useTaskFormActions(input) {
         activeCategories,
         apiEndpoint,
         assignee,
-        attachments,
         attachmentsDirty,
         category,
         checklistItems,
@@ -396,6 +451,7 @@ export function useTaskFormActions(input) {
         taskHttpMutationClient,
         updateTask,
         editingTaskId,
+        revisionConflict,
         editingReadOnlyMode,
         formTaxonomies,
         getPreferredCategoryValue,
@@ -424,6 +480,15 @@ export function useTaskFormActions(input) {
             suppressNextCreateSuccessNoticeRef.current = false;
             if (activeTab === 'add' && !editingTaskId) {
                 const createdTask = createdTaskRef.current;
+                if (createdTask && onTaskCreateAccepted) {
+                    try {
+                        await onTaskCreateAccepted(createdTask);
+                    }
+                    catch (error) {
+                        console.warn('Task create draft upload promotion failed.', error);
+                        pushNotice('Task created successfully. Temporary image cleanup will retry automatically.', 'info');
+                    }
+                }
                 if (createdTask && onTaskCreated) {
                     onTaskCreated(createdTask);
                     return;
@@ -433,7 +498,7 @@ export function useTaskFormActions(input) {
                 await fetchTasks();
             }
         }
-    }, [activeTab, editingTaskId, fetchTasks, onTaskCreated, pushNotice, resetForm, saveTask, setActiveTab]);
+    }, [activeTab, editingTaskId, fetchTasks, onTaskCreateAccepted, onTaskCreated, pushNotice, resetForm, saveTask, setActiveTab]);
     useEffect(() => {
         clearAutoSaveTimer();
         queuedAutoSaveRef.current = null;
@@ -442,14 +507,23 @@ export function useTaskFormActions(input) {
             setAutoSaveState('idle');
             return;
         }
-        setLastSavedDraftSignature(buildTaskDraftSignature());
+        setLastSavedDraftSignature(editorBaselineDraft
+            ? buildTaskDraftSignatureFromEditorDraft(editorBaselineDraft)
+            : buildTaskDraftSignature());
         setAutoSaveState('idle');
-    }, [clearAutoSaveTimer, editingTaskId]);
+    }, [
+        buildTaskDraftSignatureFromEditorDraft,
+        clearAutoSaveTimer,
+        editingTaskId,
+        editorBaselineDraft,
+    ]);
     const flushAutoSave = useCallback(async () => {
         clearAutoSaveTimer();
         if (editingReadOnlyMode) {
             return true;
         }
+        if (revisionConflict)
+            return false;
         if (!editingTaskId || lastSavedDraftSignature === null) {
             return true;
         }
@@ -475,11 +549,12 @@ export function useTaskFormActions(input) {
         enqueueAutoSave,
         lastSavedDraftSignature,
         readTextDraft,
+        revisionConflict,
         saveTask,
         scheduledDate,
     ]);
     useEffect(() => {
-        if (!editingTaskId || editingReadOnlyMode || lastSavedDraftSignature === null) {
+        if (!editingTaskId || editingReadOnlyMode || revisionConflict || lastSavedDraftSignature === null) {
             return;
         }
         const textDraft = readTextDraft();
@@ -525,6 +600,7 @@ export function useTaskFormActions(input) {
         enqueueAutoSave,
         lastSavedDraftSignature,
         readTextDraft,
+        revisionConflict,
         saveTask,
         scheduledDate,
     ]);
@@ -611,6 +687,9 @@ export function useTaskFormActions(input) {
     ]);
     return {
         autoSaveState,
+        hasUnsavedChanges,
+        hasUnsavedChangesNow,
+        hasPendingAutoSave: autoSaveState === 'saving',
         flushAutoSave,
         scheduleWarningPrompt,
         saveTask,

package/dist/hooks/ui/useSettingsModel.d.ts

@@ -29,6 +29,11 @@ type UseSettingsModelInput = {
     manualComplexityEnabled: boolean;
     checklistDropdownEnabled: boolean;
     showTaskCardStatusLabel: boolean;
+    showTaskCardDescription: boolean;
+    showTaskCardAttachments: boolean;
+    showTaskCardChecklistProgress: boolean;
+    showTaskCardLatestActivity: boolean;
+    tintTaskCardActivityBackground: boolean;
     pathSaved: boolean;
     settingsSection: SettingsSection;
     setupState: any;
@@ -38,15 +43,21 @@ type UseSettingsModelInput = {
     setCurrentTheme: (value: any) => void;
     handleSaveTheme: (...args: any[]) => any;
     handleSaveGlobalTheme: (...args: any[]) => any;
+    handleUseGlobalThemeDefault: (...args: any[]) => any;
     setKeyShortcut: (value: string) => void;
     handleJsonBackupEnabledChange: (...args: any[]) => any;
     handleSaveGlobalJsonBackupEnabled: (...args: any[]) => any;
+    handleUseGlobalJsonBackupDefault: (...args: any[]) => any;
     handleSaveGlobalWeekStartsOn: (...args: any[]) => any;
     handleSaveLocale: (...args: any[]) => any;
     handleManualComplexityEnabledChange: (...args: any[]) => any;
     handleChecklistDropdownEnabledChange: (...args: any[]) => any;
     handleShowTaskCardStatusLabelChange: (...args: any[]) => any;
-    handleResetProjectToGlobal: (...args: any[]) => any;
+    handleShowTaskCardDescriptionChange: (...args: any[]) => any;
+    handleShowTaskCardAttachmentsChange: (...args: any[]) => any;
+    handleShowTaskCardChecklistProgressChange: (...args: any[]) => any;
+    handleShowTaskCardLatestActivityChange: (...args: any[]) => any;
+    handleTintTaskCardActivityBackgroundChange: (...args: any[]) => any;
     handleSaveSettings: (...args: any[]) => any;
     initiativeTemplates: any[];
     fetchInitiativeTemplates: (...args: any[]) => any;
@@ -109,6 +120,11 @@ export declare function useSettingsModel(input: UseSettingsModelInput): {
     manualComplexityEnabled: boolean;
     checklistDropdownEnabled: boolean;
     showTaskCardStatusLabel: boolean;
+    showTaskCardDescription: boolean;
+    showTaskCardAttachments: boolean;
+    showTaskCardChecklistProgress: boolean;
+    showTaskCardLatestActivity: boolean;
+    tintTaskCardActivityBackground: boolean;
     pathSaved: boolean;
     initialSection: SettingsSection;
     setupState: any;
@@ -118,15 +134,21 @@ export declare function useSettingsModel(input: UseSettingsModelInput): {
     onThemeChange: (value: any) => void;
     onSaveTheme: (...args: any[]) => any;
     onSaveGlobalTheme: (...args: any[]) => any;
+    onUseGlobalThemeDefault: (...args: any[]) => any;
     onKeyShortcutChange: (value: string) => void;
     onJsonBackupEnabledChange: (...args: any[]) => any;
     onSaveGlobalJsonBackupEnabled: (...args: any[]) => any;
+    onUseGlobalJsonBackupDefault: (...args: any[]) => any;
     onSaveGlobalWeekStartsOn: (...args: any[]) => any;
     onSaveLocale: (...args: any[]) => any;
     onManualComplexityEnabledChange: (...args: any[]) => any;
     onChecklistDropdownEnabledChange: (...args: any[]) => any;
     onShowTaskCardStatusLabelChange: (...args: any[]) => any;
-    onResetProjectToGlobal: (...args: any[]) => any;
+    onShowTaskCardDescriptionChange: (...args: any[]) => any;
+    onShowTaskCardAttachmentsChange: (...args: any[]) => any;
+    onShowTaskCardChecklistProgressChange: (...args: any[]) => any;
+    onShowTaskCardLatestActivityChange: (...args: any[]) => any;
+    onTintTaskCardActivityBackgroundChange: (...args: any[]) => any;
     onSaveSettings: (...args: any[]) => any;
     initiativeTemplates: any[];
     onRefreshInitiativeTemplates: (...args: any[]) => any;

package/dist/hooks/ui/useSettingsModel.js

@@ -1,6 +1,6 @@
 import { useCallback } from 'react';
 export function useSettingsModel(input) {
-    const { resolveCloudAuthUrl, currentWorkspaceId, normalizedCloudAuthBaseUrl, normalizedCloudMcpBaseUrl, mergedConfig, availableWorkspaces, currentTheme, configLoaded, globalTheme, themeUseGlobalDefault, keyShortcut, jsonBackupEnabled, globalJsonBackupEnabled, globalWeekStartsOn, locale, supportedLocales, jsonBackupUseGlobalDefault, manualComplexityEnabled, checklistDropdownEnabled, showTaskCardStatusLabel, pathSaved, settingsSection, setupState, buildInfo, saveSetupMode, saveWorkspaceProfile, setCurrentTheme, handleSaveTheme, handleSaveGlobalTheme, setKeyShortcut, handleJsonBackupEnabledChange, handleSaveGlobalJsonBackupEnabled, handleSaveGlobalWeekStartsOn, handleSaveLocale, handleManualComplexityEnabledChange, handleChecklistDropdownEnabledChange, handleShowTaskCardStatusLabelChange, handleResetProjectToGlobal, handleSaveSettings, initiativeTemplates, fetchInitiativeTemplates, createInitiativeFromTemplate, setShowFolderBrowser, setBrowserTarget, fetchFolders, activeCategories, pathValidation, taxonomyDisplayLabels, handleUpdateCategory, handleRemoveCategory, handleSaveCategory, handleAddPath, handleRemovePath, handleUpdateCategoryIcon, handleUpdateCategoryColor, activeTypes, handleSaveType, handleRemoveType, handleUpdateType, taxonomies, handleUpdateTaxonomies, priorities, handleUpdatePriorities, analyzeSystemTaxonomyPack, handleApplySystemTaxonomyPack, handleUpdateTaxonomyDisplayLabels, projectRoot, projectName, mcpHostRoot, serverHostRoot, mcpScriptPath, tenantId, runtimeMode, workspaceSwitchingEnabled, deleteWorkspace, setMcpHostRoot, isAuthenticated } = input;
+    const { resolveCloudAuthUrl, currentWorkspaceId, normalizedCloudAuthBaseUrl, normalizedCloudMcpBaseUrl, mergedConfig, availableWorkspaces, currentTheme, configLoaded, globalTheme, themeUseGlobalDefault, keyShortcut, jsonBackupEnabled, globalJsonBackupEnabled, globalWeekStartsOn, locale, supportedLocales, jsonBackupUseGlobalDefault, manualComplexityEnabled, checklistDropdownEnabled, showTaskCardStatusLabel, showTaskCardDescription, showTaskCardAttachments, showTaskCardChecklistProgress, showTaskCardLatestActivity, tintTaskCardActivityBackground, pathSaved, settingsSection, setupState, buildInfo, saveSetupMode, saveWorkspaceProfile, setCurrentTheme, handleSaveTheme, handleSaveGlobalTheme, handleUseGlobalThemeDefault, setKeyShortcut, handleJsonBackupEnabledChange, handleSaveGlobalJsonBackupEnabled, handleUseGlobalJsonBackupDefault, handleSaveGlobalWeekStartsOn, handleSaveLocale, handleManualComplexityEnabledChange, handleChecklistDropdownEnabledChange, handleShowTaskCardStatusLabelChange, handleShowTaskCardDescriptionChange, handleShowTaskCardAttachmentsChange, handleShowTaskCardChecklistProgressChange, handleShowTaskCardLatestActivityChange, handleTintTaskCardActivityBackgroundChange, handleSaveSettings, initiativeTemplates, fetchInitiativeTemplates, createInitiativeFromTemplate, setShowFolderBrowser, setBrowserTarget, fetchFolders, activeCategories, pathValidation, taxonomyDisplayLabels, handleUpdateCategory, handleRemoveCategory, handleSaveCategory, handleAddPath, handleRemovePath, handleUpdateCategoryIcon, handleUpdateCategoryColor, activeTypes, handleSaveType, handleRemoveType, handleUpdateType, taxonomies, handleUpdateTaxonomies, priorities, handleUpdatePriorities, analyzeSystemTaxonomyPack, handleApplySystemTaxonomyPack, handleUpdateTaxonomyDisplayLabels, projectRoot, projectName, mcpHostRoot, serverHostRoot, mcpScriptPath, tenantId, runtimeMode, workspaceSwitchingEnabled, deleteWorkspace, setMcpHostRoot, isAuthenticated } = input;
     const fetchCloudAuthApi = useCallback(async (path, init) => {
         const resolvedUrl = resolveCloudAuthUrl(path);
         const headers = new Headers(init?.headers || undefined);
@@ -75,6 +75,11 @@ export function useSettingsModel(input) {
         manualComplexityEnabled,
         checklistDropdownEnabled,
         showTaskCardStatusLabel,
+        showTaskCardDescription,
+        showTaskCardAttachments,
+        showTaskCardChecklistProgress,
+        showTaskCardLatestActivity,
+        tintTaskCardActivityBackground,
         pathSaved,
         initialSection: settingsSection,
         setupState,
@@ -84,15 +89,21 @@ export function useSettingsModel(input) {
         onThemeChange: setCurrentTheme,
         onSaveTheme: handleSaveTheme,
         onSaveGlobalTheme: handleSaveGlobalTheme,
+        onUseGlobalThemeDefault: handleUseGlobalThemeDefault,
         onKeyShortcutChange: setKeyShortcut,
         onJsonBackupEnabledChange: handleJsonBackupEnabledChange,
         onSaveGlobalJsonBackupEnabled: handleSaveGlobalJsonBackupEnabled,
+        onUseGlobalJsonBackupDefault: handleUseGlobalJsonBackupDefault,
         onSaveGlobalWeekStartsOn: handleSaveGlobalWeekStartsOn,
         onSaveLocale: handleSaveLocale,
         onManualComplexityEnabledChange: handleManualComplexityEnabledChange,
         onChecklistDropdownEnabledChange: handleChecklistDropdownEnabledChange,
         onShowTaskCardStatusLabelChange: handleShowTaskCardStatusLabelChange,
-        onResetProjectToGlobal: handleResetProjectToGlobal,
+        onShowTaskCardDescriptionChange: handleShowTaskCardDescriptionChange,
+        onShowTaskCardAttachmentsChange: handleShowTaskCardAttachmentsChange,
+        onShowTaskCardChecklistProgressChange: handleShowTaskCardChecklistProgressChange,
+        onShowTaskCardLatestActivityChange: handleShowTaskCardLatestActivityChange,
+        onTintTaskCardActivityBackgroundChange: handleTintTaskCardActivityBackgroundChange,
         onSaveSettings: handleSaveSettings,
         initiativeTemplates,
         onRefreshInitiativeTemplates: fetchInitiativeTemplates,

package/dist/hooks/ui/useSettingsPersistence.d.ts

@@ -18,18 +18,29 @@ interface UseSettingsPersistenceInput {
     setManualComplexityEnabled: (value: boolean) => void;
     setChecklistDropdownEnabled: (value: boolean) => void;
     setShowTaskCardStatusLabel: (value: boolean) => void;
+    setShowTaskCardDescription: (value: boolean) => void;
+    setShowTaskCardAttachments: (value: boolean) => void;
+    setShowTaskCardChecklistProgress: (value: boolean) => void;
+    setShowTaskCardLatestActivity: (value: boolean) => void;
+    setTintTaskCardActivityBackground: (value: boolean) => void;
 }
 export declare function useSettingsPersistence(input: UseSettingsPersistenceInput): {
     handleSaveSettings: () => Promise<boolean>;
     handleSaveTheme: (theme: TaskforceTheme) => Promise<boolean>;
     handleSaveGlobalTheme: (theme: TaskforceTheme) => Promise<boolean>;
+    handleUseGlobalThemeDefault: () => Promise<boolean>;
     handleJsonBackupEnabledChange: (enabled: boolean) => Promise<boolean>;
     handleSaveGlobalJsonBackupEnabled: (enabled: boolean) => Promise<boolean>;
+    handleUseGlobalJsonBackupDefault: () => Promise<boolean>;
     handleSaveGlobalWeekStartsOn: (weekStartsOn: WeekStartsOn) => Promise<boolean>;
     handleSaveLocale: (nextLocale: string) => Promise<boolean>;
     handleManualComplexityEnabledChange: (enabled: boolean) => Promise<boolean>;
     handleChecklistDropdownEnabledChange: (enabled: boolean) => Promise<boolean>;
     handleShowTaskCardStatusLabelChange: (enabled: boolean) => Promise<boolean>;
-    handleResetProjectToGlobal: () => Promise<boolean>;
+    handleShowTaskCardDescriptionChange: (enabled: boolean) => Promise<boolean>;
+    handleShowTaskCardAttachmentsChange: (enabled: boolean) => Promise<boolean>;
+    handleShowTaskCardChecklistProgressChange: (enabled: boolean) => Promise<boolean>;
+    handleShowTaskCardLatestActivityChange: (enabled: boolean) => Promise<boolean>;
+    handleTintTaskCardActivityBackgroundChange: (enabled: boolean) => Promise<boolean>;
 };
 export {};

package/dist/hooks/ui/useSettingsPersistence.js

@@ -1,7 +1,7 @@
 import { useCallback } from 'react';
 import { setLocale as setAppLocale } from '../../localization';
 export function useSettingsPersistence(input) {
-    const { keyShortcut, themeUseGlobalDefault, runtimeMode, jsonBackupUseGlobalDefault, globalTheme, globalJsonBackupEnabled, setCurrentTheme, setThemeUseGlobalDefault, setGlobalTheme, setJsonBackupEnabled, setJsonBackupUseGlobalDefault, setGlobalJsonBackupEnabled, setGlobalWeekStartsOn, setLocale, setManualComplexityEnabled, setChecklistDropdownEnabled, setShowTaskCardStatusLabel } = input;
+    const { keyShortcut, themeUseGlobalDefault, runtimeMode, jsonBackupUseGlobalDefault, globalTheme, globalJsonBackupEnabled, setCurrentTheme, setThemeUseGlobalDefault, setGlobalTheme, setJsonBackupEnabled, setJsonBackupUseGlobalDefault, setGlobalJsonBackupEnabled, setGlobalWeekStartsOn, setLocale, setManualComplexityEnabled, setChecklistDropdownEnabled, setShowTaskCardStatusLabel, setShowTaskCardDescription, setShowTaskCardAttachments, setShowTaskCardChecklistProgress, setShowTaskCardLatestActivity, setTintTaskCardActivityBackground } = input;
     const handleSaveSettings = useCallback(async () => {
         try {
             const globalRes = await fetch('/api/taskforce/global-settings', {
@@ -61,6 +61,25 @@ export function useSettingsPersistence(input) {
             return false;
         }
     }, [setGlobalTheme, themeUseGlobalDefault, setCurrentTheme]);
+    const handleUseGlobalThemeDefault = useCallback(async () => {
+        try {
+            const configRes = await fetch('/api/taskforce/config', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ theme: null }),
+            });
+            if (!configRes.ok) {
+                throw new Error(`Failed to save config (${configRes.status})`);
+            }
+            setThemeUseGlobalDefault(true);
+            setCurrentTheme(globalTheme);
+            return true;
+        }
+        catch {
+            console.error('[Taskforce] Failed to use global theme default');
+            return false;
+        }
+    }, [globalTheme, setCurrentTheme, setThemeUseGlobalDefault]);
     const handleJsonBackupEnabledChange = useCallback(async (enabled) => {
         if (runtimeMode === 'cloud') {
             setJsonBackupEnabled(false);
@@ -113,6 +132,25 @@ export function useSettingsPersistence(input) {
             return false;
         }
     }, [runtimeMode, setGlobalJsonBackupEnabled, jsonBackupUseGlobalDefault, setJsonBackupEnabled]);
+    const handleUseGlobalJsonBackupDefault = useCallback(async () => {
+        try {
+            const configRes = await fetch('/api/taskforce/config', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ jsonBackupEnabled: null }),
+            });
+            if (!configRes.ok) {
+                throw new Error(`Failed to save config (${configRes.status})`);
+            }
+            setJsonBackupUseGlobalDefault(true);
+            setJsonBackupEnabled(globalJsonBackupEnabled);
+            return true;
+        }
+        catch {
+            console.error('[Taskforce] Failed to use global backup default');
+            return false;
+        }
+    }, [globalJsonBackupEnabled, setJsonBackupEnabled, setJsonBackupUseGlobalDefault]);
     const handleSaveGlobalWeekStartsOn = useCallback(async (weekStartsOn) => {
         setGlobalWeekStartsOn(weekStartsOn);
         try {
@@ -176,43 +214,12 @@ export function useSettingsPersistence(input) {
             return false;
         }
     }, [setChecklistDropdownEnabled]);
-    const handleShowTaskCardStatusLabelChange = useCallback(async (enabled) => {
-        setShowTaskCardStatusLabel(enabled);
-        try {
-            const configRes = await fetch('/api/taskforce/config', {
-                method: 'POST',
-                headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({ showTaskCardStatusLabel: enabled }),
-            });
-            if (!configRes.ok) {
-                throw new Error(`Failed to save config (${configRes.status})`);
-            }
-            return true;
-        }
-        catch {
-            console.error('[Taskforce] Failed to save task card status label setting');
-            return false;
-        }
-    }, [setShowTaskCardStatusLabel]);
-    const handleResetProjectToGlobal = useCallback(async () => {
-        setThemeUseGlobalDefault(true);
-        setJsonBackupUseGlobalDefault(true);
-        setCurrentTheme(globalTheme);
-        setJsonBackupEnabled(globalJsonBackupEnabled);
-        setManualComplexityEnabled(false);
-        setChecklistDropdownEnabled(true);
-        setShowTaskCardStatusLabel(false);
+    const saveTaskCardPreference = useCallback(async (key, enabled, errorMessage) => {
         try {
             const configRes = await fetch('/api/taskforce/config', {
                 method: 'POST',
                 headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({
-                    theme: null,
-                    jsonBackupEnabled: null,
-                    manualComplexityEnabled: null,
-                    checklistDropdownEnabled: null,
-                    showTaskCardStatusLabel: null
-                }),
+                body: JSON.stringify({ [key]: enabled }),
             });
             if (!configRes.ok) {
                 throw new Error(`Failed to save config (${configRes.status})`);
@@ -220,31 +227,51 @@ export function useSettingsPersistence(input) {
             return true;
         }
         catch {
-            console.error('[Taskforce] Failed to reset project settings');
+            console.error(`[Taskforce] ${errorMessage}`);
             return false;
         }
-    }, [
-        setThemeUseGlobalDefault,
-        setJsonBackupUseGlobalDefault,
-        setCurrentTheme,
-        globalTheme,
-        setJsonBackupEnabled,
-        globalJsonBackupEnabled,
-        setManualComplexityEnabled,
-        setChecklistDropdownEnabled,
-        setShowTaskCardStatusLabel
-    ]);
+    }, []);
+    const handleShowTaskCardStatusLabelChange = useCallback(async (enabled) => {
+        setShowTaskCardStatusLabel(enabled);
+        return saveTaskCardPreference('showTaskCardStatusLabel', enabled, 'Failed to save task card status label setting');
+    }, [saveTaskCardPreference, setShowTaskCardStatusLabel]);
+    const handleShowTaskCardDescriptionChange = useCallback(async (enabled) => {
+        setShowTaskCardDescription(enabled);
+        return saveTaskCardPreference('showTaskCardDescription', enabled, 'Failed to save task card description setting');
+    }, [saveTaskCardPreference, setShowTaskCardDescription]);
+    const handleShowTaskCardAttachmentsChange = useCallback(async (enabled) => {
+        setShowTaskCardAttachments(enabled);
+        return saveTaskCardPreference('showTaskCardAttachments', enabled, 'Failed to save task card attachments setting');
+    }, [saveTaskCardPreference, setShowTaskCardAttachments]);
+    const handleShowTaskCardChecklistProgressChange = useCallback(async (enabled) => {
+        setShowTaskCardChecklistProgress(enabled);
+        return saveTaskCardPreference('showTaskCardChecklistProgress', enabled, 'Failed to save task card checklist progress setting');
+    }, [saveTaskCardPreference, setShowTaskCardChecklistProgress]);
+    const handleShowTaskCardLatestActivityChange = useCallback(async (enabled) => {
+        setShowTaskCardLatestActivity(enabled);
+        return saveTaskCardPreference('showTaskCardLatestActivity', enabled, 'Failed to save task card latest activity setting');
+    }, [saveTaskCardPreference, setShowTaskCardLatestActivity]);
+    const handleTintTaskCardActivityBackgroundChange = useCallback(async (enabled) => {
+        setTintTaskCardActivityBackground(enabled);
+        return saveTaskCardPreference('tintTaskCardActivityBackground', enabled, 'Failed to save task card activity background setting');
+    }, [saveTaskCardPreference, setTintTaskCardActivityBackground]);
     return {
         handleSaveSettings,
         handleSaveTheme,
         handleSaveGlobalTheme,
+        handleUseGlobalThemeDefault,
         handleJsonBackupEnabledChange,
         handleSaveGlobalJsonBackupEnabled,
+        handleUseGlobalJsonBackupDefault,
         handleSaveGlobalWeekStartsOn,
         handleSaveLocale,
         handleManualComplexityEnabledChange,
         handleChecklistDropdownEnabledChange,
         handleShowTaskCardStatusLabelChange,
-        handleResetProjectToGlobal
+        handleShowTaskCardDescriptionChange,
+        handleShowTaskCardAttachmentsChange,
+        handleShowTaskCardChecklistProgressChange,
+        handleShowTaskCardLatestActivityChange,
+        handleTintTaskCardActivityBackgroundChange
     };
 }

package/dist/hooks/useFilterSort.d.ts

@@ -20,8 +20,12 @@ interface UseFilterSortProps {
     referenceDataLoaded: boolean;
     assigneeOptionsLoaded: boolean;
     assigneeOptions?: TaskAssigneeOption[];
+    runtimeMode?: 'local' | 'cloud';
+    workspaceId?: string;
+    cloudTaskSearchEnabled?: boolean;
+    cloudTaskSearchScope?: 'active' | 'archive';
 }
-export declare function useFilterSort({ tasks, archivedTasks, activeCategories, activeTypes, priorities, taxonomies, configLoaded, referenceDataLoaded, assigneeOptionsLoaded, assigneeOptions }: UseFilterSortProps): {
+export declare function useFilterSort({ tasks, archivedTasks, activeCategories, activeTypes, priorities, taxonomies, configLoaded, referenceDataLoaded, assigneeOptionsLoaded, assigneeOptions, runtimeMode, workspaceId, cloudTaskSearchEnabled, cloudTaskSearchScope, }: UseFilterSortProps): {
     searchQuery: string;
     setSearchQuery: import("react").Dispatch<import("react").SetStateAction<string>>;
     filterCategories: string[];
@@ -45,8 +49,8 @@ export declare function useFilterSort({ tasks, archivedTasks, activeCategories,
     sortOrder: "asc" | "desc";
     setSortOrder: import("react").Dispatch<import("react").SetStateAction<"asc" | "desc">>;
     toggleSortOrder: () => void;
-    groupBy: "category" | "type" | "priority" | "status" | "complexity" | "assignee" | "schedule";
-    setGroupBy: import("react").Dispatch<import("react").SetStateAction<"category" | "type" | "priority" | "status" | "complexity" | "assignee" | "schedule">>;
+    groupBy: "category" | "type" | "priority" | "complexity" | "status" | "assignee" | "schedule";
+    setGroupBy: import("react").Dispatch<import("react").SetStateAction<"category" | "type" | "priority" | "complexity" | "status" | "assignee" | "schedule">>;
     emptyColumnMode: "show" | "collapse" | "hide";
     setEmptyColumnMode: import("react").Dispatch<import("react").SetStateAction<"show" | "collapse" | "hide">>;
     collapsedCategories: Record<string, boolean>;