wolfpack-mcp 1.0.12 → 1.0.14

package/dist/index.js

@@ -19,7 +19,7 @@ async function checkForUpdates() {
             signal: AbortSignal.timeout(5000), // 5 second timeout
         });
         if (!response.ok)
-            return;
+            return null;
         const data = (await response.json());
         const latestVersion = data.version;
         if (latestVersion && latestVersion !== CURRENT_VERSION) {
@@ -32,21 +32,14 @@ async function checkForUpdates() {
                     latestMinor === currentMinor &&
                     latestPatch > currentPatch);
             if (isNewer) {
-                console.error('');
-                console.error('╔════════════════════════════════════════════════════════════╗');
-                console.error('║                    UPDATE AVAILABLE                        ║');
-                console.error(`║  ${PACKAGE_NAME} ${CURRENT_VERSION} → ${latestVersion}`.padEnd(61) + '║');
-                console.error('║                                                            ║');
-                console.error('║  Run: npm install -g wolfpack-mcp@latest                   ║');
-                console.error('║  Or update your package.json and run: npm install          ║');
-                console.error('╚════════════════════════════════════════════════════════════╝');
-                console.error('');
+                return latestVersion;
             }
         }
     }
     catch {
         // Silently ignore update check failures - don't block startup
     }
+    return null;
 }
 // Work Item schemas
 // Use z.coerce.string() to handle any type coercion issues from MCP args
