wolfpack-mcp 1.0.0 → 1.0.2

package/README.md

@@ -103,14 +103,15 @@ Work items are tasks or tickets assigned to team members.
 
 #### `list_work_items`
 
-Lists work items assigned to you.
+Lists work items assigned to you. By default, excludes completed and closed items to show active work.
 
 - **Parameters:**
   - `team_id` (number, optional): Team ID (use `list_teams` to get IDs)
-  - `status` (string, optional): Filter by status (new, doing, review, completed, blocked)
+  - `status` (string, optional): Filter by status (new, doing, review, completed, blocked). Use `completed` or `closed` to see those items.
   - `limit` (number, optional): Maximum number of items to return
   - `offset` (number, optional): Number of items to skip for pagination
 - **Returns:** Array of work item objects
+- **Note:** Results are automatically paginated. If there are more than 200 items, you'll receive a truncation warning with the first 50 items.
 
 #### `get_work_item`
 
@@ -157,17 +158,18 @@ Issues track bugs, feature requests, and other items in the issue tracker.
 
 #### `list_issues`
 
-Lists issues from the team issue tracker.
+Lists issues from the team issue tracker. By default, excludes closed issues.
 
 - **Parameters:**
   - `team_id` (number, optional): Team ID to filter issues
-  - `status` (string, optional): Filter by status (open, in-progress, resolved, closed)
+  - `status` (string, optional): Filter by status (open, in-progress, resolved, closed). Use `closed` to see closed items.
   - `severity` (string, optional): Filter by severity (low, medium, high, critical)
   - `type` (string, optional): Filter by type (bug, feature-request, task, improvement, question)
   - `assigned_to_id` (string, optional): Filter by assignee ('unassigned' or 'me' for special cases)
   - `limit` (number, optional): Maximum number of items
   - `offset` (number, optional): Items to skip
 - **Returns:** Array of issue objects
+- **Note:** Results are automatically paginated. If there are more than 200 items, you'll receive a truncation warning.
 
 #### `get_issue`
 
@@ -319,14 +321,15 @@ Radar items are strategic initiatives or roadmap items that group related work.
 
 #### `list_radar_items`
 
-Lists radar items from the team.
+Lists radar items from the team. By default, excludes completed items.
 
 - **Parameters:**
   - `team_id` (number, optional): Team ID to filter
-  - `stage` (string, optional): Filter by stage (pending, now, next, later, completed)
+  - `stage` (string, optional): Filter by stage (pending, now, next, later, completed). Use `completed` to see completed items.
   - `limit` (number, optional): Maximum items to return
   - `offset` (number, optional): Items to skip
 - **Returns:** Array of radar item objects
+- **Note:** Results are automatically paginated. If there are more than 200 items, you'll receive a truncation warning.
 
 #### `get_radar_item`
 
@@ -337,6 +340,14 @@ Gets a specific radar item by ID or reference number.
   - `team_id` (number, optional): Team ID (required when using refId)
 - **Returns:** Radar item object with work items and participants
 
+## Automatic Updates
+
+The MCP server checks for updates on startup. If a newer version is available, you'll see a notification in the server logs with instructions to update:
+
+```
+npm install -g wolfpack-mcp@latest
+```
+
 ## Security
 
 - API keys authenticate with your Wolfpack account

package/dist/client.js

@@ -1,4 +1,8 @@
 import { ApiClient } from './apiClient.js';
