davinci-resolve-mcp 2.186.0 → 2.187.0

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 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.187.0 — E134: real Premiere transitions attach, with their real type
+
+### Fixed
+
+- **Real Premiere transitions were invisible.** A Premiere 2025 track keeps
+  its transitions in a separate `TransitionItems` list, not among
+  `ClipItems` (measured on the reel: two video `Cross Dissolve (Legacy)`
+  items and one audio `Constant Power` fade-in, none of which reached the
+  parser). Each carries its span under `TransitionTrackItem.TrackItem`, an
+  `Alignment`, `HasIncomingClip` / `HasOutgoingClip` (false = a fade from or
+  to black or silence) and a `DisplayName`. The walk now reads
+  `TransitionItems` alongside `ClipItems`; transitions attach to the
+  incoming clip whose record-in falls inside the span and carry the real
+  `DisplayName` as their type, so the bridge routes dissolves and audio
+  cross-fades by name; a transition with no outgoing clip synthesizes the
+  black/silence leg as before. The synthetic real-shape fixture pins a
+  `TransitionItems` dissolve attaching at its explicit span.
+
+### Measured (filed in api-limitations)
+
+- The Premiere 2025 transition item shape and its fade flags.
+
 ## What's New in v2.186.0 — E133: Premiere nested sequences flatten into the reel
 
 ### Fixed

package/README.md

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

package/docs/reference/api-limitations.md

@@ -322,7 +322,7 @@ equivalent, blocking full automation.
 - **Object:** `editorial.parse_interchange / list_sequences (prproj)`
 - **Signature:** `(path.prproj) -> sequences/events`
 - **Behavior:** Measured on a real 130 MB colour turnover (E132): objects are defined in TWO id spaces — numeric ObjectID referenced by ObjectRef, and uuid ObjectUID referenced by ObjectURef — and Sequence, ClipProjectItem, MasterClip, Media, VideoClipTrack and AudioClipTrack are all UID-defined. A Sequence lists its tracks through <TrackGroups><TrackGroup><Second ObjectRef> → VideoTrackGroup / AudioTrackGroup (a third DataTrackGroup is empty) → <TrackGroup><Tracks><Track ObjectURef> → Video/AudioClipTrack → <ClipTrack><ClipItems><TrackItems><TrackItem ObjectRef>. An item's record span sits under <ClipTrackItem><TrackItem> (Start/End ticks) and its source under ClipTrackItem.SubClip → SubClip.Clip → VideoClip.Clip (InPoint/OutPoint, Source) → VideoMediaSource.MediaSource.Media (ObjectURef) → Media (FilePath / ActualMediaFilePath); SubClip.Name and MasterClip.Name are the fallbacks. A ZERO is written as ABSENCE (the counting leader at record 0 has End and no Start). Names are direct <Name> children. Legacy/synthetic files instead use ObjectID/ObjectRef throughout, <VideoTracks>/<AudioTracks> track lists, Start/End/InPoint/OutPoint on the item and Node/Properties names.
-- **Workaround / current handling:** Index both id spaces and follow both reference attributes; walk TrackGroups when present; read timing through the *TrackItem child; treat a missing Start/InPoint beside a present End/OutPoint as 0. With that, the turnover lists all 739 sequences and its reel walks 335 events (it listed ZERO before). A NESTED SEQUENCE used as a clip has Clip.Source → VideoSequenceSource / AudioSequenceSource → SequenceSource.Sequence ObjectURef → the nested Sequence (E133: 3607 such items in the reels project); parse_interchange flattens them through the clip's InPoint window with fromCompound.
+- **Workaround / current handling:** Index both id spaces and follow both reference attributes; walk TrackGroups when present; read timing through the *TrackItem child; treat a missing Start/InPoint beside a present End/OutPoint as 0. With that, the turnover lists all 739 sequences and its reel walks 335 events (it listed ZERO before). A NESTED SEQUENCE used as a clip has Clip.Source → VideoSequenceSource / AudioSequenceSource → SequenceSource.Sequence ObjectURef → the nested Sequence (E133: 3607 such items in the reels project); parse_interchange flattens them through the clip's InPoint window with fromCompound. TRANSITIONS sit in a SEPARATE track list, ClipTrack.TransitionItems.TrackItems (E134): a Video/AudioTransitionTrackItem carries TransitionTrackItem.TrackItem{Start,End} (the span), DisplayName / MatchName (the effect), Alignment (ticks) and HasIncomingClip / HasOutgoingClip — false marks a fade from/to black or silence.
 - **Tags:** prproj, premiere, interchange, silent-failure
 
 ### ProjectManager.CreateProject (discards an unsaved current project)

