davinci-resolve-mcp 2.122.0 → 2.123.0

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

@@ -54,7 +54,9 @@ window. `render.verify_output` covers the container-level checks.
 | Fusion titles | `elements: [{type:'title', text}]` — **21-gen hosts only** | v2.108 |
 
 `assemble_from_interchange` drives the same engine from an EDL / OTIO /
-FCP7-XML / AAF plus a `sourceMap`, and returns an honesty ledger
+FCP7-XML / AAF plus a `sourceMap` — all four formats are route-proven
+end-to-end (parse → assemble → import → measured frames and RMS) — and
+returns an honesty ledger
 (`authoredTransitions`, `droppedTransitions` with reasons, `authoredRetimes`,
 `flattenedRetimes`, `authoredAudioEvents`, `upperTrackCutsVideoOnly`).
 
@@ -99,7 +101,10 @@ Everything else stays in `droppedTransitions` with the reason.
 ## Verification checklist for a delivered .drt
 
 1. `timeline.import_timeline_checked` — expect `linked == total` for media
-   (generators legitimately count as offline).
+   (generators legitimately count as offline). For `.drt`/`.drp` it also
+   cross-checks the files items ACTUALLY link against the archive's
+   `<MediaFilePath>` set and warns on a coarse-identity cross-link
+   (`cross_link_warning`) — `linked == total` alone cannot see one.
 2. Render a probe range; check frame luma at cut boundaries, dissolve
    midpoints (expect the blend average), and retime windows.
 3. For audio: RMS per window (silence = -inf is a failed placement).

package/install.py

@@ -37,7 +37,7 @@ from src.utils.update_check import (
 
 # ─── Version ──────────────────────────────────────────────────────────────────
 
-VERSION = "2.122.0"
+VERSION = "2.123.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.122.0",
+  "version": "2.123.0",
   "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.122.0"
+VERSION = "2.123.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.122.0"
+VERSION = "2.123.0"
 
 import base64
 import os
@@ -6966,6 +6966,49 @@ def _export_timeline_checked(tl, p: Dict[str, Any]):
     return _run_maybe_background("timeline.export_timeline_checked", p, _work)
 
 
+def _drt_expected_media_paths(path: str):
+    """Unique <MediaFilePath> values referenced by a .drt/.drp's timeline clips.
+
+    Feeds the cross-link check: Resolve merges pool media by a COARSE identity
+    across imports, so a clip can silently relink to a DIFFERENT pre-existing
+    file (measured: item readback even shows the wrong clip name). The archive
+    is the ground truth for which files the timeline meant.
+    """
+    import zipfile as _zf
+    paths = set()
+    try:
+        with _zf.ZipFile(path) as zf:
+            for n in zf.namelist():
+                if re.search(r"SeqContainer/.+\.xml$", n) or re.search(r"/SeqContainer\d*\.xml$", n):
+                    xml = zf.read(n).decode("utf-8", "replace")
+                    for m in re.finditer(r"<MediaFilePath>([^<]+)</MediaFilePath>", xml):
+                        paths.add(m.group(1))
+    except Exception:
+        return None
+    return paths or None
+
+
+def _timeline_cross_link_check(tl, expected_paths):
+    """Compare the media files a timeline ACTUALLY links against the expected set."""
+    actual = set()
+    for track_type in ("video", "audio"):
+        try:
+            count = int(tl.GetTrackCount(track_type) or 0)
+        except Exception:
+            count = 0
+        for i in range(1, count + 1):
+            for item in (tl.GetItemListInTrack(track_type, i) or []):
+                try:
+                    mpi = item.GetMediaPoolItem()
+                    fp = mpi.GetClipProperty("File Path") if mpi else None
+                    if fp:
+                        actual.add(str(fp))
+                except Exception:
+                    pass
+    missing = sorted(x for x in expected_paths if x not in actual)
+    return {"expected": sorted(expected_paths), "actual": sorted(actual), "missing": missing}
+
+
 def _timeline_media_coverage(tl) -> Dict[str, Any]:
     """Count how many timeline items are linked to a Media Pool Item vs. offline.
 
@@ -7427,6 +7470,20 @@ def _import_timeline_checked(proj, mp, p: Dict[str, Any]):
             out["relink"] = relink_result
         if binary_relink_note:
             out["note"] = binary_relink_note
+        if ext in {".drt", ".drp"}:
+            expected_paths = _drt_expected_media_paths(path)
+            if expected_paths:
+                xcheck = _timeline_cross_link_check(imported, expected_paths)
+                if xcheck["missing"]:
+                    out["cross_link_warning"] = (
+                        "Media files this timeline references are NOT among the files its "
+                        f"items actually link to: {', '.join(xcheck['missing'])}. Resolve "
+                        "merges pool media by a coarse identity across imports, so clips "
+                        "can silently relink to a DIFFERENT pre-existing file (item names "
+                        "follow the wrong file too). Import into a fresh project, or "
+                        "render-probe before trusting this conform."
+                    )
+                    out["cross_link_check"] = xcheck
         if media["total"] and media["offline"]:
             msg = f"{media['offline']} of {media['total']} timeline items are offline (no linked media)."
             if is_binary: