wolfpack-mcp 1.0.64 → 1.0.66

package/dist/client.js

@@ -154,6 +154,8 @@ export class WolfpackClient {
             params.append('dateFrom', options.dateFrom);
         if (options?.dateTo)
             params.append('dateTo', options.dateTo);
+        if (options?.approved)
+            params.append('approved', options.approved);
         // 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

@@ -97,6 +97,10 @@ const ListWorkItemsSchema = z.object({
         .string()
         .optional()
         .describe('Filter items created on or before this date (ISO format, e.g. "2025-12-31")'),
+    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.'),
     limit: z.number().optional().describe('Maximum number of items to return'),
     offset: z.number().optional().describe('Number of items to skip'),
 });
@@ -708,9 +712,9 @@ class WolfpackMCPServer {
                     // Search tool
                     {
                         name: 'search',
-                        description: 'Ranked full-text search across project content: wiki pages, work items, cases, journal entries and issues. ' +
+                        description: 'Ranked full-text search across project content: wiki pages, work items, cases, journal entries, issues and the Wolfpack user manual. ' +
                             'Title matches outrank body matches; results include a snippet, entity type, and refId/slug for follow-up calls ' +
-                            '(get_work_item, get_issue, get_wiki_page, ...). ' +
+                            '(get_work_item, get_issue, get_wiki_page, ...). Results with entityType "manual" are user manual sections — platform documentation on how Wolfpack features work. ' +
                             'Use this to find existing content before creating new items, or when the user asks to "find" or "look up" something without saying where it lives.',
                         inputSchema: {
                             type: 'object',
@@ -798,6 +802,11 @@ class WolfpackMCPServer {
                                     type: 'string',
                                     description: 'Filter items created on or before this date (ISO format, e.g. "2025-12-31")',
                                 },
+                                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.',
+                                },
                                 limit: { type: 'number', description: 'Maximum number of items to return' },
                                 offset: { type: 'number', description: 'Number of items to skip' },
                             },
@@ -944,6 +953,8 @@ 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. ' +
                             '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.',
@@ -2062,6 +2073,7 @@ class WolfpackMCPServer {
                             sortOrder: parsed.sort_order,
                             dateFrom: parsed.date_from,
                             dateTo: parsed.date_to,
+                            approved: parsed.approved,
                             limit: parsed.limit,
                             offset: parsed.offset,
                         });
@@ -2078,7 +2090,7 @@ class WolfpackMCPServer {
                         const workItem = await this.client.getWorkItem(parsed.work_item_id, parsed.project_slug || this.client.getProjectSlug() || undefined);
                         if (workItem) {
                             let text = JSON.stringify(stripUuids(workItem), null, 2);
-                            const reminders = getWorkItemReminders(workItem.status, workItem.description);
+                            const reminders = getWorkItemReminders(workItem.status, workItem.description, workItem.approved);
                             if (reminders.length > 0) {
                                 text = `${reminders.join('\n\n')}\n\n${text}`;
                             }

package/dist/workItemReminders.js

@@ -27,11 +27,18 @@ const STATUS_REMINDERS = {
         '(update_work_item) and add a completion comment — do not leave it sitting in "doing".',
 };
 // Reminders to prepend to a get_work_item response, most urgent first.
-export function getWorkItemReminders(status, description) {
+export function getWorkItemReminders(status, description, approved) {
     const reminders = [];
-    const statusReminder = STATUS_REMINDERS[status];
-    if (statusReminder)
-        reminders.push(statusReminder);
+    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 — ' +
+            'leave it in the backlog until a human approves it.');
+    }
+    else {
+        const statusReminder = STATUS_REMINDERS[status];
+        if (statusReminder)
+            reminders.push(statusReminder);
+    }
     if (!hasPlan(description)) {
         reminders.push('REMINDER: This work item has no plan. Before starting work, use update_work_progress to add a plan ' +
             'below a "---" separator. Preserve the original description and append your plan with markdown ' +

package/dist/workItemReminders.test.js

@@ -30,6 +30,16 @@ describe('getWorkItemReminders', () => {
             expect.stringContaining('pull_work_item'),
         ]);
     });
+    it('still tells agents to pull approved pending items', () => {
+        expect(getWorkItemReminders('pending', PLAN, true)).toEqual([
+            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('tells agents to move new items to doing', () => {
         expect(getWorkItemReminders('new', PLAN)).toEqual([
             expect.stringContaining('set status to "doing"'),

package/package.json

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