davinci-resolve-mcp 2.94.2 → 2.94.3

package/CHANGELOG.md

@@ -2,6 +2,56 @@
 
 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.94.3
+
+A systematic sweep of catalogued API gaps against **Studio 21.0.4.5**, prompted
+by an external report. Two ledger entries were wrong and are corrected; a new
+harness proves the routes that DO work.
+
+### Fixed — transitions are not invisible to scripting
+
+- **`Transition create / copy / clone` claimed transitions applied in the UI are
+  "invisible to and unmodifiable by scripts". Both halves were wrong.** A
+  12-frame Cross Dissolve applied through the Edit-page right-click menu
+  enumerates in `GetItemListInTrack` as `GetName() == 'Cross Dissolve'`,
+  `GetStart() == 86426`, `GetDuration() == 12` — centered on a cut at 86432 —
+  with a stable `GetUniqueId()`. One authored offline into a `.drp` and imported
+  reads identically, so the creating route is irrelevant. It is also removable:
+  `DeleteClips([transition], False)` returns True and leaves both adjacent clips
+  untouched. **The discriminator** is `GetProperty()`: empty on a transition, 26
+  transform keys on a clip. Automated QC of existing transitions is therefore
+  possible. Genuinely missing: creation, cloning, and any type/alignment detail —
+  the kind is knowable only from the name string.
+
+### Fixed — CreateProject is not an "Untitled project" problem
+
+- **`CreateProject` returned None with a NAMED project current and no modal on
+  screen** (screenshot-confirmed), while `OpenPage('edit')` succeeded in the same
+  session — so the connection was healthy and the documented modal is not the
+  only mechanism. Loading any clean project unblocked it on the next call. The
+  entry's recommended workaround was `CloseProject`, which **discards unsaved
+  changes** — acceptable for a throwaway Untitled project, destructive when the
+  current project is a named one belonging to another session. It now recommends
+  `LoadProject(clean project)` instead.
+
+### Added — `tests/live_workaround_verification.py`
+
+The sibling of the gap harness: where that one proves absence, this proves
+presence, performing each operation and reading the result back. Seven routes
+verified on 21.0.4.5 — nested-timeline title placement with a later text edit,
+ripple delete (with a non-ripple control showing the gap), the take selector as
+an in-place source swap, `GetSelectedClips`, and constant retime through both
+OTIO `LinearTimeWarp` and EDL `M2` (each a true 200%: 96 source frames over a
+48-frame record, alongside a 1.0 control). It also records the compound-clip trap
+as a deliberate `ROUTE FAILS`.
+
+### Changed — the gap harness covers 13 gaps, up from 8
+
+Added control-paired repros for the Source/Auto Track Selector (locking V1 blocks
+the insert rather than redirecting it, while a media-backed clip targets V2
+fine), transitions, native multicam creation, per-caption subtitle text, and
+per-clip audio channel mapping. **13/13 confirmed missing** on 21.0.4.5.
+
 ## What's New in v2.94.2
 
 Changelog repair. No code changed.

package/README.md

@@ -2,7 +2,7 @@
 
 English | [简体中文](README.zh-CN.md)
 
