> ## Documentation Index
> Fetch the complete documentation index at: https://docs.streambuild.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Quality

> Inspect and run SQL tests and audits and monitor scheduled audit execution.

The Quality view combines authored SQL tests and audits with their latest durable results. Filter by
passing or failing state, expand a check to inspect its SQL and sampled failures, or follow links
back to the affected model.

## Run checks

Use **Run audits** or **Run tests** to execute checks from the UI. Checks run sequentially so a local
ClickHouse target is not flooded with concurrent scans. Running a check reads warehouse data and
records its result; it does not rebuild model relations.

Result state is tied to the current definition and execution context. The UI identifies stale
results caused by binding, definition, execution, or schedule changes rather than presenting them as
current evidence.

For authored syntax and command-line execution, see [Audits](/concepts/audits) and
[SQL Testing](/concepts/testing).

## Audit scheduler

`stb dev` owns the optional audit scheduler for its selected target. Enable it in project
configuration:

```toml theme={null}
[targets.prod.audit_scheduler]
enabled = true
```

The Quality view reports whether scheduling is disabled, idle, warming, due, blocked, running, or in
backoff. Run one scheduler-enabled process per target database.

The scheduler skips work during direct builds and serializes audit batches with warehouse reads.
Connection and compilation failures use bounded exponential backoff and clear after a successful
read.

If two dev processes overlap during a restart or operator mistake, warehouse-backed logical-slot
claims elect one executor without requiring Keeper. Claims use the ClickHouse clock and expire from
election consideration after 10 minutes so a process that dies before emitting run heartbeats cannot
block the slot permanently.

If an old process is suspended for that entire window rather than terminated, it can resume after
takeover and repeat read-only audit computation. Logical-slot result resolution remains
deterministic.