@amg555/frameforge-mcp 2.3.3 → 2.3.5

package/CHANGELOG.md

@@ -4,6 +4,50 @@ All notable changes to FrameForge are documented here.
 
 ---
 
+## [2.3.5] — 2026-11-09
+
+### Added
+- **Integrated Code-Driven Scene Animator** (`src/video-renderer/scene-animator.js`):
+  - Dynamic 24fps HTML5/Canvas animation generator adhering to pure-function-of-time contract `seek(t)`
+  - Contextual motion graphic themes: Code IDE/terminal typing, Data charts & counters, Network node graphs, Flow diagrams, and floating Ken-Burns image cards
+  - Dynamic gradient backgrounds with ambient particle systems and perspective motion grids
+  - High-performance Chromium harness rendering + direct FFmpeg BT.709 H.264 VUI muxing
+- **Full Multilingual & Malayalam Font Support**:
+  - Direct font resolver for Malayalam & Indic scripts (`Nirmala.ttc`, `Noto Sans Malayalam`, `Malayalam Sangam MN`, `Kartika`, `Meera`, `Manjari`)
+  - FFmpeg `text_shaping=1` HarfBuzz layout integration preserving complex conjuncts, chillu letters, and viramas
+  - Unicode-safe slicing and UTF-8 handling in caption and narration filters
+  - Updated `engine.css`, `engine.js`, and `new-project.mjs` typography stacks for seamless multilingual rendering
+
+### Fixed
+- Replaced static solid-color slideshow fallback in `renderer.js` with live code-driven animation engine
+- Fixed `--flag value` space-separated argument parsing in `harness.mjs` CLI
+- Fixed `--out` directory path resolution in `cmdFrames` frame exporter
+
+---
+
+## [2.3.4] — 2026-11-09
+
+### Added
+- **Full Code-Driven Video Production Harness** (`src/harness/`, `bin/harness.mjs`, `npx frameforge-harness`):
+  - H1 Browser resolution & GPU auto-selection (Direct3D11 / Metal / ANGLE)
+  - H2 Deterministic frame stepper & virtual clock injection
+  - H3 Resumable atomic frame worker pool (`.tmp` + `renameSync`, <1000B corruption checks)
+  - H4 Visual review generators: contact sheets, motion strips, 9:16 mobile crop previews
+  - H5 3-point history-leak & frame purity verification gate ($a === b \land a === c$) with `frames_sha256` digest
+  - H6 Pixel luminance and blind-spot frame math (blank, blown, corner-confined detection)
+  - H7 Determinism primitives in `engine.js` (`boilSeed`, `kf`, `onTwos`, `seg`, `pulse`, `shots`)
+  - H8 Broadcast-grade BT.709 color encoding & x264 VUI parameter tags
+  - H9 Unified CLI commands (`doctor`, `storyboard`, `verify`, `sheet`, `strip`, `crop`, `pixels`, `frames`, `encode`, `all`)
+- **MCP `render_animation` parity**: added `verify`, `doctor`, `pixels` modes and structured `purityReport` return object.
+- **VoxForge**: added `VOXFORGE_URL` detection to system doctor and documented in all provider tables.
+
+### Fixed
+- Fixed relative module imports in scaffolded projects (`./browser.mjs`, etc.).
+- Enforced BT.709 color tags across all procedural scene fallbacks in `renderer.js`.
+- Included `plugins/` skill templates and assets in npm package distribution.
+
+---
+
 ## [2.3.2] — 2026-11-06
 
 ### Added

package/README.md

