Quality & Health

sate trace-report

Shipped

Reads execution-trace NDJSON, emits deterministic anomaly summary: outcome distribution, per-prefix quantiles, top repeated hashes, duration outliers.

What it does

Consumes a trace file produced by SATE's executor (.ai/execution-trace.ndjson) and produces a JSON summary. Groups by runId prefix, computes p50/p95/max per group, flags outliers > 3× median, surfaces the first REJECT_UNSAFE row, and lists the biggest consecutive-run duration jumps.

Who runs this

→Performance investigators after a slow CI run
→Engineers triaging a flaky test cluster

How to invoke

sate trace-report --project-root /path/to/laravel-app

Flags

--project-root <path>

Resolves to <root>/.ai/execution-trace.ndjson.

[positional path]

Path to an NDJSON file (takes precedence).

--trace <path>

Alternative trace path.

What it produces

·JSON report to stdout (~few KB)
·exit 2 if trace file is missing, with a friendly diagnostic

What it does NOT do

✖Does NOT produce traces — only reads existing ones
✖Does NOT modify the trace file

Status

Engine tests

Status

Shipped

Related pipelines

sate emit-learning-candidates

Opt-in: extracts STABLE_TESTHASH_PASS candidates from an execution trace for downstream review.