@taskforcehq/taskforce 0.3.328 → 0.3.329

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/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,7 +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');
+    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());
@@ -63,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 } : {}),
                 },
             };
         }),
@@ -100,7 +104,10 @@ 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');
+            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');
             if (commentsOwned || checklistOwned || attachmentsOwned) {
@@ -115,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>;

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.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,15 @@ 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,
+                    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.');