samuelgursky/davinci-resolve-mcp

v2.58.0

Two bodies of work in one release: a major expansion of the optional advanced Node
server (the beyond-the-API sibling that edits Resolve files offline), and cross-platform
agent guidance so any IDE — not just Claude Code — gets per-domain routing between the
live and offline servers. All new capability is offline, deterministic, and silent-lie
guarded; no live Python-server behavior or tool counts changed (compound 34 / granular 341).

Added

Advanced Node server (davinci-resolve-advanced-mcp, bundled as a second bin) — 14 → 18 tools:

• New tools: deliverable (QC/compliance), media (front-end/AE), editorial
  (integrity/changelist), provenance (audit/episode report).
• Offline grading catalog (drx actions): scope_read, intent_tags, verify_grade,
  extract_frames, match_to_reference, saturation_match, black_balance,
  tone_curve_transfer, skin_match v2 (skin-line metric), author_look/carry_look
  (season-look authoring), lut_apply (reverse-engineered Body-LUT write path).
• Node provenance labels on every auto node, runner→apply contract, stage-resume, and a
  learning layer (pipeline learn/insights) mining decoded facts across episodes.

Python server:

• import_timeline_checked with sanitize_media (FCP7/FCPXML sanitize so the scripting API
  imports with media linked).

Cross-platform agent guidance:

• 7 per-domain MCP prompts (color_grade_workflow, timeline_edit_workflow,
  conform_workflow, delivery_workflow, fusion_workflow, audio_workflow,
  media_pool_workflow) — slash commands in every MCP client, each routing a task across
  its live tools and its offline advanced-server counterpart (compute offline, apply live).
• 9 Claude Code skills (.claude/skills/): a resolve-mcp index plus eight domain
  routers (color, edit, conform, delivery, fusion, audio, media-pool, media-analysis). Thin
  bridges to the kernels; all 18 advanced tools are routed.
• Generated cross-platform rule files from a single manifest
  (scripts/agent-rules/generate.mjs): .cursor/rules/*, .github/instructions/* +
  .github/copilot-instructions.md, .windsurf/rules/*, .clinerules, .roo/rules/*,
  .continue/rules/*, and an AGENTS.md domain-routing block. Tool/action counts are parsed
  from their canonical docs so they cannot drift.

Fixed

• Corrected stale tool counts and doc paths that had drifted in
  .github/copilot-instructions.md, .clinerules, .cursorrules, and .windsurfrules.

Documentation

• Every kernel with an offline counterpart gained an "Advanced (offline) server" section
  (color, edit, conform, deliver, fusion, audio, media-pool).
• install.py configures the second bin; advanced optional deps promoted to root.

Validation

• Full offline Node suite green (advanced server). DRX write paths live-verified against
  DaVinci Resolve 19.1.3 Studio by panel readback (windows, qualifiers, HDR zones,
  ColorSlice, HSL curves); Color Warper write is R21-format and pends an R21 verify.
• Static/drift guards green: test_import, test_static_undefined_names,
  test_action_list_drift, test_panel_docs_drift, test_doc_tool_counts,
  test_agent_rules_drift, plus audit_api_parity, gen_api_limitations --check,
  agent-rules generate.mjs --check, npm pack --dry-run, git diff --check.
• The offline QC/finishing tools compute/plan; their Resolve apply stays in the live server
  and is validated live separately. The agent-guidance work changed no live Python-server
  behavior — live Resolve validation not required for it.