davinci-resolve-mcp 2.216.0 → 2.216.1

package/CHANGELOG.md

@@ -2,6 +2,30 @@
 
 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.216.1 — ValidateDCTL's layout sensitivity is in the API ledger
+
+### Documentation
+
+- **`Resolve.ValidateDCTL` (21.1+) misreads a one-line function.** Reported
+  by @legionsound on #207 from Studio 21.1.0.14: a minimal identity transform
+  laid out across lines validates (`None`, the documented success), while the
+  same function on a single line consistently returns "main DCTL function does
+  not have return value" — false, the return is there — and a truly invalid
+  source returns "cannot find main DCTL function", so the validator does
+  discriminate; it is the single-line layout it misparses. An earlier
+  multi-line timeout did not reproduce after a restart. Recorded as a reported
+  entry (not reproduced here, no 21.1 install) with the rule for any future
+  wrapper: pass the native diagnostic through verbatim, never reflow the
+  user's source to dodge it, and keep the multi-line identity fixture as the
+  control. This server's own `dctl validate` is a static offline check and
+  does not call `ValidateDCTL`. `docs/reference/api-limitations.md`
+  regenerated (52 bugs / unreliable behaviors).
+
+### Validation
+
+- Ledger and limitations-doc guards, full offline suite, drift guards and the
+  advanced Node suite. Documentation only; no Resolve behavior changed.
+
 ## What's New in v2.216.0 — twelve Resolve 21.1 read-only controls, in both server modes
 
 Contributed by @legionsound (#206), live-measured on Studio 21.1.0.14.

package/README.md

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

package/docs/reference/api-limitations.md

@@ -12,7 +12,7 @@ that none exists).
 
 **Verified on:** DaVinci Resolve Studio 21.0.2
 
-**Totals:** 41 missing capabilities, 51 bugs / unreliable behaviors.
+**Totals:** 41 missing capabilities, 52 bugs / unreliable behaviors.
 
 The authoritative source is the runtime-queryable `api_truth` ledger
 (`resolve_control api_truth "<query>"`); this document is generated from
@@ -760,3 +760,11 @@ values, or automation-hostile modal prompts.
 - **Behavior:** On Studio 19.1.3.7 the subtitle-delivery keys documented in the Resolve 21 API reference are accepted and fully inert: SetRenderSettings returns True for all three SubtitleFormat modes ('BurnIn', 'SeparateFile', 'EmbeddedCaptions'), and the renders carry no burned-in pixels (frame-extract verified), no sidecar subtitle file, and no embedded caption track (stream-probe verified) — with the subtitle cues readback-verified on the timeline and the subtitle track enabled. Quirk: ExportSubtitle alone returns False; the pair returns True. All three outputs are stream-identical to a no-subtitle render.
 - **Workaround / current handling:** Do not trust a True return for subtitle delivery on a pre-21 host — verify the output (extract a frame for burn-in, list the target directory for a sidecar, ffprobe streams for embedded captions). On 19.x subtitle export requires the UI render page. render.set_settings warns when these keys are set on a pre-21 host.
 - **Tags:** render, subtitle, burn-in, silent-failure, version-gated
+
+### Resolve.ValidateDCTL is sensitive to source layout
+
+- **Object:** `Resolve`
+- **Signature:** `(dctlSource) -> str | None  (21.1+)`
+- **Behavior:** Reported by @legionsound (issue #207) from Studio 21.1.0.14 on macOS; NOT reproduced here (no 21.1 install). The documented success result is None. A minimal identity transform written across several lines — `__DEVICE__ float3 transform(...)` with the body on its own lines — validates (None). The SAME function collapsed onto one line consistently returns 'DCTL Error: main DCTL function does not have return value.', which is false: the return statement is there. A genuinely invalid source returns 'cannot find main DCTL function.', so the validator does distinguish; it is the single-line layout it misreads. An earlier multi-line timeout did not reproduce after a Resolve restart with a 30-second limit. Nothing establishes a GPU compiler or render defect — this is the validator's parse, not the DCTL's execution. EncryptDCTL untested.
+- **Workaround / current handling:** Any wrapper around ValidateDCTL must pass the native diagnostic through verbatim and must not reflow or rewrite the user's source to dodge it; ship the multi-line identity fixture as the known-good control. A 'no return value' error on a one-line function is this quirk, not a missing return — re-run the validation with the function laid out across lines before believing it. This server's own `dctl validate` is a static, offline check (entry point, brace balance, float suffixes) and does not call ValidateDCTL at all.
+- **Tags:** dctl, validation, unreliable-return, version-gated, reported

package/install.py

@@ -37,7 +37,7 @@ from src.utils.update_check import (
 
 # ─── Version ──────────────────────────────────────────────────────────────────
 
-VERSION = "2.216.0"
+VERSION = "2.216.1"
 # 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.216.0",
+  "version": "2.216.1",
   "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.216.0"
+VERSION = "2.216.1"
 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 365-tool granular server instead
 """
 
-VERSION = "2.216.0"
+VERSION = "2.216.1"
 
 import base64
 import os

package/src/utils/api_truth.py

@@ -3207,6 +3207,37 @@ API_TRUTH: List[Dict[str, Any]] = [
         "submit": "bug",
         "mitigation": ["render.set_settings warnings"],
     },
+    {
+        "symbol": "Resolve.ValidateDCTL is sensitive to source layout",
+        "object": "Resolve",
+        "signature": "(dctlSource) -> str | None  (21.1+)",
+        "reality": "Reported by @legionsound (issue #207) from Studio 21.1.0.14 on "
+                   "macOS; NOT reproduced here (no 21.1 install). The documented "
+                   "success result is None. A minimal identity transform written "
+                   "across several lines — `__DEVICE__ float3 transform(...)` with "
+                   "the body on its own lines — validates (None). The SAME function "
+                   "collapsed onto one line consistently returns 'DCTL Error: main "
+                   "DCTL function does not have return value.', which is false: the "
+                   "return statement is there. A genuinely invalid source returns "
+                   "'cannot find main DCTL function.', so the validator does "
+                   "distinguish; it is the single-line layout it misreads. An "
+                   "earlier multi-line timeout did not reproduce after a Resolve "
+                   "restart with a 30-second limit. Nothing establishes a GPU "
+                   "compiler or render defect — this is the validator's parse, not "
+                   "the DCTL's execution. EncryptDCTL untested.",
+        "recommended": "Any wrapper around ValidateDCTL must pass the native "
+                       "diagnostic through verbatim and must not reflow or rewrite "
+                       "the user's source to dodge it; ship the multi-line identity "
+                       "fixture as the known-good control. A 'no return value' "
+                       "error on a one-line function is this quirk, not a missing "
+                       "return — re-run the validation with the function laid out "
+                       "across lines before believing it. This server's own "
+                       "`dctl validate` is a static, offline check (entry point, "
+                       "brace balance, float suffixes) and does not call "
+                       "ValidateDCTL at all.",
+        "tags": ["dctl", "validation", "unreliable-return", "version-gated", "reported"],
+        "submit": "bug",
+    },
 ]