@taskforcehq/taskforce 0.3.328 → 0.3.330

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/useSyncOrchestrator.d.ts

@@ -79,9 +79,12 @@ export declare function useSyncOrchestrator(input: UseSyncOrchestratorInput): {
         phase: import("./sync/useLocalSyncCoordinatorSnapshot.js").LocalSyncCoordinatorSnapshotPhase;
         snapshot: import("../sync/coordinator/localSyncCoordinatorBrowserClient.js").LocalSyncCoordinatorStatusResponse | null;
         errorMessage: string | null;
+        activeCommandType: import("../sync/coordinator/localSyncCoordinatorTypes").LocalSyncCoordinatorCommandType | null;
+        activePriorityCommandType: import("../sync/coordinator/localSyncCoordinatorTypes").LocalSyncCoordinatorCommandType | null;
     } | null;
     switchLocalCoordinatorWorkspace: (targetWorkspaceId: string) => Promise<boolean>;
     transferLocalCoordinatorOwnership: (targetMode: "server" | "browser-gateway") => Promise<boolean>;
+    clearLocalCoordinatorCredential: () => Promise<boolean>;
     syncInFlightRef: import("react").RefObject<boolean>;
     workspaceRetryAt: string | null;
     isWorkspaceRetryPending: () => boolean;