@taskforcehq/taskforce 0.3.304 → 0.3.306

package/dist/hooks/useTaskMutations.js

@@ -1,6 +1,6 @@
 import { useState, useCallback, useEffect, useRef } from 'react';
 import { normalizeTaskFromApi } from '../utils/taskNormalization.js';
-export function useTaskMutations({ tasks, archivedTasks, editingTaskId, setTasks, setArchivedTasks, setDeletedTasks, setError, resetForm, setActiveTab, fetchTasks, fetchArchive, fetchDeletedTasks, mergeTaskFromServer, pushNotice, cloudAuthConfigured, runtimeMode, isAuthenticated, workspaceCloudSyncEnabled, buildWorkspaceSyncSignature, pushWorkspaceChangesToCloud, workspacePendingSignatureRef, workspaceDeletedTaskIdsRef, }) {
+export function useTaskMutations({ tasks, archivedTasks, editingTaskId, setTasks, setArchivedTasks, setDeletedTasks, setError, resetForm, setActiveTab, fetchTasks, fetchArchive, fetchDeletedTasks, mergeTaskFromServer, pushNotice, cloudAuthConfigured, runtimeMode, isAuthenticated, workspaceCloudSyncEnabled, buildWorkspaceSyncSignature, pushWorkspaceChangesToCloud, workspacePendingSignatureRef, workspaceDeletedTaskIdsRef, workspaceDeletedTaskWatermarksRef, }) {
     // Copy ID state + timer ref
     const [copiedId, setCopiedId] = useState(null);
     const copiedIdTimerRef = useRef(null);
@@ -90,9 +90,14 @@ export function useTaskMutations({ tasks, archivedTasks, editingTaskId, setTasks
             }
             if (deletedRecord) {
                 setDeletedTasks(prev => [deletedRecord, ...prev.filter((entry) => entry.taskId !== id)]);
+                const deletedAt = String(deletedRecord.deletedAt || '').trim();
+                if (Number.isFinite(Date.parse(deletedAt))) {
+                    workspaceDeletedTaskWatermarksRef.current.set(id, deletedAt);
+                }
             }
             else {
                 await fetchDeletedTasks(true);
+                workspaceDeletedTaskWatermarksRef.current.set(id, new Date().toISOString());
             }
             workspaceDeletedTaskIdsRef.current.add(id);
             if (cloudAuthConfigured && runtimeMode === 'local' && isAuthenticated && workspaceCloudSyncEnabled) {
@@ -133,7 +138,13 @@ export function useTaskMutations({ tasks, archivedTasks, editingTaskId, setTasks
                 await fetchTasks(true);
             }
             setDeletedTasks((prev) => prev.filter((entry) => entry.id !== id && entry.taskId !== id));
+            const restoredTaskId = String(restoredTask?.id || '').trim();
             workspaceDeletedTaskIdsRef.current.delete(id);
+            workspaceDeletedTaskWatermarksRef.current.delete(id);
+            if (restoredTaskId) {
+                workspaceDeletedTaskIdsRef.current.delete(restoredTaskId);
+                workspaceDeletedTaskWatermarksRef.current.delete(restoredTaskId);
+            }
             queueWorkspaceSyncFromAuthoritativeTaskState();
             setError('');
             pushNotice('Task restored from Trash.', 'info');

package/dist/hooks/useTaskMutations.test.js

@@ -38,6 +38,7 @@ describe('useTaskMutations', () => {
         const pushWorkspaceChangesToCloud = vi.fn();
         const workspacePendingSignatureRef = { current: null };
         const workspaceDeletedTaskIdsRef = { current: new Set() };
+        const workspaceDeletedTaskWatermarksRef = { current: new Map() };
         const hook = renderHook(() => useTaskMutations({
             tasks: [baseTask],
             archivedTasks: [],
@@ -61,6 +62,7 @@ describe('useTaskMutations', () => {
             pushWorkspaceChangesToCloud,
             workspacePendingSignatureRef,
             workspaceDeletedTaskIdsRef,
+            workspaceDeletedTaskWatermarksRef,
             ...overrides
         }));
         return {
@@ -80,7 +82,8 @@ describe('useTaskMutations', () => {
                 buildWorkspaceSyncSignature,
                 pushWorkspaceChangesToCloud,
                 workspacePendingSignatureRef,
-                workspaceDeletedTaskIdsRef
+                workspaceDeletedTaskIdsRef,
+                workspaceDeletedTaskWatermarksRef
             }
         };
     };
@@ -117,6 +120,7 @@ describe('useTaskMutations', () => {
         const pushWorkspaceChangesToCloud = vi.fn();
         const workspacePendingSignatureRef = { current: null };
         const workspaceDeletedTaskIdsRef = { current: new Set(['task-1']) };
+        const workspaceDeletedTaskWatermarksRef = { current: new Map([['task-1', '2026-04-03T10:10:00.000Z']]) };
         const { result } = renderHook(() => useTaskMutations({
             tasks: [],
             archivedTasks: [],
@@ -140,6 +144,7 @@ describe('useTaskMutations', () => {
             pushWorkspaceChangesToCloud,
             workspacePendingSignatureRef,
             workspaceDeletedTaskIdsRef,
+            workspaceDeletedTaskWatermarksRef,
         }));
         await act(async () => {
             await result.current.handleRestoreDeletedTask('task-1');
@@ -147,11 +152,35 @@ describe('useTaskMutations', () => {
         await waitFor(() => {
             expect(workspaceDeletedTaskIdsRef.current.has('task-1')).toBe(false);
         });
+        expect(workspaceDeletedTaskWatermarksRef.current.has('task-1')).toBe(false);
         expect(mergeTaskFromServer).toHaveBeenCalledWith(expect.objectContaining({ id: 'task-1' }));
         expect(buildWorkspaceSyncSignature).toHaveBeenCalled();
         expect(pushWorkspaceChangesToCloud).toHaveBeenCalledWith('sig-1');
         expect(setDeletedTasks).toHaveBeenCalled();
     });
+    it('records the delete watermark immediately when a task delete succeeds', async () => {
+        const fetchMock = vi.mocked(fetch);
+        fetchMock.mockResolvedValue({
+            ok: true,
+            status: 200,
+            json: async () => ({
+                deleted: {
+                    id: 'deleted-task-1',
+                    taskId: 'task-1',
+                    deletedAt: '2026-04-03T10:10:00.000Z',
+                    taskSnapshot: baseTask
+                }
+            })
+        });
+        const { result, deps } = buildHook();
+        await act(async () => {
+            await result.current.handleDelete('task-1', false, { skipConfirm: true });
+        });
+        expect(deps.workspaceDeletedTaskIdsRef.current.has('task-1')).toBe(true);
+        expect(deps.workspaceDeletedTaskWatermarksRef.current.get('task-1')).toBe('2026-04-03T10:10:00.000Z');
+        expect(deps.buildWorkspaceSyncSignature).toHaveBeenCalled();
+        expect(deps.pushWorkspaceChangesToCloud).toHaveBeenCalledWith('sig-1');
+    });
     it('optimistically marks a task done before the server responds', async () => {
         let resolveResponse;
         const fetchMock = vi.mocked(fetch);

package/dist/hooks/useTaskforce.d.ts

@@ -1,4 +1,4 @@
-import type { TaskforceConfig, TaskforceTheme, Comment, AttachmentItem, CategoryConfig, TaskItem, TaxonomyDefinition, Environment, TaskAssignee, TaskStatus, DeletedTaskRecord, InitiativeItem, WorkstreamItem, ChecklistItem } from '../types';
+import type { TaskforceConfig, TaskforceTheme, Comment, AttachmentItem, CategoryConfig, TaskItem, TaxonomyDefinition, Environment, TaskAssignee, TaskStatus, DeletedTaskRecord, InitiativeItem, WorkstreamItem, ChecklistItem, PlanningBootstrapWorkstreamTaskSummary } from '../types';
 import { type FirstClassTaxonomyDisplayLabels } from '../shared/taxonomyState.js';
 import type { UiNotice } from '../utils/uiNotice';
 import type { TaskAssigneeOption } from '../utils/assignees';
@@ -37,6 +37,27 @@ interface RuntimeCapabilities {
     supportsAdminManagedSetupOverrides: boolean;
     supportsPackageScriptSetupOverrides: boolean;
 }
+interface BootstrapStateSnapshot {
+    phase: BootstrapPhase;
+    auth: {
+        resolved: boolean;
+        pending: boolean;
+    };
+    config: {
+        loaded: boolean;
+    };
+    workspace: {
+        pending: boolean;
+    };
+    pending: boolean;
+    authPending: boolean;
+    appPending: boolean;
+    ready: boolean;
+    stalled: boolean;
+    subtitle: string;
+    error: string | null;
+    startedAt: number | null;
+}
 interface WorkspaceSummary {
     id: string;
     slug?: string | null;
@@ -122,7 +143,7 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     authUserDisplayName: string;
     authUserAvatarUrl: string;
     authWorkspaceId: string;
-    userGlobalSyncStatus: "error" | "idle" | "disconnected" | "syncing";
+    userGlobalSyncStatus: "error" | "idle" | "syncing" | "disconnected";
     workspaceLastPullAt: string | null;
     workspaceLastPushAt: string | null;
     workspaceLastErrorAt: string | null;
@@ -130,6 +151,7 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     workspaceLastErrorMessage: string | null;
     workspaceLastSuccessfulSyncAt: string | null;
     workspaceSyncPhase: import("../sync/workspaceSyncState").WorkspaceSyncPhase;
+    workspaceSyncSetupIntent: import("../sync/workspaceSyncState").WorkspaceSyncSetupIntent;
     workspaceSyncStatus: import("./useSyncOrchestrator").WorkspaceSyncStatus;
     workspaceSyncSummary: string;
     workspaceSyncRecommendedAction: string;
@@ -151,6 +173,13 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
         pendingChanges: number;
         lastErrorMessage: string | null;
         recommendedAction: string;
+        pushBlockedReason: import("./sync/controlPlane").WorkspaceSyncBlockedReason | null;
+        pullBlockedReason: import("./sync/controlPlane").WorkspaceSyncBlockedReason | null;
+        retryBlockedReason: import("./sync/controlPlane").WorkspaceSyncBlockedReason | null;
+        repairActive: boolean;
+        pushInFlight: boolean;
+        pullInFlight: boolean;
+        retryPending: boolean;
         documentSnapshotCount: number;
         aiProfileSnapshotCount: number;
         aiProfileSnapshotRawCount: number;
@@ -180,10 +209,11 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
         success: boolean;
         error?: string;
     }>;
-    applyWorkspaceSyncStateSnapshot: (nextState: Partial<import("../sync/workspaceSyncState").WorkspaceSyncStateV2> & {
+    applyWorkspaceSyncStateSnapshot: (nextState: Parameters<(nextState: Partial<import("../sync/workspaceSyncState").WorkspaceSyncStateV2> & {
         enabled: boolean;
         phase?: import("../sync/workspaceSyncState").WorkspaceSyncPhase | null;
-    }) => void;
+    }) => void>[0]) => void;
+    bootstrapState: BootstrapStateSnapshot;
     authSessionResolved: boolean;
     workspaceBootstrapPending: boolean;
     bootstrapPhase: BootstrapPhase;
@@ -241,6 +271,31 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
         code?: string;
         workspaceSetupRequired?: boolean;
     }>;
+    beginOAuthLogin: (provider: string, returnTo?: string, inviteToken?: string) => void;
+    availableAuthProviders: string[];
+    fetchLoginMethods: () => Promise<{
+        success: boolean;
+        error?: string;
+        methods?: Array<{
+            provider: string;
+            providerEmail: string | null;
+            displayNameSnapshot: string | null;
+            avatarUrlSnapshot: string | null;
+            linkedAt: string | null;
+            lastLoginAt: string | null;
+        }>;
+    }>;
+    unlinkLoginMethod: (provider: string) => Promise<{
+        success: boolean;
+        error?: string;
+        code?: string;
+    }>;
+    addPasswordToAccount: (password: string) => Promise<{
+        success: boolean;
+        error?: string;
+        code?: string;
+    }>;
+    beginOAuthLink: (provider: string, returnTo?: string) => void;
     registerWithCredentials: (email: string, password: string, options?: {
         displayName?: string | null;
         planId?: string | null;
@@ -280,6 +335,7 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
         code?: string;
         verificationToken?: string | null;
         emailSent?: boolean;
+        deliveryAttempted?: boolean;
         emailError?: string;
     }>;
     confirmEmailVerification: (token: string) => Promise<{
@@ -293,6 +349,7 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
         code?: string;
         resetToken?: string | null;
         emailSent?: boolean;
+        deliveryAttempted?: boolean;
         emailError?: string;
     }>;
     confirmPasswordReset: (token: string, password: string) => Promise<{
@@ -309,6 +366,8 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
         workspaceId?: string;
         inviteeKind?: "existing_user" | "new_user";
         passwordRequired?: boolean;
+        inviteeState?: "pending_setup" | "existing_account";
+        availableMethods?: string[];
     }>;
     acceptInviteWithToken: (token: string, password: string) => Promise<{
         success: boolean;
@@ -353,6 +412,7 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     archivedTasks: TaskItem[];
     initiatives: InitiativeItem[];
     workstreams: WorkstreamItem[];
+    planningBootstrapTaskSummaries: PlanningBootstrapWorkstreamTaskSummary[];
     deletedTasks: DeletedTaskRecord[];
     activeCategories: CategoryConfig[];
     activeTypes: {
@@ -391,6 +451,7 @@ export declare function useTaskforce({ config, initialTaskId, onTaskCountChange,
     setFilterAssignees: (nextValues: TaskAssignee[] | ((prev: TaskAssignee[]) => TaskAssignee[])) => void;
     filterTaxonomies: Record<string, (string | number)[]>;
     setFilterTaxonomies: import("react").Dispatch<import("react").SetStateAction<Record<string, (string | number)[]>>>;
+    hasInitedFilters: boolean;
     sortBy: import("../utils/taxonomySorting").TaskSortKey;
     setSortBy: import("react").Dispatch<import("react").SetStateAction<import("../utils/taxonomySorting").TaskSortKey>>;
     sortOrder: "asc" | "desc";