@taskforcehq/taskforce 0.3.327 → 0.3.329

package/dist/hooks/useTaskforce.d.ts

@@ -31,12 +31,14 @@
  *   === SECTION: Settings Model ===         Line ~4625 — settingsModel object
  *   === SECTION: Return Value ===           Line ~4817 — final return object (public API shape)
  */
-import { type SetStateAction } from 'react';
+import { type Dispatch, type SetStateAction } from 'react';
 import type { TaskforceConfig, TaskforceTheme, Comment, AttachmentItem, CategoryConfig, TaskItem, TaxonomyDefinition, TaskAssignee, TaskStatus, DeletedTaskRecord, InitiativeItem, WorkstreamItem, ChecklistItem, PlanningBootstrapPayload, PlanningBootstrapWorkstreamTaskSummary, PlanningLoadState } from '../types';
 import { type FirstClassTaxonomyDisplayLabels } from '../shared/taxonomyState.js';
+import type { PlanningIdentityColor, PlanningIdentityIcon } from '../shared/planningIdentity.js';
 import type { UiNotice } from '../utils/uiNotice';
 import type { TaskAssigneeOption } from '../utils/assignees';
 import { type WorkspaceModuleId } from './workspace/workspaceLocalState';
+export declare function buildRelationshipTasks(tasks: TaskItem[], archivedTasks: TaskItem[], taskDetails: TaskItem[], editingTaskId: string | null): TaskItem[];
 export interface UseTaskforceProps {
     config?: Partial<TaskforceConfig>;
     initialTaskId?: string;
@@ -107,6 +109,7 @@ export declare function sanitizePlanningBootstrapPayload(input: unknown): Planni
 export declare function useTaskforce({ config, initialTaskId, initialActivityEntryId, requestedWorkspaceId, onTaskCountChange, onClose }: UseTaskforceProps): {
     config: {
         cloudEnvironment: any;
+        appGates: any;
         apiBaseUrl: string | undefined;
         cloudAuthBaseUrl: string | undefined;
         wsBaseUrl: string | undefined;
@@ -135,33 +138,43 @@ export declare function useTaskforce({ config, initialTaskId, initialActivityEnt
         manualComplexityEnabled: boolean;
         checklistDropdownEnabled: boolean;
         showTaskCardStatusLabel: boolean;
+        showTaskCardDescription: boolean;
+        showTaskCardAttachments: boolean;
+        showTaskCardChecklistProgress: boolean;
+        showTaskCardLatestActivity: boolean;
+        tintTaskCardActivityBackground: boolean;
     };
     isOpen: boolean;
-    setIsOpen: import("react").Dispatch<SetStateAction<boolean>>;
+    setIsOpen: Dispatch<SetStateAction<boolean>>;
     activeTab: "tasks" | "settings" | "add";
     setActiveTab: (tab: "add" | "tasks" | "settings") => void;
     currentTheme: "light" | "dawn" | "dark" | "midnight";
-    setCurrentTheme: import("react").Dispatch<SetStateAction<"light" | "dawn" | "dark" | "midnight">>;
+    setCurrentTheme: Dispatch<SetStateAction<"light" | "dawn" | "dark" | "midnight">>;
     configLoaded: boolean;
     storagePath: string;
     saveSettings: () => Promise<boolean>;
     pathSaved: boolean;
     keyShortcut: string;
-    setKeyShortcut: import("react").Dispatch<SetStateAction<string>>;
+    setKeyShortcut: Dispatch<SetStateAction<string>>;
     globalWeekStartsOn: WeekStartsOn;
     locale: "en-US" | "es-419" | "pt-BR";
     supportedLocales: ("en-US" | "es-419" | "pt-BR")[];
     saveLocale: (nextLocale: string) => Promise<boolean>;
     jsonBackupEnabled: boolean;
-    setJsonBackupEnabled: import("react").Dispatch<SetStateAction<boolean>>;
+    setJsonBackupEnabled: Dispatch<SetStateAction<boolean>>;
     manualComplexityEnabled: boolean;
     checklistDropdownEnabled: boolean;
     showTaskCardStatusLabel: boolean;
-    setManualComplexityEnabled: import("react").Dispatch<SetStateAction<boolean>>;
+    showTaskCardDescription: boolean;
+    showTaskCardAttachments: boolean;
+    showTaskCardChecklistProgress: boolean;
+    showTaskCardLatestActivity: boolean;
+    tintTaskCardActivityBackground: boolean;
+    setManualComplexityEnabled: Dispatch<SetStateAction<boolean>>;
     mcpHostRoot: string;
-    setMcpHostRoot: import("react").Dispatch<SetStateAction<string>>;
-    settingsSection: "mcp" | "categories" | "types" | "general" | "agents" | "taxonomy" | "documents" | "appearance-application" | "appearance-task-cards" | "appearance-task-forms" | "integrations" | null;
-    setSettingsSection: import("react").Dispatch<SetStateAction<"mcp" | "categories" | "types" | "general" | "agents" | "taxonomy" | "documents" | "appearance-application" | "appearance-task-cards" | "appearance-task-forms" | "integrations" | null>>;
+    setMcpHostRoot: Dispatch<SetStateAction<string>>;
+    settingsSection: "mcp" | "categories" | "types" | "general" | "documents" | "taxonomy" | "agents" | "appearance-application" | "appearance-task-cards" | "appearance-task-forms" | "integrations" | null;
+    setSettingsSection: Dispatch<SetStateAction<"mcp" | "categories" | "types" | "general" | "documents" | "taxonomy" | "agents" | "appearance-application" | "appearance-task-cards" | "appearance-task-forms" | "integrations" | null>>;
     runtimeMode: "local" | "cloud";
     workspaceMode: "single-local" | "multi-cloud";
     workspaceSwitchingEnabled: boolean;
@@ -243,7 +256,7 @@ export declare function useTaskforce({ config, initialTaskId, initialActivityEnt
     realtimeSyncEnabled: boolean;
     realtimeSyncFlagSource: "default" | "unknown" | "settings" | "env";
     currentWorkspaceId: string;
-    currentWorkspaceRole: "member" | "owner" | "admin" | "read-only" | null;
+    currentWorkspaceRole: "owner" | "member" | "admin" | "read-only" | null;
     availableWorkspaces: WorkspaceSummary[];
     assigneeOptions: TaskAssigneeOption[];
     workspaceCloudSyncEnabled: boolean;
@@ -432,7 +445,7 @@ export declare function useTaskforce({ config, initialTaskId, initialActivityEnt
     }>;
     logout: () => Promise<void>;
     showFolderBrowser: boolean;
-    setShowFolderBrowser: import("react").Dispatch<SetStateAction<boolean>>;
+    setShowFolderBrowser: Dispatch<SetStateAction<boolean>>;
     folders: string[];
     files: string[];
     currentBrowsePath: string;
@@ -441,16 +454,16 @@ export declare function useTaskforce({ config, initialTaskId, initialActivityEnt
         type: "category";
         value: string;
     } | null;
-    setBrowserTarget: import("react").Dispatch<SetStateAction<"storage" | {
+    setBrowserTarget: Dispatch<SetStateAction<"storage" | {
         type: "category";
         value: string;
     } | null>>;
-    groupBy: "category" | "type" | "priority" | "status" | "complexity" | "assignee" | "schedule";
-    setGroupBy: import("react").Dispatch<SetStateAction<"category" | "type" | "priority" | "status" | "complexity" | "assignee" | "schedule">>;
+    groupBy: "category" | "type" | "priority" | "complexity" | "status" | "assignee" | "schedule";
+    setGroupBy: Dispatch<SetStateAction<"category" | "type" | "priority" | "complexity" | "status" | "assignee" | "schedule">>;
     activeWorkspaceModule: WorkspaceModuleId;
-    setActiveWorkspaceModule: import("react").Dispatch<SetStateAction<WorkspaceModuleId>>;
+    setActiveWorkspaceModule: Dispatch<SetStateAction<WorkspaceModuleId>>;
     emptyColumnMode: "show" | "collapse" | "hide";
-    setEmptyColumnMode: import("react").Dispatch<SetStateAction<"show" | "collapse" | "hide">>;
+    setEmptyColumnMode: Dispatch<SetStateAction<"show" | "collapse" | "hide">>;
     zenMode: boolean;
     setZenMode: () => Promise<void>;
     handleSelectPath: (path: string) => void;
@@ -484,38 +497,38 @@ export declare function useTaskforce({ config, initialTaskId, initialActivityEnt
     taxonomyDisplayLabels: FirstClassTaxonomyDisplayLabels;
     taxonomies: TaxonomyDefinition[];
     searchQuery: string;
-    setSearchQuery: import("react").Dispatch<SetStateAction<string>>;
+    setSearchQuery: Dispatch<SetStateAction<string>>;
     filterCategories: string[];
-    setFilterCategories: import("react").Dispatch<SetStateAction<string[]>>;
+    setFilterCategories: Dispatch<SetStateAction<string[]>>;
     filterTypes: string[];
-    setFilterTypes: import("react").Dispatch<SetStateAction<string[]>>;
+    setFilterTypes: Dispatch<SetStateAction<string[]>>;
     filterPriorities: (string | number)[];
-    setFilterPriorities: import("react").Dispatch<SetStateAction<(string | number)[]>>;
+    setFilterPriorities: Dispatch<SetStateAction<(string | number)[]>>;
     filterStatus: (string | number)[];
-    setFilterStatus: import("react").Dispatch<SetStateAction<(string | number)[]>>;
+    setFilterStatus: Dispatch<SetStateAction<(string | number)[]>>;
     filterAssignees: string[];
     setFilterAssignees: (nextValues: TaskAssignee[] | ((prev: TaskAssignee[]) => TaskAssignee[])) => void;
     filterTaxonomies: Record<string, (string | number)[]>;
-    setFilterTaxonomies: import("react").Dispatch<SetStateAction<Record<string, (string | number)[]>>>;
+    setFilterTaxonomies: Dispatch<SetStateAction<Record<string, (string | number)[]>>>;
     hasInitedFilters: boolean;
     sortBy: import("../utils/taxonomySorting").TaskSortKey;
-    setSortBy: import("react").Dispatch<SetStateAction<import("../utils/taxonomySorting").TaskSortKey>>;
+    setSortBy: Dispatch<SetStateAction<import("../utils/taxonomySorting").TaskSortKey>>;
     sortOrder: "asc" | "desc";
-    setSortOrder: import("react").Dispatch<SetStateAction<"asc" | "desc">>;
+    setSortOrder: Dispatch<SetStateAction<"asc" | "desc">>;
     toggleSortOrder: () => void;
     showArchive: boolean;
-    setShowArchive: import("react").Dispatch<SetStateAction<boolean>>;
+    setShowArchive: Dispatch<SetStateAction<boolean>>;
     taskScope: TaskScope;
-    setTaskScope: import("react").Dispatch<SetStateAction<TaskScope>>;
+    setTaskScope: Dispatch<SetStateAction<TaskScope>>;
     compressedCards: boolean;
-    setCompressedCards: import("react").Dispatch<SetStateAction<boolean>>;
+    setCompressedCards: Dispatch<SetStateAction<boolean>>;
     clearFilters: () => void;
     filteredTasks: TaskItem[];
     searchAgnosticTasks: TaskItem[];
     filteredArchive: TaskItem[];
     groupedTasks: Record<string, TaskItem[]>;
     collapsedCategories: Record<string, boolean>;
-    setCollapsedCategories: import("react").Dispatch<SetStateAction<Record<string, boolean>>>;
+    setCollapsedCategories: Dispatch<SetStateAction<Record<string, boolean>>>;
     fetchTasks: (isSilent?: boolean, options?: {
         ignoreAuthGuard?: boolean;
         highlightChangedTaskIds?: readonly string[];
@@ -539,6 +552,10 @@ export declare function useTaskforce({ config, initialTaskId, initialActivityEnt
     }>;
     createInitiative: (payload: Partial<InitiativeItem>) => Promise<InitiativeItem>;
     updateInitiative: (id: string, payload: Partial<InitiativeItem>) => Promise<InitiativeItem>;
+    updatePlanningIdentity: (entityType: "initiative" | "workstream", id: string, patch: {
+        icon?: PlanningIdentityIcon | null;
+        color?: PlanningIdentityColor | null;
+    }) => Promise<InitiativeItem | WorkstreamItem>;
     archiveInitiative: (id: string) => Promise<InitiativeItem>;
     unarchiveInitiative: (id: string) => Promise<InitiativeItem>;
     createWorkstream: (payload: Partial<WorkstreamItem>) => Promise<WorkstreamItem>;
@@ -548,6 +565,7 @@ export declare function useTaskforce({ config, initialTaskId, initialActivityEnt
     reorderWorkstreamTasks: (workstreamId: string, taskIds: string[]) => Promise<void>;
     handleEdit: (task: TaskItem, options?: {
         preserveReturnTrail?: boolean;
+        adoptAsBaseline?: boolean;
     }) => void;
     handleDelete: (id: string, archive?: boolean, options?: {
         skipConfirm?: boolean;
@@ -568,61 +586,65 @@ export declare function useTaskforce({ config, initialTaskId, initialActivityEnt
     handlePermanentlyDeleteDeletedTask: (id: string) => Promise<boolean>;
     handleEmptyDeletedTasks: () => Promise<number | null>;
     handleUpdateTask: (id: string, updates: Partial<TaskItem>) => Promise<boolean | undefined>;
-    handleSetStatus: (task: TaskItem, status: import("../core/TaskDurableStatusMutationService").DurableTaskTargetStatus, updates?: Partial<TaskItem>) => Promise<void>;
+    handleSetStatus: (task: TaskItem, status: import("../core/TaskDurableStatusMutationService").DurableTaskTargetStatus, updates?: Partial<TaskItem>, expectedDetailRevisionOverride?: string | null) => Promise<void>;
     editingTaskId: string | null;
     loading: boolean;
     error: string;
     clearTaskError: () => void;
     title: string;
-    setTitle: import("react").Dispatch<SetStateAction<string>>;
+    setTitle: Dispatch<SetStateAction<string>>;
     setTitleDraft: (value: string) => void;
     description: string;
-    setDescription: import("react").Dispatch<SetStateAction<string>>;
+    setDescription: Dispatch<SetStateAction<string>>;
     setDescriptionDraft: (value: string) => void;
     checklistItems: ChecklistItem[];
-    setChecklistItems: import("react").Dispatch<SetStateAction<ChecklistItem[]>>;
+    setChecklistItems: Dispatch<SetStateAction<ChecklistItem[]>>;
     category: string;
-    setCategory: import("react").Dispatch<SetStateAction<string>>;
+    setCategory: Dispatch<SetStateAction<string>>;
     type: string;
-    setType: import("react").Dispatch<SetStateAction<string>>;
+    setType: Dispatch<SetStateAction<string>>;
     priority: string | number;
-    setPriority: import("react").Dispatch<SetStateAction<string | number>>;
+    setPriority: Dispatch<SetStateAction<string | number>>;
     complexity: string | number;
-    setComplexity: import("react").Dispatch<SetStateAction<string | number>>;
+    setComplexity: Dispatch<SetStateAction<string | number>>;
     status: TaskStatus;
-    setStatus: import("react").Dispatch<SetStateAction<TaskStatus>>;
+    setStatus: Dispatch<SetStateAction<TaskStatus>>;
     assignee: string;
-    setAssignee: import("react").Dispatch<SetStateAction<string>>;
+    setAssignee: Dispatch<SetStateAction<string>>;
     scheduledDate: string;
-    setScheduledDate: import("react").Dispatch<SetStateAction<string>>;
+    setScheduledDate: Dispatch<SetStateAction<string>>;
     dueDate: string;
-    setDueDate: import("react").Dispatch<SetStateAction<string>>;
+    setDueDate: Dispatch<SetStateAction<string>>;
     workstreamInput: string;
-    setWorkstreamInput: import("react").Dispatch<SetStateAction<string>>;
+    setWorkstreamInput: Dispatch<SetStateAction<string>>;
     formTaxonomies: Record<string, string | number | string[] | number[]>;
-    setFormTaxonomies: import("react").Dispatch<SetStateAction<Record<string, string | number | string[] | number[]>>>;
+    setFormTaxonomies: Dispatch<SetStateAction<Record<string, string | number | string[] | number[]>>>;
     comments: Comment[];
     newCommentText: string;
-    setNewCommentText: import("react").Dispatch<SetStateAction<string>>;
+    setNewCommentText: Dispatch<SetStateAction<string>>;
     attachments: (string | AttachmentItem)[];
-    setAttachments: import("react").Dispatch<SetStateAction<(string | AttachmentItem)[]>>;
+    setAttachments: Dispatch<SetStateAction<(string | AttachmentItem)[]>>;
     attachmentsDirty: boolean;
-    setAttachmentsDirty: import("react").Dispatch<SetStateAction<boolean>>;
+    setAttachmentsDirty: Dispatch<SetStateAction<boolean>>;
+    descriptionImageUploadPending: boolean;
+    descriptionImageDraftId: string;
+    registerDescriptionImageUpload: (upload: Promise<void>) => void;
     descriptionFocused: boolean;
-    setDescriptionFocused: import("react").Dispatch<SetStateAction<boolean>>;
+    setDescriptionFocused: Dispatch<SetStateAction<boolean>>;
     showMarkdownHelp: boolean;
-    setShowMarkdownHelp: import("react").Dispatch<SetStateAction<boolean>>;
+    setShowMarkdownHelp: Dispatch<SetStateAction<boolean>>;
     isCapturingScreenshot: boolean;
-    setIsCapturingScreenshot: import("react").Dispatch<SetStateAction<boolean>>;
+    setIsCapturingScreenshot: Dispatch<SetStateAction<boolean>>;
     handleSubmit: (event: React.FormEvent) => Promise<void>;
     resetForm: () => void;
+    discardDescriptionImageDraft: () => Promise<void>;
     handleAddComment: (text: 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<SetStateAction<boolean>>;
+    setUnsavedModalOpen: Dispatch<SetStateAction<boolean>>;
     pendingNavigation: (() => void) | null;
     handleNavigation: (action: () => void) => Promise<void>;
     handleClose: () => void;
@@ -630,6 +652,10 @@ export declare function useTaskforce({ config, initialTaskId, initialActivityEnt
     pushNotice: (message: string, tone?: UiNotice["tone"], ttlMs?: number, action?: {
         label: string;
         onAction: () => void;
+        primary?: boolean;
+        secondaryLabel?: string;
+        onSecondaryAction?: () => void;
+        dismissible?: boolean;
         ownerKey?: string;
     }) => void;
     clearNotice: () => void;
@@ -648,13 +674,13 @@ export declare function useTaskforce({ config, initialTaskId, initialActivityEnt
     confirmScheduleWarning: () => Promise<void>;
     cancelScheduleWarning: () => void;
     tasksScrollRef: import("react").RefObject<HTMLDivElement | null>;
-    setTasksScrollPos: import("react").Dispatch<SetStateAction<number>>;
+    setTasksScrollPos: Dispatch<SetStateAction<number>>;
     taskforceAgentId: string;
-    setTaskforceAgentId: import("react").Dispatch<SetStateAction<string>>;
+    setTaskforceAgentId: Dispatch<SetStateAction<string>>;
     taskforceAgentConversationId: string;
-    setTaskforceAgentConversationId: import("react").Dispatch<SetStateAction<string>>;
+    setTaskforceAgentConversationId: Dispatch<SetStateAction<string>>;
     taskforceAgentConversationByAgentId: Record<string, string>;
-    setTaskforceAgentConversationByAgentId: import("react").Dispatch<SetStateAction<Record<string, string>>>;
+    setTaskforceAgentConversationByAgentId: Dispatch<SetStateAction<Record<string, string>>>;
     uiStateReady: boolean;
     handleUpdateCategory: (updatedCat: CategoryConfig, oldLabel?: string) => Promise<void>;
     handleRemoveCategory: (catValue: string) => Promise<void>;
@@ -685,7 +711,7 @@ export declare function useTaskforce({ config, initialTaskId, initialActivityEnt
     validatePaths: (paths: string[]) => Promise<void>;
     getCategoryPaths: (cat: CategoryConfig) => string[];
     customCategories: CategoryConfig[];
-    setCustomCategories: import("react").Dispatch<SetStateAction<CategoryConfig[]>>;
+    setCustomCategories: Dispatch<SetStateAction<CategoryConfig[]>>;
     projectRoot: string;
     projectName: string;
     mcpScriptPath: string;
@@ -726,8 +752,13 @@ export declare function useTaskforce({ config, initialTaskId, initialActivityEnt
         manualComplexityEnabled: boolean;
         checklistDropdownEnabled: boolean;
         showTaskCardStatusLabel: boolean;
+        showTaskCardDescription: boolean;
+        showTaskCardAttachments: boolean;
+        showTaskCardChecklistProgress: boolean;
+        showTaskCardLatestActivity: boolean;
+        tintTaskCardActivityBackground: boolean;
         pathSaved: boolean;
-        initialSection: "mcp" | "categories" | "types" | "priorities" | "general" | "agents" | "taxonomy" | "initiatives" | "documents" | "appearance-application" | "appearance-task-cards" | "appearance-task-forms" | "integrations" | null;
+        initialSection: "mcp" | "categories" | "types" | "priorities" | "general" | "documents" | "taxonomy" | "agents" | "initiatives" | "appearance-application" | "appearance-task-cards" | "appearance-task-forms" | "integrations" | null;
         setupState: any;
         buildInfo: any;
         onSaveSetupMode: (...args: any[]) => any;
@@ -735,15 +766,21 @@ export declare function useTaskforce({ config, initialTaskId, initialActivityEnt
         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;
@@ -787,7 +824,7 @@ export declare function useTaskforce({ config, initialTaskId, initialActivityEnt
         cloudAuthBaseUrl: string | undefined;
         cloudMcpBaseUrl: string | undefined;
         workspaceSwitchingEnabled: boolean;
-        currentWorkspaceRole: "member" | "owner" | "admin" | "read-only";
+        currentWorkspaceRole: "owner" | "member" | "admin" | "read-only";
         currentWorkspaceName: string;
         onDeleteWorkspace: (...args: any[]) => any;
         onMcpHostRootChange: (value: string) => void;