feat: add create pull request thread tool (#260)

Hey,

i added the **create_pull_request_thread** functionality to initiate a
new comment thread on a pull request.

## GitHub issue number
#231

## **Associated Risks**

/

## ✅ **PR Checklist**

- [x] **I have read the [contribution
guidelines](https://github.com/microsoft/azure-devops-mcp/blob/main/CONTRIBUTING.md)**
- [x] **I have read the [code of conduct
guidelines](https://github.com/microsoft/azure-devops-mcp/blob/main/CODE_OF_CONDUCT.md)**
- [x] Title of the pull request is clear and informative.
- [x] 👌 Code hygiene
- [x] 🔭 Telemetry added, updated, or N/A
- [x] 📄 Documentation added, updated, or N/A
- [x] 🛡️ Automated tests added, or N/A

## 🧪 **How did you test it?**
Model: Claude Sonnet 4
Prompt:
```
## Code Review Expert: Detailed Analysis and Best Practices

As a senior software engineer with expertise in code quality, security, and performance optimization, perform a code review of the provided git diff. 

Focus on delivering actionable feedback in the following areas:

Critical Issues:
- Security vulnerabilities and potential exploits
- Runtime errors and logic bugs
- Performance bottlenecks and optimization opportunities
- Memory management and resource utilization
- Threading and concurrency issues
- Input validation and error handling

Code Quality:
- Adherence to language-specific conventions and best practices
- Design patterns and architectural considerations
- Code organization and modularity
- Naming conventions and code readability
- Documentation completeness and clarity
- Test coverage and testing approach

Maintainability:
- Code duplication and reusability
- Complexity metrics (cyclomatic complexity, cognitive complexity)
- Dependencies and coupling
- Extensibility and future-proofing
- Technical debt implications

Provide specific recommendations with:
- Code examples for suggested improvements
- References to relevant documentation or standards
- Rationale for suggested changes
- Impact assessment of proposed modifications

Format your review using clear sections and bullet points. Include inline code references where applicable.

Note: This review should comply with the project's established coding standards and architectural guidelines.

### Context:
- **DevOps-Project**: z
- **Repository**: y
- **PR number**: x

### Instructions:
1. **Use Azure DevOps integration**:
   - Connect to Azure DevOps via MCP Tools
   - Load PR details, commits and existing comments
   - Analyze the changed files and code diffs

2 **Code standards check against**:
   - Copilot Instructions

3. **Sarcastic review style**:
   - Be precise but biting in criticism
   - Repeat similar issues for multiple files
   - Create separate comment threads for each issue
   - If possible, always link the file in the comment as well as the line and offset

4. **Azure DevOps Actions**:
   - Use `mcp_ado_repo_create_pull_request_thread` for new comments
   - Create specific comment threads with file/line references (for the line and offset: rightFileStartLine, rightFileStartOffset, rightFileEndLine, rightFileEndOffset)
   - Link specific lines of code and offsets
   - Set review priority based on issue severity

5. **Extra information**:
   - Ignore deleted comments
   - Ignore deleted files
   - Always perform a review, even if you think the PR has already been reviewed. Please proceed in such a way that you ignore the old review and start again.
   - PullRequest-Status Enum(NotSet = 0, Active = 1, Abandoned = 2, Completed = 3, All = 4)
   - Only look at the diffs from the PullRequest

6. **Qualtity**:
   1. **Specify filePath** - Full path to the file
   2. **Specify rightFileStartLine** - Start line of the problem
   3. **Specify rightFileEndLine** - End line of the problem
   4. **Specify rightFileStartOffset** - Start offset
   5. **Specify rightFileEndOffset** - End offset

### Expected result:
- Each comment with specific file/line reference
- Sarcastic but constructive tone
- Specific recommendations for improvement
- create new short review comments with specific line references
- Reviewing the diffs between the source branch and target branch
```
<img width="1396" height="851" alt="grafik"
src="https://github.com/user-attachments/assets/8aaec603-b890-4a6c-8d04-399a9cc4da18"
/>

---------

Co-authored-by: Dan Hellem <[email protected]>

Author: PlaySkyHD

README.md

@@ -96,9 +96,10 @@ Interact with these Azure DevOps services:
 - **repo_create_pull_request**: Create a new pull request.
 - **repo_update_pull_request_status**: Update the status of an existing pull request to active or abandoned.
 - **repo_update_pull_request_reviewers**: Add or remove reviewers for an existing pull request.
-- **repo_reply_to_comment**: Reply to a specific comment on a pull request.
-- **repo_resolve_comment**: Resolve a specific comment thread on a pull request.
-- **repo_search_commits**: Search for commits.
+- **repo_reply_to_comment**: Replies to a specific comment on a pull request.
+- **repo_resolve_comment**: Resolves a specific comment thread on a pull request.
+- **repo_search_commits**: Searches for commits.
+- **repo_create_pull_request_thread**: Creates a new comment thread on a pull request.
 
 ### 🛰️ Builds
 

src/tools/repos.ts

@@ -13,6 +13,7 @@ import {
   GitPullRequestQuery,
   GitPullRequestQueryInput,
   GitPullRequestQueryType,
+  CommentThreadContext,
 } from "azure-devops-node-api/interfaces/GitInterfaces.js";
 import { z } from "zod";
 import { getCurrentUserDetails } from "./auth.js";
@@ -34,6 +35,7 @@ const REPO_TOOLS = {
   update_pull_request_status: "repo_update_pull_request_status",
   update_pull_request_reviewers: "repo_update_pull_request_reviewers",
   reply_to_comment: "repo_reply_to_comment",
+  create_pull_request_thread: "repo_create_pull_request_thread",
   resolve_comment: "repo_resolve_comment",
   search_commits: "repo_search_commits",
   list_pull_requests_by_commits: "repo_list_pull_requests_by_commits",
@@ -518,6 +520,85 @@ function configureRepoTools(server: McpServer, tokenProvider: () => Promise<Acce
     }
   );
 
+  server.tool(
+    REPO_TOOLS.create_pull_request_thread,
+    "Creates a new comment thread on a pull request.",
+    {
+      repositoryId: z.string().describe("The ID of the repository where the pull request is located."),
+      pullRequestId: z.number().describe("The ID of the pull request where the comment thread exists."),
+      content: z.string().describe("The content of the comment to be added."),
+      project: z.string().optional().describe("Project ID or project name (optional)"),
+      filePath: z.string().optional().describe("The path of the file where the comment thread will be created. (optional)"),
+      rightFileStartLine: z.number().optional().describe("Position of first character of the thread's span in right file. The line number of a thread's position. Starts at 1. (optional)"),
+      rightFileStartOffset: z
+        .number()
+        .optional()
+        .describe(
+          "Position of first character of the thread's span in right file. The line number of a thread's position. The character offset of a thread's position inside of a line. Starts at 1. Must only be set if rightFileStartLine is also specified. (optional)"
+        ),
+      rightFileEndLine: z
+        .number()
+        .optional()
+        .describe(
+          "Position of last character of the thread's span in right file. The line number of a thread's position. Starts at 1. Must only be set if rightFileStartLine is also specified. (optional)"
+        ),
+      rightFileEndOffset: z
+        .number()
+        .optional()
+        .describe(
+          "Position of last character of the thread's span in right file. The character offset of a thread's position inside of a line. Must only be set if rightFileEndLine is also specified. (optional)"
+        ),
+    },
+    async ({ repositoryId, pullRequestId, content, project, filePath, rightFileStartLine, rightFileStartOffset, rightFileEndLine, rightFileEndOffset }) => {
+      const connection = await connectionProvider();
+      const gitApi = await connection.getGitApi();
+
+      const threadContext: CommentThreadContext = { filePath: filePath };
+
+      if (rightFileStartLine !== undefined) {
+        if (rightFileStartLine < 1) {
+          throw new Error("rightFileStartLine must be greater than or equal to 1.");
+        }
+
+        threadContext.rightFileStart = { line: rightFileStartLine };
+
+        if (rightFileStartOffset !== undefined) {
+          if (rightFileStartOffset < 1) {
+            throw new Error("rightFileStartOffset must be greater than or equal to 1.");
+          }
+
+          threadContext.rightFileStart.offset = rightFileStartOffset;
+        }
+      }
+
+      if (rightFileEndLine !== undefined) {
+        if (rightFileStartLine === undefined) {
+          throw new Error("rightFileEndLine must only be specified if rightFileStartLine is also specified.");
+        }
+
+        if (rightFileEndLine < 1) {
+          throw new Error("rightFileEndLine must be greater than or equal to 1.");
+        }
+
+        threadContext.rightFileEnd = { line: rightFileEndLine };
+
+        if (rightFileEndOffset !== undefined) {
+          if (rightFileEndOffset < 1) {
+            throw new Error("rightFileEndOffset must be greater than or equal to 1.");
+          }
+
+          threadContext.rightFileEnd.offset = rightFileEndOffset;
+        }
+      }
+
+      const thread = await gitApi.createThread({ comments: [{ content: content }], threadContext: threadContext }, repositoryId, pullRequestId, project);
+
+      return {
+        content: [{ type: "text", text: JSON.stringify(thread, null, 2) }],
+      };
+    }
+  );
+
   server.tool(
     REPO_TOOLS.resolve_comment,
     "Resolves a specific comment thread on a pull request.",