davinci-resolve-mcp 2.151.0 → 2.153.0

package/CHANGELOG.md

@@ -2,6 +2,47 @@
 
 Release history for the DaVinci Resolve MCP Server. The latest release is summarized in the root README; older entries live here to keep the README focused.
 
+## What's New in v2.153.0 — the QC loop learns fades
+
+### Added
+
+- **`editorial.verify_roundtrip` is fade-aware.** A correct fade conform
+  used to fail QC three ways: the re-export's Solid Color legs mismatched
+  the EDL's BL reels, the leg counts differed, and the fade boundary-shift
+  moved picture edges by half the transition. Now BL/Solid-Color legs
+  canonicalize to BLACK and drop out of the pairwise compare (counted in
+  `blackSegments`), picture edges inside an input junction's fade window are
+  excused into `fadeReshapedBoundaries` — reported, never silently absorbed
+  — and the per-source TC offset is fitted net of the record shift so a
+  source cut both plain and faded doesn't read as source-frames drift.
+  Live loop verified: EDL fades → conform → import → OTIO re-export →
+  `pass: true` with the reshape named. Beyond-window shifts and shifts at
+  junction-free edges still fail as real record drift.
+
+## What's New in v2.152.0 — AAF dissolves conform at last, and AAF fades join the family
+
+### Fixed
+
+- **No AAF dissolve could ever conform through `assemble_from_interchange`**:
+  an AAF Transition consumes record time, so the walker (correctly) emits the
+  incoming clip overlapping the outgoing — and the bridge's overlap gate
+  threw on exactly that shape. A reconciliation pre-pass now trims the
+  outgoing's tail to the overlap start; the boundary shift then re-extends it
+  to the cut point, which is the AAF notional-cut (`CutPoint`) semantics
+  exactly. Render-verified: the dissolve blends through the 181.8 midpoint
+  fingerprint.
+
+### Added
+
+- **AAF fades**: the walker synthesizes BL pseudo-events at filler-adjacent
+  and sequence-edge Transitions, completing fade parity across all four
+  formats (EDL v2.150, OTIO/XMEML v2.151, AAF now). The head-transition
+  "clamp" case is reinterpreted as what it is — a fade-in from black.
+  Full triple render-verified: fade-in 18→123, dissolve-to-white through the
+  midpoint, fade-out 230→21.
+- A pyaaf2-authored AAF fixture test exercises the real walker end to end
+  (no stubs), skipped only where pyaaf2 is unavailable.
+
 ## What's New in v2.151.0 — fade parity: OTIO and XMEML fades author too
 
 ### Added

package/README.md

@@ -2,7 +2,7 @@
 
 English | [简体中文](README.zh-CN.md)
 
