The one place tripwires are enumerated, and the sweep that runs them.
Registration is keyed by the tripwire's own code, so the registry cannot end up holding two checks that report under the same identifier - the ledger, the ladder and the circuit breaker all key on that code, and two sources feeding one key makes every count downstream wrong.
The sweep is the part that has to be hard to break. A tripwire that throws is caught and turned into a finding of its own, because the alternative is that one broken check hides every check registered after it, and the checks that stop reporting are exactly the ones nobody notices have gone quiet.
withStorageTripwires() : self
A registry holding every check over what is in the object store.
The set a verify pass sweeps with. Ordered cheapest-first only incidentally; every one of them reads the observation it is handed and nothing else, so the order does not change the result.
A populated registry.
withCaptureTripwires() : self
A registry holding the checks over whether capture saw everything.
Separate from the storage set because it answers a different question. The storage checks ask whether what was stored is intact; this one asks whether anything was missed, which is the only failure a backup system cannot see from inside its own capture path.
A populated registry.
withFileTripwires() : self
A registry holding the checks over the file realm.
Its own set because the file realm's failure is neither corruption nor a gap: the content is stored and restores exactly, and it simply costs far more than it should because fixed blocks cannot follow a shift.
A populated registry.
register(\Drupal\strata\Health\TripwireInterface $wire) : self
Registers a tripwire under its own code.
| \Drupal\strata\Health\TripwireInterface | $wire | The tripwire. |
When the code is empty, or something is already registered under it. Both are refused loudly rather than resolved by last-write-wins, which would silently drop a check.
This registry, so a set can be built in one expression.
get(string $code) : \Drupal\strata\Health\TripwireInterface|null
One registered tripwire.
Returns NULL rather than throwing, so a caller checking whether an optional check is installed does not need a try block to ask.
| string | $code | The tripwire code. |
The tripwire, or NULL when nothing is registered under that code.
evaluate(array $observation) : \Drupal\strata\Health\Finding[]
Runs every tripwire over one observation and collects what fired.
The sweep never aborts. A tripwire that throws becomes a FAILED finding scoped to that tripwire's code and the sweep continues, so a bug in one check costs one check.
| array | $observation | Scalars the caller already had; passed to every tripwire unchanged. |
Findings in registration order, empty when everything is satisfied.