@@ -55,7 +48,7 @@ const ListWorkItemsSchema = z.object({
     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.'),
+        .describe('Filter by status. Board columns: "new", "doing", "review", "ready", "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()
@@ -150,7 +143,7 @@ const CreateWorkItemSchema = z.object({
     status: z
         .string()
         .optional()
-        .describe('Initial status: "pending" (backlog), "new" (to do), "doing", "review", "blocked", "completed". Defaults to "new".'),
+        .describe('Initial status: "pending" (backlog), "new" (to do), "doing", "review", "ready", "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'),
@@ -237,10 +230,11 @@ class WolfpackMCPServer {
         this.client = new WolfpackClient();
         this.server = new Server({
             name: 'wolfpack',
-            version: '1.0.0',
+            version: CURRENT_VERSION,
         }, {
             capabilities: {
                 tools: {},
+                logging: {},
             },
         });
         this.setupHandlers();
@@ -262,7 +256,7 @@ class WolfpackMCPServer {
                     name: 'list_work_items',
                     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). ' +
+                        'TERMINOLOGY: 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. ' +
                         '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".',
@@ -275,7 +269,7 @@ class WolfpackMCPServer {
                             },
                             status: {
                                 type: 'string',
-                                description: 'Filter by status. Board columns: "new", "doing", "review", "blocked", "completed". ' +
+                                description: 'Filter by status. Board columns: "new", "doing", "review", "ready", "blocked", "completed". ' +
                                     'Use "pending" or "backlog" for backlog items not on board. ' +
                                     'Use "all" to include completed/closed items. Default excludes completed/closed.',
                             },
@@ -314,7 +308,10 @@ class WolfpackMCPServer {
                 },
                 {
                     name: 'get_work_item',
-                    description: 'Get a specific work item/task by ID or reference number. Returns full details including description (markdown notes). Call this before updating to see current content.',
+                    description: 'Get a specific work item/task by ID or reference number. Returns full details including description (markdown notes). ' +
+                        'Call this before updating to see current content. ' +
+                        'WORKFLOW: When asked to work on an item, check its status and follow the required state transitions ' +
+                        '(pending→pull first, new→doing, blocked/ready/completed/closed→new→doing, then review when done).',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -348,9 +345,14 @@ class WolfpackMCPServer {
                 {
                     name: 'update_work_item_status',
                     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.',
+                        'REQUIRED WORKFLOW when working on items: ' +
+                        '1) For "new" items: move to "doing" when starting work. ' +
+                        '2) For "pending" (backlog) items: use pull_work_item first (claims and sets to "new"), then move to "doing". ' +
+                        '3) For items in "blocked", "ready", "completed", or "closed": move to "new" first, then to "doing". ' +
+                        '4) When work is complete: move to "review" (NOT "completed" - that is only for deployed work). ' +
+                        '5) If work cannot be done: move to "blocked" and add a comment explaining why. ' +
+                        'Statuses: "pending" (backlog), "new" (to do), "doing" (in progress), "review" (work done, pending review), ' +
+                        '"ready" (reviewed, awaiting deployment), "blocked", "completed" (deployed).',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -360,7 +362,7 @@ class WolfpackMCPServer {
                             },
                             status: {
                                 type: 'string',
-                                description: 'New status: "pending" (backlog), "new" (to do), "doing" (in progress), "review", "blocked", "completed" (done)',
+                                description: 'New status: "pending" (backlog), "new" (to do), "doing" (in progress), "review" (work done), "ready" (awaiting deployment), "blocked", "completed" (deployed)',
                             },
                         },
                         required: ['work_item_id', 'status'],
@@ -388,10 +390,9 @@ class WolfpackMCPServer {
                 {
                     name: 'pull_work_item',
                     description: 'Pull a specific work item from the backlog to the board. ' +
-                        'WORKFLOW: 1) Use list_work_items with status="pending" to browse backlog items, ' +
-                        '2) Evaluate and select an item, ' +
-                        '3) Use this tool to pull it onto the board. ' +
-                        'This changes the status from "pending" to "new" and assigns the item. ' +
+                        'REQUIRED: Use this when starting work on a "pending" (backlog) item. ' +
+                        'This claims the item (assigns to you) and sets status to "new". ' +
+                        'After pulling, move to "doing" to indicate active work, then "review" when done. ' +
                         'If no assignee is specified, assigns to the API key owner.',
                     inputSchema: {
                         type: 'object',
@@ -511,7 +512,7 @@ class WolfpackMCPServer {
                             },
                             status: {
                                 type: 'string',
-                                description: 'Initial status: "pending" (backlog), "new" (to do), "doing", "review", "blocked", "completed". Defaults to "new".',
+                                description: 'Initial status: "pending" (backlog), "new" (to do), "doing", "review", "ready", "blocked", "completed". Defaults to "new".',
                             },
                             priority: {
                                 type: 'number',
@@ -698,7 +699,8 @@ class WolfpackMCPServer {
                 // Comment tools
                 {
                     name: 'create_work_item_comment',
-                    description: 'Add a comment to a work item. Requires mcp:comments:create permission.',
+                    description: 'Add a comment to a work item. Requires mcp:comments:create permission. ' +
+                        'REQUIRED: When moving an item to "blocked" status, add a comment explaining why the work cannot be done.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -1142,8 +1144,8 @@ class WolfpackMCPServer {
         });
     }
     async start() {
-        // Check for updates (non-blocking)
-        checkForUpdates();
+        // Start version check early (non-blocking)
+        const updateCheckPromise = checkForUpdates();
         // Resolve team on startup
         if (config.teamSlug) {
             // Explicit team slug configured - use it
@@ -1180,6 +1182,14 @@ class WolfpackMCPServer {
         const transport = new StdioServerTransport();
         await this.server.connect(transport);
         console.error(`Wolfpack MCP Server v${CURRENT_VERSION} started`);
+        // Send update notification via MCP logging after server is connected
+        const latestVersion = await updateCheckPromise;
+        if (latestVersion) {
+            await this.server.sendLoggingMessage({
+                level: 'warning',
+                data: `Update available: ${PACKAGE_NAME} ${CURRENT_VERSION} → ${latestVersion}. Run: npm install -g wolfpack-mcp@latest`,
+            });
+        }
     }
 }
 // Validate configuration before starting

package/package.json

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