1 quality gate jsonl events and panel failure summaries
forgejo-actions edited this page 2026-07-13 19:45:35 +00:00

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.