@taskforcehq/taskforce 0.3.305 → 0.3.307

package/dist/hooks/sync/transfers.test.js

@@ -0,0 +1,928 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { createWorkspaceTransferCoordinator } from './transfers';
+const { runWorkspacePullSyncServiceMock, runWorkspacePushSyncServiceMock } = vi.hoisted(() => ({
+    runWorkspacePullSyncServiceMock: vi.fn(),
+    runWorkspacePushSyncServiceMock: vi.fn()
+}));
+vi.mock('../../sync/syncService', async () => {
+    const actual = await vi.importActual('../../sync/syncService');
+    return {
+        ...actual,
+        runWorkspacePullSyncService: runWorkspacePullSyncServiceMock,
+        runWorkspacePushSyncService: runWorkspacePushSyncServiceMock
+    };
+});
+function ref(current) {
+    return { current };
+}
+function createCoordinator(overrides) {
+    const persistWorkspaceSyncPatchSafely = (overrides?.persistWorkspaceSyncPatchSafely ?? vi.fn());
+    const scheduleWorkspaceSyncRetry = (overrides?.scheduleWorkspaceSyncRetry ?? vi.fn());
+    const reportSyncEvent = vi.fn();
+    const workspacePendingPushReplayRef = ref(null);
+    const coordinator = createWorkspaceTransferCoordinator({
+        cloudAuthConfigured: true,
+        runtimeMode: 'local',
+        workspaceCloudSyncEnabled: true,
+        currentWorkspaceId: 'workspace-local-active',
+        workspaceSyncPhase: 'active',
+        isAuthenticated: true,
+        checkAuthSession: vi.fn(async () => true),
+        resolveCloudAuthUrl: (path) => `https://cloud.example.com${path}`,
+        ensureCloudWorkspaceReadyForSync: vi.fn(async () => ({ success: true })),
+        ensureWorkspaceSyncReady: vi.fn(async () => true),
+        handleSyncAuthFailure: vi.fn(async () => { }),
+        clearWorkspaceRetry: vi.fn(),
+        clearWorkspaceIssue: vi.fn(),
+        isWorkspaceRetryPending: vi.fn(() => false),
+        scheduleWorkspaceSyncRetry,
+        persistWorkspaceSyncPatchSafely,
+        persistWorkspaceSyncPatchBestEffort: vi.fn(async () => { }),
+        persistWorkspaceSyncWatermarksSnapshotBestEffort: vi.fn(() => true),
+        reportSyncEvent,
+        acquireWorkspaceSyncLease: vi.fn(async () => true),
+        releaseWorkspaceSyncLease: vi.fn(),
+        reportWorkspaceWindowContention: vi.fn(),
+        refreshWorkspaceSyncMarkdownDocumentsSnapshot: vi.fn(async () => { }),
+        refreshWorkspaceSyncAiProfilesSnapshot: vi.fn(async () => { }),
+        refreshWorkspaceSyncAssetsSnapshot: vi.fn(async () => { }),
+        refreshWorkspaceSyncPlanningEntitiesSnapshot: overrides?.refreshWorkspaceSyncPlanningEntitiesSnapshot ?? vi.fn(async () => { }),
+        refreshWorkspaceSyncDocumentReviewSessionsSnapshot: vi.fn(async () => { }),
+        refreshWorkspaceSyncAnnotatedAttachmentSessionsSnapshot: vi.fn(async () => { }),
+        refreshLocalWorkspaceTaskCollections: overrides?.refreshLocalWorkspaceTaskCollections ?? vi.fn(async () => { }),
+        buildWorkspaceSyncPayload: (overrides?.buildWorkspaceSyncPayload ?? vi.fn(() => ({
+            changes: [],
+            currentTaskIds: new Set(),
+            deleteTaskIds: new Set(),
+            currentInitiativeIds: new Set(),
+            currentInitiativeWatermarks: new Map(),
+            currentWorkstreamIds: new Set(),
+            currentWorkstreamWatermarks: new Map(),
+            currentAiProfileIds: new Set(),
+            currentAiProfileWatermarks: new Map(),
+            currentDocumentPaths: new Set(),
+            deleteDocumentPaths: new Set(),
+            currentDocumentWatermarks: new Map(),
+            currentAssetPaths: new Set(),
+            deleteAssetPaths: new Set(),
+            currentAssetWatermarks: new Map(),
+            currentDocumentReviewSessionIds: new Set(),
+            deleteDocumentReviewSessionIds: new Set(),
+            currentDocumentReviewSessionWatermarks: new Map(),
+            currentDocumentReviewCommentIds: new Set(),
+            deleteDocumentReviewCommentIds: new Set(),
+            currentDocumentReviewCommentWatermarks: new Map(),
+            currentAnnotatedAttachmentSessionIds: new Set(),
+            deleteAnnotatedAttachmentSessionIds: new Set(),
+            currentAnnotatedAttachmentSessionWatermarks: new Map(),
+            currentTaskEventWatermarks: new Map(),
+            pushedWatermarks: new Map()
+        }))),
+        buildWorkspaceSyncSignature: overrides?.buildWorkspaceSyncSignature ?? vi.fn(() => 'sync-signature'),
+        seedWorkspaceSnapshotPushBaseline: vi.fn(),
+        shouldSuppressAttachBootstrapPush: vi.fn(() => false),
+        recordSuppressedEventIds: vi.fn(),
+        workspaceRepairModeRef: ref(false),
+        workspaceForceFullAiProfilePushRef: ref(false),
+        workspacePushInFlightRef: ref(false),
+        workspacePullInFlightRef: ref(false),
+        workspacePendingPushReplayRef,
+        workspaceLastPushedSignatureRef: ref(''),
+        workspacePendingSignatureRef: ref(''),
+        workspaceLastPushedTaskIdsRef: ref(new Set()),
+        workspaceDeletedTaskIdsRef: ref(new Set()),
+        workspaceDeletedTaskWatermarksRef: ref(new Map()),
+        workspacePullCursorRef: ref('stale-cursor'),
+        workspaceLastPushedWatermarksRef: ref(new Map()),
+        workspaceLastPushedTaskChangeKeysRef: ref(new Map()),
+        workspaceLastPushedInitiativeIdsRef: ref(new Set()),
+        workspaceLastPushedInitiativeWatermarksRef: ref(new Map()),
+        workspaceLastPushedWorkstreamIdsRef: ref(new Set()),
+        workspaceLastPushedWorkstreamWatermarksRef: ref(new Map()),
+        workspaceLastPushedAiProfileIdsRef: ref(new Set()),
+        workspaceLastPushedAiProfileWatermarksRef: ref(new Map()),
+        workspaceLastPushedAiProfileChangeKeysRef: ref(new Map()),
+        workspaceLastPushedDocumentPathsRef: ref(new Set()),
+        workspaceLastPushedDocumentWatermarksRef: ref(new Map()),
+        workspaceLastPushedAssetPathsRef: ref(new Set()),
+        workspaceLastPushedAssetWatermarksRef: ref(new Map()),
+        workspaceLastPushedDocumentReviewSessionIdsRef: ref(new Set()),
+        workspaceLastPushedDocumentReviewSessionWatermarksRef: ref(new Map()),
+        workspaceLastPushedDocumentReviewCommentIdsRef: ref(new Set()),
+        workspaceLastPushedDocumentReviewCommentWatermarksRef: ref(new Map()),
+        workspaceLastPushedAnnotatedAttachmentSessionIdsRef: ref(new Set()),
+        workspaceLastPushedAnnotatedAttachmentSessionWatermarksRef: ref(new Map()),
+        workspaceLastPushedTaskEventWatermarksRef: ref(new Map()),
+        workspaceBaselineResetReasonRef: ref(null),
+        workspaceCaptureAttachBootstrapBaselineRef: ref(false),
+        workspaceStartupFullReconcileRanRef: ref(false),
+        workspaceFullReconcileInFlightRef: ref(false),
+        bootstrapLastProgressAtRef: ref(null),
+        realtimeSuppressedEventQueueRef: ref([]),
+        setWorkspaceSyncBusy: vi.fn(),
+        setUserGlobalSyncStatus: vi.fn(),
+        setUserGlobalSyncError: vi.fn(),
+        setWorkspaceLastErrorMessage: vi.fn(),
+        setWorkspaceLastErrorAt: vi.fn(),
+        setWorkspaceLastPullAt: vi.fn(),
+        setWorkspaceLastPushAt: vi.fn(),
+        setWorkspaceSyncPendingChanges: vi.fn(),
+        setTasks: vi.fn(),
+        setArchivedTasks: vi.fn()
+    });
+    return { coordinator, persistWorkspaceSyncPatchSafely, scheduleWorkspaceSyncRetry, reportSyncEvent, workspacePendingPushReplayRef };
+}
+describe('createWorkspaceTransferCoordinator', () => {
+    beforeEach(() => {
+        runWorkspacePullSyncServiceMock.mockReset();
+        runWorkspacePushSyncServiceMock.mockReset();
+    });
+    it('refreshes planning entity snapshots before building a push payload', async () => {
+        const callOrder = [];
+        const refreshWorkspaceSyncPlanningEntitiesSnapshot = vi.fn(async () => {
+            callOrder.push('planning-refresh');
+        });
+        const buildWorkspaceSyncPayload = vi.fn(() => {
+            callOrder.push('build-payload');
+            return {
+                changes: [],
+                currentTaskIds: new Set(),
+                deleteTaskIds: new Set(),
+                currentInitiativeIds: new Set(),
+                currentInitiativeWatermarks: new Map(),
+                currentWorkstreamIds: new Set(),
+                currentWorkstreamWatermarks: new Map(),
+                currentAiProfileIds: new Set(),
+                currentAiProfileWatermarks: new Map(),
+                currentDocumentPaths: new Set(),
+                deleteDocumentPaths: new Set(),
+                currentDocumentWatermarks: new Map(),
+                currentAssetPaths: new Set(),
+                deleteAssetPaths: new Set(),
+                currentAssetWatermarks: new Map(),
+                currentDocumentReviewSessionIds: new Set(),
+                deleteDocumentReviewSessionIds: new Set(),
+                currentDocumentReviewSessionWatermarks: new Map(),
+                currentDocumentReviewCommentIds: new Set(),
+                deleteDocumentReviewCommentIds: new Set(),
+                currentDocumentReviewCommentWatermarks: new Map(),
+                currentAnnotatedAttachmentSessionIds: new Set(),
+                deleteAnnotatedAttachmentSessionIds: new Set(),
+                currentAnnotatedAttachmentSessionWatermarks: new Map(),
+                currentTaskEventWatermarks: new Map(),
+                pushedWatermarks: new Map()
+            };
+        });
+        runWorkspacePushSyncServiceMock.mockResolvedValueOnce({
+            success: true,
+            syncedAt: '2026-04-27T16:00:00.000Z',
+            requestMs: 1,
+            changeCount: 0,
+            deleteCount: 0,
+            currentTaskIds: new Set(),
+            currentTaskWatermarks: new Map(),
+            currentTaskChangeKeys: new Map(),
+            deleteTaskIds: new Set(),
+            currentInitiativeIds: new Set(),
+            currentInitiativeWatermarks: new Map(),
+            currentWorkstreamIds: new Set(),
+            currentWorkstreamWatermarks: new Map(),
+            currentAiProfileIds: new Set(),
+            currentAiProfileWatermarks: new Map(),
+            currentAiProfileChangeKeys: new Map(),
+            currentDocumentPaths: new Set(),
+            currentDocumentWatermarks: new Map(),
+            currentAssetPaths: new Set(),
+            currentAssetWatermarks: new Map(),
+            currentDocumentReviewSessionIds: new Set(),
+            currentDocumentReviewSessionWatermarks: new Map(),
+            currentDocumentReviewCommentIds: new Set(),
+            currentDocumentReviewCommentWatermarks: new Map(),
+            currentAnnotatedAttachmentSessionIds: new Set(),
+            currentAnnotatedAttachmentSessionWatermarks: new Map(),
+            currentTaskEventWatermarks: new Map(),
+            pushedWatermarks: new Map(),
+            emittedEventIds: [],
+            appliedTaskUpserts: []
+        });
+        const { coordinator } = createCoordinator({
+            buildWorkspaceSyncPayload,
+            refreshWorkspaceSyncPlanningEntitiesSnapshot
+        });
+        const result = await coordinator.pushWorkspaceChangesToCloud('signature-1');
+        expect(result).toBe(true);
+        expect(refreshWorkspaceSyncPlanningEntitiesSnapshot).toHaveBeenCalledTimes(1);
+        expect(buildWorkspaceSyncPayload).toHaveBeenCalledTimes(1);
+        expect(callOrder).toEqual(['planning-refresh', 'build-payload']);
+    });
+    it('persists a cleared cursor before scheduling an invalid-cursor retry', async () => {
+        runWorkspacePullSyncServiceMock.mockResolvedValueOnce({
+            success: false,
+            kind: 'pull_http',
+            status: 400,
+            errorCode: 'INVALID_SYNC_CURSOR',
+            error: 'Invalid sync cursor.',
+            cursor: 'stale-cursor',
+            pages: 0,
+            appliedChanges: 0,
+            pullRequestMs: 1,
+            applyMs: 0,
+            pulledDeleteTaskIds: new Set(),
+            pulledActiveUpserts: false,
+            pulledArchivedUpserts: false,
+            documentDecryptFailures: []
+        });
+        const { coordinator, persistWorkspaceSyncPatchSafely, scheduleWorkspaceSyncRetry } = createCoordinator();
+        const result = await coordinator.pullWorkspaceChangesFromCloud();
+        expect(result).toBe(false);
+        expect(runWorkspacePullSyncServiceMock).toHaveBeenCalledWith(expect.objectContaining({
+            cursor: 'stale-cursor'
+        }));
+        expect(persistWorkspaceSyncPatchSafely).toHaveBeenCalledWith({ pullCursor: null });
+        expect(scheduleWorkspaceSyncRetry).toHaveBeenCalledWith(150);
+    });
+    it('refreshes local planning collections after planning-only pull changes', async () => {
+        const refreshLocalWorkspaceTaskCollections = vi.fn(async () => { });
+        runWorkspacePullSyncServiceMock.mockResolvedValueOnce({
+            success: true,
+            syncedAt: '2026-04-27T22:00:00.000Z',
+            cursor: 'planning-cursor',
+            pages: 1,
+            appliedChanges: 1,
+            pullRequestMs: 1,
+            applyMs: 1,
+            pulledDeleteTaskIds: new Set(),
+            pulledActiveUpserts: false,
+            pulledArchivedUpserts: false,
+            pulledTaskEventUpserts: false,
+            pulledPlanningUpserts: true,
+            documentDecryptFailures: [],
+            emittedEventIds: []
+        });
+        const { coordinator } = createCoordinator({ refreshLocalWorkspaceTaskCollections });
+        const result = await coordinator.pullWorkspaceChangesFromCloud();
+        expect(result).toBe(true);
+        expect(refreshLocalWorkspaceTaskCollections).toHaveBeenCalledTimes(1);
+    });
+    it('reasserts all AI profiles after a full reconcile pull', async () => {
+        vi.useFakeTimers();
+        runWorkspacePullSyncServiceMock.mockResolvedValueOnce({
+            success: true,
+            syncedAt: '2026-03-15T19:30:00.000Z',
+            cursor: 'fresh-cursor',
+            pages: 1,
+            appliedChanges: 0,
+            pullRequestMs: 1,
+            applyMs: 0,
+            pulledDeleteTaskIds: new Set(),
+            pulledActiveUpserts: false,
+            pulledArchivedUpserts: false,
+            documentDecryptFailures: []
+        });
+        runWorkspacePushSyncServiceMock.mockResolvedValueOnce({
+            success: true,
+            syncedAt: '2026-03-15T19:30:01.000Z',
+            requestMs: 1,
+            changeCount: 1,
+            deleteCount: 0,
+            currentTaskIds: new Set(),
+            currentTaskWatermarks: new Map(),
+            currentTaskChangeKeys: new Map(),
+            deleteTaskIds: new Set(),
+            currentInitiativeIds: new Set(),
+            currentInitiativeWatermarks: new Map(),
+            currentWorkstreamIds: new Set(),
+            currentWorkstreamWatermarks: new Map(),
+            currentAiProfileIds: new Set(['ai-profile-john-drake']),
+            currentAiProfileWatermarks: new Map([['ai-profile-john-drake', '2026-03-15T19:00:00.000Z']]),
+            currentAiProfileChangeKeys: new Map([['ai-profile-john-drake', 'john-change-key']]),
+            currentDocumentPaths: new Set(),
+            currentDocumentWatermarks: new Map(),
+            currentAssetPaths: new Set(),
+            currentAssetWatermarks: new Map(),
+            currentDocumentReviewSessionIds: new Set(),
+            currentDocumentReviewSessionWatermarks: new Map(),
+            currentDocumentReviewCommentIds: new Set(),
+            currentDocumentReviewCommentWatermarks: new Map(),
+            currentAnnotatedAttachmentSessionIds: new Set(),
+            currentAnnotatedAttachmentSessionWatermarks: new Map(),
+            currentTaskEventWatermarks: new Map(),
+            pushedWatermarks: new Map(),
+            emittedEventIds: [],
+            appliedTaskUpserts: []
+        });
+        const buildWorkspaceSyncPayload = vi.fn(() => ({
+            changes: [{
+                    op: 'ai-profile-upsert',
+                    profile: {
+                        id: 'ai-profile-john-drake',
+                        workspaceId: 'workspace-local-active',
+                        profileToken: 'token-john',
+                        name: 'John Drake',
+                        username: 'john-drake',
+                        icon: 'Bot',
+                        color: '#8b5cf6',
+                        avatarUrl: null,
+                        avatarSourceUrl: null,
+                        description: null,
+                        role: null,
+                        provider: null,
+                        model: null,
+                        surfaceType: null,
+                        seatScope: null,
+                        providerMetadata: null,
+                        archivedAt: null,
+                        archivedBy: null,
+                        archivedReason: null,
+                        mergedIntoProfileId: null,
+                        rosterStateUpdatedAt: null,
+                        createdAt: '2026-03-15T19:00:00.000Z',
+                        updatedAt: '2026-03-15T19:00:00.000Z',
+                        lastActiveAt: null
+                    }
+                }],
+            currentTaskIds: new Set(),
+            deleteTaskIds: new Set(),
+            currentInitiativeIds: new Set(),
+            currentInitiativeWatermarks: new Map(),
+            currentWorkstreamIds: new Set(),
+            currentWorkstreamWatermarks: new Map(),
+            currentAiProfileIds: new Set(['ai-profile-john-drake']),
+            currentAiProfileWatermarks: new Map([['ai-profile-john-drake', '2026-03-15T19:00:00.000Z']]),
+            currentAiProfileChangeKeys: new Map([['ai-profile-john-drake', 'john-change-key']]),
+            currentDocumentPaths: new Set(),
+            deleteDocumentPaths: new Set(),
+            currentDocumentWatermarks: new Map(),
+            currentAssetPaths: new Set(),
+            deleteAssetPaths: new Set(),
+            currentAssetWatermarks: new Map(),
+            currentDocumentReviewSessionIds: new Set(),
+            deleteDocumentReviewSessionIds: new Set(),
+            currentDocumentReviewSessionWatermarks: new Map(),
+            currentDocumentReviewCommentIds: new Set(),
+            deleteDocumentReviewCommentIds: new Set(),
+            currentDocumentReviewCommentWatermarks: new Map(),
+            currentAnnotatedAttachmentSessionIds: new Set(),
+            deleteAnnotatedAttachmentSessionIds: new Set(),
+            currentAnnotatedAttachmentSessionWatermarks: new Map(),
+            currentTaskEventWatermarks: new Map(),
+            pushedWatermarks: new Map()
+        }));
+        const { coordinator } = createCoordinator({ buildWorkspaceSyncPayload });
+        await coordinator.pullWorkspaceChangesFromCloud({ forceCursorNull: true });
+        await vi.advanceTimersByTimeAsync(130);
+        await Promise.resolve();
+        expect(runWorkspacePushSyncServiceMock).toHaveBeenCalledTimes(1);
+        expect(buildWorkspaceSyncPayload).toHaveBeenCalledWith({ forceAllAiProfiles: true });
+        expect(runWorkspacePushSyncServiceMock).toHaveBeenCalledWith(expect.objectContaining({
+            payload: expect.objectContaining({
+                changes: expect.arrayContaining([
+                    expect.objectContaining({
+                        op: 'ai-profile-upsert',
+                        profile: expect.objectContaining({
+                            id: 'ai-profile-john-drake',
+                            name: 'John Drake'
+                        })
+                    })
+                ])
+            })
+        }));
+    });
+    it('reports push payload diagnostics when a push fails', async () => {
+        runWorkspacePushSyncServiceMock.mockResolvedValueOnce({
+            success: false,
+            status: 524,
+            error: '524 unknown',
+            transient: true,
+            requestMs: 125000,
+            changeCount: 3,
+            deleteCount: 0,
+            currentTaskIds: new Set(),
+            deleteTaskIds: new Set(),
+            currentInitiativeIds: new Set(),
+            currentInitiativeWatermarks: new Map(),
+            currentWorkstreamIds: new Set(),
+            currentWorkstreamWatermarks: new Map(),
+            currentAiProfileIds: new Set(),
+            currentAiProfileWatermarks: new Map(),
+            currentDocumentPaths: new Set(),
+            deleteDocumentPaths: new Set(),
+            currentDocumentWatermarks: new Map(),
+            currentAssetPaths: new Set(),
+            deleteAssetPaths: new Set(),
+            currentAssetWatermarks: new Map(),
+            currentDocumentReviewSessionIds: new Set(),
+            deleteDocumentReviewSessionIds: new Set(),
+            currentDocumentReviewSessionWatermarks: new Map(),
+            currentDocumentReviewCommentIds: new Set(),
+            deleteDocumentReviewCommentIds: new Set(),
+            currentDocumentReviewCommentWatermarks: new Map(),
+            currentAnnotatedAttachmentSessionIds: new Set(),
+            deleteAnnotatedAttachmentSessionIds: new Set(),
+            currentAnnotatedAttachmentSessionWatermarks: new Map(),
+            currentTaskEventWatermarks: new Map(),
+            pushedWatermarks: new Map(),
+            emittedEventIds: [],
+            appliedTaskUpserts: []
+        });
+        const payloadDiagnostics = {
+            totalChanges: 3,
+            byOp: { 'document-upsert': 2, 'asset-upsert': 1 },
+            baselineResetReason: 'repair-reset',
+            domains: {
+                tasks: { mode: 'none', reason: null, currentCount: 0, baselineCount: 0, changeCount: 0 },
+                initiatives: { mode: 'none', reason: null, currentCount: 0, baselineCount: 0, changeCount: 0 },
+                workstreams: { mode: 'none', reason: null, currentCount: 0, baselineCount: 0, changeCount: 0 },
+                aiProfiles: { mode: 'none', reason: null, currentCount: 0, baselineCount: 0, changeCount: 0 },
+                documents: { mode: 'send-all', reason: 'repair-reset', currentCount: 2, baselineCount: 0, changeCount: 2 },
+                assets: { mode: 'send-all', reason: 'repair-reset', currentCount: 1, baselineCount: 0, changeCount: 1 },
+                documentReviewSessions: { mode: 'none', reason: null, currentCount: 0, baselineCount: 0, changeCount: 0 },
+                documentReviewComments: { mode: 'none', reason: null, currentCount: 0, baselineCount: 0, changeCount: 0 },
+                annotatedAttachmentSessions: { mode: 'none', reason: null, currentCount: 0, baselineCount: 0, changeCount: 0 },
+                taskEvents: { mode: 'none', reason: null, currentCount: 0, baselineCount: 0, changeCount: 0 },
+                taxonomy: { mode: 'none', reason: null, currentCount: 0, baselineCount: 0, changeCount: 0 }
+            }
+        };
+        const buildWorkspaceSyncPayload = vi.fn(() => ({
+            changes: [],
+            currentTaskIds: new Set(),
+            deleteTaskIds: new Set(),
+            currentInitiativeIds: new Set(),
+            currentInitiativeWatermarks: new Map(),
+            currentWorkstreamIds: new Set(),
+            currentWorkstreamWatermarks: new Map(),
+            currentAiProfileIds: new Set(),
+            currentAiProfileWatermarks: new Map(),
+            currentDocumentPaths: new Set(),
+            deleteDocumentPaths: new Set(),
+            currentDocumentWatermarks: new Map(),
+            currentAssetPaths: new Set(),
+            deleteAssetPaths: new Set(),
+            currentAssetWatermarks: new Map(),
+            currentDocumentReviewSessionIds: new Set(),
+            deleteDocumentReviewSessionIds: new Set(),
+            currentDocumentReviewSessionWatermarks: new Map(),
+            currentDocumentReviewCommentIds: new Set(),
+            deleteDocumentReviewCommentIds: new Set(),
+            currentDocumentReviewCommentWatermarks: new Map(),
+            currentAnnotatedAttachmentSessionIds: new Set(),
+            deleteAnnotatedAttachmentSessionIds: new Set(),
+            currentAnnotatedAttachmentSessionWatermarks: new Map(),
+            currentTaskEventWatermarks: new Map(),
+            pushedWatermarks: new Map(),
+            deltaDiagnostics: payloadDiagnostics
+        }));
+        const { coordinator, reportSyncEvent } = createCoordinator({ buildWorkspaceSyncPayload });
+        await coordinator.pushWorkspaceChangesToCloud('signature-1');
+        expect(buildWorkspaceSyncPayload).toHaveBeenCalled();
+        expect(reportSyncEvent).toHaveBeenCalledWith('workspace-local-active', expect.objectContaining({
+            eventType: 'push',
+            status: 'error',
+            details: expect.objectContaining({
+                payloadDiagnostics
+            })
+        }));
+    });
+    it('replays the same payload after a transient push failure before rebuilding a fresh one', async () => {
+        const firstPayload = {
+            changes: [],
+            currentTaskIds: new Set(),
+            deleteTaskIds: new Set(),
+            currentInitiativeIds: new Set(),
+            currentInitiativeWatermarks: new Map(),
+            currentWorkstreamIds: new Set(),
+            currentWorkstreamWatermarks: new Map(),
+            currentAiProfileIds: new Set(),
+            currentAiProfileWatermarks: new Map(),
+            currentDocumentPaths: new Set(),
+            deleteDocumentPaths: new Set(),
+            currentDocumentWatermarks: new Map(),
+            currentAssetPaths: new Set(),
+            deleteAssetPaths: new Set(),
+            currentAssetWatermarks: new Map(),
+            currentDocumentReviewSessionIds: new Set(),
+            deleteDocumentReviewSessionIds: new Set(),
+            currentDocumentReviewSessionWatermarks: new Map(),
+            currentDocumentReviewCommentIds: new Set(),
+            deleteDocumentReviewCommentIds: new Set(),
+            currentDocumentReviewCommentWatermarks: new Map(),
+            currentAnnotatedAttachmentSessionIds: new Set(),
+            deleteAnnotatedAttachmentSessionIds: new Set(),
+            currentAnnotatedAttachmentSessionWatermarks: new Map(),
+            currentTaskEventWatermarks: new Map(),
+            pushedWatermarks: new Map()
+        };
+        const secondPayload = {
+            ...firstPayload,
+            deltaDiagnostics: {
+                totalChanges: 9,
+                byOp: { 'task-upsert': 9 },
+                baselineResetReason: 'missing-baseline',
+                domains: {
+                    tasks: { mode: 'delta', reason: null, currentCount: 9, baselineCount: 8, changeCount: 1 },
+                    initiatives: { mode: 'none', reason: null, currentCount: 0, baselineCount: 0, changeCount: 0 },
+                    workstreams: { mode: 'none', reason: null, currentCount: 0, baselineCount: 0, changeCount: 0 },
+                    aiProfiles: { mode: 'none', reason: null, currentCount: 0, baselineCount: 0, changeCount: 0 },
+                    documents: { mode: 'none', reason: null, currentCount: 0, baselineCount: 0, changeCount: 0 },
+                    assets: { mode: 'none', reason: null, currentCount: 0, baselineCount: 0, changeCount: 0 },
+                    documentReviewSessions: { mode: 'none', reason: null, currentCount: 0, baselineCount: 0, changeCount: 0 },
+                    documentReviewComments: { mode: 'none', reason: null, currentCount: 0, baselineCount: 0, changeCount: 0 },
+                    annotatedAttachmentSessions: { mode: 'none', reason: null, currentCount: 0, baselineCount: 0, changeCount: 0 },
+                    taskEvents: { mode: 'none', reason: null, currentCount: 0, baselineCount: 0, changeCount: 0 },
+                    taxonomy: { mode: 'none', reason: null, currentCount: 0, baselineCount: 0, changeCount: 0 }
+                }
+            }
+        };
+        const buildWorkspaceSyncPayload = vi.fn()
+            .mockReturnValueOnce(firstPayload)
+            .mockReturnValueOnce(secondPayload);
+        runWorkspacePushSyncServiceMock
+            .mockResolvedValueOnce({
+            success: false,
+            status: 524,
+            error: '524 unknown',
+            transient: true,
+            requestMs: 125000,
+            changeCount: 1,
+            deleteCount: 0,
+            currentTaskIds: new Set(),
+            deleteTaskIds: new Set(),
+            currentInitiativeIds: new Set(),
+            currentInitiativeWatermarks: new Map(),
+            currentWorkstreamIds: new Set(),
+            currentWorkstreamWatermarks: new Map(),
+            currentAiProfileIds: new Set(),
+            currentAiProfileWatermarks: new Map(),
+            currentDocumentPaths: new Set(),
+            deleteDocumentPaths: new Set(),
+            currentDocumentWatermarks: new Map(),
+            currentAssetPaths: new Set(),
+            deleteAssetPaths: new Set(),
+            currentAssetWatermarks: new Map(),
+            currentDocumentReviewSessionIds: new Set(),
+            deleteDocumentReviewSessionIds: new Set(),
+            currentDocumentReviewSessionWatermarks: new Map(),
+            currentDocumentReviewCommentIds: new Set(),
+            deleteDocumentReviewCommentIds: new Set(),
+            currentDocumentReviewCommentWatermarks: new Map(),
+            currentAnnotatedAttachmentSessionIds: new Set(),
+            deleteAnnotatedAttachmentSessionIds: new Set(),
+            currentAnnotatedAttachmentSessionWatermarks: new Map(),
+            currentTaskEventWatermarks: new Map(),
+            pushedWatermarks: new Map(),
+            emittedEventIds: [],
+            appliedTaskUpserts: []
+        })
+            .mockResolvedValueOnce({
+            success: true,
+            syncedAt: '2026-04-21T12:00:00.000Z',
+            requestMs: 200,
+            changeCount: 1,
+            deleteCount: 0,
+            currentTaskIds: new Set(['task-1']),
+            deleteTaskIds: new Set(),
+            currentInitiativeIds: new Set(),
+            currentInitiativeWatermarks: new Map(),
+            currentWorkstreamIds: new Set(),
+            currentWorkstreamWatermarks: new Map(),
+            currentAiProfileIds: new Set(),
+            currentAiProfileWatermarks: new Map(),
+            currentDocumentPaths: new Set(),
+            currentDocumentWatermarks: new Map(),
+            currentAssetPaths: new Set(),
+            currentAssetWatermarks: new Map(),
+            currentDocumentReviewSessionIds: new Set(),
+            currentDocumentReviewSessionWatermarks: new Map(),
+            currentDocumentReviewCommentIds: new Set(),
+            currentDocumentReviewCommentWatermarks: new Map(),
+            currentAnnotatedAttachmentSessionIds: new Set(),
+            currentAnnotatedAttachmentSessionWatermarks: new Map(),
+            currentTaskEventWatermarks: new Map(),
+            pushedWatermarks: new Map([['task-1', '2026-04-21T12:00:00.000Z']]),
+            emittedEventIds: [],
+            appliedTaskUpserts: []
+        });
+        const { coordinator, workspacePendingPushReplayRef, reportSyncEvent } = createCoordinator({ buildWorkspaceSyncPayload });
+        const firstResult = await coordinator.pushWorkspaceChangesToCloud('signature-1');
+        const secondResult = await coordinator.pushWorkspaceChangesToCloud('signature-1');
+        expect(firstResult).toBe(false);
+        expect(secondResult).toBe(true);
+        expect(buildWorkspaceSyncPayload).toHaveBeenCalledTimes(1);
+        expect(runWorkspacePushSyncServiceMock.mock.calls[0]?.[0]?.payload).toBe(firstPayload);
+        expect(runWorkspacePushSyncServiceMock.mock.calls[1]?.[0]?.payload).toBe(firstPayload);
+        expect(workspacePendingPushReplayRef.current).toBeNull();
+        expect(reportSyncEvent).toHaveBeenLastCalledWith('workspace-local-active', expect.objectContaining({
+            eventType: 'push',
+            status: 'success',
+            details: expect.objectContaining({
+                replayedPayload: true
+            })
+        }));
+    });
+    it('rebuilds a transient replay payload when refreshed sync state changes the signature before retry', async () => {
+        const stalePayload = {
+            changes: [{
+                    op: 'workstream-upsert',
+                    workstream: {
+                        id: 'workstream-1',
+                        referenceNumber: 701,
+                        title: 'Stale workstream',
+                        description: null,
+                        ownerId: null,
+                        initiativeId: null,
+                        createdAt: '2026-04-21T12:00:00.000Z',
+                        updatedAt: '2026-04-21T12:00:00.000Z',
+                        order: null,
+                        attachments: [],
+                        isArchived: false
+                    }
+                }],
+            currentTaskIds: new Set(),
+            deleteTaskIds: new Set(),
+            currentInitiativeIds: new Set(),
+            currentInitiativeWatermarks: new Map(),
+            currentWorkstreamIds: new Set(['workstream-1']),
+            currentWorkstreamWatermarks: new Map([['workstream-1', '2026-04-21T12:00:00.000Z']]),
+            currentAiProfileIds: new Set(),
+            currentAiProfileWatermarks: new Map(),
+            currentDocumentPaths: new Set(),
+            deleteDocumentPaths: new Set(),
+            currentDocumentWatermarks: new Map(),
+            currentAssetPaths: new Set(),
+            deleteAssetPaths: new Set(),
+            currentAssetWatermarks: new Map(),
+            currentDocumentReviewSessionIds: new Set(),
+            deleteDocumentReviewSessionIds: new Set(),
+            currentDocumentReviewSessionWatermarks: new Map(),
+            currentDocumentReviewCommentIds: new Set(),
+            deleteDocumentReviewCommentIds: new Set(),
+            currentDocumentReviewCommentWatermarks: new Map(),
+            currentAnnotatedAttachmentSessionIds: new Set(),
+            deleteAnnotatedAttachmentSessionIds: new Set(),
+            currentAnnotatedAttachmentSessionWatermarks: new Map(),
+            currentTaskEventWatermarks: new Map(),
+            pushedWatermarks: new Map()
+        };
+        const refreshedPayload = {
+            ...stalePayload,
+            changes: [{
+                    op: 'workstream-upsert',
+                    workstream: {
+                        id: 'workstream-1',
+                        referenceNumber: 701,
+                        title: 'Stale workstream',
+                        description: null,
+                        ownerId: null,
+                        initiativeId: null,
+                        createdAt: '2026-04-21T12:00:00.000Z',
+                        updatedAt: '2026-04-21T12:00:05.000Z',
+                        order: null,
+                        attachments: [{
+                                path: '/api/taskforce/documents/asset-doc-1/content',
+                                fsPath: 'workspaces/workspace-local-active/assets/documents/doc-1.md',
+                                assetId: 'asset-doc-1',
+                                caption: 'Plan',
+                                timestamp: '2026-04-21T12:00:05.000Z'
+                            }],
+                        isArchived: false
+                    }
+                }],
+            currentWorkstreamWatermarks: new Map([['workstream-1', '2026-04-21T12:00:05.000Z']])
+        };
+        const buildWorkspaceSyncPayload = vi.fn()
+            .mockReturnValueOnce(stalePayload)
+            .mockReturnValueOnce(refreshedPayload);
+        const buildWorkspaceSyncSignature = vi.fn()
+            .mockReturnValueOnce('signature-stale')
+            .mockReturnValueOnce('signature-fresh')
+            .mockReturnValue('signature-fresh');
+        runWorkspacePushSyncServiceMock
+            .mockResolvedValueOnce({
+            success: false,
+            status: 524,
+            error: '524 unknown',
+            transient: true,
+            requestMs: 125000,
+            changeCount: 1,
+            deleteCount: 0,
+            currentTaskIds: new Set(),
+            deleteTaskIds: new Set(),
+            currentInitiativeIds: new Set(),
+            currentInitiativeWatermarks: new Map(),
+            currentWorkstreamIds: new Set(['workstream-1']),
+            currentWorkstreamWatermarks: new Map([['workstream-1', '2026-04-21T12:00:00.000Z']]),
+            currentAiProfileIds: new Set(),
+            currentAiProfileWatermarks: new Map(),
+            currentDocumentPaths: new Set(),
+            deleteDocumentPaths: new Set(),
+            currentDocumentWatermarks: new Map(),
+            currentAssetPaths: new Set(),
+            deleteAssetPaths: new Set(),
+            currentAssetWatermarks: new Map(),
+            currentDocumentReviewSessionIds: new Set(),
+            currentDocumentReviewSessionWatermarks: new Map(),
+            currentDocumentReviewCommentIds: new Set(),
+            currentDocumentReviewCommentWatermarks: new Map(),
+            currentAnnotatedAttachmentSessionIds: new Set(),
+            currentAnnotatedAttachmentSessionWatermarks: new Map(),
+            currentTaskEventWatermarks: new Map(),
+            pushedWatermarks: new Map(),
+            emittedEventIds: [],
+            appliedTaskUpserts: []
+        })
+            .mockResolvedValueOnce({
+            success: true,
+            syncedAt: '2026-04-21T12:00:10.000Z',
+            requestMs: 200,
+            changeCount: 1,
+            deleteCount: 0,
+            currentTaskIds: new Set(),
+            deleteTaskIds: new Set(),
+            currentInitiativeIds: new Set(),
+            currentInitiativeWatermarks: new Map(),
+            currentWorkstreamIds: new Set(['workstream-1']),
+            currentWorkstreamWatermarks: new Map([['workstream-1', '2026-04-21T12:00:05.000Z']]),
+            currentAiProfileIds: new Set(),
+            currentAiProfileWatermarks: new Map(),
+            currentDocumentPaths: new Set(),
+            currentDocumentWatermarks: new Map(),
+            currentAssetPaths: new Set(),
+            currentAssetWatermarks: new Map(),
+            currentDocumentReviewSessionIds: new Set(),
+            currentDocumentReviewSessionWatermarks: new Map(),
+            currentDocumentReviewCommentIds: new Set(),
+            currentDocumentReviewCommentWatermarks: new Map(),
+            currentAnnotatedAttachmentSessionIds: new Set(),
+            currentAnnotatedAttachmentSessionWatermarks: new Map(),
+            currentTaskEventWatermarks: new Map(),
+            pushedWatermarks: new Map(),
+            emittedEventIds: [],
+            appliedTaskUpserts: []
+        });
+        const { coordinator, reportSyncEvent } = createCoordinator({
+            buildWorkspaceSyncPayload,
+            buildWorkspaceSyncSignature
+        });
+        const firstResult = await coordinator.pushWorkspaceChangesToCloud('signature-stale');
+        const secondResult = await coordinator.pushWorkspaceChangesToCloud('signature-stale');
+        expect(firstResult).toBe(false);
+        expect(secondResult).toBe(true);
+        expect(buildWorkspaceSyncPayload).toHaveBeenCalledTimes(2);
+        expect(runWorkspacePushSyncServiceMock.mock.calls[0]?.[0]?.payload).toBe(stalePayload);
+        expect(runWorkspacePushSyncServiceMock.mock.calls[1]?.[0]?.payload).toBe(refreshedPayload);
+        expect(reportSyncEvent).toHaveBeenLastCalledWith('workspace-local-active', expect.objectContaining({
+            eventType: 'push',
+            status: 'success',
+            details: expect.objectContaining({
+                replayedPayload: false
+            })
+        }));
+    });
+    it('rebuilds a transient replay payload when a later retry forces all AI profiles', async () => {
+        const firstPayload = {
+            changes: [],
+            currentTaskIds: new Set(),
+            deleteTaskIds: new Set(),
+            currentInitiativeIds: new Set(),
+            currentInitiativeWatermarks: new Map(),
+            currentWorkstreamIds: new Set(),
+            currentWorkstreamWatermarks: new Map(),
+            currentAiProfileIds: new Set(),
+            currentAiProfileWatermarks: new Map(),
+            currentDocumentPaths: new Set(),
+            deleteDocumentPaths: new Set(),
+            currentDocumentWatermarks: new Map(),
+            currentAssetPaths: new Set(),
+            deleteAssetPaths: new Set(),
+            currentAssetWatermarks: new Map(),
+            currentDocumentReviewSessionIds: new Set(),
+            deleteDocumentReviewSessionIds: new Set(),
+            currentDocumentReviewSessionWatermarks: new Map(),
+            currentDocumentReviewCommentIds: new Set(),
+            deleteDocumentReviewCommentIds: new Set(),
+            currentDocumentReviewCommentWatermarks: new Map(),
+            currentAnnotatedAttachmentSessionIds: new Set(),
+            deleteAnnotatedAttachmentSessionIds: new Set(),
+            currentAnnotatedAttachmentSessionWatermarks: new Map(),
+            currentTaskEventWatermarks: new Map(),
+            pushedWatermarks: new Map()
+        };
+        const forcedAiProfilePayload = {
+            ...firstPayload,
+            changes: [{
+                    op: 'ai-profile-upsert',
+                    profile: {
+                        id: 'ai-profile-codex',
+                        workspaceId: 'workspace-local-active',
+                        profileToken: 'tfp_codex',
+                        name: 'Codex',
+                        username: 'codex',
+                        icon: 'Bot',
+                        color: '#8b5cf6',
+                        avatarUrl: null,
+                        avatarSourceUrl: null,
+                        description: null,
+                        role: null,
+                        provider: null,
+                        model: null,
+                        surfaceType: null,
+                        seatScope: 'cloud_metered',
+                        providerMetadata: null,
+                        archivedAt: null,
+                        archivedBy: null,
+                        archivedReason: null,
+                        mergedIntoProfileId: null,
+                        rosterStateUpdatedAt: '2026-04-21T12:00:00.000Z',
+                        createdAt: '2026-04-21T12:00:00.000Z',
+                        updatedAt: '2026-04-21T12:00:00.000Z',
+                        lastActiveAt: null
+                    }
+                }],
+            currentAiProfileIds: new Set(['ai-profile-codex']),
+            currentAiProfileWatermarks: new Map([['ai-profile-codex', '2026-04-21T12:00:00.000Z']]),
+            currentAiProfileChangeKeys: new Map([['ai-profile-codex', 'codex-change-key']])
+        };
+        const buildWorkspaceSyncPayload = vi.fn()
+            .mockReturnValueOnce(firstPayload)
+            .mockReturnValueOnce(forcedAiProfilePayload);
+        runWorkspacePushSyncServiceMock
+            .mockResolvedValueOnce({
+            success: false,
+            status: 524,
+            error: '524 unknown',
+            transient: true,
+            requestMs: 125000,
+            changeCount: 0,
+            deleteCount: 0,
+            currentTaskIds: new Set(),
+            deleteTaskIds: new Set(),
+            currentInitiativeIds: new Set(),
+            currentInitiativeWatermarks: new Map(),
+            currentWorkstreamIds: new Set(),
+            currentWorkstreamWatermarks: new Map(),
+            currentAiProfileIds: new Set(),
+            currentAiProfileWatermarks: new Map(),
+            currentDocumentPaths: new Set(),
+            deleteDocumentPaths: new Set(),
+            currentDocumentWatermarks: new Map(),
+            currentAssetPaths: new Set(),
+            deleteAssetPaths: new Set(),
+            currentAssetWatermarks: new Map(),
+            currentDocumentReviewSessionIds: new Set(),
+            deleteDocumentReviewSessionIds: new Set(),
+            currentDocumentReviewSessionWatermarks: new Map(),
+            currentDocumentReviewCommentIds: new Set(),
+            deleteDocumentReviewCommentIds: new Set(),
+            currentDocumentReviewCommentWatermarks: new Map(),
+            currentAnnotatedAttachmentSessionIds: new Set(),
+            deleteAnnotatedAttachmentSessionIds: new Set(),
+            currentAnnotatedAttachmentSessionWatermarks: new Map(),
+            currentTaskEventWatermarks: new Map(),
+            pushedWatermarks: new Map(),
+            emittedEventIds: [],
+            appliedTaskUpserts: []
+        })
+            .mockResolvedValueOnce({
+            success: true,
+            syncedAt: '2026-04-21T12:00:00.000Z',
+            requestMs: 200,
+            changeCount: 1,
+            deleteCount: 0,
+            currentTaskIds: new Set(),
+            currentTaskWatermarks: new Map(),
+            currentTaskChangeKeys: new Map(),
+            deleteTaskIds: new Set(),
+            currentInitiativeIds: new Set(),
+            currentInitiativeWatermarks: new Map(),
+            currentWorkstreamIds: new Set(),
+            currentWorkstreamWatermarks: new Map(),
+            currentAiProfileIds: new Set(['ai-profile-codex']),
+            currentAiProfileWatermarks: new Map([['ai-profile-codex', '2026-04-21T12:00:00.000Z']]),
+            currentAiProfileChangeKeys: new Map([['ai-profile-codex', 'codex-change-key']]),
+            currentDocumentPaths: new Set(),
+            currentDocumentWatermarks: new Map(),
+            currentAssetPaths: new Set(),
+            currentAssetWatermarks: new Map(),
+            currentDocumentReviewSessionIds: new Set(),
+            currentDocumentReviewSessionWatermarks: new Map(),
+            currentDocumentReviewCommentIds: new Set(),
+            currentDocumentReviewCommentWatermarks: new Map(),
+            currentAnnotatedAttachmentSessionIds: new Set(),
+            currentAnnotatedAttachmentSessionWatermarks: new Map(),
+            currentTaskEventWatermarks: new Map(),
+            pushedWatermarks: new Map(),
+            emittedEventIds: [],
+            appliedTaskUpserts: []
+        });
+        const { coordinator } = createCoordinator({ buildWorkspaceSyncPayload });
+        const firstResult = await coordinator.pushWorkspaceChangesToCloud('signature-1');
+        const secondResult = await coordinator.pushWorkspaceChangesToCloud('signature-1', { forceAllAiProfiles: true });
+        expect(firstResult).toBe(false);
+        expect(secondResult).toBe(true);
+        expect(buildWorkspaceSyncPayload).toHaveBeenCalledTimes(2);
+        expect(buildWorkspaceSyncPayload).toHaveBeenNthCalledWith(1, { forceAllAiProfiles: false });
+        expect(buildWorkspaceSyncPayload).toHaveBeenNthCalledWith(2, { forceAllAiProfiles: true });
+        expect(runWorkspacePushSyncServiceMock.mock.calls[0]?.[0]?.payload).toBe(firstPayload);
+        expect(runWorkspacePushSyncServiceMock.mock.calls[1]?.[0]?.payload).toBe(forcedAiProfilePayload);
+    });
+});