-[![Version](https://img.shields.io/badge/version-2.151.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.153.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
 [![npm](https://img.shields.io/npm/v/davinci-resolve-mcp.svg?label=npm&color=CB3837)](https://www.npmjs.com/package/davinci-resolve-mcp)
 [![API Coverage](https://img.shields.io/badge/API%20Coverage-100%25-brightgreen.svg)](docs/reference/api-coverage.md)
 [![Tools](https://img.shields.io/badge/MCP%20Tools-36%20(353%20full)-blue.svg)](#server-modes)

package/README.zh-CN.md

@@ -2,7 +2,7 @@
 
 [English](README.md) | 简体中文
 
-[![Version](https://img.shields.io/badge/version-2.151.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.153.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
 [![npm](https://img.shields.io/npm/v/davinci-resolve-mcp.svg?label=npm&color=CB3837)](https://www.npmjs.com/package/davinci-resolve-mcp)
 [![API Coverage](https://img.shields.io/badge/API%20Coverage-100%25-brightgreen.svg)](docs/reference/api-coverage.md)
 [![Tools](https://img.shields.io/badge/MCP%20Tools-36%20(353%20full)-blue.svg)](#服务器模式)
@@ -12,7 +12,7 @@
 [![Python](https://img.shields.io/badge/python-3.10+-green.svg)](https://www.python.org/downloads/)
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
-> 本翻译对应 v2.151.0 版 README。如与英文原版有出入，以 [英文原版](README.md) 为准。
+> 本翻译对应 v2.153.0 版 README。如与英文原版有出入，以 [英文原版](README.md) 为准。
 
 一个 Model Context Protocol (MCP) 服务器，让 AI 助手通过官方脚本 API 控制 DaVinci Resolve Studio（达芬奇）。它提供完整的 API 覆盖，外加带护栏的工作流助手，涵盖剪辑、媒体池整理、渲染设置、审阅标记、调色、Fusion、Fairlight、项目生命周期任务、扩展开发，以及不碰源媒体的媒体分析。
 

package/install.py

@@ -37,7 +37,7 @@ from src.utils.update_check import (
 
 # ─── Version ──────────────────────────────────────────────────────────────────
 
-VERSION = "2.151.0"
+VERSION = "2.153.0"
 # Only hard floor: mcp[cli] requires Python 3.10+. There is no upper bound —
 # Resolve's scripting bridge loads into newer interpreters on recent builds
 # (Python 3.14 verified against Resolve Studio 20.3.2). Older Resolve builds

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "davinci-resolve-mcp",
-  "version": "2.151.0",
+  "version": "2.153.0",
   "description": "NPM bootstrapper for the DaVinci Resolve MCP Server.",
   "license": "MIT",
   "author": "Samuel Gursky <samgursky@gmail.com>",

package/resolve-advanced/server/aaf_probe.py

@@ -1161,6 +1161,21 @@ def _walk_components(sequence, *, track, fps, rec, state, depth, transition=None
     """
     start = rec
     pending_transition = transition
+    # Sequence start counts as black: a Transition with Filler (or nothing)
+    # on one side is a FADE. Synthesize zero-length BL pseudo-events so the
+    # bridge's black machinery (E91-E93) authors a real clip-to-generator
+    # dissolve — Resolve renders empty track as black, and the bridge grows
+    # the BL leg to cover its side of the overlap.
+    at_black = True
+
+    def _emit_bl(rec_pos, trans):
+        state["events"].append({
+            "index": state["idx"], "track": track, "source": "BL",
+            "srcIn": 0, "srcOut": 0, "recIn": rec_pos, "recOut": rec_pos,
+            "speed": 100, "reverse": False, "transition": trans, "fps": fps,
+        })
+        state["idx"] += 1
+
     components = getattr(sequence, "components", None)
     if components is None:
         components = [sequence]
@@ -1190,15 +1205,29 @@ def _walk_components(sequence, *, track, fps, rec, state, depth, transition=None
                 # be a worse lie than the malformed AAF that produced it.
                 rec = max(start, rec - duration)
                 continue
+            if pending_transition is not None and cls in ("Filler", "ScopeReference"):
+                # Transition then Filler = fade-OUT into black: the fade
+                # attaches to a synthetic BL leg at the overlap start.
+                _emit_bl(rec, pending_transition)
+                pending_transition = None
+            elif pending_transition is not None and at_black:
+                # Filler (or sequence start) then Transition then clip =
+                # fade-IN from black: zero-length BL predecessor at the
+                # overlap start; the bridge's boundary shift grows it.
+                _emit_bl(rec, None)
             rec += _walk_segment(
                 comp, track=track, fps=fps, rec=rec, state=state, depth=depth, transition=pending_transition
             )
             pending_transition = None
+            at_black = cls in ("Filler", "ScopeReference")
         except Exception:
             # Never let one bad component abort the whole sequence — but say so.
             _note_unhandled(state, cls)
             pending_transition = None
             continue
+    if pending_transition is not None:
+        # Transition as the LAST component = fade-out to the sequence end.
+        _emit_bl(rec, pending_transition)
     return rec - start
 
 

package/resolve-advanced/server/author-interchange.mjs

@@ -443,6 +443,29 @@ export function eventsToAssembleSpec(events, opts = {}) {
     if (!perSource.has(e.source)) perSource.set(e.source, []);
     perSource.get(e.source).push(cut);
   }
+  // AAF overlap reconciliation (E93): an AAF Transition CONSUMES record time
+  // — the incoming component starts `duration` frames before the outgoing
+  // ends, so the walker legitimately emits OVERLAPPING events with the
+  // transition on the incoming (alignment 'start' at the overlap start).
+  // Trim the outgoing's tail to the overlap start before the overlap gates:
+  // the boundary-shift below then re-extends it to the cut point, which is
+  // exactly the AAF notional-cut semantics (CutPoint, centered by default).
+  // Without this the overlap gate threw and NO AAF dissolve could conform.
+  const reconcileAafOverlap = (cands, pls) => {
+    for (const c of cands) {
+      if (!c.explicitSpan || c.pre !== 0) continue;
+      const prev = pls.find((pl) => pl.track === c.track && pl.start < c.atFrame && pl.end > c.atFrame && pl.end - c.atFrame <= c.durationFrames);
+      if (!prev) continue;
+      const o = prev.end - c.atFrame;
+      if (prev.durationFrames <= o) continue; // degenerate: leave for the drop paths
+      prev.end -= o;
+      prev.durationFrames -= o;
+      prev.cutRef.durationFrames -= o;
+    }
+  };
+  reconcileAafOverlap(transitionCandidates, placements);
+  reconcileAafOverlap(audioTransCandidates, audioPlacements);
+
   audioPlacements.sort((a, b) => a.start - b.start);
   const audByTrack = new Map();
   for (const pl of audioPlacements) {
@@ -819,8 +842,29 @@ export function verifyRoundtrip(inputEvents, exportedEvents, opts = {}) {
       .map((e) => ({ track: canonTrack(e.track), source: mapSource(canonSource(e.source)), recIn: e.recIn - off, recOut: e.recOut - off, srcIn: e.srcIn ?? 0 }))
       .sort((a, b) => a.track.localeCompare(b.track) || a.recIn - b.recIn);
   };
-  const a = norm(inputEvents);
-  const b = norm(exportedEvents);
+  const a0 = norm(inputEvents);
+  const b0 = norm(exportedEvents);
+  // FADES (E94): BL legs on the input side and the Solid Color generators a
+  // fade conform authors for them are the same thing — BLACK. Black segments
+  // are synthesized filler whose extents follow from the picture boundaries,
+  // so the pairwise compare runs over PICTURE legs only; black is counted
+  // informationally. And a fade's boundary-shift legitimately moves a
+  // picture edge by up to the transition duration (matching Resolve's own
+  // start-at-cut reshaping), so an edge within an input junction's fade
+  // window is excused — and reported, not silently absorbed.
+  const isBlackSeg = (e) => /^(bl|black|solid color)$/.test(e.source);
+  const a = a0.filter((e) => !isBlackSeg(e));
+  const b = b0.filter((e) => !isBlackSeg(e));
+  const blackSegments = { input: a0.length - a.length, exported: b0.length - b.length };
+  const rawVids = vids(inputEvents);
+  const inOff = rawVids.length ? Math.min(...rawVids.map((e) => e.recIn)) : 0;
+  const junctions = inputEvents
+    .filter((e) => /^V\d*$/.test(String(e.track)) && e.recIn != null && e.transition && e.transition.duration > 0)
+    .map((e) => ({ frame: e.recIn - inOff, d: e.transition.duration }));
+  const inFadeWindow = (edgeIn, edgeExp) => junctions.some(
+    (j) => Math.abs(edgeIn - j.frame) <= j.d && Math.abs(edgeExp - edgeIn) <= j.d,
+  );
+  const fadeReshapedBoundaries = [];
   const mismatches = [];
   if (a.length !== b.length) mismatches.push({ kind: 'count', input: a.length, exported: b.length });
   const srcOffsets = {};
@@ -829,11 +873,23 @@ export function verifyRoundtrip(inputEvents, exportedEvents, opts = {}) {
     const x = a[i], y = b[i];
     if (x.track !== y.track) { mismatches.push({ kind: 'track', at: i, input: x.track, exported: y.track }); continue; }
     if (x.source !== y.source) { mismatches.push({ kind: 'source', at: i, input: x.source, exported: y.source }); continue; }
-    if (Math.abs(x.recIn - y.recIn) > recTol || Math.abs(x.recOut - y.recOut) > recTol) {
-      mismatches.push({ kind: 'record', at: i, input: [x.recIn, x.recOut], exported: [y.recIn, y.recOut] });
-      continue;
+    const inBad = Math.abs(x.recIn - y.recIn) > recTol;
+    const outBad = Math.abs(x.recOut - y.recOut) > recTol;
+    if (inBad || outBad) {
+      const inExcused = !inBad || inFadeWindow(x.recIn, y.recIn);
+      const outExcused = !outBad || inFadeWindow(x.recOut, y.recOut);
+      if (inExcused && outExcused) {
+        fadeReshapedBoundaries.push({ at: i, source: x.source, input: [x.recIn, x.recOut], exported: [y.recIn, y.recOut] });
+      } else {
+        mismatches.push({ kind: 'record', at: i, input: [x.recIn, x.recOut], exported: [y.recIn, y.recOut] });
+        continue;
+      }
     }
-    const off = y.srcIn - x.srcIn;
+    // A fade-reshaped head trims record AND source together (source stays
+    // record-aligned), so the per-source constant offset is fitted net of
+    // the record shift — otherwise a source cut both plain and faded would
+    // read as a source-frames drift.
+    const off = (y.srcIn - (y.recIn - x.recIn)) - x.srcIn;
     if (srcOffsets[x.source] === undefined) srcOffsets[x.source] = off;
     else if (Math.abs(off - srcOffsets[x.source]) > srcTol) {
       mismatches.push({ kind: 'source-frames', at: i, source: x.source, expectedOffset: srcOffsets[x.source], gotOffset: off });
@@ -870,5 +926,10 @@ export function verifyRoundtrip(inputEvents, exportedEvents, opts = {}) {
     }
     mismatches.push(...markers.mismatches);
   }
-  return { pass: mismatches.length === 0, pairs: n, srcOffsets, mismatches, markers, ...(markersNotInExport ? { markersNotInExport } : {}) };
+  return {
+    pass: mismatches.length === 0, pairs: n, srcOffsets, mismatches, markers,
+    ...(markersNotInExport ? { markersNotInExport } : {}),
+    ...(blackSegments.input || blackSegments.exported ? { blackSegments } : {}),
+    ...(fadeReshapedBoundaries.length ? { fadeReshapedBoundaries } : {}),
+  };
 }

package/resolve-advanced/server/tools/drt.mjs

@@ -153,7 +153,7 @@ function requirePathArg(args, key, action) {
 export const drtTool = {
   name: 'drt',
   description:
-    'DaVinci Resolve Timeline (.drt) operations — offline, no Resolve required. Actions: assemble_from_interchange (EDL/OTIO/XML/AAF + sourceMap → IMPORTABLE RENDERING native .drt in one call; retimes AUTHOR — constant speed fwd/rev AND zero-speed freezes (EDL M2 000.0; render-proven frozen); cross-dissolves are AUTHORED when the cut abuts with handles both sides (render-verified on 19), else dropped with reason; fades AUTHOR across formats (EDL BL legs, OTIO gap-adjacent Transitions, XMEML edge transitionitems) — BL legs become Solid Color generators and the fade a real clip-to-generator dissolve, luma-ramp render-verified, while Resolve\'s OWN EDL importer drops BL dissolves silently; ledger in `conform`), assemble (spec → IMPORTABLE native-schema .drt via template-spliced real structures; pass targetAppVersion e.g. \'19.1\' for pre-21 hosts), parse, list_sequences (enumerate the timelines inside a .drp/.drt → [{id,name,eventCount,index}] to drive a "which sequence?" picker), author, validate, inject_into_drp, extract_from_drp (pull one SeqContainer out as a .drt — feed the .drt to the Python davinci-resolve MCP timeline.import_timeline_checked, or use timeline.import_from_drp to do both), downgrade (stamp <ProjectVersion> down so an OLDER Resolve will import a .drt/.drp from a newer one — pass targetAppVersion like "19.1.3" or targetProjectVersion).',
+    'DaVinci Resolve Timeline (.drt) operations — offline, no Resolve required. Actions: assemble_from_interchange (EDL/OTIO/XML/AAF + sourceMap → IMPORTABLE RENDERING native .drt in one call; retimes AUTHOR — constant speed fwd/rev AND zero-speed freezes (EDL M2 000.0; render-proven frozen); cross-dissolves are AUTHORED when the cut abuts with handles both sides (render-verified on 19), else dropped with reason; fades AUTHOR across ALL FOUR formats (EDL BL legs, OTIO gap-adjacent Transitions, XMEML edge transitionitems, AAF filler-adjacent Transitions) and AAF overlap-consuming dissolves reconcile+author (CutPoint honored; before E93 they threw at the overlap gate) — BL legs become Solid Color generators and the fade a real clip-to-generator dissolve, luma-ramp render-verified, while Resolve\'s OWN EDL importer drops BL dissolves silently; ledger in `conform`), assemble (spec → IMPORTABLE native-schema .drt via template-spliced real structures; pass targetAppVersion e.g. \'19.1\' for pre-21 hosts), parse, list_sequences (enumerate the timelines inside a .drp/.drt → [{id,name,eventCount,index}] to drive a "which sequence?" picker), author, validate, inject_into_drp, extract_from_drp (pull one SeqContainer out as a .drt — feed the .drt to the Python davinci-resolve MCP timeline.import_timeline_checked, or use timeline.import_from_drp to do both), downgrade (stamp <ProjectVersion> down so an OLDER Resolve will import a .drt/.drp from a newer one — pass targetAppVersion like "19.1.3" or targetProjectVersion).',
   async handler({ action, args }) {
     if (action === 'parse') {
       const p = parseSchema.parse(requirePathArg(args, 'drtPath', 'parse'));

package/resolve-advanced/server/tools/editorial.mjs

@@ -86,7 +86,7 @@ const markerSchema = z.object({
 export const editorialTool = {
   name: 'editorial',
   description:
-    'Editorial integrity (Cluster E) — turnover interchange → normalized events → changelist + conform manifest with TIMING silent-lie guards (flattened retime / dropped J/L-cut audio / framerate-pulldown slip / reverse dropped / transition-handle starvation → flag, skip-not-fake). Report-only (gate: review). Actions: parse_interchange (EDL/OTIO/XMEML natively + AAF via pyaaf2 + PRPROJ via gunzip+XML → normalized events; for AAF/PRPROJ pass the file PATH as content; AAF also returns per-sequence startTimecode/startFrame — build the timeline at THAT start, not the Resolve 01:00:00:00 default — and per-clip `geometry` for Avid transform effects), list_sequences (ONE offline picker entry point across xml/edl/otio/drt/drp/aaf/prproj → [{id,name,eventCount}], plus startTimecode/startFrame for AAF), convert_to_interchange (author OTIO/EDL/DRT Resolve CAN import from events or a parsed source — the .prproj→Resolve conform bridge, no Premiere needed; editorial timing/transitions survive and per-clip effects/color do not. SPEED/REVERSE survive on the otio (LinearTimeWarp) and edl (M2) targets ONLY — this FLAT drt target flattens every retime to 100% forward and returns `flattened`/`flattenedCount` naming each event that lost one (`flattened` is always present on `drt`, empty when there were none); for a .drt that AUTHORS retimes/dissolves/multi-track/audio, use drt.assemble_from_interchange), turnover_changelist (diff old vs new → moved/retimed/replaced/new/gone + timing flags), conform_manifest (per-event assert: source resolved/handles/retime/reverse/TC-base), marker_roundtrip (markers with provenance tags), verify_roundtrip (input events vs re-export events -> pass/mismatches + fitted per-source TC offsets; the conform QC loop-closer). Offline (AAF needs pyaaf2; live AAF/DRP import is on the Python davinci-resolve MCP).',
+    'Editorial integrity (Cluster E) — turnover interchange → normalized events → changelist + conform manifest with TIMING silent-lie guards (flattened retime / dropped J/L-cut audio / framerate-pulldown slip / reverse dropped / transition-handle starvation → flag, skip-not-fake). Report-only (gate: review). Actions: parse_interchange (EDL/OTIO/XMEML natively + AAF via pyaaf2 + PRPROJ via gunzip+XML → normalized events; for AAF/PRPROJ pass the file PATH as content; AAF also returns per-sequence startTimecode/startFrame — build the timeline at THAT start, not the Resolve 01:00:00:00 default — and per-clip `geometry` for Avid transform effects), list_sequences (ONE offline picker entry point across xml/edl/otio/drt/drp/aaf/prproj → [{id,name,eventCount}], plus startTimecode/startFrame for AAF), convert_to_interchange (author OTIO/EDL/DRT Resolve CAN import from events or a parsed source — the .prproj→Resolve conform bridge, no Premiere needed; editorial timing/transitions survive and per-clip effects/color do not. SPEED/REVERSE survive on the otio (LinearTimeWarp) and edl (M2) targets ONLY — this FLAT drt target flattens every retime to 100% forward and returns `flattened`/`flattenedCount` naming each event that lost one (`flattened` is always present on `drt`, empty when there were none); for a .drt that AUTHORS retimes/dissolves/multi-track/audio, use drt.assemble_from_interchange), turnover_changelist (diff old vs new → moved/retimed/replaced/new/gone + timing flags), conform_manifest (per-event assert: source resolved/handles/retime/reverse/TC-base), marker_roundtrip (markers with provenance tags), verify_roundtrip (input events vs re-export events -> pass/mismatches + fitted per-source TC offsets + marker compare w/ markersNotInExport honesty flag; FADE-AWARE: BL/Solid-Color legs merge out as blackSegments and fade-window boundary reshapes are excused into fadeReshapedBoundaries instead of failing; the conform QC loop-closer). Offline (AAF needs pyaaf2; live AAF/DRP import is on the Python davinci-resolve MCP).',
   async handler({ action, args }) {
     if (action === 'parse_interchange') {
       const p = parseSchema.parse(args);

package/src/granular/common.py

@@ -87,7 +87,7 @@ if not logging.getLogger().handlers:
         handlers=[logging.StreamHandler()],
     )
 
-VERSION = "2.151.0"
+VERSION = "2.153.0"
 logger = logging.getLogger("davinci-resolve-mcp")
 logger.info(f"Starting DaVinci Resolve MCP Server v{VERSION}")
 logger.info(f"Detected platform: {get_platform()}")

package/src/server.py

@@ -11,7 +11,7 @@ Usage:
     python src/server.py --full       # Start the 353-tool granular server instead
 """
 
-VERSION = "2.151.0"
+VERSION = "2.153.0"
 
 import base64
 import os