davinci-resolve-mcp 2.69.1 → 2.70.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (34) hide show
  1. package/CHANGELOG.md +197 -0
  2. package/README.md +1 -1
  3. package/docs/SKILL.md +78 -1
  4. package/docs/guides/headless-edit-loop.md +238 -0
  5. package/docs/reference/api-limitations.md +65 -4
  6. package/docs/reference/headless-capability-matrix.md +56 -0
  7. package/docs/reference/headless-cli.md +751 -0
  8. package/docs/reference/pixel-equality.md +11 -0
  9. package/docs/reference/roundtrip-fidelity.md +17 -0
  10. package/docs/reference/roundtrip-rich-fidelity.md +18 -0
  11. package/install.py +8 -3
  12. package/package.json +1 -1
  13. package/resolve-advanced/package.json +3 -3
  14. package/scripts/bisect_headless_hang.py +125 -0
  15. package/scripts/contact_sheet.py +209 -0
  16. package/scripts/headless_differential.py +578 -0
  17. package/scripts/install_resolve_bridge.py +75 -5
  18. package/scripts/mode_matrix.py +345 -0
  19. package/scripts/mode_matrix_worker.py +232 -0
  20. package/scripts/pixel_equality.py +402 -0
  21. package/scripts/relink_moved_media.py +267 -0
  22. package/scripts/render_stress.py +542 -0
  23. package/scripts/resolve_headless.py +225 -0
  24. package/scripts/roundtrip_matrix.py +434 -0
  25. package/scripts/roundtrip_rich.py +431 -0
  26. package/src/granular/common.py +1 -1
  27. package/src/server.py +92 -67
  28. package/src/utils/api_truth.py +302 -4
  29. package/src/utils/headless_differential.py +363 -0
  30. package/src/utils/mode_matrix.py +338 -0
  31. package/src/utils/platform.py +10 -0
  32. package/src/utils/probe_catalogue.py +796 -0
  33. package/src/utils/project_cleanup.py +61 -9
  34. package/src/utils/resolve_runtime.py +233 -0
package/docs/reference/headless-capability-matrix.md ADDED
@@ -0,0 +1,56 @@
1
+ # GUI vs headless probe matrix
2
+
3
+ 105 probes, 2 GUI run(s) x 2 headless run(s).
4
+
5
+ | verdict | count |
6
+ | --- | --- |
7
+ | parity | 86 |
8
+ | flaky | 0 |
9
+ | hang_headless | 0 |
10
+ | hang_gui | 0 |
11
+ | headless_degraded | 2 |
12
+ | gui_degraded | 0 |
13
+ | both_hang | 0 |
14
+ | both_failed | 14 |
15
+ | divergent | 3 |
16
+ | untested | 0 |
17
+
18
+ ## Coverage by category
19
+
20
+ | category | probes | parity | hang_headless | headless_degraded | gui_degraded | divergent | untested |
21
+ | --- | --- | --- | --- | --- | --- | --- | --- |
22
+ | app | 8 | 6 | 0 | 0 | 0 | 0 | 0 |
23
+ | audio | 3 | 3 | 0 | 0 | 0 | 0 | 0 |
24
+ | color | 9 | 9 | 0 | 0 | 0 | 0 | 0 |
25
+ | editorial | 5 | 0 | 0 | 2 | 0 | 1 | 0 |
26
+ | fusion | 2 | 2 | 0 | 0 | 0 | 0 | 0 |
27
+ | gallery | 4 | 3 | 0 | 0 | 0 | 0 | 0 |
28
+ | interchange | 5 | 5 | 0 | 0 | 0 | 0 | 0 |
29
+ | layout | 4 | 4 | 0 | 0 | 0 | 0 | 0 |
30
+ | lifecycle | 3 | 3 | 0 | 0 | 0 | 0 | 0 |
31
+ | longop | 4 | 1 | 0 | 0 | 0 | 0 | 0 |
32
+ | media_pool | 8 | 5 | 0 | 0 | 0 | 0 | 0 |
33
+ | pages | 7 | 7 | 0 | 0 | 0 | 0 | 0 |
34
+ | project_manager | 8 | 8 | 0 | 0 | 0 | 0 | 0 |
35
+ | project_settings | 5 | 5 | 0 | 0 | 0 | 0 | 0 |
36
+ | projectlevel | 4 | 0 | 0 | 0 | 0 | 2 | 0 |
37
+ | render | 6 | 6 | 0 | 0 | 0 | 0 | 0 |
38
+ | timeline | 12 | 11 | 0 | 0 | 0 | 0 | 0 |
39
+ | timeline_item | 8 | 8 | 0 | 0 | 0 | 0 | 0 |
40
+
41
+ ## Mode-dependent findings
42
+
43
+ > **Re-verify every row below in isolation before believing it.** Probes run in catalogue order against one shared fixture, so a probe near the end has ~90 destructive probes' worth of accumulated state behind it, and the two modes can drift apart for reasons that have nothing to do with the mode. Measured: five findings here — nested timelines, clip linking, take selectors, multi-job queues and render presets — all reproduced as mode differences in a full sweep and all came out **identical** when re-run with `--only`. Isolation is the test:
44
+
45
+ > ```
46
+ > python scripts/mode_matrix.py run --mode gui --out iso_gui.jsonl --only <probe>
47
+ > python scripts/mode_matrix.py run --mode headless --out iso_hl.jsonl --only <probe>
48
+ > ```
49
+
50
+ | probe | verdict | GUI | headless | note |
51
+ | --- | --- | --- | --- | --- |
52
+ | `editorial.nested_timeline` | headless_degraded | ok: 'True/1' | raised | succeeded with a UI, failed without one |
53
+ | `editorial.set_clips_linked` | headless_degraded | ok: True | none: None | succeeded with a UI, failed without one |
54
+ | `editorial.take_selector` | divergent | ok: 'False/0/None/None' | ok: 'None/None/None/None' | both returned, values differ |
55
+ | `projectlevel.multi_job_queue` | divergent | ok: '3/3' | ok: '0/0' | both returned, values differ |
56
+ | `projectlevel.render_preset_roundtrip` | divergent | ok: 'True/True' | ok: 'None/None' | both returned, values differ |