@amg555/frameforge-mcp 2.7.2 → 2.7.3

package/.claude-plugin/marketplace.json

@@ -2,7 +2,7 @@
   "name": "frameforge",
   "displayName": "FrameForge — AI Video Production",
   "description": "Full AI video production engine. Produce short-form reels (1080×1920), YouTube videos (1920×1080), or code-driven animated explainers — directly from your IDE. Playwright + FFmpeg renders every frame. 28 MCP tools. Whisper, yt-dlp, broadcast audio, 24 film styles, ClaudeAnimationBase, onetake 39-move library, HyperFrames motion craft.",
-  "version": "2.7.2",
+  "version": "2.7.3",
   "homepage": "https://github.com/AMG555/FrameForge",
   "plugins": [
     {

package/CHANGELOG.md

@@ -4,11 +4,18 @@ All notable changes to FrameForge are documented here.
 
 ---
 
-## [2.7.2] — 2026-11-12
+## [2.7.3] — 2026-11-12
 
 ### Added
-- **Full Reference Documentation for all 28 MCP Tools**: Complete parameter schemas and usage examples in `plugins/video-pipeline/skills/video-pipeline/references/mcp-tools.md` covering all animation, scene generation, QA, editor, and media ingestion tools.
-- **mix_audio_pro.py Broadcast Parity**: Synchronized Python audio processor with `mixer.js` — 13 procedural SFX generators, 5 room profiles + computed Sabine RT60 acoustic simulation, platform LUFS presets (YouTube, Podcast, Broadcast, Netflix, Instagram), noise gate (-60dBFS), 300Hz mud notch, and automatic `sfx-events.json` loader for `window.__events` contract.
+- **Scaffolding update**: `new-project.mjs` now imports `beatAt`, `snapToBeat`, `OM`, `ROOM_SFX`, `event`, `seg` in the generated `edit.js` template; copies `mix_audio_pro.py` into every new project; `npm run mix` uses the professional chain by default.
+- **`orchestrator.md`** updated: step 10 now runs `mix_audio_pro.py --sfx-events` after `render.mjs full`, consuming `out/sfx-events.json` from `window.__events()` automatically.
+- **`ANIMATION_GUIDE.md`** step 4 updated to `mix_audio_pro.py --sfx-events`.
+- **`procedural-sfx.md`**: added `event()` / `window.__events()` usage examples.
+- **4 new `deep-validate.js` checks** covering scaffolder import correctness and pro chain copy.
+- **Full Reference Documentation for all 28 MCP Tools**: Complete parameter schemas and usage examples in `mcp-tools.md`.
+
+### Changed
+- `mix_audio_pro.py` v2.7.3 fully synced with `mixer.js`: 13-type SFX map, 5 room profiles, `PLATFORM_LUFS`, noise gate, mud notch, `sfx-events.json` auto-read, `computed:` room format.
 
 ### Fixed
 - **Cloudflare Remote Worker alignment**: Synchronized tool count and server versioning.

package/README.md

@@ -9,7 +9,7 @@
 [![npm](https://img.shields.io/npm/v/@amg555/frameforge-mcp.svg?label=npm)](https://www.npmjs.com/package/@amg555/frameforge-mcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)
-[![Version](https://img.shields.io/badge/version-2.7.2-blue.svg)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-2.7.3-blue.svg)](CHANGELOG.md)
 [![MCP Spec](https://img.shields.io/badge/MCP-2024--11--05-blue.svg)](https://modelcontextprotocol.io/)
 [![Tests](https://img.shields.io/badge/tests-658%20passing-brightgreen.svg)](#testing)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amg555/frameforge-mcp",
-  "version": "2.7.2",
+  "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,7 +1,7 @@
 {
   "name": "video-pipeline",
   "displayName": "FrameForge Video Pipeline",
-  "version": "2.7.2",
+  "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": [
     {

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

@@ -122,7 +122,7 @@
       "status": "synced"
     }
   },
-  "version": "2.7.2",
+  "version": "2.7.3",
   "updatedCount": 2,
   "pendingUpdates": [
     {

package/plugins/video-pipeline/skills/video-pipeline/assets/project/ANIMATION_GUIDE.md

@@ -156,7 +156,8 @@ Never capture audio from the browser. Audio is a separate pass:
 1. TTS generates audio → word-level timestamps from `scripts/transcribe.py`
 2. Scene resolves animation anchors from those timestamps via `cuePhrase()`
 3. `node scripts/render.mjs full` renders video frames (silent)
-4. `uv run scripts/mix_audio.py` builds the final audio track
+4. `uv run scripts/mix_audio_pro.py --sfx-events --room broadcast --platform youtube` builds the final audio track
+   (reads out/sfx-events.json from window.__events() automatically; use `mix_audio.py` for the simple chain)
 5. `node scripts/render.mjs mux` merges with `-c:v copy` (video stream untouched)
 
 `cuePhrase(phrase)` **throws a fatal build error** if the phrase cannot be found

package/plugins/video-pipeline/skills/video-pipeline/assets/project/pipeline/briefings/orchestrator.md

@@ -34,10 +34,14 @@ Use the right effort level at each stage — wrong effort wastes cost or quality
 7. Run render.mjs sheet (one sheet per shot)
 8. Review sheets, request patches from the responsible subagent
 9. Run render.mjs full (full encode, all workers)
-10. Run verify.py (7-gate QC)
-11. If QC fails: identify the responsible chapter, re-assign to a fresh subagent
-12. Mux audio: render.mjs mux --audio=audio/final_mix.wav
-13. Final verify.py pass
+    → After full render, out/sfx-events.json is auto-generated from window.__events()
+10. Run mix_audio_pro.py (professional signal chain):
+    uv run scripts/mix_audio_pro.py --room broadcast --platform youtube
+    (--sfx-events flag reads out/sfx-events.json automatically if present)
+11. Run verify.py (7-gate QC)
+12. If QC fails: identify the responsible chapter, re-assign to a fresh subagent
+13. Mux audio: render.mjs mux --audio=out/audio_mix_pro.m4a
+14. Final verify.py pass
 ```
 
 ## Subagent rules

package/plugins/video-pipeline/skills/video-pipeline/references/mcp-tools.md

@@ -403,7 +403,7 @@ No network requests — reads the local manifest only. Returns:
 ```json
 {
   "lastSync": "2026-11-11T20:00:00Z",
-  "manifestVersion": "2.7.2",
+  "manifestVersion": "2.7.3",
   "totalRepos": 9,
   "syncedCount": 9,
   "repos": [

package/scripts/deep-validate.js

@@ -20,7 +20,7 @@ check('batch handling',              code.includes('Array.isArray(body)'));
 check('ping handler',                code.includes("method === 'ping'"));
 check('notifications/init',          code.includes("notifications/initialized"));
 check('body size limit',             code.includes('MAX_BODY_BYTES'));
-check('SERVER_INFO version 2.7.2',    code.includes("version: '2.7.2'"));
+check('SERVER_INFO version 2.7.3',    code.includes("version: '2.7.3'"));
 check('18 tools defined (incl get_job_status)', code.includes('get_job_status'));
 check('export_to_editor tool defined', code.includes('export_to_editor'));
 check('edit_video tool defined', code.includes('edit_video'));
@@ -259,6 +259,11 @@ check('log-redaction has Tavily tvly- pattern',   redaction.includes('tvly') ||
 // ── html-renderer scaffolder ──────────────────────────────────────────────
 console.log('\n=== html-renderer scaffolder ===');
 check('new-project.mjs exists', fs.existsSync('./scripts/html-renderer/new-project.mjs'));
+const newProjectMjs = fs.readFileSync('./scripts/html-renderer/new-project.mjs', 'utf8');
+check('new-project.mjs imports OM and beatAt', newProjectMjs.includes('beatAt') && newProjectMjs.includes('OM'));
+check('new-project.mjs imports event()',        newProjectMjs.includes("'event'") || newProjectMjs.includes(', event,'));
+check('new-project.mjs copies mix_audio_pro.py', newProjectMjs.includes("'scripts/mix_audio_pro.py'"));
+check('new-project.mjs npm run mix uses pro',   newProjectMjs.includes('mix_audio_pro.py') && newProjectMjs.includes("'mix'"));
 
 // ── html-renderer engine assets ──────────────────────────────────────────
 console.log('\n=== html-renderer engine assets ===');
@@ -362,7 +367,7 @@ check('cf-worker has checkRateLimit',   cfWorker.includes('checkRateLimit'));
 check('cf-worker hashes token (SHA-256)', cfWorker.includes('SHA-256'));
 check('cf-worker uses RATE_LIMITS KV',  cfWorker.includes('env.RATE_LIMITS'));
 check('cf-worker returns 429 on limit', cfWorker.includes('429'));
-check('cf-worker version 2.7.2',         cfWorker.includes("'2.7.2'"));
+check('cf-worker version 2.7.3',         cfWorker.includes("'2.7.3'"));
 check('wrangler.toml has kv_namespaces',fs.readFileSync('./cloudflare-mcp/wrangler.toml','utf8').includes('kv_namespaces'));
 
 // ── plugins/skills present ────────────────────────────────────────────────

package/scripts/html-renderer/new-project.mjs

@@ -133,7 +133,7 @@ const editLines = [
   ` * If a layer is only active until t=X, it must explicitly hide itself after t=X.`,
   ` */`,
   ``,
-  `import { reel, layer, text, wallCard, stamp, at, stagger, captions, cue, codeCard, terminal, imageCard, chip } from './reel/engine.js';`,
+  `import { reel, layer, text, wallCard, stamp, at, stagger, captions, cue, event, codeCard, terminal, imageCard, chip, beatAt, snapToBeat, OM, ROOM_SFX, seg } from './reel/engine.js';`,
   ``,
   `// ── Compositor config ────────────────────────────────────────────────────────`,
   `reel({`,
@@ -303,6 +303,7 @@ copyAsset('scripts/encode.mjs',       'scripts/encode.mjs');
 copyAsset('scripts/look.mjs',         'scripts/look.mjs');
 copyAsset('scripts/storyboard-validator.mjs', 'scripts/storyboard-validator.mjs');
 copyAsset('scripts/mix_audio.py',     'scripts/mix_audio.py');
+copyAsset('scripts/mix_audio_pro.py', 'scripts/mix_audio_pro.py');
 copyAsset('scripts/verify.py',        'scripts/verify.py');
 copyAsset('scripts/transcribe.py',    'scripts/transcribe.py');
 copyAsset('scripts/capture.mjs',      'scripts/capture.mjs');
@@ -335,7 +336,8 @@ const pkg = {
     'render:crop':         'node scripts/render.mjs crop 9:16',
     'render:full':         'node scripts/render.mjs full',
     'render:mux':          'node scripts/render.mjs mux',
-    'mix':                 'uv run scripts/mix_audio.py',
+    'mix':                 'uv run scripts/mix_audio_pro.py',
+    'mix:basic':           'uv run scripts/mix_audio.py',
     'transcribe':          'uv run scripts/transcribe.py',
     'verify':              'uv run scripts/verify.py',
     'capture':             'node scripts/capture.mjs',
@@ -397,7 +399,9 @@ console.log(`  2. Edit STORYBOARD.md:      fill in shots, events, reads, transit
 console.log(`  3. Validate storyboard:     node scripts/storyboard-validator.mjs STORYBOARD.md`);
 console.log(`  4. Pre-flight check:        node scripts/look.mjs`);
 console.log(`  5. Check visuals:           node scripts/render.mjs sheet`);
-console.log(`  6. Mix audio (TTS):         uv run scripts/mix_audio.py`);
+console.log(`  6. Mix audio (TTS):         uv run scripts/mix_audio_pro.py`);
+console.log(`     Professional chain:      uv run scripts/mix_audio_pro.py --room broadcast --platform youtube`);
+console.log(`     With sfx-events.json:    uv run scripts/mix_audio_pro.py --sfx-events`);
 console.log(`  7. Full render:             node scripts/render.mjs full`);
 console.log(`  8. Verify quality gates:    uv run scripts/verify.py\n`);
 

package/src/mcp-server/server.js

@@ -2120,7 +2120,7 @@ Professional audio rules applied:
       planMd += `- L-cuts: current audio extends 0.3s into next clip's video\n\n`;
       planMd += `## 🚀 Execution & Approval\n\n`;
       planMd += `Review this plan, then execute with \`edit_video\` using the payload in \`edit.json\`.\n`;
-      planMd += `\nGenerated by FrameForge v2.7.2 — plan_video_edit with J/L-cut support (lemo-opuscar DIRECTOR.md)\n`;
+      planMd += `\nGenerated by FrameForge v2.7.3 — plan_video_edit with J/L-cut support (lemo-opuscar DIRECTOR.md)\n`;
 
       // 8. Build TREATMENT.md (lemo-opuscar DIRECTOR.md — 8-section format)
       let treatmentMd = '';
@@ -2161,7 +2161,7 @@ Professional audio rules applied:
         treatmentMd += `## 8. Director Notes\n\n`;
         treatmentMd += `_Add creative direction, mood references, or client notes here._\n\n`;
         treatmentMd += `---\n\n`;
-        treatmentMd += `*Generated by FrameForge v2.7.2 — lemo-opuscar DIRECTOR.md format*\n`;
+        treatmentMd += `*Generated by FrameForge v2.7.3 — lemo-opuscar DIRECTOR.md format*\n`;
       }
 
       // 9. Write outputs
@@ -2242,7 +2242,7 @@ Professional audio rules applied:
     handler: async () => {
       const syncFs = require('fs');
       const { MANIFEST_PATH, REPOSITORIES } = require('../skills/sync-upstream');
-      let manifest = { lastSync: null, repos: {}, version: '2.7.2', pendingUpdates: [] };
+      let manifest = { lastSync: null, repos: {}, version: '2.7.3', pendingUpdates: [] };
       if (syncFs.existsSync(MANIFEST_PATH)) {
         try { manifest = JSON.parse(syncFs.readFileSync(MANIFEST_PATH, 'utf8')); } catch (_) {}
       }
@@ -2289,7 +2289,7 @@ Professional audio rules applied:
       return {
         success: true,
         lastSync: manifest.lastSync,
-        manifestVersion: manifest.version || '2.7.2',
+        manifestVersion: manifest.version || '2.7.3',
         totalRepos: repos.length,
         syncedCount,
         pendingUpdates,
@@ -2820,7 +2820,7 @@ Outputs broadcast-ready 48kHz/192k AAC stereo.`,
 
 const SERVER_INFO = {
   name:    'video-pipeline',
-  version: '2.7.2',
+  version: '2.7.3',
 };
 
 const CAPABILITIES = {

package/src/skills/sync-upstream.js

@@ -105,7 +105,7 @@ function fetchJson(url) {
   return new Promise((resolve, reject) => {
     const opts = {
       headers: {
-        'User-Agent': 'FrameForge-Skill-Sync/2.7.2',
+        'User-Agent': 'FrameForge-Skill-Sync/2.7.3',
         'Accept': 'application/vnd.github.v3+json',
       },
     };
@@ -176,7 +176,7 @@ async function syncSkills(opts = {}) {
   const updatedResults = results.filter(r => r.updated);
 
   manifest.lastSync = new Date().toISOString();
-  manifest.version = '2.7.2';
+  manifest.version = '2.7.3';
   manifest.updatedCount = updatedCount;
   if (updatedResults.length > 0) {
     manifest.pendingUpdates = updatedResults.map(r => {
@@ -266,7 +266,7 @@ function getUpstreamSummary() {
   return {
     repoCount,
     lastSync: manifest.lastSync,
-    version: manifest.version || '2.7.2',
+    version: manifest.version || '2.7.3',
     pendingUpdates: pending,
     hasUpdates: pending.length > 0,
     repos: manifest.repos || {},