chore(deps,skills): bump Remotion 4.0.441→4.0.484; re-vendor HyperFrames skills at v0.7.17

## Remotion bump (mechanical, semver-safe) remotion-composer: Remotion 4.0.441 → 4.0.484 (43 patch versions, all within 4.0.x). Includes the seven core packages: remotion + @remotion/cli, captions, google-fonts, media, player, transitions. Smoke test: re-rendered the compound-snowball atelier composition through the unchanged tool path; final_review status=pass, atelier checks clean. Note: package.json also carries d3-geo@^3.1.1 forward — this line was already in the working tree from prior unrelated WIP and is not part of this bump. Removing it would leave package-lock mismatched, so it's preserved as-is here; clean up separately when its consumer lands. ## HyperFrames skills re-vendor (0.4.2 → 0.7.17) The runtime invoked by hyperframes_compose (`npx hyperframes`) was already pulling 0.7.17 on every render, but the vendored skill docs the agent reads were frozen at 0.4.2-era. This commit closes that gap. Re-vendored from upstream commit 3351fb1a (tag v0.7.17, 2026-06-27): Re-vendored core 4 (restructured upstream): - hyperframes (slim entry; deep content moved to focused skills) - hyperframes-cli (1 → 7 files; covers validate/inspect/snapshot/ benchmark/lambda natively, dropping the obsolete OM-local validate patch) - hyperframes-registry - website-to-video (renamed upstream from website-to-hyperframes) Newly vendored (8 strategic additions in 0.5–0.7): - hyperframes-core composition contract (data-*/tracks/sub-comps) - hyperframes-creative palette, type, narration, beat planning - hyperframes-media TTS, BGM, SFX, transcription, captions, bg-remove - hyperframes-animation all motion knowledge (rules, blueprints, transitions, 7 runtime adapters) - media-use agent Media OS (one `resolve` verb for BGM/SFX/image/icon; project + global cache) - motion-graphics short design-led motion patterns - remotion-to-hyperframes migration guidance (directly relevant since OpenMontage runs both runtimes) - music-to-video beat-synced video using `hyperframes beats` Intentionally NOT vendored (HF-workflow-specific; would compete with OpenMontage pipeline routing): embedded-captions, faceless-explainer, general-video, pr-to-video, product-launch-video, slideshow, talking-head-recut. Re-evaluate per pipeline need. PROVENANCE.md refreshed with the new vendor point + re-sync instructions. ## GSAP CDN pin .agents/skills/hyperframes/SKILL.md: gsap@3.14.2 → gsap@3 (auto-latest 3.x on jsdelivr; avoids future drift without breaking the API surface). ## Doctrine updates routing to new skill structure - skills/INDEX.md — HyperFrames row expanded to enumerate the 12 vendored skills and their roles. - skills/meta/animation-runtime-selector.md — runtime decision matrix updated for the rename (website-to-hyperframes → website-to-video) and three new rows added: beat-synced music videos, Remotion→HF porting, and the media-use resolve verb. The HyperFrames composition row in the animation-library matrix split into four (core/creative/media/animation) per the upstream skill structure. - skills/core/hyperframes.md — Layer-2 routing skill rewritten to point at the new focused skills and all website-to-hyperframes references renamed.
2026-06-27 14:00:00 -07:00
parent 9a676d6997
commit 46d5514a0a
543 changed files with 79444 additions and 2758 deletions
@@ -80,7 +80,7 @@ Key capability families to look for in the output:
 |-------|------|---------|----------------------|
 | FFmpeg | `core/ffmpeg.md` | Video encoding, filtering, composition | `ffmpeg`, `video-toolkit` |
 | Remotion | `core/remotion.md` | React-based composition, Phase 3+ | `remotion-best-practices`, `remotion` |
-| HyperFrames | `core/hyperframes.md` | HTML/CSS/GSAP composition runtime — kinetic typography, product promos, website-to-video, registry blocks | `hyperframes`, `hyperframes-cli`, `hyperframes-registry`, `website-to-hyperframes`, `gsap-core`, `gsap-timeline` |
+| HyperFrames | `core/hyperframes.md` | HTML/CSS/GSAP composition runtime — kinetic typography, music-to-video, product promos, website capture. Vendored at v0.7.17 (2026-06-27). | `hyperframes` (router) → `hyperframes-core` (contract), `hyperframes-creative` (palette/type/narration), `hyperframes-media` (TTS/BGM/SFX/captions), `hyperframes-animation` (all motion), `hyperframes-cli`, `hyperframes-registry`, `media-use`, `motion-graphics`, `music-to-video` (beats-driven), `website-to-video`, `remotion-to-hyperframes` (migration), `gsap-core`, `gsap-timeline` |
 | WhisperX | `core/whisperx.md` | Transcription with word-level timestamps | `speech-to-text` |
 | Subtitle Sync | `core/subtitle-sync.md` | Subtitle timing and alignment | `remotion-best-practices` |
 | Color Grading | `core/color-grading.md` | FFmpeg color profiles, LUT workflow, accessibility | `ffmpeg` |
