Helper bots
A small family of bots keeps routine repository work moving. Renovate
automerges green minor and patch bumps, and Renovatebotbot merges a bump once a
maintainer approved it. Mainfixbot and Sentryfixbot never merge anything, and a
human reviews everything else. The bots that write code run as scheduled GitLab
CI jobs, each under its own account (renovatebotbot, mainfixbot,
sentryfixbot), whose project membership defines its scope; dc-pr-agent
reacts to merge request events instead.
| Bot | Watches | Delivers |
|---|---|---|
| Renovate | Outdated dependencies | Bump merge requests; green minor and patch bumps automerge |
| Renovatebotbot | Failing Renovate merge requests, and passing major or pre-1.0 minor bumps | Adaptation commits on the bump branch, a compatibility review, and the merge after your approval |
| Mainfixbot | Failing default-branch pipelines and Renovatebotbot blocker issues | Draft fix merge requests on botfix/ branches, ready when green |
| Sentryfixbot | Errors in the Sentry projects it is configured for | One GitLab work item per error cluster, and a draft repair merge request for a code bug |
| dc-pr-agent | Merge requests when they open | Review comments and code suggestions, never a merge |
The shared mechanics (state persistence, worker execution, commit checks, GitLab access) live in botcore. Each bot’s own README is the authority on its exact behavior and safety checks. Renovate’s configuration is covered under external dependencies.
How they behave
Section titled “How they behave”An AI worker writes the code, in a checkout, without write access to GitLab. The bot validates the commit before publishing it: the reviewed change must survive, history is never rewritten, and pushes are never forced. Every result arrives in a merge request, and the merge request’s pipeline is the verdict.
A bump or fix gets a bounded number of attempts. After that the bot hands the work to a human: a note on the merge request, or an issue when no merge request exists. A new head commit hands it back to the bot with a fresh budget.
Mainfixbot ignores runner queue pressure (a red default branch outranks it) and leaves branches alone whose failing pipeline is older than a year: those are dormant, not broken. Sentryfixbot files one work item per cluster of Sentry issues that share a cause, and its repair merge request proves itself: red on the reproduction, green on the fix.
Working with them
Section titled “Working with them”- Review like any merge request. A note saying the pipeline passes means it
is ready for you. On a Renovate merge request a maintainer’s approval decides:
Renovatebotbot merges the approved changes once their pipeline passes, and
asks again when those changes move. Merge a
botfix/orsentryfix/merge request yourself. - Steer with a reply. A comment from a member with push access on a merge request Renovatebotbot or Mainfixbot works on becomes the instruction for its next attempt.
- Conflicted adapted bumps resolve themselves. The bot ticks Renovate’s rebase checkbox, Renovate regenerates the bump, and the bot replays its adaptation on the fresh branch.
- Close what you do not want. Closing a Renovate merge request mutes that
update; closing a
botfix/merge request leaves the repair to you.
