Table of Contents

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 = 100

The control was examined and found to be operating. The only band that reports assurance.

MechanismAbsent = 0

The 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 = 40

The 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 = 20

The 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.