@taskforcehq/taskforce 0.3.327 → 0.3.329

package/dist/core/TaskAttachmentLinksDurableMutationService.d.ts

@@ -8,7 +8,7 @@ export declare class DurableTaskAttachmentLinksApplyError extends Error {
     constructor(message: string, code: 'TASK_ATTACHMENT_ASSET_NOT_READY' | 'TASK_ATTACHMENT_ASSET_INVALID' | 'TASK_ATTACHMENT_LINK_INVALID', statusCode: number, assetId?: string | undefined);
 }
 export interface DurableTaskAttachmentLinksCore {
-    getWorkspaceAssetStore(): Pick<WorkspaceAssetStore, 'get' | 'listLinksForTask' | 'adoptReadableReferenceNumber'>;
+    getWorkspaceAssetStore(): Pick<WorkspaceAssetStore, 'get' | 'listLinksForTask' | 'adoptReadableReferenceNumber' | 'restoreDeleted'>;
     getWorkspaceAssetDispatchReadiness(assetId: string, workspaceId: string): {
         ready: boolean;
         retryable: boolean;
@@ -16,14 +16,20 @@ export interface DurableTaskAttachmentLinksCore {
     };
 }
 export interface DurableWorkspaceTaskAttachmentLinksCore extends DurableTaskAttachmentLinksCore {
-    getWorkspaceAssetStore(): Pick<WorkspaceAssetStore, 'get' | 'listLinksForTask' | 'listLinksForWorkspace' | 'listAllNormalizedByWorkspace' | 'adoptReadableReferenceNumber'>;
+    getWorkspaceAssetStore(): Pick<WorkspaceAssetStore, 'get' | 'listLinksForTask' | 'listLinksForWorkspace' | 'listAllNormalizedByWorkspace' | 'adoptReadableReferenceNumber' | 'restoreDeleted'>;
 }
+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?: {
     requireDispatchReady?: boolean;
     adoptAuthoritativeReferenceNumber?: boolean;
     ignoreAssetMetadataSnapshots?: boolean;
+    restoreDeletedExternalAssetForAuthoritativeSync?: boolean;
 }): AttachmentItem[];
 export declare function normalizeTaskAttachmentDescriptorsForDurableSync(core: DurableTaskAttachmentLinksCore, workspaceId: string, attachments: readonly AttachmentItem[], options?: {
     requireDispatchReady?: boolean;

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);
 }
@@ -40,6 +53,12 @@ function canonicalRole(asset, requested) {
     }
     return expected;
 }
+function canonicalPersistedRole(asset, persisted) {
+    // Historical external links predate the reference-only invariant. Repair
+    // projections must publish the current canonical shape, while mutation
+    // inputs continue through canonicalRole and remain strictly validated.
+    return asset.storageProvider === 'external' ? 'reference' : canonicalRole(asset, persisted);
+}
 function referenceFields(asset) {
     if (!asset.referenceNumber)
         return { referenceNumber: null, referenceLabel: null };
@@ -70,9 +89,13 @@ function assertReady(core, workspaceId, asset, options) {
     }
 }
 function canonicalLink(asset, link, fallbackOrder) {
+    // Historical task links could persist an external asset as an attachment.
+    // External assets are references by contract, so repair/export must emit the
+    // canonical role rather than reproducing an un-installable legacy link.
+    const role = asset.storageProvider === 'external' ? 'reference' : link.role;
     return {
         assetId: asset.assetId,
-        role: link.role,
+        role,
         order: Number.isSafeInteger(link.sortOrder) && Number(link.sortOrder) >= 0
             ? Number(link.sortOrder)
             : fallbackOrder,
@@ -94,7 +117,7 @@ export function listTaskAttachmentLinksForDurableSync(core, workspaceId, taskId)
             fail(`Task attachment asset is deleted: ${link.assetId}`, 'TASK_ATTACHMENT_ASSET_INVALID', 400);
         }
         assertReady(core, workspaceId, asset);
-        return canonicalLink(asset, link, index);
+        return canonicalLink(asset, { ...link, role: canonicalPersistedRole(asset, link.role) }, index);
     })
         .sort((left, right) => left.order - right.order
         || (left.assetId < right.assetId ? -1 : left.assetId > right.assetId ? 1 : 0)
@@ -126,7 +149,7 @@ export function listWorkspaceTaskAttachmentLinksForDurableSync(core, workspaceId
                 fail(`Task attachment asset is deleted: ${link.assetId}`, 'TASK_ATTACHMENT_ASSET_INVALID', 400);
             }
             assertReady(core, workspaceId, asset);
-            return canonicalLink(asset, link, index);
+            return canonicalLink(asset, { ...link, role: canonicalPersistedRole(asset, link.role) }, index);
         }).sort((left, right) => left.order - right.order
             || (left.assetId < right.assetId ? -1 : left.assetId > right.assetId ? 1 : 0)
             || (left.role < right.role ? -1 : left.role > right.role ? 1 : 0))
