davinci-resolve-mcp 2.95.2 → 2.96.0

package/src/utils/api_truth.py

@@ -1057,9 +1057,39 @@ API_TRUTH: List[Dict[str, Any]] = [
                    "source span EQUALS the record span even under M2; the "
                    "`M2 <reel> <rate> <srcInTC>` line carries the play rate in "
                    "fps (048.0 = 200% at 24); `* FROM CLIP NAME:` comments drive "
-                   "pool linking. UNTESTED as import routes: reverse (negative "
-                   "time_scalar / reverse M2) and varying-speed maps — do not "
-                   "extrapolate the constant-speed result to them.",
+                   "pool linking. REVERSE AND VARYING-SPEED RAMPS ARE NOW "
+                   "MEASURED TOO (2026-08-12, Studio 21.0.4.5) — this entry "
+                   "previously warned they were UNTESTED; that warning is "
+                   "closed and both work. REVERSE lands through BOTH import "
+                   "routes: OTIO with a negative time_scalar (-1) placed a clip "
+                   "reading GetSourceStartFrame 95 -> GetSourceEndFrame 46, and "
+                   "EDL with a negative M2 rate (-24.0 at 24fps) read 48 -> 0. "
+                   "So THE API DOES EXPOSE DIRECTION, which is worth knowing: a "
+                   "reversed clip reports GetSourceStartFrame GREATER THAN "
+                   "GetSourceEndFrame (a negative span). VARYING-SPEED RAMPS "
+                   "cannot be expressed in OTIO (LinearTimeWarp is a single "
+                   "time_scalar — constant by construction) but CAN be authored "
+                   "offline and survive Resolve intact: a Sm2TimeMap built with "
+                   "media-timemap.buildTimemap carrying two segments (0-2s "
+                   "record at 0.5x, 2-4s at 2.0x) was patched into a clip's "
+                   "MediaTimemapBA, imported, and re-exported by Resolve with "
+                   "the segments UNCHANGED. Independent confirmation from the "
+                   "API side: the placed clip read GetSourceStart/EndFrame 0..120 "
+                   "over a 96-frame record, and 2s at 0.5x (24 source frames) + "
+                   "2s at 2.0x (96) is exactly 120. TWO TRAPS worth naming. "
+                   "(1) buildTimemap returns a BUFFER; writing it into the XML "
+                   "without .toString('hex') embeds mojibake, and the failure is "
+                   "SILENT — the clip imports fine and reads 0..0, which is "
+                   "indistinguishable from the degenerate-map signature this "
+                   "entry describes for xmeml imports, so it reads as 'Resolve "
+                   "rejected the retime' when it is really a caller bug. "
+                   "(2) a REVERSED map does not start at (0,0): Resolve encodes "
+                   "the starting source offset as a TOP-LEVEL protobuf field 2 "
+                   "double, and each keyframe point omits whichever of "
+                   "record/source is zero (protobuf default-omission). Anything "
+                   "reading fixed offsets or assuming a (0,0) origin decodes a "
+                   "reverse as SPEED 0 rather than -1. drp-format's own decoder "
+                   "had both bugs and is fixed.",
         "recommended": "Set clip speed/retime in the Resolve UI, or BUILD it by "
                        "import: OTIO LinearTimeWarp and EDL M2 both construct "
                        "constant retimes through ImportTimelineFromFile (measured "