fix(producer): wire --crf and --video-bitrate CLI overrides into encoders

[vanceingalls]

Summary

Re-wire the --crf and --video-bitrate CLI flags through the three encoder spawn sites in renderOrchestrator.ts. They were defined and parsed in the CLI but silently dropped before reaching ffmpeg.

Why

Chunk 10 of plans/hdr-followups.md. PR #292 originally wired these through with a baseEncoderOpts object using effectiveQuality/effectiveBitrate; PR #268 rewrote the encode paths and reverted to preset.quality only, accidentally dropping the override. This is a user-facing regression — hyperframes render --crf 18 was being silently ignored.

What changed

• At the three encoder spawn sites (HDR streaming, SDR streaming, disk-based encode), quality defaults to preset.quality but is overridden by job.config.crf when set, and bitrate is set from job.config.videoBitrate. Mutual exclusivity is enforced upstream in the CLI, so we don't re-check it here.
• Fix the contradictory note in docs/packages/cli.mdx that claimed CRF/bitrate were now driven only by --quality. The flags table now lists --crf and --video-bitrate consistent with docs/guides/rendering.mdx.

Test plan

• hyperframes render --crf 18 ... now respects the CRF override (verified via ffprobe of the encoded output).
• hyperframes render --hdr ... still works (no behavior change at the default path).
• hyperframes render --help shows all flags consistent with the docs.

Stack

Chunk 10 of plans/hdr-followups.md. Independent of all other chunks.

[vanceingalls]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• docs(engine): document __name polyfill and add regression test #385
• perf(producer): cache transfer-converted hdr image buffers per render job #384
• perf(producer): gate per-frame debug meta via optional isLevelEnabled #383
• perf(producer): hdr benchmark harness — --tags filter, peak heap/RSS tracking, bench:hdr script #382
• test(producer): extract frameDirMaxIndexCache to its own module and pin cross-job isolation #381
• test(engine): cover spawnStreamingEncoder lifecycle and cleanup paths #380
• test(engine): add ffprobe-unavailable fallback regression tests #379
• test(shader-transitions): add midpoint (p=0.5) regression invariants for all shaders #378
• test(engine): lock down sRGB→BT.2020 LUT with byte-exact reference values #377
• build(lfs): track tests/*/src/*.png via Git LFS #376
• test(hdr-regression): tighten Window F maxFrameFailures budget after Chunk 4 fix #375
• fix(engine,shader): handle matrix3d transforms and hide non-first scenes #374
• refactor(producer): extract HDR compositing helpers and rename media metadata #373
• fix(producer): wire --crf and --video-bitrate CLI overrides into encoders #372 👈 (View in Graphite)
• fix(producer): tighten resource lifecycle and harden file server #371
• feat(engine): wire options.hdr through chunkEncoder + dynamic SDR→HDR transfer #370
• test(hdr-regression): tighten Window C maxFrameFailures budget after Chunk 1 fix #369
• fix(engine): stop clobbering native <video> opacity in HDR pipeline #368
• refactor(shader-transitions): extract DEFAULT_DURATION and DEFAULT_EASE constants #367
• refactor(types): tighten type safety, dedupe HfTransitionMeta, prune dead LUT export #366
• test(producer): add hdr-regression and hdr-hlg-regression test suites #365
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.