@@ -302,7 +302,7 @@ Claude Code accesses them via symlinks in `.claude/skills/`.

 | Category | Installed Skills | Source |
 |----------|-----------------|--------|
-| **Video Composition** | `remotion-best-practices`, `remotion`, `hyperframes`, `hyperframes-cli`, `hyperframes-registry`, `website-to-hyperframes` | `remotion-dev/skills`, `digitalsamba/claude-code-video-toolkit`, `heygen-com/hyperframes` |
+| **Video Composition** | `remotion-best-practices`, `remotion`, `hyperframes` (router), `hyperframes-core`, `hyperframes-creative`, `hyperframes-media`, `hyperframes-animation`, `hyperframes-cli`, `hyperframes-registry`, `media-use`, `motion-graphics`, `music-to-video`, `remotion-to-hyperframes`, `website-to-video` | `remotion-dev/skills`, `digitalsamba/claude-code-video-toolkit`, `heygen-com/hyperframes` (vendored v0.7.17, see `.agents/skills/hyperframes/PROVENANCE.md`) |
 | **Video Processing** | `ffmpeg`, `video-toolkit` | `digitalsamba/claude-code-video-toolkit` |
 | **TTS & Audio** | `text-to-speech`, `speech-to-text`, `music`, `sound-effects`, `elevenlabs`, `agents`, `setup-api-key` | `elevenlabs/skills`, `digitalsamba/claude-code-video-toolkit` |
 | **Image Generation** | `flux-best-practices`, `bfl-api`, `grok-media` | `black-forest-labs/skills`, local OpenMontage skill |
@@ -9,10 +9,18 @@ For raw HyperFrames knowledge (authoring contract, `data-*` attributes, GSAP
 timeline rules, CLI flags, registry blocks, website-to-video), read the Layer 3
 skills:

- `.agents/skills/hyperframes/` — composition authoring contract + GSAP rules
- `.agents/skills/hyperframes-cli/` — init, lint, validate, preview, render
+- `.agents/skills/hyperframes/` — router into the focused skills below (HF 0.7+ split the monolithic skill)
+- `.agents/skills/hyperframes-core/` — composition contract: `data-*` timing, tracks, sub-compositions, deterministic-render rules
+- `.agents/skills/hyperframes-creative/` — non-animation creative direction: palette, type, narration, beat planning
+- `.agents/skills/hyperframes-media/` — TTS/BGM/SFX/transcription/captions/background-removal
+- `.agents/skills/hyperframes-animation/` — all motion knowledge (rules, blueprints, transitions, runtime adapters)
+- `.agents/skills/hyperframes-cli/` — init, add, lint, validate, inspect, snapshot, preview, render, benchmark, lambda, doctor (0.7+)
 - `.agents/skills/hyperframes-registry/` — `hyperframes add` + block wiring
- `.agents/skills/website-to-hyperframes/` — capture-to-video workflow
+- `.agents/skills/website-to-video/` — capture-to-video workflow (renamed from website-to-video in 0.7)
+- `.agents/skills/music-to-video/` — beat-synced music-driven video using `hyperframes beats`
+- `.agents/skills/motion-graphics/` — short design-led motion graphic patterns
+- `.agents/skills/media-use/` — `resolve` verb for BGM/SFX/image/icon (any pipeline, any runtime)
+- `.agents/skills/remotion-to-hyperframes/` — migration ONLY when user explicitly asks to port a Remotion source

 This file teaches the bridge between the two.

@@ -40,7 +48,7 @@ logged in `decision_log`. Silent runtime swaps are a contract violation.
 | Avatar / lip-sync presenter | **Remotion** | `TalkingHead` composition lives in Remotion. No HyperFrames equivalent yet. |
 | Kinetic typography, heavy text motion, GSAP-native animation | **HyperFrames** | HTML/GSAP is the natural medium. Expressing this as Remotion `interpolate()` calls is slow and fragile. |
 | Product promo / launch reel / marketing title card | **HyperFrames** | CSS/GSAP composition grammar matches how designers already think about these. Templates (`kinetic-type`, `product-promo`, `swiss-grid`) give a strong starting point. |
-| Website-to-video / UI-driven composition | **HyperFrames** | The `website-to-hyperframes` workflow exists for exactly this. |
+| Website-to-video / UI-driven composition | **HyperFrames** | The `website-to-video` workflow exists for exactly this. |
 | Registry block needed (data chart, grain overlay, shimmer sweep, shader transition) | **HyperFrames** | The registry is HyperFrames-only. Remotion does not have `hyperframes add`. |
 | Synthetic UI / fake terminal / fake browser demo | Either — depends on existing coverage | OpenMontage already ships Remotion `TerminalScene` (see `synthetic-screen-recording` Layer 3). For UI chrome beyond terminal, HyperFrames HTML is easier. |
 | Pure concat / trim of source clips, no composition | **FFmpeg** | Neither Remotion nor HyperFrames add value here. |
@@ -128,7 +136,7 @@ and gitignored along with the rest of `projects/`.
 - `npx hyperframes lint | validate | render` all operate on a project
  directory. They don't take an abstract composition ID the way Remotion does.
 - Assets live next to the HTML that references them, matching the
