davinci-resolve-mcp 2.157.0 → 2.159.0

package/CHANGELOG.md

@@ -2,6 +2,45 @@
 
 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.159.0 — the EDL writer learns transitions
+
+### Fixed
+
+- **`convert_to_interchange`'s EDL target silently dropped every
+  transition** (the OTIO target carried them since day one). The writer now
+  emits the CMX pairs — a zero-length outgoing marker line plus the `D` line
+  with its duration — with the `BL` reel on the black side of fades, and a
+  zero-length fade-out carrier receives the fade's record extent per the
+  CMX convention. Round-trip proven: written EDLs parse back to fully
+  authored specs (dissolves, fade-in, fade-out; nothing dropped). Reel
+  names are basename-stripped before sanitizing, so path-style sources
+  produce clean reels.
+
+## What's New in v2.158.0 — E100: the kitchen-sink certification
+
+### Verified (one turnover, everything at once)
+
+- A single OTIO turnover carrying a fade-in, a V2 stack, a centered
+  dissolve, a 50% retime, a retime-adjacent fade-out, two audio legs, two
+  track markers, and a clip marker conformed, imported, and **rendered
+  correct in all 32 measured windows** — including the previously unmeasured
+  interactions (the boundary shift extending a retimed cut into its
+  fade-out; an upper-track stack compositing over the fade region). The
+  round-trip QC closed `pass: true` against Resolve's own re-export, and
+  the fixture is now a permanent offline test.
+
+### Fixed
+
+- `verify_roundtrip` compares sources by **basename**: an OTIO turnover
+  names sources by `target_url` path while Resolve's re-export uses the file
+  basename — the same file read as six spurious source mismatches.
+
+### Measured
+
+- **Fairlight level law**: the template's A1 strip plays at source level
+  while the added mono strips (A2–A16) play 3 dB down per channel (center
+  pan law). Both render; it is mixer semantics, not a placement failure.
+
 ## What's New in v2.157.0 — the conform manifest learns fades too
 
 ### Fixed

package/README.md

@@ -2,7 +2,7 @@
 
 English | [简体中文](README.zh-CN.md)
 
