wolfpack-mcp 1.0.62 → 1.0.64

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';
@@ -654,22 +655,13 @@ 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;
-}
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 class WolfpackMCPServer {
     server;
     client;
     capabilities = [];
+    capabilitiesLoaded = false;
+    capabilitiesFetch = null;
     constructor() {
         this.client = new WolfpackClient();
         this.server = new Server({
@@ -677,1324 +669,1338 @@ class WolfpackMCPServer {
             version: CURRENT_VERSION,
         }, {
             capabilities: {
-                tools: {},
+                tools: { listChanged: true },
                 logging: {},
             },
         });
         this.setupHandlers();
     }
     setupHandlers() {
-        this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
-            tools: [
-                // Project tools
-                {
-                    name: 'list_projects',
-                    description: 'List all projects you have access to. Projects can be "personal" (single user) or "team" (multi-member). ' +
-                        'IMPORTANT - PROJECT FOCUS RULES: ' +
-                        '1) Call this FIRST to identify which project you are working in. ' +
-                        '2) Once you identify a project, STAY WITHIN that project for all operations unless the user explicitly asks to switch. ' +
-                        '3) NEVER perform bulk actions across multiple projects - always work in one project at a time. ' +
-                        '4) If the user mentions a specific project, use that for all subsequent operations. ' +
-                        '5) If unclear which project to use, ASK the user before proceeding. ' +
-                        'Returns project slugs, names, and types. Single-project users have their project auto-selected; multi-project users must specify project_slug in other tool calls. ' +
-                        'ID CONVENTION: A bare number like #1 or #42 ALWAYS refers to a WORK ITEM refId — use get_work_item. ' +
-                        'Other document types REQUIRE a prefix and are never bare numbers: ' +
-                        '#i1 or #issue-1 for issues, #r1 or #roadmap-1 for roadmap/radar, ' +
-                        '#j1 or #journal-1 for journal, #c1 or #case-1 for cases, #p1 or #proc-1 for procedures. ' +
-                        'Wiki pages are referenced by path (e.g. /docs/setup). There is no ambiguity: bare #N = work item.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {},
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            // Heal a startup capabilities failure (#1488) so a tool listing is
+            // never permanently reduced by a transient gateway outage.
+            if (!this.capabilitiesLoaded) {
+                await this.fetchCapabilities();
+            }
+            return {
+                tools: [
+                    // Project tools
+                    {
+                        name: 'list_projects',
+                        description: 'List all projects you have access to. Projects can be "personal" (single user) or "team" (multi-member). ' +
+                            'IMPORTANT - PROJECT FOCUS RULES: ' +
+                            '1) Call this FIRST to identify which project you are working in. ' +
+                            '2) Once you identify a project, STAY WITHIN that project for all operations unless the user explicitly asks to switch. ' +
+                            '3) NEVER perform bulk actions across multiple projects - always work in one project at a time. ' +
+                            '4) If the user mentions a specific project, use that for all subsequent operations. ' +
+                            '5) If unclear which project to use, ASK the user before proceeding. ' +
+                            'Returns project slugs, names, and types. Single-project users have their project auto-selected; multi-project users must specify project_slug in other tool calls. ' +
+                            'ID CONVENTION: A bare number like #1 or #42 ALWAYS refers to a WORK ITEM refId — use get_work_item. ' +
+                            'Other document types REQUIRE a prefix and are never bare numbers: ' +
+                            '#i1 or #issue-1 for issues, #r1 or #roadmap-1 for roadmap/radar, ' +
+                            '#j1 or #journal-1 for journal, #c1 or #case-1 for cases, #p1 or #proc-1 for procedures. ' +
+                            'Wiki pages are referenced by path (e.g. /docs/setup). There is no ambiguity: bare #N = work item.',
+                        inputSchema: {
+                            type: 'object',
+                            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)',
+                    // 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'],
                         },
-                        required: ['query'],
                     },
-                },
-                // Work Item tools
-                {
-                    name: 'list_work_items',
-                    description: 'List work items (tasks/tickets) on the Kanban board or backlog. Work items are the PRIMARY entity — bare #N references (e.g. "work on #1") always mean work items. ' +
-                        'By default lists ALL items in the team, sorted by most recently updated. ' +
-                        'Use assigned_to_id="me" to filter to only your assigned items. ' +
-                        'TERMINOLOGY: "board" and "kanban" are synonymous - both refer to the Kanban board of work items. ' +
-                        'The board has columns: "new" (to do), "doing" (in progress), "review" (pending review), "ready" (code done, awaiting deployment), "blocked", "completed" (deployed). ' +
-                        'The "backlog" or "pending" status represents items not yet on the board. ' +
-                        'By default, completed/closed items are excluded - use status="all" to include them. ' +
-                        'IMPORTANT: Work items are NOT the same as issues. Work items live on the Kanban board/backlog. ' +
-                        'If a user mentions "bugs" in the context of the board/kanban/backlog, they mean work items categorised as bug fixes - use this tool, not list_issues. ' +
-                        'Use when user asks about "the board", "kanban", "work items", "tasks", "my work" (with assigned_to_id="me"), or "backlog".',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
-                            },
-                            status: {
-                                type: 'string',
-                                description: 'Filter by status. Board columns: "new", "doing", "review", "ready", "blocked", "completed". ' +
-                                    'Use "pending" or "backlog" for backlog items not on board. ' +
-                                    'Use "all" to include completed/closed items. Default excludes completed/closed.',
-                            },
-                            assigned_to_id: {
-                                type: 'string',
-                                description: 'Filter by assignee: "all" (default, shows all team items), "me" (your assigned items), "unassigned", or a specific user ID',
-                            },
-                            search: {
-                                type: 'string',
-                                description: 'Text search in title and description',
-                            },
-                            category_id: {
-                                type: 'string',
-                                description: 'Filter by category ID, or "none" for uncategorized items',
-                            },
-                            priority: {
-                                type: 'string',
-                                description: 'Filter by priority level (0-4, higher is more important)',
-                            },
-                            radar_item_id: {
-                                type: 'string',
-                                description: 'Filter by linked radar/initiative item. Accepts refId (e.g. "5" or "#r5"), UUID, ' +
-                                    'or one of "none" (no link), "any" (has any link), "all" (no filter).',
-                            },
-                            sort_by: {
-                                type: 'string',
-                                description: 'Sort field: "dateUpdated" (default, newest activity first), "dateCreated", "priority", "title"',
-                            },
-                            sort_order: {
-                                type: 'string',
-                                description: 'Sort direction: "desc" (default), "asc"',
-                            },
-                            date_from: {
-                                type: 'string',
-                                description: 'Filter items created on or after this date (ISO format, e.g. "2025-01-01")',
-                            },
-                            date_to: {
-                                type: 'string',
-                                description: 'Filter items created on or before this date (ISO format, e.g. "2025-12-31")',
+                    // Work Item tools
+                    {
+                        name: 'list_work_items',
+                        description: 'List work items (tasks/tickets) on the Kanban board or backlog. Work items are the PRIMARY entity — bare #N references (e.g. "work on #1") always mean work items. ' +
+                            'By default lists ALL items in the team, sorted by most recently updated. ' +
+                            'Use assigned_to_id="me" to filter to only your assigned items. ' +
+                            'TERMINOLOGY: "board" and "kanban" are synonymous - both refer to the Kanban board of work items. ' +
+                            'The board has columns: "new" (to do), "doing" (in progress), "review" (pending review), "ready" (code done, awaiting deployment), "blocked", "completed" (deployed). ' +
+                            'The "backlog" or "pending" status represents items not yet on the board. ' +
+                            'By default, completed/closed items are excluded - use status="all" to include them. ' +
+                            'IMPORTANT: Work items are NOT the same as issues. Work items live on the Kanban board/backlog. ' +
+                            'If a user mentions "bugs" in the context of the board/kanban/backlog, they mean work items categorised as bug fixes - use this tool, not list_issues. ' +
+                            'Use when user asks about "the board", "kanban", "work items", "tasks", "my work" (with assigned_to_id="me"), or "backlog".',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
+                                status: {
+                                    type: 'string',
+                                    description: 'Filter by status. Board columns: "new", "doing", "review", "ready", "blocked", "completed". ' +
+                                        'Use "pending" or "backlog" for backlog items not on board. ' +
+                                        'Use "all" to include completed/closed items. Default excludes completed/closed.',
+                                },
+                                assigned_to_id: {
+                                    type: 'string',
+                                    description: 'Filter by assignee: "all" (default, shows all team items), "me" (your assigned items), "unassigned", or a specific user ID',
+                                },
+                                search: {
+                                    type: 'string',
+                                    description: 'Text search in title and description',
+                                },
+                                category_id: {
+                                    type: 'string',
+                                    description: 'Filter by category ID, or "none" for uncategorized items',
+                                },
+                                priority: {
+                                    type: 'string',
+                                    description: 'Filter by priority level (0-4, higher is more important)',
+                                },
+                                radar_item_id: {
+                                    type: 'string',
+                                    description: 'Filter by linked radar/initiative item. Accepts refId (e.g. "5" or "#r5"), UUID, ' +
+                                        'or one of "none" (no link), "any" (has any link), "all" (no filter).',
+                                },
+                                sort_by: {
+                                    type: 'string',
+                                    description: 'Sort field: "dateUpdated" (default, newest activity first), "dateCreated", "priority", "title"',
+                                },
+                                sort_order: {
+                                    type: 'string',
+                                    description: 'Sort direction: "desc" (default), "asc"',
+                                },
+                                date_from: {
+                                    type: 'string',
+                                    description: 'Filter items created on or after this date (ISO format, e.g. "2025-01-01")',
+                                },
+                                date_to: {
+                                    type: 'string',
+                                    description: 'Filter items created on or before this date (ISO format, e.g. "2025-12-31")',
+                                },
+                                limit: { type: 'number', description: 'Maximum number of items to return' },
+                                offset: { type: 'number', description: 'Number of items to skip' },
                             },
-                            limit: { type: 'number', description: 'Maximum number of items to return' },
-                            offset: { type: 'number', description: 'Number of items to skip' },
                         },
                     },
-                },
-                {
-                    name: 'get_work_item',
-                    description: 'Get a specific work item/task by reference number. This is the DEFAULT lookup when a user says "#1" or "work on #42" — bare #N always means a work item. ' +
-                        'Returns full details including description (markdown notes). ' +
-                        'Call this before updating to see current content. ' +
-                        'WORKFLOW: When asked to work on an item, check its status and follow the required state transitions ' +
-                        '(pending→pull first, new→doing, blocked/ready/completed/closed→new→doing, then review when done). ' +
-                        '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/...)`) can be viewed using the download_image tool.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            work_item_id: {
-                                type: 'string',
-                                description: 'The refId (number) of the work item',
-                            },
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for refId lookup)',
+                    {
+                        name: 'get_work_item',
+                        description: 'Get a specific work item/task by reference number. This is the DEFAULT lookup when a user says "#1" or "work on #42" — bare #N always means a work item. ' +
+                            'Returns full details including description (markdown notes). ' +
+                            'Call this before updating to see current content. ' +
+                            'WORKFLOW: When asked to work on an item, check its status and follow the required state transitions ' +
+                            '(pending→pull first, new→doing, blocked/ready/completed/closed→new→doing, then review when done). ' +
+                            '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/...)`) can be viewed using the download_image tool.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                work_item_id: {
+                                    type: 'string',
+                                    description: 'The refId (number) of the work item',
+                                },
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for refId lookup)',
+                                },
                             },
