samuelgursky/davinci-resolve-mcp

v2.57.3

Expanded the Blackmagic-facing API-limitations catalogue with a live surface audit. See docs/reference/api-limitations.md.

Added (missing capabilities)

A dir() audit of the live Resolve 21.0.0 API objects (ProjectManager, Project, MediaPool, MediaPoolItem, Timeline, TimelineItem, Graph), diffed against the UI feature set, surfaced 8 gaps we had not catalogued:

• Timeline-item trim / move / re-time — getters only (GetStart/GetLeftOffset/…), no setters; a placed clip can't be trimmed, slipped, moved, or re-timed.
• Razor / blade / split of a timeline item — no method.
• Clip speed / retime ratio & speed ramps — SetProperty exposes only retime quality, not the speed value.
• Color node-graph editing + primary grade values — no node add/delete/connect; no read/write of lift/gamma/gain/curves/qualifiers/windows (only CDL/DRX/LUT).
• Fairlight audio — no clip/track level, pan, EQ, automation, or FairlightFX control.
• Proxy / optimized-media generation — only link/unlink existing.
• Insert / Overwrite / Replace / Fit-to-Fill edit modes — only append.
• Smart Bins / Power Bins creation — only regular bins.

Verified

• The four previously doc-derived "missing" entries (per-clip audio stereo↔mono, native multicam creation, transitions, cloud list/export/user) were confirmed absent against the live API surface.

Changed

• The generated report now carries an explicit Scope & completeness note: it is a surface audit + incident log and is not guaranteed exhaustive (it doesn't catch parameters that exist-but-misbehave or capabilities never exercised). The report now lists 14 missing capabilities + 9 bugs.

Validation

• Static checks, all drift guards (including test_api_limitations_doc), api_truth tests, node --version, and npm pack --dry-run clean.
• Live introspection run against DaVinci Resolve Studio 21.0.0 (read-only surface dump; one disposable timeline created and deleted, no media touched).