davinci-resolve-mcp 2.201.0 → 2.202.0

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 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.202.0 — E150: a rebase needs a real majority; retime rounding is the same window
+
+### Fixed
+
+- **A timecode rebase needs a majority of ALL the source's cuts.** The rule
+  measured its majority over the cuts whose windows differed, so on a real
+  reel two shifted cuts out of fifty-four became that source's base and
+  turned fifty-two UNCHANGED cuts into false trims (a control with a free
+  floor). The majority is now over every paired cut of the source (at least
+  two, and more than half). On that reel: 187 → 237 of 335 cuts retained; the
+  reels where a rebase is real keep it.
+- **One source frame of rounding on a retimed pair is the same window.**
+  Premiere's exact 80% and Resolve's keyframe slope (0.79999, frame-quantized
+  seconds) land one frame apart (41923 vs 41922). On a pair where either side
+  is retimed a source edge within `srcTolerance` (default 1 frame) compares
+  equal; a 100% pair keeps the exact compare; two frames is still a trim.
+
 ## What's New in v2.201.0 — E149: a rename is inferred from overlapping windows
 
 ### Added

package/README.md

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

package/resolve-advanced/server/editorial.mjs

@@ -1031,28 +1031,45 @@ function diffChangelistOnce(oldEvents, newEvents, opts = {}) {
   // camera TC) — not N trims. A shift witnessed on ≥2 cuts of a source is
   // that source's offset; the compare below reads old through it, and a cut
   // that still differs is a real trim on top of the rebase.
-  const shiftTally = new Map(), differing = new Map();
+  const shiftTally = new Map(), differing = new Map(), pairedCuts = new Map();
   for (const { oe, ne } of P.pairs) {
     if ([oe.srcIn, oe.srcOut, ne.srcIn, ne.srcOut].some((v) => v == null)) continue;
+    const key = String(ne.source ?? '');
+    pairedCuts.set(key, (pairedCuts.get(key) || 0) + 1);
     const dIn = ne.srcIn - oe.srcIn, dOut = ne.srcOut - oe.srcOut;
     if (dIn === 0 && dOut === 0) continue;
-    const key = String(ne.source ?? '');
     differing.set(key, (differing.get(key) || 0) + 1);
     if (dIn === 0 || dIn !== dOut) continue;
     if (!shiftTally.has(key)) shiftTally.set(key, new Map());
     shiftTally.get(key).set(dIn, (shiftTally.get(key).get(dIn) || 0) + 1);
   }
   // A rebase is the source's DOMINANT story: the same shift on ≥2 cuts AND
-  // on more than half of the cuts whose windows differ at all. A source whose
-  // cuts each shift by a different amount (an eye-matched re-conform onto
-  // other media — measured: two of seven cuts happened to share a shift) is
-  // trims, not a base change.
+  // on more than half of ALL the source's paired cuts (E150b) — not merely
+  // of the cuts whose windows differ: on a real reel two shifted cuts out of
+  // fifty-four were adopted as the base and turned fifty-two UNCHANGED cuts
+  // into false trims (a control with a free floor). A source whose cuts each
+  // shift by a different amount (an eye-matched re-conform onto other media
+  // — measured: two of seven cuts happened to share a shift) is trims, not
+  // a base change.
   const tcOffsets = new Map();
   for (const [source, tally] of shiftTally) {
     const [offset, cuts] = [...tally].sort((a, b) => b[1] - a[1])[0];
-    if (cuts >= 2 && cuts > (differing.get(source) || 0) / 2) tcOffsets.set(source, { source, offset, cuts, rebased: 0 });
+    if (cuts >= 2 && cuts > (pairedCuts.get(source) || 0) / 2) tcOffsets.set(source, { source, offset, cuts, rebased: 0 });
   }
 
+  // RETIME ROUNDING (E150): a retimed clip's source window is the speed map
+  // evaluated and rounded — Premiere's exact 80% and Resolve's keyframe
+  // slope (0.79999, frame-quantized seconds) land one frame apart on a real
+  // reel (41923 vs 41922). On a pair where either side is retimed a source
+  // edge within `srcTolerance` (default 1 frame) is the same window; a 100%
+  // pair keeps the exact compare.
+  const srcTol = opts.srcTolerance ?? 1;
+  const srcDiffers = (a, b, oe, ne) => {
+    if ((a ?? null) === (b ?? null)) return false;
+    if (a == null || b == null) return true;
+    const retimed = (oe.speed ?? 100) !== 100 || (ne.speed ?? 100) !== 100;
+    return retimed ? Math.abs(a - b) > srcTol : true;
+  };
   const retained = [];
   for (const { oe, ne } of P.pairs) {
     const deltas = {};
@@ -1067,7 +1084,7 @@ function diffChangelistOnce(oldEvents, newEvents, opts = {}) {
     } else if (Math.abs((oe.recIn ?? 0) - (ne.recIn ?? 0)) > recTol) {
       kind = 'moved';
       deltas.recIn = { old: oe.recIn, new: ne.recIn };
-    } else if ((oIn ?? null) !== (ne.srcIn ?? null) || (oOut ?? null) !== (ne.srcOut ?? null)) {
+    } else if (srcDiffers(oIn, ne.srcIn, oe, ne) || srcDiffers(oOut, ne.srcOut, oe, ne)) {
       kind = 'trimmed';
       deltas.src = { old: [oIn, oOut], new: [ne.srcIn, ne.srcOut], ...(off ? { tcOffset: off, oldBeforeRebase: [oe.srcIn, oe.srcOut] } : {}) };
     } else if (off && ((oe.srcIn ?? null) !== (ne.srcIn ?? null))) {

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

@@ -67,6 +67,7 @@ const changelistSchema = z.object({
   old: eventArray.describe('Old (locked-cut) normalized events, OR provide oldFormat+oldContent'),
   new: eventArray.describe('New (turnover) normalized events'),
   recTolerance: z.number().optional(),
+  srcTolerance: z.number().optional().describe('Source-frame slack on RETIMED pairs only (default 1): a speed map evaluated and rounded lands a frame apart between apps (E150); 100% pairs compare exactly'),
   timingGuards: z.boolean().optional().describe('Also run the timing silent-lie guards (default true)'),
   sourceAliases: z.array(z.object({ from: z.string().optional(), to: z.string().optional(), pattern: z.string().optional(), replace: z.string().optional(), flags: z.string().optional() })).optional()
     .describe('Rename OLD sources before pairing (E141): {from,to} exact or {pattern,replace} regex — e.g. the offline "4K-2K" proxies vs the online "4K" masters. A systematic rename is also inferred automatically (inferAliases) and reported in sourceAliases.'),
@@ -150,7 +151,7 @@ export const editorialTool = {
     }
     if (action === 'turnover_changelist') {
       const p = changelistSchema.parse(args);
-      const result = diffChangelist(p.old, p.new, { recTolerance: p.recTolerance, sourceAliases: p.sourceAliases, inferAliases: p.inferAliases });
+      const result = diffChangelist(p.old, p.new, { recTolerance: p.recTolerance, srcTolerance: p.srcTolerance, sourceAliases: p.sourceAliases, inferAliases: p.inferAliases });
       // The guards read the old cut through the SAME aliases the changelist adopted (E148).
       if (p.timingGuards !== false) result.timing = timingGuards(p.old, p.new, { sourceAliases: result.sourceAliases });
       return result;

package/src/granular/common.py

@@ -87,7 +87,7 @@ if not logging.getLogger().handlers:
         handlers=[logging.StreamHandler()],
     )
 
-VERSION = "2.201.0"
+VERSION = "2.202.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.201.0"
+VERSION = "2.202.0"
 
 import base64
 import os