wolfpack-mcp 1.0.41 → 1.0.43

package/dist/client.js

@@ -175,42 +175,9 @@ export class WolfpackClient {
             throw error;
         }
     }
-    async updateWorkItemStatus(workItemId, status, teamSlug) {
+    async updateWorkItem(workItemId, fields, teamSlug) {
         try {
-            return await this.api.put(this.withTeamSlug(`/work-items/${workItemId}/status`, teamSlug), { status });
-        }
-        catch (error) {
-            if (error && typeof error === 'object' && 'status' in error && error.status === 404) {
-                return null;
-            }
-            throw error;
-        }
-    }
-    async updateWorkItemAssignee(workItemId, data, teamSlug) {
-        try {
-            return await this.api.put(this.withTeamSlug(`/work-items/${workItemId}/assignee`, teamSlug), data);
-        }
-        catch (error) {
-            if (error && typeof error === 'object' && 'status' in error && error.status === 404) {
-                return null;
-            }
-            throw error;
-        }
-    }
-    async updateWorkItemTitle(workItemId, title, teamSlug) {
-        try {
-            return await this.api.put(this.withTeamSlug(`/work-items/${workItemId}/title`, teamSlug), { title });
-        }
-        catch (error) {
-            if (error && typeof error === 'object' && 'status' in error && error.status === 404) {
-                return null;
-            }
-            throw error;
-        }
-    }
-    async updateWorkItemInitiative(workItemId, radarItemId, teamSlug) {
-        try {
-            return await this.api.put(this.withTeamSlug(`/work-items/${workItemId}/initiative`, teamSlug), { radarItemId });
+            return await this.api.patch(this.withTeamSlug(`/work-items/${workItemId}`, teamSlug), fields);
         }
         catch (error) {
             if (error && typeof error === 'object' && 'status' in error && error.status === 404) {
@@ -402,7 +369,7 @@ export class WolfpackClient {
         return this.api.post('/wiki-pages', { ...rest, teamSlug });
     }
     async updateWikiPage(pageId, data, teamSlug) {
-        return this.api.patch(this.withTeamSlug(`/wiki-pages/${pageId}`, teamSlug), data);
+        return this.api.patch(this.withTeamSlug(`/wiki-pages/${encodeURIComponent(pageId)}`, teamSlug), data);
     }
     // Journal Entry methods
     async listJournalEntries(options) {
@@ -451,7 +418,7 @@ export class WolfpackClient {
         return this.api.post('/journal-entries', { ...rest, teamSlug });
     }
     async updateJournalEntry(entryId, data, teamSlug) {
-        return this.api.patch(this.withTeamSlug(`/journal-entries/${entryId}`, teamSlug), data);
+        return this.api.patch(this.withTeamSlug(`/journal-entries/${encodeURIComponent(entryId)}`, teamSlug), data);
     }
     // Comment methods
     async listWorkItemComments(workItemId, teamSlug) {
@@ -480,6 +447,13 @@ export class WolfpackClient {
         const { buffer, contentType } = await this.api.getBuffer(`/images/${team}/${filename}`);
         return { base64: buffer.toString('base64'), mimeType: contentType };
     }
+    /**
+     * Download an issue attachment image and return raw base64 + mimeType.
+     */
+    async downloadIssueAttachment(team, refId, attachmentId) {
+        const { buffer, contentType } = await this.api.getBuffer(`/issues/${team}/${refId}/attachments/${attachmentId}`);
+        return { base64: buffer.toString('base64'), mimeType: contentType };
+    }
     // Skill methods (progressive disclosure)
     async listSkills() {
         return this.api.get('/skills');

package/dist/index.js

@@ -112,39 +112,31 @@ const VALID_STATUSES = [
     'closed',
     'archived',
 ];
-const UpdateWorkItemStatusSchema = z.object({
-    work_item_id: z.string().describe('The ID of the work item'),
-    status: z.enum(VALID_STATUSES).describe('New status'),
-    project_slug: z
-        .string()
-        .optional()
-        .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
-});
-const UpdateWorkItemAssigneeSchema = z.object({
+const UpdateWorkItemSchema = z.object({
     work_item_id: z.string().describe('The ID of the work item'),
+    title: z.string().optional().describe('New title for the work item'),
+    status: z.enum(VALID_STATUSES).optional().describe('New status'),
     leading_user_id: z
         .string()
         .nullable()
+        .optional()
         .describe('User ID to assign as leading user, or null to unassign'),
-    project_slug: z
+    radar_item_id: z
         .string()
+        .nullable()
         .optional()
-        .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
-});
-const UpdateWorkItemTitleSchema = z.object({
-    work_item_id: z.string().describe('The ID of the work item'),
-    title: z.string().describe('New title for the work item'),
-    project_slug: z
+        .describe('Radar/initiative item ID to link to, or null to unlink'),
+    category_id: z
         .string()
+        .nullable()
         .optional()
-        .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
-});
-const UpdateWorkItemInitiativeSchema = z.object({
-    work_item_id: z.string().describe('The ID of the work item'),
-    radar_item_id: z
-        .string()
+        .describe('Category ID to set, or null to remove the category'),
+    priority: z.coerce.number().optional().describe('Priority level (0-4, higher is more important)'),
+    size: z
+        .enum(['S', 'M', 'L'])
         .nullable()
-        .describe('Radar/initiative item ID to link to, or null to unlink'),
+        .optional()
+        .describe('Size estimate: "S" (small), "M" (medium), "L" (large), or null to remove'),
     project_slug: z
         .string()
         .optional()
@@ -612,16 +604,13 @@ class WolfpackMCPServer {
                     },
                 },
                 {
-                    name: 'update_work_item_status',
-                    description: 'Change work item status. ' +
-                        '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) and add a completion comment summarizing what was done. ' +
-                        '5) If work cannot be done: move to "blocked" and add a detailed comment explaining the blocker, what was attempted, and what is needed to unblock. ' +
-                        'Statuses: "pending" (backlog), "new" (to do), "doing" (in progress), "review" (work done, pending review), ' +
-                        '"ready" (reviewed, awaiting deployment), "blocked", "completed" (deployed).',
+                    name: 'update_work_item',
+                    description: 'Update one or more fields on a work item. Only provide the fields you want to change. ' +
+                        'Supports: title, status, leading_user_id (assignee), radar_item_id (initiative), ' +
+                        'category_id, priority (0-4), and size (S/M/L). ' +
+                        'STATUS WORKFLOW: "pending" (backlog) → "new" (to do) → "doing" (in progress) → "review" (work done) → "ready" (awaiting deployment) → "completed" (deployed). ' +
+                        'Use "blocked" when work cannot proceed. For "pending" items use pull_work_item first. ' +
+                        'When moving to "review", add a completion comment. When moving to "blocked", add a comment explaining the blocker.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -629,6 +618,10 @@ class WolfpackMCPServer {
                                 type: 'string',
                                 description: 'The ID of the work item',
                             },
+                            title: {
+                                type: 'string',
+                                description: 'New title for the work item',
+                            },
                             status: {
                                 type: 'string',
                                 enum: [
@@ -642,84 +635,35 @@ class WolfpackMCPServer {
                                     'closed',
                                     'archived',
                                 ],
-                                description: 'New status: "pending" (backlog), "new" (to do), "doing" (in progress), "review" (work done), "ready" (awaiting deployment), "blocked", "completed" (deployed), "closed", "archived"',
-                            },
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
-                            },
-                        },
-                        required: ['work_item_id', 'status'],
-                    },
-                },
-                {
-                    name: 'update_work_item_assignee',
-                    description: 'Change the assignee (leading user) on a work item. ' +
-                        'Use this to assign work to yourself or another project member, or to unassign by passing null. ' +
-                        'Not applicable for personal projects (single user).',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            work_item_id: {
-                                type: 'string',
-                                description: 'The ID of the work item',
+                                description: 'New status',
                             },
                             leading_user_id: {
                                 type: ['string', 'null'],
                                 description: 'User ID to assign as leading user, or null to unassign',
                             },
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
-                            },
-                        },
-                        required: ['work_item_id', 'leading_user_id'],
-                    },
-                },
-                {
-                    name: 'update_work_item_title',
-                    description: 'Change the title of a work item. ' +
-                        'Use this to rename or update the title of an existing work item.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            work_item_id: {
-                                type: 'string',
-                                description: 'The ID of the work item',
-                            },
-                            title: {
-                                type: 'string',
-                                description: 'New title for the work item',
+                            radar_item_id: {
+                                type: ['string', 'null'],
+                                description: 'Radar/initiative item ID to link to, or null to unlink',
                             },
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                            category_id: {
+                                type: ['string', 'null'],
+                                description: 'Category ID to set, or null to remove the category',
                             },
-                        },
-                        required: ['work_item_id', 'title'],
-                    },
-                },
-                {
-                    name: 'update_work_item_initiative',
-                    description: 'Link or unlink a work item to/from a radar item (initiative). ' +
-                        'Pass a radar_item_id to link, or null to remove the initiative link.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            work_item_id: {
-                                type: 'string',
-                                description: 'The ID of the work item',
+                            priority: {
+                                type: 'number',
+                                description: 'Priority level: 0 (None), 1 (Low), 2 (Medium), 3 (High), 4 (Urgent)',
                             },
-                            radar_item_id: {
+                            size: {
                                 type: ['string', 'null'],
-                                description: 'Radar/initiative item ID to link to, or null to unlink',
+                                enum: ['S', 'M', 'L', null],
+                                description: 'Size estimate: "S" (small), "M" (medium), "L" (large), or null to remove',
                             },
                             project_slug: {
                                 type: 'string',
                                 description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
                             },
                         },
-                        required: ['work_item_id', 'radar_item_id'],
+                        required: ['work_item_id'],
                     },
                 },
                 {
@@ -1302,6 +1246,7 @@ class WolfpackMCPServer {
                     name: 'download_image',
                     description: 'Download and view an image referenced in content fields. ' +
                         'Content from work items, issues, wiki pages, journal entries, and comments may contain image references like `![alt](/api/files/images/...)`. ' +
+                        'Issues may also have attachment images with URLs like `/api/teams/{team}/issues/{refId}/attachments/{id}`. ' +
                         'Use this tool with that URL path to download and view the image. ' +
                         'Requires mcp:images:read permission.',
                     inputSchema: {
@@ -1309,7 +1254,7 @@ class WolfpackMCPServer {
                         properties: {
                             image_url: {
                                 type: 'string',
-                                description: 'The image URL path found in content fields (e.g. "/api/files/images/{team}/{filename}").',
+                                description: 'The image URL path found in content fields (e.g. "/api/files/images/{team}/{filename}" or "/api/teams/{team}/issues/{refId}/attachments/{id}").',
                             },
                         },
                         required: ['image_url'],
@@ -1450,78 +1395,61 @@ class WolfpackMCPServer {
                             content: [{ type: 'text', text: 'Work item not found or not assigned to you' }],
                         };
                     }
-                    case 'update_work_item_status': {
-                        const parsed = UpdateWorkItemStatusSchema.parse(args);
-                        const teamSlug = parsed.project_slug || this.client.getProjectSlug() || undefined;
-                        const workItem = await this.client.updateWorkItemStatus(parsed.work_item_id, parsed.status, teamSlug);
-                        if (workItem) {
-                            return {
-                                content: [
-                                    {
-                                        type: 'text',
-                                        text: `Updated status of "${workItem.title}" to ${parsed.status}\n\n${JSON.stringify(stripUuids(workItem), null, 2)}`,
-                                    },
-                                ],
-                            };
-                        }
-                        return {
-                            content: [{ type: 'text', text: 'Work item not found or not assigned to you' }],
-                        };
-                    }
-                    case 'update_work_item_assignee': {
-                        const parsed = UpdateWorkItemAssigneeSchema.parse(args);
+                    case 'update_work_item': {
+                        const parsed = UpdateWorkItemSchema.parse(args);
                         const teamSlug = parsed.project_slug || this.client.getProjectSlug() || undefined;
-                        const workItem = await this.client.updateWorkItemAssignee(parsed.work_item_id, {
-                            leadingUserId: parsed.leading_user_id,
-                        }, teamSlug);
+                        // Build the fields object with only provided values
+                        const fields = {};
+                        if (parsed.title !== undefined)
+                            fields.title = parsed.title;
+                        if (parsed.status !== undefined)
+                            fields.status = parsed.status;
+                        if (parsed.leading_user_id !== undefined)
+                            fields.leadingUserId = parsed.leading_user_id;
+                        if (parsed.radar_item_id !== undefined)
+                            fields.radarItemId = parsed.radar_item_id;
+                        if (parsed.category_id !== undefined)
+                            fields.categoryId = parsed.category_id;
+                        if (parsed.priority !== undefined)
+                            fields.priority = parsed.priority;
+                        if (parsed.size !== undefined)
+                            fields.size = parsed.size;
+                        const workItem = await this.client.updateWorkItem(parsed.work_item_id, fields, teamSlug);
                         if (workItem) {
-                            const assigneeText = parsed.leading_user_id
-                                ? `assigned to ${parsed.leading_user_id}`
-                                : 'unassigned';
-                            return {
-                                content: [
-                                    {
-                                        type: 'text',
-                                        text: `Updated "${workItem.title}" - now ${assigneeText}\n\n${JSON.stringify(stripUuids(workItem), null, 2)}`,
-                                    },
-                                ],
-                            };
-                        }
-                        return {
-                            content: [{ type: 'text', text: 'Work item not found' }],
-                        };
-                    }
-                    case 'update_work_item_title': {
-                        const parsed = UpdateWorkItemTitleSchema.parse(args);
-                        const teamSlug = parsed.project_slug || this.client.getProjectSlug() || undefined;
-                        const workItem = await this.client.updateWorkItemTitle(parsed.work_item_id, parsed.title, teamSlug);
-                        if (workItem) {
-                            return {
-                                content: [
-                                    {
-                                        type: 'text',
-                                        text: `Updated title to "${workItem.title}"\n\n${JSON.stringify(stripUuids(workItem), null, 2)}`,
-                                    },
-                                ],
-                            };
-                        }
-                        return {
-                            content: [{ type: 'text', text: 'Work item not found' }],
-                        };
-                    }
-                    case 'update_work_item_initiative': {
-                        const parsed = UpdateWorkItemInitiativeSchema.parse(args);
-                        const teamSlug = parsed.project_slug || this.client.getProjectSlug() || undefined;
-                        const workItem = await this.client.updateWorkItemInitiative(parsed.work_item_id, parsed.radar_item_id, teamSlug);
-                        if (workItem) {
-                            const initiativeText = parsed.radar_item_id
-                                ? `linked to initiative ${parsed.radar_item_id}`
-                                : 'unlinked from initiative';
+                            // Build a summary of what changed
+                            const changes = [];
+                            if (parsed.status !== undefined)
+                                changes.push(`status → ${parsed.status}`);
+                            if (parsed.title !== undefined)
+                                changes.push(`title → "${parsed.title}"`);
+                            if (parsed.leading_user_id !== undefined)
+                                changes.push(parsed.leading_user_id
+                                    ? `assigned to ${workItem.leadingUser?.name || parsed.leading_user_id}`
+                                    : 'unassigned');
+                            if (parsed.radar_item_id !== undefined)
+                                changes.push(parsed.radar_item_id ? `linked to initiative` : 'unlinked from initiative');
+                            if (parsed.category_id !== undefined)
+                                changes.push(parsed.category_id
+                                    ? `category → ${workItem.category?.name || parsed.category_id}`
+                                    : 'category removed');
+                            if (parsed.priority !== undefined) {
+                                const labels = {
+                                    0: 'None',
+                                    1: 'Low',
+                                    2: 'Medium',
+                                    3: 'High',
+                                    4: 'Urgent',
+                                };
+                                changes.push(`priority → ${labels[parsed.priority] || parsed.priority}`);
+                            }
+                            if (parsed.size !== undefined)
+                                changes.push(parsed.size ? `size → ${parsed.size}` : 'size removed');
+                            const summary = changes.length > 0 ? changes.join(', ') : 'no changes';
                             return {
                                 content: [
                                     {
                                         type: 'text',
-                                        text: `Updated "${workItem.title}" - ${initiativeText}\n\n${JSON.stringify(stripUuids(workItem), null, 2)}`,
+                                        text: `Updated "${workItem.title}" (${summary})\n\n${JSON.stringify(stripUuids(workItem), null, 2)}`,
                                     },
                                 ],
                             };
@@ -1918,12 +1846,23 @@ class WolfpackMCPServer {
                     }
                     case 'download_image': {
                         const parsed = DownloadImageSchema.parse(args);
-                        const match = parsed.image_url.match(/\/api\/files\/images\/([^/]+)\/(.+)$/);
-                        if (!match) {
-                            throw new Error('Invalid image URL. Expected format: /api/files/images/{team}/{filename}');
+                        // Try S3-stored image pattern: /api/files/images/{team}/{filename}
+                        const s3Match = parsed.image_url.match(/\/api\/files\/images\/([^/]+)\/(.+)$/);
+                        // Try issue attachment pattern: /api/teams/{team}/issues/{refId}/attachments/{id}
+                        const attachmentMatch = parsed.image_url.match(/\/api\/teams\/([^/]+)\/issues\/(\d+)\/attachments\/([^/]+)$/);
+                        let base64;
+                        let mimeType;
+                        if (s3Match) {
+                            const [, team, filename] = s3Match;
+                            ({ base64, mimeType } = await this.client.downloadImage(team, filename));
+                        }
+                        else if (attachmentMatch) {
+                            const [, team, refId, attachmentId] = attachmentMatch;
+                            ({ base64, mimeType } = await this.client.downloadIssueAttachment(team, refId, attachmentId));
+                        }
+                        else {
+                            throw new Error('Invalid image URL. Expected format: /api/files/images/{team}/{filename} or /api/teams/{team}/issues/{refId}/attachments/{id}');
                         }
-                        const [, team, filename] = match;
-                        const { base64, mimeType } = await this.client.downloadImage(team, filename);
                         return {
                             content: [
                                 {

package/package.json

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