What this PR does / why we need it:
Special notes for your reviewers:
AI-generated PR explainer (required when AI-generated code is included):
If applicable:
- this PR contains user facing changes - docs added
- this PR contains unit tests
Before marking ready for review
- I reviewed every changed line since the latest update, including generated or agent-assisted changes.
- I ran the relevant local checks and recorded the commands and results above.
- I confirmed the description matches the final diff and documents any missing coverage or compatibility concerns.
- I confirmed every commit has a DCO
Signed-off-bytrailer. - I stated whether AI assistance was used in Special notes for your reviewers.
- If AI-generated code is included, this PR is a draft and its title, description, and bilingual HTML explainer all match the current head.
- The HTML explainer is detailed enough for a reviewer without prior context, and its diagrams, optional motion, code walkthrough, and test rationale match the implementation.