@taskforcehq/taskforce 0.3.323 → 0.3.326

package/dist/mcp/taskPlanningRegistrar.js

@@ -2,6 +2,15 @@ import { bindDomainTool } from './toolCatalog.js';
 function stringProperty(description, enumValues) {
     return enumValues ? { type: 'string', description, enum: enumValues } : { type: 'string', description };
 }
+function nullableStringProperty(description) {
+    return {
+        description,
+        anyOf: [
+            { type: 'string' },
+            { type: 'null' },
+        ],
+    };
+}
 function numberProperty(description) {
     return { type: 'number', description };
 }
@@ -58,7 +67,7 @@ export function registerTaskPlanningTools(registerTool, executeTool) {
         },
     }));
     register('get_task', (context) => ({
-        description: context.describeTool('Get a single task by ID or task reference. Checks both active and archived tasks. Use this when you have a specific task ID or T-123 reference from a previous list or search result and need full details including comments and attachment metadata. This tool does not return attachment file contents. For task attachments, call get_task_attachments and then read_task_attachment. Do not fetch attachment path URLs directly when MCP attachment-read tools are available. Do not use this for image references like I-123 or document references like D-123.'),
+        description: context.describeTool('Get one task by ID or T-123 reference, including comments, activity, checklist, links, and attachment metadata. Use get_task_attachments for attachment bodies; use D-123/I-123 tools for documents/images.'),
         inputSchema: {
             properties: {
                 id: stringProperty('Task ID or task reference such as T-123.'),
@@ -228,42 +237,24 @@ export function registerTaskPlanningTools(registerTool, executeTool) {
             required: ['id'],
         },
     }));
-    register('set_task_workstream', (context) => ({
-        description: context.describeTool('Assign an existing task to a workstream. Reassigning a task removes it from any previous workstream.'),
+    register('update_task_workstream', (context) => ({
+        description: context.describeTool('Set or clear the workstream for one task. Pass workstreamId to assign or reassign; pass an empty string or null to unlink the task from its current workstream.'),
         inputSchema: {
             properties: {
                 taskId: stringProperty('Task ID or task reference such as T-123.'),
-                workstreamId: stringProperty('Workstream ID or workstream reference such as WS-123.'),
-            },
-            required: ['taskId', 'workstreamId'],
-        },
-    }));
-    register('clear_task_workstream', (context) => ({
-        description: context.describeTool('Remove a task from its current workstream, making it standalone.'),
-        inputSchema: {
-            properties: {
-                taskId: stringProperty('Task ID or task reference such as T-123.'),
-            },
-            required: ['taskId'],
-        },
-    }));
-    register('set_workstream_initiative', (context) => ({
-        description: context.describeTool('Assign an existing workstream to an initiative. Reassigning a workstream removes it from any previous initiative.'),
-        inputSchema: {
-            properties: {
-                workstreamId: stringProperty('Workstream ID or workstream reference such as WS-123.'),
-                initiativeId: stringProperty('Initiative ID or initiative reference such as IN-123.'),
+                id: stringProperty('Alias for taskId. Task ID or task reference such as T-123.'),
+                workstreamId: nullableStringProperty('Workstream ID or workstream reference such as WS-123. Pass an empty string or null to unlink.'),
             },
-            required: ['workstreamId', 'initiativeId'],
         },
     }));
-    register('clear_workstream_initiative', (context) => ({
-        description: context.describeTool('Remove a workstream from its current initiative, making it standalone.'),
+    register('update_workstream_initiative', (context) => ({
+        description: context.describeTool('Set or clear the initiative for one workstream. Pass initiativeId to assign or reassign; pass an empty string or null to unlink the workstream from its current initiative.'),
         inputSchema: {
             properties: {
                 workstreamId: stringProperty('Workstream ID or workstream reference such as WS-123.'),
+                id: stringProperty('Alias for workstreamId. Workstream ID or workstream reference such as WS-123.'),
+                initiativeId: nullableStringProperty('Initiative ID or initiative reference such as IN-123. Pass an empty string or null to unlink.'),
             },
-            required: ['workstreamId'],
         },
     }));
     register('get_task_checklist', (context) => ({
@@ -293,41 +284,42 @@ export function registerTaskPlanningTools(registerTool, executeTool) {
         },
     }));
     register('get_schedule_board', (context) => ({
-        description: context.describeTool('Read the current schedule board for the active workspace. Use this before scheduling or reordering tasks when you need the existing day layout and order.'),
+        description: context.describeTool('Read the current schedule board for the active workspace. Use this before scheduling tasks when you need the existing day layout and order.'),
         inputSchema: { properties: {} },
     }));
-    register('schedule_task', (context) => ({
-        description: context.describeTool('Schedule a task on a specific day. Use get_schedule_board first when you need the current order before inserting the task.'),
+    register('update_schedule', (context) => ({
+        description: context.describeTool('Default schedule write path. Schedule, unschedule, or reorder scheduled tasks. Pass taskId with date to schedule, taskId with date=null or an empty string to unschedule, or pass date plus taskIds to replace one day order. Use get_schedule_board first when you need the current board state.'),
         inputSchema: {
             properties: {
                 taskId: stringProperty('Task ID or task reference such as T-123.'),
-                date: stringProperty('Target date in YYYY-MM-DD format.'),
+                id: stringProperty('Alias for taskId. Task ID or task reference such as T-123.'),
+                date: nullableStringProperty('Target date in YYYY-MM-DD format. Pass an empty string or null with taskId to unschedule.'),
+                scheduledDate: nullableStringProperty('Alias for date. Target date in YYYY-MM-DD format. Pass an empty string or null with taskId to unschedule.'),
                 order: numberProperty('Optional position within that day.'),
+                orderInDay: numberProperty('Alias for order. Optional position within that day.'),
+                taskIds: arrayProperty('Ordered task IDs or task references for replacing one scheduled day order.', { type: 'string' }),
+                moves: arrayProperty('Advanced reorder moves. Each move may include id or taskId, date or scheduledDate, and order or orderInDay.', {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'string' },
+                        taskId: { type: 'string' },
+                        date: { type: 'string' },
+                        scheduledDate: { type: 'string' },
+                        order: { type: 'number' },
+                        orderInDay: { type: 'number' },
+                    },
+                    anyOf: [
+                        { required: ['id', 'date'] },
+                        { required: ['id', 'scheduledDate'] },
+                        { required: ['taskId', 'date'] },
+                        { required: ['taskId', 'scheduledDate'] },
+                    ],
+                }),
             },
-            required: ['taskId', 'date'],
-        },
-    }));
-    register('unschedule_task', (context) => ({
-        description: context.describeTool('Remove a task from the schedule board and return it to the unscheduled pool.'),
-        inputSchema: {
-            properties: {
-                taskId: stringProperty('Task ID or task reference such as T-123.'),
-            },
-            required: ['taskId'],
-        },
-    }));
-    register('reorder_scheduled_tasks', (context) => ({
-        description: context.describeTool('Replace the ordered task list for one scheduled day. Use get_schedule_board first to inspect the current day contents.'),
-        inputSchema: {
-            properties: {
-                date: stringProperty('Target date in YYYY-MM-DD format.'),
-                taskIds: arrayProperty('Ordered task IDs or task references for that day.', { type: 'string' }),
-            },
-            required: ['date', 'taskIds'],
         },
     }));
     register('bulk_carryover', (context) => ({
-        description: context.describeTool('Carry unfinished scheduled tasks forward from one day to another in bulk.'),
+        description: context.describeTool('Extended precision tool for carrying unfinished scheduled tasks forward from one day or week to another in bulk. Use get_schedule_board first to inspect the source period.'),
         inputSchema: {
             properties: {
                 fromDate: stringProperty('Source date in YYYY-MM-DD format.'),
@@ -353,7 +345,7 @@ export function registerTaskPlanningTools(registerTool, executeTool) {
                 title: stringProperty('Task title.'),
                 description: stringProperty('Optional task description.'),
                 assignee: stringProperty(`${context.assigneeHint} Call list_assignees to inspect the current eligible IDs.`),
-                workstreamId: stringProperty('Optional workstream ID or workstream reference such as WS-123. Use this to create the task directly inside a workstream without a separate set_task_workstream call.'),
+                workstreamId: stringProperty('Optional workstream ID or workstream reference such as WS-123. Use this to create the task directly inside a workstream without a separate update_task_workstream call.'),
                 category: stringProperty('Task category value.'),
                 type: stringProperty('Task type value.', context.typeEnum),
                 priority: numberProperty(context.priorityDesc),
@@ -406,26 +398,6 @@ export function registerTaskPlanningTools(registerTool, executeTool) {
             required: ['id'],
         },
     }));
-    register('assign_task', (context) => ({
-        description: context.describeTool('Assign a task to one eligible assignee. For assigning 3 or more tasks at once, use bulk_assign_tasks instead.'),
-        inputSchema: {
-            properties: {
-                id: stringProperty('Task ID or task reference such as T-123.'),
-                assignee: stringProperty(`${context.assigneeHint} Call list_assignees to inspect the current eligible IDs.`),
-            },
-            required: ['id', 'assignee'],
-        },
-    }));
-    register('bulk_assign_tasks', (context) => ({
-        description: context.describeTool('Assign multiple tasks to the same eligible assignee in one request. Preferred over repeated assign_task calls when changing 3 or more tasks at once.'),
-        inputSchema: {
-            properties: {
-                ids: arrayProperty('Task IDs or task references such as T-123.', { type: 'string' }),
-                assignee: stringProperty(`${context.assigneeHint} Call list_assignees to inspect the current eligible IDs.`),
-            },
-            required: ['ids', 'assignee'],
-        },
-    }));
     register('archive_task', (context) => ({
         description: context.describeTool('Move a task to history by archiving it. Use status=\'done\' for completed work or status=\'cancelled\' for abandoned work. active tasks may still use status=done for final lookover without being archived.'),
         inputSchema: {
@@ -437,14 +409,6 @@ export function registerTaskPlanningTools(registerTool, executeTool) {
             required: ['id', 'status'],
         },
     }));
-    register('list_archive', (context) => ({
-        description: context.describeTool('List archived tasks. Use format=json for programmatic use.'),
-        inputSchema: {
-            properties: {
-                format: stringProperty('Toggle output format (default: markdown).', ['markdown', 'json']),
-            },
-        },
-    }));
     register('unarchive_task', (context) => ({
         description: context.describeTool('Restore an archived task to the active task list.'),
         inputSchema: {

package/dist/mcp/toolProfiles.d.ts

@@ -0,0 +1,7 @@
+import { type McpToolName, type McpToolProfile, type McpToolSuccessor } from './toolRegistry.js';
+export declare function normalizeMcpToolProfile(value: unknown, fallback: McpToolProfile): McpToolProfile;
+export declare function getDefaultMcpToolProfile(runtimeMode: 'local' | 'cloud'): McpToolProfile;
+export declare function isMcpToolVisibleInProfile(name: string, profile: McpToolProfile): boolean;
+export declare function getMcpToolRequiredProfiles(name: string): McpToolProfile[];
+export declare function getMcpToolProfileMembership(profile: McpToolProfile): McpToolName[];
+export declare function getMcpToolSuccessor(name: string): McpToolSuccessor | null;

package/dist/mcp/toolProfiles.js

@@ -0,0 +1,36 @@
+import { MCP_TOOL_PROFILES, MCP_TOOL_REGISTRY, } from './toolRegistry.js';
+const PROFILE_RANK = {
+    default: 0,
+    extended: 1,
+    full: 2,
+};
+export function normalizeMcpToolProfile(value, fallback) {
+    const normalized = typeof value === 'string' ? value.trim().toLowerCase() : '';
+    return MCP_TOOL_PROFILES.includes(normalized)
+        ? normalized
+        : fallback;
+}
+export function getDefaultMcpToolProfile(runtimeMode) {
+    return runtimeMode === 'cloud' ? 'default' : 'full';
+}
+export function isMcpToolVisibleInProfile(name, profile) {
+    const entry = MCP_TOOL_REGISTRY[name];
+    if (!entry)
+        return false;
+    return PROFILE_RANK[profile] >= PROFILE_RANK[entry.minProfile];
+}
+export function getMcpToolRequiredProfiles(name) {
+    const entry = MCP_TOOL_REGISTRY[name];
+    if (!entry)
+        return [];
+    return MCP_TOOL_PROFILES.filter((profile) => PROFILE_RANK[profile] >= PROFILE_RANK[entry.minProfile]);
+}
+export function getMcpToolProfileMembership(profile) {
+    return Object.entries(MCP_TOOL_REGISTRY)
+        .filter(([name]) => isMcpToolVisibleInProfile(name, profile))
+        .map(([name]) => name)
+        .sort((left, right) => left.localeCompare(right));
+}
+export function getMcpToolSuccessor(name) {
+    return MCP_TOOL_REGISTRY[name]?.suggestedTool || null;
+}