@taskforcehq/taskforce 0.3.328 → 0.3.329

package/dist/sync/v3/localTaskCreateOutboxService.js

@@ -5,7 +5,7 @@ import { validateTaskActivityAuthoritativeRevision } from './taskActivityAuthori
 import { serializeEntityActivityForSync, serializeTaskActivityForSync, WORKSPACE_SYNC_ENTITY_EVENT_APPEND, WORKSPACE_SYNC_ENTITY_EVENT_DOMAIN, } from './taskActivityJournal.js';
 import { fingerprintWorkspaceSyncPayload, } from './syncDurabilityStore.js';
 import { serializeTaskRootForSync } from './workspaceSyncV3TaskRootProjection.js';
-import { serializeWorkspaceSyncV3TaskAttachmentLinksPayload, serializeWorkspaceSyncV3TaskChecklistPayload, serializeWorkspaceSyncV3TaskCommentsPayload, validateWorkspaceSyncV3TaskAttachmentLinksPayload, validateWorkspaceSyncV3TaskChecklistPayload, } from './workspaceSyncV3NestedTaskCodecs.js';
+import { serializeWorkspaceSyncV3TaskAttachmentLinksPayload, serializeWorkspaceSyncV3TaskAttachmentLinksV2Payload, serializeWorkspaceSyncV3TaskChecklistPayload, serializeWorkspaceSyncV3TaskCommentsPayload, validateWorkspaceSyncV3TaskAttachmentLinksPayload, validateWorkspaceSyncV3TaskAttachmentLinksV2Payload, validateWorkspaceSyncV3TaskChecklistPayload, } from './workspaceSyncV3NestedTaskCodecs.js';
 export class LocalAuthoritativeTaskCreateError extends Error {
     code = 'WORKSPACE_SYNC_AUTHORITATIVE_RESPONSE_INVALID';
     constructor(message) {
@@ -264,7 +264,9 @@ export function applyAuthoritativeTaskCreateAndAck(input) {
             throw new LocalAuthoritativeTaskCreateError('Authoritative task create attachment-link projection is invalid.');
         }
         try {
-            canonicalAttachmentProjection = validateWorkspaceSyncV3TaskAttachmentLinksPayload(attachmentProjection.payload);
+            canonicalAttachmentProjection = Object.prototype.hasOwnProperty.call(attachmentProjection.payload, 'cardCoverAssetId')
+                ? validateWorkspaceSyncV3TaskAttachmentLinksV2Payload(attachmentProjection.payload)
+                : validateWorkspaceSyncV3TaskAttachmentLinksPayload(attachmentProjection.payload);
         }
         catch {
             throw new LocalAuthoritativeTaskCreateError('Authoritative task create attachment-link payload is invalid.');
@@ -272,10 +274,16 @@ export function applyAuthoritativeTaskCreateAndAck(input) {
         if (canonicalAttachmentProjection.taskId !== task.id) {
             throw new LocalAuthoritativeTaskCreateError('Authoritative task create attachment-link identity is invalid.');
         }
-        const capturedAttachmentProjection = serializeWorkspaceSyncV3TaskAttachmentLinksPayload({
-            taskId: task.id,
-            links: input.core.listTaskAttachmentLinksForDurableSync(task.id, input.identity.workspaceId),
-        });
+        const capturedAttachmentProjection = 'cardCoverAssetId' in canonicalAttachmentProjection
+            ? serializeWorkspaceSyncV3TaskAttachmentLinksV2Payload({
+                taskId: task.id,
+                links: input.core.listTaskAttachmentLinksForDurableSync(task.id, input.identity.workspaceId),
+                cardCoverAssetId: task.cardCoverAssetId ?? null,
+            })
+            : serializeWorkspaceSyncV3TaskAttachmentLinksPayload({
+                taskId: task.id,
+                links: input.core.listTaskAttachmentLinksForDurableSync(task.id, input.identity.workspaceId),
+            });
         const relationshipIntent = (projection) => ({
             taskId: projection.taskId,
             links: projection.links.map(({ assetId, role, order, displayName }) => ({
@@ -284,6 +292,7 @@ export function applyAuthoritativeTaskCreateAndAck(input) {
                 order,
                 ...(displayName ? { displayName } : {}),
             })),
+            ...('cardCoverAssetId' in projection ? { cardCoverAssetId: projection.cardCoverAssetId } : {}),
         });
         if (fingerprintWorkspaceSyncPayload(relationshipIntent(canonicalAttachmentProjection))
             !== fingerprintWorkspaceSyncPayload(relationshipIntent(capturedAttachmentProjection))) {

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

@@ -7,6 +7,7 @@ export declare function createLocalTaskMetadataClient(input?: LocalTaskOperation
         entityId: string;
         patch: Partial<TaskItem>;
         saveSource?: "manual" | "autosave";
+        expectedDetailRevision?: string;
         isAuthenticated: boolean;
         dispatchEnabled?: boolean;
     }): Promise<LocalTaskMetadataMutationResult>;

package/dist/sync/v3/localTaskMetadataClient.js

@@ -15,6 +15,7 @@ export function createLocalTaskMetadataClient(input = {}) {
                 payload: {
                     patch,
                     ...(inputValue.saveSource ? { saveSource: inputValue.saveSource } : {}),
+                    ...(inputValue.expectedDetailRevision ? { expectedDetailRevision: inputValue.expectedDetailRevision } : {}),
                 },
             };
             return client.execute({

package/dist/sync/v3/localTaskMetadataOutboxHandler.js

@@ -18,12 +18,15 @@ function buildTaskMetadataEnvelope(record) {
         throw new Error('Local outbox payload must be an object.');
     }
     const payloadRecord = payload;
-    const allowedKeys = new Set(['patch', 'saveSource', 'originActor']);
+    const allowedKeys = new Set(['patch', 'saveSource', 'expectedDetailRevision', 'originActor']);
     if (!Object.prototype.hasOwnProperty.call(payloadRecord, 'patch')
         || Object.keys(payloadRecord).some((key) => !allowedKeys.has(key))) {
         throw new Error('Local task metadata outbox payload must contain patch and optional saveSource/originActor.');
     }
     const saveSource = payloadRecord.saveSource;
+    const expectedDetailRevision = typeof payloadRecord.expectedDetailRevision === 'string'
+        ? payloadRecord.expectedDetailRevision
+        : undefined;
     if (saveSource !== undefined && saveSource !== 'manual' && saveSource !== 'autosave') {
         throw new Error('Local task metadata outbox saveSource must be manual or autosave.');
     }
@@ -41,6 +44,7 @@ function buildTaskMetadataEnvelope(record) {
             payload: {
                 patch: validateDurableTaskMetadataPatch(payloadRecord.patch),
                 ...(saveSource ? { saveSource } : {}),
+                ...(expectedDetailRevision ? { expectedDetailRevision } : {}),
                 ...(payloadRecord.originActor !== undefined
                     ? { originActor: parseWorkspaceSyncV3OriginActor(payloadRecord.originActor) }
                     : {}),

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

@@ -17,6 +17,7 @@ export interface LocalTaskMetadataOutboxCore {
         allowAuthoritativeReplacement?: boolean;
     }): unknown;
     notifyDurableTaskMetadataCommitted(workspaceId: string, taskId: string): void;
+    assertTaskDetailRevisionForUpdate?(id: string, expectedDetailRevision: string, workspaceId?: string): void;
 }
 export declare class LocalAuthoritativeTaskMetadataError extends Error {
     readonly code = "WORKSPACE_SYNC_AUTHORITATIVE_RESPONSE_INVALID";
@@ -29,6 +30,7 @@ export declare function enqueueLocalTaskMetadataMutation(input: {
     taskId: string;
     patch: Partial<TaskItem>;
     saveSource?: 'manual' | 'autosave';
+    expectedDetailRevision?: string;
     now: string;
     actorRef: string;
     requireV3CombinedOwnership?: boolean;

package/dist/sync/v3/localTaskMetadataOutboxService.js

@@ -30,10 +30,17 @@ export function enqueueLocalTaskMetadataMutation(input) {
         payload: withOriginActorPayload({
             patch,
             ...(input.saveSource ? { saveSource: input.saveSource } : {}),
+            ...(input.expectedDetailRevision ? { expectedDetailRevision: input.expectedDetailRevision } : {}),
         }, input.actorRef),
         ...(input.requireV3CombinedOwnership ? { requireV3PlanningOwnership: 'combined' } : {}),
         now: input.now,
         applyLocalMutation: () => {
+            if (input.expectedDetailRevision) {
+                if (!input.core.assertTaskDetailRevisionForUpdate) {
+                    throw new DurableTaskMetadataMutationError('Task detail revision checks are unavailable.', 'DURABLE_TASK_PATCH_INVALID', 500);
+                }
+                input.core.assertTaskDetailRevisionForUpdate(input.taskId, input.expectedDetailRevision, input.identity.workspaceId);
+            }
             const task = input.core.updateTask(input.taskId, patch, input.identity.workspaceId, {
                 persistBackup: false,
                 emitRealtime: false,

package/dist/sync/v3/localTaskRestoreOutboxService.js

@@ -5,7 +5,7 @@ import { buildTaskLifecycleActivityEventId } from './taskLifecycleActivityIdenti
 import { validateTaskActivityAuthoritativeRevision } from './taskActivityAuthoritativeRevision.js';
 import { serializeTaskActivityForSync, WORKSPACE_SYNC_ENTITY_EVENT_APPEND, WORKSPACE_SYNC_ENTITY_EVENT_DOMAIN, } from './taskActivityJournal.js';
 import { fingerprintWorkspaceSyncPayload, WorkspaceSyncIdempotencyConflictError, } from './syncDurabilityStore.js';
-import { serializeWorkspaceSyncV3TaskAttachmentLinksPayload, serializeWorkspaceSyncV3TaskChecklistPayload, serializeWorkspaceSyncV3TaskCommentsPayload, validateWorkspaceSyncV3TaskAttachmentLinksPayload, validateWorkspaceSyncV3TaskChecklistPayload, validateWorkspaceSyncV3TaskCommentsPayload, } from './workspaceSyncV3NestedTaskCodecs.js';
+import { serializeWorkspaceSyncV3TaskAttachmentLinksPayload, serializeWorkspaceSyncV3TaskAttachmentLinksV2Payload, serializeWorkspaceSyncV3TaskChecklistPayload, serializeWorkspaceSyncV3TaskCommentsPayload, validateWorkspaceSyncV3TaskAttachmentLinksV2Payload, validateWorkspaceSyncV3TaskAttachmentLinksPayload, validateWorkspaceSyncV3TaskChecklistPayload, validateWorkspaceSyncV3TaskCommentsPayload, } from './workspaceSyncV3NestedTaskCodecs.js';
 export class LocalAuthoritativeTaskRestoreError extends Error {
     code = 'WORKSPACE_SYNC_AUTHORITATIVE_RESPONSE_INVALID';
     constructor(message) {
@@ -190,7 +190,9 @@ export function applyAuthoritativeTaskRestoreAndAck(input) {
     let canonicalAttachments;
     try {
         canonicalChecklist = validateWorkspaceSyncV3TaskChecklistPayload(checklist.payload);
-        canonicalAttachments = validateWorkspaceSyncV3TaskAttachmentLinksPayload(attachments.payload);
+        canonicalAttachments = Object.prototype.hasOwnProperty.call(attachments.payload, 'cardCoverAssetId')
+            ? validateWorkspaceSyncV3TaskAttachmentLinksV2Payload(attachments.payload)
+            : validateWorkspaceSyncV3TaskAttachmentLinksPayload(attachments.payload);
     }
     catch {
         throw new LocalAuthoritativeTaskRestoreError('Authoritative task restore nested projection is invalid.');
@@ -214,10 +216,16 @@ export function applyAuthoritativeTaskRestoreAndAck(input) {
             !== fingerprintWorkspaceSyncPayload(serializeWorkspaceSyncV3TaskChecklistPayload({ taskId: task.id, items: task.checklistItems || [] }))) {
         throw new LocalAuthoritativeTaskRestoreError('Authoritative task restore projections do not match the task payload.');
     }
-    const capturedAttachments = serializeWorkspaceSyncV3TaskAttachmentLinksPayload({
-        taskId: task.id,
-        links: input.core.listTaskAttachmentLinksForDurableSync(task.id, input.identity.workspaceId),
-    });
+    const capturedAttachments = 'cardCoverAssetId' in canonicalAttachments
+        ? serializeWorkspaceSyncV3TaskAttachmentLinksV2Payload({
+            taskId: task.id,
+            links: input.core.listTaskAttachmentLinksForDurableSync(task.id, input.identity.workspaceId),
+            cardCoverAssetId: task.cardCoverAssetId ?? null,
+        })
+        : serializeWorkspaceSyncV3TaskAttachmentLinksPayload({
+            taskId: task.id,
+            links: input.core.listTaskAttachmentLinksForDurableSync(task.id, input.identity.workspaceId),
+        });
     if (fingerprintWorkspaceSyncPayload(canonicalAttachments)
         !== fingerprintWorkspaceSyncPayload(capturedAttachments)) {
         throw new LocalAuthoritativeTaskRestoreError('Authoritative task restore attachment links do not match the captured projection.');

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

@@ -9,6 +9,7 @@ export type LocalTaskStatusMutationInput = {
     assigneeIntent: DurableTaskStatusAssigneeIntent;
     canceledReason: string | null;
     metadataPatch?: Partial<TaskItem>;
+    expectedDetailRevision?: string;
     isAuthenticated: boolean;
     dispatchEnabled?: boolean;
 };

package/dist/sync/v3/localTaskStatusClient.js

@@ -20,7 +20,12 @@ export function createLocalTaskStatusClient(input = {}) {
                 domain: 'task',
                 entityId,
                 mutationKind: 'set-status',
-                payload,
+                payload: {
+                    ...payload,
+                    ...(inputValue.expectedDetailRevision
+                        ? { expectedDetailRevision: inputValue.expectedDetailRevision }
+                        : {}),
+                },
             };
             return client.execute({
                 workspaceId,

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

@@ -3,6 +3,7 @@ import { type DurableTaskStatusMutationCore, type DurableTaskStatusMutationPaylo
 import { WorkspaceSyncDurabilityStore, type WorkspaceSyncOperationIdentity, type WorkspaceSyncOutboxRecord } from './syncDurabilityStore.js';
 import type { DatabaseAdapter } from '../../storage/databaseAdapter.js';
 export interface LocalTaskStatusOutboxCore extends DurableTaskStatusMutationCore {
+    assertTaskDetailRevisionForUpdate?(id: string, expectedDetailRevision: string, workspaceId?: string): void;
     getDatabaseAdapter(): DatabaseAdapter;
     getTenantId(): string;
     installDurableTaskStatusAuthoritativeForSync(task: TaskItem, payload: DurableTaskStatusMutationPayload, installAssignee: boolean, workspaceId: string): TaskItem;
@@ -33,6 +34,7 @@ export declare function enqueueLocalTaskStatusMutation(input: {
     identity: WorkspaceSyncOperationIdentity;
     taskId: string;
     payload: unknown;
+    expectedDetailRevision?: string;
     now: string;
     actorRef: string;
     requireV3CombinedOwnership?: boolean;

package/dist/sync/v3/localTaskStatusOutboxService.js

@@ -74,23 +74,42 @@ export function enqueueLocalTaskStatusMutation(input) {
             taskLifecycle: true,
             taskAssignee: payload.assigneeIntent.kind !== 'preserve',
         },
-        payload: withOriginActorPayload({ ...payload }, input.actorRef),
+        payload: withOriginActorPayload({
+            ...payload,
+            ...(input.expectedDetailRevision
+                ? { expectedDetailRevision: input.expectedDetailRevision }
+                : {}),
+        }, input.actorRef),
         ...(payload.workflowAssignment ? {
             coalesceWorkflowAssignmentExecutionId: payload.workflowAssignment.execution.id,
         } : {}),
         ...(input.requireV3CombinedOwnership ? { requireV3PlanningOwnership: 'combined' } : {}),
         now: input.now,
-        applyLocalMutation: () => applyTaskStatusMutationForDurableSync({
-            core: input.core,
-            workspaceId: input.identity.workspaceId,
-            taskId,
-            targetStatus: statusPayload.status,
-            metadataPatch: statusPayload.metadataPatch,
-            assigneeIntent: statusPayload.assigneeIntent,
-            canceledReason: statusPayload.canceledReason,
-            updatedAt: input.now,
-            actorRef: input.actorRef,
-            taskEventId: activityEventId,
+        applyLocalMutation: () => {
+            if (input.expectedDetailRevision) {
+                if (!input.core.assertTaskDetailRevisionForUpdate) {
+                    throw new Error('Task detail revision checks are unavailable.');
+                }
+                input.core.assertTaskDetailRevisionForUpdate(taskId, input.expectedDetailRevision, input.identity.workspaceId);
+            }
+            return applyTaskStatusMutationForDurableSync({
+                core: input.core,
+                workspaceId: input.identity.workspaceId,
+                taskId,
+                targetStatus: statusPayload.status,
+                metadataPatch: statusPayload.metadataPatch,
+                assigneeIntent: statusPayload.assigneeIntent,
+                canceledReason: statusPayload.canceledReason,
+                updatedAt: input.now,
+                actorRef: input.actorRef,
+                taskEventId: activityEventId,
+            });
+        },
+        buildCanonicalIntent: (result) => ({
+            metadataPatch: Object.fromEntries(Object.keys(payload.metadataPatch).map((key) => [
+                key,
+                result.task[key] ?? null,
+            ])),
         }),
     });
     if (!result.enqueued)
@@ -189,9 +208,31 @@ export function applyAuthoritativeTaskStatusAndAck(input) {
     const localCanonical = input.core.getTask(task.id, input.identity.workspaceId);
     if (!localCanonical)
         throw new LocalAuthoritativeTaskStatusError('Local task status projection is missing.');
+    let canonicalMetadataIntent = null;
+    if (input.record.canonicalIntentJson) {
+        try {
+            const parsed = JSON.parse(input.record.canonicalIntentJson);
+            canonicalMetadataIntent = parsed.metadataPatch
+                && typeof parsed.metadataPatch === 'object'
+                && !Array.isArray(parsed.metadataPatch)
+                ? parsed.metadataPatch
+                : null;
+        }
+        catch {
+            canonicalMetadataIntent = null;
+        }
+        if (!canonicalMetadataIntent) {
+            throw new LocalAuthoritativeTaskStatusError('Persisted canonical task status intent is invalid.');
+        }
+    }
     for (const key of Object.keys(payload.metadataPatch)) {
+        if (canonicalMetadataIntent && !Object.prototype.hasOwnProperty.call(canonicalMetadataIntent, key)) {
+            throw new LocalAuthoritativeTaskStatusError('Persisted canonical task status intent is incomplete.');
+        }
         const actual = task[key];
-        const expected = localCanonical[key];
+        const expected = canonicalMetadataIntent
+            ? canonicalMetadataIntent[key]
+            : localCanonical[key];
         if (fingerprintWorkspaceSyncPayload(actual ?? null) !== fingerprintWorkspaceSyncPayload(expected ?? null)) {
             throw new LocalAuthoritativeTaskStatusError('Authoritative task metadata does not match the persisted request.');
         }

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

@@ -80,6 +80,7 @@ export type WorkspaceSyncOutboxRecord = WorkspaceSyncOperationIdentity & {
     baseLifecycleRevision: string;
     payloadJson: string;
     payloadFingerprint: string;
+    canonicalIntentJson: string | null;
     status: string;
     attemptCount: number;
     initialNotFoundAttemptCount: number;
@@ -542,6 +543,7 @@ export declare class WorkspaceSyncDurabilityStore {
         queuedTaskSuccessor?: boolean;
         queuedWorkflowRuntimeSuccessor?: boolean;
         coalesceWorkflowAssignmentExecutionId?: string;
+        buildCanonicalIntent?: (mutationResult: T) => unknown;
     }): {
         enqueued: boolean;
         mutationResult?: T;
@@ -760,6 +762,11 @@ export declare class WorkspaceSyncDurabilityStore {
     private assertTaskCommentAppendRecoveryEventOwned;
     private isTaskCommentAppendRecoveryIntentSatisfied;
     private prepareTaskRecoveryPayload;
+    lockWorkspaceSequenceForMutation(input: {
+        tenantId: string;
+        workspaceId: string;
+        now: string;
+    }): void;
     private allocateSequenceRange;
     private allocateOutboxEnqueueSequence;
     private readOperationRow;

package/dist/sync/v3/syncDurabilityStore.js

@@ -791,7 +791,7 @@ export class WorkspaceSyncDurabilityStore {
                    mutation_kind, owns_task_metadata, owns_task_lifecycle, owns_task_assignee,
                    CAST(base_entity_revision AS TEXT) AS base_entity_revision,
                    CAST(base_lifecycle_revision AS TEXT) AS base_lifecycle_revision,
-                   payload_json, payload_fingerprint, status, attempt_count,
+                   payload_json, payload_fingerprint, canonical_intent_json, status, attempt_count,
                    initial_not_found_attempt_count,
                    CAST(enqueue_sequence AS TEXT) AS enqueue_sequence,
                    rebase_before_first_attempt, lease_owner, lease_expires_at
@@ -847,7 +847,7 @@ export class WorkspaceSyncDurabilityStore {
                    mutation_kind, owns_task_metadata, owns_task_lifecycle, owns_task_assignee,
                    CAST(base_entity_revision AS TEXT) AS base_entity_revision,
                    CAST(base_lifecycle_revision AS TEXT) AS base_lifecycle_revision,
-                   payload_json, payload_fingerprint, status, attempt_count,
+                   payload_json, payload_fingerprint, canonical_intent_json, status, attempt_count,
                    initial_not_found_attempt_count,
                    CAST(enqueue_sequence AS TEXT) AS enqueue_sequence,
                    rebase_before_first_attempt, lease_owner, lease_expires_at
@@ -1028,7 +1028,7 @@ export class WorkspaceSyncDurabilityStore {
                    mutation_kind, owns_task_metadata, owns_task_lifecycle, owns_task_assignee,
                    CAST(base_entity_revision AS TEXT) AS base_entity_revision,
                    CAST(base_lifecycle_revision AS TEXT) AS base_lifecycle_revision,
-                   payload_json, payload_fingerprint, status, attempt_count,
+                   payload_json, payload_fingerprint, canonical_intent_json, status, attempt_count,
                    initial_not_found_attempt_count,
                    CAST(enqueue_sequence AS TEXT) AS enqueue_sequence,
                    rebase_before_first_attempt, lease_owner, lease_expires_at
@@ -1396,7 +1396,8 @@ export class WorkspaceSyncDurabilityStore {
             const recoverySources = this.db.prepare(`
                 SELECT client_id, operation_id, dispatch_class, domain, entity_id, mutation_kind,
                        owns_task_metadata, owns_task_lifecycle, owns_task_assignee,
-                       payload_json, payload_fingerprint, last_error_code, last_error_message,
+                       payload_json, payload_fingerprint, canonical_intent_json,
+                       last_error_code, last_error_message,
                        EXISTS (
                            SELECT 1
                            FROM workspace_sync_outbox AS replay_candidate
@@ -1646,18 +1647,18 @@ export class WorkspaceSyncDurabilityStore {
                         dispatch_class, domain, entity_id, mutation_kind,
                         owns_task_metadata, owns_task_lifecycle, owns_task_assignee,
                         base_entity_revision, base_lifecycle_revision,
-                        payload_json, payload_fingerprint, status, attempt_count,
+                        payload_json, payload_fingerprint, canonical_intent_json, status, attempt_count,
                         initial_not_found_attempt_count, enqueue_sequence, rebase_before_first_attempt,
                         next_attempt_at, recovery_batch_id,
                         replay_of_client_id, replay_of_operation_id, created_at, updated_at
-                    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 'pending', 0, 0, ?, 1,
+                    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 'pending', 0, 0, ?, 1,
                         ?, ?, ?, ?, ?, ?)
                     ON CONFLICT (tenant_id, workspace_id, client_id, operation_id) DO NOTHING
-                `).run(tenantId, workspaceId, operationId, WORKSPACE_SYNC_CONTRACT_VERSION, sourceClientId, requireOutboxDispatchClass(source.dispatch_class), requireText(source.domain, 'Source domain'), replayEntityId, replayPayload.replayMutationKind, Number(source.owns_task_metadata) === 1 ? 1 : 0, Number(source.owns_task_lifecycle) === 1 ? 1 : 0, Number(source.owns_task_assignee) === 1 ? 1 : 0, primary.revision.entityRevision, primary.revision.lifecycleRevision, replayPayload.payloadJson, replayPayload.payloadFingerprint, enqueueSequence, now, recoveryBatchId, sourceClientId, sourceOperationId, now, now);
+                `).run(tenantId, workspaceId, operationId, WORKSPACE_SYNC_CONTRACT_VERSION, sourceClientId, requireOutboxDispatchClass(source.dispatch_class), requireText(source.domain, 'Source domain'), replayEntityId, replayPayload.replayMutationKind, Number(source.owns_task_metadata) === 1 ? 1 : 0, Number(source.owns_task_lifecycle) === 1 ? 1 : 0, Number(source.owns_task_assignee) === 1 ? 1 : 0, primary.revision.entityRevision, primary.revision.lifecycleRevision, replayPayload.payloadJson, replayPayload.payloadFingerprint, source.canonical_intent_json == null ? null : String(source.canonical_intent_json), enqueueSequence, now, recoveryBatchId, sourceClientId, sourceOperationId, now, now);
                 this.db.prepare(`
                     UPDATE workspace_sync_outbox
                     SET base_entity_revision = ?, base_lifecycle_revision = ?,
-                        payload_json = ?, payload_fingerprint = ?,
+                        payload_json = ?, payload_fingerprint = ?, canonical_intent_json = ?,
                         status = 'pending', attempt_count = 0, initial_not_found_attempt_count = 0,
                         rebase_before_first_attempt = 1, next_attempt_at = ?,
                         lease_owner = NULL, lease_expires_at = NULL,
@@ -1667,7 +1668,7 @@ export class WorkspaceSyncDurabilityStore {
                     WHERE tenant_id = ? AND workspace_id = ? AND client_id = ? AND operation_id = ?
                       AND recovery_batch_id = ? AND replay_of_client_id = ? AND replay_of_operation_id = ?
                       AND status = 'superseded'
-                `).run(primary.revision.entityRevision, primary.revision.lifecycleRevision, replayPayload.payloadJson, replayPayload.payloadFingerprint, now, now, tenantId, workspaceId, sourceClientId, operationId, recoveryBatchId, sourceClientId, sourceOperationId);
+                `).run(primary.revision.entityRevision, primary.revision.lifecycleRevision, replayPayload.payloadJson, replayPayload.payloadFingerprint, source.canonical_intent_json == null ? null : String(source.canonical_intent_json), now, now, tenantId, workspaceId, sourceClientId, operationId, recoveryBatchId, sourceClientId, sourceOperationId);
                 if (replayPayload.workflowDependencyCoalesced) {
                     this.db.prepare(`
                         UPDATE workspace_sync_outbox
@@ -2761,7 +2762,20 @@ export class WorkspaceSyncDurabilityStore {
                 for (const target of targets) {
                     insertTarget.run(ids[0], ids[1], ids[2], ids[3], target.domain, target.entityId, target.mutationKind, target.baseEntityRevision, target.baseLifecycleRevision, target.ownsTaskMetadata ? 1 : 0, target.ownsTaskLifecycle ? 1 : 0, target.ownsTaskAssignee ? 1 : 0, now);
                 }
-                return { enqueued: true, mutationResult: input.applyLocalMutation() };
+                const mutationResult = input.applyLocalMutation();
+                if (input.buildCanonicalIntent) {
+                    const canonicalIntentJson = canonicalWorkspaceSyncJson(input.buildCanonicalIntent(mutationResult));
+                    const updated = this.db.prepare(`
+                        UPDATE workspace_sync_outbox
+                        SET canonical_intent_json = ?, updated_at = ?
+                        WHERE tenant_id = ? AND workspace_id = ? AND client_id = ? AND operation_id = ?
+                          AND status = 'pending'
+                    `).run(canonicalIntentJson, now, ...ids);
+                    if (Number(updated.changes || 0) !== 1) {
+                        throw new Error('Workspace sync canonical intent changed before it was persisted.');
+                    }
+                }
+                return { enqueued: true, mutationResult };
             }
             const existing = this.db.prepare(`
                 SELECT contract_version, dispatch_class, domain, entity_id, mutation_kind,
@@ -3891,7 +3905,7 @@ export class WorkspaceSyncDurabilityStore {
                            mutation_kind, owns_task_metadata, owns_task_lifecycle, owns_task_assignee,
                            CAST(base_entity_revision AS TEXT) AS base_entity_revision,
                            CAST(base_lifecycle_revision AS TEXT) AS base_lifecycle_revision,
-                           payload_json, payload_fingerprint, status, attempt_count,
+                           payload_json, payload_fingerprint, canonical_intent_json, status, attempt_count,
                            initial_not_found_attempt_count,
                            CAST(enqueue_sequence AS TEXT) AS enqueue_sequence,
                            rebase_before_first_attempt,
@@ -4664,6 +4678,9 @@ export class WorkspaceSyncDurabilityStore {
             workflowDependencyCoalesced: true,
         };
     }
+    lockWorkspaceSequenceForMutation(input) {
+        this.allocateSequenceRange(requireText(input.tenantId, 'Tenant id'), requireText(input.workspaceId, 'Workspace id'), requireIsoTimestamp(input.now, 'Lock time'), 0);
+    }
     allocateSequenceRange(tenantId, workspaceId, now, count) {
         const row = this.db.prepare(`
             INSERT INTO workspace_sync_sequences (tenant_id, workspace_id, last_sequence, updated_at)
@@ -4719,6 +4736,9 @@ export class WorkspaceSyncDurabilityStore {
             baseLifecycleRevision: normalizeSequence(row.base_lifecycle_revision),
             payloadJson: requireText(row.payload_json, 'Payload'),
             payloadFingerprint: requireText(row.payload_fingerprint, 'Payload fingerprint'),
+            canonicalIntentJson: row.canonical_intent_json == null
+                ? null
+                : requireText(row.canonical_intent_json, 'Canonical intent'),
             status: requireText(row.status, 'Outbox status'),
             attemptCount: Number(row.attempt_count || 0),
             initialNotFoundAttemptCount: Number(row.initial_not_found_attempt_count || 0),

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

@@ -2,15 +2,15 @@ import type { AttachmentItem, TaskEvent, TaskEventDetails, TaskItem } from '../.
 import { serializeTaskRootForSync } from './workspaceSyncV3TaskRootProjection.js';
 import { serializeTaskActivityForSync, type WorkspaceSyncActivityRevision } from './taskActivityJournal.js';
 import { WorkspaceSyncDurabilityStore } from './syncDurabilityStore.js';
-import { type WorkspaceSyncV3TaskAttachmentLink, type WorkspaceSyncV3TaskAttachmentLinksPayload } from './workspaceSyncV3NestedTaskCodecs.js';
+import { type WorkspaceSyncV3TaskAttachmentLink, type WorkspaceSyncV3TaskAttachmentLinksV2Payload } from './workspaceSyncV3NestedTaskCodecs.js';
 export declare class DurableTaskAttachmentLinksMutationError extends Error {
-    readonly code: 'TASK_NOT_FOUND' | 'TASK_ARCHIVED_READ_ONLY' | 'TASK_ATTACHMENT_LINKS_INVALID' | 'TASK_ATTACHMENT_LINKS_IDENTITY_CONFLICT' | 'WORKSPACE_SYNC_OPERATION_ID_REQUIRED' | 'TASK_ATTACHMENT_LINKS_DEPENDENCY_PENDING' | 'TASK_ATTACHMENT_ASSET_NOT_READY';
+    readonly code: 'TASK_NOT_FOUND' | 'TASK_ARCHIVED_READ_ONLY' | 'TASK_ATTACHMENT_LINKS_INVALID' | 'TASK_ATTACHMENT_LINKS_IDENTITY_CONFLICT' | 'WORKSPACE_SYNC_OPERATION_ID_REQUIRED' | 'TASK_ATTACHMENT_LINKS_DEPENDENCY_PENDING' | 'TASK_ATTACHMENT_ASSET_NOT_READY' | '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_ATTACHMENT_LINKS_INVALID' | 'TASK_ATTACHMENT_LINKS_IDENTITY_CONFLICT' | 'WORKSPACE_SYNC_OPERATION_ID_REQUIRED' | 'TASK_ATTACHMENT_LINKS_DEPENDENCY_PENDING' | 'TASK_ATTACHMENT_ASSET_NOT_READY', 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_ATTACHMENT_LINKS_INVALID' | 'TASK_ATTACHMENT_LINKS_IDENTITY_CONFLICT' | 'WORKSPACE_SYNC_OPERATION_ID_REQUIRED' | 'TASK_ATTACHMENT_LINKS_DEPENDENCY_PENDING' | 'TASK_ATTACHMENT_ASSET_NOT_READY' | 'TASK_DETAIL_REVISION_CONFLICT', statusCode: number, details?: Record<string, unknown> | undefined, retryable?: boolean | undefined, retryAfterAt?: string | undefined, retryHint?: string | undefined);
 }
 export type DurableTaskAttachmentLinksResponse = {
     success: true;
@@ -37,7 +37,7 @@ export type DurableTaskAttachmentLinksResponse = {
             sequence: string;
             entityRevision: string;
             lifecycleRevision: string;
-            payload: WorkspaceSyncV3TaskAttachmentLinksPayload;
+            payload: WorkspaceSyncV3TaskAttachmentLinksV2Payload;
         };
     };
     activity: ReturnType<typeof serializeTaskActivityForSync>;
@@ -108,5 +108,7 @@ export declare function runDurableTaskAttachmentLinksReplace(input: {
     actorRef: string;
     resolveActorRef?: () => string;
     originActorRef?: string;
+    expectedDetailRevision?: string;
+    assertPrecondition?: () => void;
     onPostCommitError?: (error: unknown) => void;
 }): DurableTaskAttachmentLinksMutationResult;

package/dist/sync/v3/taskAttachmentLinksMutationService.js

@@ -3,7 +3,7 @@ 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;
@@ -61,6 +61,9 @@ export function runDurableTaskAttachmentLinksReplace(input) {
                 ? { cardCoverAssetId: input.cardCoverAssetId }
                 : {}),
             ...(input.originActorRef ? { originActorRef: input.originActorRef } : {}),
+            ...(input.expectedDetailRevision
+                ? { expectedDetailRevision: input.expectedDetailRevision }
+                : {}),
         },
     });
     const activityEventId = buildTaskAttachmentLinksActivityEventId({
@@ -74,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,
@@ -101,16 +114,11 @@ 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);
@@ -181,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;