Quality-Gate JSONL Events And Panel Failure Summaries
Quality-gate JSONL events are the machine-readable run history that Control Panel uses for structured failure summaries instead of scraping raw command output.
Purpose
Use this page when a quality gate fails in the panel, but raw stdout does not explain which step failed or how the panel classified the failure.
Required Inputs
xtask quality-gate can write --events-jsonl under target/quality-gates. Events include step start, pass, fail, duration, action kind, command, and failure class. The panel prefers JSONL event files when building summaries.
Procedure
Run gates with --events-jsonl when the panel or automation needs structured status. Inspect the event file for step_failed and failure class before reading the entire stdout log.
Failure Modes
Missing, malformed, stale, or wrong-workspace event files force the panel back to less precise summaries. Nested gates, docs-check failures, engine-health thresholds, command exits, and setup failures should classify distinctly.
Verification
After a failure, confirm the JSONL file path, most recent timestamp, workspace root, failed step id, duration, and failure class. If the panel summary disagrees with CLI output, compare the event file with raw stdout.