fix(pull-requests): retain granular schema descriptions

Keep the original enum guidance in input descriptions while preserving actual JSON Schema enum constraints.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Author: SamMorrowDrums

pkg/github/__toolsnaps__/add_pull_request_review_comment.snap

@@ -49,7 +49,7 @@
         "x-mcp-header": "repo"
       },
       "side": {
-        "description": "The side of the diff to comment on (optional)",
+        "description": "The side of the diff to comment on (LEFT or RIGHT, optional)",
         "enum": [
           "LEFT",
           "RIGHT"
@@ -61,15 +61,15 @@
         "type": "number"
       },
       "startSide": {
-        "description": "The start side of a multi-line comment (optional)",
+        "description": "The start side of a multi-line comment (LEFT or RIGHT, optional)",
         "enum": [
           "LEFT",
           "RIGHT"
         ],
         "type": "string"
       },
       "subjectType": {
-        "description": "The subject type of the comment",
+        "description": "The subject type of the comment (FILE or LINE)",
         "enum": [
           "FILE",
           "LINE"

pkg/github/__toolsnaps__/add_pull_request_review_comment_reaction.snap

@@ -27,7 +27,7 @@
         "type": "number"
       },
       "content": {
-        "description": "The emoji reaction type",
+        "description": "The emoji reaction type (+1, -1, laugh, confused, heart, hooray, rocket, or eyes)",
         "enum": [
           "+1",
           "-1",

pkg/github/__toolsnaps__/create_pull_request_review.snap

@@ -30,7 +30,7 @@
         "type": "string"
       },
       "event": {
-        "description": "The review action to perform. If omitted, creates a pending review.",
+        "description": "The review action to perform (APPROVE, REQUEST_CHANGES, or COMMENT). If omitted, creates a pending review.",
         "enum": [
           "APPROVE",
           "REQUEST_CHANGES",

pkg/github/__toolsnaps__/submit_pending_pull_request_review.snap

@@ -26,7 +26,7 @@
         "type": "string"
       },
       "event": {
-        "description": "The review action to perform",
+        "description": "The review action to perform (APPROVE, REQUEST_CHANGES, or COMMENT)",
         "enum": [
           "APPROVE",
           "REQUEST_CHANGES",

pkg/github/__toolsnaps__/update_pull_request_state.snap

@@ -37,7 +37,7 @@
         "x-mcp-header": "repo"
       },
       "state": {
-        "description": "The new state for the pull request",
+        "description": "The new state for the pull request (open or closed)",
         "enum": [
           "open",
           "closed"

pkg/github/pullrequests_granular.go

@@ -164,7 +164,7 @@ func GranularUpdatePullRequestState(t translations.TranslationHelperFunc) invent
 		map[string]*jsonschema.Schema{
 			"state": {
 				Type:        "string",
-				Description: "The new state for the pull request",
+				Description: "The new state for the pull request (open or closed)",
 				Enum:        GranularPullRequestState("").JSONSchema().Enum,
 			},
 		},
@@ -363,7 +363,7 @@ func GranularCreatePullRequestReview(t translations.TranslationHelperFunc) inven
 					"repo":       {Type: "string", Description: "Repository name"},
 					"pullNumber": {Type: "number", Description: "The pull request number", Minimum: new(1.0)},
 					"body":       {Type: "string", Description: "The review body text (optional)"},
-					"event":      {Type: "string", Description: "The review action to perform. If omitted, creates a pending review.", Enum: GranularPullRequestReviewEvent("").JSONSchema().Enum},
+					"event":      {Type: "string", Description: "The review action to perform (APPROVE, REQUEST_CHANGES, or COMMENT). If omitted, creates a pending review.", Enum: GranularPullRequestReviewEvent("").JSONSchema().Enum},
 					"commitID":   {Type: "string", Description: "The SHA of the commit to review (optional, defaults to latest)"},
 				},
 				Required: []string{"owner", "repo", "pullNumber"},
@@ -419,7 +419,7 @@ func GranularSubmitPendingPullRequestReview(t translations.TranslationHelperFunc
 					"owner":      {Type: "string", Description: "Repository owner (username or organization)"},
 					"repo":       {Type: "string", Description: "Repository name"},
 					"pullNumber": {Type: "number", Description: "The pull request number", Minimum: new(1.0)},
-					"event":      {Type: "string", Description: "The review action to perform", Enum: GranularPullRequestReviewEvent("").JSONSchema().Enum},
+					"event":      {Type: "string", Description: "The review action to perform (APPROVE, REQUEST_CHANGES, or COMMENT)", Enum: GranularPullRequestReviewEvent("").JSONSchema().Enum},
 					"body":       {Type: "string", Description: "The review body text (optional)"},
 				},
 				Required: []string{"owner", "repo", "pullNumber", "event"},
@@ -515,11 +515,11 @@ func GranularAddPullRequestReviewComment(t translations.TranslationHelperFunc) i
 					"pullNumber":  {Type: "number", Description: "The pull request number", Minimum: new(1.0)},
 					"path":        {Type: "string", Description: "The relative path of the file to comment on"},
 					"body":        {Type: "string", Description: "The comment body"},
-					"subjectType": {Type: "string", Description: "The subject type of the comment", Enum: GranularPullRequestCommentSubject("").JSONSchema().Enum},
+					"subjectType": {Type: "string", Description: "The subject type of the comment (FILE or LINE)", Enum: GranularPullRequestCommentSubject("").JSONSchema().Enum},
 					"line":        {Type: "number", Description: "The line number in the diff to comment on (optional)"},
-					"side":        {Type: "string", Description: "The side of the diff to comment on (optional)", Enum: GranularPullRequestDiffSide("").JSONSchema().Enum},
+					"side":        {Type: "string", Description: "The side of the diff to comment on (LEFT or RIGHT, optional)", Enum: GranularPullRequestDiffSide("").JSONSchema().Enum},
 					"startLine":   {Type: "number", Description: "The start line of a multi-line comment (optional)"},
-					"startSide":   {Type: "string", Description: "The start side of a multi-line comment (optional)", Enum: GranularPullRequestDiffSide("").JSONSchema().Enum},
+					"startSide":   {Type: "string", Description: "The start side of a multi-line comment (LEFT or RIGHT, optional)", Enum: GranularPullRequestDiffSide("").JSONSchema().Enum},
 				},
 				Required: []string{"owner", "repo", "pullNumber", "path", "body", "subjectType"},
 			},
@@ -742,7 +742,7 @@ func GranularAddPullRequestReviewCommentReaction(t translations.TranslationHelpe
 					},
 					"content": {
 						Type:        "string",
-						Description: "The emoji reaction type",
+						Description: "The emoji reaction type (+1, -1, laugh, confused, heart, hooray, rocket, or eyes)",
 						Enum:        PullRequestCommentReactionType("").JSONSchema().Enum,
 					},
 				},