davinci-resolve-mcp 2.57.4 → 2.58.0

package/resolve-advanced/vendor/fusion-codec/templates/title-card.js

@@ -0,0 +1,184 @@
+/**
+ * Title Card Template — Full-frame title with background
+ *
+ * Clean title card with main title, optional subtitle,
+ * over a solid or gradient background. Fades in/out.
+ */
+
+module.exports = {
+  label: 'Title Card',
+  description: 'Full-frame title card with main title, optional subtitle, and fade transitions.',
+  parameters: {
+    title: { type: 'string', default: 'Title', description: 'Main title text' },
+    subtitle: { type: 'string', default: '', description: 'Optional subtitle text' },
+    font: { type: 'string', default: 'Futura', description: 'Font family' },
+    titleSize: { type: 'number', default: 0.1, description: 'Title font size (0-1)' },
+    textColor: { type: 'object', default: { r: 1, g: 1, b: 1 }, description: 'Text color RGB' },
+    bgColor: { type: 'object', default: { r: 0.02, g: 0.02, b: 0.04 }, description: 'Background color RGB' },
+    fadeIn: { type: 'number', default: 24, description: 'Fade in duration (frames)' },
+    fadeOut: { type: 'number', default: 24, description: 'Fade out duration (frames)' },
+    holdDuration: { type: 'number', default: 72, description: 'Hold duration (frames)' },
+    width: { type: 'number', default: 1920, description: 'Frame width' },
+    height: { type: 'number', default: 1080, description: 'Frame height' },
+  },
+
+  generate(params = {}) {
+    const {
+      title = 'Title',
+      subtitle = '',
+      font = 'Futura',
+      titleSize = 0.1,
+      textColor = { r: 1, g: 1, b: 1 },
+      bgColor = { r: 0.02, g: 0.02, b: 0.04 },
+      fadeIn = 24,
+      fadeOut = 24,
+      holdDuration = 72,
+      width = 1920,
+      height = 1080,
+    } = params;
+
+    const totalDuration = fadeIn + holdDuration + fadeOut;
+    const hasSubtitle = subtitle && subtitle.length > 0;
+
+    // Vertical positioning: center title, subtitle below
+    const titleY = hasSubtitle ? 0.54 : 0.5;
+    const subtitleY = 0.42;
+
+    const nodes = [
+      // Background
+      {
+        type: 'Background',
+        name: 'BG_Title',
+        inputs: {
+          TopLeftRed: bgColor.r,
+          TopLeftGreen: bgColor.g,
+          TopLeftBlue: bgColor.b,
+          TopLeftAlpha: 1,
+          Width: width,
+          Height: height,
+          UseFrameFormatSettings: 0,
+        },
+        viewX: 0, viewY: 0,
+      },
+
+      // Main title
+      {
+        type: 'TextPlus',
+        name: 'Text_Title',
+        inputs: {
+          StyledText: title,
+          Font: font,
+          Style: 'Bold',
+          Size: titleSize,
+          Center: { x: 0.5, y: titleY },
+          Red1: textColor.r,
+          Green1: textColor.g,
+          Blue1: textColor.b,
+          HorizontalJustificationNew: 1, // center
+          VerticalJustificationNew: 1,
+          Width: width,
+          Height: height,
+          Tracking: 0.05, // slightly wide tracking for titles
+        },
+        viewX: 0, viewY: 33,
+      },
+
+      // Merge title over background
+      {
+        type: 'Merge',
+        name: 'Merge_Title',
+        inputs: {},
+        connections: {
+          Background: 'BG_Title.Output',
+          Foreground: 'Text_Title.Output',
+        },
+        viewX: 220, viewY: 0,
+      },
+    ];
+
+    let lastMerge = 'Merge_Title';
+
+    // Subtitle (optional)
+    if (hasSubtitle) {
+      nodes.push({
+        type: 'TextPlus',
+        name: 'Text_Subtitle',
+        inputs: {
+          StyledText: subtitle,
+          Font: font,
+          Style: 'Regular',
+          Size: titleSize * 0.45,
+          Center: { x: 0.5, y: subtitleY },
+          Red1: textColor.r * 0.7,
+          Green1: textColor.g * 0.7,
+          Blue1: textColor.b * 0.7,
+          HorizontalJustificationNew: 1,
+          VerticalJustificationNew: 1,
+          Tracking: 0.12,
+          Width: width,
+          Height: height,
+        },
+        viewX: 110, viewY: 66,
+      });
+
+      nodes.push({
+        type: 'Merge',
+        name: 'Merge_Subtitle',
+        inputs: {},
+        connections: {
+          Background: 'Merge_Title.Output',
+          Foreground: 'Text_Subtitle.Output',
+        },
+        viewX: 330, viewY: 0,
+      });
+
+      lastMerge = 'Merge_Subtitle';
+    }
+
+    // Final merge with MediaIn (so title card composites over video if present)
+    nodes.splice(0, 0, {
+      type: 'MediaIn',
+      name: 'MediaIn1',
+      inputs: {},
+      viewX: -110, viewY: 0,
+    });
+
+    // Dissolve/blend the title card over the source
+    nodes.push({
+      type: 'Dissolve',
+      name: 'Dissolve_Fade',
+      inputs: {
+        Mix: 1,
+      },
+      connections: {
+        Background: 'MediaIn1.Output',
+        Foreground: `${lastMerge}.Output`,
+      },
+      viewX: 440, viewY: 0,
+    });
+
+    // MediaOut
+    nodes.push({
+      type: 'MediaOut',
+      name: 'MediaOut1',
+      inputs: {},
+      connections: {
+        Input: 'Dissolve_Fade.Output',
+      },
+      viewX: 550, viewY: 0,
+    });
+
+    return {
+      nodes,
+      keyframes: [
+        // Fade in
+        { tool: 'Dissolve_Fade', input: 'Mix', time: 0, value: 0 },
+        { tool: 'Dissolve_Fade', input: 'Mix', time: fadeIn, value: 1 },
+        // Hold
+        { tool: 'Dissolve_Fade', input: 'Mix', time: fadeIn + holdDuration, value: 1 },
+        // Fade out
+        { tool: 'Dissolve_Fade', input: 'Mix', time: totalDuration, value: 0 },
+      ],
+    };
+  },
+};

