VerificationResult

Immutable verdict of a verification: tri-state (passed / failed / waived) + PENDING for async verifiers. Framework-agnostic — carries only opaque strings, no Doctrine, no domain types. `principal` and `verifier` are opaque identifiers (e.g. "user:42", "human_verify"); the core never resolves them to entities. `missing` is a generic list of unmet requirement keys.

public static function pass(?string $verifier = null, ?string $principal = null, array $metadata = []): self

Build a PASSED result: the verification was satisfied on its merits.

Parameters

public static function fail(string $reason, array $missing = [], ?string $verifier = null, array $metadata = [], ?string $principal = null): self

Build a FAILED result, optionally listing the unmet requirement keys in `$missing`.

Parameters

public static function waived(string $reason, ?string $principal = null, ?string $verifier = null, array $metadata = []): self

Exempted with a justification — clears the gate despite not passing on merit.

Parameters

public static function pending(?string $verifier = null, array $metadata = []): self

Requested but unresolved (async human/agent verify).

Parameters

public function isSatisfied(): bool

Whether the gate this result represents is satisfied, i.e. PASSED or WAIVED. {@see VerificationStatus::isSatisfied()}

public function isPending(): bool

Whether this result is still awaiting an async human/agent verifier.

public function isFinal(): bool

Whether this result is terminal, i.e. will not transition to another status. {@see VerificationStatus::isFinal()}

public function hasMissing(): bool

Whether this result carries any unmet requirement keys.

public function toArray(): array

Serialize to a plain array for logging/transport (status as its scalar `.value`).