@amg555/frameforge-mcp 2.4.5 → 2.4.7

package/CHANGELOG.md

@@ -4,6 +4,31 @@ All notable changes to FrameForge are documented here.
 
 ---
 
+## [2.4.6] — 2026-11-10
+
+### Enhanced
+- **High-Quality Volumetric 2D Character Anatomy (`src/video-renderer/scene-animator.js`)**:
+  - Replaced all single-stroke stick limbs with solid anatomical contoured polygons:
+    - Contoured muscular thighs (quadriceps curve), articulated knee joints, gastrocnemius calf curves, and realistic ankles.
+    - Solid contoured upper arms and forearms tapering to wrists; fully articulated hands with solid palms, opposable thumbs, and 4 individual fingers for each pose (`natural`, `dress_shirt`, `hold_spear`, `sewing`, `thinker`, `peace_gesture`, `shiver`, `cover_body`).
+    - Anatomical head contour with cranium dome, temples, cheekbones, sculpted jawline, chin, and ears with antihelix and lobe.
+    - Almond eyes with sclera, colored iris, pupil, specular catchlights, eyelid crease, and blinking animation over pure-$t$.
+    - Sculpted nose bridge and nostril curves; expressive lips with oral cavity and teeth line modulated by sine speech waves.
+    - Layered volumetric styled hair: modern textured pompadour/fade, or lush flowing prehistoric locks.
+    - Modern tailored suit jacket/blazer with notched lapels, shirt collar, silk tie, belt with polished buckle, trousers with center pressed crease, and leather oxford shoes.
+    - Prehistoric animal hide tunic with ragged deckle hem, rawhide stitching, and carved bone toggle buckle, or bare human body with natural skin contours and 5 distinct toes.
+- **Production-Grade Environmental Backdrops**:
+  - `doodle_dressing`: Hardwood herringbone parquet floor with individual planks and specular reflection sheen, architectural wainscoting trim, luxury dark walnut wardrobe closet with warm internal LED downlight, upper storage shelf, and 4 styled garments on wooden hangers, alongside an arched full-length brass mirror with crystal reflection.
+  - `doodle_modern_vs_prehistoric`: Split-screen comparison featuring a modern penthouse with twilight city skyline and illuminated skyscrapers on the left, an African savannah sunset with volcanic mountain ridges and flat-canopy acacia trees on the right, joined by a central glowing timeline rift (`300,000 BCE ───▶ PRESENT`).
+  - `doodle_shiver_cold`: Frigid Ice Age glacial valley with jagged snow-covered crags, wind-carved snow dunes, howling blizzard streaks, breath condensation plumes, and volumetric golden dawn sunbeams.
+  - `doodle_hunter_savannah`: Wide African savannah horizon under glowing sun with swaying golden grass stalks and flaked obsidian/flint spear.
+  - `doodle_sewing_needle`: Prehistoric cavern shelter with stone cave walls, ancient cave paintings, glowing campfire hearth with red embers, and high-precision inspection loupe showing extreme close-up of drilled ivory bone needle and sinew stitching.
+  - `doodle_shame_reflection`: Tranquil forest pool with mossy river rocks, water ripples, mirrored reflection, and radiant cognitive awareness halo.
+  - `doodle_tribe_meeting`: Misty valley with monolithic standing stones, two tribal figures meeting in peace, and glowing golden connection arc.
+  - `doodle_thinking_future`: Primeval starlit night sky with crescent moon, granite boulder, and luminous thought constellation.
+
+---
+
 ## [2.4.5] — 2026-11-10
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amg555/frameforge-mcp",
-  "version": "2.4.5",
+  "version": "2.4.7",
   "description": "FrameForge — AI video production engine for agentic IDEs. npx @amg555/frameforge-mcp. FFmpeg + TTS run on your machine. 21 MCP tools.",
   "publishConfig": {
     "access": "public"
@@ -31,7 +31,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/scene-animator.test.js src/video-renderer/renderer.test.js src/video-editor/editor.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/workflows/ingest.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 src/video-editor/editor.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/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.4.5',   code.includes("version: '2.4.5'"));
+check('SERVER_INFO version 2.4.7',   code.includes("version: '2.4.7'"));
 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'));
@@ -299,7 +299,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.4.5',        cfWorker.includes("'2.4.5'"));
+check('cf-worker version 2.4.7',        cfWorker.includes("'2.4.7'"));
 check('wrangler.toml has kv_namespaces',fs.readFileSync('./cloudflare-mcp/wrangler.toml','utf8').includes('kv_namespaces'));
 
 // ── plugins/skills present ────────────────────────────────────────────────

package/src/cli/make.js

@@ -354,21 +354,36 @@ async function runSingleVideo(args, topic, outDir, workflows) {
     }
   }
 
