Fixes and pull requests
How TraceX turns a root cause into a fix and a reviewed GitHub pull request, how fix approvals work, and how fix outcomes are tracked.
Finding the cause is half the job. When an investigation finds a root cause in your code or data, TraceX also writes the fix, so the engineer who picks it up starts from a working change instead of a blank editor.
What a fix contains
Section titled “What a fix contains”| Part | Description |
|---|---|
| The change | A code patch, a data correction or a configuration change. |
| Why it works | How the change addresses the root cause, not just the symptom. |
| Risk | Low, medium or high, based on what the change touches. |
| How to verify | A query to run, a test, or a behaviour to check after it ships. |
TraceX only proposes a fix when the root cause is grounded in evidence. If it isn’t sure, it says what it would need instead of guessing at a change.
Open a pull request
Section titled “Open a pull request”On the investigation page, choose Open pull request. TraceX creates a branch on the connected GitHub repository and opens a pull request with the change and a description linking back to the investigation, so reviewers can see the evidence behind it.
- Fix pull requests are on the Pro and Team plans.
- They work with GitHub repositories. GitLab and Bitbucket are read-only for now.
- Nothing is merged automatically. Your normal review, CI and merge rules apply.
Approvals
Section titled “Approvals”Some teams want every automated change checked by a lead before it exists as a pull request. Admins can turn on Security → Admins approve every fix pull request:
- Members can still write fixes and ask for a pull request.
- An admin approves by opening it, from the dashboard or from Slack.
- High-risk fixes always need an admin, whether or not this setting is on.
What happens after
Section titled “What happens after”TraceX records what happened to each fix pull request:
- merged as written,
- merged after edits, or
- closed without merging.
You see the totals in Reports and accuracy. It is a direct measure of how useful the fixes are on your codebase.
Can TraceX push to my main branch?
Section titled “Can TraceX push to my main branch?”No. It always opens a pull request on a new branch. Merging is up to your team.
Why is the “Open pull request” button missing?
Section titled “Why is the “Open pull request” button missing?”Either your plan doesn’t include fix pull requests, the repository isn’t on GitHub, or your organization requires admin approval and you aren’t an admin. In the last case, ask for a pull request and an admin will approve it.