@taskforcehq/taskforce 0.3.327 → 0.3.329

package/dist/sync/v3/taskAttachmentLinksMutationService.js

@@ -1,9 +1,9 @@
-import { projectResolvedTaskAttachmentLinksForDurableSync } from '../../core/TaskAttachmentLinksDurableMutationService.js';
+import { projectResolvedTaskAttachmentLinksForDurableSync, resolveTaskCardCoverAssetIdForLinks, } from '../../core/TaskAttachmentLinksDurableMutationService.js';
 import { serializeTaskRootForSync } from './workspaceSyncV3TaskRootProjection.js';
 import { buildTaskAttachmentLinksActivityEventId } from './taskAttachmentLinksActivityIdentity.js';
 import { asWorkspaceSyncActivityRevision, buildTaskActivityJournalEntry, canonicalizeEntityActivityDetailsForSync, serializeTaskActivityForSync, } from './taskActivityJournal.js';
 import { fingerprintWorkspaceSyncPayload, runReservedWorkspaceSyncV3Operation, WORKSPACE_SYNC_CONTRACT_VERSION, } from './syncDurabilityStore.js';
-import { serializeWorkspaceSyncV3TaskAttachmentLinksPayload, } from './workspaceSyncV3NestedTaskCodecs.js';
+import { serializeWorkspaceSyncV3TaskAttachmentLinksPayload, serializeWorkspaceSyncV3TaskAttachmentLinksV2Payload, } from './workspaceSyncV3NestedTaskCodecs.js';
 import { resolveDeferredMutationActorRef } from './workspaceSyncV3OriginActor.js';
 export class DurableTaskAttachmentLinksMutationError extends Error {
     code;
@@ -57,7 +57,13 @@ export function runDurableTaskAttachmentLinksReplace(input) {
             domain: 'task-attachment-links', entityId: input.taskId, mutationKind: 'replace',
             baseEntityRevision: String(input.baseEntityRevision),
             baseLifecycleRevision: String(input.baseLifecycleRevision), links: requestedLinks,
+            ...(Object.prototype.hasOwnProperty.call(input, 'cardCoverAssetId')
+                ? { cardCoverAssetId: input.cardCoverAssetId }
+                : {}),
             ...(input.originActorRef ? { originActorRef: input.originActorRef } : {}),
+            ...(input.expectedDetailRevision
+                ? { expectedDetailRevision: input.expectedDetailRevision }
+                : {}),
         },
     });
     const activityEventId = buildTaskAttachmentLinksActivityEventId({
@@ -71,6 +77,16 @@ export function runDurableTaskAttachmentLinksReplace(input) {
             throw new Error('Durable task attachment-link activity was not persisted.');
         return activity;
     };
+    const readAttachmentPayload = () => {
+        const task = input.core.getTask(input.taskId, input.workspaceId);
+        if (!task)
+            throw new DurableTaskAttachmentLinksMutationError('Task not found.', 'TASK_NOT_FOUND', 404);
+        return serializeWorkspaceSyncV3TaskAttachmentLinksV2Payload({
+            taskId: input.taskId,
+            links: input.core.listTaskAttachmentLinksForDurableSync(input.taskId, input.workspaceId),
+            cardCoverAssetId: task.cardCoverAssetId ?? null,
+        });
+    };
     const result = runReservedWorkspaceSyncV3Operation({
         store: input.store, identity, requestFingerprint,
         now: input.now, leaseExpiresAt: input.leaseExpiresAt, leaseOwner: input.leaseOwner,
@@ -98,21 +114,29 @@ export function runDurableTaskAttachmentLinksReplace(input) {
                     }, {
                         domain: 'task-attachment-links', entityId: input.taskId, mutationKind: 'replace', revisionKind: 'metadata',
                         baseEntityRevision: input.baseEntityRevision, baseLifecycleRevision: input.baseLifecycleRevision,
-                        buildCanonicalFingerprint: () => fingerprintWorkspaceSyncPayload(serializeWorkspaceSyncV3TaskAttachmentLinksPayload({
-                            taskId: input.taskId,
-                            links: input.core.listTaskAttachmentLinksForDurableSync(input.taskId, input.workspaceId),
-                        })),
-                        buildAuthoritativePayload: () => serializeWorkspaceSyncV3TaskAttachmentLinksPayload({
-                            taskId: input.taskId,
-                            links: input.core.listTaskAttachmentLinksForDurableSync(input.taskId, input.workspaceId),
-                        }),
+                        buildCanonicalFingerprint: () => fingerprintWorkspaceSyncPayload(readAttachmentPayload()),
+                        buildAuthoritativePayload: readAttachmentPayload,
                     }, buildTaskActivityJournalEntry({ eventId: activityEventId, readEvent: readActivity })],
                 applyMutation: () => {
+                    input.assertPrecondition?.();
                     const existing = input.core.getTask(input.taskId, input.workspaceId);
                     if (!existing)
                         throw new DurableTaskAttachmentLinksMutationError('Task not found.', 'TASK_NOT_FOUND', 404);
                     if (existing.isArchived)
                         throw new DurableTaskAttachmentLinksMutationError('Archived tasks are read-only. Unarchive first to make changes.', 'TASK_ARCHIVED_READ_ONLY', 409);
+                    let cardCoverAssetId;
+                    try {
+                        cardCoverAssetId = resolveTaskCardCoverAssetIdForLinks({
+                            currentCardCoverAssetId: existing.cardCoverAssetId,
+                            ...(Object.prototype.hasOwnProperty.call(input, 'cardCoverAssetId')
+                                ? { requestedCardCoverAssetId: input.cardCoverAssetId }
+                                : {}),
+                            links,
+                        });
+                    }
+                    catch (error) {
+                        throw new DurableTaskAttachmentLinksMutationError(error instanceof Error ? error.message : 'Task card cover is invalid.', 'TASK_ATTACHMENT_LINKS_INVALID', Number(error?.statusCode) || 400);
+                    }
                     const previousLinks = input.core.listTaskAttachmentLinksForDurableSync(input.taskId, input.workspaceId);
                     let attachments;
                     try {
@@ -126,7 +150,7 @@ export function runDurableTaskAttachmentLinksReplace(input) {
                     }
                     const updatedAt = nextUpdatedAt(String(existing.updatedAt || existing.createdAt), input.now);
                     const actorRef = resolveDeferredMutationActorRef(input);
-                    const task = input.core.updateTask(existing.id, { attachments }, input.workspaceId, {
+                    const task = input.core.updateTask(existing.id, { attachments, cardCoverAssetId }, input.workspaceId, {
                         persistBackup: false, emitRealtime: false, syncUpdatedAt: updatedAt,
                         actorRef, skipTaskEvents: true,
                         preferExplicitAttachmentRole: true,
@@ -165,9 +189,10 @@ export function runDurableTaskAttachmentLinksReplace(input) {
                                 sequence: attachmentLinksRevision.sequence,
                                 entityRevision: attachmentLinksRevision.entityRevision,
                                 lifecycleRevision: attachmentLinksRevision.lifecycleRevision,
-                                payload: serializeWorkspaceSyncV3TaskAttachmentLinksPayload({
+                                payload: serializeWorkspaceSyncV3TaskAttachmentLinksV2Payload({
                                     taskId: task.id,
                                     links: input.core.listTaskAttachmentLinksForDurableSync(task.id, input.workspaceId),
+                                    cardCoverAssetId: task.cardCoverAssetId ?? null,
                                 }),
                             },
                         },

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

@@ -4,13 +4,13 @@ import { serializeTaskActivityForSync, type WorkspaceSyncActivityRevision } from
 import { WorkspaceSyncDurabilityStore } from './syncDurabilityStore.js';
 import { type WorkspaceSyncV3TaskChecklistPayload } from './workspaceSyncV3NestedTaskCodecs.js';
 export declare class DurableTaskChecklistMutationError extends Error {
-    readonly code: 'TASK_NOT_FOUND' | 'TASK_ARCHIVED_READ_ONLY' | 'TASK_CHECKLIST_INVALID' | 'TASK_CHECKLIST_IDENTITY_CONFLICT' | 'WORKSPACE_SYNC_OPERATION_ID_REQUIRED' | 'TASK_CHECKLIST_DEPENDENCY_PENDING';
+    readonly code: 'TASK_NOT_FOUND' | 'TASK_ARCHIVED_READ_ONLY' | 'TASK_CHECKLIST_INVALID' | 'TASK_CHECKLIST_IDENTITY_CONFLICT' | 'WORKSPACE_SYNC_OPERATION_ID_REQUIRED' | 'TASK_CHECKLIST_DEPENDENCY_PENDING' | 'TASK_DETAIL_REVISION_CONFLICT';
     readonly statusCode: number;
     readonly details?: Record<string, unknown> | undefined;
     readonly retryable?: boolean | undefined;
     readonly retryAfterAt?: string | undefined;
     readonly retryHint?: string | undefined;
-    constructor(message: string, code: 'TASK_NOT_FOUND' | 'TASK_ARCHIVED_READ_ONLY' | 'TASK_CHECKLIST_INVALID' | 'TASK_CHECKLIST_IDENTITY_CONFLICT' | 'WORKSPACE_SYNC_OPERATION_ID_REQUIRED' | 'TASK_CHECKLIST_DEPENDENCY_PENDING', statusCode: number, details?: Record<string, unknown> | undefined, retryable?: boolean | undefined, retryAfterAt?: string | undefined, retryHint?: string | undefined);
+    constructor(message: string, code: 'TASK_NOT_FOUND' | 'TASK_ARCHIVED_READ_ONLY' | 'TASK_CHECKLIST_INVALID' | 'TASK_CHECKLIST_IDENTITY_CONFLICT' | 'WORKSPACE_SYNC_OPERATION_ID_REQUIRED' | 'TASK_CHECKLIST_DEPENDENCY_PENDING' | 'TASK_DETAIL_REVISION_CONFLICT', statusCode: number, details?: Record<string, unknown> | undefined, retryable?: boolean | undefined, retryAfterAt?: string | undefined, retryHint?: string | undefined);
 }
 export type DurableTaskChecklistResponse = {
     success: true;
@@ -88,5 +88,7 @@ export declare function runDurableTaskChecklistReplace(input: {
     actorRef: string;
     resolveActorRef?: () => string;
     originActorRef?: string;
+    expectedDetailRevision?: string;
+    assertPrecondition?: () => void;
     onPostCommitError?: (error: unknown) => void;
 }): DurableTaskChecklistMutationResult;

package/dist/sync/v3/taskChecklistMutationService.js

@@ -58,6 +58,9 @@ export function runDurableTaskChecklistReplace(input) {
             baseLifecycleRevision: String(input.baseLifecycleRevision),
             items,
             ...(input.originActorRef ? { originActorRef: input.originActorRef } : {}),
+            ...(input.expectedDetailRevision
+                ? { expectedDetailRevision: input.expectedDetailRevision }
+                : {}),
         },
     });
     const activityEventId = buildTaskChecklistActivityEventId({
@@ -100,6 +103,7 @@ export function runDurableTaskChecklistReplace(input) {
                 }),
             }, buildTaskActivityJournalEntry({ eventId: activityEventId, readEvent: readActivity })],
         applyMutation: () => {
+            input.assertPrecondition?.();
             const existing = input.core.getTask(input.taskId, input.workspaceId);
             if (!existing)
                 throw new DurableTaskChecklistMutationError('Task not found.', 'TASK_NOT_FOUND', 404);

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

@@ -2,7 +2,7 @@ import { type DurableTaskCreateMutationCore } from '../../core/TaskDurableCreate
 import type { EntityEvent, TaskEvent, TaskItem } from '../../core/Taskforce.js';
 import { serializeTaskForSync } from '../taskSyncPayload.js';
 import type { WorkspaceSyncTaskEventSnapshot } from '../workspaceSyncModel.js';
-import { serializeWorkspaceSyncV3TaskAttachmentLinksPayload, serializeWorkspaceSyncV3TaskChecklistPayload, serializeWorkspaceSyncV3TaskCommentsPayload, type WorkspaceSyncV3TaskAttachmentLink } from './workspaceSyncV3NestedTaskCodecs.js';
+import { serializeWorkspaceSyncV3TaskAttachmentLinksV2Payload, serializeWorkspaceSyncV3TaskChecklistPayload, serializeWorkspaceSyncV3TaskCommentsPayload, type WorkspaceSyncV3TaskAttachmentLink } from './workspaceSyncV3NestedTaskCodecs.js';
 import { type WorkspaceSyncActivityRevision } from './taskActivityJournal.js';
 import { WorkspaceSyncDurabilityStore } from './syncDurabilityStore.js';
 export interface DurableTaskCreateServiceCore extends DurableTaskCreateMutationCore {
@@ -64,7 +64,7 @@ export type DurableTaskCreateResponse = {
         sequence: string;
         entityRevision: string;
         lifecycleRevision: string;
-        payload: ReturnType<typeof serializeWorkspaceSyncV3TaskAttachmentLinksPayload>;
+        payload: ReturnType<typeof serializeWorkspaceSyncV3TaskAttachmentLinksV2Payload>;
     };
     activity: WorkspaceSyncTaskEventSnapshot;
     activityRevision: WorkspaceSyncActivityRevision;

package/dist/sync/v3/taskCreateMutationService.js

@@ -1,7 +1,7 @@
 import { applyTaskCreateForDurableSync, assertTaskCreateIdentityAvailable, validateDurableTaskCreateInput, } from '../../core/TaskDurableCreateMutationService.js';
 import { serializeTaskForSync } from '../taskSyncPayload.js';
 import { buildTaskCreateActivityEventId } from './taskCreateActivityIdentity.js';
-import { serializeWorkspaceSyncV3TaskAttachmentLinksPayload, serializeWorkspaceSyncV3TaskChecklistPayload, serializeWorkspaceSyncV3TaskCommentsPayload, } from './workspaceSyncV3NestedTaskCodecs.js';
+import { serializeWorkspaceSyncV3TaskAttachmentLinksPayload, serializeWorkspaceSyncV3TaskAttachmentLinksV2Payload, serializeWorkspaceSyncV3TaskChecklistPayload, serializeWorkspaceSyncV3TaskCommentsPayload, } from './workspaceSyncV3NestedTaskCodecs.js';
 import { asWorkspaceSyncActivityRevision, buildEntityActivityJournalEntry, buildTaskActivityJournalEntry, serializeTaskActivityForSync, } from './taskActivityJournal.js';
 import { fingerprintWorkspaceSyncPayload, WORKSPACE_SYNC_CONTRACT_VERSION, } from './syncDurabilityStore.js';
 function requireZeroBaseRevision(value, label) {
@@ -151,13 +151,15 @@ export function runDurableTaskCreate(input) {
                 domain: 'task-attachment-links', entityId: taskId, mutationKind: 'replace', revisionKind: 'metadata',
                 baseEntityRevision: 0, baseLifecycleRevision: 0,
                 include: () => attachmentLinks.length > 0,
-                buildCanonicalFingerprint: (task) => fingerprintWorkspaceSyncPayload(serializeWorkspaceSyncV3TaskAttachmentLinksPayload({
+                buildCanonicalFingerprint: (task) => fingerprintWorkspaceSyncPayload(serializeWorkspaceSyncV3TaskAttachmentLinksV2Payload({
                     taskId: task.id,
                     links: input.core.listTaskAttachmentLinksForDurableSync(task.id, input.workspaceId),
+                    cardCoverAssetId: task.cardCoverAssetId ?? null,
                 })),
-                buildAuthoritativePayload: (task) => serializeWorkspaceSyncV3TaskAttachmentLinksPayload({
+                buildAuthoritativePayload: (task) => serializeWorkspaceSyncV3TaskAttachmentLinksV2Payload({
                     taskId: task.id,
                     links: input.core.listTaskAttachmentLinksForDurableSync(task.id, input.workspaceId),
+                    cardCoverAssetId: task.cardCoverAssetId ?? null,
                 }),
             }, buildTaskActivityJournalEntry({ eventId: activityEventId, readEvent: readActivity }), {
                 ...buildEntityActivityJournalEntry({
@@ -257,9 +259,10 @@ export function runDurableTaskCreate(input) {
                         sequence: attachmentRevision.sequence,
                         entityRevision: attachmentRevision.entityRevision,
                         lifecycleRevision: attachmentRevision.lifecycleRevision,
-                        payload: serializeWorkspaceSyncV3TaskAttachmentLinksPayload({
+                        payload: serializeWorkspaceSyncV3TaskAttachmentLinksV2Payload({
                             taskId: task.id,
                             links: input.core.listTaskAttachmentLinksForDurableSync(task.id, input.workspaceId),
+                            cardCoverAssetId: task.cardCoverAssetId ?? null,
                         }),
                     } } : {}),
                 activity: serializeTaskActivityForSync(activity),

package/dist/sync/v3/taskMetadataCoexistence.js

@@ -57,8 +57,12 @@ export function preserveV3OwnedTaskMetadata(incoming, existing) {
     return merged;
 }
 export function preserveV3OwnedTaskRoot(incoming, existing) {
+    const hasCardCoverAssetId = Object.prototype.hasOwnProperty.call(incoming, 'cardCoverAssetId');
     return {
         ...serializeTaskRootForSync(existing),
+        cardCoverAssetId: hasCardCoverAssetId
+            ? incoming.cardCoverAssetId ?? null
+            : existing.cardCoverAssetId ?? null,
         comments: incoming.comments ?? existing.comments,
         attachments: incoming.attachments ?? existing.attachments,
         checklistItems: incoming.checklistItems ?? existing.checklistItems,

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

@@ -45,6 +45,7 @@ export interface DurableTaskMetadataServiceCore extends DurableTaskMetadataMutat
         workspaceId: string;
         eventId: string;
     }): EntityEvent | null;
+    assertTaskDetailRevisionForUpdate?(id: string, expectedDetailRevision: string, workspaceId?: string): void;
 }
 export declare function runDurableTaskMetadataUpdate(input: {
     store: WorkspaceSyncDurabilityStore;
@@ -67,5 +68,7 @@ export declare function runDurableTaskMetadataUpdate(input: {
     originActorRef?: string;
     saveSource?: 'manual' | 'autosave';
     activityAction?: 'task-updated' | 'task-schedule-changed';
+    expectedDetailRevision?: string;
+    assertPrecondition?: () => void;
     onPostCommitError?: (error: unknown) => void;
 }): DurableTaskMetadataMutationResult;

package/dist/sync/v3/taskMetadataMutationService.js

@@ -35,6 +35,9 @@ export function runDurableTaskMetadataUpdate(input) {
             ...(input.activityAction && input.activityAction !== 'task-updated'
                 ? { activityAction: input.activityAction }
                 : {}),
+            ...(input.expectedDetailRevision
+                ? { expectedDetailRevision: input.expectedDetailRevision }
+                : {}),
         },
     });
     const activityEventId = buildTaskMetadataActivityEventId({
@@ -112,6 +115,7 @@ export function runDurableTaskMetadataUpdate(input) {
                 })),
             }],
         applyMutation: () => {
+            input.assertPrecondition?.();
             const actorRef = resolveDeferredMutationActorRef(input);
             if (!carriers)
                 return applyTaskMetadataUpdateForDurableSync({

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

@@ -2,7 +2,7 @@ import type { TaskEvent } from '../../core/Taskforce.js';
 import type { TaskRestoreDestination } from '../../shared/taskRestoreDestination.js';
 import { type DurableTaskRestoreCore } from '../../core/TaskDurableRestoreMutationService.js';
 import { serializeTaskForSync } from '../taskSyncPayload.js';
-import { serializeWorkspaceSyncV3TaskAttachmentLinksPayload, serializeWorkspaceSyncV3TaskChecklistPayload, serializeWorkspaceSyncV3TaskCommentsPayload, type WorkspaceSyncV3TaskAttachmentLink } from './workspaceSyncV3NestedTaskCodecs.js';
+import { serializeWorkspaceSyncV3TaskAttachmentLinksV2Payload, serializeWorkspaceSyncV3TaskChecklistPayload, serializeWorkspaceSyncV3TaskCommentsPayload, type WorkspaceSyncV3TaskAttachmentLink } from './workspaceSyncV3NestedTaskCodecs.js';
 import { type WorkspaceSyncActivityRevision } from './taskActivityJournal.js';
 import { WorkspaceSyncDurabilityStore } from './syncDurabilityStore.js';
 export interface DurableTaskRestoreServiceCore extends DurableTaskRestoreCore {
@@ -57,7 +57,7 @@ export type DurableTaskRestoreResponse = {
         sequence: string;
         entityRevision: string;
         lifecycleRevision: string;
-        payload: ReturnType<typeof serializeWorkspaceSyncV3TaskAttachmentLinksPayload>;
+        payload: ReturnType<typeof serializeWorkspaceSyncV3TaskAttachmentLinksV2Payload>;
     };
     activity: TaskEvent;
     activityRevision: WorkspaceSyncActivityRevision;

package/dist/sync/v3/taskRestoreMutationService.js

@@ -1,7 +1,7 @@
 import { applyTaskRestoreForDurableSync, } from '../../core/TaskDurableRestoreMutationService.js';
 import { serializeTaskForSync } from '../taskSyncPayload.js';
 import { buildTaskLifecycleActivityEventId } from './taskLifecycleActivityIdentity.js';
-import { serializeWorkspaceSyncV3TaskAttachmentLinksPayload, serializeWorkspaceSyncV3TaskChecklistPayload, serializeWorkspaceSyncV3TaskCommentsPayload, } from './workspaceSyncV3NestedTaskCodecs.js';
+import { serializeWorkspaceSyncV3TaskAttachmentLinksV2Payload, serializeWorkspaceSyncV3TaskChecklistPayload, serializeWorkspaceSyncV3TaskCommentsPayload, } from './workspaceSyncV3NestedTaskCodecs.js';
 import { asWorkspaceSyncActivityRevision, buildTaskActivityJournalEntry, } from './taskActivityJournal.js';
 import { fingerprintWorkspaceSyncPayload, WORKSPACE_SYNC_CONTRACT_VERSION, } from './syncDurabilityStore.js';
 export function runDurableTaskRestore(input) {
@@ -90,13 +90,15 @@ export function runDurableTaskRestore(input) {
                 domain: 'task-attachment-links', entityId: input.taskId, mutationKind: 'replace', revisionKind: 'metadata',
                 baseEntityRevision: 0, baseLifecycleRevision: 0,
                 baseRevisionPolicy: 'current',
-                buildCanonicalFingerprint: (task) => fingerprintWorkspaceSyncPayload(serializeWorkspaceSyncV3TaskAttachmentLinksPayload({
+                buildCanonicalFingerprint: (task) => fingerprintWorkspaceSyncPayload(serializeWorkspaceSyncV3TaskAttachmentLinksV2Payload({
                     taskId: task.id,
                     links: input.core.listTaskAttachmentLinksForDurableSync(task.id, input.workspaceId),
+                    cardCoverAssetId: task.cardCoverAssetId ?? null,
                 })),
-                buildAuthoritativePayload: (task) => serializeWorkspaceSyncV3TaskAttachmentLinksPayload({
+                buildAuthoritativePayload: (task) => serializeWorkspaceSyncV3TaskAttachmentLinksV2Payload({
                     taskId: task.id,
                     links: input.core.listTaskAttachmentLinksForDurableSync(task.id, input.workspaceId),
+                    cardCoverAssetId: task.cardCoverAssetId ?? null,
                 }),
             }, buildTaskActivityJournalEntry({ eventId: activityEventId, readEvent: readActivity })],
         applyMutation: () => applyTaskRestoreForDurableSync({
@@ -151,9 +153,10 @@ export function runDurableTaskRestore(input) {
                     domain: 'task-attachment-links', entityId: task.id, mutationKind: 'replace',
                     sequence: attachmentRevision.sequence, entityRevision: attachmentRevision.entityRevision,
                     lifecycleRevision: attachmentRevision.lifecycleRevision,
-                    payload: serializeWorkspaceSyncV3TaskAttachmentLinksPayload({
+                    payload: serializeWorkspaceSyncV3TaskAttachmentLinksV2Payload({
                         taskId: task.id,
                         links: input.core.listTaskAttachmentLinksForDurableSync(task.id, input.workspaceId),
+                        cardCoverAssetId: task.cardCoverAssetId ?? null,
                     }),
                 },
                 activity: readActivity(),

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

@@ -64,6 +64,8 @@ export declare function runDurableTaskStatusMutation(input: {
     resolveActorRef?: () => string;
     originActorRef?: string;
     includeWorkflowRuntimeJournal?: boolean;
+    expectedDetailRevision?: string;
+    assertPrecondition?: () => void;
     onPostCommitError?: (error: unknown) => void;
 }): {
     state: 'in_progress';

package/dist/sync/v3/taskStatusMutationService.js

@@ -34,6 +34,9 @@ export function runDurableTaskStatusMutation(input) {
             baseLifecycleRevision: String(input.baseLifecycleRevision),
             payload: operationPayload,
             ...(input.originActorRef ? { originActorRef: input.originActorRef } : {}),
+            ...(input.expectedDetailRevision
+                ? { expectedDetailRevision: input.expectedDetailRevision }
+                : {}),
         },
     });
     const activityEventId = buildTaskLifecycleActivityEventId({
@@ -184,6 +187,7 @@ export function runDurableTaskStatusMutation(input) {
                 })),
             }, ...workflowEntries],
         applyMutation: () => {
+            input.assertPrecondition?.();
             const currentTask = input.core.getTask(input.taskId, input.workspaceId);
             if (operationPayload.workflowAssignment) {
                 if (payload.status !== 'in-progress'

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

@@ -2,6 +2,7 @@ import type { WorkflowAssignmentSyncRecord, WorkflowExecutionEventRecord, Workfl
 import { type DurableTaskStatusMutationPayload } from '../../core/TaskDurableStatusMutationService.js';
 export type TaskStatusOperationWithWorkflowAssignment = DurableTaskStatusMutationPayload & {
     workflowAssignment?: WorkflowAssignmentSyncRecord;
+    expectedDetailRevision?: string;
 };
 export declare class WorkflowAssignmentSyncError extends Error {
     readonly code = "WORKFLOW_ASSIGNMENT_SYNC_INVALID";

package/dist/sync/v3/workflowAssignmentSync.js

@@ -209,5 +209,8 @@ export function normalizeTaskStatusOperationWithWorkflowAssignment(raw) {
             ? {}
             : { workflowAssignment: normalizeWorkflowAssignmentSyncRecord(source.workflowAssignment) }),
         ...(originActor ? { originActor } : {}),
+        ...(typeof source.expectedDetailRevision === 'string' && source.expectedDetailRevision.trim()
+            ? { expectedDetailRevision: source.expectedDetailRevision.trim() }
+            : {}),
     };
 }

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

@@ -1,6 +1,6 @@
 import type { WorkspaceSyncIncomingTaskApplyModel } from '../syncApplyHandlers.js';
 import type { WorkspaceSyncChange } from '../workspaceSyncModel.js';
-export declare const WORKSPACE_SYNC_V2_EXCLUDABLE_PROJECTIONS: readonly ["task/root-v1", "task-relationship/full-v1", "taxonomy/full-v1", "initiative/full-v1", "workstream/full-v1", "task-comments/full-v1", "task-checklist/full-v1", "task-attachment-links/full-v1", "entity-event/full-v1", "workstream-task-order/full-v1"];
+export declare const WORKSPACE_SYNC_V2_EXCLUDABLE_PROJECTIONS: readonly ["task/root-v1", "task-relationship/full-v1", "taxonomy/full-v1", "initiative/full-v1", "workstream/full-v1", "task-comments/full-v1", "task-checklist/full-v1", "task-attachment-links/full-v1", "task-attachment-links/full-v2", "entity-event/full-v1", "workstream-task-order/full-v1"];
 export type WorkspaceSyncV2ProjectionExclusion = typeof WORKSPACE_SYNC_V2_EXCLUDABLE_PROJECTIONS[number];
 export declare const WORKSPACE_SYNC_V3_COMBINED_V2_EXCLUSIONS: readonly WorkspaceSyncV2ProjectionExclusion[];
 export declare function normalizeWorkspaceSyncV2ProjectionExclusions(values: Iterable<unknown> | null | undefined): WorkspaceSyncV2ProjectionExclusion[];

package/dist/sync/v3/workspaceSyncV2ProjectionExclusions.js

@@ -8,6 +8,7 @@ export const WORKSPACE_SYNC_V2_EXCLUDABLE_PROJECTIONS = Object.freeze([
     'task-comments/full-v1',
     'task-checklist/full-v1',
     'task-attachment-links/full-v1',
+    'task-attachment-links/full-v2',
     'entity-event/full-v1',
     'workstream-task-order/full-v1',
 ]);
@@ -49,10 +50,9 @@ export function prepareWorkspaceSyncV2TaskCarriers(taskMutations, excludedProjec
         return taskMutations;
     const commentsOwned = excludedProjections.has('task-comments/full-v1');
     const checklistOwned = excludedProjections.has('task-checklist/full-v1');
-    const attachmentsOwned = excludedProjections.has('task-attachment-links/full-v1');
-    if (commentsOwned && checklistOwned && attachmentsOwned) {
-        return { upserts: [], deletes: taskMutations.deletes };
-    }
+    const cardCoverOwned = excludedProjections.has('task-attachment-links/full-v2');
+    const attachmentsOwned = excludedProjections.has('task-attachment-links/full-v1')
+        || cardCoverOwned;
     return {
         upserts: taskMutations.upserts.map(({ archived, task }) => {
             const existing = readExistingTask?.(String(task.id || '').trim());
@@ -66,6 +66,7 @@ export function prepareWorkspaceSyncV2TaskCarriers(taskMutations, excludedProjec
                     ...(commentsOwned ? { comments: existing.comments || [] } : {}),
                     ...(checklistOwned ? { checklistItems: existing.checklistItems || [] } : {}),
                     ...(attachmentsOwned ? { attachments: existing.attachments || [] } : {}),
+                    ...(cardCoverOwned ? { cardCoverAssetId: existing.cardCoverAssetId ?? null } : {}),
                 },
             };
         }),
@@ -103,14 +104,12 @@ export function partitionWorkspaceSyncV2LegacyChanges(changes, excludedProjectio
         if (change.op === 'upsert') {
             const commentsOwned = excludedProjections.has('task-comments/full-v1');
             const checklistOwned = excludedProjections.has('task-checklist/full-v1');
-            const attachmentsOwned = excludedProjections.has('task-attachment-links/full-v1');
-            if (excludedProjections.has('task/root-v1') && commentsOwned && checklistOwned && attachmentsOwned) {
+            const attachmentProjection = excludedProjections.has('task-attachment-links/full-v2')
+                ? 'task-attachment-links/full-v2'
+                : 'task-attachment-links/full-v1';
+            const attachmentsOwned = excludedProjections.has(attachmentProjection);
+            if (excludedProjections.has('task/root-v1'))
                 suppress('task/root-v1');
-                suppress('task-comments/full-v1');
-                suppress('task-checklist/full-v1');
-                suppress('task-attachment-links/full-v1');
-                continue;
-            }
             if (commentsOwned || checklistOwned || attachmentsOwned) {
                 const task = { ...change.task };
                 if (commentsOwned) {
@@ -123,7 +122,10 @@ export function partitionWorkspaceSyncV2LegacyChanges(changes, excludedProjectio
                 }
                 if (attachmentsOwned) {
                     delete task.attachments;
-                    suppress('task-attachment-links/full-v1');
+                    if (attachmentProjection === 'task-attachment-links/full-v2') {
+                        delete task.cardCoverAssetId;
+                    }
+                    suppress(attachmentProjection);
                 }
                 accepted.push({ ...change, task });
                 continue;

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

@@ -15,10 +15,13 @@ export interface WorkspaceSyncV3AttachmentApplyObligation {
     createdAt: string;
     updatedAt: string;
     nextAttemptAt: string;
+    terminalAt: string | null;
+    terminalReason: string | null;
     resolvedAt: string | null;
 }
 export interface WorkspaceSyncV3AttachmentApplyObligationSummary {
     open: number;
+    terminal: number;
     due: number;
     oldestOpenCreatedAt: string | null;
     nextAttemptAt: string | null;
@@ -70,6 +73,14 @@ export declare class WorkspaceSyncV3AttachmentApplyObligationStore {
         taskId: string;
         now: string;
     }): void;
+    markTerminalUnavailable(input: {
+        tenantId: string;
+        workspaceId: string;
+        taskId: string;
+        canonicalFingerprint: string;
+        reason: string;
+        now: string;
+    }): void;
     recordAttemptFailure(input: {
         tenantId: string;
         workspaceId: string;

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>;