@taskforcehq/taskforce 0.3.328 → 0.3.329

package/dist/hooks/tasks/useTaskFormActions.js

@@ -4,7 +4,7 @@ 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, 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 { 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);
@@ -53,29 +53,46 @@ export function useTaskFormActions(input) {
         }
         createDraftOccupiedRef.current = createDraftOccupied;
     }, [createDraftOccupied, createTaskDurably, workspaceId]);
-    const buildTaskDraftSignature = useCallback((textDraft = readTextDraft(), attachmentDraft = getAttachmentsDraftRef.current()) => 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: attachmentDraft,
     }), [
         activeCategories,
         assignee,
+        buildTaskDraftSignatureFromEditorDraft,
         category,
         checklistItems,
-        comments,
         complexity,
         description,
         dueDate,
@@ -83,7 +100,9 @@ export function useTaskFormActions(input) {
         getPreferredCategoryValue,
         priority,
         readTextDraft,
+        resolveWorkstreamIdInput,
         scheduledDate,
+        status,
         title,
         type,
         workstreamInput
@@ -94,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
@@ -127,6 +157,11 @@ 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?.();
@@ -240,6 +275,9 @@ export function useTaskFormActions(input) {
             }
             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);
@@ -413,6 +451,7 @@ export function useTaskFormActions(input) {
         taskHttpMutationClient,
         updateTask,
         editingTaskId,
+        revisionConflict,
         editingReadOnlyMode,
         formTaxonomies,
         getPreferredCategoryValue,
@@ -468,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;
         }
@@ -501,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();
@@ -551,6 +600,7 @@ export function useTaskFormActions(input) {
         enqueueAutoSave,
         lastSavedDraftSignature,
         readTextDraft,
+        revisionConflict,
         saveTask,
         scheduledDate,
     ]);
@@ -637,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>;

package/dist/hooks/useFilterSort.js

@@ -29,8 +29,9 @@ import { normalizeTaskSearchQuery, taskMatchesSearch } from '../utils/taskSearch
 import { compareTasksBySortKey } from '../utils/taxonomySorting.js';
 import { getFilterVisibleTaxonomyOptions } from '../utils/taxonomyFilterOptions.js';
 import { getVisibleTaxonomiesForTasks } from '../utils/taxonomyLifecycle.js';
+import { useCloudTaskSearch } from './tasks/useCloudTaskSearch';
 // === SECTION: Filter State ===