package/resolve-advanced/vendor/fusion-codec/templates/vignette.js

@@ -0,0 +1,107 @@
+/**
+ * Vignette Template — Edge darkening effect
+ *
+ * Elliptical mask with soft edges over a black background,
+ * merged in multiply/darken mode over source footage.
+ */
+
+module.exports = {
+  label: 'Vignette',
+  description: 'Soft edge vignette — darkens frame edges with customizable shape and intensity.',
+  parameters: {
+    intensity: { type: 'number', default: 0.5, description: 'Vignette intensity (0-1)' },
+    softness: { type: 'number', default: 0.35, description: 'Edge softness (0-1)' },
+    size: { type: 'number', default: 0.75, description: 'Inner clear area size (0-1)' },
+    aspect: { type: 'number', default: 1.3, description: 'Horizontal/vertical aspect ratio' },
+    centerX: { type: 'number', default: 0.5, description: 'Center X (0-1)' },
+    centerY: { type: 'number', default: 0.5, description: 'Center Y (0-1)' },
+    color: { type: 'object', default: { r: 0, g: 0, b: 0 }, description: 'Vignette color (default black)' },
+    width: { type: 'number', default: 1920, description: 'Frame width' },
+    height: { type: 'number', default: 1080, description: 'Frame height' },
+  },
+
+  generate(params = {}) {
+    const {
+      intensity = 0.5,
+      softness = 0.35,
+      size = 0.75,
+      aspect = 1.3,
+      centerX = 0.5,
+      centerY = 0.5,
+      color = { r: 0, g: 0, b: 0 },
+      width = 1920,
+      height = 1080,
+    } = params;
+
+    return {
+      nodes: [
+        {
+          type: 'MediaIn',
+          name: 'MediaIn1',
+          inputs: {},
+          viewX: 0, viewY: 0,
+        },
+
+        // Black (or colored) background for vignette
+        {
+          type: 'Background',
+          name: 'BG_Vignette',
+          inputs: {
+            TopLeftRed: color.r,
+            TopLeftGreen: color.g,
+            TopLeftBlue: color.b,
+            TopLeftAlpha: 1,
+            Width: width,
+            Height: height,
+            UseFrameFormatSettings: 0,
+          },
+          viewX: 110, viewY: -33,
+        },
+
+        // Elliptical mask — inverted so edges are visible, center is clear
+        {
+          type: 'EllipseMask',
+          name: 'Mask_Vignette',
+          inputs: {
+            Center: { x: centerX, y: centerY },
+            Width: size * aspect,
+            Height: size,
+            SoftEdge: softness,
+            Invert: 1, // invert so edges are opaque
+            MaskWidth: width,
+            MaskHeight: height,
+          },
+          viewX: 220, viewY: -66,
+        },
+
+        // Merge vignette over source
+        {
+          type: 'Merge',
+          name: 'Merge_Vignette',
+          inputs: {
+            Blend: intensity,
+            ApplyMode: 'Multiply',
+          },
+          connections: {
+            Background: 'MediaIn1.Output',
+            Foreground: 'BG_Vignette.Output',
+          },
+          effectMask: 'Mask_Vignette.Mask',
+          viewX: 330, viewY: 0,
+        },
+
+        {
+          type: 'MediaOut',
+          name: 'MediaOut1',
+          inputs: {},
+          connections: {
+            Input: 'Merge_Vignette.Output',
+          },
+          viewX: 440, viewY: 0,
+        },
+      ],
+
+      keyframes: [],
+    };
+  },
+};

