MMnode/utils
Z User 4dccb4fb4c fix: surface the real FFmpeg compose failure instead of a generic error
merge_video_track_with_ffmpeg returned None for every failure mode (FFmpeg
missing, empty timeline, odd canvas, missing segment/locked-audio files,
spawn errors, non-zero exit), which collapsed into the useless
'FFmpeg could not compose the H3 project video' message users saw in the
ComfyUI error dialog.

Add an opt-in failure_reason collector: callers that need to surface the
cause (compose_h3_project_video) now pass a list and receive one specific
human-readable entry per failed precondition, or the FFmpeg stderr tail
(e.g. 'Unknown encoder libx264') when the command itself fails. The
nodes/basic.py tensor-merge fallback still uses the silent None contract
and is unchanged.

Verified with scripts/test_merge_failure_reason.py (16 stubbed checks:
every return-None path records a reason, compose propagates it).
2026-09-29 05:52:23 +00:00
..
__init__.py init 2026-09-26 11:11:23 -07:00
audio_gain.py init 2026-09-26 11:11:23 -07:00
audio.py feat: scrub EasyMedia/MiniMax branding from all user-facing output 2026-09-26 23:05:24 +00:00
bernini_s2v_model_patch.py init 2026-09-26 11:11:23 -07:00
bernini_s2v.py init 2026-09-26 11:11:23 -07:00
bernini.py init 2026-09-26 11:11:23 -07:00
h3_conditioning_cache.py feat: translate all cache/task console logs to English 2026-09-26 23:27:09 +00:00
h3_presets.py init 2026-09-26 11:11:23 -07:00
h3_project.py fix: surface the real FFmpeg compose failure instead of a generic error 2026-09-29 05:52:23 +00:00
image.py init 2026-09-26 11:11:23 -07:00
llm_api.py feat: revert editor to pristine upstream, drop format label mapping and T2V==R2V, fix editor delivery 2026-09-27 21:24:56 +00:00
log.py feat: scrub EasyMedia/MiniMax branding from all user-facing output 2026-09-26 23:05:24 +00:00
media.py feat: scrub EasyMedia/MiniMax branding from all user-facing output 2026-09-26 23:05:24 +00:00
minimax.py init 2026-09-26 11:11:23 -07:00
model_memory.py feat: scrub EasyMedia/MiniMax branding from all user-facing output 2026-09-26 23:05:24 +00:00
models.py feat: scrub EasyMedia/MiniMax branding from all user-facing output 2026-09-26 23:05:24 +00:00
multitrack.py init 2026-09-26 11:11:23 -07:00
panorama.py init 2026-09-26 11:11:23 -07:00
project_memory.py feat: scrub EasyMedia/MiniMax branding from all user-facing output 2026-09-26 23:05:24 +00:00
prompt_builder.py init 2026-09-26 11:11:23 -07:00
prompt_override.py init 2026-09-26 11:11:23 -07:00
rtx_vsr.py feat: display Moxie Multimedia on the format combo, keep MiniMax internally; silence the upscale console line 2026-09-27 03:52:43 +00:00
sampling_preview.py feat: scrub EasyMedia/MiniMax branding from all user-facing output 2026-09-26 23:05:24 +00:00
speech.py init 2026-09-26 11:11:23 -07:00
subtitles.py init 2026-09-26 11:11:23 -07:00
video.py fix: surface the real FFmpeg compose failure instead of a generic error 2026-09-29 05:52:23 +00:00
workflow_submission.py init 2026-09-26 11:11:23 -07:00