davinci-resolve-mcp 2.57.3 → 2.57.4

package/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 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.57.4
+
+Live mutating verification of the catalogued API gaps.
+
+- **Added** `tests/live_api_gap_verification.py` — attempts each catalogued
+  "missing capability" against a disposable project built from synthetic ffmpeg
+  media, recording the failing call alongside a positive control that succeeds.
+  All 8 surface-audited gaps confirmed missing on Resolve Studio 21.0.0:
+  `SetProperty('Speed', …)` / audio-level keys return False while
+  `RetimeProcess` / video-transform keys succeed; trim/move/split/proxy/node-
+  graph/Smart-Bin methods are absent (by `dir()`), while append/CDL/AddSubFolder
+  controls work.
+- **Added** a new bug entry: `hasattr()`/`getattr()` are unusable on Resolve
+  objects — the Python bridge fabricates a callable for ANY attribute name, so
+  capability detection must use `dir()`. (Discovered when the first harness pass
+  reported nonexistent methods as present.) Report now lists 14 missing + 10 bugs.
+- **Changed** the report's Scope note to record the live mutating-harness
+  methodology and the `hasattr` caveat. Strengthened the clip-speed and
+  Fairlight-audio entries with the live `SetProperty` rejection evidence (and
+  noted that `'Pan'` is the video-transform key, not audio pan).
+
 ## What's New in v2.57.3
 
 Expanded the API-limitations catalogue with a live surface audit.

package/README.md

@@ -1,6 +1,6 @@
 # DaVinci Resolve MCP Server
 
-[![Version](https://img.shields.io/badge/version-2.57.3-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.57.4-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(341%20full)-blue.svg)](#server-modes)

package/docs/reference/api-limitations.md

@@ -12,7 +12,7 @@ that none exists).
 
 **Verified on:** DaVinci Resolve Studio 21.0.0
 
-**Totals:** 14 missing capabilities, 9 bugs / unreliable behaviors.
+**Totals:** 14 missing capabilities, 10 bugs / unreliable behaviors.
 
 The authoritative source is the runtime-queryable `api_truth` ledger
 (`resolve_control api_truth "<query>"`); this document is generated from
@@ -21,14 +21,21 @@ it and stays in sync via a drift guard.
 ### Scope & completeness
 
 This list is **not guaranteed exhaustive.** It combines (a) issues hit
-while building this MCP server and (b) a `dir()` surface audit of the live
+while building this MCP server, (b) a `dir()` surface audit of the live
 Resolve API objects (ProjectManager, Project, MediaPool, MediaPoolItem,
-Timeline, TimelineItem, Graph) diffed against Resolve's UI feature set.
+Timeline, TimelineItem, Graph) diffed against Resolve's UI feature set,
+and (c) a live mutating harness (`tests/live_api_gap_verification.py`)
+that attempts each operation against a disposable project built from
+synthetic media and confirms it fails while a related control succeeds.
 That catches absent methods and documented constraints, but not subtler
 issues: parameters that exist yet misbehave, version-specific regressions,
 or capabilities we simply never exercised. New findings are added as
 `submit`-tagged `api_truth` entries and this document is regenerated.
 
+Note: `hasattr()`/`getattr()` cannot be used to probe this API — the
+Python bridge fabricates a callable for any attribute name (see the
+`hasattr` bug below). Method existence here was checked with `dir()`.
+
 ## Missing Capabilities (please add)
 
 Functionality that exists in the Resolve UI but has no scripting API
@@ -95,7 +102,7 @@ equivalent, blocking full automation.
 ### Clip speed / retime ratio and speed ramps
 
 - **Object:** `TimelineItem`
-- **Behavior:** SetProperty exposes only retime *quality* (RetimeProcess, MotionEstimation) and transform/crop/composite/opacity keys — not the speed value itself. There is no way to set a clip to a given % speed, reverse it, or author a speed ramp. Verified against the documented SetProperty key list (21.0.0).
+- **Behavior:** SetProperty exposes only retime *quality* (RetimeProcess, MotionEstimation) and transform/crop/composite/opacity keys — not the speed value itself. There is no way to set a clip to a given % speed, reverse it, or author a speed ramp. Verified against the documented SetProperty key list AND by live mutating attempt on 21.0.0: SetProperty('Speed'|'PlaybackSpeed'|'RetimeSpeed'|'ClipSpeed', 50) all return False, while SetProperty('RetimeProcess', 1) returns True.
 - **Workaround / current handling:** Set clip speed/retime in the Resolve UI; no scripted equivalent exists.
 - **Tags:** missing-method, timeline, retime, speed
 
@@ -109,7 +116,7 @@ equivalent, blocking full automation.
 ### Fairlight audio levels / pan / EQ / automation / FairlightFX
 
 - **Object:** `TimelineItem / Timeline`
-- **Behavior:** There is no API to set clip or track volume, pan, EQ, audio automation, or to add/configure FairlightFX. SetProperty covers video transform only; the audio surface is read-only (GetSourceAudioChannelMapping, GetAudioMapping, voice isolation). Verified via dir() + SetProperty docs (21.0.0).
+- **Behavior:** There is no API to set clip or track volume, pan, EQ, audio automation, or to add/configure FairlightFX. SetProperty covers video transform only; the audio surface is read-only (GetSourceAudioChannelMapping, GetAudioMapping, voice isolation). Verified via dir() + SetProperty docs AND by live mutating attempt on 21.0.0: SetProperty('Volume'|'Level'|'Gain'|'AudioVolume', 0) all return False (note 'Pan' is the VIDEO transform key, not audio pan, so it misleadingly succeeds).
 - **Workaround / current handling:** Mix in the Fairlight UI; only voice-isolation state and channel-mapping reads are scriptable.
 - **Tags:** missing-method, audio, fairlight
 
