@taskforcehq/taskforce 0.3.170 → 0.3.301

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

@@ -0,0 +1,203 @@
+type WorkspaceRole = 'owner' | 'admin' | 'member' | 'read-only';
+type SettingsSection = 'categories' | 'types' | 'general' | 'appearance-application' | 'appearance-task-cards' | 'appearance-task-forms' | 'documents' | 'commands' | 'workflow-editor' | 'agents' | 'taxonomy' | 'mcp' | 'integrations' | 'resources' | 'priorities' | 'initiatives' | null;
+type UseSettingsModelInput = {
+    resolveCloudAuthUrl: (path: string) => string;
+    currentWorkspaceId: string;
+    normalizedCloudAuthBaseUrl?: string | null;
+    normalizedCloudMcpBaseUrl?: string | null;
+    mergedConfig: {
+        cloudAuthBaseUrl?: string;
+    };
+    availableWorkspaces: Array<{
+        id: string;
+        role?: string;
+        name?: string;
+    }>;
+    currentTheme: any;
+    configLoaded: boolean;
+    globalTheme: any;
+    themeUseGlobalDefault: boolean;
+    keyShortcut: string;
+    jsonBackupEnabled: boolean;
+    globalJsonBackupEnabled: boolean;
+    globalWeekStartsOn: 'sunday' | 'monday';
+    locale: string;
+    supportedLocales: any[];
+    jsonBackupUseGlobalDefault: boolean;
+    manualComplexityEnabled: boolean;
+    checklistDropdownEnabled: boolean;
+    showTaskCardStatusLabel: boolean;
+    exportWorkflowsPath: string;
+    exportingResource: any;
+    exportResult: any;
+    pathSaved: boolean;
+    settingsSection: SettingsSection;
+    exportEnvironment: string;
+    setupState: any;
+    buildInfo: any;
+    saveSetupMode: (...args: any[]) => any;
+    saveWorkspaceProfile: (...args: any[]) => any;
+    setCurrentTheme: (value: any) => void;
+    handleSaveTheme: (...args: any[]) => any;
+    handleSaveGlobalTheme: (...args: any[]) => any;
+    setKeyShortcut: (value: string) => void;
+    handleJsonBackupEnabledChange: (...args: any[]) => any;
+    handleSaveGlobalJsonBackupEnabled: (...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;
+    handleSaveSettings: (...args: any[]) => any;
+    setExportWorkflowsPath: (value: string) => void;
+    setExportEnvironment: (value: string) => void;
+    availableWorkflows: any[];
+    initiativeTemplates: any[];
+    availableEnvironments: any[];
+    fetchWorkflows: (...args: any[]) => any;
+    fetchInitiativeTemplates: (...args: any[]) => any;
+    createInitiativeFromTemplate: (...args: any[]) => any;
+    fetchWorkflowTemplate: (...args: any[]) => any;
+    fetchWorkflowOverrideNames: (...args: any[]) => any;
+    saveWorkflowTemplateDraft: (...args: any[]) => any;
+    resetWorkflowTemplateDraft: (...args: any[]) => any;
+    handleExportWorkflows: (...args: any[]) => any;
+    setShowFolderBrowser: (value: boolean) => void;
+    setBrowserTarget: (value: any) => void;
+    fetchFolders: (...args: any[]) => any;
+    activeCategories: any[];
+    pathValidation: Record<string, any>;
+    taxonomyDisplayLabels: {
+        category?: string;
+        type?: string;
+        priority?: string;
+    };
+    handleUpdateCategory: (...args: any[]) => any;
+    handleRemoveCategory: (...args: any[]) => any;
+    handleSaveCategory: (...args: any[]) => any;
+    handleAddPath: (...args: any[]) => any;
+    handleRemovePath: (...args: any[]) => any;
+    handleUpdateCategoryIcon: (...args: any[]) => any;
+    handleUpdateCategoryColor: (...args: any[]) => any;
+    activeTypes: any[];
+    handleSaveType: (...args: any[]) => any;
+    handleRemoveType: (...args: any[]) => any;
+    handleUpdateType: (...args: any[]) => any;
+    taxonomies: any[];
+    handleUpdateTaxonomies: (...args: any[]) => any;
+    priorities: any[];
+    handleUpdatePriorities: (...args: any[]) => any;
+    analyzeSystemTaxonomyPack: (...args: any[]) => any;
+    handleApplySystemTaxonomyPack: (...args: any[]) => any;
+    handleUpdateTaxonomyDisplayLabels: (...args: any[]) => any;
+    projectRoot: string;
+    projectName: string;
+    mcpHostRoot: string;
+    serverHostRoot: string;
+    mcpScriptPath: string;
+    tenantId: string;
+    runtimeMode: 'local' | 'cloud';
+    workspaceSwitchingEnabled: boolean;
+    deleteWorkspace: (...args: any[]) => any;
+    setMcpHostRoot: (value: string) => void;
+    isAuthenticated: boolean;
+};
+export declare function useSettingsModel(input: UseSettingsModelInput): {
+    fetchCloudAuthApi: (path: string, init?: RequestInit) => Promise<Response>;
+    currentTheme: any;
+    configLoaded: boolean;
+    globalTheme: any;
+    themeUseGlobalDefault: boolean;
+    keyShortcut: string;
+    jsonBackupEnabled: boolean;
+    globalJsonBackupEnabled: boolean;
+    globalWeekStartsOn: "sunday" | "monday";
+    locale: string;
+    supportedLocales: any[];
+    jsonBackupUseGlobalDefault: boolean;
+    manualComplexityEnabled: boolean;
+    checklistDropdownEnabled: boolean;
+    showTaskCardStatusLabel: boolean;
+    exportWorkflowsPath: string;
+    exportingResource: any;
+    exportResult: any;
+    pathSaved: boolean;
+    initialSection: SettingsSection;
+    exportEnvironment: string;
+    setupState: any;
+    buildInfo: any;
+    onSaveSetupMode: (...args: any[]) => any;
+    onSaveWorkspaceProfile: (...args: any[]) => any;
+    onThemeChange: (value: any) => void;
+    onSaveTheme: (...args: any[]) => any;
+    onSaveGlobalTheme: (...args: any[]) => any;
+    onKeyShortcutChange: (value: string) => void;
+    onJsonBackupEnabledChange: (...args: any[]) => any;
+    onSaveGlobalJsonBackupEnabled: (...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;
+    onSaveSettings: (...args: any[]) => any;
+    onExportWorkflowsPathChange: (value: string) => void;
+    onExportEnvironmentChange: (value: string) => void;
+    availableWorkflows: any[];
+    initiativeTemplates: any[];
+    availableEnvironments: any[];
+    onRefreshWorkflows: (...args: any[]) => any;
+    onRefreshInitiativeTemplates: (...args: any[]) => any;
+    onCreateInitiativeFromTemplate: (...args: any[]) => any;
+    onFetchWorkflowTemplate: (...args: any[]) => any;
+    onFetchWorkflowOverrideNames: (...args: any[]) => any;
+    onSaveWorkflowTemplateDraft: (...args: any[]) => any;
+    onResetWorkflowTemplateDraft: (...args: any[]) => any;
+    onExportWorkflows: (...args: any[]) => any;
+    onShowFolderBrowserChange: (value: boolean) => void;
+    onBrowserTargetChange: (value: any) => void;
+    onFetchFolders: (...args: any[]) => any;
+    categories: any[];
+    pathValidation: Record<string, any>;
+    taxonomyDisplayLabels: {
+        category?: string;
+        type?: string;
+        priority?: string;
+    };
+    onUpdateCategory: (...args: any[]) => any;
+    onRemoveCategory: (...args: any[]) => any;
+    onSaveCategory: (...args: any[]) => any;
+    onAddPath: (...args: any[]) => any;
+    onRemovePath: (...args: any[]) => any;
+    onUpdateCategoryIcon: (...args: any[]) => any;
+    onUpdateCategoryColor: (...args: any[]) => any;
+    types: any[];
+    onSaveType: (...args: any[]) => any;
+    onRemoveType: (...args: any[]) => any;
+    onUpdateType: (...args: any[]) => any;
+    taxonomies: any[];
+    onUpdateTaxonomies: (...args: any[]) => any;
+    priorities: any[];
+    onUpdatePriorities: (...args: any[]) => any;
+    onAnalyzeSystemTaxonomyPack: (...args: any[]) => any;
+    onApplySystemTaxonomyPack: (...args: any[]) => any;
+    onUpdateTaxonomyDisplayLabels: (...args: any[]) => any;
+    projectRoot: string;
+    projectName: string;
+    mcpHostRoot: string;
+    serverHostRoot: string;
+    mcpScriptPath: string;
+    tenantId: string;
+    workspaceId: string;
+    runtimeMode: "local" | "cloud";
+    cloudAuthBaseUrl: string | undefined;
+    cloudMcpBaseUrl: string | undefined;
+    workspaceSwitchingEnabled: boolean;
+    currentWorkspaceRole: WorkspaceRole;
+    currentWorkspaceName: string;
+    onDeleteWorkspace: (...args: any[]) => any;
+    onMcpHostRootChange: (value: string) => void;
+    isAuthenticated: boolean;
+};
+export {};

package/dist/hooks/ui/useSettingsModel.js

@@ -0,0 +1,125 @@
+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, exportWorkflowsPath, exportingResource, exportResult, pathSaved, settingsSection, exportEnvironment, setupState, buildInfo, saveSetupMode, saveWorkspaceProfile, setCurrentTheme, handleSaveTheme, handleSaveGlobalTheme, setKeyShortcut, handleJsonBackupEnabledChange, handleSaveGlobalJsonBackupEnabled, handleSaveGlobalWeekStartsOn, handleSaveLocale, handleManualComplexityEnabledChange, handleChecklistDropdownEnabledChange, handleShowTaskCardStatusLabelChange, handleResetProjectToGlobal, handleSaveSettings, setExportWorkflowsPath, setExportEnvironment, availableWorkflows, initiativeTemplates, availableEnvironments, fetchWorkflows, fetchInitiativeTemplates, createInitiativeFromTemplate, fetchWorkflowTemplate, fetchWorkflowOverrideNames, saveWorkflowTemplateDraft, resetWorkflowTemplateDraft, handleExportWorkflows, 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);
+        if (path.startsWith('/api/taskforce/settings/mcp/')) {
+            const workspaceHeader = String(currentWorkspaceId || '').trim();
+            if (workspaceHeader && workspaceHeader !== 'default' && !headers.has('x-taskforce-workspace-id')) {
+                headers.set('x-taskforce-workspace-id', workspaceHeader);
+            }
+        }
+        const nextInit = {
+            ...init,
+            headers,
+            credentials: init?.credentials ?? 'include'
+        };
+        if (typeof window !== 'undefined' && /^https?:\/\//i.test(resolvedUrl)) {
+            try {
+                const target = new URL(resolvedUrl, window.location.origin);
+                if (target.origin !== window.location.origin && nextInit.mode === undefined) {
+                    nextInit.mode = 'cors';
+                }
+            }
+            catch {
+                // Leave mode untouched if URL parsing fails.
+            }
+        }
+        return fetch(resolvedUrl, nextInit);
+    }, [currentWorkspaceId, resolveCloudAuthUrl]);
+    const currentWorkspace = availableWorkspaces.find((workspace) => workspace.id === currentWorkspaceId);
+    return {
+        fetchCloudAuthApi,
+        currentTheme,
+        configLoaded,
+        globalTheme,
+        themeUseGlobalDefault,
+        keyShortcut,
+        jsonBackupEnabled,
+        globalJsonBackupEnabled,
+        globalWeekStartsOn,
+        locale,
+        supportedLocales,
+        jsonBackupUseGlobalDefault,
+        manualComplexityEnabled,
+        checklistDropdownEnabled,
+        showTaskCardStatusLabel,
+        exportWorkflowsPath,
+        exportingResource,
+        exportResult,
+        pathSaved,
+        initialSection: settingsSection,
+        exportEnvironment,
+        setupState,
+        buildInfo,
+        onSaveSetupMode: saveSetupMode,
+        onSaveWorkspaceProfile: saveWorkspaceProfile,
+        onThemeChange: setCurrentTheme,
+        onSaveTheme: handleSaveTheme,
+        onSaveGlobalTheme: handleSaveGlobalTheme,
+        onKeyShortcutChange: setKeyShortcut,
+        onJsonBackupEnabledChange: handleJsonBackupEnabledChange,
+        onSaveGlobalJsonBackupEnabled: handleSaveGlobalJsonBackupEnabled,
+        onSaveGlobalWeekStartsOn: handleSaveGlobalWeekStartsOn,
+        onSaveLocale: handleSaveLocale,
+        onManualComplexityEnabledChange: handleManualComplexityEnabledChange,
+        onChecklistDropdownEnabledChange: handleChecklistDropdownEnabledChange,
+        onShowTaskCardStatusLabelChange: handleShowTaskCardStatusLabelChange,
+        onResetProjectToGlobal: handleResetProjectToGlobal,
+        onSaveSettings: handleSaveSettings,
+        onExportWorkflowsPathChange: setExportWorkflowsPath,
+        onExportEnvironmentChange: setExportEnvironment,
+        availableWorkflows,
+        initiativeTemplates,
+        availableEnvironments,
+        onRefreshWorkflows: fetchWorkflows,
+        onRefreshInitiativeTemplates: fetchInitiativeTemplates,
+        onCreateInitiativeFromTemplate: createInitiativeFromTemplate,
+        onFetchWorkflowTemplate: fetchWorkflowTemplate,
+        onFetchWorkflowOverrideNames: fetchWorkflowOverrideNames,
+        onSaveWorkflowTemplateDraft: saveWorkflowTemplateDraft,
+        onResetWorkflowTemplateDraft: resetWorkflowTemplateDraft,
+        onExportWorkflows: handleExportWorkflows,
+        onShowFolderBrowserChange: setShowFolderBrowser,
+        onBrowserTargetChange: setBrowserTarget,
+        onFetchFolders: fetchFolders,
+        categories: activeCategories,
+        pathValidation,
+        taxonomyDisplayLabels,
+        onUpdateCategory: handleUpdateCategory,
+        onRemoveCategory: handleRemoveCategory,
+        onSaveCategory: handleSaveCategory,
+        onAddPath: handleAddPath,
+        onRemovePath: handleRemovePath,
+        onUpdateCategoryIcon: handleUpdateCategoryIcon,
+        onUpdateCategoryColor: handleUpdateCategoryColor,
+        types: activeTypes,
+        onSaveType: handleSaveType,
+        onRemoveType: handleRemoveType,
+        onUpdateType: handleUpdateType,
+        taxonomies,
+        onUpdateTaxonomies: handleUpdateTaxonomies,
+        priorities,
+        onUpdatePriorities: handleUpdatePriorities,
+        onAnalyzeSystemTaxonomyPack: analyzeSystemTaxonomyPack,
+        onApplySystemTaxonomyPack: handleApplySystemTaxonomyPack,
+        onUpdateTaxonomyDisplayLabels: handleUpdateTaxonomyDisplayLabels,
+        projectRoot,
+        projectName,
+        mcpHostRoot,
+        serverHostRoot,
+        mcpScriptPath,
+        tenantId,
+        workspaceId: currentWorkspaceId,
+        runtimeMode,
+        cloudAuthBaseUrl: normalizedCloudAuthBaseUrl || mergedConfig.cloudAuthBaseUrl,
+        cloudMcpBaseUrl: normalizedCloudMcpBaseUrl || undefined,
+        workspaceSwitchingEnabled,
+        currentWorkspaceRole: (currentWorkspace?.role || 'member'),
+        currentWorkspaceName: String(currentWorkspace?.name || ''),
+        onDeleteWorkspace: deleteWorkspace,
+        onMcpHostRootChange: setMcpHostRoot,
+        isAuthenticated
+    };
+}

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

