wolfpack-mcp 1.0.8 → 1.0.10

package/dist/client.js

@@ -90,6 +90,22 @@ export class WolfpackClient {
             params.append('status', options.status);
         if (options?.assignedToId)
             params.append('assignedToId', options.assignedToId);
+        if (options?.search)
+            params.append('search', options.search);
+        if (options?.categoryId)
+            params.append('categoryId', options.categoryId);
+        if (options?.priority)
+            params.append('priority', options.priority);
+        if (options?.radarItemId)
+            params.append('radarItemId', options.radarItemId);
+        if (options?.createdById)
+            params.append('createdById', options.createdById);
+        if (options?.updatedById)
+            params.append('updatedById', options.updatedById);
+        if (options?.sortBy)
+            params.append('sortBy', options.sortBy);
+        if (options?.sortOrder)
+            params.append('sortOrder', options.sortOrder);
         // If explicit limit/offset provided, use single request (for manual pagination)
         if (options?.limit !== undefined || options?.offset !== undefined) {
             if (options?.limit)

package/dist/index.js

@@ -49,13 +49,34 @@ async function checkForUpdates() {
     }
 }
 // Work Item schemas
+// Use z.coerce.string() to handle any type coercion issues from MCP args
 const ListWorkItemsSchema = z.object({
     team_id: z.number().optional().describe('Team ID to filter work items'),
-    status: z.string().optional().describe('Filter by status'),
-    assigned_to_id: z
+    status: z.coerce
+        .string()
+        .optional()
+        .describe('Filter by status. Board columns: "new", "doing", "review", "blocked", "completed". Use "pending" or "backlog" for backlog items. Use "all" to include completed/closed. Default excludes completed/closed.'),
+    assigned_to_id: z.coerce
+        .string()
+        .optional()
+        .describe('Filter by assignee: "all" (default), "me" (your items), "unassigned", or a specific user ID'),
+    search: z.coerce.string().optional().describe('Text search in title and description'),
+    category_id: z.coerce
+        .string()
+        .optional()
+        .describe('Filter by category ID, or "none" for uncategorized items'),
+    priority: z.coerce
+        .string()
+        .optional()
+        .describe('Filter by priority level (0-4, higher is more important)'),
+    radar_item_id: z.coerce.string().optional().describe('Filter by linked radar/initiative item'),
+    created_by_id: z.coerce.string().optional().describe('Filter by creator user ID'),
+    updated_by_id: z.coerce.string().optional().describe('Filter by last updater user ID'),
+    sort_by: z.coerce
         .string()
         .optional()
-        .describe('Filter by assignee ID (use "unassigned" for unassigned, "me" for self)'),
+        .describe('Sort field: "dateUpdated" (default, newest first), "dateCreated", "priority", "title"'),
+    sort_order: z.coerce.string().optional().describe('Sort direction: "desc" (default), "asc"'),
     limit: z.number().optional().describe('Maximum number of items to return'),
     offset: z.number().optional().describe('Number of items to skip'),
 });
@@ -100,7 +121,7 @@ const ListIssuesSchema = z.object({
     assigned_to_id: z
         .string()
         .optional()
-        .describe('Filter by assignee ID (use "unassigned" for unassigned, "me" for self)'),
+        .describe('Filter by assignee: "me" (default), "unassigned", "all", or a specific user ID'),
     limit: z.number().optional().describe('Maximum number of items to return'),
     offset: z.number().optional().describe('Number of items to skip'),
 });
@@ -112,9 +133,14 @@ const GetIssueSchema = z.object({
 const CreateWorkItemSchema = z.object({
     title: z.string().describe('Title of the work item'),
     description: z.string().optional().describe('Description/notes for the work item (markdown)'),
-    status: z.string().optional().describe('Initial status'),
+    status: z
+        .string()
+        .optional()
+        .describe('Initial status: "pending" (backlog), "new" (to do), "doing", "review", "blocked", "completed". Defaults to "new".'),
     priority: z.number().optional().describe('Priority level (0-4, higher is more important)'),
     leading_user_id: z.string().optional().describe('User ID to assign as leading user'),
+    category_id: z.string().optional().describe('Category ID to organize the work item'),
+    radar_item_id: z.string().optional().describe('Radar/initiative item ID to link to'),
 });
 const CreateIssueSchema = z.object({
     title: z.string().describe('Title of the issue'),
@@ -220,7 +246,12 @@ class WolfpackMCPServer {
                 // Work Item tools
                 {
                     name: 'list_work_items',
-                    description: 'List work items (tasks/tickets). Use when user asks about "my work", "my tasks", "what am I working on", "assigned to me", or "backlog". By default lists items assigned to you. Status mapping: "new" = backlog/todo, "doing" = in progress/active, "review" = pending review, "completed" = done/finished.',
+                    description: 'List work items (tasks/tickets). By default lists ALL items in the team, sorted by most recently updated. ' +
+                        'Use assigned_to_id="me" to filter to only your assigned items. ' +
+                        'TERMINOLOGY: The board has columns: "new" (to do), "doing" (in progress), "review" (pending review), "blocked", "completed" (done). ' +
+                        'The "backlog" or "pending" status represents items not yet on the board. ' +
+                        'By default, completed/closed items are excluded - use status="all" to include them. ' +
+                        'Use when user asks about "the board", "work items", "tasks", "my work" (with assigned_to_id="me"), or "backlog".',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -230,11 +261,37 @@ class WolfpackMCPServer {
                             },
                             status: {
                                 type: 'string',
-                                description: 'Filter: "new" (backlog/todo), "doing" (in progress), "review", "completed" (done), "blocked"',
+                                description: 'Filter by status. Board columns: "new", "doing", "review", "blocked", "completed". ' +
+                                    'Use "pending" or "backlog" for backlog items not on board. ' +
+                                    'Use "all" to include completed/closed items. Default excludes completed/closed.',
                             },
                             assigned_to_id: {
                                 type: 'string',
-                                description: 'Filter by assignee ID (use "unassigned" for unassigned, "me" for self)',
+                                description: 'Filter by assignee: "all" (default, shows all team items), "me" (your assigned items), "unassigned", or a specific user ID',
+                            },
+                            search: {
+                                type: 'string',
+                                description: 'Text search in title and description',
+                            },
+                            category_id: {
+                                type: 'string',
+                                description: 'Filter by category ID, or "none" for uncategorized items',
+                            },
+                            priority: {
+                                type: 'string',
+                                description: 'Filter by priority level (0-4, higher is more important)',
+                            },
+                            radar_item_id: {
+                                type: 'string',
+                                description: 'Filter by linked radar/initiative item ID',
+                            },
+                            sort_by: {
+                                type: 'string',
+                                description: 'Sort field: "dateUpdated" (default, newest activity first), "dateCreated", "priority", "title"',
+                            },
+                            sort_order: {
+                                type: 'string',
+                                description: 'Sort direction: "desc" (default), "asc"',
                             },
                             limit: { type: 'number', description: 'Maximum number of items to return' },
                             offset: { type: 'number', description: 'Number of items to skip' },
@@ -276,7 +333,10 @@ class WolfpackMCPServer {
                 },
                 {
                     name: 'update_work_item_status',
-                    description: 'Change work item status. WORKFLOW: Move to "doing" when you start work, or "review" when ready for review. Can also set to "completed", "blocked", etc.',
+                    description: 'Change work item status. ' +
+                        'Board columns: "new" (to do), "doing" (in progress), "review" (pending review), "blocked", "completed" (done). ' +
+                        '"pending" is for backlog items not yet on the board. ' +
+                        'WORKFLOW: Move to "doing" when starting work, "review" when ready for review, "completed" when done.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -286,7 +346,7 @@ class WolfpackMCPServer {
                             },
                             status: {
                                 type: 'string',
-                                description: 'New status',
+                                description: 'New status: "pending" (backlog), "new" (to do), "doing" (in progress), "review", "blocked", "completed" (done)',
                             },
                         },
                         required: ['work_item_id', 'status'],
@@ -356,7 +416,7 @@ class WolfpackMCPServer {
                             },
                             assigned_to_id: {
                                 type: 'string',
-                                description: 'Filter by assignee ID (use "unassigned" for unassigned, "me" for self)',
+                                description: 'Filter by assignee: "me" (default), "unassigned", "all", or a specific user ID',
                             },
                             limit: { type: 'number', description: 'Maximum number of items to return' },
                             offset: { type: 'number', description: 'Number of items to skip' },
@@ -395,7 +455,7 @@ class WolfpackMCPServer {
                             },
                             status: {
                                 type: 'string',
-                                description: 'Initial status (e.g., new, doing, review, completed - defaults to new)',
+                                description: 'Initial status: "pending" (backlog), "new" (to do), "doing", "review", "blocked", "completed". Defaults to "new".',
                             },
                             priority: {
                                 type: 'number',
@@ -405,6 +465,14 @@ class WolfpackMCPServer {
                                 type: 'string',
                                 description: 'User ID to assign as leading user',
                             },
+                            category_id: {
+                                type: 'string',
+                                description: 'Category ID to organize the work item',
+                            },
+                            radar_item_id: {
+                                type: 'string',
+                                description: 'Radar/initiative item ID to link to',
+                            },
                         },
                         required: ['title'],
                     },
@@ -628,12 +696,20 @@ class WolfpackMCPServer {
                             teamId: parsed.team_id || this.client.getTeamId() || undefined,
                             status: parsed.status,
                             assignedToId: parsed.assigned_to_id,
+                            search: parsed.search,
+                            categoryId: parsed.category_id,
+                            priority: parsed.priority,
+                            radarItemId: parsed.radar_item_id,
+                            createdById: parsed.created_by_id,
+                            updatedById: parsed.updated_by_id,
+                            sortBy: parsed.sort_by,
+                            sortOrder: parsed.sort_order,
                             limit: parsed.limit,
                             offset: parsed.offset,
                         });
                         let text = JSON.stringify(result.items, null, 2);
                         if (result.truncated) {
-                            text = `Note: Results truncated. Showing ${result.items.length} of ${result.total} items. Use status filter or limit/offset for pagination.\n\n${text}`;
+                            text = `Note: Results truncated. Showing ${result.items.length} of ${result.total} items. Use filters or limit/offset for pagination.\n\n${text}`;
                         }
                         return {
                             content: [{ type: 'text', text }],
@@ -755,6 +831,8 @@ class WolfpackMCPServer {
                             status: parsed.status,
                             priority: parsed.priority,
                             leadingUserId: parsed.leading_user_id,
+                            categoryId: parsed.category_id,
+                            radarItemId: parsed.radar_item_id,
                         });
                         return {
                             content: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wolfpack-mcp",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "MCP server for Wolfpack AI-enhanced software delivery tools",
   "main": "dist/index.js",
   "type": "module",