@taskforcehq/taskforce 0.3.326 → 0.3.327

package/dist/sync/planningSyncPayload.js

@@ -1,3 +1,4 @@
+import { normalizeLegacyPlanningAttachments, normalizePlanningComments, serializeCanonicalPlanningAttachmentLinks, } from './planningCanonicalFields.js';
 function toOptionalTrimmedString(value) {
     if (typeof value !== 'string')
         return undefined;
@@ -23,8 +24,33 @@ function toOptionalInteger(value) {
         return null;
     return Math.floor(normalized);
 }
-function clonePlanningAttachments(value) {
-    return Array.isArray(value) ? value : undefined;
+function normalizeDurablePlanningRevision(raw, domain, entityId) {
+    if (raw === undefined)
+        return undefined;
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return undefined;
+    const source = raw;
+    const expected = [
+        'canonicalFingerprint', 'contractVersion', 'domain', 'entityId', 'entityRevision',
+        'lifecycleRevision', 'mutationKind', 'sequence',
+    ];
+    const actual = Object.keys(source).sort();
+    const validMutationKinds = new Set(['create', 'metadata-update', 'append-comment', 'archive', 'unarchive']);
+    if (actual.length !== expected.length
+        || actual.some((key, index) => key !== expected[index])
+        || source.contractVersion !== 3
+        || source.domain !== domain
+        || source.entityId !== entityId
+        || typeof source.mutationKind !== 'string' || !validMutationKinds.has(source.mutationKind)
+        || typeof source.sequence !== 'string' || !/^[1-9]\d*$/.test(source.sequence)
+        || typeof source.entityRevision !== 'string' || !/^\d+$/.test(source.entityRevision)
+        || typeof source.lifecycleRevision !== 'string' || !/^\d+$/.test(source.lifecycleRevision)
+        || source.entityRevision === '0'
+        || (source.mutationKind === 'create' && (source.entityRevision !== '1' || source.lifecycleRevision !== '0'))
+        || ((source.mutationKind === 'archive' || source.mutationKind === 'unarchive') && source.lifecycleRevision === '0')
+        || typeof source.canonicalFingerprint !== 'string' || !/^[a-f0-9]{64}$/.test(source.canonicalFingerprint))
+        return undefined;
+    return source;
 }
 export function normalizeTaxonomySyncPayload(raw) {
     if (!raw || typeof raw !== 'object' || Array.isArray(raw))
@@ -36,12 +62,42 @@ export function normalizeTaxonomySyncPayload(raw) {
     const taxonomies = Array.isArray(source.taxonomies) ? source.taxonomies : undefined;
     if (!taxonomyState && !taxonomies)
         return null;
+    const durableRevision = normalizeDurableTaxonomyRevision(source.durableRevision);
+    if (Object.prototype.hasOwnProperty.call(source, 'durableRevision') && !durableRevision) {
+        throw new Error('Taxonomy durable revision is invalid.');
+    }
     return {
         ...(taxonomies ? { taxonomies } : {}),
         ...(taxonomyState ? { taxonomyState } : {}),
         updatedAt: String(source.updatedAt || source.watermark || '').trim(),
+        ...(durableRevision ? { durableRevision } : {}),
     };
 }
+function normalizeDurableTaxonomyRevision(raw) {
+    if (raw === undefined)
+        return undefined;
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return undefined;
+    const source = raw;
+    const expected = [
+        'canonicalFingerprint', 'contractVersion', 'domain', 'entityId', 'entityRevision',
+        'lifecycleRevision', 'mutationKind', 'sequence',
+    ];
+    const actual = Object.keys(source).sort();
+    if (actual.length !== expected.length || actual.some((key, index) => key !== expected[index]))
+        return undefined;
+    if (source.contractVersion !== 3
+        || source.domain !== 'taxonomy'
+        || source.entityId !== '__taxonomy_config__'
+        || source.mutationKind !== 'replace-state'
+        || typeof source.sequence !== 'string' || !/^[1-9]\d*$/.test(source.sequence)
+        || typeof source.entityRevision !== 'string' || !/^[1-9]\d*$/.test(source.entityRevision)
+        || source.lifecycleRevision !== '0'
+        || typeof source.canonicalFingerprint !== 'string'
+        || !/^[a-f0-9]{64}$/.test(source.canonicalFingerprint))
+        return undefined;
+    return source;
+}
 export function normalizeInitiativeSyncPayload(raw, sourceWatermark) {
     if (!raw || typeof raw !== 'object' || Array.isArray(raw))
         return null;
@@ -49,6 +105,11 @@ export function normalizeInitiativeSyncPayload(raw, sourceWatermark) {
     const id = String(source.id || '').trim();
     if (!id)
         return null;
+    const durableRevision = normalizeDurablePlanningRevision(source.durableRevision, 'initiative', id);
+    if (Object.prototype.hasOwnProperty.call(source, 'durableRevision') && !durableRevision) {
+        throw new Error('Initiative durable revision is invalid.');
+    }
+    const comments = normalizePlanningComments(source.comments);
     return {
         id,
         referenceNumber: toOptionalPositiveInteger(source.referenceNumber),
@@ -56,11 +117,13 @@ export function normalizeInitiativeSyncPayload(raw, sourceWatermark) {
         title: String(source.title || '').trim(),
         description: typeof source.description === 'string' ? source.description : null,
         ownerId: toNullableTrimmedString(source.ownerId),
+        ...(comments ? { comments } : {}),
         createdAt: String(source.createdAt || sourceWatermark || '').trim(),
         updatedAt: String(source.updatedAt || sourceWatermark || source.createdAt || '').trim(),
         order: toOptionalInteger(source.order),
-        attachments: clonePlanningAttachments(source.attachments),
+        attachments: normalizeLegacyPlanningAttachments(source.attachments),
         isArchived: Boolean(source.isArchived),
+        ...(durableRevision ? { durableRevision } : {}),
     };
 }
 export function normalizeWorkstreamSyncPayload(raw, sourceWatermark) {
@@ -70,6 +133,11 @@ export function normalizeWorkstreamSyncPayload(raw, sourceWatermark) {
     const id = String(source.id || '').trim();
     if (!id)
         return null;
+    const durableRevision = normalizeDurablePlanningRevision(source.durableRevision, 'workstream', id);
+    if (Object.prototype.hasOwnProperty.call(source, 'durableRevision') && !durableRevision) {
+        throw new Error('Workstream durable revision is invalid.');
+    }
+    const comments = normalizePlanningComments(source.comments);
     return {
         id,
         referenceNumber: toOptionalPositiveInteger(source.referenceNumber),
@@ -78,10 +146,26 @@ export function normalizeWorkstreamSyncPayload(raw, sourceWatermark) {
         title: String(source.title || '').trim(),
         description: typeof source.description === 'string' ? source.description : null,
         ownerId: toNullableTrimmedString(source.ownerId),
+        ...(comments ? { comments } : {}),
         createdAt: String(source.createdAt || sourceWatermark || '').trim(),
         updatedAt: String(source.updatedAt || sourceWatermark || source.createdAt || '').trim(),
         order: toOptionalInteger(source.order),
-        attachments: clonePlanningAttachments(source.attachments),
+        attachments: normalizeLegacyPlanningAttachments(source.attachments),
         isArchived: Boolean(source.isArchived),
+        ...(durableRevision ? { durableRevision } : {}),
     };
 }
+export function serializeInitiativeForSync(value) {
+    const normalized = normalizeInitiativeSyncPayload(value);
+    if (!normalized || !normalized.createdAt || !normalized.updatedAt) {
+        throw new Error('Initiative is missing canonical sync identity or watermarks.');
+    }
+    return { ...normalized, attachments: serializeCanonicalPlanningAttachmentLinks(value.attachments) };
+}
+export function serializeWorkstreamForSync(value) {
+    const normalized = normalizeWorkstreamSyncPayload(value);
+    if (!normalized || !normalized.createdAt || !normalized.updatedAt) {
+        throw new Error('Workstream is missing canonical sync identity or watermarks.');
+    }
+    return { ...normalized, attachments: serializeCanonicalPlanningAttachmentLinks(value.attachments) };
+}

package/dist/sync/syncApplyHandlers.d.ts

@@ -1,8 +1,12 @@
 import type { TaskforceCore, TaskforceSyncCapable } from '../core/Taskforce.js';
-import type { WorkspaceSyncAiProfileSnapshot, WorkspaceSyncAnnotatedAttachmentSessionSnapshot, WorkspaceSyncChange, WorkspaceSyncDocumentReviewCommentSnapshot, WorkspaceSyncDocumentReviewSessionSnapshot, WorkspaceSyncEntityEventSnapshot, WorkspaceSyncInitiativeSnapshot, WorkspaceSyncTaskSnapshot, WorkspaceSyncWorkspaceMemberSnapshot, WorkspaceSyncWorkstreamSnapshot } from './workspaceSyncModel.js';
+import type { DeletedTaskDetails, DeletedTaskSource, TaskRelationshipRecord } from '../core/Taskforce.js';
+import type { WorkspaceSyncAiProfileSnapshot, WorkspaceSyncAgentConversationSnapshot, WorkspaceSyncAgentRoleSnapshot, WorkspaceSyncAnnotatedAttachmentSessionSnapshot, WorkspaceSyncChange, WorkspaceSyncDocumentReviewCommentSnapshot, WorkspaceSyncDocumentReviewSessionSnapshot, WorkspaceSyncDurableTaskRevision, WorkspaceSyncDurableTaxonomyRevision, WorkspaceSyncEntityEventSnapshot, WorkspaceSyncInitiativeSnapshot, WorkspaceSyncTaskforceAgentSnapshot, WorkspaceSyncTaskforceAgentSkillSnapshot, WorkspaceSyncTaskSnapshot, WorkspaceSyncWorkspaceMemberSnapshot, WorkspaceSyncWorkstreamSnapshot } from './workspaceSyncModel.js';
 import type { BinaryAssetSyncPayload, DocumentSyncPayload } from './contentSyncPayload.js';
+import type { WorkspaceTaxonomyState } from '../shared/taxonomyState.js';
+import { WorkspaceSyncDurabilityStore } from './v3/syncDurabilityStore.js';
 import type { AiProfileSurfaceType } from '../shared/aiProfileSurfaceType.js';
 import type { AiProfileSeatScope } from '../shared/aiProfileSeatScope.js';
+import { type TaskMetadataCoexistenceDirection } from './v3/taskMetadataCoexistence.js';
 type SyncCore = TaskforceCore & TaskforceSyncCapable;
 type SyncRouteError = Error & {
     code?: string;
@@ -28,17 +32,27 @@ type NormalizeTaskEventSyncPayload = (raw: unknown, workspaceId: string, sourceW
 export interface WorkspaceSyncIncomingTaskMutation {
     archived: boolean;
     task: WorkspaceSyncTaskSnapshot;
+    durableRevision?: WorkspaceSyncDurableTaskRevision;
 }
 export interface WorkspaceSyncIncomingTaskApplyModel {
     upserts: WorkspaceSyncIncomingTaskMutation[];
-    deletes: Map<string, string>;
+    deletes: Map<string, {
+        deletedAt: string;
+        suppliedDeletedAt: boolean;
+        actor?: string;
+        actorType?: 'human' | 'ai' | 'system';
+        source?: DeletedTaskSource;
+        details?: DeletedTaskDetails;
+    }>;
 }
 export interface WorkspaceSyncIncomingApplyModel {
     taskMutations: WorkspaceSyncIncomingTaskApplyModel;
+    taskRelationships: Map<string, TaskRelationshipRecord>;
     planning: {
         incomingTaxonomies: unknown[] | null;
-        incomingTaxonomyState: Record<string, unknown> | null;
+        incomingTaxonomyState: WorkspaceTaxonomyState | null;
         incomingTaxonomiesUpdatedAt: string;
+        incomingTaxonomyDurableRevision: WorkspaceSyncDurableTaxonomyRevision | null;
         incomingInitiatives: Map<string, WorkspaceSyncInitiativeSnapshot>;
         incomingWorkstreams: Map<string, WorkspaceSyncWorkstreamSnapshot>;
     };
@@ -55,9 +69,16 @@ export interface WorkspaceSyncIncomingApplyModel {
         incomingDocumentReviewSessions: Map<string, WorkspaceSyncDocumentReviewSessionSnapshot>;
         incomingDocumentReviewSessionDeletes: Map<string, string>;
         incomingDocumentReviewComments: Map<string, WorkspaceSyncDocumentReviewCommentSnapshot>;
-        incomingDocumentReviewCommentDeletes: Map<string, string>;
+        incomingDocumentReviewCommentDeletes: Map<string, {
+            deletedAt: string;
+            deletedByActorId: string | null;
+        }>;
         incomingAnnotatedAttachmentSessions: Map<string, WorkspaceSyncAnnotatedAttachmentSessionSnapshot>;
         incomingAnnotatedAttachmentSessionDeletes: Map<string, string>;
+        incomingTaskforceAgents: Map<string, WorkspaceSyncTaskforceAgentSnapshot>;
+        incomingAgentRoles: Map<string, WorkspaceSyncAgentRoleSnapshot>;
+        incomingTaskforceAgentSkills: Map<string, WorkspaceSyncTaskforceAgentSkillSnapshot>;
+        incomingAgentConversations: Map<string, WorkspaceSyncAgentConversationSnapshot>;
     };
     taskActivity: {
         incomingTaskEvents: Map<string, WorkspaceSyncEntityEventSnapshot>;
@@ -66,6 +87,12 @@ export interface WorkspaceSyncIncomingApplyModel {
 export interface PreparedWorkspaceTaskSyncSnapshot {
     tasks: WorkspaceSyncTaskSnapshot[];
     archived: WorkspaceSyncTaskSnapshot[];
+    authoritativeTaskTaxonomyIds: string[];
+    authoritativeTaskNestedContentIds: string[];
+    metadataPreservedTaskIds: string[];
+    metadataSeededTaskIds: string[];
+    lifecyclePreservedTaskIds: string[];
+    reopenAssigneePreservedTaskIds: string[];
 }
 export declare function resolveSyncConflictOrdering(incomingWatermark: string, existingWatermark: string, incomingTieBreak: string, existingTieBreak: string): number;
 export declare function classifyWorkspaceSyncChanges(input: {
@@ -83,32 +110,85 @@ export declare function prepareTaskSyncSnapshotApply(input: {
     workspaceId: string;
     taskMutations: WorkspaceSyncIncomingTaskApplyModel;
     recordSyncDiagnostic: RecordSyncDiagnostic;
+    v3OwnedTaskMetadataIds?: ReadonlySet<string>;
+    v3OwnedTaskRootIds?: ReadonlySet<string>;
+    v3OwnedTaskTaxonomyIds?: ReadonlySet<string>;
+    v3OwnedTaskDeleteIds?: ReadonlySet<string>;
+    v3OwnedTaskLifecycleIds?: ReadonlySet<string>;
+    v3OwnedTaskReopenAssigneeIds?: ReadonlySet<string>;
+    coexistenceDirection?: TaskMetadataCoexistenceDirection;
+    recordReferenceNumberMismatch?: boolean;
 }): PreparedWorkspaceTaskSyncSnapshot;
+export declare function prepareDurableTaskPullMutations(input: {
+    store: WorkspaceSyncDurabilityStore;
+    tenantId: string;
+    workspaceId: string;
+    taskMutations: WorkspaceSyncIncomingTaskApplyModel;
+}): {
+    taskMutations: WorkspaceSyncIncomingTaskApplyModel;
+    pendingRevisions: WorkspaceSyncDurableTaskRevision[];
+};
+export declare function applyDurableTaskPullRevisions(input: {
+    store: WorkspaceSyncDurabilityStore;
+    tenantId: string;
+    workspaceId: string;
+    revisions: WorkspaceSyncDurableTaskRevision[];
+    now: string;
+}): void;
 export declare function applyTaskSyncDeletes(input: {
     core: SyncCore;
     workspaceId: string;
     taskMutations: WorkspaceSyncIncomingTaskApplyModel;
     recordSyncDiagnostic: RecordSyncDiagnostic;
+    failFast?: boolean;
 }): number;
 export declare function applyPreparedTaskSyncSnapshot(input: {
     core: SyncCore;
     workspaceId: string;
     prepared: PreparedWorkspaceTaskSyncSnapshot;
+    deferSideEffects?: boolean;
 }): ReturnType<SyncCore['applyWorkspaceSyncSnapshot']>;
+export declare function applyTaskRelationshipSyncChanges(input: {
+    core: SyncCore;
+    workspaceId: string;
+    relationships: Map<string, TaskRelationshipRecord>;
+    protectedRelationshipIds?: ReadonlySet<string>;
+    recordSyncDiagnostic: RecordSyncDiagnostic;
+}): {
+    applied: number;
+    skipped: number;
+};
 export declare function applyPlanningSyncChanges(input: {
     core: SyncCore;
     workspaceId: string;
     incomingInitiatives: Map<string, WorkspaceSyncInitiativeSnapshot>;
     incomingWorkstreams: Map<string, WorkspaceSyncWorkstreamSnapshot>;
+    recordSyncDiagnostic: RecordSyncDiagnostic;
+    coexistenceDirection?: TaskMetadataCoexistenceDirection;
+    assertedActiveV3InitiativeIds?: ReadonlySet<string>;
+    requiredInitiativeProjectionOwner?: 'v2' | 'v3';
+    durabilityStore?: WorkspaceSyncDurabilityStore;
+    tenantId?: string;
+    now?: string;
+}): void;
+export declare function applyTaxonomySyncChanges(input: {
+    core: SyncCore;
+    workspaceId: string;
     incomingTaxonomies: unknown[] | null;
-    incomingTaxonomyState: Record<string, unknown> | null;
+    incomingTaxonomyState: WorkspaceTaxonomyState | null;
     incomingTaxonomiesUpdatedAt: string;
+    incomingDurableRevision: WorkspaceSyncDurableTaxonomyRevision | null;
     workspaceTaxonomySyncMeta: Map<string, {
         updatedAt: string;
         hash: string;
     }>;
-    recordSyncDiagnostic: RecordSyncDiagnostic;
-}): void;
+    coexistenceDirection?: 'cloud-push' | 'local-pull';
+    assertedActiveV3Taxonomy?: boolean;
+}): {
+    applied: boolean;
+    protected: boolean;
+    revisionState?: 'applied' | 'current' | 'stale';
+};
 export declare function applyAiProfileAndMemberSyncChanges(input: {
     core: SyncCore;
     workspaceId: string;
@@ -134,6 +214,8 @@ export declare function applyContentSyncChanges(input: {
         allowReferenceNumberReassignment?: boolean;
     }) => boolean;
     getExistingDocument?: (docPath: string, workspaceId: string) => {
+        assetId?: string | null;
+        storageProvider?: string | null;
         updatedAt?: string | null;
         contentHash?: string | null;
     } | null;
@@ -153,6 +235,7 @@ export declare function applyContentSyncChanges(input: {
     options?: {
         allowReferenceNumberReassignment?: boolean;
     };
+    phase?: 'all' | 'upserts' | 'deletes';
 }): Promise<void>;
 export declare function applyCollaborationSyncChanges(input: {
     core: SyncCore;
@@ -160,9 +243,16 @@ export declare function applyCollaborationSyncChanges(input: {
     incomingDocumentReviewSessions: Map<string, WorkspaceSyncDocumentReviewSessionSnapshot>;
     incomingDocumentReviewSessionDeletes: Map<string, string>;
     incomingDocumentReviewComments: Map<string, WorkspaceSyncDocumentReviewCommentSnapshot>;
-    incomingDocumentReviewCommentDeletes: Map<string, string>;
+    incomingDocumentReviewCommentDeletes: Map<string, {
+        deletedAt: string;
+        deletedByActorId: string | null;
+    }>;
     incomingAnnotatedAttachmentSessions: Map<string, WorkspaceSyncAnnotatedAttachmentSessionSnapshot>;
     incomingAnnotatedAttachmentSessionDeletes: Map<string, string>;
+    incomingTaskforceAgents?: Map<string, WorkspaceSyncTaskforceAgentSnapshot>;
+    incomingAgentRoles?: Map<string, WorkspaceSyncAgentRoleSnapshot>;
+    incomingTaskforceAgentSkills?: Map<string, WorkspaceSyncTaskforceAgentSkillSnapshot>;
+    incomingAgentConversations?: Map<string, WorkspaceSyncAgentConversationSnapshot>;
     recordSyncDiagnostic: RecordSyncDiagnostic;
     createSyncRouteError: CreateSyncRouteError;
 }): void;