The report is the artifact that outlives the investigation: behavior, commit, root cause files, dependency links & the repro command in 1 place.

what it contains

crux report takes a behavior with a stored signature & renders the chain. The blamed commit comes from a search over the recent range. Root causes are the files that commit actually touched, not the whole suspect list. Dependency links appear when root causes hit vendored paths. The repro line prints the exact crux replay command for the finding.

formats

Terminal output uses bold labels & reads like a witness statement. json carries the same fields for tooling. Watch writes the richest variant automatically: markdown drift reports under .crux/reports/ add the essential diff & now-versus-then output excerpts, ready to paste into a pull request.

the principle

Every claim links to evidence crux produced: a search result, a verified minimization, a replay verdict. Nothing in the report is inferred from a version number or file name alone.

edit this page