package/resolve-advanced/vendor/fusion-codec/templates/watermark.js

@@ -0,0 +1,101 @@
+/**
+ * Watermark Template — Logo/text overlay for review copies
+ *
+ * Semi-transparent text watermark with configurable position,
+ * rotation, and tiling options.
+ */
+
+module.exports = {
+  label: 'Watermark',
+  description: 'Semi-transparent text watermark for review copies. Supports diagonal and tiled modes.',
+  parameters: {
+    text: { type: 'string', default: 'CONFIDENTIAL', description: 'Watermark text' },
+    font: { type: 'string', default: 'Arial', description: 'Font family' },
+    fontSize: { type: 'number', default: 0.08, description: 'Font size (0-1)' },
+    opacity: { type: 'number', default: 0.15, description: 'Watermark opacity (0-1)' },
+    color: { type: 'object', default: { r: 1, g: 1, b: 1 }, description: 'Text color RGB' },
+    angle: { type: 'number', default: -30, description: 'Rotation angle (degrees)' },
+    position: { type: 'string', default: 'center', description: 'Position: center, bottom-right, top-left' },
+    width: { type: 'number', default: 1920, description: 'Frame width' },
+    height: { type: 'number', default: 1080, description: 'Frame height' },
+  },
+
+  generate(params = {}) {
+    const {
+      text = 'CONFIDENTIAL',
+      font = 'Arial',
+      fontSize = 0.08,
+      opacity = 0.15,
+      color = { r: 1, g: 1, b: 1 },
+      angle = -30,
+      position = 'center',
+      width = 1920,
+      height = 1080,
+    } = params;
+
+    const posMap = {
+      'center': { x: 0.5, y: 0.5 },
+      'bottom-right': { x: 0.8, y: 0.1 },
+      'top-left': { x: 0.2, y: 0.9 },
+    };
+    const pos = posMap[position] || posMap['center'];
+
+    return {
+      nodes: [
+        {
+          type: 'MediaIn',
+          name: 'MediaIn1',
+          inputs: {},
+          viewX: 0, viewY: 0,
+        },
+
+        {
+          type: 'TextPlus',
+          name: 'Text_Watermark',
+          inputs: {
+            StyledText: text,
+            Font: font,
+            Style: 'Bold',
+            Size: fontSize,
+            Center: { x: pos.x, y: pos.y },
+            Red1: color.r,
+            Green1: color.g,
+            Blue1: color.b,
+            HorizontalJustificationNew: 1,
+            VerticalJustificationNew: 1,
+            LayoutRotation: angle,
+            Tracking: 0.2,
+            Width: width,
+            Height: height,
+          },
+          viewX: 110, viewY: 33,
+        },
+
+        {
+          type: 'Merge',
+          name: 'Merge_Watermark',
+          inputs: {
+            Blend: opacity,
+          },
+          connections: {
+            Background: 'MediaIn1.Output',
+            Foreground: 'Text_Watermark.Output',
+          },
+          viewX: 220, viewY: 0,
+        },
+
+        {
+          type: 'MediaOut',
+          name: 'MediaOut1',
+          inputs: {},
+          connections: {
+            Input: 'Merge_Watermark.Output',
+          },
+          viewX: 330, viewY: 0,
+        },
+      ],
+
+      keyframes: [],
+    };
+  },
+};

