@oh-story/dsh 0.1.12 → 0.1.13

package/lib/video-recap/skills/video-assemble/SKILL.md

@@ -12,9 +12,10 @@ description: >
 本技能负责最终合成：
 
 1. 把各段旁白音频放到视频时间线上。
-2. 在旁白窗口内压低原声，支持 fixed / sidechain / zone 模式。
-3. 根据旁白位置生成 `subtitles.srt`；默认同时生成并烧录 `subtitles.ass`，`--no-burn-subtitles` 可关闭。
-4. 可选把最终响度标准化到目标 LUFS。
+2. 在旁白窗口内用固定包络压低原声（盖住原声对白时与落在安静段时各用一档音量），间隙恢复原声。
+3. 根据旁白位置生成 `subtitles.srt`；默认同时生成并烧录 `subtitles.ass`，`--no-burn-subtitles` 可关闭。不烧录时（关闭或降级），`subtitles.srt` 复制到成片旁，名为 `recap_<stem>.srt`；烧录时删掉旧的同名外挂字幕。
+4. 可选把最终响度标准化到目标 LUFS：两遍 loudnorm，只用一个恒定增益，不做动态压缩；混音的真峰值放不下这么大的增益时，先过 4 倍过采样的真峰值限幅器（最多削 `LOUDNESS_LIMITER_MAX_DB`，默认 6 dB），超出部分才下调目标响度。真峰值目标针对交付的 AAC 文件：AAC 编码会让真峰值比 PCM 混音高 0.3–1.4 dB，所以首次渲染瞄准 TP 下 0.5 dB，渲染后解码成片实测；仍超过 -1 dBTP 时按超出量再降 0.1 dB 只重编码音频（画面流复制），最多两次，仍超出则以 `delivered_true_peak_over_target` 阻断。ffmpeg 实际用的模式、限幅量与成片实测值记在 `assembly_qc.json` 的 `loudness_mode` 与 `loudnorm_final_pass`（`delivered`）。
+5. 成片不带原片的容器元数据（`title`、`comment` 等标签与章节）。
 
 ## 2. 声音收尾契约
 
@@ -69,21 +70,26 @@ python3 scripts/assemble.py <video> --work-dir <work_dir> \
 - 音频模式的处理与冻结语义见 `references/audio-modes.md`。默认仍为 `narration`；另外两种模式必须显式选择。
 - `--audio-mix-adoption` 只与显式 `--tts-meta`、`--narration-adoption` 同时使用；它保留 `narration` 模式名，但跳过旧速度/适配、原声 handoff、环境 BGM、duck、loudnorm 和 limiter。
 - 音频按轨道混合：原声、可选 BGM 与旁白各自独立。
+- 段落首块（与上一块作者留白超过 1.6 秒）从写的 `start` 放置，但不早于上一块实际结尾加它的 `pause_after_ms`，上一块超时会把它往后推；段落内后续块紧接上一块的实际结尾（间隔 0.35 秒），最多比写的 `start` 提前 1.2 秒。这一提前发生在旁白校验之后，所以提前的那一段不能进入原声对白：有对白时最多提前到最后一段对白结束处。真的提前了的块在 `source_entry_status` 记 `paragraph_tightened`，并在 `written_start` 记写的 `start`。
 - 旁白不做任何容差裁尾；温和加速后仍放不下即 `no_safe_fit`。每段 `_placed_*.wav`
   必须与序列化后的时间线区间等长或更短，否则 `timeline_audio_mismatch` 阻断。
 - 已采用配音的 v1 合同只支持原速、禁止段内适速；不能让环境默认 1.15 倍速或旧缓存覆盖它。放不下就修订安排，不裁尾。严格运行使用新工作目录与新输出路径；输入/实际混音来源变动或 QC 失败时，不发布候选成片。没有采用文件的旧入口仍是兼容模式，不自动获得同等证据。
