Trends and deltas

A single check answers “what is wrong now?” A sequence of runs answers “what is getting better, worse, or staying put?” Pass --state-dir and pgdba persists snapshot.json; every later run compares against it.

  • baseline — the finding existed in the first recorded run
  • resolved — present before, gone now
  • new — not present before
  • unchanged — present in both

The report’s trend block carries runs_compared and the per-finding statuses; the new and resolved transitions are what alerting usually cares about (--warning/--critical thresholds operate on absolute counts, so pair them with trend review for direction of travel).

pgdba why <finding-id> reads the last report, so a cron run + pgdba why is a complete incident drill-down with no dashboard.