wolfpack-mcp 1.0.60 → 1.0.62

package/dist/client.js

@@ -60,6 +60,17 @@ export class WolfpackClient {
         const response = await this.api.get('/teams');
         return response.teams;
     }
+    // Search methods
+    async search(options) {
+        const params = new URLSearchParams({ q: options.query });
+        if (options.teamSlug)
+            params.append('teamSlug', options.teamSlug);
+        if (options.includeInactive)
+            params.append('includeInactive', 'true');
+        if (options.exactOnly)
+            params.append('exactOnly', 'true');
+        return this.api.get(`/search?${params.toString()}`);
+    }
     // Team Member methods
     async listTeamMembers(teamSlug) {
         const params = new URLSearchParams();
@@ -469,6 +480,14 @@ export class WolfpackClient {
         const query = params.toString();
         return this.api.get(`/categories${query ? `?${query}` : ''}`);
     }
+    // Tag methods
+    async listTags(teamSlug) {
+        const params = new URLSearchParams();
+        if (teamSlug)
+            params.append('teamSlug', teamSlug);
+        const query = params.toString();
+        return this.api.get(`/tags${query ? `?${query}` : ''}`);
+    }
     /**
      * Upload an image and get back a URL that can be used in markdown content.
      */
@@ -483,6 +502,14 @@ export class WolfpackClient {
         const { buffer, contentType } = await this.api.getBuffer(`/images/${team}/${filename}`);
         return { base64: buffer.toString('base64'), mimeType: contentType };
     }
+    /**
+     * Download a stored file (new /api/files/{fileId}/{filename} URL shape) and
+     * return raw base64 + mimeType.
+     */
+    async downloadFile(fileId) {
+        const { buffer, contentType } = await this.api.getBuffer(`/files/${fileId}`);
+        return { base64: buffer.toString('base64'), mimeType: contentType };
+    }
     /**
      * Download an issue attachment image and return raw base64 + mimeType.
      */

package/dist/index.js

@@ -166,7 +166,10 @@ const UpdateWorkItemSchema = z.object({
         .nullable()
         .optional()
         .describe('User ID for third assisting user, or null to remove'),
-    tag_ids: z.array(z.string()).optional().describe('Tag IDs to apply (replaces existing tags)'),
+    tags: z
+        .array(z.string())
+        .optional()
+        .describe('Tag names to apply (replaces existing tags). Use list_tags to see available tags.'),
     closing_comment: z
         .string()
         .nullable()
@@ -217,7 +220,14 @@ const CreateRadarItemSchema = z.object({
         .optional()
         .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
     title: z.string().describe('Title of the radar/initiative item'),
-    description: z.string().optional().describe('Description of the initiative (markdown)'),
+    description: z
+        .string()
+        .optional()
+        .describe('Short summary shown on the roadmap card (1-2 sentences). Put extended detail in notes, not here.'),
+    notes: z
+        .string()
+        .optional()
+        .describe("Extended details shown on the initiative's Notes page (markdown). Use this for long-form content."),
     stage: z
         .enum(['pending', 'now', 'next', 'later', 'completed'])
         .describe('Stage: "pending" (not started), "now" (current sprint), "next" (upcoming), "later" (future), "completed"'),
@@ -225,8 +235,11 @@ const CreateRadarItemSchema = z.object({
 const UpdateRadarItemSchema = z.object({
     item_id: z.string().describe('The refId (number) of the radar item to update'),
     title: z.string().optional().describe('Updated title'),
-    description: z.string().optional().describe('Updated description (markdown)'),
-    notes: z.string().optional().describe('Updated internal notes (markdown)'),
+    description: z
+        .string()
+        .optional()
+        .describe('Updated short summary (1-2 sentences; extended detail belongs in notes)'),
+    notes: z.string().optional().describe('Updated Notes page content (markdown)'),
     stage: z
         .enum(['pending', 'now', 'next', 'later', 'completed'])
         .optional()
@@ -343,6 +356,22 @@ const UpdateIssueSchema = z.object({
         .optional()
         .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
 });
+// Search schema
+const SearchSchema = z.object({
+    query: z.string().describe('Search query (websearch syntax: quoted phrases, -exclusions)'),
+    project_slug: z
+        .string()
+        .optional()
+        .describe('Project slug; omit to search all accessible projects'),
+    include_inactive: z
+        .boolean()
+        .optional()
+        .describe('Include finished/archived items (default false)'),
+    exact_only: z
+        .boolean()
+        .optional()
+        .describe('Only exact full-text matches, skipping semantic results (default false)'),
+});
 // Wiki Page schemas
 const ListWikiPagesSchema = z.object({
     project_slug: z.string().optional().describe('Project slug to filter wiki pages'),
@@ -488,7 +517,7 @@ const UploadImageSchema = z.object({
 const DownloadImageSchema = z.object({
     image_url: z
         .string()
-        .describe('The image URL path found in content fields (e.g. "/api/files/images/{team}/{filename}").'),
+        .describe('The image URL path found in content fields (e.g. "/api/files/{fileId}/{filename}" or legacy "/api/files/images/{team}/{filename}").'),
 });
 // Skill schemas
 const GetSkillSchema = z.object({
@@ -505,6 +534,13 @@ const ListCategoriesSchema = z.object({
         .optional()
         .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
 });
+// Tag schemas
+const ListTagsSchema = z.object({
+    project_slug: z
+        .string()
+        .optional()
+        .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
+});
 // Team member schemas
 const ListTeamMembersSchema = z.object({
     project_slug: z
@@ -671,6 +707,36 @@ class WolfpackMCPServer {
                         properties: {},
                     },
                 },
+                // Search tool
+                {
+                    name: 'search',
+                    description: 'Ranked full-text search across project content: wiki pages, work items, cases, journal entries and issues. ' +
+                        '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, ...). ' +
+                        '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',
+                        properties: {
+                            query: {
+                                type: 'string',
+                                description: 'Search query (websearch syntax: quoted phrases, -exclusions)',
+                            },
+                            project_slug: {
+                                type: 'string',
+                                description: 'Project slug; omit to search all accessible projects',
+                            },
+                            include_inactive: {
+                                type: 'boolean',
+                                description: 'Include finished/archived items (default false)',
+                            },
+                            exact_only: {
+                                type: 'boolean',
+                                description: 'Only exact full-text matches, skipping semantic results (default false)',
+                            },
+                        },
+                        required: ['query'],
+                    },
+                },
                 // Work Item tools
                 {
                     name: 'list_work_items',
@@ -748,7 +814,7 @@ class WolfpackMCPServer {
                         '(pending→pull first, new→doing, blocked/ready/completed/closed→new→doing, then review when done). ' +
                         'PLANNING: Check if the description contains a plan (markdown checklist). If not, APPEND one using update_work_progress - preserve all original description text and add your plan below a "---" separator. ' +
                         'FORMS: Procedure-created work items may include formDefinition (field definitions with name, label, type, required, options) and formValues (current values). Use submit_work_item_form to fill in form values. ' +
-                        'IMAGES: Image references in the description (e.g. `![alt](/api/files/images/...)`) can be viewed using the download_image tool.',
+                        'IMAGES: Image references in the description (e.g. `![alt](/api/files/...)`) can be viewed using the download_image tool.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -790,7 +856,7 @@ class WolfpackMCPServer {
                     name: 'update_work_item',
                     description: 'Update one or more fields on a work item. Only provide the fields you want to change. ' +
                         'Supports: title, description, status, leading_user_id (assignee), assisting_user1/2/3_id, ' +
-                        'radar_item_id (initiative), category_id, priority (0-4), size (S/M/L), tag_ids, and closing_comment. ' +
+                        'radar_item_id (initiative), category_id, priority (0-4), size (S/M/L), tags, and closing_comment. ' +
                         '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.',
@@ -857,10 +923,10 @@ class WolfpackMCPServer {
                                 type: ['string', 'null'],
                                 description: 'User ID for third assisting user, or null to remove',
                             },
-                            tag_ids: {
+                            tags: {
                                 type: 'array',
                                 items: { type: 'string' },
-                                description: 'Tag IDs to apply (replaces existing tags)',
+                                description: 'Tag names to apply (replaces existing tags). Use list_tags to see available tags.',
                             },
                             closing_comment: {
                                 type: ['string', 'null'],
@@ -953,7 +1019,7 @@ class WolfpackMCPServer {
                 {
                     name: 'get_radar_item',
                     description: 'Get a specific radar item (initiative) by reference number, including its work items and participants. ' +
-                        'IMAGES: Image references in the description (e.g. `![alt](/api/files/images/...)`) can be viewed using the download_image tool.',
+                        'IMAGES: Image references in the description (e.g. `![alt](/api/files/...)`) can be viewed using the download_image tool.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -972,6 +1038,7 @@ class WolfpackMCPServer {
                 {
                     name: 'create_radar_item',
                     description: 'Create a new radar/initiative item in your current project. Requires mcp:radar:create permission. ' +
+                        'Keep "description" to a short summary; put extended detail in "notes". ' +
                         CONTENT_LINKING_HELP,
                     inputSchema: {
                         type: 'object',
@@ -983,7 +1050,11 @@ class WolfpackMCPServer {
                             title: { type: 'string', description: 'Title of the radar/initiative item' },
                             description: {
                                 type: 'string',
-                                description: 'Description of the initiative (markdown)',
+                                description: 'Short summary shown on the roadmap card (1-2 sentences). Put extended detail in notes, not here.',
+                            },
+                            notes: {
+                                type: 'string',
+                                description: "Extended details shown on the initiative's Notes page (markdown). Use this for long-form content.",
                             },
                             stage: {
                                 type: 'string',
@@ -1006,8 +1077,11 @@ class WolfpackMCPServer {
                                 description: 'The refId (number) of the radar item to update',
                             },
                             title: { type: 'string', description: 'Updated title' },
-                            description: { type: 'string', description: 'Updated description (markdown)' },
-                            notes: { type: 'string', description: 'Updated internal notes (markdown)' },
+                            description: {
+                                type: 'string',
+                                description: 'Updated short summary (1-2 sentences; extended detail belongs in notes)',
+                            },
+                            notes: { type: 'string', description: 'Updated Notes page content (markdown)' },
                             stage: {
                                 type: 'string',
                                 enum: ['pending', 'now', 'next', 'later', 'completed'],
@@ -1086,7 +1160,7 @@ class WolfpackMCPServer {
                     description: 'Get a specific issue by its PREFIXED reference #iN (e.g. #i5). ' +
                         'IMPORTANT: A bare #N (without prefix) is ALWAYS a work item, NOT an issue. Only use this tool when the user explicitly says "issue" or uses the #i prefix. ' +
                         'Returns full details including comment and attachment counts. ' +
-                        'IMAGES: Image references in the description (e.g. `![alt](/api/files/images/...)`) can be viewed using the download_image tool.',
+                        'IMAGES: Image references in the description (e.g. `![alt](/api/files/...)`) can be viewed using the download_image tool.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -1271,7 +1345,7 @@ class WolfpackMCPServer {
                 {
                     name: 'get_wiki_page',
                     description: 'Get a specific wiki/documentation page by slug (URL path). Returns full content in markdown. ' +
-                        'IMAGES: Image references in the content (e.g. `![alt](/api/files/images/...)`) can be viewed using the download_image tool.',
+                        'IMAGES: Image references in the content (e.g. `![alt](/api/files/...)`) can be viewed using the download_image tool.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -1323,7 +1397,7 @@ class WolfpackMCPServer {
                             tag_ids: {
                                 type: 'array',
                                 items: { type: 'string' },
-                                description: 'Tag IDs to apply to the page (replaces existing tags). Use list tags endpoint to get available tag IDs.',
+                                description: 'Tag IDs to apply to the page (replaces existing tags)',
                             },
                             project_slug: {
                                 type: 'string',
@@ -1364,7 +1438,7 @@ class WolfpackMCPServer {
                 {
                     name: 'get_journal_entry',
                     description: 'Get a specific journal/log entry by reference number. Returns full content. ' +
-                        'IMAGES: Image references in the content (e.g. `![alt](/api/files/images/...)`) can be viewed using the download_image tool.',
+                        'IMAGES: Image references in the content (e.g. `![alt](/api/files/...)`) can be viewed using the download_image tool.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -1427,7 +1501,7 @@ class WolfpackMCPServer {
                 {
                     name: 'list_work_item_comments',
                     description: 'List all comments on a work item. Returns comments in chronological order. Requires mcp:comments:read permission. ' +
-                        'IMAGES: Image references in comments (e.g. `![alt](/api/files/images/...)`) can be viewed using the download_image tool.',
+                        'IMAGES: Image references in comments (e.g. `![alt](/api/files/...)`) can be viewed using the download_image tool.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -1443,7 +1517,7 @@ class WolfpackMCPServer {
                 {
                     name: 'list_issue_comments',
                     description: 'List all comments on an issue. Returns comments in chronological order. Requires mcp:comments:read permission. ' +
-                        'IMAGES: Image references in comments (e.g. `![alt](/api/files/images/...)`) can be viewed using the download_image tool.',
+                        'IMAGES: Image references in comments (e.g. `![alt](/api/files/...)`) can be viewed using the download_image tool.',
                     inputSchema: {
                         type: 'object',
                         properties: {
@@ -1563,7 +1637,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/...)`. ' +
+                        'Content from work items, issues, wiki pages, journal entries, and comments may contain image references like `![alt](/api/files/{fileId}/...)` or the legacy `![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.',
@@ -1572,7 +1646,7 @@ class WolfpackMCPServer {
                         properties: {
                             image_url: {
                                 type: 'string',
-                                description: 'The image URL path found in content fields (e.g. "/api/files/images/{team}/{filename}" or "/api/teams/{team}/issues/{refId}/attachments/{id}").',
+                                description: 'The image URL path found in content fields (e.g. "/api/files/{fileId}/{filename}", legacy "/api/files/images/{team}/{filename}", or "/api/teams/{team}/issues/{refId}/attachments/{id}").',
                             },
                         },
                         required: ['image_url'],
@@ -1593,6 +1667,21 @@ class WolfpackMCPServer {
                         },
                     },
                 },
+                // Tag tools
+                {
+                    name: 'list_tags',
+                    description: 'List all tags available in a project. Returns tag names and colours. ' +
+                        'Work items are tagged by name via update_work_item.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            project_slug: {
+                                type: 'string',
+                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                            },
+                        },
+                    },
+                },
                 // Team member tools
                 {
                     name: 'list_team_members',
@@ -1929,6 +2018,22 @@ class WolfpackMCPServer {
                             ],
                         };
                     }
+                    // Search handler
+                    case 'search': {
+                        const parsed = SearchSchema.parse(args);
+                        const results = await this.client.search({
+                            query: parsed.query,
+                            teamSlug: parsed.project_slug || this.client.getProjectSlug() || undefined,
+                            includeInactive: parsed.include_inactive,
+                            exactOnly: parsed.exact_only,
+                        });
+                        const text = results.length === 0
+                            ? 'No results found.'
+                            : JSON.stringify(stripUuids(results), null, 2);
+                        return {
+                            content: [{ type: 'text', text }],
+                        };
+                    }
                     // Work Item handlers
                     case 'list_work_items': {
                         const parsed = ListWorkItemsSchema.parse(args);
@@ -2029,8 +2134,8 @@ class WolfpackMCPServer {
                             fields.assistingUser2Id = parsed.assisting_user2_id;
                         if (parsed.assisting_user3_id !== undefined)
                             fields.assistingUser3Id = parsed.assisting_user3_id;
-                        if (parsed.tag_ids !== undefined)
-                            fields.tagIds = parsed.tag_ids;
+                        if (parsed.tags !== undefined)
+                            fields.tags = parsed.tags;
                         if (parsed.closing_comment !== undefined)
                             fields.closingComment = parsed.closing_comment;
                         const workItem = await this.client.updateWorkItem(parsed.work_item_id, fields, teamSlug);
@@ -2077,7 +2182,7 @@ class WolfpackMCPServer {
                                 changes.push(parsed.assisting_user3_id
                                     ? `assisting user 3 updated`
                                     : 'assisting user 3 removed');
-                            if (parsed.tag_ids !== undefined)
+                            if (parsed.tags !== undefined)
                                 changes.push('tags updated');
                             if (parsed.closing_comment !== undefined)
                                 changes.push('closing comment set');
@@ -2168,6 +2273,7 @@ class WolfpackMCPServer {
                         const radarItem = await this.client.createRadarItem({
                             title: parsed.title,
                             description: parsed.description,
+                            notes: parsed.notes,
                             stage: parsed.stage,
                             teamSlug: parsed.project_slug || this.client.getProjectSlug() || undefined,
                         });
@@ -2557,13 +2663,18 @@ class WolfpackMCPServer {
                     }
                     case 'download_image': {
                         const parsed = DownloadImageSchema.parse(args);
-                        // Try S3-stored image pattern: /api/files/images/{team}/{filename}
+                        // Try stored-file pattern (#1439): /api/files/{fileId}/{filename}
+                        const storedFileMatch = parsed.image_url.match(/\/api\/files\/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})(?:\/|$)/i);
+                        // Try legacy 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) {
+                        if (storedFileMatch) {
+                            ({ base64, mimeType } = await this.client.downloadFile(storedFileMatch[1]));
+                        }
+                        else if (s3Match) {
                             const [, team, filename] = s3Match;
                             ({ base64, mimeType } = await this.client.downloadImage(team, filename));
                         }
@@ -2572,7 +2683,7 @@ class WolfpackMCPServer {
                             ({ 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}');
+                            throw new Error('Invalid image URL. Expected format: /api/files/{fileId}/{filename}, /api/files/images/{team}/{filename} or /api/teams/{team}/issues/{refId}/attachments/{id}');
                         }
                         return {
                             content: [
@@ -2592,6 +2703,14 @@ class WolfpackMCPServer {
                             content: [{ type: 'text', text: JSON.stringify(categories, null, 2) }],
                         };
                     }
+                    // Tag handlers
+                    case 'list_tags': {
+                        const parsed = ListTagsSchema.parse(args);
+                        const tags = await this.client.listTags(parsed.project_slug || this.client.getProjectSlug() || undefined);
+                        return {
+                            content: [{ type: 'text', text: JSON.stringify(tags, null, 2) }],
+                        };
+                    }
                     // Team member handlers
                     case 'list_team_members': {
                         const parsed = ListTeamMembersSchema.parse(args);

package/package.json

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

package/dist/imageProcessor.js

@@ -1,21 +0,0 @@
-const IMAGE_URL_REGEX = /!\[([^\]]*)\]\(\/api\/files\/images\/([^/]+)\/([^)]+)\)/g;
-/**
- * Processes markdown content to replace image URLs with base64 data URIs.
- * Failed fetches or oversized images leave the original URL intact.
- */
-export async function processContentImages(content, client) {
-    if (!content)
-        return content;
-    const matches = [...content.matchAll(IMAGE_URL_REGEX)];
-    if (matches.length === 0)
-        return content;
-    let result = content;
-    for (const match of matches) {
-        const [fullMatch, alt, team, filename] = match;
-        const dataUri = await client.fetchImageAsBase64(team, filename);
-        if (dataUri) {
-            result = result.replace(fullMatch, `![${alt}](${dataUri})`);
-        }
-    }
-    return result;
-}