@taskforcehq/taskforce 0.3.328 → 0.3.330

package/dist/mcp/taskPlanningRegistrar.js

@@ -11,8 +11,16 @@ function nullableStringProperty(description) {
         ],
     };
 }
-function numberProperty(description) {
-    return { type: 'number', description };
+function integerProperty(description, minimum, maximum) {
+    return {
+        type: 'integer',
+        description,
+        ...(minimum === undefined ? {} : { minimum }),
+        ...(maximum === undefined ? {} : { maximum }),
+    };
+}
+function integerEnumProperty(description, values) {
+    return { type: 'integer', description, enum: values };
 }
 function booleanProperty(description) {
     return { type: 'boolean', description };
@@ -57,7 +65,7 @@ export function registerTaskPlanningTools(registerTool, executeTool) {
                         title: stringProperty('Initiative title.'),
                         description: stringProperty('Optional initiative description.'),
                         ownerId: stringProperty(`${context.assigneeHint} Call list_assignees to inspect eligible IDs.`),
-                        order: numberProperty('Optional initiative order.'),
+                        order: integerProperty('Optional non-negative initiative order.', 0),
                     },
                     required: ['title'],
                 },
@@ -71,7 +79,7 @@ export function registerTaskPlanningTools(registerTool, executeTool) {
                             title: stringProperty('Workstream title.'),
                             description: stringProperty('Optional workstream description.'),
                             ownerId: stringProperty(`${context.assigneeHint} Call list_assignees to inspect eligible IDs.`),
-                            order: numberProperty('Optional workstream order.'),
+                            order: integerProperty('Optional non-negative workstream order.', 0),
                             tasks: {
                                 type: 'array', maxItems: 50,
                                 items: {
@@ -83,8 +91,8 @@ export function registerTaskPlanningTools(registerTool, executeTool) {
                                         assignee: stringProperty(`${context.assigneeHint} Call list_assignees to inspect eligible IDs.`),
                                         category: stringProperty('Task category.', context.categoryEnum),
                                         type: stringProperty('Task type.', context.typeEnum),
-                                        priority: numberProperty(context.priorityDesc),
-                                        complexity: numberProperty(context.complexityDesc),
+                                        priority: integerEnumProperty(context.priorityDesc, context.priorityEnum),
+                                        complexity: integerProperty(context.complexityDesc, 1, 5),
                                         scheduledDate: stringProperty('Optional schedule date (YYYY-MM-DD).'),
                                         dueDate: stringProperty('Optional due date (YYYY-MM-DD).'),
                                     },
@@ -120,22 +128,24 @@ export function registerTaskPlanningTools(registerTool, executeTool) {
                 status: stringProperty('Filter by status.', ['task', 'on-hold', 'in-progress', 'review', 'done', 'cancelled']),
                 openOnly: booleanProperty('When true, only include open tasks (task, on-hold, in-progress, review).'),
                 assignee: stringProperty(context.assigneeHint),
-                priority: numberProperty('Filter by priority level.'),
+                priority: integerEnumProperty(context.priorityDesc, context.priorityEnum),
                 type: stringProperty('Filter by task type.', context.typeEnum),
                 workstreamId: stringProperty('Filter by workstream ID or workstream reference such as WS-123.'),
                 sort: stringProperty('Sort field (default: created).', ['priority', 'created', 'updated']),
                 order: stringProperty('Sort order (default: desc).', ['asc', 'desc']),
-                limit: numberProperty('Max tasks to return.'),
-                offset: numberProperty('Non-negative result offset for pagination (default: 0).'),
+                limit: integerProperty('Max tasks to return (max 200).', 1, 200),
+                offset: integerProperty('Non-negative result offset for pagination (default: 0).', 0),
             },
         },
     }));
     register('search_tasks', (context) => ({
-        description: context.describeTool('Search active and archived tasks by keyword, ID, T-* reference, or provisional LT-* reference. Use scope to narrow results. Prefer this over list_tasks when looking for a specific task by name. When results include links, preserve those links when presenting tasks.'),
+        description: context.describeTool('Search active and archived tasks by keyword, ID, T-* reference, or provisional LT-* reference. Use scope to narrow results and offset/limit to continue broad searches. Prefer this over list_tasks when looking for a specific task by name. When results include links, preserve those links when presenting tasks.'),
         inputSchema: {
             properties: {
                 query: stringProperty('Search term or exact task reference such as T-123 or LT-123.'),
                 scope: stringProperty('Search scope (default: all).', ['all', 'active', 'archive']),
+                limit: integerProperty('Page size (default 25; max 50).', 1, 50),
+                offset: integerProperty('Non-negative result offset (default 0).', 0),
             },
             required: ['query'],
         },
@@ -179,10 +189,12 @@ export function registerTaskPlanningTools(registerTool, executeTool) {
         },
     }));
     register('list_initiatives', (context) => ({
-        description: context.describeTool('List or search initiatives for the active workspace. Pass query to search by initiative title, description, ID/reference, owner, or linked workstream title. Returns compact initiative summaries with workstream and task counts.'),
+        description: context.describeTool('List or search initiatives for the active workspace. Pass query to search by initiative title, description, ID/reference, owner, or linked workstream title. Use offset/limit to continue through compact summaries.'),
         inputSchema: {
             properties: {
                 query: stringProperty('Optional search term for initiative title, description, ID/reference such as IN-123, owner, or linked workstream title.'),
+                limit: { type: 'integer', minimum: 1, maximum: 100, description: 'Page size (default 25; max 100).' },
+                offset: { type: 'integer', minimum: 0, description: 'Non-negative result offset (default 0).' },
             },
         },
     }));
