@taskforcehq/taskforce 0.3.169 → 0.3.300

package/dist/hooks/useTaskforce.d.ts

@@ -1,5 +1,8 @@
-import type { TaskforceConfig, TaskforceTheme, Comment, AttachmentItem, CategoryConfig, TaskItem, TaxonomyDefinition, Environment, ParentTaskFilterMode, TaskAssignee } from '../types';
-interface UseTaskforceProps {
+import type { TaskforceConfig, TaskforceTheme, Comment, AttachmentItem, CategoryConfig, TaskItem, TaxonomyDefinition, Environment, TaskAssignee, TaskStatus, DeletedTaskRecord, InitiativeItem, WorkstreamItem, ChecklistItem } from '../types';
+import { type FirstClassTaxonomyDisplayLabels } from '../shared/taxonomyState.js';
+import type { UiNotice } from '../utils/uiNotice';
+import type { TaskAssigneeOption } from '../utils/assignees';
+export interface UseTaskforceProps {
     config?: Partial<TaskforceConfig>;
     initialTaskId?: string;
     onTaskCountChange?: (count: number) => void;
@@ -9,6 +12,8 @@ type WeekStartsOn = 'sunday' | 'monday';
 type SetupStateStatus = 'present' | 'missing' | 'unreadable';
 type WorkspaceMode = 'core' | 'operations';
 type BootstrapPhase = 'idle' | 'auth' | 'workspace' | 'config' | 'ready' | 'stalled';
+type TaskScope = 'open' | 'archived' | 'deleted';
+type WorkspaceModuleId = 'tasks' | 'docs' | 'annotate' | 'workflows' | 'agents';
 interface SetupStateSnapshot {
     globalSetupState: SetupStateStatus;
     workspaceSetupState: SetupStateStatus;
@@ -32,12 +37,6 @@ interface RuntimeCapabilities {
     supportsAdminManagedSetupOverrides: boolean;
     supportsPackageScriptSetupOverrides: boolean;
 }
-interface BuildMetadata {
-    version: string;
-    gitSha: string | null;
-    buildTime: string | null;
-    deployId: string | null;
-}
 interface WorkspaceSummary {
     id: string;
     slug?: string | null;
@@ -49,10 +48,18 @@ interface WorkspaceSummary {
 }
 export declare function useTaskforce({ config, initialTaskId, onTaskCountChange, onClose }: UseTaskforceProps): {
     config: {
+        cloudEnvironment: any;
+        apiBaseUrl: string | undefined;
+        cloudAuthBaseUrl: string | undefined;
+        wsBaseUrl: string | undefined;
         categories: string[] | CategoryConfig[];
         types: Array<{
             value: string;
             label: string;
+            color?: string;
+            icon?: string;
+            aliases?: string[];
+            status?: "active" | "retired";
         }>;
         priorities: Array<{
             value: number;
@@ -68,23 +75,21 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
         }>;
         taxonomies: TaxonomyDefinition[];
         apiEndpoint: string;
-        apiBaseUrl?: string;
-        cloudAuthBaseUrl?: string;
-        wsBaseUrl?: string;
+        cloudMcpBaseUrl?: string;
         position: "bottom-left" | "bottom-right" | "top-left" | "top-right";
         offsetY: number;
         theme: TaskforceTheme;
         shortcut: string;
         manualComplexityEnabled: boolean;
         checklistDropdownEnabled: boolean;
-        assigneeFilterEnabled: boolean;
+        showTaskCardStatusLabel: boolean;
     };
     isOpen: boolean;
     setIsOpen: import("react").Dispatch<import("react").SetStateAction<boolean>>;
-    activeTab: "settings" | "tasks" | "add";
+    activeTab: "tasks" | "settings" | "add";
     setActiveTab: (tab: "add" | "tasks" | "settings") => void;
-    currentTheme: TaskforceTheme;
-    setCurrentTheme: import("react").Dispatch<import("react").SetStateAction<TaskforceTheme>>;
+    currentTheme: "light" | "dawn" | "dark" | "midnight";
+    setCurrentTheme: import("react").Dispatch<import("react").SetStateAction<"light" | "dawn" | "dark" | "midnight">>;
     configLoaded: boolean;
     storagePath: string;
     saveSettings: () => Promise<boolean>;
@@ -99,12 +104,12 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     setJsonBackupEnabled: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     manualComplexityEnabled: boolean;
     checklistDropdownEnabled: boolean;
-    assigneeFilterEnabled: boolean;
+    showTaskCardStatusLabel: boolean;
     setManualComplexityEnabled: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     mcpHostRoot: string;
     setMcpHostRoot: import("react").Dispatch<import("react").SetStateAction<string>>;
-    settingsSection: "categories" | "types" | "general" | "documents" | "commands" | "workflow-editor" | "agents" | "taxonomy" | "mcp" | "resources" | null;
-    setSettingsSection: import("react").Dispatch<import("react").SetStateAction<"categories" | "types" | "general" | "documents" | "commands" | "workflow-editor" | "agents" | "taxonomy" | "mcp" | "resources" | null>>;
+    settingsSection: "mcp" | "categories" | "types" | "general" | "agents" | "taxonomy" | "documents" | "appearance-application" | "appearance-task-cards" | "appearance-task-forms" | "commands" | "workflow-editor" | "integrations" | "resources" | null;
+    setSettingsSection: import("react").Dispatch<import("react").SetStateAction<"mcp" | "categories" | "types" | "general" | "agents" | "taxonomy" | "documents" | "appearance-application" | "appearance-task-cards" | "appearance-task-forms" | "commands" | "workflow-editor" | "integrations" | "resources" | null>>;
     runtimeMode: "local" | "cloud";
     workspaceMode: "single-local" | "multi-cloud";
     workspaceSwitchingEnabled: boolean;
@@ -113,52 +118,69 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     authBlocked: boolean;
     isAuthenticated: boolean;
     authUserEmail: string;
-    userGlobalSyncStatus: "error" | "disconnected" | "idle" | "syncing";
-    userGlobalLastSyncedAt: string | null;
+    authUserDisplayName: string;
+    authWorkspaceId: string;
+    userGlobalSyncStatus: "error" | "idle" | "syncing" | "disconnected";
     workspaceLastPullAt: string | null;
     workspaceLastPushAt: string | null;
     workspaceLastErrorAt: string | null;
-    workspaceRetryAt: string | null;
-    userGlobalSyncPendingChanges: number;
     userGlobalSyncError: string | null;
     workspaceLastErrorMessage: string | null;
-    workspaceLastWarningMessage: string | null;
-    workspaceSyncFailureCount: number;
-    workspaceSyncRetryScheduledCount: number;
-    workspaceSyncAuthFailureCount: number;
-    workspaceSyncLastFailureSource: ("push" | "pull" | "apply" | "handshake") | null;
-    workspaceSyncLastFailureStatusCode: number | null;
-    workspaceBootstrapSyncInProgress: boolean;
-    workspaceBootstrapSyncPages: number;
-    workspaceBootstrapSyncAppliedChanges: number;
+    workspaceLastSuccessfulSyncAt: string | null;
+    workspaceSyncPhase: import("../sync/workspaceSyncState").WorkspaceSyncPhase;
+    workspaceSyncStatus: import("./useSyncOrchestrator").WorkspaceSyncStatus;
+    workspaceSyncSummary: string;
+    workspaceSyncRecommendedAction: string;
+    workspaceSyncBusy: boolean;
+    workspaceSyncPendingChanges: number;
     retryUserGlobalSettingsSync: () => Promise<void>;
-    retryWorkspaceCloudSync: () => Promise<void>;
+    retryWorkspaceCloudSync: () => Promise<boolean>;
     resetWorkspaceSyncCursorAndPull: () => Promise<void>;
+    getWorkspaceSyncDiagnostics: () => {
+        workspaceId: string;
+        enabled: boolean;
+        phase: import("../sync/workspaceSyncState").WorkspaceSyncPhase;
+        status: import("./useSyncOrchestrator").WorkspaceSyncStatus;
+        summary: string;
+        lastSuccessfulSyncAt: string | null;
+        lastPullAt: string | null;
+        lastPushAt: string | null;
+        lastErrorAt: string | null;
+        pendingChanges: number;
+        lastErrorMessage: string | null;
+        recommendedAction: string;
+        documentSnapshotCount: number;
+        aiProfileSnapshotCount: number;
+        aiProfileSnapshotRawCount: number;
+        aiProfileSnapshotLastFetchAt: string | null;
+        aiProfileSnapshotLastFetchError: string | null;
+        aiProfileSnapshotLastSkipReason: string | null;
+        assetSnapshotCount: number;
+        documentReviewSessionSnapshotCount: number;
+        documentReviewSessionSnapshotFingerprint: string;
+        annotatedAttachmentSessionSnapshotCount: number;
+        annotatedAttachmentSessionSnapshotFingerprint: string;
+        lastPushedAiProfileCount: number;
+        lastPushedAiProfileWatermarkCount: number;
+        forceFullAiProfilePushQueued: boolean;
+    };
     hasBetaAccess: boolean;
     realtimeSyncEnabled: boolean;
-    realtimeSyncFlagSource: "default" | "settings" | "env" | "unknown";
+    realtimeSyncFlagSource: "default" | "unknown" | "settings" | "env";
     currentWorkspaceId: string;
+    currentWorkspaceRole: "member" | "owner" | "admin" | "read-only" | null;
     availableWorkspaces: WorkspaceSummary[];
+    assigneeOptions: TaskAssigneeOption[];
     workspaceCloudSyncEnabled: boolean;
-    realtimeConnectionState: import("./useRealtimeSync").RealtimeConnectionState;
-    realtimeTelemetry: import("../sync/realtimeReconcile").RealtimeReconcileTelemetry;
-    workspaceSyncSourceOfTruth: "local" | "cloud" | null;
-    workspaceSyncOnboardingCompleted: boolean;
-    workspaceSyncReady: boolean;
-    workspaceCloudHydrated: boolean;
-    saveWorkspaceCloudSyncSettings: (input: {
+    saveWorkspaceCloudSyncSettings: (settings: {
         enabled: boolean;
-        sourceOfTruth?: "cloud" | "local" | null;
-        onboardingCompleted?: boolean;
     }) => Promise<{
         success: boolean;
         error?: string;
     }>;
-    applyWorkspaceSyncStateSnapshot: (nextState: {
-        cloudSyncEnabled: boolean;
-        sourceOfTruth?: "cloud" | "local" | null;
-        onboardingCompleted?: boolean;
-        pullCursor?: string | null;
+    applyWorkspaceSyncStateSnapshot: (nextState: Partial<import("../sync/workspaceSyncState").WorkspaceSyncStateV2> & {
+        enabled: boolean;
+        phase?: import("../sync/workspaceSyncState").WorkspaceSyncPhase | null;
     }) => void;
     authSessionResolved: boolean;
     workspaceBootstrapPending: boolean;
@@ -211,7 +233,12 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
         code?: string;
         workspaceSetupRequired?: boolean;
     }>;
-    registerWithCredentials: (email: string, password: string) => Promise<{
+    registerWithCredentials: (email: string, password: string, options?: {
+        displayName?: string | null;
+        planId?: string | null;
+        planVersionId?: string | null;
+        interval?: string | null;
+    }) => Promise<{
         success: boolean;
         error?: string;
         code?: string;
@@ -221,6 +248,18 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
         emailError?: string;
         workspaceSetupRequired?: boolean;
     }>;
+    updateCurrentUserProfile: (input: {
+        displayName: string;
+    }) => Promise<{
+        success: boolean;
+        error?: string;
+        code?: string;
+        profile?: {
+            userId: string;
+            email: string;
+            displayName: string | null;
+        };
+    }>;
     requestEmailVerification: (email: string) => Promise<{
         success: boolean;
         error?: string;
@@ -254,6 +293,8 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
         state?: string;
         email?: string;
         workspaceId?: string;
+        inviteeKind?: "existing_user" | "new_user";
+        passwordRequired?: boolean;
     }>;
     acceptInviteWithToken: (token: string, password: string) => Promise<{
         success: boolean;
@@ -261,6 +302,12 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
         code?: string;
         workspaceSetupRequired?: boolean;
     }>;
+    joinInviteWithToken: (token: string) => Promise<{
+        success: boolean;
+        error?: string;
+        code?: string;
+        workspaceSetupRequired?: boolean;
+    }>;
     logout: () => Promise<void>;
     showFolderBrowser: boolean;
     setShowFolderBrowser: import("react").Dispatch<import("react").SetStateAction<boolean>>;
@@ -268,21 +315,18 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     files: string[];
     currentBrowsePath: string;
     fetchFolders: (path?: string) => Promise<void>;
-    browserTarget: {
+    browserTarget: "storage" | {
         type: "category";
         value: string;
-    } | {
-        type: "context-link";
-    } | "storage" | null;
-    setBrowserTarget: import("react").Dispatch<import("react").SetStateAction<{
+    } | null;
+    setBrowserTarget: import("react").Dispatch<import("react").SetStateAction<"storage" | {
         type: "category";
         value: string;
-    } | {
-        type: "context-link";
-    } | "storage" | null>>;
-    contextLinkBrowsePath: string;
-    groupBy: "type" | "status" | "assignee" | "category" | "priority" | "approach" | "complexity" | "hierarchy" | "schedule" | "docs";
-    setGroupBy: import("react").Dispatch<import("react").SetStateAction<"type" | "status" | "assignee" | "category" | "priority" | "approach" | "complexity" | "hierarchy" | "schedule" | "docs">>;
+    } | null>>;
+    groupBy: "category" | "type" | "priority" | "status" | "complexity" | "approach" | "assignee" | "schedule";
+    setGroupBy: import("react").Dispatch<import("react").SetStateAction<"category" | "type" | "priority" | "status" | "complexity" | "approach" | "assignee" | "schedule">>;
+    activeWorkspaceModule: WorkspaceModuleId;
+    setActiveWorkspaceModule: import("react").Dispatch<import("react").SetStateAction<WorkspaceModuleId>>;
     emptyColumnMode: "show" | "collapse" | "hide";
     setEmptyColumnMode: import("react").Dispatch<import("react").SetStateAction<"show" | "collapse" | "hide">>;
     zenMode: boolean;
@@ -293,10 +337,17 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     tasks: TaskItem[];
     loadingTasks: boolean;
     archivedTasks: TaskItem[];
+    initiatives: InitiativeItem[];
+    workstreams: WorkstreamItem[];
+    deletedTasks: DeletedTaskRecord[];
     activeCategories: CategoryConfig[];
     activeTypes: {
         value: string;
         label: string;
+        color?: string;
+        icon?: string;
+        aliases?: string[];
+        status?: "active" | "retired";
     }[];
     priorities: {
         value: number;
@@ -304,16 +355,13 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
         color?: string;
         icon?: string;
     }[];
+    taxonomyDisplayLabels: FirstClassTaxonomyDisplayLabels;
     approaches: {
         value: string;
         label: string;
         color?: string;
         icon?: string;
     }[];
-    availableSpecialists: {
-        value: string;
-        label: string;
-    }[];
     taxonomies: TaxonomyDefinition[];
     searchQuery: string;
     setSearchQuery: import("react").Dispatch<import("react").SetStateAction<string>>;
@@ -325,21 +373,19 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     setFilterPriorities: import("react").Dispatch<import("react").SetStateAction<(string | number)[]>>;
     filterStatus: (string | number)[];
     setFilterStatus: import("react").Dispatch<import("react").SetStateAction<(string | number)[]>>;
-    filterAssignees: TaskAssignee[];
-    setFilterAssignees: import("react").Dispatch<import("react").SetStateAction<TaskAssignee[]>>;
-    parentTaskFilterMode: ParentTaskFilterMode;
-    setParentTaskFilterMode: import("react").Dispatch<import("react").SetStateAction<ParentTaskFilterMode>>;
-    showParentsOnly: boolean;
-    setShowParentsOnly: (show: boolean) => void;
+    filterAssignees: string[];
+    setFilterAssignees: (nextValues: TaskAssignee[] | ((prev: TaskAssignee[]) => TaskAssignee[])) => void;
     filterTaxonomies: Record<string, (string | number)[]>;
     setFilterTaxonomies: import("react").Dispatch<import("react").SetStateAction<Record<string, (string | number)[]>>>;
-    sortBy: "priority" | "complexity" | "created" | "updated";
-    setSortBy: import("react").Dispatch<import("react").SetStateAction<"priority" | "complexity" | "created" | "updated">>;
+    sortBy: import("../utils/taxonomySorting").TaskSortKey;
+    setSortBy: import("react").Dispatch<import("react").SetStateAction<import("../utils/taxonomySorting").TaskSortKey>>;
     sortOrder: "asc" | "desc";
     setSortOrder: import("react").Dispatch<import("react").SetStateAction<"asc" | "desc">>;
     toggleSortOrder: () => void;
     showArchive: boolean;
     setShowArchive: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    taskScope: TaskScope;
+    setTaskScope: import("react").Dispatch<import("react").SetStateAction<TaskScope>>;
     clearFilters: () => void;
     filteredTasks: TaskItem[];
     searchAgnosticTasks: TaskItem[];
@@ -350,8 +396,30 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     fetchTasks: (isSilent?: boolean, options?: {
         ignoreAuthGuard?: boolean;
     }) => Promise<void>;
-    fetchArchive: (isSilent?: boolean) => Promise<void>;
-    handleEdit: (task: TaskItem) => void;
+    fetchArchive: (isSilent?: boolean, options?: {
+        ignoreAuthGuard?: boolean;
+    }) => Promise<void>;
+    fetchDeletedTasks: (isSilent?: boolean, options?: {
+        ignoreAuthGuard?: boolean;
+    }) => Promise<void>;
+    fetchPlanningEntities: (options?: {
+        ignoreAuthGuard?: boolean;
+    }) => Promise<void>;
+    fetchAssigneeOptions: () => Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    createInitiative: (payload: Partial<InitiativeItem>) => Promise<InitiativeItem>;
+    updateInitiative: (id: string, payload: Partial<InitiativeItem>) => Promise<InitiativeItem>;
+    archiveInitiative: (id: string) => Promise<InitiativeItem>;
+    unarchiveInitiative: (id: string) => Promise<InitiativeItem>;
+    createWorkstream: (payload: Partial<WorkstreamItem>) => Promise<WorkstreamItem>;
+    updateWorkstream: (id: string, payload: Partial<WorkstreamItem>) => Promise<WorkstreamItem>;
+    archiveWorkstream: (id: string) => Promise<WorkstreamItem>;
+    unarchiveWorkstream: (id: string) => Promise<WorkstreamItem>;
+    handleEdit: (task: TaskItem, options?: {
+        preserveReturnTrail?: boolean;
+    }) => void;
     handleDelete: (id: string, archive?: boolean, options?: {
         skipConfirm?: boolean;
     }) => Promise<boolean>;
@@ -363,6 +431,9 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     handleArchiveTask: (task: TaskItem) => Promise<void>;
     handleBulkArchive: () => Promise<void>;
     handleUnarchive: (id: string) => Promise<void>;
+    handleRestoreDeletedTask: (id: string) => Promise<TaskItem | null>;
+    handlePermanentlyDeleteDeletedTask: (id: string) => Promise<boolean>;
+    handleEmptyDeletedTasks: () => Promise<number | null>;
     handleUpdateTask: (id: string, updates: Partial<TaskItem>) => Promise<void>;
     editingTaskId: string | null;
     loading: boolean;
@@ -371,6 +442,8 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     setTitle: import("react").Dispatch<import("react").SetStateAction<string>>;
     description: string;
     setDescription: import("react").Dispatch<import("react").SetStateAction<string>>;
+    checklistItems: ChecklistItem[];
+    setChecklistItems: import("react").Dispatch<import("react").SetStateAction<ChecklistItem[]>>;
     category: string;
     setCategory: import("react").Dispatch<import("react").SetStateAction<string>>;
     type: string;
@@ -379,73 +452,60 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     setPriority: import("react").Dispatch<import("react").SetStateAction<string | number>>;
     complexity: string | number;
     setComplexity: import("react").Dispatch<import("react").SetStateAction<string | number>>;
+    status: TaskStatus;
+    setStatus: import("react").Dispatch<import("react").SetStateAction<TaskStatus>>;
     approach: string;
     setApproach: import("react").Dispatch<import("react").SetStateAction<string>>;
-    assignee: TaskAssignee;
-    setAssignee: import("react").Dispatch<import("react").SetStateAction<TaskAssignee>>;
+    assignee: string;
+    setAssignee: import("react").Dispatch<import("react").SetStateAction<string>>;
     scheduledDate: string;
     setScheduledDate: import("react").Dispatch<import("react").SetStateAction<string>>;
     dueDate: string;
     setDueDate: import("react").Dispatch<import("react").SetStateAction<string>>;
-    parentTaskIdInput: string;
-    setParentTaskIdInput: import("react").Dispatch<import("react").SetStateAction<string>>;
-    addChildTaskIdInput: string;
-    setAddChildTaskIdInput: import("react").Dispatch<import("react").SetStateAction<string>>;
+    workstreamInput: string;
+    setWorkstreamInput: import("react").Dispatch<import("react").SetStateAction<string>>;
     formTaxonomies: Record<string, string | number | string[] | number[]>;
     setFormTaxonomies: import("react").Dispatch<import("react").SetStateAction<Record<string, string | number | string[] | number[]>>>;
-    selectedSpecialists: string[];
-    setSelectedSpecialists: import("react").Dispatch<import("react").SetStateAction<string[]>>;
     comments: Comment[];
     newCommentText: string;
     setNewCommentText: import("react").Dispatch<import("react").SetStateAction<string>>;
-    screenshots: (string | AttachmentItem)[];
-    setScreenshots: import("react").Dispatch<import("react").SetStateAction<(string | AttachmentItem)[]>>;
+    attachments: (string | AttachmentItem)[];
+    setAttachments: import("react").Dispatch<import("react").SetStateAction<(string | AttachmentItem)[]>>;
+    attachmentsDirty: boolean;
+    setAttachmentsDirty: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     descriptionFocused: boolean;
     setDescriptionFocused: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     showMarkdownHelp: boolean;
     setShowMarkdownHelp: import("react").Dispatch<import("react").SetStateAction<boolean>>;
-    showSpecialists: boolean;
-    setShowSpecialists: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     showChecklist: boolean;
     setShowChecklist: import("react").Dispatch<import("react").SetStateAction<boolean>>;
-    showTaskRelationships: boolean;
-    setShowTaskRelationships: import("react").Dispatch<import("react").SetStateAction<boolean>>;
-    showChildTasks: boolean;
-    setShowChildTasks: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     showComments: boolean;
     setShowComments: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     isCapturingScreenshot: boolean;
     setIsCapturingScreenshot: import("react").Dispatch<import("react").SetStateAction<boolean>>;
-    handleSubmit: (e: React.FormEvent) => Promise<void>;
+    handleSubmit: (event: React.FormEvent) => Promise<void>;
     resetForm: () => void;
     handleAddComment: (text: string) => Promise<void>;
-    handleSetParentForCurrentTask: (parentTaskIdOverride?: string | null) => Promise<void>;
-    handleAddChildToCurrentTask: () => Promise<void>;
-    handleCreateChildForCurrentTask: () => Promise<void>;
-    handleUnlinkChildTask: (childId: string) => Promise<void>;
-    handleReorderChildTasks: (parentTaskId: string, orderedChildIds: string[]) => Promise<void>;
-    handleClearParentTask: (taskId: string) => Promise<void>;
+    handleSetWorkstreamForCurrentTask: (workstreamIdOverride?: string | null) => Promise<void>;
     handleOpenTaskById: (taskId: string) => void;
+    returnToPreviousTask: () => boolean;
+    autoSaveState: import("./tasks/useTaskFormActions").TaskAutoSaveState;
     unsavedModalOpen: boolean;
     setUnsavedModalOpen: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     pendingNavigation: (() => void) | null;
     handleNavigation: (action: () => void) => void;
     handleClose: () => void;
+    uiNotice: UiNotice | null;
+    pushNotice: (message: string, tone?: UiNotice["tone"], ttlMs?: number) => void;
+    clearNotice: () => void;
     successBanner: {
         message: string;
-        type: "added" | "updated" | "info";
+        type: "info";
     } | null;
-    returnToParentTaskId: string | null;
-    returnFromChildTaskId: string | null;
+    taskReturnTrail: string[];
     clearReturnToParentTask: () => void;
     copiedId: string | null;
     recentlyChangedTaskIds: string[];
-    cancellationPromptTask: TaskItem | null;
-    cancellationOpenDescendantIds: string[];
-    cancellationMode: "cascade" | "unlink" | null;
-    setCancellationMode: import("react").Dispatch<import("react").SetStateAction<"cascade" | "unlink" | null>>;
-    confirmCancellation: (reason: string, mode?: "cascade" | "unlink" | null) => Promise<boolean>;
-    cancelCancellationPrompt: () => void;
     scheduleWarningPrompt: {
         dueDate: string;
         scheduledDate: string;
@@ -458,14 +518,11 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     setExportEnvironment: import("react").Dispatch<import("react").SetStateAction<string>>;
     exportWorkflowsPath: string;
     setExportWorkflowsPath: import("react").Dispatch<import("react").SetStateAction<string>>;
-    exportSpecialistsPath: string;
-    setExportSpecialistsPath: import("react").Dispatch<import("react").SetStateAction<string>>;
     exportResult: {
         type: "success" | "error";
         message: string;
     } | null;
-    handleExportResources: (type: "workflows" | "specialists", path: string) => Promise<void>;
-    exportingResource: "workflows" | "specialists" | null;
+    exportingResource: "workflows" | null;
     handleUpdateCategory: (updatedCat: CategoryConfig, oldLabel?: string) => Promise<void>;
     handleRemoveCategory: (catValue: string) => Promise<void>;
     handleSaveCategory: (newCategoryName: string) => Promise<void>;
@@ -473,19 +530,20 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     handleUpdateCategoryColor: (catValue: string, color: string) => void;
     handleSaveType: (labelInput: string) => Promise<void>;
     handleRemoveType: (typeToRemove: string) => Promise<void>;
-    handleUpdateTaxonomies: (updated: TaxonomyDefinition[]) => Promise<void>;
-    handleUpdatePriorities: (updated: Array<{
-        value: number;
+    handleUpdateType: (typeValue: string, updates: Partial<{
         label: string;
         color?: string;
         icon?: string;
+        status?: "active" | "retired";
     }>) => Promise<void>;
-    handleUpdateApproaches: (updated: Array<{
-        value: string;
+    handleUpdateTaxonomies: (updated: TaxonomyDefinition[]) => Promise<void>;
+    handleUpdatePriorities: (updated: Array<{
+        value: number;
         label: string;
         color?: string;
         icon?: string;
     }>) => Promise<void>;
+    handleUpdateTaxonomyDisplayLabels: (updates: FirstClassTaxonomyDisplayLabels) => Promise<void>;
     pathValidation: Record<string, {
         exists: boolean;
         isDirectory: boolean;
@@ -501,29 +559,26 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     serverHostRoot: string;
     commentsEndRef: import("react").RefObject<HTMLDivElement | null>;
     currentTask: TaskItem | undefined;
-    currentTaskParent: TaskItem | undefined;
-    currentTaskChildren: TaskItem[];
+    currentTaskWorkstream: WorkstreamItem | undefined;
+    currentTaskInitiative: InitiativeItem | undefined;
     availableWorkflows: string[];
-    initiativeTemplates: {
-        id: string;
-        name: string;
-        description: string;
-        checklistBlocks: {
-            definitionOfDone: string[];
-            rollbackPlan: string[];
-        };
-        milestones: Array<{
-            title: string;
-            description: string;
-            priority?: number;
-            approach?: string;
-            category?: string;
-        }>;
-        defaultSpecialists?: string[];
-    }[];
+    initiativeTemplates: import("./ui/useWorkflowTemplates").InitiativeTemplate[];
     availableEnvironments: Environment[];
     fetchWorkflows: () => Promise<void>;
     fetchInitiativeTemplates: () => Promise<any>;
+    createInitiativeFromTemplate: (payload: {
+        templateId: string;
+        title: string;
+        description?: string;
+        category?: string;
+        type?: string;
+        priority?: number;
+        approach?: string;
+    }) => Promise<{
+        success: boolean;
+        error?: string;
+        result?: any;
+    }>;
     fetchWorkflowTemplate: (name: string) => Promise<any>;
     fetchWorkflowOverrideNames: () => Promise<string[]>;
     saveWorkflowTemplateDraft: (name: string, draft: any) => Promise<{
@@ -536,171 +591,85 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     }>;
     onExportWorkflows: (environment: string, selected: string[]) => Promise<void>;
     settingsModel: {
-        currentTheme: TaskforceTheme;
+        fetchCloudAuthApi: (path: string, init?: RequestInit) => Promise<Response>;
+        currentTheme: any;
         configLoaded: boolean;
-        globalTheme: TaskforceTheme;
+        globalTheme: any;
         themeUseGlobalDefault: boolean;
         keyShortcut: string;
         jsonBackupEnabled: boolean;
         globalJsonBackupEnabled: boolean;
-        globalWeekStartsOn: WeekStartsOn;
-        locale: "en-US" | "es-419" | "pt-BR";
-        supportedLocales: ("en-US" | "es-419" | "pt-BR")[];
+        globalWeekStartsOn: "sunday" | "monday";
+        locale: string;
+        supportedLocales: any[];
         jsonBackupUseGlobalDefault: boolean;
         manualComplexityEnabled: boolean;
         checklistDropdownEnabled: boolean;
-        assigneeFilterEnabled: boolean;
+        showTaskCardStatusLabel: boolean;
         exportWorkflowsPath: string;
-        exportSpecialistsPath: string;
-        exportingResource: "workflows" | "specialists" | null;
-        exportResult: {
-            type: "success" | "error";
-            message: string;
-        } | null;
+        exportingResource: any;
+        exportResult: any;
         pathSaved: boolean;
-        initialSection: "categories" | "types" | "general" | "documents" | "commands" | "workflow-editor" | "agents" | "taxonomy" | "mcp" | "resources" | null;
+        initialSection: "mcp" | "categories" | "types" | "priorities" | "general" | "agents" | "taxonomy" | "initiatives" | "documents" | "appearance-application" | "appearance-task-cards" | "appearance-task-forms" | "commands" | "workflow-editor" | "integrations" | "resources" | null;
         exportEnvironment: string;
-        setupState: SetupStateSnapshot | null;
-        buildInfo: BuildMetadata | null;
-        onSaveSetupMode: (mode: WorkspaceMode) => Promise<boolean>;
-        onSaveWorkspaceProfile: (input: {
-            name: string;
-            description?: string;
-            workspaceId?: string;
-        }) => Promise<{
-            success: boolean;
-            error?: string;
-            code?: string;
-            workspaceId?: string;
-        }>;
-        onThemeChange: import("react").Dispatch<import("react").SetStateAction<TaskforceTheme>>;
-        onSaveTheme: (theme: TaskforceTheme) => Promise<boolean>;
-        onSaveGlobalTheme: (theme: TaskforceTheme) => Promise<boolean>;
-        onKeyShortcutChange: import("react").Dispatch<import("react").SetStateAction<string>>;
-        onJsonBackupEnabledChange: (enabled: boolean) => Promise<boolean>;
-        onSaveGlobalJsonBackupEnabled: (enabled: boolean) => Promise<boolean>;
-        onSaveGlobalWeekStartsOn: (weekStartsOn: WeekStartsOn) => Promise<boolean>;
-        onSaveLocale: (nextLocale: string) => Promise<boolean>;
-        onManualComplexityEnabledChange: (enabled: boolean) => Promise<boolean>;
-        onChecklistDropdownEnabledChange: (enabled: boolean) => Promise<boolean>;
-        onAssigneeFilterEnabledChange: (enabled: boolean) => Promise<boolean>;
-        onResetProjectToGlobal: () => Promise<boolean>;
-        onSaveSettings: () => Promise<boolean>;
-        onExportWorkflowsPathChange: import("react").Dispatch<import("react").SetStateAction<string>>;
-        onExportSpecialistsPathChange: import("react").Dispatch<import("react").SetStateAction<string>>;
-        onExportEnvironmentChange: import("react").Dispatch<import("react").SetStateAction<string>>;
-        onExportResources: (type: "workflows" | "specialists", path: string) => Promise<void>;
-        availableWorkflows: string[];
-        initiativeTemplates: {
-            id: string;
-            name: string;
-            description: string;
-            checklistBlocks: {
-                definitionOfDone: string[];
-                rollbackPlan: string[];
-            };
-            milestones: Array<{
-                title: string;
-                description: string;
-                priority?: number;
-                approach?: string;
-                category?: string;
-            }>;
-            defaultSpecialists?: string[];
-        }[];
-        availableEnvironments: Environment[];
-        onRefreshWorkflows: () => Promise<void>;
-        onRefreshInitiativeTemplates: () => Promise<any>;
-        onCreateInitiativeFromTemplate: (payload: {
-            templateId: string;
-            title: string;
-            description?: 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?: number;
-            approach?: string;
-            parentTaskId?: string | null;
-            specialists?: string[];
-        }) => Promise<{
-            success: boolean;
-            error?: string;
-            result?: any;
-        }>;
-        onCloneChecklistBlocksToChildren: (payload: {
-            parentTaskId: string;
-            checklistBlocks: {
-                definitionOfDone: string[];
-                rollbackPlan: string[];
-            };
-        }) => Promise<{
-            success: boolean;
-            error?: string;
-            updated?: number;
-        }>;
-        onFetchWorkflowTemplate: (name: string) => Promise<any>;
-        onFetchWorkflowOverrideNames: () => Promise<string[]>;
-        onSaveWorkflowTemplateDraft: (name: string, draft: any) => Promise<{
-            success: boolean;
-            error?: string;
-        }>;
-        onResetWorkflowTemplateDraft: (name: string) => Promise<{
-            success: boolean;
-            error?: string;
-        }>;
-        onExportWorkflows: (environment: string, selected: string[]) => Promise<void>;
-        onShowFolderBrowserChange: import("react").Dispatch<import("react").SetStateAction<boolean>>;
-        onBrowserTargetChange: import("react").Dispatch<import("react").SetStateAction<{
-            type: "category";
-            value: string;
-        } | {
-            type: "context-link";
-        } | "storage" | null>>;
-        onFetchFolders: (path?: string) => Promise<void>;
-        categories: CategoryConfig[];
-        pathValidation: Record<string, {
-            exists: boolean;
-            isDirectory: boolean;
-            isFile: boolean;
-        }>;
-        onUpdateCategory: (updatedCat: CategoryConfig, oldLabel?: string) => Promise<void>;
-        onRemoveCategory: (catValue: string) => Promise<void>;
-        onSaveCategory: (newCategoryName: string) => Promise<void>;
-        onAddPath: (catValue: string, pathInput: string) => void;
-        onRemovePath: (catValue: string, pathToRemove: string) => void;
-        onUpdateCategoryIcon: (catValue: string, iconName: string) => void;
-        onUpdateCategoryColor: (catValue: string, color: string) => void;
-        types: {
-            value: string;
-            label: string;
-        }[];
-        onSaveType: (labelInput: string) => Promise<void>;
-        onRemoveType: (typeToRemove: string) => Promise<void>;
-        taxonomies: TaxonomyDefinition[];
-        onUpdateTaxonomies: (updated: TaxonomyDefinition[]) => Promise<void>;
-        priorities: {
-            value: number;
-            label: string;
-            color?: string;
-            icon?: string;
-        }[];
-        onUpdatePriorities: (updated: Array<{
-            value: number;
-            label: string;
-            color?: string;
-            icon?: string;
-        }>) => Promise<void>;
-        approaches: {
-            value: string;
-            label: string;
-            color?: string;
-            icon?: string;
-        }[];
-        onUpdateApproaches: (updated: Array<{
-            value: string;
-            label: string;
-            color?: string;
-            icon?: string;
-        }>) => Promise<void>;
+            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;
@@ -709,19 +678,15 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
         tenantId: string;
         workspaceId: string;
         runtimeMode: "local" | "cloud";
+        cloudAuthBaseUrl: string | undefined;
+        cloudMcpBaseUrl: string | undefined;
         workspaceSwitchingEnabled: boolean;
-        currentWorkspaceRole: "owner" | "admin" | "member" | "read-only";
+        currentWorkspaceRole: "member" | "owner" | "admin" | "read-only";
         currentWorkspaceName: string;
-        onDeleteWorkspace: (workspaceId: string) => Promise<{
-            success: boolean;
-            error?: string;
-            code?: string;
-            nextWorkspaceId?: string;
-            workspaceSetupRequired?: boolean;
-            cleanupWarnings?: string[];
-        }>;
-        onMcpHostRootChange: import("react").Dispatch<import("react").SetStateAction<string>>;
+        onDeleteWorkspace: (...args: any[]) => any;
+        onMcpHostRootChange: (value: string) => void;
         isAuthenticated: boolean;
     };
 };
+export type UseTaskforceResult = ReturnType<typeof useTaskforce>;
 export {};