fix get_file_blame maintainer follow-ups

Author: MayorFaj

README.md

@@ -1205,12 +1205,6 @@ The following sets of tools are available:
   - `repo`: Repository name (string, required)
   - `sha`: Commit SHA, branch name, or tag name (string, required)
 
-- **get_file_blame** - Get file blame information
-  - `owner`: Repository owner (username or organization) (string, required)
-  - `path`: Path to the file in the repository (string, required)
-  - `ref`: Git reference (branch, tag, or commit SHA). Defaults to the repository's default branch (string, optional)
-  - `repo`: Repository name (string, required)
-
 - **get_file_contents** - Get file or directory contents
   - **Required OAuth Scopes**: `repo`
   - `owner`: Repository owner (username or organization) (string, required)

pkg/github/__toolsnaps__/get_file_blame.snap

@@ -3,32 +3,53 @@
     "readOnlyHint": true,
     "title": "Get file blame information"
   },
-  "description": "Get git blame information for a file, showing who last modified each line",
+  "description": "Get git blame information for a file, showing the commit that last modified each line. Ranges share commit metadata via the top-level 'commits' map keyed by SHA. Use 'start_line'/'end_line' to restrict the result to a window of the file, and 'page'/'perPage' to page through returned ranges. Matching ranges are capped at 1000; when the cap is hit 'truncated' is set to true and 'total_ranges' reports the pre-cap match count.",
   "inputSchema": {
-    "type": "object",
-    "required": [
-      "owner",
-      "repo",
-      "path"
-    ],
     "properties": {
+      "end_line": {
+        "description": "Optional 1-based ending line of the window of interest. Must be \u003e= start_line when both are provided.",
+        "minimum": 1,
+        "type": "number"
+      },
       "owner": {
-        "type": "string",
-        "description": "Repository owner (username or organization)"
+        "description": "Repository owner (username or organization)",
+        "type": "string"
+      },
+      "page": {
+        "description": "Page number for pagination (min 1)",
+        "minimum": 1,
+        "type": "number"
       },
       "path": {
-        "type": "string",
-        "description": "Path to the file in the repository"
+        "description": "Path to the file in the repository, relative to the repository root",
+        "type": "string"
+      },
+      "perPage": {
+        "description": "Results per page for pagination (min 1, max 100)",
+        "maximum": 100,
+        "minimum": 1,
+        "type": "number"
       },
       "ref": {
-        "type": "string",
-        "description": "Git reference (branch, tag, or commit SHA). Defaults to the repository's default branch"
+        "description": "Git reference (branch, tag, or commit SHA). Defaults to the repository's default branch (HEAD).",
+        "type": "string"
       },
       "repo": {
-        "type": "string",
-        "description": "Repository name"
+        "description": "Repository name",
+        "type": "string"
+      },
+      "start_line": {
+        "description": "Optional 1-based starting line of the window of interest. Only ranges overlapping [start_line, end_line] are returned, clamped to the window.",
+        "minimum": 1,
+        "type": "number"
       }
-    }
+    },
+    "required": [
+      "owner",
+      "repo",
+      "path"
+    ],
+    "type": "object"
   },
   "name": "get_file_blame"
-}
+}