@taskforcehq/taskforce 0.3.304 → 0.3.306

package/dist/hooks/useWorkspaceSyncController.d.ts

@@ -1,5 +1,5 @@
 import type { EnsureWorkspaceReadyResult } from '../sync/syncService';
-import { type WorkspaceSyncPhase, type WorkspaceSyncStateV2 } from '../sync/workspaceSyncState';
+import { type WorkspaceSyncSetupIntent, type WorkspaceSyncPhase, type WorkspaceSyncStateV2 } from '../sync/workspaceSyncState';
 type WorkspaceSyncLeaseOperation = 'pull' | 'push' | 'repair';
 interface WorkspaceSyncLeaseRecord {
     ownerId: string;
@@ -12,6 +12,7 @@ interface UseWorkspaceSyncControllerInput {
     currentWorkspaceId: string;
     setWorkspaceCloudSyncEnabled: (value: boolean) => void;
     setWorkspaceSyncPhase: (value: WorkspaceSyncPhase) => void;
+    setWorkspaceSyncSetupIntent: (value: WorkspaceSyncSetupIntent) => void;
     setWorkspaceLastPullAt: (value: string | null) => void;
     setWorkspaceLastPushAt: (value: string | null) => void;
     setWorkspaceLastErrorMessage: (value: string | null) => void;
@@ -30,6 +31,7 @@ export declare function useWorkspaceSyncController(input: UseWorkspaceSyncContro
     workspacePendingSignatureRef: import("react").RefObject<string>;
     workspaceLastPushedTaskIdsRef: import("react").RefObject<Set<string>>;
     workspaceDeletedTaskIdsRef: import("react").RefObject<Set<string>>;
+    workspaceDeletedTaskWatermarksRef: import("react").RefObject<Map<string, string>>;
     workspacePullCursorRef: import("react").RefObject<string | null>;
     clearWorkspaceRetry: () => void;
     scheduleWorkspaceRetry: (invokeSync: () => Promise<boolean>, options?: {
@@ -37,6 +39,7 @@ export declare function useWorkspaceSyncController(input: UseWorkspaceSyncContro
     }) => void;
     persistWorkspaceSyncPatch: (patch: Partial<WorkspaceSyncStateV2>) => Promise<WorkspaceSyncStateV2>;
     applyWorkspaceSyncPatchLocally: (patch: Partial<WorkspaceSyncStateV2>) => WorkspaceSyncStateV2;
+    readWorkspaceSyncStateSnapshot: () => WorkspaceSyncStateV2;
     loadWorkspaceSyncState: () => Promise<void>;
     applyWorkspaceSyncStateSnapshot: (nextState: Partial<WorkspaceSyncStateV2> & {
         enabled: boolean;

package/dist/hooks/useWorkspaceSyncController.js

@@ -59,20 +59,23 @@ function buildWorkspaceSyncStatePatch(current, patch) {
         ...patch,
         version: 2,
         phase: patch.phase || current.phase,
+        setupIntent: patch.setupIntent === undefined ? (current.setupIntent ?? null) : (patch.setupIntent ?? null),
         pullCursor: patch.pullCursor === undefined ? current.pullCursor : normalizeCursor(patch.pullCursor),
         lastPullAt: patch.lastPullAt === undefined ? current.lastPullAt : normalizeCursor(patch.lastPullAt),
         lastPushAt: patch.lastPushAt === undefined ? current.lastPushAt : normalizeCursor(patch.lastPushAt),
         lastSyncedAt: patch.lastSyncedAt === undefined ? current.lastSyncedAt : normalizeCursor(patch.lastSyncedAt),
-        lastErrorMessage: patch.lastErrorMessage === undefined ? current.lastErrorMessage : (patch.lastErrorMessage ?? null)
+        lastErrorMessage: patch.lastErrorMessage === undefined ? current.lastErrorMessage : (patch.lastErrorMessage ?? null),
+        pushBaseline: patch.pushBaseline === undefined ? (current.pushBaseline ?? null) : (patch.pushBaseline ?? null)
     };
     if (!next.enabled) {
         next.phase = 'idle';
+        next.setupIntent = null;
         next.pullCursor = null;
     }
     return next;
 }
 export function useWorkspaceSyncController(input) {
-    const { currentWorkspaceId, setWorkspaceCloudSyncEnabled, setWorkspaceSyncPhase, setWorkspaceLastPullAt, setWorkspaceLastPushAt, setWorkspaceLastErrorMessage } = input;
+    const { currentWorkspaceId, setWorkspaceCloudSyncEnabled, setWorkspaceSyncPhase, setWorkspaceSyncSetupIntent, setWorkspaceLastPullAt, setWorkspaceLastPushAt, setWorkspaceLastErrorMessage } = input;
     const [workspaceRetryAt, setWorkspaceRetryAt] = useState(null);
     const workspaceRetryTimerRef = useRef(null);
     const workspaceRetryAtMsRef = useRef(null);
@@ -86,6 +89,7 @@ export function useWorkspaceSyncController(input) {
     const workspacePendingSignatureRef = useRef('');
     const workspaceLastPushedTaskIdsRef = useRef(new Set());
     const workspaceDeletedTaskIdsRef = useRef(new Set());
+    const workspaceDeletedTaskWatermarksRef = useRef(new Map());
     const workspacePullCursorRef = useRef(null);
     const workspaceSyncStateRef = useRef(createDefaultWorkspaceSyncState());
     const workspaceSyncLeaseOwnerIdRef = useRef('');
@@ -255,6 +259,7 @@ export function useWorkspaceSyncController(input) {
         const next = buildWorkspaceSyncStatePatch(current, {
             enabled: Boolean(nextState.enabled),
             phase: nextState.phase || current.phase,
+            setupIntent: nextState.setupIntent,
             pullCursor: nextState.pullCursor,
             lastPullAt: nextState.lastPullAt,
             lastPushAt: nextState.lastPushAt,
@@ -265,12 +270,14 @@ export function useWorkspaceSyncController(input) {
         workspacePullCursorRef.current = next.pullCursor;
         setWorkspaceCloudSyncEnabled(next.enabled);
         setWorkspaceSyncPhase(next.phase);
+        setWorkspaceSyncSetupIntent(next.setupIntent ?? null);
         setWorkspaceLastPullAt(next.lastPullAt);
         setWorkspaceLastPushAt(next.lastPushAt);
         setWorkspaceLastErrorMessage(next.lastErrorMessage ?? null);
     }, [
         setWorkspaceCloudSyncEnabled,
         setWorkspaceSyncPhase,
+        setWorkspaceSyncSetupIntent,
         setWorkspaceLastPullAt,
         setWorkspaceLastPushAt,
         setWorkspaceLastErrorMessage
@@ -280,6 +287,9 @@ export function useWorkspaceSyncController(input) {
         applyWorkspaceSyncStateSnapshot(next);
         return next;
     }, [applyWorkspaceSyncStateSnapshot]);
+    const readWorkspaceSyncStateSnapshot = useCallback(() => {
+        return workspaceSyncStateRef.current;
+    }, []);
     const persistWorkspaceSyncPatch = useCallback(async (patch) => {
         const next = buildWorkspaceSyncStatePatch(workspaceSyncStateRef.current, patch);
         workspaceSyncStateRef.current = next;
@@ -343,6 +353,7 @@ export function useWorkspaceSyncController(input) {
                 await persistWorkspaceSyncPatch({
                     enabled: false,
                     phase: 'idle',
+                    setupIntent: null,
                     pullCursor: null
                 });
                 return { success: true };
@@ -360,6 +371,7 @@ export function useWorkspaceSyncController(input) {
             await persistWorkspaceSyncPatch({
                 enabled: true,
                 phase: ensured.provisioned ? 'provision-local' : 'attach-cloud',
+                setupIntent: null,
                 pullCursor: null,
                 lastPullAt: null,
                 lastPushAt: null,
@@ -376,6 +388,7 @@ export function useWorkspaceSyncController(input) {
         workspacePendingSignatureRef.current = '';
         workspaceLastPushedTaskIdsRef.current = new Set();
         workspaceDeletedTaskIdsRef.current = new Set();
+        workspaceDeletedTaskWatermarksRef.current = new Map();
         workspacePullCursorRef.current = null;
         workspaceSyncStateRef.current = createDefaultWorkspaceSyncState();
         workspacePushInFlightRef.current = false;
@@ -413,11 +426,13 @@ export function useWorkspaceSyncController(input) {
         workspacePendingSignatureRef,
         workspaceLastPushedTaskIdsRef,
         workspaceDeletedTaskIdsRef,
+        workspaceDeletedTaskWatermarksRef,
         workspacePullCursorRef,
         clearWorkspaceRetry,
         scheduleWorkspaceRetry,
         persistWorkspaceSyncPatch,
         applyWorkspaceSyncPatchLocally,
+        readWorkspaceSyncStateSnapshot,
         loadWorkspaceSyncState,
         applyWorkspaceSyncStateSnapshot,
         saveWorkspaceCloudSyncSettings,

package/dist/hooks/useWorkspaceSyncController.test.js

@@ -5,6 +5,7 @@ const makeInput = (overrides = {}) => ({
     currentWorkspaceId: 'ws-test',
     setWorkspaceCloudSyncEnabled: vi.fn(),
     setWorkspaceSyncPhase: vi.fn(),
+    setWorkspaceSyncSetupIntent: vi.fn(),
     setWorkspaceLastPullAt: vi.fn(),
     setWorkspaceLastPushAt: vi.fn(),
     setWorkspaceLastErrorMessage: vi.fn(),

package/dist/hooks/workspace/useTaskforceWorkspaceBootstrap.d.ts

@@ -11,6 +11,14 @@ export interface WorkspaceSummary {
     status?: string;
     betaAccess?: boolean;
 }
+type CloudBootstrapReason = 'initial-load' | 'post-plans' | 'retry';
+type CloudBootstrapResult = {
+    success: boolean;
+    authenticated: boolean;
+    workspaceSetupRequired: boolean;
+    error?: string;
+    code?: string;
+};
 interface UseTaskforceWorkspaceBootstrapArgs {
     shouldDeferProtectedApiCalls: boolean;
     shouldBlockProtectedApiCalls: boolean;
@@ -67,6 +75,7 @@ interface UseTaskforceWorkspaceBootstrapArgs {
     authSessionResolved: boolean;
     isAuthenticated: boolean;
     authUserId: string;
+    authUserAvatarUrl: string;
     setHydratedWorkspaceRole: (value: WorkspaceRole | null) => void;
     setAssigneeOptions: (value: TaskAssigneeOption[]) => void;
     setAssigneeOptionsLoaded: (value: boolean) => void;
@@ -90,6 +99,7 @@ interface UseTaskforceWorkspaceBootstrapArgs {
     showArchive: boolean;
     taskScope: string;
     settingsSection: string | null;
+    workspaceBootstrapPending: boolean;
     fetchTasks: (isSilent?: boolean, options?: {
         ignoreAuthGuard?: boolean;
     }) => Promise<void>;
@@ -162,5 +172,11 @@ export declare function useTaskforceWorkspaceBootstrap(args: UseTaskforceWorkspa
         workspaceId?: undefined;
     }>;
     retryBootstrapChecks: () => Promise<void>;
+    runCloudBootstrap: (options?: {
+        reason?: CloudBootstrapReason;
+        ignoreAuthGuard?: boolean;
+        tasksSilent?: boolean;
+        includeDeferredArchive?: boolean;
+    }) => Promise<CloudBootstrapResult>;
 };
 export {};