davinci-resolve-mcp 2.146.0 → 2.148.0

package/CHANGELOG.md

@@ -2,6 +2,35 @@
 
 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.148.0 — the audio ceiling doubles: A1–A16
+
+### Changed
+
+- **Offline audio placement now reaches A16** (was A8). The r19 media
+  template was re-captured live with 16 mono audio tracks — valid Fairlight
+  strips included, because a cloned track without a strip renders silent
+  (the measured strip law). A9 and A16 placements render-verified on
+  Studio 19.1.3.7 at the same -24.1 dB mono-strip level as A1, with the
+  gaps digitally silent at the sample level. `drt.assemble` cuts refuse
+  at A17 with the re-capture guidance.
+
+## What's New in v2.147.0 — the round-trip QC loop learns markers
+
+### Added
+
+- **`editorial.verify_roundtrip` is marker-aware**: timeline markers compare
+  through the loop (min-anchored frames within tolerance, names when both
+  sides carry them). A re-export with NO markers while the turnover has them
+  raises the `markersNotInExport` honesty flag without failing the pass — a
+  missing exporter capability is not a conform drift.
+
+### Measured (new Resolve bug, filed in api-limitations)
+
+- **`EXPORT_OTIO` drops timeline markers wholesale**: two markers readable
+  through the marker API, zero in the exported .otio — while Resolve's own
+  OTIO *importer* reads Marker objects fine. Marker-fidelity checks must go
+  through the marker API, never an OTIO re-export.
+
 ## What's New in v2.146.0 — bins, and the folder registry law
 
 ### Added

package/README.md

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

package/docs/guides/native-drt-authoring.md

@@ -49,7 +49,7 @@ window. `render.verify_output` covers the container-level checks.
 | Constant retimes, reverse | `cuts[].reverse` | v2.114 |
 | Freeze frames | `cuts[].freeze` (holds source frame `srcIn`) | v2.134 |
 | Speed ramps | `cuts[].ramp: [{durationFrames, speed}, …]` (linear segments only) | v2.139 |
-| Audio placements, A1–A8 | `cuts[].audioOnly + track` | v2.115 |
+| Audio placements, A1–A16 | `cuts[].audioOnly + track` | v2.115 (A1–A8) · v2.148 (A9–A16) |
 | Built-in generators | `elements: [{type:'generator', generatorName}]` | v2.110 |
 | Custom start timecode | `spec.startFrame` / `preserveStartTimecode` | v2.117 |
 | Timeline markers | `spec.markers` (16 colors, notes, durations, customData) | v2.118 |

package/docs/reference/api-limitations.md

@@ -12,7 +12,7 @@ that none exists).
 
 **Verified on:** DaVinci Resolve Studio 21.0.2
 
-**Totals:** 35 missing capabilities, 47 bugs / unreliable behaviors.
+**Totals:** 35 missing capabilities, 48 bugs / unreliable behaviors.
 
 The authoritative source is the runtime-queryable `api_truth` ledger
 (`resolve_control api_truth "<query>"`); this document is generated from
