feat: Add tool for discussion comment write operations (github#2427)

* Add discussion comment write operation tools

Co-authored-by: Copilot <[email protected]>

* Address comments from Copilot review

* Update includeReplies description to specify GitHub API maximum replies limit

* Consolidate into single tool

* add tests cases for checking param presence

* Enhance validation on discussion comment operations

* Enhance discussion_write tool description

Co-authored-by: Roberto Nacu <[email protected]>

* Remove redundant param

Co-authored-by: Roberto Nacu <[email protected]>

* Refactor tests

* Fix failing build

---------

Co-authored-by: Copilot <[email protected]>
Co-authored-by: Roberto Nacu <[email protected]>

Author: 3 people

README.md

@@ -730,6 +730,23 @@ The following sets of tools are available:
 
 <summary><picture><source media="(prefers-color-scheme: dark)" srcset="pkg/octicons/icons/comment-discussion-dark.png"><source media="(prefers-color-scheme: light)" srcset="pkg/octicons/icons/comment-discussion-light.png"><img src="pkg/octicons/icons/comment-discussion-light.png" width="20" height="20" alt="comment-discussion"></picture> Discussions</summary>
 
+- **discussion_comment_write** - Manage discussion comments
+  - **Required OAuth Scopes**: `repo`
+  - `body`: Comment content (required for 'add', 'reply', and 'update' methods) (string, optional)
+  - `commentNodeID`: The Node ID of the discussion comment (required for 'reply', 'update', 'delete', 'mark_answer', and 'unmark_answer' methods). For 'reply', this is the top-level comment to reply to; GitHub Discussions only support one level of nesting. (string, optional)
+  - `discussionNumber`: Discussion number (required for 'add' and 'reply' methods) (number, optional)
+  - `method`: Write operation to perform on a discussion comment.
+    Options are:
+    - 'add' - adds a new top-level comment to a discussion.
+    - 'reply' - replies to a top-level discussion comment (GitHub Discussions only support one level of nesting).
+    - 'update' - updates an existing discussion comment.
+    - 'delete' - deletes a discussion comment.
+    - 'mark_answer' - marks a discussion comment as the answer (Q&A only).
+    - 'unmark_answer' - unmarks a discussion comment as the answer (Q&A only).
+     (string, required)
+  - `owner`: Repository owner (required for 'add' and 'reply' methods) (string, optional)
+  - `repo`: Repository name (required for 'add' and 'reply' methods) (string, optional)
+
 - **get_discussion** - Get discussion
   - **Required OAuth Scopes**: `repo`
   - `discussionNumber`: Discussion Number (number, required)
@@ -740,6 +757,7 @@ The following sets of tools are available:
   - **Required OAuth Scopes**: `repo`
   - `after`: Cursor for pagination. Use the endCursor from the previous page's PageInfo for GraphQL APIs. (string, optional)
   - `discussionNumber`: Discussion Number (number, required)
+  - `includeReplies`: When true, each top-level comment will include its replies nested within it (up to 100 replies per comment, which is the GitHub API maximum). Defaults to false. (boolean, optional)
   - `owner`: Repository owner (string, required)
   - `perPage`: Results per page for pagination (min 1, max 100) (number, optional)
   - `repo`: Repository name (string, required)

pkg/github/__toolsnaps__/discussion_comment_write.snap

@@ -0,0 +1,48 @@
+{
+  "annotations": {
+    "destructiveHint": true,
+    "title": "Manage discussion comments"
+  },
+  "description": "Write operations for discussion comments.\nSupports adding top-level comments, replying to existing comments, updating comment content, deleting comments, and marking or unmarking comments as the answer.",
+  "inputSchema": {
+    "properties": {
+      "body": {
+        "description": "Comment content (required for 'add', 'reply', and 'update' methods)",
+        "type": "string"
+      },
+      "commentNodeID": {
+        "description": "The Node ID of the discussion comment (required for 'reply', 'update', 'delete', 'mark_answer', and 'unmark_answer' methods). For 'reply', this is the top-level comment to reply to; GitHub Discussions only support one level of nesting.",
+        "type": "string"
+      },
+      "discussionNumber": {
+        "description": "Discussion number (required for 'add' and 'reply' methods)",
+        "type": "number"
+      },
+      "method": {
+        "description": "Write operation to perform on a discussion comment.\nOptions are:\n- 'add' - adds a new top-level comment to a discussion.\n- 'reply' - replies to a top-level discussion comment (GitHub Discussions only support one level of nesting).\n- 'update' - updates an existing discussion comment.\n- 'delete' - deletes a discussion comment.\n- 'mark_answer' - marks a discussion comment as the answer (Q\u0026A only).\n- 'unmark_answer' - unmarks a discussion comment as the answer (Q\u0026A only).\n",
+        "enum": [
+          "add",
+          "reply",
+          "update",
+          "delete",
+          "mark_answer",
+          "unmark_answer"
+        ],
+        "type": "string"
+      },
+      "owner": {
+        "description": "Repository owner (required for 'add' and 'reply' methods)",
+        "type": "string"
+      },
+      "repo": {
+        "description": "Repository name (required for 'add' and 'reply' methods)",
+        "type": "string"
+      }
+    },
+    "required": [
+      "method"
+    ],
+    "type": "object"
+  },
+  "name": "discussion_comment_write"
+}

pkg/github/__toolsnaps__/get_discussion_comments.snap

@@ -14,6 +14,10 @@
         "description": "Discussion Number",
         "type": "number"
       },
+      "includeReplies": {
+        "description": "When true, each top-level comment will include its replies nested within it (up to 100 replies per comment, which is the GitHub API maximum). Defaults to false.",
+        "type": "boolean"
+      },
       "owner": {
         "description": "Repository owner",
         "type": "string"