@@ -143,6 +166,14 @@ export function resolveTaskAttachmentLinksForDurableSync(core, workspaceId, link
         if (!asset) {
             fail(`Task attachment asset is unavailable because it has not reached this runtime: ${link.assetId}`, 'TASK_ATTACHMENT_ASSET_NOT_READY', 425, link.assetId);
         }
+        if (asset.deletedAt
+            && asset.storageProvider === 'external'
+            && options?.restoreDeletedExternalAssetForAuthoritativeSync === true) {
+            // External pointers do not travel through binary content hydration.
+            // An active authoritative link is the lifecycle proof needed to
+            // revive the existing local placeholder inside the apply transaction.
+            asset = store.restoreDeleted(asset.assetId, workspaceId, asset.updatedAt) || asset;
+        }
         assertReady(core, workspaceId, asset, options);
         // Replicated apply may align independently hydrated local D-/I- numbers
         // to cloud authority. Ordinary local/cloud mutation writers must never
@@ -159,13 +190,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)
+            || (options?.ignoreAssetMetadataSnapshots === true ? '' : asset.originalFilename)
+            || (options?.ignoreAssetMetadataSnapshots === true ? '' : asset.logicalName)).trim() || null;
         const projected = canonicalLink(asset, { role, displayName, sortOrder: index }, index);
         if (options?.ignoreAssetMetadataSnapshots !== true
             && ((link.referenceNumber ?? null) !== (projected.referenceNumber ?? null)
@@ -176,12 +205,18 @@ export function resolveTaskAttachmentLinksForDurableSync(core, workspaceId, link
             path: canonicalAssetPath(asset),
             assetId: asset.assetId,
             linkRole: role,
-            ...(asset.kind === 'document' && asset.storageProvider !== 'external' && projected.caption !== undefined
+            ...(options?.ignoreAssetMetadataSnapshots !== true
+                && asset.kind === 'document'
+                && asset.storageProvider !== 'external'
+                && projected.caption !== undefined
                 ? { caption: projected.caption } : {}),
             ...(projected.displayName !== undefined ? { displayName: projected.displayName } : {}),
-            ...(projected.originalFilename !== undefined ? { originalFilename: projected.originalFilename } : {}),
-            ...(projected.referenceNumber !== undefined ? { referenceNumber: projected.referenceNumber } : {}),
-            ...(projected.referenceLabel !== undefined ? { referenceLabel: projected.referenceLabel } : {}),
+            ...(options?.ignoreAssetMetadataSnapshots !== true && projected.originalFilename !== undefined
+                ? { originalFilename: projected.originalFilename } : {}),
+            ...(options?.ignoreAssetMetadataSnapshots !== true && projected.referenceNumber !== undefined
+                ? { referenceNumber: projected.referenceNumber } : {}),
+            ...(options?.ignoreAssetMetadataSnapshots !== true && projected.referenceLabel !== undefined
+                ? { referenceLabel: projected.referenceLabel } : {}),
         };
     });
 }
@@ -205,10 +240,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';
@@ -94,6 +95,17 @@ export interface AuditActivityItem {
     event: TaskEvent;
 }
 export type TaskActivityItem = CommentActivityItem | AuditActivityItem;