@@ -0,0 +1,36 @@
+import type { TaskforceTheme } from '../../types';
+type WeekStartsOn = 'sunday' | 'monday';
+interface UseSettingsPersistenceInput {
+    keyShortcut: string;
+    themeUseGlobalDefault: boolean;
+    runtimeMode: 'local' | 'cloud';
+    jsonBackupUseGlobalDefault: boolean;
+    globalTheme: TaskforceTheme;
+    globalJsonBackupEnabled: boolean;
+    setCurrentTheme: (theme: TaskforceTheme) => void;
+    setThemeUseGlobalDefault: (value: boolean) => void;
+    setGlobalTheme: (theme: TaskforceTheme) => void;
+    setJsonBackupEnabled: (value: boolean) => void;
+    setJsonBackupUseGlobalDefault: (value: boolean) => void;
+    setGlobalJsonBackupEnabled: (value: boolean) => void;
+    setGlobalWeekStartsOn: (value: WeekStartsOn) => void;
+    setLocale: (value: any) => void;
+    setManualComplexityEnabled: (value: boolean) => void;
+    setChecklistDropdownEnabled: (value: boolean) => void;
+    setShowTaskCardStatusLabel: (value: boolean) => void;
+    setShowChecklist: (value: boolean) => void;
+}
+export declare function useSettingsPersistence(input: UseSettingsPersistenceInput): {
+    handleSaveSettings: () => Promise<boolean>;
+    handleSaveTheme: (theme: TaskforceTheme) => Promise<boolean>;
+    handleSaveGlobalTheme: (theme: TaskforceTheme) => Promise<boolean>;
+    handleJsonBackupEnabledChange: (enabled: boolean) => Promise<boolean>;
+    handleSaveGlobalJsonBackupEnabled: (enabled: boolean) => 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>;
+};
+export {};