+                            required: ['work_item_id'],
                         },
-                        required: ['work_item_id'],
                     },
-                },
-                {
-                    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. ' +
-                        '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,
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            work_item_id: { type: 'string', description: 'The ID of the work item' },
-                            description: {
-                                type: 'string',
-                                description: 'Updated description/notes for the work item',
-                            },
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                    {
+                        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,
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                work_item_id: { type: 'string', description: 'The ID of the work item' },
+                                description: {
+                                    type: 'string',
+                                    description: 'Updated description/notes for the work item',
+                                },
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
                             },
+                            required: ['work_item_id', 'description'],
                         },
-                        required: ['work_item_id', 'description'],
                     },
-                },
-                {
-                    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), 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.',
-                    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',
-                            },
-                            description: {
-                                type: 'string',
-                                description: 'Updated description (supports Markdown and @mentions)',
-                            },
-                            status: {
-                                type: 'string',
-                                enum: [
-                                    'pending',
-                                    'new',
-                                    'doing',
-                                    'blocked',
-                                    'review',
-                                    'ready',
-                                    'completed',
-                                    'closed',
-                                    'archived',
-                                ],
-                                description: 'New status',
-                            },
-                            leading_user_id: {
-                                type: ['string', 'null'],
-                                description: 'User ID to assign as leading user, or null to unassign',
-                            },
-                            radar_item_id: {
-                                type: ['string', 'null'],
-                                description: 'Link to a radar/initiative item. Accepts refId (e.g. "5" or "#r5") or UUID. Use null to unlink.',
-                            },
-                            category_id: {
-                                type: ['string', 'null'],
-                                description: 'Category ID to set, or null to remove the category',
-                            },
-                            priority: {
-                                type: 'number',
-                                description: 'Priority level: 0 (None), 1 (Low), 2 (Medium), 3 (High), 4 (Urgent)',
-                            },
-                            size: {
-                                type: ['string', 'null'],
-                                enum: ['S', 'M', 'L', null],
-                                description: 'Size estimate: "S" (small), "M" (medium), "L" (large), or null to remove',
-                            },
-                            assisting_user1_id: {
-                                type: ['string', 'null'],
-                                description: 'User ID for first assisting user, or null to remove',
-                            },
-                            assisting_user2_id: {
-                                type: ['string', 'null'],
-                                description: 'User ID for second assisting user, or null to remove',
-                            },
-                            assisting_user3_id: {
-                                type: ['string', 'null'],
-                                description: 'User ID for third assisting user, or null to remove',
-                            },
-                            tags: {
-                                type: 'array',
-                                items: { type: 'string' },
-                                description: 'Tag names to apply (replaces existing tags). Use list_tags to see available tags.',
-                            },
-                            closing_comment: {
-                                type: ['string', 'null'],
-                                description: 'Comment explaining closure/completion',
-                            },
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                    {
+                        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), 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.',
+                        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',
+                                },
+                                description: {
+                                    type: 'string',
+                                    description: 'Updated description (supports Markdown and @mentions)',
+                                },
+                                status: {
+                                    type: 'string',
+                                    enum: [
+                                        'pending',
+                                        'new',
+                                        'doing',
+                                        'blocked',
+                                        'review',
+                                        'ready',
+                                        'completed',
+                                        'closed',
+                                        'archived',
+                                    ],
+                                    description: 'New status',
+                                },
+                                leading_user_id: {
+                                    type: ['string', 'null'],
+                                    description: 'User ID to assign as leading user, or null to unassign',
+                                },
+                                radar_item_id: {
+                                    type: ['string', 'null'],
+                                    description: 'Link to a radar/initiative item. Accepts refId (e.g. "5" or "#r5") or UUID. Use null to unlink.',
+                                },
+                                category_id: {
+                                    type: ['string', 'null'],
+                                    description: 'Category ID to set, or null to remove the category',
+                                },
+                                priority: {
+                                    type: 'number',
+                                    description: 'Priority level: 0 (None), 1 (Low), 2 (Medium), 3 (High), 4 (Urgent)',
+                                },
+                                size: {
+                                    type: ['string', 'null'],
+                                    enum: ['S', 'M', 'L', null],
+                                    description: 'Size estimate: "S" (small), "M" (medium), "L" (large), or null to remove',
+                                },
+                                assisting_user1_id: {
+                                    type: ['string', 'null'],
+                                    description: 'User ID for first assisting user, or null to remove',
+                                },
+                                assisting_user2_id: {
+                                    type: ['string', 'null'],
+                                    description: 'User ID for second assisting user, or null to remove',
+                                },
+                                assisting_user3_id: {
+                                    type: ['string', 'null'],
+                                    description: 'User ID for third assisting user, or null to remove',
+                                },
+                                tags: {
+                                    type: 'array',
+                                    items: { type: 'string' },
+                                    description: 'Tag names to apply (replaces existing tags). Use list_tags to see available tags.',
+                                },
+                                closing_comment: {
+                                    type: ['string', 'null'],
+                                    description: 'Comment explaining closure/completion',
+                                },
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
                             },
+                            required: ['work_item_id'],
                         },
-                        required: ['work_item_id'],
                     },
-                },
-                {
-                    name: 'pull_work_item',
-                    description: 'Pull a specific work item from the backlog to the board. ' +
-                        'REQUIRED: Use this when starting work on a "pending" (backlog) item. ' +
-                        'This claims the item (assigns to you) and sets status to "new". ' +
-                        'After pulling, move to "doing" to indicate active work, then "review" when done. ' +
-                        'If no assignee is specified, assigns to the API key owner. ' +
-                        'In personal projects, items are always assigned to the owner.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            work_item_id: {
-                                type: 'string',
-                                description: 'The ID of the work item to pull from backlog',
-                            },
-                            leading_user_id: {
-                                type: 'string',
-                                description: 'User ID to assign as leading user (optional, defaults to API key owner)',
-                            },
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                    {
+                        name: 'pull_work_item',
+                        description: 'Pull a specific work item from the backlog to the board. ' +
+                            'REQUIRED: Use this when starting work on a "pending" (backlog) item. ' +
+                            'This claims the item (assigns to you) and sets status to "new". ' +
+                            'After pulling, move to "doing" to indicate active work, then "review" when done. ' +
+                            'If no assignee is specified, assigns to the API key owner. ' +
+                            'In personal projects, items are always assigned to the owner.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                work_item_id: {
+                                    type: 'string',
+                                    description: 'The ID of the work item to pull from backlog',
+                                },
+                                leading_user_id: {
+                                    type: 'string',
+                                    description: 'User ID to assign as leading user (optional, defaults to API key owner)',
+                                },
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
                             },
+                            required: ['work_item_id'],
                         },
-                        required: ['work_item_id'],
                     },
-                },
-                {
-                    name: 'submit_work_item_form',
-                    description: 'Submit form values for a procedure-created work item. ' +
-                        'Use get_work_item first to see formDefinition (field names, types, required) and current formValues. ' +
-                        'Then call this with form_values mapping field names to values.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            work_item_id: {
-                                type: 'string',
-                                description: 'The ID of the work item',
-                            },
-                            form_values: {
-                                type: 'object',
-                                description: 'Key-value pairs matching formDefinition field names',
-                            },
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                    {
+                        name: 'submit_work_item_form',
+                        description: 'Submit form values for a procedure-created work item. ' +
+                            'Use get_work_item first to see formDefinition (field names, types, required) and current formValues. ' +
+                            'Then call this with form_values mapping field names to values.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                work_item_id: {
+                                    type: 'string',
+                                    description: 'The ID of the work item',
+                                },
+                                form_values: {
+                                    type: 'object',
+                                    description: 'Key-value pairs matching formDefinition field names',
+                                },
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
                             },
