engine

type Options struct {
	Root       string   // absolute path to repo root
	GateNames  []string // in run order; each must be registered
	Scope      gitdiff.Scope
	ScopeLabel string // "staged" | "since:main" | "whole-tree"
	// FailFast stops the engine on the first gate that reports FAIL.
	// Remaining gates emit GateResult{Status: GateSkip, SkipReason: "fail-fast"}
	// so nothing is silently dropped from the verdict.
	FailFast bool
}