@taskforcehq/taskforce 0.3.328 → 0.3.330

package/dist/sync/v3/workspaceSyncV3NestedTaskRepairSnapshot.js

@@ -1,8 +1,9 @@
-import { serializeWorkspaceSyncV3EntityEventPayload, serializeWorkspaceSyncV3TaskChecklistPayload, serializeWorkspaceSyncV3TaskCommentsPayload, validateWorkspaceSyncV3TaskAttachmentLinksPayload, } from './workspaceSyncV3NestedTaskCodecs.js';
+import { serializeWorkspaceSyncV3EntityEventPayload, serializeWorkspaceSyncV3TaskChecklistPayload, serializeWorkspaceSyncV3TaskCommentsPayload, validateWorkspaceSyncV3TaskAttachmentLinksPayload, serializeWorkspaceSyncV3TaskAttachmentLinksV2Payload, } from './workspaceSyncV3NestedTaskCodecs.js';
 const rank = new Map([
     ['task-comments/full-v1', 0],
     ['task-checklist/full-v1', 1],
     ['task-attachment-links/full-v1', 2],
+    ['task-attachment-links/full-v2', 2],
     ['entity-event/full-v1', 3],
 ]);
 function compareCodeUnits(left, right) {
@@ -19,6 +20,7 @@ export function buildWorkspaceSyncV3NestedTaskRepairCandidates(input) {
         if (!links) {
             throw new Error(`Task attachment-link repair source is missing for ${task.id}.`);
         }
+        const attachmentProjection = input.attachmentProjection || 'task-attachment-links/full-v1';
         candidates.push({
             projection: 'task-comments/full-v1', domain: 'task-comments', entityId: task.id, mutationKind: 'replace',
             payload: serializeWorkspaceSyncV3TaskCommentsPayload({ taskId: task.id, comments: task.comments || [] }),
@@ -26,8 +28,14 @@ export function buildWorkspaceSyncV3NestedTaskRepairCandidates(input) {
             projection: 'task-checklist/full-v1', domain: 'task-checklist', entityId: task.id, mutationKind: 'replace',
             payload: serializeWorkspaceSyncV3TaskChecklistPayload({ taskId: task.id, items: task.checklistItems || [] }),
         }, {
-            projection: 'task-attachment-links/full-v1', domain: 'task-attachment-links', entityId: task.id, mutationKind: 'replace',
-            payload: validateWorkspaceSyncV3TaskAttachmentLinksPayload({ taskId: task.id, links: links || [] }),
+            projection: attachmentProjection, domain: 'task-attachment-links', entityId: task.id, mutationKind: 'replace',
+            payload: attachmentProjection === 'task-attachment-links/full-v2'
+                ? serializeWorkspaceSyncV3TaskAttachmentLinksV2Payload({
+                    taskId: task.id,
+                    links,
+                    cardCoverAssetId: task.cardCoverAssetId ?? null,
+                })
+                : validateWorkspaceSyncV3TaskAttachmentLinksPayload({ taskId: task.id, links }),
         });
     }
     for (const event of input.events) {

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

@@ -11,6 +11,7 @@ import type { WorkflowRuntimeMutationCommand } from './workflowRuntimeSync.js';
 import type { WorkspaceSyncV3OriginActor } from './workspaceSyncV3OriginActor.js';
 import type { WorkspaceSyncV3TaskCommentReconcileProvenance } from './taskCommentReconcileProvenance.js';
 import type { WorkspaceSyncEntityEventSnapshot } from '../workspaceSyncModel.js';
+import type { TaskChecklistItemUpdateIntent } from './taskChecklistMutationService.js';
 export type { WorkspaceSyncV3OriginActor } from './workspaceSyncV3OriginActor.js';
 type WorkspaceSyncV3OperationEnvelopeBase<TOperation> = {
     contractVersion: 3;
@@ -30,6 +31,7 @@ type TaskOperationBase<TMutationKind extends string, TPayload> = {
 export type WorkspaceSyncV3TaskMetadataEnvelope = WorkspaceSyncV3OperationEnvelopeBase<TaskOperationBase<'metadata-update', {
     patch: Partial<TaskItem>;
     saveSource?: 'manual' | 'autosave';
+    expectedDetailRevision?: string;
     originActor?: WorkspaceSyncV3OriginActor;
 }>>;
 export type WorkspaceSyncV3TaskCreateEnvelope = WorkspaceSyncV3OperationEnvelopeBase<TaskOperationBase<'create', {
@@ -74,6 +76,7 @@ export type WorkspaceSyncV3TaskWorkflowEnvelope = WorkspaceSyncV3OperationEnvelo
 export type WorkspaceSyncV3TaskStatusEnvelope = WorkspaceSyncV3OperationEnvelopeBase<TaskOperationBase<'set-status', DurableTaskStatusMutationPayload & {
     workflowAssignment?: WorkflowAssignmentSyncRecord;
     originActor?: WorkspaceSyncV3OriginActor;
+    expectedDetailRevision?: string;
 }>>;
 export type WorkspaceSyncV3WorkflowRuntimeEnvelope = WorkspaceSyncV3OperationEnvelopeBase<{
     domain: 'workflow-execution';
@@ -113,6 +116,8 @@ export type WorkspaceSyncV3TaskChecklistEnvelope = WorkspaceSyncV3OperationEnvel
     baseLifecycleRevision: '0';
     payload: {
         items: ChecklistItem[];
+        expectedDetailRevision?: string;
+        itemUpdateIntent?: TaskChecklistItemUpdateIntent;
         originActor?: WorkspaceSyncV3OriginActor;
     };
 }>;

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

@@ -46,6 +46,10 @@ export interface WorkspaceSyncV3OperatorDiagnosticsSnapshot {
         materializationsInWindow: number;
         materializedEntriesInWindow: number;
         unexpiredMaterializations: number;
+        storedMaterializations: number;
+        storedEntries: number;
+        expiredMaterializations: number;
+        expiredEntries: number;
     };
     outbox: {
         captureConfigured: boolean;
@@ -74,6 +78,7 @@ export interface WorkspaceSyncV3OperatorDiagnosticsSnapshot {
         };
         server5xx: number;
         nonTest409: number;
+        cursorExpiredResets: number;
         requestP95Ms: number | null;
         maxObservedResponseBytes: number | null;
     };
@@ -131,11 +136,13 @@ export interface WorkspaceSyncV3OperatorDiagnosticsSnapshot {
         };
         attachmentApply: {
             openObligations: number;
+            terminalObligations: number;
             dueObligations: number;
             oldestOpenCreatedAt: string | null;
             nextAttemptAt: string | null;
             attempted: number;
             lastError: string | null;
+            terminalReason: string | null;
         };
         runner: {
             available: boolean;

package/dist/sync/v3/workspaceSyncV3OperatorDiagnostics.js

@@ -116,7 +116,13 @@ export function buildWorkspaceSyncV3OperatorDiagnostics(input) {
     `).all(tenantId, workspaceId, since, eventLimit + 1);
     const truncated = eventRows.length > eventLimit;
     const events = eventRows.slice(0, eventLimit);
-    const transfer = { pull: { success: 0, error: 0 }, apply: { success: 0, error: 0 }, server5xx: 0, nonTest409: 0 };
+    const transfer = {
+        pull: { success: 0, error: 0 },
+        apply: { success: 0, error: 0 },
+        server5xx: 0,
+        nonTest409: 0,
+        cursorExpiredResets: 0,
+    };
     const requestTimes = [];
     const observedResponseBytes = [];
     for (const row of events) {
@@ -131,7 +137,10 @@ export function buildWorkspaceSyncV3OperatorDiagnostics(input) {
         const requestMs = Number(row.request_ms);
         if (Number.isFinite(requestMs) && requestMs >= 0)
             requestTimes.push(requestMs);
-        const bytes = responseBytes(parseDetails(row.details_json));
+        const details = parseDetails(row.details_json);
+        if (JSON.stringify(details).includes('CURSOR_EXPIRED'))
+            transfer.cursorExpiredResets += 1;
+        const bytes = responseBytes(details);
         if (bytes !== null)
             observedResponseBytes.push(bytes);
     }
@@ -143,6 +152,27 @@ export function buildWorkspaceSyncV3OperatorDiagnostics(input) {
           AND coverage_profile_id = ? AND coverage_version = ? AND coverage_digest = ?
           AND created_at >= ?
     `).get(nowIso, tenantId, workspaceId, projection.coverageProfileId, projection.coverageVersion, projection.coverageDigest, since);
+    const storedRepairMaterialization = input.db.prepare(`
+        SELECT
+            COUNT(*) AS count,
+            COALESCE(SUM(CASE WHEN expires_at < ? THEN 1 ELSE 0 END), 0) AS expired,
+            (SELECT COUNT(*)
+             FROM workspace_sync_repair_snapshot_entries entry
+             WHERE entry.tenant_id = ? AND entry.workspace_id = ?) AS entries,
+            (SELECT COUNT(*)
+             FROM workspace_sync_repair_snapshot_entries entry
+             WHERE entry.tenant_id = ? AND entry.workspace_id = ?
+               AND EXISTS (
+                   SELECT 1
+                   FROM workspace_sync_repair_snapshots snapshot
+                   WHERE snapshot.tenant_id = entry.tenant_id
+                     AND snapshot.workspace_id = entry.workspace_id
+                     AND snapshot.snapshot_id = entry.snapshot_id
+                     AND snapshot.expires_at < ?
+               )) AS expired_entries
+        FROM workspace_sync_repair_snapshots
+        WHERE tenant_id = ? AND workspace_id = ?
+    `).get(nowIso, tenantId, workspaceId, tenantId, workspaceId, nowIso, tenantId, workspaceId);
     const stagedEntry = projection.repair ? input.db.prepare(`
         SELECT COUNT(*) AS count
         FROM workspace_sync_coverage_repair_entries
@@ -216,12 +246,14 @@ export function buildWorkspaceSyncV3OperatorDiagnostics(input) {
             WHERE tenant_id = ? AND workspace_id = ? AND resolved_at IS NULL
         `).get(tenantId, workspaceId);
         attachmentApplyRow = input.db.prepare(`
-            SELECT COUNT(*) AS count,
-                   SUM(CASE WHEN next_attempt_at <= ? THEN 1 ELSE 0 END) AS due,
-                   MIN(created_at) AS oldest_created_at,
-                   MIN(next_attempt_at) AS next_attempt_at,
-                   COALESCE(SUM(attempts), 0) AS attempts,
-                   MAX(last_error) AS last_error
+            SELECT SUM(CASE WHEN terminal_at IS NULL THEN 1 ELSE 0 END) AS count,
+                   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_created_at,
+                   MIN(CASE WHEN terminal_at IS NULL THEN next_attempt_at END) AS next_attempt_at,
+                   COALESCE(SUM(CASE WHEN terminal_at IS NULL THEN attempts ELSE 0 END), 0) AS attempts,
+                   MAX(CASE WHEN terminal_at IS NULL THEN last_error END) AS last_error,
+                   MAX(CASE WHEN terminal_at IS NOT NULL THEN terminal_reason END) AS terminal_reason
             FROM workspace_sync_v3_attachment_apply_obligations
             WHERE tenant_id = ? AND workspace_id = ? AND resolved_at IS NULL
         `).get(nowIso, tenantId, workspaceId);
@@ -255,7 +287,9 @@ export function buildWorkspaceSyncV3OperatorDiagnostics(input) {
     const oldestOpenRecoveryAt = String(recoveryRow?.oldest_created_at || '').trim() || null;
     const coordinatorGeneration = coordinatorState ? integer(coordinatorState.coordinator_generation) : null;
     const ownershipMode = coordinatorState ? String(coordinatorState.ownership_mode || '') || null : null;
-    const localConverged = baseLocalConverged && integer(attachmentApplyRow?.count) === 0;
+    const localConverged = baseLocalConverged
+        && integer(attachmentApplyRow?.count) === 0
+        && integer(attachmentApplyRow?.terminal) === 0;
     const coordinatorFailures = [];
     if (input.runtimeMode === 'local') {
         if (!coordinatorState)
@@ -279,6 +313,9 @@ export function buildWorkspaceSyncV3OperatorDiagnostics(input) {
         if (integer(attachmentApplyRow?.count) > 0) {
             coordinatorFailures.push('open attachment apply obligations remain');
         }
+        if (integer(attachmentApplyRow?.terminal) > 0) {
+            coordinatorFailures.push('terminal unavailable attachment apply obligations require operator action');
+        }
         if (ownershipMode === 'server' && !runnerState) {
             coordinatorFailures.push('server ownership has no durable runner checkpoint');
         }
@@ -305,6 +342,9 @@ export function buildWorkspaceSyncV3OperatorDiagnostics(input) {
             failures.push('recent pull/apply window contains 409 responses');
         if (integer(attachmentApplyRow?.count) > 0)
             failures.push('attachment apply obligations remain open');
+        if (integer(attachmentApplyRow?.terminal) > 0) {
+            failures.push('terminal unavailable attachment apply obligations require operator action');
+        }
         if (cursorAtCycleHighWatermark === null)
             unknowns.push('no committed feed cycle coordinates are available');
         if (!events.length)
@@ -336,6 +376,10 @@ export function buildWorkspaceSyncV3OperatorDiagnostics(input) {
             materializationsInWindow: integer(repairMaterialization?.count),
             materializedEntriesInWindow: integer(repairMaterialization?.entries),
             unexpiredMaterializations: integer(repairMaterialization?.unexpired),
+            storedMaterializations: integer(storedRepairMaterialization?.count),
+            storedEntries: integer(storedRepairMaterialization?.entries),
+            expiredMaterializations: integer(storedRepairMaterialization?.expired),
+            expiredEntries: integer(storedRepairMaterialization?.expired_entries),
         },
         outbox: {
             captureConfigured, dispatchConfigured, automaticSyncEnabled: automaticSync.enabled,
@@ -387,11 +431,13 @@ export function buildWorkspaceSyncV3OperatorDiagnostics(input) {
             },
             attachmentApply: {
                 openObligations: integer(attachmentApplyRow?.count),
+                terminalObligations: integer(attachmentApplyRow?.terminal),
                 dueObligations: integer(attachmentApplyRow?.due),
                 oldestOpenCreatedAt: String(attachmentApplyRow?.oldest_created_at || '').trim() || null,
                 nextAttemptAt: String(attachmentApplyRow?.next_attempt_at || '').trim() || null,
                 attempted: integer(attachmentApplyRow?.attempts),
                 lastError: String(attachmentApplyRow?.last_error || '').trim() || null,
+                terminalReason: String(attachmentApplyRow?.terminal_reason || '').trim() || null,
             },
             runner: {
                 available: Boolean(runnerState),

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

@@ -0,0 +1,17 @@
+import type { DatabaseAdapter } from '../../storage/databaseAdapter.js';
+export declare const DEFAULT_WORKSPACE_SYNC_REPAIR_SNAPSHOT_RETENTION_BATCH_SIZE = 500;
+export interface WorkspaceSyncRepairSnapshotRetentionPolicy {
+    batchSize: number;
+}
+export interface WorkspaceSyncRepairSnapshotRetentionResult {
+    deletedEntries: number;
+    deletedSnapshots: number;
+    remainingExpiredSnapshots: number;
+}
+export declare function resolveWorkspaceSyncRepairSnapshotRetentionPolicy(env?: NodeJS.ProcessEnv): WorkspaceSyncRepairSnapshotRetentionPolicy;
+export declare function pruneExpiredWorkspaceSyncRepairSnapshots(input: {
+    db: DatabaseAdapter;
+    tenantId: string;
+    now?: Date;
+    policy?: WorkspaceSyncRepairSnapshotRetentionPolicy;
+}): WorkspaceSyncRepairSnapshotRetentionResult;

package/dist/sync/v3/workspaceSyncV3RepairSnapshotRetentionService.js

@@ -0,0 +1,64 @@
+export const DEFAULT_WORKSPACE_SYNC_REPAIR_SNAPSHOT_RETENTION_BATCH_SIZE = 500;
+function positiveInteger(value, fallback) {
+    const parsed = Number.parseInt(String(value ?? '').trim(), 10);
+    return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : fallback;
+}
+export function resolveWorkspaceSyncRepairSnapshotRetentionPolicy(env = process.env) {
+    return {
+        batchSize: Math.min(10_000, positiveInteger(env.TASKFORCE_SYNC_REPAIR_SNAPSHOT_RETENTION_BATCH_SIZE, DEFAULT_WORKSPACE_SYNC_REPAIR_SNAPSHOT_RETENTION_BATCH_SIZE)),
+    };
+}
+export function pruneExpiredWorkspaceSyncRepairSnapshots(input) {
+    const now = (input.now || new Date()).toISOString();
+    const policy = input.policy || resolveWorkspaceSyncRepairSnapshotRetentionPolicy();
+    return input.db.transaction(() => {
+        const snapshot = input.db.prepare(`
+            SELECT workspace_id, snapshot_id
+            FROM workspace_sync_repair_snapshots
+            WHERE tenant_id = ? AND expires_at < ?
+            ORDER BY expires_at ASC, workspace_id ASC, snapshot_id ASC
+            LIMIT 1
+        `).get(input.tenantId, now);
+        const workspaceId = String(snapshot?.workspace_id || '').trim();
+        const snapshotId = String(snapshot?.snapshot_id || '').trim();
+        let deletedEntries = 0;
+        let deletedSnapshots = 0;
+        if (workspaceId && snapshotId) {
+            const entries = input.db.prepare(`
+                SELECT entry_index
+                FROM workspace_sync_repair_snapshot_entries
+                WHERE tenant_id = ? AND workspace_id = ? AND snapshot_id = ?
+                ORDER BY entry_index ASC
+                LIMIT ?
+            `).all(input.tenantId, workspaceId, snapshotId, policy.batchSize);
+            if (entries.length > 0) {
+                const result = input.db.prepare(`
+                    DELETE FROM workspace_sync_repair_snapshot_entries
+                    WHERE tenant_id = ? AND workspace_id = ? AND snapshot_id = ?
+                      AND entry_index IN (${entries.map(() => '?').join(', ')})
+                `).run(input.tenantId, workspaceId, snapshotId, ...entries.map((entry) => entry.entry_index));
+                deletedEntries = Number(result.changes || 0);
+            }
+            const snapshotResult = input.db.prepare(`
+                DELETE FROM workspace_sync_repair_snapshots
+                WHERE tenant_id = ? AND workspace_id = ? AND snapshot_id = ? AND expires_at < ?
+                  AND NOT EXISTS (
+                      SELECT 1
+                      FROM workspace_sync_repair_snapshot_entries
+                      WHERE tenant_id = ? AND workspace_id = ? AND snapshot_id = ?
+                  )
+            `).run(input.tenantId, workspaceId, snapshotId, now, input.tenantId, workspaceId, snapshotId);
+            deletedSnapshots = Number(snapshotResult.changes || 0);
+        }
+        const remaining = input.db.prepare(`
+            SELECT COUNT(*) AS count
+            FROM workspace_sync_repair_snapshots
+            WHERE tenant_id = ? AND expires_at < ?
+        `).get(input.tenantId, now);
+        return {
+            deletedEntries,
+            deletedSnapshots,
+            remainingExpiredSnapshots: Number(remaining?.count || 0),
+        };
+    })();
+}

package/dist/sync/v3/workspaceSyncV3TaskCommentAudit.js

@@ -36,12 +36,19 @@ export function buildWorkspaceSyncV3TaskCommentAuditPage(input) {
     const workspaceId = String(input.workspaceId || '').trim();
     const previousCursor = normalizeCursor(input.cursor);
     const limit = pageSize(input.limit);
+    // Task IDs are compared in JavaScript when a page is installed locally.
+    // Make the database boundary use the same bytewise ordering so Postgres
+    // locale collation cannot place mixed-case IDs in an order the local
+    // validator rejects (SQLite already defaults to binary ordering here).
+    const taskIdWithCollationSql = input.core.getDatabaseAdapter().provider === 'postgres'
+        ? 'id COLLATE "C"'
+        : 'id COLLATE BINARY';
     const rows = input.core.getDatabaseAdapter().prepare(`
         SELECT id
         FROM tasks
         WHERE tenant_id = ? AND workspace_id = ?
-          AND (? = '' OR id > ?)
-        ORDER BY id
+          AND (? = '' OR ${taskIdWithCollationSql} > ?)
+        ORDER BY ${taskIdWithCollationSql}
         LIMIT ?
     `).all(input.core.getTenantId(), workspaceId, previousCursor || '', previousCursor || '', limit + 1);
     const pageRows = rows.slice(0, limit);

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

@@ -0,0 +1,7 @@
+import type { WorkspaceSyncV3FeedCoveragePolicy, WorkspaceSyncV3FeedEntry, WorkspaceSyncV3FeedOperationProjector } from './workspaceSyncV3Feed.js';
+import type { WorkspaceSyncV3CoverageProfile } from './workspaceSyncV3FeedProfile.js';
+/** Dark v7 candidate: v4 ownership plus explicit task card-cover selection. */
+export declare const WORKSPACE_SYNC_V3_TASK_COVER_COVERAGE_PROFILE: WorkspaceSyncV3CoverageProfile;
+export declare const projectWorkspaceSyncV3TaskCoverCoverageOperation: WorkspaceSyncV3FeedOperationProjector;
+export declare const WORKSPACE_SYNC_V3_TASK_COVER_COVERAGE_POLICY: WorkspaceSyncV3FeedCoveragePolicy;
+export declare function validateWorkspaceSyncV3TaskCoverCoverageFeedEntry(entry: WorkspaceSyncV3FeedEntry): void;

package/dist/sync/v3/workspaceSyncV3TaskCoverCoverage.js

@@ -0,0 +1,37 @@
+import { createHash } from 'crypto';
+import { canonicalWorkspaceSyncJson } from './canonicalWorkspaceSyncJson.js';
+import { projectWorkspaceSyncV3CombinedOperation, validateWorkspaceSyncV3CombinedFeedEntry, } from './workspaceSyncV3CombinedCoverage.js';
+import { WORKSPACE_SYNC_V3_NESTED_COVERAGE_PROFILE } from './workspaceSyncV3NestedCoverage.js';
+import { projectWorkspaceSyncV3NestedTaskV2Operation, validateWorkspaceSyncV3NestedTaskFeedEntry, WORKSPACE_SYNC_V3_TASK_ATTACHMENT_LINKS_V2_PROJECTION, } from './workspaceSyncV3NestedTaskProjection.js';
+const projections = Object.freeze(WORKSPACE_SYNC_V3_NESTED_COVERAGE_PROFILE.projections.map((projection) => (projection.projectionId === 'task-attachment-links/full-v1'
+    ? WORKSPACE_SYNC_V3_TASK_ATTACHMENT_LINKS_V2_PROJECTION
+    : projection)));
+const identity = Object.freeze({
+    coverageProfileId: 'task-planning-metadata',
+    coverageVersion: 7,
+    projections,
+});
+/** Dark v7 candidate: v4 ownership plus explicit task card-cover selection. */
+export const WORKSPACE_SYNC_V3_TASK_COVER_COVERAGE_PROFILE = Object.freeze({
+    ...identity,
+    coverageDigest: createHash('sha256').update(canonicalWorkspaceSyncJson(identity)).digest('hex'),
+});
+const NESTED_DOMAINS = new Set(['task-comments', 'task-checklist', 'task-attachment-links', 'entity-event']);
+export const projectWorkspaceSyncV3TaskCoverCoverageOperation = (input) => {
+    if (input.rows.some((row) => NESTED_DOMAINS.has(row.domain))) {
+        const nested = projectWorkspaceSyncV3NestedTaskV2Operation(input);
+        if (!nested)
+            throw new Error('Task-cover coverage operation is incomplete.');
+        return nested;
+    }
+    return projectWorkspaceSyncV3CombinedOperation(input);
+};
+export const WORKSPACE_SYNC_V3_TASK_COVER_COVERAGE_POLICY = Object.freeze({
+    profile: WORKSPACE_SYNC_V3_TASK_COVER_COVERAGE_PROFILE,
+    projectOperation: projectWorkspaceSyncV3TaskCoverCoverageOperation,
+});
+export function validateWorkspaceSyncV3TaskCoverCoverageFeedEntry(entry) {
+    if (NESTED_DOMAINS.has(entry.domain))
+        return validateWorkspaceSyncV3NestedTaskFeedEntry(entry);
+    return validateWorkspaceSyncV3CombinedFeedEntry(entry);
+}

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

@@ -0,0 +1,6 @@
+export declare const WORKSPACE_SYNC_V3_TASK_COVER_COVERAGE_SELECTOR: Readonly<{
+    coverageProfileId: "task-planning-metadata";
+    coverageVersion: 7;
+    coverageDigest: "84b0dee7ac0811234288c1b296357b2ddbcfe82d438ccf90b6bc6e8b5afea0b6";
+}>;
+export declare const WORKSPACE_SYNC_V3_TASK_COVER_EXCLUDED_V2_PROJECTIONS: readonly ("initiative/full-v1" | "taxonomy/full-v1" | "task/root-v1" | "task-relationship/full-v1" | "workstream/full-v1" | "task-comments/full-v1" | "task-checklist/full-v1" | "task-attachment-links/full-v2" | "entity-event/full-v1")[];

package/dist/sync/v3/workspaceSyncV3TaskCoverWireContract.js

@@ -0,0 +1,9 @@
+import { WORKSPACE_SYNC_V3_NESTED_EXCLUDED_V2_PROJECTIONS } from './workspaceSyncV3NestedWireContract.js';
+export const WORKSPACE_SYNC_V3_TASK_COVER_COVERAGE_SELECTOR = Object.freeze({
+    coverageProfileId: 'task-planning-metadata',
+    coverageVersion: 7,
+    coverageDigest: '84b0dee7ac0811234288c1b296357b2ddbcfe82d438ccf90b6bc6e8b5afea0b6',
+});
+export const WORKSPACE_SYNC_V3_TASK_COVER_EXCLUDED_V2_PROJECTIONS = Object.freeze(WORKSPACE_SYNC_V3_NESTED_EXCLUDED_V2_PROJECTIONS.map((projection) => (projection === 'task-attachment-links/full-v1'
+    ? 'task-attachment-links/full-v2'
+    : projection)));

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

@@ -0,0 +1,7 @@
+import type { WorkspaceSyncV3FeedCoveragePolicy, WorkspaceSyncV3FeedEntry, WorkspaceSyncV3FeedOperationProjector } from './workspaceSyncV3Feed.js';
+import type { WorkspaceSyncV3CoverageProfile } from './workspaceSyncV3FeedProfile.js';
+/** Dark v8 candidate: active v7 task-cover ownership plus workflow runtime. */
+export declare const WORKSPACE_SYNC_V3_WORKFLOW_TASK_COVER_COVERAGE_PROFILE: WorkspaceSyncV3CoverageProfile;
+export declare const projectWorkspaceSyncV3WorkflowTaskCoverCoverageOperation: WorkspaceSyncV3FeedOperationProjector;
+export declare const WORKSPACE_SYNC_V3_WORKFLOW_TASK_COVER_COVERAGE_POLICY: WorkspaceSyncV3FeedCoveragePolicy;
+export declare function validateWorkspaceSyncV3WorkflowTaskCoverCoverageFeedEntry(entry: WorkspaceSyncV3FeedEntry): void;

package/dist/sync/v3/workspaceSyncV3WorkflowTaskCoverCoverage.js

@@ -0,0 +1,33 @@
+import { createHash } from 'crypto';
+import { canonicalWorkspaceSyncJson } from './canonicalWorkspaceSyncJson.js';
+import { projectWorkspaceSyncV3TaskCoverCoverageOperation, validateWorkspaceSyncV3TaskCoverCoverageFeedEntry, WORKSPACE_SYNC_V3_TASK_COVER_COVERAGE_PROFILE, } from './workspaceSyncV3TaskCoverCoverage.js';
+import { WORKSPACE_SYNC_V3_WORKFLOW_RUNTIME_PROJECTIONS } from './workflowRuntimeSync.js';
+import { projectWorkspaceSyncV3WorkflowRuntimeOperation, validateWorkspaceSyncV3WorkflowRuntimeFeedEntry, } from './workspaceSyncV3WorkflowRuntimeProjection.js';
+const projections = Object.freeze([
+    ...WORKSPACE_SYNC_V3_TASK_COVER_COVERAGE_PROFILE.projections,
+    ...WORKSPACE_SYNC_V3_WORKFLOW_RUNTIME_PROJECTIONS,
+]);
+const identity = Object.freeze({
+    coverageProfileId: 'task-planning-metadata',
+    coverageVersion: 8,
+    projections,
+});
+/** Dark v8 candidate: active v7 task-cover ownership plus workflow runtime. */
+export const WORKSPACE_SYNC_V3_WORKFLOW_TASK_COVER_COVERAGE_PROFILE = Object.freeze({
+    ...identity,
+    coverageDigest: createHash('sha256').update(canonicalWorkspaceSyncJson(identity)).digest('hex'),
+});
+export const projectWorkspaceSyncV3WorkflowTaskCoverCoverageOperation = (input) => {
+    const workflow = projectWorkspaceSyncV3WorkflowRuntimeOperation(input);
+    return workflow || projectWorkspaceSyncV3TaskCoverCoverageOperation(input);
+};
+export const WORKSPACE_SYNC_V3_WORKFLOW_TASK_COVER_COVERAGE_POLICY = Object.freeze({
+    profile: WORKSPACE_SYNC_V3_WORKFLOW_TASK_COVER_COVERAGE_PROFILE,
+    projectOperation: projectWorkspaceSyncV3WorkflowTaskCoverCoverageOperation,
+});
+export function validateWorkspaceSyncV3WorkflowTaskCoverCoverageFeedEntry(entry) {
+    if (entry.projection.startsWith('workflow-')) {
+        return validateWorkspaceSyncV3WorkflowRuntimeFeedEntry(entry);
+    }
+    return validateWorkspaceSyncV3TaskCoverCoverageFeedEntry(entry);
+}

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

@@ -0,0 +1,7 @@
+export declare const WORKSPACE_SYNC_V3_WORKFLOW_TASK_COVER_COVERAGE_SELECTOR: Readonly<{
+    coverageProfileId: "task-planning-metadata";
+    coverageVersion: 8;
+    coverageDigest: "344c3360d36d383241b212192fe6c2ac1a7694fe521d3b6636559043b7e58253";
+}>;
+/** V2 has neither workflow runtime nor explicit task card-cover projections. */
+export declare const WORKSPACE_SYNC_V3_WORKFLOW_TASK_COVER_EXCLUDED_V2_PROJECTIONS: readonly ("initiative/full-v1" | "taxonomy/full-v1" | "task/root-v1" | "task-relationship/full-v1" | "workstream/full-v1" | "task-comments/full-v1" | "task-checklist/full-v1" | "task-attachment-links/full-v2" | "entity-event/full-v1")[];

package/dist/sync/v3/workspaceSyncV3WorkflowTaskCoverWireContract.js

@@ -0,0 +1,8 @@
+import { WORKSPACE_SYNC_V3_TASK_COVER_EXCLUDED_V2_PROJECTIONS } from './workspaceSyncV3TaskCoverWireContract.js';
+export const WORKSPACE_SYNC_V3_WORKFLOW_TASK_COVER_COVERAGE_SELECTOR = Object.freeze({
+    coverageProfileId: 'task-planning-metadata',
+    coverageVersion: 8,
+    coverageDigest: '344c3360d36d383241b212192fe6c2ac1a7694fe521d3b6636559043b7e58253',
+});
+/** V2 has neither workflow runtime nor explicit task card-cover projections. */
+export const WORKSPACE_SYNC_V3_WORKFLOW_TASK_COVER_EXCLUDED_V2_PROJECTIONS = WORKSPACE_SYNC_V3_TASK_COVER_EXCLUDED_V2_PROJECTIONS;

package/dist/sync/workspacePullFeed.js

@@ -33,7 +33,8 @@ export async function buildWorkspacePullFeed(input) {
     const excludedProjections = new Set(input.excludedProjections || []);
     const commentsV3Owned = excludedProjections.has('task-comments/full-v1');
     const checklistV3Owned = excludedProjections.has('task-checklist/full-v1');
-    const attachmentsV3Owned = excludedProjections.has('task-attachment-links/full-v1');
+    const attachmentsV3Owned = excludedProjections.has('task-attachment-links/full-v1')
+        || excludedProjections.has('task-attachment-links/full-v2');
     const suppressTaskCarriers = excludedProjections.has('task/root-v1')
         && commentsV3Owned && checklistV3Owned && attachmentsV3Owned;
     const syncCursor = cursor ? { watermark: cursor.u, id: cursor.id } : null;

package/dist/sync/workspaceRepair.d.ts

@@ -2,6 +2,7 @@ import type { TaskItem } from '../types.js';
 import type { WorkspaceAssetLinkRole, WorkspaceAssetStore } from '../storage/workspaceAssetStore.js';
 import { type AiProfileAvatarPathSource } from './aiProfileAvatarSyncPaths.js';
 import { type WorkspaceSyncPublishedContentResolver } from './engine/workspaceSyncPublishedContentResolver.js';
+import type { WorkspaceSyncContentPullObligationStore } from './engine/workspaceSyncContentPullObligationStore.js';
 export interface WorkspaceRepairManifestTaskEntry {
     id: string;
     archived: boolean;
@@ -22,6 +23,7 @@ export interface WorkspaceRepairManifestDocumentEntry {
     sha256: string;
     sizeBytes: number;
     existsLocally: boolean;
+    contentCheckReliable: boolean;
     source: 'metadata' | 'filesystem';
     publicationState: 'legacy' | 'versioned' | 'deleted' | 'invalid';
     publicationError: string | null;
@@ -36,6 +38,7 @@ export interface WorkspaceRepairManifestAssetEntry {
     sha256: string;
     sizeBytes: number;
     existsLocally: boolean;
+    contentCheckReliable: boolean;
     source: 'metadata' | 'filesystem';
     publicationState: 'legacy' | 'versioned' | 'deleted' | 'invalid';
     publicationError: string | null;
@@ -50,7 +53,7 @@ export interface WorkspaceRepairManifest {
     assets: WorkspaceRepairManifestAssetEntry[];
     assetDeletes: WorkspaceRepairManifestDeleteEntry[];
 }
-export type WorkspaceRepairIssueCode = 'missing_document_metadata' | 'missing_document_file' | 'stale_document_tombstone' | 'published_document_tombstone_conflict' | 'published_document_live_head_conflict' | 'invalid_published_document_content' | 'missing_asset_metadata' | 'missing_asset_file' | 'stale_asset_tombstone' | 'published_asset_tombstone_conflict' | 'published_asset_live_head_conflict' | 'invalid_published_asset_content' | 'stale_asset_link' | 'missing_asset_link';
+export type WorkspaceRepairIssueCode = 'missing_document_metadata' | 'missing_document_file' | 'stale_document_tombstone' | 'published_document_tombstone_conflict' | 'published_document_live_head_conflict' | 'invalid_published_document_content' | 'document_content_unverified' | 'missing_asset_metadata' | 'missing_asset_file' | 'stale_asset_tombstone' | 'published_asset_tombstone_conflict' | 'published_asset_live_head_conflict' | 'invalid_published_asset_content' | 'asset_content_unverified' | 'stale_asset_link' | 'missing_asset_link';
 export interface WorkspaceRepairIssue {
     code: WorkspaceRepairIssueCode;
     entityKind: 'document' | 'asset' | 'link';
@@ -59,7 +62,7 @@ export interface WorkspaceRepairIssue {
     taskId?: string | null;
     role?: WorkspaceAssetLinkRole;
     repairable: boolean;
-    recommendedAction: 'create-metadata' | 'mark-deleted' | 'revive-metadata' | 'delete-link' | 'create-link' | 'inspect-published-content';
+    recommendedAction: 'create-metadata' | 'mark-deleted' | 'revive-metadata' | 'delete-link' | 'create-link' | 'inspect-published-content' | 'retry-pull';
     detail: string;
 }
 export interface WorkspaceRepairScanResult {
@@ -103,4 +106,7 @@ export declare function scanWorkspaceRepair(input: WorkspaceRepairInput): Worksp
 export declare function applyWorkspaceRepair(input: WorkspaceRepairInput & {
     upsertDocumentWatermark: (workspaceId: string, path: string, contentHash: string, updatedAt: string) => void;
     repairMissingAssetLinks?: boolean;
+    repairMissingContentFiles?: boolean;
+    contentPullObligationStore?: WorkspaceSyncContentPullObligationStore;
+    now?: () => string;
 }): WorkspaceRepairApplyResult;