+                            required: ['work_item_id', 'form_values'],
                         },
-                        required: ['work_item_id', 'form_values'],
                     },
-                },
-                // Radar Item (Initiative/Roadmap) tools
-                {
-                    name: 'list_radar_items',
-                    description: 'List radar items - these are initiatives, epics, or roadmap items that group related work items. Use when user asks about "roadmap", "initiatives", "epics", "projects", "what\'s planned", or "upcoming work". Stage: "now" (current sprint), "next" (upcoming), "later" (future), "pending" (not started), "completed".',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (use list_projects to get slugs)',
-                            },
-                            stage: {
-                                type: 'string',
-                                enum: ['pending', 'now', 'next', 'later', 'completed'],
-                                description: 'Filter: "now" (current), "next" (upcoming), "later" (future), "pending", "completed"',
-                            },
-                            search: {
-                                type: 'string',
-                                description: 'Text search in title and description',
+                    // Radar Item (Initiative/Roadmap) tools
+                    {
+                        name: 'list_radar_items',
+                        description: 'List radar items - these are initiatives, epics, or roadmap items that group related work items. Use when user asks about "roadmap", "initiatives", "epics", "projects", "what\'s planned", or "upcoming work". Stage: "now" (current sprint), "next" (upcoming), "later" (future), "pending" (not started), "completed".',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (use list_projects to get slugs)',
+                                },
+                                stage: {
+                                    type: 'string',
+                                    enum: ['pending', 'now', 'next', 'later', 'completed'],
+                                    description: 'Filter: "now" (current), "next" (upcoming), "later" (future), "pending", "completed"',
+                                },
+                                search: {
+                                    type: 'string',
+                                    description: 'Text search in title and description',
+                                },
+                                limit: { type: 'number', description: 'Maximum number of items to return' },
+                                offset: { type: 'number', description: 'Number of items to skip' },
                             },
-                            limit: { type: 'number', description: 'Maximum number of items to return' },
-                            offset: { type: 'number', description: 'Number of items to skip' },
                         },
                     },
-                },
-                {
-                    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/...)`) can be viewed using the download_image tool.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            item_id: {
-                                type: 'string',
-                                description: 'The refId (number) of the radar item',
-                            },
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for refId lookup)',
+                    {
+                        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/...)`) can be viewed using the download_image tool.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                item_id: {
+                                    type: 'string',
+                                    description: 'The refId (number) of the radar item',
+                                },
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for refId lookup)',
+                                },
                             },
+                            required: ['item_id'],
                         },
-                        required: ['item_id'],
                     },
-                },
-                {
-                    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',
-                        properties: {
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
-                            },
-                            title: { type: 'string', description: 'Title of the radar/initiative item' },
-                            description: {
-                                type: 'string',
-                                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',
-                                enum: ['pending', 'now', 'next', 'later', 'completed'],
-                                description: 'Stage: "pending" (not started), "now" (current sprint), "next" (upcoming), "later" (future), "completed"',
+                    {
+                        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',
+                            properties: {
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
+                                title: { type: 'string', description: 'Title of the radar/initiative item' },
+                                description: {
+                                    type: 'string',
+                                    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',
+                                    enum: ['pending', 'now', 'next', 'later', 'completed'],
+                                    description: 'Stage: "pending" (not started), "now" (current sprint), "next" (upcoming), "later" (future), "completed"',
+                                },
                             },
+                            required: ['title', 'stage'],
                         },
-                        required: ['title', 'stage'],
                     },
-                },
-                {
-                    name: 'update_radar_item',
-                    description: 'Update an existing radar/initiative item. Requires mcp:radar:update permission. ' +
-                        CONTENT_LINKING_HELP,
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            item_id: {
-                                type: 'string',
-                                description: 'The refId (number) of the radar item to update',
-                            },
-                            title: { type: 'string', description: 'Updated title' },
-                            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'],
-                                description: 'Updated stage',
-                            },
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                    {
+                        name: 'update_radar_item',
+                        description: 'Update an existing radar/initiative item. Requires mcp:radar:update permission. ' +
+                            CONTENT_LINKING_HELP,
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                item_id: {
+                                    type: 'string',
+                                    description: 'The refId (number) of the radar item to update',
+                                },
+                                title: { type: 'string', description: 'Updated title' },
+                                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'],
+                                    description: 'Updated stage',
+                                },
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
                             },
+                            required: ['item_id'],
                         },
-                        required: ['item_id'],
                     },
-                },
-                // Issue tools
-                {
-                    name: 'list_issues',
-                    description: 'List issues from the Issue Tracker. Issues are a SEPARATE system from work items on the Kanban board. ' +
-                        'Issues track bugs, feature requests, and other reports that may or may not have associated work items. ' +
-                        'Issues are referenced with the #i prefix (e.g. #i5). A bare #N (without prefix) is ALWAYS a work item, NOT an issue. ' +
-                        'IMPORTANT: If the user asks about "bugs" or "tasks" in the context of the "board", "kanban", or "backlog", use list_work_items instead - those are work items, not issues. ' +
-                        'Only use this tool when the user specifically asks about "issues", the "issue tracker", uses the #i prefix, or is clearly referring to the issue tracking system. ' +
-                        'Can filter by status, severity, and type.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
-                            },
-                            status: {
-                                type: 'string',
-                                enum: ['open', 'in-progress', 'resolved', 'closed'],
-                                description: 'Filter: "open" (new/active), "in-progress", "resolved" (fixed), "closed"',
-                            },
-                            severity: {
-                                type: 'string',
-                                enum: ['low', 'medium', 'high', 'critical'],
-                                description: 'Filter by severity/priority: "critical", "high", "medium", "low"',
-                            },
-                            type: {
-                                type: 'string',
-                                enum: ['bug', 'feature-request', 'task', 'improvement', 'question'],
-                                description: 'Filter: "bug" (defect), "feature-request", "task", "improvement", "question"',
-                            },
-                            assigned_to_id: {
-                                type: 'string',
-                                description: 'Filter by assignee: "me" (default), "unassigned", "all", or a specific user ID',
-                            },
-                            search: {
-                                type: 'string',
-                                description: 'Text search in title and description',
-                            },
-                            date_from: {
-                                type: 'string',
-                                description: 'Filter issues created on or after this date (ISO format, e.g. "2025-01-01")',
-                            },
-                            date_to: {
-                                type: 'string',
-                                description: 'Filter issues created on or before this date (ISO format, e.g. "2025-12-31")',
-                            },
-                            sort_by: {
-                                type: 'string',
-                                description: 'Sort field: "dateCreated" (default), "dateUpdated", "severity", "title"',
-                            },
-                            sort_order: {
-                                type: 'string',
-                                description: 'Sort direction: "desc" (default), "asc"',
+                    // Issue tools
+                    {
+                        name: 'list_issues',
+                        description: 'List issues from the Issue Tracker. Issues are a SEPARATE system from work items on the Kanban board. ' +
+                            'Issues track bugs, feature requests, and other reports that may or may not have associated work items. ' +
+                            'Issues are referenced with the #i prefix (e.g. #i5). A bare #N (without prefix) is ALWAYS a work item, NOT an issue. ' +
+                            'IMPORTANT: If the user asks about "bugs" or "tasks" in the context of the "board", "kanban", or "backlog", use list_work_items instead - those are work items, not issues. ' +
+                            'Only use this tool when the user specifically asks about "issues", the "issue tracker", uses the #i prefix, or is clearly referring to the issue tracking system. ' +
+                            'Can filter by status, severity, and type.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
+                                status: {
+                                    type: 'string',
+                                    enum: ['open', 'in-progress', 'resolved', 'closed'],
+                                    description: 'Filter: "open" (new/active), "in-progress", "resolved" (fixed), "closed"',
+                                },
+                                severity: {
+                                    type: 'string',
+                                    enum: ['low', 'medium', 'high', 'critical'],
+                                    description: 'Filter by severity/priority: "critical", "high", "medium", "low"',
+                                },
+                                type: {
+                                    type: 'string',
+                                    enum: ['bug', 'feature-request', 'task', 'improvement', 'question'],
+                                    description: 'Filter: "bug" (defect), "feature-request", "task", "improvement", "question"',
+                                },
+                                assigned_to_id: {
+                                    type: 'string',
+                                    description: 'Filter by assignee: "me" (default), "unassigned", "all", or a specific user ID',
+                                },
+                                search: {
+                                    type: 'string',
+                                    description: 'Text search in title and description',
+                                },
+                                date_from: {
+                                    type: 'string',
+                                    description: 'Filter issues created on or after this date (ISO format, e.g. "2025-01-01")',
+                                },
+                                date_to: {
+                                    type: 'string',
+                                    description: 'Filter issues created on or before this date (ISO format, e.g. "2025-12-31")',
+                                },
+                                sort_by: {
+                                    type: 'string',
+                                    description: 'Sort field: "dateCreated" (default), "dateUpdated", "severity", "title"',
+                                },
+                                sort_order: {
+                                    type: 'string',
+                                    description: 'Sort direction: "desc" (default), "asc"',
+                                },
+                                limit: { type: 'number', description: 'Maximum number of items to return' },
+                                offset: { type: 'number', description: 'Number of items to skip' },
                             },
-                            limit: { type: 'number', description: 'Maximum number of items to return' },
-                            offset: { type: 'number', description: 'Number of items to skip' },
                         },
                     },
