@taskforcehq/taskforce 0.3.328 → 0.3.329

package/dist/sync/v3/workspaceSyncV3CombinedLocalApply.js

@@ -6,7 +6,7 @@ import { validateWorkspaceSyncV3CombinedRepairPage, WorkspaceSyncV3CombinedProje
 import { fingerprintWorkspaceSyncPayload, WorkspaceSyncDurabilityStore } from './syncDurabilityStore.js';
 import { WorkflowStore } from '../../storage/workflowStore.js';
 import { serializeTaskRelationshipForSync } from './workspaceSyncV3TaskRelationshipProjection.js';
-import { serializeWorkspaceSyncV3EntityEventPayload, serializeWorkspaceSyncV3TaskAttachmentLinksPayload, serializeWorkspaceSyncV3TaskChecklistPayload, serializeWorkspaceSyncV3TaskCommentsPayload, validateWorkspaceSyncV3EntityEventPayload, } from './workspaceSyncV3NestedTaskCodecs.js';
+import { serializeWorkspaceSyncV3EntityEventPayload, serializeWorkspaceSyncV3TaskAttachmentLinksPayload, serializeWorkspaceSyncV3TaskAttachmentLinksV2Payload, serializeWorkspaceSyncV3TaskChecklistPayload, serializeWorkspaceSyncV3TaskCommentsPayload, validateWorkspaceSyncV3EntityEventPayload, } from './workspaceSyncV3NestedTaskCodecs.js';
 import { applyWorkspaceSyncV3NestedTaskEntries, WorkspaceSyncV3TaskCommentAggregateDivergenceError, } from './workspaceSyncV3NestedTaskApply.js';
 import { LocalSyncIdentityStore } from './localSyncIdentityStore.js';
 import { enqueueLocalTaskCommentReconciliation } from './localTaskCommentOutboxService.js';
@@ -25,7 +25,8 @@ function combinedRepairBaselineMarker(page) {
     })}`;
 }
 const NESTED_TASK_PROJECTIONS = new Set([
-    'task-comments/full-v1', 'task-checklist/full-v1', 'task-attachment-links/full-v1', 'entity-event/full-v1',
+    'task-comments/full-v1', 'task-checklist/full-v1', 'task-attachment-links/full-v1',
+    'task-attachment-links/full-v2', 'entity-event/full-v1',
 ]);
 const WORKFLOW_RUNTIME_PROJECTIONS = new Set([
     'workflow-published-definition/full-v2',
@@ -59,7 +60,8 @@ function coveredDomains(projections) {
         domains.push('task-comments');
     if (projections.has('task-checklist/full-v1'))
         domains.push('task-checklist');
-    if (projections.has('task-attachment-links/full-v1'))
+    if (projections.has('task-attachment-links/full-v1')
+        || projections.has('task-attachment-links/full-v2'))
         domains.push('task-attachment-links');
     if (projections.has('entity-event/full-v1'))
         domains.push('entity-event');
@@ -181,6 +183,15 @@ function isExactPlanningRootProjectionReplay(input) {
         && input.current.lastSequence === input.entry.sequence
         && input.current.canonicalFingerprint === (input.entry.canonicalFingerprint || input.entry.payloadFingerprint);
 }
+function parentOwnedNestedTaskId(entry) {
+    if (entry.projection === 'task-comments/full-v1'
+        || entry.projection === 'task-checklist/full-v1'
+        || entry.projection === 'task-attachment-links/full-v1'
+        || entry.projection === 'task-attachment-links/full-v2') {
+        return entry.entityId;
+    }
+    return null;
+}
 function applyEntries(input) {
     const store = new WorkspaceSyncDurabilityStore(input.core.getDatabaseAdapter());
     const workflowApply = prepareWorkspaceSyncV3WorkflowRuntimeApply({
@@ -200,9 +211,13 @@ function applyEntries(input) {
                 throw coveredLocalOperationsError('Combined feed apply is blocked by covered local operations.');
             }
             const notices = notifications();
+            const deletedTaskRoots = new Set();
             for (const entry of input.entries) {
                 let taskChange = null;
                 let nestedTaskChangeId = null;
+                const nestedTaskId = parentOwnedNestedTaskId(entry);
+                if (nestedTaskId && deletedTaskRoots.has(nestedTaskId))
+                    continue;
                 const current = store.readWorkspaceDomainOwnership({ tenantId: input.tenantId,
                     workspaceId: input.workspaceId, domain: entry.domain, entityId: entry.entityId });
                 const exactTaskRootReplay = isExactTaskRootProjectionReplay({ entry, current });
@@ -288,6 +303,16 @@ function applyEntries(input) {
                         shouldRecordRevision: (result) => result?.state !== 'deferred',
                     });
                 }
+                if (entry.projection === 'task/root-v1') {
+                    if (taskChange === 'upsert') {
+                        deletedTaskRoots.delete(entry.entityId);
+                    }
+                    else if (taskChange === 'delete'
+                        || (!input.core.getTask(entry.entityId, input.workspaceId)
+                            && input.core.hasTaskDeletionMarkerForSync(entry.entityId, input.workspaceId))) {
+                        deletedTaskRoots.add(entry.entityId);
+                    }
+                }
                 if (applied.state !== 'applied')
                     continue;
                 if (entry.projection === 'task/root-v1' && entry.mutationKind !== 'delete') {
@@ -366,12 +391,19 @@ function listLocalTaskNestedProjection(core, workspaceId, projection) {
                     taskId: task.id, items: task.checklistItems || [],
                 }));
             }
-            else {
+            else if (projection === 'task-attachment-links/full-v1') {
                 values.set(task.id, serializeWorkspaceSyncV3TaskAttachmentLinksPayload({
                     taskId: task.id,
                     links: core.listTaskAttachmentLinksForDurableSync(task.id, workspaceId),
                 }));
             }
+            else {
+                values.set(task.id, serializeWorkspaceSyncV3TaskAttachmentLinksV2Payload({
+                    taskId: task.id,
+                    links: core.listTaskAttachmentLinksForDurableSync(task.id, workspaceId),
+                    cardCoverAssetId: task.cardCoverAssetId ?? null,
+                }));
+            }
         }
         const last = page.at(-1);
         cursor = page.length === 1000 && last
@@ -416,6 +448,9 @@ function nestedLocalDomains(core, workspaceId, projections, liveEntityIds) {
     if (projections.has('task-attachment-links/full-v1')) {
         domains.push(['task-attachment-links', listLocalTaskNestedProjection(core, workspaceId, 'task-attachment-links/full-v1')]);
     }
+    else if (projections.has('task-attachment-links/full-v2')) {
+        domains.push(['task-attachment-links', listLocalTaskNestedProjection(core, workspaceId, 'task-attachment-links/full-v2')]);
+    }
     if (projections.has('entity-event/full-v1')) {
         domains.push(['entity-event', listLocalEntityEvents(core, workspaceId, liveEntityIds)]);
     }
@@ -560,13 +595,18 @@ function isCompatibleLegacyAttachmentLinks(core, workspaceId, local, incoming) {
             if (!value || typeof value !== 'object' || Array.isArray(value))
                 return false;
             const incomingLink = value;
-            if (localLink.role !== incomingLink.role)
-                return false;
             const localAsset = store.get(String(localLink.assetId || ''), workspaceId);
             const incomingAsset = store.get(String(incomingLink.assetId || ''), workspaceId);
             if (!localAsset || !incomingAsset || localAsset.deletedAt || incomingAsset.deletedAt
                 || localAsset.storageKey !== incomingAsset.storageKey)
                 return false;
+            const compatibleRole = localLink.role === incomingLink.role
+                || (localAsset.storageProvider === 'external'
+                    && localLink.role === 'reference'
+                    && incomingAsset.storageProvider !== 'external'
+                    && incomingLink.role === (incomingAsset.kind === 'image' ? 'image' : 'attachment'));
+            if (!compatibleRole)
+                return false;
             const sameContent = localAsset.contentSha256 === incomingAsset.contentSha256
                 && localAsset.sizeBytes === incomingAsset.sizeBytes;
             const authoritativeMaterialization = localAsset.storageProvider === 'external'
@@ -584,15 +624,15 @@ function isCompatibleLegacyAttachmentLinks(core, workspaceId, local, incoming) {
                 if (!value || typeof value !== 'object' || Array.isArray(value))
                     return false;
                 const incomingLink = value;
-                if (localLink.role !== incomingLink.role)
-                    return false;
                 const incomingAsset = store.get(String(incomingLink.assetId || ''), workspaceId);
                 return Boolean(incomingAsset && !incomingAsset.deletedAt
                     && incomingAsset.storageProvider !== 'external'
+                    && localLink.role === 'reference'
+                    && incomingLink.role === (incomingAsset.kind === 'image' ? 'image' : 'attachment')
                     && incomingAsset.storageKey === localAsset.storageKey
                     && incomingAsset.sizeBytes >= localAsset.sizeBytes);
             }));
-    }) && unmatched.length === 0;
+    });
     return compatible;
 }
 function assertLocalInventoryReady(input) {
@@ -981,7 +1021,8 @@ export function applyWorkspaceSyncV3CombinedRepairPage(input) {
             const supportedTarget = ((target.domain === 'task' && entry.projection === 'task/root-v1')
                 || (target.domain === 'task-comments' && entry.projection === 'task-comments/full-v1')
                 || (target.domain === 'task-attachment-links'
-                    && entry.projection === 'task-attachment-links/full-v1')
+                    && (entry.projection === 'task-attachment-links/full-v1'
+                        || entry.projection === 'task-attachment-links/full-v2'))
                 || (target.domain === 'entity-event' && entry.projection === 'entity-event/full-v1'));
             if (!supportedTarget) {
                 throw new Error('Targeted workspace sync recovery does not support this projection.');

package/dist/sync/v3/workspaceSyncV3CombinedRepairBaseline.d.ts

@@ -7,6 +7,7 @@ export declare function prepareWorkspaceSyncV3CombinedRepairSnapshot(input: {
     nestedCoverage?: boolean;
     workflowCoverage?: boolean;
     planningOrderCoverage?: boolean;
+    taskCoverCoverage?: boolean;
     coveredLegacyWritesFenced?: boolean;
 }): {
     highWatermark: string;
@@ -35,6 +36,12 @@ export declare function prepareWorkspaceSyncV3PlanningOrderRepairSnapshot(input:
     now?: string;
     coveredLegacyWritesFenced?: boolean;
 }): ReturnType<typeof prepareWorkspaceSyncV3CombinedRepairSnapshot>;
+export declare function prepareWorkspaceSyncV3TaskCoverRepairSnapshot(input: {
+    core: TaskforceCore;
+    workspaceId: string;
+    now?: string;
+    coveredLegacyWritesFenced?: boolean;
+}): ReturnType<typeof prepareWorkspaceSyncV3CombinedRepairSnapshot>;
 export declare function ensureWorkspaceSyncV3CombinedRepairBaselines(input: {
     core: TaskforceCore;
     workspaceId: string;

package/dist/sync/v3/workspaceSyncV3CombinedRepairBaseline.js

@@ -3,11 +3,12 @@ import { serializeInitiativeForSync, serializeWorkstreamForSync } from '../plann
 import { serializeTaskForSync } from '../taskSyncPayload.js';
 import { canonicalWorkspaceSyncJson } from './canonicalWorkspaceSyncJson.js';
 import { WORKSPACE_SYNC_COMBINED_PROJECTION, fingerprintWorkspaceSyncPayload, WORKSPACE_SYNC_CONTRACT_VERSION, WorkspaceSyncRevisionConflictError, } from './syncDurabilityStore.js';
-import { buildWorkspaceSyncV3CombinedRepairSnapshot, buildWorkspaceSyncV3CombinedRepairSnapshotFromLockedCandidates, buildWorkspaceSyncV3NestedRepairSnapshot, buildWorkspaceSyncV3PlanningOrderRepairSnapshot, buildWorkspaceSyncV3WorkflowRepairSnapshot, listWorkspaceSyncV3CombinedRepairCandidates, listWorkspaceSyncV3NestedRepairCandidates, listWorkspaceSyncV3PlanningOrderRepairCandidates, listWorkspaceSyncV3WorkflowRepairCandidates, } from './workspaceSyncV3CombinedRepairSnapshot.js';
+import { buildWorkspaceSyncV3CombinedRepairSnapshot, buildWorkspaceSyncV3CombinedRepairSnapshotFromLockedCandidates, buildWorkspaceSyncV3NestedRepairSnapshot, buildWorkspaceSyncV3PlanningOrderRepairSnapshot, buildWorkspaceSyncV3TaskCoverRepairSnapshot, buildWorkspaceSyncV3WorkflowRepairSnapshot, listWorkspaceSyncV3CombinedRepairCandidates, listWorkspaceSyncV3NestedRepairCandidates, listWorkspaceSyncV3PlanningOrderRepairCandidates, listWorkspaceSyncV3TaskCoverRepairCandidates, listWorkspaceSyncV3WorkflowRepairCandidates, } from './workspaceSyncV3CombinedRepairSnapshot.js';
 import { WORKSPACE_SYNC_V3_COMBINED_COVERAGE_PROFILE } from './workspaceSyncV3CombinedCoverage.js';
 import { WORKSPACE_SYNC_V3_NESTED_COVERAGE_PROFILE } from './workspaceSyncV3NestedCoverage.js';
 import { WORKSPACE_SYNC_V3_WORKFLOW_COVERAGE_PROFILE } from './workspaceSyncV3WorkflowCoverage.js';
 import { WORKSPACE_SYNC_V3_PLANNING_ORDER_COVERAGE_PROFILE } from './workspaceSyncV3PlanningOrderCoverage.js';
+import { WORKSPACE_SYNC_V3_TASK_COVER_COVERAGE_PROFILE } from './workspaceSyncV3TaskCoverCoverage.js';
 import { serializeWorkspaceSyncV3TaskAttachmentLinksPayload, serializeWorkspaceSyncV3TaskCommentsPayload, } from './workspaceSyncV3NestedTaskCodecs.js';
 import { projectWorkspaceSyncV3NestedTaskJournalRow } from './workspaceSyncV3NestedTaskProjection.js';
 import { serializeTaskRelationshipForSync } from './workspaceSyncV3TaskRelationshipProjection.js';
@@ -262,11 +263,13 @@ export function prepareWorkspaceSyncV3CombinedRepairSnapshot(input) {
         const lockCompletedAt = Date.now();
         const candidates = input.workflowCoverage
             ? listWorkspaceSyncV3WorkflowRepairCandidates(input.core, workspaceId)
-            : input.planningOrderCoverage
-                ? listWorkspaceSyncV3PlanningOrderRepairCandidates(input.core, workspaceId)
-                : input.nestedCoverage
-                    ? listWorkspaceSyncV3NestedRepairCandidates(input.core, workspaceId)
-                    : listWorkspaceSyncV3CombinedRepairCandidates(input.core, workspaceId);
+            : input.taskCoverCoverage
+                ? listWorkspaceSyncV3TaskCoverRepairCandidates(input.core, workspaceId)
+                : input.planningOrderCoverage
+                    ? listWorkspaceSyncV3PlanningOrderRepairCandidates(input.core, workspaceId)
+                    : input.nestedCoverage
+                        ? listWorkspaceSyncV3NestedRepairCandidates(input.core, workspaceId)
+                        : listWorkspaceSyncV3CombinedRepairCandidates(input.core, workspaceId);
         const inventoryCompletedAt = Date.now();
         const keys = candidates.map((candidate) => `${candidate.domain}\0${candidate.entityId}`);
         if (new Set(keys).size !== keys.length)
@@ -550,11 +553,13 @@ export function prepareWorkspaceSyncV3CombinedRepairSnapshot(input) {
         const baselineWritesCompletedAt = Date.now();
         const profile = input.workflowCoverage
             ? WORKSPACE_SYNC_V3_WORKFLOW_COVERAGE_PROFILE
-            : input.planningOrderCoverage
-                ? WORKSPACE_SYNC_V3_PLANNING_ORDER_COVERAGE_PROFILE
-                : input.nestedCoverage
-                    ? WORKSPACE_SYNC_V3_NESTED_COVERAGE_PROFILE
-                    : WORKSPACE_SYNC_V3_COMBINED_COVERAGE_PROFILE;
+            : input.taskCoverCoverage
+                ? WORKSPACE_SYNC_V3_TASK_COVER_COVERAGE_PROFILE
+                : input.planningOrderCoverage
+                    ? WORKSPACE_SYNC_V3_PLANNING_ORDER_COVERAGE_PROFILE
+                    : input.nestedCoverage
+                        ? WORKSPACE_SYNC_V3_NESTED_COVERAGE_PROFILE
+                        : WORKSPACE_SYNC_V3_COMBINED_COVERAGE_PROFILE;
         const activeOwner = db.prepare(`
             SELECT 1 AS active
             FROM workspace_sync_projection_state
