davinci-resolve-mcp 2.155.0 → 2.156.0

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 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.156.0 — the QC loop learns audio; the verify surface is complete
+
+### Added
+
+- **`editorial.verify_roundtrip` is audio-aware.** Declared audio events
+  compare pairwise through the same machinery as video — record, source,
+  retime, and fade-window excusal — with audio mismatches tagged
+  `trackType: 'audio'`, AAF channel legs deduped, and BL/silence legs merged
+  out. A video-only turnover whose re-export carries audio (the A1
+  convenience mirror this bridge authors) reports `audio.compared: false`
+  informationally instead of failing. Live loop verified: an explicit A2 leg
+  round-trips through `EXPORT_OTIO` at exact geometry.
+- With markers (v2.147), fades (v2.153), retimes (v2.154), and now audio,
+  the round-trip QC surface covers every structure the conform bridge
+  authors.
+
 ## What's New in v2.155.0 — Premiere transitions land properly: centered spans and fades
 
 ### Fixed

package/README.md

@@ -2,7 +2,7 @@
 
 English | [简体中文](README.zh-CN.md)
 
-[![Version](https://img.shields.io/badge/version-2.155.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.156.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.155.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.156.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.155.0 版 README。如与英文原版有出入，以 [英文原版](README.md) 为准。
+> 本翻译对应 v2.156.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.155.0"
+VERSION = "2.156.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.155.0",
+  "version": "2.156.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

@@ -838,16 +838,21 @@ export function verifyRoundtrip(inputEvents, exportedEvents, opts = {}) {
   // before the D event — a pairing placeholder, never a rendered clip, and
   // no export reproduces it.
   const vids = (evts) => evts.filter((e) => /^V\d*$/.test(String(e.track)) && e.recIn != null && e.recOut != null && e.recOut > e.recIn);
-  const norm = (evts) => {
+  const audsOf = (evts) => evts.filter((e) => /^A\d*$/.test(String(e.track)) && e.recIn != null && e.recOut != null && e.recOut > e.recIn);
+  const anchorOfSide = (evts) => {
     const v = vids(evts);
+    if (v.length) return Math.min(...v.map((e) => e.recIn));
+    const au = audsOf(evts);
+    return au.length ? Math.min(...au.map((e) => e.recIn)) : 0;
+  };
+  const norm = (evts, pick = vids) => {
+    const v = pick(evts);
     if (!v.length) return [];
-    const off = Math.min(...v.map((e) => e.recIn));
+    const off = anchorOfSide(evts);
     return v
       .map((e) => ({ track: canonTrack(e.track), source: mapSource(canonSource(e.source)), recIn: e.recIn - off, recOut: e.recOut - off, srcIn: e.srcIn ?? 0, speed: e.speed ?? 100, reverse: Boolean(e.reverse) }))
       .sort((a, b) => a.track.localeCompare(b.track) || a.recIn - b.recIn);
   };
-  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,
@@ -857,60 +862,91 @@ export function verifyRoundtrip(inputEvents, exportedEvents, opts = {}) {
   // 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 inAnchor = anchorOfSide(inputEvents);
+  const junctionsFor = (trackRe) => inputEvents
+    .filter((e) => trackRe.test(String(e.track)) && e.recIn != null && e.transition && e.transition.duration > 0)
+    .map((e) => ({ frame: e.recIn - inAnchor, d: e.transition.duration }));
   const fadeReshapedBoundaries = [];
   const mismatches = [];
-  if (a.length !== b.length) mismatches.push({ kind: 'count', input: a.length, exported: b.length });
   const srcOffsets = {};
-  const n = Math.min(a.length, b.length);
-  for (let i = 0; i < n; i += 1) {
-    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; }
-    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] });
+  const comparePairs = (a, b, junctions, trackType) => {
+    const tt = trackType === 'audio' ? { trackType: 'audio' } : {};
+    const inFadeWindow = (edgeIn, edgeExp) => junctions.some(
+      (j) => Math.abs(edgeIn - j.frame) <= j.d && Math.abs(edgeExp - edgeIn) <= j.d,
+    );
+    if (a.length !== b.length) mismatches.push({ kind: 'count', ...tt, input: a.length, exported: b.length });
+    const n = Math.min(a.length, b.length);
+    for (let i = 0; i < n; i += 1) {
+      const x = a[i], y = b[i];
+      if (x.track !== y.track) { mismatches.push({ kind: 'track', ...tt, at: i, input: x.track, exported: y.track }); continue; }
+      if (x.source !== y.source) { mismatches.push({ kind: 'source', ...tt, at: i, input: x.source, exported: y.source }); 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, ...tt, source: x.source, input: [x.recIn, x.recOut], exported: [y.recIn, y.recOut] });
+        } else {
+          mismatches.push({ kind: 'record', ...tt, at: i, input: [x.recIn, x.recOut], exported: [y.recIn, y.recOut] });
+          continue;
+        }
+      }
+      // RETIMES (E95): a conform that lost its retime is a wrong timeline
+      // that record/source geometry alone cannot catch (the record extent is
+      // unchanged; only the playback rate is). Resolve's EXPORT_OTIO carries
+      // an authored Sm2TimeMap back as LinearTimeWarp (measured live: 50%
+      // in → time_scalar 0.5 out), so a speed/reverse mismatch is real drift.
+      if (Math.abs((x.speed ?? 100) - (y.speed ?? 100)) > 0.5 || x.reverse !== y.reverse) {
+        mismatches.push({
+          kind: 'retime', ...tt, at: i, source: x.source,
+          input: { speed: x.speed, reverse: x.reverse },
+          exported: { speed: y.speed, reverse: y.reverse },
+        });
         continue;
       }
+      // 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', ...tt, at: i, source: x.source, expectedOffset: srcOffsets[x.source], gotOffset: off });
+      }
     }
