@mcp-consultant-tools/azure-devops 27.0.0 → 28.0.0-beta.10

package/build/tools/wiki-tools.js

@@ -0,0 +1,151 @@
+/**
+ * Wiki Tools - 9 tools for wiki operations
+ */
+import { z } from 'zod';
+import { descWithExamples, ATTACHMENT_PATH_EXAMPLES } from '../tool-examples.js';
+export function registerWikiTools(server, ctx) {
+    server.tool("get-wikis", "Get all wikis in an Azure DevOps project", {
+        project: z.string().describe("The project name"),
+    }, async ({ project }) => {
+        try {
+            const result = await ctx.wiki.getWikis(project);
+            return { content: [{ type: "text", text: `Wikis in project '${project}':\n\n${JSON.stringify(result, null, 2)}` }] };
+        }
+        catch (error) {
+            console.error("Error getting wikis:", error);
+            return { content: [{ type: "text", text: `Failed to get wikis: ${error.message}` }] };
+        }
+    });
+    server.tool("search-wiki-pages", "Search wiki pages across Azure DevOps projects", {
+        searchText: z.string().describe("The text to search for"),
+        project: z.string().optional().describe("Optional project filter"),
+        maxResults: z.number().optional().describe("Maximum number of results (default: 25)"),
+    }, async ({ searchText, project, maxResults }) => {
+        try {
+            const result = await ctx.wiki.searchWikiPages(searchText, project, maxResults);
+            return { content: [{ type: "text", text: `Wiki search results for '${searchText}':\n\n${JSON.stringify(result, null, 2)}` }] };
+        }
+        catch (error) {
+            console.error("Error searching wiki pages:", error);
+            return { content: [{ type: "text", text: `Failed to search wiki pages: ${error.message}` }] };
+        }
+    });
+    server.tool("get-wiki-page", "Get a specific wiki page with content from Azure DevOps", {
+        project: z.string().describe("The project name"),
+        wikiId: z.string().describe("The wiki identifier (ID or name)"),
+        pagePath: z.string().describe("The path to the page (e.g., '/Setup/Authentication')"),
+        includeContent: z.boolean().optional().describe("Include page content (default: true)"),
+    }, async ({ project, wikiId, pagePath, includeContent }) => {
+        try {
+            const result = await ctx.wiki.getWikiPage(project, wikiId, pagePath, includeContent ?? true);
+            return { content: [{ type: "text", text: `Wiki page '${pagePath}':\n\n${JSON.stringify(result, null, 2)}` }] };
+        }
+        catch (error) {
+            console.error("Error getting wiki page:", error);
+            return { content: [{ type: "text", text: `Failed to get wiki page: ${error.message}` }] };
+        }
+    });
+    server.tool("create-wiki-page", "Create a new wiki page in Azure DevOps (requires AZUREDEVOPS_ENABLE_WIKI_WRITE=true)", {
+        project: z.string().describe("The project name"),
+        wikiId: z.string().describe("The wiki identifier"),
+        pagePath: z.string().describe("The path for the new page (e.g., '/Setup/NewGuide')"),
+        content: z.string().describe("The markdown content for the page"),
+    }, async ({ project, wikiId, pagePath, content }) => {
+        try {
+            const result = await ctx.wiki.createWikiPage(project, wikiId, pagePath, content);
+            return { content: [{ type: "text", text: `Created wiki page '${pagePath}':\n\n${JSON.stringify(result, null, 2)}` }] };
+        }
+        catch (error) {
+            console.error("Error creating wiki page:", error);
+            return { content: [{ type: "text", text: `Failed to create wiki page: ${error.message}` }] };
+        }
+    });
+    server.tool("update-wiki-page", "Update an existing wiki page in Azure DevOps. Version is auto-fetched if not provided, so you can update pages without first calling get-wiki-page. (requires AZUREDEVOPS_ENABLE_WIKI_WRITE=true)", {
+        project: z.string().describe("The project name"),
+        wikiId: z.string().describe("The wiki identifier"),
+        pagePath: z.string().describe("The path to the page"),
+        content: z.string().describe("The updated markdown content"),
+        version: z.string().optional().describe("The ETag/version for optimistic concurrency. If not provided, will be auto-fetched from the current page."),
+    }, async ({ project, wikiId, pagePath, content, version }) => {
+        try {
+            const result = await ctx.wiki.updateWikiPage(project, wikiId, pagePath, content, version);
+            return { content: [{ type: "text", text: `Updated wiki page '${pagePath}':\n\n${JSON.stringify(result, null, 2)}` }] };
+        }
+        catch (error) {
+            console.error("Error updating wiki page:", error);
+            return { content: [{ type: "text", text: `Failed to update wiki page: ${error.message}` }], isError: true };
+        }
+    });
+    server.tool("ado-str-replace-wiki", "Replace a specific string in an Azure DevOps wiki page without rewriting entire content. More efficient than update-wiki-page for small changes. (requires AZUREDEVOPS_ENABLE_WIKI_WRITE=true)", {
+        project: z.string().describe("The project name"),
+        wikiId: z.string().describe("The wiki identifier (ID or name)"),
+        pagePath: z.string().describe("The path to the wiki page (e.g., '/SharePoint-Online/04-DEV-Configuration')"),
+        old_str: z.string().describe("The exact string to replace (must be unique unless replace_all is true)"),
+        new_str: z.string().describe("The replacement string"),
+        replace_all: z.boolean().optional().describe("If true, replace all occurrences. If false (default), old_str must be unique in the page."),
+        description: z.string().optional().describe("Optional description of the change (for audit logging)")
+    }, async ({ project, wikiId, pagePath, old_str, new_str, replace_all, description }) => {
+        try {
+            const result = await ctx.wiki.strReplaceWikiPage(project, wikiId, pagePath, old_str, new_str, replace_all ?? false, description);
+            return {
+                content: [{ type: "text", text: `Successfully replaced "${old_str}" with "${new_str}" in wiki page '${pagePath}' (${result.occurrences} occurrence(s)):\n\n${JSON.stringify(result, null, 2)}\n\nDiff:\n${result.diff}` }],
+            };
+        }
+        catch (error) {
+            console.error("Error replacing text in wiki page:", error);
+            return { content: [{ type: "text", text: `Failed to replace text in wiki page: ${error.message}` }], isError: true };
+        }
+    });
+    server.tool("delete-wiki-page", "Delete a wiki page permanently (requires AZUREDEVOPS_ENABLE_WIKI_DELETE=true). WARNING: This permanently deletes the page and all sub-pages.", {
+        project: z.string().describe("The project name"),
+        wikiId: z.string().describe("The wiki identifier"),
+        pagePath: z.string().describe("Page path (e.g., '/Setup/Old-Page')"),
+    }, async ({ project, wikiId, pagePath }) => {
+        try {
+            const result = await ctx.wiki.deleteWikiPage(project, wikiId, pagePath);
+            return { content: [{ type: "text", text: `Deleted wiki page:\n\n${JSON.stringify(result, null, 2)}` }] };
+        }
+        catch (error) {
+            console.error("Error deleting wiki page:", error);
+            return { content: [{ type: "text", text: `Failed to delete wiki page: ${error.message}` }] };
+        }
+    });
+    server.tool("download-wiki-attachment", "Download a single wiki attachment/image from Azure DevOps wiki to disk. Uses the wiki's backing git repository to retrieve binary files. Claude can then Read the downloaded image for multimodal analysis.", {
+        project: z.string().describe("The project name"),
+        wikiId: z.string().describe("The wiki identifier (ID or name)"),
+        attachmentPath: z.string().describe(descWithExamples("The attachment path as it appears in wiki markdown (e.g., from /.attachments/ references)", ATTACHMENT_PATH_EXAMPLES)),
+        outputDir: z.string().optional().describe("Directory to save the file. Default: OS temp dir"),
+    }, async ({ project, wikiId, attachmentPath, outputDir }) => {
+        try {
+            const result = await ctx.wiki.downloadWikiAttachment(project, wikiId, attachmentPath, outputDir);
+            return {
+                content: [{ type: "text", text: `Downloaded wiki attachment:\n\n${JSON.stringify(result, null, 2)}\n\nUse the Read tool on '${result.filePath}' to view the image.` }],
+            };
+        }
+        catch (error) {
+            console.error("Error downloading wiki attachment:", error);
+            return { content: [{ type: "text", text: `Failed to download wiki attachment: ${error.message}` }] };
+        }
+    });
+    server.tool("download-wiki-page-attachments", "Download all image/file attachments referenced in a wiki page. Extracts ![...](/.attachments/...) references from page content and downloads each file to disk. Returns file paths for Claude to Read and interpret images.", {
+        project: z.string().describe("The project name"),
+        wikiId: z.string().describe("The wiki identifier (ID or name)"),
+        pagePath: z.string().describe("The wiki page path (e.g., '/Setup/Authentication')"),
+        outputDir: z.string().optional().describe("Directory to save files. Default: OS temp dir"),
+    }, async ({ project, wikiId, pagePath, outputDir }) => {
+        try {
+            const result = await ctx.wiki.downloadWikiPageAttachments(project, wikiId, pagePath, outputDir);
+            if (result.totalFound === 0) {
+                return { content: [{ type: "text", text: `No attachments found in wiki page '${pagePath}'.` }] };
+            }
+            return {
+                content: [{ type: "text", text: `Downloaded ${result.downloaded}/${result.totalFound} attachments from '${pagePath}':\n\n${JSON.stringify(result, null, 2)}\n\nUse the Read tool on each filePath to view the images.` }],
+            };
+        }
+        catch (error) {
+            console.error("Error downloading wiki page attachments:", error);
+            return { content: [{ type: "text", text: `Failed to download wiki page attachments: ${error.message}` }] };
+        }
+    });
+}
+//# sourceMappingURL=wiki-tools.js.map

