feat: Add work item link retrieval and linked work items functionality

- Implement `getWorkItemLinks` method to fetch all links associated with a work item
- Add `getLinkedWorkItems` method to retrieve full details of linked work items
- Introduce new server tools for accessing work item links and linked work items
- Update types to include `WorkItemLink` interface for enhanced type safety
- Enhance error handling for work item link extraction
- Update documentation to reflect new features

Author: Maxim Titovich

src/azure-devops-service.ts

@@ -13,6 +13,8 @@ import {
   PullRequestCommentRequest,
   PullRequestCommentResponse,
   PullRequestFileContent,
+  WorkItemRelation,
+  WorkItemLink,
 } from './types.js';
 
 /**
@@ -297,6 +299,105 @@ class AzureDevOpsService {
     return attachments;
   }
 
+  /**
+   * Get all links associated with a work item (parent, child, related, etc.)
+   * @param workItemId The ID of the work item
+   * @returns Object with work item links grouped by relationship type
+   */
+  async getWorkItemLinks(workItemId: number): Promise<Record<string, WorkItemLink[]>> {
+    await this.initialize();
+
+    if (!this.workItemClient) {
+      throw new Error('Work item client not initialized');
+    }
+
+    // Get work item with relations
+    const workItem = await this.workItemClient.getWorkItem(
+      workItemId,
+      undefined,
+      undefined,
+      4 // 4 = WorkItemExpand.Relations in the SDK
+    );
+
+    if (!workItem || !workItem.relations) {
+      return {};
+    }
+
+    // Filter for work item link relations (exclude attachments and hyperlinks)
+    const linkRelations = workItem.relations.filter(
+      (relation: any) => relation.rel.includes('Link') &&
+        relation.rel !== 'AttachedFile' &&
+        relation.rel !== 'Hyperlink'
+    );
+
+    // Group relations by relationship type
+    const groupedRelations: Record<string, WorkItemLink[]> = {};
+    
+    linkRelations.forEach((relation: any) => {
+      const relType = relation.rel;
+      
+      // Extract work item ID from URL
+      // URL format is typically like: https://dev.azure.com/{org}/{project}/_apis/wit/workItems/{id}
+      let targetId = 0;
+      try {
+        const urlParts = relation.url.split('/');
+        targetId = parseInt(urlParts[urlParts.length - 1], 10);
+      } catch (error) {
+        console.error('Failed to extract work item ID from URL:', relation.url);
+      }
+      
+      if (!groupedRelations[relType]) {
+        groupedRelations[relType] = [];
+      }
+      
+      const workItemLink: WorkItemLink = {
+        ...relation,
+        targetId,
+        title: relation.attributes?.name || `Work Item ${targetId}`
+      };
+      
+      groupedRelations[relType].push(workItemLink);
+    });
+
+    return groupedRelations;
+  }
+
+  /**
+   * Get all linked work items with their full details
+   * @param workItemId The ID of the work item to get links from
+   * @returns Array of work items that are linked to the specified work item
+   */
+  async getLinkedWorkItems(workItemId: number): Promise<WorkItem[]> {
+    await this.initialize();
+
+    if (!this.workItemClient) {
+      throw new Error('Work item client not initialized');
+    }
+
+    // First get all links
+    const linkGroups = await this.getWorkItemLinks(workItemId);
+    
+    // Extract all target IDs from all link groups
+    const linkedIds: number[] = [];
+    
+    Object.values(linkGroups).forEach(links => {
+      links.forEach(link => {
+        if (link.targetId > 0) {
+          linkedIds.push(link.targetId);
+        }
+      });
+    });
+    
+    // If no linked items found, return empty array
+    if (linkedIds.length === 0) {
+      return [];
+    }
+    
+    // Get the full work item details for all linked items
+    const linkedWorkItems = await this.getWorkItems(linkedIds);
+    return linkedWorkItems;
+  }
+
   /**
    * Get detailed changes for a pull request
    */

src/index.ts

@@ -428,6 +428,46 @@ server.tool(
   }
 );
 
+// New tool for work item links
+server.tool(
+  'azure_devops_work_item_links',
+  'Get links for a specific work item',
+  {
+    id: z.number().describe('Work item ID'),
+  },
+  async ({ id }) => {
+    const result = await azureDevOpsService.getWorkItemLinks(id);
+    return {
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify(result, null, 2),
+        },
+      ],
+    };
+  }
+);
+
+// New tool for linked work items with full details
+server.tool(
+  'azure_devops_linked_work_items',
+  'Get all linked work items with their full details',
+  {
+    id: z.number().describe('Work item ID'),
+  },
+  async ({ id }) => {
+    const result = await azureDevOpsService.getLinkedWorkItems(id);
+    return {
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify(result, null, 2),
+        },
+      ],
+    };
+  }
+);
+
 // New tool for pull request changes with file contents
 server.tool(
   'azure_devops_pull_request_changes',
@@ -708,6 +748,10 @@ async function main() {
     console.error('- azure_devops_pull_request_by_id: Get a pull request by ID');
     console.error('- azure_devops_pull_request_threads: Get threads (comments) for a pull request');
     console.error('- azure_devops_work_item_attachments: Get attachments for a work item');
+    console.error('- azure_devops_work_item_links: Get links for a work item');
+    console.error(
+      '- azure_devops_linked_work_items: Get all linked work items with their full details'
+    );
     console.error(
       '- azure_devops_pull_request_changes: Get detailed code changes for a pull request'
     );

src/sse-server.ts

@@ -236,6 +236,46 @@ app.get('/sse', async (req, res) => {
       }
     );
 
+    // New tool for work item links
+    server.tool(
+      'azure_devops_work_item_links',
+      'Get links for a specific work item',
+      {
+        id: z.number().describe('Work item ID'),
+      },
+      async ({ id }) => {
+        const result = await azureDevOpsService.getWorkItemLinks(id);
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(result, null, 2),
+            },
+          ],
+        };
+      }
+    );
+
+    // New tool for linked work items with full details
+    server.tool(
+      'azure_devops_linked_work_items',
+      'Get all linked work items with their full details',
+      {
+        id: z.number().describe('Work item ID'),
+      },
+      async ({ id }) => {
+        const result = await azureDevOpsService.getLinkedWorkItems(id);
+        return {
+          content: [
+            {
+              type: 'text',
+              text: JSON.stringify(result, null, 2),
+            },
+          ],
+        };
+      }
+    );
+
     // New tool for pull request changes with file contents
     server.tool(
       'azure_devops_pull_request_changes',

src/types.ts

@@ -30,6 +30,12 @@ export interface WorkItemRelation {
   attributes?: Record<string, any>;
 }
 
+// Azure DevOps Work Item Link (Extended from WorkItemRelation)
+export interface WorkItemLink extends WorkItemRelation {
+  targetId: number; // The ID of the target work item
+  title?: string;   // Optional title of the target work item
+}
+
 // Azure DevOps Git Repository
 export interface GitRepository {
   id: string;