-    // RETIMES (E95): a conform that lost its retime is a wrong timeline that
-    // record/source geometry alone cannot catch (the record extent is
-    // unchanged; only the playback rate is). Resolve's EXPORT_OTIO carries
-    // an authored Sm2TimeMap back as LinearTimeWarp (measured live: 50%
-    // in → time_scalar 0.5 out), so a speed/reverse mismatch is real drift.
-    if (Math.abs((x.speed ?? 100) - (y.speed ?? 100)) > 0.5 || x.reverse !== y.reverse) {
-      mismatches.push({
-        kind: 'retime', at: i, source: x.source,
-        input: { speed: x.speed, reverse: x.reverse },
-        exported: { speed: y.speed, reverse: y.reverse },
-      });
-      continue;
-    }
-    // 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 });
-    }
+    return n;
+  };
+
+  const a0 = norm(inputEvents);
+  const b0 = norm(exportedEvents);
+  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 n = comparePairs(a, b, junctionsFor(/^V\d*$/), 'video');
+
+  // AUDIO (E97): compared only when the INPUT declares audio events — a
+  // video-only turnover legitimately re-exports with audio (the A1
+  // convenience mirror), which is reported informationally, never failed.
+  // AAF channel legs dedupe (same track/source/range arrives once per
+  // channel); BL/silence legs merge out like video black.
+  const dedupeAud = (list) => {
+    const seen = new Set();
+    return list.filter((e) => {
+      const k = `${e.track}|${e.source}|${e.recIn}|${e.recOut}|${e.srcIn}`;
+      if (seen.has(k)) return false;
+      seen.add(k);
+      return true;
+    });
+  };
+  const aa = dedupeAud(norm(inputEvents, audsOf).filter((e) => !isBlackSeg(e)));
+  const ba = dedupeAud(norm(exportedEvents, audsOf).filter((e) => !isBlackSeg(e)));
+  let audio;
+  if (aa.length) {
+    audio = { input: aa.length, exported: ba.length, compared: true };
+    comparePairs(aa, ba, junctionsFor(/^A\d*$/), 'audio');
+  } else if (ba.length) {
+    audio = { input: 0, exported: ba.length, compared: false, note: 'export-only audio (A1 convenience mirror) — not compared' };
   }
   // MARKERS (E88): compare track-'MARKER' pseudo-events, min-anchored to
   // each side's own VIDEO record origin like everything else. When the
@@ -948,5 +984,6 @@ export function verifyRoundtrip(inputEvents, exportedEvents, opts = {}) {
     ...(markersNotInExport ? { markersNotInExport } : {}),
     ...(blackSegments.input || blackSegments.exported ? { blackSegments } : {}),
     ...(fadeReshapedBoundaries.length ? { fadeReshapedBoundaries } : {}),
+    ...(audio ? { audio } : {}),
   };
 }

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), 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; 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 .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; 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.155.0"
+VERSION = "2.156.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.155.0"
+VERSION = "2.156.0"
 
 import base64
 import os