davinci-resolve-mcp 2.184.0 → 2.185.0

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.185.0 — E132: real Premiere projects parse — 739 sequences where there were zero
+
+### Fixed
+
+- **A real `.prproj` listed no sequences and walked no events.** Measured on
+  a real 130 MB Premiere 2025 colour turnover (project Version 45): objects
+  live in two id spaces — numeric `ObjectID`/`ObjectRef` and uuid
+  `ObjectUID`/`ObjectURef` — and every sequence, project item, master clip,
+  medium and clip track is uuid-defined; sequences list their tracks through
+  `TrackGroups` → track groups → `Tracks`; an item's record span sits under
+  `ClipTrackItem.TrackItem` and its source behind `SubClip` → `VideoClip`
+  (in/out points, source) → media source → `Media` (path); a zero is written
+  as absence; names are direct `<Name>` children. The parser keyed
+  `ObjectID` only, followed `ObjectRef` only, and knew only the synthetic
+  shape — 0 of 739 sequences listed. Both shapes now walk: the turnover
+  lists all 739 sequences by name and its reel walks 335 events with no
+  unknown source or position (the counting leader lands at frame 0). The
+  real shape is pinned as a synthetic fixture.
+
+### Measured (filed in api-limitations)
+
+- The Premiere 2025 `.prproj` object graph, both id spaces, the track-group
+  chain, the clip source chain, and the omitted-zero law.
+
 ## What's New in v2.184.0 — E131: a nested Stack's audio tracks flatten onto the parent audio lanes
 
 ### Verified

package/README.md

@@ -2,7 +2,7 @@
 
 English | [简体中文](README.zh-CN.md)
 
