Skip to Content

fix

Reproduce the bug against a twin first. Then fix it. Then prove it.

/veris:fix https://github.com/org/repo/issues/42 /veris:fix "create_invoice duplicates the invoice when the response is lost"

In Codex that is $veris:fix.

Use fix for a bug in code that talks to a third-party dependency. It takes an issue link or a plain description, and the repository must already be wired by setup.

fix reproduces the reported failure against a twin before it edits any source, fixes it, then runs the same code path green. Both go through the run its tier makes: veris run on the container tier, and on the direct tier your own test command against the wired sandbox. See Running tests.

A bug that will not reproduce stops the workflow. You get the finding and an unchanged repository, rather than a change made against a failure nobody saw.

What it does to your repository

Treats the issue as claims to check

A report can be right about the symptom and wrong about the cause, so everything it says about the vendor, its diagnosis included, is checked against the twin.

Reproduces the failure red

It deploys a sandbox, seeds the state, arms the failure if the bug is about one, and drives your unmodified code path through it. The actual endpoint or worker the report names, not a curl standing in.

Not done until the request trace and the stored rows show the outcome the issue describes, with ids and counts you can quote.

It also varies whatever your code uses to identify a record and counts the rows, which is how a duplicate write surfaces.

Fixes it in your repository’s own conventions

Then runs your full test suite.

Proves it green

Same fault, same code path, same sandbox. Red before, green after, identical flow.

Opens a PR

Three sections: what was verified and how, what was assumed rather than verified, and limitations and risks. It names the sandbox id, so a reviewer can see what the fix ran against, and every other entry point that could carry the same bug is either driven too or listed as a risk.

The sandbox is deleted at the end, and never promoted.

Every gate it has to meet before it opens that PR is in the fix skill.