-  // ── Script file bypass (--script-file): skip research, load approved JSON ──
+  // ── Script file bypass (--script-file): skip research, load approved JSON or Markdown ──
   if (args.scriptFile && !scenes) {
     logSection('Loading Approved Script');
     const absScript = path.resolve(process.cwd(), args.scriptFile);
     if (!fs.existsSync(absScript)) throw new Error(`Script file not found: ${absScript}`);
-    const raw = JSON.parse(fs.readFileSync(absScript, 'utf8'));
-    const scriptData = raw.script || raw;
-    scenes      = scriptData.scenes;
-    productionId = scriptData.productionId || raw.productionId || `script_${Date.now()}`;
-    title       = scriptData.title || topic || 'Video';
-    description = scriptData.description || '';
-    tags        = scriptData.tags || [];
-    thumbnailPrompt = scriptData.thumbnailPrompt || null;
-    totalWords  = scriptData.totalWords || scenes?.reduce((n, s) => n + (s.narration || '').split(/\s+/).filter(Boolean).length, 0) || 0;
-    log('Script', `✅  Loaded ${scenes?.length} scenes from: ${absScript}`);
+    const content = fs.readFileSync(absScript, 'utf8');
+
+    if (/\.(md|markdown)$/i.test(absScript) || (!content.trim().startsWith('{') && !content.trim().startsWith('['))) {
+      const { parseMarkdownScript } = require('../workflows/ingest');
+      const parsedMd = parseMarkdownScript(content);
+      scenes = parsedMd.scenes;
+      productionId = `script_${Date.now()}`;
+      title = parsedMd.title || topic || 'Video';
+      description = '';
+      tags = [];
+      thumbnailPrompt = null;
+      totalWords = scenes?.reduce((n, s) => n + (s.narration || '').split(/\s+/).filter(Boolean).length, 0) || 0;
+      log('Script', `✅  Parsed ${scenes?.length} scenes from Markdown: ${absScript}`);
+    } else {
+      const raw = JSON.parse(content);
+      const scriptData = raw.script || raw;
+      scenes      = scriptData.scenes;
+      productionId = scriptData.productionId || raw.productionId || `script_${Date.now()}`;
+      title       = scriptData.title || topic || 'Video';
+      description = scriptData.description || '';
+      tags        = scriptData.tags || [];
+      thumbnailPrompt = scriptData.thumbnailPrompt || null;
+      totalWords  = scriptData.totalWords || scenes?.reduce((n, s) => n + (s.narration || '').split(/\s+/).filter(Boolean).length, 0) || 0;
+      log('Script', `✅  Loaded ${scenes?.length} scenes from: ${absScript}`);
+    }
 
     if (args.dryRun) {
       logSection('Dry Run Complete');

package/src/mcp-server/server.js

@@ -355,9 +355,10 @@ const TOOLS = {
         theme:        { type: 'string',  description: 'Theme preset alias' },
         title:        { type: 'string',  description: 'Video title' },
         language:     { type: 'string',  description: 'BCP-47 language hint (e.g. ml, hi, en, ta)' },
+        showCaptions: { type: 'boolean', default: false, description: 'Display on-screen synchronized subtitles/captions. Default false.' },
       },
     },
-    handler: async ({ productionId, scenes, orientation = 'landscape', skipImages = false, skipTts = false, withMusic = true, musicVolume = 0.07, topic = '', style = '', theme = '', title = '', language = '' }) => {
+    handler: async ({ productionId, scenes, orientation = 'landscape', skipImages = false, skipTts = false, withMusic = true, musicVolume = 0.07, topic = '', style = '', theme = '', title = '', language = '', showCaptions = false }) => {
       const syncFs = require('fs');
       const { runAssets }   = require('../workflows/assets');
       const { runRender }   = require('../workflows/render');
@@ -641,6 +642,9 @@ Example scene:
         style:              s.style              || style || '',
         theme:              s.theme              || theme || '',
         language:           s.language           || language || '',
+        duration:           s.duration != null ? Number(s.duration) : null,
+        start_time:         s.start_time != null ? Number(s.start_time) : (s.startTime != null ? Number(s.startTime) : null),
+        end_time:           s.end_time != null ? Number(s.end_time) : (s.endTime != null ? Number(s.endTime) : null),
         character:          s.character          || { character_id: 'none', pose: 'none', emotion: 'neutral', position: { x: 0.5, y: 0.8, scale: 1.0 } },
         focal_point:        s.focal_point        || { x: 0.5, y: 0.35, weight: 0.8 },
         overlay:            s.overlay            || { type: 'none' },
@@ -1637,7 +1641,7 @@ Allows the agent in Claude Code, Cursor, or any IDE to inspect the visual output
 
 const SERVER_INFO = {
   name:    'video-pipeline',
-  version: '2.4.5',
+  version: '2.4.7',
 };
 
 const CAPABILITIES = {

package/src/video-renderer/renderer.js

@@ -167,16 +167,15 @@ class VideoRenderer {
     startTime = 0,
     trimStart,
     endTime,
+    duration = null,
     trimEnd,
     speed = 1.0,
     clipVolume = 0,
     colorGrade = null,
     showCaptions = false,
   } = {}) {
-    const { detectCaptionsRequested } = require('./scene-animator');
     const effectiveShowCaptions = Boolean(
       showCaptions ||
-      detectCaptionsRequested(`${caption} ${narration} ${topic} ${style} ${visualDescription}`) ||
       process.env.FRAMEFORGE_SHOW_CAPTIONS === '1'
     );
     const outputPath = path.join(this.vdir, `scene_${sceneIndex}_out.mp4`);
@@ -189,12 +188,13 @@ class VideoRenderer {
 
     fs.mkdirSync(this.vdir, { recursive: true });
 
-    // Duration from voice file.
+    // Duration from voice file or explicit scene duration.
     if (!voicePath || !fs.existsSync(voicePath)) {
       throw new Error(`Scene ${sceneIndex} render failed: voicePath is missing or does not exist (${voicePath})`);
     }
-    const dur        = this._getAudioDuration(voicePath);
-    const clampedDur = Math.max(2, Number.isFinite(dur) ? dur + 0.15 : 3.15);
+    const voiceDur   = this._getAudioDuration(voicePath);
+    const dur        = (typeof duration === 'number' && duration > 0) ? Math.max(duration, voiceDur) : voiceDur;
+    const clampedDur = Math.max(1, Number.isFinite(dur) ? dur + 0.15 : 3.15);
 
     const isVideoInput = Boolean(videoPath) || (videoPath && /\.(mp4|mov|webm|mkv|m4v)$/i.test(videoPath));