@taskforcehq/taskforce 0.3.169 → 0.3.300

package/dist/hooks/useSyncOrchestrator.d.ts

@@ -1,12 +1,14 @@
-import type { TaskItem } from '../types';
-import { type WorkspaceSyncDocumentSnapshot } from '../sync/workspaceSyncModel';
-import type { RealtimeReconcileTelemetry } from '../sync/realtimeReconcile';
-import { type RealtimeConnectionState } from './useRealtimeSync';
+import type { InitiativeItem, TaskItem, TaskforceTheme, WorkstreamItem } from '../types';
+import { type WorkspaceSyncPhase } from '../sync/workspaceSyncState';
+import { type WorkspaceSyncAiProfileSnapshot } from '../sync/workspaceSyncModel';
+import type { WorkspaceTaxonomyState } from '../shared/taxonomyState.js';
 import type { SupportedLocale } from '../localization';
+export declare function normalizeWorkspaceSyncAiProfileSnapshotEntry(entry: any): WorkspaceSyncAiProfileSnapshot;
 export interface UseSyncOrchestratorInput {
     currentWorkspaceId: string;
     cloudAuthConfigured: boolean;
     runtimeMode: 'local' | 'cloud';
+    authSessionResolved: boolean;
     isAuthenticated: boolean;
     authUserId: string | null;
     projectName: string;
@@ -15,11 +17,14 @@ export interface UseSyncOrchestratorInput {
     realtimeSyncEnabled: boolean;
     tasks: TaskItem[];
     archivedTasks: TaskItem[];
+    initiatives: InitiativeItem[];
+    workstreams: WorkstreamItem[];
     taxonomies: unknown[];
+    taxonomyState?: WorkspaceTaxonomyState;
     setupState: {
         mode?: string;
     } | null;
-    globalTheme: 'dark' | 'light' | 'midnight';
+    globalTheme: TaskforceTheme;
     locale: SupportedLocale;
     globalWeekStartsOn: 'sunday' | 'monday';
     themeUseGlobalDefault: boolean;
@@ -28,61 +33,34 @@ export interface UseSyncOrchestratorInput {
     setAuthBlocked: (value: boolean) => void;
     setIsAuthenticated: (value: boolean) => void;
     checkAuthSession: () => Promise<boolean>;
-    setGlobalTheme: (value: 'dark' | 'light' | 'midnight') => void;
-    setCurrentTheme: (value: 'dark' | 'light' | 'midnight') => void;
+    setGlobalTheme: (value: TaskforceTheme) => void;
+    setCurrentTheme: (value: TaskforceTheme) => void;
     setSetupState: React.Dispatch<React.SetStateAction<any>>;
     setLocale: (value: SupportedLocale) => void;
     setGlobalWeekStartsOn: (value: 'sunday' | 'monday') => void;
+    fetchPlanningEntities: () => Promise<void>;
 }
+export type WorkspaceSyncStatus = 'off' | 'syncing' | 'attention' | 'healthy';
 export declare function useSyncOrchestrator(input: UseSyncOrchestratorInput): {
-    userGlobalSyncStatus: "error" | "disconnected" | "idle" | "syncing";
-    setUserGlobalSyncStatus: import("react").Dispatch<import("react").SetStateAction<"error" | "disconnected" | "idle" | "syncing">>;
-    userGlobalLastSyncedAt: string | null;
-    setUserGlobalLastSyncedAt: import("react").Dispatch<import("react").SetStateAction<string | null>>;
-    userGlobalSyncPendingChanges: number;
-    setUserGlobalSyncPendingChanges: import("react").Dispatch<import("react").SetStateAction<number>>;
+    userGlobalSyncStatus: "error" | "idle" | "syncing" | "disconnected";
+    setUserGlobalSyncStatus: import("react").Dispatch<import("react").SetStateAction<"error" | "idle" | "syncing" | "disconnected">>;
     userGlobalSyncError: string | null;
     setUserGlobalSyncError: import("react").Dispatch<import("react").SetStateAction<string | null>>;
     workspaceLastPullAt: string | null;
-    setWorkspaceLastPullAt: import("react").Dispatch<import("react").SetStateAction<string | null>>;
     workspaceLastPushAt: string | null;
-    setWorkspaceLastPushAt: import("react").Dispatch<import("react").SetStateAction<string | null>>;
     workspaceLastErrorAt: string | null;
-    setWorkspaceLastErrorAt: import("react").Dispatch<import("react").SetStateAction<string | null>>;
     workspaceLastErrorMessage: string | null;
-    setWorkspaceLastErrorMessage: import("react").Dispatch<import("react").SetStateAction<string | null>>;
-    workspaceLastWarningMessage: string | null;
-    setWorkspaceLastWarningMessage: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    workspaceLastSuccessfulSyncAt: string | null;
     workspaceCloudSyncEnabled: boolean;
-    realtimeConnectionState: RealtimeConnectionState;
-    realtimeTelemetry: RealtimeReconcileTelemetry;
-    setWorkspaceCloudSyncEnabled: import("react").Dispatch<import("react").SetStateAction<boolean>>;
-    workspaceSyncSourceOfTruth: "local" | "cloud" | null;
-    setWorkspaceSyncSourceOfTruth: import("react").Dispatch<import("react").SetStateAction<"local" | "cloud" | null>>;
-    workspaceSyncOnboardingCompleted: boolean;
-    setWorkspaceSyncOnboardingCompleted: import("react").Dispatch<import("react").SetStateAction<boolean>>;
-    workspaceSyncReady: boolean;
-    setWorkspaceSyncReady: import("react").Dispatch<import("react").SetStateAction<boolean>>;
-    workspaceCloudHydrated: boolean;
-    setWorkspaceCloudHydrated: import("react").Dispatch<import("react").SetStateAction<boolean>>;
-    workspaceSyncDocuments: WorkspaceSyncDocumentSnapshot[];
-    setWorkspaceSyncDocuments: import("react").Dispatch<import("react").SetStateAction<WorkspaceSyncDocumentSnapshot[]>>;
-    workspaceSyncDocumentsFingerprint: string;
-    setWorkspaceSyncDocumentsFingerprint: import("react").Dispatch<import("react").SetStateAction<string>>;
+    workspaceSyncPhase: WorkspaceSyncPhase;
+    workspaceSyncStatus: WorkspaceSyncStatus;
+    workspaceSyncSummary: string;
+    workspaceSyncRecommendedAction: string;
+    workspaceSyncBusy: boolean;
+    workspaceSyncPendingChanges: number;
     syncInFlightRef: import("react").RefObject<boolean>;
     workspaceRetryAt: string | null;
-    isWorkspacePullRetryPending: () => boolean;
-    workspaceBootstrapSyncInProgress: boolean;
-    setWorkspaceBootstrapSyncInProgress: import("react").Dispatch<import("react").SetStateAction<boolean>>;
-    workspaceBootstrapSyncPages: number;
-    setWorkspaceBootstrapSyncPages: import("react").Dispatch<import("react").SetStateAction<number>>;
-    workspaceBootstrapSyncAppliedChanges: number;
-    setWorkspaceBootstrapSyncAppliedChanges: import("react").Dispatch<import("react").SetStateAction<number>>;
-    workspaceSyncFailureCount: number;
-    workspaceSyncRetryScheduledCount: number;
-    workspaceSyncAuthFailureCount: number;
-    workspaceSyncLastFailureSource: ("push" | "pull" | "apply" | "handshake") | null;
-    workspaceSyncLastFailureStatusCode: number | null;
+    isWorkspaceRetryPending: () => boolean;
     workspacePushInFlightRef: import("react").RefObject<boolean>;
     workspacePullInFlightRef: import("react").RefObject<boolean>;
     workspaceLastPushedSignatureRef: import("react").RefObject<string>;
@@ -90,75 +68,59 @@ export declare function useSyncOrchestrator(input: UseSyncOrchestratorInput): {
     workspaceLastPushedTaskIdsRef: import("react").RefObject<Set<string>>;
     workspaceDeletedTaskIdsRef: import("react").RefObject<Set<string>>;
     workspacePullCursorRef: import("react").RefObject<string | null>;
-    workspacePullBootstrapDoneRef: import("react").RefObject<boolean>;
-    workspaceBackfillForcedRef: import("react").RefObject<Set<string>>;
-    workspaceSyncReadyRef: import("react").RefObject<Set<string>>;
-    workspaceCloudHydratedRef: import("react").RefObject<Set<string>>;
     clearWorkspaceRetry: () => void;
-    scheduleWorkspacePullRetry: (invokePull: () => Promise<boolean>, options?: {
-        minDelayMs?: number;
-        workspaceId?: string;
-    }) => void;
-    isWorkspacePullCooldownActive: (workspaceId: string) => boolean;
-    markWorkspacePullCooldown: (workspaceId: string, minDelayMs?: number) => void;
-    tryAcquireWorkspacePullLease: (workspaceId: string) => Promise<boolean>;
-    releaseWorkspacePullLease: (workspaceId: string) => void;
-    recordWorkspaceSyncFailure: (source: "push" | "pull" | "apply" | "handshake", statusCode?: number | null) => void;
-    incrementWorkspaceSyncAuthFailure: () => void;
-    persistWorkspaceSyncPatch: (patch: Record<string, unknown>) => Promise<void>;
+    persistWorkspaceSyncPatch: (patch: Partial<import("../sync/workspaceSyncState").WorkspaceSyncStateV2>) => Promise<import("../sync/workspaceSyncState").WorkspaceSyncStateV2>;
     loadWorkspaceSyncState: () => Promise<void>;
-    applyWorkspaceSyncStateSnapshot: (nextState: {
-        cloudSyncEnabled: boolean;
-        sourceOfTruth?: "cloud" | "local" | null;
-        onboardingCompleted?: boolean;
-        pullCursor?: string | null;
+    applyWorkspaceSyncStateSnapshot: (nextState: Partial<import("../sync/workspaceSyncState").WorkspaceSyncStateV2> & {
+        enabled: boolean;
+        phase?: WorkspaceSyncPhase | null;
     }) => void;
     syncUserGlobalSettings: (options?: {
         preferCloudOnFirstSync?: boolean;
     }) => Promise<void>;
-    getLocalUserSyncUpdatedAt: (userId: string) => string | null;
-    setLocalUserSyncUpdatedAt: (userId: string, updatedAt: string) => void;
-    buildUserGlobalSyncPayload: () => {
-        theme: "dark" | "light" | "midnight";
-        operatingMode: string;
-        localization: {
-            locale: "en-US" | "es-419" | "pt-BR";
-            weekStartsOn: "sunday" | "monday";
-        };
-    };
-    applyRemoteUserGlobalSyncPayload: (remote: any) => Promise<void>;
-    ensureCloudWorkspaceReadyForSync: () => Promise<{
-        success: boolean;
-        error?: string;
-        provisioned?: boolean;
-        statusCode?: number;
-        retryAfterMs?: number;
-    }>;
-    buildWorkspaceSyncPayload: () => import("../sync/workspaceSyncModel").WorkspaceSyncPayload;
     buildWorkspaceSyncSignature: () => string;
-    refreshWorkspaceSyncDocumentsSnapshot: () => Promise<void>;
-    handleSyncAuthFailure: (source: "push" | "pull" | "apply" | "handshake", statusCode: number) => Promise<void>;
-    ensureWorkspaceSyncReady: () => Promise<boolean>;
-    pushWorkspaceChangesToCloud: (signature: string) => Promise<boolean>;
-    pullWorkspaceChangesFromCloud: () => Promise<boolean>;
-    fetchLocalWorkspaceSnapshot: () => Promise<{
-        tasks: never[];
-        archived: never[];
-        error: string;
-    } | {
-        tasks: any;
-        archived: any;
-        error?: undefined;
-    }>;
-    saveWorkspaceCloudSyncSettings: (input: {
+    pushWorkspaceChangesToCloud: (signature: string, options?: {
+        forceAllAiProfiles?: boolean;
+        repairMode?: boolean;
+    }) => Promise<boolean>;
+    pullWorkspaceChangesFromCloud: (options?: {
+        repairMode?: boolean;
+    }) => Promise<boolean>;
+    saveWorkspaceCloudSyncSettings: (settings: {
         enabled: boolean;
-        sourceOfTruth?: "cloud" | "local" | null;
-        onboardingCompleted?: boolean;
     }) => Promise<{
         success: boolean;
         error?: string;
     }>;
     retryUserGlobalSettingsSync: () => Promise<void>;
-    retryWorkspaceCloudSync: () => Promise<void>;
+    retryWorkspaceCloudSync: () => Promise<boolean>;
     resetWorkspaceSyncCursorAndPull: () => Promise<void>;
+    getWorkspaceSyncDiagnostics: () => {
+        workspaceId: string;
+        enabled: boolean;
+        phase: WorkspaceSyncPhase;
+        status: 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;
+    };
 };