-[![Version](https://img.shields.io/badge/version-2.157.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.159.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.157.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.159.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.157.0 版 README。如与英文原版有出入，以 [英文原版](README.md) 为准。
+> 本翻译对应 v2.159.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.157.0"
+VERSION = "2.159.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.157.0",
+  "version": "2.159.0",
   "description": "NPM bootstrapper for the DaVinci Resolve MCP Server.",
   "license": "MIT",
   "author": "Samuel Gursky <samgursky@gmail.com>",

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

@@ -705,19 +705,41 @@ export function eventsToAssembleSpec(events, opts = {}) {
 
 export function eventsToEDL(events, opts = {}) {
   const fps = opts.fps || events.find((e) => e.fps)?.fps || 24;
-  const vids = events.filter((e) => e.track !== 'A').sort((a, b) => (a.recIn ?? 0) - (b.recIn ?? 0));
+  const vids = events.filter((e) => e.track !== 'A').sort((a, b) => (a.recIn ?? 0) - (b.recIn ?? 0) || (a.recOut ?? 0) - (b.recOut ?? 0));
   const lines = [`TITLE: ${opts.name || 'CONFORMED'}`, 'FCM: NON-DROP FRAME'];
+  const reelOf = (e) =>
+    String(e.source || 'AX')
+      .split(/[\\/]/).pop()
+      .replace(/\.[^.]+$/, '')
+      .replace(/[^A-Za-z0-9]/g, '')
+      .slice(0, 8)
+      .toUpperCase() || 'AX';
+  let num = 0;
   vids.forEach((e, i) => {
-    const num = pad(i + 1, 3);
-    const reel =
-      String(e.source || 'AX')
-        .replace(/\.[^.]+$/, '')
-        .replace(/[^A-Za-z0-9]/g, '')
-        .slice(0, 8)
-        .toUpperCase() || 'AX';
-    lines.push(
-      `${num}  ${reel} V     C        ${framesToTc(e.srcIn, fps)} ${framesToTc(e.srcOut, fps)} ${framesToTc(e.recIn, fps)} ${framesToTc(e.recOut, fps)}`,
-    );
+    const reel = reelOf(e);
+    // Transitions write the CMX pair (E101 — the OTIO writer carried them
+    // since day one, this writer silently dropped them): a zero-length cut
+    // of the OUTGOING at the junction, then the D line with the duration.
+    // Fades work identically with the BL reel on the black side.
+    if (e.transition && (e.transition.duration || 0) > 0) {
+      const prev = vids.find((o) => o !== e && (o.recOut ?? 0) === (e.recIn ?? 0) && (o.recIn ?? 0) < (o.recOut ?? 0));
+      const outReel = prev ? reelOf(prev) : 'BL';
+      const outSrc = prev ? framesToTc(prev.srcOut, fps) : framesToTc(0, fps);
+      lines.push(
+        `${pad(++num, 3)}  ${outReel} V     C        ${outSrc} ${outSrc} ${framesToTc(e.recIn, fps)} ${framesToTc(e.recIn, fps)}`,
+      );
+      // A zero-length BL carrier (OTIO/AAF fade-out shape) gets the fade's
+      // own record extent — the CMX fade-out convention.
+      const recOut = (e.recIn ?? 0) === (e.recOut ?? 0) ? (e.recIn ?? 0) + Math.round(e.transition.duration) : e.recOut;
+      lines.push(
+        `${pad(++num, 3)}  ${reel} V     D    ${String(Math.round(e.transition.duration)).padStart(3, '0')} ${framesToTc(e.srcIn, fps)} ${framesToTc(e.srcOut, fps)} ${framesToTc(e.recIn, fps)} ${framesToTc(recOut, fps)}`,
+      );
+    } else {
+      if ((e.recIn ?? 0) === (e.recOut ?? 0)) return; // zero-length markers are emitted by the transition pair itself
+      lines.push(
+        `${pad(++num, 3)}  ${reel} V     C        ${framesToTc(e.srcIn, fps)} ${framesToTc(e.srcOut, fps)} ${framesToTc(e.recIn, fps)} ${framesToTc(e.recOut, fps)}`,
+      );
+    }
     if ((e.speed ?? 100) !== 100 || e.reverse) {
       const play = (e.reverse ? -1 : 1) * (fps * ((e.speed ?? 100) / 100));
       lines.push(`M2   ${reel}       ${play.toFixed(1)}             ${framesToTc(e.srcIn, fps)}`);
@@ -826,7 +848,10 @@ export function verifyRoundtrip(inputEvents, exportedEvents, opts = {}) {
     const m = /^([VA])(\d+)?$/.exec(String(t || ''));
     return m ? `${m[1]}${m[2] || '1'}` : String(t);
   };
-  const canonSource = (x) => String(x || '').replace(/\.[^.]+$/, '').toLowerCase();
+  // Basename + extension-stripped + case-folded: an OTIO turnover names
+  // sources by target_url PATH while Resolve's re-export names them by file
+  // basename (measured E100) — same file, different spelling.
+  const canonSource = (x) => String(x || '').split(/[\\/]/).pop().replace(/\.[^.]+$/, '').toLowerCase();
   // Reel/tape aliases: an EDL names sources by REEL (CUTSRC) while the
   // re-export names them by file basename (cut_src) — the sourceMap that
   // drove the assemble is the authority linking the two. Keys and values

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 incl. span-explicit transitions and BL fade legs; 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; BL-aware — black legs need no source, fades no black-side handles, and a fade-out tail requirement lands on the picture source), 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; RETIME-AWARE: speed/reverse compare pairwise — EXPORT_OTIO carries an authored Sm2TimeMap back as LinearTimeWarp (measured), so a flattened/lost retime fails as drift geometry alone cannot catch; AUDIO-AWARE: declared audio events compare (channel legs deduped, mismatches tagged trackType audio) while the mirrored-A1 export of a video-only turnover stays informational; 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 incl. span-explicit transitions and BL fade legs; 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 EDL target writes CMX transition pairs incl. BL fades — 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; BL-aware — black legs need no source, fades no black-side handles, and a fade-out tail requirement lands on the picture source), 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; RETIME-AWARE: speed/reverse compare pairwise — EXPORT_OTIO carries an authored Sm2TimeMap back as LinearTimeWarp (measured), so a flattened/lost retime fails as drift geometry alone cannot catch; AUDIO-AWARE: declared audio events compare (channel legs deduped, mismatches tagged trackType audio) while the mirrored-A1 export of a video-only turnover stays informational; 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.157.0"
+VERSION = "2.159.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.157.0"
+VERSION = "2.159.0"
 
 import base64
 import os