-[![Version](https://img.shields.io/badge/version-2.184.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.185.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.184.0-blue.svg)](https://github.com/samuelgursky/davinci-resolve-mcp/releases)
+[![Version](https://img.shields.io/badge/version-2.185.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.184.0 版 README。如与英文原版有出入，以 [英文原版](README.md) 为准。
+> 本翻译对应 v2.185.0 版 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:** 39 missing capabilities, 50 bugs / unreliable behaviors.
+**Totals:** 40 missing capabilities, 50 bugs / unreliable behaviors.
 
 The authoritative source is the runtime-queryable `api_truth` ledger
 (`resolve_control api_truth "<query>"`); this document is generated from
@@ -317,6 +317,14 @@ equivalent, blocking full automation.
 - **Workaround / current handling:** Author fade-to-white / colour mattes by placing a Solid Color generator with that blob (drp-format placeGenerator `color`, drt.assemble elements[].color) — or carry an XMEML generatoritem fillcolor through editorial.parse_interchange; the bridge authors the coloured leg.
 - **Tags:** xml, import, generator, colour, export, drt
 
+### Premiere .prproj (2025, project Version 45) object graph — what a real file looks like
+
+- **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).
+- **Tags:** prproj, premiere, interchange, silent-failure
+
 ### ProjectManager.CreateProject (discards an unsaved current project)
 
 - **Object:** `ProjectManager`

package/install.py

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

package/resolve-advanced/server/prproj.mjs

@@ -44,7 +44,13 @@ function childText(node, tag) {
   return v;
 }
 
-const nodeName = (node) => childText(node?.Node?.Properties, 'Name');
+// A real Premiere 2025 object carries its name as a direct <Name> child
+// (E132); the legacy/synthetic shape keeps it under Node/Properties.
+const nodeName = (node) => {
+  const direct = childText(node, 'Name');
+  if (direct != null && String(direct).trim() !== '') return String(direct).trim();
+  return childText(node?.Node?.Properties, 'Name');
+};
 
 /** ticks → whole frames at fps. */
 function ticksToFrames(ticks, fps) {
@@ -69,11 +75,19 @@ function indexObjects(xml) {
   const doc = parser.parse(xml);
   const pd = doc.PremiereData;
   if (!pd) throw new Error('Not a .prproj: missing <PremiereData> root.');
+  // Two id spaces (E132, measured on a real Premiere 2025 turnover): objects
+  // are defined by numeric `ObjectID` (referenced by `ObjectRef`) OR by a
+  // uuid `ObjectUID` (referenced by `ObjectURef`) — sequences, project items,
+  // master clips, media and clip tracks are all UID-defined there, so a map
+  // keyed on ObjectID alone listed ZERO sequences. Key both; the spaces do
+  // not collide (integers vs uuids).
   const byId = new Map();
   for (const [tag, val] of Object.entries(pd)) {
     if (tag.startsWith('@_')) continue;
     for (const node of asArray(val)) {
-      if (node && typeof node === 'object' && node['@_ObjectID'] != null) byId.set(String(node['@_ObjectID']), { tag, node });
+      if (!node || typeof node !== 'object') continue;
+      if (node['@_ObjectID'] != null) byId.set(String(node['@_ObjectID']), { tag, node });
+      if (node['@_ObjectUID'] != null) byId.set(String(node['@_ObjectUID']), { tag, node });
     }
   }
   return { byId, projectVersion: firstProjectVersion(byId) };
@@ -86,9 +100,11 @@ function firstProjectVersion(byId) {
   return null;
 }
 
+/** The id a reference element names: numeric ObjectRef or uuid ObjectURef (E132). */
+const refId = (r) => (r ? String(r['@_ObjectRef'] ?? r['@_ObjectURef'] ?? '') : '');
 const ref = (node, tag) => {
   const r = asArray(node?.[tag])[0];
-  return r ? String(r['@_ObjectRef'] ?? '') : null;
+  return r ? refId(r) : null;
 };
 
 /** Best-effort source label for a clip item: media basename, else project-item name, else UNKNOWN. */
@@ -121,11 +137,65 @@ function findFirstText(node, tags, depth) {
   return null;
 }
 
+/**
+ * Record timing of a track item in either shape: Start/End directly on the
+ * item (synthetic/legacy) or under its <ClipTrackItem>/<TransitionTrackItem>
+ * <TrackItem> child (real Premiere 2025, E132).
+ */
+function itemTiming(node) {
+  // A ZERO is written as ABSENCE (measured E132: the counting leader at
+  // record 0 carries <End> and no <Start>), so a present End with no Start
+  // means Start 0 — never "unknown".
+  const norm = (t) => ({ start: t.start != null ? t.start : (t.end != null ? 0 : null), end: t.end });
+  const direct = { start: childText(node, 'Start'), end: childText(node, 'End') };
+  if (direct.end != null) return norm(direct);
+  for (const k of Object.keys(node || {})) {
+    if (!/TrackItem$/.test(k)) continue;
+    const inner = asArray(node[k])[0];
+    const ti = inner && asArray(inner.TrackItem)[0];
+    if (ti && childText(ti, 'End') != null) return norm({ start: childText(ti, 'Start'), end: childText(ti, 'End') });
+  }
+  return norm(direct);
+}
+
+/**
+ * Source timing + name of a real Premiere clip item: ClipTrackItem.SubClip →
+ * SubClip.Clip → VideoClip/AudioClip (InPoint/OutPoint, Source) →
+ * VideoMediaSource.MediaSource.Media → Media (file path). Null when the item
+ * is the synthetic shape (InPoint/OutPoint on the item itself).
+ */
+function realClipSource(clipNode, byId) {
+  const cti = asArray(clipNode.ClipTrackItem)[0];
+  if (!cti) return null;
+  const sub = byId.get(ref(cti, 'SubClip') || '');
+  if (!sub) return null;
+  const clip = byId.get(ref(sub.node, 'Clip') || '');
+  const inner = clip && (asArray(clip.node.Clip)[0] || clip.node);
+  const outPt = inner ? childText(inner, 'OutPoint') : null;
+  // Same omitted-zero law for the source in-point.
+  const inPt = inner ? (childText(inner, 'InPoint') != null ? childText(inner, 'InPoint') : (outPt != null ? 0 : null)) : null;
+  let name = null;
+  const srcEntry = inner && byId.get(ref(inner, 'Source') || '');
+  const ms = srcEntry && asArray(srcEntry.node.MediaSource)[0];
+  const media = ms && byId.get(ref(ms, 'Media') || '');
+  if (media) {
+    const path = findFirstText(media.node, ['ActualMediaFilePath', 'FilePath', 'RelativePath'], 6);
+    if (path) name = String(path).split(/[\\/]/).pop();
+  }
+  if (!name) {
+    const master = byId.get(ref(sub.node, 'MasterClip') || '');
+    name = (master && nodeName(master.node)) || nodeName(sub.node) || null;
+  }
+  return { inPt, outPt, name };
+}
+
 function clipEvent(clipNode, byId, track, fps, index) {
-  const start = childText(clipNode, 'Start');
-  const end = childText(clipNode, 'End');
-  const inPt = childText(clipNode, 'InPoint');
-  const outPt = childText(clipNode, 'OutPoint');
+  const timing = itemTiming(clipNode);
+  const real = realClipSource(clipNode, byId);
+  const start = timing.start;
+  const end = timing.end;
+  const inPt = real && real.inPt != null ? real.inPt : childText(clipNode, 'InPoint');
+  const outPt = real && real.outPt != null ? real.outPt : childText(clipNode, 'OutPoint');
   const recIn = ticksToFrames(start, fps);
   const recOut = ticksToFrames(end, fps);
   const srcIn = ticksToFrames(inPt, fps);
@@ -142,7 +212,7 @@ function clipEvent(clipNode, byId, track, fps, index) {
   return {
     index,
     track,
-    source: resolveSourceName(clipNode, byId),
+    source: (real && real.name) || resolveSourceName(clipNode, byId),
     srcIn: reverse ? srcOut : srcIn,
     srcOut: reverse ? srcIn : srcOut,
     recIn,
@@ -158,25 +228,39 @@ function walkSequence(seqEntry, byId) {
   const fps = deriveFps(seqEntry.node);
   const events = [];
   let idx = 1;
-  for (const [container, trackKind] of [
-    ['VideoTracks', 'V'],
-    ['AudioTracks', 'A'],
-  ]) {
-    const trackRefs = asArray(seqEntry.node[container]?.Track);
+  // Two sequence shapes (E132): the synthetic/legacy one lists tracks under
+  // <VideoTracks>/<AudioTracks>; a real Premiere 2025 project lists
+  // <TrackGroups> whose <Second> references a VideoTrackGroup /
+  // AudioTrackGroup carrying <TrackGroup><Tracks><Track ObjectURef>.
+  const trackLists = [];
+  for (const [container, trackKind] of [['VideoTracks', 'V'], ['AudioTracks', 'A']]) {
+    const refs = asArray(seqEntry.node[container]?.Track);
+    if (refs.length) trackLists.push({ trackKind, refs });
+  }
+  for (const tg of asArray(seqEntry.node.TrackGroups?.TrackGroup)) {
+    const grp = byId.get(refId(asArray(tg.Second)[0]));
+    if (!grp) continue;
+    const trackKind = /^Audio/.test(grp.tag) ? 'A' : /^Video/.test(grp.tag) ? 'V' : null;
+    if (!trackKind) continue;
+    const refs = asArray(grp.node.TrackGroup?.Tracks?.Track);
+    if (refs.length) trackLists.push({ trackKind, refs });
+  }
+  for (const { trackKind, refs: trackRefs } of trackLists) {
     for (const tref of trackRefs) {
-      const tEntry = byId.get(String(tref['@_ObjectRef'] ?? ''));
+      const tEntry = byId.get(refId(tref));
       if (!tEntry) continue;
-      const itemRefs = asArray(tEntry.node.TrackItems?.TrackItem);
+      const itemRefs = asArray(tEntry.node.TrackItems?.TrackItem).concat(asArray(tEntry.node.ClipTrack?.ClipItems?.TrackItems?.TrackItem), asArray(tEntry.node.ClipItems?.TrackItems?.TrackItem));
       const transitions = [];
       const clipEvents = [];
       for (const iref of itemRefs) {
-        const cEntry = byId.get(String(iref['@_ObjectRef'] ?? ''));
+        const cEntry = byId.get(refId(iref));
         if (!cEntry) continue;
         if (/ClipTrackItem$/.test(cEntry.tag)) {
           clipEvents.push(clipEvent(cEntry.node, byId, trackKind, fps, idx++));
         } else if (/Transition/.test(cEntry.tag)) {
-          const dur = ticksToFrames(Number(childText(cEntry.node, 'End')) - Number(childText(cEntry.node, 'Start')), fps);
-          transitions.push({ recIn: ticksToFrames(childText(cEntry.node, 'Start'), fps), duration: dur || 0 });
+          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 });
         }
       }
       // Attach each transition to the INCOMING clip whose record-in falls
@@ -243,8 +327,8 @@ export function parsePrprojDoc(pathOrBuffer) {
     const fps = deriveFps(entry.node);
     const events = walkSequence(entry, byId);
     return {
-      id: String(entry.node['@_ObjectID']),
-      name: nodeName(entry.node) || `Sequence ${entry.node['@_ObjectID']}`,
+      id: String(entry.node['@_ObjectID'] ?? entry.node['@_ObjectUID']),
+      name: nodeName(entry.node) || `Sequence ${entry.node['@_ObjectID'] ?? entry.node['@_ObjectUID']}`,
       fps,
       eventCount: events.length,
       events,

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 → 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) → 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.184.0"
+VERSION = "2.185.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.184.0"
+VERSION = "2.185.0"
 
 import base64
 import os

package/src/utils/api_truth.py

@@ -2877,6 +2877,41 @@ API_TRUTH: List[Dict[str, Any]] = [
         "submit": "missing",
         "mitigation": ["drp-format placeGenerator color", "editorial.parse_interchange fillcolor", "drt.assemble_from_interchange"],
     },
+    {
+        "symbol": "Premiere .prproj (2025, project Version 45) object graph — what a real file looks like",
+        "object": "editorial.parse_interchange / list_sequences (prproj)",
+        "signature": "(path.prproj) -> sequences/events",
+        "reality": "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.",
+        "recommended": "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).",
+        "tags": ["prproj", "premiere", "interchange", "silent-failure"],
+        "submit": "missing",
+        "mitigation": ["editorial.parse_interchange prproj", "editorial.list_sequences"],
+    },
     {
         "symbol": "ProjectManager.CreateProject (discards an unsaved current project)",
         "object": "ProjectManager",