-  `website-to-hyperframes` reference workflow.
+  `website-to-video` reference workflow.

 ---

@@ -155,7 +163,7 @@ with the path to the generated MP4. See `tools/video/hyperframes_compose.py`.

 ### Workspace-local authoring artifacts

-Upstream's `website-to-hyperframes` skill uses `DESIGN.md`, `SCRIPT.md`, and
+Upstream's `website-to-video` skill uses `DESIGN.md`, `SCRIPT.md`, and
 `STORYBOARD.md` as step-by-step workspace files. OpenMontage does **not**
 replace its canonical artifact contracts with these — `brief`, `script`,
 `scene_plan`, `edit_decisions`, etc. remain the source of truth under
@@ -59,9 +59,13 @@ when both were available is a CRITICAL reviewer finding.
 | Existing React scene stack (text_card, stat_card, chart, caption overlay, TalkingHead, CinematicRenderer) | **remotion** | `skills/core/remotion.md` |
 | Word-level caption burn / karaoke captions | **remotion** | `skills/core/remotion.md` |
 | Avatar / lip-sync / presenter | **remotion** | `skills/core/remotion.md` |
-| Kinetic typography, HTML/GSAP-native motion, product promo, launch reel | **hyperframes** | `skills/core/hyperframes.md` + `.agents/skills/hyperframes/SKILL.md` |
-| Website → video, UI-driven composition | **hyperframes** | `.agents/skills/website-to-hyperframes/SKILL.md` |
+| Kinetic typography, HTML/GSAP-native motion, product promo, launch reel | **hyperframes** | `skills/core/hyperframes.md` + `.agents/skills/hyperframes/SKILL.md` (router) → `hyperframes-core` (contract), `hyperframes-creative` (palette/type), `hyperframes-animation` (motion) |
+| Website → video, UI-driven composition | **hyperframes** | `.agents/skills/website-to-video/SKILL.md` (renamed from website-to-hyperframes in 0.7) |
 | Registry block needed (data-chart, grain-overlay, shader transitions, etc.) | **hyperframes** | `.agents/skills/hyperframes-registry/SKILL.md` |
+| Beat-synced music video (audio drives scene timing) | **hyperframes** | `.agents/skills/music-to-video/SKILL.md` — uses `hyperframes beats` to detect drops, lays out frames on the beat grid |
+| Porting an existing Remotion composition to HyperFrames | **hyperframes** | `.agents/skills/remotion-to-hyperframes/SKILL.md` — migration guidance, ONLY for explicit port requests |
+| BGM / SFX / image / icon resolution (any pipeline, any runtime) | n/a | `.agents/skills/media-use/SKILL.md` — `resolve` verb against project cache + global cache + HeyGen catalog |
+| Short design-led motion graphic (lower-third, stat reveal, logo sting, headline) | **hyperframes** | `.agents/skills/motion-graphics/SKILL.md` |
 | Pure concat / trim of source clips, no composition needed | **ffmpeg** | `skills/core/ffmpeg.md` |
 | Selected runtime is unavailable | **escalate** — do not substitute silently | `AGENT_GUIDE.md` → Escalate Blockers |

@@ -88,8 +92,11 @@ decision matrix and the list of features that stay Remotion-only in Phase 1.
 | Mathematical / scientific visualization | Manim | `.agents/skills/manim-composer`, `.agents/skills/manimce-best-practices` |
 | D3 data-driven visualization | D3 | `.agents/skills/d3-viz` |
 | Data chart (bar/line/pie/KPI) | Remotion built-in chart components | `remotion-composer/SCENE_TYPES.md` |
-| HyperFrames composition (any motion) | HyperFrames + GSAP (mandatory) | `.agents/skills/hyperframes` + `.agents/skills/gsap-core`, `.agents/skills/gsap-timeline` |
-| HyperFrames composition CLI work (lint/validate/render) | HyperFrames CLI | `.agents/skills/hyperframes-cli` |
+| HyperFrames composition — animation knowledge (rules, blueprints, transitions, runtime adapters) | HyperFrames + GSAP default | `.agents/skills/hyperframes-animation` (consolidated motion skill) + `.agents/skills/gsap-core`, `.agents/skills/gsap-timeline` |
+| HyperFrames composition structure (data-* timing, tracks, sub-compositions) | HyperFrames | `.agents/skills/hyperframes-core` |
+| HyperFrames creative direction (palette, type, narration, beat planning) | HyperFrames | `.agents/skills/hyperframes-creative` |
+| HyperFrames audio/media (TTS, BGM, SFX, transcription, captions, bg-removal) | HyperFrames | `.agents/skills/hyperframes-media` |
+| HyperFrames composition CLI work (lint/validate/inspect/snapshot/benchmark/render/lambda) | HyperFrames CLI 0.7+ | `.agents/skills/hyperframes-cli` |
 | HyperFrames registry block install (`hyperframes add ...`) | HyperFrames registry | `.agents/skills/hyperframes-registry` |

 ## The "keep it simple" bias