Improve get_pull_request_ci_failures tool for comprehensive CI failure detection

- Query workflow runs for both head SHA and merge commit SHA to catch all CI runs
- Add pagination for ListWorkflowJobs to find failures beyond the first page
- Fetch third-party check runs (e.g., dorny/test-reporter) with annotations
- Add configurable parameters: include_annotations, include_logs, tail_lines, max_failed_jobs
- Use generic failure detection (no company-specific heuristics)
- Increase bufio.Scanner buffer to 10MB to handle very long log lines
- Add unit tests for merge SHA discovery, paginated jobs, and third-party check runs

Author: jaceksan

pkg/buffer/buffer.go

@@ -32,7 +32,7 @@ func ProcessResponseAsRingBufferToEnd(httpResp *http.Response, maxJobLogLines in
 	writeIndex := 0
 
 	scanner := bufio.NewScanner(httpResp.Body)
-	scanner.Buffer(make([]byte, 0, 64*1024), 1024*1024)
+	scanner.Buffer(make([]byte, 0, 64*1024), 10*1024*1024) // 10MB max line size
 
 	for scanner.Scan() {
 		line := scanner.Text()

pkg/github/__toolsnaps__/get_pull_request_ci_failures.snap

@@ -12,6 +12,21 @@
       "pullNumber"
     ],
     "properties": {
+      "include_annotations": {
+        "type": "boolean",
+        "description": "Include GitHub Check Run annotations - structured error messages with file/line info (default: true). Set to false to reduce output size.",
+        "default": true
+      },
+      "include_logs": {
+        "type": "boolean",
+        "description": "Include tail of job logs for context (default: true). Set to false if annotations are sufficient or to reduce output size.",
+        "default": true
+      },
+      "max_failed_jobs": {
+        "type": "number",
+        "description": "Maximum number of failed jobs to fetch details for (default: 3). Use 0 for no limit. Reduce if output is too large.",
+        "default": 3
+      },
       "owner": {
         "type": "string",
         "description": "Repository owner"
@@ -24,15 +39,10 @@
         "type": "string",
         "description": "Repository name"
       },
-      "return_content": {
-        "type": "boolean",
-        "description": "Returns actual log content instead of URLs (default: true)",
-        "default": true
-      },
       "tail_lines": {
         "type": "number",
-        "description": "Number of lines to return from the end of each log (default: 500)",
-        "default": 500
+        "description": "Number of log lines to include from end of each job (default: 100). Reduce if output is too large.",
+        "default": 100
       }
     }
   },