@taskforcehq/taskforce 0.3.328 → 0.3.330

package/dist/sync/v3/workspaceSyncV3AttachmentApplyObligationStore.js

@@ -28,6 +28,8 @@ function mapRow(row) {
         createdAt: row.created_at,
         updatedAt: row.updated_at,
         nextAttemptAt: row.next_attempt_at,
+        terminalAt: row.terminal_at,
+        terminalReason: row.terminal_reason,
         resolvedAt: row.resolved_at,
     };
 }
@@ -52,8 +54,8 @@ export class WorkspaceSyncV3AttachmentApplyObligationStore {
                 tenant_id, workspace_id, task_id, asset_ids_json, payload_json,
                 canonical_fingerprint, source_sequence, attempts, last_error,
                 entity_revision, lifecycle_revision, revision_fingerprint,
-                created_at, updated_at, next_attempt_at, resolved_at
-            ) VALUES (?, ?, ?, ?, ?, ?, ?, 0, ?, ?, ?, ?, ?, ?, ?, NULL)
+                created_at, updated_at, next_attempt_at, terminal_at, terminal_reason, resolved_at
+            ) VALUES (?, ?, ?, ?, ?, ?, ?, 0, ?, ?, ?, ?, ?, ?, ?, NULL, NULL, NULL)
             ON CONFLICT (tenant_id, workspace_id, task_id) DO UPDATE SET
                 asset_ids_json = excluded.asset_ids_json,
                 payload_json = excluded.payload_json,
