davinci-resolve-mcp 4.10.6 → 4.11.0

package/CHANGELOG.md

@@ -2,6 +2,68 @@
 
 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 v4.11.0 — `rename_plan` collides names a case-insensitive volume treats as one
+
+### Fixes
+
+- **`media(action="rename_plan")` missed collisions that only differ in case
+  or Unicode form.** macOS (default APFS) and Windows volumes are
+  case-insensitive, and APFS also ignores Unicode normalization, so renaming
+  `take_A.mov` to `A.mov` overwrites an existing `a.mov`. The plan compared
+  names byte-for-byte and reported that rename as free (`collisions: 0`).
+  - Targets are now compared after NFC normalization and lowercasing, so
+    `A.mov` / `a.mov` and `café` spelled precomposed or with a combining
+    accent each count as one file.
+  - A case-only rename of a single file (`clip.MOV` → `clip.mov`) is still a
+    `rename`, not a collision.
+
+### New parameter
+
+- `rename_plan` takes `caseSensitive` (default `false`). Pass `true` only for
+  a case-sensitive volume to restore exact comparison. The result reports the
+  mode used as `caseSensitive`.
+
+### Validation
+
+- Offline planning only; nothing calls Resolve or touches files. New
+  `media-ops` test fails on the old code and passes now; `group-grade-read`
+  gains a case for a group name with `"`, `<` and `>`, as Studio 19.1.3.7
+  escapes them.
+
+## What's New in v4.10.7 — `retargetDRT` moves the `<ProjectVersion>` import gate, not only the comment stamp
+
+### Fixes
+
+- **`retargetDRT` / `retargetDRP` produced files an older Resolve still
+  refused.** Resolve decides "A newer version of DaVinci Resolve is needed to
+  import" on project.xml's `<ProjectVersion>` element; it never reads the
+  `DbAppVer="…" DbPrjVer="…"` comment for that decision. The vendored
+  `drt-format/resolve-versions.js` rewrote the comment on every XML member and
+  left the element alone, so a DRP "retargeted" to 19 still carried 17 inside.
+  - **The bundled project shell had the same hole.** It is a 20.3.2 export
+    with `<ProjectVersion>15</ProjectVersion>`, so a tool-built DRT retargeted
+    to 19 shipped a shell Resolve 19 cannot open.
+  - `restampVersions` now also moves any `<ProjectVersion>` element to the
+    target's DbPrjVer, whatever its current value. A DRP's kept project.xml
+    and the added shell both land on the target schema. DRX and
+    SeqContainer/MpFolder XML carry no such element and are unchanged;
+    unrelated numbers in the body are untouched.
+  - The `drt` tool's `downgrade` and `assemble` actions patched the element
+    themselves and were never affected; the library on its own was.
+
+### Validation
+
+- Tests: gate moved for a DRP's project.xml and for the shell at every
+  registry target (19, 20, 21); null control that XML without the element
+  gains none and keeps its other numbers; the pre-fix module leaves the gate
+  at 17 on the same input.
+- Vendored drt-format suites: 51 pass, 0 fail, 1 pre-existing skip (missing
+  fixture). Server drt suites (downgrade, assemble, events): 32/32.
+- Manual import, 2026-10-13: a Resolve 21.0.3 timeline (schema 17) imported
+  into Resolve 19.1.3 once the element read 14. The `.drp` round-trip harness
+  was not run: it needs a Resolve 21.x Studio host, and this machine runs
+  19.1.3.7.
+
 ## What's New in v4.10.6 — names that need xml escaping reach their bin and their color group
 
 ### Fixes

package/README.md

@@ -2,7 +2,7 @@
 
 English | [简体中文](README.zh-CN.md)
 