package/scripts/agent-rules/README.md

@@ -0,0 +1,68 @@
+# Cross-platform agent rules
+
+One manifest, every IDE. The *content* an agent needs (source-media safety,
+per-domain routing between the live and offline servers) is platform-neutral and
+lives in `AGENTS.md`, `docs/kernels/*`, `docs/guides/*`, and
+`resolve-advanced/README.md`. What differs per IDE is only the **trigger/discovery
+layer** — the file each tool reads and how it decides *when* to load it. This
+directory generates those thin per-platform shims from a single source so they
+cannot drift.
+
+## Two layers
+
+1. **Dynamic, every-MCP-client layer — MCP prompts (not generated here).** The
+   server registers per-domain slash prompts in `src/server.py`
+   (`color_grade_workflow`, `timeline_edit_workflow`, `conform_workflow`,
+   `delivery_workflow`, plus `analyze_media`). Every MCP client — Codex, Cursor,
+   Copilot, Continue, Claude Desktop, Cline, Roo, Zed, Windsurf, OpenCode — gets
+   them the moment it connects, with no committed files. This is the only layer
+   Claude Desktop (a chat client with no repo-rule mechanism) can use.
+
+2. **Static per-repo-file layer — generated by `generate.mjs`.** For always-on
+   rules and glob/semantic-triggered loading, each IDE reads a different file:
+
+   | Platform | File(s) | Trigger | Source |
+   |---|---|---|---|
+   | Codex / OpenCode / Zed / others | `AGENTS.md` (`## Domain Routing` block) | always-on | generated block |
+   | Claude Code | `.claude/skills/*.md` | semantic (description) | hand-authored (rich) |
+   | Cursor | `.cursor/rules/*.mdc` | `alwaysApply` repo rule + per-domain `description` (agent-requested) | generated |
+   | VS Code / Copilot | `.github/copilot-instructions.md` + `.github/instructions/*.instructions.md` | always-on + `applyTo` | generated |
+   | Windsurf | `.windsurf/rules/*.md` + `.windsurfrules` | rules dir + legacy flat | generated |
+   | Cline | `.clinerules` (single file) | always-on | generated |
+   | Roo Code | `.roo/rules/resolve-mcp.md` | always-on | generated |
+   | Continue | `.continue/rules/resolve-mcp.md` | always-on | generated |
+   | Claude Desktop | — (chat client, no repo rules) | — | MCP prompts only |
+
+   `.claude/skills/*` stays hand-authored (Claude's rich semantic skills); every
+   other file is generated. `AGENTS.md` remains the universal backstop for any
+   client not listed. Always-on rule dirs (Cline/Roo/Continue) get one compact
+   combined file (repo hygiene + domain table), since they load every rule file
+   unconditionally.
+
+## Drift-proofing
+
+- Tool/action counts are **parsed from their canonical docs** at generate time,
+  never hand-copied: compound/granular from `docs/SKILL.md`, kernel actions from
+  `docs/kernels/README.md`, advanced tools from `resolve-advanced/README.md`.
+- `tests/test_agent_rules_drift.py` runs `generate.mjs --check` and fails the
+  suite if any generated file is stale, and asserts the four domain prompts exist
+  in `src/server.py`.
+- `tests/test_doc_tool_counts.py` independently asserts the canonical docs quote
+  the *real* code counts. Chain: code → `test_doc_tool_counts` → canonical docs →
+  `generate.mjs` → agent-rule files → `test_agent_rules_drift`.
+
+## Usage
+
+```bash
+node scripts/agent-rules/generate.mjs          # write/update all outputs
+node scripts/agent-rules/generate.mjs --check   # exit 1 if anything is stale (CI/release gate)
+```
+
+## Adding a domain or a platform
+
+- **New domain:** add an entry to `DOMAINS` in `generate.mjs`, add a matching
+  `@mcp.prompt` in `src/server.py`, and (optionally) a rich `.claude/skills/*.md`.
+  Regenerate.
+- **New platform:** add an `emit(...)` for its convention in `generate.mjs`,
+  reusing `domainBody(d)` / `repoHygiene`. Regenerate. Do not hand-edit generated
+  files — the drift guard will fail.