davinci-resolve-mcp 2.72.0 → 2.72.1

package/CHANGELOG.md

@@ -2,6 +2,48 @@
 
 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.72.1
+
+Documentation only. The API coverage page stated its method counts in four
+places and they disagreed; the cause turned out to be structural rather than
+clerical.
+
+### The Resolve 21 surface was never counted
+
+None of the Resolve 21 methods appeared in the Complete API Reference tables —
+the tables the `API Methods Covered` denominator counts — although the server
+has wrapped, released and live-tested them since v2.28.1. So `337/337 (100%)`
+described a surface that excluded nine methods across four classes, and the
+`336 → 337` bump for `ResetIntellisearchAnalysis` added one to a count whose
+table did not list it.
+
+Thirteen rows added, one per method per object class, since a wrapper on
+`Folder` and one on `MediaPoolItem` can fail independently. Signatures taken
+from the bundled 21.0.2 scripting reference. `TranscribeAudio` was already
+listed — its Resolve 21 change is the optional `useSpeakerDetection` argument,
+accepted but producing identical transcripts either way — so those rows are
+annotated rather than duplicated.
+
+Every summary figure is now derived from the tables: **349 covered, 338 live
+tested, 11 untested**.
+
+### The counting convention is now written down
+
+Two of the three disagreements came from it being implicit:
+
+- A method that could not be executed is **not** counted as a pass. The old
+  "Resolve 21 delta 8/9" counted Extras-blocked methods as passes, contradicting
+  the prose directly above it and overstating coverage exactly where the risk is
+  highest.
+- The phase table counts **methods, not assertions**, which is why its Total
+  equals Methods Live Tested. That ambiguity is what made two figures look
+  independently wrong.
+
+`tests/test_api_coverage_arithmetic.py` derives all four figures from the
+reference tables and fails if any disagrees, so the tables stay the single
+source. It was checked against both drift shapes: a hand-edited summary figure,
+and a row removed from a table.
+
 ## What's New in v2.72.0
 
 Resolve 21's AI methods report a missing Extras pack as an error *string*, not

package/README.md

@@ -1,11 +1,11 @@
 # DaVinci Resolve MCP Server
 