@@ -576,14 +581,17 @@ export function prepareWorkspaceSyncV3CombinedRepairSnapshot(input) {
                 nestedCoverage: input.nestedCoverage === true,
                 workflowCoverage: input.workflowCoverage === true,
                 planningOrderCoverage: input.planningOrderCoverage === true,
+                taskCoverCoverage: input.taskCoverCoverage === true,
             })
             : input.workflowCoverage
                 ? buildWorkspaceSyncV3WorkflowRepairSnapshot({ core: input.core, workspaceId })
-                : input.planningOrderCoverage
-                    ? buildWorkspaceSyncV3PlanningOrderRepairSnapshot({ core: input.core, workspaceId })
-                    : input.nestedCoverage
-                        ? buildWorkspaceSyncV3NestedRepairSnapshot({ core: input.core, workspaceId })
-                        : buildWorkspaceSyncV3CombinedRepairSnapshot({ core: input.core, workspaceId });
+                : input.taskCoverCoverage
+                    ? buildWorkspaceSyncV3TaskCoverRepairSnapshot({ core: input.core, workspaceId })
+                    : input.planningOrderCoverage
+                        ? buildWorkspaceSyncV3PlanningOrderRepairSnapshot({ core: input.core, workspaceId })
+                        : input.nestedCoverage
+                            ? buildWorkspaceSyncV3NestedRepairSnapshot({ core: input.core, workspaceId })
+                            : buildWorkspaceSyncV3CombinedRepairSnapshot({ core: input.core, workspaceId });
         const snapshotCompletedAt = Date.now();
         if (snapshot.snapshotSequence !== highWatermark) {
             throw new Error('Combined repair baseline snapshot sequence changed while locked.');
@@ -591,8 +599,9 @@ export function prepareWorkspaceSyncV3CombinedRepairSnapshot(input) {
         console.info('[Taskforce Sync Repair Baseline Timing]', JSON.stringify({
             workspaceId,
             coverage: input.workflowCoverage ? 'workflow'
-                : input.planningOrderCoverage ? 'planning-order'
-                    : input.nestedCoverage ? 'nested' : 'combined',
+                : input.taskCoverCoverage ? 'task-cover'
+                    : input.planningOrderCoverage ? 'planning-order'
+                        : input.nestedCoverage ? 'nested' : 'combined',
             candidates: candidates.length,
             lock: lockCompletedAt - startedAt,
             inventory: inventoryCompletedAt - lockCompletedAt,
@@ -615,6 +624,9 @@ export function prepareWorkspaceSyncV3WorkflowRepairSnapshot(input) {
 export function prepareWorkspaceSyncV3PlanningOrderRepairSnapshot(input) {
     return prepareWorkspaceSyncV3CombinedRepairSnapshot({ ...input, planningOrderCoverage: true });
 }
+export function prepareWorkspaceSyncV3TaskCoverRepairSnapshot(input) {
+    return prepareWorkspaceSyncV3CombinedRepairSnapshot({ ...input, taskCoverCoverage: true });
+}
 export function ensureWorkspaceSyncV3CombinedRepairBaselines(input) {
     const { snapshot: _snapshot, ...result } = prepareWorkspaceSyncV3CombinedRepairSnapshot(input);
     return result;

package/dist/sync/v3/workspaceSyncV3CombinedRepairMaterialization.d.ts

@@ -3,6 +3,7 @@ import { WORKSPACE_SYNC_V3_COMBINED_COVERAGE_PROFILE } from './workspaceSyncV3Co
 import { WORKSPACE_SYNC_V3_NESTED_COVERAGE_PROFILE } from './workspaceSyncV3NestedCoverage.js';
 import { WORKSPACE_SYNC_V3_WORKFLOW_COVERAGE_PROFILE } from './workspaceSyncV3WorkflowCoverage.js';
 import { WORKSPACE_SYNC_V3_PLANNING_ORDER_COVERAGE_PROFILE } from './workspaceSyncV3PlanningOrderCoverage.js';
+import { WORKSPACE_SYNC_V3_TASK_COVER_COVERAGE_PROFILE } from './workspaceSyncV3TaskCoverCoverage.js';
 import { type WorkspaceSyncV3FeedEntry } from './workspaceSyncV3Feed.js';
 import { type WorkspaceSyncV3FeedCursorKeyring } from './workspaceSyncV3FeedCursorKeys.js';
 export interface WorkspaceSyncV3CombinedRepairCursor {
@@ -21,7 +22,7 @@ export interface WorkspaceSyncV3CombinedRepairPage {
     success: true;
     protocolVersion: 3;
     workspaceId: string;
-    coverage: typeof WORKSPACE_SYNC_V3_COMBINED_COVERAGE_PROFILE | typeof WORKSPACE_SYNC_V3_NESTED_COVERAGE_PROFILE | typeof WORKSPACE_SYNC_V3_WORKFLOW_COVERAGE_PROFILE | typeof WORKSPACE_SYNC_V3_PLANNING_ORDER_COVERAGE_PROFILE;
+    coverage: typeof WORKSPACE_SYNC_V3_COMBINED_COVERAGE_PROFILE | typeof WORKSPACE_SYNC_V3_NESTED_COVERAGE_PROFILE | typeof WORKSPACE_SYNC_V3_WORKFLOW_COVERAGE_PROFILE | typeof WORKSPACE_SYNC_V3_PLANNING_ORDER_COVERAGE_PROFILE | typeof WORKSPACE_SYNC_V3_TASK_COVER_COVERAGE_PROFILE;
     snapshotId: string;
     snapshotSequence: string;
     expiresAt: string;
@@ -47,6 +48,8 @@ export declare function decodeWorkspaceSyncV3CombinedRepairCursor(raw: string |
 export declare function decodeWorkspaceSyncV3NestedRepairCursor(raw: string | null | undefined, keyring: WorkspaceSyncV3FeedCursorKeyring): WorkspaceSyncV3CombinedRepairCursor | null;
 export declare function decodeWorkspaceSyncV3WorkflowRepairCursor(raw: string | null | undefined, keyring: WorkspaceSyncV3FeedCursorKeyring): WorkspaceSyncV3CombinedRepairCursor | null;
 export declare function decodeWorkspaceSyncV3PlanningOrderRepairCursor(raw: string | null | undefined, keyring: WorkspaceSyncV3FeedCursorKeyring): WorkspaceSyncV3CombinedRepairCursor | null;
+export declare function decodeWorkspaceSyncV3TaskCoverRepairCursor(raw: string | null | undefined, keyring: WorkspaceSyncV3FeedCursorKeyring): WorkspaceSyncV3CombinedRepairCursor | null;
+export declare const WORKSPACE_SYNC_REPAIR_SNAPSHOT_CLEANUP_BATCH_SIZE = 500;
 export declare function buildWorkspaceSyncV3CombinedRepairPage(input: {
     core: TaskforceCore;
     workspaceId: string;
@@ -59,8 +62,10 @@ export declare function buildWorkspaceSyncV3CombinedRepairPage(input: {
     nestedCoverage?: boolean;
     workflowCoverage?: boolean;
     planningOrderCoverage?: boolean;
+    taskCoverCoverage?: boolean;
     coveredLegacyWritesFenced?: boolean;
 }): WorkspaceSyncV3CombinedRepairPage;
-export declare function buildWorkspaceSyncV3NestedRepairPage(input: Omit<Parameters<typeof buildWorkspaceSyncV3CombinedRepairPage>[0], 'nestedCoverage' | 'workflowCoverage' | 'planningOrderCoverage'>): WorkspaceSyncV3CombinedRepairPage;
-export declare function buildWorkspaceSyncV3WorkflowRepairPage(input: Omit<Parameters<typeof buildWorkspaceSyncV3CombinedRepairPage>[0], 'nestedCoverage' | 'workflowCoverage' | 'planningOrderCoverage'>): WorkspaceSyncV3CombinedRepairPage;
-export declare function buildWorkspaceSyncV3PlanningOrderRepairPage(input: Omit<Parameters<typeof buildWorkspaceSyncV3CombinedRepairPage>[0], 'nestedCoverage' | 'workflowCoverage' | 'planningOrderCoverage'>): WorkspaceSyncV3CombinedRepairPage;
+export declare function buildWorkspaceSyncV3NestedRepairPage(input: Omit<Parameters<typeof buildWorkspaceSyncV3CombinedRepairPage>[0], 'nestedCoverage' | 'workflowCoverage' | 'planningOrderCoverage' | 'taskCoverCoverage'>): WorkspaceSyncV3CombinedRepairPage;
+export declare function buildWorkspaceSyncV3WorkflowRepairPage(input: Omit<Parameters<typeof buildWorkspaceSyncV3CombinedRepairPage>[0], 'nestedCoverage' | 'workflowCoverage' | 'planningOrderCoverage' | 'taskCoverCoverage'>): WorkspaceSyncV3CombinedRepairPage;
+export declare function buildWorkspaceSyncV3PlanningOrderRepairPage(input: Omit<Parameters<typeof buildWorkspaceSyncV3CombinedRepairPage>[0], 'nestedCoverage' | 'workflowCoverage' | 'planningOrderCoverage' | 'taskCoverCoverage'>): WorkspaceSyncV3CombinedRepairPage;
+export declare function buildWorkspaceSyncV3TaskCoverRepairPage(input: Omit<Parameters<typeof buildWorkspaceSyncV3CombinedRepairPage>[0], 'nestedCoverage' | 'workflowCoverage' | 'planningOrderCoverage' | 'taskCoverCoverage'>): WorkspaceSyncV3CombinedRepairPage;

package/dist/sync/v3/workspaceSyncV3CombinedRepairMaterialization.js

@@ -1,11 +1,12 @@
 import { createHmac, randomUUID, timingSafeEqual } from 'crypto';
 import { canonicalWorkspaceSyncJson } from './canonicalWorkspaceSyncJson.js';
 import { decodeCanonicalWorkspaceSyncBase64Url } from './workspaceSyncV3CursorEncoding.js';
-import { prepareWorkspaceSyncV3CombinedRepairSnapshot, prepareWorkspaceSyncV3NestedRepairSnapshot, prepareWorkspaceSyncV3PlanningOrderRepairSnapshot, prepareWorkspaceSyncV3WorkflowRepairSnapshot, } from './workspaceSyncV3CombinedRepairBaseline.js';
+import { prepareWorkspaceSyncV3CombinedRepairSnapshot, prepareWorkspaceSyncV3NestedRepairSnapshot, prepareWorkspaceSyncV3PlanningOrderRepairSnapshot, prepareWorkspaceSyncV3TaskCoverRepairSnapshot, prepareWorkspaceSyncV3WorkflowRepairSnapshot, } from './workspaceSyncV3CombinedRepairBaseline.js';
 import { validateWorkspaceSyncV3CombinedFeedEntry, WORKSPACE_SYNC_V3_COMBINED_COVERAGE_PROFILE, } from './workspaceSyncV3CombinedCoverage.js';
 import { validateWorkspaceSyncV3NestedCoverageFeedEntry, WORKSPACE_SYNC_V3_NESTED_COVERAGE_PROFILE, } from './workspaceSyncV3NestedCoverage.js';
 import { validateWorkspaceSyncV3WorkflowCoverageFeedEntry, WORKSPACE_SYNC_V3_WORKFLOW_COVERAGE_PROFILE, } from './workspaceSyncV3WorkflowCoverage.js';
 import { validateWorkspaceSyncV3PlanningOrderCoverageFeedEntry, WORKSPACE_SYNC_V3_PLANNING_ORDER_COVERAGE_PROFILE, } from './workspaceSyncV3PlanningOrderCoverage.js';
+import { validateWorkspaceSyncV3TaskCoverCoverageFeedEntry, WORKSPACE_SYNC_V3_TASK_COVER_COVERAGE_PROFILE, } from './workspaceSyncV3TaskCoverCoverage.js';
 import { createWorkspaceSyncV3FeedResumeCursor, WorkspaceSyncV3FeedOperationTooLargeError, } from './workspaceSyncV3Feed.js';
 import { findWorkspaceSyncV3FeedCursorVerificationKey, } from './workspaceSyncV3FeedCursorKeys.js';
 import { WORKSPACE_SYNC_COMBINED_PROJECTION, WORKSPACE_SYNC_CONTRACT_VERSION, } from './syncDurabilityStore.js';
@@ -95,14 +96,19 @@ export function decodeWorkspaceSyncV3WorkflowRepairCursor(raw, keyring) {
 export function decodeWorkspaceSyncV3PlanningOrderRepairCursor(raw, keyring) {
     return decodeRepairCursor(raw, keyring, WORKSPACE_SYNC_V3_PLANNING_ORDER_COVERAGE_PROFILE);
 }
+export function decodeWorkspaceSyncV3TaskCoverRepairCursor(raw, keyring) {
+    return decodeRepairCursor(raw, keyring, WORKSPACE_SYNC_V3_TASK_COVER_COVERAGE_PROFILE);
+}
 function repairProfile(coverage) {
     return coverage === 'workflow'
         ? WORKSPACE_SYNC_V3_WORKFLOW_COVERAGE_PROFILE
-        : coverage === 'planning-order'
-            ? WORKSPACE_SYNC_V3_PLANNING_ORDER_COVERAGE_PROFILE
-            : coverage === 'nested'
-                ? WORKSPACE_SYNC_V3_NESTED_COVERAGE_PROFILE
-                : WORKSPACE_SYNC_V3_COMBINED_COVERAGE_PROFILE;
+        : coverage === 'task-cover'
+            ? WORKSPACE_SYNC_V3_TASK_COVER_COVERAGE_PROFILE
+            : coverage === 'planning-order'
+                ? WORKSPACE_SYNC_V3_PLANNING_ORDER_COVERAGE_PROFILE
+                : coverage === 'nested'
+                    ? WORKSPACE_SYNC_V3_NESTED_COVERAGE_PROFILE
+                    : WORKSPACE_SYNC_V3_COMBINED_COVERAGE_PROFILE;
 }
 function containsCurrentEntityEventInventory(input) {
     if (input.coverage === 'combined')
@@ -140,27 +146,70 @@ function containsCurrentEntityEventInventory(input) {
                 AND entry.domain = 'entity-event'
                 AND entry.entity_id = event.id
           )
+          AND NOT EXISTS (
+              SELECT 1
+              FROM workspace_sync_journal journal
+              WHERE journal.tenant_id = event.tenant_id
+                AND journal.workspace_id = event.workspace_id
+                AND journal.domain = 'entity-event'
+                AND journal.entity_id = event.id
+                -- Later sequenced events are delivered after the immutable
+                -- repair boundary; only unsequenced legacy adoption makes the
+                -- snapshot incomplete and requires rematerialization.
+                AND journal.sequence > ?
+          )
         LIMIT 1
-    `).get(input.tenantId, input.workspaceId, input.snapshotId);
+    `).get(input.tenantId, input.workspaceId, input.snapshotId, input.snapshotSequence);
     return !missing;
 }
-function cleanupExpired(core, tenantId, workspaceId, now, excludingSnapshotId) {
+export const WORKSPACE_SYNC_REPAIR_SNAPSHOT_CLEANUP_BATCH_SIZE = 500;
+function cleanupExpiredBestEffort(core, tenantId, workspaceId, now, excludingSnapshotId) {
     const db = core.getDatabaseAdapter();
     const exclusion = excludingSnapshotId ? ' AND snapshot_id <> ?' : '';
     const args = excludingSnapshotId
         ? [tenantId, workspaceId, now, excludingSnapshotId]
         : [tenantId, workspaceId, now];
-    db.prepare(`
-        DELETE FROM workspace_sync_repair_snapshot_entries
-        WHERE tenant_id = ? AND workspace_id = ? AND snapshot_id IN (
-            SELECT snapshot_id FROM workspace_sync_repair_snapshots
-            WHERE tenant_id = ? AND workspace_id = ? AND expires_at <= ?${exclusion}
-        )
-    `).run(tenantId, workspaceId, ...args);
-    db.prepare(`
-        DELETE FROM workspace_sync_repair_snapshots
-        WHERE tenant_id = ? AND workspace_id = ? AND expires_at <= ?${exclusion}
-    `).run(...args);
+    try {
+        db.transaction(() => {
+            const expired = db.prepare(`
+                SELECT snapshot_id
+                FROM workspace_sync_repair_snapshots
+                WHERE tenant_id = ? AND workspace_id = ? AND expires_at <= ?${exclusion}
+                ORDER BY expires_at ASC, snapshot_id ASC
+                LIMIT 1
+            `).get(...args);
+            const snapshotId = String(expired?.snapshot_id || '').trim();
+            if (!snapshotId)
+                return;
+            db.prepare(`
+                DELETE FROM workspace_sync_repair_snapshot_entries
+                WHERE tenant_id = ? AND workspace_id = ? AND snapshot_id = ?
+                  AND entry_index IN (
+                      SELECT entry_index
+                      FROM workspace_sync_repair_snapshot_entries
+                      WHERE tenant_id = ? AND workspace_id = ? AND snapshot_id = ?
+                      ORDER BY entry_index ASC
+                      LIMIT ?
+                  )
+            `).run(tenantId, workspaceId, snapshotId, tenantId, workspaceId, snapshotId, WORKSPACE_SYNC_REPAIR_SNAPSHOT_CLEANUP_BATCH_SIZE);
+            db.prepare(`
+                DELETE FROM workspace_sync_repair_snapshots
+                WHERE tenant_id = ? AND workspace_id = ? AND snapshot_id = ? AND expires_at <= ?
+                  AND NOT EXISTS (
+                      SELECT 1 FROM workspace_sync_repair_snapshot_entries
+                      WHERE tenant_id = ? AND workspace_id = ? AND snapshot_id = ?
+                  )
+            `).run(tenantId, workspaceId, snapshotId, now, tenantId, workspaceId, snapshotId);
+        })();
+    }
+    catch (error) {
+        // Expired snapshot removal is opportunistic maintenance. A cleanup
+        // timeout must not invalidate an otherwise valid repair response.
+        console.warn('[Taskforce Sync Repair Cleanup Deferred]', JSON.stringify({
+            workspaceId,
+            error: String(error?.message || error),
+        }));
+    }
 }
 function persistMaterialization(input) {
     const db = input.core.getDatabaseAdapter();
@@ -225,6 +274,7 @@ function readMetadata(input) {
             tenantId: input.tenantId,
             workspaceId: input.workspaceId,
             snapshotId: input.cursor.snapshotId,
+            snapshotSequence: input.cursor.snapshotSequence,
             coverage: input.coverage,
         })) {
         throw new WorkspaceSyncV3CombinedRepairSnapshotUnavailableError();
@@ -275,6 +325,7 @@ function readReusableMetadata(input) {
         tenantId: input.tenantId,
         workspaceId: input.workspaceId,
         snapshotId: String(row.snapshot_id),
+        snapshotSequence: sequence(row.snapshot_sequence, 'Combined repair snapshot sequence'),
         coverage: input.coverage,
     }))
         return null;
@@ -306,11 +357,13 @@ function mapEntry(row, coverage) {
     };
     (coverage === 'workflow'
         ? validateWorkspaceSyncV3WorkflowCoverageFeedEntry
-        : coverage === 'planning-order'
-            ? validateWorkspaceSyncV3PlanningOrderCoverageFeedEntry
-            : coverage === 'nested'
-                ? validateWorkspaceSyncV3NestedCoverageFeedEntry
-                : validateWorkspaceSyncV3CombinedFeedEntry)(entry);
+        : coverage === 'task-cover'
+            ? validateWorkspaceSyncV3TaskCoverCoverageFeedEntry
+            : coverage === 'planning-order'
+                ? validateWorkspaceSyncV3PlanningOrderCoverageFeedEntry
+                : coverage === 'nested'
+                    ? validateWorkspaceSyncV3NestedCoverageFeedEntry
+                    : validateWorkspaceSyncV3CombinedFeedEntry)(entry);
     return entry;
 }
 function finalizePage(input) {
@@ -369,22 +422,15 @@ export function buildWorkspaceSyncV3CombinedRepairPage(input) {
     const db = input.core.getDatabaseAdapter();
     const coverage = input.workflowCoverage
         ? 'workflow'
-        : input.planningOrderCoverage
-            ? 'planning-order'
-            : input.nestedCoverage
-                ? 'nested'
-                : 'combined';
+        : input.taskCoverCoverage
+            ? 'task-cover'
+            : input.planningOrderCoverage
+                ? 'planning-order'
+                : input.nestedCoverage
+                    ? 'nested'
+                    : 'combined';
     if (input.cursor && Date.parse(input.cursor.expiresAt) <= Date.parse(now)) {
-        db.transaction(() => {
-            db.prepare(`DELETE FROM workspace_sync_repair_snapshot_entries
-                WHERE tenant_id = ? AND workspace_id = ? AND snapshot_id = ? AND EXISTS (
-                    SELECT 1 FROM workspace_sync_repair_snapshots
-                    WHERE tenant_id = ? AND workspace_id = ? AND snapshot_id = ? AND expires_at <= ?
-                )`).run(tenantId, workspaceId, input.cursor.snapshotId, tenantId, workspaceId, input.cursor.snapshotId, now);
-            db.prepare(`DELETE FROM workspace_sync_repair_snapshots
-                WHERE tenant_id = ? AND workspace_id = ? AND snapshot_id = ? AND expires_at <= ?`)
-                .run(tenantId, workspaceId, input.cursor.snapshotId, now);
-        })();
+        cleanupExpiredBestEffort(input.core, tenantId, workspaceId, now);
         throw new WorkspaceSyncV3CombinedRepairSnapshotUnavailableError();
     }
     let insertedBaselineEntities = 0;
@@ -393,17 +439,17 @@ export function buildWorkspaceSyncV3CombinedRepairPage(input) {
     let metadata;
     let nextIndex;
     if (input.cursor) {
+        cleanupExpiredBestEffort(input.core, tenantId, workspaceId, now, input.cursor.snapshotId);
         metadata = db.transaction(() => {
-            const current = readMetadata({
+            return readMetadata({
                 core: input.core, tenantId, workspaceId, cursor: input.cursor, now,
                 coverage,
             });
-            cleanupExpired(input.core, tenantId, workspaceId, now, current.snapshotId);
-            return current;
         })();
         nextIndex = input.cursor.nextIndex;
     }
     else {
+        cleanupExpiredBestEffort(input.core, tenantId, workspaceId, now);
         const materialized = db.transaction(() => {
             // Serialize cursorless materialization and reuse decisions with
             // durable writers and competing repair requests.
@@ -413,7 +459,6 @@ export function buildWorkspaceSyncV3CombinedRepairPage(input) {
                 ON CONFLICT (tenant_id, workspace_id) DO UPDATE SET updated_at = excluded.updated_at
                 RETURNING CAST(last_sequence AS TEXT) AS last_sequence
             `).get(tenantId, workspaceId, now);
-            cleanupExpired(input.core, tenantId, workspaceId, now);
             const reusable = readReusableMetadata({
                 core: input.core, tenantId, workspaceId, now,
                 coverage,
@@ -428,11 +473,14 @@ export function buildWorkspaceSyncV3CombinedRepairPage(input) {
                 : coverage === 'planning-order'
                     ? prepareWorkspaceSyncV3PlanningOrderRepairSnapshot({ core: input.core, workspaceId, now,
                         coveredLegacyWritesFenced: input.coveredLegacyWritesFenced })
-                    : coverage === 'nested'
-                        ? prepareWorkspaceSyncV3NestedRepairSnapshot({ core: input.core, workspaceId, now,
+                    : coverage === 'task-cover'
+                        ? prepareWorkspaceSyncV3TaskCoverRepairSnapshot({ core: input.core, workspaceId, now,
                             coveredLegacyWritesFenced: input.coveredLegacyWritesFenced })
-                        : prepareWorkspaceSyncV3CombinedRepairSnapshot({ core: input.core, workspaceId, now,
-                            coveredLegacyWritesFenced: input.coveredLegacyWritesFenced });
+                        : coverage === 'nested'
+                            ? prepareWorkspaceSyncV3NestedRepairSnapshot({ core: input.core, workspaceId, now,
+                                coveredLegacyWritesFenced: input.coveredLegacyWritesFenced })
+                            : prepareWorkspaceSyncV3CombinedRepairSnapshot({ core: input.core, workspaceId, now,
+                                coveredLegacyWritesFenced: input.coveredLegacyWritesFenced });
             // Production expiry is sampled at the end of persistence, after
             // every immutable payload row has committed in the same lock.
             const materializationStartedAt = input.now
@@ -525,3 +573,6 @@ export function buildWorkspaceSyncV3WorkflowRepairPage(input) {
 export function buildWorkspaceSyncV3PlanningOrderRepairPage(input) {
     return buildWorkspaceSyncV3CombinedRepairPage({ ...input, planningOrderCoverage: true });
 }
+export function buildWorkspaceSyncV3TaskCoverRepairPage(input) {
+    return buildWorkspaceSyncV3CombinedRepairPage({ ...input, taskCoverCoverage: true });
+}

package/dist/sync/v3/workspaceSyncV3CombinedRepairSnapshot.d.ts

@@ -31,6 +31,8 @@ export declare class WorkspaceSyncV3CombinedRepairBaselineRequiredError extends
 export declare function listWorkspaceSyncV3CombinedRepairCandidates(core: TaskforceCore, workspaceId: string): WorkspaceSyncV3CombinedRepairCandidate[];
 /** Candidate v4 inventory. The coverage-v3 inventory above intentionally remains unchanged. */
 export declare function listWorkspaceSyncV3NestedRepairCandidates(core: TaskforceCore, workspaceId: string): WorkspaceSyncV3CombinedRepairCandidate[];
+/** Candidate v7 inventory. It is the v4 family with attachment-link schema v2. */
+export declare function listWorkspaceSyncV3TaskCoverRepairCandidates(core: TaskforceCore, workspaceId: string): WorkspaceSyncV3CombinedRepairCandidate[];
 /** Candidate v5 inventory. Coverage-v3/v4 inventories intentionally remain unchanged. */
 export declare function listWorkspaceSyncV3WorkflowRepairCandidates(core: TaskforceCore, workspaceId: string): WorkspaceSyncV3CombinedRepairCandidate[];
 /** Candidate v6 inventory. Workflow v5 remains an independent dark contract. */
@@ -50,6 +52,7 @@ export declare function buildWorkspaceSyncV3CombinedRepairSnapshotFromLockedCand
     nestedCoverage?: boolean;
     workflowCoverage?: boolean;
     planningOrderCoverage?: boolean;
+    taskCoverCoverage?: boolean;
 }): {
     snapshotSequence: string;
     entries: WorkspaceSyncV3FeedEntry[];
@@ -75,4 +78,11 @@ export declare function buildWorkspaceSyncV3PlanningOrderRepairSnapshot(input: {
     snapshotSequence: string;
     entries: WorkspaceSyncV3FeedEntry[];
 };
+export declare function buildWorkspaceSyncV3TaskCoverRepairSnapshot(input: {
+    core: TaskforceCore;
+    workspaceId: string;
+}): {
+    snapshotSequence: string;
+    entries: WorkspaceSyncV3FeedEntry[];
+};
 export {};