samuelgursky/davinci-resolve-mcp

v2.57.1

Investigation outcome for community feature request #74 — no behavior change.

Documentation

• Source Track Selector is not controllable via the API (issue #74). Verified live on DaVinci Resolve Studio 21.0.0: there is no get/set for the Source/Auto Track Selector, the Insert*IntoTimeline family (titles, generators, OFX, Fusion comps) takes no trackIndex and always lands on V1, locking lower video tracks makes the insert fail rather than redirect, and titles/generators can't be relocated afterward (no MediaPoolItem). Closed as won't-fix (API limitation), worth raising with Blackmagic Design.
• Recorded the verified limitation in the api_truth ledger — query it at runtime with resolve_control api_truth "track" — and in docs/reference/api-coverage.md.
• Documented the supported alternative for media-backed clips: MediaPool.AppendToTimeline's clipInfo trackIndex (exposed as media_pool.append_to_timeline with clip_infos).
• Added a regression test.

Credits

• Investigation driven by @swayll (Elpidio Coppa) via issue #74; credited as co-author on the documenting commit.

Validation

• Static checks (test_import, audit_api_parity, undefined-names / action-list / panel-docs drift guards), api_truth unit tests, node --version, and npm pack --dry-run all clean.
• No Resolve behavior changed; the underlying limitation was live-verified on Resolve Studio 21.0.0 during investigation.