@taskforcehq/taskforce 0.3.306 → 0.3.308

package/dist/core/Taskforce.mcpAuth.test.js

@@ -289,6 +289,82 @@ describe('TaskforceCore MCP auth invalidation', () => {
             cleanup();
         }
     });
+    it('does not delete active MCP access tokens', () => {
+        const { core, cleanup } = makeCore();
+        try {
+            setupWorkspace(core, 'owner-1', 'workspace-1');
+            const issued = core.createMcpAccessToken({
+                userId: 'owner-1',
+                workspaceId: 'workspace-1',
+                name: 'Active Token',
+                scopes: ['tasks:read']
+            });
+            expect(() => core.deleteMcpAccessToken({
+                actorUserId: 'owner-1',
+                workspaceId: 'workspace-1',
+                tokenId: issued.record.id
+            })).toThrow('Active MCP tokens must be revoked before deletion');
+            expect(core.listMcpAccessTokens({ userId: 'owner-1', workspaceId: 'workspace-1' }).items).toHaveLength(1);
+        }
+        finally {
+            cleanup();
+        }
+    });
+    it('deletes revoked MCP access token records', () => {
+        const { core, cleanup } = makeCore();
+        try {
+            setupWorkspace(core, 'owner-1', 'workspace-1');
+            const issued = core.createMcpAccessToken({
+                userId: 'owner-1',
+                workspaceId: 'workspace-1',
+                name: 'Revoked Token',
+                scopes: ['tasks:read']
+            });
+            core.revokeMcpAccessToken({
+                actorUserId: 'owner-1',
+                workspaceId: 'workspace-1',
+                tokenId: issued.record.id
+            });
+            expect(core.deleteMcpAccessToken({
+                actorUserId: 'owner-1',
+                workspaceId: 'workspace-1',
+                tokenId: issued.record.id
+            })).toBe(true);
+            expect(core.listMcpAccessTokens({ userId: 'owner-1', workspaceId: 'workspace-1' }).items).toHaveLength(0);
+            expect(core.authenticateMcpAccessToken(issued.token)).toBeNull();
+        }
+        finally {
+            cleanup();
+        }
+    });
+    it('deletes expired MCP access token records', () => {
+        const { core, cleanup } = makeCore();
+        try {
+            setupWorkspace(core, 'owner-1', 'workspace-1');
+            const issued = core.createMcpAccessToken({
+                userId: 'owner-1',
+                workspaceId: 'workspace-1',
+                name: 'Expired Token',
+                scopes: ['tasks:read'],
+                expiresAt: new Date(Date.now() + 60_000).toISOString()
+            });
+            core.db.prepare(`
+                UPDATE mcp_access_tokens
+                SET expires_at = ?
+                WHERE tenant_id = ? AND id = ?
+            `).run(new Date(Date.now() - 60_000).toISOString(), 'default', issued.record.id);
+            expect(core.listMcpAccessTokens({ userId: 'owner-1', workspaceId: 'workspace-1' }).items[0]?.status).toBe('expired');
+            expect(core.deleteMcpAccessToken({
+                actorUserId: 'owner-1',
+                workspaceId: 'workspace-1',
+                tokenId: issued.record.id
+            })).toBe(true);
+            expect(core.listMcpAccessTokens({ userId: 'owner-1', workspaceId: 'workspace-1' }).items).toHaveLength(0);
+        }
+        finally {
+            cleanup();
+        }
+    });
     it('denies OAuth authentication after the authorized member is disabled', () => {
         const { core, cleanup } = makeCore();
         try {
@@ -308,6 +384,39 @@ describe('TaskforceCore MCP auth invalidation', () => {
             cleanup();
         }
     });
+    it('returns persisted AI profile binding on OAuth connector authentication', () => {
+        const { core, cleanup } = makeCore();
+        try {
+            setupWorkspace(core, 'owner-1', 'workspace-1');
+            const accessToken = createOauthGrantToken(core, 'owner-1', 'workspace-1');
+            const auth = core.authenticateMcpOAuthAccessToken(accessToken);
+            expect(auth?.aiProfileToken).toBeFalsy();
+            const resolved = core.resolveAiProfile({
+                workspaceId: 'workspace-1',
+                name: 'Codex Connector',
+                icon: 'Code',
+                color: '#0ea5e9',
+            }, {
+                trustedSeatScope: 'cloud_metered',
+            });
+            expect(core.bindMcpOAuthConnectorGrantAiProfile({
+                grantId: auth.grantId,
+                workspaceId: 'workspace-1',
+                profileId: resolved.profile.id,
+                profileToken: resolved.profile.profileToken,
+                profileName: resolved.profile.name,
+            })).toBe(true);
+            expect(core.authenticateMcpOAuthAccessToken(accessToken)).toEqual(expect.objectContaining({
+                grantId: auth.grantId,
+                aiProfileId: resolved.profile.id,
+                aiProfileToken: resolved.profile.profileToken,
+                aiProfileName: 'Codex Connector',
+            }));
+        }
+        finally {
+            cleanup();
+        }
+    });
     it('denies OAuth authentication after account access is suspended', () => {
         const { core, cleanup } = makeCore();
         try {

package/dist/core/types.d.ts

@@ -275,6 +275,11 @@ export interface GlobalTaskforceSettings {
     site?: {
         showRunTaskforceLocally?: boolean;
         pricingPageEnabled?: boolean;
+        animatedBackgroundEnabled?: boolean;
+        siteTheme?: 'dark' | 'light';
+        pricingPageTitle?: string;
+        pricingPageDescription?: string;
+        pricingPageShowPublicDescriptions?: boolean;
     };
     setup?: {
         mode?: 'core' | 'operations';
@@ -505,8 +510,10 @@ export interface PlanFeatureCatalogItem {
     featureKey: string;
     label: string;
     description: string;
+    isCustom?: boolean;
     publicLabel?: string | null;
     publicDescription?: string | null;
+    publicDescriptionVisible?: boolean | null;
     publicDisplayOrder?: number | null;
     allowedAccessModes: PlanFeatureAccess[];
     configTemplate: Record<string, unknown>;
@@ -678,4 +685,7 @@ export interface McpOAuthAccessTokenAuthResult {
     provider: McpOAuthProvider;
     scopes: McpAccessTokenScope[];
     status: McpOAuthGrantStatus;
+    aiProfileId?: string | null;
+    aiProfileToken?: string | null;
+    aiProfileName?: string | null;
 }

package/dist/hooks/auth/useTaskforceAuthBootstrap.js

@@ -2,6 +2,7 @@ import { useCallback, useEffect } from 'react';
 import { createDefaultAssigneeOptions } from '../../utils/assignees';
 import { logBootstrapDebug } from '../workspace/workspaceLocalState';
 import { persistLocalMutationActorUserId, readLocalMutationActorUserId } from '../../utils/taskforceApiClient';
+import { AUTH_SESSION_REQUEST_TIMEOUT_MS } from '../bootstrapTimeouts';
 function getBootstrapTimestamp() {
     return typeof performance !== 'undefined' ? performance.now() : Date.now();
 }
@@ -48,7 +49,7 @@ export function useTaskforceAuthBootstrap({ runtimeConfigReady, shouldProbeCloud
             const startedAt = getBootstrapTimestamp();
             const abortController = new AbortController();
             const timeoutId = typeof window !== 'undefined'
-                ? window.setTimeout(() => abortController.abort(), 8000)
+                ? window.setTimeout(() => abortController.abort(), AUTH_SESSION_REQUEST_TIMEOUT_MS)
                 : null;
             const isStaleRequest = () => authSessionEpochRef.current !== requestEpoch;
             const logResult = (event, details) => {

package/dist/hooks/bootstrapTimeouts.d.ts

@@ -0,0 +1,4 @@
+export declare const BOOTSTRAP_REQUEST_TIMEOUT_MS = 12000;
+export declare const CLOUD_BOOTSTRAP_REQUEST_TIMEOUT_MS = 30000;
+export declare const AUTH_SESSION_REQUEST_TIMEOUT_MS = 20000;
+export declare function resolveBootstrapRequestTimeoutMs(runtimeMode: 'local' | 'cloud'): number;

package/dist/hooks/bootstrapTimeouts.js

@@ -0,0 +1,8 @@
+export const BOOTSTRAP_REQUEST_TIMEOUT_MS = 12_000;
+export const CLOUD_BOOTSTRAP_REQUEST_TIMEOUT_MS = 30_000;
+export const AUTH_SESSION_REQUEST_TIMEOUT_MS = 20_000;
+export function resolveBootstrapRequestTimeoutMs(runtimeMode) {
+    return runtimeMode === 'cloud'
+        ? CLOUD_BOOTSTRAP_REQUEST_TIMEOUT_MS
+        : BOOTSTRAP_REQUEST_TIMEOUT_MS;
+}

package/dist/hooks/bootstrapTimeouts.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/hooks/bootstrapTimeouts.test.js

@@ -0,0 +1,12 @@
+import { describe, expect, it } from 'vitest';
+import { AUTH_SESSION_REQUEST_TIMEOUT_MS, BOOTSTRAP_REQUEST_TIMEOUT_MS, CLOUD_BOOTSTRAP_REQUEST_TIMEOUT_MS, resolveBootstrapRequestTimeoutMs } from './bootstrapTimeouts';
+describe('bootstrap timeout budgets', () => {
+    it('keeps local bootstrap checks short', () => {
+        expect(resolveBootstrapRequestTimeoutMs('local')).toBe(BOOTSTRAP_REQUEST_TIMEOUT_MS);
+    });
+    it('gives cloud bootstrap checks enough room for edge delays', () => {
+        expect(resolveBootstrapRequestTimeoutMs('cloud')).toBe(CLOUD_BOOTSTRAP_REQUEST_TIMEOUT_MS);
+        expect(CLOUD_BOOTSTRAP_REQUEST_TIMEOUT_MS).toBeGreaterThan(BOOTSTRAP_REQUEST_TIMEOUT_MS);
+        expect(AUTH_SESSION_REQUEST_TIMEOUT_MS).toBeGreaterThan(BOOTSTRAP_REQUEST_TIMEOUT_MS);
+    });
+});

package/dist/hooks/sync/orchestratorShared.d.ts

@@ -1,7 +1,7 @@
 import type { WorkspaceTaxonomyState } from '../../shared/taxonomyState.js';
-import type { WorkspaceSyncAiProfileSnapshot, WorkspaceSyncDocumentReviewCommentSnapshot, WorkspaceSyncDocumentReviewSessionSnapshot, WorkspaceSyncTaskEventSnapshot } from '../../sync/workspaceSyncModel';
+import type { WorkspaceSyncAiProfileSnapshot, WorkspaceSyncDocumentReviewCommentSnapshot, WorkspaceSyncDocumentReviewSessionSnapshot, WorkspaceSyncEntityEventSnapshot } from '../../sync/workspaceSyncModel';
 import type { WorkspaceSyncPushBaselineSnapshot } from '../../sync/workspaceSyncState.js';
-import type { TaskItem } from '../../types';
+import type { InitiativeItem, TaskItem, WorkstreamItem } from '../../types';
 export declare const USER_GLOBAL_SYNC_META_KEY = "taskforce.userGlobalSyncMeta.v1";
 export declare const SYNC_DEBUG_LOG_KEY = "taskforce.syncDebug.v1";
 export declare const WORKSPACE_BOOTSTRAP_TIMEOUT_MS = 120000;
@@ -19,7 +19,7 @@ export declare function writeUserGlobalSyncMeta(next: Record<string, {
 }>): void;
 export declare function buildTaxonomyStateFingerprint(taxonomyState?: WorkspaceTaxonomyState): string;
 export declare function flattenDocumentReviewComments(sessions: WorkspaceSyncDocumentReviewSessionSnapshot[]): WorkspaceSyncDocumentReviewCommentSnapshot[];
-export declare function flattenTaskEvents(tasks: TaskItem[], archivedTasks: TaskItem[]): WorkspaceSyncTaskEventSnapshot[];
+export declare function flattenTaskEvents(tasks: TaskItem[], archivedTasks: TaskItem[], initiatives?: InitiativeItem[], workstreams?: WorkstreamItem[]): WorkspaceSyncEntityEventSnapshot[];
 export interface PersistedSyncWatermarks {
     taskIds: Set<string>;
     taskWatermarks: Map<string, string>;

package/dist/hooks/sync/orchestratorShared.js

@@ -40,6 +40,8 @@ export function normalizeWorkspaceSyncAiProfileSnapshotEntry(entry) {
         color: String(entry?.color || '#8b5cf6').trim() || '#8b5cf6',
         avatarUrl: normalizeSyncSameOriginAssetUrl(entry?.avatarUrl ?? entry?.avatar_url),
         avatarSourceUrl: normalizeSyncSameOriginAssetUrl(entry?.avatarSourceUrl ?? entry?.avatar_source_url),
+        avatarRevision: Number.isFinite(Number(entry?.avatarRevision ?? entry?.avatar_revision)) ? Math.max(0, Math.floor(Number(entry?.avatarRevision ?? entry?.avatar_revision))) : 0,
+        avatarUpdatedAt: normalizeSyncNullableIsoString(entry?.avatarUpdatedAt ?? entry?.avatar_updated_at),
         description: normalizeSyncNullableString(entry?.description),
         role: normalizeSyncNullableString(entry?.role),
         provider: normalizeSyncNullableString(entry?.provider),
@@ -113,7 +115,7 @@ export function flattenDocumentReviewComments(sessions) {
             .filter((comment) => comment.id.length > 0 && comment.sessionId.length > 0);
     });
 }
-export function flattenTaskEvents(tasks, archivedTasks) {
+export function flattenTaskEvents(tasks, archivedTasks, initiatives = [], workstreams = []) {
     const deduped = new Map();
     for (const task of [...(tasks || []), ...(archivedTasks || [])]) {
         const taskEvents = Array.isArray(task?.taskEvents) ? task.taskEvents : [];
@@ -126,8 +128,66 @@ export function flattenTaskEvents(tasks, archivedTasks) {
                 continue;
             const nextEvent = {
                 id,
+                workspaceId,
+                entityType: 'task',
+                entityId: taskId,
                 taskId,
+                action: String(event?.action || '').trim(),
+                actor: String(event?.actor || 'system').trim() || 'system',
+                actorType: event?.actorType === 'ai' || event?.actorType === 'human' || event?.actorType === 'system'
+                    ? event.actorType
+                    : 'system',
+                details: event?.details,
+                createdAt,
+            };
+            const existing = deduped.get(id);
+            if (!existing || nextEvent.createdAt > existing.createdAt) {
+                deduped.set(id, nextEvent);
+            }
+        }
+    }
+    for (const initiative of initiatives || []) {
+        const entityEvents = Array.isArray(initiative?.entityEvents) ? initiative.entityEvents : [];
+        for (const event of entityEvents) {
+            const id = String(event?.id || '').trim();
+            const entityId = String(event?.entityId || initiative?.id || '').trim();
+            const workspaceId = String(event?.workspaceId || '').trim();
+            const createdAt = String(event?.createdAt || '').trim();
+            if (!id || !entityId || !workspaceId || !createdAt)
+                continue;
+            const nextEvent = {
+                id,
+                workspaceId,
+                entityType: 'initiative',
+                entityId,
+                action: String(event?.action || '').trim(),
+                actor: String(event?.actor || 'system').trim() || 'system',
+                actorType: event?.actorType === 'ai' || event?.actorType === 'human' || event?.actorType === 'system'
+                    ? event.actorType
+                    : 'system',
+                details: event?.details,
+                createdAt,
+            };
+            const existing = deduped.get(id);
+            if (!existing || nextEvent.createdAt > existing.createdAt) {
+                deduped.set(id, nextEvent);
+            }
+        }
+    }
+    for (const workstream of workstreams || []) {
+        const entityEvents = Array.isArray(workstream?.entityEvents) ? workstream.entityEvents : [];
+        for (const event of entityEvents) {
+            const id = String(event?.id || '').trim();
+            const entityId = String(event?.entityId || workstream?.id || '').trim();
+            const workspaceId = String(event?.workspaceId || '').trim();
+            const createdAt = String(event?.createdAt || '').trim();
+            if (!id || !entityId || !workspaceId || !createdAt)
+                continue;
+            const nextEvent = {
+                id,
                 workspaceId,
+                entityType: 'workstream',
+                entityId,
                 action: String(event?.action || '').trim(),
                 actor: String(event?.actor || 'system').trim() || 'system',
                 actorType: event?.actorType === 'ai' || event?.actorType === 'human' || event?.actorType === 'system'

package/dist/hooks/sync/recovery.js

@@ -10,6 +10,10 @@ function resetWorkspaceSyncStatePushBaselines(args) {
     args.workspaceLastPushedAiProfileIdsRef.current = new Set();
     args.workspaceLastPushedAiProfileWatermarksRef.current = new Map();
     args.workspaceLastPushedAiProfileChangeKeysRef.current = new Map();
+    args.workspaceLastPushedDocumentPathsRef.current = new Set();
+    args.workspaceLastPushedDocumentWatermarksRef.current = new Map();
+    args.workspaceLastPushedAssetPathsRef.current = new Set();
+    args.workspaceLastPushedAssetWatermarksRef.current = new Map();
     args.workspaceBaselineResetReasonRef.current = 'repair-reset';
 }
 function resetAllWorkspacePushBaselines(args) {
@@ -187,6 +191,10 @@ export function createSyncRecoveryCoordinator({ currentWorkspaceId, workspaceClo
                     workspaceLastPushedAiProfileIdsRef,
                     workspaceLastPushedAiProfileWatermarksRef,
                     workspaceLastPushedAiProfileChangeKeysRef,
+                    workspaceLastPushedDocumentPathsRef,
+                    workspaceLastPushedDocumentWatermarksRef,
+                    workspaceLastPushedAssetPathsRef,
+                    workspaceLastPushedAssetWatermarksRef,
                     workspaceBaselineResetReasonRef,
                 });
             }

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

@@ -168,7 +168,7 @@ describe('createSyncRecoveryCoordinator', () => {
         expect(args.workspaceBaselineResetReasonRef.current).toBeNull();
         expect(args.workspaceRepairModeRef.current).toBe(false);
     });
-    it('resets sync-state push baselines during active repair and preserves content baselines', async () => {
+    it('resets sync-state and content push baselines during active repair', async () => {
         const taskWatermarks = new Map([['task-1', '2026-03-15T17:00:00.000Z']]);
         const taskChangeKeys = new Map([['task-1', 'task-change-key-1']]);
         const initiativeWatermarks = new Map([['initiative-1', '2026-03-15T17:00:00.000Z']]);
@@ -213,8 +213,8 @@ describe('createSyncRecoveryCoordinator', () => {
         expect(args.workspaceLastPushedWorkstreamWatermarksRef.current.size).toBe(0);
         expect(args.workspaceLastPushedAiProfileWatermarksRef.current.size).toBe(0);
         expect(args.workspaceLastPushedAiProfileChangeKeysRef.current.size).toBe(0);
-        expect(args.workspaceLastPushedDocumentWatermarksRef.current).toBe(documentWatermarks);
-        expect(args.workspaceLastPushedAssetWatermarksRef.current).toBe(assetWatermarks);
+        expect(args.workspaceLastPushedDocumentWatermarksRef.current.size).toBe(0);
+        expect(args.workspaceLastPushedAssetWatermarksRef.current.size).toBe(0);
         expect(pullWorkspaceChangesFromCloud).toHaveBeenCalledWith({ repairMode: true });
         expect(pushWorkspaceChangesToCloud).toHaveBeenCalledWith('signature-1', {
             forceAllAiProfiles: true,
@@ -227,8 +227,8 @@ describe('createSyncRecoveryCoordinator', () => {
         expect(persisted?.workstreamWatermarks.size).toBe(0);
         expect(persisted?.aiProfileWatermarks.size).toBe(0);
         expect(persisted?.aiProfileChangeKeys?.size).toBe(0);
-        expect(persisted?.documentWatermarks.get('docs/spec.md')).toBe('2026-03-15T17:00:00.000Z');
-        expect(persisted?.assetWatermarks.get('assets/image.png')).toBe('2026-03-15T17:00:00.000Z');
+        expect(persisted?.documentWatermarks.size).toBe(0);
+        expect(persisted?.assetWatermarks.size).toBe(0);
         expect(persisted?.taskEventWatermarks.get('event-1')).toBe('2026-03-15T17:00:00.000Z');
     });
     it('does not push during attach-cloud repair', async () => {

package/dist/hooks/sync/transfers.d.ts

@@ -60,6 +60,7 @@ interface CreateWorkspaceTransferCoordinatorArgs {
     refreshWorkspaceSyncMarkdownDocumentsSnapshot: () => Promise<void>;
     refreshWorkspaceSyncAiProfilesSnapshot: () => Promise<void>;
     refreshWorkspaceSyncAssetsSnapshot: () => Promise<void>;
+    refreshWorkspaceSyncPlanningEntitiesSnapshot: () => Promise<void>;
     refreshWorkspaceSyncDocumentReviewSessionsSnapshot: () => Promise<void>;
     refreshWorkspaceSyncAnnotatedAttachmentSessionsSnapshot: () => Promise<void>;
     refreshLocalWorkspaceTaskCollections: () => Promise<void>;
@@ -122,7 +123,7 @@ interface CreateWorkspaceTransferCoordinatorArgs {
     setTasks: Dispatch<SetStateAction<any[]>>;
     setArchivedTasks: Dispatch<SetStateAction<any[]>>;
 }
-export declare function createWorkspaceTransferCoordinator({ cloudAuthConfigured, runtimeMode, workspaceCloudSyncEnabled, currentWorkspaceId, workspaceSyncPhase, isAuthenticated, checkAuthSession, resolveCloudAuthUrl, ensureCloudWorkspaceReadyForSync, ensureWorkspaceSyncReady, handleSyncAuthFailure, clearWorkspaceRetry, clearWorkspaceIssue, isWorkspaceRetryPending, scheduleWorkspaceSyncRetry, persistWorkspaceSyncPatchSafely, persistWorkspaceSyncPatchBestEffort, persistWorkspaceSyncWatermarksSnapshotBestEffort, reportSyncEvent, acquireWorkspaceSyncLease, releaseWorkspaceSyncLease, reportWorkspaceWindowContention, refreshWorkspaceSyncMarkdownDocumentsSnapshot, refreshWorkspaceSyncAiProfilesSnapshot, refreshWorkspaceSyncAssetsSnapshot, refreshWorkspaceSyncDocumentReviewSessionsSnapshot, refreshWorkspaceSyncAnnotatedAttachmentSessionsSnapshot, refreshLocalWorkspaceTaskCollections, buildWorkspaceSyncPayload, buildWorkspaceSyncSignature, seedWorkspaceSnapshotPushBaseline, shouldSuppressAttachBootstrapPush, recordSuppressedEventIds, workspaceRepairModeRef, workspaceForceFullAiProfilePushRef, workspacePushInFlightRef, workspacePullInFlightRef, workspacePendingPushReplayRef, workspaceLastPushedSignatureRef, workspacePendingSignatureRef, workspaceLastPushedTaskIdsRef, workspaceDeletedTaskIdsRef, workspaceDeletedTaskWatermarksRef, workspacePullCursorRef, workspaceLastPushedWatermarksRef, workspaceLastPushedTaskChangeKeysRef, workspaceLastPushedInitiativeIdsRef, workspaceLastPushedInitiativeWatermarksRef, workspaceLastPushedWorkstreamIdsRef, workspaceLastPushedWorkstreamWatermarksRef, workspaceLastPushedAiProfileIdsRef, workspaceLastPushedAiProfileWatermarksRef, workspaceLastPushedAiProfileChangeKeysRef, workspaceLastPushedDocumentPathsRef, workspaceLastPushedDocumentWatermarksRef, workspaceLastPushedAssetPathsRef, workspaceLastPushedAssetWatermarksRef, workspaceLastPushedDocumentReviewSessionIdsRef, workspaceLastPushedDocumentReviewSessionWatermarksRef, workspaceLastPushedDocumentReviewCommentIdsRef, workspaceLastPushedDocumentReviewCommentWatermarksRef, workspaceLastPushedAnnotatedAttachmentSessionIdsRef, workspaceLastPushedAnnotatedAttachmentSessionWatermarksRef, workspaceLastPushedTaskEventWatermarksRef, workspaceBaselineResetReasonRef, workspaceCaptureAttachBootstrapBaselineRef, workspaceStartupFullReconcileRanRef, workspaceFullReconcileInFlightRef, bootstrapLastProgressAtRef, realtimeSuppressedEventQueueRef, setWorkspaceSyncBusy, setUserGlobalSyncStatus, setUserGlobalSyncError, setWorkspaceLastErrorMessage, setWorkspaceLastErrorAt, setWorkspaceLastPullAt, setWorkspaceLastPushAt, setWorkspaceSyncPendingChanges, setTasks, setArchivedTasks }: CreateWorkspaceTransferCoordinatorArgs): {
+export declare function createWorkspaceTransferCoordinator({ cloudAuthConfigured, runtimeMode, workspaceCloudSyncEnabled, currentWorkspaceId, workspaceSyncPhase, isAuthenticated, checkAuthSession, resolveCloudAuthUrl, ensureCloudWorkspaceReadyForSync, ensureWorkspaceSyncReady, handleSyncAuthFailure, clearWorkspaceRetry, clearWorkspaceIssue, isWorkspaceRetryPending, scheduleWorkspaceSyncRetry, persistWorkspaceSyncPatchSafely, persistWorkspaceSyncPatchBestEffort, persistWorkspaceSyncWatermarksSnapshotBestEffort, reportSyncEvent, acquireWorkspaceSyncLease, releaseWorkspaceSyncLease, reportWorkspaceWindowContention, refreshWorkspaceSyncMarkdownDocumentsSnapshot, refreshWorkspaceSyncAiProfilesSnapshot, refreshWorkspaceSyncAssetsSnapshot, refreshWorkspaceSyncPlanningEntitiesSnapshot, refreshWorkspaceSyncDocumentReviewSessionsSnapshot, refreshWorkspaceSyncAnnotatedAttachmentSessionsSnapshot, refreshLocalWorkspaceTaskCollections, buildWorkspaceSyncPayload, buildWorkspaceSyncSignature, seedWorkspaceSnapshotPushBaseline, shouldSuppressAttachBootstrapPush, recordSuppressedEventIds, workspaceRepairModeRef, workspaceForceFullAiProfilePushRef, workspacePushInFlightRef, workspacePullInFlightRef, workspacePendingPushReplayRef, workspaceLastPushedSignatureRef, workspacePendingSignatureRef, workspaceLastPushedTaskIdsRef, workspaceDeletedTaskIdsRef, workspaceDeletedTaskWatermarksRef, workspacePullCursorRef, workspaceLastPushedWatermarksRef, workspaceLastPushedTaskChangeKeysRef, workspaceLastPushedInitiativeIdsRef, workspaceLastPushedInitiativeWatermarksRef, workspaceLastPushedWorkstreamIdsRef, workspaceLastPushedWorkstreamWatermarksRef, workspaceLastPushedAiProfileIdsRef, workspaceLastPushedAiProfileWatermarksRef, workspaceLastPushedAiProfileChangeKeysRef, workspaceLastPushedDocumentPathsRef, workspaceLastPushedDocumentWatermarksRef, workspaceLastPushedAssetPathsRef, workspaceLastPushedAssetWatermarksRef, workspaceLastPushedDocumentReviewSessionIdsRef, workspaceLastPushedDocumentReviewSessionWatermarksRef, workspaceLastPushedDocumentReviewCommentIdsRef, workspaceLastPushedDocumentReviewCommentWatermarksRef, workspaceLastPushedAnnotatedAttachmentSessionIdsRef, workspaceLastPushedAnnotatedAttachmentSessionWatermarksRef, workspaceLastPushedTaskEventWatermarksRef, workspaceBaselineResetReasonRef, workspaceCaptureAttachBootstrapBaselineRef, workspaceStartupFullReconcileRanRef, workspaceFullReconcileInFlightRef, bootstrapLastProgressAtRef, realtimeSuppressedEventQueueRef, setWorkspaceSyncBusy, setUserGlobalSyncStatus, setUserGlobalSyncError, setWorkspaceLastErrorMessage, setWorkspaceLastErrorAt, setWorkspaceLastPullAt, setWorkspaceLastPushAt, setWorkspaceSyncPendingChanges, setTasks, setArchivedTasks }: CreateWorkspaceTransferCoordinatorArgs): {
     pushWorkspaceChangesToCloud: (signature: string, options?: {
         forceAllAiProfiles?: boolean;
         repairMode?: boolean;

package/dist/hooks/sync/transfers.js

@@ -3,7 +3,7 @@ import { isTransientWorkspaceSyncStatus, runWorkspacePullSyncService, runWorkspa
 import { createWorkspaceSyncLeaseHeldDecision, resolvePullSyncReadiness, resolvePushSyncReadiness } from './controlPlane';
 import { resolveWorkspacePullRequestPlan, resolveWorkspacePullSuccessPlan } from './pullLifecycle';
 import { logSyncDebug } from './orchestratorShared';
-export function createWorkspaceTransferCoordinator({ cloudAuthConfigured, runtimeMode, workspaceCloudSyncEnabled, currentWorkspaceId, workspaceSyncPhase, isAuthenticated, checkAuthSession, resolveCloudAuthUrl, ensureCloudWorkspaceReadyForSync, ensureWorkspaceSyncReady, handleSyncAuthFailure, clearWorkspaceRetry, clearWorkspaceIssue, isWorkspaceRetryPending, scheduleWorkspaceSyncRetry, persistWorkspaceSyncPatchSafely, persistWorkspaceSyncPatchBestEffort, persistWorkspaceSyncWatermarksSnapshotBestEffort, reportSyncEvent, acquireWorkspaceSyncLease, releaseWorkspaceSyncLease, reportWorkspaceWindowContention, refreshWorkspaceSyncMarkdownDocumentsSnapshot, refreshWorkspaceSyncAiProfilesSnapshot, refreshWorkspaceSyncAssetsSnapshot, refreshWorkspaceSyncDocumentReviewSessionsSnapshot, refreshWorkspaceSyncAnnotatedAttachmentSessionsSnapshot, refreshLocalWorkspaceTaskCollections, buildWorkspaceSyncPayload, buildWorkspaceSyncSignature, seedWorkspaceSnapshotPushBaseline, shouldSuppressAttachBootstrapPush, recordSuppressedEventIds, workspaceRepairModeRef, workspaceForceFullAiProfilePushRef, workspacePushInFlightRef, workspacePullInFlightRef, workspacePendingPushReplayRef, workspaceLastPushedSignatureRef, workspacePendingSignatureRef, workspaceLastPushedTaskIdsRef, workspaceDeletedTaskIdsRef, workspaceDeletedTaskWatermarksRef, workspacePullCursorRef, workspaceLastPushedWatermarksRef, workspaceLastPushedTaskChangeKeysRef, workspaceLastPushedInitiativeIdsRef, workspaceLastPushedInitiativeWatermarksRef, workspaceLastPushedWorkstreamIdsRef, workspaceLastPushedWorkstreamWatermarksRef, workspaceLastPushedAiProfileIdsRef, workspaceLastPushedAiProfileWatermarksRef, workspaceLastPushedAiProfileChangeKeysRef, workspaceLastPushedDocumentPathsRef, workspaceLastPushedDocumentWatermarksRef, workspaceLastPushedAssetPathsRef, workspaceLastPushedAssetWatermarksRef, workspaceLastPushedDocumentReviewSessionIdsRef, workspaceLastPushedDocumentReviewSessionWatermarksRef, workspaceLastPushedDocumentReviewCommentIdsRef, workspaceLastPushedDocumentReviewCommentWatermarksRef, workspaceLastPushedAnnotatedAttachmentSessionIdsRef, workspaceLastPushedAnnotatedAttachmentSessionWatermarksRef, workspaceLastPushedTaskEventWatermarksRef, workspaceBaselineResetReasonRef, workspaceCaptureAttachBootstrapBaselineRef, workspaceStartupFullReconcileRanRef, workspaceFullReconcileInFlightRef, bootstrapLastProgressAtRef, realtimeSuppressedEventQueueRef, setWorkspaceSyncBusy, setUserGlobalSyncStatus, setUserGlobalSyncError, setWorkspaceLastErrorMessage, setWorkspaceLastErrorAt, setWorkspaceLastPullAt, setWorkspaceLastPushAt, setWorkspaceSyncPendingChanges, setTasks, setArchivedTasks }) {
+export function createWorkspaceTransferCoordinator({ cloudAuthConfigured, runtimeMode, workspaceCloudSyncEnabled, currentWorkspaceId, workspaceSyncPhase, isAuthenticated, checkAuthSession, resolveCloudAuthUrl, ensureCloudWorkspaceReadyForSync, ensureWorkspaceSyncReady, handleSyncAuthFailure, clearWorkspaceRetry, clearWorkspaceIssue, isWorkspaceRetryPending, scheduleWorkspaceSyncRetry, persistWorkspaceSyncPatchSafely, persistWorkspaceSyncPatchBestEffort, persistWorkspaceSyncWatermarksSnapshotBestEffort, reportSyncEvent, acquireWorkspaceSyncLease, releaseWorkspaceSyncLease, reportWorkspaceWindowContention, refreshWorkspaceSyncMarkdownDocumentsSnapshot, refreshWorkspaceSyncAiProfilesSnapshot, refreshWorkspaceSyncAssetsSnapshot, refreshWorkspaceSyncPlanningEntitiesSnapshot, refreshWorkspaceSyncDocumentReviewSessionsSnapshot, refreshWorkspaceSyncAnnotatedAttachmentSessionsSnapshot, refreshLocalWorkspaceTaskCollections, buildWorkspaceSyncPayload, buildWorkspaceSyncSignature, seedWorkspaceSnapshotPushBaseline, shouldSuppressAttachBootstrapPush, recordSuppressedEventIds, workspaceRepairModeRef, workspaceForceFullAiProfilePushRef, workspacePushInFlightRef, workspacePullInFlightRef, workspacePendingPushReplayRef, workspaceLastPushedSignatureRef, workspacePendingSignatureRef, workspaceLastPushedTaskIdsRef, workspaceDeletedTaskIdsRef, workspaceDeletedTaskWatermarksRef, workspacePullCursorRef, workspaceLastPushedWatermarksRef, workspaceLastPushedTaskChangeKeysRef, workspaceLastPushedInitiativeIdsRef, workspaceLastPushedInitiativeWatermarksRef, workspaceLastPushedWorkstreamIdsRef, workspaceLastPushedWorkstreamWatermarksRef, workspaceLastPushedAiProfileIdsRef, workspaceLastPushedAiProfileWatermarksRef, workspaceLastPushedAiProfileChangeKeysRef, workspaceLastPushedDocumentPathsRef, workspaceLastPushedDocumentWatermarksRef, workspaceLastPushedAssetPathsRef, workspaceLastPushedAssetWatermarksRef, workspaceLastPushedDocumentReviewSessionIdsRef, workspaceLastPushedDocumentReviewSessionWatermarksRef, workspaceLastPushedDocumentReviewCommentIdsRef, workspaceLastPushedDocumentReviewCommentWatermarksRef, workspaceLastPushedAnnotatedAttachmentSessionIdsRef, workspaceLastPushedAnnotatedAttachmentSessionWatermarksRef, workspaceLastPushedTaskEventWatermarksRef, workspaceBaselineResetReasonRef, workspaceCaptureAttachBootstrapBaselineRef, workspaceStartupFullReconcileRanRef, workspaceFullReconcileInFlightRef, bootstrapLastProgressAtRef, realtimeSuppressedEventQueueRef, setWorkspaceSyncBusy, setUserGlobalSyncStatus, setUserGlobalSyncError, setWorkspaceLastErrorMessage, setWorkspaceLastErrorAt, setWorkspaceLastPullAt, setWorkspaceLastPushAt, setWorkspaceSyncPendingChanges, setTasks, setArchivedTasks }) {
     const pushWorkspaceChangesToCloud = async (signature, options) => {
         let pushReadiness = resolvePushSyncReadiness({
             cloudAuthConfigured,
@@ -61,16 +61,29 @@ export function createWorkspaceTransferCoordinator({ cloudAuthConfigured, runtim
         const repairMode = options?.repairMode === true || workspaceRepairModeRef.current === true;
         let payloadForAttempt = null;
         let replayedPayload = false;
+        let attemptSignature = signature;
         try {
             await refreshWorkspaceSyncMarkdownDocumentsSnapshot();
             await refreshWorkspaceSyncAiProfilesSnapshot();
             await refreshWorkspaceSyncAssetsSnapshot();
+            await refreshWorkspaceSyncPlanningEntitiesSnapshot();
             await refreshWorkspaceSyncDocumentReviewSessionsSnapshot();
             const ready = await ensureWorkspaceSyncReady();
             if (!ready)
                 return false;
+            const refreshedSignature = buildWorkspaceSyncSignature();
+            if (refreshedSignature) {
+                attemptSignature = refreshedSignature;
+            }
+            if (shouldSuppressAttachBootstrapPush(attemptSignature)) {
+                return false;
+            }
             const pendingReplay = workspacePendingPushReplayRef.current;
-            const replayPayload = pendingReplay && pendingReplay.signature === signature
+            const canReplayPayload = (pendingReplay
+                && pendingReplay.signature === attemptSignature
+                && (!forceAllAiProfiles || pendingReplay.forceAllAiProfiles === true)
+                && (!repairMode || pendingReplay.repairMode === true));
+            const replayPayload = canReplayPayload
                 ? pendingReplay
                 : null;
             const payload = replayPayload?.payload || buildWorkspaceSyncPayload({ forceAllAiProfiles });
@@ -111,10 +124,10 @@ export function createWorkspaceTransferCoordinator({ cloudAuthConfigured, runtim
                         replayedPayload
                     }
                 });
-                workspacePendingSignatureRef.current = signature;
+                workspacePendingSignatureRef.current = attemptSignature;
                 if (pushResult.transient || isTransientWorkspaceSyncStatus(pushResult.status)) {
                     workspacePendingPushReplayRef.current = {
-                        signature,
+                        signature: attemptSignature,
                         payload,
                         forceAllAiProfiles: replayPayload?.forceAllAiProfiles ?? forceAllAiProfiles,
                         repairMode: replayPayload?.repairMode ?? repairMode
@@ -130,7 +143,7 @@ export function createWorkspaceTransferCoordinator({ cloudAuthConfigured, runtim
                 return false;
             }
             workspacePendingPushReplayRef.current = null;
-            workspaceLastPushedSignatureRef.current = signature;
+            workspaceLastPushedSignatureRef.current = attemptSignature;
             workspaceLastPushedTaskIdsRef.current = pushResult.currentTaskIds;
             workspaceLastPushedWatermarksRef.current = pushResult.currentTaskWatermarks
                 ? new Map(pushResult.currentTaskWatermarks)
@@ -247,10 +260,10 @@ export function createWorkspaceTransferCoordinator({ cloudAuthConfigured, runtim
             setUserGlobalSyncError(message);
             setWorkspaceLastErrorMessage(message);
             setWorkspaceLastErrorAt(new Date().toISOString());
-            workspacePendingSignatureRef.current = signature;
+            workspacePendingSignatureRef.current = attemptSignature;
             if (payloadForAttempt) {
                 workspacePendingPushReplayRef.current = {
-                    signature,
+                    signature: attemptSignature,
                     payload: payloadForAttempt,
                     forceAllAiProfiles,
                     repairMode
@@ -435,7 +448,8 @@ export function createWorkspaceTransferCoordinator({ cloudAuthConfigured, runtim
             if (pullResult.appliedChanges > 0
                 && (pullResult.pulledActiveUpserts
                     || pullResult.pulledArchivedUpserts
-                    || pullResult.pulledTaskEventUpserts)) {
+                    || pullResult.pulledTaskEventUpserts
+                    || pullResult.pulledPlanningUpserts)) {
                 try {
                     await refreshLocalWorkspaceTaskCollections();
                 }
@@ -508,7 +522,20 @@ export function createWorkspaceTransferCoordinator({ cloudAuthConfigured, runtim
                     });
                 }, 250);
             }
-            if (pullSuccessPlan.deferredPushSignature) {
+            const shouldReassertAiProfilesAfterFullReconcile = (options?.forceCursorNull === true
+                && options?.repairMode !== true
+                && workspaceSyncPhase === 'active');
+            if (shouldReassertAiProfilesAfterFullReconcile) {
+                const reassertSignature = buildWorkspaceSyncSignature();
+                if (reassertSignature) {
+                    workspaceForceFullAiProfilePushRef.current = true;
+                    workspacePendingSignatureRef.current = reassertSignature;
+                    window.setTimeout(() => {
+                        void pushWorkspaceChangesToCloud(reassertSignature, { forceAllAiProfiles: true });
+                    }, 120);
+                }
+            }
+            else if (pullSuccessPlan.deferredPushSignature) {
                 const deferredPushSignature = pullSuccessPlan.deferredPushSignature;
                 window.setTimeout(() => {
                     void pushWorkspaceChangesToCloud(deferredPushSignature);