wolfpack-mcp 1.0.72 → 1.0.74

package/dist/client.js

@@ -97,6 +97,7 @@ export class WolfpackClient {
                 items: firstPage.items,
                 total: firstPage.total,
                 truncated: true,
+                notice: firstPage.notice,
             };
         }
         // If all items fit in first page, return them
@@ -105,6 +106,7 @@ export class WolfpackClient {
                 items: firstPage.items,
                 total: firstPage.total,
                 truncated: false,
+                notice: firstPage.notice,
             };
         }
         // Fetch remaining pages
@@ -123,6 +125,7 @@ export class WolfpackClient {
             items: allItems,
             total: firstPage.total,
             truncated: false,
+            notice: firstPage.notice,
         };
     }
     // Work Item methods
@@ -172,6 +175,7 @@ export class WolfpackClient {
                 items: response.items,
                 total: response.total,
                 truncated: response.total > response.items.length,
+                notice: response.notice,
             };
         }
         // Otherwise, fetch all pages automatically

package/dist/index.js

@@ -100,7 +100,7 @@ const ListWorkItemsSchema = z.object({
     approved: z.coerce
         .string()
         .optional()
-        .describe('Filter by approval: "true" for approved items, "false" for not-yet-approved. Backlog items must be approved before agents may pull them.'),
+        .describe('Filter by approval: "true" for approved items, "false" for not-yet-approved. Unassigned backlog items must be approved before agents may pull them; items assigned to you can be pulled regardless.'),
     limit: z.number().optional().describe('Maximum number of items to return'),
     offset: z.number().optional().describe('Number of items to skip'),
 });
@@ -751,6 +751,9 @@ class WolfpackMCPServer {
                         description: 'List work items (tasks/tickets) on the Kanban board or backlog. Work items are the PRIMARY entity — bare #N references (e.g. "work on #1") always mean work items. ' +
                             '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. ' +
+                            'AGENTS: unless granted the mcp:work_items:read_all permission, your results are always ' +
+                            'narrowed to items assigned to you or routed to a work pool you belong to, whatever ' +
+                            'assigned_to_id you pass; the response says so when this applies. ' +
                             'TERMINOLOGY: "board" and "kanban" are synonymous - both refer to the Kanban board of work items. ' +
                             'The board has columns: "new" (to do), "doing" (in progress), "review" (pending review), "ready" (code done, awaiting deployment), "blocked", "completed" (deployed). ' +
                             'The "backlog" or "pending" status represents items not yet on the board. ' +
@@ -811,7 +814,8 @@ class WolfpackMCPServer {
                                 approved: {
                                     type: 'string',
                                     description: 'Filter by approval: "true" for approved items, "false" for not-yet-approved. ' +
-                                        'Backlog ("pending") items must be approved by a human before agents may pull them.',
+                                        'Unassigned backlog ("pending") items must be approved by a human before agents may ' +
+                                        'pull them; items assigned to you can be pulled regardless.',
                                 },
                                 limit: { type: 'number', description: 'Maximum number of items to return' },
                                 offset: { type: 'number', description: 'Number of items to skip' },
@@ -965,8 +969,11 @@ class WolfpackMCPServer {
                         description: 'Pull a specific work item from the backlog to the board. ' +
                             'REQUIRED: Use this when starting work on a "pending" (backlog) item. ' +
                             'This claims the item (assigns to you) and sets status to "new". ' +
-                            'APPROVAL: Agents can only pull backlog items a human has approved (approved=true on the item) — ' +
-                            'unapproved items must stay in the backlog until a human approves them. ' +
+                            'AGENTS: an item already assigned to you is always pullable, approved or not. An item ' +
+                            'that is NOT assigned to you is pullable only if it is routed to a work pool you belong ' +
+                            'to AND a human has approved it (approved=true) — pool membership grants the access, ' +
+                            'approval grants the go-ahead. An unassigned item in no work pool cannot be pulled by an ' +
+                            'agent and will return 403: ask a human to route it to your pool or assign it to you. ' +
                             'After pulling, move to "doing" to indicate active work, then "review" when done. ' +
                             'If no assignee is specified, assigns to the API key owner. ' +
                             'In personal projects, items are always assigned to the owner.',
@@ -2090,6 +2097,9 @@ class WolfpackMCPServer {
                             offset: parsed.offset,
                         });
                         let text = JSON.stringify(stripUuids(result.items), null, 2);
+                        if (result.notice) {
+                            text = `Note: ${result.notice}\n\n${text}`;
+                        }
                         if (result.truncated) {
                             text = `Note: Results truncated. Showing ${result.items.length} of ${result.total} items. Use filters or limit/offset for pagination.\n\n${text}`;
                         }

package/dist/workItemReminders.js

@@ -30,8 +30,9 @@ const STATUS_REMINDERS = {
 export function getWorkItemReminders(status, description, approved) {
     const reminders = [];
     if (status === 'pending' && approved === false) {
-        // Overrides the generic pending reminder: pulling would be refused anyway
-        reminders.push('REMINDER: This backlog item has NOT been approved. Agents may not pull it — ' +
+        // Overrides the generic pending reminder: approval only gates unassigned items
+        reminders.push('REMINDER: This backlog item has NOT been approved. If it is assigned to you, that assignment ' +
+            'overrides approval — pull it with pull_work_item and start work. If it is not assigned to you, ' +
             'leave it in the backlog until a human approves it.');
     }
     else {

package/dist/workItemReminders.test.js

@@ -35,10 +35,10 @@ describe('getWorkItemReminders', () => {
             expect.stringContaining('pull_work_item'),
         ]);
     });
-    it('warns agents off unapproved pending items instead of telling them to pull', () => {
-        expect(getWorkItemReminders('pending', PLAN, false)).toEqual([
-            expect.stringContaining('NOT been approved'),
-        ]);
+    it('explains the assignment override on unapproved pending items', () => {
+        const reminders = getWorkItemReminders('pending', PLAN, false);
+        expect(reminders).toEqual([expect.stringContaining('NOT been approved')]);
+        expect(reminders[0]).toContain('assignment overrides approval');
     });
     it('tells agents to move new items to doing', () => {
         expect(getWorkItemReminders('new', PLAN)).toEqual([

package/package.json

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