@taskforcehq/taskforce 0.3.326 → 0.3.328

package/dist/sync/taskNestedContent.d.ts

@@ -0,0 +1,2 @@
+import type { TaskItem } from '../core/Taskforce.js';
+export declare function canonicalTaskNestedContent(task: Pick<Partial<TaskItem>, 'comments' | 'attachments' | 'checklistItems'> | null | undefined): string;

package/dist/sync/taskNestedContent.js

@@ -0,0 +1,8 @@
+import { canonicalWorkspaceSyncJson } from './v3/canonicalWorkspaceSyncJson.js';
+export function canonicalTaskNestedContent(task) {
+    return canonicalWorkspaceSyncJson({
+        comments: Array.isArray(task?.comments) ? task.comments : [],
+        attachments: Array.isArray(task?.attachments) ? task.attachments : [],
+        checklistItems: Array.isArray(task?.checklistItems) ? task.checklistItems : [],
+    });
+}

package/dist/sync/taskSyncChangeKey.js

@@ -122,7 +122,6 @@ export function buildTaskSyncChangeKey(task, archivedValue) {
         priority: source.priority === undefined || source.priority === null ? '' : String(source.priority),
         complexity: source.complexity === undefined || source.complexity === null ? '' : String(source.complexity),
         status: source.status,
-        approach: normalizeSyncOptionalString(source.approach) || '',
         canceledReason: normalizeSyncNullableString(source.canceledReason) || '',
         createdAt: source.createdAt,
         completedAt: normalizeSyncNullableIsoString(source.completedAt) || '',

package/dist/sync/taskSyncPayload.d.ts

@@ -9,7 +9,6 @@ export interface TaskSyncPayload {
     complexity?: number | null;
     type: string;
     category: string;
-    approach?: string;
     canceledReason?: string | null;
     createdAt: string;
     updatedAt?: string;
@@ -26,6 +25,7 @@ export interface TaskSyncPayload {
     referenceNumber?: number | null;
     comments?: Comment[];
     attachments?: Array<string | AttachmentItem>;
+    cardCoverAssetId?: string | null;
     checklistItems?: ChecklistItem[];
 }
 export declare function serializeTaskForSync(task: Partial<TaskItem> | null | undefined): TaskSyncPayload;

package/dist/sync/taskSyncPayload.js

@@ -29,6 +29,8 @@ function cloneTaxonomies(value) {
         return undefined;
     const entries = Object.entries(value);
     const normalized = entries.reduce((acc, [key, raw]) => {
+        if (key === 'approach')
+            return acc;
         if (Array.isArray(raw)) {
             acc[key] = raw.map((entry) => String(entry ?? ''));
             return acc;
@@ -41,7 +43,18 @@ function cloneTaxonomies(value) {
     return Object.keys(normalized).length > 0 ? normalized : {};
 }
 function cloneComments(value) {
-    return Array.isArray(value) ? value : undefined;
+    if (!Array.isArray(value))
+        return undefined;
+    return value.map((entry) => {
+        const comment = entry;
+        return {
+            id: comment.id,
+            author: comment.author,
+            ...(comment.submittedAuthor === undefined ? {} : { submittedAuthor: comment.submittedAuthor }),
+            text: comment.text,
+            timestamp: comment.timestamp,
+        };
+    });
 }
 function cloneAttachments(value) {
     return Array.isArray(value) ? value : undefined;
@@ -51,6 +64,7 @@ function cloneChecklistItems(value) {
 }
 export function serializeTaskForSync(task) {
     const source = task && typeof task === 'object' ? task : {};
+    const hasCardCoverAssetId = Object.prototype.hasOwnProperty.call(source, 'cardCoverAssetId');
     return {
         id: String(source.id || '').trim(),
         title: String(source.title || '').trim(),
@@ -60,7 +74,6 @@ export function serializeTaskForSync(task) {
         complexity: toOptionalInteger(source.complexity, { min: 1, nullable: true }),
         type: String(source.type || '').trim(),
         category: String(source.category || '').trim(),
-        approach: toOptionalString(source.approach),
         canceledReason: source.canceledReason === undefined ? undefined : (source.canceledReason || null),
         createdAt: String(source.createdAt || '').trim(),
         updatedAt: toOptionalString(source.updatedAt),
@@ -77,6 +90,9 @@ export function serializeTaskForSync(task) {
         referenceNumber: toOptionalInteger(source.referenceNumber, { min: 1, nullable: true }),
         comments: cloneComments(source.comments),
         attachments: cloneAttachments(source.attachments),
+        ...(hasCardCoverAssetId
+            ? { cardCoverAssetId: toNullableString(source.cardCoverAssetId) }
+            : {}),
         checklistItems: cloneChecklistItems(source.checklistItems),
     };
 }
@@ -90,6 +106,7 @@ export function normalizeTaskSyncPayload(raw) {
     return serializeTaskForSync(source);
 }
 export function taskSyncPayloadToCoreTask(task) {
+    const hasCardCoverAssetId = Object.prototype.hasOwnProperty.call(task, 'cardCoverAssetId');
     return {
         id: task.id,
         title: task.title,
@@ -99,7 +116,6 @@ export function taskSyncPayloadToCoreTask(task) {
         complexity: task.complexity ?? undefined,
         type: task.type,
         category: task.category,
-        approach: task.approach,
         canceledReason: task.canceledReason ?? undefined,
         createdAt: task.createdAt,
         updatedAt: task.updatedAt,
@@ -116,6 +132,7 @@ export function taskSyncPayloadToCoreTask(task) {
         referenceNumber: task.referenceNumber ?? undefined,
         comments: task.comments,
         attachments: task.attachments,
+        ...(hasCardCoverAssetId ? { cardCoverAssetId: task.cardCoverAssetId } : {}),
         checklistItems: task.checklistItems
     };
 }

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

@@ -0,0 +1,2 @@
+/** Version 3 canonical JSON contract shared by browser and server fingerprints. */
+export declare function canonicalWorkspaceSyncJson(value: unknown): string;

package/dist/sync/v3/canonicalWorkspaceSyncJson.js

@@ -0,0 +1,26 @@
+function canonicalizeJsonValue(value) {
+    if (value === null || typeof value === 'string' || typeof value === 'boolean')
+        return value;
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value))
+            throw new Error('Canonical JSON cannot contain non-finite numbers.');
+        return value;
+    }
+    if (Array.isArray(value))
+        return value.map(canonicalizeJsonValue);
+    if (typeof value === 'object') {
+        const output = {};
+        for (const key of Object.keys(value).sort()) {
+            const entry = value[key];
+            if (entry === undefined)
+                continue;
+            output[key] = canonicalizeJsonValue(entry);
+        }
+        return output;
+    }
+    throw new Error(`Canonical JSON cannot contain ${typeof value}.`);
+}
+/** Version 3 canonical JSON contract shared by browser and server fingerprints. */
+export function canonicalWorkspaceSyncJson(value) {
+    return JSON.stringify(canonicalizeJsonValue(value));
+}

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

@@ -0,0 +1,21 @@
+import { type WorkspaceSyncV3CombinedReadinessPrerequisite } from './combinedFeedPrerequisites.js';
+import { WORKSPACE_SYNC_V3_COMBINED_CAPABILITY_VERSION, type WorkspaceSyncV3CombinedCoverageSelector } from './workspaceSyncV3CombinedWireContract.js';
+export { WORKSPACE_SYNC_V3_COMBINED_CAPABILITY_VERSION } from './workspaceSyncV3CombinedWireContract.js';
+export type { WorkspaceSyncV3CombinedReadinessPrerequisite } from './combinedFeedPrerequisites.js';
+export type WorkspaceSyncV3CombinedCapability = {
+    capabilityVersion: typeof WORKSPACE_SYNC_V3_COMBINED_CAPABILITY_VERSION;
+    runtimeMode: 'local' | 'cloud';
+    routeAvailable: boolean;
+    writerPrerequisitesReady: boolean;
+    activationReady: boolean;
+    missingPrerequisites: WorkspaceSyncV3CombinedReadinessPrerequisite[];
+    coverage: WorkspaceSyncV3CombinedCoverageSelector;
+};
+export declare function resolveRequestedCombinedFeedCoverage(env?: NodeJS.ProcessEnv): WorkspaceSyncV3CombinedCoverageSelector;
+export declare function resolveCombinedFeedCapability(input: {
+    runtimeMode: 'local' | 'cloud';
+    env?: NodeJS.ProcessEnv;
+    coverage?: WorkspaceSyncV3CombinedCoverageSelector;
+}): {
+    combinedFeed: WorkspaceSyncV3CombinedCapability;
+};

package/dist/sync/v3/combinedFeedCapability.js

@@ -0,0 +1,80 @@
+import { combinedCloudWriterChecks, combinedLocalChecks, combinedNestedCloudWriterChecks, combinedNestedLocalWriterChecks, combinedNestedRouteChecks, combinedPlanningOrderCloudWriterChecks, combinedPlanningOrderLocalWriterChecks, combinedRouteChecks, combinedWorkflowCloudWriterChecks, combinedWorkflowLocalWriterChecks, combinedWorkflowRouteChecks, isWorkspaceSyncV3FlagEnabled, } from './combinedFeedPrerequisites.js';
+import { WORKSPACE_SYNC_V3_COMBINED_CAPABILITY_VERSION, WORKSPACE_SYNC_V3_COMBINED_COVERAGE_SELECTOR, resolveWorkspaceSyncV3CombinedWireContract, } from './workspaceSyncV3CombinedWireContract.js';
+import { WORKSPACE_SYNC_V3_NESTED_COVERAGE_SELECTOR } from './workspaceSyncV3NestedWireContract.js';
+import { WORKSPACE_SYNC_V3_WORKFLOW_COVERAGE_SELECTOR } from './workspaceSyncV3WorkflowWireContract.js';
+import { WORKSPACE_SYNC_V3_PLANNING_ORDER_COVERAGE_SELECTOR } from './workspaceSyncV3PlanningOrderWireContract.js';
+export { WORKSPACE_SYNC_V3_COMBINED_CAPABILITY_VERSION } from './workspaceSyncV3CombinedWireContract.js';
+export function resolveRequestedCombinedFeedCoverage(env = process.env) {
+    const requestedVersion = String(env.TASKFORCE_SYNC_V3_COMBINED_FEED_COVERAGE_VERSION || '').trim();
+    if (!requestedVersion || requestedVersion === String(WORKSPACE_SYNC_V3_COMBINED_COVERAGE_SELECTOR.coverageVersion)) {
+        return WORKSPACE_SYNC_V3_COMBINED_COVERAGE_SELECTOR;
+    }
+    if (requestedVersion === String(WORKSPACE_SYNC_V3_NESTED_COVERAGE_SELECTOR.coverageVersion)) {
+        return WORKSPACE_SYNC_V3_NESTED_COVERAGE_SELECTOR;
+    }
+    if (requestedVersion === String(WORKSPACE_SYNC_V3_WORKFLOW_COVERAGE_SELECTOR.coverageVersion)) {
+        return WORKSPACE_SYNC_V3_WORKFLOW_COVERAGE_SELECTOR;
+    }
+    if (requestedVersion === String(WORKSPACE_SYNC_V3_PLANNING_ORDER_COVERAGE_SELECTOR.coverageVersion)) {
+        return WORKSPACE_SYNC_V3_PLANNING_ORDER_COVERAGE_SELECTOR;
+    }
+    throw new Error(`Unsupported TASKFORCE_SYNC_V3_COMBINED_FEED_COVERAGE_VERSION: ${requestedVersion}.`);
+}
+export function resolveCombinedFeedCapability(input) {
+    const env = input.env || process.env;
+    const coverage = input.coverage || resolveRequestedCombinedFeedCoverage(env);
+    const contract = resolveWorkspaceSyncV3CombinedWireContract(coverage);
+    if (!contract)
+        throw new Error('Unsupported combined workspace sync coverage selector.');
+    const routeChecks = [
+        ...combinedRouteChecks(env),
+        ...(contract.nestedWriterPrerequisitesRequired ? combinedNestedRouteChecks(env) : []),
+        ...(contract.workflowWriterPrerequisitesRequired ? combinedWorkflowRouteChecks(env) : []),
+    ];
+    const baselineWriterChecks = input.runtimeMode === 'local'
+        ? combinedLocalChecks(env)
+        : combinedCloudWriterChecks(env);
+    const writerChecks = contract.nestedWriterPrerequisitesRequired
+        ? [...baselineWriterChecks, ...(input.runtimeMode === 'local'
+                ? combinedNestedLocalWriterChecks(env)
+                : combinedNestedCloudWriterChecks(env))]
+        : baselineWriterChecks;
+    if (contract.workflowWriterPrerequisitesRequired) {
+        writerChecks.push(...(input.runtimeMode === 'local'
+            ? combinedWorkflowLocalWriterChecks(env)
+            : combinedWorkflowCloudWriterChecks(env)));
+    }
+    if (contract.planningOrderWriterPrerequisitesRequired) {
+        writerChecks.push(...(input.runtimeMode === 'local'
+            ? combinedPlanningOrderLocalWriterChecks(env)
+            : combinedPlanningOrderCloudWriterChecks(env)));
+    }
+    const missingPrerequisites = [...routeChecks, ...writerChecks]
+        .filter(([, ready]) => !ready)
+        .map(([prerequisite]) => prerequisite);
+    const writerPrerequisitesReady = writerChecks
+        .filter(([prerequisite]) => prerequisite !== 'local.feed-apply'
+        && prerequisite !== 'local.combined-apply'
+        && prerequisite !== 'local.activation-request')
+        .every(([, ready]) => ready);
+    const routeAvailable = routeChecks.every(([, ready]) => ready)
+        && (input.runtimeMode === 'cloud'
+            ? writerPrerequisitesReady
+            : writerChecks
+                .filter(([prerequisite]) => prerequisite === 'local.feed-apply'
+                || prerequisite === 'local.combined-apply')
+                .every(([, ready]) => ready));
+    return {
+        combinedFeed: {
+            capabilityVersion: WORKSPACE_SYNC_V3_COMBINED_CAPABILITY_VERSION,
+            runtimeMode: input.runtimeMode,
+            routeAvailable,
+            writerPrerequisitesReady,
+            activationReady: routeAvailable && writerPrerequisitesReady
+                && (input.runtimeMode === 'cloud'
+                    || isWorkspaceSyncV3FlagEnabled(env.TASKFORCE_SYNC_V3_COMBINED_FEED_ACTIVATION_ENABLED)),
+            missingPrerequisites,
+            coverage,
+        },
+    };
+}

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

@@ -0,0 +1,18 @@
+export type WorkspaceSyncV3CombinedReadinessPrerequisite = 'route.feed-and-repair' | 'route.combined-feed' | 'route.legacy-v2-fence' | 'route.nested-legacy-v2-fence' | 'route.workflow-runtime-carrier-coexistence' | 'local.feed-apply' | 'local.combined-apply' | 'local.activation-request' | 'writer.workflow-runtime-capture' | 'writer.workflow-runtime-dispatch' | 'writer.workflow-runtime-http' | 'writer.workflow-runtime-mcp' | 'writer.workflow-runtime-cloud-http' | 'writer.workflow-runtime-cloud-mcp' | 'writer.task-create' | 'writer.task-metadata' | 'writer.task-status-lifecycle' | 'writer.task-delete' | 'writer.task-relationships' | 'writer.task-cloud-http' | 'writer.taxonomy-http' | 'writer.taxonomy-mcp' | 'writer.initiative-http' | 'writer.initiative-mcp' | 'writer.workstream-http' | 'writer.workstream-mcp' | 'writer.task-comments-http' | 'writer.task-comments-mcp' | 'writer.task-checklist-http' | 'writer.task-checklist-mcp' | 'writer.task-attachment-links-http' | 'writer.task-attachment-links-mcp' | 'writer.workstream-task-order-http';
+export type WorkspaceSyncV3CombinedPrerequisiteCheck = readonly [
+    WorkspaceSyncV3CombinedReadinessPrerequisite,
+    boolean
+];
+export declare function isWorkspaceSyncV3FlagEnabled(value: unknown): boolean;
+export declare function combinedRouteChecks(env: NodeJS.ProcessEnv): WorkspaceSyncV3CombinedPrerequisiteCheck[];
+export declare function combinedNestedRouteChecks(env: NodeJS.ProcessEnv): WorkspaceSyncV3CombinedPrerequisiteCheck[];
+export declare function combinedWorkflowRouteChecks(env: NodeJS.ProcessEnv): WorkspaceSyncV3CombinedPrerequisiteCheck[];
+export declare function combinedLocalChecks(env: NodeJS.ProcessEnv): WorkspaceSyncV3CombinedPrerequisiteCheck[];
+export declare function combinedCloudWriterChecks(env: NodeJS.ProcessEnv): WorkspaceSyncV3CombinedPrerequisiteCheck[];
+export declare function combinedNestedLocalWriterChecks(env: NodeJS.ProcessEnv): WorkspaceSyncV3CombinedPrerequisiteCheck[];
+export declare function combinedNestedCloudWriterChecks(env: NodeJS.ProcessEnv): WorkspaceSyncV3CombinedPrerequisiteCheck[];
+export declare function combinedPlanningOrderLocalWriterChecks(env: NodeJS.ProcessEnv): WorkspaceSyncV3CombinedPrerequisiteCheck[];
+export declare function combinedPlanningOrderCloudWriterChecks(env: NodeJS.ProcessEnv): WorkspaceSyncV3CombinedPrerequisiteCheck[];
+export declare function combinedWorkflowLocalWriterChecks(env: NodeJS.ProcessEnv): WorkspaceSyncV3CombinedPrerequisiteCheck[];
+export declare function combinedWorkflowCloudWriterChecks(env: NodeJS.ProcessEnv): WorkspaceSyncV3CombinedPrerequisiteCheck[];
+export declare function areWorkspaceSyncV3CombinedCloudWritersReady(env: NodeJS.ProcessEnv): boolean;

package/dist/sync/v3/combinedFeedPrerequisites.js

@@ -0,0 +1,184 @@
+export function isWorkspaceSyncV3FlagEnabled(value) {
+    return /^(1|true|on|yes)$/i.test(String(value || '').trim());
+}
+export function combinedRouteChecks(env) {
+    return [
+        ['route.feed-and-repair', isWorkspaceSyncV3FlagEnabled(env.TASKFORCE_SYNC_V3_FEED_ENABLED)
+                && isWorkspaceSyncV3FlagEnabled(env.TASKFORCE_SYNC_V3_FEED_REPAIR_ENABLED)],
+        ['route.combined-feed', isWorkspaceSyncV3FlagEnabled(env.TASKFORCE_SYNC_V3_COMBINED_FEED_ENABLED)],
+        ['route.legacy-v2-fence', isWorkspaceSyncV3FlagEnabled(env.TASKFORCE_SYNC_V3_COMBINED_LEGACY_FENCE_ENABLED)],
+    ];
+}
+export function combinedNestedRouteChecks(env) {
+    return [['route.nested-legacy-v2-fence',
+            isWorkspaceSyncV3FlagEnabled(env.TASKFORCE_SYNC_V3_NESTED_LEGACY_FENCE_ENABLED)]];
+}
+export function combinedWorkflowRouteChecks(env) {
+    return [['route.workflow-runtime-carrier-coexistence',
+            isWorkspaceSyncV3FlagEnabled(env.TASKFORCE_SYNC_V3_WORKFLOW_RUNTIME_CARRIER_COEXISTENCE_ENABLED)
+                && isWorkspaceSyncV3FlagEnabled(env.TASKFORCE_SYNC_V3_TASK_STATUS_ENABLED)]];
+}
+export function combinedLocalChecks(env) {
+    const enabled = isWorkspaceSyncV3FlagEnabled;
+    const localPipeline = enabled(env.TASKFORCE_SYNC_V3_LOCAL_CAPTURE_ENABLED)
+        && enabled(env.TASKFORCE_SYNC_V3_LOCAL_DISPATCH_ENABLED);
+    const taskAcceptance = enabled(env.TASKFORCE_SYNC_V3_TASKS_ENABLED);
+    return [
+        ['local.feed-apply', enabled(env.TASKFORCE_SYNC_V3_LOCAL_FEED_APPLY_ENABLED)],
+        ['local.combined-apply', enabled(env.TASKFORCE_SYNC_V3_COMBINED_LOCAL_FEED_APPLY_ENABLED)],
+        ['local.activation-request', enabled(env.TASKFORCE_SYNC_V3_COMBINED_FEED_ACTIVATION_ENABLED)],
+        ['writer.task-create', taskAcceptance && localPipeline
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_CREATE_CAPTURE_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_CREATE_ACTIVATION_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_CREATE_MCP_ACTIVATION_ENABLED)],
+        ['writer.task-metadata', taskAcceptance && localPipeline
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_METADATA_ACTIVATION_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_METADATA_MCP_ACTIVATION_ENABLED)],
+        ['writer.task-status-lifecycle', taskAcceptance && localPipeline
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_STATUS_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_STATUS_ACTIVATION_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_STATUS_MCP_ACTIVATION_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_LIFECYCLE_CAPTURE_ENABLED)],
+        ['writer.task-delete', taskAcceptance && localPipeline
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_DELETE_CAPTURE_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_DELETE_ACTIVATION_ENABLED)],
+        ['writer.task-relationships', taskAcceptance && localPipeline
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_RELATIONSHIP_CAPTURE_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_RELATIONSHIP_MCP_ACTIVATION_ENABLED)],
+        ['writer.taxonomy-http', localPipeline && enabled(env.TASKFORCE_SYNC_V3_TAXONOMY_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_TAXONOMY_CAPTURE_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_TAXONOMY_ACTIVATION_ENABLED)],
+        ['writer.taxonomy-mcp', localPipeline && enabled(env.TASKFORCE_SYNC_V3_TAXONOMY_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_TAXONOMY_CAPTURE_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_TAXONOMY_MCP_ACTIVATION_ENABLED)],
+        ['writer.initiative-http', localPipeline && enabled(env.TASKFORCE_SYNC_V3_INITIATIVES_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_INITIATIVE_CAPTURE_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_INITIATIVE_ACTIVATION_ENABLED)],
+        ['writer.initiative-mcp', localPipeline && enabled(env.TASKFORCE_SYNC_V3_INITIATIVES_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_INITIATIVE_CAPTURE_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_INITIATIVE_MCP_ACTIVATION_ENABLED)],
+        ['writer.workstream-http', localPipeline && enabled(env.TASKFORCE_SYNC_V3_WORKSTREAMS_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_WORKSTREAM_CAPTURE_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_WORKSTREAM_ACTIVATION_ENABLED)],
+        ['writer.workstream-mcp', localPipeline && enabled(env.TASKFORCE_SYNC_V3_WORKSTREAMS_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_WORKSTREAM_CAPTURE_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_WORKSTREAM_MCP_ACTIVATION_ENABLED)],
+    ];
+}
+export function combinedCloudWriterChecks(env) {
+    const enabled = isWorkspaceSyncV3FlagEnabled;
+    const taskAcceptance = enabled(env.TASKFORCE_SYNC_V3_TASKS_ENABLED);
+    return [
+        ['writer.task-cloud-http', taskAcceptance
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_CLOUD_HTTP_ACTIVATION_ENABLED)],
+        ['writer.task-create', taskAcceptance
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_CREATE_MCP_ACTIVATION_ENABLED)],
+        ['writer.task-metadata', taskAcceptance
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_METADATA_MCP_ACTIVATION_ENABLED)],
+        ['writer.task-status-lifecycle', taskAcceptance
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_STATUS_ENABLED)],
+        ['writer.task-relationships', taskAcceptance
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_RELATIONSHIP_MCP_ACTIVATION_ENABLED)],
+        ['writer.taxonomy-http', enabled(env.TASKFORCE_SYNC_V3_TAXONOMY_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_TAXONOMY_ACTIVATION_ENABLED)],
+        ['writer.taxonomy-mcp', enabled(env.TASKFORCE_SYNC_V3_TAXONOMY_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_TAXONOMY_MCP_ACTIVATION_ENABLED)],
+        ['writer.initiative-http', enabled(env.TASKFORCE_SYNC_V3_INITIATIVES_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_INITIATIVE_ACTIVATION_ENABLED)],
+        ['writer.initiative-mcp', enabled(env.TASKFORCE_SYNC_V3_INITIATIVES_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_INITIATIVE_MCP_ACTIVATION_ENABLED)],
+        ['writer.workstream-http', enabled(env.TASKFORCE_SYNC_V3_WORKSTREAMS_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_WORKSTREAM_ACTIVATION_ENABLED)],
+        ['writer.workstream-mcp', enabled(env.TASKFORCE_SYNC_V3_WORKSTREAMS_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_WORKSTREAM_MCP_ACTIVATION_ENABLED)],
+    ];
+}
+export function combinedNestedLocalWriterChecks(env) {
+    const enabled = isWorkspaceSyncV3FlagEnabled;
+    const localPipeline = enabled(env.TASKFORCE_SYNC_V3_LOCAL_CAPTURE_ENABLED)
+        && enabled(env.TASKFORCE_SYNC_V3_LOCAL_DISPATCH_ENABLED);
+    const comments = localPipeline && enabled(env.TASKFORCE_SYNC_V3_TASK_COMMENTS_ENABLED)
+        && enabled(env.TASKFORCE_SYNC_V3_TASK_COMMENTS_CAPTURE_ENABLED);
+    const checklist = localPipeline && enabled(env.TASKFORCE_SYNC_V3_TASK_CHECKLIST_ENABLED)
+        && enabled(env.TASKFORCE_SYNC_V3_TASK_CHECKLIST_CAPTURE_ENABLED);
+    const attachmentLinks = localPipeline && enabled(env.TASKFORCE_SYNC_V3_TASK_ATTACHMENT_LINKS_ENABLED)
+        && enabled(env.TASKFORCE_SYNC_V3_TASK_ATTACHMENT_LINKS_CAPTURE_ENABLED);
+    return [
+        ['writer.task-comments-http', comments
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_COMMENTS_HTTP_ACTIVATION_ENABLED)],
+        ['writer.task-comments-mcp', comments
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_COMMENTS_MCP_ACTIVATION_ENABLED)],
+        ['writer.task-checklist-http', checklist
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_CHECKLIST_HTTP_ACTIVATION_ENABLED)],
+        ['writer.task-checklist-mcp', checklist
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_CHECKLIST_MCP_ACTIVATION_ENABLED)],
+        ['writer.task-attachment-links-http', attachmentLinks
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_ATTACHMENT_LINKS_HTTP_ACTIVATION_ENABLED)],
+        ['writer.task-attachment-links-mcp', attachmentLinks
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_ATTACHMENT_LINKS_MCP_ACTIVATION_ENABLED)],
+    ];
+}
+export function combinedNestedCloudWriterChecks(env) {
+    const enabled = isWorkspaceSyncV3FlagEnabled;
+    const comments = enabled(env.TASKFORCE_SYNC_V3_TASK_COMMENTS_ENABLED);
+    const checklist = enabled(env.TASKFORCE_SYNC_V3_TASK_CHECKLIST_ENABLED);
+    const attachmentLinks = enabled(env.TASKFORCE_SYNC_V3_TASK_ATTACHMENT_LINKS_ENABLED);
+    return [
+        ['writer.task-comments-http', comments
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_COMMENTS_HTTP_ACTIVATION_ENABLED)],
+        ['writer.task-comments-mcp', comments
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_COMMENTS_MCP_ACTIVATION_ENABLED)],
+        ['writer.task-checklist-http', checklist
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_CHECKLIST_HTTP_ACTIVATION_ENABLED)],
+        ['writer.task-checklist-mcp', checklist
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_CHECKLIST_MCP_ACTIVATION_ENABLED)],
+        ['writer.task-attachment-links-http', attachmentLinks
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_ATTACHMENT_LINKS_HTTP_ACTIVATION_ENABLED)],
+        ['writer.task-attachment-links-mcp', attachmentLinks
+                && enabled(env.TASKFORCE_SYNC_V3_TASK_ATTACHMENT_LINKS_MCP_ACTIVATION_ENABLED)],
+    ];
+}
+export function combinedPlanningOrderLocalWriterChecks(env) {
+    const enabled = isWorkspaceSyncV3FlagEnabled;
+    return [['writer.workstream-task-order-http',
+            enabled(env.TASKFORCE_SYNC_V3_WORKSTREAM_TASK_ORDER_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_LOCAL_CAPTURE_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_LOCAL_DISPATCH_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_WORKSTREAM_TASK_ORDER_CAPTURE_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_WORKSTREAM_TASK_ORDER_HTTP_ACTIVATION_ENABLED)]];
+}
+export function combinedPlanningOrderCloudWriterChecks(env) {
+    const enabled = isWorkspaceSyncV3FlagEnabled;
+    return [['writer.workstream-task-order-http',
+            enabled(env.TASKFORCE_SYNC_V3_WORKSTREAM_TASK_ORDER_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_WORKSTREAM_TASK_ORDER_HTTP_ACTIVATION_ENABLED)]];
+}
+export function combinedWorkflowLocalWriterChecks(env) {
+    const enabled = isWorkspaceSyncV3FlagEnabled;
+    const accepted = enabled(env.TASKFORCE_SYNC_V3_WORKFLOW_RUNTIME_ENABLED);
+    return [
+        ['writer.workflow-runtime-capture', accepted
+                && enabled(env.TASKFORCE_SYNC_V3_LOCAL_CAPTURE_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_WORKFLOW_RUNTIME_CAPTURE_ENABLED)],
+        ['writer.workflow-runtime-dispatch', accepted
+                && enabled(env.TASKFORCE_SYNC_V3_LOCAL_DISPATCH_ENABLED)
+                && enabled(env.TASKFORCE_SYNC_V3_WORKFLOW_RUNTIME_DISPATCH_ENABLED)],
+        ['writer.workflow-runtime-http', accepted
+                && enabled(env.TASKFORCE_SYNC_V3_WORKFLOW_RUNTIME_HTTP_ACTIVATION_ENABLED)],
+        ['writer.workflow-runtime-mcp', accepted
+                && enabled(env.TASKFORCE_SYNC_V3_WORKFLOW_RUNTIME_MCP_ACTIVATION_ENABLED)],
+    ];
+}
+export function combinedWorkflowCloudWriterChecks(env) {
+    const enabled = isWorkspaceSyncV3FlagEnabled;
+    const accepted = enabled(env.TASKFORCE_SYNC_V3_WORKFLOW_RUNTIME_ENABLED);
+    return [
+        ['writer.workflow-runtime-cloud-http', accepted
+                && enabled(env.TASKFORCE_SYNC_V3_WORKFLOW_RUNTIME_HTTP_ACTIVATION_ENABLED)],
+        ['writer.workflow-runtime-cloud-mcp', accepted
+                && enabled(env.TASKFORCE_SYNC_V3_WORKFLOW_RUNTIME_MCP_ACTIVATION_ENABLED)],
+    ];
+}
+export function areWorkspaceSyncV3CombinedCloudWritersReady(env) {
+    return combinedCloudWriterChecks(env).every(([, ready]) => ready);
+}

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

