@amg555/frameforge-mcp 2.7.6 → 2.7.8

package/.agent/skills/gstack-upgrade/migrations/v1.78.0.0.sh

@@ -1,30 +0,0 @@
-#!/usr/bin/env bash
-# Migration: v1.78.0.0 — carry feature-discovery acknowledgements to GSTACK_HOME
-# (#2728 absorption follow-through).
-#
-# Why a migration: pre-v1.78, `gstack-skill-start` gated the one-time feature
-# prompts (.feature-prompted-continuous-checkpoint, .feature-prompted-model-
-# overlay) on marker files BESIDE THE INSTALL — which, for project-local
-# symlink installs, resolved into the project repo and left machine-state
-# droppings in checkouts (#2728). v1.78 reads them from GSTACK_HOME. Without
-# this copy, every existing install that already answered those prompts gets
-# re-prompted once per feature.
-#
-# Idempotent: existing destination markers are left untouched. Non-fatal
-# throughout — a failed copy just means one benign re-prompt.
-set -u
-
-INSTALL_DIR="${GSTACK_INSTALL_DIR:-$HOME/.claude/skills/gstack}"
-_gstack_migration_dir="${BASH_SOURCE[0]//\\//}"; _gstack_migration_dir="${_gstack_migration_dir%/*}"
-. "${_gstack_migration_dir}/../../bin/gstack-state-root.sh" 2>/dev/null || { echo "$0: cannot resolve the gstack state root: ${_gstack_migration_dir}/../../bin/gstack-state-root.sh is missing. fix: reinstall with ./setup or /gstack-upgrade (docs/state-root.md)" >&2; exit 1; }
-gstack_state_root_select; GH="$_gstack_sr_root"
-
-mkdir -p "$GH" 2>/dev/null || exit 0
-
-for m in .feature-prompted-continuous-checkpoint .feature-prompted-model-overlay; do
-  if [ -f "$INSTALL_DIR/$m" ] && [ ! -f "$GH/$m" ]; then
-    touch "$GH/$m" 2>/dev/null && echo "migrated: $m → $GH"
-  fi
-done
-
-exit 0

package/.agent/skills/gstack-upgrade/migrations/v1.86.0.0.sh

@@ -1,12 +0,0 @@
-#!/usr/bin/env bash
-# Migration: v1.86.0.0 — /claude becomes /claude-code on non-Claude hosts.
-# Affected: existing generated skills, including copied and dangling installs.
-# The same helper runs before setup builds, so replacements are installed before
-# shared old renders are retired. This post-setup pass repairs missed upgrades.
-# Idempotent and non-fatal: foreign entries and failed replacements stay intact.
-set -u
-INSTALL_DIR="${GSTACK_INSTALL_DIR:-$HOME/.claude/skills/gstack}"
-if [ -f "$INSTALL_DIR/bin/gstack-migrate-claude-code" ] && command -v bun >/dev/null 2>&1; then
-  bun "$INSTALL_DIR/bin/gstack-migrate-claude-code" --install-dir "$INSTALL_DIR" || true
-fi
-exit 0

package/.agent/skills/gstack-upgrade/migrations/v1.91.19.0.sh