package/install.py

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

package/resolve-advanced/server/prproj.mjs

@@ -264,7 +264,15 @@ function walkSequence(seqEntry, byId, depth = 0, seen = new Set()) {
     for (const tref of trackRefs) {
       const tEntry = byId.get(refId(tref));
       if (!tEntry) continue;
-      const itemRefs = asArray(tEntry.node.TrackItems?.TrackItem).concat(asArray(tEntry.node.ClipTrack?.ClipItems?.TrackItems?.TrackItem), asArray(tEntry.node.ClipItems?.TrackItems?.TrackItem));
+      // Real Premiere 2025 keeps a track's TRANSITIONS in a separate list,
+      // ClipTrack.TransitionItems (E134, measured: 2 video + 1 audio on the
+      // reel — none reached the parser from ClipItems alone).
+      const itemRefs = asArray(tEntry.node.TrackItems?.TrackItem).concat(
+        asArray(tEntry.node.ClipTrack?.ClipItems?.TrackItems?.TrackItem),
+        asArray(tEntry.node.ClipItems?.TrackItems?.TrackItem),
+        asArray(tEntry.node.ClipTrack?.TransitionItems?.TrackItems?.TrackItem),
+        asArray(tEntry.node.TransitionItems?.TrackItems?.TrackItem),
+      );
       const transitions = [];
       const clipEvents = [];
       for (const iref of itemRefs) {
@@ -301,7 +309,13 @@ function walkSequence(seqEntry, byId, depth = 0, seen = new Set()) {
         } else if (/Transition/.test(cEntry.tag)) {
           const ti = itemTiming(cEntry.node);
           const dur = ticksToFrames(Number(ti.end) - Number(ti.start), fps);
-          transitions.push({ recIn: ticksToFrames(ti.start, fps), duration: dur || 0 });
+          // Real shape carries the type and the fade semantics on the item
+          // (E134): DisplayName/MatchName name the effect; HasOutgoingClip
+          // false = a fade-IN from black/silence, HasIncomingClip false = a
+          // fade-OUT — the BL synthesis below keys on the missing neighbour.
+          const tti = asArray(cEntry.node.TransitionTrackItem)[0] || {};
+          const type = childText(tti, 'DisplayName') || childText(tti, 'MatchName') || childText(cEntry.node, 'DisplayName') || null;
+          transitions.push({ recIn: ticksToFrames(ti.start, fps), duration: dur || 0, type });
         }
       }
       // Attach each transition to the INCOMING clip whose record-in falls
@@ -313,7 +327,7 @@ function walkSequence(seqEntry, byId, depth = 0, seen = new Set()) {
       // bridge's black machinery (E91-E96).
       for (const tr of transitions) {
         const end = tr.recIn + tr.duration;
-        const trans = { type: 'dissolve', duration: tr.duration, recStart: tr.recIn };
+        const trans = { type: tr.type || 'dissolve', duration: tr.duration, recStart: tr.recIn };
         const incoming = clipEvents.find((e) => e.recIn > tr.recIn - 1 && e.recIn <= end);
         if (incoming) {
           incoming.transition = trans;

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

@@ -86,7 +86,7 @@ const markerSchema = z.object({
 export const editorialTool = {
   name: 'editorial',
   description:
-    'Editorial integrity (Cluster E) — turnover interchange → normalized events → changelist + conform manifest with TIMING silent-lie guards (flattened retime / dropped J/L-cut audio / framerate-pulldown slip / reverse dropped / transition-handle starvation → flag, skip-not-fake). Report-only (gate: review). Actions: parse_interchange (EDL/OTIO/XMEML natively — incl. Resolve-written OTIO generator clips (a Solid Color is a Clip with a NULL media_reference; it walks as a BL leg with generatorName, and an OTIO GeneratorReference carries its colour) and nested OTIO Stacks (compound clips — Resolve\'s writer nests them with a trim window) FLATTEN into record time with fromCompound on each cut, so Resolve\'s own OTIO exports re-conform (its FCP7 XML writer flattens a compound to ONE media-less clipitem instead — tagged `compound`, which the bridge drops with a reason in unresolvedCompounds unless the sourceMap maps the compound name to a flattened media file), Resolve-written FCP7 -1 junction edges (paired in record order) + Solid Color / Color Matte generators carrying their `fillcolor` (BL legs with `color` → fade-to-white and colour mattes author, E110), XMEML audio-track transitionitems as audio cross-fades on numbered lanes A/A2/…, and CMX FROM/TO CLIP NAME comments over the generic AX reel — + AAF via pyaaf2 (flat sound/picture slots number A/A2/… and V/V2/… in slot order so separate beds keep their lanes; NestedScope layers keep layer numbering; a NESTED SEQUENCE used as a clip — a SourceClip referencing a named CompositionMob — flattens through its reference window with fromCompound, like OTIO Stacks) + PRPROJ via gunzip+XML (real Premiere 2025 files — uuid ObjectUID/ObjectURef graph, TrackGroups, ClipTrackItem→SubClip→VideoClip→MediaSource→Media chain, zeros written as absence — and the legacy ObjectID/VideoTracks shape both walk; measured on a 739-sequence turnover that used to list ZERO; a NESTED SEQUENCE used as a clip — Source = Video/AudioSequenceSource → Sequence — flattens through its in-point window with fromCompound, like OTIO Stacks and AAF nested compositions; 13,711 such events on one real reels project) → normalized events incl. span-explicit transitions, BL fade legs, and freezes as zero-speed events (OTIO FreezeFrame, XMEML timeremap 0, PrProj in==out, AAF 0% motion effects); for AAF/PRPROJ pass the file PATH as content; AAF also returns per-sequence startTimecode/startFrame — build the timeline at THAT start, not the Resolve 01:00:00:00 default — and per-clip `geometry` for Avid transform effects), list_sequences (ONE offline picker entry point across xml/edl/otio/drt/drp/aaf/prproj → [{id,name,eventCount}], plus startTimecode/startFrame for AAF and nestedIn — an AAF composition another composition uses as a clip is NESTED in it; offer the parent, its cuts arrive flattened), convert_to_interchange (author OTIO/EDL/DRT Resolve CAN import from events or a parsed source; the EDL target writes CMX transition pairs incl. BL fades — the .prproj→Resolve conform bridge, no Premiere needed; editorial timing/transitions survive and per-clip effects/color do not. SPEED/REVERSE survive on the otio (LinearTimeWarp) and edl (M2) targets ONLY — this FLAT drt target flattens every retime to 100% forward and returns `flattened`/`flattenedCount` naming each event that lost one (`flattened` is always present on `drt`, empty when there were none); for a .drt that AUTHORS retimes/dissolves/multi-track/audio, use drt.assemble_from_interchange), turnover_changelist (diff old vs new → moved/retimed/trimmed/replaced/new/gone PLUS the junction diff: transition_added/transition_dropped/transition_changed with fade in/out or dissolve, outgoing/incoming, span and duration/type/pre-roll deltas — zero-length CMX carrier lines and the BL legs that carry fades fold into the junction diff instead of reading as gone/new sources; events pair by closest record position, consumed once, so a source cut twice at two speeds compares instance to instance; + timing flags incl. transition_dropped and dropped_split_audio on any A-track; a compound seen collapsed in one cut and flattened in the other reports compound_collapsed/compound_expanded once, never replaced+gone), conform_manifest (per-event assert: source resolved/handles/retime/reverse/TC-base; BL-aware — black legs need no source, fades no black-side handles, and a fade-out tail requirement lands on the picture source; a compound clipitem fails source_resolved by NAME with the remedy — map it to a flattened file or turn over as OTIO), marker_roundtrip (markers with provenance tags), verify_roundtrip (input events vs re-export events -> pass/mismatches + fitted per-source TC offsets + marker compare w/ markersNotInExport honesty flag; FADE-AWARE: BL/Solid-Color legs merge out as blackSegments and fade-window boundary reshapes are excused into fadeReshapedBoundaries instead of failing; RETIME-AWARE: speed/reverse compare pairwise — EXPORT_OTIO carries an authored Sm2TimeMap back as LinearTimeWarp (measured), so a flattened/lost retime fails as drift geometry alone cannot catch; AUDIO-AWARE: declared audio events compare (a video-only export such as EXPORT_EDL flags audioNotInExport instead of failing) (channel legs deduped, mismatches tagged trackType audio) while the mirrored-A1 export of a video-only turnover stays informational; COLOUR-AWARE: an input generator leg carrying a fillcolor (fade-to-white, colour matte) must come back on the same track over its span with the same colour — Resolve\'s FCP7 writer emits it — else generator-colour fails (generatorColours reports the compare) — pass exportedFormat: an OTIO/EDL re-export cannot carry colour (measured) and reports generatorColourNotInExport instead of failing; COMPOUND-AWARE: an XML re-export that collapsed a compound to one clipitem over cuts the input flattened from that compound reports compoundsCollapsedInExport instead of count/source drift; the conform QC loop-closer). Offline (AAF needs pyaaf2; live AAF/DRP import is on the Python davinci-resolve MCP).',
+    'Editorial integrity (Cluster E) — turnover interchange → normalized events → changelist + conform manifest with TIMING silent-lie guards (flattened retime / dropped J/L-cut audio / framerate-pulldown slip / reverse dropped / transition-handle starvation → flag, skip-not-fake). Report-only (gate: review). Actions: parse_interchange (EDL/OTIO/XMEML natively — incl. Resolve-written OTIO generator clips (a Solid Color is a Clip with a NULL media_reference; it walks as a BL leg with generatorName, and an OTIO GeneratorReference carries its colour) and nested OTIO Stacks (compound clips — Resolve\'s writer nests them with a trim window) FLATTEN into record time with fromCompound on each cut, so Resolve\'s own OTIO exports re-conform (its FCP7 XML writer flattens a compound to ONE media-less clipitem instead — tagged `compound`, which the bridge drops with a reason in unresolvedCompounds unless the sourceMap maps the compound name to a flattened media file), Resolve-written FCP7 -1 junction edges (paired in record order) + Solid Color / Color Matte generators carrying their `fillcolor` (BL legs with `color` → fade-to-white and colour mattes author, E110), XMEML audio-track transitionitems as audio cross-fades on numbered lanes A/A2/…, and CMX FROM/TO CLIP NAME comments over the generic AX reel — + AAF via pyaaf2 (flat sound/picture slots number A/A2/… and V/V2/… in slot order so separate beds keep their lanes; NestedScope layers keep layer numbering; a NESTED SEQUENCE used as a clip — a SourceClip referencing a named CompositionMob — flattens through its reference window with fromCompound, like OTIO Stacks) + PRPROJ via gunzip+XML (real Premiere 2025 files — uuid ObjectUID/ObjectURef graph, TrackGroups, ClipTrackItem→SubClip→VideoClip→MediaSource→Media chain, zeros written as absence — and the legacy ObjectID/VideoTracks shape both walk; measured on a 739-sequence turnover that used to list ZERO; a NESTED SEQUENCE used as a clip — Source = Video/AudioSequenceSource → Sequence — flattens through its in-point window with fromCompound, like OTIO Stacks and AAF nested compositions; 13,711 such events on one real reels project; real transitions live in the track\'s TransitionItems list — read alongside ClipItems, attached with their DisplayName as type, HasOutgoingClip/HasIncomingClip false = fade from/to black or silence) → normalized events incl. span-explicit transitions, BL fade legs, and freezes as zero-speed events (OTIO FreezeFrame, XMEML timeremap 0, PrProj in==out, AAF 0% motion effects); for AAF/PRPROJ pass the file PATH as content; AAF also returns per-sequence startTimecode/startFrame — build the timeline at THAT start, not the Resolve 01:00:00:00 default — and per-clip `geometry` for Avid transform effects), list_sequences (ONE offline picker entry point across xml/edl/otio/drt/drp/aaf/prproj → [{id,name,eventCount}], plus startTimecode/startFrame for AAF and nestedIn — an AAF composition another composition uses as a clip is NESTED in it; offer the parent, its cuts arrive flattened), convert_to_interchange (author OTIO/EDL/DRT Resolve CAN import from events or a parsed source; the EDL target writes CMX transition pairs incl. BL fades — the .prproj→Resolve conform bridge, no Premiere needed; editorial timing/transitions survive and per-clip effects/color do not. SPEED/REVERSE survive on the otio (LinearTimeWarp) and edl (M2) targets ONLY — this FLAT drt target flattens every retime to 100% forward and returns `flattened`/`flattenedCount` naming each event that lost one (`flattened` is always present on `drt`, empty when there were none); for a .drt that AUTHORS retimes/dissolves/multi-track/audio, use drt.assemble_from_interchange), turnover_changelist (diff old vs new → moved/retimed/trimmed/replaced/new/gone PLUS the junction diff: transition_added/transition_dropped/transition_changed with fade in/out or dissolve, outgoing/incoming, span and duration/type/pre-roll deltas — zero-length CMX carrier lines and the BL legs that carry fades fold into the junction diff instead of reading as gone/new sources; events pair by closest record position, consumed once, so a source cut twice at two speeds compares instance to instance; + timing flags incl. transition_dropped and dropped_split_audio on any A-track; a compound seen collapsed in one cut and flattened in the other reports compound_collapsed/compound_expanded once, never replaced+gone), conform_manifest (per-event assert: source resolved/handles/retime/reverse/TC-base; BL-aware — black legs need no source, fades no black-side handles, and a fade-out tail requirement lands on the picture source; a compound clipitem fails source_resolved by NAME with the remedy — map it to a flattened file or turn over as OTIO), marker_roundtrip (markers with provenance tags), verify_roundtrip (input events vs re-export events -> pass/mismatches + fitted per-source TC offsets + marker compare w/ markersNotInExport honesty flag; FADE-AWARE: BL/Solid-Color legs merge out as blackSegments and fade-window boundary reshapes are excused into fadeReshapedBoundaries instead of failing; RETIME-AWARE: speed/reverse compare pairwise — EXPORT_OTIO carries an authored Sm2TimeMap back as LinearTimeWarp (measured), so a flattened/lost retime fails as drift geometry alone cannot catch; AUDIO-AWARE: declared audio events compare (a video-only export such as EXPORT_EDL flags audioNotInExport instead of failing) (channel legs deduped, mismatches tagged trackType audio) while the mirrored-A1 export of a video-only turnover stays informational; COLOUR-AWARE: an input generator leg carrying a fillcolor (fade-to-white, colour matte) must come back on the same track over its span with the same colour — Resolve\'s FCP7 writer emits it — else generator-colour fails (generatorColours reports the compare) — pass exportedFormat: an OTIO/EDL re-export cannot carry colour (measured) and reports generatorColourNotInExport instead of failing; COMPOUND-AWARE: an XML re-export that collapsed a compound to one clipitem over cuts the input flattened from that compound reports compoundsCollapsedInExport instead of count/source drift; the conform QC loop-closer). Offline (AAF needs pyaaf2; live AAF/DRP import is on the Python davinci-resolve MCP).',
   async handler({ action, args }) {
     if (action === 'parse_interchange') {
       const p = parseSchema.parse(args);

package/src/granular/common.py

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

package/src/utils/api_truth.py

@@ -2912,7 +2912,14 @@ API_TRUTH: List[Dict[str, Any]] = [
                        "AudioSequenceSource → SequenceSource.Sequence ObjectURef "
                        "→ the nested Sequence (E133: 3607 such items in the "
                        "reels project); parse_interchange flattens them through "
-                       "the clip\'s InPoint window with fromCompound.",
+                       "the clip\'s InPoint window with fromCompound. "
+                       "TRANSITIONS sit in a SEPARATE track list, "
+                       "ClipTrack.TransitionItems.TrackItems (E134): a "
+                       "Video/AudioTransitionTrackItem carries "
+                       "TransitionTrackItem.TrackItem{Start,End} (the span), "
+                       "DisplayName / MatchName (the effect), Alignment (ticks) "
+                       "and HasIncomingClip / HasOutgoingClip — false marks a "
+                       "fade from/to black or silence.",
         "tags": ["prproj", "premiere", "interchange", "silent-failure"],
         "submit": "missing",
         "mitigation": ["editorial.parse_interchange prproj", "editorial.list_sequences"],