+export type TaskActivitySummaryItem = {
+    id: string;
+    type: 'comment';
+    timestamp: string;
+    comment: Pick<Comment, 'text' | 'author' | 'actor'>;
+} | {
+    id: string;
+    type: 'event';
+    timestamp: string;
+    event: Pick<TaskEvent, 'action' | 'details' | 'actor' | 'actorType' | 'actorProfile'>;
+};
 export interface EntityAuditActivityItem {
     id: string;
     type: 'event';
@@ -151,6 +163,8 @@ export interface TaskItem {
     activity?: TaskActivityItem[];
     taskEvents?: TaskEvent[];
     attachments?: AttachmentItem[];
+    cardCoverAssetId?: string | null;
+    cardCoverAttachment?: Exclude<AttachmentItem, 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. */
@@ -169,7 +183,27 @@ export interface TaskItem {
     workstreamOrder?: number | null;
     workstreamId?: string | null;
     checklistItems?: ChecklistItem[];
-}
+    /** True when this object came from a collection read and omits the full task graph. */
+    isSummary?: boolean;
+    commentCount?: number;
+    checklistCount?: number;
+    completedChecklistCount?: number;
+    attachmentCount?: number;
+    relationshipCount?: number;
+    /** Compact newest comment or audit event carried by lightweight collection reads. */
+    latestActivity?: TaskActivitySummaryItem | null;
+    detailRevision?: string;
+}
+export type TaskSummary = Omit<TaskItem, 'description' | 'comments' | 'activity' | 'taskEvents' | 'attachments' | 'checklistItems'> & {
+    isSummary: true;
+    commentCount: number;
+    checklistCount: number;
+    completedChecklistCount: number;
+    attachmentCount: number;
+    relationshipCount: number;
+    latestActivity: TaskActivitySummaryItem | null;
+    detailRevision: string;
+};
 export type AttachmentItem = string | {
     path: string;
     fsPath?: string;
@@ -190,6 +224,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 +244,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 +256,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 +301,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 +346,7 @@ export interface TaskforceConfig {
     storagePath?: string;
     tenantId?: string;
     runtimeMode?: RuntimeMode;
+    initializationMode?: 'standard' | 'cloud-read-worker';
     localDataOwnerPermit?: LocalDataOwnerPermit;
     database?: {
         provider?: DatabaseProvider;
@@ -335,12 +383,23 @@ export interface TaskFile {
         manualComplexityEnabled?: boolean;
         checklistDropdownEnabled?: boolean;
         showTaskCardStatusLabel?: boolean;
+        showTaskCardDescription?: boolean;
+        showTaskCardAttachments?: boolean;
+        showTaskCardChecklistProgress?: boolean;
+        showTaskCardLatestActivity?: boolean;
+        tintTaskCardActivityBackground?: boolean;
         taxonomies?: any[];
     };
 }
 export interface ArchiveFile {
     archived: TaskItem[];
 }
+export interface TaskSummaryFile {
+    tasks: TaskSummary[];
+}
+export interface ArchiveSummaryFile {
+    archived: TaskSummary[];
+}
 export interface BulkCreateTaskError {
     index: number;
     message: string;
@@ -856,6 +915,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,8 +1037,10 @@ export interface TaskforceSyncCapable {
         workspaceId: string;
         connectionId: string;
         seatScope?: AiProfileSeatScope | null;
+        repairLegacyBinding?: boolean;
     }): AiProfileRecord | null;
     resolveWorkspaceActor(workspaceId: string, actorRef: unknown): TaskActor | null;
+    resolveWorkspaceActors(workspaceId: string, actorRefs: unknown[]): Map<string, TaskActor | null>;
 }
 export type TaskRelationshipInputType = 'depends_on' | 'blocks' | 'related_to' | 'supersedes';
 export type TaskRelationshipKind = 'dependency' | 'related' | 'supersedes';
@@ -1127,6 +1190,7 @@ export declare class TaskforceCore implements TaskforceSyncCapable {
         requireDispatchReady?: boolean;
         adoptAuthoritativeReferenceNumber?: boolean;
         ignoreAssetMetadataSnapshots?: boolean;
+        restoreDeletedExternalAssetForAuthoritativeSync?: boolean;
     }): AttachmentItem[];
     private normalizeEntitlementState;
     private upsertCanonicalEntitlementRecord;
@@ -1316,6 +1380,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;
@@ -1419,6 +1490,16 @@ export declare class TaskforceCore implements TaskforceSyncCapable {
     private getSyncReconciliationServiceDeps;
     private getWorkspaceLifecycleServiceDeps;
     listTasks(workspaceId?: string): TaskFile;
+    private listTaskSummaries;
+    listActiveTaskSummaries(workspaceId?: string): TaskSummaryFile;
+    listArchiveSummaries(workspaceId?: string): ArchiveSummaryFile;
+    getTaskDetailRevision(id: string, workspaceId?: string): string | null;
+    getTaskDetailSnapshot(id: string, workspaceId?: string): TaskItem | null;
+    updateTaskIfDetailRevisionMatches(id: string, expectedDetailRevision: string, updates: Partial<TaskItem>, workspaceId?: string, options?: {
+        actorRef?: string;
+        saveSource?: 'manual' | 'autosave';
+    }): TaskItem | null;
+    assertTaskDetailRevisionForUpdate(id: string, expectedDetailRevision: string, workspaceId?: string): void;
     /**
      * Filter-pushdown listing used by read-only surfaces that don't need the
      * full task graph (MCP list_tasks, CLI summaries). Avoids the per-task
@@ -1438,6 +1519,25 @@ 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, options?: {
+        limit?: number;
+        offset?: number;
     }): Array<Record<string, unknown>>;
     getDataVersion(): number;
     getDatabaseProvider(): DatabaseProvider;
@@ -1446,6 +1546,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 +1568,7 @@ export declare class TaskforceCore implements TaskforceSyncCapable {
             total: number;
             doneCount: number;
             cancelledCount: number;
+            otherCount: number;
             retentionDays: number;
         };
     };
@@ -1602,6 +1706,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 +1822,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 +1831,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;
@@ -1754,7 +1863,9 @@ export declare class TaskforceCore implements TaskforceSyncCapable {
         sessionId: string;
     }): boolean;
     private getAiProfileServiceDeps;
+    private buildUnresolvedWorkspaceActor;
     resolveWorkspaceActor(workspaceId: string, actorRef: unknown): TaskActor | null;
+    resolveWorkspaceActors(workspaceId: string, actorRefs: unknown[]): Map<string, TaskActor | null>;
     listAssignableActors(workspaceId: string): TaskActor[];
     addAdminAuditLog(input: {
         action: string;
@@ -2150,6 +2261,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 +2582,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;