@@ -206,3 +213,10 @@ values, or automation-hostile modal prompts.
 - **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.
 - **Tags:** project, modal, silent-failure
+
+### hasattr() / getattr() on Resolve API objects (attribute fabrication)
+
+- **Object:** `(all Resolve scripting objects)`
+- **Behavior:** The Python bridge returns a callable for ANY attribute name, so hasattr(obj, 'TotallyMadeUpMethod') is always True and getattr never raises. This makes capability detection by hasattr impossible — verified on 21.0.0 (hasattr reported SetStart, Razor, AddNode, GenerateProxy, AddSmartBin etc. as present though none exist). Only dir() lists the real methods.
+- **Workaround / current handling:** Never probe method existence with hasattr/getattr; test membership against dir(obj) instead. Calling a fabricated method typically returns None/False with no error.
+- **Tags:** bridge, introspection, silent-failure

package/install.py

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

package/scripts/gen_api_limitations.py

@@ -85,14 +85,21 @@ def render() -> str:
         "### Scope & completeness",
         "",
         "This list is **not guaranteed exhaustive.** It combines (a) issues hit",
-        "while building this MCP server and (b) a `dir()` surface audit of the live",
+        "while building this MCP server, (b) a `dir()` surface audit of the live",
         "Resolve API objects (ProjectManager, Project, MediaPool, MediaPoolItem,",
-        "Timeline, TimelineItem, Graph) diffed against Resolve's UI feature set.",
+        "Timeline, TimelineItem, Graph) diffed against Resolve's UI feature set,",
+        "and (c) a live mutating harness (`tests/live_api_gap_verification.py`)",
+        "that attempts each operation against a disposable project built from",
+        "synthetic media and confirms it fails while a related control succeeds.",
         "That catches absent methods and documented constraints, but not subtler",
         "issues: parameters that exist yet misbehave, version-specific regressions,",
         "or capabilities we simply never exercised. New findings are added as",
         "`submit`-tagged `api_truth` entries and this document is regenerated.",
         "",
+        "Note: `hasattr()`/`getattr()` cannot be used to probe this API — the",
+        "Python bridge fabricates a callable for any attribute name (see the",
+        "`hasattr` bug below). Method existence here was checked with `dir()`.",
+        "",
         "## Missing Capabilities (please add)",
         "",
         "Functionality that exists in the Resolve UI but has no scripting API",

package/src/granular/common.py

@@ -80,7 +80,7 @@ if not logging.getLogger().handlers:
         handlers=[logging.StreamHandler()],
     )
 
-VERSION = "2.57.3"
+VERSION = "2.57.4"
 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 341-tool granular server instead
 """
 
-VERSION = "2.57.3"
+VERSION = "2.57.4"
 
 import base64
 import os

package/src/utils/api_truth.py

@@ -290,7 +290,10 @@ API_TRUTH: List[Dict[str, Any]] = [
                    "MotionEstimation) and transform/crop/composite/opacity keys — "
                    "not the speed value itself. There is no way to set a clip to a "
                    "given % speed, reverse it, or author a speed ramp. Verified "
-                   "against the documented SetProperty key list (21.0.0).",
+                   "against the documented SetProperty key list AND by live "
+                   "mutating attempt on 21.0.0: SetProperty('Speed'|'PlaybackSpeed'"
+                   "|'RetimeSpeed'|'ClipSpeed', 50) all return False, while "
+                   "SetProperty('RetimeProcess', 1) returns True.",
         "recommended": "Set clip speed/retime in the Resolve UI; no scripted "
                        "equivalent exists.",
         "tags": ["missing-method", "timeline", "retime", "speed"],
@@ -319,7 +322,10 @@ API_TRUTH: List[Dict[str, Any]] = [
                    "automation, or to add/configure FairlightFX. SetProperty covers "
                    "video transform only; the audio surface is read-only "
                    "(GetSourceAudioChannelMapping, GetAudioMapping, voice "
-                   "isolation). Verified via dir() + SetProperty docs (21.0.0).",
+                   "isolation). Verified via dir() + SetProperty docs AND by live "
+                   "mutating attempt on 21.0.0: SetProperty('Volume'|'Level'|'Gain'"
+                   "|'AudioVolume', 0) all return False (note 'Pan' is the VIDEO "
+                   "transform key, not audio pan, so it misleadingly succeeds).",
         "recommended": "Mix in the Fairlight UI; only voice-isolation state and "
                        "channel-mapping reads are scriptable.",
         "tags": ["missing-method", "audio", "fairlight"],
@@ -360,6 +366,21 @@ API_TRUTH: List[Dict[str, Any]] = [
         "tags": ["missing-method", "media-pool", "bins"],
         "submit": "missing",
     },
+    {
+        "symbol": "hasattr() / getattr() on Resolve API objects (attribute fabrication)",
+        "object": "(all Resolve scripting objects)",
+        "reality": "The Python bridge returns a callable for ANY attribute name, so "
+                   "hasattr(obj, 'TotallyMadeUpMethod') is always True and getattr "
+                   "never raises. This makes capability detection by hasattr "
+                   "impossible — verified on 21.0.0 (hasattr reported SetStart, "
+                   "Razor, AddNode, GenerateProxy, AddSmartBin etc. as present "
+                   "though none exist). Only dir() lists the real methods.",
+        "recommended": "Never probe method existence with hasattr/getattr; test "
+                       "membership against dir(obj) instead. Calling a fabricated "
+                       "method typically returns None/False with no error.",
+        "tags": ["bridge", "introspection", "silent-failure"],
+        "submit": "bug",
+    },
     {
         "symbol": "subprocess inheriting stdin under the MCP stdio server",
         "object": "(server runtime)",