@amg555/frameforge-mcp 2.7.1 → 2.7.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amg555/frameforge-mcp",
-  "version": "2.7.1",
+  "version": "2.7.3",
   "description": "FrameForge — AI video production engine for agentic IDEs. npx @amg555/frameforge-mcp. FFmpeg + TTS on your machine. 28 MCP tools. Whisper, yt-dlp, broadcast-grade audio, 13-type SFX library, 24 film styles, ClaudeAnimationBase full guide, onetake 39-move library + OM motion primitives, HyperFrames beat-grid, earshot forge DSP, J/L-cut editing, lemo-opuscar TREATMENT.md, upstream auto-update changelog.",
   "publishConfig": {
     "access": "public"

package/plugins/video-pipeline/.claude-plugin/plugin.json

@@ -1,25 +1,25 @@
-{
-  "name": "video-pipeline",
-  "displayName": "FrameForge Video Pipeline",
-  "version": "2.7.0",
-  "description": "End-to-end AI video production. IDE writes scenes → FrameForge renders. Or: scaffold a Playwright+ffmpeg code-driven animation. Or: auto-research and script the video.",
-  "skills": [
-    {
-      "name": "video-pipeline",
-      "path": "skills/video-pipeline/SKILL.md",
-      "displayName": "Video Pipeline",
-      "description": "28 MCP tools: create_video_from_script, edit_video, plan_video_edit, preview_scene, verify_scene_quality, scaffold_animation_project, render_animation, validate_storyboard, mix_audio_pro, transcribe_media, ingest_url, sync_upstream_skills, check_upstream_updates, and more."
-    },
-    {
-      "name": "html-renderer",
-      "path": "skills/html-renderer/SKILL.md",
-      "displayName": "HTML Renderer",
-      "description": "HTML-as-compositor rendering engine: pure function of time t, virtual clock, Playwright headless capture, and FFmpeg broadcast-standard encoding."
-    }
-  ],
-  "mcpServer": {
-    "command": "npx",
-    "args": ["--yes", "--package=@amg555/frameforge-mcp", "frameforge-mcp"],
-    "description": "Starts the FrameForge MCP server. No install needed — npx pulls from npm."
-  }
-}
+{
+  "name": "video-pipeline",
+  "displayName": "FrameForge Video Pipeline",
+  "version": "2.7.3",
+  "description": "End-to-end AI video production. IDE writes scenes → FrameForge renders. Or: scaffold a Playwright+ffmpeg code-driven animation. Or: auto-research and script the video.",
+  "skills": [
+    {
+      "name": "video-pipeline",
+      "path": "skills/video-pipeline/SKILL.md",
+      "displayName": "Video Pipeline",
+      "description": "28 MCP tools: create_video_from_script, edit_video, plan_video_edit, preview_scene, verify_scene_quality, scaffold_animation_project, render_animation, validate_storyboard, mix_audio_pro, transcribe_media, ingest_url, sync_upstream_skills, check_upstream_updates, and more."
+    },
+    {
+      "name": "html-renderer",
+      "path": "skills/html-renderer/SKILL.md",
+      "displayName": "HTML Renderer",
+      "description": "HTML-as-compositor rendering engine: pure function of time t, virtual clock, Playwright headless capture, and FFmpeg broadcast-standard encoding."
+    }
+  ],
+  "mcpServer": {
+    "command": "npx",
+    "args": ["--yes", "--package=@amg555/frameforge-mcp", "frameforge-mcp"],
+    "description": "Starts the FrameForge MCP server. No install needed — npx pulls from npm."
+  }
+}

package/plugins/video-pipeline/skills/.upstream-skills.json

@@ -1,143 +1,143 @@
-{
-  "lastSync": "2026-11-11T19:56:18.351Z",
-  "repos": {
-    "hyperframes": {
-      "repo": "heygen-com/hyperframes",
-      "category": "compositor",
-      "desc": "Agent-native HTML/GSAP declarative video compositor",
-      "capabilities": [
-        "scaffold_animation_project",
-        "render_animation"
-      ],
-      "userImpact": "New compositor patterns or GSAP animation primitives available for HTML-rendered video",
-      "sha": "a243169",
-      "lastChecked": "2026-11-11T19:56:16.487Z",
-      "status": "synced"
-    },
-    "opuscar": {
-      "repo": "lemomo-ai/lemo-opuscar",
-      "category": "styles",
-      "desc": "Frontier cinematic and viral film styles catalog (12 styles)",
-      "capabilities": [
-        "plan_video_edit",
-        "edit_video",
-        "render_from_scenes"
-      ],
-      "userImpact": "New color grades or film styles available in plan_video_edit style parameter",
-      "sha": "9eb7739",
-      "lastChecked": "2026-11-11T19:56:16.692Z",
-      "status": "synced"
-    },
-    "onetake": {
-      "repo": "feitangyuan/onetake",
-      "category": "camera",
-      "desc": "Continuous single-shot camera choreography (zero-cut spline)",
-      "capabilities": [
-        "generate_scene_code",
-        "scaffold_animation_project"
-      ],
-      "userImpact": "New onetake camera transition patterns available for code-driven animation",
-      "sha": "abb6d17",
-      "lastChecked": "2026-11-11T19:56:16.855Z",
-      "status": "synced"
-    },
-    "collage-broll": {
-      "repo": "pyang5166/gbro-collage-broll",
-      "category": "broll",
-      "desc": "Editorial paper collage, halftone textures, 2.5D tilt",
-      "capabilities": [
-        "generate_scene_code",
-        "create_video_from_script"
-      ],
-      "userImpact": "New editorial collage / halftone visual templates available",
-      "sha": "a1a4ee2",
-      "lastChecked": "2026-11-11T19:56:17.057Z",
-      "status": "synced"
-    },
-    "remotion-skills": {
-      "repo": "remotion-dev/skills",
-      "category": "motion",
-      "desc": "First-party Remotion composition skills (spring physics)",
-      "capabilities": [
-        "scaffold_animation_project",
-        "render_animation"
-      ],
-      "userImpact": "New Remotion motion patterns or spring physics presets available",
-      "sha": "7e541aa",
-      "lastChecked": "2026-11-11T19:56:17.403Z",
-      "status": "synced"
-    },
-    "earshot": {
-      "repo": "Leonxlnx/earshot",
-      "category": "audio",
-      "desc": "Procedural CPU SFX synthesis and timeline sync (13-type library)",
-      "capabilities": [
-        "mix_audio_pro",
-        "create_video_from_script"
-      ],
-      "userImpact": "New procedural SFX cue types or audio sync patterns available in mix_audio_pro",
-      "sha": "4ac3d2a",
-      "lastChecked": "2026-11-11T19:56:17.839Z",
-      "status": "synced"
-    },
-    "claude-anim-base": {
-      "repo": "JohnHeibel/ClaudeAnimationBase",
-      "category": "animation",
-      "desc": "12fps hand-drawn cel boil, character emotions (Opus 5.5 patterns)",
-      "capabilities": [
-        "generate_scene_code",
-        "scaffold_animation_project"
-      ],
-      "userImpact": "New ClaudeAnimationBase patterns for 12fps organic boil or character emotion scenes",
-      "sha": "0ac8bf2",
-      "lastChecked": "2026-11-11T19:56:18.012Z",
-      "status": "synced"
-    },
-    "claude-remotion": {
-      "repo": "haidrrrry/claude-remotion-skill",
-      "category": "motion",
-      "desc": "10 hard motion craft rules, review loop, Opus 5.5 closed-loop QA",
-      "capabilities": [
-        "scaffold_animation_project",
-        "render_animation",
-        "verify_scene_quality"
-      ],
-      "userImpact": "Updated motion craft rules or QA patterns for the Opus 5.5 closed-loop correction pipeline",
-      "sha": "1dcbe5e",
-      "lastChecked": "2026-11-11T19:56:18.180Z",
-      "status": "synced"
-    },
-    "ffmpeg-skill": {
-      "repo": "kajisho5/ffmpeg-skill",
-      "category": "ffmpeg",
-      "desc": "42 typed-argparse FFmpeg tools, machine-readable contract, visual linter",
-      "capabilities": [
-        "edit_video",
-        "plan_video_edit",
-        "mix_audio_pro"
-      ],
-      "userImpact": "New FFmpeg filter patterns or video editing operations available",
-      "sha": "532cbe3",
-      "lastChecked": "2026-11-11T19:56:18.351Z",
-      "status": "synced"
-    }
-  },
-  "version": "2.7.0",
-  "updatedCount": 2,
-  "pendingUpdates": [
-    {
-      "id": "hyperframes",
-      "repo": "heygen-com/hyperframes",
-      "sha": "a243169",
-      "category": "compositor",
-      "userImpact": "New compositor patterns or GSAP animation primitives available for HTML-rendered video"
-    },
-    {
-      "id": "remotion-skills",
-      "repo": "remotion-dev/skills",
-      "sha": "7e541aa",
-      "category": "motion",
-      "userImpact": "New Remotion motion patterns or spring physics presets available"
-    }
-  ]
-}
+{
+  "lastSync": "2026-11-11T19:56:18.351Z",
+  "repos": {
+    "hyperframes": {
+      "repo": "heygen-com/hyperframes",
+      "category": "compositor",
+      "desc": "Agent-native HTML/GSAP declarative video compositor",
+      "capabilities": [
+        "scaffold_animation_project",
+        "render_animation"
+      ],
+      "userImpact": "New compositor patterns or GSAP animation primitives available for HTML-rendered video",
+      "sha": "a243169",
+      "lastChecked": "2026-11-11T19:56:16.487Z",
+      "status": "synced"
+    },
+    "opuscar": {
+      "repo": "lemomo-ai/lemo-opuscar",
+      "category": "styles",
+      "desc": "Frontier cinematic and viral film styles catalog (12 styles)",
+      "capabilities": [
+        "plan_video_edit",
+        "edit_video",
+        "render_from_scenes"
+      ],
+      "userImpact": "New color grades or film styles available in plan_video_edit style parameter",
+      "sha": "9eb7739",
+      "lastChecked": "2026-11-11T19:56:16.692Z",
+      "status": "synced"
+    },
+    "onetake": {
+      "repo": "feitangyuan/onetake",
+      "category": "camera",
+      "desc": "Continuous single-shot camera choreography (zero-cut spline)",
+      "capabilities": [
+        "generate_scene_code",
+        "scaffold_animation_project"
+      ],
+      "userImpact": "New onetake camera transition patterns available for code-driven animation",
+      "sha": "abb6d17",
+      "lastChecked": "2026-11-11T19:56:16.855Z",
+      "status": "synced"
+    },
+    "collage-broll": {
+      "repo": "pyang5166/gbro-collage-broll",
+      "category": "broll",
+      "desc": "Editorial paper collage, halftone textures, 2.5D tilt",
+      "capabilities": [
+        "generate_scene_code",
+        "create_video_from_script"
+      ],
+      "userImpact": "New editorial collage / halftone visual templates available",
+      "sha": "a1a4ee2",
+      "lastChecked": "2026-11-11T19:56:17.057Z",
+      "status": "synced"
+    },
+    "remotion-skills": {
+      "repo": "remotion-dev/skills",
+      "category": "motion",
+      "desc": "First-party Remotion composition skills (spring physics)",
+      "capabilities": [
+        "scaffold_animation_project",
+        "render_animation"
+      ],
+      "userImpact": "New Remotion motion patterns or spring physics presets available",
+      "sha": "7e541aa",
+      "lastChecked": "2026-11-11T19:56:17.403Z",
+      "status": "synced"
+    },
+    "earshot": {
+      "repo": "Leonxlnx/earshot",
+      "category": "audio",
+      "desc": "Procedural CPU SFX synthesis and timeline sync (13-type library)",
+      "capabilities": [
+        "mix_audio_pro",
+        "create_video_from_script"
+      ],
+      "userImpact": "New procedural SFX cue types or audio sync patterns available in mix_audio_pro",
+      "sha": "4ac3d2a",
+      "lastChecked": "2026-11-11T19:56:17.839Z",
+      "status": "synced"
+    },
+    "claude-anim-base": {
+      "repo": "JohnHeibel/ClaudeAnimationBase",
+      "category": "animation",
+      "desc": "12fps hand-drawn cel boil, character emotions (Opus 5.5 patterns)",
+      "capabilities": [
+        "generate_scene_code",
+        "scaffold_animation_project"
+      ],
+      "userImpact": "New ClaudeAnimationBase patterns for 12fps organic boil or character emotion scenes",
+      "sha": "0ac8bf2",
+      "lastChecked": "2026-11-11T19:56:18.012Z",
+      "status": "synced"
+    },
+    "claude-remotion": {
+      "repo": "haidrrrry/claude-remotion-skill",
+      "category": "motion",
+      "desc": "10 hard motion craft rules, review loop, Opus 5.5 closed-loop QA",
+      "capabilities": [
+        "scaffold_animation_project",
+        "render_animation",
+        "verify_scene_quality"
+      ],
+      "userImpact": "Updated motion craft rules or QA patterns for the Opus 5.5 closed-loop correction pipeline",
+      "sha": "1dcbe5e",
+      "lastChecked": "2026-11-11T19:56:18.180Z",
+      "status": "synced"
+    },
+    "ffmpeg-skill": {
+      "repo": "kajisho5/ffmpeg-skill",
+      "category": "ffmpeg",
+      "desc": "42 typed-argparse FFmpeg tools, machine-readable contract, visual linter",
+      "capabilities": [
+        "edit_video",
+        "plan_video_edit",
+        "mix_audio_pro"
+      ],
+      "userImpact": "New FFmpeg filter patterns or video editing operations available",
+      "sha": "532cbe3",
+      "lastChecked": "2026-11-11T19:56:18.351Z",
+      "status": "synced"
+    }
+  },
+  "version": "2.7.3",
+  "updatedCount": 2,
+  "pendingUpdates": [
+    {
+      "id": "hyperframes",
+      "repo": "heygen-com/hyperframes",
+      "sha": "a243169",
+      "category": "compositor",
+      "userImpact": "New compositor patterns or GSAP animation primitives available for HTML-rendered video"
+    },
+    {
+      "id": "remotion-skills",
+      "repo": "remotion-dev/skills",
+      "sha": "7e541aa",
+      "category": "motion",
+      "userImpact": "New Remotion motion patterns or spring physics presets available"
+    }
+  ]
+}

package/plugins/video-pipeline/skills/html-renderer/references/procedural-sfx.md

@@ -48,13 +48,25 @@ mix_audio_pro({
 })
 ```
 
-Or in `edit.js` for render-time visual sync (engine.js `cue()` function):
+Or in `edit.js` for render-time visual sync (engine.js `cue()` and `event()` functions):
 ```javascript
-import { cue } from './reel/engine.js';
-cue('whoosh',    2.5, 0.8);   // registered in window.__cues for render.mjs
+import { cue, event, ROOM_SFX } from './reel/engine.js';
+
+// cue() — registers in window.__cues (legacy, render.mjs live preview)
+cue('whoosh',    2.5, 0.8);
 cue('impact',   8.0, 1.0);
 cue('riser',   18.0, 0.7);
 cue('deep_boom',30.0, 0.9);
+
+// event() — registers in window.__events() and is written to out/sfx-events.json
+// by render.mjs after probe. mix_audio_pro.py reads it automatically.
+event('sfx', 2.5,  { sfxName: 'whoosh',    vol: 0.8 });
+event('sfx', 8.0,  { sfxName: 'impact',    vol: 1.0 });
+event('sfx', 30.0, { material: 'sub',      vol: 0.9 }); // OneTake ROOM_SFX → deep_boom
+
+// Then: render.mjs writes out/sfx-events.json
+// mix_audio_pro.py reads it automatically (no --sfx flags needed):
+//   uv run scripts/mix_audio_pro.py --music assets/bg.mp3 --platform youtube --room broadcast
 ```
 
 ---