-                },
-                {
-                    name: 'get_issue',
-                    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/...)`) can be viewed using the download_image tool.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            issue_id: {
-                                type: 'string',
-                                description: 'The refId (number) of the issue',
-                            },
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for refId lookup)',
+                    {
+                        name: 'get_issue',
+                        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/...)`) can be viewed using the download_image tool.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                issue_id: {
+                                    type: 'string',
+                                    description: 'The refId (number) of the issue',
+                                },
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for refId lookup)',
+                                },
                             },
+                            required: ['issue_id'],
                         },
-                        required: ['issue_id'],
                     },
-                },
-                // Create/Update tools
-                {
-                    name: 'create_work_item',
-                    description: 'Create a new work item in your current project (auto-selected for single-project users, or use list_projects first for multi-project). Requires mcp:work_items:create permission. ' +
-                        CONTENT_LINKING_HELP,
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
-                            },
-                            title: { type: 'string', description: 'Title of the work item' },
-                            description: {
-                                type: 'string',
-                                description: 'Description/notes for the work item (markdown)',
-                            },
-                            status: {
-                                type: 'string',
-                                enum: [
-                                    'pending',
-                                    'new',
-                                    'doing',
-                                    'blocked',
-                                    'review',
-                                    'ready',
-                                    'completed',
-                                    'closed',
-                                    'archived',
-                                ],
-                                description: 'Initial status: "pending" (backlog), "new" (to do), "doing", "review", "ready", "blocked", "completed", "closed", "archived". Defaults to "new".',
-                            },
-                            priority: {
-                                type: 'number',
-                                description: 'Priority level (0-4, higher is more important)',
-                            },
-                            size: {
-                                type: 'string',
-                                enum: ['S', 'M', 'L'],
-                                description: 'Size estimate: "S" (small), "M" (medium), "L" (large)',
-                            },
-                            leading_user_id: {
-                                type: 'string',
-                                description: 'User ID to assign as leading user',
-                            },
-                            category_id: {
-                                type: 'string',
-                                description: 'Category ID to organize the work item',
-                            },
-                            radar_item_id: {
-                                type: 'string',
-                                description: 'Link to a radar/initiative item. Accepts refId (e.g. "5" or "#r5") or UUID.',
+                    // Create/Update tools
+                    {
+                        name: 'create_work_item',
+                        description: 'Create a new work item in your current project (auto-selected for single-project users, or use list_projects first for multi-project). Requires mcp:work_items:create permission. ' +
+                            CONTENT_LINKING_HELP,
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
+                                title: { type: 'string', description: 'Title of the work item' },
+                                description: {
+                                    type: 'string',
+                                    description: 'Description/notes for the work item (markdown)',
+                                },
+                                status: {
+                                    type: 'string',
+                                    enum: [
+                                        'pending',
+                                        'new',
+                                        'doing',
+                                        'blocked',
+                                        'review',
+                                        'ready',
+                                        'completed',
+                                        'closed',
+                                        'archived',
+                                    ],
+                                    description: 'Initial status: "pending" (backlog), "new" (to do), "doing", "review", "ready", "blocked", "completed", "closed", "archived". Defaults to "new".',
+                                },
+                                priority: {
+                                    type: 'number',
+                                    description: 'Priority level (0-4, higher is more important)',
+                                },
+                                size: {
+                                    type: 'string',
+                                    enum: ['S', 'M', 'L'],
+                                    description: 'Size estimate: "S" (small), "M" (medium), "L" (large)',
+                                },
+                                leading_user_id: {
+                                    type: 'string',
+                                    description: 'User ID to assign as leading user',
+                                },
+                                category_id: {
+                                    type: 'string',
+                                    description: 'Category ID to organize the work item',
+                                },
+                                radar_item_id: {
+                                    type: 'string',
+                                    description: 'Link to a radar/initiative item. Accepts refId (e.g. "5" or "#r5") or UUID.',
+                                },
                             },
+                            required: ['title'],
                         },
-                        required: ['title'],
                     },
-                },
-                {
-                    name: 'create_issue',
-                    description: 'Create a new issue in your current project (auto-selected for single-project users, or use list_projects first for multi-project). Requires mcp:issues:create permission. ' +
-                        CONTENT_LINKING_HELP,
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
-                            },
-                            title: { type: 'string', description: 'Title of the issue' },
-                            description: { type: 'string', description: 'Description of the issue' },
-                            severity: {
-                                type: 'string',
-                                enum: ['low', 'medium', 'high', 'critical'],
-                                description: 'Severity level',
-                            },
-                            type: {
-                                type: 'string',
-                                enum: ['bug', 'feature-request', 'task', 'improvement', 'question'],
-                                description: 'Issue type',
+                    {
+                        name: 'create_issue',
+                        description: 'Create a new issue in your current project (auto-selected for single-project users, or use list_projects first for multi-project). Requires mcp:issues:create permission. ' +
+                            CONTENT_LINKING_HELP,
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
+                                title: { type: 'string', description: 'Title of the issue' },
+                                description: { type: 'string', description: 'Description of the issue' },
+                                severity: {
+                                    type: 'string',
+                                    enum: ['low', 'medium', 'high', 'critical'],
+                                    description: 'Severity level',
+                                },
+                                type: {
+                                    type: 'string',
+                                    enum: ['bug', 'feature-request', 'task', 'improvement', 'question'],
+                                    description: 'Issue type',
+                                },
+                                assigned_to_id: { type: 'string', description: 'User ID to assign the issue to' },
+                                environment: {
+                                    type: 'string',
+                                    description: 'Environment where the issue occurred',
+                                },
+                                affected_version: { type: 'string', description: 'Version affected by the issue' },
+                                reproducible: { type: 'boolean', description: 'Whether the issue is reproducible' },
+                                steps_to_reproduce: { type: 'string', description: 'Steps to reproduce the issue' },
+                                expected_behavior: { type: 'string', description: 'Expected behavior' },
+                                actual_behavior: { type: 'string', description: 'Actual behavior observed' },
                             },
-                            assigned_to_id: { type: 'string', description: 'User ID to assign the issue to' },
-                            environment: { type: 'string', description: 'Environment where the issue occurred' },
-                            affected_version: { type: 'string', description: 'Version affected by the issue' },
-                            reproducible: { type: 'boolean', description: 'Whether the issue is reproducible' },
-                            steps_to_reproduce: { type: 'string', description: 'Steps to reproduce the issue' },
-                            expected_behavior: { type: 'string', description: 'Expected behavior' },
-                            actual_behavior: { type: 'string', description: 'Actual behavior observed' },
+                            required: ['title'],
                         },
-                        required: ['title'],
                     },
-                },
-                {
-                    name: 'update_issue',
-                    description: 'Update an existing issue. Requires mcp:issues:update permission. ' +
-                        CONTENT_LINKING_HELP,
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            issue_id: {
-                                type: 'string',
-                                description: 'The refId (number) of the issue to update',
-                            },
-                            title: { type: 'string', description: 'Updated title' },
-                            description: { type: 'string', description: 'Updated description' },
-                            status: {
-                                type: 'string',
-                                enum: ['open', 'in-progress', 'resolved', 'closed'],
-                                description: 'Updated status',
-                            },
-                            severity: {
-                                type: 'string',
-                                enum: ['low', 'medium', 'high', 'critical'],
-                                description: 'Updated severity',
-                            },
-                            type: {
-                                type: 'string',
-                                enum: ['bug', 'feature-request', 'task', 'improvement', 'question'],
-                                description: 'Updated type',
-                            },
-                            assigned_to_id: { type: 'string', description: 'Updated assignee' },
-                            closing_note: {
-                                type: 'string',
-                                description: 'Closing note (when closing the issue)',
-                            },
-                            environment: { type: 'string', description: 'Environment where the issue occurred' },
-                            affected_version: { type: 'string', description: 'Affected version' },
-                            reproducible: { type: 'boolean', description: 'Whether reproducible' },
-                            steps_to_reproduce: { type: 'string', description: 'Steps to reproduce' },
-                            expected_behavior: { type: 'string', description: 'Expected behavior' },
-                            actual_behavior: { type: 'string', description: 'Actual behavior' },
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                    {
+                        name: 'update_issue',
+                        description: 'Update an existing issue. Requires mcp:issues:update permission. ' +
+                            CONTENT_LINKING_HELP,
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                issue_id: {
+                                    type: 'string',
+                                    description: 'The refId (number) of the issue to update',
+                                },
+                                title: { type: 'string', description: 'Updated title' },
+                                description: { type: 'string', description: 'Updated description' },
+                                status: {
+                                    type: 'string',
+                                    enum: ['open', 'in-progress', 'resolved', 'closed'],
+                                    description: 'Updated status',
+                                },
+                                severity: {
+                                    type: 'string',
+                                    enum: ['low', 'medium', 'high', 'critical'],
+                                    description: 'Updated severity',
+                                },
+                                type: {
+                                    type: 'string',
+                                    enum: ['bug', 'feature-request', 'task', 'improvement', 'question'],
+                                    description: 'Updated type',
+                                },
+                                assigned_to_id: { type: 'string', description: 'Updated assignee' },
+                                closing_note: {
+                                    type: 'string',
+                                    description: 'Closing note (when closing the issue)',
+                                },
+                                environment: {
+                                    type: 'string',
+                                    description: 'Environment where the issue occurred',
+                                },
+                                affected_version: { type: 'string', description: 'Affected version' },
+                                reproducible: { type: 'boolean', description: 'Whether reproducible' },
+                                steps_to_reproduce: { type: 'string', description: 'Steps to reproduce' },
+                                expected_behavior: { type: 'string', description: 'Expected behavior' },
+                                actual_behavior: { type: 'string', description: 'Actual behavior' },
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
                             },
+                            required: ['issue_id'],
                         },