-[![Version](https://img.shields.io/badge/version-2.94.2-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.94.3-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-34%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.94.2-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.94.3-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-34%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.94.2 版 README。如与英文原版有出入，以 [英文原版](README.md) 为准。
+> 本翻译对应 v2.94.3 版 README。如与英文原版有出入，以 [英文原版](README.md) 为准。
 
 一个 Model Context Protocol (MCP) 服务器，让 AI 助手通过官方脚本 API 控制 DaVinci Resolve Studio（达芬奇）。它提供完整的 API 覆盖，外加带护栏的工作流助手，涵盖剪辑、媒体池整理、渲染设置、审阅标记、调色、Fusion、Fairlight、项目生命周期任务、扩展开发，以及不碰源媒体的媒体分析。
 

package/docs/reference/api-limitations.md

@@ -89,8 +89,8 @@ equivalent, blocking full automation.
 ### Transition create / copy / clone
 
 - **Object:** `Timeline / TimelineItem`
-- **Behavior:** The scripting API exposes no method to add, read, copy, or clone an edit transition (cross-dissolve, etc.). Transitions applied in the UI are invisible to and unmodifiable by scripts.
-- **Workaround / current handling:** Apply/duplicate transitions in the Resolve UI; no scripted equivalent exists.
+- **Behavior:** There is no method to ADD or CLONE an edit transition — no AddTransition/CreateTransition/AddVideoTransition on Timeline or TimelineItem (dir(), 21.0.4.5). CORRECTION, measured on Studio 21.0.4.5 (2026-08-12): this entry previously said transitions applied in the UI are 'invisible to and unmodifiable by scripts'. BOTH HALVES WERE WRONG and are withdrawn. A transition IS a first-class timeline item: a 12-frame Cross Dissolve applied through the Edit-page right-click menu enumerates in GetItemListInTrack('video', 1) as GetName()=='Cross Dissolve', GetStart()==86426, GetDuration()==12 — centered on a cut at 86432 — with a stable GetUniqueId() and a working GetTrackTypeAndIndex(). A transition authored offline into a .drp and imported reads IDENTICALLY, so the route that created it does not matter. It is also REMOVABLE: Timeline.DeleteClips([transition], False) returns True and deletes it, leaving both adjacent clips at their original starts and durations. THE DISCRIMINATOR between a transition item and a clip item is GetProperty(): a transition returns an EMPTY dict where a video clip returns 26 transform keys; it also has no MediaPoolItem and no Fusion comp. WHAT IS GENUINELY MISSING: creation, cloning, and any type/alignment/parameter detail — the transition's kind is knowable ONLY from its name string, and there is no way to read its alignment (centered/start/end) or edit its duration.
+- **Workaround / current handling:** Automated QC of existing transitions IS possible and is the main practical need — enumerate GetItemListInTrack, treat any item whose GetProperty() is empty and whose GetMediaPoolItem() is None as a transition, and read its name, start and duration. Removal is scriptable via Timeline.DeleteClips. To CREATE one, either apply it in the Resolve UI, or author it offline and import: the advanced server's drp place_transition writes a cross dissolve at an abutting cut ({track, atFrame, durationFrames}) and it round-trips into Resolve 21.0.4.5 reading back at the expected centered range.
 - **Tags:** missing-method, timeline, transition
 
 ### Cloud project enumeration / export / user management
@@ -367,11 +367,11 @@ values, or automation-hostile modal prompts.
 - **Workaround / current handling:** Treat a trailing ellipsis as truncation (see media_pool_item get_transcription's `truncated` flag).
 - **Tags:** transcription, truncation
 
-### ProjectManager.CreateProject (with a dirty Untitled project)
+### ProjectManager.CreateProject (blocked by the current project)
 
 - **Object:** `ProjectManager`
-- **Behavior:** Returns None and pops a modal 'Save Current Project' dialog when the current unsaved/Untitled project blocks the switch. SaveProject() on an Untitled project re-triggers the same modal.
-- **Workaround / current handling:** CloseProject(current) to discard the untitled project without a prompt, then CreateProject; restore with LoadProject afterward.
+- **Behavior:** Returns None and pops a modal 'Save Current Project' dialog when the current unsaved/Untitled project blocks the switch. SaveProject() on an Untitled project re-triggers the same modal. BROADER THAN 'UNTITLED', measured on Studio 21.0.4.5 (2026-08-12): with a NAMED project current (a conform project left open on the Deliver page), CreateProject returned None for a brand-new name and SaveProject returned False — with NO modal on screen, confirmed by screenshot, so the dialog is not the only mechanism. The connection was healthy throughout: OpenPage('edit') returned True in the same session, and moving to the Edit page did not help. Loading ANY clean project immediately unblocked it — CreateProject succeeded on the very next call. So the trigger is the current project, not the 'Untitled' name, and a bare False/None is the only signal.
+- **Workaround / current handling:** LoadProject(any clean project) first, then CreateProject; restore the caller's project afterward. PREFER THAT OVER CloseProject, which this entry used to recommend: CloseProject DISCARDS unsaved changes, which is fine for a throwaway Untitled project but destroys work when the current project is a named one belonging to someone else's session — and the failure is NOT limited to Untitled projects, so that is a live risk. Never assume a bare None here means the name is taken; check GetProjectListInCurrentFolder().
 - **Tags:** project, modal, silent-failure
 
 ### TimelineItem.GetSourceStartFrame

package/install.py

@@ -36,7 +36,7 @@ from src.utils.update_check import (
 
 # ─── Version ──────────────────────────────────────────────────────────────────
 
-VERSION = "2.94.2"
+VERSION = "2.94.3"
 # 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.94.2",
+  "version": "2.94.3",
   "description": "NPM bootstrapper for the DaVinci Resolve MCP Server.",
   "license": "MIT",
   "author": "Samuel Gursky <samgursky@gmail.com>",

package/src/granular/common.py

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

package/src/utils/api_truth.py

@@ -525,14 +525,32 @@ API_TRUTH: List[Dict[str, Any]] = [
         "submit": "bug",
     },
     {
-        "symbol": "ProjectManager.CreateProject (with a dirty Untitled project)",
+        "symbol": "ProjectManager.CreateProject (blocked by the current project)",
         "object": "ProjectManager",
         "reality": "Returns None and pops a modal 'Save Current Project' dialog "
                    "when the current unsaved/Untitled project blocks the switch. "
-                   "SaveProject() on an Untitled project re-triggers the same modal.",
-        "recommended": "CloseProject(current) to discard the untitled project "
-                       "without a prompt, then CreateProject; restore with "
-                       "LoadProject afterward.",
+                   "SaveProject() on an Untitled project re-triggers the same modal. "
+                   "BROADER THAN 'UNTITLED', measured on Studio 21.0.4.5 "
+                   "(2026-08-12): with a NAMED project current (a conform project "
+                   "left open on the Deliver page), CreateProject returned None for "
+                   "a brand-new name and SaveProject returned False — with NO modal "
+                   "on screen, confirmed by screenshot, so the dialog is not the "
+                   "only mechanism. The connection was healthy throughout: "
+                   "OpenPage('edit') returned True in the same session, and moving "
+                   "to the Edit page did not help. Loading ANY clean project "
+                   "immediately unblocked it — CreateProject succeeded on the very "
+                   "next call. So the trigger is the current project, not the "
+                   "'Untitled' name, and a bare False/None is the only signal.",
+        "recommended": "LoadProject(any clean project) first, then CreateProject; "
+                       "restore the caller's project afterward. PREFER THAT OVER "
+                       "CloseProject, which this entry used to recommend: "
+                       "CloseProject DISCARDS unsaved changes, which is fine for a "
+                       "throwaway Untitled project but destroys work when the "
+                       "current project is a named one belonging to someone else's "
+                       "session — and the failure is NOT limited to Untitled "
+                       "projects, so that is a live risk. Never assume a bare None "
+                       "here means the name is taken; check "
+                       "GetProjectListInCurrentFolder().",
         "tags": ["project", "modal", "silent-failure"],
         "submit": "bug",
     },
@@ -663,11 +681,41 @@ API_TRUTH: List[Dict[str, Any]] = [
     {
         "symbol": "Transition create / copy / clone",
         "object": "Timeline / TimelineItem",
-        "reality": "The scripting API exposes no method to add, read, copy, or "
-                   "clone an edit transition (cross-dissolve, etc.). Transitions "
-                   "applied in the UI are invisible to and unmodifiable by scripts.",
-        "recommended": "Apply/duplicate transitions in the Resolve UI; no scripted "
-                       "equivalent exists.",
+        "reality": "There is no method to ADD or CLONE an edit transition — no "
+                   "AddTransition/CreateTransition/AddVideoTransition on Timeline "
+                   "or TimelineItem (dir(), 21.0.4.5). CORRECTION, measured on "
+                   "Studio 21.0.4.5 (2026-08-12): this entry previously said "
+                   "transitions applied in the UI are 'invisible to and "
+                   "unmodifiable by scripts'. BOTH HALVES WERE WRONG and are "
+                   "withdrawn. A transition IS a first-class timeline item: a "
+                   "12-frame Cross Dissolve applied through the Edit-page "
+                   "right-click menu enumerates in GetItemListInTrack('video', 1) "
+                   "as GetName()=='Cross Dissolve', GetStart()==86426, "
+                   "GetDuration()==12 — centered on a cut at 86432 — with a stable "
+                   "GetUniqueId() and a working GetTrackTypeAndIndex(). A "
+                   "transition authored offline into a .drp and imported reads "
+                   "IDENTICALLY, so the route that created it does not matter. It "
+                   "is also REMOVABLE: Timeline.DeleteClips([transition], False) "
+                   "returns True and deletes it, leaving both adjacent clips at "
+                   "their original starts and durations. THE DISCRIMINATOR between "
+                   "a transition item and a clip item is GetProperty(): a "
+                   "transition returns an EMPTY dict where a video clip returns 26 "
+                   "transform keys; it also has no MediaPoolItem and no Fusion "
+                   "comp. WHAT IS GENUINELY MISSING: creation, cloning, and any "
+                   "type/alignment/parameter detail — the transition's kind is "
+                   "knowable ONLY from its name string, and there is no way to "
+                   "read its alignment (centered/start/end) or edit its duration.",
+        "recommended": "Automated QC of existing transitions IS possible and is "
+                       "the main practical need — enumerate GetItemListInTrack, "
+                       "treat any item whose GetProperty() is empty and whose "
+                       "GetMediaPoolItem() is None as a transition, and read its "
+                       "name, start and duration. Removal is scriptable via "
+                       "Timeline.DeleteClips. To CREATE one, either apply it in the "
+                       "Resolve UI, or author it offline and import: the advanced "
+                       "server's drp place_transition writes a cross dissolve at an "
+                       "abutting cut ({track, atFrame, durationFrames}) and it "
+                       "round-trips into Resolve 21.0.4.5 reading back at the "
+                       "expected centered range.",
         "tags": ["missing-method", "timeline", "transition"],
         "submit": "missing",
     },