@@ -679,3 +679,11 @@ values, or automation-hostile modal prompts.
 - **Behavior:** Item-level markers (clip locators) are not serialized into the exported .drt at all. They live in the project database as Sm2TiItemLockableBlob rows (same wire codec as timeline markers, BlobOwner = the item's DbId — located by byte search in a live Project.db), and readback via TimelineItem.GetMarkers is fine, but the export omits the blobs even after SaveProject — measured on Studio 19.1.3.7. Asymmetrically, ImportTimelineFromFile ACCEPTS an authored Sm2TiItemLockableBlob and the markers read back perfectly.
 - **Workaround / current handling:** Do not rely on .drt archives to carry clip markers. To deliver item markers in a .drt, author them offline (drt.assemble cuts[].markers writes the accepted blob); to preserve markers from a live timeline, read them via the marker API and re-author.
 - **Tags:** timeline, export, drt, markers, silent-failure
+
+### Timeline.Export EXPORT_OTIO (drops timeline markers)
+
+- **Object:** `Timeline`
+- **Signature:** `(filePath, EXPORT_OTIO) -> bool`
+- **Behavior:** Timeline markers present and readable through the marker API do not appear in the exported .otio at all — the OTIO Marker schema exists and Resolve's importer reads it, but the exporter writes none (measured on Studio 19.1.3.7: two markers read back at frames 12/72; the export carried zero). Any marker-fidelity QC built on an OTIO re-export silently sees an unmarked timeline.
+- **Workaround / current handling:** Do not use EXPORT_OTIO to carry or verify markers. editorial.verify_roundtrip reports this case as `markersNotInExport` (honesty flag, not a failure); read markers through the marker API for fidelity checks, and author them offline via drt.assemble spec.markers when a .drt must carry them.
+- **Tags:** timeline, export, otio, markers, silent-failure

package/install.py

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

package/resolve-advanced/server/author-interchange.mjs

@@ -746,5 +746,36 @@ export function verifyRoundtrip(inputEvents, exportedEvents, opts = {}) {
       mismatches.push({ kind: 'source-frames', at: i, source: x.source, expectedOffset: srcOffsets[x.source], gotOffset: off });
     }
   }
-  return { pass: mismatches.length === 0, pairs: n, srcOffsets, mismatches };
+  // MARKERS (E88): compare track-'MARKER' pseudo-events, min-anchored to
+  // each side's own VIDEO record origin like everything else. When the
+  // re-export carries NO markers at all while the input has them, that is
+  // reported as markersNotInExport rather than failed — several export
+  // formats drop markers wholesale, and a missing capability is not a
+  // conform drift. When both sides carry markers, they compare strictly.
+  const mks = (evts, anchor) => evts
+    .filter((e) => String(e.track) === 'MARKER' && e.recIn != null)
+    .map((e) => ({ frame: e.recIn - anchor, name: e.name || '' }))
+    .sort((x, y) => x.frame - y.frame);
+  const anchorOf = (evts) => {
+    const v = vids(evts);
+    return v.length ? Math.min(...v.map((e) => e.recIn)) : 0;
+  };
+  const am = mks(inputEvents, anchorOf(inputEvents));
+  const bm = mks(exportedEvents, anchorOf(exportedEvents));
+  const markers = { input: am.length, exported: bm.length, mismatches: [] };
+  let markersNotInExport = false;
+  if (am.length && !bm.length) {
+    markersNotInExport = true;
+  } else {
+    if (am.length !== bm.length) markers.mismatches.push({ kind: 'marker-count', input: am.length, exported: bm.length });
+    for (let i = 0; i < Math.min(am.length, bm.length); i += 1) {
+      if (Math.abs(am[i].frame - bm[i].frame) > recTol) {
+        markers.mismatches.push({ kind: 'marker-frame', at: i, input: am[i].frame, exported: bm[i].frame });
+      } else if (am[i].name && bm[i].name && am[i].name !== bm[i].name) {
+        markers.mismatches.push({ kind: 'marker-name', at: i, input: am[i].name, exported: bm[i].name });
+      }
+    }
+    mismatches.push(...markers.mismatches);
+  }
+  return { pass: mismatches.length === 0, pairs: n, srcOffsets, mismatches, markers, ...(markersNotInExport ? { markersNotInExport } : {}) };
 }

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

