@taskforcehq/taskforce 0.3.327 → 0.3.329

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

@@ -131,11 +131,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

@@ -216,12 +216,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 +257,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 +283,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 +312,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)
@@ -387,11 +397,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/workspaceSyncV3RepairSqlBatching.d.ts

@@ -0,0 +1,2 @@
+import type { DatabaseAdapter } from '../../storage/databaseAdapter.js';
+export declare function workspaceSyncV3RepairEntityReadBatchSize(db: DatabaseAdapter): number;

package/dist/sync/v3/workspaceSyncV3RepairSqlBatching.js

@@ -0,0 +1,10 @@
+const SQLITE_ENTITY_READ_BATCH_SIZE = 400;
+// These reads bind one parameter per entity plus a small fixed scope. Keeping
+// the batch at 4,000 remains far below PostgreSQL's 65,535 parameter limit
+// while avoiding dozens of synchronous database-worker round trips.
+const POSTGRES_ENTITY_READ_BATCH_SIZE = 4000;
+export function workspaceSyncV3RepairEntityReadBatchSize(db) {
+    return db.provider === 'postgres'
+        ? POSTGRES_ENTITY_READ_BATCH_SIZE
+        : SQLITE_ENTITY_READ_BATCH_SIZE;
+}

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/workspaceSyncV3TaskRootProjection.d.ts

@@ -2,7 +2,7 @@ import { serializeTaskForSync, type TaskSyncPayload } from '../taskSyncPayload.j
 import type { TaxonomyTaskRemapAuthoritativePayload } from './taxonomyCompositeMutationService.js';
 import type { WorkspaceSyncJournalRow } from './workspaceSyncJournalReader.js';
 export type WorkspaceSyncV3TaskRootMutationKind = 'create' | 'metadata-update' | 'archive' | 'unarchive' | 'complete' | 'reopen' | 'set-status' | 'taxonomy-remap' | 'delete';
-export type WorkspaceSyncV3TaskRootPayload = Omit<TaskSyncPayload, 'attachments' | 'checklistItems' | 'comments'>;
+export type WorkspaceSyncV3TaskRootPayload = Omit<TaskSyncPayload, 'attachments' | 'cardCoverAssetId' | 'checklistItems' | 'comments'>;
 export type WorkspaceSyncV3TaskRootTombstone = {
     taskId: string;
     deletedAt: string;

package/dist/sync/v3/workspaceSyncV3TaskRootProjection.js

@@ -20,7 +20,7 @@ const FULL_MUTATIONS = new Set([
 ]);
 const TASK_STATUSES = new Set(['task', 'on-hold', 'in-progress', 'review', 'done', 'cancelled']);
 function taskRootFromSerialized(task) {
-    const { attachments: _attachments, checklistItems: _checklistItems, comments: _comments, ...root } = task;
+    const { attachments: _attachments, cardCoverAssetId: _cardCoverAssetId, checklistItems: _checklistItems, comments: _comments, ...root } = task;
     return root;
 }
 export function serializeTaskRootForSync(task) {

package/dist/sync/workspacePullFeed.d.ts

@@ -1,6 +1,6 @@
 import type { TaskforceCore, TaskforceSyncCapable, TaskRelationshipRecord } from '../core/Taskforce.js';
 import type { WorkspaceTaxonomyState } from '../shared/taxonomyState.js';
-import type { WorkspaceSyncAiProfileSnapshot, WorkspaceSyncAgentConversationSnapshot, WorkspaceSyncAgentRoleSnapshot, WorkspaceSyncAnnotatedAttachmentSessionSnapshot, WorkspaceSyncChange, WorkspaceSyncDocumentReviewCommentSnapshot, WorkspaceSyncDocumentReviewSessionSnapshot, WorkspaceSyncDurableTaskRevision, WorkspaceSyncDurablePlanningRevision, WorkspaceSyncDurableTaxonomyRevision, WorkspaceSyncEntityEventSnapshot, WorkspaceSyncInitiativeSnapshot, WorkspaceSyncTaskEventSnapshot, WorkspaceSyncTaskSnapshot, WorkspaceSyncTaskforceAgentSnapshot, WorkspaceSyncTaskforceAgentSkillSnapshot, WorkspaceSyncWorkspaceMemberSnapshot, WorkspaceSyncWorkstreamSnapshot } from './workspaceSyncModel.js';
+import type { WorkspaceSyncAiProfileSnapshot, WorkspaceSyncAgentConversationSnapshot, WorkspaceSyncAgentRoleSnapshot, WorkspaceSyncAnnotatedAttachmentSessionSnapshot, WorkspaceSyncChange, WorkspaceSyncDocumentReviewCommentSnapshot, WorkspaceSyncDocumentReviewSessionSnapshot, WorkspaceSyncDurableTaskRevision, WorkspaceSyncDurablePlanningRevision, WorkspaceSyncDurableTaxonomyRevision, WorkspaceSyncEntityEventSnapshot, WorkspaceSyncInitiativeSnapshot, WorkspaceSyncPlanningIdentitySnapshot, WorkspaceSyncTaskEventSnapshot, WorkspaceSyncTaskSnapshot, WorkspaceSyncTaskforceAgentSnapshot, WorkspaceSyncTaskforceAgentSkillSnapshot, WorkspaceSyncWorkspaceMemberSnapshot, WorkspaceSyncWorkstreamSnapshot } from './workspaceSyncModel.js';
 import { createCollaborationSyncState } from './collaborationSyncState.js';
 import { createContentSyncState } from './contentSyncState.js';
 import type { WorkspaceAssetSyncLinkPayload } from './contentSyncPayload.js';
@@ -52,6 +52,11 @@ type PullFeedEntry = {
     watermark: string;
     sortId: string;
     workstream: WorkspaceSyncWorkstreamSnapshot;
+} | {
+    kind: 'planning-identity';
+    watermark: string;
+    sortId: string;
+    identity: WorkspaceSyncPlanningIdentitySnapshot;
 } | {
     kind: 'ai-profile';
     watermark: string;