-                        required: ['issue_id'],
                     },
-                },
-                // Wiki Page tools
-                {
-                    name: 'list_wiki_pages',
-                    description: 'List wiki pages (documentation, docs, knowledge base). Use when user asks about "docs", "documentation", "wiki", "knowledge base", or "how-to guides".',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
-                            },
-                            search: {
-                                type: 'string',
-                                description: 'Text search in title and content',
-                            },
-                            date_from: {
-                                type: 'string',
-                                description: 'Filter pages updated on or after this date (ISO format, e.g. "2025-01-01")',
-                            },
-                            date_to: {
-                                type: 'string',
-                                description: 'Filter pages updated on or before this date (ISO format, e.g. "2025-12-31")',
+                    // Wiki Page tools
+                    {
+                        name: 'list_wiki_pages',
+                        description: 'List wiki pages (documentation, docs, knowledge base). Use when user asks about "docs", "documentation", "wiki", "knowledge base", or "how-to guides".',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
+                                search: {
+                                    type: 'string',
+                                    description: 'Text search in title and content',
+                                },
+                                date_from: {
+                                    type: 'string',
+                                    description: 'Filter pages updated on or after this date (ISO format, e.g. "2025-01-01")',
+                                },
+                                date_to: {
+                                    type: 'string',
+                                    description: 'Filter pages updated on or before this date (ISO format, e.g. "2025-12-31")',
+                                },
+                                limit: { type: 'number', description: 'Maximum number of pages to return' },
+                                offset: { type: 'number', description: 'Number of pages to skip' },
                             },
-                            limit: { type: 'number', description: 'Maximum number of pages to return' },
-                            offset: { type: 'number', description: 'Number of pages to skip' },
                         },
                     },
-                },
-                {
-                    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/...)`) can be viewed using the download_image tool.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            page_id: {
-                                type: 'string',
-                                description: 'The page slug (URL path like "getting-started")',
+                    {
+                        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/...)`) can be viewed using the download_image tool.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                page_id: {
+                                    type: 'string',
+                                    description: 'The page slug (URL path like "getting-started")',
+                                },
                             },
+                            required: ['page_id'],
                         },
-                        required: ['page_id'],
                     },
-                },
-                {
-                    name: 'create_wiki_page',
-                    description: 'Create a new wiki/documentation page. Use when user wants to "add docs", "create documentation", or "write a guide". ' +
-                        CONTENT_LINKING_HELP,
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
-                            },
-                            slug: {
-                                type: 'string',
-                                description: 'URL slug for the page (without team prefix). The system automatically prepends the team and wiki path. For example, to create a page at "myteam/wiki/guides/onboarding", pass just "guides/onboarding". Do NOT include the team slug or "wiki/" prefix.',
-                            },
-                            title: { type: 'string', description: 'Page title' },
-                            content: {
-                                type: 'string',
-                                description: 'Page content (markdown)',
+                    {
+                        name: 'create_wiki_page',
+                        description: 'Create a new wiki/documentation page. Use when user wants to "add docs", "create documentation", or "write a guide". ' +
+                            CONTENT_LINKING_HELP,
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
+                                slug: {
+                                    type: 'string',
+                                    description: 'URL slug for the page (without team prefix). The system automatically prepends the team and wiki path. For example, to create a page at "myteam/wiki/guides/onboarding", pass just "guides/onboarding". Do NOT include the team slug or "wiki/" prefix.',
+                                },
+                                title: { type: 'string', description: 'Page title' },
+                                content: {
+                                    type: 'string',
+                                    description: 'Page content (markdown)',
+                                },
                             },
+                            required: ['slug', 'title', 'content'],
                         },
-                        required: ['slug', 'title', 'content'],
                     },
-                },
-                {
-                    name: 'update_wiki_page',
-                    description: 'Update an existing wiki page. Requires mcp:wiki:update permission. ' +
-                        CONTENT_LINKING_HELP,
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            page_id: { type: 'string', description: 'The page slug' },
-                            title: { type: 'string', description: 'Updated title' },
-                            content: {
-                                type: 'string',
-                                description: 'Updated content (markdown)',
-                            },
-                            tag_ids: {
-                                type: 'array',
-                                items: { type: 'string' },
-                                description: 'Tag IDs to apply to the page (replaces existing tags)',
-                            },
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                    {
+                        name: 'update_wiki_page',
+                        description: 'Update an existing wiki page. Requires mcp:wiki:update permission. ' +
+                            CONTENT_LINKING_HELP,
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                page_id: { type: 'string', description: 'The page slug' },
+                                title: { type: 'string', description: 'Updated title' },
+                                content: {
+                                    type: 'string',
+                                    description: 'Updated content (markdown)',
+                                },
+                                tag_ids: {
+                                    type: 'array',
+                                    items: { type: 'string' },
+                                    description: 'Tag IDs to apply to the page (replaces existing tags)',
+                                },
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
                             },
+                            required: ['page_id'],
                         },
-                        required: ['page_id'],
                     },
-                },
-                // Journal Entry tools
-                {
-                    name: 'list_journal_entries',
-                    description: 'List journal entries (daily logs, standup notes, progress updates). Use when user asks about "journal", "daily log", "standup notes", "progress updates", or "what did I work on".',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
-                            },
-                            search: {
-                                type: 'string',
-                                description: 'Text search in title and content',
-                            },
-                            date_from: {
-                                type: 'string',
-                                description: 'Filter entries dated on or after this date (ISO format, e.g. "2025-01-01")',
-                            },
-                            date_to: {
-                                type: 'string',
-                                description: 'Filter entries dated on or before this date (ISO format, e.g. "2025-12-31")',
+                    // Journal Entry tools
+                    {
+                        name: 'list_journal_entries',
+                        description: 'List journal entries (daily logs, standup notes, progress updates). Use when user asks about "journal", "daily log", "standup notes", "progress updates", or "what did I work on".',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
+                                search: {
+                                    type: 'string',
+                                    description: 'Text search in title and content',
+                                },
+                                date_from: {
+                                    type: 'string',
+                                    description: 'Filter entries dated on or after this date (ISO format, e.g. "2025-01-01")',
+                                },
+                                date_to: {
+                                    type: 'string',
+                                    description: 'Filter entries dated on or before this date (ISO format, e.g. "2025-12-31")',
+                                },
+                                limit: { type: 'number', description: 'Maximum number of entries to return' },
+                                offset: { type: 'number', description: 'Number of entries to skip' },
                             },
-                            limit: { type: 'number', description: 'Maximum number of entries to return' },
-                            offset: { type: 'number', description: 'Number of entries to skip' },
                         },
                     },
-                },
-                {
-                    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/...)`) can be viewed using the download_image tool.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            entry_id: { type: 'string', description: 'The entry refId (number)' },
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for refId lookup)',
+                    {
+                        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/...)`) can be viewed using the download_image tool.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                entry_id: { type: 'string', description: 'The entry refId (number)' },
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for refId lookup)',
+                                },
                             },
+                            required: ['entry_id'],
                         },
-                        required: ['entry_id'],
                     },
-                },
-                {
-                    name: 'create_journal_entry',
-                    description: 'Create a new journal entry (daily log, standup note, progress update). Use when user wants to "log progress", "write a standup", "add a journal entry", or "record what I did". ' +
-                        CONTENT_LINKING_HELP,
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
-                            },
-                            title: { type: 'string', description: 'Entry title' },
-                            content: {
-                                type: 'string',
-                                description: 'Entry content (markdown)',
+                    {
+                        name: 'create_journal_entry',
+                        description: 'Create a new journal entry (daily log, standup note, progress update). Use when user wants to "log progress", "write a standup", "add a journal entry", or "record what I did". ' +
+                            CONTENT_LINKING_HELP,
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
+                                title: { type: 'string', description: 'Entry title' },
+                                content: {
+                                    type: 'string',
+                                    description: 'Entry content (markdown)',
+                                },
                             },
+                            required: ['title', 'content'],
                         },
-                        required: ['title', 'content'],
                     },
-                },
-                {
-                    name: 'update_journal_entry',
-                    description: 'Update an existing journal entry. Requires mcp:journal:update permission. ' +
-                        CONTENT_LINKING_HELP,
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            entry_id: { type: 'string', description: 'The entry refId (number)' },
-                            title: { type: 'string', description: 'Updated title' },
-                            content: {
-                                type: 'string',
-                                description: 'Updated content (markdown)',
-                            },
-                            tag_ids: {
-                                type: 'array',
-                                items: { type: 'string' },
-                                description: 'Tag IDs to apply (replaces existing tags)',
-                            },
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                    {
+                        name: 'update_journal_entry',
+                        description: 'Update an existing journal entry. Requires mcp:journal:update permission. ' +
+                            CONTENT_LINKING_HELP,
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                entry_id: { type: 'string', description: 'The entry refId (number)' },
+                                title: { type: 'string', description: 'Updated title' },
+                                content: {
+                                    type: 'string',
+                                    description: 'Updated content (markdown)',
+                                },
+                                tag_ids: {
+                                    type: 'array',
+                                    items: { type: 'string' },
+                                    description: 'Tag IDs to apply (replaces existing tags)',
+                                },
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
                             },
+                            required: ['entry_id'],
                         },
-                        required: ['entry_id'],
                     },
