Enum ControlEffectiveness
- Namespace
- Excalibur.Compliance
- Assembly
- Excalibur.Compliance.Abstractions.dll
The effectiveness bands a control validator may report, and the order they must stand in.
public enum ControlEffectiveness
Fields
Effective = 100The control was examined and found to be operating. The only band that reports assurance.
MechanismAbsent = 0The mechanism this control depends on is not present at all, so nothing can operate. Ranks below ViolationDetected: a control that does not exist is worse than one that exists and failed.
Unverified = 40The mechanism is present, but this run did not establish that it operates — the check threw, had nothing in scope, or the mechanism is not observable from inside this framework. This is a statement about the validation, not an accusation about the control.
ViolationDetected = 20The control was examined and a violation was found. Strictly below Unverified: a proven deficiency is worse than an open question and must never read as better than one.
Remarks
The ordering is the contract, not the particular numbers. A control that was examined and found broken can never rank above one that was merely not examined, because a finding is knowledge and an absence of examination is not. Anything reporting a band picks the one matching the worst fact established, never a count of the remarks made about it.
This replaced a bare int, and the reason is worth stating. The numbers
were once computed as 100 - (issues.Count * 25) — an expression that counts how many
sentences a validator wrote, which measures nothing. It placed a confirmed tampered audit trail
at 75, one complaint, above a control that was present but could not be verified at 40, and
above a control whose mechanism is absent entirely. Severity never entered the arithmetic, and the
averages built on those numbers reach an external assessor. An integer invites that mistake again:
0–100 reads as a percentage, so a plausible 75 meaning "good, minor notes" is both a reasonable
thing to write and a wrong answer. The bands are a closed, ordered set, so name one.
This value determines Outcome. The band is the finer fact — it separates a control whose mechanism is absent from one that was examined and found broken, which Deficient covers jointly — so the outcome is derived from it rather than stated beside it. Report the band; the verdict follows and cannot contradict it.