package/dist/hooks/ui/useSettingsPersistence.js

@@ -0,0 +1,254 @@
+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, setShowChecklist } = input;
+    const handleSaveSettings = useCallback(async () => {
+        try {
+            const globalRes = await fetch('/api/taskforce/global-settings', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    shortcut: keyShortcut
+                }),
+            });
+            if (!globalRes.ok) {
+                throw new Error(`Failed to save global settings (${globalRes.status})`);
+            }
+            return true;
+        }
+        catch {
+            console.error('[Taskforce] Failed to save shortcut');
+            return false;
+        }
+    }, [keyShortcut]);
+    const handleSaveTheme = useCallback(async (theme) => {
+        setCurrentTheme(theme);
+        setThemeUseGlobalDefault(false);
+        try {
+            const configRes = await fetch('/api/taskforce/config', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ theme }),
+            });
+            if (!configRes.ok) {
+                throw new Error(`Failed to save config (${configRes.status})`);
+            }
+            return true;
+        }
+        catch {
+            console.error('[Taskforce] Failed to save project theme');
+            return false;
+        }
+    }, [setCurrentTheme, setThemeUseGlobalDefault]);
+    const handleSaveGlobalTheme = useCallback(async (theme) => {
+        setGlobalTheme(theme);
+        if (themeUseGlobalDefault) {
+            setCurrentTheme(theme);
+        }
+        try {
+            const globalRes = await fetch('/api/taskforce/global-settings', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ theme }),
+            });
+            if (!globalRes.ok) {
+                throw new Error(`Failed to save global settings (${globalRes.status})`);
+            }
+            return true;
+        }
+        catch {
+            console.error('[Taskforce] Failed to save global theme');
+            return false;
+        }
+    }, [setGlobalTheme, themeUseGlobalDefault, setCurrentTheme]);
+    const handleJsonBackupEnabledChange = useCallback(async (enabled) => {
+        if (runtimeMode === 'cloud') {
+            setJsonBackupEnabled(false);
+            setJsonBackupUseGlobalDefault(false);
+            return false;
+        }
+        setJsonBackupEnabled(enabled);
+        setJsonBackupUseGlobalDefault(false);
+        try {
+            const configRes = await fetch('/api/taskforce/config', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ jsonBackupEnabled: enabled }),
+            });
+            if (!configRes.ok) {
+                throw new Error(`Failed to save config (${configRes.status})`);
+            }
+            return true;
+        }
+        catch {
+            console.error('[Taskforce] Failed to save project backup setting');
+            return false;
+        }
+    }, [runtimeMode, setJsonBackupEnabled, setJsonBackupUseGlobalDefault]);
+    const handleSaveGlobalJsonBackupEnabled = useCallback(async (enabled) => {
+        if (runtimeMode === 'cloud') {
+            setGlobalJsonBackupEnabled(false);
+            if (jsonBackupUseGlobalDefault) {
+                setJsonBackupEnabled(false);
+            }
+            return false;
+        }
+        setGlobalJsonBackupEnabled(enabled);
+        if (jsonBackupUseGlobalDefault) {
+            setJsonBackupEnabled(enabled);
+        }
+        try {
+            const globalRes = await fetch('/api/taskforce/global-settings', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ jsonBackupEnabled: enabled }),
+            });
+            if (!globalRes.ok) {
+                throw new Error(`Failed to save global settings (${globalRes.status})`);
+            }
+            return true;
+        }
+        catch {
+            console.error('[Taskforce] Failed to save global backup setting');
+            return false;
+        }
+    }, [runtimeMode, setGlobalJsonBackupEnabled, jsonBackupUseGlobalDefault, setJsonBackupEnabled]);
+    const handleSaveGlobalWeekStartsOn = useCallback(async (weekStartsOn) => {
+        setGlobalWeekStartsOn(weekStartsOn);
+        try {
+            const globalRes = await fetch('/api/taskforce/global-settings', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    schedulePreferences: {
+                        weekStartsOn
+                    }
+                }),
+            });
+            if (!globalRes.ok) {
+                throw new Error(`Failed to save global settings (${globalRes.status})`);
+            }
+            return true;
+        }
+        catch {
+            console.error('[Taskforce] Failed to save regional week start setting');
+            return false;
+        }
+    }, [setGlobalWeekStartsOn]);
+    const handleSaveLocale = useCallback(async (nextLocale) => {
+        const applied = setAppLocale(nextLocale);
+        setLocale(applied);
+        return true;
+    }, [setLocale]);
+    const handleManualComplexityEnabledChange = useCallback(async (enabled) => {
+        setManualComplexityEnabled(enabled);
+        try {
+            const configRes = await fetch('/api/taskforce/config', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ manualComplexityEnabled: enabled }),
+            });
+            if (!configRes.ok) {
+                throw new Error(`Failed to save config (${configRes.status})`);
+            }
+            return true;
+        }
+        catch {
+            console.error('[Taskforce] Failed to save manual complexity setting');
+            return false;
+        }
+    }, [setManualComplexityEnabled]);
+    const handleChecklistDropdownEnabledChange = useCallback(async (enabled) => {
+        setChecklistDropdownEnabled(enabled);
+        if (!enabled)
+            setShowChecklist(false);
+        try {
+            const configRes = await fetch('/api/taskforce/config', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ checklistDropdownEnabled: enabled }),
+            });
+            if (!configRes.ok) {
+                throw new Error(`Failed to save config (${configRes.status})`);
+            }
+            return true;
+        }
+        catch {
+            console.error('[Taskforce] Failed to save checklist dropdown setting');
+            return false;
+        }
+    }, [setChecklistDropdownEnabled, setShowChecklist]);
+    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(true);
+        setShowChecklist(false);
+        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
+                }),
+            });
+            if (!configRes.ok) {
+                throw new Error(`Failed to save config (${configRes.status})`);
+            }
+            return true;
+        }
+        catch {
+            console.error('[Taskforce] Failed to reset project settings');
+            return false;
+        }
+    }, [
+        setThemeUseGlobalDefault,
+        setJsonBackupUseGlobalDefault,
+        setCurrentTheme,
+        globalTheme,
+        setJsonBackupEnabled,
+        globalJsonBackupEnabled,
+        setManualComplexityEnabled,
+        setChecklistDropdownEnabled,
+        setShowTaskCardStatusLabel,
+        setShowChecklist
+    ]);
+    return {
+        handleSaveSettings,
+        handleSaveTheme,
+        handleSaveGlobalTheme,
+        handleJsonBackupEnabledChange,
+        handleSaveGlobalJsonBackupEnabled,
+        handleSaveGlobalWeekStartsOn,
+        handleSaveLocale,
+        handleManualComplexityEnabledChange,
+        handleChecklistDropdownEnabledChange,
+        handleShowTaskCardStatusLabelChange,
+        handleResetProjectToGlobal
+    };
+}