-export function useFilterSort({ tasks, archivedTasks, activeCategories, activeTypes, priorities, taxonomies, configLoaded, referenceDataLoaded, assigneeOptionsLoaded, assigneeOptions }) {
+export function useFilterSort({ tasks, archivedTasks, activeCategories, activeTypes, priorities, taxonomies, configLoaded, referenceDataLoaded, assigneeOptionsLoaded, assigneeOptions, runtimeMode = 'local', workspaceId = '', cloudTaskSearchEnabled = false, cloudTaskSearchScope = 'active', }) {
     const relationshipTasks = useMemo(() => [...tasks, ...archivedTasks], [archivedTasks, tasks]);
     const resolvedAssigneeOptions = useMemo(() => normalizeAssigneeOptions(assigneeOptions), [assigneeOptions]);
     const filterableTaxonomies = useMemo(() => getVisibleTaxonomiesForTasks(taxonomies, relationshipTasks)
@@ -42,6 +43,13 @@ export function useFilterSort({ tasks, archivedTasks, activeCategories, activeTy
     const filterableTaxonomyById = useMemo(() => new Map(filterableTaxonomies.map((taxonomy) => [taxonomy.id, taxonomy])), [filterableTaxonomies]);
     const assigneeFilterValues = useMemo(() => resolvedAssigneeOptions.map((opt) => opt.value), [resolvedAssigneeOptions]);
     const [searchQuery, setSearchQuery] = useState('');
+    const cloudSearchMatchIds = useCloudTaskSearch({
+        query: searchQuery,
+        runtimeMode,
+        workspaceId,
+        enabled: cloudTaskSearchEnabled,
+        scope: cloudTaskSearchScope,
+    });
     const [filterCategories, setFilterCategories] = useState([]);
     const [filterPriorities, setFilterPriorities] = useState([]);
     const [filterTypes, setFilterTypes] = useState([]);
@@ -229,7 +237,8 @@ export function useFilterSort({ tasks, archivedTasks, activeCategories, activeTy
         const isAllPrioritiesSelected = isAllFilterValuesSelected(Array.from(new Set(filterPriorities.map((value) => Number(value)).filter((value) => Number.isFinite(value)))), priorities.map((priority) => Number(priority.value)).filter((value) => Number.isFinite(value)));
         const isAllStatusesSelected = isAllFilterValuesSelected(filterStatus, STATUS_OPTIONS.map((status) => status.value));
         return tasks.filter(t => {
-            const matchSearch = taskMatchesSearch(t, normalizedSearchQuery, taskSearchContext);
+            const matchSearch = taskMatchesSearch(t, normalizedSearchQuery, taskSearchContext)
+                || (Boolean(normalizedSearchQuery.raw) && cloudSearchMatchIds.has(t.id));
             const matchCategory = !hasInitedFilters || isAllCategoriesSelected || filterCategories.includes(t.category);
             const matchPriority = !hasInitedFilters || isAllPrioritiesSelected || matchesPriorityFilter(t.priority, filterPriorities);
             const matchType = !hasInitedFilters || isAllTypesSelected || filterTypes.includes(t.type || DEFAULT_TYPE_VALUE);
@@ -253,7 +262,7 @@ export function useFilterSort({ tasks, archivedTasks, activeCategories, activeTy
             });
             return matchSearch && matchCategory && matchPriority && matchType && matchStatus && matchAssignee && matchTaxonomies;
         }).sort((a, b) => compareTasksBySortKey(a, b, sortBy, sortOrder, taxonomies));
-    }, [tasks, normalizedSearchQuery, taskSearchContext, filterCategories, filterPriorities, filterTypes, filterStatus, filterAssignees, filterAssigneesAllSelected, filterTaxonomies, sortBy, sortOrder, hasInitedFilters, filterableTaxonomies, filterableTaxonomyById, activeCategories, activeTypes, priorities, isAllFilterValuesSelected, taxonomies]);
+    }, [tasks, normalizedSearchQuery, taskSearchContext, cloudSearchMatchIds, filterCategories, filterPriorities, filterTypes, filterStatus, filterAssignees, filterAssigneesAllSelected, filterTaxonomies, sortBy, sortOrder, hasInitedFilters, filterableTaxonomies, filterableTaxonomyById, activeCategories, activeTypes, priorities, isAllFilterValuesSelected, taxonomies]);
     const searchAgnosticTasks = useMemo(() => {
         const isAllCategoriesSelected = isAllFilterValuesSelected(filterCategories, activeCategories.map((category) => category.value));
         const isAllTypesSelected = isAllFilterValuesSelected(filterTypes, activeTypes.map((type) => type.value));
@@ -288,7 +297,8 @@ export function useFilterSort({ tasks, archivedTasks, activeCategories, activeTy
         const isAllTypesSelected = isAllFilterValuesSelected(filterTypes, activeTypes.map((type) => type.value));
         const isAllPrioritiesSelected = isAllFilterValuesSelected(Array.from(new Set(filterPriorities.map((value) => Number(value)).filter((value) => Number.isFinite(value)))), priorities.map((priority) => Number(priority.value)).filter((value) => Number.isFinite(value)));
         return archivedTasks.filter(t => {
-            const matchSearch = taskMatchesSearch(t, normalizedSearchQuery, taskSearchContext);
+            const matchSearch = taskMatchesSearch(t, normalizedSearchQuery, taskSearchContext)
+                || (Boolean(normalizedSearchQuery.raw) && cloudSearchMatchIds.has(t.id));
             const matchCategory = !hasInitedFilters || isAllCategoriesSelected || filterCategories.includes(t.category);
             const matchPriority = !hasInitedFilters || isAllPrioritiesSelected || matchesPriorityFilter(t.priority, filterPriorities);
             const matchType = !hasInitedFilters || isAllTypesSelected || filterTypes.includes(t.type || DEFAULT_TYPE_VALUE);
@@ -310,7 +320,7 @@ export function useFilterSort({ tasks, archivedTasks, activeCategories, activeTy
             });
             return matchSearch && matchCategory && matchPriority && matchType && matchAssignee && matchTaxonomies;
         }).sort((a, b) => compareTasksBySortKey(a, b, sortBy, sortOrder, taxonomies));
-    }, [archivedTasks, normalizedSearchQuery, taskSearchContext, filterCategories, filterPriorities, filterTypes, filterAssignees, filterAssigneesAllSelected, filterTaxonomies, sortBy, sortOrder, hasInitedFilters, activeCategories, activeTypes, priorities, filterableTaxonomies, filterableTaxonomyById, isAllFilterValuesSelected, taxonomies]);
+    }, [archivedTasks, normalizedSearchQuery, taskSearchContext, cloudSearchMatchIds, filterCategories, filterPriorities, filterTypes, filterAssignees, filterAssigneesAllSelected, filterTaxonomies, sortBy, sortOrder, hasInitedFilters, activeCategories, activeTypes, priorities, filterableTaxonomies, filterableTaxonomyById, isAllFilterValuesSelected, taxonomies]);
     const groupedTasks = useMemo(() => {
         const groups = {};
         filteredTasks.forEach(task => {

package/dist/hooks/useTaskData.d.ts

@@ -12,10 +12,14 @@ interface UseTaskDataProps {
     handleUnauthorized: () => void;
     /** Only used to detect auth changes in the fetch dependency array */
     authRequiredForApi: boolean;
+    setError?: (value: string) => void;
+    setLoading?: (value: boolean) => void;
 }
-export declare function useTaskData({ tasks, archivedTasks, setTasks, setArchivedTasks, setLoadingTasks, getCurrentWorkspaceId, workspaceResetKey, shouldDeferProtectedApiCalls, shouldBlockProtectedApiCalls, handleUnauthorized, authRequiredForApi }: UseTaskDataProps): {
+export declare function useTaskData({ tasks, archivedTasks, setTasks, setArchivedTasks, setLoadingTasks, getCurrentWorkspaceId, workspaceResetKey, shouldDeferProtectedApiCalls, shouldBlockProtectedApiCalls, handleUnauthorized, authRequiredForApi, setError, setLoading }: UseTaskDataProps): {
     tasksRef: import("react").RefObject<TaskItem[]>;
     archivedTasksRef: import("react").RefObject<TaskItem[]>;
+    taskDetails: TaskItem[];
+    staleTaskDetailRevisions: Record<string, string>;
     recentlyChangedTaskIds: string[];
     markRecentlyChangedTasks: (taskIds: string[]) => void;
     fetchTasks: (isSilent?: boolean, options?: {
@@ -26,6 +30,11 @@ export declare function useTaskData({ tasks, archivedTasks, setTasks, setArchive
     fetchArchive: (isSilent?: boolean, options?: {
         ignoreAuthGuard?: boolean;
     }) => Promise<boolean>;
+    loadTaskDetail: (task: TaskItem, options?: {
+        shouldCommit?: () => boolean;
+        force?: boolean;
+    }) => Promise<TaskItem | null>;
+    cancelTaskDetailLoad: () => void;
     refreshTaskCollections: (options?: {
         isSilent?: boolean;
         ignoreAuthGuard?: boolean;