@@ -9,9 +9,9 @@
 [![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.3.3-blue.svg)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-2.3.5-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-512%20passing-brightgreen.svg)](#testing)
+[![Tests](https://img.shields.io/badge/tests-539%20passing-brightgreen.svg)](#testing)
 
 </div>
 
@@ -219,6 +219,7 @@ Switch any provider with one `.env` change — no code changes.
 | Provider | Free? | Key needed |
 |----------|-------|------------|
 | `edge-tts` | ✅ free, offline | none — **default** |
+| `voxforge` | ✅ free, local/private | none — `VOXFORGE_URL` ([VoxForge](https://github.com/AMG555/VoxForge)) |
 | `elevenlabs` | paid | `ELEVENLABS_API_KEY` |
 | `azure` | paid | `AZURE_SPEECH_KEY` + `AZURE_SPEECH_REGION` |
 | `openai` | paid | `OPENAI_API_KEY` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amg555/frameforge-mcp",
-  "version": "2.3.3",
+  "version": "2.3.5",
   "description": "FrameForge — AI video production engine for agentic IDEs. npx @amg555/frameforge-mcp. FFmpeg + TTS run on your machine. 17 MCP tools.",
   "publishConfig": {
     "access": "public"
@@ -30,7 +30,7 @@
     "start:local-render": "cross-env RENDER_MODE=full WORKER_PORT=3211 node src/worker/server-render-free.js",
     "db:migrate": "node scripts/db-migrate.js",
     "validate": "node scripts/deep-validate.js",
-    "test": "node --test src/pipeline/retry-policy.test.js src/pipeline/telemetry.test.js src/pipeline/artifact-manifest.test.js src/pipeline/artifact-retention.test.js src/pipeline/external-adapter.test.js src/workflows/publishing.test.js src/workflows/script.test.js src/animation/animation-system.test.js src/fact-checker/review-gate.test.js src/fact-checker/checker.test.js src/utils/log-redaction.test.js src/worker/server-render-free.test.js src/worker/server.test.js src/mcp-server/server.test.js src/quality-gate/gate.test.js src/shorts-extractor/extractor.test.js src/audio-mixer/mixer.test.js src/video-renderer/renderer.test.js plugins/video-pipeline/skills/video-pipeline/assets/project/reel/engine.test.js src/harness/lib/pixels.test.js src/harness/lib/verify-purity.test.js src/harness/harness.test.js src/integration.test.js",
+    "test": "node --test src/pipeline/retry-policy.test.js src/pipeline/telemetry.test.js src/pipeline/artifact-manifest.test.js src/pipeline/artifact-retention.test.js src/pipeline/external-adapter.test.js src/workflows/publishing.test.js src/workflows/script.test.js src/animation/animation-system.test.js src/fact-checker/review-gate.test.js src/fact-checker/checker.test.js src/utils/log-redaction.test.js src/worker/server-render-free.test.js src/worker/server.test.js src/mcp-server/server.test.js src/quality-gate/gate.test.js src/shorts-extractor/extractor.test.js src/audio-mixer/mixer.test.js src/video-renderer/scene-animator.test.js src/video-renderer/renderer.test.js plugins/video-pipeline/skills/video-pipeline/assets/project/reel/engine.test.js src/harness/lib/pixels.test.js src/harness/lib/verify-purity.test.js src/harness/harness.test.js src/integration.test.js",
     "lint": "echo 'No linter configured — add eslint for production'",
     "check-credentials": "node src/utils/log-redaction.js",
     "generate-assets": "node scripts/generate-initial-assets.js",

package/plugins/video-pipeline/skills/video-pipeline/SKILL.md

@@ -41,7 +41,7 @@ IDE Agent (IBM Bob / Codex / opencode / Cursor / Windsurf / Claude Code)
     │  LLM provider:   PROVIDER_LLM=groq|openrouter|anthropic|gemini
     │                              |mistral|together|cerebras|openai
     │                              |ollama|webhook
-    │  TTS provider:   PROVIDER_TTS=edge-tts|elevenlabs|azure|openai|webhook
+    │  TTS provider:   PROVIDER_TTS=edge-tts|voxforge|elevenlabs|azure|openai|webhook
     │  Visuals:        Code-driven animations (default) + user media (video_path / image_path)
     │
     ▼  Optional: queue_full_pipeline

package/plugins/video-pipeline/skills/video-pipeline/assets/project/reel/engine.css

@@ -21,9 +21,9 @@
   --danger:    #ef4444;
 
   /* Typography scale */
-  --font-body:    -apple-system, "Segoe UI", system-ui, sans-serif;
+  --font-body:    -apple-system, "Segoe UI", "Nirmala UI", "Noto Sans Malayalam", "Malayalam Sangam MN", "Kartika", "Meera", "Manjari", system-ui, sans-serif;
   --font-mono:    "Fira Code", "Cascadia Code", "Consolas", monospace;
-  --font-display: "Archivo", "Segoe UI", system-ui, sans-serif;
+  --font-display: "Archivo", "Nirmala UI", "Noto Sans Malayalam", "Malayalam Sangam MN", "Kartika", "Meera", "Manjari", -apple-system, "Segoe UI", system-ui, sans-serif;
 
   /* Spacing */
   --gap-sm:  8px;

package/plugins/video-pipeline/skills/video-pipeline/assets/project/reel/engine.js

@@ -331,7 +331,7 @@ export function shots(shotList = []) {
  * @param {{ font, color, x, y, size, weight, align, opacity, duration }} opts
  */
 export function text(str, {
-  font     = '48px/1.3 system-ui',
+  font     = '48px/1.3 "Nirmala UI", "Noto Sans Malayalam", "Malayalam Sangam MN", "Kartika", system-ui, sans-serif',
   color    = '#ffffff',
   x        = 'center',
   y        = 100,

package/plugins/video-pipeline/skills/video-pipeline/references/providers.md

@@ -52,6 +52,17 @@ PROVIDER_TTS=edge-tts
 # Voice list: edge-tts --list-voices
 ```
 
+### voxforge (free, private multi-engine neural TTS & voice cloning in Rust)
+```bash
+PROVIDER_TTS=voxforge
+VOXFORGE_URL=http://localhost:5005   # or your self-hosted VoxForge workstation URL
+# Optional:
+VOXFORGE_KEY=...                     # optional auth token if enabled
+VOXFORGE_VOICE=default               # voice/clone reference
+VOXFORGE_MODEL=voxforge-v1           # engine model (XTTS, Piper, Kokoro, Whisper)
+```
+Repo: [AMG555/VoxForge](https://github.com/AMG555/VoxForge) — local, private neural TTS & voice cloning workstation.
+
 ### elevenlabs (voice cloning)
 ```bash
 PROVIDER_TTS=elevenlabs

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.3.3',   code.includes("version: '2.3.3'"));
+check('SERVER_INFO version 2.3.5',   code.includes("version: '2.3.5'"));
 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('voxforge TTS provider', code.includes('voxforge'));
@@ -293,7 +293,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.3.3',        cfWorker.includes("'2.3.3'"));
+check('cf-worker version 2.3.5',        cfWorker.includes("'2.3.5'"));
 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

@@ -97,7 +97,7 @@ const indexHtml = `<!DOCTYPE html>
   <!-- Preload primary typeface — must resolve before frame 0 (fonts.ready gate) -->
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link href="https://fonts.googleapis.com/css2?family=Archivo:ital,wght@0,100..900;1,100..900&display=swap" rel="stylesheet">
+  <link href="https://fonts.googleapis.com/css2?family=Archivo:ital,wght@0,100..900;1,100..900&family=Noto+Sans+Malayalam:wght@400;600;700;800;900&display=swap" rel="stylesheet">
   <link rel="stylesheet" href="reel/engine.css">
   <style>
     /* Project-level overrides — edit here */
@@ -105,7 +105,7 @@ const indexHtml = `<!DOCTYPE html>
       --primary: #ffffff;
       --accent:  #3b82f6;
       --bg:      #0d1117;
-      --font:    'Archivo', system-ui, sans-serif;
+      --font:    'Archivo', 'Nirmala UI', 'Noto Sans Malayalam', 'Malayalam Sangam MN', 'Kartika', system-ui, sans-serif;
     }
   </style>
 </head>

package/src/cli/doctor.js

@@ -73,19 +73,26 @@ if (ffprobe.status === 0) {
   hasCriticalFailure = true;
 }
 
-// 4. Voice Engine (edge-tts or Cloud API)
+// 4. Voice Engine (edge-tts, VoxForge, or Cloud API)
 const edgeTts = spawnSync('edge-tts', ['--version'], { encoding: 'utf8', timeout: 5000, shell: process.platform === 'win32' });
-const hasCloudTts = Boolean(process.env.ELEVENLABS_API_KEY || process.env.AZURE_SPEECH_KEY || process.env.OPENAI_API_KEY || process.env.CUSTOM_TTS_URL);
+const hasCloudTts = Boolean(
+  process.env.ELEVENLABS_API_KEY ||
+  process.env.AZURE_SPEECH_KEY ||
+  process.env.OPENAI_API_KEY ||
+  process.env.CUSTOM_TTS_URL ||
+  process.env.WEBHOOK_TTS_URL ||
+  process.env.VOXFORGE_URL
+);
 
 if (edgeTts.status === 0) {
   pass('Voice Engine', `edge-tts CLI available (${(edgeTts.stdout || '').trim()})`);
 } else if (hasCloudTts) {
-  pass('Voice Engine', 'Cloud TTS API configured via environment');
+  pass('Voice Engine', 'TTS provider (VoxForge or Cloud API) configured via environment');
 } else {
   warn(
     'Voice Engine',
-    'Neither edge-tts CLI nor cloud TTS API detected',
-    'Run "pip install edge-tts" for free offline voiceover, or set OPENAI_API_KEY / ELEVENLABS_API_KEY in .env'
+    'Neither edge-tts CLI nor configured TTS provider detected',
+    'Run "pip install edge-tts" for free offline voiceover, set VOXFORGE_URL (VoxForge), or set OPENAI_API_KEY / ELEVENLABS_API_KEY in .env'
   );
 }
 

package/src/harness/bin/harness.mjs

@@ -39,8 +39,19 @@ const extras = [];
 for (let i = 1; i < argv.length; i++) {
   const arg = argv[i];
   if (arg.startsWith('--')) {
-    const [k, v] = arg.slice(2).split('=');
-    flags[k] = v ?? true;
+    const eqIdx = arg.indexOf('=');
+    if (eqIdx !== -1) {
+      const k = arg.slice(2, eqIdx);
+      const v = arg.slice(eqIdx + 1);
+      flags[k] = v;
+    } else {
+      const k = arg.slice(2);
+      if (i + 1 < argv.length && !argv[i + 1].startsWith('--')) {
+        flags[k] = argv[++i];
+      } else {
+        flags[k] = true;
+      }
+    }
   } else {
     extras.push(arg);
   }
@@ -56,7 +67,7 @@ function resolveProjectFile(filename, fallback) {
 const HTML_FILE   = flags.html ? path.resolve(CWD, flags.html) : resolveProjectFile('index.html', resolveProjectFile('studio.html'));
 const OUT_DIR     = flags.outDir ? path.resolve(CWD, flags.outDir) : path.join(CWD, 'out');
 const CHECK_DIR   = path.join(OUT_DIR, 'check');
-const FRAMES_DIR  = path.join(OUT_DIR, 'frames');
+const FRAMES_DIR  = flags.frames ? path.resolve(CWD, flags.frames) : flags.out ? path.resolve(CWD, flags.out) : path.join(OUT_DIR, 'frames');
 const PURITY_LOG  = path.join(CHECK_DIR, 'purity_report.json');
 
 fs.mkdirSync(OUT_DIR, { recursive: true });
@@ -214,17 +225,19 @@ async function cmdFrames() {
   const fps = parseInt(flags.fps || '30', 10);
   const workers = parseInt(flags.workers || '4', 10);
   const duration = flags.duration ? parseFloat(flags.duration) : 2.0;
-  const totalFrames = Math.round(duration * fps);
+  const first = flags.first !== undefined ? parseInt(flags.first, 10) : 0;
+  const last = flags.last !== undefined ? parseInt(flags.last, 10) : (Math.round(duration * fps) - 1);
+  const totalFrames = last - first + 1;
 
-  console.log(`📦 Rendering Frame Range [0..${totalFrames - 1}] (${duration}s @ ${fps}fps, workers=${workers})`);
+  console.log(`📦 Rendering Frame Range [${first}..${last}] (${totalFrames} frames @ ${fps}fps, workers=${workers})`);
   const { browser } = await launchHarnessBrowser();
 
   const res = await renderFrameJobs({
     browser,
     htmlPath: HTML_FILE,
     framesDir: FRAMES_DIR,
-    first: 0,
-    last: totalFrames - 1,
+    first,
+    last,
     fps,
     workers,
     width: parseInt(flags.width || '1920', 10),

package/src/mcp-server/server.js

@@ -1372,7 +1372,7 @@ Operations (used with action="edit"):
 
 const SERVER_INFO = {
   name:    'video-pipeline',
-  version: '2.3.3',
+  version: '2.3.5',
 };
 
 const CAPABILITIES = {