feat: Resolve threads in AddressReviews mode (#266)

* Add review thread resolution to AddressReviews mode

- Add thread_id to comment metadata in buildThreadBlocks
- Implement ResolveReviewThreadTool with GraphQL mutation
- Register new tool in MCP server
- Update AddressReviews mode to resolve threads after addressing feedback

Closes #227

* Fix typo: use log.warning instead of log.warn

* refactor: DRY up catch block by extracting isResolved condition

* fix lint.

* fix: avoid using any.

* fix: combining log statements around the message.

* fix(test): Adjusting snapshot.

---------

Co-authored-by: pullfrog[bot] <226033991+pullfrog[bot]@users.noreply.github.com>
Co-authored-by: Robin Tail <robin_tail@me.com>

mcp/__snapshots__/reviewComments.test.ts.snap

@@ -11,7 +11,7 @@ exports[`formatReviewThreads > formats thread blocks with TOC and correct line n
 
 ## .github/workflows/test.yml:7 [RESOLVED]
 
-\`\`\`\`comment author=cursor id=2544544046 review=3485940013 *
+\`\`\`\`comment author=cursor id=2544544046 review=3485940013 thread=PRRT_kwDOPaxxp85iysVl *
 ### Bug: GitHub Actions workflow triggered for wrong branch
 
 <!-- **High Severity** -->

mcp/reviewComments.ts

@@ -395,7 +395,7 @@ export function buildThreadBlocks(
       const marker = isTargetReview ? " *" : "";
 
       block.push(
-        `\`\`\`\`comment author=${author} id=${comment.fullDatabaseId ?? "unknown"} review=${comment.pullRequestReview?.databaseId ?? "unknown"}${marker}`
+        `\`\`\`\`comment author=${author} id=${comment.fullDatabaseId ?? "unknown"} review=${comment.pullRequestReview?.databaseId ?? "unknown"} thread=${thread.id}${marker}`
       );
       block.push(comment.body || "(no comment body)");
       block.push("````");
@@ -576,3 +576,70 @@ export function ListPullRequestReviewsTool(ctx: ToolContext) {
     }),
   });
 }
+
+const RESOLVE_REVIEW_THREAD_MUTATION = `
+mutation($threadId: ID!) {
+  resolveReviewThread(input: {threadId: $threadId}) {
+    thread {
+      id
+      isResolved
+    }
+  }
+}
+`;
+
+export const ResolveReviewThread = type({
+  thread_id: type.string.describe("The GraphQL node ID of the review thread to resolve"),
+});
+
+export function ResolveReviewThreadTool(ctx: ToolContext) {
+  return tool({
+    name: "resolve_review_thread",
+    description:
+      "Mark a review thread as resolved using GitHub's GraphQL API. " +
+      "Only call this after addressing the review feedback, implementing fixes, testing them, and posting a reply. " +
+      "Do not resolve threads that are already resolved, threads where no action was taken, or threads where you disagree with the feedback.",
+    parameters: ResolveReviewThread,
+    execute: execute(async (params) => {
+      try {
+        const response = await ctx.octokit.graphql<{
+          resolveReviewThread: {
+            thread: {
+              id: string;
+              isResolved: boolean;
+            };
+          };
+        }>(RESOLVE_REVIEW_THREAD_MUTATION, {
+          threadId: params.thread_id,
+        });
+
+        const thread = response.resolveReviewThread.thread;
+        log.debug(`resolved thread ${thread.id}, isResolved=${thread.isResolved}`);
+
+        return {
+          thread_id: thread.id,
+          is_resolved: thread.isResolved,
+          success: true,
+          message: "Thread resolved successfully",
+        };
+      } catch (error) {
+        // handle common error cases gracefully
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const isResolved =
+          errorMessage.includes("already resolved") || errorMessage.includes("isResolved");
+
+        const message = isResolved
+          ? `thread ${params.thread_id} was already resolved`
+          : `failed to resolve thread ${params.thread_id}: ${errorMessage}`;
+        log.warning(message);
+
+        return {
+          thread_id: params.thread_id,
+          is_resolved: isResolved,
+          success: isResolved,
+          message,
+        };
+      }
+    }),
+  });
+}

mcp/server.ts

@@ -106,7 +106,11 @@ import { SetOutputTool } from "./output.ts";
 import { CreatePullRequestTool } from "./pr.ts";
 import { PullRequestInfoTool } from "./prInfo.ts";
 import { CreatePullRequestReviewTool } from "./review.ts";
-import { GetReviewCommentsTool, ListPullRequestReviewsTool } from "./reviewComments.ts";
+import {
+  GetReviewCommentsTool,
+  ListPullRequestReviewsTool,
+  ResolveReviewThreadTool,
+} from "./reviewComments.ts";
 import { SelectModeTool } from "./selectMode.ts";
 import { addTools } from "./shared.ts";
 import { UploadFileTool } from "./upload.ts";
@@ -166,6 +170,7 @@ function buildTools(ctx: ToolContext): Tool<any, any>[] {
     CheckoutPrTool(ctx),
     GetReviewCommentsTool(ctx),
     ListPullRequestReviewsTool(ctx),
+    ResolveReviewThreadTool(ctx),
     GetCheckSuiteLogsTool(ctx),
     AddLabelsTool(ctx),
     PushBranchTool(ctx),