@@ -66,6 +68,8 @@ export class WorkspaceSyncV3AttachmentApplyObligationStore {
                 last_error = excluded.last_error,
                 updated_at = excluded.updated_at,
                 next_attempt_at = excluded.next_attempt_at,
+                terminal_at = NULL,
+                terminal_reason = NULL,
                 resolved_at = NULL
             WHERE workspace_sync_v3_attachment_apply_obligations.resolved_at IS NOT NULL
                OR CAST(excluded.source_sequence AS ${this.db.provider === 'postgres' ? 'BIGINT' : 'INTEGER'})
@@ -77,7 +81,8 @@ export class WorkspaceSyncV3AttachmentApplyObligationStore {
         const rows = this.db.prepare(`
             SELECT *
             FROM workspace_sync_v3_attachment_apply_obligations
-            WHERE tenant_id = ? AND workspace_id = ? AND resolved_at IS NULL AND next_attempt_at <= ?
+            WHERE tenant_id = ? AND workspace_id = ?
+              AND resolved_at IS NULL AND terminal_at IS NULL AND next_attempt_at <= ?
             ORDER BY next_attempt_at ASC, task_id ASC
             LIMIT ?
         `).all(input.tenantId, input.workspaceId, input.now, limit);
@@ -87,30 +92,34 @@ export class WorkspaceSyncV3AttachmentApplyObligationStore {
         const row = this.db.prepare(`
             SELECT COUNT(*) AS count
             FROM workspace_sync_v3_attachment_apply_obligations
-            WHERE tenant_id = ? AND workspace_id = ? AND resolved_at IS NULL
+            WHERE tenant_id = ? AND workspace_id = ?
+              AND resolved_at IS NULL AND terminal_at IS NULL
         `).get(input.tenantId, input.workspaceId);
         return Number(row?.count || 0);
     }
     readSummary(input) {
         const aggregate = this.db.prepare(`
-            SELECT COUNT(*) AS open,
-                   SUM(CASE WHEN next_attempt_at <= ? THEN 1 ELSE 0 END) AS due,
-                   MIN(created_at) AS oldest_open_created_at,
-                   MIN(next_attempt_at) AS next_attempt_at,
-                   SUM(attempts) AS total_attempts
+            SELECT SUM(CASE WHEN terminal_at IS NULL THEN 1 ELSE 0 END) AS open,
+                   SUM(CASE WHEN terminal_at IS NOT NULL THEN 1 ELSE 0 END) AS terminal,
+                   SUM(CASE WHEN terminal_at IS NULL AND next_attempt_at <= ? THEN 1 ELSE 0 END) AS due,
+                   MIN(CASE WHEN terminal_at IS NULL THEN created_at END) AS oldest_open_created_at,
+                   MIN(CASE WHEN terminal_at IS NULL THEN next_attempt_at END) AS next_attempt_at,
+                   SUM(CASE WHEN terminal_at IS NULL THEN attempts ELSE 0 END) AS total_attempts
             FROM workspace_sync_v3_attachment_apply_obligations
             WHERE tenant_id = ? AND workspace_id = ? AND resolved_at IS NULL
         `).get(input.now, input.tenantId, input.workspaceId);
         const latest = this.db.prepare(`
             SELECT last_error
             FROM workspace_sync_v3_attachment_apply_obligations
-            WHERE tenant_id = ? AND workspace_id = ? AND resolved_at IS NULL
+            WHERE tenant_id = ? AND workspace_id = ?
+              AND resolved_at IS NULL AND terminal_at IS NULL
               AND last_error IS NOT NULL
             ORDER BY updated_at DESC, task_id ASC
             LIMIT 1
         `).get(input.tenantId, input.workspaceId);
         return {
             open: Number(aggregate?.open || 0),
+            terminal: Number(aggregate?.terminal || 0),
             due: Number(aggregate?.due || 0),
             oldestOpenCreatedAt: aggregate?.oldest_open_created_at || null,
             nextAttemptAt: aggregate?.next_attempt_at || null,
@@ -142,6 +151,14 @@ export class WorkspaceSyncV3AttachmentApplyObligationStore {
             WHERE tenant_id = ? AND workspace_id = ? AND task_id = ? AND resolved_at IS NULL
         `).run(input.now, input.now, input.tenantId, input.workspaceId, input.taskId);
     }
+    markTerminalUnavailable(input) {
+        this.db.prepare(`
+            UPDATE workspace_sync_v3_attachment_apply_obligations
+            SET terminal_at = ?, terminal_reason = ?, last_error = ?, updated_at = ?
+            WHERE tenant_id = ? AND workspace_id = ? AND task_id = ?
+              AND canonical_fingerprint = ? AND resolved_at IS NULL AND terminal_at IS NULL
+        `).run(input.now, String(input.reason || '').slice(0, 500), String(input.reason || '').slice(0, 500), input.now, input.tenantId, input.workspaceId, input.taskId, input.canonicalFingerprint);
+    }
     recordAttemptFailure(input) {
         this.db.prepare(`
             UPDATE workspace_sync_v3_attachment_apply_obligations

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

@@ -7,10 +7,11 @@ export type WorkspaceSyncV3AttachmentAssetHydrationResult = {
 } | {
     success: false;
     error: string;
+    disposition?: 'retryable' | 'terminal-unavailable';
 };
 export declare function hydrateWorkspaceSyncV3AttachmentAsset(input: {
     workspaceId: string;
     assetId: string;
-    remoteServices: Pick<WorkspaceSyncEngineRemoteServices, 'pullWorkspaceContent' | 'abandonTransferReceipts' | 'buildV2ApplyCompletionGroup'>;
+    remoteServices: Pick<WorkspaceSyncEngineRemoteServices, 'pullWorkspaceContent' | 'abandonTransferReceipts' | 'buildIndependentContentApplyCompletionGroup'>;
     localServices: Pick<WorkspaceSyncEngineLocalServices, 'applyV2Batch'>;
 }): Promise<WorkspaceSyncV3AttachmentAssetHydrationResult>;

package/dist/sync/v3/workspaceSyncV3AttachmentAssetHydration.js

@@ -3,20 +3,48 @@ import { fingerprintWorkspaceContentBody } from '../workspaceContentManifest.js'
 export async function hydrateWorkspaceSyncV3AttachmentAsset(input) {
     const remoteServices = input.remoteServices;
     const applyV2Batch = input.localServices.applyV2Batch;
+    const completionIdentity = `attachment-asset:${input.assetId}`;
     const response = await remoteServices.pullWorkspaceContent({
         workspaceId: input.workspaceId,
         requests: [{ kind: 'asset', assetId: input.assetId }],
         previousCursor: null,
+        independentCompletionIdentity: completionIdentity,
     });
     const receipt = response.transferReceipt;
     let transferCommitted = false;
+    let localApplyStarted = false;
     try {
         if (!response.ok) {
             return { success: false, error: `Workspace attachment asset hydration failed (${response.status || 0}).` };
         }
         const data = response.data || {};
-        if ((data.missing?.length || 0) > 0 || (data.remaining?.length || 0) > 0) {
-            return { success: false, error: `Workspace attachment asset is unavailable in cloud content: ${input.assetId}` };
+        if ((data.remaining?.length || 0) > 0) {
+            return {
+                success: false,
+                error: `Workspace attachment asset hydration is incomplete: ${input.assetId}`,
+                disposition: 'retryable',
+            };
+        }
+        const exactMissing = Array.isArray(data.missing) && data.missing.find((entry) => (entry?.kind === 'asset'
+            && 'assetId' in entry
+            && String(entry.assetId || '').trim() === input.assetId));
+        if (exactMissing) {
+            return {
+                success: false,
+                error: exactMissing.disposition === 'terminal-unavailable'
+                    ? `Workspace attachment asset is authoritatively unavailable in cloud metadata: ${input.assetId}`
+                    : `Workspace attachment asset body is temporarily unavailable in cloud content: ${input.assetId}`,
+                disposition: exactMissing.disposition === 'terminal-unavailable'
+                    ? 'terminal-unavailable'
+                    : 'retryable',
+            };
+        }
+        if ((data.missing?.length || 0) > 0) {
+            return {
+                success: false,
+                error: `Workspace attachment asset hydration returned an unexpected missing result: ${input.assetId}`,
+                disposition: 'retryable',
+            };
         }
         const rawChanges = Array.isArray(data.changes) ? data.changes : [];
         const changes = rawChanges.filter((change) => ((change.op === 'document-upsert' || change.op === 'asset-upsert')
@@ -50,10 +78,9 @@ export async function hydrateWorkspaceSyncV3AttachmentAsset(input) {
             return { success: false, error: `Workspace attachment asset hydration verification failed: ${input.assetId}` };
         }
         const completionGroup = receipt
-            ? remoteServices.buildV2ApplyCompletionGroup({
+            ? remoteServices.buildIndependentContentApplyCompletionGroup({
                 workspaceId: input.workspaceId,
-                previousCursor: null,
-                nextCursor: null,
+                identity: completionIdentity,
                 receipts: [receipt],
             })
             : undefined;
@@ -63,6 +90,7 @@ export async function hydrateWorkspaceSyncV3AttachmentAsset(input) {
                 error: 'Workspace attachment asset hydration could not bind its transfer to local apply.',
             };
         }
+        localApplyStarted = true;
         const applyResult = completionGroup
             ? await applyV2Batch(input.workspaceId, changes, { completionGroup })
             : await applyV2Batch(input.workspaceId, changes);
@@ -80,11 +108,25 @@ export async function hydrateWorkspaceSyncV3AttachmentAsset(input) {
     }
     finally {
         if (receipt && !transferCommitted) {
-            await remoteServices.abandonTransferReceipts({
-                workspaceId: input.workspaceId,
-                receipts: [receipt],
-                errorCode: 'WORKSPACE_SYNC_V3_ATTACHMENT_HYDRATION_NOT_COMMITTED',
-            });
+            if (!localApplyStarted) {
+                const completionGroup = remoteServices.buildIndependentContentApplyCompletionGroup({
+                    workspaceId: input.workspaceId,
+                    identity: completionIdentity,
+                    receipts: [receipt],
+                });
+                if (completionGroup) {
+                    localApplyStarted = true;
+                    const settlement = await applyV2Batch(input.workspaceId, [], { completionGroup });
+                    transferCommitted = settlement.ok;
+                }
+            }
+            if (!transferCommitted) {
+                await remoteServices.abandonTransferReceipts({
+                    workspaceId: input.workspaceId,
+                    receipts: [receipt],
+                    errorCode: 'WORKSPACE_SYNC_V3_ATTACHMENT_HYDRATION_NOT_COMMITTED',
+                });
+            }
         }
     }
 }

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

@@ -46,6 +46,7 @@ export type WorkspaceSyncV3CloudOperationContext = {
     /** @deprecated Prefer resolveOriginActorRef; retained for create callers. */
     resolveTaskCreateActorRef?: (originActor: NonNullable<WorkspaceSyncV3TaskCreateEnvelope['operation']['payload']['originActor']>) => string;
     onPostCommitError?: (error: unknown) => void;
+    includeWorkflowRuntimeJournal?: boolean;
 };
 export type WorkspaceSyncV3CloudOperationHandler = {
     key: string;

package/dist/sync/v3/workspaceSyncV3CloudOperationHandler.js

@@ -71,6 +71,10 @@ export function createWorkspaceSyncV3CloudOperationHandlers() {
                     ...withDeferredOriginActor(context, operation.payload.originActor),
                     taskId: operation.entityId, patch: operation.payload.patch,
                     saveSource: operation.payload.saveSource,
+                    expectedDetailRevision: operation.payload.expectedDetailRevision,
+                    assertPrecondition: operation.payload.expectedDetailRevision && context.core.assertTaskDetailRevisionForUpdate
+                        ? () => context.core.assertTaskDetailRevisionForUpdate(operation.entityId, operation.payload.expectedDetailRevision, context.workspaceId)
+                        : undefined,
                     baseEntityRevision: operation.baseEntityRevision, baseLifecycleRevision: operation.baseLifecycleRevision,
                 });
             },
@@ -187,11 +191,16 @@ export function createWorkspaceSyncV3CloudOperationHandlers() {
             supports: (envelope) => envelope.operation.domain === 'task' && envelope.operation.mutationKind === 'set-status',
             apply: (envelope, context) => {
                 const operation = envelope.operation;
-                const { originActor, ...payload } = operation.payload;
+                const { originActor, expectedDetailRevision, ...payload } = operation.payload;
                 return runDurableTaskStatusMutation({
                     ...withDeferredOriginActor(context, originActor),
                     taskId: operation.entityId,
                     payload,
+                    expectedDetailRevision,
+                    includeWorkflowRuntimeJournal: context.includeWorkflowRuntimeJournal,
+                    assertPrecondition: expectedDetailRevision && context.core.assertTaskDetailRevisionForUpdate
+                        ? () => context.core.assertTaskDetailRevisionForUpdate(operation.entityId, expectedDetailRevision, context.workspaceId)
+                        : undefined,
                     baseEntityRevision: operation.baseEntityRevision,
                     baseLifecycleRevision: operation.baseLifecycleRevision,
                 });
@@ -229,10 +238,16 @@ export function createWorkspaceSyncV3CloudOperationHandlers() {
             supports: (envelope) => envelope.operation.domain === 'task-checklist' && envelope.operation.mutationKind === 'replace',
             apply: (envelope, context) => {
                 const operation = envelope.operation;
+                const { originActor, expectedDetailRevision, itemUpdateIntent, items } = operation.payload;
                 return runDurableTaskChecklistReplace({
-                    ...withDeferredOriginActor(context, operation.payload.originActor),
+                    ...withDeferredOriginActor(context, originActor),
                     taskId: operation.entityId,
-                    items: operation.payload.items,
+                    items,
+                    expectedDetailRevision,
+                    itemUpdateIntent,
+                    assertPrecondition: expectedDetailRevision && context.core.assertTaskDetailRevisionForUpdate
+                        ? () => context.core.assertTaskDetailRevisionForUpdate(operation.entityId, expectedDetailRevision, context.workspaceId)
+                        : undefined,
                     baseEntityRevision: operation.baseEntityRevision,
                     baseLifecycleRevision: operation.baseLifecycleRevision,
                 });

package/dist/sync/v3/workspaceSyncV3CombinedFeedOrchestrator.js

@@ -325,10 +325,14 @@ async function runWorkspaceSyncV3CombinedProjectionCycleInternal(input, staleRep
     let projection = initial;
     let recoveryRepairApplied = false;
     let restartStaleRepair = false;
+    let restartCoverageRepair = false;
     let restartedStaleRepair = staleRepairAlreadyRestarted;
     const persistedCoverage = projectionCoverage(projection);
     if (!persistedCoverage)
         return localFailure(projection, 'Persisted combined workspace sync coverage is unsupported.');
+    restartCoverageRepair = projection.owner === 'v3'
+        && projection.repair !== null
+        && !exactCoverage(persistedCoverage, coverage);
     if (projection.coverageRepairRequired
         || (projection.owner === 'v3' && !projection.repair && !exactCoverage(persistedCoverage, coverage))) {
         const feed = await dependencies.pullFeed(input.resolveCloudAuthUrl, {
@@ -413,12 +417,12 @@ async function runWorkspaceSyncV3CombinedProjectionCycleInternal(input, staleRep
     }
     let restartExpiredRepair = false;
     let restartedExpiredRepair = false;
-    while (projection.owner === 'v2' || projection.repair || restartStaleRepair) {
-        const previousCursor = restartExpiredRepair || restartStaleRepair
+    while (projection.owner === 'v2' || projection.repair || restartStaleRepair || restartCoverageRepair) {
+        const previousCursor = restartExpiredRepair || restartStaleRepair || restartCoverageRepair
             ? null : projection.repair?.cursor || null;
         const feed = await dependencies.pullFeed(input.resolveCloudAuthUrl, {
             workspaceId: input.workspaceId,
-            ...(restartExpiredRepair || restartStaleRepair
+            ...(restartExpiredRepair || restartStaleRepair || restartCoverageRepair
                 ? { forceRepair: true }
                 : { repairCursor: previousCursor }),
             limit: 100,
@@ -449,6 +453,7 @@ async function runWorkspaceSyncV3CombinedProjectionCycleInternal(input, staleRep
         projection = updated;
         restartExpiredRepair = false;
         restartStaleRepair = false;
+        restartCoverageRepair = false;
         if (repairSnapshotWasInvalidated(applied)) {
             if (restartedStaleRepair) {
                 return localFailure(projection, 'A refreshed combined repair snapshot still predates authoritative local state.');

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

@@ -6,7 +6,9 @@ export declare function prepareWorkspaceSyncV3CombinedRepairSnapshot(input: {
     now?: string;
     nestedCoverage?: boolean;
     workflowCoverage?: boolean;
+    workflowTaskCoverCoverage?: boolean;
     planningOrderCoverage?: boolean;
+    taskCoverCoverage?: boolean;
     coveredLegacyWritesFenced?: boolean;
 }): {
     highWatermark: string;
@@ -35,6 +37,18 @@ 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 prepareWorkspaceSyncV3WorkflowTaskCoverRepairSnapshot(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,13 @@ 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, buildWorkspaceSyncV3WorkflowTaskCoverRepairSnapshot, listWorkspaceSyncV3CombinedRepairCandidates, listWorkspaceSyncV3NestedRepairCandidates, listWorkspaceSyncV3PlanningOrderRepairCandidates, listWorkspaceSyncV3TaskCoverRepairCandidates, listWorkspaceSyncV3WorkflowRepairCandidates, listWorkspaceSyncV3WorkflowTaskCoverRepairCandidates, } 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 { WORKSPACE_SYNC_V3_WORKFLOW_TASK_COVER_COVERAGE_PROFILE } from './workspaceSyncV3WorkflowTaskCoverCoverage.js';
 import { serializeWorkspaceSyncV3TaskAttachmentLinksPayload, serializeWorkspaceSyncV3TaskCommentsPayload, } from './workspaceSyncV3NestedTaskCodecs.js';
 import { projectWorkspaceSyncV3NestedTaskJournalRow } from './workspaceSyncV3NestedTaskProjection.js';
 import { serializeTaskRelationshipForSync } from './workspaceSyncV3TaskRelationshipProjection.js';
@@ -260,13 +262,17 @@ export function prepareWorkspaceSyncV3CombinedRepairSnapshot(input) {
         `).get(tenantId, workspaceId, now);
         sequence(lock?.last_sequence);
         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);
+        const candidates = input.workflowTaskCoverCoverage
+            ? listWorkspaceSyncV3WorkflowTaskCoverRepairCandidates(input.core, workspaceId)
+            : input.workflowCoverage
+                ? listWorkspaceSyncV3WorkflowRepairCandidates(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)
@@ -548,13 +554,17 @@ export function prepareWorkspaceSyncV3CombinedRepairSnapshot(input) {
                 throw repairConflict('legacy-nested-repair-raced', repair.candidate);
         }
         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;
+        const profile = input.workflowTaskCoverCoverage
+            ? WORKSPACE_SYNC_V3_WORKFLOW_TASK_COVER_COVERAGE_PROFILE
+            : input.workflowCoverage
+                ? WORKSPACE_SYNC_V3_WORKFLOW_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
@@ -575,24 +585,32 @@ export function prepareWorkspaceSyncV3CombinedRepairSnapshot(input) {
                 inventory: candidates,
                 nestedCoverage: input.nestedCoverage === true,
                 workflowCoverage: input.workflowCoverage === true,
+                workflowTaskCoverCoverage: input.workflowTaskCoverCoverage === 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.workflowTaskCoverCoverage
+                ? buildWorkspaceSyncV3WorkflowTaskCoverRepairSnapshot({ core: input.core, workspaceId })
+                : input.workflowCoverage
+                    ? buildWorkspaceSyncV3WorkflowRepairSnapshot({ 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.');
         }
         console.info('[Taskforce Sync Repair Baseline Timing]', JSON.stringify({
             workspaceId,
-            coverage: input.workflowCoverage ? 'workflow'
-                : input.planningOrderCoverage ? 'planning-order'
-                    : input.nestedCoverage ? 'nested' : 'combined',
+            coverage: input.workflowTaskCoverCoverage ? 'workflow-task-cover'
+                : input.workflowCoverage ? 'workflow'
+                    : input.taskCoverCoverage ? 'task-cover'
+                        : input.planningOrderCoverage ? 'planning-order'
+                            : input.nestedCoverage ? 'nested' : 'combined',
             candidates: candidates.length,
             lock: lockCompletedAt - startedAt,
             inventory: inventoryCompletedAt - lockCompletedAt,
@@ -615,6 +633,12 @@ export function prepareWorkspaceSyncV3WorkflowRepairSnapshot(input) {
 export function prepareWorkspaceSyncV3PlanningOrderRepairSnapshot(input) {
     return prepareWorkspaceSyncV3CombinedRepairSnapshot({ ...input, planningOrderCoverage: true });
 }
+export function prepareWorkspaceSyncV3TaskCoverRepairSnapshot(input) {
+    return prepareWorkspaceSyncV3CombinedRepairSnapshot({ ...input, taskCoverCoverage: true });
+}
+export function prepareWorkspaceSyncV3WorkflowTaskCoverRepairSnapshot(input) {
+    return prepareWorkspaceSyncV3CombinedRepairSnapshot({ ...input, workflowTaskCoverCoverage: true });
+}
 export function ensureWorkspaceSyncV3CombinedRepairBaselines(input) {
     const { snapshot: _snapshot, ...result } = prepareWorkspaceSyncV3CombinedRepairSnapshot(input);
     return result;