finish-interview

name	finish-interview
description	Apply repeatable dialogue MA, Studio-based or automatic portrait reframing, overlay-safe rendering, and loudness/sync QA to an existing interview or talking-head rough cut. Use when the user asks to make speech easier to hear, perform MA, enlarge or rebalance a person in frame, crop or punch in an interview, automatically propose framing, or prepare a finishing preview before final approval.

Finish Interview

Use canonical timeline metadata and the shared renderer. Do not handwrite a one-off ffmpeg graph unless the project's downstream overlay format cannot be represented by the timeline.

Workflow

1. Read 05_timeline/timeline.json, 06_review/review_patch.json, the latest preview, and any downstream card/caption artifacts.
2. Measure before changing:
   • create a representative frame contact sheet;
   • measure integrated LUFS, true peak, and LRA;
   • probe video/audio start times and durations;
   • record avg_frame_rate, r_frame_rate, and time_base; treat a phone source whose cadence cannot be proven CFR as VFR for sync review.
   • when choosing framing automatically, run .build/debug/videoos-studio-cli interview-reframe --source=<video> --in-us=<n> --out-us=<n>;
   • treat its face/eye/yaw/hand result as a proposal, then inspect representative frames.
3. Keep editorial timing unchanged unless the user separately requests a cut. For a titled J-cut opening, stage information instead of presenting exterior, title, and dialogue at the same instant: establish the exterior, let the title read, then fade dialogue in before the title exits. Enter the interview on a moving source frame, never a frozen bridge frame. Preserve the complete final utterance and a short moving-picture tail; do not extend the ending with a freeze frame.
4. Write review patch operations:
   • one change_visual_transform per affected video clip;
   • one timeline-level change_audio_finish operation. Studio can author both operations from the selected clip's インタビュー仕上げ inspector. Adjusted framing appears immediately in the Viewer; press 画角を保留 and MAを保留 before Apply & Preview.
5. Apply the patch with scripts/compile-timeline.ts --patch and require schema validation to pass.
6. Render the clean assembly first. Burn captions and insert question cards afterward so zoom/crop never scales authored graphics.
7. Verify the final preview by full decode, loudness measurement, visual frame sampling, audio/video duration comparison, and dialogue placement QA. The duration comparison alone is insufficient: package QA must show dialogue_timeline_alignment_valid as well as av_drift_valid.

Patch pattern

{
  "timeline_version": "1",
  "operations": [
    {
      "op": "change_visual_transform",
      "target_clip_id": "CLP_0001",
      "visual_transform": {
        "zoom": 1.15,
        "position": { "x": -144, "y": -39 }
      },
      "reason": "Increase portrait presence while preserving look room"
    },
    {
      "op": "change_audio_finish",
      "audio_finish": {
        "preset": "dialogue-clean",
        "loudness_target_lufs": 
         
      
       
    
  

position is measured in output pixels. Negative x shifts the image left; negative y shifts it upward. Start around zoom: 1.10–1.18 for a restrained talking-head punch-in and inspect hand gestures across the whole cut.

For zoom > 1, position pans inside the available zoom overscan and clamps at the source boundary. Do not recreate the old post-crop pad/translate graph; it exposes black edges. The automatic planner normally caps an interview punch-in at 1.18, reduces it when hands are detected, and allows stronger zoom only when the detected face is genuinely small.

Audio presets

• dialogue-clean: 70 Hz high-pass, gentle noise reduction, mud/presence EQ, 3:1 compression, and measured two-pass loudness normalization.
• loudness-only: measured two-pass normalization without cleanup or EQ.
• none: disables the declared finish preset.

Defaults target -16 LUFS, LRA 7, and -1.5 dBTP. The dialogue preset keeps 0.3 dB of codec headroom before AAC encoding.

QA contract

• No cropped head, hands, or interviewer look room in representative samples.
• Captions and question cards retain their authored size and position.
• Integrated loudness is within 0.5 LU of target.
• Encoded true peak does not exceed the declared target by more than 0.2 dB.
• Audio/video start at zero and end within one frame.
• Dialogue-only signal stays inside the timeline windows that own dialogue. adelay=...,atrim=start=0 on one input branch is forbidden because the trim removes the inserted lead-in; source atrim must precede adelay, and only the final mixed output may be duration-trimmed.
• For VFR phone footage, first choose the intended video frame, then measure the video and audio source offsets independently. If frame quantization leaves a sub-frame residual, keep the chosen picture frame and offset audio by the measured residual. Do not chase sync by repeatedly moving the video trim across frame boundaries.
• A proxy or alternate encode made to diagnose a player is diagnostic only. It must not become the canonical creative output or constrain title/J-cut timing.
• Full ffmpeg decode exits successfully.
• Keep preview output distinct from final package output until caption and review gates are approved.