-[![Version](https://img.shields.io/badge/version-2.72.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.72.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-34%20(341%20full)-blue.svg)](#server-modes)
 [![Advanced](https://img.shields.io/badge/Advanced%20(offline)-18%20tools-blueviolet.svg)](#server-modes)
-[![Tested](https://img.shields.io/badge/Live%20Tested-98.5%25-green.svg)](docs/reference/api-coverage.md#test-results)
+[![Tested](https://img.shields.io/badge/Live%20Tested-96.8%25-green.svg)](docs/reference/api-coverage.md#test-results)
 [![DaVinci Resolve](https://img.shields.io/badge/DaVinci%20Resolve-18.5+-darkred.svg)](https://www.blackmagicdesign.com/products/davinciresolve)
 [![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)
@@ -252,9 +252,9 @@ The default server is a local stdio process launched by your MCP client; it does
 | MCP Tools | **34** compound / **341** granular (live server) |
 | Advanced (offline) tools | **18** — .drp/.drt/.drx + DB authoring, no Resolve running |
 | Kernel Actions | **136** guarded workflow actions across 9 compound tools |
-| API Methods Covered | **337/337** (100%) |
-| Methods Live Tested | **332/337** (98.5%) |
-| Live Test Pass Rate | **332/332** (100%) |
+| API Methods Covered | **349/349** (100%) |
+| Methods Live Tested | **338/349** (96.8%) |
+| Live Test Pass Rate | **338/338** (100%) |
 | Tested Against | DaVinci Resolve 19.1.3 Studio + Resolve 20.3.2 Studio + Resolve 21.0.2 Studio |
 
 For method-by-method status, see [API Coverage and Test Results](docs/reference/api-coverage.md). For current workflow support, see [Kernel Action Coverage](docs/kernels/README.md).

package/docs/reference/api-coverage.md

@@ -8,12 +8,12 @@ Complete Resolve scripting API coverage, live-test status, and method-by-method
 |--------|-------|
 | MCP Tools | **34** compound (default) / **341** granular |
 | Kernel Actions | **136** guarded MCP workflow actions across 9 compound tools |
-| API Methods Covered | **337/337** (100%) |
-| Methods Live Tested | **332/337** (98.5%) |
-| Live Test Pass Rate | **332/332** (100%) |
+| API Methods Covered | **349/349** (100%) |
+| Methods Live Tested | **338/349** (96.8%) |
+| Live Test Pass Rate | **338/338** (100%) |
 | API Object Classes | 13 |
 | Tested Against | DaVinci Resolve 19.1.3 Studio + Resolve 20.3.2 Studio + Resolve 21.0.2 Studio |
-| Compatibility Note | Resolve 19.1.3 remains the compatibility baseline; Resolve 20.x scripting calls are additive, version-guarded, and live-tested on 20.3.2; Resolve 21.0 additions are version-guarded and live-tested on 21.0.2 (see the Resolve 21 delta row below — three of them need AI Extras packs and stay untested without one) |
+| Compatibility Note | Resolve 19.1.3 remains the compatibility baseline; Resolve 20.x scripting calls are additive, version-guarded, and live-tested on 20.3.2; Resolve 21.0 additions are version-guarded and live-tested on 21.0.2 (see the Resolve 21 delta row below — five wrappers need AI Extras packs and stay untested without one, and one is deliberately not executed) |
 
 ## API Coverage
 
@@ -81,7 +81,24 @@ guard, so it never goes stale.
 
 ## Test Results
 
-Baseline testing was performed against **DaVinci Resolve 19.1.3 Studio** on macOS with live API calls (no mocks). Resolve 20 additions were revalidated live against **DaVinci Resolve 20.3.2 Studio**.
+Baseline testing was performed against **DaVinci Resolve 19.1.3 Studio** on macOS with live API calls (no mocks). Resolve 20 additions were revalidated live against **DaVinci Resolve 20.3.2 Studio**, Resolve 21 additions against **Studio 21.0.2.4**.
+
+**Counting convention.** Every figure on this page is derived from the rows of
+the [Complete API Reference](#complete-api-reference) tables — that table is the
+source, these summaries are downstream of it:
+
+- **API Methods Covered** = the number of rows. One row per method per object
+  class, so `PerformAudioClassification` on both `Folder` and `MediaPoolItem`
+  counts twice, because they are two wrappers that can fail independently.
+- **Methods Live Tested** = rows marked ✅ or ⚠️ — the call was made against a
+  live Resolve and the result observed.
+- **Untested** = rows marked ☁️ or 🔬. A method that could not be executed is
+  never counted as a pass: a missing Extras pack tells you nothing about the
+  wrapper, so counting it as tested would overstate coverage in exactly the
+  place the risk is highest.
+- **The phase table below counts methods, not test cases**, which is why its
+  Total equals Methods Live Tested rather than the number of assertions run.
+
 
 | Phase | Tests | Pass Rate | Scope |
 |-------|-------|-----------|-------|
@@ -91,8 +108,8 @@ Baseline testing was performed against **DaVinci Resolve 19.1.3 Studio** on macO
 | Phase 4 | 10/10 | 100% | AI/ML methods, Fusion clips, stereo, gallery stills |
 | Phase 5 | 6/6 | 100% | Scene cuts, subtitles from audio, graph node cache/tools/enable |
 | Resolve 20 delta | 12/12 | 100% | Resolve 20.0-20.2.2 scripting additions live-tested on 20.3.2 |
-| Resolve 21 delta | 8/9 | 89% | Resolve 21.0 scripting additions live-tested on Studio 21.0.2.4 (`tests/live_resolve21_validation.py`) |
-| **Total** | **339/340** | **99.7%** | **98.5% of current API methods tested live** |
+| Resolve 21 delta | 7/7 | 100% | Resolve 21.0 additions that could be executed, live-tested on Studio 21.0.2.4 (`tests/live_resolve21_validation.py`). The other 6 need an AI Extras pack or are unsafe to run — counted as untested, not as passes |
+| **Total** | **338/338** | **100%** | **96.8% of the 349 covered methods tested live** |
 
 #### Resolve 21 delta detail
 
@@ -113,7 +130,10 @@ marked 🔬 rather than ⚠️.
 | `Project.GenerateSpeech` | 🔬 | Requires AI Speech Generator; returned an error **string**, not a MediaPoolItem |
 | `Resolve.DisableBackgroundTasksForCurrentResolveSession` | 🔬 | Present in `dir()`; **not executed** — session-wide, returns None, and has no `Enable...` counterpart, so there is no undo short of restarting Resolve |
 
-### Untested Methods (5 of 336)
+### Untested Methods (11 of 349)
+
+Every ☁️ and 🔬 row from the reference tables, listed here so the count is
+checkable rather than asserted.
 
 | Method | Reason | Help Wanted |
 |--------|--------|-------------|
@@ -122,6 +142,18 @@ marked 🔬 rather than ⚠️.
 | `PM.ImportCloudProject` | Requires DaVinci Resolve cloud infrastructure | Yes |
 | `PM.RestoreCloudProject` | Requires DaVinci Resolve cloud infrastructure | Yes |
 | `TL.AnalyzeDolbyVision` | Requires HDR/Dolby Vision content | Yes |
+| `Folder.AnalyzeForIntellisearch` | Requires the AI IntelliSearch Extra | Yes |
+| `MPI.AnalyzeForIntellisearch` | Requires the AI IntelliSearch Extra | Yes |
+| `Folder.AnalyzeForSlate` | Requires the AI Slate ID Extra | Yes |
+| `MPI.AnalyzeForSlate` | Requires the AI Slate ID Extra | Yes |
+| `Project.GenerateSpeech` | Requires the AI Speech Generator Extra | Yes |
+| `Resolve.DisableBackgroundTasksForCurrentResolveSession` | Deliberately not executed: session-wide, returns `None`, and has no `Enable...` counterpart, so there is no undo short of restarting Resolve | No |
+
+The five AI Extras rows are untested for want of a downloadable pack, not because
+the wrappers are suspect — a report from anyone who has the packs installed would
+close them. The last one is a decision rather than a gap: it is reachable, and
+running it during a validation sweep would disable background tasks for every
+project open in that Resolve instance.
 
 ---
 
@@ -161,6 +193,7 @@ Every method in the DaVinci Resolve Scripting API and its test status. Methods a
 | 20 | `GetKeyframeMode()` | ✅ | Returns keyframe mode |
 | 21 | `SetKeyframeMode(keyframeMode)` | ⚠️ | API accepts; mode must match valid enum |
 | 22 | `GetFairlightPresets()` | ✅ | Resolve 20.3.2 live test returns preset map |
+| 23 | `DisableBackgroundTasksForCurrentResolveSession()` | 🔬 | Resolve 21.0. Present in `dir()`; **not executed** — session-wide, returns `None`, no `Enable...` counterpart, so no undo short of restarting Resolve |
 
 ### ProjectManager
 
@@ -239,6 +272,8 @@ Every method in the DaVinci Resolve Scripting API and its test status. Methods a
 | 41 | `AddColorGroup(groupName)` | ✅ | Returns ColorGroup object |
 | 42 | `DeleteColorGroup(colorGroup)` | ✅ | Deletes color group |
 | 43 | `ApplyFairlightPresetToCurrentTimeline(presetName)` | ⚠️ | Resolve 20.3.2 live test accepts call; returns `False` without a named preset |
+| 44 | `GenerateSpeech({speechGenerationSettings}, timecode)` | 🔬 | Resolve 21.0. Requires the AI Speech Generator Extra; without it returns an error **string**, not a MediaPoolItem |
+| 45 | `ResetIntellisearchAnalysis()` | ✅ | Resolve 21.0.2 live test returns `True` |
 
 ### MediaStorage
 
@@ -294,8 +329,13 @@ Every method in the DaVinci Resolve Scripting API and its test status. Methods a
 | 4 | `GetIsFolderStale()` | ✅ | Returns `False` |
 | 5 | `GetUniqueId()` | ✅ | Returns UUID string |
 | 6 | `Export(filePath)` | ✅ | Exports DRB file |
-| 7 | `TranscribeAudio()` | ✅ | Starts audio transcription |
+| 7 | `TranscribeAudio({useSpeakerDetection})` | ✅ | Starts audio transcription. Resolve 21.0 added the optional `useSpeakerDetection` argument: it is accepted, but `True` and `False` produced identical transcripts on a deliberately two-voice clip (21.0.2.4) — the method passes, the parameter has no observable effect |
 | 8 | `ClearTranscription()` | ✅ | Clears transcription |
+| 9 | `PerformAudioClassification()` | ✅ | Resolve 21.0.2 live test returns `True`; `Category` clip property goes `""` → `Dialogue` |
+| 10 | `ClearAudioClassification()` | ✅ | Resolve 21.0.2 live test returns `True`; `Category` resets to `Uncategorized`, not `""` |
+| 11 | `AnalyzeForIntellisearch(identifyFaces, isBetterMode)` | 🔬 | Resolve 21.0. Requires the AI IntelliSearch Extra; without it returns an error **string**, not `False` |
+| 12 | `AnalyzeForSlate(markerColor)` | 🔬 | Resolve 21.0. Requires the AI Slate ID Extra. Documented `resolve.MARKER_*` constants do not exist on the handle |
+| 13 | `RemoveMotionBlur({deblurOption})` | ✅ | Resolve 21.0.2 live test returns original→new pairs; source media unchanged. Requires the AI Motion Deblur Extra |
 
 ### MediaPoolItem
 
@@ -327,7 +367,7 @@ Every method in the DaVinci Resolve Scripting API and its test status. Methods a
 | 24 | `UnlinkProxyMedia()` | ✅ | Unlinks proxy media |
 | 25 | `ReplaceClip(filePath)` | ✅ | Replaces clip source |
 | 26 | `GetUniqueId()` | ✅ | Returns UUID string |
-| 27 | `TranscribeAudio()` | ✅ | Starts audio transcription |
+| 27 | `TranscribeAudio({useSpeakerDetection})` | ✅ | Starts audio transcription. Resolve 21.0 added the optional `useSpeakerDetection` argument: it is accepted, but `True` and `False` produced identical transcripts on a deliberately two-voice clip (21.0.2.4) — the method passes, the parameter has no observable effect |
 | 28 | `ClearTranscription()` | ✅ | Clears transcription |
 | 29 | `GetAudioMapping()` | ✅ | Returns JSON audio mapping |
 | 30 | `GetMarkInOut()` | ✅ | Returns mark in/out dict |
@@ -337,6 +377,11 @@ Every method in the DaVinci Resolve Scripting API and its test status. Methods a
 | 34 | `LinkFullResolutionMedia(filePath)` | ⚠️ | Resolve 20.3.2 live test accepts call; full-res relink returns `False` without a matching proxy/full-res fixture |
 | 35 | `ReplaceClipPreserveSubClip(filePath)` | ✅ | Resolve 20.3.2 live test replaces clip while preserving subclip metadata |
 | 36 | `MonitorGrowingFile()` | ✅ | Resolve 20.3.2 live test enables growing-file monitoring |
+| 37 | `PerformAudioClassification()` | ✅ | Resolve 21.0.2 live test returns `True`; `Category` clip property goes `""` → `Dialogue` |
+| 38 | `ClearAudioClassification()` | ✅ | Resolve 21.0.2 live test returns `True`; `Category` resets to `Uncategorized`, not `""` |
+| 39 | `AnalyzeForIntellisearch(identifyFaces, isBetterMode)` | 🔬 | Resolve 21.0. Requires the AI IntelliSearch Extra; without it returns an error **string**, not `False` |
+| 40 | `AnalyzeForSlate(markerColor)` | 🔬 | Resolve 21.0. Requires the AI Slate ID Extra. Documented `resolve.MARKER_*` constants do not exist on the handle |
+| 41 | `RemoveMotionBlur({deblurOption})` | ✅ | Resolve 21.0.2 live test returns the new MediaPoolItem; source media path unchanged. Requires the AI Motion Deblur Extra |
 
 ### Timeline
 

package/install.py

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

package/src/granular/common.py

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