Runs
A run is one correction pass: the artifacts Kontrua owns regenerated, the false lines in your own files rewritten.
A run is created when someone approves a pull request on the watch branch, when a schedule fires, when your CI calls the API trigger, or when you click Run now. It compares the change against the code, regenerates the artifacts that change can have invalidated, corrects the false lines in the documents you wrote, and delivers the result for review.
Run states
| State | Meaning |
|---|---|
| pending | Run created, waiting to be picked up |
| running | Artifacts are being regenerated and corrections written |
| success | The run finished and its changes are on a branch, as a pull request unless review mode is set to manual |
| failed | An error occurred; details shown in the dashboard. A failed run does not consume allowance |
| queued | Monthly allowance reached; run will retry when space opens |
Queued runs
When your monthly correction allowance is reached, new runs are not dropped. They enter a queued state and are retried automatically once capacity is available - at the start of the next calendar month, or earlier if a slot opens (after a plan upgrade, for example). The pull request that would have been corrected gets a passing commit status saying the correction is paused, because our capacity running out is not a failure of your pull request.
Viewing output
Open any run in Dashboard - Runs to see the generated content, which artifacts and documents were updated, a step-by-step progress log, and a direct link to the pull request.
Trigger types
| Trigger | Source |
|---|---|
| pr_approved | GitHub PR approval or GitLab MR approval on the watch branch, via webhook |
| scheduled | Recurring schedule configured on the repository (daily, weekly on Mondays, monthly on the 1st) |
| ci | Direct call to POST /api/trigger |
| manual | "Run now" button in the dashboard |
There is no push trigger and no merge trigger. A push produces a free verdict, not a run.
Ready to prove your context is true?
Connect your first repository and Kontrua tells you how much of what your docs claim is still true, before it writes anything.