wolfpack-mcp 1.0.61 → 1.0.63

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();

package/dist/index.js

@@ -7,6 +7,7 @@ import { createRequire } from 'module';
 import { readFile, stat } from 'fs/promises';
 import { basename, extname, resolve } from 'path';
 import { WolfpackClient } from './client.js';
+import { allTasksChecked, getWorkItemReminders } from './workItemReminders.js';
 import { validateConfig, config } from './config.js';
 import { AGENT_BUILDER_TOOLS, handleAgentBuilderTool } from './agentBuilderTools.js';
 import { PROCEDURE_TOOLS, handleProcedureTool } from './procedureTools.js';
@@ -220,7 +221,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"'),
@@ -228,8 +236,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()
@@ -346,6 +357,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'),
@@ -628,18 +655,6 @@ function stripUuids(obj) {
     }
     return result;
 }
-// Helper to detect if a work item description contains a plan
-function hasPlan(description) {
-    if (!description)
-        return false;
-    // Check for markdown checklist items (plan indicators)
-    if (/- \[[ x]\]/.test(description))
-        return true;
-    // Check for --- separator with content after (agent-added section)
-    if (/\n---\n/.test(description))
-        return true;
-    return false;
-}
 class WolfpackMCPServer {
     server;
     client;
@@ -681,6 +696,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',
@@ -777,6 +822,7 @@ class WolfpackMCPServer {
                 {
                     name: 'update_work_progress',
                     description: 'Update work item description/notes with your progress. WORKFLOW: 1) get_work_item to read current notes 2) Modify the markdown description with new findings/progress 3) Call this with the complete updated description. The full description replaces the existing one. ' +
+                        'STATUS: Items in "new" are auto-advanced to "doing" (updating progress means work has started). Completing the work is NOT auto-detected: when done, set status to "review" via update_work_item and add a completion comment. ' +
                         'CRITICAL: NEVER overwrite or remove the original description text. Preserve all existing content exactly as-is. Append your plan below a "---" separator. You may only modify content you previously added (your plan section). ' +
                         'BEST PRACTICE: Append a plan with markdown checkboxes (- [ ] task). Check off completed tasks (- [x] task) as you progress. Include sections for: Plan (checklist), Approach (strategy), and Notes (discoveries/decisions). ' +
                         CONTENT_LINKING_HELP,
@@ -982,6 +1028,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',
@@ -993,7 +1040,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',
@@ -1016,8 +1067,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'],
@@ -1954,6 +2008,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);
@@ -1992,11 +2062,9 @@ 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);
-                            // Add hint if no plan detected in description
-                            if (!hasPlan(workItem.description)) {
-                                text =
-                                    '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 checkboxes (- [ ] task).\n\n' +
-                                        text;
+                            const reminders = getWorkItemReminders(workItem.status, workItem.description);
+                            if (reminders.length > 0) {
+                                text = `${reminders.join('\n\n')}\n\n${text}`;
                             }
                             return {
                                 content: [{ type: 'text', text }],
@@ -2009,15 +2077,25 @@ class WolfpackMCPServer {
                     case 'update_work_progress': {
                         const parsed = UpdateWorkProgressSchema.parse(args);
                         const teamSlug = parsed.project_slug || this.client.getProjectSlug() || undefined;
-                        const workItem = await this.client.updateWorkProgress(parsed.work_item_id, parsed.description, teamSlug);
+                        let workItem = await this.client.updateWorkProgress(parsed.work_item_id, parsed.description, teamSlug);
                         if (workItem) {
+                            let summary = `Updated description on: ${workItem.title}`;
+                            // Progress on a "new" item means work has started — advance it to "doing"
+                            if (workItem.status === 'new') {
+                                const advanced = await this.client.updateWorkItem(parsed.work_item_id, { status: 'doing' }, teamSlug);
+                                if (advanced) {
+                                    workItem = advanced;
+                                    summary += ' (status auto-advanced new → doing)';
+                                }
+                            }
+                            let text = `${summary}\n\n${JSON.stringify(stripUuids(workItem), null, 2)}`;
+                            if (workItem.status === 'doing' && allTasksChecked(workItem.description)) {
+                                text =
+                                    'REMINDER: All plan tasks are checked off. If the work is complete, set status to "review" NOW (update_work_item) and add a completion comment.\n\n' +
+                                        text;
+                            }
                             return {
-                                content: [
-                                    {
-                                        type: 'text',
-                                        text: `Updated description on: ${workItem.title}\n\n${JSON.stringify(stripUuids(workItem), null, 2)}`,
-                                    },
-                                ],
+                                content: [{ type: 'text', text }],
                             };
                         }
                         return {
@@ -2193,6 +2271,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,
                         });

package/dist/workItemReminders.js

@@ -0,0 +1,41 @@
+// Workflow reminders injected into work-item tool responses. Tool descriptions document
+// the status workflow, but agents skim them — a reminder in the response at the moment of
+// action is what reliably changes behaviour. Reminders only fire when actionable.
+// Detect if a work item description contains a plan
+export function hasPlan(description) {
+    if (!description)
+        return false;
+    // Check for markdown checklist items (plan indicators)
+    if (/- \[[ x]\]/.test(description))
+        return true;
+    // Check for --- separator with content after (agent-added section)
+    if (/\n---\n/.test(description))
+        return true;
+    return false;
+}
+// True when the description has a checklist and every task is checked off.
+export function allTasksChecked(description) {
+    if (!description)
+        return false;
+    return /- \[x\]/.test(description) && !/- \[ \]/.test(description);
+}
+const STATUS_REMINDERS = {
+    pending: 'REMINDER: This work item is in the backlog ("pending"). Claim it with pull_work_item before starting work.',
+    new: 'REMINDER: This work item is in "new". If you are picking it up, set status to "doing" (update_work_item) ' +
+        'BEFORE starting work.',
+    doing: 'REMINDER: This work item is in "doing". The moment the work is complete, set status to "review" ' +
+        '(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) {
+    const reminders = [];
+    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 ' +
+            'checkboxes (- [ ] task).');
+    }
+    return reminders;
+}

package/dist/workItemReminders.test.js

@@ -0,0 +1,52 @@
+import { describe, it, expect } from 'vitest';
+import { hasPlan, allTasksChecked, getWorkItemReminders } from './workItemReminders.js';
+const PLAN = 'Original text\n\n---\n\n## Plan\n\n- [x] first task\n- [ ] second task';
+const DONE_PLAN = 'Original text\n\n---\n\n## Plan\n\n- [x] first task\n- [x] second task';
+describe('hasPlan', () => {
+    it('detects markdown checklists', () => {
+        expect(hasPlan(PLAN)).toBe(true);
+    });
+    it('detects a --- separator section', () => {
+        expect(hasPlan('Original text\n---\nAgent notes')).toBe(true);
+    });
+    it.each([null, undefined, '', 'Just a plain description'])('rejects %j', (description) => {
+        expect(hasPlan(description)).toBe(false);
+    });
+});
+describe('allTasksChecked', () => {
+    it('is true when every task is checked', () => {
+        expect(allTasksChecked(DONE_PLAN)).toBe(true);
+    });
+    it('is false while unchecked tasks remain', () => {
+        expect(allTasksChecked(PLAN)).toBe(false);
+    });
+    it.each([null, undefined, '', 'No checklist here'])('is false without a checklist (%j)', (description) => {
+        expect(allTasksChecked(description)).toBe(false);
+    });
+});
+describe('getWorkItemReminders', () => {
+    it('tells agents to pull pending items', () => {
+        expect(getWorkItemReminders('pending', PLAN)).toEqual([
+            expect.stringContaining('pull_work_item'),
+        ]);
+    });
+    it('tells agents to move new items to doing', () => {
+        expect(getWorkItemReminders('new', PLAN)).toEqual([
+            expect.stringContaining('set status to "doing"'),
+        ]);
+    });
+    it('tells agents to move doing items to review when complete', () => {
+        expect(getWorkItemReminders('doing', PLAN)).toEqual([
+            expect.stringContaining('set status to "review"'),
+        ]);
+    });
+    it('adds the no-plan reminder when the description has no plan', () => {
+        const reminders = getWorkItemReminders('new', 'Just a description');
+        expect(reminders).toHaveLength(2);
+        expect(reminders[1]).toContain('no plan');
+    });
+    it('stays quiet for statuses with no required action', () => {
+        expect(getWorkItemReminders('review', PLAN)).toEqual([]);
+        expect(getWorkItemReminders('completed', PLAN)).toEqual([]);
+    });
+});

package/package.json

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