packages feed

kenshou-cli-0.1.0.0: help/diagnostics.md

# Diagnostics

Re-evaluate the sampled series from a completed run without changing its sealed
artifacts:

    kenshou diagnose leak RUN_DIR

Render saved watchdog captures, rebuild their classification, or export the
PostgreSQL wait graph as Graphviz DOT:

    kenshou diagnose stall RUN_DIR
    kenshou diagnose stall RUN_DIR --reclassify --dot wait-graph.dot

Rerun a scenario under a bounded heap profile or GHC event log:

    kenshou diagnose profile SCENARIO --mode closure-type
    kenshou diagnose profile SCENARIO --mode info-table
    kenshou diagnose profile SCENARIO --mode eventlog --classes gu

Diagnosis uses the ordinary process exit contract: 0 means no finding, 1 means
a finding was confirmed, 2 is invalid usage, 3 means insufficient evidence, and
4 is an input, execution, or infrastructure error. See
`docs/guides/diagnosing-leaks-and-stalls.md` in the source distribution for the
full investigation workflow.