@amg555/frameforge-mcp 2.3.8 → 2.3.9

package/CHANGELOG.md

@@ -4,6 +4,16 @@ All notable changes to FrameForge are documented here.
 
 ---
 
+## [2.3.9] — 2026-11-09
+
+### Enhanced
+- **Code-Driven Animation Primitives (`src/video-renderer/scene-animator.js`)**:
+  - Expanded `wrapCodeInHarnessHtml` runtime environment with standard animation and easing helpers: `clamp`, `lerp`, `easeIn`, `easeOut`, `easeInOut`, and `boilSeed` (12fps hand-drawn wobble).
+  - Explicitly registered `html`, `code`, and `animation_code` in `src/schema/scene.schema.json` for first-class schema validation and tool discovery.
+  - Verified pure-function-of-time canvas code execution pipeline: scene code → Playwright virtual clock headless capture → FFmpeg BT.709 H.264/AAC MP4 encode.
+
+---
+
 ## [2.3.8] — 2026-11-09
 
 ### Fixed & Enhanced

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amg555/frameforge-mcp",
-  "version": "2.3.8",
+  "version": "2.3.9",
   "description": "FrameForge — AI video production engine for agentic IDEs. npx @amg555/frameforge-mcp. FFmpeg + TTS run on your machine. 19 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.3.8',   code.includes("version: '2.3.8'"));
+check('SERVER_INFO version 2.3.9',   code.includes("version: '2.3.9'"));
 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'));
@@ -295,7 +295,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.8',        cfWorker.includes("'2.3.8'"));
+check('cf-worker version 2.3.9',        cfWorker.includes("'2.3.9'"));
 check('wrangler.toml has kv_namespaces',fs.readFileSync('./cloudflare-mcp/wrangler.toml','utf8').includes('kv_namespaces'));
 
 // ── plugins/skills present ────────────────────────────────────────────────

package/src/mcp-server/server.js

@@ -1524,7 +1524,7 @@ Features:
 
 const SERVER_INFO = {
   name:    'video-pipeline',
-  version: '2.3.8',
+  version: '2.3.9',
 };
 
 const CAPABILITIES = {

package/src/schema/scene.schema.json

@@ -12,6 +12,9 @@
     "video_path": { "type": "string", "description": "Optional path to user-supplied video clip or B-roll" },
     "image_path": { "type": "string", "description": "Optional path to user-supplied static image" },
     "audio_path": { "type": "string", "description": "Optional path to user-supplied pre-recorded voiceover" },
+    "html": { "type": "string", "description": "Optional self-contained HTML animation page conforming to window.seek(t)" },
+    "code": { "type": "string", "description": "Optional canvas drawing JavaScript code executed for time t in window.seek" },
+    "animation_code": { "type": "string", "description": "Alias for code" },
     "visual_description": { "type": "string", "minLength": 1 },
     "character": {
       "type": "object",

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

@@ -406,6 +406,21 @@ function sfc32(a, b, c, d) {
 }
 const hash = (i) => sfc32(i * 19 + 42, i * 29 + 1337, i * 13 + 7, 99)();
 
+// Animation Primitives & Easing
+function clamp(val, min = 0, max = 1) { return Math.max(min, Math.min(max, val)); }
+function lerp(t, a, b, t0 = 0, t1 = 1) {
+  if (t <= t0) return a;
+  if (t >= t1) return b;
+  return a + (b - a) * ((t - t0) / (t1 - t0));
+}
+function easeIn(t) { return clamp(t, 0, 1) ** 2; }
+function easeOut(t) { const c = clamp(t, 0, 1); return 1 - (1 - c) ** 2; }
+function easeInOut(t) { const c = clamp(t, 0, 1); return c < 0.5 ? 2 * c * c : 1 - (-2 * c + 2) ** 2 / 2; }
+function boilSeed(t, seed = 0) {
+  const frame12 = Math.floor(t * 12);
+  return hash(seed * 1000 + frame12);
+}
+
 // Spring dynamics
 function spring(t, delay = 0, tension = 180, friction = 14) {
   const dt = t - delay;