@amg555/frameforge-mcp 2.7.6 → 2.7.7

package/.claude-plugin/marketplace.json

@@ -2,7 +2,7 @@
   "name": "frameforge",
   "displayName": "FrameForge — AI Video Production",
   "description": "Full AI video production engine. Produce short-form reels (1080×1920), YouTube videos (1920×1080), or code-driven animated explainers — directly from your IDE. Playwright + FFmpeg renders every frame. 34 MCP tools. Whisper, yt-dlp, broadcast audio, 24 film styles, ClaudeAnimationBase, onetake 39-move library, HyperFrames motion craft. 62 Motion Graphics Styles.",
-  "version": "2.7.6",
+  "version": "2.7.7",
   "homepage": "https://github.com/AMG555/FrameForge",
   "plugins": [
     {

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to FrameForge are documented here.
 
 ---
 
+## [2.7.7] — 2026-11-12
+
+### Changed
+- Slimmed npm tarball distribution: excluded `.agent/` cache and vendor artifacts via `.npmignore` (size reduced from 48MB to 28MB).
+- Upgraded version manifests across core MCP server and sync engine to v2.7.7.
+
+---
+
 ## [2.7.6] — 2026-11-12
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amg555/frameforge-mcp",
-  "version": "2.7.6",
+  "version": "2.7.7",
   "description": "FrameForge — Universal AI video creation & autonomous editing engine for any AI agent, CLI, or IDE. npx @amg555/frameforge-mcp. FFmpeg + TTS on your machine. 34 MCP tools. Whisper transcription, yt-dlp ingestion, broadcast-grade audio, 62 procedural motion styles, 6 viral faceless shorts engines, autonomous video editor with retake/silence cutting, J/L-cuts, timeline export to DaVinci/Premiere.",
   "publishConfig": {
     "access": "public"

package/plugins/video-pipeline/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "video-pipeline",
   "displayName": "FrameForge Video Pipeline",
-  "version": "2.7.6",
+  "version": "2.7.7",
   "description": "End-to-end AI video production. IDE writes scenes → FrameForge renders. Or: scaffold a Playwright+ffmpeg code-driven animation. Or: auto-research and script the video.",
   "skills": [
     {

package/plugins/video-pipeline/skills/.upstream-skills.json

@@ -135,7 +135,7 @@
       "status": "synced"
     }
   },
-  "version": "2.7.6",
+  "version": "2.7.7",
   "updatedCount": 0,
   "pendingUpdates": [
     {

package/plugins/video-pipeline/skills/video-pipeline/references/mcp-tools.md

@@ -403,7 +403,7 @@ No network requests — reads the local manifest only. Returns:
 ```json
 {
   "lastSync": "2026-11-11T20:00:00Z",
-  "manifestVersion": "2.7.6",
+  "manifestVersion": "2.7.7",
   "totalRepos": 11,
   "syncedCount": 11,
   "repos": [

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.7.6',    code.includes("version: '2.7.6'"));
+check('SERVER_INFO version 2.7.7',    code.includes("version: '2.7.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'));
@@ -368,7 +368,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.7.6',         cfWorker.includes("'2.7.6'"));
+check('cf-worker version 2.7.7',         cfWorker.includes("'2.7.7'"));
 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

@@ -2124,7 +2124,7 @@ Professional audio rules applied:
       planMd += `- L-cuts: current audio extends 0.3s into next clip's video\n\n`;
       planMd += `## 🚀 Execution & Approval\n\n`;
       planMd += `Review this plan, then execute with \`edit_video\` using the payload in \`edit.json\`.\n`;
-      planMd += `\nGenerated by FrameForge v2.7.6 — plan_video_edit with J/L-cut support (lemo-opuscar DIRECTOR.md)\n`;
+      planMd += `\nGenerated by FrameForge v2.7.7 — plan_video_edit with J/L-cut support (lemo-opuscar DIRECTOR.md)\n`;
 
       // 8. Build TREATMENT.md (lemo-opuscar DIRECTOR.md — 8-section format)
       let treatmentMd = '';
@@ -2165,7 +2165,7 @@ Professional audio rules applied:
         treatmentMd += `## 8. Director Notes\n\n`;
         treatmentMd += `_Add creative direction, mood references, or client notes here._\n\n`;
         treatmentMd += `---\n\n`;
-        treatmentMd += `*Generated by FrameForge v2.7.6 — lemo-opuscar DIRECTOR.md format*\n`;
+        treatmentMd += `*Generated by FrameForge v2.7.7 — lemo-opuscar DIRECTOR.md format*\n`;
       }
 
       // 9. Write outputs
@@ -2246,7 +2246,7 @@ Professional audio rules applied:
     handler: async () => {
       const syncFs = require('fs');
       const { MANIFEST_PATH, REPOSITORIES } = require('../skills/sync-upstream');
-      let manifest = { lastSync: null, repos: {}, version: '2.7.6', pendingUpdates: [] };
+      let manifest = { lastSync: null, repos: {}, version: '2.7.7', pendingUpdates: [] };
       if (syncFs.existsSync(MANIFEST_PATH)) {
         try { manifest = JSON.parse(syncFs.readFileSync(MANIFEST_PATH, 'utf8')); } catch (_) {}
       }
@@ -2293,7 +2293,7 @@ Professional audio rules applied:
       return {
         success: true,
         lastSync: manifest.lastSync,
-        manifestVersion: manifest.version || '2.7.6',
+        manifestVersion: manifest.version || '2.7.7',
         totalRepos: repos.length,
         syncedCount,
         pendingUpdates,
@@ -3536,7 +3536,7 @@ Get a style id from list_motion_styles first. Source: FrameForge Motion Library
 
 const SERVER_INFO = {
   name:    'video-pipeline',
-  version: '2.7.6',
+  version: '2.7.7',
 };
 
 const CAPABILITIES = {

package/src/skills/sync-upstream.js

@@ -117,7 +117,7 @@ function fetchJson(url) {
   return new Promise((resolve, reject) => {
     const opts = {
       headers: {
-        'User-Agent': 'FrameForge-Skill-Sync/2.7.6',
+        'User-Agent': 'FrameForge-Skill-Sync/2.7.7',
         'Accept': 'application/vnd.github.v3+json',
       },
     };
@@ -188,7 +188,7 @@ async function syncSkills(opts = {}) {
   const updatedResults = results.filter(r => r.updated);
 
   manifest.lastSync = new Date().toISOString();
-  manifest.version = '2.7.6';
+  manifest.version = '2.7.7';
   manifest.updatedCount = updatedCount;
   if (updatedResults.length > 0) {
     manifest.pendingUpdates = updatedResults.map(r => {
@@ -278,7 +278,7 @@ function getUpstreamSummary() {
   return {
     repoCount,
     lastSync: manifest.lastSync,
-    version: manifest.version || '2.7.6',
+    version: manifest.version || '2.7.7',
     pendingUpdates: pending,
     hasUpdates: pending.length > 0,
     repos: manifest.repos || {},

package/.agent/skills/ai-video-editor/README.md

@@ -1,32 +0,0 @@
-# AI Video Editor (free skill)
-
-Give your AI coding agent a talking-head video. It asks you a few questions, then:
-
-1. Transcribes it on your computer with Whisper (English and Hindi)
-2. Cuts the silent parts and your mistakes (retakes, false starts)
-3. Adds motion graphics in one of 7 styles from the Motion Graphics Style Library
-4. Adds sound effects and optional captions, and renders the final MP4
-
-No paid APIs. Everything runs locally: Whisper, ffmpeg and a headless browser.
-
-## Install
-
-1. Install **ffmpeg**
-   - Windows: `winget install Gyan.FFmpeg`
-   - Mac: `brew install ffmpeg`
-   - Linux: `sudo apt install ffmpeg`
-2. Install **Python 3.9+** if you don't have it (python.org).
-3. Unzip this folder into your skills folder:
-   - **Claude Code:** `~/.claude/skills/ai-video-editor/` (Windows: `C:\Users\<you>\.claude\skills\ai-video-editor\`)
-   - **OpenCode:** the same folder works (OpenCode also reads `~/.claude/skills`), or use `~/.config/opencode/skills/ai-video-editor/`
-4. Start Claude Code or OpenCode and say: **"Edit my video C:\path\to\video.mp4"**.
-   The first time, the agent runs the setup script, which installs the Python packages and the browser (free, one time).
-
-## Good to know
-
-- The first transcription downloads a Whisper model once (0.5 to 1.6 GB).
-- Hindi uses the larger model; on a laptop without an NVIDIA GPU it can take about as long as the video.
-- Long videos use a lot of your AI plan's usage, because the agent reads the transcript and writes the graphics code.
-- 16:9 videos for now.
-
-Made by Motion Graphics: youtube.com

package/.agent/skills/ai-video-editor/SKILL.md

@@ -1,152 +0,0 @@
----
-name: ai-video-editor
-description: Edit a talking-head video end to end for free. Asks a few questions, cuts silent parts and mistakes (retakes, false starts) using local Whisper, adds code-drawn motion graphics in one of 7 Motion Graphics Styles, and renders the final MP4. English and Hindi. Use when the user gives a video file and wants it edited, cut, or given motion graphics.
----
-
-# AI Video Editor
-
-Turns a raw talking-head recording into a finished video: silences and mistakes cut, motion graphics in one of
-seven styles, sound effects, optional captions, loudness set for YouTube. Everything runs on the user's computer
-with free tools: Whisper (faster-whisper) for transcription, ffmpeg for cutting and encoding, headless Chromium
-for drawing the graphics. You (the agent) are the editor: you decide the cuts and write the graphics.
-
-`SKILL` below means this skill's folder (the one containing this file). If your tool did not tell you where
-it is, look for the first of these that contains `scripts/render.py`: `~/.claude/skills/ai-video-editor`,
-`~/.config/opencode/skills/ai-video-editor`, `~/.agents/skills/ai-video-editor`, or the same names
-under `.claude/skills`, `.opencode/skills` or `.agents/skills` in the current project. Run scripts with the Python the user has
-(`python` on Windows, usually `python3` on macOS/Linux). Quote paths: video paths often contain spaces.
-Every script prints JSON or a short report; read it before the next step.
-
-## 0. Setup (first time only)
-
-```
-python "SKILL/scripts/setup.py" --check
-```
-If anything is missing, run `python "SKILL/scripts/setup.py"` (installs faster-whisper, playwright, numpy,
-pillow and the headless browser; all free). ffmpeg must be installed separately: the report prints the right
-command for the user's OS (Windows: `winget install Gyan.FFmpeg`, macOS: `brew install ffmpeg`). Ask before
-installing anything system-wide.
-
-## 1. Ask first
-
-Before touching the video, ask these in one go (use your question tool if you have one, otherwise a short
-numbered list). Offer the default in brackets so the user can just say "defaults".
-
-1. **Cut silent parts?** yes / no [yes]. Pace: natural (keeps 0.3 s pauses) or tight (0.15 s) [natural].
-2. **Cut mistakes?** Retakes, false starts, repeated lines, "wait let me redo that": yes / no [yes].
-   Show the list of mistake cuts for approval first? [yes]
-3. **Style** (read `SKILL/styles/index.json`; one line each):
-   - Warm Canvas: calm editorial, you stay on screen with serif captions and a PiP canvas of cards. Best default for talking heads.
-   - Creator Motion Graphics: punchy kinetic type, dark, high energy.
-   - Clean Tech: light, crisp UI cards and kinetic type for tech topics.
-   - Software Walkthrough: mock app screens, cursor and clicks for tutorials.
-   - Data Story: dark charts and counters for numbers and trends.
-   - Chalk Talk: hand-drawn chalkboard for explaining ideas.
-   - Pop Info: flat illustrated infographic scenes with a character.
-   Or "no graphics" (just the cut, with captions if wanted).
-4. **Language:** English, Hindi, or a Hindi/English mix [detect].
-5. **Captions:** yes / no [no]. For Hindi: Devanagari or Roman letters (Hinglish)?
-6. **How much graphics:** light (only the key moments) / medium [light]. Graphics only where they explain something.
-7. **Check-ins:** review the graphics plan and stills before the final render? [yes]
-
-If the user gave some answers already, ask only the rest.
-
-## 2. Transcribe
-
-```
-python "SKILL/scripts/transcribe.py" "VIDEO" --lang en|hi|auto
-```
-Creates the project folder `<video name>_edit` next to the video (WORK below) with `transcript.txt`.
-English uses `small.en` on CPU (fast) and `large-v3-turbo` on an NVIDIA GPU; Hindi/mixed always uses
-`large-v3-turbo`. The first run downloads the model once (small.en about 0.5 GB, turbo about 1.6 GB). On a CPU,
-turbo takes roughly as long as the video or longer, so tell the user before a long run. `--model medium.en`
-is a middle ground for English.
-
-## 3. Find the mistakes (skip if the user said no)
-
-Read `WORK/transcript.txt`. Each line is a phrase: `[start-end] wA-wB: text`, with `(pause Ns)` between.
-Look for:
-- **Retakes:** the same sentence (or its opening) said twice or more. Keep the LAST complete take; remove the
-  earlier attempts entirely, including any half-finished words.
-- **False starts:** a phrase that stops mid-thought and restarts ("So the main, the key thing is").
-  Remove the abandoned part.
-- **Explicit redo cues:** "let me say that again", "cut that", "one more time", "wait", "sorry".
-  Remove the cue and the take it refers to.
-- **Filler at the start/end:** "okay, recording", "is this on", trailing "and, um, yeah".
-- Fillers inside sentences ("um", "uh"): remove only clusters or long ones; single fillers usually sound
-  natural. Hindi speakers' "matlab", "toh", "na" are normal speech, keep them.
-Do NOT remove content just because it is informal, and never reorder sentences.
-
-Write `WORK/edits.json`:
-```json
-{ "remove": [ {"from": 41, "to": 58, "why": "first take of the intro"},
-              {"from": 203, "to": 207, "why": "false start"} ] }
-```
-`from`/`to` are word indices (inclusive) from transcript.txt. Then preview the plan:
-```
-python "SKILL/scripts/cut.py" WORK --dry-run --style STYLE --captions yes|no [--no-silence] [--pause 0.15]
-```
-If the user wanted to approve mistake cuts, show them the `mistake_cuts` list (time, reason, the removed words)
-and wait. Adjust edits.json if they disagree.
-
-## 4. Cut
-
-```
-python "SKILL/scripts/cut.py" WORK --style STYLE --captions yes|no [--no-silence] [--pause 0.15]
-```
-Writes `cut.mp4` (frame-accurate, click-free joins, 1080p by default; `--height 2160` keeps 4K),
-`transcript_edited.txt/json` with the NEW times, and the cut summary. If the user chose no graphics, use `--style warm-canvas` (it only sets the caption look) and skip to 7
-with an empty story: `var EDIT = { D: <cut_seconds>, SPANS: [], draw() {}, score() {} };`.
-
-## 5. Plan the graphics
-
-Read, in this order:
-1. `SKILL/references/story-guide.md` (the contract, footage helpers, sound and taste rules). Always.
-2. `SKILL/styles/STYLE/style.md` (the look and rules of the style).
-3. `SKILL/styles/STYLE/base.js` from the `STYLE:` banner to the end (helpers and the demo scenes to learn from).
-4. For Warm Canvas, `SKILL/references/example-story-warm-canvas.js` (a complete working story).
-5. `WORK/transcript_edited.txt`.
-
-Pick the beats: the moments where a visual makes the idea clearer (a list, number, comparison, process, key term,
-before/after, a named tool). Light = roughly one beat per 30 to 60 seconds; medium = one per 15 to 30 seconds.
-Leave the personal and emotional lines on the plain footage. For each beat note: start/end time, the words it
-illustrates, what is on screen, how it enters and leaves.
-
-If the user wanted check-ins, show the beat list (a short table) and wait for an OK.
-
-## 6. Write story.js and check it
-
-Write `WORK/story.js` following the guide. Set `EDIT.D` to `cut_seconds` from `WORK/edit.json`. Then:
-```
-python "SKILL/scripts/render.py" WORK --check
-python "SKILL/scripts/render.py" WORK --stills auto
-```
-Open `WORK/stills/contact.png` (an image; look at it) and fix anything off: clipped or overlapping text, small
-type, graphics covering the face, off-style colours, wrong words. Repeat until it looks right. For check-ins,
-show the user the contact sheet. Optional live preview with sound:
-`python "SKILL/scripts/preview.py" WORK` (run it in the background; it prints a localhost link).
-
-## 7. Render
-
-```
-python "SKILL/scripts/render.py" WORK
-```
-Renders the graphics frames in parallel, the effects, captions (if on), mixes voice and effects, normalizes to
--14 LUFS, and writes `WORK/final.mp4`. Expect a few frames per second of graphics on a laptop; plain footage
-costs nothing extra. Options: `--preset slow` (smaller, slightly better file), `--sfx-gain 0.7` (quieter
-effects), `--no-captions`, `--height 2160`.
-
-Tell the user where final.mp4 is, how much was cut (from the cut summary), and what graphics were added.
-
-## Fixing things later
-
-- A cut is wrong: edit `edits.json` (or run with `--no-silence` / another `--pause`), re-run cut.py. Then shift
-  the story's times if words moved (re-read transcript_edited.txt) and render again.
-- A misheard word in captions: edit its `"w"` in `transcript_edited.json` (or add `"cap"`), render again.
-- Hindi captions in Roman letters: add `"cap"` with the Roman spelling to each word in transcript_edited.json.
-- Only the graphics changed: edit story.js and run render.py; nothing else needs redoing.
-
-## Limits
-
-- 16:9 videos. Vertical or square sources are center-cropped to 16:9 for now.
-- One continuous recording per edit (join clips first with ffmpeg if needed).