@@ -0,0 +1,61 @@
+import type { DatabaseAdapter } from '../../storage/databaseAdapter.js';
+import { serializeInitiativeForSync } from '../planningSyncPayload.js';
+import type { WorkspaceSyncEntityEventSnapshot, WorkspaceSyncPlanningComment } from '../workspaceSyncModel.js';
+import { type DurableInitiativeCreatePayload } from './initiativeMutationPayload.js';
+import { type DurableInitiativeServiceCore } from './initiativeMutationService.js';
+import { type LocalInitiativeOutboxCore } from './localInitiativeOutboxService.js';
+import { type DurablePlanningSurface } from './planningActivation.js';
+import type { WorkspaceSyncV3InitiativeMetadataPatch } from './workspaceSyncV3OperationProtocol.js';
+export type DurableInitiativeMutationRouterCore = DurableInitiativeServiceCore & LocalInitiativeOutboxCore & {
+    getDatabaseAdapter(): DatabaseAdapter;
+};
+type LocalResult = {
+    state: 'pending';
+    route: 'local-outbox';
+    operationId: string;
+    provisionalInitiative?: ReturnType<typeof serializeInitiativeForSync>;
+    provisionalActivity?: WorkspaceSyncEntityEventSnapshot;
+};
+type CloudResult = {
+    state: 'committed';
+    route: 'cloud-acceptance';
+    operationId: string;
+    authoritativeInitiative: ReturnType<typeof serializeInitiativeForSync>;
+    authoritativeActivity: WorkspaceSyncEntityEventSnapshot;
+};
+export type DurableInitiativeMutationRouterResult = LocalResult | CloudResult;
+export declare class DurableInitiativeMutationRouterDisabledError extends Error {
+    readonly code = "WORKSPACE_SYNC_V3_INITIATIVE_ACTIVATION_DISABLED";
+    constructor();
+}
+export declare class DurableInitiativeMutationRouterInProgressError extends Error {
+    readonly retryAt: string;
+    readonly code = "WORKSPACE_SYNC_OPERATION_IN_PROGRESS";
+    readonly statusCode = 409;
+    constructor(retryAt: string);
+}
+export declare function createDurableInitiativeMutationRouter(input: {
+    core: DurableInitiativeMutationRouterCore;
+    runtimeMode: 'local' | 'cloud';
+    surface: DurablePlanningSurface;
+    tenantId: string;
+    workspaceId: string;
+    actorRef: string;
+    env?: NodeJS.ProcessEnv;
+    cloudClientId?: string;
+    createOperationId?: () => string;
+    createCommentId?: () => string;
+    now?: () => Date;
+    onPostCommitError?: (error: unknown) => void;
+    deferPostCommitNotification?: (notify: () => void) => void;
+}): {
+    enabled: boolean;
+    create(initiativeId: string, payload: DurableInitiativeCreatePayload): DurableInitiativeMutationRouterResult;
+    updateMetadata(initiativeId: string, patch: WorkspaceSyncV3InitiativeMetadataPatch): DurableInitiativeMutationRouterResult;
+    appendComment(initiativeId: string, comment: Omit<WorkspaceSyncPlanningComment, "id"> & {
+        id?: string;
+    }): DurableInitiativeMutationRouterResult;
+    archive(initiativeId: string): DurableInitiativeMutationRouterResult;
+    unarchive(initiativeId: string): DurableInitiativeMutationRouterResult;
+};
+export {};