Reports

Pick one or more formats with -f (comma-separated). All reports are single, self-contained files.

HTML

mrd scan . -f html -o report.html --open

A standalone dashboard: overall score ring, the four axes, an executive summary, top issues, quick wins, and every finding with evidence and a fix. It has light/dark themes and works offline (no CDN) — good for sharing or uploading as a CI artifact.

JSON

mrd scan . -f json -o report.json

The full result as structured JSON: score, axes, file stats, and the complete findings array (id, severity, confidence, category, description, evidence, suggested fix). Use it to build dashboards or gate CI on specific checks.

Markdown (for AI)

mrd scan . -f md -o report.md

A compact, self-describing Markdown report designed for LLMs. It opens with a one-line schema note, then the score, a summary, and findings grouped by severity — each with a stable id, why it matters, and a concrete fix. Paste it into an AI assistant and ask it to fix the issues.

Severity & scoring

Each finding has a severity (critical · high · medium · low · info). Findings roll up into four 0–100 axes — size · speed · stability · hygiene — and an overall score with an A–F grade. See the Checks overview for what each severity means.