fix(vmaf-tune): address report audit findings #2-#10 and document SVT-AV1-HDR knobs

[lusoris]

Summary

Lands the remaining nine findings (#2–#10) of docs/research/vmaftune-profile-report-audit-2026-05-27.md in the vmaf-tune report renderer (PR #852 had fixed only #1 and the 480px media query) and adds the SVT-AV1-HDR knob documentation that T-SVTAV1-HDR-ADAPTER-2026-05-20 still lacked. report.py: explicit kbps / Mbps axis and tick units, failed rows (ok=False) render — instead of 0 kbps / 0.00, VideoToolbox codecs get their own palette slots instead of aliasing libx264/libx265/libsvtav1, pareto annotations are deduplicated to the lowest-bitrate frontier point per codec with a bitrate suffix, the picked-CRF scatter and failed targets appear in a deduplicated legend, and savefig(..., metadata={"Date": None}) + a pinned svg.hashsalt make HTML/SVG output byte-identical across renders. cli.py: --json-sidecar on compare and report writes <output>.json (ReportData.to_dict()) next to the HTML/Markdown; ReportData.from_dict round-trips it. Docs: a new "SVT-AV1-HDR tuning knobs" section in docs/usage/vmaf-tune.md whose ranges and defaults were taken from juliobbv-p/svt-av1-hdr README + Docs/Parameters.md at commit 0033340 (2026-09-01, verified via the GitHub API), plus the --json-sidecar row and a cross-link in the libsvtav1 adapter row. Verification: cd tools/vmaf-tune && ruff check . && pytest tests/test_report.py tests/test_compare.py -q → All checks passed! / 40 passed; concat-changelog-fragments.sh --check exit 0; assertion-density.sh PASS (256 asserts / 151 functions); pre-commit green on every touched file. Not verified: an end-to-end encode against a live SVT-AV1-HDR FFmpeg build (no such binary on the workstation); the knob table is documentation of upstream defaults, not a behaviour the fork tests.

Type

• fix — vmaf-tune report renderer audit findings chore(docs): update mkdocs site_url to vmafx.github.io/vmafx #2–chore(deps): Update rocm/rocm-terminal Docker tag to v6.4 #10, --json-sidecar, SVT-AV1-HDR knob docs

Checklist

• Commits follow Conventional Commits.
• make format && make lint is green locally (pre-commit on every touched file).
• Unit tests: tools/vmaf-tune/tests/test_report.py (+7 tests, 4 new fixtures: compare v1/v2, ladder, per-shot) and tests/test_compare.py — 40 passed.
• Docs in the same PR: docs/usage/vmaf-tune.md (SVT-AV1-HDR tuning knobs section, --json-sidecar CLI row), docs/usage/vmaf-tune-codec-adapters.md (libsvtav1 row).
• SIMD/GPU, twins, new C sources, breaking change, ADR — n/a: Python renderer/CLI + docs only; no ADR (bug fixes + documentation, ADR-0644 / ADR-0294 already cover the design).

Bug-status hygiene (ADR-0165)

• docs/state.md — T-VMAFTUNE-PROFILE-REPORT-AUDIT-2026-05-20 and T-SVTAV1-HDR-ADAPTER-2026-05-20 moved from Open to Recently closed, two _Updated: lines added.

Netflix golden-data gate (ADR-0024)

• I did not modify any assertAlmostEqual(...) score in the Netflix golden Python tests.

Deep-dive deliverables (ADR-0108)

• Research digest — no digest needed: this PR closes out findings chore(docs): update mkdocs site_url to vmafx.github.io/vmafx #2-chore(deps): Update rocm/rocm-terminal Docker tag to v6.4 #10 of the existing audit docs/research/vmaftune-profile-report-audit-2026-05-27.md; no new research was required.
• Decision matrix — no alternatives: only-one-way fix. The audit prescribes each fix; the runtime-variant decision is already recorded in ADR-0644.
• AGENTS.md invariant note — no rebase-sensitive invariants: fork-only tools/vmaf-tune Python and docs.
• Reproducer / smoke-test command — below.
• CHANGELOG fragment — changelog.d/fixed/vmaftune-report-audit-findings.md, changelog.d/added/vmaftune-svtav1-hdr-knob-docs.md
• Rebase note — docs/rebase-notes.md entry (fix/vmaf-tune-report-audit-and-svtav1-hdr-knob-docs, no rebase impact).

Reproducer

source .venv/bin/activate
cd tools/vmaf-tune && ruff check . && pytest tests/test_report.py tests/test_compare.py -q
# All checks passed!
# 40 passed
python - <<'PY'
from vmaftune.report import _bitrate_tick_label, _CODEC_COLOURS
from vmaftune.codec_adapters import known_codecs
assert _bitrate_tick_label(1500) == "1.5 Mbps" and _bitrate_tick_label(800) == "800 kbps"
assert _CODEC_COLOURS["h264_videotoolbox"] != _CODEC_COLOURS["libx264"]
assert "libsvtav1" in known_codecs() and "svtav1-hdr" not in known_codecs()
print("ok")
PY
# ok
cd ../.. && bash scripts/release/concat-changelog-fragments.sh --check && echo changelog-ok
# changelog-ok

🤖 Generated with Claude Code