@mcp-consultant-tools/azure-devops 27.0.0-beta.1 → 27.0.0-beta.11

package/build/tool-examples.js

@@ -0,0 +1,142 @@
+/**
+ * Tool Use Examples for Azure DevOps MCP Tools
+ *
+ * Provides inline examples embedded in Zod `.describe()` strings to improve
+ * LLM accuracy when calling these tools. Based on Anthropic research showing
+ * 72% → 90% accuracy improvement with examples.
+ */
+/**
+ * Helper function to append examples to a description string.
+ * Formats examples as a bulleted list for easy parsing by LLMs.
+ */
+export function descWithExamples(description, examples) {
+    if (examples.length === 0)
+        return description;
+    const exampleLines = examples
+        .map(ex => `  - ${ex.label}: \`${ex.value}\``)
+        .join('\n');
+    return `${description}\n\nExamples:\n${exampleLines}`;
+}
+// ========================================
+// WIQL Query Examples
+// ========================================
+export const WIQL_EXAMPLES = [
+    {
+        label: "Active bugs",
+        value: "SELECT [System.Id], [System.Title] FROM WorkItems WHERE [System.WorkItemType] = 'Bug' AND [System.State] = 'Active'"
+    },
+    {
+        label: "My assigned items",
+        value: "SELECT [System.Id] FROM WorkItems WHERE [System.AssignedTo] = @Me ORDER BY [System.ChangedDate] DESC"
+    },
+    {
+        label: "Children of parent",
+        value: "SELECT [System.Id] FROM WorkItems WHERE [System.Parent] = 12345"
+    },
+];
+// ========================================
+// JSON Patch Operation Examples
+// ========================================
+export const PATCH_OP_EXAMPLES = [
+    {
+        label: "Update state",
+        value: '{ "op": "replace", "path": "/fields/System.State", "value": "Active" }'
+    },
+    {
+        label: "Set description",
+        value: '{ "op": "add", "path": "/fields/System.Description", "value": "Content here" }'
+    },
+    {
+        label: "Clear assignee",
+        value: '{ "op": "remove", "path": "/fields/System.AssignedTo" }'
+    },
+];
+// ========================================
+// Work Item Field Examples
+// ========================================
+export const WORK_ITEM_FIELD_EXAMPLES = [
+    {
+        label: "Bug with details",
+        value: '{"System.Title": "Login fails on mobile", "System.Description": "Steps to reproduce...", "Microsoft.VSTS.TCM.ReproSteps": "1. Open app..."}'
+    },
+    {
+        label: "User Story",
+        value: '{"System.Title": "As a user, I want to...", "Microsoft.VSTS.Common.AcceptanceCriteria": "Given... When... Then..."}'
+    },
+    {
+        label: "Task",
+        value: '{"System.Title": "Implement API endpoint", "System.Description": "Details...", "Microsoft.VSTS.Scheduling.OriginalEstimate": 4}'
+    },
+];
+// ========================================
+// Sync Mode Examples
+// ========================================
+export const SYNC_TO_FILE_EXAMPLES = [
+    {
+        label: "Pull single work item",
+        value: 'workItemIds: [1044]'
+    },
+    {
+        label: "Pull multiple work items",
+        value: 'workItemIds: [1044, 1045, 1046]'
+    },
+    {
+        label: "Pull all User Stories under Feature",
+        value: 'parentId: 12345'
+    },
+    {
+        label: "Pull all Bugs under Feature",
+        value: 'parentId: 12345, childType: "Bug"'
+    },
+];
+export const SYNC_FROM_FILE_EXAMPLES = [
+    {
+        label: "Push specific work items",
+        value: 'workItemIds: [1044, 1045]'
+    },
+    {
+        label: "Auto-create new work items",
+        value: 'project: "MyProject" (auto-detects new_*.md files)'
+    },
+];
+export const SYNC_TASKS_TO_FILE_EXAMPLES = [
+    {
+        label: "Pull tasks for single User Story",
+        value: 'parentIds: [70824]'
+    },
+    {
+        label: "Pull tasks for multiple User Stories",
+        value: 'parentIds: [70824, 70825, 70826]'
+    },
+];
+export const SYNC_TASKS_FROM_FILE_EXAMPLES = [
+    {
+        label: "Push tasks for single parent",
+        value: 'parentIds: [70824]'
+    },
+    {
+        label: "Push tasks for multiple parents",
+        value: 'parentIds: [70824, 70825]'
+    },
+];
+// ========================================
+// Pull Request Write Examples
+// ========================================
+export const PR_BRANCH_REF_EXAMPLES = [
+    { label: "Feature branch", value: "refs/heads/feature/my-feature" },
+    { label: "Main branch", value: "refs/heads/main" },
+    { label: "Release branch", value: "refs/heads/release/2.0" },
+];
+export const PR_MERGE_STRATEGY_EXAMPLES = [
+    { label: "Squash (default)", value: "squash" },
+    { label: "No fast-forward merge commit", value: "noFastForward" },
+    { label: "Rebase", value: "rebase" },
+    { label: "Rebase merge", value: "rebaseMerge" },
+];
+export const PR_VOTE_EXAMPLES = [
+    { label: "Approve", value: "approve" },
+    { label: "Approve with suggestions", value: "approveWithSuggestions" },
+    { label: "Wait for author", value: "waitForAuthor" },
+    { label: "Reject", value: "reject" },
+];
+//# sourceMappingURL=tool-examples.js.map

package/build/tool-examples.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-consultant-tools/azure-devops",
-  "version": "27.0.0-beta.1",
+  "version": "27.0.0-beta.11",
   "description": "MCP server for Azure DevOps integration - wikis, work items, pull requests, and variable group read access",
   "type": "module",
   "main": "./build/index.js",
@@ -45,10 +45,12 @@
     "@modelcontextprotocol/sdk": "^1.0.4",
     "axios": "^1.8.3",
     "marked": "^17.0.1",
+    "turndown": "^7.2.2",
     "zod": "^3.24.1"
   },
   "devDependencies": {
     "@types/node": "^22.10.5",
+    "@types/turndown": "^5.0.6",
     "typescript": "^5.8.2"
   },
   "bin": {