Reading a Clearance Verdict
Every seat on a roster resolves to one of four verdicts. Three of them are straightforward. The fourth is the one that matters most.
clear
Nothing outstanding. The player has a current passing scan, no active bans, no upheld reports against them, and a trust score above the bar.
blocked
An active ban, or a player record in a banned state. This is the only verdict we would describe as a refusal — everything else hands the decision back to you.
Bans attach to the handle as well as to the player record, so a ban is not shed by uninstalling Guardian and re-registering.
review
Something is worth a look. This is a judgement call handed back to you, not a
refusal, and the right response depends on what is at stake. A weekly ladder
might admit every review; a qualifier with a prize pool probably should not
admit some of them.
Read the reason codes before deciding. The two most common are easy to confuse:
no_passing_attestation— this player has never produced a passing scan. Usually means: ask them to install Guardian and run it.attestation_stale— they did pass, but a while ago. A pass describes the machine that produced it, and machines change. Usually means: ask them to run it again.
Neither is an accusation. Both are usually solved by a message to the player.
unknown — and why it is not clear
Guardian has no record of this player at all.
It is tempting to read that as "nothing against them, so they are fine". That reading is a hole you could drive a truck through: if no record meant clearance, the cheapest way to pass a roster check would be to never install Guardian.
So unknown is counted alongside blocked in the roster roll-up, and a roster
full of players nobody has ever scanned will never report itself as ready.
If your rules do admit unverified entrants — plenty of open community events
do — read the per-entry verdict rather than the roll-up's cleared flag, and
treat unknown however your rules say to.
A note on disputes
Every verdict stores its reasons at the time it was made. A player's score can
move afterwards; the record of why you benched them on Saturday does not. If you
disqualify somebody, keep the entry's reasons and checked_at — that is your
evidence, and it is far more useful in an appeal than "the system said no".