-                },
-                // Comment tools
-                {
-                    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/...)`) can be viewed using the download_image tool.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            work_item_id: { type: 'string', description: 'The work item refId (number)' },
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                    // Comment tools
+                    {
+                        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/...)`) can be viewed using the download_image tool.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                work_item_id: { type: 'string', description: 'The work item refId (number)' },
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
                             },
+                            required: ['work_item_id'],
                         },
-                        required: ['work_item_id'],
                     },
-                },
-                {
-                    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/...)`) can be viewed using the download_image tool.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            issue_id: { type: 'string', description: 'The issue refId (number)' },
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                    {
+                        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/...)`) can be viewed using the download_image tool.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                issue_id: { type: 'string', description: 'The issue refId (number)' },
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
                             },
+                            required: ['issue_id'],
                         },
-                        required: ['issue_id'],
                     },
-                },
-                {
-                    name: 'create_work_item_comment',
-                    description: 'Add a comment to a work item. Requires mcp:comments:create permission. ' +
-                        'USE COMMENTS FOR: 1) Blocking reasons when moving to "blocked" (what failed, what was tried, what is needed). ' +
-                        '2) Completion summaries when moving to "review" (what was done, files changed, testing notes). ' +
-                        '3) Important observations or decisions that should be visible in the activity history. ' +
-                        'USE DESCRIPTION (update_work_progress) FOR: Plans, checklists, and progress tracking that need to be updated over time. ' +
-                        'Comments are typically not used in personal projects. ' +
-                        CONTENT_LINKING_HELP,
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            work_item_id: { type: 'string', description: 'The work item refId (number)' },
-                            content: {
-                                type: 'string',
-                                description: 'Comment content (markdown)',
-                            },
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                    {
+                        name: 'create_work_item_comment',
+                        description: 'Add a comment to a work item. Requires mcp:comments:create permission. ' +
+                            'USE COMMENTS FOR: 1) Blocking reasons when moving to "blocked" (what failed, what was tried, what is needed). ' +
+                            '2) Completion summaries when moving to "review" (what was done, files changed, testing notes). ' +
+                            '3) Important observations or decisions that should be visible in the activity history. ' +
+                            'USE DESCRIPTION (update_work_progress) FOR: Plans, checklists, and progress tracking that need to be updated over time. ' +
+                            'Comments are typically not used in personal projects. ' +
+                            CONTENT_LINKING_HELP,
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                work_item_id: { type: 'string', description: 'The work item refId (number)' },
+                                content: {
+                                    type: 'string',
+                                    description: 'Comment content (markdown)',
+                                },
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
                             },
+                            required: ['work_item_id', 'content'],
                         },
-                        required: ['work_item_id', 'content'],
                     },
-                },
-                {
-                    name: 'create_issue_comment',
-                    description: 'Add a comment to an issue. Requires mcp:comments:create permission. ' +
-                        CONTENT_LINKING_HELP,
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            issue_id: { type: 'string', description: 'The issue refId (number)' },
-                            content: {
-                                type: 'string',
-                                description: 'Comment content (markdown)',
-                            },
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                    {
+                        name: 'create_issue_comment',
+                        description: 'Add a comment to an issue. Requires mcp:comments:create permission. ' +
+                            CONTENT_LINKING_HELP,
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                issue_id: { type: 'string', description: 'The issue refId (number)' },
+                                content: {
+                                    type: 'string',
+                                    description: 'Comment content (markdown)',
+                                },
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
                             },
+                            required: ['issue_id', 'content'],
                         },
-                        required: ['issue_id', 'content'],
                     },
-                },
-                {
-                    name: 'delete_work_item_comment',
-                    description: 'Delete a comment from a work item. Only the comment author can delete their own comments. ' +
-                        'Requires mcp:comments:delete permission. Use list_work_item_comments to get comment IDs.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            work_item_id: { type: 'string', description: 'The work item refId (number)' },
-                            comment_id: { type: 'string', description: 'The comment ID to delete' },
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                    {
+                        name: 'delete_work_item_comment',
+                        description: 'Delete a comment from a work item. Only the comment author can delete their own comments. ' +
+                            'Requires mcp:comments:delete permission. Use list_work_item_comments to get comment IDs.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                work_item_id: { type: 'string', description: 'The work item refId (number)' },
+                                comment_id: { type: 'string', description: 'The comment ID to delete' },
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
                             },
+                            required: ['work_item_id', 'comment_id'],
                         },
-                        required: ['work_item_id', 'comment_id'],
                     },
-                },
-                {
-                    name: 'delete_issue_comment',
-                    description: 'Delete a comment from an issue. Only the comment author can delete their own comments. ' +
-                        'Requires mcp:comments:delete permission. Use list_issue_comments to get comment IDs.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            issue_id: { type: 'string', description: 'The issue refId (number)' },
-                            comment_id: { type: 'string', description: 'The comment ID to delete' },
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                    {
+                        name: 'delete_issue_comment',
+                        description: 'Delete a comment from an issue. Only the comment author can delete their own comments. ' +
+                            'Requires mcp:comments:delete permission. Use list_issue_comments to get comment IDs.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                issue_id: { type: 'string', description: 'The issue refId (number)' },
+                                comment_id: { type: 'string', description: 'The comment ID to delete' },
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
                             },
+                            required: ['issue_id', 'comment_id'],
                         },
-                        required: ['issue_id', 'comment_id'],
                     },
-                },
-                // Image tools
-                {
-                    name: 'upload_image',
-                    description: 'Upload an image file from disk and get back a permanent URL. ' +
-                        'Reads the file directly from disk. ' +
-                        'Returns a markdown image URL you can include in any content field. ' +
-                        'IMPORTANT: This tool requires direct filesystem access and may not work in sandboxed environments (e.g. Claude.ai, Claude Desktop). ' +
-                        'If the MCP server cannot access the file path, inform the user that image uploads are not supported in their environment. ' +
-                        'Requires mcp:images:upload permission.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            file_path: {
-                                type: 'string',
-                                description: 'Absolute path to an image file on disk (e.g., "/tmp/screenshot.png"). ' +
-                                    'Supported formats: JPEG, PNG, GIF, WebP. Max 5MB.',
-                            },
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                    // Image tools
+                    {
+                        name: 'upload_image',
+                        description: 'Upload an image file from disk and get back a permanent URL. ' +
+                            'Reads the file directly from disk. ' +
+                            'Returns a markdown image URL you can include in any content field. ' +
+                            'IMPORTANT: This tool requires direct filesystem access and may not work in sandboxed environments (e.g. Claude.ai, Claude Desktop). ' +
+                            'If the MCP server cannot access the file path, inform the user that image uploads are not supported in their environment. ' +
+                            'Requires mcp:images:upload permission.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                file_path: {
+                                    type: 'string',
+                                    description: 'Absolute path to an image file on disk (e.g., "/tmp/screenshot.png"). ' +
+                                        'Supported formats: JPEG, PNG, GIF, WebP. Max 5MB.',
+                                },
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
                             },
+                            required: ['file_path'],
                         },
-                        required: ['file_path'],
                     },
-                },
-                {
-                    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/{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.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            image_url: {
-                                type: 'string',
-                                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}").',
+                    {
+                        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/{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.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                image_url: {
+                                    type: 'string',
+                                    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'],
                         },
-                        required: ['image_url'],
                     },
-                },
-                // Category tools
-                {
-                    name: 'list_categories',
-                    description: 'List all categories available in a project. Returns category IDs, names, and descriptions. ' +
-                        'Use this to look up category IDs by name when creating or updating work items.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            project_slug: {
-                                type: 'string',
-                                description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                    // Category tools
+                    {
+                        name: 'list_categories',
+                        description: 'List all categories available in a project. Returns category IDs, names, and descriptions. ' +
+                            'Use this to look up category IDs by name when creating or updating work items.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
                             },
                         },
                     },
-                },
-                // 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)',
+                    // 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',
-                    description: 'List all members in a project/team. Returns user IDs, names, usernames, roles, and whether the member is an agent. ' +
-                        'Use this to look up user IDs when assigning work items or issues.',
-                    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',
+                        description: 'List all members in a project/team. Returns user IDs, names, usernames, roles, and whether the member is an agent. ' +
+                            'Use this to look up user IDs when assigning work items or issues.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
                             },
                         },
                     },
-                },
-                // Skill tools (progressive disclosure)
-                {
-                    name: 'list_skills',
-                    description: 'List all skills available to the current agent. Returns lean metadata (name + description) for each skill. ' +
-                        'Use get_skill to load the full instructions for a specific skill when needed.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {},
+                    // Skill tools (progressive disclosure)
+                    {
+                        name: 'list_skills',
+                        description: 'List all skills available to the current agent. Returns lean metadata (name + description) for each skill. ' +
+                            'Use get_skill to load the full instructions for a specific skill when needed.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {},
+                        },
                     },
-                },
-                {
-                    name: 'get_skill',
-                    description: 'Load the full instruction content for a specific skill by name. ' +
-                        "Call this when a task matches a skill's description to get detailed instructions before proceeding. " +
-                        'Also returns a list of available resources (scripts, references, assets).',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            skill_name: {
-                                type: 'string',
-                                description: 'The name of the skill to load (e.g. "deploy-app")',
+                    {
+                        name: 'get_skill',
+                        description: 'Load the full instruction content for a specific skill by name. ' +
+                            "Call this when a task matches a skill's description to get detailed instructions before proceeding. " +
+                            'Also returns a list of available resources (scripts, references, assets).',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                skill_name: {
+                                    type: 'string',
+                                    description: 'The name of the skill to load (e.g. "deploy-app")',
+                                },
                             },
+                            required: ['skill_name'],
                         },
-                        required: ['skill_name'],
                     },