@@ -1,53 +0,0 @@
-#!/usr/bin/env bash
-# Migration: v1.91.19.0 — severe fix wave (memory ingest, artifacts remote).
-# Placeholder name: the release queue may rename this file at /ship.
-#
-# Each step is independent and guarded. Idempotent and non-fatal: every path
-# exits 0, and no step calls gbrain or the network unless it has work to do.
-set -u
-_gstack_migration_dir="${BASH_SOURCE[0]//\\//}"; _gstack_migration_dir="${_gstack_migration_dir%/*}"
-. "${_gstack_migration_dir}/../../bin/gstack-state-root.sh" 2>/dev/null || { echo "$0: cannot resolve the gstack state root: ${_gstack_migration_dir}/../../bin/gstack-state-root.sh is missing. fix: reinstall with ./setup or /gstack-upgrade (docs/state-root.md)" >&2; exit 1; }
-gstack_state_root_select; GH="$_gstack_sr_root"
-
-# Step 1 (A1, #2778): older versions could mark a transcript ingested that
-# gbrain had skipped. Record that a reconcile pass is pending; the next memory
-# ingest re-checks stamped pages in bounded batches and re-queues the missing
-# ones. This only writes a flag under the ingest's state lock; it never calls
-# gbrain.
-if [ -f "$GH/.transcript-ingest-state.json" ]; then
-  INGEST="${_gstack_migration_dir}/../../bin/gstack-memory-ingest.ts"
-  if command -v bun >/dev/null 2>&1 && [ -f "$INGEST" ]; then
-    if bun "$INGEST" --request-reconcile --quiet; then
-      echo "memory ingest: reconcile pending; the next /sync-gbrain re-checks transcripts already marked ingested."
-    else
-      echo "memory ingest: could not record a pending reconcile now; run: gstack-memory-ingest --reconcile" >&2
-    fi
-  fi
-fi
-
-# Step 2 (A8, #1437): the v1.27.0.0 migration passed a bare repo name to
-# `gh repo rename`, which always failed, then pointed the artifacts remote at
-# gstack-artifacts-<user> anyway. When that repository does not exist but the
-# old gstack-brain-<user> does, point the remote back at the old one. Only a
-# remote that names a gstack-artifacts-* GitHub repo is checked.
-REMOTE_TXT="${HOME:-}/.gstack-artifacts-remote.txt"
-if [ -n "${HOME:-}" ] && [ -f "$REMOTE_TXT" ]; then
-  URL=$(head -1 "$REMOTE_TXT" 2>/dev/null | tr -d '[:space:]')
-  OWNER=$(printf '%s\n' "$URL" | sed -n 's#^.*github\.com[:/]\([^/]*\)/gstack-artifacts-[^/]*$#\1#p')
-  NEW_NAME=$(printf '%s\n' "$URL" | sed -n 's#^.*/\(gstack-artifacts-[^/]*\)$#\1#p' | sed 's/\.git$//')
-  if [ -n "$OWNER" ] && [ -n "$NEW_NAME" ]; then
-    OLD_NAME="gstack-brain-${NEW_NAME#gstack-artifacts-}"
-    if ! command -v gh >/dev/null 2>&1 || ! gh auth status >/dev/null 2>&1; then
-      echo "artifacts remote: could not confirm $OWNER/$NEW_NAME exists (gh is not installed or not signed in). If artifact pushes fail, run: gh repo rename $NEW_NAME --repo $OWNER/$OLD_NAME --yes"
-    elif ! gh repo view "$OWNER/$NEW_NAME" >/dev/null 2>&1 && gh repo view "$OWNER/$OLD_NAME" >/dev/null 2>&1; then
-      OLD_URL=$(printf '%s\n' "$URL" | sed "s#/${NEW_NAME}#/${OLD_NAME}#")
-      echo "$OLD_URL" > "$REMOTE_TXT" && chmod 600 "$REMOTE_TXT"
-      if [ "$(git -C "$GH" remote get-url origin 2>/dev/null)" = "$URL" ]; then
-        git -C "$GH" remote set-url origin "$OLD_URL" 2>/dev/null || true
-      fi
-      echo "artifacts remote: restored $OLD_URL because $OWNER/$NEW_NAME does not exist and $OWNER/$OLD_NAME does (an earlier upgrade rewrote it before the rename ran). To finish the rename later: gh repo rename $NEW_NAME --repo $OWNER/$OLD_NAME --yes"
-    fi
-  fi
-fi
-
-exit 0

package/.agent/skills/gstack-upgrade/migrations/v1.91.65.0.sh

