@amg555/frameforge-mcp 2.3.3 → 2.3.4

package/CHANGELOG.md

@@ -4,6 +4,29 @@ All notable changes to FrameForge are documented here.
 
 ---
 
+## [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,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.3.3-blue.svg)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-2.3.4-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)
 
@@ -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.4",
   "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"

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/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.4',   code.includes("version: '2.3.4'"));
 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.4',        cfWorker.includes("'2.3.4'"));
 check('wrangler.toml has kv_namespaces',fs.readFileSync('./cloudflare-mcp/wrangler.toml','utf8').includes('kv_namespaces'));
 
 // ── plugins/skills present ────────────────────────────────────────────────

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/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.4',
 };
 
 const CAPABILITIES = {