Pull requests
Tracemoor reads and works on the pull requests of the repository's remote. You open pull requests, review them, comment, merge, and hand open review comments to the AI. The work happens in the Pull Requests tab in the lower area of the Git view. Open it with Git › View Pull Requests.
Supported providers
The provider follows from the URL of the remote origin. Without origin,
the first configured remote is used.
| Remote host | Provider |
|---|---|
github.com | GitHub |
bitbucket.org | Bitbucket Cloud |
| any other host | not supported |
For another host the tab shows "Unsupported not supported yet" and the remote URL. GitLab, GitHub Enterprise and Bitbucket Server are not supported.
Each provider needs a token. It is stored once in the operating system's keychain and applies to every project with that provider. See Set up pull requests.
What the integration covers
| Area | Topic |
|---|---|
| Open a pull request from a branch, with reviewers and draft flag | Open a pull request |
| List, filter and read pull requests: conversation, changed files, commits, checks | Review a pull request |
| Comment, reply, approve, request changes, merge | Review a pull request |
| Work through review comments with the AI, keep them as projectdocs entries | Pull requests and the AI |
Work packages open their pull requests through the same connection, with title and description from the Workflow Policy.
Review threads and "open"
A review thread is a comment with its replies. Inline comments belong to a line of a file, conversation comments to the pull request as a whole. A review summary is the text a reviewer writes with a verdict.
Whether a thread still needs action is decided per provider:
| Provider | A thread is open when … |
|---|---|
| Bitbucket | it is not marked as resolved. |
| GitHub | it has a comment written after the latest push to the pull request. |
GitHub's resolved flag is not available to Tracemoor. A GitHub thread that nobody answered after your last push therefore counts as handled, even if it is not resolved on GitHub.
Notifications
While a project is open, Tracemoor checks its pull requests every minute and fetches the remote every three minutes. Changes appear under the bell icon in the top bar: a new pull request, approved, changes requested, merged, closed, and merge conflicts. The number on the bell counts unread events. Opening the list marks them as read, Clear empties it. Click an event to open the pull request in the browser.
Only changes after the project was opened are reported. The list is kept per project. Checks only run when a token for the provider is configured.
Differences between the providers
| Function | GitHub | Bitbucket Cloud |
|---|---|---|
| Draft pull request | native draft | title prefix [DRAFT] |
| Request changes | review with the verdict "changes requested" | posts the comment, then marks the pull request "changes requested". |
| Reply to a conversation comment | posted as a new conversation comment that quotes the original | posted in the thread |
| Apply suggestion | yes | no |
| Rebase and merge | rebase merge | fast-forward merge |
| Open threads | comment after the latest push | not resolved |
| Reviewer suggestions | collaborators of the repository | members of the workspace |