@amg555/frameforge-mcp 2.4.4 → 2.4.6

package/CHANGELOG.md

@@ -4,6 +4,55 @@ 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
+- **Browser Code Animation Dispatch in `src/video-renderer/renderer.js`**:
+  - Fixed `ReferenceError: camera is not defined` inside `_renderCodeAnimationScene`. Previously, missing parameter destructuring caused the browser animation engine to throw on every scene, silently falling back to static FFmpeg image slideshows.
+  - Added full pass-through of `camera`, `visualType`, and `focalPoint` into `_renderCodeAnimationScene`.
+- **Manifest Ingest Preservation (`src/workflows/ingest.js`, `src/workflows/assets.js`)**:
+  - `normaliseIngestScene` now retains `prompt`, `style`, and `theme`, and falls back to `raw.prompt` for `visual_description`.
+  - Added `--theme` and `--aesthetic` CLI options to `src/cli/make.js`.
+
+### Enhanced
+- **Audio-Driven Continuous Camera Director (`src/video-renderer/scene-animator.js`)**:
+  - Replaced hardcoded timer modulo cuts with continuous trajectory over `p = t / window.DURATION`.
+  - Camera movements (`slow_zoom_in`, `slow_zoom_out`, `pan_left`, `pan_right`, `tilt_up`, `tilt_down`, `ken_burns`, `static`, and `auto`) now smoothly scale to exact narration length.
+- **Max-Quality Organic Doodle Anatomy (`src/video-renderer/scene-animator.js`)**:
+  - Overhauled `drawDoodleCharacter`: replaced straight vertical spine line with contoured human torso (shoulders, ribcage, waist, hips), clavicle accents, articulated knees, and planted feet.
+  - Removed forced ground drop shadows, forced rosy cheek blush, and forced specular eye highlights.
+- **Light Parchment Hand-Drawn Inking Aesthetic (`hand_drawn_doodle`)**:
+  - Warm parchment paper backgrounds (`#faf7f2`, `#f6f1e8`, `#fdfbf7`) with dark charcoal inking (`#1c1917`), subtle line grain, and organic 12fps line boil.
+  - Removed all unwanted text stamps and banners (`NOT FOR COLD`, `THEORY OF MIND`, etc.) from narrative doodle themes.
+  - Added `doodle_modern_vs_prehistoric` split-screen comparison theme.
+
+---
+
 ## [2.4.4] — 2026-11-09
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amg555/frameforge-mcp",
-  "version": "2.4.4",
+  "version": "2.4.6",
   "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"

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

package/src/cli/make.js

@@ -98,6 +98,7 @@ function parseArgs(argv) {
     mode: 'full-auto',
     topic: '', topicsFile: '', language: 'en',
     style: 'educational comedy', channels: ['file'],
+    theme: '',
     orientation: 'landscape',
     captions: false, subtitles: false,
     scenesFile: '', scriptFile: '', mediaDir: '',
@@ -120,6 +121,8 @@ function parseArgs(argv) {
       case '--subtitles':
       case '--with-captions': args.captions = true; break;
       case '--style':         args.style       = argv[++i] || args.style; break;
+      case '--theme':
+      case '--aesthetic':     args.theme       = argv[++i] || ''; break;
       case '--channels':      args.channels    = (argv[++i] || 'file').split(',').map(s => s.trim()); break;
       case '--no-research':   args.noResearch  = true; break;
       case '--no-script':     args.noScript    = true; break;
@@ -423,6 +426,7 @@ async function runSingleVideo(args, topic, outDir, workflows) {
     topic,
     title,
     style: args.style || '',
+    theme: args.theme || '',
     language: args.language,
     voice: resolvedVoice,
   });
@@ -439,6 +443,7 @@ async function runSingleVideo(args, topic, outDir, workflows) {
     topic,
     title,
     style: args.style || '',
+    theme: args.theme || '',
     language: args.language,
     showCaptions: Boolean(args.captions || args.subtitles),
     renderWidth,

package/src/mcp-server/server.js

@@ -1637,7 +1637,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.4',
+  version: '2.4.6',
 };
 
 const CAPABILITIES = {

package/src/video-renderer/renderer.js

@@ -278,11 +278,14 @@ class VideoRenderer {
           caption,
           narration,
           visualDescription,
+          visualType,
           topic,
           style,
           theme,
           title,
           language,
+          camera,
+          focalPoint,
           html,
           code,
           clampedDur,
@@ -360,11 +363,14 @@ class VideoRenderer {
     caption,
     narration,
     visualDescription,
+    visualType = 'code_animation',
     topic = '',
     style = '',
     theme = '',
     title = '',
     language = '',
+    camera = 'auto',
+    focalPoint = null,
     html = null,
     code = null,
     clampedDur,
@@ -393,6 +399,7 @@ class VideoRenderer {
         topic,
       });
     } else {
+      const effectiveCam = camera || selectCameraHint(sceneIndex, focalPoint || {});
       htmlContent = generateSceneHtml({
         caption,
         narration,
@@ -409,6 +416,8 @@ class VideoRenderer {
         sceneIndex,
         musicMood,
         showCaptions,
+        camera: effectiveCam,
+        cameraHint: effectiveCam,
       });
     }