@amg555/frameforge-mcp 2.7.3 → 2.7.7

package/src/video-renderer/scene-animator.js

@@ -204,7 +204,7 @@ function detectAesthetic({
   // Explicit override wins
   const explicit = (theme || style || '').toLowerCase().trim();
   if (AESTHETICS[explicit]) return explicit;
-  if (/doodle|sketch|hand[-\s]?drawn|drawing|white background|cream background|cartoon|illustration/i.test(explicit)) return 'hand_drawn_doodle';
+  if (/doodle|sketch|hand[-\s]?drawn|drawing|whiteboard|white background|cream background|cartoon|illustration|explainer|pencil/i.test(explicit)) return 'hand_drawn_doodle';
   if (/cyber|tech|code|ai|crypto|hacker|futur/i.test(explicit)) return 'cyber_tech';
   if (/doc|history|ancient|story|cinema|kerala|temple|culture/i.test(explicit)) return 'cinematic_documentary';
   if (/finan|market|stock|money|invest|crypto|business/i.test(explicit)) return 'finance_executive';
@@ -218,8 +218,8 @@ function detectAesthetic({
   // Keyword scan across all textual signals (English + Multilingual)
   const combined = `${topic} ${title} ${visualDescription} ${narration} ${caption} ${musicMood}`.toLowerCase();
 
-  // Hand-Drawn Doodle / Sketch / Cartoon
-  if (/(?:^|[^\w])(doodle|sketch|hand[-\s]?drawn|drawing|white background|cream background|paper|cartoon)(?:[^\w]|$)/.test(combined)
+  // Hand-Drawn Doodle / Sketch / Cartoon / Whiteboard Explainer
+  if (/(?:^|[^\w])(doodle|sketch|hand[-\s]?drawn|drawing|whiteboard|white background|cream background|paper|cartoon|explainer|pencil|chalkboard|marker)(?:[^\w]|$)/.test(combined)
       || /ഡൂഡിൽ|വര|വരച്ച|ചിത്രരചന|रेखाचित्र|कार्टून/.test(combined)) {
     return 'hand_drawn_doodle';
   }
@@ -267,6 +267,11 @@ function detectAesthetic({
   if (/(?:^|[^\w])(luxury|minimal|architect|premium|bespoke|couture|gallery|elegance|aesthetic|curated|pure)(?:[^\w]|$)/.test(combined)) {
     return 'minimal_luxury';
   }
+  // Warm Creative / Art / Lifestyle / Food / Travel / Personal
+  if (/(?:^|[^\w])(creative|art|design|lifestyle|food|cook|travel|personal|vlog|story|human|emotion|family|love|warmth|vibrant|colorful|paint|studio|craft|maker|passion|inspiration|community|culture|life|everyday|people)(?:[^\w]|$)/.test(combined)
+      || /creative|warm_creative/.test((theme || style || '').toLowerCase())) {
+    return 'warm_creative';
+  }
 
   // Fallback by music mood if available
   if (musicMood === 'energetic') return 'hype_sports';
@@ -274,6 +279,8 @@ function detectAesthetic({
   if (musicMood === 'dramatic') return 'cinematic_documentary';
   if (musicMood === 'calm') return 'nature_organic';
   if (musicMood === 'mysterious') return 'cosmic_space';
+  if (musicMood === 'uplifting' || musicMood === 'happy') return 'warm_creative';
+  if (musicMood === 'corporate' || musicMood === 'professional') return 'minimal_luxury';
 
   // Default to versatile cyber_tech for general modern explainers
   return 'cyber_tech';
@@ -712,6 +719,11 @@ function spring(t, delay = 0, tension = 180, friction = 14) {
 window.seek = async (t) => {
   ${code}
 };
+window.renderAt = async (t, mime = 'image/jpeg', q = 0.92) => {
+  await window.seek(t);
+  const c = document.getElementById('stage') || document.querySelector('canvas');
+  return c && typeof c.toDataURL === 'function' ? c.toDataURL(mime, q) : null;
+};
 </script>
 </body>
 </html>`;
@@ -2848,6 +2860,7 @@ function drawMainScene(t) {
       showShadow: true,
       seed: 760,
     });
+    ctx.restore();
 
   } else if (COMP_THEME === 'doodle_royal_status') {
     // Scene 16: Evolution of Clothing into Royal Mantles, Crowns & Social Status
@@ -3735,10 +3748,14 @@ function drawMainScene(t) {
     ctx.translate(-cx, -cy);
 
     // Primary Gear Train (Interlocking 3 gears)
+    // On dark backgrounds use accent-derived fills so gears are clearly visible.
     const gearSpeed = t * 1.4;
-    drawGear(cx - 150, cy, 140, 24, gearSpeed, IS_LIGHT ? '#e2e8f0' : '#1e293b', ACCENT);
-    drawGear(cx + 90, cy - 80, 105, 18, -gearSpeed * (24 / 18) + 0.17, IS_LIGHT ? '#cbd5e1' : '#334155', ACCENT2);
-    drawGear(cx + 175, cy + 95, 70, 12, gearSpeed * (24 / 12) + 0.25, IS_LIGHT ? '#94a3b8' : '#475569', '#10b981');
+    const gear1Fill = IS_LIGHT ? '#e2e8f0' : ACCENT;
+    const gear2Fill = IS_LIGHT ? '#cbd5e1' : ACCENT2;
+    const gear3Fill = IS_LIGHT ? '#94a3b8' : '#10b981';
+    drawGear(cx - 150, cy, 140, 24, gearSpeed, gear1Fill, IS_LIGHT ? '#64748b' : BG1);
+    drawGear(cx + 90, cy - 80, 105, 18, -gearSpeed * (24 / 18) + 0.17, gear2Fill, IS_LIGHT ? '#64748b' : BG2);
+    drawGear(cx + 175, cy + 95, 70, 12, gearSpeed * (24 / 12) + 0.25, gear3Fill, IS_LIGHT ? '#475569' : BG2);
 
     // Dynamic Kinematic Linkage / Piston
     const pistonCycle = t * 3.5;
@@ -4201,6 +4218,19 @@ function drawMainScene(t) {
     const boardX = cx - boardW / 2;
     const boardY = cy - boardH / 2;
 
+    // Derive display text from actual scene content
+    const boardTitle = CAPTION && CAPTION.trim().length > 0
+      ? CAPTION.trim().toUpperCase().slice(0, 40)
+      : (NARRATION && NARRATION.trim().length > 0
+        ? NARRATION.trim().split(/\s+/).slice(0, 5).join(' ').toUpperCase()
+        : TAG);
+    // Split narration into up to 3 concept segments for pillar descriptions
+    const narWords = NARRATION ? NARRATION.trim().split(/\s+/) : [];
+    const segLen = Math.ceil(narWords.length / 3) || 1;
+    const seg1 = narWords.slice(0, segLen).join(' ').slice(0, 28) || 'Core Concepts';
+    const seg2 = narWords.slice(segLen, segLen * 2).join(' ').slice(0, 28) || 'Key Dynamics';
+    const seg3 = narWords.slice(segLen * 2).join(' ').slice(0, 28) || 'Final Impact';
+
     ctx.save();
     const bScale = Math.min(1, Math.max(0, boardSpring));
     ctx.translate(cx, cy);
@@ -4225,7 +4255,7 @@ function drawMainScene(t) {
     ctx.font = '800 22px ' + FONT_DISPLAY;
     ctx.fillStyle = TEXT_MAIN;
     ctx.textAlign = 'left';
-    ctx.fillText('CORE PRINCIPLES & ARCHITECTURE', boardX + 48, boardY + 50);
+    ctx.fillText(boardTitle, boardX + 48, boardY + 50);
 
     // Live Status Badge
     ctx.fillStyle = 'rgba(16, 185, 129, 0.15)';
@@ -4234,13 +4264,13 @@ function drawMainScene(t) {
     ctx.fill();
     ctx.fillStyle = '#10b981';
     ctx.font = 'bold 13px ' + FONT_DISPLAY;
-    ctx.fillText('● SYSTEM ACTIVE', boardX + boardW - 146, boardY + 48);
+    ctx.fillText('● LIVE', boardX + boardW - 130, boardY + 48);
 
-    // 3 Structured Concept Pillars
+    // 3 Structured Concept Pillars — titles/descriptions derived from scene content
     const pillarData = [
-      { num: '01', title: 'FOUNDATION', desc: 'Core axioms & structure', icon: 'diamond', spr: p1Spring },
-      { num: '02', title: 'DYNAMICS', desc: 'Kinetic transformation', icon: 'gear', spr: p2Spring },
-      { num: '03', title: 'IMPACT', desc: 'Synthesized outcome', icon: 'star', spr: p3Spring },
+      { num: '01', title: 'CONCEPT', desc: seg1, icon: 'diamond', spr: p1Spring },
+      { num: '02', title: 'PROCESS', desc: seg2, icon: 'gear', spr: p2Spring },
+      { num: '03', title: 'RESULT', desc: seg3, icon: 'star', spr: p3Spring },
     ];
 
     const pillarW = (boardW - 128) / 3;
@@ -4305,13 +4335,14 @@ function drawMainScene(t) {
         sCircle(gfxX, gfxY, 8, 825, '#ffffff', 2, '#f59e0b');
       }
 
-      // Feature Check items
+      // Feature indicator dots (visual only — no hardcoded text)
       for (let ch = 0; ch < 3; ch++) {
         const itemY = pillarH - 85 + ch * 24;
         sCircle(28, itemY, 4, 830 + ch, ACCENT, 2, ACCENT);
-        ctx.fillStyle = TEXT_MAIN;
+        ctx.fillStyle = TEXT_MUTED;
         ctx.font = '500 13px ' + FONT_BODY;
-        ctx.fillText('Verification Key 0' + (ch + 1), 42, itemY + 4);
+        const dotLabels = ['Primary', 'Secondary', 'Tertiary'];
+        ctx.fillText(dotLabels[ch], 42, itemY + 4);
       }
 
       ctx.restore();
@@ -4415,6 +4446,10 @@ window.seek = async (t) => {
   drawMainScene(t);
   drawCinematicOverlay(t);
 };
+window.renderAt = async (t, mime = 'image/jpeg', q = 0.92) => {
+  await window.seek(t);
+  return canvas.toDataURL(mime, q);
+};
 </script>
 </body>
 </html>`;

package/src/workflows/assets.js

@@ -38,9 +38,9 @@ async function runAssets({
   showCaptions = false,
   showAnchor = false,
 }) {
-  const ttsGen    = new TTSProvider();
+  const ttsGen    = new TTSProvider({ language });
   const sm        = new StateMachine({ mode: 'file', stateDir: STATE_DIR });
-  const retryPol  = new RetryPolicy({ maxAttempts: 3, baseDelayMs: 8000 });
+  const retryPol  = new RetryPolicy({ maxAttempts: 3, baseDelayMs: 2000 });
   const telemetry = new Telemetry({ mode: 'file', logPath: `${FILES_DIR}/usage.ndjson` });
 
   await sm.init();
@@ -51,6 +51,14 @@ async function runAssets({
 
   await sm.startStage(productionId, 'Asset_Generation');
 
+  // ── Voice Consistency Lock ────────────────────────────────────────────────
+  // Resolve a single canonical narrator voice for the entire production so that
+  // individual scenes never accidentally switch voices mid-video (e.g. due to
+  // subtle character, punctuation, or script variations in scene narration).
+  // Scene-level overrides (scene.voice) are preserved for intentional multi-speaker dialogue.
+  const allNarrations = scenes.map(s => s.narration || '').filter(Boolean).join(' ');
+  const defaultProductionVoice = voice || ttsGen.selectNarratorVoice(null, allNarrations, language);
+
   const results = [];
 
   // Process scenes in batches of `parallelism`
@@ -101,13 +109,45 @@ async function runAssets({
         voicePath = null;
       } else {
         voicePath = path.join(VDIR, `voice_${idx}.m4a`);
-        const ttsVoice = scene.voice || voice || undefined;
+        // Locked to defaultProductionVoice across all scenes unless scene.voice is explicitly given
+        const ttsVoice = scene.voice || defaultProductionVoice;
+        // Pass per-scene language for best-fit voice selection (Unicode detection + BCP-47 hint)
+        const sceneLang = scene.language || language || '';
         await retryPol.executeStage('TTS', async () =>
-          ttsGen.synthesize({ text: scene.narration, voice: ttsVoice, outputPath: voicePath })
+          ttsGen.synthesize({ text: scene.narration, voice: ttsVoice, outputPath: voicePath, language: sceneLang })
         );
         await telemetry.track({ productionId, stage: 'TTS', provider: process.env.PROVIDER_TTS || 'edge-tts', operation: 'tts_synthesis', units: scene.narration.length });
       }
 
+      // Auto-inject SFX cues when none are provided, based on music mood and scene position.
+      // This adds a subtle transition sound at scene open (t=0.05) so the edit feels alive.
+      let sfxCues = Array.isArray(scene.sound_effects) ? scene.sound_effects
+                  : Array.isArray(scene.sfxCues)       ? scene.sfxCues : [];
+      if (sfxCues.length === 0) {
+        const mood = (scene.music_mood || 'neutral').toLowerCase();
+        const sceneIdx0 = scene.scene_id - 1;
+        // Only inject for non-video scenes (code-animation / image paths)
+        if (!scene.video_path) {
+          if (mood === 'energetic' || mood === 'hype') {
+            sfxCues = [{ name: 'whoosh', time: 0.05, volume: 0.18 }];
+          } else if (mood === 'dramatic' || mood === 'cinematic') {
+            // Every 3rd dramatic scene gets a deep_boom for emphasis
+            sfxCues = sceneIdx0 % 3 === 0
+              ? [{ name: 'deep_boom', time: 0.05, volume: 0.15 }]
+              : [{ name: 'transition', time: 0.05, volume: 0.12 }];
+          } else if (mood === 'tense' || mood === 'urgent') {
+            sfxCues = [{ name: 'impact', time: 0.05, volume: 0.20 }];
+          } else if (mood === 'uplifting' || mood === 'happy') {
+            sfxCues = [{ name: 'chime', time: 0.05, volume: 0.15 }];
+          } else if (mood === 'mysterious') {
+            sfxCues = [{ name: 'riser', time: 0.05, volume: 0.10 }];
+          } else {
+            // neutral / default: subtle swish at scene open
+            sfxCues = [{ name: 'swish', time: 0.05, volume: 0.10 }];
+          }
+        }
+      }
+
       return {
         sceneId:   scene.scene_id,
         imagePath,
@@ -136,10 +176,14 @@ async function runAssets({
         colorGrade: scene.color_grade || scene.colorGrade || null,
         showCaptions: scene.show_captions !== undefined ? scene.show_captions : (scene.showCaptions !== undefined ? scene.showCaptions : showCaptions),
         showAnchor:   scene.show_anchor !== undefined ? scene.show_anchor : (scene.showAnchor !== undefined ? scene.showAnchor : showAnchor),
+        sound_effects: sfxCues,
       };
     }));
     results.push(...batchResults);
-    if (i + parallelism < scenes.length) {
+    // Small inter-batch pause only for remote TTS APIs to avoid rate-limiting.
+    // edge-tts is a local subprocess — no pause needed.
+    const provider = (process.env.PROVIDER_TTS || 'edge-tts').toLowerCase();
+    if (i + parallelism < scenes.length && provider !== 'edge-tts') {
       await new Promise(r => setTimeout(r, 200));
     }
   }

package/src/workflows/render.js

@@ -83,6 +83,8 @@ async function runRender({
         colorGrade:        asset.colorGrade,
         showCaptions:      asset.showCaptions !== undefined ? asset.showCaptions : showCaptions,
         showAnchor:        asset.showAnchor !== undefined ? asset.showAnchor : showAnchor,
+        sfxCues:           Array.isArray(asset.sfxCues) ? asset.sfxCues
+                           : Array.isArray(asset.sound_effects) ? asset.sound_effects : [],
         renderWidth,
         renderHeight,
       });

package/src/workflows/script.js

@@ -102,7 +102,7 @@ async function runScript({
   persona      = 'narrator',
   format       = 'YouTube video',
   language     = 'en',
-  sceneCount   = 55,
+  sceneCount   = null,
   targetDuration = null,
   imageStyle   = 'clean flat illustration, white background, bold lines',
 }) {
@@ -121,8 +121,19 @@ async function runScript({
   const anchorWanted = detectAnchorRequested(topic);
   const effectivePersona = persona !== 'video host' ? persona : (anchorWanted ? 'video host' : 'narrator');
 
-  // Fast visual pacing: ≈ 2.5-3.2s per scene cut (never monolithic drags)
-  const targetScenes = targetDuration ? Math.max(8, Math.ceil(targetDuration / 2.8)) : Math.max(sceneCount, 55);
+  // Token-efficient dynamic scene count:
+  // Short-form/reels default to 6 scenes (~30-45s); explainers default to 10-12 scenes (~45-60s)
+  const isShortForm = /short|reel|tiktok|quick/i.test(format) || /short|reel|tiktok/i.test(topic) || (targetDuration && targetDuration <= 90);
+  let targetScenes;
+  if (targetDuration) {
+    targetScenes = Math.max(4, Math.ceil(targetDuration / 3.0));
+  } else if (typeof sceneCount === 'number' && sceneCount > 0) {
+    targetScenes = Math.max(3, sceneCount);
+  } else if (isShortForm) {
+    targetScenes = 6;
+  } else {
+    targetScenes = 12;
+  }
 
   const raw = await retryPol.executeStage('Script', async () => {
     const system = [