-                },
-                {
-                    name: 'get_skill_resource',
-                    description: 'Get a specific resource file attached to a skill. ' +
-                        'Resources can be scripts, reference documents, or assets that supplement the skill instructions.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            skill_name: {
-                                type: 'string',
-                                description: 'The name of the skill',
-                            },
-                            resource_name: {
-                                type: 'string',
-                                description: 'The name of the resource file',
+                    {
+                        name: 'get_skill_resource',
+                        description: 'Get a specific resource file attached to a skill. ' +
+                            'Resources can be scripts, reference documents, or assets that supplement the skill instructions.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                skill_name: {
+                                    type: 'string',
+                                    description: 'The name of the skill',
+                                },
+                                resource_name: {
+                                    type: 'string',
+                                    description: 'The name of the resource file',
+                                },
                             },
+                            required: ['skill_name', 'resource_name'],
                         },
-                        required: ['skill_name', 'resource_name'],
                     },
-                },
-                // Notification tools
-                {
-                    name: 'list_notifications',
-                    description: 'List your notifications. Returns notifications with type, title, message, read status, and linked items (work items, issues). ' +
-                        'Notification types include: mention, assignment, comment, status_change, team_invite, page_update, nomination, reaction. ' +
-                        'Use unread_only=true to see only unread notifications. Supports pagination with limit/offset.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            unread_only: {
-                                type: 'boolean',
-                                description: 'If true, only return unread notifications',
-                            },
-                            limit: {
-                                type: 'number',
-                                description: 'Maximum number of notifications to return (default 20)',
-                            },
-                            offset: {
-                                type: 'number',
-                                description: 'Number of notifications to skip for pagination',
+                    // Notification tools
+                    {
+                        name: 'list_notifications',
+                        description: 'List your notifications. Returns notifications with type, title, message, read status, and linked items (work items, issues). ' +
+                            'Notification types include: mention, assignment, comment, status_change, team_invite, page_update, nomination, reaction. ' +
+                            'Use unread_only=true to see only unread notifications. Supports pagination with limit/offset.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                unread_only: {
+                                    type: 'boolean',
+                                    description: 'If true, only return unread notifications',
+                                },
+                                limit: {
+                                    type: 'number',
+                                    description: 'Maximum number of notifications to return (default 20)',
+                                },
+                                offset: {
+                                    type: 'number',
+                                    description: 'Number of notifications to skip for pagination',
+                                },
                             },
                         },
                     },
-                },
-                {
-                    name: 'mark_notification_read',
-                    description: 'Mark a specific notification as read. Use this after processing a notification to prevent re-processing.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            notification_id: {
-                                type: 'string',
-                                description: 'The ID of the notification to mark as read',
+                    {
+                        name: 'mark_notification_read',
+                        description: 'Mark a specific notification as read. Use this after processing a notification to prevent re-processing.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                notification_id: {
+                                    type: 'string',
+                                    description: 'The ID of the notification to mark as read',
+                                },
                             },
+                            required: ['notification_id'],
                         },
-                        required: ['notification_id'],
                     },
-                },
-                {
-                    name: 'mark_all_notifications_read',
-                    description: 'Mark all of your unread notifications as read.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {},
+                    {
+                        name: 'mark_all_notifications_read',
+                        description: 'Mark all of your unread notifications as read.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {},
+                        },
                     },
-                },
-                {
-                    name: 'delete_notification',
-                    description: 'Delete a specific notification permanently.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            notification_id: {
-                                type: 'string',
-                                description: 'The ID of the notification to delete',
+                    {
+                        name: 'delete_notification',
+                        description: 'Delete a specific notification permanently.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                notification_id: {
+                                    type: 'string',
+                                    description: 'The ID of the notification to delete',
+                                },
                             },
+                            required: ['notification_id'],
                         },
-                        required: ['notification_id'],
                     },
-                },
-                // Subscription tools
-                {
-                    name: 'list_subscriptions',
-                    description: 'List your document subscriptions. Subscriptions control which documents you receive notifications for. ' +
-                        'Each subscription shows the document type, notification preferences (mentions, edits, comments, status), mute status, and reason for subscribing. ' +
-                        'Filter by document_type to see subscriptions for a specific type (e.g. "work_item", "issue", "wiki_page").',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            document_type: {
-                                type: 'string',
-                                enum: ['wiki_page', 'work_item', 'radar_item', 'issue', 'journal', 'discussion'],
-                                description: 'Filter by document type',
-                            },
-                            is_active: {
-                                type: 'boolean',
-                                description: 'Filter by active status',
+                    // Subscription tools
+                    {
+                        name: 'list_subscriptions',
+                        description: 'List your document subscriptions. Subscriptions control which documents you receive notifications for. ' +
+                            'Each subscription shows the document type, notification preferences (mentions, edits, comments, status), mute status, and reason for subscribing. ' +
+                            'Filter by document_type to see subscriptions for a specific type (e.g. "work_item", "issue", "wiki_page").',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                document_type: {
+                                    type: 'string',
+                                    enum: ['wiki_page', 'work_item', 'radar_item', 'issue', 'journal', 'discussion'],
+                                    description: 'Filter by document type',
+                                },
+                                is_active: {
+                                    type: 'boolean',
+                                    description: 'Filter by active status',
+                                },
                             },
                         },
                     },
-                },
-                {
-                    name: 'subscribe',
-                    description: 'Subscribe to a document to receive notifications about it. ' +
-                        'You can configure which notification types to receive: mentions, edits, comments, and status changes. ' +
-                        'Supported document types: wiki_page, work_item, radar_item, issue, journal, discussion.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            document_type: {
-                                type: 'string',
-                                enum: ['wiki_page', 'work_item', 'radar_item', 'issue', 'journal', 'discussion'],
-                                description: 'Type of document to subscribe to',
-                            },
-                            document_id: {
-                                type: 'string',
-                                description: 'The ID of the document to subscribe to',
-                            },
-                            reason: {
-                                type: 'string',
-                                description: 'Reason for subscribing (default: "watched")',
-                            },
-                            notify_on_mentions: {
-                                type: 'boolean',
-                                description: 'Notify when mentioned in this document',
-                            },
-                            notify_on_edits: {
-                                type: 'boolean',
-                                description: 'Notify when the document is edited',
-                            },
-                            notify_on_comments: {
-                                type: 'boolean',
-                                description: 'Notify on new comments',
-                            },
-                            notify_on_status: {
-                                type: 'boolean',
-                                description: 'Notify on status changes',
-                            },
-                            cooldown_minutes: {
-                                type: 'number',
-                                description: 'Minimum minutes between notifications',
+                    {
+                        name: 'subscribe',
+                        description: 'Subscribe to a document to receive notifications about it. ' +
+                            'You can configure which notification types to receive: mentions, edits, comments, and status changes. ' +
+                            'Supported document types: wiki_page, work_item, radar_item, issue, journal, discussion.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                document_type: {
+                                    type: 'string',
+                                    enum: ['wiki_page', 'work_item', 'radar_item', 'issue', 'journal', 'discussion'],
+                                    description: 'Type of document to subscribe to',
+                                },
+                                document_id: {
+                                    type: 'string',
+                                    description: 'The ID of the document to subscribe to',
+                                },
+                                reason: {
+                                    type: 'string',
+                                    description: 'Reason for subscribing (default: "watched")',
+                                },
+                                notify_on_mentions: {
+                                    type: 'boolean',
+                                    description: 'Notify when mentioned in this document',
+                                },
+                                notify_on_edits: {
+                                    type: 'boolean',
+                                    description: 'Notify when the document is edited',
+                                },
+                                notify_on_comments: {
+                                    type: 'boolean',
+                                    description: 'Notify on new comments',
+                                },
+                                notify_on_status: {
+                                    type: 'boolean',
+                                    description: 'Notify on status changes',
+                                },
+                                cooldown_minutes: {
+                                    type: 'number',
+                                    description: 'Minimum minutes between notifications',
+                                },
                             },
+                            required: ['document_type', 'document_id'],
                         },
-                        required: ['document_type', 'document_id'],
                     },
-                },
-                {
-                    name: 'unsubscribe',
-                    description: 'Unsubscribe from a document (soft delete). Stops notifications but keeps the subscription record. ' +
-                        'The subscription can be reactivated by subscribing again.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            document_type: {
-                                type: 'string',
-                                enum: ['wiki_page', 'work_item', 'radar_item', 'issue', 'journal', 'discussion'],
-                                description: 'Type of document to unsubscribe from',
-                            },
-                            document_id: {
-                                type: 'string',
-                                description: 'The ID of the document to unsubscribe from',
+                    {
+                        name: 'unsubscribe',
+                        description: 'Unsubscribe from a document (soft delete). Stops notifications but keeps the subscription record. ' +
+                            'The subscription can be reactivated by subscribing again.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                document_type: {
+                                    type: 'string',
+                                    enum: ['wiki_page', 'work_item', 'radar_item', 'issue', 'journal', 'discussion'],
+                                    description: 'Type of document to unsubscribe from',
+                                },
+                                document_id: {
+                                    type: 'string',
+                                    description: 'The ID of the document to unsubscribe from',
+                                },
                             },
+                            required: ['document_type', 'document_id'],
                         },
-                        required: ['document_type', 'document_id'],
                     },
