v2.57.2

v2.57.2

A consolidated, submittable list of DaVinci Resolve scripting-API limitations.

Added

• docs/reference/api-limitations.md — a curated, behaviorally-verified catalogue of Resolve scripting-API gaps and bugs, formatted for submission to Blackmagic Design's developer feedback. Split into:
  • Missing Capabilities (please add): Source Track Selector / insert trackIndex (#74), per-clip audio stereo↔mono (#73), native multicam-clip creation, transition create/copy/clone, GetTimelineByName, cloud project list/export/user management.
  • Bugs / Unreliable Behavior (please fix): enum-key silent failures in AutoSyncAudio, CreateSubtitlesFromAudio, the CloudProject family, and Timeline.Export; flaky DeleteProject; Composition.Paste bridge failure; FlowView unreliable returns; truncated Transcription property; automation-blocking CreateProject modal.
• scripts/gen_api_limitations.py — generates the report from the submit-tagged entries in the api_truth ledger, which remains the single source of truth (also queryable at runtime via resolve_control api_truth).

Changed

• The api_truth entries gained optional submit ("missing"/"bug") and issue keys; four new missing-capability entries were catalogued and verified absent against the bundled API reference.
• Release process and CI keep the report current: a new tests.test_api_limitations_doc drift guard (added to the publish workflow) fails if the doc is stale, and docs/process/release-process.md + AGENTS.md now require regenerating it whenever a submit-tagged entry changes.

Validation

• Static checks (test_import, audit_api_parity, gen_api_limitations --check, undefined-names / action-list / panel-docs / api-limitations drift guards), api_truth unit tests, node --version, and npm pack --dry-run all clean.
• No Resolve behavior changed; this is documentation + tooling. The catalogued gaps were verified live on Resolve Studio 21.0.0 and against the bundled API reference.