[GLinnik21]

Fifth PR of the playback-refusal series (#918). It is stacked on #1062 (S2b), so the diff shown is S3 only.

No production change. Under Force Direct Play, audio this install has learned the TV refuses is already refused before any Load. The refusal names the codec and offers "Switch to Auto and play". This PR adds the tests that pin that behaviour, so a later change cannot quietly send the refused stream to the pipeline again.

Closes #1048

Why there is no code change

• Force Direct Play refuses a learned refusal before the Load #1048 assumed that main sends a learned-refused track to the pipeline under Forced. It does not. Since Audio: per-TV Opus limits, and formats the player learns to avoid #1034, main's Forced gate reads the global capability value, and the learned rows were folded into that value.
• S0 (Route: one capability value per playback request; the planner reads no global #1054) and S2b (Playback: the capability answer is fixed at boot; each play start applies the stored refusals itself #1062) moved the same check onto the attempt's start value: devcaps::start_caps over the session's applied rows. Here is the chain for a DTS 5.1 file on a set that announces DTS 6ch and has an applied dts 6 row:
  1. Caps::minus sets native_ceiling["dts"] = 2.
  2. forced_feeds_audio_track("dca", 6) rejects the track, so the Forced pick has no eligible track.
  3. The Forced gate (route/plan.rs) returns ForcedFailure::Audio { codec: "DTS" } before plan.url is set, so no Engine starts and no Load is issued.
• Every other Forced path reads the attempt or the start value. That includes the in-film track switch, the preview, the HUD and track menu, retry, Switch to Auto, queue items, the next episode, and the in-flight re-resolve. The engine's three boot reads cover video only.
• A file with an AC3 5.1 sibling plays the sibling under Forced. That is the existing stand-in rule, forced_direct_play_keeps_its_stand_in.

Tests

• forced_direct_play_refuses_a_learned_refusal_before_the_load (route tier). Forced plus a stored named dca 6 row, planned from start_caps, gives:
  • ForcedFailure::Audio { codec: "DTS" };
  • an empty plan.url;
  • a read-out that names DTS.
• forced_direct_play_plays_the_ac3_sibling_of_a_learned_dts (route tier). The same row with an AC3 sibling: there is no verdict, the part URL is planned, and every hasMDE=1 probe names audioStreamID=2.
• the_play_start_value_lacks_an_applied_refusal (app crate). This is the first test of the app's start_caps() wrapper:
  • with no row, the boot Arc itself;
  • with a row, a new value that lacks DTS 5.1 and that Forced will not feed;
  • the boot value is untouched.
• The route tests needed cold_audio_resolve_held, a split of cold_audio_resolve for a caller that already holds the test serial lock (TempSession and the firmware door must be built under it). The 15 existing callers are unchanged.

Red, observed by mutation. No landed tree fails these tests, because main since #1034 also refuses. Each mutation was reverted before the commit:

• The app wrapper returns devcaps::caps(): the_play_start_value_lacks_an_applied_refusal fails with a row in force makes a new value.
• The Forced pick reads devcaps::caps() instead of &env.caps: both route tests fail. The refusal test gets no verdict; the sibling test's probe names audioStreamID=1.
• audio_direct_plays_with's Forced arm calls forced_feeds_audio instead of forced_feeds_audio_track. Both fail with:
  • a learned DTS refusal must refuse under Force Direct Play before the Load, got None
  • Forced must name the AC3 sibling (stream 2), not the learned DTS (stream 1)

There is no ui-sim capture: the read-out code is unchanged, and forced_audio_refusal_names_the_codec already pins its sentence.

Crate runs on the committed tree:

• make test-crate C=plx_media T=forced_direct_play: test result: ok. 7 passed; 0 failed; 0 ignored; 0 measured; 1863 filtered out
• make test-crate C=plx_media T=forced: test result: ok. 58 passed; 0 failed; 0 ignored; 0 measured; 1812 filtered out
• make test-crate C=app T=the_play_start_value: test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 1059 filtered out

The full gates are left to this PR's CI.

Docs

player/CLAUDE.md: one sentence saying that under Force Direct Play a row in force refuses before any Load, with the codec named.

🤖 Generated with Claude Code