samuelgursky/davinci-resolve-mcp

v2.26.0

Fusion group-settings authoring + a headless batch-runner CLI. Adapts PR #40 from @RaincloudTheDragon (parser + helpers kept, AMZ-specific templates dropped), and closes #42 (long-running batches without holding a chat turn open).

Added

• fusion_comp.group_settings_export(group_name, path, include_advisory?) — write a live GroupOperator to a .setting file. Returns a parsed published_inputs summary via a balanced-brace walker so nested UserControls / ControlGroup tables are bounded correctly (the original flat-regex parser truncated InstanceInput bodies at the first inner }).
• fusion_comp.group_settings_splice_inputs(source_path, template_path, dest_path?, source_group_name?, template_group_name?) — replace one .setting's Inputs = ordered() { ... } block with the matching block from another. Preserves the source's outer structure and inner Tools. Pure file operation — neither group needs to be live in Resolve.
• fusion_comp.group_settings_load(group_name, settings_path, backup_path?, undo_name?) — apply a .setting to a live group with an automatic timestamped backup. Wrapped in StartUndo/Lock/LoadSettings/Unlock/EndUndo(True) so Fusion's Ctrl+Z reverses the change.
• fusion_comp.bulk_set_expressions(ops) — companion to bulk_set_inputs. Batch attach Fusion expressions across many timeline-item comps in one call. Each op requires timeline scope plus tool_name, input_name, expression. Returns per-op success/error rows + op_count.
• davinci-resolve-mcp batch <plan|run|status|list|resume|cancel> — headless batch-runner CLI that drives src/utils/media_analysis_jobs from outside an MCP/chat client. Closes #42. Exit codes: 0 ok / 2 partial / 3 fatal / 130 Ctrl+C. JSON mode (--json) emits one record per progress event.

Fixed

• InstanceInput parser walks balanced braces instead of using a flat regex. Real-world group exports routinely have nested UserControls = ordered() { ... } tables; the previous parser truncated bodies at the first inner } and reported only a subset of inputs with wrong field values.
• group_settings_load mutation is now wrapped in StartUndo/Lock/Unlock/EndUndo so Ctrl+Z in Fusion reverses the change. The backup path is returned on both success and error.

Documentation

• docs/SKILL.md — new fusion_comp actions surfaced in the key-actions list.
• CHANGELOG.md — v2.26.0 entry.
• docs/kernels/fusion-composition-kernel.md — group-settings action reference.

Validation

• Static checks: tests/test_import.py OK, scripts/audit_api_parity.py PASS, node bin/davinci-resolve-mcp.mjs --version reports 2.26.0, npm pack --dry-run clean, git diff --check clean.
• Focused unit tests: tests/test_fusion_group_settings.py (12) + tests/test_batch_cli.py (12) all pass.
• Live Resolve validation: all five steps of the PR #43 test plan exercised against a disposable project (group_settings_export / splice_inputs / load returned the expected shapes, bulk_set_expressions 3-op shape verified). The Ctrl+Z undo wrap was verified programmatically via direct BMD API in a self-contained diagnostic — both SetInput and LoadSettings mutations under the wrap reverse on comp.Undo().
• Batch CLI is a net-new surface that drives the existing media-analysis jobs engine; no new Resolve API calls were introduced, so no additional Resolve live run was required.

Contributors

Adapted with thanks from @RaincloudTheDragon's PR #40.