@mcp-consultant-tools/azure-devops 27.0.0-beta.5 → 27.0.0-beta.7

package/build/index.js

@@ -10,11 +10,14 @@ import { realpathSync } from "node:fs";
 import { createMcpServer, createEnvLoader } from "@mcp-consultant-tools/core";
 import { AzureDevOpsService } from "./AzureDevOpsService.js";
 import { z } from 'zod';
-import { checkFieldFormats, getConversionInstructions, workItemToMarkdown, commentsToMarkdown, buildPatchOperations, updateSyncRevision, getSyncConfig, ensureFolderExists, getWorkItemFilePath, getCommentsFilePath, fileExists, writeWorkItemFile, readWorkItemFile, readFileContent, listSyncedWorkItems, validateFolderPath, autoCommitMultipleFiles, 
+import { descWithExamples, WIQL_EXAMPLES, PATCH_OP_EXAMPLES, WORK_ITEM_FIELD_EXAMPLES, SYNC_TO_FILE_EXAMPLES, SYNC_FROM_FILE_EXAMPLES, SYNC_TASKS_TO_FILE_EXAMPLES, SYNC_TASKS_FROM_FILE_EXAMPLES, } from './tool-examples.js';
+import { checkFieldFormats, workItemToMarkdown, commentsToMarkdown, buildPatchOperations, updateSyncRevision, getSyncConfig, ensureFolderExists, getWorkItemFilePath, getCommentsFilePath, fileExists, writeWorkItemFile, readWorkItemFile, readFileContent, listSyncedWorkItems, validateFolderPath, autoCommitMultipleFiles, 
 // Task sync utilities
 tasksToMarkdown, parseTasksMarkdown, buildTaskPatchOperations, buildNewTaskFields, getTasksFilePath, updateTasksFileAfterCreate, 
 // New work item utilities
-parseNewWorkItemMarkdown, buildNewWorkItemFields, generateNewWorkItemTemplate, convertNewFileToSynced, getNewWorkItemFilePath, findNextNewFileIndex, findNewWorkItemFiles, renameFile, } from './sync/index.js';
+parseNewWorkItemMarkdown, buildNewWorkItemFields, generateNewWorkItemTemplate, convertNewFileToSynced, getNewWorkItemFilePath, findNextNewFileIndex, findNewWorkItemFiles, renameFile, 
+// Markdown format utilities
+getAllLargeTextFields, autoConvertFieldsToMarkdown, isHtmlContent, } from './sync/index.js';
 /**
  * Register azure-devops tools and prompts to an MCP server
  * @param server - The MCP server instance
@@ -579,7 +582,7 @@ export function registerAzureDevOpsTools(server, azuredevopsService) {
     });
     server.tool("query-work-items", "Query work items using WIQL (Work Item Query Language) in Azure DevOps", {
         project: z.string().describe("The project name"),
-        wiql: z.string().describe("The WIQL query string (e.g., \"SELECT [System.Id], [System.Title] FROM WorkItems WHERE [System.State] = 'Active'\")"),
+        wiql: z.string().describe(descWithExamples("The WIQL query string. SQL-like syntax with field names in brackets. Common fields: [System.Id], [System.Title], [System.State], [System.WorkItemType], [System.AssignedTo], [System.Parent]. Use @Me for current user.", WIQL_EXAMPLES)),
         maxResults: z.number().optional().describe("Maximum number of results (default: 200)"),
     }, async ({ project, wiql, maxResults }) => {
         try {
@@ -666,24 +669,53 @@ export function registerAzureDevOpsTools(server, azuredevopsService) {
             };
         }
     });
-    server.tool("update-work-item", "Update a work item in Azure DevOps using JSON Patch operations (requires AZUREDEVOPS_ENABLE_WORK_ITEM_WRITE=true)", {
+    server.tool("update-work-item", "Update a work item in Azure DevOps using JSON Patch operations (requires AZUREDEVOPS_ENABLE_WORK_ITEM_WRITE=true). Auto-injects markdown format operations for large text fields.", {
         project: z.string().describe("The project name"),
         workItemId: z.number().describe("The work item ID"),
         patchOperations: z.array(z.object({
-            op: z.string().describe("The operation type (e.g., 'add', 'replace', 'remove')"),
-            path: z.string().describe("The field path (e.g., '/fields/System.State')"),
+            op: z.string().describe("The operation type: 'add' (set value), 'replace' (update existing), or 'remove' (clear field)"),
+            path: z.string().describe("The field path starting with '/fields/' (e.g., '/fields/System.State', '/fields/System.Title')"),
             value: z.any().optional().describe("The value to set (not required for 'remove' operation)")
-        })).describe("Array of JSON Patch operations"),
-    }, async ({ project, workItemId, patchOperations }) => {
+        })).describe(descWithExamples("Array of JSON Patch operations. Each operation specifies what to change.", PATCH_OP_EXAMPLES)),
+        skipAutoConvert: z.boolean().optional().describe("Skip automatic markdown format injection for large text fields. Only use when explicitly requested. Default: false"),
+    }, async ({ project, workItemId, patchOperations, skipAutoConvert }) => {
         try {
             const service = getAzureDevOpsService();
-            const result = await service.updateWorkItem(project, workItemId, patchOperations);
+            // Auto-inject markdown format operations for large text fields
+            let finalOperations = [...patchOperations];
+            const formatOpsAdded = [];
+            if (!skipAutoConvert) {
+                // Find large text fields being updated (includes custom fields)
+                const allLargeTextFields = getAllLargeTextFields();
+                const largeTextFieldsBeingUpdated = patchOperations
+                    .filter((op) => op.path?.startsWith('/fields/'))
+                    .map((op) => op.path.replace('/fields/', ''))
+                    .filter((field) => allLargeTextFields.includes(field));
+                for (const field of largeTextFieldsBeingUpdated) {
+                    // Check if format operation already exists
+                    const hasFormatOp = finalOperations.some((op) => op.path === `/multilineFieldsFormat/${field}`);
+                    if (!hasFormatOp) {
+                        // Add format operation to ensure markdown
+                        finalOperations.push({
+                            op: 'add',
+                            path: `/multilineFieldsFormat/${field}`,
+                            value: 'Markdown'
+                        });
+                        formatOpsAdded.push(field);
+                    }
+                }
+            }
+            const result = await service.updateWorkItem(project, workItemId, finalOperations);
+            let message = `Updated work item ${workItemId}`;
+            if (formatOpsAdded.length > 0) {
+                message += ` (auto-set markdown format for: ${formatOpsAdded.join(', ')})`;
+            }
             const resultStr = JSON.stringify(result, null, 2);
             return {
                 content: [
                     {
                         type: "text",
-                        text: `Updated work item ${workItemId}:\n\n${resultStr}`,
+                        text: `${message}:\n\n${resultStr}`,
                     },
                 ],
             };
@@ -702,8 +734,8 @@ export function registerAzureDevOpsTools(server, azuredevopsService) {
     });
     server.tool("create-work-item", "Create a new work item in Azure DevOps with optional parent relationship (requires AZUREDEVOPS_ENABLE_WORK_ITEM_WRITE=true)", {
         project: z.string().describe("The project name"),
-        workItemType: z.string().describe("The work item type (e.g., 'Bug', 'Task', 'User Story')"),
-        fields: z.record(z.any()).describe("Object with field values (e.g., {\"System.Title\": \"Bug title\", \"System.Description\": \"Details\"})"),
+        workItemType: z.string().describe("The work item type: 'Bug', 'Task', 'User Story', 'Feature', 'Epic', or custom types"),
+        fields: z.record(z.any()).describe(descWithExamples("Object with field values. Required: System.Title. Common fields: System.Description, System.State, System.AssignedTo, Microsoft.VSTS.Common.AcceptanceCriteria, Microsoft.VSTS.TCM.ReproSteps (bugs).", WORK_ITEM_FIELD_EXAMPLES)),
         parentId: z.number().optional().describe("Optional parent work item ID (for creating child items). Simplified alternative to relations parameter."),
         relations: z.array(z.object({
             rel: z.string().describe("Relation type (e.g., 'System.LinkTypes.Hierarchy-Reverse' for parent)"),
@@ -945,16 +977,70 @@ export function registerAzureDevOpsTools(server, azuredevopsService) {
         }
     });
     // ========================================
+    // BUILD TROUBLESHOOTING TOOLS (Read-only)
+    // NOTE: These tools are duplicated in azure-devops-admin package.
+    // If you update these, also update packages/azure-devops-admin/src/index.ts
+    // ========================================
+    server.tool("get-build-status", "Get build status and details. Use detail='summary' for basic status, 'timeline' for step breakdown (default scope='problems' shows only failed/warning items), or 'full' for logs. The timelineScope controls what records are included: 'problems' (default, only errors/warnings), 'stages' (minimal), 'jobs' (moderate), 'all' (everything).", {
+        project: z.string().describe("The project name"),
+        buildId: z.number().describe("The build ID"),
+        detail: z.enum(["summary", "timeline", "full"]).optional().describe("Level of detail: 'summary' (default), 'timeline' (include steps), or 'full' (include logs)"),
+        timelineScope: z.enum(["stages", "jobs", "all", "problems"]).optional().describe("Timeline scope: 'problems' (default, only errors/warnings/failures), 'stages' (minimal), 'jobs' (moderate), 'all' (everything - may be large)"),
+        maxIssues: z.number().optional().describe("Maximum issues per record (default: 5, prioritizes errors over warnings)"),
+    }, async ({ project, buildId, detail, timelineScope, maxIssues }) => {
+        try {
+            const service = getAzureDevOpsService();
+            const result = await service.getBuildStatus(project, buildId, detail || 'summary', timelineScope || 'problems', maxIssues || 5);
+            return { content: [{ type: "text", text: `Build ${buildId} status:\n\n${JSON.stringify(result, null, 2)}` }] };
+        }
+        catch (error) {
+            console.error("Error getting build status:", error);
+            return { content: [{ type: "text", text: `Failed to get build status: ${error.message}` }] };
+        }
+    });
+    server.tool("get-build-timeline", "Get step-by-step breakdown of a build. Shows stages, jobs, and tasks with timing, status, and error/warning counts. Use scope to control output size: 'problems' (default, only errors/warnings), 'stages' (minimal), 'jobs' (moderate), 'all' (everything). Always includes summary stats regardless of scope.", {
+        project: z.string().describe("The project name"),
+        buildId: z.number().describe("The build ID"),
+        scope: z.enum(["stages", "jobs", "all", "problems"]).optional().describe("Filter scope: 'problems' (default, only errors/warnings/failures), 'stages' (minimal), 'jobs' (moderate), 'all' (everything - may be large)"),
+        maxIssues: z.number().optional().describe("Maximum issues per record (default: 5, prioritizes errors over warnings)"),
+    }, async ({ project, buildId, scope, maxIssues }) => {
+        try {
+            const service = getAzureDevOpsService();
+            const result = await service.getBuildTimeline(project, buildId, scope || 'problems', maxIssues || 5);
+            return { content: [{ type: "text", text: `Build ${buildId} timeline:\n\n${JSON.stringify(result, null, 2)}` }] };
+        }
+        catch (error) {
+            console.error("Error getting build timeline:", error);
+            return { content: [{ type: "text", text: `Failed to get build timeline: ${error.message}` }] };
+        }
+    });
+    server.tool("get-build-logs", "Get build logs. Without logId, returns list of available logs with line counts. With logId, returns that log's content. NOTE: For verbose logs, consider using a sub-agent to analyze the content.", {
+        project: z.string().describe("The project name"),
+        buildId: z.number().describe("The build ID"),
+        logId: z.number().optional().describe("Optional specific log ID to retrieve content"),
+    }, async ({ project, buildId, logId }) => {
+        try {
+            const service = getAzureDevOpsService();
+            const result = await service.getBuildLogs(project, buildId, logId);
+            return { content: [{ type: "text", text: `Build ${buildId} logs:\n\n${JSON.stringify(result, null, 2)}` }] };
+        }
+        catch (error) {
+            console.error("Error getting build logs:", error);
+            return { content: [{ type: "text", text: `Failed to get build logs: ${error.message}` }] };
+        }
+    });
+    // ========================================
     // WORK ITEM SYNC TOOLS (Local Markdown)
     // ========================================
-    server.tool("sync-work-item-to-file", "Download work item(s) from ADO and save as local markdown file(s). Token-efficient for editing. Requires markdown format fields (not HTML). Can also pull all child work items under a parent (e.g., all User Stories under a Feature).", {
+    server.tool("sync-work-item-to-file", descWithExamples("Download work item(s) from ADO and save as local markdown file(s). Token-efficient for editing. Auto-converts HTML fields to markdown. Can also pull all child work items under a parent (e.g., all User Stories under a Feature).", SYNC_TO_FILE_EXAMPLES), {
         project: z.string().describe("The project name"),
         workItemIds: z.array(z.number()).default([]).describe("Work item IDs to pull (optional if using parentId)"),
         parentId: z.number().optional().describe("Pull all child work items of this parent (e.g., Feature ID to pull all User Stories)"),
-        childType: z.string().optional().describe("Filter by work item type when using parentId (default: 'User Story')"),
+        childType: z.string().optional().describe("Filter by work item type when using parentId (default: 'User Story'). Common values: 'User Story', 'Bug', 'Task'"),
         folder: z.string().optional().describe("Override folder path (default: docs/user-stories or AZUREDEVOPS_SYNC_FOLDER)"),
         includeComments: z.boolean().optional().describe("Also save comments to {id}-comments.md (default: false)"),
-    }, async ({ project, workItemIds: providedWorkItemIds, parentId, childType, folder, includeComments }) => {
+        skipAutoConvert: z.boolean().optional().describe("Skip automatic HTML-to-markdown conversion. Only use when explicitly requested. Default: false (auto-convert enabled)"),
+    }, async ({ project, workItemIds: providedWorkItemIds, parentId, childType, folder, includeComments, skipAutoConvert }) => {
         try {
             const service = getAzureDevOpsService();
             const syncConfig = getSyncConfig(folder);
@@ -993,21 +1079,44 @@ export function registerAzureDevOpsTools(server, azuredevopsService) {
             for (const workItemId of workItemIds) {
                 try {
                     // Fetch work item from ADO
-                    const workItem = await service.getWorkItem(project, workItemId);
-                    const revision = workItem.rev || workItem._rev || 1;
+                    let workItem = await service.getWorkItem(project, workItemId);
+                    let revision = workItem.rev || workItem._rev || 1;
+                    let convertedFields = [];
                     // Check field formats
                     const formats = checkFieldFormats(workItem);
                     if (!formats.ready) {
-                        const htmlFields = [];
+                        if (skipAutoConvert) {
+                            // User explicitly requested to skip conversion
+                            const htmlFields = [];
+                            if (formats.description === 'html')
+                                htmlFields.push('Description');
+                            if (formats.acceptanceCriteria === 'html')
+                                htmlFields.push('Acceptance Criteria');
+                            skipped.push({
+                                id: workItemId,
+                                reason: `HTML fields: ${htmlFields.join(', ')}. skipAutoConvert=true, skipping.`,
+                            });
+                            continue;
+                        }
+                        // Auto-convert HTML fields to markdown in ADO
+                        const fieldsToConvert = [];
                         if (formats.description === 'html')
-                            htmlFields.push('Description');
+                            fieldsToConvert.push('System.Description');
                         if (formats.acceptanceCriteria === 'html')
-                            htmlFields.push('Acceptance Criteria');
-                        skipped.push({
-                            id: workItemId,
-                            reason: `HTML fields: ${htmlFields.join(', ')}. Convert to markdown in ADO first.`,
-                        });
-                        continue;
+                            fieldsToConvert.push('Microsoft.VSTS.Common.AcceptanceCriteria');
+                        try {
+                            convertedFields = await autoConvertFieldsToMarkdown(service, project, workItemId, workItem.fields, fieldsToConvert);
+                            // Re-fetch work item with converted content
+                            workItem = await service.getWorkItem(project, workItemId);
+                            revision = workItem.rev || workItem._rev || 1;
+                        }
+                        catch (convertError) {
+                            skipped.push({
+                                id: workItemId,
+                                reason: `Failed to auto-convert HTML: ${convertError.message}`,
+                            });
+                            continue;
+                        }
                     }
                     // Convert to markdown and save
                     const { content: markdown, skippedFields: secondarySkipped } = workItemToMarkdown(workItem, revision);
@@ -1017,6 +1126,7 @@ export function registerAzureDevOpsTools(server, azuredevopsService) {
                         id: workItemId,
                         file: filePath,
                         revision,
+                        ...(convertedFields.length > 0 ? { converted: convertedFields } : {}),
                         ...(secondarySkipped.length > 0 ? { skippedFields: secondarySkipped } : {}),
                     });
                     filesToCommit.push({ filePath, workItemId });
@@ -1068,11 +1178,12 @@ export function registerAzureDevOpsTools(server, azuredevopsService) {
             };
         }
     });
-    server.tool("sync-work-item-from-file", "Upload local markdown changes back to ADO. Auto-detects new_*.md files and creates them as new work items. Requires AZUREDEVOPS_ENABLE_WORK_ITEM_WRITE=true.", {
+    server.tool("sync-work-item-from-file", descWithExamples("Upload local markdown changes back to ADO. Auto-detects new_*.md files and creates them as new work items. Auto-converts HTML fields to markdown. Requires AZUREDEVOPS_ENABLE_WORK_ITEM_WRITE=true.", SYNC_FROM_FILE_EXAMPLES), {
         project: z.string().describe("The project name"),
         workItemIds: z.array(z.number()).default([]).describe("Work item IDs to push (optional - new_*.md files are auto-detected)"),
         folder: z.string().optional().describe("Override folder path (default: docs/user-stories or AZUREDEVOPS_SYNC_FOLDER)"),
-    }, async ({ project, workItemIds, folder }) => {
+        skipAutoConvert: z.boolean().optional().describe("Skip automatic HTML-to-markdown conversion. Only use when explicitly requested. Default: false (auto-convert enabled)"),
+    }, async ({ project, workItemIds, folder, skipAutoConvert }) => {
         try {
             const service = getAzureDevOpsService();
             const syncConfig = getSyncConfig(folder);
@@ -1138,8 +1249,8 @@ export function registerAzureDevOpsTools(server, azuredevopsService) {
                     const oldRevision = parsed.frontmatter.lastSyncedRevision;
                     // Fetch current work item from ADO to compare
                     const currentWorkItem = await service.getWorkItem(project, workItemId);
-                    // Build patch operations
-                    const { operations, skippedFields } = buildPatchOperations(parsed, currentWorkItem);
+                    // Build patch operations (auto-converts HTML fields unless skipAutoConvert)
+                    const { operations, skippedFields, convertedFields } = buildPatchOperations(parsed, currentWorkItem, skipAutoConvert);
                     if (operations.length === 0 && skippedFields.length === 0) {
                         // No changes
                         pushed.push({
@@ -1156,7 +1267,10 @@ export function registerAzureDevOpsTools(server, azuredevopsService) {
                     if (operations.length > 0) {
                         const updatedWorkItem = await service.updateWorkItem(project, workItemId, operations);
                         newRevision = updatedWorkItem.rev || updatedWorkItem._rev || oldRevision + 1;
-                        fieldsUpdated = operations.map(op => op.path.replace('/fields/', ''));
+                        // Filter out format operations from fieldsUpdated
+                        fieldsUpdated = operations
+                            .filter(op => op.path.startsWith('/fields/'))
+                            .map(op => op.path.replace('/fields/', ''));
                         // Update local file with new revision
                         const content = await readFileContent(filePath);
                         const updatedContent = updateSyncRevision(content, newRevision);
@@ -1169,6 +1283,7 @@ export function registerAzureDevOpsTools(server, azuredevopsService) {
                             newRevision,
                             fieldsUpdated,
                             skippedFields,
+                            ...(convertedFields.length > 0 ? { convertedFields } : {}),
                         });
                     }
                     else {
@@ -1177,6 +1292,7 @@ export function registerAzureDevOpsTools(server, azuredevopsService) {
                             oldRevision,
                             newRevision,
                             fieldsUpdated,
+                            ...(convertedFields.length > 0 ? { convertedFields } : {}),
                         });
                     }
                 }
@@ -1265,7 +1381,10 @@ export function registerAzureDevOpsTools(server, azuredevopsService) {
                     ready: readyCount,
                     needsConversion: needsConversionCount,
                 },
-                conversionInstructions: needsConversionCount > 0 ? getConversionInstructions() : undefined,
+                autoConvertAvailable: true,
+                message: needsConversionCount === 0
+                    ? 'All work items are markdown format - ready to sync'
+                    : `${needsConversionCount} work item(s) have HTML fields. Will be auto-converted to markdown on sync (unless skipAutoConvert=true).`,
             };
             return {
                 content: [{
@@ -1365,11 +1484,12 @@ export function registerAzureDevOpsTools(server, azuredevopsService) {
     // ========================================
     // TASK SYNC TOOLS
     // ========================================
-    server.tool("sync-tasks-to-file", "Download all tasks under a parent work item (User Story) to a local markdown file. Supports pulling tasks for multiple parents at once.", {
+    server.tool("sync-tasks-to-file", descWithExamples("Download all tasks under a parent work item (User Story) to a local markdown file. Auto-converts HTML descriptions to markdown. Supports pulling tasks for multiple parents at once.", SYNC_TASKS_TO_FILE_EXAMPLES), {
         project: z.string().describe("The project name"),
         parentIds: z.array(z.number()).describe("Parent work item IDs (User Stories) to fetch tasks for"),
         folder: z.string().optional().describe("Override folder path (default: docs/user-stories or AZUREDEVOPS_SYNC_FOLDER)"),
-    }, async ({ project, parentIds, folder }) => {
+        skipAutoConvert: z.boolean().optional().describe("Skip automatic HTML-to-markdown conversion for task descriptions. Only use when explicitly requested. Default: false"),
+    }, async ({ project, parentIds, folder, skipAutoConvert }) => {
         try {
             const service = getAzureDevOpsService();
             const syncConfig = getSyncConfig(folder);
@@ -1386,12 +1506,26 @@ export function registerAzureDevOpsTools(server, azuredevopsService) {
                     // Query for child tasks using WIQL
                     const wiql = `SELECT [System.Id] FROM WorkItems WHERE [System.Parent] = ${parentId} AND [System.WorkItemType] = 'Task' ORDER BY [System.Id] ASC`;
                     const queryResult = await service.queryWorkItems(project, wiql, 200);
-                    // Fetch full details for each task
+                    // Fetch full details for each task and auto-convert HTML descriptions
                     const tasks = [];
+                    let tasksConverted = 0;
                     if (queryResult.workItems && queryResult.workItems.length > 0) {
                         for (const wi of queryResult.workItems) {
                             try {
-                                const task = await service.getWorkItem(project, wi.id);
+                                let task = await service.getWorkItem(project, wi.id);
+                                // Auto-convert HTML description to markdown unless skipAutoConvert
+                                const description = task.fields?.['System.Description'];
+                                if (description && !skipAutoConvert && isHtmlContent(description)) {
+                                    try {
+                                        await autoConvertFieldsToMarkdown(service, project, wi.id, task.fields, ['System.Description']);
+                                        // Re-fetch with converted content
+                                        task = await service.getWorkItem(project, wi.id);
+                                        tasksConverted++;
+                                    }
+                                    catch (convertError) {
+                                        console.error(`Failed to convert HTML description for task ${wi.id}:`, convertError.message);
+                                    }
+                                }
                                 tasks.push(task);
                             }
                             catch (taskError) {
@@ -1443,11 +1577,12 @@ export function registerAzureDevOpsTools(server, azuredevopsService) {
             };
         }
     });
-    server.tool("sync-tasks-from-file", "Push local task changes back to ADO with upsert semantics. Existing tasks (## Task #ID) are updated, new tasks (## NEW TASK) are created. Requires AZUREDEVOPS_ENABLE_WORK_ITEM_WRITE=true.", {
+    server.tool("sync-tasks-from-file", descWithExamples("Push local task changes back to ADO with upsert semantics. Existing tasks (## Task #ID) are updated, new tasks (## NEW TASK) are created. Auto-converts HTML fields to markdown. Requires AZUREDEVOPS_ENABLE_WORK_ITEM_WRITE=true.", SYNC_TASKS_FROM_FILE_EXAMPLES), {
         project: z.string().describe("The project name"),
         parentIds: z.array(z.number()).describe("Parent work item IDs to sync tasks for"),
         folder: z.string().optional().describe("Override folder path (default: docs/user-stories or AZUREDEVOPS_SYNC_FOLDER)"),
-    }, async ({ project, parentIds, folder }) => {
+        skipAutoConvert: z.boolean().optional().describe("Skip automatic HTML-to-markdown conversion for task descriptions. Only use when explicitly requested. Default: false"),
+    }, async ({ project, parentIds, folder, skipAutoConvert }) => {
         try {
             const service = getAzureDevOpsService();
             const syncConfig = getSyncConfig(folder);
@@ -1477,15 +1612,16 @@ export function registerAzureDevOpsTools(server, azuredevopsService) {
                     for (const task of parsed.tasks) {
                         try {
                             if (task.id !== null) {
-                                // Existing task - update
+                                // Existing task - update (auto-converts HTML fields unless skipAutoConvert)
                                 const currentTask = await service.getWorkItem(project, task.id);
-                                const { operations, fieldsUpdated } = buildTaskPatchOperations(task, currentTask);
+                                const { operations, fieldsUpdated, convertedFields } = buildTaskPatchOperations(task, currentTask, skipAutoConvert);
                                 if (operations.length > 0) {
                                     await service.updateWorkItem(project, task.id, operations);
                                     updated.push({
                                         id: task.id,
                                         parentId,
                                         fieldsUpdated,
+                                        ...(convertedFields.length > 0 ? { convertedFields } : {}),
                                     });
                                 }
                                 else {
@@ -1557,9 +1693,18 @@ export function registerAzureDevOpsTools(server, azuredevopsService) {
         }
     });
     // Log registration summary (enablePullRequestWrite already defined above)
-    const syncToolsCount = 4; // Work item sync tools
-    const taskSyncToolsCount = 2; // Task sync tools
-    const baseToolsCount = 21 + syncToolsCount + taskSyncToolsCount; // 15 original + 6 PR read-only + 4 work item sync + 2 task sync
+    // Tool count breakdown:
+    // - Wiki: 6 (get-wikis, search-wiki-pages, get-wiki-page, create-wiki-page, update-wiki-page, str-replace-wiki-page)
+    // - Work Item: 7 (get-work-item, query-work-items, get-work-item-comments, add-work-item-comment, update-work-item, create-work-item, delete-work-item)
+    // - Variable Group: 2 (list-variable-groups, get-variable-group)
+    // - PR Read-only: 6 (list-repositories, list-pull-requests, get-pull-request, get-pull-request-threads, get-pull-request-commits, get-pull-request-changes)
+    // - Build Troubleshooting: 3 (get-build-status, get-build-timeline, get-build-logs)
+    // - Work Item Sync: 5 (sync-work-item-to-file, sync-work-item-from-file, check-work-item-markdown, list-synced-work-items, create-user-story-file)
+    // - Task Sync: 2 (sync-tasks-to-file, sync-tasks-from-file)
+    // - Config: 1 (get-configuration)
+    // Total base: 6 + 7 + 2 + 6 + 3 + 5 + 2 + 1 = 32
+    // + PR Write: 1 (add-pull-request-thread) - conditional
+    const baseToolsCount = 32;
     const prWriteToolsCount = enablePullRequestWrite ? 1 : 0;
     const totalToolsCount = baseToolsCount + prWriteToolsCount;
     console.error(`azure-devops tools registered: ${totalToolsCount} tools (${baseToolsCount} base + ${prWriteToolsCount} PR write), 4 prompts`);