-                },
-                {
-                    name: 'mute_subscription',
-                    description: 'Temporarily mute notifications from a subscription. The subscription remains active but notifications are silenced. ' +
-                        'Specify duration in minutes, or omit for indefinite mute. Use unmute_subscription to resume.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            document_type: {
-                                type: 'string',
-                                enum: ['wiki_page', 'work_item', 'radar_item', 'issue', 'journal', 'discussion'],
-                                description: 'Type of document',
-                            },
-                            document_id: {
-                                type: 'string',
-                                description: 'The ID of the document',
-                            },
-                            duration: {
-                                type: 'number',
-                                description: 'Duration in minutes to mute (omit for indefinite)',
+                    {
+                        name: 'mute_subscription',
+                        description: 'Temporarily mute notifications from a subscription. The subscription remains active but notifications are silenced. ' +
+                            'Specify duration in minutes, or omit for indefinite mute. Use unmute_subscription to resume.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                document_type: {
+                                    type: 'string',
+                                    enum: ['wiki_page', 'work_item', 'radar_item', 'issue', 'journal', 'discussion'],
+                                    description: 'Type of document',
+                                },
+                                document_id: {
+                                    type: 'string',
+                                    description: 'The ID of the document',
+                                },
+                                duration: {
+                                    type: 'number',
+                                    description: 'Duration in minutes to mute (omit for indefinite)',
+                                },
                             },
+                            required: ['document_type', 'document_id'],
                         },
-                        required: ['document_type', 'document_id'],
                     },
-                },
-                {
-                    name: 'unmute_subscription',
-                    description: 'Unmute a subscription to resume receiving notifications.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            document_type: {
-                                type: 'string',
-                                enum: ['wiki_page', 'work_item', 'radar_item', 'issue', 'journal', 'discussion'],
-                                description: 'Type of document',
-                            },
-                            document_id: {
-                                type: 'string',
-                                description: 'The ID of the document',
+                    {
+                        name: 'unmute_subscription',
+                        description: 'Unmute a subscription to resume receiving notifications.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                document_type: {
+                                    type: 'string',
+                                    enum: ['wiki_page', 'work_item', 'radar_item', 'issue', 'journal', 'discussion'],
+                                    description: 'Type of document',
+                                },
+                                document_id: {
+                                    type: 'string',
+                                    description: 'The ID of the document',
+                                },
                             },
+                            required: ['document_type', 'document_id'],
                         },
-                        required: ['document_type', 'document_id'],
                     },
-                },
-                // Discussion tools
-                {
-                    name: 'get_discussions',
-                    description: 'Get all discussion threads on a document (wiki page, work item, issue, etc.). ' +
-                        'Returns discussions with their full comment threads including replies.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            document_type: {
-                                type: 'string',
-                                description: 'Document type (e.g. "wiki", "work_item", "issue")',
-                            },
-                            document_id: {
-                                type: 'string',
-                                description: 'The ID of the document',
+                    // Discussion tools
+                    {
+                        name: 'get_discussions',
+                        description: 'Get all discussion threads on a document (wiki page, work item, issue, etc.). ' +
+                            'Returns discussions with their full comment threads including replies.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                document_type: {
+                                    type: 'string',
+                                    description: 'Document type (e.g. "wiki", "work_item", "issue")',
+                                },
+                                document_id: {
+                                    type: 'string',
+                                    description: 'The ID of the document',
+                                },
                             },
+                            required: ['document_type', 'document_id'],
                         },
-                        required: ['document_type', 'document_id'],
                     },
-                },
-                {
-                    name: 'get_discussion_by_comment',
-                    description: 'Find the full discussion thread containing a specific comment. ' +
-                        'Use this when you have a comment ID from a notification (sourceDocumentType: "discussion_comment") ' +
-                        'and need to see the full discussion context.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            comment_id: {
-                                type: 'string',
-                                description: 'The comment ID (e.g. from a notification sourceDocumentId)',
+                    {
+                        name: 'get_discussion_by_comment',
+                        description: 'Find the full discussion thread containing a specific comment. ' +
+                            'Use this when you have a comment ID from a notification (sourceDocumentType: "discussion_comment") ' +
+                            'and need to see the full discussion context.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                comment_id: {
+                                    type: 'string',
+                                    description: 'The comment ID (e.g. from a notification sourceDocumentId)',
+                                },
                             },
+                            required: ['comment_id'],
                         },
-                        required: ['comment_id'],
                     },
-                },
-                {
-                    name: 'create_discussion_comment',
-                    description: 'Add a comment to a discussion thread. Supports threaded replies via parent_comment_id. ' +
-                        'Use this to respond to wiki page discussions, work item discussions, or any document discussion.',
-                    inputSchema: {
-                        type: 'object',
-                        properties: {
-                            discussion_id: {
-                                type: 'string',
-                                description: 'The ID of the discussion to comment on',
-                            },
-                            content: {
-                                type: 'string',
-                                description: 'Comment content (supports markdown and @mentions)',
-                            },
-                            parent_comment_id: {
-                                type: 'string',
-                                description: 'Parent comment ID for threaded replies (omit for top-level)',
+                    {
+                        name: 'create_discussion_comment',
+                        description: 'Add a comment to a discussion thread. Supports threaded replies via parent_comment_id. ' +
+                            'Use this to respond to wiki page discussions, work item discussions, or any document discussion.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                discussion_id: {
+                                    type: 'string',
+                                    description: 'The ID of the discussion to comment on',
+                                },
+                                content: {
+                                    type: 'string',
+                                    description: 'Comment content (supports markdown and @mentions)',
+                                },
+                                parent_comment_id: {
+                                    type: 'string',
+                                    description: 'Parent comment ID for threaded replies (omit for top-level)',
+                                },
                             },
+                            required: ['discussion_id', 'content'],
                         },
-                        required: ['discussion_id', 'content'],
                     },
-                },
-                ...(this.capabilities.includes('procedures') ? PROCEDURE_TOOLS : []),
-                ...(this.capabilities.includes('agent_self') ? AGENT_SELF_TOOLS : []),
-                ...(this.capabilities.includes('agent_builder') ? AGENT_BUILDER_TOOLS : []),
-            ],
-        }));
+                    ...(this.capabilities.includes('procedures') ? PROCEDURE_TOOLS : []),
+                    ...(this.capabilities.includes('agent_self') ? AGENT_SELF_TOOLS : []),
+                    ...(this.capabilities.includes('agent_builder') ? AGENT_BUILDER_TOOLS : []),
+                ],
+            };
+        });
         this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
             const { name, arguments: args } = request.params;
             try {
@@ -2072,11 +2078,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 }],
@@ -2089,15 +2093,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 {
@@ -2875,6 +2889,11 @@ class WolfpackMCPServer {
                         };
                     }
                     default: {
+                        // A gated tool may be called while capabilities are still unknown
+                        // (e.g. the client cached the full tool list from a previous process).
+                        if (!this.capabilitiesLoaded) {
+                            await this.fetchCapabilities();
+                        }
                         // Check procedure tools
                         if (this.capabilities.includes('procedures')) {
                             const procedureToolNames = PROCEDURE_TOOLS.map((t) => t.name);
@@ -2931,23 +2950,58 @@ class WolfpackMCPServer {
             return true;
         return false;
     }
-    async start() {
-        // Fetch capabilities to determine which tools to register
-        try {
-            const caps = await this.client.getCapabilities();
+    /**
+     * Fetch capabilities from the backend, sharing a single in-flight request.
+     * Returns true on success. A failure is logged and leaves the current
+     * (possibly empty) capability set untouched so a later attempt can heal it.
+     */
+    fetchCapabilities() {
+        this.capabilitiesFetch ??= this.client
+            .getCapabilities()
+            .then((caps) => {
             this.capabilities = caps.capabilities;
+            this.capabilitiesLoaded = true;
             if (this.capabilities.length > 0) {
                 console.error(`Capabilities: ${this.capabilities.join(', ')}`);
             }
-        }
-        catch (error) {
+            return true;
+        })
+            .catch((error) => {
             console.error(`Warning: Could not fetch capabilities: ${error instanceof Error ? error.message : String(error)}`);
-            // Proceed with project tools only (backward compat)
+            return false;
+        })
+            .finally(() => {
+            this.capabilitiesFetch = null;
+        });
+        return this.capabilitiesFetch;
+    }
+    /** Keep retrying the capability fetch until it succeeds, then tell the client to re-list tools. */
+    async recoverCapabilities() {
+        let delayMs = 15_000;
+        while (!this.capabilitiesLoaded) {
+            await sleep(delayMs);
+            delayMs = Math.min(delayMs * 2, 300_000);
+            if (await this.fetchCapabilities()) {
+                // Best effort — the refreshed set is also served on the next ListTools
+                await this.server.sendToolListChanged().catch(() => { });
+            }
+        }
+    }
+    async start() {
+        // Fetch capabilities to determine which tools to register. A transient
+        // failure here (e.g. a gateway 503) must not permanently reduce the tool
+        // set (#1488), so retry briefly now and keep retrying in the background.
+        for (let attempt = 1; !(await this.fetchCapabilities()) && attempt < 3; attempt++) {
+            await sleep(1000 * attempt);
         }
         // Connect stdio transport FIRST so MCP clients don't deadlock waiting for initialize
         const transport = new StdioServerTransport();
         await this.server.connect(transport);
         console.error(`Wolfpack MCP Server v${CURRENT_VERSION} started`);
+        if (!this.capabilitiesLoaded) {
+            console.error('Starting with base tools only; retrying capabilities fetch in background');
+            void this.recoverCapabilities();
+        }
         // Resolve project for project-capable keys
         if (this.capabilities.includes('project') || this.capabilities.length === 0) {
             if (config.projectSlug) {