package/build/tools/wiki-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-tools.js","sourceRoot":"","sources":["../../src/tools/wiki-tools.ts"],"names":[],"mappings":"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"}

package/build/tools/work-item-tools.d.ts

@@ -0,0 +1,3 @@
+import type { ServiceContext } from '../types.js';
+export declare function registerWorkItemTools(server: any, ctx: ServiceContext): void;
+//# sourceMappingURL=work-item-tools.d.ts.map

package/build/tools/work-item-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-item-tools.d.ts","sourceRoot":"","sources":["../../src/tools/work-item-tools.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CA6Q5E"}

package/build/tools/work-item-tools.js

@@ -0,0 +1,188 @@
+/**
+ * Work Item Tools - 10 tools for work item operations
+ */
+import { z } from 'zod';
+import { descWithExamples, WIQL_EXAMPLES, PATCH_OP_EXAMPLES, WORK_ITEM_FIELD_EXAMPLES } from '../tool-examples.js';
+import { getAllLargeTextFields } from '../sync/html-detection.js';
+export function registerWorkItemTools(server, ctx) {
+    server.tool("get-work-item", "Get a work item by ID with full details from Azure DevOps", {
+        project: z.string().describe("The project name"),
+        workItemId: z.number().describe("The work item ID"),
+    }, async ({ project, workItemId }) => {
+        try {
+            const result = await ctx.workItem.getWorkItem(project, workItemId);
+            return { content: [{ type: "text", text: `Work item ${workItemId}:\n\n${JSON.stringify(result, null, 2)}` }] };
+        }
+        catch (error) {
+            console.error("Error getting work item:", error);
+            return { content: [{ type: "text", text: `Failed to get work item: ${error.message}` }] };
+        }
+    });
+    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(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 {
+            const result = await ctx.workItem.queryWorkItems(project, wiql, maxResults);
+            return { content: [{ type: "text", text: `Work items query results:\n\n${JSON.stringify(result, null, 2)}` }] };
+        }
+        catch (error) {
+            console.error("Error querying work items:", error);
+            return { content: [{ type: "text", text: `Failed to query work items: ${error.message}` }] };
+        }
+    });
+    server.tool("run-saved-query", "Execute a saved Azure DevOps query by its query ID (GUID). Returns a compact summary by default (ID, Title, Assigned To, State, Severity, Priority, Tags, Story Points, Resolved Reason). Use detail='full' for all fields.", {
+        project: z.string().describe("The project name"),
+        queryId: z.string().describe(descWithExamples("The saved query GUID. Found in ADO query URLs: https://dev.azure.com/{org}/{project}/_queries/query/{queryId}/", [{ label: "From URL", value: "f8c22439-f72d-4018-b863-a52396b26c4b" }])),
+        maxResults: z.number().optional().describe("Maximum number of results (default: 50)"),
+        detail: z.enum(['summary', 'full']).optional().describe("Level of detail: 'summary' (default) returns key fields only, 'full' returns all fields expanded"),
+        fields: z.array(z.string()).optional().describe(descWithExamples("Custom list of ADO field reference names to return. Overrides the default summary fields.", [{ label: "Effort and state", value: '["System.Title", "System.State", "Microsoft.VSTS.Scheduling.Effort"]' }])),
+        groupBy: z.string().optional().describe(descWithExamples("Group results by a summary field name and return counts per group.", [
+            { label: "By state", value: "state" },
+            { label: "By assigned to", value: "assignedTo" },
+            { label: "By priority", value: "priority" },
+        ])),
+    }, async ({ project, queryId, maxResults, detail, fields, groupBy }) => {
+        try {
+            const result = await ctx.workItem.runSavedQuery(project, queryId, maxResults, detail, fields, groupBy);
+            return { content: [{ type: "text", text: `Saved query results:\n\n${JSON.stringify(result, null, 2)}` }] };
+        }
+        catch (error) {
+            console.error("Error running saved query:", error);
+            return { content: [{ type: "text", text: `Failed to run saved query: ${error.message}` }] };
+        }
+    });
+    server.tool("get-saved-query", "Get a saved Azure DevOps query's metadata and WIQL text without executing it. Useful for inspecting or modifying a query before running it.", {
+        project: z.string().describe("The project name"),
+        queryId: z.string().describe("The saved query GUID"),
+    }, async ({ project, queryId }) => {
+        try {
+            const result = await ctx.workItem.getSavedQuery(project, queryId);
+            return { content: [{ type: "text", text: `Saved query details:\n\n${JSON.stringify(result, null, 2)}` }] };
+        }
+        catch (error) {
+            console.error("Error getting saved query:", error);
+            return { content: [{ type: "text", text: `Failed to get saved query: ${error.message}` }] };
+        }
+    });
+    server.tool("get-work-item-comments", "Get comments/discussion for a work item in Azure DevOps", {
+        project: z.string().describe("The project name"),
+        workItemId: z.number().describe("The work item ID"),
+    }, async ({ project, workItemId }) => {
+        try {
+            const result = await ctx.workItem.getWorkItemComments(project, workItemId);
+            return { content: [{ type: "text", text: `Comments for work item ${workItemId}:\n\n${JSON.stringify(result, null, 2)}` }] };
+        }
+        catch (error) {
+            console.error("Error getting work item comments:", error);
+            return { content: [{ type: "text", text: `Failed to get work item comments: ${error.message}` }] };
+        }
+    });
+    server.tool("add-work-item-comment", "Add a comment to a work item in Azure DevOps (requires AZUREDEVOPS_ENABLE_WORK_ITEM_WRITE=true). By default, comments are sent as Markdown. For orgs without Markdown preview, set AZUREDEVOPS_COMMENT_FORMAT=html to auto-convert Markdown to HTML.", {
+        project: z.string().describe("The project name"),
+        workItemId: z.number().describe("The work item ID"),
+        commentText: z.string().describe("The comment text in Markdown format. Use standard Markdown syntax: **bold**, *italic*, `code`, - lists, [links](url), etc. Will be auto-converted to HTML if AZUREDEVOPS_COMMENT_FORMAT=html is set."),
+    }, async ({ project, workItemId, commentText }) => {
+        try {
+            const result = await ctx.workItem.addWorkItemComment(project, workItemId, commentText);
+            return { content: [{ type: "text", text: `Added comment to work item ${workItemId}:\n\n${JSON.stringify(result, null, 2)}` }] };
+        }
+        catch (error) {
+            console.error("Error adding work item comment:", error);
+            return { content: [{ type: "text", text: `Failed to add work item comment: ${error.message}` }] };
+        }
+    });
+    server.tool("update-work-item-comment", "Update an existing comment on a work item in Azure DevOps (requires AZUREDEVOPS_ENABLE_WORK_ITEM_WRITE=true). By default, comments are sent as Markdown. For orgs without Markdown preview, set AZUREDEVOPS_COMMENT_FORMAT=html to auto-convert Markdown to HTML.", {
+        project: z.string().describe("The project name"),
+        workItemId: z.number().describe("The work item ID"),
+        commentId: z.number().describe("The comment ID to update. Get comment IDs from get-work-item-comments."),
+        commentText: z.string().describe("The updated comment text in Markdown format. Use standard Markdown syntax: **bold**, *italic*, `code`, - lists, [links](url), etc. Will be auto-converted to HTML if AZUREDEVOPS_COMMENT_FORMAT=html is set."),
+    }, async ({ project, workItemId, commentId, commentText }) => {
+        try {
+            const result = await ctx.workItem.updateWorkItemComment(project, workItemId, commentId, commentText);
+            return { content: [{ type: "text", text: `Updated comment ${commentId} on work item ${workItemId}:\n\n${JSON.stringify(result, null, 2)}` }] };
+        }
+        catch (error) {
+            console.error("Error updating work item comment:", error);
+            return { content: [{ type: "text", text: `Failed to update work item comment: ${error.message}` }] };
+        }
+    });
+    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: '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(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 {
+            let finalOperations = [...patchOperations];
+            const formatOpsAdded = [];
+            if (!skipAutoConvert) {
+                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) {
+                    const hasFormatOp = finalOperations.some((op) => op.path === `/multilineFieldsFormat/${field}`);
+                    if (!hasFormatOp) {
+                        finalOperations.push({
+                            op: 'add',
+                            path: `/multilineFieldsFormat/${field}`,
+                            value: 'Markdown'
+                        });
+                        formatOpsAdded.push(field);
+                    }
+                }
+            }
+            const result = await ctx.workItem.updateWorkItem(project, workItemId, finalOperations);
+            let message = `Updated work item ${workItemId}`;
+            if (formatOpsAdded.length > 0) {
+                message += ` (auto-set markdown format for: ${formatOpsAdded.join(', ')})`;
+            }
+            return { content: [{ type: "text", text: `${message}:\n\n${JSON.stringify(result, null, 2)}` }] };
+        }
+        catch (error) {
+            console.error("Error updating work item:", error);
+            return { content: [{ type: "text", text: `Failed to update work item: ${error.message}` }] };
+        }
+    });
+    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: '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)"),
+            url: z.string().describe("URL to related work item (e.g., 'https://dev.azure.com/org/project/_apis/wit/workItems/123')"),
+            attributes: z.record(z.any()).optional().describe("Optional relation attributes")
+        })).optional().describe("Optional array of work item relationships. Use parentId for simple parent-child relationships.")
+    }, async ({ project, workItemType, fields, parentId, relations }) => {
+        try {
+            const result = await ctx.workItem.createWorkItem(project, workItemType, fields, parentId, relations);
+            return { content: [{ type: "text", text: `Created work item:\n\n${JSON.stringify(result, null, 2)}` }] };
+        }
+        catch (error) {
+            console.error("Error creating work item:", error);
+            return { content: [{ type: "text", text: `Failed to create work item: ${error.message}` }] };
+        }
+    });
+    server.tool("delete-work-item", "Delete a work item in Azure DevOps (requires AZUREDEVOPS_ENABLE_WORK_ITEM_DELETE=true)", {
+        project: z.string().describe("The project name"),
+        workItemId: z.number().describe("The work item ID"),
+    }, async ({ project, workItemId }) => {
+        try {
+            const result = await ctx.workItem.deleteWorkItem(project, workItemId);
+            return { content: [{ type: "text", text: `Deleted work item ${workItemId}:\n\n${JSON.stringify(result, null, 2)}` }] };
+        }
+        catch (error) {
+            console.error("Error deleting work item:", error);
+            return { content: [{ type: "text", text: `Failed to delete work item: ${error.message}` }] };
+        }
+    });
+}
+//# sourceMappingURL=work-item-tools.js.map