-- 原声在旁白结束后保持压低到下一可靠句末的 `pause_start`，只在实测停顿内渐强，
-  于 `source_restore_at` 回满；无后续锚点时保持压低到时间线末端，而不是放出半句。
+- 原声在旁白结束后最多再压低 3 秒，等这段时间内的下一个句末锚点：压到它的 `pause_start`，只在实测停顿内渐强，
+  于 `source_restore_at` 回满（锚点为 `unverified` 时状态记 `sentence_boundary_unverified`）。3 秒内没有锚点时，
+  离时间线末端不足 3 秒就压到末端（`held_to_timeline_end`），否则在旁白结束处直接回满（`bounded_release`），
+  不为远处的锚点长时间压住原声对白。`assembly_qc.json` 的 `summary.max_source_duck_hold_seconds` 记录最长的压低延续。
 - `--export-jianying` / `EXPORT_JIANYING=1` 可把 `timeline.json` 导出为可编辑草稿。cut 模式应传 `--source-video <orig>`，让草稿引用真实原片区间。
 - 剪映导出默认把视频、音频与图片复制到 `Resources/local/{video,audio,image}`，保持草稿可搬迁；`--jianying-no-bundle-media` 只适合原路径始终可访问的情况。
 - 重叠覆盖物会拆到编号轨道；非空目标目录不会覆盖，而会创建编号兄弟目录。
-- 常速、倒放、变换、富文本、转场、蒙版、LUT、绿幕复合草稿及显式特效轨道通过 timeline v2 扩展表达。需要素材包的功能只接受调用方合法提供的离线资源。
+- 导出只接受 `schema_version: 2` 的 `timeline.json`，只映射视频、音频、字幕和图片叠层（`scale` / `position`）；变速、转场、蒙版、富文本、特效轨等手写扩展字段会被明确拒绝。
 - 剪映草稿引用未烧录的源视频，因此原片硬字幕仍会保留，必要时在剪映内另行遮罩。
 - 字幕外观可用 `SUBTITLE_FONT_SIZE`、`SUBTITLE_MARGIN_V`、`SUBTITLE_MAX_CHARS` 等控制。
-- `SUBTITLE_Y_TOP/BOT` 把 ASS 基线放到测得的原片字幕区域，坐标为半开 `[top, bot)`；显式遮罩策略下默认 `SUBTITLE_MASK_OPACITY=0.6`，`SOURCE_SUBTITLE_MASK_TIMING=narration`。
-- 原声在旁白间隙回到 `IDLE_ORIG_VOLUME`，旁白下压到 `SPEECH_DUCKING_VOLUME`；`DUCK_FADE_SECONDS` 控制过渡。还可配置 `DUCKING_MODE`、`ZONE_DUCKING_VOLUME`、`FINAL_LOUDNORM` 与 `TARGET_LUFS`。
+- `SUBTITLE_Y_TOP/BOT` 把 ASS 基线放到测得的原片字幕区域，坐标为显示画布上的半开 `[top, bot)`，只接受方形或近方形像素（SAR 与 1:1 相差不超过 2%，未标注的 `0:1` 按方形）；显式遮罩策略下默认 `SUBTITLE_MASK_OPACITY=0.6`，`SOURCE_SUBTITLE_MASK_TIMING=narration`。
+- 原声在旁白间隙回到 `IDLE_ORIG_VOLUME`，旁白下压到 `SPEECH_DUCKING_VOLUME`；`DUCK_FADE_SECONDS` 控制过渡。还可配置 `DUCK_BRIDGE_SECONDS`、`ZONE_DUCKING_VOLUME`、`FINAL_LOUDNORM`、`TARGET_LUFS` 与 `LOUDNESS_LIMITER_MAX_DB`。
 - 可通过 `BGM_PATH` 指定 BGM；它会循环到成片长度，并按 `BGM_VOLUME` / `BGM_DUCKING_VOLUME` 混音。不要在没有创作依据时设置通用 BGM。