@@ -205,7 +217,7 @@ export function registerTaskPlanningTools(registerTool, executeTool) {
                 title: stringProperty('Initiative title.'),
                 description: stringProperty('Optional initiative description.'),
                 ownerId: stringProperty(context.assigneeHint),
-                order: numberProperty('Optional sort order among initiatives.'),
+                order: integerProperty('Optional non-negative sort order among initiatives.', 0),
                 attachments: arrayProperty('Optional attachment descriptors to store on the initiative. Prefer save_initiative_attachment for generated content or files.', {
                     type: 'object',
                     properties: {
@@ -231,7 +243,7 @@ export function registerTaskPlanningTools(registerTool, executeTool) {
                 title: stringProperty('Updated initiative title.'),
                 description: stringProperty('Updated initiative description.'),
                 ownerId: stringProperty(context.assigneeHint),
-                order: numberProperty('Optional sort order among initiatives.'),
+                order: integerProperty('Optional non-negative sort order among initiatives.', 0),
                 attachments: arrayProperty('Replacement attachment descriptors for the initiative. Prefer save_initiative_attachment for generated content or files. Removing managed attachments requires delete_initiative_attachment in the extended profile.', {
                     type: 'object',
                     properties: {
@@ -278,10 +290,12 @@ export function registerTaskPlanningTools(registerTool, executeTool) {
         },
     }));
     register('list_workstreams', (context) => ({
-        description: context.describeTool('List or search workstreams for the active workspace. Pass query to search by workstream title, description, ID/reference, owner, or linked initiative title/reference. Returns compact workstream summaries with task counts.'),
+        description: context.describeTool('List or search workstreams for the active workspace. Pass query to search by workstream title, description, ID/reference, owner, or linked initiative title/reference. Use offset/limit to continue through compact summaries.'),
         inputSchema: {
             properties: {
                 query: stringProperty('Optional search term for workstream title, description, ID/reference such as WS-123, owner, or linked initiative title/reference.'),
+                limit: { type: 'integer', minimum: 1, maximum: 100, description: 'Page size (default 25; max 100).' },
+                offset: { type: 'integer', minimum: 0, description: 'Non-negative result offset (default 0).' },
             },
         },
     }));
@@ -305,7 +319,7 @@ export function registerTaskPlanningTools(registerTool, executeTool) {
                 description: stringProperty('Optional workstream description.'),
                 ownerId: stringProperty(context.assigneeHint),
                 initiativeId: stringProperty('Optional initiative ID or initiative reference such as IN-123.'),
-                order: numberProperty('Optional sort order among workstreams.'),
+                order: integerProperty('Optional non-negative sort order among workstreams.', 0),
                 attachments: arrayProperty('Optional attachment descriptors to store on the workstream. Prefer save_workstream_attachment for generated content or files.', {
                     type: 'object',
                     properties: {
@@ -332,7 +346,7 @@ export function registerTaskPlanningTools(registerTool, executeTool) {
                 description: stringProperty('Updated workstream description.'),
                 ownerId: stringProperty(context.assigneeHint),
                 initiativeId: stringProperty('Optional initiative ID or initiative reference such as IN-123. Pass an empty string to unlink.'),
-                order: numberProperty('Optional sort order among workstreams.'),
+                order: integerProperty('Optional non-negative sort order among workstreams.', 0),
                 attachments: arrayProperty('Replacement attachment descriptors for the workstream. Prefer save_workstream_attachment for generated content or files. Removing managed attachments requires delete_workstream_attachment in the extended profile.', {
                     type: 'object',
                     properties: {
@@ -384,9 +398,9 @@ export function registerTaskPlanningTools(registerTool, executeTool) {
         inputSchema: {
             properties: {
                 taskId: stringProperty('Task ID or task reference such as T-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: ['taskId', 'workstreamId'],
         },
     }));
     register('update_workstream_initiative', (context) => ({
@@ -394,13 +408,13 @@ export function registerTaskPlanningTools(registerTool, executeTool) {
         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', 'initiativeId'],
         },
     }));
     register('get_task_checklist', (context) => ({
-        description: context.describeTool('Read the structured checklist items for one task. Returns stored checklist items, not markdown parsing.'),
+        description: context.describeTool('Read the structured checklist items for one task. Returns stored checklist items plus detailRevision for optimistic concurrency; it does not parse markdown.'),
         inputSchema: {
             properties: {
                 taskId: stringProperty('Task ID or task reference such as T-123.'),
@@ -419,6 +433,24 @@ export function registerTaskPlanningTools(registerTool, executeTool) {
             required: ['taskId', 'text'],
         },
     }));
+    register('update_task_checklist_item', (context) => ({
+        description: context.describeTool('Update one existing checklist item without replacing the full checklist. Read get_task_checklist first and pass expectedDetailRevision to reject concurrent changes. Pass idempotencyKey only when retrying an ambiguous outcome; reuse it only with the exact same task, item, patch, and revision.'),
+        inputSchema: {
+            properties: {
+                taskId: stringProperty('Task ID or task reference such as T-123.'),
+                itemId: stringProperty('Stable checklist item ID returned by get_task_checklist.'),
+                text: stringProperty('Optional replacement checklist text. Must be descriptive and non-empty.'),
+                done: booleanProperty('Optional completion state.'),
+                order: integerProperty('Optional non-negative display order. Sibling items are not renumbered.', 0),
+                expectedDetailRevision: stringProperty('Optional task detailRevision from get_task_checklist. A stale value rejects the update without mutation.'),
+                idempotencyKey: {
+                    type: 'string', minLength: 1, maxLength: 128,
+                    description: 'Optional opaque retry key scoped to the active workspace, actor, and tool.',
+                },
+            },
+            required: ['taskId', 'itemId'],
+        },
+    }));
     register('replace_task_checklist', (context) => ({
         description: context.describeTool('Replace the structured checklist items for one task with a new ordered list. Use this when a user explicitly asks to create, update, or replace a task checklist; do not just draft checklist text.'),
         inputSchema: {
@@ -430,7 +462,7 @@ export function registerTaskPlanningTools(registerTool, executeTool) {
                         id: { type: 'string', description: 'Stable checklist item ID. Reuse it when reordering or updating an existing item.' },
                         text: { type: 'string' },
                         done: { type: 'boolean' },
-                        order: { type: 'number', description: 'Optional zero-based display order.' },
+                        order: { type: 'integer', minimum: 0, description: 'Optional zero-based display order.' },
                         createdAt: { type: 'string', description: 'Optional canonical ISO creation timestamp.' },
                         updatedAt: { type: 'string', description: 'Optional canonical ISO last-change timestamp.' },
                     },
@@ -454,28 +486,17 @@ export function registerTaskPlanningTools(registerTool, executeTool) {
         inputSchema: {
             properties: {
                 taskId: stringProperty('Task ID or task reference such as T-123.'),
-                id: stringProperty('Alias for taskId.'),
                 date: nullableStringProperty('YYYY-MM-DD; null or empty with taskId unschedules.'),
-                scheduledDate: nullableStringProperty('Alias for date.'),
-                order: numberProperty('Optional position within that day.'),
-                orderInDay: numberProperty('Alias for order.'),
+                order: integerProperty('Optional non-negative position within that day.', 0),
                 taskIds: arrayProperty('Ordered task IDs or references replacing one day.', { type: 'string' }),
-                moves: arrayProperty('Advanced reorder moves using task, date, and order aliases.', {
+                moves: arrayProperty('Advanced reorder moves using canonical taskId, date, and order fields.', {
                     type: 'object',
                     properties: {
-                        id: { type: 'string' },
                         taskId: { type: 'string' },
                         date: { type: 'string' },
-                        scheduledDate: { type: 'string' },
-                        order: { type: 'number' },
-                        orderInDay: { type: 'number' },
+                        order: { type: 'integer', minimum: 0 },
                     },
-                    anyOf: [
-                        { required: ['id', 'date'] },
-                        { required: ['id', 'scheduledDate'] },
-                        { required: ['taskId', 'date'] },
-                        { required: ['taskId', 'scheduledDate'] },
-                    ],
+                    required: ['taskId', 'date'],
                 }),
             },
         },
@@ -535,9 +556,9 @@ export function registerTaskPlanningTools(registerTool, executeTool) {
                 workstreamId: stringProperty('Workstream ID or WS-123; use to create the task directly inside a workstream. Search list_workstreams if needed.'),
                 category: stringProperty('Task category value.', context.categoryEnum),
                 type: stringProperty('Task type value.', context.typeEnum),
-                priority: numberProperty(context.priorityDesc),
+                priority: integerEnumProperty(context.priorityDesc, context.priorityEnum),
                 status: stringProperty('Initial task status.', ['task', 'on-hold', 'in-progress', 'review', 'done', 'cancelled']),
-                complexity: numberProperty(context.complexityDesc),
+                complexity: integerProperty(context.complexityDesc, 1, 5),
                 scheduledDate: stringProperty('Optional scheduled date in YYYY-MM-DD format.'),
                 dueDate: stringProperty('Optional due date in YYYY-MM-DD format.'),
             },
@@ -564,7 +585,7 @@ export function registerTaskPlanningTools(registerTool, executeTool) {
         },
     }));
     register('update_task', (context) => ({
-        description: context.describeTool('Update an existing task. Current taxonomy values are included in this tool schema; call get_config only for richer metadata or after a validation mismatch. Use start_task when beginning active work on a tracked task, and prefer finish_task for the final completion or review handoff.'),
+        description: context.describeTool('Update task fields. Use start_task to begin tracked work. Review transitions are rejected; use finish_task so its required handoff comment, status, and reviewer commit atomically.'),
         inputSchema: {
             properties: {
                 id: stringProperty('Task ID or task reference such as T-123.'),
@@ -574,9 +595,9 @@ export function registerTaskPlanningTools(registerTool, executeTool) {
                 workstreamId: stringProperty('Updated workstream ID or workstream reference such as WS-123. Pass an empty string to unlink the task. Call list_workstreams with query first if you only know the workstream name.'),
                 category: stringProperty('Updated category value.', context.categoryEnum),
                 type: stringProperty('Updated task type value.', context.typeEnum),
-                priority: numberProperty(context.priorityDesc),
+                priority: integerEnumProperty(context.priorityDesc, context.priorityEnum),
                 status: stringProperty('Updated task status.', ['task', 'on-hold', 'in-progress', 'review', 'done', 'cancelled']),
-                complexity: numberProperty(context.complexityDesc),
+                complexity: integerProperty(context.complexityDesc, 1, 5),
                 scheduledDate: stringProperty('Updated scheduled date in YYYY-MM-DD format. Pass an empty string to clear.'),
                 dueDate: stringProperty('Updated due date in YYYY-MM-DD format. Pass an empty string to clear.'),
             },
@@ -584,12 +605,13 @@ export function registerTaskPlanningTools(registerTool, executeTool) {
         },
     }));
     register('finish_task', (context) => ({
-        description: context.describeTool('Default end-of-task handoff. Use outcome=\'done\' for completed work or outcome=\'review\' for validation. Both remain active and unarchived; use archive_task for history. Archived tasks require reopen_task first.'),
+        description: context.describeTool('Finish active work as done or review without archiving. Review atomically commits its required handoff comment and reviewer. Pass a human or AI reviewer ID unless an eligible human is already assigned. No Git or PR required.'),
         inputSchema: {
             properties: {
                 id: stringProperty('Task ID or task reference such as T-123.'),
                 outcome: stringProperty('Completion outcome.', ['review', 'done']),
-                comment: stringProperty('Optional completion note returned in the handoff response.'),
+                comment: stringProperty('Required for review and persisted atomically with the transition; optional for done.'),
+                reviewer: stringProperty('Reviewer assignee ID. Required for review unless an eligible human is already assigned.'),
             },
             required: ['id', 'outcome'],
         },

package/dist/mcp/toolCallCompatibility.js

@@ -10,7 +10,44 @@ export function resolveCanonicalMcpToolName(nameRaw) {
 export function resolveMcpToolCallCompatibility(nameRaw, argsRaw) {
     const name = resolveCanonicalMcpToolName(nameRaw);
     const args = argsRaw && typeof argsRaw === 'object' && !Array.isArray(argsRaw)
-        ? argsRaw
+        ? { ...argsRaw }
         : {};
+    const moveAlias = (alias, canonical) => {
+        if (args[canonical] === undefined && args[alias] !== undefined)
+            args[canonical] = args[alias];
+        delete args[alias];
+    };
+    if (name === 'get_image')
+        moveAlias('id', 'imageId');
+    if (name === 'get_image_annotations')
+        moveAlias('imageAssetId', 'imageId');
+    if (name === 'get_task_attachments')
+        moveAlias('id', 'taskId');
+    if (name === 'update_task_workstream')
+        moveAlias('id', 'taskId');
+    if (name === 'update_workstream_initiative')
+        moveAlias('id', 'workstreamId');
+    if (name === 'update_schedule') {
+        moveAlias('id', 'taskId');
+        moveAlias('scheduledDate', 'date');
+        moveAlias('orderInDay', 'order');
+        if (Array.isArray(args.moves)) {
+            args.moves = args.moves.map((move) => {
+                if (!move || typeof move !== 'object' || Array.isArray(move))
+                    return move;
+                const normalized = { ...move };
+                const normalizeMoveAlias = (alias, canonical) => {
+                    if (normalized[canonical] === undefined && normalized[alias] !== undefined) {
+                        normalized[canonical] = normalized[alias];
+                    }
+                    delete normalized[alias];
+                };
+                normalizeMoveAlias('id', 'taskId');
+                normalizeMoveAlias('scheduledDate', 'date');
+                normalizeMoveAlias('orderInDay', 'order');
+                return normalized;
+            });
+        }
+    }
     return { name, arguments: args };
 }

package/dist/mcp/toolCatalog.d.ts

@@ -22,6 +22,7 @@ export type McpToolDescriptorContext = {
     describeTool: (text: string) => string;
     assigneeHint: string;
     categoryEnum: string[];
+    priorityEnum: number[];
     priorityDesc: string;
     typeEnum: string[];
     complexityDesc: string;

package/dist/mcp/toolProfiles.d.ts

@@ -5,11 +5,13 @@ type McpScopedPermission = Extract<McpPermission, {
     kind: 'scope';
 }>;
 type McpScope = McpScopedPermission['scope'];
+export type CloudMcpToolProfile = Extract<McpToolProfile, 'default' | 'extended'>;
 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 getCloudMcpToolProfileMembership(profile: CloudMcpToolProfile, scopes?: readonly McpScope[]): McpToolName[];
 export declare function getManagedAgentMcpRuntimeProfile(_profile?: ManagedAgentMcpToolProfile): McpToolProfile;
 export declare function getManagedAgentMcpToolProfileMembership(profile?: ManagedAgentMcpToolProfile): McpToolName[];
 export declare function getManagedAgentMcpToolScopes(profile?: ManagedAgentMcpToolProfile): McpScope[];

package/dist/mcp/toolProfiles.js

@@ -14,6 +14,7 @@ const MANAGED_AGENT_ALLOWED_MUTATING_TOOLS = new Set([
     'add_comment',
     'add_initiative_comment',
     'add_task_checklist_item',
+    'update_task_checklist_item',
     'add_workstream_comment',
     'complete_workflow_step',
     'replace_task_checklist',
@@ -45,6 +46,15 @@ export function getMcpToolProfileMembership(profile) {
         .map(([name]) => name)
         .sort((left, right) => left.localeCompare(right));
 }
+export function getCloudMcpToolProfileMembership(profile, scopes) {
+    const allowedScopes = scopes ? new Set(scopes) : null;
+    return getMcpToolProfileMembership(profile).filter((name) => {
+        const permission = MCP_TOOL_REGISTRY[name].permission;
+        if (permission.kind === 'local-only' || permission.kind === 'session-only')
+            return false;
+        return permission.kind === 'public' || !allowedScopes || allowedScopes.has(permission.scope);
+    });
+}
 export function getManagedAgentMcpRuntimeProfile(_profile = MCP_MANAGED_AGENT_DEFAULT_PROFILE) {
     return 'default';
 }

package/dist/mcp/toolRegistry.d.ts

@@ -51,6 +51,7 @@ export declare const MCP_TOOL_REGISTRY: Readonly<{
     readonly update_workstream_initiative: McpToolRegistryEntry;
     readonly get_task_checklist: McpToolRegistryEntry;
     readonly add_task_checklist_item: McpToolRegistryEntry;
+    readonly update_task_checklist_item: McpToolRegistryEntry;
     readonly replace_task_checklist: McpToolRegistryEntry;
     readonly get_task_attachments: McpToolRegistryEntry;
     readonly get_workstream_attachments: McpToolRegistryEntry;

package/dist/mcp/toolRegistry.js

@@ -49,6 +49,7 @@ export const MCP_TOOL_REGISTRY = Object.freeze({
     update_workstream_initiative: defaultTool({ kind: 'scope', scope: 'tasks:write' }, true),
     get_task_checklist: defaultTool({ kind: 'scope', scope: 'tasks:read' }, false),
     add_task_checklist_item: defaultTool({ kind: 'scope', scope: 'tasks:write' }, true),
+    update_task_checklist_item: defaultTool({ kind: 'scope', scope: 'tasks:write' }, true),
     replace_task_checklist: defaultTool({ kind: 'scope', scope: 'tasks:write' }, true),
     get_task_attachments: defaultTool({ kind: 'scope', scope: 'tasks:read' }, false),
     get_workstream_attachments: extendedTool({ kind: 'scope', scope: 'tasks:read' }, false),

package/dist/mcp/workflowExecutionRegistrar.js

@@ -32,16 +32,16 @@ export function registerWorkflowExecutionTools(registerTool, executeTool) {
         },
     }));
     register('complete_workflow_step', (context) => ({
-        description: context.describeTool('Complete the current workflow step when the active AI profile owns it. If the step requires a task comment, add the comment first and pass its returned commentId as evidence. Advances and reassigns the task automatically.'),
+        description: context.describeTool('Complete the current workflow step when the active AI profile owns it. Call get_task_workflow first for the same task and reuse its completionCall arguments exactly; never invent or reuse workflow IDs. If the step requires a task comment, add the comment first and pass its returned commentId as evidence. Advances and reassigns the task automatically.'),
         annotations: { idempotentHint: true },
         inputSchema: {
             additionalProperties: false,
             properties: {
                 taskId: { type: 'string', description: 'Task UUID or reference label such as T-123.' },
-                executionId: { type: 'string', description: 'Workflow execution ID returned by get_task_workflow.' },
-                stepId: { type: 'string', description: 'Current workflow step ID returned by get_task_workflow.' },
+                executionId: { type: 'string', description: 'Exact executionId from the same-task get_task_workflow completionCall; never invent or reuse it.' },
+                stepId: { type: 'string', description: 'Exact stepId from the same-task get_task_workflow completionCall; never invent or reuse it.' },
                 evidenceCommentId: {
-                    type: 'string',
+                    anyOf: [{ type: 'string' }, { type: 'null' }],
                     description: 'Exact commentId returned by add_comment when the current step requires task-comment evidence.',
                 },
             },

package/dist/migrations/taskSchemaMigrations.d.ts

@@ -44,6 +44,11 @@ export declare function ensureLocalSyncCoordinatorSchema(db: DatabaseAdapter): v
 export declare function ensureWorkspaceDocumentsSchema(db: DatabaseAdapter): void;
 export declare function ensureAnnotatedAttachmentSessionsSchema(db: DatabaseAdapter): void;
 export declare function ensureTaskforceAgentsSchema(db: DatabaseAdapter): void;
+export declare function ensureModelProviderConnectionsSchema(db: DatabaseAdapter): void;
+export declare function ensureTaskforceAgentConnectionBindingsSchema(db: DatabaseAdapter): void;
+export declare function ensureGitHubReviewEvidenceInstallationBindingsSchema(db: DatabaseAdapter): void;
+export declare function ensureExecutorPhaseAApprovalReceiptsSchema(db: DatabaseAdapter): void;
+export declare function ensureExecutorPhaseARunAuthorizationsSchema(db: DatabaseAdapter): void;
 export declare function ensureAgentRolesSchema(db: DatabaseAdapter): void;
 export declare function ensureTaskforceAgentSkillsSchema(db: DatabaseAdapter): void;
 export declare function ensureWorkflowSchema(db: DatabaseAdapter): void;