@taskforcehq/taskforce 0.3.305 → 0.3.307

package/dist/sync/contentSyncPayload.js

@@ -1,3 +1,8 @@
+function toOptionalLinkTargetType(value) {
+    return value === 'initiative' || value === 'workstream' || value === 'task'
+        ? value
+        : undefined;
+}
 function toOptionalTrimmedString(value) {
     if (typeof value !== 'string')
         return undefined;
@@ -32,6 +37,8 @@ export function normalizeDocumentSyncPayload(raw, normalizePath) {
         referenceNumber: toOptionalPositiveInteger(source.referenceNumber),
         version: toOptionalPositiveInteger(source.version),
         taskId: toNullableTrimmedString(source.taskId),
+        linkTargetType: toOptionalLinkTargetType(source.linkTargetType) ?? null,
+        linkTargetId: toNullableTrimmedString(source.linkTargetId),
         logicalName: toNullableTrimmedString(source.logicalName),
         caption: toNullableTrimmedString(source.caption),
         originalFilename: toNullableTrimmedString(source.originalFilename),
@@ -67,6 +74,8 @@ export function normalizeBinaryAssetSyncPayload(raw, normalizePath) {
         mimeType: toOptionalTrimmedString(source.mimeType) || 'application/octet-stream',
         referenceNumber: toOptionalPositiveInteger(source.referenceNumber),
         taskId: toNullableTrimmedString(source.taskId),
+        linkTargetType: toOptionalLinkTargetType(source.linkTargetType) ?? null,
+        linkTargetId: toNullableTrimmedString(source.linkTargetId),
         logicalName: toNullableTrimmedString(source.logicalName),
         caption: toNullableTrimmedString(source.caption),
         originalFilename: toNullableTrimmedString(source.originalFilename),

package/dist/sync/contentSyncPayload.test.js

@@ -18,6 +18,8 @@ describe('contentSyncPayload', () => {
             referenceNumber: '7',
             version: '2',
             taskId: ' task-1 ',
+            linkTargetType: 'task',
+            linkTargetId: ' task-1 ',
             logicalName: ' Spec ',
             caption: ' Draft ',
             originalFilename: ' spec.md ',
@@ -32,6 +34,8 @@ describe('contentSyncPayload', () => {
             referenceNumber: 7,
             version: 2,
             taskId: 'task-1',
+            linkTargetType: 'task',
+            linkTargetId: 'task-1',
             logicalName: 'Spec',
             caption: 'Draft',
             originalFilename: 'spec.md',
@@ -47,6 +51,8 @@ describe('contentSyncPayload', () => {
             mimeType: ' image/png ',
             referenceNumber: '3',
             taskId: ' task-2 ',
+            linkTargetType: 'task',
+            linkTargetId: ' task-2 ',
             logicalName: ' Hero ',
             caption: ' Screenshot ',
             originalFilename: ' hero.png ',
@@ -61,6 +67,8 @@ describe('contentSyncPayload', () => {
             mimeType: 'image/png',
             referenceNumber: 3,
             taskId: 'task-2',
+            linkTargetType: 'task',
+            linkTargetId: 'task-2',
             logicalName: 'Hero',
             caption: 'Screenshot',
             originalFilename: 'hero.png',
@@ -72,6 +80,37 @@ describe('contentSyncPayload', () => {
             assetId: undefined,
         });
     });
+    it('normalizes planning link targets for document and asset payloads', () => {
+        expect(normalizeDocumentSyncPayload({
+            path: 'docs/plan.md',
+            updatedAt: '2026-04-10T17:00:00.000Z',
+            content: 'hello',
+            linkTargetType: 'initiative',
+            linkTargetId: ' initiative-1 ',
+            caption: ' Plan ',
+        }, normalizeDocumentPath)).toEqual(expect.objectContaining({
+            path: 'docs/plan.md',
+            linkTargetType: 'initiative',
+            linkTargetId: 'initiative-1',
+            taskId: null,
+            caption: 'Plan',
+        }));
+        expect(normalizeBinaryAssetSyncPayload({
+            path: 'workspaces/a/assets/files/file.bin',
+            updatedAt: '2026-04-10T17:00:00.000Z',
+            contentBase64: 'YWJj',
+            kind: 'file',
+            mimeType: 'application/octet-stream',
+            linkTargetType: 'workstream',
+            linkTargetId: ' workstream-1 ',
+        }, normalizeAssetPath)).toEqual(expect.objectContaining({
+            path: 'workspaces/a/assets/files/file.bin',
+            kind: 'file',
+            linkTargetType: 'workstream',
+            linkTargetId: 'workstream-1',
+            taskId: null,
+        }));
+    });
     it('serializes push-side document and asset payloads without route-local parsing', () => {
         expect(serializeDocumentSyncPayload({
             path: 'docs/plan.md',

package/dist/sync/contentSyncState.d.ts

@@ -1,6 +1,6 @@
 import type { TaskforceCore, TaskforceSyncCapable } from '../core/Taskforce.js';
 import type { ObjectStorageClient } from '../storage/objectStorageClient.js';
-import type { WorkspaceAssetEntry, WorkspaceAssetLinkEntry, WorkspaceAssetLinkRole, WorkspaceAssetStore } from '../storage/workspaceAssetStore.js';
+import type { WorkspaceAssetEntry, WorkspaceAssetLinkEntry, WorkspaceAssetLinkRole, WorkspaceAssetLinkTargetType, WorkspaceAssetStore } from '../storage/workspaceAssetStore.js';
 import type { BinaryAssetDeleteSyncPayload, BinaryAssetSyncPayload, DocumentDeleteSyncPayload, DocumentSyncPayload } from './contentSyncPayload.js';
 type SyncCore = TaskforceCore & TaskforceSyncCapable;
 type RecordSyncDiagnostic = (workspaceId: string, eventType: 'pull' | 'push' | 'apply', errorMessage: string, details?: Record<string, unknown>) => void;
@@ -28,16 +28,14 @@ export declare function resolveCanonicalAssetSyncLinkState(deps: ContentSyncStat
     effectiveUpdatedAt: string;
 };
 export declare function getCanonicalSyncDocumentMetadata(deps: ContentSyncStateDeps, relativePath: string, workspaceId: string): Omit<DocumentSyncPayload, 'path' | 'updatedAt' | 'content'>;
-export declare function hasDocumentSyncMetadataDrift(deps: ContentSyncStateDeps, workspaceId: string, doc: DocumentSyncPayload, options?: {
-    allowReferenceNumberReassignment?: boolean;
-}): boolean;
-export declare function hasBinaryAssetSyncMetadataDrift(deps: ContentSyncStateDeps, workspaceId: string, asset: BinaryAssetSyncPayload, options?: {
-    allowReferenceNumberReassignment?: boolean;
-}): boolean;
+export declare function hasDocumentSyncMetadataDrift(deps: ContentSyncStateDeps, workspaceId: string, doc: DocumentSyncPayload): boolean;
+export declare function hasBinaryAssetSyncMetadataDrift(deps: ContentSyncStateDeps, workspaceId: string, asset: BinaryAssetSyncPayload): boolean;
 export declare function reconcileWorkspaceSyncLinks(deps: ContentSyncStateDeps, input: {
     workspaceId: string;
     assetId: string;
     taskId?: string | null;
+    linkTargetType?: WorkspaceAssetLinkTargetType | null;
+    linkTargetId?: string | null;
     role?: WorkspaceAssetLinkRole | null;
     displayName?: string | null;
     updatedAt?: string | null;
@@ -64,16 +62,18 @@ export declare function createContentSyncState(deps: ContentSyncStateDeps): {
         effectiveUpdatedAt: string;
     };
     getCanonicalSyncDocumentMetadata: (relativePath: string, workspaceId: string) => Omit<DocumentSyncPayload, "path" | "updatedAt" | "content">;
-    hasDocumentSyncMetadataDrift: (workspaceId: string, doc: DocumentSyncPayload, options?: {
+    hasDocumentSyncMetadataDrift: (workspaceId: string, doc: DocumentSyncPayload, _options?: {
         allowReferenceNumberReassignment?: boolean;
     }) => boolean;
-    hasBinaryAssetSyncMetadataDrift: (workspaceId: string, asset: BinaryAssetSyncPayload, options?: {
+    hasBinaryAssetSyncMetadataDrift: (workspaceId: string, asset: BinaryAssetSyncPayload, _options?: {
         allowReferenceNumberReassignment?: boolean;
     }) => boolean;
     reconcileWorkspaceSyncLinks: (input: {
         workspaceId: string;
         assetId: string;
         taskId?: string | null;
+        linkTargetType?: WorkspaceAssetLinkTargetType | null;
+        linkTargetId?: string | null;
         role?: WorkspaceAssetLinkRole | null;
         displayName?: string | null;
         updatedAt?: string | null;