Skip to content

feat(cli): doctor names the tested ffmpeg build and says loudness is only comparable on it - #6566

Merged
miguel-heygen merged 5 commits into
mainfrom
fix/doctor-ffmpeg-tested-build
Oct 27, 2026
Merged

miguel-heygen merged 5 commits into
mainfrom
fix/doctor-ffmpeg-tested-build

Conversation

@miguel-heygen

Copy link
Copy Markdown
Collaborator

What

hyperframes doctor now says which ffmpeg build is the tested one (8.0.1, what CI, the render images and the regression baselines run). On any other build the FFmpeg row adds "loudness numbers are only comparable on 8.0.1"; on the tested build it says "(tested build)". No warning in check.

Why

The render closes a loop on the encoded AAC: it measures the true peak, then re-encodes with a corrective gain so the peak stays under -1 dBFS. That gain follows the encoder build's own peak. The same fixture gets -5.3 dB of correction on ffmpeg 7.0.2 and -4.6 dB on 8.0.1, which is a 0.7 dB loudness gap (-7.0 vs -6.3 LUFS in a normal local render). The mix graph, amix and a plain AAC encode are identical across the two builds, so this is not a bug to fix in the engine; the honest answer is to say which build the numbers are tied to.

Single owner

TESTED_FFMPEG_VERSION in doctor.ts is the one string the CLI uses. A test fails if the CI install action, Dockerfile.render or the Cloud Run Dockerfile stop naming that version, so a pin bump cannot leave the doctor text stale.

Why under 100 lines

One constant, one pure function, one call site, and a test that ties the constant to the three pins; nothing else carries the note.

Tests

doctor.test.ts: the tested and other-build wording, and the pin check (fails when the constant is bumped alone). Ran 3 times green on a Linux box.

@heygengenesis heygengenesis Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Verdict: REQUEST CHANGES · 1 blocker · 0 important · 1 nit · head 583471f8

CI is green. The pin check leaves out the image that produces the regression baselines, so the PR's "a pin bump cannot leave the doctor text stale" holds for only three of the four 8.0.1 pins. Details inline.

— Genesis

Comment thread packages/cli/src/commands/doctor.ts Resolved

@heygengenesis heygengenesis Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Verdict: APPROVE — 2 resolved, 0 open, 0 new · 583471f → 4edd34d

@miguel-heygen
miguel-heygen added this pull request to the merge queue Oct 27, 2026
Merged via the queue into main with commit 98e7743 Oct 27, 2026
66 checks passed
@miguel-heygen
miguel-heygen deleted the fix/doctor-ffmpeg-tested-build branch October 27, 2026 16:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant