Kissaki Docs
Guides

Gate pull requests

Publish a scan verdict as a pull-request check that can block a merge.

PR gating publishes a verdict on a pull request as a check run, so risky changes can be blocked before they merge.

How it works

For a connected repository, Kissaki evaluates the change and posts a check run keyed by the provider's repository name and PR number. The verdict is governed by two settings:

  • gating_mode - whether the check only reports, or blocks.
  • gating_threshold - the severity at or above which the gate fails.

A published verdict outranks anything derivable from the repository's standing policy: the check on the PR is the source of truth for that PR.

Enable it

  1. Connect the repository (see onboard a repository).
  2. Turn on PR gating for the repository and pick a mode and threshold.
  3. Open a pull request - the Kissaki check appears with its verdict.

Gating in blocking mode can stop merges. Start in report-only mode, confirm the verdicts look right on a few PRs, then switch to blocking.

On this page