-- 烧录字幕需要带 `subtitles` / libass 的 ffmpeg；合成阶段会预检并在缺失时明确失败。
+- 烧录字幕需要带 `subtitles` / libass 的 ffmpeg，合成阶段在渲染前预检。显式要求烧录（`--burn-subtitles` 或环境变量 `BURN_SUBTITLES`）时缺 libass 直接失败；只是默认开启时降级：不烧录，交付外挂 `.srt`（留白里的 `「」` 原声对白仅在有 `user_subtitles.*` 时照常写进去；原本由遮罩触发的对白随遮罩一起关闭，原片硬字幕可见），`visual_qc.json` 的 `warnings` 与 `assembly_manifest.json` 的 `warnings` 记一条 `subtitle_burn_degraded`，`subtitles.burn_degraded_reason` 写原因。降级后遮罩照旧关闭（`mask.trigger` 为 `burn_subtitles_degraded`）。
+- `visual_overlays.json` 的文字叠加用 ffmpeg `drawtext`（libfreetype）。缺 drawtext 时合成在渲染前失败；叠加是写稿时明确加的内容，不会被静默丢掉。
+- 成片画面一律是 H.264 8-bit 4:2:0 并带 `+faststart`：不需要滤镜、且源画面已是 H.264 8-bit 4:2:0（`yuv420p`，或全范围的 `yuvj420p`）、宽高为偶数时才流复制，原样交付；否则重编码为 `yuv420p`。色彩标记：源未标记或已是 BT.709 时标为 BT.709（`-colorspace/-color_primaries/-color_trc bt709`），其它已声明的色彩空间原样保留；全范围（`pc`）源保留 `pc`，其余标 `tv`。YUV 源只改标记，不转换像素；RGB 源（ffprobe 报 `gbr`，如 PNG/QuickTime RLE 封装的 MOV）没有 YUV 矩阵可保留，按 BT.709 limited 转换。结果记在 `assembly_qc.json` 的 `delivery_qc.color_tags`（RGB 源多一个 `from_rgb: true`）。
 - 原声留白中的对白字幕优先读取 Agent 校对的 `original_subtitles.json`；否则保守映射 ASR。只有遮罩覆盖留白或用户字幕明确要求替换时才烧录原声对白，并用 `「」` 与旁白区分。
 
 ### 按原片区间准备声音，而不是整体压低旧成片
@@ -96,9 +102,9 @@ python3 scripts/assemble.py <video> --work-dir <work_dir> \
 ## 7. 字幕与可选包装
 
 先锁定画面、剪点、旁白和混音，再投入字幕动画或边框包装；字幕样式不能掩盖叙事、剪点或声音问题。
-普通交付优先使用现有 ASS 路径；只有用户需要逐 cue 排版、动画或透明图层时，才用项目级代码渲染器，
-并按 `references/foreground-compose.md` 把它生成的 RGBA 序列叠到锁定母版。包装顺序与样帧抽检清单见
-`references/packaging.md`。
+普通交付优先使用现有 ASS 路径；整片不动的包框、标题条和角标用 `packaging_layers.json` 静态叠加；
+只有用户需要逐 cue 排版、动画或透明图层时，才用项目级代码渲染器，由该项目自己把透明层合成到锁定母版。
+包装顺序与样帧抽检清单见 `references/packaging.md`。
 
 ## 8. 能力边界
 
@@ -106,7 +112,3 @@ python3 scripts/assemble.py <video> --work-dir <work_dir> \
 - 字幕烧录默认开启；关闭时不会重编码绘制字幕区域。
 
 显式输出轴字幕轨的独立合同、完整替换语义和当前边界见 `references/subtitle-track.md`。
-
-画面回原片重建后，若需保留另一文件中的已采用完整混音，先按
-`references/pair-media.md` 显式配对独立画面与音轨。配对只复制流，不补字幕或片名卡；
-后续字幕轨必须重新绑定配对后的容器与 `a:0`，不能继续沿用旧版本身份。

package/lib/video-recap/skills/video-assemble/references/explicit-audio-mix.md

@@ -64,7 +64,9 @@ narration binding path, the final decoded PCM facts, the final AAC decoder/packe
 count/payload bytes, and the actual output picture decoder/frame clock. The output
 picture must preserve fps, frame count, zero start, and duration. A video-copy path
 reports `packet_identity: EXACT` when decoder parameters and packet sizes/timestamps