@@ -51,7 +51,7 @@ const assembleSchema = z.object({
   spec: z
     .object({})
     .passthrough()
-    .describe("assembleTimeline spec: { timelineName?, startFrame? (timeline start frame @24, default 86400=01:00:00:00 — sets the start TIMECODE, render-verified on 19), media?: {mediaFilePath, spec:{width,height,frameCount,fps}, cuts:[{startFrame,durationFrames,srcIn?,track? (1-based video track; >1 = video-only, render-verified stacking),speed?/reverse? (constant retime, e.g. 0.5, forward or backwards; video-only; readback+render-verified on 19),freeze? (true = hold source frame srcIn for the whole cut; video-only; render-proven frozen on 19 via freezedetect),ramp? ([{durationFrames,speed},...] >=2 LINEAR segments from the cut head, srcIn honored; video-only; render-proven cadence on 19 — eased/curved ramps are NOT authorable, an interp!=0 keyframe crashes Resolve on import (measured)),audioOnly?+track? (explicit AUDIO placement on audio track 1-8; presence suppresses the A1 mirror; render-verified on 19),markers? (ITEM markers/clip locators: [{frame ITEM-relative, color?, name?, note?, duration?, customData?}] — readback-verified on 19; NOTE Resolve's own EXPORT_DRT drops item markers, this authoring path is the only .drt carrier)}]} | [same, ...] (multi-source needs media_pool.capture_media_template run once per file), transitions?: [{track, atFrame, durationFrames?, trackType? ('video' | 'audio' cross-fade), type? ('dissolve' default | 'wipe' | 'dip' | 'additive' | 'smooth-cut' | 'non-additive' — all render-verified on 19 w/ midpoint fingerprints; XMEML/EDL transition codes route automatically, and NOTE Resolve's own XMEML importer writes transitions that render INERT, so this route beats it)}], markers?: [{frame (timeline-absolute), color? (16 names), name?, note?, duration?, customData?}] (readback-verified on 19), compounds?: [{name, startFrame (parent, absolute), durationFrames, track?, cuts:[{mediaFilePath, startFrame (INNER, 0-based), durationFrames, srcIn?}], compounds?: [same, nested — frames inner-relative]}] (multiple PARALLEL compounds compose AND compounds NEST recursively — depth-2 through depth-4 playback render-verified on 19 (the old depth-2 black was a missing SequenceSetup key, fixed); inner cuts need captured templates w/ native clips), subtitles?: [{startFrame (timeline-absolute), durationFrames, text}] + subtitlesSrt? (raw SRT, cues anchor at the origin; readback-verified on 19; angle-bracket runs read as SRT markup), elements?: [{type:'title'|'generator', track, startFrame, durationFrames?, text?, generatorName? ('Solid Color'|'SMPTE Color Bar'|'Grey Scale' render-verified on 19), ...}] }. startFrame is timeline-absolute (origin 86400)."),
+    .describe("assembleTimeline spec: { timelineName?, startFrame? (timeline start frame @24, default 86400=01:00:00:00 — sets the start TIMECODE, render-verified on 19), media?: {mediaFilePath, spec:{width,height,frameCount,fps}, cuts:[{startFrame,durationFrames,srcIn?,track? (1-based video track; >1 = video-only, render-verified stacking),speed?/reverse? (constant retime, e.g. 0.5, forward or backwards; video-only; readback+render-verified on 19),freeze? (true = hold source frame srcIn for the whole cut; video-only; render-proven frozen on 19 via freezedetect),ramp? ([{durationFrames,speed},...] >=2 LINEAR segments from the cut head, srcIn honored; video-only; render-proven cadence on 19 — eased/curved ramps are NOT authorable, an interp!=0 keyframe crashes Resolve on import (measured)),audioOnly?+track? (explicit AUDIO placement on audio track 1-16; presence suppresses the A1 mirror; A1-A8 and the raised A9-A16 ceiling render-verified on 19),markers? (ITEM markers/clip locators: [{frame ITEM-relative, color?, name?, note?, duration?, customData?}] — readback-verified on 19; NOTE Resolve's own EXPORT_DRT drops item markers, this authoring path is the only .drt carrier)}]} | [same, ...] (multi-source needs media_pool.capture_media_template run once per file), transitions?: [{track, atFrame, durationFrames?, trackType? ('video' | 'audio' cross-fade), type? ('dissolve' default | 'wipe' | 'dip' | 'additive' | 'smooth-cut' | 'non-additive' — all render-verified on 19 w/ midpoint fingerprints; XMEML/EDL transition codes route automatically, and NOTE Resolve's own XMEML importer writes transitions that render INERT, so this route beats it)}], markers?: [{frame (timeline-absolute), color? (16 names), name?, note?, duration?, customData?}] (readback-verified on 19), compounds?: [{name, startFrame (parent, absolute), durationFrames, track?, cuts:[{mediaFilePath, startFrame (INNER, 0-based), durationFrames, srcIn?}], compounds?: [same, nested — frames inner-relative]}] (multiple PARALLEL compounds compose AND compounds NEST recursively — depth-2 through depth-4 playback render-verified on 19 (the old depth-2 black was a missing SequenceSetup key, fixed); inner cuts need captured templates w/ native clips), subtitles?: [{startFrame (timeline-absolute), durationFrames, text}] + subtitlesSrt? (raw SRT, cues anchor at the origin; readback-verified on 19; angle-bracket runs read as SRT markup), elements?: [{type:'title'|'generator', track, startFrame, durationFrames?, text?, generatorName? ('Solid Color'|'SMPTE Color Bar'|'Grey Scale' render-verified on 19), ...}] }. startFrame is timeline-absolute (origin 86400)."),
   outputPath: z.string().describe('Absolute path where the importable .drt will be written'),
   targetAppVersion: z
     .union([z.string(), z.number()])

package/resolve-advanced/vendor/drp-format/cut-media.js

@@ -164,8 +164,10 @@ async function cutSourceIntoClips(drpInput, opts = {}) {
           // Fairlight model (FLStudioModelBA inside the pool's
           // Sm2Sequence.FieldsBlob) holds one strip per track, and a cloned
           // track without a strip imports fine, reads back fine, and renders
-          // SILENT (measured). The r19 media template is captured with 8
-          // audio tracks (valid strips included); beyond that, refuse.
+          // SILENT (measured). The r19 media template is captured with 16
+          // audio tracks (valid strips included; A9/A16 render-verified at
+          // the same -24.1 dB as A1's mono-strip law, E89 2026-09-01);
+          // beyond that, refuse.
           throw new Error(
             `cutSourceIntoClips: audio track ${maxA} exceeds the template's ${tracks.length} ` +
             'audio tracks — audio tracks cannot be grown offline (no Fairlight strip = silent). ' +

package/src/granular/common.py

@@ -87,7 +87,7 @@ if not logging.getLogger().handlers:
         handlers=[logging.StreamHandler()],
     )
 
-VERSION = "2.146.0"
+VERSION = "2.148.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 353-tool granular server instead
 """
 
-VERSION = "2.146.0"
+VERSION = "2.148.0"
 
 import base64
 import os

package/src/utils/api_truth.py

@@ -2716,6 +2716,27 @@ API_TRUTH: List[Dict[str, Any]] = [
         "submit": "bug",
         "mitigation": ["drt.assemble cuts[].markers"],
     },
+    {
+        "symbol": "Timeline.Export EXPORT_OTIO (drops timeline markers)",
+        "object": "Timeline",
+        "signature": "(filePath, EXPORT_OTIO) -> bool",
+        "reality": "Timeline markers present and readable through the marker "
+                   "API do not appear in the exported .otio at all — the OTIO "
+                   "Marker schema exists and Resolve's importer reads it, but "
+                   "the exporter writes none (measured on Studio 19.1.3.7: two "
+                   "markers read back at frames 12/72; the export carried "
+                   "zero). Any marker-fidelity QC built on an OTIO re-export "
+                   "silently sees an unmarked timeline.",
+        "recommended": "Do not use EXPORT_OTIO to carry or verify markers. "
+                       "editorial.verify_roundtrip reports this case as "
+                       "`markersNotInExport` (honesty flag, not a failure); "
+                       "read markers through the marker API for fidelity "
+                       "checks, and author them offline via drt.assemble "
+                       "spec.markers when a .drt must carry them.",
+        "tags": ["timeline", "export", "otio", "markers", "silent-failure"],
+        "submit": "bug",
+        "mitigation": ["editorial.verify_roundtrip markersNotInExport"],
+    },
 ]