@taskforcehq/taskforce 0.3.327 → 0.3.328

package/dist/core/McpTokenService.js

@@ -973,6 +973,58 @@ export class McpTokenService {
         `).run(profileId, profileToken, profileName, now, this.tenantId, workspaceId, grantId);
         return Number(result?.changes || 0) > 0;
     }
+    listMcpOAuthRestorableAiProfileIds(input) {
+        const grantId = String(input.grantId || '').trim();
+        const workspaceId = String(input.workspaceId || '').trim();
+        if (!grantId || !workspaceId)
+            return [];
+        const current = this.db.prepare(`
+            SELECT current.provider, current.user_id, current_client.client_name,
+                   current_client.redirect_uris_json, current_client.product_client_id
+            FROM mcp_oauth_connector_grants current
+            JOIN mcp_oauth_clients current_client
+              ON current_client.tenant_id = current.tenant_id
+             AND current_client.id = current.client_id
+            WHERE current.tenant_id = ?
+              AND current.workspace_id = ?
+              AND current.id = ?
+              AND current.status = 'active'
+            LIMIT 1
+        `).get(this.tenantId, workspaceId, grantId);
+        if (!current?.provider || !current.user_id)
+            return [];
+        const canonicalRedirectUris = (value) => {
+            try {
+                const parsed = JSON.parse(String(value || '[]'));
+                if (!Array.isArray(parsed))
+                    return null;
+                return JSON.stringify([...new Set(parsed.map((uri) => String(uri || '').trim()).filter(Boolean))].sort());
+            }
+            catch {
+                return null;
+            }
+        };
+        const currentRedirectUris = canonicalRedirectUris(current.redirect_uris_json);
+        if (!currentRedirectUris)
+            return [];
+        const previousRows = this.db.prepare(`
+            SELECT previous.ai_profile_id, previous_client.client_name,
+                   previous_client.redirect_uris_json, previous_client.product_client_id
+            FROM mcp_oauth_connector_grants previous
+            JOIN mcp_oauth_clients previous_client
+              ON previous_client.tenant_id = previous.tenant_id
+             AND previous_client.id = previous.client_id
+            WHERE previous.tenant_id = ?
+              AND previous.workspace_id = ?
+              AND previous.user_id = ?
+              AND previous.provider = ?
+              AND previous.id <> ?
+              AND previous.ai_profile_id IS NOT NULL
+        `).all(this.tenantId, workspaceId, String(current.user_id), String(current.provider), grantId);
+        return [...new Set(previousRows.filter((row) => (String(row.client_name || '') === String(current.client_name || '')
+                && String(row.product_client_id || '') === String(current.product_client_id || '')
+                && canonicalRedirectUris(row.redirect_uris_json) === currentRedirectUris)).map((row) => String(row.ai_profile_id || '').trim()).filter(Boolean))].sort();
+    }
     recordMcpOAuthConnectorGrantUsage(input) {
         const grantId = String(input.grantId || '').trim();
         const workspaceId = String(input.workspaceId || '').trim();

package/dist/core/TaskAttachmentLinksDurableMutationService.d.ts

@@ -18,6 +18,11 @@ export interface DurableTaskAttachmentLinksCore {
 export interface DurableWorkspaceTaskAttachmentLinksCore extends DurableTaskAttachmentLinksCore {
     getWorkspaceAssetStore(): Pick<WorkspaceAssetStore, 'get' | 'listLinksForTask' | 'listLinksForWorkspace' | 'listAllNormalizedByWorkspace' | 'adoptReadableReferenceNumber'>;
 }
+export declare function resolveTaskCardCoverAssetIdForLinks(input: {
+    currentCardCoverAssetId?: string | null;
+    requestedCardCoverAssetId?: string | null;
+    links: readonly WorkspaceSyncV3TaskAttachmentLink[];
+}): string | null;
 export declare function listTaskAttachmentLinksForDurableSync(core: DurableTaskAttachmentLinksCore, workspaceId: string, taskId: string): WorkspaceSyncV3TaskAttachmentLink[];
 export declare function listWorkspaceTaskAttachmentLinksForDurableSync(core: DurableWorkspaceTaskAttachmentLinksCore, workspaceId: string, taskIds: ReadonlySet<string>): Map<string, WorkspaceSyncV3TaskAttachmentLink[]>;
 export declare function resolveTaskAttachmentLinksForDurableSync(core: DurableTaskAttachmentLinksCore, workspaceId: string, links: readonly WorkspaceSyncV3TaskAttachmentLink[], options?: {

package/dist/core/TaskAttachmentLinksDurableMutationService.js

@@ -12,6 +12,19 @@ export class DurableTaskAttachmentLinksApplyError extends Error {
         this.name = 'DurableTaskAttachmentLinksApplyError';
     }
 }
+export function resolveTaskCardCoverAssetIdForLinks(input) {
+    const explicitlyRequested = Object.prototype.hasOwnProperty.call(input, 'requestedCardCoverAssetId');
+    const candidate = explicitlyRequested
+        ? String(input.requestedCardCoverAssetId || '').trim()
+        : String(input.currentCardCoverAssetId || '').trim();
+    if (!candidate)
+        return null;
+    const matchingImage = input.links.some((link) => link.assetId === candidate && link.role === 'image');
+    if (!matchingImage && explicitlyRequested) {
+        throw new DurableTaskAttachmentLinksApplyError('Task card cover must reference an image already attached to this task.', 'TASK_ATTACHMENT_LINK_INVALID', 400, candidate);
+    }
+    return matchingImage ? candidate : null;
+}
 function fail(message, code, statusCode, assetId) {
     throw new DurableTaskAttachmentLinksApplyError(message, code, statusCode, assetId);
 }
@@ -159,13 +172,11 @@ export function resolveTaskAttachmentLinksForDurableSync(core, workspaceId, link
             fail('Task attachment links must have unique asset and role identities.', 'TASK_ATTACHMENT_LINK_INVALID', 400);
         }
         identities.add(identity);
-        const displayName = asset.kind === 'document' && asset.storageProvider !== 'external'
-            ? null
-            : String(link.displayName
-                || (options?.ignoreAssetMetadataSnapshots === true ? '' : link.caption)
-                || (options?.ignoreAssetMetadataSnapshots === true ? '' : link.originalFilename)
-                || asset.logicalName
-                || asset.originalFilename).trim() || null;
+        const displayName = String(link.displayName
+            || (options?.ignoreAssetMetadataSnapshots === true ? '' : link.originalFilename)
+            || (options?.ignoreAssetMetadataSnapshots === true ? '' : link.caption)
+            || asset.originalFilename
+            || asset.logicalName).trim() || null;
         const projected = canonicalLink(asset, { role, displayName, sortOrder: index }, index);
         if (options?.ignoreAssetMetadataSnapshots !== true
             && ((link.referenceNumber ?? null) !== (projected.referenceNumber ?? null)
@@ -205,10 +216,8 @@ export function normalizeTaskAttachmentDescriptorsForDurableSync(core, workspace
             fail('Task attachment links must have unique asset and role identities.', 'TASK_ATTACHMENT_LINK_INVALID', 400);
         }
         identities.add(identity);
-        const displayName = asset.kind === 'document' && asset.storageProvider !== 'external'
-            ? null
-            : String(attachment.caption || attachment.displayName || attachment.originalFilename
-                || asset.logicalName || asset.originalFilename).trim() || null;
+        const displayName = String(attachment.displayName || attachment.originalFilename || attachment.caption
+            || asset.logicalName || asset.originalFilename).trim() || null;
         return canonicalLink(asset, { role, displayName, sortOrder: order }, order);
     });
 }

package/dist/core/Taskforce.d.ts

@@ -1,3 +1,4 @@
+import { type PlanningIdentityColor, type PlanningIdentityEntityType, type PlanningIdentityIcon } from '../shared/planningIdentity.js';
 import type { DatabaseAdapter, DatabaseProvider } from '../storage/databaseAdapter.js';
 import { type LocalDataOwnerPermit } from '../server/localDataOwnerPermit.js';
 import type { DurableTaskStatusMutationPayload } from './TaskDurableStatusMutationService.js';
@@ -151,6 +152,7 @@ export interface TaskItem {
     activity?: TaskActivityItem[];
     taskEvents?: TaskEvent[];
     attachments?: AttachmentItem[];
+    cardCoverAssetId?: string | null;
     /** @deprecated Use status='done'. Safe to remove after v0.4.x migration gate. */
     completed?: boolean;
     /** @deprecated Use status='cancelled'. Safe to remove after v0.4.x migration gate. */
@@ -190,6 +192,9 @@ export interface InitiativeItem {
     title: string;
     description: string | null;
     ownerId?: string | null;
+    icon?: PlanningIdentityIcon | null;
+    color?: PlanningIdentityColor | null;
+    identityUpdatedAt?: string | null;
     comments?: Comment[];
     activity?: EntityActivityItem[];
     entityEvents?: PlanningEntityEvent[];
@@ -207,6 +212,9 @@ export interface WorkstreamItem {
     title: string;
     description: string | null;
     ownerId?: string | null;
+    icon?: PlanningIdentityIcon | null;
+    color?: PlanningIdentityColor | null;
+    identityUpdatedAt?: string | null;
     comments?: Comment[];
     activity?: EntityActivityItem[];
     entityEvents?: PlanningEntityEvent[];
@@ -216,6 +224,13 @@ export interface WorkstreamItem {
     order?: number | null;
     isArchived?: boolean;
 }
+export interface PlanningEntityIdentityRecord {
+    entityType: PlanningIdentityEntityType;
+    entityId: string;
+    icon: PlanningIdentityIcon | null;
+    color: PlanningIdentityColor | null;
+    updatedAt: string;
+}
 export interface ChecklistItem {
     id: string;
     taskId: string;
@@ -254,7 +269,7 @@ export interface ScheduleBoardResult {
         }>;
     };
 }
-export type RealtimeMutationEntityType = 'task' | 'taxonomy' | 'document-metadata';
+export type RealtimeMutationEntityType = 'task' | 'initiative' | 'workstream' | 'taxonomy' | 'document-metadata';
 export interface RealtimeMutationEvent {
     eventId: string;
     workspaceId: string;
@@ -299,6 +314,7 @@ export interface TaskforceConfig {
     storagePath?: string;
     tenantId?: string;
     runtimeMode?: RuntimeMode;
+    initializationMode?: 'standard' | 'cloud-read-worker';
     localDataOwnerPermit?: LocalDataOwnerPermit;
     database?: {
         provider?: DatabaseProvider;
@@ -856,6 +872,8 @@ export interface TaskforceSyncCapable {
     listInitiativesForSync(workspaceId: string | undefined, afterId: string | null, limit: number): InitiativeItem[];
     listWorkstreams(workspaceId?: string): WorkstreamItem[];
     listWorkstreamsForSync(workspaceId: string | undefined, afterId: string | null, limit: number): WorkstreamItem[];
+    listPlanningEntityIdentities(workspaceId?: string): PlanningEntityIdentityRecord[];
+    applyPlanningEntityIdentityForSync(identity: PlanningEntityIdentityRecord, workspaceId?: string | null): PlanningEntityIdentityRecord | null;
     listAiProfiles(workspaceId: string, options?: {
         includeArchived?: boolean;
     }): AiProfileRecord[];
@@ -976,6 +994,7 @@ export interface TaskforceSyncCapable {
         workspaceId: string;
         connectionId: string;
         seatScope?: AiProfileSeatScope | null;
+        repairLegacyBinding?: boolean;
     }): AiProfileRecord | null;
     resolveWorkspaceActor(workspaceId: string, actorRef: unknown): TaskActor | null;
 }
@@ -1316,6 +1335,13 @@ export declare class TaskforceCore implements TaskforceSyncCapable {
     getWorkstream(id: string, workspaceId?: string): WorkstreamItem | null;
     listWorkstreams(workspaceId?: string): WorkstreamItem[];
     listWorkstreamsForSync(workspaceId: string | undefined, afterId: string | null, limit: number): WorkstreamItem[];
+    listPlanningEntityIdentities(workspaceId?: string): PlanningEntityIdentityRecord[];
+    private writePlanningEntityIdentity;
+    updatePlanningEntityIdentity(entityType: PlanningIdentityEntityType, entityId: string, patch: {
+        icon?: unknown;
+        color?: unknown;
+    }, workspaceId?: string): InitiativeItem | WorkstreamItem;
+    applyPlanningEntityIdentityForSync(identity: PlanningEntityIdentityRecord, workspaceId?: string | null): PlanningEntityIdentityRecord | null;
     listPlanningBootstrap(workspaceId?: string, diagnostics?: PlanningBootstrapDiagnostics): PlanningBootstrapPayload;
     createWorkstream(input: Partial<WorkstreamItem>, workspaceId?: string, options?: {
         actorRef?: string;
@@ -1438,7 +1464,23 @@ export declare class TaskforceCore implements TaskforceSyncCapable {
         limit?: number;
         offset?: number;
         workstreamId?: string;
+        includeArchived?: boolean;
     }): Array<Record<string, unknown>>;
+    listTaskCountsByWorkstream(workspaceId?: string, workstreamId?: string): Array<{
+        workstreamId: string;
+        total: number;
+        active: number;
+        archived: number;
+    }>;
+    listTaskReferenceSummaries(taskIds: string[], workspaceId?: string): Array<{
+        id: string;
+        referenceNumber: number | null;
+        localReferenceNumber: number | null;
+        referenceLabel: string | null;
+        title: string;
+        status: TaskStatus;
+    }>;
+    searchTaskSummaries(query: string, scope?: 'all' | 'active' | 'archive', workspaceId?: string): Array<Record<string, unknown>>;
     getDataVersion(): number;
     getDatabaseProvider(): DatabaseProvider;
     isDatabaseHealthy(): boolean;
@@ -1446,6 +1488,9 @@ export declare class TaskforceCore implements TaskforceSyncCapable {
     listDeletedTasks(workspaceId?: string): {
         deleted: DeletedTaskRecord[];
     };
+    listDeletedTasksReadOnly(workspaceId?: string): {
+        deleted: DeletedTaskRecord[];
+    };
     getDeletedTask(id: string, workspaceId?: string): DeletedTaskRecord | null;
     private assertNoDurableTaskDeleteOwnership;
     permanentlyDeleteDeletedTask(id: string, workspaceId?: string): boolean;
@@ -1465,6 +1510,7 @@ export declare class TaskforceCore implements TaskforceSyncCapable {
             total: number;
             doneCount: number;
             cancelledCount: number;
+            otherCount: number;
             retentionDays: number;
         };
     };
@@ -1602,6 +1648,7 @@ export declare class TaskforceCore implements TaskforceSyncCapable {
         workspaceId: string;
         connectionId: string;
         seatScope?: AiProfileSeatScope | null;
+        repairLegacyBinding?: boolean;
     }): AiProfileRecord | null;
     resolveAiProfile(input: ResolveAiProfileInput, options?: ResolveAiProfileOptions): ResolveAiProfileResult;
     listAnnotatedAttachmentSessions(input: {
@@ -1717,6 +1764,8 @@ export declare class TaskforceCore implements TaskforceSyncCapable {
         body: string;
         anchor?: DocumentReviewAnchor | null;
         actorId?: string | null;
+        idempotencyKey?: string | null;
+        commentId?: string | null;
     }): DocumentReviewSession;
     addDocumentReviewReply(input: {
         workspaceId?: string | null;
@@ -1724,6 +1773,8 @@ export declare class TaskforceCore implements TaskforceSyncCapable {
         parentCommentId: string;
         body: string;
         actorId?: string | null;
+        idempotencyKey?: string | null;
+        commentId?: string | null;
     }): DocumentReviewSession;
     updateDocumentReviewThreadStatus(input: {
         workspaceId?: string | null;
@@ -2150,6 +2201,10 @@ export declare class TaskforceCore implements TaskforceSyncCapable {
         profileToken: string;
         profileName: string;
     }): boolean;
+    listMcpOAuthRestorableAiProfileIds(input: {
+        grantId: string;
+        workspaceId: string;
+    }): string[];
     recordMcpOAuthConnectorGrantUsage(input: {
         grantId: string;
         workspaceId: string;
@@ -2467,6 +2522,13 @@ export declare class TaskforceCore implements TaskforceSyncCapable {
         task: any;
         archived: boolean;
     }>;
+    /**
+     * Full task inventory for authoritative repair without the per-task UI
+     * hydration performed by rowToTask. Repair serializes task roots, comments,
+     * and checklist items separately; task activity, actor decoration, and
+     * resolved attachment bodies are not part of that canonical inventory.
+     */
+    listTasksForAuthoritativeRepair(workspaceId: string): TaskItem[];
     listWorkspaceSyncDeletesSince(workspaceId: string | undefined, cursor: {
         watermark: string;
         id: string;