+// Maximum number of items to fetch without confirmation
+const MAX_ITEMS_THRESHOLD = 200;
+// Page size for fetching all items
+const PAGE_SIZE = 50;
 export class WolfpackClient {
     api;
     teamId = null;
@@ -31,6 +35,48 @@ export class WolfpackClient {
     async listTeams() {
         return this.api.get('/teams');
     }
+    // Helper to fetch all pages of a paginated endpoint
+    async fetchAllPages(endpoint, baseParams) {
+        // First request to get total count
+        const firstParams = new URLSearchParams(baseParams);
+        firstParams.set('limit', PAGE_SIZE.toString());
+        firstParams.set('offset', '0');
+        const firstQuery = firstParams.toString();
+        const firstPage = await this.api.get(`${endpoint}${firstQuery ? `?${firstQuery}` : ''}`);
+        // If total exceeds threshold, return first page with truncation warning
+        if (firstPage.total > MAX_ITEMS_THRESHOLD) {
+            return {
+                items: firstPage.items,
+                total: firstPage.total,
+                truncated: true,
+            };
+        }
+        // If all items fit in first page, return them
+        if (firstPage.items.length >= firstPage.total) {
+            return {
+                items: firstPage.items,
+                total: firstPage.total,
+                truncated: false,
+            };
+        }
+        // Fetch remaining pages
+        const allItems = [...firstPage.items];
+        let offset = PAGE_SIZE;
+        while (offset < firstPage.total) {
+            const params = new URLSearchParams(baseParams);
+            params.set('limit', PAGE_SIZE.toString());
+            params.set('offset', offset.toString());
+            const query = params.toString();
+            const page = await this.api.get(`${endpoint}${query ? `?${query}` : ''}`);
+            allItems.push(...page.items);
+            offset += PAGE_SIZE;
+        }
+        return {
+            items: allItems,
+            total: firstPage.total,
+            truncated: false,
+        };
+    }
     // Work Item methods
     async listWorkItems(options) {
         const params = new URLSearchParams();
@@ -38,12 +84,22 @@ export class WolfpackClient {
             params.append('teamId', options.teamId.toString());
         if (options?.status)
             params.append('status', options.status);
-        if (options?.limit)
-            params.append('limit', options.limit.toString());
-        if (options?.offset)
-            params.append('offset', options.offset.toString());
-        const query = params.toString();
-        return this.api.get(`/work-items${query ? `?${query}` : ''}`);
+        // If explicit limit/offset provided, use single request (for manual pagination)
+        if (options?.limit !== undefined || options?.offset !== undefined) {
+            if (options?.limit)
+                params.append('limit', options.limit.toString());
+            if (options?.offset)
+                params.append('offset', options.offset.toString());
+            const query = params.toString();
+            const response = await this.api.get(`/work-items${query ? `?${query}` : ''}`);
+            return {
+                items: response.items,
+                total: response.total,
+                truncated: response.total > response.items.length,
+            };
+        }
+        // Otherwise, fetch all pages automatically
+        return this.fetchAllPages('/work-items', params);
     }
     async getWorkItem(workItemId, teamId) {
         try {
@@ -91,12 +147,21 @@ export class WolfpackClient {
             params.append('teamId', options.teamId.toString());
         if (options?.stage)
             params.append('stage', options.stage);
-        if (options?.limit)
-            params.append('limit', options.limit.toString());
-        if (options?.offset)
-            params.append('offset', options.offset.toString());
-        const query = params.toString();
-        return this.api.get(`/radar-items${query ? `?${query}` : ''}`);
+        // If explicit limit/offset provided, use single request
+        if (options?.limit !== undefined || options?.offset !== undefined) {
+            if (options?.limit)
+                params.append('limit', options.limit.toString());
+            if (options?.offset)
+                params.append('offset', options.offset.toString());
+            const query = params.toString();
+            const response = await this.api.get(`/radar-items${query ? `?${query}` : ''}`);
+            return {
+                items: response.items,
+                total: response.total,
+                truncated: response.total > response.items.length,
+            };
+        }
+        return this.fetchAllPages('/radar-items', params);
     }
     async getRadarItem(itemId, teamId) {
         try {
@@ -126,12 +191,21 @@ export class WolfpackClient {
             params.append('type', options.type);
         if (options?.assignedToId)
             params.append('assignedToId', options.assignedToId);
-        if (options?.limit)
-            params.append('limit', options.limit.toString());
-        if (options?.offset)
-            params.append('offset', options.offset.toString());
-        const query = params.toString();
-        return this.api.get(`/issues${query ? `?${query}` : ''}`);
+        // If explicit limit/offset provided, use single request
+        if (options?.limit !== undefined || options?.offset !== undefined) {
+            if (options?.limit)
+                params.append('limit', options.limit.toString());
+            if (options?.offset)
+                params.append('offset', options.offset.toString());
+            const query = params.toString();
+            const response = await this.api.get(`/issues${query ? `?${query}` : ''}`);
+            return {
+                items: response.items,
+                total: response.total,
+                truncated: response.total > response.items.length,
+            };
+        }
+        return this.fetchAllPages('/issues', params);
     }
     async getIssue(issueId, teamId) {
         try {
@@ -161,12 +235,21 @@ export class WolfpackClient {
     // Wiki Page methods
     async listWikiPages(options) {
         const params = new URLSearchParams();
-        if (options?.limit)
-            params.append('limit', options.limit.toString());
-        if (options?.offset)
-            params.append('offset', options.offset.toString());
-        const query = params.toString();
-        return this.api.get(`/wiki-pages${query ? `?${query}` : ''}`);
+        // If explicit limit/offset provided, use single request
+        if (options?.limit !== undefined || options?.offset !== undefined) {
+            if (options?.limit)
+                params.append('limit', options.limit.toString());
+            if (options?.offset)
+                params.append('offset', options.offset.toString());
+            const query = params.toString();
+            const response = await this.api.get(`/wiki-pages${query ? `?${query}` : ''}`);
+            return {
+                items: response.items,
+                total: response.total,
+                truncated: response.total > response.items.length,
+            };
+        }
+        return this.fetchAllPages('/wiki-pages', params);
     }
     async getWikiPage(pageId) {
         try {
@@ -188,12 +271,21 @@ export class WolfpackClient {
     // Journal Entry methods
     async listJournalEntries(options) {
         const params = new URLSearchParams();
-        if (options?.limit)
-            params.append('limit', options.limit.toString());
-        if (options?.offset)
-            params.append('offset', options.offset.toString());
-        const query = params.toString();
-        return this.api.get(`/journal-entries${query ? `?${query}` : ''}`);
+        // If explicit limit/offset provided, use single request
+        if (options?.limit !== undefined || options?.offset !== undefined) {
+            if (options?.limit)
+                params.append('limit', options.limit.toString());
+            if (options?.offset)
+                params.append('offset', options.offset.toString());
+            const query = params.toString();
+            const response = await this.api.get(`/journal-entries${query ? `?${query}` : ''}`);
+            return {
+                items: response.items,
+                total: response.total,
+                truncated: response.total > response.items.length,
+            };
+        }
+        return this.fetchAllPages('/journal-entries', params);
     }
     async getJournalEntry(entryId, teamId) {
         try {

package/dist/index.js

@@ -3,8 +3,51 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
 import { z } from 'zod';
+import { createRequire } from 'module';
 import { WolfpackClient } from './client.js';
 import { validateConfig, config } from './config.js';
+// Get current package version
+const require = createRequire(import.meta.url);
+const packageJson = require('../package.json');
+const CURRENT_VERSION = packageJson.version;
+const PACKAGE_NAME = packageJson.name;
+// Check for updates from npm registry
+async function checkForUpdates() {
+    try {
+        const response = await fetch(`https://registry.npmjs.org/${PACKAGE_NAME}/latest`, {
+            headers: { Accept: 'application/json' },
+            signal: AbortSignal.timeout(5000), // 5 second timeout
+        });
+        if (!response.ok)
+            return;
+        const data = (await response.json());
+        const latestVersion = data.version;
+        if (latestVersion && latestVersion !== CURRENT_VERSION) {
+            const [latestMajor, latestMinor, latestPatch] = latestVersion.split('.').map(Number);
+            const [currentMajor, currentMinor, currentPatch] = CURRENT_VERSION.split('.').map(Number);
+            // Check if latest is actually newer
+            const isNewer = latestMajor > currentMajor ||
+                (latestMajor === currentMajor && latestMinor > currentMinor) ||
+                (latestMajor === currentMajor &&
+                    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('');
+            }
+        }
+    }
+    catch {
+        // Silently ignore update check failures - don't block startup
+    }
+}
 // Work Item schemas
 const ListWorkItemsSchema = z.object({
     team_id: z.number().optional().describe('Team ID to filter work items'),
@@ -573,14 +616,18 @@ class WolfpackMCPServer {
                     // Work Item handlers
                     case 'list_work_items': {
                         const parsed = ListWorkItemsSchema.parse(args);
-                        const workItems = await this.client.listWorkItems({
+                        const result = await this.client.listWorkItems({
                             teamId: parsed.team_id || this.client.getTeamId() || undefined,
                             status: parsed.status,
                             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}`;
+                        }
                         return {
-                            content: [{ type: 'text', text: JSON.stringify(workItems, null, 2) }],
+                            content: [{ type: 'text', text }],
                         };
                     }
                     case 'get_work_item': {
@@ -632,14 +679,18 @@ class WolfpackMCPServer {
                     // Radar Item handlers
                     case 'list_radar_items': {
                         const parsed = ListRadarItemsSchema.parse(args);
-                        const radarItems = await this.client.listRadarItems({
+                        const result = await this.client.listRadarItems({
                             teamId: parsed.team_id,
                             stage: parsed.stage,
                             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 stage filter or limit/offset for pagination.\n\n${text}`;
+                        }
                         return {
-                            content: [{ type: 'text', text: JSON.stringify(radarItems, null, 2) }],
+                            content: [{ type: 'text', text }],
                         };
                     }
                     case 'get_radar_item': {
@@ -657,7 +708,7 @@ class WolfpackMCPServer {
                     // Issue handlers
                     case 'list_issues': {
                         const parsed = ListIssuesSchema.parse(args);
-                        const issues = await this.client.listIssues({
+                        const result = await this.client.listIssues({
                             teamId: parsed.team_id,
                             status: parsed.status,
                             severity: parsed.severity,
@@ -666,8 +717,12 @@ class WolfpackMCPServer {
                             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 filters or limit/offset for pagination.\n\n${text}`;
+                        }
                         return {
-                            content: [{ type: 'text', text: JSON.stringify(issues, null, 2) }],
+                            content: [{ type: 'text', text }],
                         };
                     }
                     case 'get_issue': {
@@ -747,12 +802,16 @@ class WolfpackMCPServer {
                     // Wiki Page handlers
                     case 'list_wiki_pages': {
                         const parsed = ListWikiPagesSchema.parse(args);
-                        const pages = await this.client.listWikiPages({
+                        const result = await this.client.listWikiPages({
                             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} pages. Use limit/offset for pagination.\n\n${text}`;
+                        }
                         return {
-                            content: [{ type: 'text', text: JSON.stringify(pages, null, 2) }],
+                            content: [{ type: 'text', text }],
                         };
                     }
                     case 'get_wiki_page': {
@@ -801,12 +860,16 @@ class WolfpackMCPServer {
                     // Journal Entry handlers
                     case 'list_journal_entries': {
                         const parsed = ListJournalEntriesSchema.parse(args);
-                        const entries = await this.client.listJournalEntries({
+                        const result = await this.client.listJournalEntries({
                             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} entries. Use limit/offset for pagination.\n\n${text}`;
+                        }
                         return {
-                            content: [{ type: 'text', text: JSON.stringify(entries, null, 2) }],
+                            content: [{ type: 'text', text }],
                         };
                     }
                     case 'get_journal_entry': {
@@ -895,6 +958,8 @@ class WolfpackMCPServer {
         });
     }
     async start() {
+        // Check for updates (non-blocking)
+        checkForUpdates();
         // Resolve team on startup
         if (config.teamSlug) {
             // Explicit team slug configured - use it
@@ -930,7 +995,7 @@ class WolfpackMCPServer {
         }
         const transport = new StdioServerTransport();
         await this.server.connect(transport);
-        console.error('Wolfpack MCP Server v1.0.0 started');
+        console.error(`Wolfpack MCP Server v${CURRENT_VERSION} started`);
     }
 }
 // Validate configuration before starting

package/package.json

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