-[![Version](https://img.shields.io/badge/version-4.10.6-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-4.11.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-37%20(389%20full)-blue.svg)](#server-modes)

package/README.zh-CN.md

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

package/resolve-advanced/server/media-ops.mjs

@@ -121,7 +121,9 @@ const CAMERA_ORIGINAL_RE = /^([A-Z]\d{3}[_ ]?[CR]\d{3,4}|[A-Z]\d{3}_\d{8}_C\d+|M
 /**
  * Dry-run rename plan (regex find/replace). REFUSES camera originals (sidecar/DB only).
  * @param {string[]} names basenames to rename
- * @param {{find:string, replace:string, allowCameraOriginals?:boolean, cameraOriginalRe?:RegExp}} rule
+ * @param {{find:string, replace:string, allowCameraOriginals?:boolean, cameraOriginalRe?:RegExp, caseSensitive?:boolean}} rule
+ *   caseSensitive defaults to false: macOS (APFS) and Windows volumes treat names that
+ *   differ only in case or Unicode normalization as one file, so those collide.
  */
 export function renamePlan(names, rule = {}) {
   let re;
@@ -133,27 +135,30 @@ export function renamePlan(names, rule = {}) {
   const camRe = rule.cameraOriginalRe || CAMERA_ORIGINAL_RE;
   const plan = [];
   const targets = new Map();
+  const caseSensitive = rule.caseSensitive === true;
+  const key = (n) => (caseSensitive ? n : n.normalize('NFC').toLowerCase());
   // A name the plan leaves in place still occupies it — a refused camera original
   // above all — so it counts as a target too, or a rename onto it reads as free.
   for (const name of names) {
     const isCam = camRe.test(name);
     if (isCam && !rule.allowCameraOriginals) {
       plan.push({ from: name, action: 'refuse-camera-original', note: 'camera original — rename via sidecar/DB only, never the file' });
-      targets.set(name, (targets.get(name) || 0) + 1);
+      targets.set(key(name), (targets.get(key(name)) || 0) + 1);
       continue;
     }
     const to = name.replace(re, rule.replace ?? '');
-    targets.set(to, (targets.get(to) || 0) + 1);
+    targets.set(key(to), (targets.get(key(to)) || 0) + 1);
     plan.push({ from: name, to, action: to === name ? 'noop' : 'rename' });
   }
   // Flag collisions (two sources → one target).
-  for (const p of plan) if (p.action === 'rename' && targets.get(p.to) > 1) p.action = 'collision';
+  for (const p of plan) if (p.action === 'rename' && targets.get(key(p.to)) > 1) p.action = 'collision';
   const collisions = plan.filter((p) => p.action === 'collision');
   return {
     plan,
     renameCount: plan.filter((p) => p.action === 'rename').length,
     refused: plan.filter((p) => p.action === 'refuse-camera-original').length,
     collisions: collisions.length,
+    caseSensitive,
     dryRun: true,
   };
 }

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

@@ -47,6 +47,10 @@ const renameSchema = z.object({
   find: z.string(),
   replace: z.string().optional(),
   allowCameraOriginals: z.boolean().optional(),
+  caseSensitive: z
+    .boolean()
+    .optional()
+    .describe('Default false: names differing only in case/Unicode form collide, as on macOS and Windows volumes. Pass true only for a case-sensitive volume.'),
 });
 
 const reelSchema = z.object({ reels: z.array(z.string()), pad: z.number().optional() });
@@ -83,7 +87,7 @@ export const mediaTool = {
     }
     if (action === 'rename_plan') {
       const p = renameSchema.parse(args);
-      return renamePlan(p.names, { find: p.find, replace: p.replace, allowCameraOriginals: p.allowCameraOriginals });
+      return renamePlan(p.names, { find: p.find, replace: p.replace, allowCameraOriginals: p.allowCameraOriginals, caseSensitive: p.caseSensitive });
     }
     if (action === 'reel_normalize') {
       const p = reelSchema.parse(args);

package/resolve-advanced/vendor/drt-format/__tests__/multi-format.test.js

@@ -91,3 +91,17 @@ test('index re-exports the multi-format surface', () => {
   assert.equal(typeof drt.capabilityDomains.capabilitiesForFormat, 'function');
   assert.equal(typeof drt.schemaFingerprint.fingerprintFile, 'function');
 });
+
+test('retargetDRP moves the kept project.xml\'s <ProjectVersion> gate, not only its stamp', async () => {
+  // A real Resolve 21 DRP: full project.xml with the gate at 17.
+  const zip = new JSZip();
+  zip.file('project.xml', `${STAMP('21.0.3.0007', '17')}\n<SM_Project><FullProjectSentinel>keep</FullProjectSentinel><ProjectVersion>17</ProjectVersion></SM_Project>`);
+  zip.file('SeqContainer/uuid-1.xml', `${STAMP('21.0.3.0007', '17')}\n<Sm2SequenceContainer><Sm2TiVideoClip><MediaRef>m</MediaRef></Sm2TiVideoClip></Sm2SequenceContainer>`);
+  zip.file('MediaPool/Master/MpFolder.xml', `${STAMP('21.0.3.0007', '17')}\n<MpFolder/>`);
+  const out = await retargetDRP(await zip.generateAsync({ type: 'nodebuffer' }), 19);
+  const proj = await (await JSZip.loadAsync(out)).file('project.xml').async('string');
+  assert.ok(proj.includes('FullProjectSentinel'), 'project kept');
+  assert.ok(proj.includes('<ProjectVersion>14</ProjectVersion>'), 'gate moved to 14');
+  assert.ok(!proj.includes('<ProjectVersion>17</ProjectVersion>'), 'old gate gone');
+  assert.deepEqual(readVersionStamp(proj), { dbAppVer: '19.1.3.0007', dbPrjVer: '14' });
+});

package/resolve-advanced/vendor/drt-format/__tests__/resolve-versions.test.js

@@ -118,3 +118,45 @@ test('index re-exports retargetDRT + capabilities surface', () => {
   assert.equal(typeof drt.resolveVersions.resolveVersion, 'function');
   assert.equal(typeof drt.capabilities.collectCapabilities, 'function');
 });
+
+// ---- the import gate: <ProjectVersion> in project.xml ----
+// Resolve decides "a newer version is needed" on this element, not on the comment
+// stamp. Verified live 2026-10-13: a 21.0.3 DRT imported into 19.1.3 only once the
+// element read 14. Before this fix retargetDRT moved the comment and left the gate.
+
+const { restampVersions } = require('../resolve-versions');
+
+test('restampVersions moves the <ProjectVersion> gate to the target schema, whatever it was', () => {
+  const src = { dbAppVer: '21.0.3.0007', dbPrjVer: '17' };
+  const tgt = VERSIONS[19];
+  const proj = `<!--DbAppVer="21.0.3.0007" DbPrjVer="17"-->\n<SM_Project><ProjectVersion>17</ProjectVersion><Name>T</Name></SM_Project>`;
+  const out = restampVersions(proj, src, tgt);
+  assert.ok(out.includes('<ProjectVersion>14</ProjectVersion>'), 'gate moved to 14');
+  assert.ok(!out.includes('17'), 'no residual 17 in stamp or gate');
+  // a gate that disagrees with the comment stamp (the bundled shell: comment 15, element 15,
+  // but a hand-edited file could differ) still lands on the target
+  const skew = `<!--DbAppVer="21.0.3.0007" DbPrjVer="17"-->\n<SM_Project><ProjectVersion>15</ProjectVersion></SM_Project>`;
+  assert.ok(restampVersions(skew, src, tgt).includes('<ProjectVersion>14</ProjectVersion>'));
+});
+
+test('restampVersions: null control — XML without the element gains none, other numbers untouched', () => {
+  const seq = `<!--DbAppVer="21.0.3.0007" DbPrjVer="17"-->\n<Sm2SequenceContainer><Version>17</Version><Start>17</Start></Sm2SequenceContainer>`;
+  const out = restampVersions(seq, { dbAppVer: '21.0.3.0007', dbPrjVer: '17' }, VERSIONS[19]);
+  assert.ok(!out.includes('<ProjectVersion>'), 'no element invented');
+  assert.ok(out.includes('<Version>17</Version><Start>17</Start>'), 'unrelated 17s kept');
+  assert.deepEqual(readVersionStamp(out), { dbAppVer: '19.1.3.0007', dbPrjVer: '14' });
+});
+
+test('retargetDRT: the added shell carries the TARGET gate, not the template\'s own', async () => {
+  // The bundled shell is a 20.3.2 export (<ProjectVersion>15</ProjectVersion>); a DRT
+  // retargeted to 19 must not ship a shell Resolve 19 refuses.
+  const src = await makeDrt({ dbAppVer: '21.0.0.0048', dbPrjVer: '17', body: MEDIA_CLIP });
+  for (const tgt of [19, 20, 21]) {
+    const z = await JSZip.loadAsync(await retargetDRT(src, tgt));
+    const proj = await z.file('project.xml').async('string');
+    const gates = proj.match(/<ProjectVersion>(\d+)<\/ProjectVersion>/g) || [];
+    assert.equal(gates.length, 1, `shell has exactly one gate (target ${tgt})`);
+    assert.equal(gates[0], `<ProjectVersion>${VERSIONS[tgt].dbPrjVer}</ProjectVersion>`);
+    assert.deepEqual(readVersionStamp(proj), { dbAppVer: VERSIONS[tgt].dbAppVer, dbPrjVer: VERSIONS[tgt].dbPrjVer });
+  }
+});

package/resolve-advanced/vendor/drt-format/resolve-versions.js

@@ -54,19 +54,31 @@ function readVersionStamp(seqXml) {
 
 const SEQ_RE = /(^|\/)SeqContainer(\d*\.xml|\/[^/]+\.xml)$/;
 
+// The import GATE: project.xml's <ProjectVersion> element. Resolve refuses a file whose
+// value is above its own ("A newer version of DaVinci Resolve is needed to import") and
+// never reads the comment stamp for that decision — verified live 2026-10-13 (a 21.0.3
+// DRT with the element at 14 imported into 19.1.3; the same file with only the comment
+// re-stamped did not). DRX and SeqContainer/MpFolder XML carry no such element.
+const PROJECT_VERSION_RE = /<ProjectVersion>\d+<\/ProjectVersion>/g;
+
 // Value-based version re-stamp (not length-dependent → safe even if stamp widths differ).
 // Shared by every format (DRT, DRP, DRX) — the DbAppVer/DbPrjVer header is universal.
+// Also moves the <ProjectVersion> gate (whatever its current value) to the target schema,
+// so a project.xml — a DRP's own or the bundled shell — is importable by the target, not
+// just labelled for it.
 function restampVersions(xmlStr, src, target) {
   return xmlStr
     .split(`DbAppVer="${src.dbAppVer}"`).join(`DbAppVer="${target.dbAppVer}"`)
-    .split(`DbPrjVer="${src.dbPrjVer}"`).join(`DbPrjVer="${target.dbPrjVer}"`);
+    .split(`DbPrjVer="${src.dbPrjVer}"`).join(`DbPrjVer="${target.dbPrjVer}"`)
+    .replace(PROJECT_VERSION_RE, `<ProjectVersion>${target.dbPrjVer}</ProjectVersion>`);
 }
 
 /**
  * Re-stamp a zip-based Resolve file (DRT or DRP) to a target version. Value-based,
  * so it's safe even if stamp widths differ. Re-stamps every XML entry in place
- * (keeping a DRP's full project.xml); adds a stamped generic shell only if the source
- * has no project.xml (a tool-built DRT).
+ * (keeping a DRP's full project.xml, with its <ProjectVersion> gate moved to the
+ * target schema); adds a stamped generic shell only if the source has no project.xml
+ * (a tool-built DRT).
  *
  * @param {Buffer} drtBuffer  a real-schema .drt/.drp (SeqContainer/<uuid>.xml + MpFolder)
  * @param {number|string} targetKey  e.g. 19, 20, 21

package/src/granular/common.py

@@ -91,7 +91,7 @@ if not logging.getLogger().handlers:
         handlers=[logging.StreamHandler()],
     )
 
-VERSION = "4.10.6"
+VERSION = "4.11.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 377-tool granular server instead
 """
 
-VERSION = "4.10.6"
+VERSION = "4.11.0"
 
 import base64
 import os