Summary

This PR adds a new toolget_pull_request_ci_failures that allows AI agents to automatically find and retrieve CI failure logs for a pull request without manual copy-pasting from the GitHub web UI.

Use Case

When working with AI coding assistants like Cursor, GitHub Copilot, or Claude, a common workflow is:

1. Create a PR with code changes
2. CI pipeline runs and fails
3. Currently: Manually navigate to GitHub Actions, find the failed job, copy error logs, paste into the AI chat
4. With this tool: The AI agent can directly retrieve the failure logs and suggest fixes

This significantly improves the developer experience by eliminating the tedious copy-paste cycle when debugging CI failures.

Features

• Finds workflow runs triggered by a PR using the head SHA
• Identifies failed workflow runs (failure, timed_out, cancelled conclusions)
• Collects logs from all failed jobs with failed step information
• Returns log content by default (configurable viareturn_content parameter)
• Supportstail_lines parameter to limit log output (default: 500 lines)

Implementation Details

• AddedGetPullRequestCIFailures function inpkg/github/actions.go
• Added helper functiongetFailedJobsForRun to collect failed job logs for a workflow run
• Reuses existinggetJobLogData function for log retrieval
• Registered in bothpull_requests (default toolset) andactions toolsets
• Comprehensive test coverage inpkg/github/actions_test.go

Tool Schema

{"name":"get_pull_request_ci_failures","description":"Get failed CI workflow job logs for a pull request...","inputSchema": {"required": ["owner","repo","pullNumber"],"properties": {"owner": {"type":"string" },"repo": {"type":"string" },"pullNumber": {"type":"number" },"return_content": {"type":"boolean","default":true },"tail_lines": {"type":"number","default":500 }    }  }}

Testing

• All existing tests pass
• Added unit tests for the new tool covering:
  • Successful CI failure retrieval with failed jobs
  • No failed workflow runs scenario
  • No workflow runs found scenario
  • Missing required parameters
  • PR not found error handling
  • Content return with actual log content

Checklist

• Tests pass (go test ./...)
• Linter passes (script/lint)
• Documentation updated (script/generate-docs)
• Toolsnap created