@@ -1,31 +0,0 @@
-#!/usr/bin/env bash
-# Migration: v1.91.65.0 — install footprint (#1694). The release queue may
-# rename this file at /ship; it must match VERSION.
-#
-# Installs used to render every host's skills inside the checkout, so a global
-# Claude install carried ~576 extra SKILL.md files (32 MB) that Claude Code and
-# Cursor-agent scan. Record the hosts this install already serves (registry
-# rows, install roots that resolve here, host skills that link into its
-# renders), then prune the renders of every other host with
-# bin/gstack-host-renders.sh: generated files are backed up under
-# $GSTACK_STATE_ROOT/backups/host-renders/, anything not proven generated stays.
-# ./setup runs the same prune on every run; this covers an install upgraded
-# without one. Idempotent and non-fatal.
-set -u
-_gstack_migration_dir="${BASH_SOURCE[0]//\\//}"; _gstack_migration_dir="${_gstack_migration_dir%/*}"
-_gstack_bin="${_gstack_migration_dir}/../../bin"
-. "$_gstack_bin/gstack-state-root.sh" 2>/dev/null || { echo "$0: cannot resolve the gstack state root: $_gstack_bin/gstack-state-root.sh is missing. fix: reinstall with ./setup or /gstack-upgrade (docs/state-root.md)" >&2; exit 1; }
-gstack_state_root_select; GSTACK_STATE_ROOT="$_gstack_sr_root"
-. "$_gstack_bin/gstack-install-registry.sh" 2>/dev/null || exit 0
-. "$_gstack_bin/gstack-host-renders.sh" 2>/dev/null || exit 0
-
-INSTALL="${GSTACK_INSTALL_DIR:-${HOME:-}/.claude/skills/gstack}"
-[ -f "$INSTALL/VERSION" ] && [ -f "$INSTALL/setup" ] || exit 0
-
-gstack_render_hosts_seed "$INSTALL"
-if [ ! -f "$(gstack_render_hosts_file "$INSTALL")" ]; then
-  echo "host renders: no install from $INSTALL was found, so its renders were left alone; ./setup --host <name> records and prunes"
-  exit 0
-fi
-gstack_prune_host_renders "$INSTALL" || echo "host renders: some generated files could not be backed up and were left in place; the next ./setup retries" >&2
-exit 0

package/.agent/skills/html-renderer/SKILL.md

