mix gate.check (Statifier v2.1.1)

Copy Markdown View Source

Reports changes to the quality gate's own configuration that the branch does not also record in docs/quality-gate-changes.md.

ADR-0011 says the gate's config is not agent-editable. This task is how a mix quality run notices: it runs as the Gate guard custom stage, and fails it when a guarded file changed with no ledger entry naming that file.

Usage

mix gate.check
mix gate.check --base upstream/trunk
mix gate.check --format json

Options

  • --base - ref to diff against, tried before origin/main and main
  • --format json - print the ExQuality finding contract instead of prose

Exit status is 0 when nothing is unjustified, 1 when something is, and 2 when no base ref resolves and there is nothing to diff against - which the stage's skip_exit_code: 2 turns into a skip with its own reason rather than a pass.

Summary

Functions

execute(argv, opts \\ [])

Runs the guard and reports the outcome instead of halting.

Functions

execute(argv, opts \\ [])

@spec execute(argv :: [String.t()], opts :: keyword()) ::
  {:ok, iodata()} | {:skip, String.t()} | {:error, iodata()}

Runs the guard and reports the outcome instead of halting.

opts are passed through to Mix.Statifier.GateGuard.collect/1, so opts[:runner] drives this without a real git history.