-are unchanged; an allowed visual re-encode reports `REENCODED_CLOCK_MATCH`. Timeline,
+are unchanged; an allowed visual re-encode reports `REENCODED_CLOCK_MATCH`. The colour
+labels (`color_range` / `color_space` / `color_transfer` / `color_primaries`) are left out of
+that comparison, because the final render deliberately labels an untagged picture BT.709. Timeline,
 settings, QC, and manifest identify the explicit path rather than reporting ambient
 ducking/BGM/loudnorm operations.
 

package/lib/video-recap/skills/video-assemble/references/jianying/SOURCE.md

@@ -4,12 +4,12 @@ These JSON protocol templates are pinned to
 [`duoec/duo-video`](https://github.com/duoec/duo-video) commit
 `ef4eb46c823910553f901649f2f13fd7575e748f`, under its MIT license. They are
 data/schema baselines, not executable upstream code. Runtime builders deep-copy
-the templates and replace authored values such as IDs, paths, timings, canvas
-dimensions, and resource configuration.
+the templates and replace authored values such as IDs, paths, timings, and canvas
+dimensions. Only the templates the exporter builds from are kept; the nested
+compound-draft templates were dropped together with green-screen export.
 
 The required copyright and permission notice is preserved in
 `LICENSE.duo-video` in this directory.
 
-The exporter never uses duo-video's embedded example credentials. Resource-ID
-features accept an offline `material` or `resource_config` payload so official
-resource packages can be supplied legally by the caller.
+The exporter never uses duo-video's embedded example credentials and never
+emits resource-ID materials (stickers, effects, transitions, text templates).

package/lib/video-recap/skills/video-assemble/references/packaging.md

@@ -13,9 +13,9 @@
 4. 渲染完整透明字幕层，再 overlay 到锁定母版；合成后确认音轨未被意外改写。
 5. 完整播放实际最终文件，并复查字幕遮脸、跳字、断行、首尾帧和边界处残影。
 
-已有项目级渲染器能输出精确包装时，使用 `foreground-compose.md` 将它生成的 RGBA 序列叠到锁定母版，
-而不是用通用白字黑框近似品牌样式。该操作保留实际帧钟和 AAC 包，不生成字体或文案；只有通过验证的
-新文件才写入新目录。片名卡有渐显或动画时须提供完整序列，不能冻结最后一张图代替。
+已有项目级渲染器能输出精确包装时，由该项目自己把它生成的透明层合成到锁定母版，而不是用通用白字黑框
+近似品牌样式；本技能不提供逐帧前景合成命令。合成时音轨按流复制，合成后核对帧率、时长与音轨未被改写，
+再写入新文件。片名卡有渐显或动画时须渲染完整序列，不能冻结最后一张图代替。
 
 ## 静态包装图层 `packaging_layers.json`
 
@@ -37,7 +37,7 @@
 - `timeline.json` 同时得到对应的 image 轨，剪映草稿里的包框可单独编辑。
 - `assembly_manifest.json` 的 `video_filters.packaging_layers` 记录每张图片的路径与 `{size, mtime_ns}`。
 - 编排器按项目绑定的 `packaging` 模板写出这个文件时会带 `written_by` 标记；
-  手写的文件不会被它删除。有渐显或动画的包装仍走 `foreground-compose.md`。
+  手写的文件不会被它删除。有渐显或动画的包装仍由项目级渲染器自行合成。
 
 ## 原则
 

package/lib/video-recap/skills/video-assemble/references/subtitle-track.md

@@ -15,7 +15,7 @@ from subtitles.track import load_subtitle_track
 loaded = load_subtitle_track(
     "subtitle_track.json",
     expected_picture_identity={
-        "path": "/project/paired.mp4",
+        "path": "/project/master.mp4",
         "edit_plan": "/project/edit_plan.json",
     },
     expected_audio_identity={
@@ -66,7 +66,7 @@ reports the labels present; it is not an aggregate precision verdict.
   "overlap_policy": "forbid",
   "bindings": {
     "picture": {
-      "path": "/project/paired.mp4",
+      "path": "/project/master.mp4",
       "edit_plan": "/project/edit_plan.json"
     },
     "audio": {
@@ -105,8 +105,8 @@ reports the labels present; it is not an aggregate precision verdict.
 - `attribution.kind` is `source` or `narration`; `ref` identifies the source
   utterance or narration item without changing its text.
 - Unknown fields and schema versions other than integer `1` are rejected, so a
-  newer producer cannot be silently interpreted as v1. Legacy `sha256` /
-  `edit_sha256` binding keys are the one exception: they are ignored.
+  newer producer cannot be silently interpreted as v1. That includes `sha256` /
+  `edit_sha256` binding keys.
 
 ## Independent binding checks
 
@@ -175,12 +175,12 @@ as current facts.
 Actual decoded frame PTS are read before projection. Integer cue ticks and the
 rational timebase are retained until each boundary is resolved to the first
 frame at or after it. `subtitle_track_validation.json` records original ticks,
-resolved frame indexes/PTS, quantization deltas, ASS thresholds, validation
-schema and projector version. SRT and timeline consume resolved frame seconds;
-ASS thresholds are chosen to switch on those same frames despite ASS's 10ms
-clock. A cue with no visible frame, or a boundary that ASS cannot distinguish,
-is rejected rather than silently dropped. The original author file is not
-rewritten. Legacy subtitles keep their previous rendering behavior.
+resolved frame indexes/PTS, quantization deltas and ASS thresholds. SRT and
+timeline consume resolved frame seconds; ASS thresholds are chosen to switch on
+those same frames despite ASS's 10ms clock. A cue with no visible frame, or a
+boundary that ASS cannot distinguish, is rejected rather than silently dropped.
+The original author file is not rewritten. Legacy subtitles keep their previous
+rendering behavior.
 
 Each consumption re-checks the track/media/optional edit plan `{size, mtime_ns}`
 and the consumer duration; a rewritten input is stale and must be prepared

package/lib/video-recap/skills/video-assemble/scripts/adoption/audio_mix_binding.py

@@ -7,7 +7,7 @@ import subprocess
 from assemble_constants import frame_clock_samples
 from adoption.frozen_audio import probe_audio_packets
 import adoption.narration_binding as narration_binding
-from pair_media import probe_picture, validate_pair_timing
+from adoption.av_clock import probe_picture, validate_pair_timing
 import source_score
 from adoption.strict_inputs import (
     read_json_bytes, require_fields, require_integer, require_local_path, require_number,
@@ -204,6 +204,16 @@ def render_explicit_mix(context, narration_context, tts_segments, work_dir):
     return runtime
 
 
+_COLOR_TAG_KEYS = ("color_range", "color_space", "color_transfer", "color_primaries")
+
+
+def _without_color_tags(picture):
+    """The picture identity minus the colour labels the final render writes on purpose
+    (an untagged copied picture gains BT.709 tags; its packets stay the same)."""
+    decoder = {k: v for k, v in picture["decoder"].items() if k not in _COLOR_TAG_KEYS}
+    return {**picture, "decoder": decoder}
+
+
 def finalize_binding(context, narration_record, rendered_output, final_output, work_dir):
     """Probe the rendered candidate and write ``audio_mix_binding.json`` into work_dir."""
     if not context.get("runtime"):
@@ -216,7 +226,8 @@ def finalize_binding(context, narration_record, rendered_output, final_output, w
         if output_clock[key] != input_clock[key]:
             raise ValueError("rendered output picture frame clock changed")
     packet_identity = (
-        "EXACT" if output_picture == context["picture_identity"]
+        "EXACT"
+        if _without_color_tags(output_picture) == _without_color_tags(context["picture_identity"])
         else "REENCODED_CLOCK_MATCH"
     )
     audio = probe_audio_packets(rendered, 0)

package/lib/video-recap/skills/video-assemble/scripts/adoption/av_clock.py

@@ -0,0 +1,109 @@
+"""Exact picture and AAC clocks for the frozen-audio adoption paths.
+
+``probe_picture`` reads the full CFR presentation clock of a picture stream;
+``validate_aac_packet_interval`` proves an AAC stream's packets tile its header
+interval; ``validate_pair_timing`` checks the two intervals agree within one frame
+or one AAC packet. These are narrow container-clock gates, not a perceptual
+synchronization verdict.
+"""
+
+from fractions import Fraction
+
+from assemble_constants import SUPPORTED_PICTURE_CODECS
+from adoption.strict_inputs import probe_json
+
+
+def _time(value):
+    if value in (None, 'N/A'):
+        raise ValueError('Missing media timing')
+    try:
+        return Fraction(str(value))
+    except (ValueError, ZeroDivisionError) as exc:
+        raise ValueError('Invalid media timing') from exc
+
+
+def probe_picture(path):
+    """Actual full CFR presentation clock plus codec-order packet sizes and timestamps."""
+    data = probe_json(path, '-select_streams', 'v:0', '-show_streams', '-show_packets',
+                  '-show_format', '-show_entries',
+                  'format=format_name:stream=codec_name,profile,level,width,height,pix_fmt,'
+                  'sample_aspect_ratio,field_order,color_range,color_space,color_transfer,'
+                  'color_primaries,chroma_location,time_base,start_pts,duration_ts,avg_frame_rate'
+                  ':packet=pts,dts,duration,size,side_data_list')
+    streams = data.get('streams', [])
+    if len(streams) != 1 or streams[0].get('codec_name') not in SUPPORTED_PICTURE_CODECS:
+        raise ValueError('Picture clock requires one selected H264/HEVC picture stream')
+    if 'mp4' not in data.get('format', {}).get('format_name', '').split(','):
+        raise ValueError('Picture clock currently requires an MP4-family container')
+    v = streams[0]
+    fps, tb = _time(v.get('avg_frame_rate')), _time(v.get('time_base'))
+    if not 1 <= fps <= 120 or tb <= 0 or v.get('start_pts') != 0:
+        raise ValueError('Picture requires positive CFR and a known zero start')
+    duration = _time(v.get('duration_ts')) * tb
+    frames = probe_json(path, '-select_streams', 'v:0', '-show_frames',
+                    '-show_entries', 'frame=pts')['frames']
+    pts = [_time(frame.get('pts')) * tb for frame in frames]
+    if not pts or any(t != Fraction(i, fps) for i, t in enumerate(pts)) or duration != len(pts) / fps:
+        raise ValueError('Picture requires complete zero-origin CFR frame clock and exact duration')
+    decoder_keys = ['codec_name', 'profile', 'level', 'width', 'height', 'pix_fmt',
+                    'sample_aspect_ratio', 'field_order', 'color_range', 'color_space',
+                    'color_transfer', 'color_primaries', 'chroma_location']
+    packets = []
+    for packet in data.get('packets', []):
+        if packet.get('size') is None:
+            raise ValueError('Picture packet missing size')
+        ticks = {key: str(_time(packet.get(key)) * tb) for key in ['pts', 'dts', 'duration']}
+        if _time(ticks['duration']) <= 0:
+            raise ValueError('Picture packet has invalid duration')
+        packets.append({**ticks, 'size': int(packet['size']),
+                        'side_data_list': packet.get('side_data_list', [])})
+    if len(packets) != len(pts):
+        raise ValueError('Picture packet/frame counts disagree')
+    return {'decoder': {key: v.get(key) for key in decoder_keys}, 'packets': packets,
+            'frame_pts': [str(t) for t in pts], 'frame_count': len(pts), 'fps': str(fps),
+            'duration': str(duration), 'start': '0'}
+
+
+def validate_aac_packet_interval(audio):
+    """Validate exact AAC packet continuity against the stream-header interval."""
+    if audio['codec'] != 'aac':
+        raise ValueError('Adopted audio must be AAC')
+    packets = audio['packets']
+    rate = audio['sample_rate']
+    if type(rate) is not int or rate <= 0 or len(packets) < 2:
+        raise ValueError('AAC packet timing is incomplete')
+    nominal = _time(packets[0]['duration'])
+    # Accept known AAC frame sample counts, never an arbitrary huge duration.
+    if nominal * rate not in {960, 1024, 1920, 2048}:
+        raise ValueError('Unsupported AAC nominal packet duration')
+    for i, packet in enumerate(packets):
+        d = _time(packet['duration'])
+        if d <= 0 or d > nominal or (i < len(packets) - 1 and d != nominal):
+            raise ValueError('Nonuniform or invalid AAC packet duration')
+        p, t = _time(packet['pts']), _time(packet['dts'])
+        if p != t:
+            raise ValueError('Unsupported AAC PTS/DTS difference')
+        if i and p != _time(packets[i-1]['pts']) + _time(packets[i-1]['duration']):
+            raise ValueError('AAC packet clock has gaps or overlaps')
+    audio_start, audio_duration = _time(audio['start_time']), _time(audio['duration'])
+    if audio_duration <= 0:
+        raise ValueError('Invalid audio interval')
+    audio_end = audio_start + audio_duration
+    first_pts = _time(packets[0]['pts'])
+    last_end = _time(packets[-1]['pts']) + _time(packets[-1]['duration'])
+    if (not 0 <= audio_start - first_pts <= nominal
+            or abs(last_end - audio_end) > Fraction(1, rate)):
+        raise ValueError('AAC packet clock does not match stream interval')
+    return audio_start, audio_end, nominal
+
+
+def validate_pair_timing(picture, audio):
+    """Narrow AAC/CFR compatibility; not a perceptual synchronization verdict."""
+    audio_start, audio_end, nominal = validate_aac_packet_interval(audio)
+    tolerance = max(1 / Fraction(picture['fps']), nominal)
+    end_delta = audio_end - Fraction(picture['duration'])
+    if abs(audio_start) > tolerance or abs(end_delta) > tolerance:
+        raise ValueError('Picture/audio interval mismatch; no implicit trim, padding, offset or retime')
+    return {'start_delta': str(audio_start),
+            'end_delta': str(end_delta),
+            'tolerance': str(tolerance), 'nominal_aac_packet': str(nominal)}

package/lib/video-recap/skills/video-assemble/scripts/adoption/strict_publish.py

@@ -30,7 +30,8 @@ def current_audio_mix_binding(work_dir, audio_mode):
 def publish_render(*, work_dir, binding, explicit_mix, tts_segments, narration_wav,
                    render_output, published_output, audio_mode, audio_operations,
                    adopted_audio, loudness_mode, loudnorm_measurement, visual_qc,
-                   source_has_audio, video_duration, render_delivery, source_audio_status):
+                   source_has_audio, video_duration, render_delivery, source_audio_status,
+                   loudnorm_final_pass=None):
     """Gate the rendered candidate on assembly QC and publish it with its bindings.
 
     Returns the final output path. Inactive-binding renders only write their
@@ -77,6 +78,7 @@ def publish_render(*, work_dir, binding, explicit_mix, tts_segments, narration_w
             source_has_audio=source_has_audio,
             loudness_mode=loudness_mode,
             loudnorm_measurement=loudnorm_measurement,
+            loudnorm_final_pass=loudnorm_final_pass,
             visual_qc=visual_qc,
             audio_mode=audio_mode,
             audio_operations=audio_operations,
@@ -103,6 +105,7 @@ def publish_render(*, work_dir, binding, explicit_mix, tts_segments, narration_w
                 tts_segments, video_duration, output_path=render_output,
                 source_has_audio=source_has_audio,
                 loudness_mode=loudness_mode, loudnorm_measurement=loudnorm_measurement,
+                loudnorm_final_pass=loudnorm_final_pass,
                 visual_qc=visual_qc, audio_mode=audio_mode,
                 audio_operations=audio_operations, adopted_audio=adopted_audio,
                 narration_input_binding=current_binding,

package/lib/video-recap/skills/video-assemble/scripts/artifacts.py

@@ -18,16 +18,9 @@ def _artifact_identity(path):
     return file_identity(path) if path.exists() else None
 
 
-def _explicit_source_video():
-    """Return the cut-mode source video only when the caller opted in explicitly."""
-    if not CONFIG["source_video_explicit"]:
-        return ""
-    return CONFIG["source_video"]
-
-
 def _source_video_identity():
-    """``{path, size, mtime_ns}`` of the explicit cut-mode source video, else None."""
-    source_video = _explicit_source_video()
+    """``{path, size, mtime_ns}`` of the cut-mode --source-video, else None."""
+    source_video = CONFIG["source_video"]
     if not source_video:
         return None
     path = Path(source_video)