@@ -1,336 +0,0 @@
----
-name: html-renderer
-description: |
-  HTML-as-compositor renderer for FrameForge. Every video frame is a pure
-  function of time rendered by a headless browser (Playwright + Chromium)
-  and encoded by FFmpeg. Produces exact, pixel-perfect animation — React
-  component quality without a React runtime. Use this as an alternative to
-  FFmpeg-only zoompan when richer motion graphics are required: kinetic text,
-  morphing layouts, spring-physics, counters, progress rings, captions
-  synced to audio, and any CSS/SVG animation. Pairs with the FrameForge
-  pipeline: script JSON → HTML compositor → frame PNGs → FFmpeg encode.
-  Compatible with IBM Bob, Kiro, Cursor, Windsurf, Claude Code, Codex,
-  opencode, and any agentic IDE connected via MCP. Activate when the user
-  asks for richer animation, Remotion-style rendering, HTML-based video, or
-  "make it look like the reference repo".
-
-  Advanced animation patterns (read references/ after scaffold):
-    references/animation-patterns.md  — ClaudeAnimationBase 12fps boil, onetake 39-move library,
-                                        collage B-roll 3-gate, Remotion spring patterns
-    references/character-animation.md — ClaudeAnimationBase full ANIMATION_GUIDE (31 emotions,
-                                        timing principles, pure-fn constraint, review loop)
-    references/motion-craft.md        — 10 hard motion craft rules (springs, 5-layer stack, exits faster)
-    references/film-styles.md         — 24 cinematic film styles (anamorphic, cyberpunk, anime, lofi...)
-    references/hyperframes-motion.md  — HyperFrames motion craft (GSAP eases, beat grid, transitions,
-                                        measured from official launch films)
-    references/directing.md           — lemo-opuscar directing method (story, sound layers, rhythm,
-                                        camera, performance, review loop, delivery checklist)
-    references/earshot-audio.md       — earshot professional audio (5 loops, forge DSP, sound bank,
-                                        LUFS tables, J/L cuts, AI-verifiable audio metrics)
-    references/onetake-camera.md      — zero-cut continuous camera choreography
-    references/collage-broll.md       — editorial paper collage + halftone 2.5D
-    references/procedural-sfx.md      — 13-type SFX library with room profiles + platform LUFS targets
-    references/render-contract.md     — determinism contract (bans Date.now, Math.random, CSS transitions)
----
-
-# HTML Renderer — FrameForge Extension
-
-Renders video frames as HTML pages (one page = one frame clock) using
-Playwright for screenshot capture and FFmpeg for final encoding.
-
-Built on deterministic `seek(t)` — every style is a pure function of time `t`.
-No CSS transitions, no `setTimeout`, no frame state that depends on the
-previous frame (Playwright renders frames out of order for parallelism).
-
----
-
-## When to use this renderer
-
-| Use FFmpeg zoompan (default)       | Use HTML renderer (this skill)       |
-|------------------------------------|--------------------------------------|
-| Batch overnight — speed matters    | Animation quality is the priority    |
-| Simple Ken-Burns + captions        | Kinetic text, counters, data charts  |
-| CI/server with no browser          | Morphing layouts, spring physics     |
-| < 5 min render time required       | Creator wants Remotion-style output  |
-| Raspberry Pi / low-RAM machine     | macOS/Linux with 4GB+ free RAM       |
-
----
-
-## Requirements
-
-- Node.js 18+, FFmpeg, `npx playwright install chromium`
-- macOS or Linux recommended (Windows: WSL2)
-- 4 GB+ free RAM (Playwright renders up to 6 subframes per output frame in
-  parallel for motion blur)
-- `uv` (Python) for audio processing scripts: `pip install uv` or
-  `curl -LsSf https://astral.sh/uv/install.sh | sh`
-
----
-
-## Setup
-
-```bash
-# Install Playwright chromium (one-time)
-npx playwright install chromium
-
-# Scaffold a new HTML-renderer project from a FrameForge script JSON
-node <frameforge-root>/scripts/html-renderer/new-project.mjs \
-  --script output/<productionId>-script.json \
-  --out    output/<productionId>-html/
-```
-
-The scaffold copies `index.html` (compositor), starter `edit.js`, the
-`reel/engine.js` runtime, and all render scripts into the project folder.
-
----
-
-## Core concept: `seek(t)`
-
-```js
-// edit.js — every element style is computed from t (seconds)
-import { reel, faceAt, layer, text, at, captions } from './reel/engine.js';
-
-reel({ width: 1920, height: 1080, fps: 30, duration: 65 });
-
-// Title card: fades in at t=0, stays for 3s
-layer('hook').on(t => ({
-  opacity: t < 0.3 ? t / 0.3 : t > 2.7 ? (3 - t) / 0.3 : 1,
-}));
-
-at(0, text('Why Ancient Humans Started Cooking', {
-  font: '72px/1.2 "Archivo"', color: '#fff',
-  x: 'center', y: 200,
-}));
-
-// Caption synced to FrameForge TTS audio
-captions('audio/outline.txt');  // generated by transcribe.py
-```
-
-**Iron rule:** Every style must be a pure function of `t`. If a layer is
-active during frames 5–15 s and you `return` early for t > 15, it must
-explicitly reset every property it drove — otherwise the last frame's value
-sticks on all later frames.
-
----
-
-## Workflow (integrates with FrameForge pipeline)
-
-### Step 1: Run FrameForge dry-run to get script JSON
-
-```bash
-npm run make -- --topic "Your Topic" --dry-run --out-dir output/my-topic
-# Produces: output/my-topic/<productionId>-script.json
-```
-
-### Step 2: Scaffold the HTML compositor project
-
-```bash
-node scripts/html-renderer/new-project.mjs \
-  --script output/my-topic/<productionId>-script.json \
-  --out    output/my-topic/html-render/
-```
-
-The scaffolder reads each scene's `narration`, `caption`,
-`visual_description`, `camera_hint`, and `music_mood` from the script JSON
-and generates a starter `edit.js` with one `layer()` per scene, timed to
-the expected narration duration (estimated at 2.5 words/second).
-
-### Step 3: Gather assets (optional)
-
-```bash
-# Stock footage
-uv run scripts/stock.py video "ancient cooking fire" --portrait
-
-# Website screenshot as b-roll
-node scripts/capture.mjs site https://example.com broll-site
-
-# X post card
-node scripts/capture.mjs tweet https://x.com/... post-card
-```
-
-### Step 4: Check visually before full render
-
-```bash
-# Contact sheet — one frame every 0.5s
-node scripts/render.mjs sheet
-
-# Specific timestamps
-node scripts/render.mjs stills 0 5.5 12 28 45 60
-```
-
-### Step 5: Mix audio
-
-```bash
-uv run scripts/mix_audio.py
-# Reads FrameForge TTS outputs, applies -14 LUFS, writes out/audio_mix.m4a
-```
-
-### Step 6: Full render + verify
-
-```bash
-node scripts/render.mjs full
-uv run scripts/verify.py
-```
-
-Output: `out/<name>.mp4` (1920x1080 or 1080x1920 for Shorts), verified
-against the same FrameForge quality gates (resolution, codec, LUFS, A/V sync).
-
-### Step 7: Re-inject into FrameForge pipeline
-
-The rendered MP4 can be injected back into FrameForge via `video_path`:
-
-```json
-{
-  "scene_id": 1,
-  "video_path": "output/my-topic/html-render/out/video.mp4"
-}
-```
-
-Or pass it directly to `publish_video` via MCP:
-
-```
-publish_video(productionId, masterPath="output/my-topic/html-render/out/video.mp4", channels=["file","webhook"])
-```
-
----
-
-## Engine API quick reference
-
-| Function | What it does |
-|---|---|
-| `reel({ width, height, fps, duration })` | Configure the compositor |
-| `layer('name').on(t => styles)` | Declare a layer; styles recomputed every frame |
-| `at(t, element)` | Place element at time t |
-| `stagger(t, dt, elements[])` | Place elements with dt spacing |
-| `text(str, opts)` | Animated text with font/color/position |
-| `chip(str, opts)` | Pill-shaped label (tags, captions) |
-| `wallCard(lines[], opts)` | Frosted-glass card over background |
-| `imageCard(src, opts)` | Image with optional caption overlay |
-| `browserCard(url, opts)` | Screenshot-as-card |
-| `terminal(lines[], opts)` | Animated terminal output |
-| `stamp(str, opts)` | Bold diagonal stamp (VERIFIED, SOURCE, etc.) |
-| `codeCard(code, lang, opts)` | Syntax-highlighted code block |
-| `captions(outlinePath)` | Auto-sync captions from whisper outline |
-| `cuePhrase(phrase, offset)` | Word-level trigger with fail-fast transcript check |
-| `cue(sfxName, t, vol)` | Trigger sound effect at time t |
-| `event(type, t, meta)` | Declare a composition event for render.mjs to consume via `window.__events()` |
-| `faceAt(layout, t)` | Position talking-head face (FULL, SPLIT, PIP) |
-| `hash(i)` | Deterministic PRNG float [0, 1) for index i |
-| `boilSeed(key, t)` | Deterministic stepped float [0, 1) in 1/12s window |
-| `kf(t, keys, ease)` | Keyframe interpolation with easing curves |
-| `onTwos(t)` | Quantize time to 12 fps (traditional animation on twos) |
-| `seg(t, a, b)` | Clamp t into [0, 1] interval progress |
-| `pulse(t, k)` | Exponential impulse peak at t=0, decaying with rate k |
-| `shots(timeline)` | Time-ordered shot registry fn(t, lt, dur) for parallel render |
-| `on(t => ...)` | Raw per-frame compute (for custom animations) |
-| `beatAt(index, bpm, fps)` | Beat frame index (HyperFrames formula — round per-index, never accumulated) |
-| `beatTime(index, bpm)` | Beat timestamp in seconds |
-| `snapToBeat(t, bpm)` | Snap a timestamp to the nearest beat boundary |
-| `OM.spring(t, opts)` | OneTake spring entrance → `{ transform, opacity }` |
-| `OM.iris(t, opts)` | Radial clip expand from centre → `{ clipPath }` |
-| `OM.morphRect(t, opts)` | Clip from narrow rect to full frame → `{ clipPath }` |
-| `OM.zoomThrough(t, opts)` | Portal scale-through → `{ transform }` |
-| `OM.camera(t, opts)` | Ken Burns + seeded micro-shake → `{ transform }` |
-| `OM.carryScore(t)` | Carry momentum at exit (must be ≥ 0.5 to PASS oracle) |
-| `ROOM_SFX` | OneTake 5-material SFX palette (air/wood/glass/sub/bubble) for `cue()` |
-
----
-
-## Storyboard Gates, Purity Verification & Review Modes
-
-```bash
-# 1. Diagnostic & Setup checks
-node scripts/harness.mjs doctor        # Verify Chrome, GPU flags (D3D11/Metal), WebGL context
-node scripts/look.mjs                  # Pre-render linter (fonts, clipping, NaN transforms)
-
-# 2. Purity verification gate (3-point repeat, wander, cold-jump test)
-node scripts/harness.mjs verify        # Must pass a===b and a===c across 9 sampled timestamps
-
-# 3. Gate stills & review commands
-node scripts/harness.mjs storyboard    # 4 keyframes (0%, 33%, 66%, 100%) or validate STORYBOARD.md
-node scripts/harness.mjs sheet         # Contact sheet (0.5s interval)
-node scripts/harness.mjs strip 1.0 1.5 # Horizontal frame strip (motion check)
-node scripts/harness.mjs crop 9:16     # Focal-point mobile crop preview
-node scripts/harness.mjs pixels        # Blind-spot frame analysis (blank, blown, corner-confined)
-
-# 4. Master render & encode
-node scripts/harness.mjs frames        # Resumable atomic frame render (.tmp + renameSync)
-node scripts/harness.mjs encode        # BT.709 color-tagged master encode + audio mux
-node scripts/harness.mjs all           # Complete gate-checked end-to-end production
-node scripts/render.mjs mux            # Re-mux audio only (no re-render)
-node scripts/render.mjs kit            # Editor kit (Premiere/Resolve XML)
-```
-
-Full render uses 6-page parallel Playwright pool (motion blur subframes).
-Long videos render in 60s resumable chunks — re-run to continue after crash.
-
----
-
-## Gotchas
-
-- **Pure functions of t.** No CSS transitions, `setTimeout`, or state that
-  depends on previous frames. Playwright seeks out of order.
-- **Every style must reset.** If a layer returns early after t > 15s, it
-  must explicitly set opacity/display/visibility to 0/none/hidden — or the
-  last rendered value bleeds onto all later frames.
-- **HDR iPhone footage** needs tonemapping before compositing
-  (`uv run scripts/assemble.py` does this automatically).
-- **Motion blur needs 6 subframes.** Fewer subframes show fast morphs as
-  ghost copies. Default is 6 (180° shutter), a 60s video takes ~4 min.
-- **Measure text after fonts load.** Components that need widths (strike-
-  through, underline) measure lazily on first `seek()`.
-- **Captions over the mouth.** Use `REEL.captionY` per layout to move them
-  to the seam in split-screen mode.
-
----
-
-## IBM Bob integration
-
-This skill works inside IBM Bob as a `~/.bob/skills/html-renderer/` skill.
-
-```bash
-# Install
-cp -r plugins/video-pipeline/skills/html-renderer/ ~/.bob/skills/html-renderer/
-
-# Bob will pick it up automatically — ask:
-# "use the html-renderer skill to animate my FrameForge script"
-```
-
-The skill pairs with the existing `video-pipeline` skill: use
-`video-pipeline` for research/script/TTS/publish and `html-renderer` for
-the animation/render stage.
-
----
-
-## Files this skill adds
-
-```
-plugins/video-pipeline/skills/html-renderer/
-  SKILL.md                           ← this file
-  references/engine-api.md           ← full engine function reference
-  references/design.md               ← layouts, safe zones, type scale, pacing
-  references/animation-patterns.md   ← ClaudeAnimationBase boil + onetake 39-move + collage + Remotion
-  references/character-animation.md  ← ClaudeAnimationBase full ANIMATION_GUIDE (31 emotions, timing)
-  references/hyperframes-motion.md   ← HyperFrames GSAP motion craft (measured from official films)
-  references/directing.md            ← lemo-opuscar directing method (sound, rhythm, camera, delivery)
-  references/earshot-audio.md        ← earshot 5-loop audio workflow (forge DSP, kit, LUFS tables)
-  references/motion-craft.md         ← 10 hard motion craft rules (springs, 5-layer stack, exits faster)
-  references/film-styles.md          ← 24 cinematic film styles from lemo-opuscar
-  references/onetake-camera.md       ← zero-cut continuous camera patterns
-  references/collage-broll.md        ← editorial paper collage + halftone 2.5D
-  references/procedural-sfx.md       ← 13-type SFX + room profiles + platform LUFS + earshot bank
-  references/render-contract.md      ← determinism contract (bans Math.random etc.)
-  assets/project/                    ← template copied into each render project
-    index.html                       ← compositor page (loads engine.js)
-    edit.js                          ← starter edit (one layer per FrameForge scene)
-    reel/engine.js                   ← springs, layouts, components, captions, seek API
-    reel/engine.css                  ← default fonts + base reset
-    scripts/                         ← render.mjs, mix_audio.py, mix_audio_pro.py,
-                                        verify.py, stock.py, capture.mjs,
-                                        transcribe.py, new-project.mjs
-scripts/html-renderer/
-  new-project.mjs                    ← scaffolds a render project from script JSON
-```
-
-References are automatically copied into each project's `references/` directory
-by `scaffold_animation_project` — agents should read them for advanced patterns.