package/build/tools/work-item-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-item-tools.js","sourceRoot":"","sources":["../../src/tools/work-item-tools.ts"],"names":[],"mappings":"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"}

package/build/types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Service context shared between MCP server and CLI entry points.
+ * Uses lazy getters to initialize services on-demand.
+ */
+import type { AzureDevOpsClient } from './azure-devops-client.js';
+import type { WikiService } from './services/wiki-service.js';
+import type { WorkItemService } from './services/work-item-service.js';
+import type { PullRequestService } from './services/pull-request-service.js';
+import type { BuildService } from './services/build-service.js';
+import type { VariableGroupService } from './services/variable-group-service.js';
+import type { SyncService } from './services/sync-service.js';
+import type { ConfigurationService } from './services/configuration-service.js';
+export interface ServiceContext {
+    readonly client: AzureDevOpsClient;
+    readonly wiki: WikiService;
+    readonly workItem: WorkItemService;
+    readonly pullRequest: PullRequestService;
+    readonly build: BuildService;
+    readonly variableGroup: VariableGroupService;
+    readonly sync: SyncService;
+    readonly configuration: ConfigurationService;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAEhF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC;IAC7C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC;CAC9C"}

package/build/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-consultant-tools/azure-devops",
-  "version": "27.0.0",
+  "version": "28.0.0-beta.10",
   "description": "MCP server for Azure DevOps integration - wikis, work items, pull requests, and variable group read access",
   "type": "module",
   "main": "./build/index.js",
@@ -41,9 +41,10 @@
     "node": ">=16.0.0"
   },
   "dependencies": {
-    "@mcp-consultant-tools/core": "^1.0.0",
+    "@mcp-consultant-tools/core": "28.0.0-beta.10",
     "@modelcontextprotocol/sdk": "^1.0.4",
     "axios": "^1.8.3",
+    "commander": "^14.0.3",
     "marked": "^17.0.1",
     "turndown": "^7.2.2",
     "zod": "^3.24.1"
@@ -54,6 +55,7 @@
     "typescript": "^5.8.2"
   },
   "bin": {
-    "mcp-ado": "build/index.js"
+    "mcp-ado": "build/index.js",
+    "mcp-ado-cli": "build/cli.js"
   }
 }