Herk Edit Kit by Nate Herk: edit videos, reels, and YouTube Shorts with Codex or Claude Code. 15 skills, transcript-driven cuts, storytelling, 406 motion-graphics cards, and HyperFrames templates.
Merge video pipeline kit and short-form editing into student kit
Nate Herke0454295333e
diff --cc .agents/skills/make-a-video/SKILL.mdindex 0000000,0000000..53fe977new file mode 100644--- /dev/null+++ b/.agents/skills/make-a-video/SKILL.md@@@ -1,0 -1,0 +1,268 @@@++---++name: make-a-video++description: Beginner-friendly end-to-end video creator for HyperFrames. Use when the user says "make a video", "create a video", "new video", "build a video", "video from scratch", "I want to make a video", "help me create a video", or when someone who's never used HyperFrames before arrives with a concept, script, or rough idea and wants a finished MP4. Interviews the user in one pass, then builds the full video with mandatory preview and visual-verification gates.++---++++# Make a Video — The Beginner-to-Finished-MP4 Skill++++Two phases, eight sequential gates. Every gate produces a concrete artifact the next gate consumes. Don't skip gates.++++## When to use this skill — and when to hand off++++**Use this skill when:**++- The user is new to HyperFrames and starting from a concept, script, or outline++- They want an end-to-end walkthrough, not framework reference material++- They haven't decided on format yet++++**Hand off when:**++- The user pastes a URL and wants a video from that site → invoke `/website-to-hyperframes`++- The user explicitly wants a 9:16 vertical talking-head with face-cam + scene overlays → run Gates 1–4 here, then invoke `/short-form-edit` from Gate 5 onward++- The user asks for framework rules, not a video → invoke `/hyperframes`++++## The two phases++++- **Phase 1 — INTERVIEW (Gates 1–4):** one conversational pass to gather *everything* before touching code. Intent, format, script, voice, style, assets, pacing. Synthesize into a `BRIEF.md` and wait for explicit approval.++- **Phase 2 — BUILD (Gates 5–8):** scaffold → storyboard → compositions → lint → Studio preview → draft render → visual verification → MP4 preview → final render.++++---++++## Gate 1 · Intent & format++++Ask one question at a time via `AskUserQuestion`, multiple-choice where possible.++++1. What's this video for? (promo · social ad · launch teaser · product demo · tutorial · explainer · intro/outro card · other)++2. Who's the audience? (open-ended)++3. Target duration? (10–20s short · 20–45s promo · 45–90s explainer · 1.5–3 min lesson · custom)++4. Aspect ratio? (16:9 1920×1080 · 9:16 1080×1920 · 1:1 1080×1080)++5. Frame rate? (30 default · 60 for crisp UI · 24 cinematic)++6. Platform / delivery constraints? (file size · deadline · where it'll play)++++**Gate:** all six captured. If the answer is 9:16 + face-cam, plan to hand off to `/short-form-edit` at Gate 5.++++Full question bank: `Read: references/interview-questions.md`++++---++++## Gate 2 · Script & voice++++1. Script source? (paste · outline → I'll draft · I'll record · TTS from text · no narration)++2. If TTS: voice preference. Offer choices from `npx hyperframes tts --help`. Also capture pace.++3. If face-cam: recording path · full-screen or corner placement · need transcription? (`npx hyperframes transcribe <file> --model small.en --json`)++4. Captions? (off · hype · corporate · karaoke-word-by-word · minimal)++++**Gate:** script captured (or drafted), audio plan captured, caption plan captured.++++---++++## Gate 3 · Style intake++++**Before asking the user anything, inventory existing assets.** Check `<workspace-root>/assets/` and any project `assets/` folder. Don't ask for what's already there.++++Then ask progressively — they don't need answers to all of these:++++1. Style guide or brand doc? (paste/path · no)++2. Color palette? (hex codes · none — use MOTION_PHILOSOPHY defaults)++3. Fonts? (Google Fonts name(s) · file paths · none — use Inter + JetBrains Mono defaults)++4. Logo file? (path · none — use text wordmark instead)++5. Reference videos for vibe? (URLs/paths · none)++6. Other assets? (screenshots · product photos · b-roll · music — list paths)++7. MOTION_PHILOSOPHY aesthetic (black canvas · chrome type · perspective grid · whip transitions) or a different feel?++8. Pacing? (kinetic 1–2s · balanced 2–3s · relaxed 3–5s)++9. Music? (none · ambient pad 0.15 · music bed 0.4 · full 0.8 — file path if they have one)++10. Outro / call-to-action text?++++**Never impose a brand on the user.** Fall back to MOTION_PHILOSOPHY defaults *only* when they explicitly decline to supply a style.++++Full style flow + MOTION_PHILOSOPHY defaults: `Read: references/style-intake.md`++++---++++## Gate 4 · Brief synthesis (HARD-GATE before building)++++1. **Read `MOTION_PHILOSOPHY.md`** if it exists in the workspace root — mandatory if present. If missing, proceed with the defaults in `references/style-intake.md` and note the absence in the brief.++2. **Ask where projects live** if it's not obvious:++ - If `video-projects/` exists → use `video-projects/<slug>/`++ - Otherwise → ask the user++3. **Write `<project-folder>/BRIEF.md`**:++ - slug · intent · audience · dimensions · fps · duration++ - script (full or outline)++ - voice choice · caption plan · face-cam plan++ - style profile: palette (hex), fonts, logo path, reference videos++ - pacing++ - asset inventory with paths++ - outro / CTA text++4. **Show the brief. WAIT for explicit approval.** Don't proceed to Gate 5 without a clear "yes, build it."++++---++++## Gate 5 · Scaffold & storyboard++++### Handoff check first++++If the brief describes a 9:16 vertical talking-head with face-cam + scene overlays, invoke `/short-form-edit` NOW and hand off the brief. Its transcript-driven workflow covers hooks, cuts, captions, footage, and sound.++++Otherwise continue:++++### Scaffold++++1. `mkdir <project-folder>`++2. If a sibling project with similar format exists, offer to copy its `hyperframes.json` + `meta.json` as a template. Otherwise from inside the folder: `npx hyperframes init`++3. Edit `meta.json` with the user's slug, dimensions, fps.++4. Copy supplied assets into `<project-folder>/assets/`.++5. Create `<project-folder>/assets/style-profile.md` from Gate 3 — single source of truth for palette/fonts/logo.++++### Storyboard++++Generate `<project-folder>/STORYBOARD.md` using the template in `references/storyboard-template.md`. Every beat gets:++++```++Beat N — TITLE (start–end, duration) — Concept in one sentence++Visual elements: [each element, size, animation, timing]++Motion language: [kind of motion]++Eases used: [3–4 distinct GSAP eases]++Exit: [transition into next beat]++Audio: [VO line / SFX / music layer]++```++++Top of file: a timing table with scene · start · duration · composition file.++++**Propose a rule-of-threes structure:**++- Act 1 (hook) ≈ 20% of duration++- Act 2 (body) ≈ 55%++- Act 3 (payoff + outro with 4–6 second hold) ≈ 25%++++(MOTION_PHILOSOPHY §0 Law 9, §1.)++++**Map user intents → catalog blocks:** `Read: references/catalog-intent-map.md`++++**Gate:** show storyboard + timing table. Iterate until the user approves.++++---++++## Gate 6 · Build compositions++++Invoke `/hyperframes` for framework rules. This skill owns the scaffold and discipline; `/hyperframes` enforces the rules.++++### Scaffold every sub-composition++++```html++<div data-composition-id="scene-name" data-start="..." data-duration="...">++ <style>[data-composition-id="scene-name"] { /* scoped */ }</style>++ <!-- DOM -->++ <script>++ (function(){++ const SLOT_DURATION = ...;++ const tl = gsap.timeline({ paused: true });++ // ... tweens ...++ tl.to({}, { duration: SLOT_DURATION }, 0); // anchor — MOTION_PHILOSOPHY Law 11++ window.__timelines["scene-name"] = tl;++ })();++ </script>++</div>++```++++Full boilerplate + captions pattern + ambient-bg pattern: `Read: references/composition-scaffold.md`++++### Build rules++++- **Ambient background** on `data-track-index="0"` for the full composition duration.++- **Kinetic-type openers:** per-word stagger 0.06–0.10s.++- **Captions** as body-level siblings of the root composition in `index.html`, each with `data-track-index ≥ 20`. Never inside scene timelines (MOTION_PHILOSOPHY §3.13).++- **Catalog blocks** installed via `npx hyperframes add <name>`. Immediately **scope the block's CSS** to `[data-composition-id="..."]` — catalog blocks ship with `html, body { ... }` rules that bleed into the parent document when loaded as sub-compositions.++- **Vertical + face-cam:** wrap native 1920×1080 face in a transform (`translate` + `scale`) for bottom-half or full-screen mode. (If you end up here instead of `/short-form-edit`, strongly consider the handoff.)++- **Apply ONLY what the user supplied.** Their palette, their fonts, their logo. Don't inject anything else. If they chose MOTION_PHILOSOPHY defaults, pull the palette + font pair from `references/style-intake.md`.++++### Determinism++++No `Math.random()`, no `Date.now()`, no render-time `fetch()`. Use seeded PRNGs or harmonic-sin hashes (MOTION_PHILOSOPHY §3.10).++++---++++## Gate 7 · Lint → Studio preview (PREVIEW GATE 1 — MANDATORY)++++1. `npx hyperframes lint` — fix all errors, triage warnings.++2. `npx hyperframes preview` in the background.++3. Wait for "Studio running" on `http://localhost:3002`.++4. Hand the user the URL **plus** individual composition URLs (`http://localhost:3002/?comp=<id>`). If the project has WebGL shader blocks, lead with the individual URLs — software WebGL fallback can stall the master composition.++5. **WAIT for explicit "looks good, render a draft"** before proceeding. Silence is not approval.++++Hot reload is on — edits show up live.++++---++++## Gate 8 · Draft render → visual verification → MP4 preview → final++++### Draft render++++```bash++npx hyperframes render --quality draft --output renders/<slug>-draft.mp4++```++++### Visual verification (MANDATORY before delivery)++++Lint passing ≠ design working. Extract frames and **view them**.++++1. `mkdir -p renders/frames`++2. For every beat hero moment AND every transition:++ ```bash++ ffmpeg -y -ss <t> -i renders/<slug>-draft.mp4 -frames:v 1 -q:v 2 renders/frames/t<t>.png++ ```++3. **Call the `Read` tool on every PNG.** The Read tool loads the image into context — don't just list filenames.++4. Confirm per frame: no cropped faces, correct face-mode per scene, text readable and on-palette, no overflow, transitions land on intended words, no blank frames.++5. If anything's wrong: fix → re-render → re-verify. Never ship a broken draft.++++### MP4 preview (PREVIEW GATE 2 — MANDATORY)++++```bash++npx serve renders -p 8080 -n++```++++Do NOT use Python's `http.server` — it doesn't support HTTP Range requests, so scrubbing breaks.++++Hand the user `http://localhost:8080/<slug>-draft.mp4`. **WAIT for explicit sign-off** on playback and audio sync.++++### Final render++++```bash++npx hyperframes render --quality standard --output renders/<slug>-final.mp4++```++++Report the output path. Done.++++Full preflight + pre-delivery checklist: `Read: references/build-checklist.md`++++---++++## Non-negotiables (load-bearing — do not soften)++++- **DO NOT skip PREVIEW GATE 1 (Studio) or PREVIEW GATE 2 (rendered MP4).** Two gates per build, always.++- **DO NOT claim a render is done** until frames have been extracted AND Read via the Read tool.++- **DO NOT build anywhere but inside a dedicated project folder.** Never put `index.html` at the workspace root.++- **DO NOT ask the user for assets** before inventorying their workspace.++- **DO NOT skip the `tl.to({}, { duration: SLOT_DURATION }, 0)` anchor tween** at the end of every sub-composition timeline. MOTION_PHILOSOPHY Law 11.++- **DO NOT use `Math.random()` / `Date.now()`** inside render logic. Seeded hashes only.++- **DO NOT add `class="clip"` to `<video>` tags.** It breaks them.++- **DO NOT impose a brand on the user.** Ask first; fall back to MOTION_PHILOSOPHY defaults only when they explicitly decline.++++---++++## References++++- `references/interview-questions.md` — full question bank by Gate++- `references/style-intake.md` — style interview + MOTION_PHILOSOPHY defaults++- `references/catalog-intent-map.md` — "user says X → install Y"++- `references/storyboard-template.md` — beat-by-beat template + worked example++- `references/composition-scaffold.md` — scoped-styles + IIFE GSAP boilerplate++- `references/build-checklist.md` — preflight + pre-delivery gates++++External (workspace-level):++- `MOTION_PHILOSOPHY.md` — the one external reference this skill assumes exists. Aesthetic baseline. Fallback lives in `references/style-intake.md` if the file is missing.++++## Related skills++++- `/hyperframes` — framework rules, invoke at Gate 6++- `/hyperframes-cli` — init · lint · preview · render · transcribe · tts++- `/hyperframes-registry` — installing catalog blocks++- `/gsap` — GSAP animation reference++- `/short-form-edit` — hand off at Gate 5 for 9:16 talking-head format++- `/website-to-hyperframes` — hand off at Gate 1 if the starting input is a URLdiff --cc .agents/skills/make-a-video/references/build-checklist.mdindex 0000000,0000000..75046e3new file mode 100644--- /dev/null+++ b/.agents/skills/make-a-video/references/build-checklist.md@@@ -1,0 -1,0 +1,110 @@@++# Build Checklist — Preflight + Pre-Delivery++++Used by `/make-a-video` Gates 7 and 8. Run before any render and before telling the user "it's done."++++---++++## Preflight — structural (before PREVIEW GATE 1)++++- [ ] Root `<div>` in `index.html` has `id`, `data-composition-id`, `data-start="0"`, `data-width`, `data-height`++- [ ] Every sub-composition `.html` has a root `<div>` with `data-composition-id`, `data-start`, `data-duration`++- [ ] Every timed visible element has `class="clip"`, `data-start`, `data-duration`, `data-track-index`++- [ ] NO `class="clip"` on `<video>` tags++- [ ] `<video>` elements are `muted`; audio lives in sibling `<audio>` elements++- [ ] Same-track clips never overlap (different `data-track-index` for overlapping elements)++- [ ] Every GSAP timeline ends with `tl.to({}, { duration: SLOT_DURATION }, 0)`++- [ ] Every timeline registered on `window.__timelines['<id>']` with key matching `data-composition-id` exactly++- [ ] Captions are body-level siblings in `index.html` (not inside sub-compositions), each with `data-track-index ≥ 20`++- [ ] No `Math.random()`, no `Date.now()`, no render-time `fetch()`++- [ ] Catalog block CSS is scoped under `[data-composition-id="..."]` (no leaked `html, body { ... }`)++- [ ] `npx hyperframes lint` — all errors fixed, warnings triaged++++---++++## Preflight — aesthetic++++- [ ] Palette on-brief — no rogue colors, ≤5 symbolic hues++- [ ] Typography on-brief — only the fonts declared in `assets/style-profile.md`++- [ ] Grid / vignette / grain texture present on every scene (or on the full-composition background)++- [ ] Ambient background composition on `data-track-index="0"` for full duration++- [ ] Every scene transition is a *motion* transition (whip · morph · blur · recolor), not a hard fade++- [ ] Outro holds 4–6 seconds++- [ ] At least one visual callback (element returns later)++- [ ] Scene lengths follow the brief's pacing tier (kinetic 1–2s · balanced 2–3s · relaxed 3–5s)++++---++++## PREVIEW GATE 1 — Studio++++- [ ] `npx hyperframes preview` running (background)++- [ ] User given `http://localhost:3002`++- [ ] If the project has shader blocks, user also given individual composition URLs (`http://localhost:3002/?comp=<id>`)++- [ ] Hot-reload edits show up correctly++- [ ] **Explicit "looks good, render a draft" captured** — silence is not approval++++---++++## Draft render++++- [ ] `npx hyperframes render --quality draft --output renders/<slug>-draft.mp4` completed++- [ ] No render errors or warnings++- [ ] Output file exists and plays in a standard video player++++---++++## Visual verification (NON-NEGOTIABLE)++++- [ ] `mkdir -p renders/frames`++- [ ] Frame extracted at each beat hero moment:++ ```bash++ ffmpeg -y -ss <t> -i renders/<slug>-draft.mp4 -frames:v 1 -q:v 2 renders/frames/t<t>.png++ ```++- [ ] Frame extracted at each transition moment (the mid-streak / mid-morph timestamp)++- [ ] **Every PNG opened via the `Read` tool** — not just listed by filename++- [ ] For each frame confirmed:++ - [ ] No cropped faces++ - [ ] Face-mode correct per scene (full-screen vs. corner as storyboarded)++ - [ ] Text readable, on-palette, not overflowing++ - [ ] Transition lands on the intended word / beat++ - [ ] No blank frames, no black-frame flashes++- [ ] Any regression → fixed → re-rendered → re-verified++++---++++## PREVIEW GATE 2 — Rendered MP4++++- [ ] `npx serve renders -p 8080 -n` running (NOT Python's `http.server` — no Range support breaks scrubbing)++- [ ] User given `http://localhost:8080/<slug>-draft.mp4`++- [ ] Playback scrubs cleanly end-to-end++- [ ] Audio syncs with visuals (voiceover · SFX · music bed)++- [ ] **Explicit sign-off captured**++++---++++## Final render++++- [ ] `npx hyperframes render --quality standard --output renders/<slug>-final.mp4`++- [ ] File exists, size reasonable for duration (roughly 3–10 MB per 10 seconds at 1080p)++- [ ] Final file plays cleanly in a standard player++- [ ] Output path reported to the user++++---++++## After delivery++++- [ ] Update `BRIEF.md` with a `## Delivery` section: final render path, render command used, any post-delivery notes++- [ ] Offer one round of revisions — the user almost always has one++- [ ] If the user wants a different format (e.g. 1:1 crop from 16:9), plan that as a new pass through Gates 1–8 with the original `BRIEF.md` as the starting point++++---++++## Common fail-modes and how they look++++| Symptom in the render | Likely cause | Fix |++|---|---|---|++| Black frame flash at end of a scene | Timeline shorter than `data-duration` | Add / extend the anchor tween in that sub-composition |++| `<video>` freezes on a still frame | Animating `width`/`height` on the video element directly | Wrap in a `<div>` and animate the wrapper |++| Text clipped / cropped | Scoped style missing `overflow: visible` on the container | Add it |++| Catalog block's background covers the whole stage | Block's `html, body { ... }` rule leaked | Scope it under `[data-composition-id="..."]` |++| Transition lands mid-word | `data-start` on the incoming scene is off | Align to the transition's peak frame (usually midway through its duration) |++| Grain flickers / looks random | Using `Math.random()` in the grain script | Replace with a seeded hash |diff --cc .agents/skills/make-a-video/references/catalog-intent-map.mdindex 0000000,0000000..2fe4f2anew file mode 100644--- /dev/null+++ b/.agents/skills/make-a-video/references/catalog-intent-map.md@@@ -1,0 -1,0 +1,90 @@@++# Catalog Intent Map — "User Says X → Install Y"++++Used by `/make-a-video` Gate 5. Translates beginner language into `npx hyperframes add <block>` commands.++++## The map++++| User says… | Install |++|---|---|++| "title card / opener / kinetic type" | hand-build — registry has no kinetic-type block; see MOTION_PHILOSOPHY §3.3 |++| "logo reveal / outro / final card" | `logo-outro` |++| "film grain / texture on everything" | `grain-overlay` (component) |++| "shimmer on my logo / light glint" | `shimmer-sweep` (component) |++| "smooth transition / soft fade" | `transitions-blur` · `transitions-dissolve` |++| "energetic transition / fast cut / punchy" | `whip-pan` · `cinematic-zoom` · `glitch` |++| "cinematic transition / premium morph" | `cross-warp-morph` · `swirl-vortex` |++| "act break / dramatic flash" | `flash-through-white` · `light-leak` |++| "zoom-through text" | `cinematic-zoom` |++| "color change on same scene" | `chromatic-radial-split` — or hand-build the CSS-variable recolor in MOTION_PHILOSOPHY §3.5 |++| "phone showcase / mobile demo" | `app-showcase` |++| "3D UI reveal / perspective product" | `ui-3d-reveal` |++| "macOS notification popup" | `macos-notification` |++| "chart / data viz / bar graph" | `data-chart` |++| "flowchart / decision tree / node diagram" | `flowchart` |++| "grid tile transition / pixelate wipe" | `grid-pixelate-wipe` (component) · `transitions-grid` |++| "TikTok follow overlay" | `tiktok-follow` |++| "Instagram follow overlay" | `instagram-follow` |++| "YouTube subscribe lower-third" | `yt-lower-third` |++| "Twitter/X post card" | `x-post` |++| "Reddit post card" | `reddit-post` |++| "Spotify now-playing card" | `spotify-card` |++| "thermal / heat distortion" | `thermal-distortion` |++| "ripple / water / concentric waves" | `ripple-waves` |++| "iris / circular reveal" | `sdf-iris` |++| "domain warp / noise dissolve" | `domain-warp-dissolve` |++| "ridged burn / fire effect" | `ridged-burn` |++| "gravitational lens / warp" | `gravitational-lens` |++++For the full catalog browse live with `npx hyperframes catalog --type block` and `npx hyperframes catalog --type component`.++++---++++## Install + wire workflow++++1. **From inside the project folder:**++ ```bash++ npx hyperframes add <block-name>++ ```++2. **Block installs to** `<project>/compositions/<block-name>.html` (or `<project>/compositions/components/<name>.html` for components).++3. **Immediately scope its CSS.** Catalog blocks ship with top-level `html, body { ... }` rules. When loaded as a sub-composition via `data-composition-src`, those rules bleed into the parent document.++ - Open the installed file++ - Wrap the `html, body { ... }` rule under `[data-composition-id="<block-id>"]`++ - Do the same for any other un-scoped global rule++4. **Wire into `index.html`:**++ ```html++ <template++ data-composition-src="compositions/<block-name>.html"++ data-start="..."++ data-duration="..."++ data-track-index="..."></template>++ ```++5. **Apply the user's palette.** Most blocks accept CSS variables at the top of the file — find them and override with the user's hex codes from `style-profile.md`.++++---++++## Components vs. blocks++++- **Blocks** are standalone sub-compositions — their own timeline, their own root `<div>`. Reference via `data-composition-src`. Examples: `logo-outro`, `app-showcase`, `tiktok-follow`.++- **Components** are snippets you merge *into* an existing composition's HTML. Paste the component's DOM + CSS + a slice of its script into the host composition. Examples: `grain-overlay`, `shimmer-sweep`, `grid-pixelate-wipe`.++++The installer handles the distinction automatically; you mainly need to know which to reach for when planning the storyboard.++++---++++## When NOT to install++++Catalog blocks buy production velocity. When you have time, hand-building hero moments (kinetic-type openers, logo reveals) usually looks better than installing a block — the MOTION_PHILOSOPHY reference spot installs **zero** blocks.++++**Rule of thumb for this skill:**++- Transitions and social/UI overlays → install++- Hero opener and final CTA → hand-build unless the user is on a tight deadline++- Film grain and shimmer → always install (they're components, meant to be dropped in)++++---++++## Gotchas++++- After installing a block, always run `npx hyperframes lint` — the installer can create `data-composition-id` collisions if you already have one with the same name.++- Blocks ship with their own fonts. If the user specified custom fonts in the style profile, override the block's font family with a scoped rule.++- Some blocks (notably `logo-outro`) expect specific asset filenames — read the installed file and rename / re-path to the user's logo.++- Shader blocks (the 14 shader transitions) use WebGL. In the Studio's software WebGL fallback, they can stall the master composition preview. Gate 7 routes users to individual composition URLs to work around this.diff --cc .agents/skills/make-a-video/references/composition-scaffold.mdindex 0000000,0000000..9a17601new file mode 100644--- /dev/null+++ b/.agents/skills/make-a-video/references/composition-scaffold.md@@@ -1,0 -1,0 +1,189 @@@++# Composition Scaffold — Scoped Styles + IIFE GSAP Pattern++++Used by `/make-a-video` Gate 6. Every sub-composition follows this pattern.++++## Why this pattern++++- **Scoped styles** (`[data-composition-id="..."] { ... }`) prevent CSS bleed between compositions and from catalog blocks.++- **IIFE** keeps GSAP variables out of the global namespace — multiple sub-compositions won't collide.++- **Anchor tween** (`tl.to({}, { duration: SLOT_DURATION }, 0)`) guarantees `timeline.duration() ≥ data-duration`, preventing the black-frame flash HyperFrames emits when a timeline ends short. MOTION_PHILOSOPHY Law 11.++++---++++## Boilerplate — one sub-composition file++++```html++<div data-composition-id="scene-01-hook" data-start="0" data-duration="1.5">++ <!-- Scoped styles — every selector under the [data-composition-id] -->++ <style>++ [data-composition-id="scene-01-hook"] {++ position: absolute;++ inset: 0;++ display: grid;++ place-items: center;++ }++ [data-composition-id="scene-01-hook"] .word {++ font-family: 'Inter', sans-serif;++ font-weight: 700;++ font-size: 96px;++ background: linear-gradient(180deg, #fff 0%, #999 100%);++ -webkit-background-clip: text;++ color: transparent;++ }++ </style>++++ <!-- DOM — timed elements get class="clip" + data-start/duration/track -->++ <span class="word w1 clip" data-start="0.0" data-duration="0.8" data-track-index="2">Why</span>++ <span class="word w2 clip" data-start="0.2" data-duration="0.8" data-track-index="2">is</span>++ <span class="word w3 clip" data-start="0.4" data-duration="0.8" data-track-index="2">this</span>++ <span class="word w4 clip" data-start="0.6" data-duration="0.8" data-track-index="2">still</span>++ <span class="word w5 clip" data-start="0.8" data-duration="0.7" data-track-index="2">hard?</span>++++ <!-- IIFE + anchor tween -->++ <script>++ (function(){++ const SLOT_DURATION = 1.5;++ const tl = gsap.timeline({ paused: true });++++ // Per-word reveal stagger++ tl.from('[data-composition-id="scene-01-hook"] .w1',++ { y: 30, opacity: 0, scale: 0.9, duration: 0.5, ease: 'power3.out' }, 0);++ tl.from('[data-composition-id="scene-01-hook"] .w2',++ { y: 30, opacity: 0, scale: 0.9, duration: 0.5, ease: 'power3.out' }, 0.2);++ tl.from('[data-composition-id="scene-01-hook"] .w3',++ { y: 30, opacity: 0, scale: 0.9, duration: 0.5, ease: 'power3.out' }, 0.4);++ tl.from('[data-composition-id="scene-01-hook"] .w4',++ { y: 30, opacity: 0, scale: 0.9, duration: 0.5, ease: 'power3.out' }, 0.6);++ tl.fromTo('[data-composition-id="scene-01-hook"] .w5',++ { y: 30, opacity: 0, scale: 0.9 },++ { y: 0, opacity: 1, scale: 1, duration: 0.3, ease: 'power3.out' }, 0.8);++ // Dolly-through on the hero word++ tl.to('[data-composition-id="scene-01-hook"] .w5',++ { scale: 8, opacity: 0, duration: 0.4, ease: 'power2.in' }, 1.1);++++ // ANCHOR — keeps timeline.duration() >= SLOT_DURATION. Non-negotiable.++ tl.to({}, { duration: SLOT_DURATION }, 0);++++ // Register — key MUST exactly match data-composition-id++ window.__timelines['scene-01-hook'] = tl;++ })();++ </script>++</div>++```++++---++++## Hard rules the scaffold enforces++++1. **Root composition `<div>` in `index.html`** has `id`, `data-composition-id`, `data-start="0"`, `data-width`, `data-height`. Sub-composition roots have `data-composition-id`, `data-start`, `data-duration` — no width/height.++2. **Every timed visible element** has `class="clip"`, `data-start`, `data-duration`, `data-track-index`. **Exceptions:** `<video>` and `<audio>` do NOT get `class="clip"` — it breaks them.++3. **CSS is scoped.** No top-level rules inside a sub-composition file. Every selector lives under `[data-composition-id="..."]`.++4. **Timeline registered** on `window.__timelines['<id>']` with key exactly matching `data-composition-id`.++5. **Anchor tween** at the end of every timeline: `tl.to({}, { duration: SLOT_DURATION }, 0)`.++6. **Never** `masterTL.add(child)` — HyperFrames auto-links sub-composition timelines to the parent.++7. **Never** call `.play()` / `.pause()` / set `.currentTime` on media. The framework owns playback.++8. **Never animate** `width` · `height` · `top` · `left` directly on a `<video>` — browsers freeze frames. Wrap in a `<div>` and animate the wrapper.++9. **Same-track clips never overlap** (same `data-track-index`). Use separate track indices for overlapping elements.++++---++++## Ambient background pattern++++One persistent composition, bottom layer, full video duration.++++In `index.html`:++```html++<template++ data-composition-src="compositions/ambient-bg.html"++ data-start="0"++ data-duration="<total-seconds>"++ data-track-index="0"></template>++```++++`compositions/ambient-bg.html` is its own sub-composition: grid + vignette + grain + slow drifts (breathing vignette, parallax grid). Uses the same scaffold pattern — scoped styles, IIFE, anchor tween.++++---++++## Caption pattern (body-level siblings)++++Captions go OUTSIDE the master composition `<div>` in `index.html`, each with `data-track-index ≥ 20`:++++```html++<div class="cap clip"++ data-start="0.5" data-duration="1.8" data-track-index="30">++ Why is this still so hard?++</div>++<div class="cap clip"++ data-start="2.4" data-duration="2.2" data-track-index="31">++ Ship faster with ACME.++</div>++++<style>++ .cap {++ position: absolute;++ bottom: 72px;++ left: 50%;++ transform: translateX(-50%);++ padding: 12px 22px;++ border-radius: 14px;++ background: rgba(10, 8, 5, 0.55);++ backdrop-filter: blur(8px);++ font: 500 28px/1.3 Inter, sans-serif;++ color: #fff;++ }++</style>++```++++Central control, zero coupling to scene timelines. MOTION_PHILOSOPHY §3.13.++++---++++## Time-reference aliasing++++A clip's `data-start` can reference another clip by id:++++```html++<span id="intro" data-start="0" data-duration="2">...</span>++<span data-start="intro + 1.5" data-duration="2">...</span>++<span data-start="intro - 0.3" data-duration="2">...</span>++```++++Useful for small offsets around a named beat without hard-coding seconds.++++---++++## Diagnostic — every timeline fills its slot++++Before shipping, open Studio devtools and run:++++```js++const p = document.querySelector('hyperframes-player');++const iw = p.shadowRoot.querySelector('iframe').contentWindow;++Object.fromEntries(Object.entries(iw.__timelines).map(([k, v]) =>++ [k, +v.duration().toFixed(4)]));++```++++Compare every value against the corresponding `data-duration`. Any gap where `timeline.duration() < data-duration` is a black-frame risk. Fix by adjusting the anchor tween's duration.++++---++++## Time-snapping++++Tween end-times should snap to multiples of `1 / fps`:++- 30fps: 0.0333, 0.0667, 0.1, 0.1333, 0.1667, 0.2, …++- 60fps: 0.0167, 0.0333, 0.05, 0.0667, …++++Steep-tail easings (`expo.in`, `power4.in`) visibly alias at sub-frame boundaries. MOTION_PHILOSOPHY §4.++++---++++## Determinism++++Never use `Math.random()` or `Date.now()` inside render logic. Use seeded hashes:++++```js++// Deterministic pseudo-random per index++const noise = i => 80 + 220 * Math.abs(Math.sin(i * 0.7 + 0.3) * Math.cos(i * 1.3 + 0.7));++```++++Renders must be identical frame-to-frame across runs.diff --cc .agents/skills/make-a-video/references/interview-questions.mdindex 0000000,0000000..393e904new file mode 100644--- /dev/null+++ b/.agents/skills/make-a-video/references/interview-questions.md@@@ -1,0 -1,0 +1,143 @@@++# Interview Questions — Full Bank++++Used by `/make-a-video` Gates 1–3. Ask one at a time via `AskUserQuestion`, multiple-choice where possible.++++## Before asking anything — inventory first++++Run these to see what already exists so you don't ask for supplied assets:++++```bash++ls "<workspace-root>/assets" 2>/dev/null++ls "<project-folder>/assets" 2>/dev/null++```++++Reference anything you find by path in the eventual `BRIEF.md`.++++---++++## Gate 1 · Intent & format++++**Q1. What's this video for?**++- Promo / marketing video++- Social ad (TikTok · Reels · Shorts · X)++- Launch teaser++- Product demo++- Tutorial++- Explainer++- Intro / outro card++- Other (describe)++++**Q2. Who's the audience?** (open-ended)++Probe: industry · expertise level · platform they'll watch on · what should they feel++++**Q3. Target duration?**++- Short — 10–20s++- Promo — 20–45s++- Explainer — 45–90s++- Lesson — 1.5–3 min++- Custom — ask for a number++++**Q4. Aspect ratio?**++- 16:9 landscape — 1920×1080++- 9:16 vertical — 1080×1920++- 1:1 square — 1080×1080++++**Q5. Frame rate?**++- 30 fps (default, good for everything)++- 60 fps (crisp UI, product demos, game footage)++- 24 fps (cinematic)++++**Q6. Platform / delivery constraints?**++- Where will it play? (site hero · TikTok · LinkedIn · YouTube · internal deck · other)++- File-size ceiling?++- Deadline?++++---++++## Gate 2 · Script & voice++++**Q7. Script source?**++- Paste the full script now++- I have an outline — draft the full script for me++- I'll record it myself (need path to voiceover or face-cam file)++- Generate TTS narration from text++- No narration — visuals + music only++++**Q8. If TTS:**++- Voice choice (offer from `npx hyperframes tts --help`). Common: `am_adam`, `am_michael` (male US) · `af_bella`, `bf_emma` (female US/UK)++- Speaking pace (normal · slightly faster · slightly slower)++++**Q9. If face-cam or recorded voiceover:**++- File path++- Full-screen or corner? (bottom-right · bottom-left · top-right · top-left)++- Need transcription? If yes: `npx hyperframes transcribe <file> --model small.en --json`++++**Q10. Captions?**++- Off++- On — hype (bold, punchy, colored accent words)++- On — corporate (clean, single-line, no emphasis)++- On — karaoke (per-word sync, reveal as spoken)++- On — minimal (single sub-line, low contrast)++++---++++## Gate 3 · Style intake++++**Q11. Style guide or brand document?**++- Yes — paste or give path (look for hex codes, fonts, logo rules, spacing rules)++- No++++**Q12. Color palette?**++- Paste hex codes. Ask for at least: background · text/primary · accent (the "emotion" color). Optional: surface · border · warn.++- None — use MOTION_PHILOSOPHY defaults (see `style-intake.md`)++++**Q13. Fonts?**++- Google Fonts names (e.g. Inter · Montserrat · JetBrains Mono · Bebas Neue · Space Grotesk)++- Font file paths++- None — use Inter + JetBrains Mono defaults++++**Q14. Logo file?**++- Path to file++- None — text wordmark instead? Ask for the text and weight/style++++**Q15. Reference videos?**++- URLs or file paths — "the vibe I want"++- None++++**Q16. Other assets?**++- Screenshots (paths)++- Product photos (paths)++- B-roll clips (paths)++- Music tracks (paths)++- Any SVGs / icons / illustrations (paths)++++**Q17. MOTION_PHILOSOPHY aesthetic or different feel?**++- MOTION_PHILOSOPHY: black canvas · chrome-gradient type · perspective grid · whip-pan transitions · 4–6s outro hold++- Different — describe or give references++++**Q18. Pacing?**++- Kinetic — 1–2s scenes, energetic (reference-quality motion graphics)++- Balanced — 2–3s scenes (most promos)++- Relaxed — 3–5s scenes (explainers · lessons · luxury feel)++++**Q19. Music?**++- None (silence)++- Ambient pad — `data-volume="0.15"` (premium, barely there)++- Music bed — `data-volume="0.4"` (standard promo layer)++- Full music — `data-volume="0.8"` (music-driven edit)++- File path if they have one++++**Q20. Outro / call-to-action text?**++- CTA line (e.g. "Get started at example.com")++- Hold duration (4–6s recommended — the longest shot in the whole video)++++---++++## Sequencing rules++++- **One question per `AskUserQuestion` call.** Don't batch. The user can't focus on three questions at once.++- **Multiple-choice over open-ended** when the answer has discrete valid forms.++- **Follow-ups happen inline.** If Q7 = "record it myself," the next question is Q9 (not Q8).++- **Capture every answer to the brief as you go** — short phrases, not full sentences. The `BRIEF.md` at Gate 4 is a synthesis, not a transcript.++- **If an answer is surprising** (e.g. "I want a 4-hour TikTok ad"), confirm before proceeding. Don't assume.++- **Never ask for what's already known.** If the user mentioned a file path earlier or it's sitting in `assets/`, skip that question and just confirm the interpretation.diff --cc .agents/skills/make-a-video/references/storyboard-template.mdindex 0000000,0000000..08a9c54new file mode 100644--- /dev/null+++ b/.agents/skills/make-a-video/references/storyboard-template.md@@@ -1,0 -1,0 +1,142 @@@++# Storyboard Template — Beat-by-Beat++++Used by `/make-a-video` Gate 5. Generates `<project-folder>/STORYBOARD.md` — the build blueprint.++++## Header++++```markdown++# STORYBOARD — <project-slug>++++**Total duration:** <duration>s · <fps>fps · <width>×<height>++**Style profile:** see `assets/style-profile.md`++**Script / brief:** see `BRIEF.md`++++## Act structure++++- **Act 1 (0 → ≈20%):** hook — grab attention in the first 1–2 seconds++- **Act 2 (≈20% → ≈75%):** body — one idea per beat, 1–2 second scenes++- **Act 3 (≈75% → end):** payoff + outro with 4–6 second hold++++## Timing table++++| # | Start | Dur | Scene file | Concept |++|---|-------|-----|------------|---------|++| 0 | 0.0 | <total> | `ambient-bg.html` | Persistent background |++| 1 | 0.0 | 1.5 | `01-opener.html` | Hook |++| 2 | 1.5 | 1.2 | `02-...` | ... |++| N | ... | 4.5 | `N-cta-outro.html` | CTA hold |++```++++---++++## Per-beat format (one block per beat)++++```markdown++## Beat N — <TITLE> (<start>s–<end>s, <duration>s) — <one-sentence concept>++++**Visual elements:**++- <element 1> — position, size, animation, timing++- <element 2> — ...++++**Motion language:** <1–2 sentences: what kind of motion carries this beat?>++++**Eases used:**++- Entry: `<ease>` (e.g. `power3.out`)++- Hold: `<ease>` (or `none` for linear)++- Exit: `<ease>`++++**Exit transition:** <how this beat hands off — whip streak · morph · blur crossfade · color recolor · hard cut aligned to streak peak>++++**Audio:** <VO line if any · SFX · music layer notes>++```++++---++++## Worked example — 15-second product promo++++```markdown++# STORYBOARD — acme-promo-15s++++**Total duration:** 15s · 30fps · 1920×1080++**Style profile:** see `assets/style-profile.md`++++## Act structure++++- Act 1 (0–3s): hook — "Why is this still so hard?"++- Act 2 (3–11s): body — three benefits in kinetic type + product shot++- Act 3 (11–15s): CTA — logo + URL, 4s hold++++## Timing table++++| # | Start | Dur | Scene file | Concept |++|---|-------|-----|------------|---------|++| 0 | 0.0 | 15.0 | `ambient-bg.html` | Perspective-grid background |++| 1 | 0.0 | 1.5 | `01-hook.html` | "Why is this still so hard?" kinetic type |++| 2 | 1.4 | 0.4 | `02-whip.html` | Light-streak whip transition |++| 3 | 1.5 | 2.0 | `03-benefit-fast.html` | "Fast" + comet streak |++| 4 | 3.5 | 2.0 | `04-benefit-simple.html` | "Simple" + object morph |++| 5 | 5.5 | 2.0 | `05-benefit-reliable.html` | "Reliable" + flowchart |++| 6 | 7.5 | 2.5 | `06-product-shot.html` | App showcase block |++| 7 | 10.0 | 1.0 | `07-logo-crystallize.html` | Logo crystallizes |++| 8 | 11.0 | 4.0 | `08-cta-outro.html` | Wordmark + URL hold |++++## Beat 1 — Hook (0.0–1.5s, 1.5s) — "Why is this still so hard?"++++**Visual elements:**++- Perspective grid floor (ambient, already on)++- Five words, chrome gradient, Inter 96px, centered++- Hero word "hard?" scales 1× → 8× camera-dolly-through at 1.0–1.5s++++**Motion language:** kinetic typography, per-word stagger, final word dolly-through++++**Eases used:**++- Entry per word: `power3.out`, duration 0.5s, stagger 0.08s++- Each word fade-out: `power2.in`, duration 0.4s, overlaps next by 0.15s++- "Hard?" dolly: `power2.in`, duration 1.0s, scale 1 → 8, opacity 1 → 0++++**Exit transition:** light-streak whip (Beat 2) fires at t=1.4s, crosses the grid, hard cut on the streak peak at t=1.6s++++**Audio:** VO "Why is this still so hard?" (TTS `am_adam`) · ambient pad `data-volume="0.15"`++++## Beat 2 — Whip (1.4–1.8s, 0.4s) — Motion-blur transition++++**Visual elements:**++- Single horizontal streak: `linear-gradient(90deg, transparent, #fff, transparent)`, 40% width, 8px tall, blur 6px++- Hides the cut between Beat 1 and Beat 3++++**Motion language:** speed line, no content++++**Eases used:**++- `xPercent: -100` → `xPercent: 250`, duration 0.4s, `power3.in`++++**Exit transition:** N/A (is itself the transition)++++**Audio:** whoosh SFX at 0.2 volume++++## Beat 3 — Fast (1.5–3.5s, 2.0s) — "Fast" benefit++++... (and so on)++```++++---++++## Rules the storyboard enforces++++1. **Every beat ≤ 2 seconds** unless it's the hero moment or outro.++2. **Every transition has a name and a duration** — no "and then we cut to the next scene" hand-waving.++3. **Every beat names its eases** (at least entry + exit). Don't let every beat default to `power2.out`.++4. **The outro holds 4–6 seconds.** No exceptions.++5. **At least one visual callback** appears in Act 2 or Act 3 — an element that echoes something set up earlier (MOTION_PHILOSOPHY §0 Law 6).++6. **Rule of threes** where possible — 3 benefits · 3 product surfaces · 3 icons. The reference Infinite spot uses it everywhere.++7. **Ambient background composition** always present on `data-track-index="0"` for the full duration.++++---++++## After writing++++Show the storyboard + timing table to the user. They will often:++- Cut a beat ("I don't need 'Reliable,' combine it with 'Simple'")++- Shift an emphasis ("the hook should be longer so it lands")++- Ask for different transition feel ("this should feel more cinematic, less energetic")++++Iterate. Don't build until they approve.diff --cc .agents/skills/make-a-video/references/style-intake.mdindex 0000000,0000000..0959406new file mode 100644--- /dev/null+++ b/.agents/skills/make-a-video/references/style-intake.md@@@ -1,0 -1,0 +1,130 @@@++# Style Intake — How to Interview Without Imposing a Brand++++Used by `/make-a-video` Gate 3. The goal: extract the user's visual identity (or fall back cleanly when they don't have one) without ever picking a brand *for* them.++++## The decision tree++++```++Does the user have a style guide, brand doc, or explicit palette?++├── Yes → Extract values → Use exactly what they supplied++├── Partial (some answers, not all) → Fill gaps with MOTION_PHILOSOPHY defaults, flag the gaps in BRIEF.md++└── No → Offer MOTION_PHILOSOPHY defaults AND ask for reference videos as a fallback++```++++## MOTION_PHILOSOPHY defaults (the fallback, only when user declines to supply a style)++++### Palette++++| Role | Value |++|---|---|++| Background | `#000` (pure black) or `#0a0a0a` (near-black) |++| Chrome text gradient | `linear-gradient(180deg, #ffffff 0%, #999999 60%, #cccccc 100%)` with `-webkit-background-clip: text; color: transparent;` |++| Grid lines | `rgba(255, 255, 255, 0.05)` |++| Vignette | `radial-gradient(ellipse at center, transparent 30%, black 100%)` |++| Accent | ONE hex picked for symbolic meaning — ask the user "what's the ONE emotion of this video?" and map it |++++Keep accent discipline tight. MOTION_PHILOSOPHY §0 Law 7: ≤5 symbolic colors across the whole video, each with a named meaning.++++### Fonts++++- **Headlines / kinetic type:** Inter (Google Fonts), weight 700++- **Mono (code, numbers, terminal):** JetBrains Mono, weight 500++- Load via `<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Inter:wght@400;700&family=JetBrains+Mono:wght@500&display=swap">`++++Variations allowed: Space Grotesk or Geist for a tech feel, Instrument Serif for editorial, Bebas Neue for impact. **One display family plus one mono.** Two sans-serifs in the same piece almost always looks wrong.++++### Textures (always on, even with custom palette)++++- Perspective grid floor (low-opacity lines)++- Vignette layer on top++- Film grain: `npx hyperframes add grain-overlay` installed as a component++- Crosshair `+` markers at grid intersections (optional but recommended)++++---++++## When the user supplies hex codes++++1. **Ask for at least three roles:**++ - Background++ - Primary text / main accent++ - Secondary accent (the "emotion" color)++ - (Optional: surface · border · warn)++++2. **Enforce the ≤5 symbolic colors rule.** If they give you 8 colors, ask which three carry narrative work and which five are decorative — drop the decorative.++++3. **Assign meaning to each color.** One sentence per color, e.g. "cyan = action, orange = warning, white = brand voice." Save the mapping in the project's `style-profile.md`.++++4. **Check contrast.** If accent hex on background hex is below 4.5:1 for text-sized elements, flag it to the user. Text on a dark background often needs a `text-shadow` halo to read well — MOTION_PHILOSOPHY §2.2 covers the recipe.++++## When the user supplies fonts++++1. Resolve Google Fonts names → `<link>` tags. If a font is custom, capture the file path and plan a `@font-face` declaration.++2. Confirm weights: default to Regular (400) + Bold (700) + one display weight if specified.++3. Pair rule: one display / headline family + one mono. Avoid stacking two sans-serifs.++++## When the user supplies a logo++++1. Ask for: file path · clearspace preference · any known glow/effect spec++2. In `style-profile.md` record: path · dimensions · CSS filter recipe (e.g. `drop-shadow(0 0 40px rgba(accent, 0.6))` if they want a glow)++3. Never recolor or stretch the logo in compositions.++++## When the user supplies reference videos++++1. Watch / read the references. If URLs, fetch them.++2. Extract:++ - Dominant palette (2–4 hex codes)++ - Type feel (serif · sans · mono · display)++ - Pacing (kinetic · balanced · relaxed)++ - Primary motion vocabulary (whip-pans · morphs · fades · glitches · 3D reveals)++3. Propose a derived palette + font pair + pacing. **Confirm with the user** before building.++++---++++## `<project-folder>/assets/style-profile.md` — what it contains++++```markdown++# Style Profile — <project-slug>++++## Palette++- bg: #... (role: background)++- text: #... (role: primary text)++- accent: #... (role: <named meaning>)++- warn: #... (optional, role: ...)++- surface: #... (optional)++++## Fonts++- Display: <Family Name> (weight(s), loaded from Google Fonts or file path)++- Mono: <Family Name> (weight, loaded from ...)++++## Logo++- Path: assets/<logo-file>++- Clearspace: <e.g. half a logo-height on all sides>++- CSS filter (if any): filter: drop-shadow(0 0 40px rgba(..., 0.6));++++## Source of profile++- [ ] Provided by user (style guide / brand doc)++- [ ] Derived from reference videos (confirmed by user)++- [ ] MOTION_PHILOSOPHY defaults (user declined to supply)++++## Meanings (≤5 colors)++- <color> = <meaning>++- ...++```++++Every composition in Gate 6 pulls from this file. It's the project's single source of truth.++++---++++## The discipline that applies regardless of palette++++Even when the user chooses a fully custom palette, keep these MOTION_PHILOSOPHY principles. They're aesthetic-agnostic:++++- 1–2 second scenes in the body of the video++- One idea per beat++- ≤5 symbolic colors, each with a named meaning++- Grid / vignette / grain texture on every scene++- Motion-blur transitions (whip-pans, morphs) — never hard cuts++- Hold the outro 4–6 seconds++- At least one visual callback (element that returns later)++++Brand changes. Discipline doesn't.diff --cc .agents/skills/short-form-edit/SKILL.mdindex 0000000,0000000..cdd71a7new file mode 100644--- /dev/null+++ b/.agents/skills/short-form-edit/SKILL.md@@@ -1,0 -1,0 +1,324 @@@++---++name: short-form-edit++description: Turn talking-head footage into a finished reel, YouTube Short, or short advertisement with curiosity-led openings, earned payoffs, story-driven cuts, transcript-synced motion graphics, moving B-roll, captions, subtle music, and synchronized sound effects. Use for short-form editing; use edit-video for long-form videos and cut-silences for pause removal alone.++---++++# Short form edit++++Input: a source-video path and an optional reference-reel path.++++Deliver the requested formats and the editable project. Default to 1080x1920;++when requested, also compose 1920x1080 with its own framing and text placement.++Verify each aspect ratio independently, including its opening and CTA. The edit must tell the++speaker's story through images, timing, and sound. Virality is an aspiration, not++a result that editing can guarantee. Work locally unless delegation is requested.++++## Priority++++The first creative gate is: **"In the first 3 seconds is someone convinced they++need to watch until the end?"** Establish a specific reason to stay and earn its++payoff inside the video. Effects, asset volume, and production polish come after++this test. Treat the answer as editorial judgment until audience data exists.++++## Establish the edit++++1. Read the scoped workspace guide, `MOTION_PHILOSOPHY.md`, and the HyperFrames++ and video-storytelling skills before composition work. Use the user's brief++ over aesthetic defaults. Keep all artifacts in `video-projects/<slug>/`.++2. Probe the supplied source and reference: duration, dimensions, frame rate,++ audio, and existing transcript identity. Preserve originals. Transcribe with++ ElevenLabs Scribe using the workspace script. Never substitute an older take.++3. When a reference is supplied, inspect the entire reel using contact sheets,++ individual full-size frames, and contiguous frame strips at representative++ transitions. Review its sound when an audio-capable review surface is available.++ Save `REFERENCE-ANALYSIS.md` with timestamped observations, inferred principles,++ and explicit limits. Do not imply you heard audio based on waveform analysis.++ Read [reference-analysis.md](references/reference-analysis.md) for the reusable++ worksheet and analysis questions. Borrow editorial mechanisms, not branded copy.++4. Before locking the concept, inspect the supplied footage, brand assets, and++ relevant source demos. Save an asset shortlist with exact usable intervals,++ visible action, consequence, provenance, and a possible story role. Let a++ distinctive source moment shape the idea. Choose what reads in one glance;++ fit the complete action and result before considering a tighter crop. A filled++ frame is not useful if the viewer cannot see what is happening.++5. Read every spoken line. Run silence and mistake tools, then manually review++ the full transcript: a zero-candidate report can miss an obvious retake.++ Remove abandoned takes, preserve meaningful qualifications and the payoff,++ and keep natural breath around joins. Save reviewed source-time cut reasons.++ Render the clean cut once and derive word timing from the actual frame-aligned++ EDL. Lock the cut after the rough animatic, before polished graphics. Every later timing change rebuilds dependent++ captions, graphics, and sound from the same map.++++User authorization persists. An instruction to make a finished video and iterate++authorizes ordinary local editing and rendering. An explicit request for Kie++B-roll authorizes those generations. Resolve review gates through the current++authorization; ask only for missing approval, not again at every draft. Never post++the reel or contact anyone without explicit authorization.++++## Design the emotional journey++++Write `DESIGN.md` and a beat plan before HTML. Identify the hook, open loop,++escalation, evidence, payoff, and CTA. Give every shot a reason to exist.++++Read [curiosity-and-entertainment.md](references/curiosity-and-entertainment.md).++Create `OPEN-LOOPS.json` with each honest viewer question, planted object,++setup time, reminders or partial answers, closure time, and the spoken evidence++that earns the closure. Default to one main loop and at most one secondary loop++open at once. Close the promised lesson before the CTA; a comment request must++not be the only answer. A recurring object alone is not an open loop: establish++what is missing or unresolved, then visibly change that state.++++Build three materially different rough openings using the same truthful source++speech. Compare the first three seconds for topic clarity, curiosity, muted++comprehension, and follow-through. Choose and record the reason; do not select++only the loudest effect. Render a low-resolution moving animatic with speech and++rough sound before polishing materials. Fix predictability, missing context, or++weak payoffs at this stage. Existing approved materials can be reused, but still++review the new sequence before spending time on final rendering.++++Vary rhythm by sequence: a short cluster of discoveries, a brief anticipation,++then a payoff. Preserve word timing while varying animation speed and scale.++The 1-2 second event guideline is not a metronome or permission to add filler.++Allow the speaker's expression to carry a conviction beat. For every shot record++the viewer's expectation and the new information or consequence it supplies.++++Audit information duplication. Narration and captions carry the exact words;++graphics should usually show the example, relationship, evidence, or consequence.++Remove a third restatement as a headline unless deliberate emphasis earns it.++Prefer a specific product action or source detail to generic typing footage.++Do not invent a product result simply to make a more satisfying payoff.++++### Treat the first three seconds as a separate edit++++For each opening record the viewer benefit, unresolved question, visible evidence++by second three, and the exact payoff scene. Reject vague teasing and any promise++that this footage cannot fulfill. An advertisement may resolve a concrete example++or explain a mechanism before inviting the viewer to learn more; it must not++promise a complete tutorial and deliver only a registration CTA.++++Make the first frame immediately meaningful. A surprising action, contradiction,++result glimpse, or revealing human expression can establish the tension. Choose++an impact or transition only when it sharpens that idea. A quiet impossible-looking++result can beat a loud montage. Avoid a mandatory stamp, flash, or 0.3-second effect.++++Use a supplied sound reference when available. Remove recording lead-in, align++the effect's audible impact with the visual landing within two frames, and shape++its level and tail around the first words. Make the hit noticeable while keeping++speech clear; briefly dip the music if helpful. Do not make loudness the only hook.++++The opening still has to work muted. Establish the topic or tension immediately,++then reveal another meaningful state within the first three seconds. Avoid an++unrelated logo bumper, added silence, repeated flashes, or an effect that delays++the argument. Match the chosen material style. Vary the device between reels;++do not automatically stamp STOP on every video.++++Save a first-three-seconds shot/sound plan and inspect the encoded opening++frame by frame, including its first frame, impact, reveal, and return to the main++edit. Check that the first spoken word survives the impact mix. Record this as++a distinct opening-hook gate in the verification report.++++### Build the visual world++++- Choose a visual direction from the subject, audience, source material, and++ brand brief. Record why it suits this story. Documentary footage, visual comedy,++ product demonstrations, and designed objects are options, not required quotas.++ Use coherent colors, type, and transitions without imposing paper on every reel.++- Choose full speaker, split, or full supporting footage by the current attention++ target. Preserve expressions, gestures, and the evidence in each requested ratio.++- Plan rhythm by sequence: burst, anticipation, reveal, and breathing room. Treat++ 1-2 seconds as a pacing diagnostic, not a cutting schedule. Keep longer holds++ when a developing action or performance earns them, and record the reason.++ Assign transitions by their editorial purpose, never by shot-index rotation.++- Escalate and release. Use short moments of relative stillness to land conviction++ or a reveal. Do not enforce the long-form 4-6-second outro on a short reel.++- Use an object callback: the unfinished model planted in the hook should resolve++ at the payoff. Show relationships and transformations, not just successive++ title cards. A viewer watching muted should still follow the central idea.++- Keep text within a phone-safe region. For 1080x1920, start with x=90..930,++ y=200..1600, reserving the right edge and bottom for social UI. Adjust captions++ to actual face position in every layout. Use short phrase groups and exact++ word onsets; keyword emphasis must preserve the speaker's wording.++++For a minimal, Apple-style brief, read++[premium-motion-and-footage.md](references/premium-motion-and-footage.md).++Use restrained type, negative space, real object depth, directional light, and++soft contact shadows. Minimal composition can still have rich, purposeful motion++and sound. Do not mistake a small object on a blank slide for premium design.++++### Make the reel entertaining through layers and actions++++Give the eye one clear attention target. Use depth, occlusion, light, and camera++movement when they make the action easier to follow. Keep typography readable++and use dimensional treatment only when the chosen material world calls for it.++For a paper brief, inspect fibers, edges, folds, contact shadows, and perspective++in the encoded output. These are conditional craft checks, not universal style rules.++++Give every extended graphic beat an action with an outcome: a key seats and a++project starts, criteria turn into checks, a card opens to reveal a result, or a++stack assembles into a system. A card such as Define good can swivel or tilt so++its edge and moving contact shadow remain visible as its criteria resolve.++Avoid settle-and-freeze title cards. Subtle secondary motion supports the main++action; identical idle bobbing applied to every object is not storytelling.++++Use the supplied human-edited reference to study how attention moves: wide++context, isolated detail, interaction, visible consequence, then return to the++speaker. Before delivery ask what makes each sequence entertaining beyond looking++professional. A new heading or a new caption alone is not the answer.++++Audit named people, products, and places in the transcript before storyboarding.++Use a verified portrait when recognizing a real person matters, rather than++defaulting to their name in text. Prefer their own site or an attributable source,++save provenance, and inspect the actual image. Animate the photograph as a++physical object when appropriate, with a meaningful callback. Never generate++a likeness and present it as an authentic photo. A moving portrait remains a++photographic layer and does not count as moving B-roll.++++Review adjacent shots as silhouettes and actions, with headings hidden. If they++still look like the same card reveal, redesign the weaker beat. Vary mechanisms:++tear to reveal, unfold to show scale, press to create, connect to enable, process++to produce a result. Preserve a coherent world and understandable cause and++effect. Spend the strongest action on the most important spoken idea. A user's++engagement score is feedback for iteration, not a metric a validator can certify.++++For product stories, seek real source material: public product pages, official++documentation, authentic screen recordings, and official logos. Record actual++scrolls, selections, or visible interactions when useful. Present real logos on++dimensional surfaces without redrawing an approximate mark or implying endorsement.++Retain source URLs and distinguish authentic product footage from illustrative++interfaces and generated B-roll. Never expose real credentials in captured UI.++An animated source screenshot may be one layer in an explanatory composition,++but it must not substitute for moving B-roll when the brief requires video.++++### Verify brand assets before drawing++++Never invent, approximate, trace from memory, or generate an existing brand's++logo. A radial star is not a substitute for the Claude mark. Use the exact++user-supplied asset first; otherwise obtain the asset from the brand's official++site or media kit. Search engines help locate sources, but do not establish++authenticity. Save the source URL or supplied path, original file, and checksum.++Inspect the artwork before use, preserve its shape and proportions, and animate++the authentic asset or the surface carrying it. Do not alter a logo's geometry++to create depth. Audit every logo occurrence in the final encoded reel against++its source asset, including small marks and recurring motifs. If no verified++asset is available, use plain brand-name text rather than fabricate a mark.++++### Balance graphics with moving footage++++Choose the mix from the story and available evidence. There is no default++graphics/B-roll percentage. Keep a duration ledger with authentic footage,++generated illustration, designed graphics, and speaker-only time; explain the++denominator and count split panels once. Captions over footage remain footage.++A still image with a camera move is a photographic layer, not moving B-roll.++++Use each distinct B-roll scene only once per reel. Another crop, filename, speed,++reverse, or grade does not make it a new scene. Reusing the same selected scene++across the two requested aspect ratios is expected. Record source scene identity,++file hash, and selected interval in `assets/footage-ledger.json`; run the footage++validator below. A graphic callback must develop the original idea into a new++state and composition. It is not permission to replay footage.++++Default to containing the full source frame when a tighter crop hides context.++Keep the subject, action, and consequence visible throughout the selected interval,++with captions outside that action. Inspect beginning, middle, and end in each++ratio at phone size. Dense demo text must not be required to understand a fleeting++insert; isolate a meaningful visible action or give it more time. Avoid duplicated,++blurred background video as an automatic solution for vertical framing.++++Prefer a specific action with a readable consequence. Compare adjacent shots++with headings hidden: if the sequence repeats the same visual mechanism or could++belong in any AI advertisement, replace the weakest insert. Generated metaphors++can add surprise but cannot stand in for captured evidence. Prioritize authentic++human reactions where they support the story.++++## Generate and assemble++++1. Use Kie text-to-video for simple moving inserts when authorized. Verify the++ current official API schema. Save model, prompt, task ID, selected output,++ and generation state; reuse successful jobs rather than resubmitting blindly.++ Download and inspect real video files, including full-size corners throughout++ the selected interval for generated text, logos, or malformed objects. Reframe++ or regenerate defects, then verify the encoded result. B-roll must have genuine motion, not++ a still with a zoom. Static diagrams may be source assets only if the final++ animation meaningfully transforms them. Never generate fake evidence or++ imply a synthetic person is the real named person.++2. Animate graphics from the retimed words. Store each shot's anchor phrase and++ time. Bind sub-element reveals to their own spoken nouns, not arbitrary++ `index * 0.4` staggers. Target within 2 frames of word onset for captions and++ impact events, with at most 0.15 seconds of deliberate visual anticipation.++3. Use the HyperFrames timeline contract: one registered paused timeline per++ composition, full duration coverage, local assets, muted video and separate++ audio. Animate the footage wrapper. Deterministic canvas or CSS 3D is fine;++ use genuine rendered 3D when the metaphor needs it. The framework is a tool,++ not an aesthetic. Preserve editable source.++4. Source or generate an instrumental bed with clear narration space. Save its++ provenance. Normalize the voice before mixing; start the bed roughly 14-20 dB++ below voice, then adjust to the actual track. Duck under speech, fade cleanly,++ and measure the final mix. Aim around -16 LUFS and <= -1 dBTP, adapting to++ source dynamics rather than crushing them.++ When the user says music is too loud, reduce its gain relative to the reviewed++ version and save the measured change. Verify after final normalization that++ the bed-to-voice ratio is lower; a lower master level alone is not a fix.++5. Build SFX from the visual-event map. Paper impacts land on object contact;++ swipes support movement; restrained success tones support checks. Align the++ audible onset or impact peak, not just the beginning of an audio file with++ leading silence. Vary effect density and levels. Voice remains dominant.++ Score anticipation, contact, and release separately. A brief bed dip can make++ the next contact more distinct without raising its volume. Let some cuts pass++ without a whoosh. Record cue purpose and audition transitions when supported.++ A request for more SFX calls for a richer event score: paper movement, object++ contact, docking, connection, anticipation, and reveal can each have distinct++ sounds. Make meaningful contacts perceptible, vary texture and density, and++ retain quieter conviction beats. Do not substitute louder music or a whoosh++ on every cut. Inspect the actual animation landing before setting each cue.++6. Run lint and inspect the live preview before rendering. Browser automation is++ headless with Pointer Lock and pointer capture disabled in every context.++ Local automated review is permitted when the user authorized autonomous++ iteration. Render a draft, inspect it, revise, then render final quality.++ If the framework capture stalls, a deterministic graphics export plus FFmpeg++ assembly is acceptable. Await local fonts before capturing canvas. Normalize++ every video input to the same frame time base before overlaying, and inspect++ every encoded cut for one-frame mismatches. Build final face crops from the++ native-resolution source rather than a downscaled editing proxy.++++## Gates before delivery++++Use [quality-gates.md](references/quality-gates.md). The plan validator catches++structural defects but cannot certify taste, motion, or the audio listening pass:++++```powershell++node .agents/skills/short-form-edit/scripts/validate-plan.mjs video-projects/<slug>++node .agents/skills/short-form-edit/scripts/validate-footage.mjs video-projects/<slug>++```++++It reads `assets/plan.json`, `assets/transcript.json`, and++`assets/edit-decisions.json`. See [plan-schema.md](references/plan-schema.md).++For another implementation, export that schema or adapt the validator explicitly;++never silently skip checks because the schema differs.++++Inspect encoded hero frames for every shot at full size and phone scale. Inspect++contiguous strips across every cut and transition, plus the complete motion where++supported. Check speech joins, fresh ASR from final audio, voice/bed balance,++SFX timing, clipping, and the last syllable. Distinguish listening from signal++analysis. Record any unavailable review modality honestly.++++Run a separate uninterrupted entertainment review of the animatic and final++where real-time video review is supported. Record attention-drop timestamps,++predictable sequences, unresolved promises, and reading overload in++`ENTERTAINMENT-REVIEW.md`. Fix the weakest sequences, then recheck them in context.++Automated playback completion and contact sheets are technical/visual evidence,++not a claim of uninterrupted perceptual viewing. If that modality is unavailable,++use chronological sequence strips and explicit loop-state checks, and disclose++the limit. Never manufacture retention scores or call internal hook comparisons++an audience A/B test.++++Fix findings, archive superseded versions, and repeat the checks affected by each++change. Give `VERIFY.md` the actual output hash, measured results, inspected++artifacts, revisions, and unresolved limits. Do not claim passes based on code++inspection, file existence, or an empty validator result.++++## Delivery++++Return a playable final MP4, its absolute path, and the skill path. Keep the++composition, assets, source and retimed transcripts, EDL, shot/event plan, audio++stems, reference analysis, and QA evidence in the project. Clearly identify the++final version. Never label a draft final or claim guaranteed viral performance.diff --cc .agents/skills/short-form-edit/references/curiosity-and-entertainment.mdindex 0000000,0000000..87fd5ffnew file mode 100644--- /dev/null+++ b/.agents/skills/short-form-edit/references/curiosity-and-entertainment.md@@@ -1,0 -1,0 +1,79 @@@++# Curiosity and entertainment workflow++++First and highest-priority test: "In the first 3 seconds is someone convinced++they need to watch until the end?" Record the benefit, question, and earned++payoff that support the judgment. A technical validator or internal comparison++cannot establish that actual viewers are convinced.++++Prioritize this gate over every aesthetic score. If the opening only earns++"that looked cool" and cannot answer "why should I stay?", revise it before++rendering the final. Document the editorial reason to pass or revise; never++invent a percentage of viewers convinced. Check again on the encoded export.++++## Before composition++++1. Read the exact retained speech. State the useful lesson a viewer receives by++ the end. Keep qualifications and do not manufacture a claim for a hook.++2. Pick an unresolved state viewers can understand immediately. Examples:++ three empty slots around an AI model; a project with an unfilled access slot;++ two parts that appear incompatible. Make the missing information specific.++3. Map setup, partial answer, reminder, and resolution. Use one main question++ with short subordinate questions, rather than many unrelated mysteries.++4. Draft three different openings: problem first, result glimpse, or recognition++ first. Each must lead naturally into the same source narration. Render their++ first three seconds cheaply, compare, and record the choice.++5. Build the entire moving rough edit. Use simple shapes and existing assets.++ Judge story before shadows. Recut speech only when needed and preserve its++ meaning; rebuild all timing-dependent artifacts after any EDL change.++++## Loop ledger++++Save OPEN-LOOPS.json as an array. Each item has:++++```json++{++ "id": "main",++ "question": "What fills the three missing slots?",++ "object": "Three numbered empty slots around the model",++ "setup": 2.3,++ "updates": [{"time": 5.1, "state": "First slot becomes the specification"}],++ "closure": 38.4,++ "resolution": "All three named layers assemble around the same model",++ "supportingSpeech": "an entire system around Claude"++}++```++++Times are output seconds. A checker can verify order, coverage, and source++anchors; only rendered inspection establishes whether the question is clear.++An object reappearing without resolving anything is a callback, not a closed loop.++Add an `opening` object with `benefit`, `evidenceBy3`, and `payoffTime` so the++highest-priority test has concrete evidence. Keep `supportingSpeech` verbatim++when quoting; label any paraphrased explanation as a paraphrase.++++## Direct each sequence++++- Expectation: what does the viewer think happens next?++- Development: what changes their understanding or gives a partial answer?++- Payoff: what result, contrast, or connection lands?++- Attention: which single thing should their eye follow?++- Rhythm: where does density increase, briefly release, then resolve?++- Sound: which cue anticipates, contacts, or releases? Which cuts stay quiet?++++Do not force suspense into a straightforward explanation. Do not withhold the++topic, fabricate a failure, or add a vague "wait for it". A deliberately incomplete++editorial model must not be presented as an actual product failure or output.++Showing all answers on the first card closes a list-based loop prematurely.++++## Review++++At rough and final stages, review uninterrupted motion and actual sound when++the runtime supports perception of them. Record the actual modality. When only++stills/strips and signal analysis are available, use those honestly: inspect++chronological 0.25-0.5 second samples plus contiguous action strips, audit every++loop state, and do not call successful automated playback a listening/viewing pass.++++Write timestamped weaknesses and decisions in ENTERTAINMENT-REVIEW.md. Compare++adjacent shots without headings; remove generic footage and repeated headline++copy that add no information. Distinguish audience measurements from editorial++judgment. If future user-provided retention data exists, relate drop-offs to exact++edit moments without assuming the edit caused them.diff --cc .agents/skills/short-form-edit/references/plan-schema.mdindex 0000000,0000000..17ed23bnew file mode 100644--- /dev/null+++ b/.agents/skills/short-form-edit/references/plan-schema.md@@@ -1,0 -1,0 +1,65 @@@++# Editable plan schema++++Keep one canonical map. Seconds are on the edited timeline except fields prefixed++with `source`. Quantize cuts and scene boundaries to `1/fps`; retain precise ASR++word timings rather than rounding every word independently.++++`assets/plan.json`:++++```json++{++ "duration": 10,++ "fps": 30,++ "scenes": [{"id":"s00","start":0,"end":10,"layout":"face","kind":"hook","anchor":"First three words","anchorTime":0.1}],++ "events": [{"time":0,"type":"paper-tap","visual":"s00","anchor":"First three words"}],++ "captions": [{"start":0.1,"end":0.8,"words":[{"text":"First","start":0.1,"end":0.3,"sourceStart":1.1,"sourceEnd":1.3}]}]++}++```++++Layouts are `face`, `split`, `paper`, `broll`, and `broll-split`. For this schema,++B-roll scene `kind` names `assets/<kind>.mp4`. `events` are actual meaningful++visual actions, never filler entries inserted only to satisfy cadence. Longer++holds can carry `holdReason` on their scene and must be justified editorially.++++`assets/transcript.json` contains `words` with the same text/start/end/sourceStart/++sourceEnd fields and `text`. `assets/edit-decisions.json` contains `duration`, `fps`,++`keeps` with `{sourceStart,sourceEnd,start,end}`, and reviewed removal reasons.++Every retained word must map back to one kept range without crossing a removed++interval. `sourceStart` may be absent only when no edit was made; adapt validation++explicitly for that case rather than guessing a mapping.++++## Creative companion++++Keep creative reasoning in DESIGN.md alongside the technical map. It must name:++++- Audience, requested aspect ratios, chosen visual direction, and asset shortlist.++- Three distinct opening concepts and their rough preview paths; the selected++ concept's benefit, viewer question, evidence visible by three seconds, and payoff.++- Sequence ranges with expectation, development, consequence, attention target,++ rhythm, and source rationale. Group related shots; avoid redundant per-frame prose.++- OPEN-LOOPS.json using the schema in curiosity-and-entertainment.md. Resolve each++ promised answer before the CTA; verify closure in the rendered sequence.++- Timestamped ENTERTAINMENT-REVIEW.md findings and revisions before polish.++++The plan validator checks timing and coverage. It does not validate these creative++documents or certify engagement; review their claims against the rendered footage.++++## Footage ledger++++For projects with B-roll, `assets/footage-ledger.json` is an array of rows:++++```json++[{"scene":"s02","sourceSceneId":"wallet-opening","asset":"assets/wallet.mp4",++"sha256":"<64 lowercase hex characters>","sourceStart":0.5,"sourceEnd":1.5,++"framing":{"9x16":"Full source contained; hands and wallet visible",++"16x9":"Full source contained; captions outside the action"}}]++```++++Intervals refer to that exact local asset, before playback-speed adjustment.++Record upstream source provenance separately for downloaded excerpts. Scene++identity survives crop, grade, speed, reverse, and transcode changes. Each scene++appears once per reel; the same selection can be used in both requested ratios.++`validate-footage.mjs` verifies selected rows, file hashes, duplicate scene++identities, and overlapping intervals. Visual review must still establish that++the action and result remain visible and that differently encoded duplicates++have not evaded the source identity ledger.diff --cc .agents/skills/short-form-edit/references/premium-motion-and-footage.mdindex 0000000,0000000..88ffbe5new file mode 100644--- /dev/null+++ b/.agents/skills/short-form-edit/references/premium-motion-and-footage.md@@@ -1,0 -1,0 +1,42 @@@++# Premium motion and readable footage++++The first-three-seconds reason-to-stay gate remains the highest priority. This++craft pass improves its delivery; it does not replace curiosity with decoration.++++For a minimal, Apple-style treatment, choose a coherent material family and one++focal action. Build readable object silhouettes, bevelled edges, thickness,++occlusion, directional lighting, and soft contact shadows. Use actual 3D when++camera rotation or assembly needs it. Keep typography clean and subordinate.++Avoid heavy text outlines, arbitrary glowing panels, fake chrome, uniform idle++bobbing, and repeated flat cards. Paper should have visible edges and perspective;++ceramic or metal should show form through light rather than noisy texture.++++Inspect at phone size. Negative space should concentrate attention, not leave++the meaningful object too small. Compare adjacent shots without their headings.++Change action, scale, or camera only when it supplies new information. Alternate++assembly, detail, human expression, evidence, and a resolved wider view. Every++pattern interrupt needs an editorial purpose. Repeated B-roll is prohibited;++a callback uses a changed graphic state or a genuinely new source moment.++++For each B-roll insert, save a ledger row with scene id, semantic sourceSceneId,++asset path relative to project, sha256, sourceStart, sourceEnd, and framing notes++for each delivery ratio. Source intervals refer to that exact asset file. Also++retain upstream provenance for excerpts. Detect duplicate scene IDs and overlapping++intervals from files with the same hash, including renamed copies. Re-encoding can++change hashes, so semantic scene identity and visual review remain necessary.++++Use contain framing by default. An intentional crop must keep the complete++subject, visible action, and result inside a documented region throughout the++selection. Check start, midpoint, endpoint, and action peaks independently in++16:9 and 9:16. Do not enlarge a scene until essential context disappears or place++captions over the evidence. Phone-scale review determines whether a screen demo++communicates anything; passing dimensions alone is insufficient.++++Normalize the voice first. If music was overwhelming, measure its reduction++against the previous stem and preserve the quieter bed-to-voice ratio through++mastering. Add varied SFX tied to physical motion and narrative reveals, not an++arbitrary cue-count quota. Check onset, contact peak, tail, and masking. State++whether a real listening pass was possible; RMS and ASR do not replace hearing.++++Save concrete revision evidence. A requested 10/10 is a quality aspiration, not++a score an internal validator can award.diff --cc .agents/skills/short-form-edit/references/quality-gates.mdindex 0000000,0000000..7487d36new file mode 100644--- /dev/null+++ b/.agents/skills/short-form-edit/references/quality-gates.md@@@ -1,0 -1,0 +1,59 @@@++# Short-form quality gates++++Apply these to the encoded final, not only the source composition.++++| Gate | Required evidence | Fail examples |++|---|---|---|++| Priority 1: reason to stay | "In the first 3 seconds is someone convinced they need to watch until the end?" Specific benefit, unresolved question, and actual ending payoff | Attention grabbed with no reason to continue, vague teasing, promise not delivered |++| Story | Exact retained script, hook, complete argument, payoff, CTA | Repeated retake, missing qualification, unrelated insert |++| Open loops | Viewer question, planted unresolved state, timed partial answers, earned closure before CTA | Random question mark, recurring decoration, withheld basic context, promise never answered |++| Asset discovery | Inspected shortlist before concept lock, exact intervals, legible action and consequence | Storyboard locked before reviewing supplied assets, dense UI shown too briefly to understand |++| Rough edit | Three distinct opening drafts and a moving animatic reviewed before final polish | Choosing by impact loudness, polishing a predictable slideshow |++| Rhythm and reading load | Sequence-level density changes, anticipation/payoff, caption-versus-heading audit | Metronomic cuts, three copies of the same sentence, simultaneous competing reveals |++| Entertainment review | Timestamped critique separate from technical QA, review modality stated | Playback completion reported as audience engagement, fabricated retention score |++| First three seconds | Encoded first frame, immediately meaningful image, specific reason to stay by 3 s, sound/impact alignment, clear opening word | Caption-only opening, long audio lead-in, masked consonant, unrelated bumper |++| Word timing | EDL-derived words, fresh final-audio ASR, spot checks | Cut consonant, missing word, caption ahead of speech |++| Cadence | Shot durations and semantic visual-event map | Repeated template, >2.2 s gap without a deliberate story hold |++| Layout | Every hero frame at full size and phone scale | Face cropped, mouth covered, text beyond safe region |++| Motion | Contiguous encoded frames across every transition | Black flash, one-frame pop, unexpected freeze, conflicting moves |++| Paper depth (paper briefs only) | Close inspection of object edges, shadows, perspective | Flat rectangles used as decorative slide containers |++| Dimensional typography (when chosen) | Full-size and phone-size major headings, bevel/edge, cast shadow, readable perspective | Flat titles above dimensional objects, muddy extrusion, glowing text |++| Layered entertainment | Encoded action-to-result sequences, foreground/background separation, moving object shadows | Same idle bob on every card, title changes without consequence, settle-and-freeze beats |++| Product authenticity | Saved source URLs and reviewed real page interactions or official marks when used | Approximate invented logo, fabricated product evidence, private data in a screen capture |++| Named entities | Transcript audit, verified portrait or authentic source material where recognition matters, saved provenance | Name-only treatment when a recognizable person is central, synthetic portrait presented as real |++| Editorial variety | Adjacent silhouettes and action mechanisms compared; encoded setup, action, and consequence | Repeated card reveal with different words, identical bobbing, visual activity without a story outcome |++| Logo fidelity | Exact supplied or official asset, checksum, and every encoded occurrence compared with it | Generic star used for Claude, traced or generated brand mark, distorted proportions |++| Footage balance | Duration ledger for the supporting track and total runtime; story-based selection rationale, authentic and synthetic separated | Shot-count-only percentage, counting facecam or still-image zooms as B-roll, repetitive diagram run |++| Material realism (physical material briefs) | Encoded close-ups and motion showing fibers, imperfect edges, contact and cast shadows, directional light | Flat cream fills with blur shadows, texture that disappears at phone size, noise obscuring words |++| B-roll | Probed moving footage, sufficient source duration at the chosen speed, reviewed selected interval, exact encoded frame count per segment | Ken Burns still, irrelevant action, synthetic proof, short source clip truncating the final export |++| No repeated footage | Scene identity and file-hash/interval ledger; duplicate and overlap negative controls | Same scene replayed, renamed, recropped, reversed, or regraded as a new insert |++| Action framing | Start, middle, end, and action peaks in each ratio; full subject, action, and result visible at phone size | Enlarged B-roll hides context, captions cover evidence, unreadable UI is the only explanation |++| Minimal dimensional craft (when requested) | Readable focal object, thickness, perspective, restrained type, light and contact shadows; sequence variety | Tiny object on an empty slide, harsh strokes, repeated flat cards, decorative motion |++| Audio revision | Measured bed reduction relative to reviewed version; varied purposeful SFX with inspected contact times | Master merely quieter, bed still masks voice, more music substituted for SFX |++| Sound | Actual listening when supported, plus stem and mix measurements | Voice buried, repeated loud whoosh, onset unaligned, clipping |++| Delivery | Every requested ratio (default 1080x1920; 1920x1080 when requested), independently framed and reviewed, correct duration, fast-start MP4, final hash | Wrong aspect ratio, missing final syllable, stale export |++++The artistic test: each shot advances the story or changes the emotional emphasis.++Remove an effect that only demonstrates the renderer. Most graphics should show++an object doing something: a spec filling, a test resolving, a workspace assembling.++At least one metaphor returns with a changed meaning or completed state.++++Calibrate new validators with negative controls. A caption shifted by 0.3 seconds,++a one-frame scene gap, and an omitted spoken word should fail the relevant checks.++Do not make the validator accept the current output merely to reach green.++++The original workspace motion checklist has brief-dependent defaults. A warm++paper reel deliberately overrides black canvas, chrome text, halos, grids, and a++long outro. Preserve timing discipline, coherent materials, callback, full timeline++coverage, and rendered visual inspection.++++If a review modality is unavailable, state it explicitly. A waveform establishes++levels and timing, not whether music is emotionally right. ASR establishes spoken++content, not whether every audio edit sounds natural. Never count one as the other.++++When replacing a paper scene with footage, choose caption contrast from the++actual background, including qualifiers and small secondary text. Inspect the++first encoded frame of every inserted screen recording: fractional source seeks++must not leave an empty viewport before the footage appears. Review the entire++selected generated-video interval for malformed hands, gibberish focal text,++unintended marks, and implausible actions; generation success is not asset QA.diff --cc .agents/skills/short-form-edit/references/reference-analysis.mdindex 0000000,0000000..4902b50new file mode 100644--- /dev/null+++ b/.agents/skills/short-form-edit/references/reference-analysis.md@@@ -1,0 -1,0 +1,29 @@@++# Analyze a short-form reference++++Use a reference the student supplies and has permission to use. Keep the recording++and analysis inside the private video project. Do not copy its script or assets.++++## Watch and record++++Watch the full video once for its promise and payoff, then again with timestamps.++For each meaningful change, record:++++| Time | Spoken idea | Visual change | Sound cue | Viewer question | Payoff |++| --- | --- | --- | --- | --- | --- |++| Fill from the supplied reference | Verbatim phrase | Framing, footage, or graphic | Audible impact | What remains unresolved | Where it resolves |++++Measure the actual resolution, duration, and frame rate. Separate observations++from your interpretation of why a choice works. A fast montage does not imply++that every new edit needs the same number of cuts.++++## Transfer the mechanism++++- Make the opening visual support a truthful promise in the spoken hook.++- Use a brief crop or caption emphasis on a specific word, then return to rest.++- Cut to moving footage when it supplies evidence or explains something concrete.++- Give each sound cue a visible event; align its audible impact, not its file start.++- Build curiosity that the retained recording actually resolves.++- End after the payoff with enough room for the intended action to be understood.++++Write which mechanisms fit this recording and which would distract from it.++Design new copy, scenes, and motion from the student's own transcript and brief.diff --cc .agents/skills/short-form-edit/scripts/validate-footage.mjsindex 0000000,0000000..4d4be23new file mode 100644--- /dev/null+++ b/.agents/skills/short-form-edit/scripts/validate-footage.mjs@@@ -1,0 -1,0 +1,25 @@@++import fs from 'node:fs';import path from 'node:path';import crypto from 'node:crypto';++export function validateFootage(rows){++ const errors=[],seen=new Set();++ for(let i=0;i<rows.length;i++){++ const r=rows[i];if(!r.sourceSceneId)errors.push(`Missing scene identity: ${r.scene}`);++ else if(seen.has(r.sourceSceneId))errors.push(`Repeated footage scene: ${r.sourceSceneId}`);seen.add(r.sourceSceneId);++ if(!/^[a-f0-9]{64}$/.test(r.sha256||''))errors.push(`Missing asset hash: ${r.scene}`);++ if(!(r.sourceStart>=0&&r.sourceEnd>r.sourceStart))errors.push(`Invalid interval: ${r.scene}`);++ for(const previous of rows.slice(0,i))if(previous.sha256===r.sha256&&Math.min(previous.sourceEnd,r.sourceEnd)>Math.max(previous.sourceStart,r.sourceStart)+.001)errors.push(`Overlapping footage: ${previous.scene} / ${r.scene}`);++ }++ return {ok:errors.length===0,errors,scenes:rows.length};++}++if(process.argv[1]&&path.resolve(process.argv[1])===path.resolve(import.meta.filename)){++ const root=path.resolve(process.argv[2]||'.'),plan=JSON.parse(fs.readFileSync(path.join(root,'assets/plan.json')));++ const footage=plan.scenes.filter(s=>s.layout?.includes('broll')||s.mode==='footage');++ const ledgerPath=path.join(root,'assets/footage-ledger.json'),rows=fs.existsSync(ledgerPath)?JSON.parse(fs.readFileSync(ledgerPath)):[];++ const result=validateFootage(rows);++ for(const s of footage)if(rows.filter(r=>r.scene===s.id).length!==1)result.errors.push(`Missing or duplicate ledger row: ${s.id}`);++ for(const r of rows){++ const asset=path.resolve(root,r.asset);if(!asset.startsWith(root+path.sep)||!fs.existsSync(asset)){result.errors.push(`Missing local asset: ${r.scene}`);continue;}++ if(crypto.createHash('sha256').update(fs.readFileSync(asset)).digest('hex')!==r.sha256)result.errors.push(`Asset hash mismatch: ${r.scene}`);++ if(!footage.some(s=>s.id===r.scene))result.errors.push(`Unselected ledger row: ${r.scene}`);++ }++ result.ok=result.errors.length===0;console.log(JSON.stringify(result,null,2));process.exitCode=result.ok?0:1;++}diff --cc .agents/skills/short-form-edit/scripts/validate-plan.mjsindex 0000000,0000000..0860bdanew file mode 100644--- /dev/null+++ b/.agents/skills/short-form-edit/scripts/validate-plan.mjs@@@ -1,0 -1,0 +1,38 @@@++import fs from 'node:fs';import path from 'node:path';++export function validatePlan(plan,transcript,edl,exists=()=>true){++ const errors=[],fail=m=>errors.push(m),fps=plan.fps,tol=1/fps+.005;++ if(!Number.isFinite(fps)||fps<=0)fail('Invalid fps');++ if(!plan.scenes?.length)fail('No scenes');++ const words=transcript.words.filter(w=>w.type!=='spacing');++ const caps=(plan.captions||[]).flatMap(g=>g.words);++ if(caps.length!==words.length)fail(`Caption word count ${caps.length} != retained word count ${words.length}`);++ words.forEach((w,i)=>{++ const cap=caps[i];if(!cap||cap.text!==w.text)fail(`Caption ${i} missing or different`);++ else if(Math.abs(cap.start-w.start)>.005||Math.abs(cap.end-w.end)>.005)fail(`Caption ${i} timing differs from transcript`);++ if(w.end<=w.start||w.start<0||w.end>plan.duration+tol)fail(`Word ${i} outside timeline`);++ const k=edl.keeps.find(k=>w.sourceStart>=k.sourceStart-.016&&w.sourceEnd<=k.sourceEnd+.016);++ if(!k)fail(`Word ${i} crosses a cut or has no source range`);++ else if(Math.abs(w.start-(k.start+w.sourceStart-k.sourceStart))>.006)fail(`Word ${i} source mapping incorrect`);++ });++ let end=0;const ids=new Set();for(const s of plan.scenes||[]){++ if(ids.has(s.id))fail(`Duplicate scene ${s.id}`);ids.add(s.id);++ if(Math.abs(s.start-end)>.005)fail(`Scene gap or overlap at ${s.id}`);++ if(s.end<=s.start)fail(`Scene ${s.id} has no duration`);++ if(Math.abs(s.start*fps-Math.round(s.start*fps))>.01)fail(`Scene ${s.id} is not frame aligned`);++ if(!s.anchor||!Number.isFinite(s.anchorTime))fail(`Scene ${s.id} has no verified anchor`);++ else if(s.anchorTime-s.start<-.15||s.anchorTime-s.start>.2)fail(`Scene ${s.id} anchor not close to cut`);++ if(s.layout.includes('broll')&&!exists('assets/'+s.kind+'.mp4'))fail(`Missing moving B-roll ${s.kind}`);++ end=s.end;++ }++ if(Math.abs(end-plan.duration)>.005)fail('Scene coverage differs from duration');++ const times=[0,...(plan.events||[]).map(e=>e.time),plan.duration].sort((a,b)=>a-b);let maxGap=0;++ for(let i=1;i<times.length;i++){const gap=times[i]-times[i-1];maxGap=Math.max(maxGap,gap);if(gap>2.2){const s=plan.scenes.find(s=>times[i-1]>=s.start&×[i-1]<s.end);if(!s?.holdReason)fail(`Unexplained visual-event gap ${gap.toFixed(2)}s at ${times[i-1].toFixed(2)}`);}}++ for(const e of plan.events||[])if(!ids.has(e.visual)||e.time<0||e.time>=plan.duration)fail('Invalid visual event '+JSON.stringify(e));++ for(let i=0;i<(plan.captions||[]).length;i++){const g=plan.captions[i];if(g.start>g.words[0].start+.005||g.end<g.words.at(-1).end-.005)fail('Caption group truncates word '+i);if(i&&g.start<plan.captions[i-1].end-.005)fail('Caption groups overlap '+i);}++ return {ok:!errors.length,errors,metrics:{duration:plan.duration,retainedWords:words.length,scenes:plan.scenes.length,averageShotSeconds:plan.duration/plan.scenes.length,visualEvents:plan.events.length,maxEventGap:maxGap,speakerShare:plan.scenes.filter(s=>['face','split','broll-split'].includes(s.layout)).reduce((a,s)=>a+s.end-s.start,0)/plan.duration}};++}++if(process.argv[1]&&path.resolve(process.argv[1])===path.resolve(import.meta.filename)){++ const root=path.resolve(process.argv[2]||'.');const read=n=>JSON.parse(fs.readFileSync(path.join(root,'assets',n)));++ const result=validatePlan(read('plan.json'),read('transcript.json'),read('edit-decisions.json'),p=>fs.existsSync(path.join(root,p)));++ console.log(JSON.stringify(result,null,2));process.exitCode=result.ok?0:1;++}diff --cc .agents/skills/short-form-video/SKILL.mdindex 0000000,0000000..9b61e04new file mode 100644--- /dev/null+++ b/.agents/skills/short-form-video/SKILL.md@@@ -1,0 -1,0 +1,330 @@@++---++name: short-form-video++description: Maintain the existing May Shorts teaching compositions using their legacy face-mode, scene-overlay, and karaoke-caption patterns. Use only when working on those examples or explicitly requesting this legacy scaffold. For new reels, Shorts, or short advertisements, use short-form-edit.++---++++# Short-Form Vertical Video (Hyperframes)++++Short-form = 1080x1920 vertical, 10–30s, talking-head face + motion-graphic scene overlays + karaoke captions. Everything in this skill is distilled from the May Shorts 19 iteration autopsy (v1 → v4) and is preserved for maintenance of those examples. Use `short-form-edit` for new recordings.++++**Always invoke `/hyperframes` first.** This skill sits on top of it — it does not replace the framework rules (`data-*` attributes, `window.__timelines`, composition structure). Those are non-negotiable regardless of the format.++++## When this skill fires++++- Maintaining the existing May Shorts examples.++- Explicitly requesting their legacy four-layer scaffold.++++## The playbook (high-level)++++1. **Audio is source of truth.** Edit audio FIRST (cut retakes, pauses). Save as `<name>-edit.mp4`. Measure exact duration with `ffprobe` — this is the composition's `data-duration`.++2. **Transcribe the edited audio** with the root `scripts/transcribe-elevenlabs.mjs` helper (ElevenLabs Scribe), or if retiming an existing build with a `shift()` function in captions, keep the existing captions and just shift scene starts.++3. **Author scene boundaries in edited-time** — NEVER mix original-time and edited-time anchors in the same file. See "Audio-sync protocol" below.++4. **Build the composition scaffold** (4 layers: ambient-bg, seam-treatment, captions, face) — see "Composition scaffold" below.++5. **Author scenes with LOCAL offsets** relative to each scene's `data-start`. Each scene is its own sub-composition under `compositions/scene<N>-<label>.html`.++6. **Lint → draft render → word-exact frame verification → final render.** This is the verification gate. Never skip step 3 (frame verification).++++## Composition scaffold (the 4 always-on layers)++++Every short-form vertical has these four sub-compositions under `compositions/`, loaded on shared tracks:++++```++index.html (root, 1080x1920, data-composition-id="main")++├── ambient-bg.html track-index="3" — radial gradient + drift grid + particles + vignette++├── face-wrapper + <video> track-index="0" — talking head (see face-mode choreography)++├── seam-treatment.html track-index="5" — feathers y=960 edge (bottom-half scenes only)++├── scene1-<label>.html track-index="1" — scene overlays (back-to-back, no gaps)++├── scene2-<label>.html track-index="1"++├── …++└── captions.html track-index="2" — karaoke captions, word-synced++```++++- `data-duration` is identical across root, ambient-bg, seam-treatment, face-video, face-audio, captions. Only scene overlays change over time.++- `<audio>` for the face is a SEPARATE element (mixer needs it), never use the video's own audio track.++- `class="clip"` goes on timed divs — NEVER on `<video>` or `<audio>`.++++## Face-mode choreography (the signature move of short-form)++++The face lives in a wrapper div sized at the source's native landscape (1920x1080). GSAP animates the WRAPPER (never the video element — animating `<video>` dimensions freezes frames).++++Two modes:++++```js++const BOTTOM = { x: 0, y: 1136, scale: 0.5625 }; // bottom-half, full landscape visible++const FULLSCREEN = { x: -1166.5, y: 0, scale: 1.7778 }; // cropped-cover, fills 1080x1920++const MODE_DUR = 0.32;++```++++`BOTTOM` renders the 1920x1080 source at 1080x607.5 centered in the bottom 960px. `FULLSCREEN` crops horizontally to fill the portrait frame.++++**Transition 0.15s BEFORE the new scene's content lands**, using `ease: "expo.inOut"`:++++```js++[++ { t: <scene-4-start>, mode: FULLSCREEN },++ { t: <scene-5-start>, mode: BOTTOM },++ …++].forEach(({ t, mode }) => {++ mainTl.to("#face-wrapper", { ...mode, duration: MODE_DUR, ease: "expo.inOut" }, t - 0.15);++});++```++++A face that snaps modes instantly is the single most jarring frame in a vertical video. Always interpolate.++++### Face grading (every short, no exceptions)++++```css++#face-video {++ filter: contrast(1.08) saturate(1.08) brightness(0.97);++}++```++++Plus a subtle 1.00 → 1.025 Ken Burns zoom over the full duration (`ease: "none"`) and a side-vignette `::after` pseudo-element so the face sinks into the surrounding navy instead of butting against a razor edge.++++### Seam treatment (required for bottom-half scenes)++++A navy→transparent gradient band (60–100px) at y=960 plus a 2px accent scan line with soft glow. Draw it AFTER the face so it sits on top; full-screen scenes will cover it when they take over. Razor-sharp y=960 cuts are the #2 tell for AI-edited content (after background flatness).++++## Audio-sync protocol (DO NOT skip)++++**Problem:** if audio is edited (retakes/pauses removed), timestamps in the source transcript no longer match the edited video. Scene starts authored in original-time will fire late.++++**The rule:** ALL timing lives in edited-time. Never mix.++++**Verification procedure for any short-form retime:**++++1. Measure both audio files:++ ```bash++ ffprobe -v error -show_entries format=duration -of csv=p=0 assets/original.mp4++ ffprobe -v error -show_entries format=duration -of csv=p=0 assets/<name>-edit.mp4++ ```++ Difference = total cut time.++2. If using a `shift()` function in `captions.html` to map transcript words, treat that as the source of truth. The map `shift(originalTime) = editedTime` applies to EVERY scene `data-start` too.++3. Scene internal offsets (inside `compositions/sceneN.html`) are LOCAL relative to the scene's `data-start`. If a scene's parent `data-start` is correct in edited-time, internal offsets stay correct WITHOUT modification — UNLESS a scene straddles a cut, in which case both the parent duration AND internal offsets shift.++4. Face-mode transition array times MUST use edited-time. They are NOT automatically shifted.++++**Plan format for retimes** (use this table structure every time):++++| Scene | Current start | Current dur | New start | New dur | Rationale |++|-------|---------------|-------------|-----------|---------|-----------|++| ... | ... | ... | ... | ... | ... |++++Then the face-mode array, then any internal-offset changes, then frame-verification list.++++## Scene authoring++++One scene = one sub-composition file. Scenes sit on the same `data-track-index` back-to-back (no gaps). Inside each scene:++++- `data-duration` matches the parent's slot exactly++- All GSAP anchors are LOCAL (0-based from scene start)++- Use `tl.set({}, {}, <data-duration>)` to pad the timeline so GSAP `tl.duration()` matches `data-duration`++++### Scene pacing rules (from the 10 principles)++++- **No dead frames.** Every 100ms has ≥1 animating element. Offset first entrance 0.1–0.3s, not t=0.++- **Payoff ≥ 1s hold.** The "big reveal" of the scene (stamp, number lock, punchline) must have ≥1s on screen, ideally 1.5s. Budget scenes by reveal time, not total time.++- **Motion through full duration.** If entrance anims all land by local 2s on a 4s scene, add secondary motion: underline sweeps, checkmark pops, ambient drift on cards, small oscillating glows on pills. Dead pacing = swipe-away.++- **Vary eases.** At least 3 different eases per scene across entrances.++- **One jaw-dropper per 5s of runtime.** Typography slam, glitch/chromatic reveal, whip-pan, audio-sync slam. Without these, the video reads as "labeled talking head" — correct but forgettable.++++## Captions (karaoke style)++++- Montserrat 900, 46–58px (for 1080 width), 100% white base++- Active word: scale-1.08 pop + color change to accent (`#37bdf8` for AIS, adapt to brand)++- Stroke via layered `text-shadow`, NEVER `-webkit-text-stroke` (renders inconsistently in Chromium render)++- Drop the rgba background pill — let the stroke hold readability. Captions should feel like graffiti on the frame, not a subtitle track.++- For retimes, use a `shift()` function inside `captions.html` to map transcript word timestamps → edited-time. This keeps the transcript JSON untouched and makes retimes mechanical.++++See `references/captions.md` under `/hyperframes` for the full karaoke implementation. TL;DR: per-word `<span>` elements with `data-word-start`, GSAP tweens scoped to each span, tight 0.08–0.12s pop durations.++++## Ambient background (never ship flat navy)++++Minimum viable background stack:++++1. **Radial gradient base** (center lighter than edges by 15–20%)++2. **Animated noise/grain overlay** at 8–12% opacity++3. **4–8 drifting particle dots** or grid traces++4. **Subtle vignette**++++`background: #07121c` alone is a placeholder, not a design. For techy/control-room aesthetic, use the 6-layer stack from `feedback_techy_background_layers.md` (HUD grid masked to vignette + circuit traces + pulse nodes + scan beam + telemetry ticker + corner mono labels).++++## Audio reactivity++++- Headlines pulse 3–6% on beat. Backgrounds can go 10–30% on bass.++- Text reactivity kept subtle (3–6%) so captions stay readable; backgrounds can push harder.++- Use a SEEDED offline analyser (pre-compute the audio feature track) so renders are deterministic. Do NOT use `AnalyserNode` in the render path — `Math.random()` and real-time audio nodes break determinism.++++## Transitions++++- **Rotate flavors.** No two consecutive transitions the same type. Six hard cuts in a row is the #1 tell for AI editing.++- Face-mode transitions (`BOTTOM ↔ FULLSCREEN`) double as scene transitions when the mode changes between scenes.++- For pure overlay scene-to-scene, install from registry: `push-up`, `flash-through-white`, `sdf-iris`, or the full shader-transitions pack. `npx hyperframes catalog --type block` to browse.++++## The verification gate (mandatory — DO NOT ship without)++++Lint passing ≠ design working. Never report a short-form render done until you have extracted frames at word-exact timestamps and READ every PNG.++++### Step 1 — draft render++++```bash++cd video-projects/<slug>++npx hyperframes lint++npx hyperframes render --quality draft --output renders/<slug>-vN-draft.mp4++```++++### Step 2 — word-exact frame extraction++++Pick 8–15 timestamps that each correspond to a SPOKEN WORD where a specific visual should be on-screen. Not round numbers. Not mid-scene. The exact word.++++```bash++mkdir -p renders/frames-vN++for pair in "<t>:<label>" "<t>:<label>" ...; do++ t="${pair%%:*}"; label="${pair##*:}"++ ffmpeg -y -ss "$t" -i renders/<slug>-vN-draft.mp4 \++ -frames:v 1 -q:v 2 "renders/frames-vN/t${t}-${label}.png"++done++```++++### Step 3 — Read every PNG++++Call `Read` on every PNG so the image loads into context. Do NOT just list filenames. For each frame confirm:++++- The expected visual is on-screen at the expected moment (not 1s late, not early)++- Speaker's face is not cropped in any bottom-half scene++- Full-screen vs bottom-half face mode is correct for that scene++- Captions are on-brand, readable, not overflowing++- No blank frames, no unintentional overlap, no text-off-canvas++++### Step 4 — if anything fails, fix + re-verify. Never ship broken.++++### Step 5 — final render++++```bash++npx hyperframes render --quality standard --output renders/<slug>-vN.mp4++```++++Spot-check 3–4 frames from the final render (same timestamps, different folder `frames-vN-final/`) to confirm the standard-quality encode didn't change anything.++++## The 10 rules (quality checklist — run BEFORE first draft)++++Every short-form build. Run this list during authoring, not after.++++1. **No dead frames.** Every 100ms has an animating element.++2. **Scene payoff ≥ 1s hold.** Budget by reveal time, not total time.++3. **Face is a character.** Grade + Ken Burns + side vignette.++4. **No hard seams.** Feather y=960 with gradient + scan line.++5. **One jaw-dropper per 5s.** Typography slam, glitch, whip-pan, audio slam.++6. **Audio reactivity non-negotiable.** 3–6% text, 10–30% background.++7. **Rotate transition flavors.** No two consecutive the same.++8. **Captions pop, don't politely label.** Stroke not pill. Scale + color on active word.++9. **Motion through full scene duration.** Secondary motion if entrances land early.++10. **Background is a layer, not a color.** Radial + noise + particles + vignette minimum.++11. **Slam/stamp overlays land AFTER target text is fully visible.** Reveal logic > word-sync. Stamp `t` ≥ target-visible `t` + 0.10–0.25s. Otherwise the punchline lands before the setup.++++## Project structure (every short-form project)++++```++video-projects/<slug>/++├── hyperframes.json++├── meta.json (id, name, dimensions 1080x1920, fps 30)++├── index.html (root composition, the 4-layer scaffold)++├── compositions/++│ ├── ambient-bg.html++│ ├── seam-treatment.html++│ ├── captions.html (with shift() function if retiming)++│ ├── scene1-<label>.html++│ ├── scene2-<label>.html++│ └── ...++├── assets/++│ ├── <name>.mp4 (original recording)++│ ├── <name>-edit.mp4 (edited — cuts removed — this is what the comp uses)++│ ├── transcript.json (whisper output)++│ └── brand assets (logo, brand-tokens.css, background music)++└── renders/++ ├── <slug>-v1-draft.mp4++ ├── frames-v1/++ ├── <slug>-v1.mp4++ └── ...++```++++## Retime protocol (when audio is re-edited or timestamps drift)++++1. Measure old and new edited audio durations with `ffprobe`. Delta = total cut time.++2. Identify cut window(s): which seconds were removed, from where.++3. Write the Plan table: every scene `data-start`, `data-duration`, every face-mode transition `t`, any scene whose internal offsets straddle a cut.++4. For each scene that straddles a cut, both its parent duration AND its internal offsets change. Scenes entirely on one side of the cut just need parent `data-start` shifted.++5. Lint → draft render → word-exact frame verify → final render. No shortcuts.++++## What NOT to do in short-form++++- Don't animate `<video>` element dimensions — freezes frames. Animate wrapper div.++- Don't use `repeat: -1` on any timeline — breaks the capture engine. Finite counts only.++- Don't use `Math.random()` or `Date.now()` — breaks determinism. Seeded PRNG if pseudo-random needed.++- Don't use `<br>` inside captions — natural wrapping + `<br>` produces extra unwanted breaks.++- Don't skip the frame verification gate. Lint exit code is not visual truth.++- Don't author in original-time if the audio is edited. Edited-time or nothing.++- Don't leave `background: #07121c` flat. Layer it.++- Don't hard-cut between scenes. Rotate transition flavors.++- Don't polite-caption. Pop them.++- Don't let the face sit still. Grade + Ken Burns always.++++## Lessons from may-shorts-18 (v1 → v2)++++Distilled from the 4 concrete problems the v1 render had and what fixed them in v2. Apply these on every new short.++++### 1. Slam/stamp timing — reveal logic beats word-sync++++A SLAM/STAMP overlay (KILLED, DEAD, STOP, etc.) lands AFTER its target text is fully visible, **not** during the spoken word. In may-shorts-18 v1 scene 1, CLAUDE and CHATGPT were pitched as opponents — KILLED fired at local 0.46s while CHATGPT didn't appear until 0.66s, so viewers saw "Claude … KILLED" with no visible target. The joke collapsed.++++**Rule:** `stamp_t ≥ target-text-visible_t + 0.10–0.25s`. The "visible" timestamp is the END of the target's entrance animation, not its start. Word-sync is a guideline; visual reveal order is the constraint.++++### 2. BOTTOM face-mode scale — don't ship the default++++Default `BOTTOM = { x: 0, y: 1136, scale: 0.5625 }` (exact horizontal fit for a 1920×1080 source) leaves empty studio background flanking the speaker if they occupy <70% of the source frame. This is the default in may-shorts-19 and was copied into may-shorts-18 v1 — both videos had visible dead space left and right of the speaker in every BOTTOM scene.++++**Rule:** prefer `BOTTOM = { x: -180, y: 1110, scale: 0.75 }` — crops 180px each side, bottom-anchors to y=1920. Preview ONE frame of BOTTOM mode against the actual source video before committing the constant. If the source speaker is tight-framed already, scale 0.65 may be enough; if the source is wide studio framing, push to scale 0.80 and re-tune x.++++Always keep HIDDEN's `x`, `y`, `scale` identical to BOTTOM — they only differ in `opacity` — so the opacity-fade scenes don't drift geometrically mid-fade.++++### 3. Face-mode transitions — three things at once, not one++++When the face changes mode between adjacent scenes, a bare 0.15s pre-roll + 0.32s duration `expo.inOut` on just the face wrapper reads as rigid — the outgoing scene's panels are still fully opaque behind the morphing face, so the eye sees two things fighting instead of a crossfade.++++**Rule:** for any "hero" scene-to-scene face-mode change (especially BOTTOM ↔ FULLSCREEN), do all three:++1. Extend that specific transition's duration to 0.45–0.55s (not the default 0.32s)++2. Start it 0.25–0.30s before the new scene's `data-start` (not the default 0.15s)++3. Fade + blur the outgoing scene's panel wrapper to `opacity: 0, filter: blur(6px)` over 0.20–0.25s, starting 0.25s before scene end++++Implementation-wise, promote the face-mode transition array to per-entry `dur` so one transition can be longer than the others:++```js++[ { t: 2.06, mode: FULLSCREEN, dur: 0.50 }, { t: 3.71, mode: HIDDEN, dur: 0.32 }, ... ]++ .forEach(({ t, mode, dur }) => mainTl.to("#face-wrapper", { ...mode, duration: dur, ease: "expo.inOut" }, t));++```++++Three simultaneous changes = "a real editor edited this." Any one alone = rigid.++++### 4. Data-feel scenes beat decoration scenes mid-video++++For scenes 3–5 of a 15–20s short (the "middle grind" where attention drops the hardest), lean on visuals that read as information — bar races, stat grids with counting numbers, heatmaps, sparklines, flowcharts, dashboard chrome with telemetry ticking, pain-point grids that flash red in sequence. may-shorts-18 v1 scene 4 was a radar-rings + terminal-chip + sparks combo — functional but decorative, and Nate called it "bland." v2 replaced it with a 3×3 pain-point grid lighting up red-orange in sequence + a sparkline stroke-drawing with a YOU-ARE-HERE marker + the payoff slam — same time budget, much higher engagement.++++**Rule:** pure typography-plus-icon scenes feel like slides. Data-feel scenes feel like evidence. When a middle scene feels bland, replace the decoration with something that reads as *information*: a small number ticking up, a bar filling, a chart stroking in, a grid flashing in sequence.++++## Reference compositions++++- `video-projects/may-shorts-19/` — the canonical short-form example (18.84s, 1080x1920, 7 scenes, face-mode choreography, karaoke captions with shift(), ambient bg + seam treatment). Read `index.html` and any `compositions/scene*.html` before authoring a new short.++- `video-projects/may-shorts-18/` — secondary reference with the 4 lessons above baked in: BOTTOM scale=0.75, KILLED stamp timed after CHATGPT reveal, scene-1→2 fluid fade, scene 4 data-dashboard "THE PATTERN" grid.++++## Related skills (invoke in addition)++++- `/hyperframes` — framework rules (always first)++- `/hyperframes-cli` — CLI commands (init, lint, preview, render)++- `/gsap` — animation library reference++- `/hyperframes-registry` — installing transition blocks++- `/seedance-loop-prompt` — if the short needs an AI-generated looping background video++++## Memory pointers (relevant feedback entries)++++- `feedback_short_form_principles.md` — the 10 rules, full rationale++- `feedback_contrast_technique.md` — glow localization + text-shadow halos + brightening dim text++- `feedback_techy_background_layers.md` — 6-layer control-room background stack++- `feedback_visual_verification.md` — the verification gate++- `project_ais_brand_specs.md` — if the short is AIS-branded (hex codes, fonts, logo glow)diff --cc .agents/skills/website-to-hyperframes/SKILL.mdindex 0000000,0000000..8d73fefnew file mode 100644--- /dev/null+++ b/.agents/skills/website-to-hyperframes/SKILL.md@@@ -1,0 -1,0 +1,121 @@@++---++name: website-to-hyperframes++description: |++ Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.++---++++# Website to HyperFrames++++Capture a website, then produce a professional video from it.++++Users say things like:++++- "Capture https://... and make me a 25-second product launch video"++- "Turn this website into a 15-second social ad for Instagram"++- "Create a 30-second product tour from https://..."++++The workflow has 7 steps. Each produces an artifact that gates the next.++++---++++## Step 1: Capture & Understand++++**Read:** [references/step-1-capture.md](references/step-1-capture.md)++++Run the capture, read the extracted data, and build a working summary using the write-down-and-forget method.++++**Gate:** Print your site summary (name, top colors, fonts, key assets, one-sentence vibe).++++---++++## Step 2: Write DESIGN.md++++**Read:** [references/step-2-design.md](references/step-2-design.md)++++Write a simple brand reference for the captured website. 6 sections, ~90 lines. This is a cheat sheet, not the creative plan — that comes in Step 4.++++**Gate:** `DESIGN.md` exists in the project directory.++++---++++## Step 3: Write SCRIPT++++**Read:** [references/step-3-script.md](references/step-3-script.md)++++Write the narration script. The story backbone. Scene durations come from the narration, not from guessing.++++**Gate:** `SCRIPT.md` exists in the project directory.++++---++++## Step 4: Write STORYBOARD++++**Read:** [references/step-4-storyboard.md](references/step-4-storyboard.md)++++Write per-beat creative direction: mood, camera, animations, transitions, assets, depth layers, SFX. This is the creative north star — the document the engineer follows to build each composition.++++**Gate:** `STORYBOARD.md` exists with beat-by-beat direction and an asset audit table.++++---++++## Step 5: Generate VO + Map Timing++++**Read:** [references/step-5-vo.md](references/step-5-vo.md)++++Generate TTS audio, transcribe for word-level timestamps, and map timestamps to beats. Update STORYBOARD.md with real durations.++++**Gate:** `narration.wav` (or .mp3) + `transcript.json` exist. Beat timings in STORYBOARD.md updated.++++---++++## Step 6: Build Compositions++++**Read:** The `/hyperframes` skill (invoke it — every rule matters)++**Read:** [references/step-6-build.md](references/step-6-build.md)++++Build each composition following the storyboard. After each one: self-review for layout, asset placement, and animation quality.++++**Gate:** Every composition has been self-reviewed. No overlapping elements, no misplaced assets, no static images without motion.++++---++++## Step 7: Validate & Deliver++++**Read:** [references/step-7-validate.md](references/step-7-validate.md)++++Lint, validate, preview. Create a HANDOFF.md for multi-session continuity.++++**Gate:** `npx hyperframes lint` and `npx hyperframes validate` pass with zero errors.++++---++++## Quick Reference++++### Video Types++++| Type | Duration | Beats | Narration |++| --------------------- | -------- | ----- | ---------------------- |++| Social ad (IG/TikTok) | 10-15s | 3-4 | Optional hook sentence |++| Product demo | 30-60s | 5-8 | Full narration |++| Feature announcement | 15-30s | 3-5 | Full narration |++| Brand reel | 20-45s | 4-6 | Optional, music focus |++| Launch teaser | 10-20s | 2-4 | Minimal, high energy |++++### Format++++- **Landscape**: 1920x1080 (default)++- **Portrait**: 1080x1920 (Instagram Stories, TikTok)++- **Square**: 1080x1080 (Instagram feed)++++### Reference Files++++| File | When to read |++| ------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |++| [step-1-capture.md](references/step-1-capture.md) | Step 1 — reading captured data |++| [step-2-design.md](references/step-2-design.md) | Step 2 — writing DESIGN.md |++| [step-3-script.md](references/step-3-script.md) | Step 3 — writing the narration script |++| [step-4-storyboard.md](references/step-4-storyboard.md) | Step 4 — per-beat creative direction |++| [step-5-vo.md](references/step-5-vo.md) | Step 5 — TTS, transcription, timing |++| [step-6-build.md](references/step-6-build.md) | Step 6 — building compositions with self-review |++| [step-7-validate.md](references/step-7-validate.md) | Step 7 — lint, validate, preview, handoff |++| [techniques.md](references/techniques.md) | Steps 4 & 6 — 10 visual techniques with code patterns (SVG drawing, Canvas 2D, 3D, typography, Lottie, video, typing, variable fonts, MotionPath, transitions) |diff --cc .agents/skills/website-to-hyperframes/references/step-1-capture.mdindex 0000000,0000000..7703262new file mode 100644--- /dev/null+++ b/.agents/skills/website-to-hyperframes/references/step-1-capture.md@@@ -1,0 -1,0 +1,66 @@@++# Step 1: Capture & Understand++++## Run the capture++++```bash++npx hyperframes capture <URL> -o captures/<project-name>++```++++No API keys required. The capture extracts design tokens, screenshots, fonts, and assets with DOM-context descriptions automatically.++++**Optional:** Set `GEMINI_API_KEY` (or `GOOGLE_API_KEY`) in a `.env` file at the repo root for richer AI-powered image descriptions via Gemini 2.5 Flash vision. Free tier: 5 RPM; paid tier removes the bottleneck.++++Wait for it to complete. Print how many screenshots, assets, sections, and fonts were extracted.++++## Read and summarize++++Read each file below. After reading each one, **write a 1-2 sentence summary** of what you learned. These summaries are your working memory — the raw file content may be cleared from context later.++++### Must read (do not skip)++++1. **View the scroll screenshots** — viewport-sized captures covering the full page height (the number depends on the page length). Start with:++ - `screenshots/scroll-000.png` — the hero section at full 1920x1080 resolution. This is the most important image. Describe: is the background light or dark? What's the dominant visual element? What colors jump out?++ - Then scan through the rest to see the full page. Each screenshot overlaps the previous by ~30%.++++ After viewing them, write 3-4 sentences describing the site's visual mood, layout patterns, color strategy, and overall feel.++++2. **`extracted/tokens.json`** — Note the top 5-7 colors (HEX), all font families, number of sections, and number of headings/CTAs.++++3. **`extracted/visible-text.txt`** — Note the site's headline, tagline, key selling points, and any notable statistics or social proof.++++4. **`extracted/asset-descriptions.md`** — One-line-per-file summary of all downloaded assets. Note which assets are most visually striking or useful for video (hero images, logos, product screenshots).++++### Read if they exist++++5. **`extracted/animations.json`** — Note if the site uses scroll-triggered animations, marquees, canvas/WebGL, or named CSS animations.++++6. **`extracted/lottie-manifest.json`** — View each preview image at `assets/lottie/previews/` to see what the animations look like.++++7. **`extracted/video-manifest.json`** — View each preview at `assets/videos/previews/` to see what each video shows.++++8. **`extracted/shaders.json`** — If present, this contains the actual GLSL shader code that powers the site's WebGL visual effects (gradient waves, particle systems, noise fields). Read the fragment shaders to extract: color values used in gradients, noise algorithms, blend functions. You can recreate similar effects in your compositions using Canvas 2D or by embedding the shader patterns with a `<canvas>` + WebGL context. See the Canvas 2D and procedural art patterns in `techniques.md`.++++### On-demand (read when building scenes)++++9. **Individual images in `assets/`** — Use `asset-descriptions.md` as your index. View specific images when you need them for a beat.++++10. **`extracted/assets-catalog.json`** — Use to find remote URLs when you need an asset that wasn't downloaded.++++### For rich captures (30+ images)++++Launch a sub-agent to view all images and SVGs:++++> "Read every image in assets/ and every SVG in assets/svgs/. For each, write one line: filename — what it shows, dominant colors, approximate size. Return the complete catalog."++++Use the sub-agent's catalog as your asset reference for the rest of the workflow.++++## Gate++++Print your site summary before proceeding to Step 2:++++- **Site:** [name]++- **Colors:** [top 3-5 HEX values with roles]++- **Fonts:** [font families]++- **Sections:** [count] sections, [count] headings, [count] CTAs++- **Key assets:** [3-5 most useful assets for video]++- **Vibe:** [one sentence describing the visual identity]diff --cc .agents/skills/website-to-hyperframes/references/step-2-design.mdindex 0000000,0000000..f4fc655new file mode 100644--- /dev/null+++ b/.agents/skills/website-to-hyperframes/references/step-2-design.md@@@ -1,0 -1,0 +1,128 @@@++# Step 2: Write DESIGN.md++++DESIGN.md is a **brand cheat sheet** for the captured website. It encodes the visual identity so you can reference exact colors, fonts, and patterns while writing the storyboard and compositions.++++DESIGN.md is NOT the creative plan. The STORYBOARD (Step 4) drives creative direction. DESIGN.md is a reference you consult, not a document you follow slavishly.++++## The 6 Sections++++### `## Overview`++++3-4 sentences. Describe the visual identity factually: layout patterns (bento grid, logo wall, hero section), color strategy, typography tone, overall feel. Be precise, not poetic.++++### `## Colors`++++5-10 key colors with HEX values from tokens.json and their roles:++++```++- **Primary Surface**: `#020204` — deep black background++- **Primary Content**: `#FFFFFF` — high-purity white for text and borders++- **Accent Warm**: `#FB923C` — orange for CTAs and highlights++```++++Include semantic colors if the site uses color to differentiate product areas.++++### `## Typography`++++Font families with weights, roles, and any distinctive usage:++++```++- **Serif**: Cormorant Garamond (Italic). Major headings, brand identity.++- **Monospace**: Geist Mono. Subheaders, labels, terminal readouts. High tracking (0.1-0.3em), all-caps.++- **Sans-Serif**: Inter. Body copy, interface elements. Small sizes (9-14px).++```++++Include sizing hierarchy if notable (hero: 64px, section: 32px, body: 16px).++++### `## Elevation`++++One paragraph on depth strategy: Does the site use borders, shadows, glassmorphism, or flat color shifts? Reference specific patterns (e.g., "1px borders at white/10 opacity" or "layered backdrop-blur with thin borders").++++### `## Components`++++Name every notable UI component you see in the screenshot. Be specific:++++- "Cinematic Accordion" not "Cards"++- "Logo Marquee" not "Scrolling section"++- "Glass Cards with grain overlay" not "Content containers"++++For each, note the distinctive visual treatment (border-radius, spacing, hover behavior).++++### `## Do's and Don'ts`++++3-5 rules each, derived from what the site actually does and doesn't do:++++```++### Do's++- Use thin subtle borders (white/10) to separate sections++- Keep imagery desaturated with dark gradients for text readability++++### Don'ts++- Do not use bright solid background colors — stay in "The Void"++- Do not use standard drop shadows — use radial glow or bloom effects++- Do not use sharp high-speed animations — all motion should be fluid++```++++## Rules++++- Use **exact HEX values** from tokens.json. Do not approximate.++- Name components by what you see in the screenshot, not generic terms.++- Keep it under 100 lines. This is a cheat sheet, not a design system document.++- No "Style Prompt" section — the storyboard handles creative direction.++- No "Assets" section — `asset-descriptions.md` already covers this.++- No "Motion" section — the storyboard specifies motion per-beat.++++## Example++++This is a real DESIGN.md from a production capture (Soulscape 2026):++++```markdown++# Design System++++## Overview++++Soulscape 2026 is a cinematic, "high-signal" digital experience that positions itself as the vanguard of AI filmmaking. The visual personality is dark, technical, and premium, characterized by high-contrast "Flare" on "Void" (white on black) aesthetics. The layout is dense but organized, utilizing heavy horizontal layering and border-defined sections to evoke a wide-screen cinematic feel. Motion is a core tenet, with atmospheric grain overlays, shifting light leaks, and slow-moving marquees creating constant, breathing texture.++++## Colors++++- **Primary Surface**: `#020204` (Void) - Deep black for the entire background.++- **Primary Content**: `#FFFFFF` (Flare) - High-purity white for typography and primary borders.++- **Accent 1 (Warm)**: `#FB923C` - Orange for industry/executive tiers and primary CTAs.++- **Accent 2 (Cool)**: `#60A5FA` - Blue for creative voices and summit-focused components.++- **Subtle Overlays**: `rgba(255, 255, 255, 0.02)` to `0.08` for glass backgrounds.++++## Typography++++- **Serif**: Cormorant Garamond (Italic). Major headings and "Soul" brand identity. Classical cinematic contrast.++- **Monospace**: Geist Mono. Subheaders, labels, terminal readouts. High tracking (0.1-0.3em), all-caps.++- **Sans-Serif**: Inter. Body copy and interface elements. Small sizes (9-14px).++++## Elevation++++- **Glassmorphism**: Components use backdrop-filter blur(10px) with thin borders (1px solid rgba(255, 255, 255, 0.08)).++- **Layering**: Depth via fixed global grain-overlay and localized light-leak gradients rather than box-shadows.++- **Interaction**: Hover triggers subtle translateY(-5px) and increased border opacity.++++## Components++++- **Cinematic Accordion**: Expanding horizontal/vertical card system where panels expand from compressed state to reveal full-bleed imagery and large serif typography.++- **HUD Explorer**: Floating mobile navigation trigger styled as a "Lens" with pulsing glow and terminal readouts.++- **Slow Marquees**: Continuous horizontal tickers for partner logos and veteran listings.++- **Glass Cards**: Content containers with subtle gradients, rounded corners (2.5rem), and high-contrast iconography.++- **Grain & Flicker**: Global CSS noise filters and holographic flicker animations on UI labels.++++## Do's and Don'ts++++### Do's++++- Use thin subtle borders (white/10) to separate sections rather than solid color changes.++- Maintain high letter-spacing on all Geist Mono labels.++- Use serif italics for emotional or visionary statements.++- Keep imagery desaturated or stylized with dark gradients for readability.++++### Don'ts++++- Do not use bright solid background colors — the page must remain in "The Void."++- Do not use standard drop shadows — use radial glow or bloom effects instead.++- Do not use sharp high-speed animations — all motion should be fluid and breathing.++```diff --cc .agents/skills/website-to-hyperframes/references/step-3-script.mdindex 0000000,0000000..2eca87anew file mode 100644--- /dev/null+++ b/.agents/skills/website-to-hyperframes/references/step-3-script.md@@@ -1,0 -1,0 +1,96 @@@++# Step 3: Write the Narration Script++++**Before writing, re-read DESIGN.md** — specifically the Overview and Components sections. The script should reference real product features, real stats, and real components that the website highlights. Use exact numbers from `extracted/visible-text.txt`.++++The script is the backbone. Everything downstream — scene durations, animation timing, beat pacing — comes from the narration. Write it before the storyboard.++++Save as `SCRIPT.md` in the project directory.++++## Pacing++++- **2.5 words per second** is natural speaking pace++- 15s = ~37 words. 30s = ~75 words. 60s = ~150 words++- Leave room for pauses. Silence between sentences is a feature, not dead air++- The script should feel SHORTER than the video — visual breathing room matters++++## Tone++++Write like a person, not a brochure:++++- Use contractions: "it's", "you'll", "that's", "we've"++- Vary sentence length — short punchy phrases mixed with longer flowing ones++- Read it out loud. If it sounds robotic, rewrite it++- Avoid jargon unless the audience expects it++++## Number Pronunciation++++Write what you want the voice to say. TTS reads literally.++++| On the website | Write in script as |++| -------------- | --------------------------------- |++| 135+ | more than one hundred thirty five |++| $1.9T | nearly two trillion dollars |++| 99.999% | ninety nine point nine percent |++| 200M+ | over two hundred million |++| 10x | ten times |++| API | A P I |++| stripe.com | stripe dot com |++++The visual can show the exact figure while the voice rounds it.++++## Structure++++For product videos from a website capture:++++1. **Hook** — what's surprising or impressive about this product? A bold claim, a provocative question, a contrast, or a striking number. This is the opening line. **Vary the hook type** — don't default to a stat every time.++2. **Story** — what does the product do? Who uses it? Keep it concrete.++3. **Proof** — stats, customer names, social proof. Real numbers from the website.++4. **CTA** — what should the viewer do? "Start building at stripe dot com."++++Not every video needs all four. A 15-second social ad might be Hook + Proof + CTA. A 60-second product tour uses all four with more Story.++++## The Opening Line++++The most important sentence in the video. It must create tension, curiosity, or surprise in the first 3 seconds.++++Patterns that work:++++- **A bold claim**: "The financial infrastructure that powers the internet economy."++- **A question that provokes**: "What if your database could think?"++- **A contrast**: "Your AI agent already knows how to make videos. It just needs the right format."++- **A number that shocks**: "Nearly two trillion dollars." (Use sparingly — not every video should open with a stat.)++++If the opening is generic ("Welcome to Stripe" / "Introducing our product"), start over.++++## Example++++From a 62-second product launch video (team reference):++++```++Your AI agent already knows how to make videos.++It just needs the right format.++++This is Hyperframes. An open source framework. HTML in, video out.++++A div is a keyframe. Data attributes are your timeline.++CSS is your look. G-Sap is your animation engine.++++Anything a browser can render can be a frame in your video.++++CSS animations. G-Sap. Lottie. Shaders. Three.js.++++Drop in music, sound effects, footage — it all composes together.++++No new framework for the agent to learn.++Just HTML.++++The agent writes it. The renderer captures every frame as MP4.++It's deterministic. Identical outputs, every time.++++Give your agent the CLI. Tell it what to make.++Watch it build.++++Hyperframes. Go make something.++```++++Note: ~140 words for 62 seconds — that's 2.3 words/sec, leaving room for pauses and visual breathing.diff --cc .agents/skills/website-to-hyperframes/references/step-4-storyboard.mdindex 0000000,0000000..0579c94new file mode 100644--- /dev/null+++ b/.agents/skills/website-to-hyperframes/references/step-4-storyboard.md@@@ -1,0 -1,0 +1,222 @@@++# Step 4: Write the Storyboard++++**Before writing anything, fully re-read these files:**++++- **DESIGN.md** — your color palette, font rules, components, Do's/Don'ts. Every creative decision must be grounded in this brand identity. If it says "white backgrounds with purple accent" — plan light scenes, not dark moody ones.++- **`extracted/asset-descriptions.md`** — read EVERY line. This is your menu of available visuals. Each line describes what the image actually shows (e.g., "translucent ribbons in orange, pink, and purple on white background" or "a high-speed train under a dark starry sky"). Use these descriptions to decide which assets belong in which beat. Assets you don't understand from the description — view them directly before assigning.++- **[techniques.md](techniques.md)** — 10 visual techniques (SVG path drawing, Canvas 2D art, CSS 3D, per-word typography, Lottie, video compositing, typing effect, variable fonts, MotionPath, velocity transitions). Pick 2-3 per beat and specify them in the storyboard.++++The storyboard is the creative north star. It tells the engineer exactly what to build for each beat — mood, camera, animations, transitions, assets, sound. Write it as if you're briefing a motion designer who's never seen the website.++++Save as `STORYBOARD.md` in the project directory.++++---++++## Global Direction++++Every STORYBOARD.md starts with global settings:++++```markdown++**Format:** 1920×1080++**Audio:** [TTS provider] voiceover + underscore + SFX++**VO direction:** [voice character — e.g., "mid-age male, calm confident delivery,++Apple keynote register — economy of words, silence between sentences is a feature"]++**Style basis:** DESIGN.md (brand colors, fonts, components from the captured site)++```++++**Global guardrails** (adapt to the brand):++++- Push color presence. Muted is fine, flat is not. Every beat should have at least one color that pulls your eye.++- Motion should be visible and intentional. Err toward more movement than feels safe — subtle reads as static at 30fps.++- Use as many captured assets as the creative vision allows. Scatter framework icons around a dashboard. Layer enterprise photos behind stats. Use product screenshots as floating cards. The assets exist — use them generously.++- Aim for 8-10 visual elements per beat, not 2-3. A great beat has: background texture, midground content, foreground accents, floating decorative elements, animated icons, SVG path drawings, particle effects, typographic details. It should feel DENSE and alive.++- Use at least 2-3 different techniques from techniques.md per beat — not across the whole video, per beat. Don't default to basic fade/scale/opacity — mix in SVG path drawing, CSS 3D transforms, typing effects, counter animations, canvas procedural art. Each beat should feel like its own visual world.++++**Underscore/music direction** (if applicable):++++- Describe the mood, reference artists, when it swells or drops++- Example: "Minimal electronic. Warm sustained pad already playing when the video starts. Sits underneath everything, never competing with VO. Swells gently during the flex section, drops to near-nothing for the comparison, resolves on a final chord."++++---++++## Asset Audit++++Before writing any beats, audit every captured asset. Print this table:++++| Asset | Type | Assign to Beat | Role |++| ------------------------------ | ---------- | -------------- | ------------------------------------- |++| wave-fallback-desktop.png | Hero image | Beat 1 | Full-bleed animated background |++| enterprise-accordion-hertz.png | Photo | Beat 3 | Enterprise credibility, Ken Burns pan |++| stripe-logo.svg | SVG | Beat 1, Beat 5 | Brand mark opener + closer |++| datavizstatic3x.png | Data viz | Beat 3 | Supporting visual behind stats |++| icon-3.svg | Icon | SKIP | Decorative, too small |++++**Minimum utilization:**++++- At least 50% of product screenshots and hero images must appear++- Brand logo appears in the first AND last beat++- The site's signature visual (gradient wave, hero illustration, key product UI) must appear — it's the most recognizable brand element++- Maximum 2 consecutive text-only beats. The 3rd must contain a visual asset++- Opening beat must contain a visual asset, not text-only++++---++++## Per-Beat Direction++++Each beat is a WORLD, not a layout. Before writing CSS specs and GSAP instructions, describe what the viewer EXPERIENCES. The difference between a great storyboard and a mediocre one:++++**Mediocre:** "Dark navy background. '$1.9T' in white, 280px. Logo top-left. Wave image bottom-right."++**Great:** "Camera is already mid-flight over a vast dark canvas. The gradient wave sweeps across the frame like aurora borealis — alive, shifting. '$1.9T' SLAMS into existence with such force the wave ripples in response. This isn't a slide — it's a moment."++++The first describes pixels. The second describes an experience. Write the second, then figure out the pixels.++++Each beat should have:++++### Concept++++The big idea for this beat in 2-3 sentences. What visual WORLD are we in? What metaphor drives it? What should the viewer FEEL? This is the most important part — everything else flows from it.++++### VO cue++++Which narration line plays over this beat.++++### Visual description++++What the viewer sees — described cinematically, not as CSS specs. Use camera language (pan, zoom, drift, settle). Describe at least 5 visual elements, not just text + background. Think in layers — what's moving in the foreground, midground, background simultaneously?++++### Mood direction++++Cultural and design references, not hex codes:++++- "Geometric, rhythmic, precise. Think Josef Albers or Bauhaus color studies."++- "Warm workspace. Nice notebook energy, not technical blueprint."++- "Cinematic title sequence. The kind of opening where you lean forward."++++### Assets++++Which captured files to use, referenced by filename:++++- "Background: `assets/wave-fallback-desktop.png` — full-bleed, slow zoom 1→1.04 over beat duration"++- "Logo: `assets/svgs/stripe-logo.svg` — centered, fades in at 0.5s"++- "Enterprise photo: `assets/enterprise-accordion-hertz.png` — Ken Burns pan, 70% opacity overlay"++++### Animation choreography++++Specific motion verbs per element — not "it animates in" but HOW:++++| Energy | Verbs | Example |++| ------------- | --------------------------------------------- | ------------------------------------- |++| High impact | SLAMS, CRASHES, PUNCHES, STAMPS, SHATTERS | "$1.9T" SLAMS in from left at -5° |++| Medium energy | CASCADE, SLIDES, DROPS, FILLS, DRAWS | Three cards CASCADE in staggered 0.3s |++| Low energy | types on, FLOATS, morphs, COUNTS UP, fades in | Counter COUNTS UP from 0 to 135K |++++Every element gets a verb. If you can't name the verb, the element is not yet designed.++++### Transition++++How this beat hands off to the next. Specify the type and parameters.++++**CSS transitions** (choose from `skills/hyperframes/references/transitions/catalog.md`):++++- Velocity-matched upward: exit `y:-150, blur:30px, 0.33s power2.in` → entry `y:150→0, blur:30px→0, 1.0s power2.out`++- Whip pan: exit `x:-400, blur:24px, 0.3s power3.in` → entry `x:400→0, blur:24px→0, 0.3s power3.out`++- Blur through: exit `blur:20px, 0.3s` → entry `blur:20px→0, 0.25s power3.out`++- Zoom through: exit `scale:1→1.2, blur:20px, 0.2s power3.in` → entry `scale:0.75→1, blur:20px→0, 0.5s expo.out`++- Hard cut / smash cut (for rapid-fire sequences)++++**Shader transitions** (choose from `skills/hyperframes/references/transitions/shader-transitions.md`):++++- Cross-Warp Morph (organic, versatile) — 0.5-0.8s, power2.inOut++- Cinematic Zoom (professional momentum) — 0.4-0.6s, power2.inOut++- Gravitational Lens (otherworldly) — 0.6-1.0s, power2.inOut++- Glitch (aggressive, high energy) — 0.3-0.5s++- See `skills/hyperframes/references/transitions/shader-setup.md` for the full WebGL boilerplate++++**How velocity-matched CSS transitions work:**++Exit the outgoing beat with an accelerating ease (power2.in or power3.in) plus a blur ramp. Enter the incoming beat with a decelerating ease (power2.out or power3.out) plus blur clear. The fastest point of both easing curves meets at the cut — the viewer perceives continuous camera motion, not two discrete animations. Match exit velocity to entry velocity within ~5% tolerance.++++### Depth layers++++What's in foreground, midground, and background. Every beat should have at least 2 layers:++++- "BG: dark navy fill + subtle radial glow. MG: stat cards with drop shadow. FG: brand logo bottom-right."++++### SFX cues++++What sounds at what moment:++++- "On the capture pulse — a soft, warm analog shutter click."++- "Left side carries a faint low drone. On fold: drone cuts. Silence. Then a single clean chime."++++---++++## Production Architecture++++Include this file tree at the bottom of the storyboard:++++```++project/++├── index.html root — VO + underscore + beat orchestration++├── DESIGN.md brand reference (from Step 2)++├── SCRIPT.md narration text (from Step 3)++├── STORYBOARD.md THIS FILE — creative north star++├── transcript.json word-level timestamps (from Step 5)++├── narration.wav TTS audio (from Step 5)++├── captures/<name>/ captured website data++└── compositions/++ ├── beat-1-hook.html++ ├── beat-2-features.html++ ├── ...++ └── captions.html++```++++---++++## Example: Beat-by-Beat Format++++Here are three beats from a production storyboard showing the level of detail expected.++++### BEAT 1 — COLD OPEN (0:00–0:05)++++**VO:** "Your AI agent already knows how to make videos."++++**Concept:** We're already in motion when the video starts. No title card, no fade from black. We're mid-flight over an infinite creative workspace — dozens of living compositions scattered below us like a city seen from a drone. Each one is alive, running a different animation. The message is clear before any words: this tool makes videos. Lots of them.++++**Visual:** Slow smooth diagonal drift over a vast canvas (3600×2200px plane). Scattered across it: 25 composition cards at organic angles (±5-15° rotation), soft shadows, thin borders. Each card contains a DIFFERENT running animation — kinetic type, gradient morph, data viz, particle system, logo assembly, SVG drawing, shader noise, 3D rotating object. Depth-of-field: close cards slightly blurred, focal sweet-spot in mid-distance, far cards smaller and desaturated.++++**Camera:** Diagonal drift top-left to bottom-right, slight 2-3° rotation over 5s. power1.inOut ease. Zoom accelerates in final second as we approach one specific card.++++**Assets:** Product screenshots and logo on cards. Each card is a mini-composition with its own animation.++++**SFX:** Ambient warmth pad already playing. Faint textured hum — overhearing creative activity from a distance.++++---++++### BEAT 5 — THE THESIS (0:20–0:24)++++**VO:** "Anything a browser can render can be a frame in your video."++++**Mood:** Big statement. This sentence gets its own canvas. Clean, spacious, typographic.++++**Visual:** Words appear as staggered kinetic typography. "Anything a browser can render" — distinctive serif, gentle fade + rise (y: 24px → 0, opacity 0 → 1, 0.4s, power2.out). Held beat — one second of stillness. "can be a frame in your video." appears below. As the final word lands, the entire text pulses once — a brief warm flash, subtle scale bump to 101%.++++**Transition OUT:** Whip pan left — x:-400, blur:24px, opacity:0.4, 0.3s power3.in++++**SFX:** Silence under the first line. On the capture pulse — a soft analog shutter click.++++---++++### BEAT 7 — THE CONTRAST (0:38–0:44)++++**VO:** "No new framework for the agent to learn. Just HTML."++++**Mood:** Clean comparison. Light base. Two worlds side by side.++++**Visual:** Left half: dense code, small, compressed, overwhelming. Scrolls slowly upward. Slightly desaturated. Right half: spacious HTML, syntax-highlighted, generous line spacing, inviting. On "Just HTML." — the left side folds inward along its center line, like a book closing. The right side expands to fill the frame. Warm glow rises behind it.++++**Transition IN:** Zoom through — scale 0.75→1, blur 20px→0, 0.5s expo.out++**Transition OUT:** Velocity-matched upward — y:-150, blur:30px, 0.33s power2.in++++**Assets:** Real framework code on the left (actual content, not lorem ipsum). Real HyperFrames HTML on the right.++++**SFX:** Left side carries a faint low drone. On fold: drone cuts. Silence. Then a single clean chime as the right side expands.diff --cc .agents/skills/website-to-hyperframes/references/step-5-vo.mdindex 0000000,0000000..be656c6new file mode 100644--- /dev/null+++ b/.agents/skills/website-to-hyperframes/references/step-5-vo.md@@@ -1,0 -1,0 +1,40 @@@++# Step 5: Generate VO + Map Timing++++## Audition voices++++Never use the first voice you find. Audition 2-3 voices with the first sentence of SCRIPT.md:++++- **Kokoro** (try first — free, no API key) — `npx hyperframes tts SCRIPT.md --voice af_nova --output narration.wav`. Runs locally on CPU. Requires Python 3.10+ (macOS system Python 3.9 won't work — if it fails with an onnxruntime error, move to the next option).++- **ElevenLabs** (best voice quality, widest selection) — `mcp__elevenlabs__search_voices` to browse, `mcp__elevenlabs__text_to_speech` to generate. Does not return timestamps — transcribe separately after.++- **HeyGen TTS** (returns word timestamps automatically — saves a transcribe step) — `mcp__claude_ai_HeyGen__text_to_speech`. Use when you want timestamps without a separate transcription pass.++++Pick the voice that sounds most natural and conversational. Listen for pacing — does it breathe between sentences? Does it sound like a person or a robot?++++## Generate full narration++++Generate the full script as `narration.wav` (or `.mp3`) in the project directory.++++## Transcribe for word-level timestamps++++```bash++npx hyperframes transcribe narration.wav++```++++Produces `transcript.json` with `[{ text, start, end }]` for every word. These timestamps are the source of truth for all beat durations.++++## Map timestamps to beats++++Go through STORYBOARD.md beat by beat. For each beat:++++1. Find the first word of that beat's VO cue in `transcript.json`++2. Find the last word of that beat's VO cue++3. Set `beat.start = firstWord.start`, `beat.end = lastWord.end`++4. Add 0.3-0.5s padding at the end for visual breathing room++++Update STORYBOARD.md with real durations. Replace estimated times (e.g., "0:00-0:05") with actual timestamps (e.g., "0.00-3.21s").++++Beat boundaries land on word onsets — hard cuts to the VO.++++## Update index.html++++Update each scene slot's `data-start` and `data-duration` to match the real beat timings from the transcript. Also update the total composition duration and audio element duration.diff --cc .agents/skills/website-to-hyperframes/references/step-6-build.mdindex 0000000,0000000..be8a2d4new file mode 100644--- /dev/null+++ b/.agents/skills/website-to-hyperframes/references/step-6-build.md@@@ -1,0 -1,0 +1,162 @@@++# Step 6: Build Compositions++++**Before building, fully re-read these files:**++++- **DESIGN.md** — your color palette, fonts, components, and Do's/Don'ts. Every composition must use EXACT hex colors and font families from this file. If it says "white backgrounds" — use white, not dark.++- **STORYBOARD.md** — the beat-by-beat plan you're executing. Each beat specifies assets, animations, transitions, and which techniques to use.++- **`extracted/asset-descriptions.md`** — when the storyboard assigns an asset to a beat, re-read the description to understand what it shows and how to position/style it correctly.++- **[techniques.md](techniques.md)** — code patterns for the 10 visual techniques. When the storyboard says "SVG path drawing" or "per-word kinetic typography" — read the code pattern from this file and adapt it.++- **transcript.json** — word-level timestamps that drive scene durations.++++**Split the work: spawn a sub-agent for each beat.** By this step your context is full of captured data, DESIGN.md, SCRIPT, STORYBOARD, and transcript. Building compositions on top of all that means the detailed rules below compete with thousands of tokens of prior work. Each sub-agent gets a fresh context focused on one beat — dramatically better output.++++**How to dispatch each sub-agent:**++++Pass file PATHS, not file contents. The #1 failure mode is reading an asset file and pasting its SVG/image data into the sub-agent prompt. The sub-agent then uses inline content instead of referencing the file on disk. Same with fonts — pass the local woff2 path, don't substitute Google Fonts.++++```++Build the composition for beat 1. Save to compositions/beat-1-hook.html.++++STORYBOARD for this beat:++[paste the beat section from STORYBOARD.md]++++ASSETS — reference by path, do NOT read/inline the file contents:++- Logo: <img src="../assets/favicon.svg"> (top-left, 40x40px)++- Hero image: <img src="../assets/hero-bg.png"> (full-bleed background)++- Noise texture: ../assets/noise.png (full-frame overlay, 3% opacity)++++FONTS — use @font-face with the captured font files, NOT Google Fonts:++@font-face { font-family: 'BrandFont'; src: url('../assets/fonts/BrandFont-Regular.woff2'); }++++Read DESIGN.md for exact colors and Do's/Don'ts.++Read techniques.md for animation code patterns.++Invoke /hyperframes for composition structure rules.++```++++After each sub-agent finishes, verify the composition references `../assets/` — if it used inline SVGs or Google Fonts instead of the captured files, fix it before moving on.++++Invoke the `/hyperframes` skill first — it has the rules for data attributes, timeline contracts, deterministic rendering, and layout. Everything below supplements those rules, not replaces them.++++---++++## Per-Composition Process++++For each beat in the storyboard:++++### 1. Read the beat's storyboard section++++Know the mood, visual description, assets, animation choreography, transition, and SFX before writing any HTML.++++### 2. Build the static end-state first++++Position every element where it should be at its **most visible moment** — the frame where everything is fully entered and correctly placed. Write this as static HTML+CSS. No GSAP yet.++++This is the "Layout Before Animation" principle from the compose skill. The CSS position is the ground truth. Animations describe the journey to and from it.++++### 3. Verify the static layout++++Look at it. Check:++++- Are elements where the storyboard says they should be?++- Are depth layers present (foreground / midground / background)?++- Do any elements overlap unintentionally?++- Are assets sized correctly? (hero images should fill 50-70% of frame, not sit at 100x100px)++++### 4. Add entrance animations++++Use `gsap.from()` — animate FROM offscreen/invisible TO the CSS position. The CSS position is where the element ends up.++++### 5. Add mid-scene activity++++Every visible element must have continuous motion. A still image on a still background is a JPEG with a progress bar.++++| Element type | Mid-scene activity |++| ---------------------- | ------------------------------------------------ |++| Image / screenshot | Slow zoom (scale 1→1.03), slow pan, or Ken Burns |++| Stat / number | Counter animates from 0 to target |++| Logo grid | Subtle shimmer sweep, or gentle scale pulse |++| Any persistent element | Subtle float (y ±4-6px, sine.inOut, yoyo) |++++### 6. Add exit / transition++++Check the storyboard's transition specification for this beat:++++- **CSS transition**: implement the exit animation (e.g., `y:-150, blur:30px, 0.33s power2.in`). The next composition handles its own entry.++- **Shader transition**: no exit animation needed — the shader handles the blend. Read `skills/hyperframes/references/transitions/shader-setup.md` for the full WebGL boilerplate and `skills/hyperframes/references/transitions/shader-transitions.md` for the fragment shader. Copy the FULL boilerplate — a simplified version produces black screens.++- **Hard cut**: no exit animation. The scene simply ends.++++For all CSS transition types and their GSAP implementations, read `skills/hyperframes/references/transitions/catalog.md`.++++### 7. Asset cross-reference++++Before self-review, verify you actually used the assets you planned to:++++1. Open STORYBOARD.md and find this beat's asset assignments++2. List every asset that was assigned to this beat++3. Search the composition HTML for each filename (e.g., grep for "wave-fallback-desktop")++4. If any assigned asset is missing from the HTML, add it now++5. Check for the inline anti-pattern: if the HTML contains `<svg xmlns=` or `data:image/` but no `../assets/` references, the assets were inlined instead of referenced. Replace inline content with `<img src="../assets/filename.svg">`++6. Check fonts: if the HTML uses `fonts.googleapis.com` but there are captured fonts in `assets/fonts/`, replace with `@font-face` pointing to the local files++++This step catches the two most common failures: compositions ending up text-only, and assets being inlined instead of file-referenced.++++### 8. Self-review++++After building the composition, check WITH ACTUAL CODE:++++- [ ] Asset cross-reference passed (step 7 above — every assigned asset is in the HTML)++- [ ] Elements are where the storyboard says they should be (no misplacement)++- [ ] No overlapping text (text covering text is always ugly)++- [ ] Depth layers present (2+ layers minimum)++- [ ] Every visible element has mid-scene activity (not just entrance + exit)++- [ ] Font sizes above minimum (20px body text, 16px labels — sub-14px is unreadable after encoding)++- [ ] No full-screen dark linear gradients (H.264 creates visible banding — use solid + localized radial glows)++- [ ] Timeline registered: `window.__timelines["comp-id"] = tl`++- [ ] Colors match DESIGN.md exactly (paste the HEX value, don't approximate)++++**If `skills/hyperframes-animation-map/` is installed**, run it:++++```bash++node skills/hyperframes-animation-map/scripts/animation-map.mjs <composition-dir>++```++++Read the summaries. Fix every flag: offscreen, collision, invisible, pacing issues.++++### 9. Move to the next composition++++---++++## Asset Presentation++++Never embed a raw flat image. Every image must have motion treatment:++++- **Perspective tilt**: use `gsap.set(el, { transformPerspective: 1200, rotationY: -8 })` + `box-shadow` — creates depth. Do NOT use CSS `transform: perspective(...)` as GSAP will overwrite it.++- **Slow zoom (Ken Burns)**: GSAP `scale: 1` → `1.04` over beat duration — makes photos cinematic++- **Device frame**: Wrap in a laptop/phone shape using CSS `border-radius` and `box-shadow`++- **Floating UI**: Extract a key element and animate it at a different z-depth for parallax++- **Scroll reveal**: Clip the image to a viewport window and animate `y` position++++---++++## Audio Wiring++++In the root `index.html`:++++- **Narration**: `<audio id="narration" src="narration.wav" data-start="0" data-duration="..." data-track-index="0" data-volume="1">`++- **Underscore/music** (if storyboard specifies): `<audio id="underscore" src="underscore.mp3" data-start="0" data-duration="..." data-track-index="3" data-volume="0.15">`++- **SFX** (if storyboard specifies): individual `<audio>` elements at specific `data-start` timestamps++- **Captions** (optional — only if user requests): sub-composition on a parallel track. Skip unless explicitly asked for.++++---++++## Critical Rules++++These exist because the capture engine is deterministic. Violations produce broken output.++++- **No `repeat: -1`** — calculate exact repeats from beat duration++- **No `Math.random()`** — use a seeded PRNG (mulberry32)++- **Register every timeline**: `window.__timelines["comp-id"] = tl`++- **Synchronous timeline construction** — no async/await wrapping timeline code++- **Never use ANY CSS `transform` for centering** — not `translate(-50%, -50%)`, not `translateX(-50%)`, not `translateY(-50%)`. GSAP animates the `transform` property, which overwrites ALL CSS transforms including centering. The element flies offscreen. Use flexbox centering instead: `display:flex; align-items:center; justify-content:center` on a wrapper div. The linter catches this (`gsap_css_transform_conflict`) but only if you run it.++- **Minimum font sizes**: 20px body, 16px labels++- **No full-screen dark linear gradients** — H.264 bandingdiff --cc .agents/skills/website-to-hyperframes/references/step-7-validate.mdindex 0000000,0000000..fa094c1new file mode 100644--- /dev/null+++ b/.agents/skills/website-to-hyperframes/references/step-7-validate.md@@@ -1,0 -1,0 +1,109 @@@++# Step 7: Validate & Deliver++++## Lint + Validate++++Run in sequence. Fix all errors before proceeding to the next command.++++```bash++npx hyperframes lint++npx hyperframes validate++```++++`lint` checks HTML structure statically — missing attributes, timeline registration, tween conflicts, CSS transform + GSAP conflicts (including inline styles).++`validate` loads the composition in headless Chrome and catches runtime JS errors, missing assets, and failed network requests.++++## Visual Verification (snapshot)++++After lint and validate pass, capture snapshot frames to SEE your own output:++++```bash++npx hyperframes snapshot <project-dir> --at <beat-midpoints>++```++++If the snapshot command isn't available, fall back to:++++```bash++npx tsx packages/cli/src/cli.ts snapshot <project-dir> --at <beat-midpoints>++```++++Calculate the midpoint of each beat from your STORYBOARD.md timings. For a 4-beat video with beats at 0-5.8s, 5.8-15.0s, 15.0-22.5s, 22.5-25.3s:++++```bash++npx hyperframes snapshot <project-dir> --at 2.9,10.4,18.7,23.9++```++++This renders one frame per beat at the moment when content is most visible. Use timestamps where the most content is on screen — usually 60-70% into each beat, after entrances finish but before exits start.++++**View every snapshot image carefully.** Don't glance and move on. For each frame, check:++++**Visibility:**++++- Is there visible content? All-white or all-black frames mean compositions aren't rendering.++- Can you read ALL text? White text on white/light background is invisible. Dark text on dark background is invisible. Every text element needs contrast against what's directly behind it.++- Are images and assets showing? Empty space where an image should be means a path issue or missing file.++++**Positioning and layout:**++++- Do background images fill the entire frame? If an image only covers half the screen, the `object-fit`, `width`, `height`, or position values are wrong.++- Are elements where the storyboard says they should be? Compare the snapshot to the beat description.++- Is there too much empty/dead space? If more than 40% of the frame is a flat solid color with nothing on it, the composition is sparse.++- Are elements overlapping incorrectly? Text over text, or content bleeding off the edges?++++**Visual quality:**++++- Are overlays too heavy? If a background image is barely visible through a dark overlay, reduce the overlay opacity.++- Is the visual hierarchy clear? One dominant element per frame, supporting elements secondary.++- Do the colors match DESIGN.md? Check actual rendered colors against what was planned.++++**Code vs. rendered verification:**++++- For each beat, check: does the snapshot show the assets you referenced in the HTML? If a composition has `<img src="...wave.png">` but the snapshot shows no wave — the image isn't loading, the path is wrong, or it's hidden behind another element.++- If a snapshot shows nothing at a timestamp, try a slightly different time (1-2 seconds later). Compositions may still be in entrance animations.++- The snapshot command is fast — run it multiple times at different timestamps if needed.++++If any frame has issues, go back to Step 6 and fix that composition before proceeding.++++## Preview++++```bash++npx hyperframes preview++```++++Open the studio in a browser. Scrub through every beat.++++## Create HANDOFF.md++++Write a `HANDOFF.md` for multi-session continuity:++++```markdown++# Handoff — [Project Name]++++**Date:** [today]++**Preview:** `npx hyperframes preview`++++## What's Built++++| Beat | File | Dur | Status | Notes |++| ---- | -------------------- | ---- | ------ | ----- |++| 1 | beat-1-hook.html | 5.2s | Built | ... |++| 2 | beat-2-features.html | 6.8s | Built | ... |++++## Audio++++| Asset | Status | Notes |++| --------------- | ------ | ------------------------------------ |++| narration.wav | Done | [provider], [voice name], [duration] |++| transcript.json | Done | [word count] words, [duration] |++++## What Needs Work++++- [any known issues, polish requests, missing SFX]++++## Commands++++npx hyperframes preview++npx hyperframes lint++npx hyperframes validate++npx hyperframes snapshot <project-dir> --at <beat-midpoints>++npx hyperframes render --output renders/final.mp4++```diff --cc .agents/skills/website-to-hyperframes/references/techniques.mdindex 0000000,0000000..f380dffnew file mode 100644--- /dev/null+++ b/.agents/skills/website-to-hyperframes/references/techniques.md@@@ -1,0 -1,0 +1,341 @@@++# Visual Techniques Reference++++10 proven techniques from production HyperFrames videos. Use these in your storyboard and compositions to create visually rich, professional output. Each technique includes a minimal code pattern you can adapt.++++These are NOT advanced — they're standard motion design patterns that every composition should use at least 2-3 of.++++---++++## 1. SVG Path Drawing++++A path draws itself in real-time, like someone tracing with a pen. Use for revealing diagrams, arrows, connector lines, or brand marks.++++```html++<svg viewBox="0 0 400 200">++ <path++ class="draw-path"++ d="M 50 100 L 200 50 L 350 100"++ stroke="#c84f1c"++ stroke-width="4"++ fill="none"++ stroke-linecap="round"++ />++</svg>++<style>++ .draw-path {++ stroke-dasharray: 280;++ stroke-dashoffset: 280;++ }++</style>++<script>++ tl.to(".draw-path", { strokeDashoffset: 0, duration: 0.7, ease: "power2.out" }, 0.5);++</script>++```++++Use `path.getTotalLength()` to calculate the dasharray value dynamically.++++---++++## 2. Canvas 2D Procedural Art++++Animated noise, particle fields, data visualizations — anything that evolves frame-by-frame. Drive it with a GSAP proxy.++++```html++<canvas id="proc-canvas" width="1920" height="1080"></canvas>++<script>++ var canvas = document.getElementById("proc-canvas");++ var ctx = canvas.getContext("2d");++++ function hash(x, y) {++ var n = x * 374761393 + y * 668265263;++ n = (n ^ (n >> 13)) * 1274126177;++ return ((n ^ (n >> 16)) & 0x7fffffff) / 0x7fffffff;++ }++++ function drawFrame(t) {++ ctx.fillStyle = "#0a0a0a";++ ctx.fillRect(0, 0, 1920, 1080);++ for (var i = 0; i < 200; i++) {++ var x = hash(i, 0) * 1920;++ var y = hash(i, 1) * 1080;++ var brightness = hash(i, Math.floor(t * 10)) * 255;++ ctx.fillStyle = "rgba(255, 255, 255, " + brightness / 255 + ")";++ ctx.beginPath();++ ctx.arc(x, y, 2, 0, Math.PI * 2);++ ctx.fill();++ }++ }++++ var proxy = { time: 0 };++ tl.to(++ proxy,++ {++ time: 5,++ duration: 5,++ ease: "none",++ onUpdate: function () {++ drawFrame(proxy.time);++ },++ },++ 0,++ );++</script>++```++++The `hash()` function is deterministic — same frame renders identically every time.++++---++++## 3. CSS 3D Transforms++++Perspective rotations create depth. Use for product showcases, card flips, architectural reveals.++++```html++<div class="stage" style="perspective: 900px;">++ <div class="card-3d" style="transform-style: preserve-3d;">++ <div class="face front">Product</div>++ <div class="face back" style="transform: rotateY(180deg);">Details</div>++ </div>++</div>++<script>++ tl.to(".card-3d", { rotationY: 360, rotationX: 15, duration: 1.2, ease: "sine.inOut" }, 0);++</script>++```++++Always set `perspective` on the parent, `transform-style: preserve-3d` on the animated element.++++---++++## 4. Per-Word Kinetic Typography++++Words appear one-by-one, synced to transcript.json timestamps. The core technique for narration-driven videos.++++```html++<div class="headline">++ <span class="word w-0">Anything</span>++ <span class="word w-1">a</span>++ <span class="word w-2">browser</span>++ <span class="word w-3">can</span>++ <span class="word w-4">render</span>++</div>++<style>++ .word {++ display: inline-block;++ opacity: 0;++ margin: 0 0.12em;++ }++</style>++<script>++ // Word onset times from transcript.json (seconds relative to beat start)++ var timings = [0.0, 0.23, 0.28, 0.63, 0.78];++ var slides = [80, 60, 50, 25, 12]; // horizontal slide decay (px)++++ document.querySelectorAll(".word").forEach(function (word, i) {++ tl.from(++ word,++ {++ x: slides[i],++ y: 14,++ opacity: 0,++ duration: 0.35,++ ease: "power2.out",++ },++ timings[i],++ );++ });++</script>++```++++The slide distance DECAYS per word (80→12px) — mimics a camera settling.++++---++++## 5. Lottie Animation++++Vector animations that play inside a composition. Use for logos, character animations, icons.++++```html++<script src="https://cdn.jsdelivr.net/npm/@dotlottie/[email protected]/dist/dotlottie-player.js"></script>++<dotlottie-player++ class="lottie"++ src="../assets/lottie/animation-0.json"++ autoplay++ loop++ speed="1.5"++ style="width:500px;height:500px;"++>++</dotlottie-player>++<script>++ gsap.set(".lottie", { scale: 0.3, opacity: 0 });++ tl.to(".lottie", { scale: 1, opacity: 1, duration: 0.35, ease: "back.out(1.6)" }, 0.2);++</script>++```++++Or use lottie-web for more control:++++```javascript++var anim = lottie.loadAnimation({++ container: document.getElementById("anim"),++ renderer: "svg",++ loop: false,++ autoplay: false,++ path: "../assets/lottie/animation-0.json",++});++```++++---++++## 6. Video Compositing++++Embed real video footage inside compositions. Videos must be `muted` with `playsinline`.++++```html++<div class="video-frame" style="width:680px;height:840px;border-radius:16px;overflow:hidden;">++ <video++ id="footage"++ src="../assets/videos/clip.mp4"++ muted++ playsinline++ style="width:100%;height:100%;object-fit:cover;"++ ></video>++</div>++<script>++ // Video playback is controlled by the framework — don't call play() manually++ tl.from(".video-frame", { scale: 0.9, opacity: 0, duration: 0.3, ease: "power2.out" }, 0);++</script>++```++++The HyperFrames runtime handles video seeking and playback.++++---++++## 7. Character-by-Character Typing++++Terminal typing effect using `tl.call()` to update text content character by character.++++```html++<div class="terminal-line">++ <span class="prompt">❯</span>++ <span class="typed" id="typed-text"></span>++ <span class="cursor" style="width:11px;height:22px;background:#333;display:inline-block;"></span>++</div>++<script>++ var CMD = "npx hyperframes init";++ var typed = document.getElementById("typed-text");++++ // Cursor blinks++ tl.to(".cursor", { opacity: 0, duration: 0.12, yoyo: true, repeat: 20, ease: "steps(1)" }, 0);++++ // Type each character++ for (var i = 0; i < CMD.length; i++) {++ (function (idx) {++ tl.call(++ function () {++ typed.textContent = CMD.substring(0, idx + 1);++ },++ null,++ (idx / CMD.length) * 0.9,++ );++ })(i);++ }++</script>++```++++Use `ease: "steps(1)"` for cursor blink — creates discrete on/off.++++---++++## 8. Variable Font Axis Animation++++Animate font-variation-settings to reshape glyphs in real-time. Works with variable fonts that have axes like optical size (opsz), weight (wght), softness (SOFT).++++```html++<style>++ @import url("https://fonts.googleapis.com/css2?family=Fraunces:opsz,[email protected],100..900&display=block");++ .wordmark {++ --opsz: 144;++ --wght: 440;++ font-family: "Fraunces", serif;++ font-variation-settings:++ "opsz" var(--opsz),++ "wght" var(--wght);++ font-size: 200px;++ }++</style>++<script>++ tl.to(".wordmark", { "--opsz": 72, "--wght": 300, duration: 0.45, ease: "power2.out" }, 0);++</script>++```++++The glyph subtly reshapes as axes animate — optical size adjusts detail, weight changes thickness.++++---++++## 9. GSAP MotionPathPlugin++++Animate an element along an arbitrary SVG path. Use for sliders following curves, particles along trajectories, guided reveals.++++```html++<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/MotionPathPlugin.min.js"></script>++<div class="dot" style="width:20px;height:20px;background:#2a8a7c;border-radius:50%;"></div>++<script>++ gsap.registerPlugin(MotionPathPlugin);++ tl.to(++ ".dot",++ {++ motionPath: { path: "M 12 300 C 280 280 520 80 820 50 S 1200 48 1308 38" },++ duration: 1.5,++ ease: "power2.out",++ },++ 0,++ );++</script>++```++++---++++## 10. Velocity-Matched Transitions++++Exit one beat and enter the next with matched velocities — creates perceived continuous motion.++++```javascript++// EXIT (in outgoing composition): accelerating with blur++tl.to(++ ".content",++ {++ y: -150,++ filter: "blur(30px)",++ opacity: 0,++ duration: 0.33,++ ease: "power2.in", // accelerates++ },++ beatDuration - 0.33,++);++++// ENTRY (in incoming composition): decelerating from blur++gsap.set(".content", { y: 150, filter: "blur(30px)" });++tl.to(++ ".content",++ {++ y: 0,++ filter: "blur(0px)",++ duration: 1.0,++ ease: "power2.out", // decelerates++ },++ 0,++);++```++++The fastest point of both curves meets at the cut — the viewer perceives smooth camera motion. Match ease families: `.in` for exits, `.out` for entries.++++---++++## When to Use What++++| Video energy | Techniques to combine |++| ------------------------------ | --------------------------------------------------------------- |++| High impact (launches, promos) | Per-word typography + velocity transitions + counter animations |++| Cinematic (tours, stories) | SVG path drawing + video compositing + 3D transforms |++| Technical (dev tools, APIs) | Character typing + Canvas 2D procedural + MotionPath |++| Premium (luxury, enterprise) | Variable font animation + Lottie + slow velocity transitions |++| Data-driven (stats, metrics) | Canvas 2D procedural + counter animations + SVG path drawing |diff --cc .claude/skills/make-a-video/SKILL.mdindex 24878e7,0000000..53fe977mode 100644,000000..100644--- a/.claude/skills/make-a-video/SKILL.md+++ b/.claude/skills/make-a-video/SKILL.md@@@ -1,268 -1,0 +1,268 @@@+---+name: make-a-video+description: Beginner-friendly end-to-end video creator for HyperFrames. Use when the user says "make a video", "create a video", "new video", "build a video", "video from scratch", "I want to make a video", "help me create a video", or when someone who's never used HyperFrames before arrives with a concept, script, or rough idea and wants a finished MP4. Interviews the user in one pass, then builds the full video with mandatory preview and visual-verification gates.+---++# Make a Video — The Beginner-to-Finished-MP4 Skill++Two phases, eight sequential gates. Every gate produces a concrete artifact the next gate consumes. Don't skip gates.++## When to use this skill — and when to hand off++**Use this skill when:**+- The user is new to HyperFrames and starting from a concept, script, or outline+- They want an end-to-end walkthrough, not framework reference material+- They haven't decided on format yet++**Hand off when:**+- The user pastes a URL and wants a video from that site → invoke `/website-to-hyperframes`- - The user explicitly wants a 9:16 vertical talking-head with face-cam + scene overlays → run Gates 1–4 here, then invoke `/short-form-video` from Gate 5 onward++- The user explicitly wants a 9:16 vertical talking-head with face-cam + scene overlays → run Gates 1–4 here, then invoke `/short-form-edit` from Gate 5 onward+- The user asks for framework rules, not a video → invoke `/hyperframes`++## The two phases++- **Phase 1 — INTERVIEW (Gates 1–4):** one conversational pass to gather *everything* before touching code. Intent, format, script, voice, style, assets, pacing. Synthesize into a `BRIEF.md` and wait for explicit approval.+- **Phase 2 — BUILD (Gates 5–8):** scaffold → storyboard → compositions → lint → Studio preview → draft render → visual verification → MP4 preview → final render.++---++## Gate 1 · Intent & format++Ask one question at a time via `AskUserQuestion`, multiple-choice where possible.++1. What's this video for? (promo · social ad · launch teaser · product demo · tutorial · explainer · intro/outro card · other)+2. Who's the audience? (open-ended)+3. Target duration? (10–20s short · 20–45s promo · 45–90s explainer · 1.5–3 min lesson · custom)+4. Aspect ratio? (16:9 1920×1080 · 9:16 1080×1920 · 1:1 1080×1080)+5. Frame rate? (30 default · 60 for crisp UI · 24 cinematic)+6. Platform / delivery constraints? (file size · deadline · where it'll play)+- **Gate:** all six captured. If the answer is 9:16 + face-cam, plan to hand off to `/short-form-video` at Gate 5.++**Gate:** all six captured. If the answer is 9:16 + face-cam, plan to hand off to `/short-form-edit` at Gate 5.++Full question bank: `Read: references/interview-questions.md`++---++## Gate 2 · Script & voice++1. Script source? (paste · outline → I'll draft · I'll record · TTS from text · no narration)+2. If TTS: voice preference. Offer choices from `npx hyperframes tts --help`. Also capture pace.+3. If face-cam: recording path · full-screen or corner placement · need transcription? (`npx hyperframes transcribe <file> --model small.en --json`)+4. Captions? (off · hype · corporate · karaoke-word-by-word · minimal)++**Gate:** script captured (or drafted), audio plan captured, caption plan captured.++---++## Gate 3 · Style intake++**Before asking the user anything, inventory existing assets.** Check `<workspace-root>/assets/` and any project `assets/` folder. Don't ask for what's already there.++Then ask progressively — they don't need answers to all of these:++1. Style guide or brand doc? (paste/path · no)+2. Color palette? (hex codes · none — use MOTION_PHILOSOPHY defaults)+3. Fonts? (Google Fonts name(s) · file paths · none — use Inter + JetBrains Mono defaults)+4. Logo file? (path · none — use text wordmark instead)+5. Reference videos for vibe? (URLs/paths · none)+6. Other assets? (screenshots · product photos · b-roll · music — list paths)+7. MOTION_PHILOSOPHY aesthetic (black canvas · chrome type · perspective grid · whip transitions) or a different feel?+8. Pacing? (kinetic 1–2s · balanced 2–3s · relaxed 3–5s)+9. Music? (none · ambient pad 0.15 · music bed 0.4 · full 0.8 — file path if they have one)+10. Outro / call-to-action text?++**Never impose a brand on the user.** Fall back to MOTION_PHILOSOPHY defaults *only* when they explicitly decline to supply a style.++Full style flow + MOTION_PHILOSOPHY defaults: `Read: references/style-intake.md`++---++## Gate 4 · Brief synthesis (HARD-GATE before building)++1. **Read `MOTION_PHILOSOPHY.md`** if it exists in the workspace root — mandatory if present. If missing, proceed with the defaults in `references/style-intake.md` and note the absence in the brief.+2. **Ask where projects live** if it's not obvious:+ - If `video-projects/` exists → use `video-projects/<slug>/`+ - Otherwise → ask the user+3. **Write `<project-folder>/BRIEF.md`**:+ - slug · intent · audience · dimensions · fps · duration+ - script (full or outline)+ - voice choice · caption plan · face-cam plan+ - style profile: palette (hex), fonts, logo path, reference videos+ - pacing+ - asset inventory with paths+ - outro / CTA text+4. **Show the brief. WAIT for explicit approval.** Don't proceed to Gate 5 without a clear "yes, build it."++---++## Gate 5 · Scaffold & storyboard++### Handoff check first+- If the brief describes a 9:16 vertical talking-head with face-cam + scene overlays, invoke `/short-form-video` NOW and hand off the brief. Its 4-layer scaffold is purpose-built for that format.++If the brief describes a 9:16 vertical talking-head with face-cam + scene overlays, invoke `/short-form-edit` NOW and hand off the brief. Its transcript-driven workflow covers hooks, cuts, captions, footage, and sound.++Otherwise continue:++### Scaffold++1. `mkdir <project-folder>`+2. If a sibling project with similar format exists, offer to copy its `hyperframes.json` + `meta.json` as a template. Otherwise from inside the folder: `npx hyperframes init`+3. Edit `meta.json` with the user's slug, dimensions, fps.+4. Copy supplied assets into `<project-folder>/assets/`.+5. Create `<project-folder>/assets/style-profile.md` from Gate 3 — single source of truth for palette/fonts/logo.++### Storyboard++Generate `<project-folder>/STORYBOARD.md` using the template in `references/storyboard-template.md`. Every beat gets:++```+Beat N — TITLE (start–end, duration) — Concept in one sentence+Visual elements: [each element, size, animation, timing]+Motion language: [kind of motion]+Eases used: [3–4 distinct GSAP eases]+Exit: [transition into next beat]+Audio: [VO line / SFX / music layer]+```++Top of file: a timing table with scene · start · duration · composition file.++**Propose a rule-of-threes structure:**+- Act 1 (hook) ≈ 20% of duration+- Act 2 (body) ≈ 55%+- Act 3 (payoff + outro with 4–6 second hold) ≈ 25%++(MOTION_PHILOSOPHY §0 Law 9, §1.)++**Map user intents → catalog blocks:** `Read: references/catalog-intent-map.md`++**Gate:** show storyboard + timing table. Iterate until the user approves.++---++## Gate 6 · Build compositions++Invoke `/hyperframes` for framework rules. This skill owns the scaffold and discipline; `/hyperframes` enforces the rules.++### Scaffold every sub-composition++```html+<div data-composition-id="scene-name" data-start="..." data-duration="...">+ <style>[data-composition-id="scene-name"] { /* scoped */ }</style>+ <!-- DOM -->+ <script>+ (function(){+ const SLOT_DURATION = ...;+ const tl = gsap.timeline({ paused: true });+ // ... tweens ...+ tl.to({}, { duration: SLOT_DURATION }, 0); // anchor — MOTION_PHILOSOPHY Law 11+ window.__timelines["scene-name"] = tl;+ })();+ </script>+</div>+```++Full boilerplate + captions pattern + ambient-bg pattern: `Read: references/composition-scaffold.md`++### Build rules++- **Ambient background** on `data-track-index="0"` for the full composition duration.+- **Kinetic-type openers:** per-word stagger 0.06–0.10s.+- **Captions** as body-level siblings of the root composition in `index.html`, each with `data-track-index ≥ 20`. Never inside scene timelines (MOTION_PHILOSOPHY §3.13).+- **Catalog blocks** installed via `npx hyperframes add <name>`. Immediately **scope the block's CSS** to `[data-composition-id="..."]` — catalog blocks ship with `html, body { ... }` rules that bleed into the parent document when loaded as sub-compositions.- - **Vertical + face-cam:** wrap native 1920×1080 face in a transform (`translate` + `scale`) for bottom-half or full-screen mode. (If you end up here instead of `/short-form-video`, strongly consider the handoff.)++- **Vertical + face-cam:** wrap native 1920×1080 face in a transform (`translate` + `scale`) for bottom-half or full-screen mode. (If you end up here instead of `/short-form-edit`, strongly consider the handoff.)+- **Apply ONLY what the user supplied.** Their palette, their fonts, their logo. Don't inject anything else. If they chose MOTION_PHILOSOPHY defaults, pull the palette + font pair from `references/style-intake.md`.++### Determinism++No `Math.random()`, no `Date.now()`, no render-time `fetch()`. Use seeded PRNGs or harmonic-sin hashes (MOTION_PHILOSOPHY §3.10).++---++## Gate 7 · Lint → Studio preview (PREVIEW GATE 1 — MANDATORY)++1. `npx hyperframes lint` — fix all errors, triage warnings.+2. `npx hyperframes preview` in the background.+3. Wait for "Studio running" on `http://localhost:3002`.+4. Hand the user the URL **plus** individual composition URLs (`http://localhost:3002/?comp=<id>`). If the project has WebGL shader blocks, lead with the individual URLs — software WebGL fallback can stall the master composition.+5. **WAIT for explicit "looks good, render a draft"** before proceeding. Silence is not approval.++Hot reload is on — edits show up live.++---++## Gate 8 · Draft render → visual verification → MP4 preview → final++### Draft render++```bash+npx hyperframes render --quality draft --output renders/<slug>-draft.mp4+```++### Visual verification (MANDATORY before delivery)++Lint passing ≠ design working. Extract frames and **view them**.++1. `mkdir -p renders/frames`+2. For every beat hero moment AND every transition:+ ```bash+ ffmpeg -y -ss <t> -i renders/<slug>-draft.mp4 -frames:v 1 -q:v 2 renders/frames/t<t>.png+ ```+3. **Call the `Read` tool on every PNG.** The Read tool loads the image into context — don't just list filenames.+4. Confirm per frame: no cropped faces, correct face-mode per scene, text readable and on-palette, no overflow, transitions land on intended words, no blank frames.+5. If anything's wrong: fix → re-render → re-verify. Never ship a broken draft.++### MP4 preview (PREVIEW GATE 2 — MANDATORY)++```bash+npx serve renders -p 8080 -n+```++Do NOT use Python's `http.server` — it doesn't support HTTP Range requests, so scrubbing breaks.++Hand the user `http://localhost:8080/<slug>-draft.mp4`. **WAIT for explicit sign-off** on playback and audio sync.++### Final render++```bash+npx hyperframes render --quality standard --output renders/<slug>-final.mp4+```++Report the output path. Done.++Full preflight + pre-delivery checklist: `Read: references/build-checklist.md`++---++## Non-negotiables (load-bearing — do not soften)++- **DO NOT skip PREVIEW GATE 1 (Studio) or PREVIEW GATE 2 (rendered MP4).** Two gates per build, always.+- **DO NOT claim a render is done** until frames have been extracted AND Read via the Read tool.+- **DO NOT build anywhere but inside a dedicated project folder.** Never put `index.html` at the workspace root.+- **DO NOT ask the user for assets** before inventorying their workspace.+- **DO NOT skip the `tl.to({}, { duration: SLOT_DURATION }, 0)` anchor tween** at the end of every sub-composition timeline. MOTION_PHILOSOPHY Law 11.+- **DO NOT use `Math.random()` / `Date.now()`** inside render logic. Seeded hashes only.+- **DO NOT add `class="clip"` to `<video>` tags.** It breaks them.+- **DO NOT impose a brand on the user.** Ask first; fall back to MOTION_PHILOSOPHY defaults only when they explicitly decline.++---++## References++- `references/interview-questions.md` — full question bank by Gate+- `references/style-intake.md` — style interview + MOTION_PHILOSOPHY defaults+- `references/catalog-intent-map.md` — "user says X → install Y"+- `references/storyboard-template.md` — beat-by-beat template + worked example+- `references/composition-scaffold.md` — scoped-styles + IIFE GSAP boilerplate+- `references/build-checklist.md` — preflight + pre-delivery gates++External (workspace-level):+- `MOTION_PHILOSOPHY.md` — the one external reference this skill assumes exists. Aesthetic baseline. Fallback lives in `references/style-intake.md` if the file is missing.++## Related skills++- `/hyperframes` — framework rules, invoke at Gate 6+- `/hyperframes-cli` — init · lint · preview · render · transcribe · tts+- `/hyperframes-registry` — installing catalog blocks+- `/gsap` — GSAP animation reference- - `/short-form-video` — hand off at Gate 5 for 9:16 talking-head format++- `/short-form-edit` — hand off at Gate 5 for 9:16 talking-head format+- `/website-to-hyperframes` — hand off at Gate 1 if the starting input is a URLdiff --cc .claude/skills/short-form-edit/SKILL.mdindex 0000000,0000000..3f84baanew file mode 100644--- /dev/null+++ b/.claude/skills/short-form-edit/SKILL.md@@@ -1,0 -1,0 +1,324 @@@++---++name: short-form-edit++description: Turn talking-head footage into a finished reel, YouTube Short, or short advertisement with curiosity-led openings, earned payoffs, story-driven cuts, transcript-synced motion graphics, moving B-roll, captions, subtle music, and synchronized sound effects. Use for short-form editing; use edit-video for long-form videos and cut-silences for pause removal alone.++---++++# Short form edit++++Input: a source-video path and an optional reference-reel path.++++Deliver the requested formats and the editable project. Default to 1080x1920;++when requested, also compose 1920x1080 with its own framing and text placement.++Verify each aspect ratio independently, including its opening and CTA. The edit must tell the++speaker's story through images, timing, and sound. Virality is an aspiration, not++a result that editing can guarantee. Work locally unless delegation is requested.++++## Priority++++The first creative gate is: **"In the first 3 seconds is someone convinced they++need to watch until the end?"** Establish a specific reason to stay and earn its++payoff inside the video. Effects, asset volume, and production polish come after++this test. Treat the answer as editorial judgment until audience data exists.++++## Establish the edit++++1. Read the scoped workspace guide, `MOTION_PHILOSOPHY.md`, and the HyperFrames++ and video-storytelling skills before composition work. Use the user's brief++ over aesthetic defaults. Keep all artifacts in `video-projects/<slug>/`.++2. Probe the supplied source and reference: duration, dimensions, frame rate,++ audio, and existing transcript identity. Preserve originals. Transcribe with++ ElevenLabs Scribe using the workspace script. Never substitute an older take.++3. When a reference is supplied, inspect the entire reel using contact sheets,++ individual full-size frames, and contiguous frame strips at representative++ transitions. Review its sound when an audio-capable review surface is available.++ Save `REFERENCE-ANALYSIS.md` with timestamped observations, inferred principles,++ and explicit limits. Do not imply you heard audio based on waveform analysis.++ Read [reference-analysis.md](references/reference-analysis.md) for the reusable++ worksheet and analysis questions. Borrow editorial mechanisms, not branded copy.++4. Before locking the concept, inspect the supplied footage, brand assets, and++ relevant source demos. Save an asset shortlist with exact usable intervals,++ visible action, consequence, provenance, and a possible story role. Let a++ distinctive source moment shape the idea. Choose what reads in one glance;++ fit the complete action and result before considering a tighter crop. A filled++ frame is not useful if the viewer cannot see what is happening.++5. Read every spoken line. Run silence and mistake tools, then manually review++ the full transcript: a zero-candidate report can miss an obvious retake.++ Remove abandoned takes, preserve meaningful qualifications and the payoff,++ and keep natural breath around joins. Save reviewed source-time cut reasons.++ Render the clean cut once and derive word timing from the actual frame-aligned++ EDL. Lock the cut after the rough animatic, before polished graphics. Every later timing change rebuilds dependent++ captions, graphics, and sound from the same map.++++User authorization persists. An instruction to make a finished video and iterate++authorizes ordinary local editing and rendering. An explicit request for Kie++B-roll authorizes those generations. Resolve review gates through the current++authorization; ask only for missing approval, not again at every draft. Never post++the reel or contact anyone without explicit authorization.++++## Design the emotional journey++++Write `DESIGN.md` and a beat plan before HTML. Identify the hook, open loop,++escalation, evidence, payoff, and CTA. Give every shot a reason to exist.++++Read [curiosity-and-entertainment.md](references/curiosity-and-entertainment.md).++Create `OPEN-LOOPS.json` with each honest viewer question, planted object,++setup time, reminders or partial answers, closure time, and the spoken evidence++that earns the closure. Default to one main loop and at most one secondary loop++open at once. Close the promised lesson before the CTA; a comment request must++not be the only answer. A recurring object alone is not an open loop: establish++what is missing or unresolved, then visibly change that state.++++Build three materially different rough openings using the same truthful source++speech. Compare the first three seconds for topic clarity, curiosity, muted++comprehension, and follow-through. Choose and record the reason; do not select++only the loudest effect. Render a low-resolution moving animatic with speech and++rough sound before polishing materials. Fix predictability, missing context, or++weak payoffs at this stage. Existing approved materials can be reused, but still++review the new sequence before spending time on final rendering.++++Vary rhythm by sequence: a short cluster of discoveries, a brief anticipation,++then a payoff. Preserve word timing while varying animation speed and scale.++The 1-2 second event guideline is not a metronome or permission to add filler.++Allow the speaker's expression to carry a conviction beat. For every shot record++the viewer's expectation and the new information or consequence it supplies.++++Audit information duplication. Narration and captions carry the exact words;++graphics should usually show the example, relationship, evidence, or consequence.++Remove a third restatement as a headline unless deliberate emphasis earns it.++Prefer a specific product action or source detail to generic typing footage.++Do not invent a product result simply to make a more satisfying payoff.++++### Treat the first three seconds as a separate edit++++For each opening record the viewer benefit, unresolved question, visible evidence++by second three, and the exact payoff scene. Reject vague teasing and any promise++that this footage cannot fulfill. An advertisement may resolve a concrete example++or explain a mechanism before inviting the viewer to learn more; it must not++promise a complete tutorial and deliver only a registration CTA.++++Make the first frame immediately meaningful. A surprising action, contradiction,++result glimpse, or revealing human expression can establish the tension. Choose++an impact or transition only when it sharpens that idea. A quiet impossible-looking++result can beat a loud montage. Avoid a mandatory stamp, flash, or 0.3-second effect.++++Use a supplied sound reference when available. Remove recording lead-in, align++the effect's audible impact with the visual landing within two frames, and shape++its level and tail around the first words. Make the hit noticeable while keeping++speech clear; briefly dip the music if helpful. Do not make loudness the only hook.++++The opening still has to work muted. Establish the topic or tension immediately,++then reveal another meaningful state within the first three seconds. Avoid an++unrelated logo bumper, added silence, repeated flashes, or an effect that delays++the argument. Match the chosen material style. Vary the device between reels;++do not automatically stamp STOP on every video.++++Save a first-three-seconds shot/sound plan and inspect the encoded opening++frame by frame, including its first frame, impact, reveal, and return to the main++edit. Check that the first spoken word survives the impact mix. Record this as++a distinct opening-hook gate in the verification report.++++### Build the visual world++++- Choose a visual direction from the subject, audience, source material, and++ brand brief. Record why it suits this story. Documentary footage, visual comedy,++ product demonstrations, and designed objects are options, not required quotas.++ Use coherent colors, type, and transitions without imposing paper on every reel.++- Choose full speaker, split, or full supporting footage by the current attention++ target. Preserve expressions, gestures, and the evidence in each requested ratio.++- Plan rhythm by sequence: burst, anticipation, reveal, and breathing room. Treat++ 1-2 seconds as a pacing diagnostic, not a cutting schedule. Keep longer holds++ when a developing action or performance earns them, and record the reason.++ Assign transitions by their editorial purpose, never by shot-index rotation.++- Escalate and release. Use short moments of relative stillness to land conviction++ or a reveal. Do not enforce the long-form 4-6-second outro on a short reel.++- Use an object callback: the unfinished model planted in the hook should resolve++ at the payoff. Show relationships and transformations, not just successive++ title cards. A viewer watching muted should still follow the central idea.++- Keep text within a phone-safe region. For 1080x1920, start with x=90..930,++ y=200..1600, reserving the right edge and bottom for social UI. Adjust captions++ to actual face position in every layout. Use short phrase groups and exact++ word onsets; keyword emphasis must preserve the speaker's wording.++++For a minimal, Apple-style brief, read++[premium-motion-and-footage.md](references/premium-motion-and-footage.md).++Use restrained type, negative space, real object depth, directional light, and++soft contact shadows. Minimal composition can still have rich, purposeful motion++and sound. Do not mistake a small object on a blank slide for premium design.++++### Make the reel entertaining through layers and actions++++Give the eye one clear attention target. Use depth, occlusion, light, and camera++movement when they make the action easier to follow. Keep typography readable++and use dimensional treatment only when the chosen material world calls for it.++For a paper brief, inspect fibers, edges, folds, contact shadows, and perspective++in the encoded output. These are conditional craft checks, not universal style rules.++++Give every extended graphic beat an action with an outcome: a key seats and a++project starts, criteria turn into checks, a card opens to reveal a result, or a++stack assembles into a system. A card such as Define good can swivel or tilt so++its edge and moving contact shadow remain visible as its criteria resolve.++Avoid settle-and-freeze title cards. Subtle secondary motion supports the main++action; identical idle bobbing applied to every object is not storytelling.++++Use the supplied human-edited reference to study how attention moves: wide++context, isolated detail, interaction, visible consequence, then return to the++speaker. Before delivery ask what makes each sequence entertaining beyond looking++professional. A new heading or a new caption alone is not the answer.++++Audit named people, products, and places in the transcript before storyboarding.++Use a verified portrait when recognizing a real person matters, rather than++defaulting to their name in text. Prefer their own site or an attributable source,++save provenance, and inspect the actual image. Animate the photograph as a++physical object when appropriate, with a meaningful callback. Never generate++a likeness and present it as an authentic photo. A moving portrait remains a++photographic layer and does not count as moving B-roll.++++Review adjacent shots as silhouettes and actions, with headings hidden. If they++still look like the same card reveal, redesign the weaker beat. Vary mechanisms:++tear to reveal, unfold to show scale, press to create, connect to enable, process++to produce a result. Preserve a coherent world and understandable cause and++effect. Spend the strongest action on the most important spoken idea. A user's++engagement score is feedback for iteration, not a metric a validator can certify.++++For product stories, seek real source material: public product pages, official++documentation, authentic screen recordings, and official logos. Record actual++scrolls, selections, or visible interactions when useful. Present real logos on++dimensional surfaces without redrawing an approximate mark or implying endorsement.++Retain source URLs and distinguish authentic product footage from illustrative++interfaces and generated B-roll. Never expose real credentials in captured UI.++An animated source screenshot may be one layer in an explanatory composition,++but it must not substitute for moving B-roll when the brief requires video.++++### Verify brand assets before drawing++++Never invent, approximate, trace from memory, or generate an existing brand's++logo. A radial star is not a substitute for the Claude mark. Use the exact++user-supplied asset first; otherwise obtain the asset from the brand's official++site or media kit. Search engines help locate sources, but do not establish++authenticity. Save the source URL or supplied path, original file, and checksum.++Inspect the artwork before use, preserve its shape and proportions, and animate++the authentic asset or the surface carrying it. Do not alter a logo's geometry++to create depth. Audit every logo occurrence in the final encoded reel against++its source asset, including small marks and recurring motifs. If no verified++asset is available, use plain brand-name text rather than fabricate a mark.++++### Balance graphics with moving footage++++Choose the mix from the story and available evidence. There is no default++graphics/B-roll percentage. Keep a duration ledger with authentic footage,++generated illustration, designed graphics, and speaker-only time; explain the++denominator and count split panels once. Captions over footage remain footage.++A still image with a camera move is a photographic layer, not moving B-roll.++++Use each distinct B-roll scene only once per reel. Another crop, filename, speed,++reverse, or grade does not make it a new scene. Reusing the same selected scene++across the two requested aspect ratios is expected. Record source scene identity,++file hash, and selected interval in `assets/footage-ledger.json`; run the footage++validator below. A graphic callback must develop the original idea into a new++state and composition. It is not permission to replay footage.++++Default to containing the full source frame when a tighter crop hides context.++Keep the subject, action, and consequence visible throughout the selected interval,++with captions outside that action. Inspect beginning, middle, and end in each++ratio at phone size. Dense demo text must not be required to understand a fleeting++insert; isolate a meaningful visible action or give it more time. Avoid duplicated,++blurred background video as an automatic solution for vertical framing.++++Prefer a specific action with a readable consequence. Compare adjacent shots++with headings hidden: if the sequence repeats the same visual mechanism or could++belong in any AI advertisement, replace the weakest insert. Generated metaphors++can add surprise but cannot stand in for captured evidence. Prioritize authentic++human reactions where they support the story.++++## Generate and assemble++++1. Use Kie text-to-video for simple moving inserts when authorized. Verify the++ current official API schema. Save model, prompt, task ID, selected output,++ and generation state; reuse successful jobs rather than resubmitting blindly.++ Download and inspect real video files, including full-size corners throughout++ the selected interval for generated text, logos, or malformed objects. Reframe++ or regenerate defects, then verify the encoded result. B-roll must have genuine motion, not++ a still with a zoom. Static diagrams may be source assets only if the final++ animation meaningfully transforms them. Never generate fake evidence or++ imply a synthetic person is the real named person.++2. Animate graphics from the retimed words. Store each shot's anchor phrase and++ time. Bind sub-element reveals to their own spoken nouns, not arbitrary++ `index * 0.4` staggers. Target within 2 frames of word onset for captions and++ impact events, with at most 0.15 seconds of deliberate visual anticipation.++3. Use the HyperFrames timeline contract: one registered paused timeline per++ composition, full duration coverage, local assets, muted video and separate++ audio. Animate the footage wrapper. Deterministic canvas or CSS 3D is fine;++ use genuine rendered 3D when the metaphor needs it. The framework is a tool,++ not an aesthetic. Preserve editable source.++4. Source or generate an instrumental bed with clear narration space. Save its++ provenance. Normalize the voice before mixing; start the bed roughly 14-20 dB++ below voice, then adjust to the actual track. Duck under speech, fade cleanly,++ and measure the final mix. Aim around -16 LUFS and <= -1 dBTP, adapting to++ source dynamics rather than crushing them.++ When the user says music is too loud, reduce its gain relative to the reviewed++ version and save the measured change. Verify after final normalization that++ the bed-to-voice ratio is lower; a lower master level alone is not a fix.++5. Build SFX from the visual-event map. Paper impacts land on object contact;++ swipes support movement; restrained success tones support checks. Align the++ audible onset or impact peak, not just the beginning of an audio file with++ leading silence. Vary effect density and levels. Voice remains dominant.++ Score anticipation, contact, and release separately. A brief bed dip can make++ the next contact more distinct without raising its volume. Let some cuts pass++ without a whoosh. Record cue purpose and audition transitions when supported.++ A request for more SFX calls for a richer event score: paper movement, object++ contact, docking, connection, anticipation, and reveal can each have distinct++ sounds. Make meaningful contacts perceptible, vary texture and density, and++ retain quieter conviction beats. Do not substitute louder music or a whoosh++ on every cut. Inspect the actual animation landing before setting each cue.++6. Run lint and inspect the live preview before rendering. Browser automation is++ headless with Pointer Lock and pointer capture disabled in every context.++ Local automated review is permitted when the user authorized autonomous++ iteration. Render a draft, inspect it, revise, then render final quality.++ If the framework capture stalls, a deterministic graphics export plus FFmpeg++ assembly is acceptable. Await local fonts before capturing canvas. Normalize++ every video input to the same frame time base before overlaying, and inspect++ every encoded cut for one-frame mismatches. Build final face crops from the++ native-resolution source rather than a downscaled editing proxy.++++## Gates before delivery++++Use [quality-gates.md](references/quality-gates.md). The plan validator catches++structural defects but cannot certify taste, motion, or the audio listening pass:++++```powershell++node .claude/skills/short-form-edit/scripts/validate-plan.mjs video-projects/<slug>++node .claude/skills/short-form-edit/scripts/validate-footage.mjs video-projects/<slug>++```++++It reads `assets/plan.json`, `assets/transcript.json`, and++`assets/edit-decisions.json`. See [plan-schema.md](references/plan-schema.md).++For another implementation, export that schema or adapt the validator explicitly;++never silently skip checks because the schema differs.++++Inspect encoded hero frames for every shot at full size and phone scale. Inspect++contiguous strips across every cut and transition, plus the complete motion where++supported. Check speech joins, fresh ASR from final audio, voice/bed balance,++SFX timing, clipping, and the last syllable. Distinguish listening from signal++analysis. Record any unavailable review modality honestly.++++Run a separate uninterrupted entertainment review of the animatic and final++where real-time video review is supported. Record attention-drop timestamps,++predictable sequences, unresolved promises, and reading overload in++`ENTERTAINMENT-REVIEW.md`. Fix the weakest sequences, then recheck them in context.++Automated playback completion and contact sheets are technical/visual evidence,++not a claim of uninterrupted perceptual viewing. If that modality is unavailable,++use chronological sequence strips and explicit loop-state checks, and disclose++the limit. Never manufacture retention scores or call internal hook comparisons++an audience A/B test.++++Fix findings, archive superseded versions, and repeat the checks affected by each++change. Give `VERIFY.md` the actual output hash, measured results, inspected++artifacts, revisions, and unresolved limits. Do not claim passes based on code++inspection, file existence, or an empty validator result.++++## Delivery++++Return a playable final MP4, its absolute path, and the skill path. Keep the++composition, assets, source and retimed transcripts, EDL, shot/event plan, audio++stems, reference analysis, and QA evidence in the project. Clearly identify the++final version. Never label a draft final or claim guaranteed viral performance.diff --cc .claude/skills/short-form-edit/references/curiosity-and-entertainment.mdindex 0000000,0000000..87fd5ffnew file mode 100644--- /dev/null+++ b/.claude/skills/short-form-edit/references/curiosity-and-entertainment.md@@@ -1,0 -1,0 +1,79 @@@++# Curiosity and entertainment workflow++++First and highest-priority test: "In the first 3 seconds is someone convinced++they need to watch until the end?" Record the benefit, question, and earned++payoff that support the judgment. A technical validator or internal comparison++cannot establish that actual viewers are convinced.++++Prioritize this gate over every aesthetic score. If the opening only earns++"that looked cool" and cannot answer "why should I stay?", revise it before++rendering the final. Document the editorial reason to pass or revise; never++invent a percentage of viewers convinced. Check again on the encoded export.++++## Before composition++++1. Read the exact retained speech. State the useful lesson a viewer receives by++ the end. Keep qualifications and do not manufacture a claim for a hook.++2. Pick an unresolved state viewers can understand immediately. Examples:++ three empty slots around an AI model; a project with an unfilled access slot;++ two parts that appear incompatible. Make the missing information specific.++3. Map setup, partial answer, reminder, and resolution. Use one main question++ with short subordinate questions, rather than many unrelated mysteries.++4. Draft three different openings: problem first, result glimpse, or recognition++ first. Each must lead naturally into the same source narration. Render their++ first three seconds cheaply, compare, and record the choice.++5. Build the entire moving rough edit. Use simple shapes and existing assets.++ Judge story before shadows. Recut speech only when needed and preserve its++ meaning; rebuild all timing-dependent artifacts after any EDL change.++++## Loop ledger++++Save OPEN-LOOPS.json as an array. Each item has:++++```json++{++ "id": "main",++ "question": "What fills the three missing slots?",++ "object": "Three numbered empty slots around the model",++ "setup": 2.3,++ "updates": [{"time": 5.1, "state": "First slot becomes the specification"}],++ "closure": 38.4,++ "resolution": "All three named layers assemble around the same model",++ "supportingSpeech": "an entire system around Claude"++}++```++++Times are output seconds. A checker can verify order, coverage, and source++anchors; only rendered inspection establishes whether the question is clear.++An object reappearing without resolving anything is a callback, not a closed loop.++Add an `opening` object with `benefit`, `evidenceBy3`, and `payoffTime` so the++highest-priority test has concrete evidence. Keep `supportingSpeech` verbatim++when quoting; label any paraphrased explanation as a paraphrase.++++## Direct each sequence++++- Expectation: what does the viewer think happens next?++- Development: what changes their understanding or gives a partial answer?++- Payoff: what result, contrast, or connection lands?++- Attention: which single thing should their eye follow?++- Rhythm: where does density increase, briefly release, then resolve?++- Sound: which cue anticipates, contacts, or releases? Which cuts stay quiet?++++Do not force suspense into a straightforward explanation. Do not withhold the++topic, fabricate a failure, or add a vague "wait for it". A deliberately incomplete++editorial model must not be presented as an actual product failure or output.++Showing all answers on the first card closes a list-based loop prematurely.++++## Review++++At rough and final stages, review uninterrupted motion and actual sound when++the runtime supports perception of them. Record the actual modality. When only++stills/strips and signal analysis are available, use those honestly: inspect++chronological 0.25-0.5 second samples plus contiguous action strips, audit every++loop state, and do not call successful automated playback a listening/viewing pass.++++Write timestamped weaknesses and decisions in ENTERTAINMENT-REVIEW.md. Compare++adjacent shots without headings; remove generic footage and repeated headline++copy that add no information. Distinguish audience measurements from editorial++judgment. If future user-provided retention data exists, relate drop-offs to exact++edit moments without assuming the edit caused them.diff --cc .claude/skills/short-form-edit/references/plan-schema.mdindex 0000000,0000000..17ed23bnew file mode 100644--- /dev/null+++ b/.claude/skills/short-form-edit/references/plan-schema.md@@@ -1,0 -1,0 +1,65 @@@++# Editable plan schema++++Keep one canonical map. Seconds are on the edited timeline except fields prefixed++with `source`. Quantize cuts and scene boundaries to `1/fps`; retain precise ASR++word timings rather than rounding every word independently.++++`assets/plan.json`:++++```json++{++ "duration": 10,++ "fps": 30,++ "scenes": [{"id":"s00","start":0,"end":10,"layout":"face","kind":"hook","anchor":"First three words","anchorTime":0.1}],++ "events": [{"time":0,"type":"paper-tap","visual":"s00","anchor":"First three words"}],++ "captions": [{"start":0.1,"end":0.8,"words":[{"text":"First","start":0.1,"end":0.3,"sourceStart":1.1,"sourceEnd":1.3}]}]++}++```++++Layouts are `face`, `split`, `paper`, `broll`, and `broll-split`. For this schema,++B-roll scene `kind` names `assets/<kind>.mp4`. `events` are actual meaningful++visual actions, never filler entries inserted only to satisfy cadence. Longer++holds can carry `holdReason` on their scene and must be justified editorially.++++`assets/transcript.json` contains `words` with the same text/start/end/sourceStart/++sourceEnd fields and `text`. `assets/edit-decisions.json` contains `duration`, `fps`,++`keeps` with `{sourceStart,sourceEnd,start,end}`, and reviewed removal reasons.++Every retained word must map back to one kept range without crossing a removed++interval. `sourceStart` may be absent only when no edit was made; adapt validation++explicitly for that case rather than guessing a mapping.++++## Creative companion++++Keep creative reasoning in DESIGN.md alongside the technical map. It must name:++++- Audience, requested aspect ratios, chosen visual direction, and asset shortlist.++- Three distinct opening concepts and their rough preview paths; the selected++ concept's benefit, viewer question, evidence visible by three seconds, and payoff.++- Sequence ranges with expectation, development, consequence, attention target,++ rhythm, and source rationale. Group related shots; avoid redundant per-frame prose.++- OPEN-LOOPS.json using the schema in curiosity-and-entertainment.md. Resolve each++ promised answer before the CTA; verify closure in the rendered sequence.++- Timestamped ENTERTAINMENT-REVIEW.md findings and revisions before polish.++++The plan validator checks timing and coverage. It does not validate these creative++documents or certify engagement; review their claims against the rendered footage.++++## Footage ledger++++For projects with B-roll, `assets/footage-ledger.json` is an array of rows:++++```json++[{"scene":"s02","sourceSceneId":"wallet-opening","asset":"assets/wallet.mp4",++"sha256":"<64 lowercase hex characters>","sourceStart":0.5,"sourceEnd":1.5,++"framing":{"9x16":"Full source contained; hands and wallet visible",++"16x9":"Full source contained; captions outside the action"}}]++```++++Intervals refer to that exact local asset, before playback-speed adjustment.++Record upstream source provenance separately for downloaded excerpts. Scene++identity survives crop, grade, speed, reverse, and transcode changes. Each scene++appears once per reel; the same selection can be used in both requested ratios.++`validate-footage.mjs` verifies selected rows, file hashes, duplicate scene++identities, and overlapping intervals. Visual review must still establish that++the action and result remain visible and that differently encoded duplicates++have not evaded the source identity ledger.diff --cc .claude/skills/short-form-edit/references/premium-motion-and-footage.mdindex 0000000,0000000..88ffbe5new file mode 100644--- /dev/null+++ b/.claude/skills/short-form-edit/references/premium-motion-and-footage.md@@@ -1,0 -1,0 +1,42 @@@++# Premium motion and readable footage++++The first-three-seconds reason-to-stay gate remains the highest priority. This++craft pass improves its delivery; it does not replace curiosity with decoration.++++For a minimal, Apple-style treatment, choose a coherent material family and one++focal action. Build readable object silhouettes, bevelled edges, thickness,++occlusion, directional lighting, and soft contact shadows. Use actual 3D when++camera rotation or assembly needs it. Keep typography clean and subordinate.++Avoid heavy text outlines, arbitrary glowing panels, fake chrome, uniform idle++bobbing, and repeated flat cards. Paper should have visible edges and perspective;++ceramic or metal should show form through light rather than noisy texture.++++Inspect at phone size. Negative space should concentrate attention, not leave++the meaningful object too small. Compare adjacent shots without their headings.++Change action, scale, or camera only when it supplies new information. Alternate++assembly, detail, human expression, evidence, and a resolved wider view. Every++pattern interrupt needs an editorial purpose. Repeated B-roll is prohibited;++a callback uses a changed graphic state or a genuinely new source moment.++++For each B-roll insert, save a ledger row with scene id, semantic sourceSceneId,++asset path relative to project, sha256, sourceStart, sourceEnd, and framing notes++for each delivery ratio. Source intervals refer to that exact asset file. Also++retain upstream provenance for excerpts. Detect duplicate scene IDs and overlapping++intervals from files with the same hash, including renamed copies. Re-encoding can++change hashes, so semantic scene identity and visual review remain necessary.++++Use contain framing by default. An intentional crop must keep the complete++subject, visible action, and result inside a documented region throughout the++selection. Check start, midpoint, endpoint, and action peaks independently in++16:9 and 9:16. Do not enlarge a scene until essential context disappears or place++captions over the evidence. Phone-scale review determines whether a screen demo++communicates anything; passing dimensions alone is insufficient.++++Normalize the voice first. If music was overwhelming, measure its reduction++against the previous stem and preserve the quieter bed-to-voice ratio through++mastering. Add varied SFX tied to physical motion and narrative reveals, not an++arbitrary cue-count quota. Check onset, contact peak, tail, and masking. State++whether a real listening pass was possible; RMS and ASR do not replace hearing.++++Save concrete revision evidence. A requested 10/10 is a quality aspiration, not++a score an internal validator can award.diff --cc .claude/skills/short-form-edit/references/quality-gates.mdindex 0000000,0000000..7487d36new file mode 100644--- /dev/null+++ b/.claude/skills/short-form-edit/references/quality-gates.md@@@ -1,0 -1,0 +1,59 @@@++# Short-form quality gates++++Apply these to the encoded final, not only the source composition.++++| Gate | Required evidence | Fail examples |++|---|---|---|++| Priority 1: reason to stay | "In the first 3 seconds is someone convinced they need to watch until the end?" Specific benefit, unresolved question, and actual ending payoff | Attention grabbed with no reason to continue, vague teasing, promise not delivered |++| Story | Exact retained script, hook, complete argument, payoff, CTA | Repeated retake, missing qualification, unrelated insert |++| Open loops | Viewer question, planted unresolved state, timed partial answers, earned closure before CTA | Random question mark, recurring decoration, withheld basic context, promise never answered |++| Asset discovery | Inspected shortlist before concept lock, exact intervals, legible action and consequence | Storyboard locked before reviewing supplied assets, dense UI shown too briefly to understand |++| Rough edit | Three distinct opening drafts and a moving animatic reviewed before final polish | Choosing by impact loudness, polishing a predictable slideshow |++| Rhythm and reading load | Sequence-level density changes, anticipation/payoff, caption-versus-heading audit | Metronomic cuts, three copies of the same sentence, simultaneous competing reveals |++| Entertainment review | Timestamped critique separate from technical QA, review modality stated | Playback completion reported as audience engagement, fabricated retention score |++| First three seconds | Encoded first frame, immediately meaningful image, specific reason to stay by 3 s, sound/impact alignment, clear opening word | Caption-only opening, long audio lead-in, masked consonant, unrelated bumper |++| Word timing | EDL-derived words, fresh final-audio ASR, spot checks | Cut consonant, missing word, caption ahead of speech |++| Cadence | Shot durations and semantic visual-event map | Repeated template, >2.2 s gap without a deliberate story hold |++| Layout | Every hero frame at full size and phone scale | Face cropped, mouth covered, text beyond safe region |++| Motion | Contiguous encoded frames across every transition | Black flash, one-frame pop, unexpected freeze, conflicting moves |++| Paper depth (paper briefs only) | Close inspection of object edges, shadows, perspective | Flat rectangles used as decorative slide containers |++| Dimensional typography (when chosen) | Full-size and phone-size major headings, bevel/edge, cast shadow, readable perspective | Flat titles above dimensional objects, muddy extrusion, glowing text |++| Layered entertainment | Encoded action-to-result sequences, foreground/background separation, moving object shadows | Same idle bob on every card, title changes without consequence, settle-and-freeze beats |++| Product authenticity | Saved source URLs and reviewed real page interactions or official marks when used | Approximate invented logo, fabricated product evidence, private data in a screen capture |++| Named entities | Transcript audit, verified portrait or authentic source material where recognition matters, saved provenance | Name-only treatment when a recognizable person is central, synthetic portrait presented as real |++| Editorial variety | Adjacent silhouettes and action mechanisms compared; encoded setup, action, and consequence | Repeated card reveal with different words, identical bobbing, visual activity without a story outcome |++| Logo fidelity | Exact supplied or official asset, checksum, and every encoded occurrence compared with it | Generic star used for Claude, traced or generated brand mark, distorted proportions |++| Footage balance | Duration ledger for the supporting track and total runtime; story-based selection rationale, authentic and synthetic separated | Shot-count-only percentage, counting facecam or still-image zooms as B-roll, repetitive diagram run |++| Material realism (physical material briefs) | Encoded close-ups and motion showing fibers, imperfect edges, contact and cast shadows, directional light | Flat cream fills with blur shadows, texture that disappears at phone size, noise obscuring words |++| B-roll | Probed moving footage, sufficient source duration at the chosen speed, reviewed selected interval, exact encoded frame count per segment | Ken Burns still, irrelevant action, synthetic proof, short source clip truncating the final export |++| No repeated footage | Scene identity and file-hash/interval ledger; duplicate and overlap negative controls | Same scene replayed, renamed, recropped, reversed, or regraded as a new insert |++| Action framing | Start, middle, end, and action peaks in each ratio; full subject, action, and result visible at phone size | Enlarged B-roll hides context, captions cover evidence, unreadable UI is the only explanation |++| Minimal dimensional craft (when requested) | Readable focal object, thickness, perspective, restrained type, light and contact shadows; sequence variety | Tiny object on an empty slide, harsh strokes, repeated flat cards, decorative motion |++| Audio revision | Measured bed reduction relative to reviewed version; varied purposeful SFX with inspected contact times | Master merely quieter, bed still masks voice, more music substituted for SFX |++| Sound | Actual listening when supported, plus stem and mix measurements | Voice buried, repeated loud whoosh, onset unaligned, clipping |++| Delivery | Every requested ratio (default 1080x1920; 1920x1080 when requested), independently framed and reviewed, correct duration, fast-start MP4, final hash | Wrong aspect ratio, missing final syllable, stale export |++++The artistic test: each shot advances the story or changes the emotional emphasis.++Remove an effect that only demonstrates the renderer. Most graphics should show++an object doing something: a spec filling, a test resolving, a workspace assembling.++At least one metaphor returns with a changed meaning or completed state.++++Calibrate new validators with negative controls. A caption shifted by 0.3 seconds,++a one-frame scene gap, and an omitted spoken word should fail the relevant checks.++Do not make the validator accept the current output merely to reach green.++++The original workspace motion checklist has brief-dependent defaults. A warm++paper reel deliberately overrides black canvas, chrome text, halos, grids, and a++long outro. Preserve timing discipline, coherent materials, callback, full timeline++coverage, and rendered visual inspection.++++If a review modality is unavailable, state it explicitly. A waveform establishes++levels and timing, not whether music is emotionally right. ASR establishes spoken++content, not whether every audio edit sounds natural. Never count one as the other.++++When replacing a paper scene with footage, choose caption contrast from the++actual background, including qualifiers and small secondary text. Inspect the++first encoded frame of every inserted screen recording: fractional source seeks++must not leave an empty viewport before the footage appears. Review the entire++selected generated-video interval for malformed hands, gibberish focal text,++unintended marks, and implausible actions; generation success is not asset QA.diff --cc .claude/skills/short-form-edit/references/reference-analysis.mdindex 0000000,0000000..4902b50new file mode 100644--- /dev/null+++ b/.claude/skills/short-form-edit/references/reference-analysis.md@@@ -1,0 -1,0 +1,29 @@@++# Analyze a short-form reference++++Use a reference the student supplies and has permission to use. Keep the recording++and analysis inside the private video project. Do not copy its script or assets.++++## Watch and record++++Watch the full video once for its promise and payoff, then again with timestamps.++For each meaningful change, record:++++| Time | Spoken idea | Visual change | Sound cue | Viewer question | Payoff |++| --- | --- | --- | --- | --- | --- |++| Fill from the supplied reference | Verbatim phrase | Framing, footage, or graphic | Audible impact | What remains unresolved | Where it resolves |++++Measure the actual resolution, duration, and frame rate. Separate observations++from your interpretation of why a choice works. A fast montage does not imply++that every new edit needs the same number of cuts.++++## Transfer the mechanism++++- Make the opening visual support a truthful promise in the spoken hook.++- Use a brief crop or caption emphasis on a specific word, then return to rest.++- Cut to moving footage when it supplies evidence or explains something concrete.++- Give each sound cue a visible event; align its audible impact, not its file start.++- Build curiosity that the retained recording actually resolves.++- End after the payoff with enough room for the intended action to be understood.++++Write which mechanisms fit this recording and which would distract from it.++Design new copy, scenes, and motion from the student's own transcript and brief.diff --cc .claude/skills/short-form-edit/scripts/validate-footage.mjsindex 0000000,0000000..4d4be23new file mode 100644--- /dev/null+++ b/.claude/skills/short-form-edit/scripts/validate-footage.mjs@@@ -1,0 -1,0 +1,25 @@@++import fs from 'node:fs';import path from 'node:path';import crypto from 'node:crypto';++export function validateFootage(rows){++ const errors=[],seen=new Set();++ for(let i=0;i<rows.length;i++){++ const r=rows[i];if(!r.sourceSceneId)errors.push(`Missing scene identity: ${r.scene}`);++ else if(seen.has(r.sourceSceneId))errors.push(`Repeated footage scene: ${r.sourceSceneId}`);seen.add(r.sourceSceneId);++ if(!/^[a-f0-9]{64}$/.test(r.sha256||''))errors.push(`Missing asset hash: ${r.scene}`);++ if(!(r.sourceStart>=0&&r.sourceEnd>r.sourceStart))errors.push(`Invalid interval: ${r.scene}`);++ for(const previous of rows.slice(0,i))if(previous.sha256===r.sha256&&Math.min(previous.sourceEnd,r.sourceEnd)>Math.max(previous.sourceStart,r.sourceStart)+.001)errors.push(`Overlapping footage: ${previous.scene} / ${r.scene}`);++ }++ return {ok:errors.length===0,errors,scenes:rows.length};++}++if(process.argv[1]&&path.resolve(process.argv[1])===path.resolve(import.meta.filename)){++ const root=path.resolve(process.argv[2]||'.'),plan=JSON.parse(fs.readFileSync(path.join(root,'assets/plan.json')));++ const footage=plan.scenes.filter(s=>s.layout?.includes('broll')||s.mode==='footage');++ const ledgerPath=path.join(root,'assets/footage-ledger.json'),rows=fs.existsSync(ledgerPath)?JSON.parse(fs.readFileSync(ledgerPath)):[];++ const result=validateFootage(rows);++ for(const s of footage)if(rows.filter(r=>r.scene===s.id).length!==1)result.errors.push(`Missing or duplicate ledger row: ${s.id}`);++ for(const r of rows){++ const asset=path.resolve(root,r.asset);if(!asset.startsWith(root+path.sep)||!fs.existsSync(asset)){result.errors.push(`Missing local asset: ${r.scene}`);continue;}++ if(crypto.createHash('sha256').update(fs.readFileSync(asset)).digest('hex')!==r.sha256)result.errors.push(`Asset hash mismatch: ${r.scene}`);++ if(!footage.some(s=>s.id===r.scene))result.errors.push(`Unselected ledger row: ${r.scene}`);++ }++ result.ok=result.errors.length===0;console.log(JSON.stringify(result,null,2));process.exitCode=result.ok?0:1;++}diff --cc .claude/skills/short-form-edit/scripts/validate-plan.mjsindex 0000000,0000000..0860bdanew file mode 100644--- /dev/null+++ b/.claude/skills/short-form-edit/scripts/validate-plan.mjs@@@ -1,0 -1,0 +1,38 @@@++import fs from 'node:fs';import path from 'node:path';++export function validatePlan(plan,transcript,edl,exists=()=>true){++ const errors=[],fail=m=>errors.push(m),fps=plan.fps,tol=1/fps+.005;++ if(!Number.isFinite(fps)||fps<=0)fail('Invalid fps');++ if(!plan.scenes?.length)fail('No scenes');++ const words=transcript.words.filter(w=>w.type!=='spacing');++ const caps=(plan.captions||[]).flatMap(g=>g.words);++ if(caps.length!==words.length)fail(`Caption word count ${caps.length} != retained word count ${words.length}`);++ words.forEach((w,i)=>{++ const cap=caps[i];if(!cap||cap.text!==w.text)fail(`Caption ${i} missing or different`);++ else if(Math.abs(cap.start-w.start)>.005||Math.abs(cap.end-w.end)>.005)fail(`Caption ${i} timing differs from transcript`);++ if(w.end<=w.start||w.start<0||w.end>plan.duration+tol)fail(`Word ${i} outside timeline`);++ const k=edl.keeps.find(k=>w.sourceStart>=k.sourceStart-.016&&w.sourceEnd<=k.sourceEnd+.016);++ if(!k)fail(`Word ${i} crosses a cut or has no source range`);++ else if(Math.abs(w.start-(k.start+w.sourceStart-k.sourceStart))>.006)fail(`Word ${i} source mapping incorrect`);++ });++ let end=0;const ids=new Set();for(const s of plan.scenes||[]){++ if(ids.has(s.id))fail(`Duplicate scene ${s.id}`);ids.add(s.id);++ if(Math.abs(s.start-end)>.005)fail(`Scene gap or overlap at ${s.id}`);++ if(s.end<=s.start)fail(`Scene ${s.id} has no duration`);++ if(Math.abs(s.start*fps-Math.round(s.start*fps))>.01)fail(`Scene ${s.id} is not frame aligned`);++ if(!s.anchor||!Number.isFinite(s.anchorTime))fail(`Scene ${s.id} has no verified anchor`);++ else if(s.anchorTime-s.start<-.15||s.anchorTime-s.start>.2)fail(`Scene ${s.id} anchor not close to cut`);++ if(s.layout.includes('broll')&&!exists('assets/'+s.kind+'.mp4'))fail(`Missing moving B-roll ${s.kind}`);++ end=s.end;++ }++ if(Math.abs(end-plan.duration)>.005)fail('Scene coverage differs from duration');++ const times=[0,...(plan.events||[]).map(e=>e.time),plan.duration].sort((a,b)=>a-b);let maxGap=0;++ for(let i=1;i<times.length;i++){const gap=times[i]-times[i-1];maxGap=Math.max(maxGap,gap);if(gap>2.2){const s=plan.scenes.find(s=>times[i-1]>=s.start&×[i-1]<s.end);if(!s?.holdReason)fail(`Unexplained visual-event gap ${gap.toFixed(2)}s at ${times[i-1].toFixed(2)}`);}}++ for(const e of plan.events||[])if(!ids.has(e.visual)||e.time<0||e.time>=plan.duration)fail('Invalid visual event '+JSON.stringify(e));++ for(let i=0;i<(plan.captions||[]).length;i++){const g=plan.captions[i];if(g.start>g.words[0].start+.005||g.end<g.words.at(-1).end-.005)fail('Caption group truncates word '+i);if(i&&g.start<plan.captions[i-1].end-.005)fail('Caption groups overlap '+i);}++ return {ok:!errors.length,errors,metrics:{duration:plan.duration,retainedWords:words.length,scenes:plan.scenes.length,averageShotSeconds:plan.duration/plan.scenes.length,visualEvents:plan.events.length,maxEventGap:maxGap,speakerShare:plan.scenes.filter(s=>['face','split','broll-split'].includes(s.layout)).reduce((a,s)=>a+s.end-s.start,0)/plan.duration}};++}++if(process.argv[1]&&path.resolve(process.argv[1])===path.resolve(import.meta.filename)){++ const root=path.resolve(process.argv[2]||'.');const read=n=>JSON.parse(fs.readFileSync(path.join(root,'assets',n)));++ const result=validatePlan(read('plan.json'),read('transcript.json'),read('edit-decisions.json'),p=>fs.existsSync(path.join(root,p)));++ console.log(JSON.stringify(result,null,2));process.exitCode=result.ok?0:1;++}diff --cc .claude/skills/short-form-video/SKILL.mdindex 931f1ea,0000000..9b61e04mode 100644,000000..100644--- a/.claude/skills/short-form-video/SKILL.md+++ b/.claude/skills/short-form-video/SKILL.md@@@ -1,332 -1,0 +1,330 @@@+---+name: short-form-video- description: Build and iterate short-form vertical (9:16) videos in Hyperframes — TikTok/Reels/Shorts style. Use when Nate says "short-form video", "vertical video", "TikTok/Reels/Shorts", "make a short", "talking-head + motion graphics", or when the target is a 1080x1920 composition with face video + synced scene overlays + karaoke captions. Encodes the full May Shorts 19 playbook: face-mode choreography, audio-synced scene timing, karaoke captions, and the 10-rule quality checklist.++description: Maintain the existing May Shorts teaching compositions using their legacy face-mode, scene-overlay, and karaoke-caption patterns. Use only when working on those examples or explicitly requesting this legacy scaffold. For new reels, Shorts, or short advertisements, use short-form-edit.+---++# Short-Form Vertical Video (Hyperframes)+- Short-form = 1080x1920 vertical, 10–30s, talking-head face + motion-graphic scene overlays + karaoke captions. Everything in this skill is distilled from the May Shorts 19 iteration autopsy (v1 → v4) and should be applied on every new short.++Short-form = 1080x1920 vertical, 10–30s, talking-head face + motion-graphic scene overlays + karaoke captions. Everything in this skill is distilled from the May Shorts 19 iteration autopsy (v1 → v4) and is preserved for maintenance of those examples. Use `short-form-edit` for new recordings.++**Always invoke `/hyperframes` first.** This skill sits on top of it — it does not replace the framework rules (`data-*` attributes, `window.__timelines`, composition structure). Those are non-negotiable regardless of the format.++## When this skill fires+- - "Make a short-form video", "TikTok post", "Reels", "Shorts", "vertical video"- - Any build starting from a talking-head recording + script/transcript intended for social- - Retiming, recutting, or re-syncing an existing short- - Adding karaoke captions synced to a voiceover++- Maintaining the existing May Shorts examples.++- Explicitly requesting their legacy four-layer scaffold.++## The playbook (high-level)++1. **Audio is source of truth.** Edit audio FIRST (cut retakes, pauses). Save as `<name>-edit.mp4`. Measure exact duration with `ffprobe` — this is the composition's `data-duration`.- 2. **Transcribe the edited audio** with `npx hyperframes transcribe <edit>.mp4 --model small.en --json`, or if retiming an existing build with a `shift()` function in captions, keep the existing captions and just shift scene starts.++2. **Transcribe the edited audio** with the root `scripts/transcribe-elevenlabs.mjs` helper (ElevenLabs Scribe), or if retiming an existing build with a `shift()` function in captions, keep the existing captions and just shift scene starts.+3. **Author scene boundaries in edited-time** — NEVER mix original-time and edited-time anchors in the same file. See "Audio-sync protocol" below.+4. **Build the composition scaffold** (4 layers: ambient-bg, seam-treatment, captions, face) — see "Composition scaffold" below.+5. **Author scenes with LOCAL offsets** relative to each scene's `data-start`. Each scene is its own sub-composition under `compositions/scene<N>-<label>.html`.+6. **Lint → draft render → word-exact frame verification → final render.** This is the verification gate. Never skip step 3 (frame verification).++## Composition scaffold (the 4 always-on layers)++Every short-form vertical has these four sub-compositions under `compositions/`, loaded on shared tracks:++```+index.html (root, 1080x1920, data-composition-id="main")+├── ambient-bg.html track-index="3" — radial gradient + drift grid + particles + vignette+├── face-wrapper + <video> track-index="0" — talking head (see face-mode choreography)+├── seam-treatment.html track-index="5" — feathers y=960 edge (bottom-half scenes only)+├── scene1-<label>.html track-index="1" — scene overlays (back-to-back, no gaps)+├── scene2-<label>.html track-index="1"+├── …+└── captions.html track-index="2" — karaoke captions, word-synced+```++- `data-duration` is identical across root, ambient-bg, seam-treatment, face-video, face-audio, captions. Only scene overlays change over time.+- `<audio>` for the face is a SEPARATE element (mixer needs it), never use the video's own audio track.+- `class="clip"` goes on timed divs — NEVER on `<video>` or `<audio>`.++## Face-mode choreography (the signature move of short-form)++The face lives in a wrapper div sized at the source's native landscape (1920x1080). GSAP animates the WRAPPER (never the video element — animating `<video>` dimensions freezes frames).++Two modes:++```js+const BOTTOM = { x: 0, y: 1136, scale: 0.5625 }; // bottom-half, full landscape visible+const FULLSCREEN = { x: -1166.5, y: 0, scale: 1.7778 }; // cropped-cover, fills 1080x1920+const MODE_DUR = 0.32;+```++`BOTTOM` renders the 1920x1080 source at 1080x607.5 centered in the bottom 960px. `FULLSCREEN` crops horizontally to fill the portrait frame.++**Transition 0.15s BEFORE the new scene's content lands**, using `ease: "expo.inOut"`:++```js+[+ { t: <scene-4-start>, mode: FULLSCREEN },+ { t: <scene-5-start>, mode: BOTTOM },+ …+].forEach(({ t, mode }) => {+ mainTl.to("#face-wrapper", { ...mode, duration: MODE_DUR, ease: "expo.inOut" }, t - 0.15);+});+```++A face that snaps modes instantly is the single most jarring frame in a vertical video. Always interpolate.++### Face grading (every short, no exceptions)++```css+#face-video {+ filter: contrast(1.08) saturate(1.08) brightness(0.97);+}+```++Plus a subtle 1.00 → 1.025 Ken Burns zoom over the full duration (`ease: "none"`) and a side-vignette `::after` pseudo-element so the face sinks into the surrounding navy instead of butting against a razor edge.++### Seam treatment (required for bottom-half scenes)++A navy→transparent gradient band (60–100px) at y=960 plus a 2px accent scan line with soft glow. Draw it AFTER the face so it sits on top; full-screen scenes will cover it when they take over. Razor-sharp y=960 cuts are the #2 tell for AI-edited content (after background flatness).++## Audio-sync protocol (DO NOT skip)++**Problem:** if audio is edited (retakes/pauses removed), timestamps in the source transcript no longer match the edited video. Scene starts authored in original-time will fire late.++**The rule:** ALL timing lives in edited-time. Never mix.++**Verification procedure for any short-form retime:**++1. Measure both audio files:+ ```bash+ ffprobe -v error -show_entries format=duration -of csv=p=0 assets/original.mp4+ ffprobe -v error -show_entries format=duration -of csv=p=0 assets/<name>-edit.mp4+ ```+ Difference = total cut time.+2. If using a `shift()` function in `captions.html` to map transcript words, treat that as the source of truth. The map `shift(originalTime) = editedTime` applies to EVERY scene `data-start` too.+3. Scene internal offsets (inside `compositions/sceneN.html`) are LOCAL relative to the scene's `data-start`. If a scene's parent `data-start` is correct in edited-time, internal offsets stay correct WITHOUT modification — UNLESS a scene straddles a cut, in which case both the parent duration AND internal offsets shift.+4. Face-mode transition array times MUST use edited-time. They are NOT automatically shifted.++**Plan format for retimes** (use this table structure every time):++| Scene | Current start | Current dur | New start | New dur | Rationale |+|-------|---------------|-------------|-----------|---------|-----------|+| ... | ... | ... | ... | ... | ... |++Then the face-mode array, then any internal-offset changes, then frame-verification list.++## Scene authoring++One scene = one sub-composition file. Scenes sit on the same `data-track-index` back-to-back (no gaps). Inside each scene:++- `data-duration` matches the parent's slot exactly+- All GSAP anchors are LOCAL (0-based from scene start)+- Use `tl.set({}, {}, <data-duration>)` to pad the timeline so GSAP `tl.duration()` matches `data-duration`++### Scene pacing rules (from the 10 principles)++- **No dead frames.** Every 100ms has ≥1 animating element. Offset first entrance 0.1–0.3s, not t=0.+- **Payoff ≥ 1s hold.** The "big reveal" of the scene (stamp, number lock, punchline) must have ≥1s on screen, ideally 1.5s. Budget scenes by reveal time, not total time.+- **Motion through full duration.** If entrance anims all land by local 2s on a 4s scene, add secondary motion: underline sweeps, checkmark pops, ambient drift on cards, small oscillating glows on pills. Dead pacing = swipe-away.+- **Vary eases.** At least 3 different eases per scene across entrances.+- **One jaw-dropper per 5s of runtime.** Typography slam, glitch/chromatic reveal, whip-pan, audio-sync slam. Without these, the video reads as "labeled talking head" — correct but forgettable.++## Captions (karaoke style)++- Montserrat 900, 46–58px (for 1080 width), 100% white base+- Active word: scale-1.08 pop + color change to accent (`#37bdf8` for AIS, adapt to brand)+- Stroke via layered `text-shadow`, NEVER `-webkit-text-stroke` (renders inconsistently in Chromium render)+- Drop the rgba background pill — let the stroke hold readability. Captions should feel like graffiti on the frame, not a subtitle track.+- For retimes, use a `shift()` function inside `captions.html` to map transcript word timestamps → edited-time. This keeps the transcript JSON untouched and makes retimes mechanical.++See `references/captions.md` under `/hyperframes` for the full karaoke implementation. TL;DR: per-word `<span>` elements with `data-word-start`, GSAP tweens scoped to each span, tight 0.08–0.12s pop durations.++## Ambient background (never ship flat navy)++Minimum viable background stack:++1. **Radial gradient base** (center lighter than edges by 15–20%)+2. **Animated noise/grain overlay** at 8–12% opacity+3. **4–8 drifting particle dots** or grid traces+4. **Subtle vignette**++`background: #07121c` alone is a placeholder, not a design. For techy/control-room aesthetic, use the 6-layer stack from `feedback_techy_background_layers.md` (HUD grid masked to vignette + circuit traces + pulse nodes + scan beam + telemetry ticker + corner mono labels).++## Audio reactivity++- Headlines pulse 3–6% on beat. Backgrounds can go 10–30% on bass.+- Text reactivity kept subtle (3–6%) so captions stay readable; backgrounds can push harder.+- Use a SEEDED offline analyser (pre-compute the audio feature track) so renders are deterministic. Do NOT use `AnalyserNode` in the render path — `Math.random()` and real-time audio nodes break determinism.++## Transitions++- **Rotate flavors.** No two consecutive transitions the same type. Six hard cuts in a row is the #1 tell for AI editing.+- Face-mode transitions (`BOTTOM ↔ FULLSCREEN`) double as scene transitions when the mode changes between scenes.+- For pure overlay scene-to-scene, install from registry: `push-up`, `flash-through-white`, `sdf-iris`, or the full shader-transitions pack. `npx hyperframes catalog --type block` to browse.++## The verification gate (mandatory — DO NOT ship without)++Lint passing ≠ design working. Never report a short-form render done until you have extracted frames at word-exact timestamps and READ every PNG.++### Step 1 — draft render++```bash+cd video-projects/<slug>+npx hyperframes lint+npx hyperframes render --quality draft --output renders/<slug>-vN-draft.mp4+```++### Step 2 — word-exact frame extraction++Pick 8–15 timestamps that each correspond to a SPOKEN WORD where a specific visual should be on-screen. Not round numbers. Not mid-scene. The exact word.++```bash+mkdir -p renders/frames-vN+for pair in "<t>:<label>" "<t>:<label>" ...; do+ t="${pair%%:*}"; label="${pair##*:}"+ ffmpeg -y -ss "$t" -i renders/<slug>-vN-draft.mp4 \+ -frames:v 1 -q:v 2 "renders/frames-vN/t${t}-${label}.png"+done+```++### Step 3 — Read every PNG++Call `Read` on every PNG so the image loads into context. Do NOT just list filenames. For each frame confirm:++- The expected visual is on-screen at the expected moment (not 1s late, not early)+- Speaker's face is not cropped in any bottom-half scene+- Full-screen vs bottom-half face mode is correct for that scene+- Captions are on-brand, readable, not overflowing+- No blank frames, no unintentional overlap, no text-off-canvas++### Step 4 — if anything fails, fix + re-verify. Never ship broken.++### Step 5 — final render++```bash+npx hyperframes render --quality standard --output renders/<slug>-vN.mp4+```++Spot-check 3–4 frames from the final render (same timestamps, different folder `frames-vN-final/`) to confirm the standard-quality encode didn't change anything.++## The 10 rules (quality checklist — run BEFORE first draft)++Every short-form build. Run this list during authoring, not after.++1. **No dead frames.** Every 100ms has an animating element.+2. **Scene payoff ≥ 1s hold.** Budget by reveal time, not total time.+3. **Face is a character.** Grade + Ken Burns + side vignette.+4. **No hard seams.** Feather y=960 with gradient + scan line.+5. **One jaw-dropper per 5s.** Typography slam, glitch, whip-pan, audio slam.+6. **Audio reactivity non-negotiable.** 3–6% text, 10–30% background.+7. **Rotate transition flavors.** No two consecutive the same.+8. **Captions pop, don't politely label.** Stroke not pill. Scale + color on active word.+9. **Motion through full scene duration.** Secondary motion if entrances land early.+10. **Background is a layer, not a color.** Radial + noise + particles + vignette minimum.+11. **Slam/stamp overlays land AFTER target text is fully visible.** Reveal logic > word-sync. Stamp `t` ≥ target-visible `t` + 0.10–0.25s. Otherwise the punchline lands before the setup.++## Project structure (every short-form project)++```+video-projects/<slug>/+├── hyperframes.json+├── meta.json (id, name, dimensions 1080x1920, fps 30)+├── index.html (root composition, the 4-layer scaffold)+├── compositions/+│ ├── ambient-bg.html+│ ├── seam-treatment.html+│ ├── captions.html (with shift() function if retiming)+│ ├── scene1-<label>.html+│ ├── scene2-<label>.html+│ └── ...+├── assets/+│ ├── <name>.mp4 (original recording)+│ ├── <name>-edit.mp4 (edited — cuts removed — this is what the comp uses)+│ ├── transcript.json (whisper output)+│ └── brand assets (logo, brand-tokens.css, background music)+└── renders/+ ├── <slug>-v1-draft.mp4+ ├── frames-v1/+ ├── <slug>-v1.mp4+ └── ...+```++## Retime protocol (when audio is re-edited or timestamps drift)++1. Measure old and new edited audio durations with `ffprobe`. Delta = total cut time.+2. Identify cut window(s): which seconds were removed, from where.+3. Write the Plan table: every scene `data-start`, `data-duration`, every face-mode transition `t`, any scene whose internal offsets straddle a cut.+4. For each scene that straddles a cut, both its parent duration AND its internal offsets change. Scenes entirely on one side of the cut just need parent `data-start` shifted.+5. Lint → draft render → word-exact frame verify → final render. No shortcuts.++## What NOT to do in short-form++- Don't animate `<video>` element dimensions — freezes frames. Animate wrapper div.+- Don't use `repeat: -1` on any timeline — breaks the capture engine. Finite counts only.+- Don't use `Math.random()` or `Date.now()` — breaks determinism. Seeded PRNG if pseudo-random needed.+- Don't use `<br>` inside captions — natural wrapping + `<br>` produces extra unwanted breaks.+- Don't skip the frame verification gate. Lint exit code is not visual truth.+- Don't author in original-time if the audio is edited. Edited-time or nothing.+- Don't leave `background: #07121c` flat. Layer it.+- Don't hard-cut between scenes. Rotate transition flavors.+- Don't polite-caption. Pop them.+- Don't let the face sit still. Grade + Ken Burns always.++## Lessons from may-shorts-18 (v1 → v2)++Distilled from the 4 concrete problems the v1 render had and what fixed them in v2. Apply these on every new short.++### 1. Slam/stamp timing — reveal logic beats word-sync++A SLAM/STAMP overlay (KILLED, DEAD, STOP, etc.) lands AFTER its target text is fully visible, **not** during the spoken word. In may-shorts-18 v1 scene 1, CLAUDE and CHATGPT were pitched as opponents — KILLED fired at local 0.46s while CHATGPT didn't appear until 0.66s, so viewers saw "Claude … KILLED" with no visible target. The joke collapsed.++**Rule:** `stamp_t ≥ target-text-visible_t + 0.10–0.25s`. The "visible" timestamp is the END of the target's entrance animation, not its start. Word-sync is a guideline; visual reveal order is the constraint.++### 2. BOTTOM face-mode scale — don't ship the default++Default `BOTTOM = { x: 0, y: 1136, scale: 0.5625 }` (exact horizontal fit for a 1920×1080 source) leaves empty studio background flanking the speaker if they occupy <70% of the source frame. This is the default in may-shorts-19 and was copied into may-shorts-18 v1 — both videos had visible dead space left and right of the speaker in every BOTTOM scene.++**Rule:** prefer `BOTTOM = { x: -180, y: 1110, scale: 0.75 }` — crops 180px each side, bottom-anchors to y=1920. Preview ONE frame of BOTTOM mode against the actual source video before committing the constant. If the source speaker is tight-framed already, scale 0.65 may be enough; if the source is wide studio framing, push to scale 0.80 and re-tune x.++Always keep HIDDEN's `x`, `y`, `scale` identical to BOTTOM — they only differ in `opacity` — so the opacity-fade scenes don't drift geometrically mid-fade.++### 3. Face-mode transitions — three things at once, not one++When the face changes mode between adjacent scenes, a bare 0.15s pre-roll + 0.32s duration `expo.inOut` on just the face wrapper reads as rigid — the outgoing scene's panels are still fully opaque behind the morphing face, so the eye sees two things fighting instead of a crossfade.++**Rule:** for any "hero" scene-to-scene face-mode change (especially BOTTOM ↔ FULLSCREEN), do all three:+1. Extend that specific transition's duration to 0.45–0.55s (not the default 0.32s)+2. Start it 0.25–0.30s before the new scene's `data-start` (not the default 0.15s)+3. Fade + blur the outgoing scene's panel wrapper to `opacity: 0, filter: blur(6px)` over 0.20–0.25s, starting 0.25s before scene end++Implementation-wise, promote the face-mode transition array to per-entry `dur` so one transition can be longer than the others:+```js+[ { t: 2.06, mode: FULLSCREEN, dur: 0.50 }, { t: 3.71, mode: HIDDEN, dur: 0.32 }, ... ]+ .forEach(({ t, mode, dur }) => mainTl.to("#face-wrapper", { ...mode, duration: dur, ease: "expo.inOut" }, t));+```++Three simultaneous changes = "a real editor edited this." Any one alone = rigid.++### 4. Data-feel scenes beat decoration scenes mid-video++For scenes 3–5 of a 15–20s short (the "middle grind" where attention drops the hardest), lean on visuals that read as information — bar races, stat grids with counting numbers, heatmaps, sparklines, flowcharts, dashboard chrome with telemetry ticking, pain-point grids that flash red in sequence. may-shorts-18 v1 scene 4 was a radar-rings + terminal-chip + sparks combo — functional but decorative, and Nate called it "bland." v2 replaced it with a 3×3 pain-point grid lighting up red-orange in sequence + a sparkline stroke-drawing with a YOU-ARE-HERE marker + the payoff slam — same time budget, much higher engagement.++**Rule:** pure typography-plus-icon scenes feel like slides. Data-feel scenes feel like evidence. When a middle scene feels bland, replace the decoration with something that reads as *information*: a small number ticking up, a bar filling, a chart stroking in, a grid flashing in sequence.++## Reference compositions++- `video-projects/may-shorts-19/` — the canonical short-form example (18.84s, 1080x1920, 7 scenes, face-mode choreography, karaoke captions with shift(), ambient bg + seam treatment). Read `index.html` and any `compositions/scene*.html` before authoring a new short.+- `video-projects/may-shorts-18/` — secondary reference with the 4 lessons above baked in: BOTTOM scale=0.75, KILLED stamp timed after CHATGPT reveal, scene-1→2 fluid fade, scene 4 data-dashboard "THE PATTERN" grid.++## Related skills (invoke in addition)++- `/hyperframes` — framework rules (always first)+- `/hyperframes-cli` — CLI commands (init, lint, preview, render)+- `/gsap` — animation library reference+- `/hyperframes-registry` — installing transition blocks+- `/seedance-loop-prompt` — if the short needs an AI-generated looping background video++## Memory pointers (relevant feedback entries)++- `feedback_short_form_principles.md` — the 10 rules, full rationale+- `feedback_contrast_technique.md` — glow localization + text-shadow halos + brightening dim text+- `feedback_techy_background_layers.md` — 6-layer control-room background stack+- `feedback_visual_verification.md` — the verification gate+- `project_ais_brand_specs.md` — if the short is AIS-branded (hex codes, fonts, logo glow)diff --cc .env.exampleindex 552bbf7,fc282be..6f5cced--- a/.env.example+++ b/.env.example@@@ -1,8 -1,4 +1,10 @@@- # Copy this file to `.env` and fill in your own keys.- # `.env` is gitignored — never commit it.+ # Optional: only needed to transcribe your own footage with ElevenLabs Scribe.+ # Get a key with speech_to_text access at https://elevenlabs.io/app/settings/api-keys+ # Copy this file to .env locally. Never commit your key.+ ELEVENLABS_API_KEY=+- # ClickUp API key — only needed if a project integrates with ClickUp++# Optional integrations used by the older examples.+CLICKUP_API_KEY=-- # OpenAI API key — only needed if a project uses OpenAI for text/image generation+OPENAI_API_KEY=++# Optional generated footage; configure only when using this provider.++KIE_API_KEY=diff --cc .gitignoreindex 428aac7,3cf26be..f716715--- a/.gitignore+++ b/.gitignore@@@ -19,16 -2,34 +2,38 @@@.env.env.*!.env.example- .claude/settings.local.json- .claude/scheduled_tasks.lock-- # Local-only media stash (large raw recordings, source music)+ *.env+ *.pem+ *.key+ node_modules/raw-media/+ video-projects/+ renders/+ **/renders/+ **/assets/+ tmp/+ archives/+ *.mp4+ *.mov+ *.mkv+ *.webm+ *.wav+ *.mp3+ *.m4a+ *.aac+ *.flac+ *.zip+ *.log+ __pycache__/+ *.pyc+ .DS_Store+ Thumbs.db+ .vscode/+ .claude/settings.local.json+ .codex/auth.json+ .codex/sessions/+ .codex/history.jsonl+- # Playwright browser profiles- .playwright-profile/-- # Frame-extraction scratch- **/renders/frames/- **/renders/frames-*/-++# Deliberately public synthetic timing data, without media.++!examples/short-form/assets/++!examples/short-form/assets/*.jsondiff --cc AGENTS.mdindex 506ecf3,af945b7..6c162ae--- a/AGENTS.md+++ b/AGENTS.md@@@ -1,58 -1,91 +1,99 @@@- # HyperFrames Composition Project-- ## Skills-- This project uses AI agent skills for framework-specific patterns. Install them if not already present:-- ```bash- npx skills add heygen-com/hyperframes- ```-- Skills encode patterns like `window.__timelines` registration, `data-*` attribute semantics, and shader-compatible CSS rules that are not in generic web docs. Using them produces correct compositions from the start.-- ## Commands-- ```bash- npx hyperframes preview # preview in browser (studio editor)- npx hyperframes render # render to MP4- npx hyperframes lint # validate compositions (errors + warnings)- npx hyperframes lint --json # machine-readable output for CI- npx hyperframes docs <topic> # reference docs in terminal- ```-- ## Project Structure-- - `index.html` — main composition (root timeline)- - `compositions/` — sub-compositions referenced via `data-composition-src`- - `assets/` — media files (video, audio, images)- - `meta.json` — project metadata (id, name)- - `transcript.json` — whisper word-level transcript (if generated)-- ## Linting — Always Run After Changes-- After creating or editing any `.html` composition, run the linter before considering the task complete:-- ```bash- npx hyperframes lint- ```-- Fix all errors before presenting the result.-- ## Key Rules-- 1. Every timed element needs `data-start`, `data-duration`, and `data-track-index`- 2. Visible timed elements **must** have `class="clip"` — the framework uses this for visibility control- 3. GSAP timelines must be paused and registered on `window.__timelines`:- ```js- window.__timelines = window.__timelines || {};- window.__timelines["composition-id"] = gsap.timeline({ paused: true });- ```- 4. Videos use `muted` with a separate `<audio>` element for the audio track- 5. Sub-compositions use `data-composition-src="compositions/file.html"`- 6. Only deterministic logic — no `Date.now()`, no `Math.random()`, no network fetches-- ## Documentation-- Full docs: https://hyperframes.heygen.com/introduction-- Machine-readable index for AI tools: https://hyperframes.heygen.com/llms.txt-# HyperFrames Video Pipeline: workspace guide++# HyperFrames Student Kit: workspace guide++ Turn a talking-head recording into an intentional edit using local HyperFrames+ rendering, transcript-driven cuts, and reusable motion graphics.++ ## Runtime routing++ `AGENTS.md` and `CLAUDE.md` contain the same standing guide. Keep them synchronized.+ Claude Code uses `.claude/skills/`. Codex uses the generated `.agents/skills/`.+ Edit canonical skills in `.claude/skills/`, then run `npm run sync:skills`.+ Use `$edit-video` in Codex, `/edit-video` in Claude Code, or natural language.+ Model and permission choices belong to the user; `.codex/config.toml` only adds+ document loading defaults. Work locally unless the user requests subagents.++ ## Start and route++ Read `README.md` for installation and `docs/WORKFLOW.md` for a complete edit.+ Use `edit-video` to coordinate transcription, cuts, design, and verification.+ For one stage, load the matching local skill:++ | Need | Skill |+ | --- | --- |++| Reels, Shorts, and short advertisements | `short-form-edit` |++| Existing May Shorts example maintenance | `short-form-video` |++| New motion-graphics video from a brief | `make-a-video` |++| Website-inspired compositions | `website-to-hyperframes` |+ | Full raw-video edit | `edit-video` |+ | Silence removal | `cut-silences` |+ | Retakes, false starts, or stutters | `cut-mistakes` |+ | Narrative arc, persistent world, and visual callbacks | `video-storytelling` |+ | Overlay beats, paper takeovers, and glass cards | `hyperframes-video-beats` |+ | Select or extend styles and templates | `style-library` |+ | HTML compositions and media timing | `hyperframes` |+ | Preview, lint, and rendering | `hyperframes-cli` |+ | Timeline animation | `gsap` |+ | Install HyperFrames catalog blocks | `hyperframes-registry` |++ Before a creative session read `MOTION_PHILOSOPHY.md` and the project's DESIGN.md.+ The philosophy's fast sizzle pacing is a style reference. Give educational speech+ room to breathe. The project brief controls pacing, palette, and typography.+ Framework skill contracts override historical code recipes in the style guide.++ ## Workspace++ Create a project with `npm run new-video -- my-video`. Keep source media, EDLs,+ transcripts, compositions, and renders together under `video-projects/<slug>/`.+ Run HyperFrames from that project's directory. The root `scripts/` utilities+ accept paths from the working directory. `style-library/registry.json` indexes+ cards; each style has a DESIGN.md, CSS tokens, and named text slots.+ See `style-templates/README.md` for whole-scene templates.++ Preserve raw files. Use a new output filename for each editing stage. Archive+ obsolete work. Video projects, personal footage, transcripts, credentials, and-renders are gitignored. A public kit contains reusable resources and synthetic-fixtures only. Never print secrets or copy private media into library examples.++renders are gitignored. The 12 already-published projects are retained as teaching examples; new private++projects stay ignored. Do not treat existing public examples as permission to add++new personal footage. Never print secrets or copy private media into library examples.++ ## Editing and timing++ Use ElevenLabs Scribe for transcription via `scripts/transcribe-elevenlabs.mjs`;+ reuse existing word timestamps whenever possible. Audio is uploaded to ElevenLabs+ and consumes the user's credits. Use their own locally configured credentials.+ The synthetic demo requires no API key. Avoid implicit Whisper transcription.++ Cut silences first; use its edited video AND retimed transcript for cut-mistakes.+ Review each mistake in context. Intentional repetition is not a mistake. Record+ the reviewed decisions before applying them. If no cuts are needed, preserve the+ input or use an empty cuts list. Never mix original timestamps with edited footage.++ Load the relevant skills before changing HTML. Root compositions use a visible+ div with id, data-composition-id, data-start, duration, width, and height. Timed+ elements carry data-start, data-duration, and data-track-index; same-track clips+ must not overlap. Visible timed divs use class="clip"; videos do not.+ Mute videos and use sibling audio for the mix. Animate a non-timed video wrapper.+ Register one synchronous paused GSAP timeline per composition in window.__timelines+ using its exact composition ID. Keep finite timelines and explicit durations.+ HyperFrames owns media playback. Use deterministic animation and local assets.++ ## Verification and approvals++ Run `node scripts/preflight.mjs <project>` and HyperFrames lint. For anchored+ sub-compositions, run `node scripts/validate-beat-sync.mjs <project>`; each beat+ needs data-anchor with an exact transcript phrase. Enter between 0.2 seconds after+ and 1.8 seconds before that word. Inline timelines require manual timing review.++ Review Studio before draft rendering. Review the encoded draft, extract and+ inspect hero frames and transition boundaries, and listen to the audio joins.+ Check cropped faces, overflow, black flashes, readable labels, clipping, and A/V+ sync. Resolve problems before the final render. Save evidence in VERIFY.md.+ Use a Range-capable preview server for MP4 scrubbing (for example `npx serve`).++ Honor approvals already provided. When review approval is missing, prepare the+ concrete preview or cut proposal first. Never claim a lint result proves visual+ quality. Only publish or upload a finished video when the user authorizes it.+ Automated browser checks must be headless, with Pointer Lock and cursor capture+ disabled; synthetic input must remain inside the virtual browser.++++For short-form edits, read `docs/SHORT-FORM.md` and use the plan and footage++validators. Structural checks supplement rendered video and audio review.diff --cc CLAUDE.mdindex db379cd,af945b7..6c162ae--- a/CLAUDE.md+++ b/CLAUDE.md@@@ -1,258 -1,91 +1,99 @@@- # Hyperframes Editor — Workspace Guide-- HTML-native video workspace built on [Hyperframes](https://hyperframes.heygen.com). Scaffolded 2026-04-17 from the `product-promo` example. Not a Remotion project — this is the other pipeline.-- **This workspace hosts multiple video projects, one folder each, all under `video-projects/`.** The workspace root holds shared tooling (`node_modules/`, `package.json`, `.claude/`, this `CLAUDE.md`, `DESIGN.ais-example.md`, `MOTION_PHILOSOPHY.md`) — never put `index.html`, `assets/`, `compositions/`, or `renders/` directly at the root. Always work from inside a project subfolder.-- ## MOTION_PHILOSOPHY.md — READ BEFORE BRAINSTORMING-- **`MOTION_PHILOSOPHY.md` (at the workspace root) is the canonical motion-graphics aesthetic for this workspace.** It is the deconstructed playbook of the Infinite Global Payments 30s spot — the gold standard Nate has chosen for every motion build going forward.-- **You MUST read it before:**- - Brainstorming a new composition, scene, or storyboard- - Proposing a visual direction, palette, or pacing- - Picking transitions, animations, or registry blocks- - Designing any kinetic typography, logo reveal, or product showcase-- **How to use it:**- 1. **Always read the full file** at the start of any creative session — `Read MOTION_PHILOSOPHY.md` from the workspace root. Don't skim, don't quote from memory. The doc evolves.- 2. **Re-read sections 0 (10 Laws) and 4 (pre-flight checklist)** every time, even on quick iterations. They are the discipline.- 3. **Apply the defaults**: ~1.5s avg scene length, black canvas + perspective grid + crosshairs + vignette + grain on every scene, chrome-gradient text with halo glow, motion-blurred whip transitions (never hard cuts), ≤5 symbolic colors, hold the outro 4–6s, rule of threes.- 4. **Use the recipes**: section 3 has copy-pasteable HyperFrames patterns (composition shell, kinetic-type opener, whip-streak, color-recolor trick, registry block mappings).- 5. **Run the pre-flight checklist** before claiming any motion piece is done. The "What Would Infinite Do?" 10-question test in section 5 is a good gut check before showing Nate.-- **When NOT to apply it:**- - If a brand brief explicitly demands a different aesthetic (e.g., AIS Shorts use bright/playful Roboto Mono + Montserrat with the AIS palette — see `DESIGN.ais-example.md`). In those cases, keep the *discipline* (one idea per beat, motion in transitions, breathing outros, callbacks) but adapt the *palette and texture* to the brand.-- If `MOTION_PHILOSOPHY.md` is missing from the workspace root, stop and ask Nate before brainstorming — it should always be there.-- ## Skills — USE THESE FIRST-- **Always invoke the matching skill before writing or modifying compositions.** Skills encode framework-specific patterns (`window.__timelines` registration, `data-*` attribute semantics, shader-compatible CSS, relative-timing syntax) that are NOT in generic web docs. Skipping them produces broken compositions.-- | Skill | Command | When to use |- | ------------------------ | -------------------------- | ----------------------------------------------------------------------------------------- |- | `hyperframes` | `/hyperframes` | Authoring/editing compositions, captions, TTS, audio-reactive animation, transitions |- | `hyperframes-cli` | `/hyperframes-cli` | CLI commands: `init`, `add`, `lint`, `preview`, `render`, `transcribe`, `tts`, `doctor` |- | `gsap` | `/gsap` | GSAP animation — timelines, easing, stagger, ScrollTrigger, plugins, performance |- | `hyperframes-registry` | `/hyperframes-registry` | Installing catalog blocks/components via `npx hyperframes add <name>` |- | `website-to-hyperframes` | `/website-to-hyperframes` | Turning a URL into a composition (7-step capture-to-video pipeline) |-- Not present? `npx skills add heygen-com/hyperframes --yes` then reopen this directory.-- ## Commands-- ```bash- # Authoring loop- npx hyperframes preview # Studio opens in browser with hot reload (port 3002)- npx hyperframes lint # static HTML check — always run before rendering- npx hyperframes compositions # list comp IDs + resolved durations- npx hyperframes render --quality draft --output renders/draft.mp4 # fast iteration render- npx hyperframes render --quality standard --output renders/final.mp4 # visually lossless 1080p-- # Catalog & install- npx hyperframes catalog --type block # browse 38 blocks- npx hyperframes catalog --type component # browse 3 components- npx hyperframes add <name> # install a catalog item into compositions/-- # Media pipeline (baked into CLI — no Whisper CLI needed)- npx hyperframes transcribe <file> --model small.en --json # word-level timestamps- npx hyperframes tts "text" --voice am_adam --output narration.wav # on-device Kokoro-82M-- # Diagnostics- npx hyperframes doctor # env check (Node, FFmpeg, Chrome, Docker)- npx hyperframes info --json # project stats- npx hyperframes benchmark # find optimal workers/quality- npx hyperframes docs <topic> # inline docs: data-attributes, gsap, rendering, examples, troubleshooting, compositions- ```-- ### Render flags worth knowing-- - `--quality draft|standard|high` — CRF 28 / 18 / 15 (standard is visually lossless at 1080p)- - `--fps 24|30|60` (default 30)- - `--format mp4|mov|webm` — `mov` = ProRes 4444 with alpha, `webm` = VP9 alpha (Chromium only)- - `--workers <n>` / `--gpu` / `--docker` / `--crf <n>` / `--video-bitrate 10M`- - `--max-concurrent-renders <n>` — when running the producer server-- ## Workspace Layout-- ```- Hyperframes Editor/- ├── CLAUDE.md, AGENTS.md, DESIGN.ais-example.md ← workspace docs- ├── MOTION_PHILOSOPHY.md ← gold-standard motion-graphics aesthetic (READ before brainstorming)- ├── package.json, node_modules/ ← workspace tooling- ├── .claude/ ← skills + plugin config- ├── assets/ ← shared assets (AIS brand, music)- └── video-projects/ ← one folder per video- ├── aisoc-hype/- ├── aisoc-lesson-5-1/- ├── may-shorts-19/- └── clickup-demo/- ```-- Each project under `video-projects/<name>/` is a self-contained Hyperframes project:-- - `index.html` — root composition entry point- - `compositions/` — sub-compositions loaded via `data-composition-src`- - `compositions/components/` — shared snippets installed by `npx hyperframes add <component>`- - `assets/` — media files for this project (videos, audio, images, SVG, transcripts). Brand assets that multiple projects need (AIS logo, brand-tokens.css) are duplicated per-project, not symlinked — keeps each project portable.- - `renders/` — render outputs for this project (gitignored)- - `hyperframes.json` — CLI config (registry URL, paths — all relative to the project folder)- - `meta.json` — project metadata (id, name, dimensions, fps)- - (optional) `STORYBOARD.md`, `scripts/`, etc. — anything project-specific-- ### Always run the CLI from inside the project folder-- ```bash- cd video-projects/may-shorts-19- npx hyperframes lint- npx hyperframes preview- npx hyperframes render --quality standard --output renders/final.mp4- ```-- The CLI reads `hyperframes.json`/`meta.json` from the current directory and resolves `assets/`, `compositions/`, `renders/` relative to it. Running it from the workspace root will fail or scan the wrong files.-- ### Adding a new video project-- 1. `mkdir video-projects/<new-project-slug>` (kebab-case, e.g. `q3-launch-promo`)- 2. `cd video-projects/<new-project-slug>`- 3. Either `npx hyperframes init` to scaffold, or copy the structure from a sibling project (`cp -r ../may-shorts-19/{hyperframes.json,meta.json} .` then edit `meta.json` for the new id/name/dimensions, and create empty `index.html`, `compositions/`, `assets/`, `renders/`)- 4. Pull in any shared brand assets the project needs (e.g. `cp ../../assets/brand-tokens.css ../../assets/AIS\ Logo\ PNG.png assets/`)- 5. Build the composition; lint + render from inside this folder-- ### What lives at the workspace root-- - **Motion-graphics philosophy:** `MOTION_PHILOSOPHY.md` (gold-standard aesthetic, deconstructed Infinite Payments spot — read before brainstorming any composition)- - Shared brand source-of-truth: `DESIGN.ais-example.md` (AIS brand spec — kept as a worked example; students should write their own `DESIGN.md` for their brand), root `assets/` (AIS Logo PNG, brand-tokens.css, AIS Background.png) — copy into a project's `assets/` when needed- - Shared raw-recording stash: large source MP4s/MP3s that aren't yet assigned to a project (e.g. raw lesson recordings, license-free music) can sit at root until they're moved into a project's `assets/`- - Tooling: `node_modules/`, `package.json`, `.claude/`, `.gitignore`, `skills-lock.json`-- ## Render Contract (the must-dos and must-not-dos)-- 1. Root `<div>` needs `id`, `data-composition-id`, `data-start="0"`, `data-width`, `data-height`.- 2. Timed visible elements need `class="clip"` — **except** `<video>` and `<audio>` (adding `class="clip"` to `<video>` breaks it).- 3. Every timed element needs `data-start`, `data-duration`, `data-track-index`.- 4. `data-start` can reference another clip's id: `data-start="intro"`, `data-start="intro + 2"`, `data-start="intro - 0.5"`. Same-track clips cannot overlap — use different `data-track-index` values.- 5. `<video>` must be `muted`; audio belongs in sibling `<audio>` elements for the mixer. `data-has-audio="true"` only when the video's own audio should feed the mix.- 6. Every composition registers exactly one GSAP timeline, paused, on `window.__timelines["<data-composition-id>"]`. Key must match `data-composition-id` exactly.- 7. Composition duration = `tl.duration()`. If the timeline is shorter than the video, the video truncates. Pad with `tl.set({}, {}, <seconds>)` to extend.- 8. Never call `.play()`, `.pause()`, or set `.currentTime` on media. The framework owns playback.- 9. Never animate `width`/`height`/`top`/`left` directly on a `<video>` — the browser freezes frames. Wrap in a `<div>` and animate the wrapper.- 10. Sub-compositions use `<template>` + `data-composition-src`. Their timelines auto-link to the parent — never do `masterTL.add(child)`.- 11. Determinism: no `Date.now()`, no unseeded `Math.random()`, no render-time network fetches. Use seeded PRNGs.-- ## Authoring Loop-- 1. **Read `MOTION_PHILOSOPHY.md`** if you haven't this session — it sets the aesthetic baseline (1–2s scenes, chrome type, motion-blur transitions, etc.).- 2. Pick the skill → invoke `/hyperframes` (or sibling) before editing.- 3. Edit HTML in `index.html` or `compositions/<name>.html`.- 4. `npx hyperframes lint` — fix errors, triage warnings.- 5. **Localhost Studio preview** — before **any** render (even a draft), start `npx hyperframes preview` in the background and hand Nate the URL. He eyeballs the edit live and iterates; no render cycle until he's seen it. See "Localhost Preview Before Any Render" below.- 6. Only after Nate says the live preview looks right: `render --quality draft` for a draft MP4.- 7. **Visual verification** (REQUIRED before handoff) — see "Visual Verification" below.- 8. **Run the `MOTION_PHILOSOPHY.md` pre-flight checklist** (section 4) before claiming done.- 9. Second localhost preview pass on the draft MP4 (via static server on port 8080 for scrubbable playback) — wait for explicit sign-off before the final render.- 10. Final: `render --quality standard` (or `high --docker` for archival deterministic output).-- ## Visual Verification (MANDATORY before delivery)-- Lint passing ≠ design working. Never tell Nate a render is done until you have actually looked at the frames. No exceptions. A "successful" render with a cropped face, misaligned text, or a scene landing on the wrong word is a broken render — and lint exit codes will not catch any of that. Nate has explicitly asked for this gate — treat skipping it as a regression.-- **Required checks before delivery:**-- 1. Render a draft: `npx hyperframes render --quality draft --output renders/<name>-draft.mp4`- 2. Pull one frame per scene at its hero moment, plus frames at any mid-entrance or transition at risk. Cover the full timeline — don't cherry-pick.- ```bash- mkdir -p renders/frames- for t in <scene1-t> <scene2-t> ...; do- ffmpeg -y -ss $t -i renders/<name>-draft.mp4 -frames:v 1 -q:v 2 "renders/frames/t${t}.png"- done- ```- 3. Call `Read` on every PNG so the image actually loads into context. Do NOT just list filenames. Verify:- - Speaker's face is not cropped in any bottom-half scene- - Full-screen vs bottom-half face mode is correct for each scene- - Scene transitions land on the intended word- - Captions are on-brand (AIS: Montserrat, #37bdf8 accent, #f09025 hot) and readable- - No text overflow, no unintentional overlap, no blank frames- 4. If anything is wrong — fix, re-render, re-verify. Never ship a broken render and let Nate find the bug.- 5. Only then run the `standard` quality render and report the path.-- **Pre-render (live scrubbing):** Playwright 1.59.1 is installed. For quick contrast/layout checks on a single scene mid-authoring without paying a full render, run `npx hyperframes preview` (opens on localhost:3002) and drive Playwright to screenshot the live state at specific timestamps. Useful when iterating on one scene's visual balance before committing to a draft render.-- ## Localhost Preview Before Any Render (MANDATORY)-- **Every edit pass gets two preview gates**: one on the live Studio **before** any render (so Nate can iterate on cheap edits without waiting for a render), and one on the rendered MP4 **before** the final `--quality standard` bake. Do not run `render --quality draft` OR `render --quality standard` until Nate has eyeballed the relevant state in his browser.-- ### Gate 1 — Live Studio preview (before any render)-- After editing compositions and before any render command:-- 1. Start Studio in the background:- ```bash- cd video-projects/<project-slug>- npx hyperframes preview # run_in_background: true- ```- 2. Wait for "Studio running" on http://localhost:3002.- 3. Hand Nate the URL + tell him exactly which sub-compositions to scrub (individual comp URLs load fastest — the master composition can stall when it includes WebGL shader blocks under software WebGL fallback). Example: `http://localhost:3002/?comp=v01-kinetic-type`.- 4. Wait for Nate's explicit sign-off on the live preview ("looks good, render a draft" / "ship it" / "go ahead"). Silence is not approval.- 5. Hot reload means any further edit you make shows up live without a restart.-- ### Gate 2 — Rendered MP4 preview (before final)-- After frame-verification passes on a draft render:-- 6. Serve `renders/` via `npx serve . -p 8080 -n` (NOT Python's `http.server` — it doesn't support HTTP Range requests, so scrubbing breaks). Hand Nate `http://localhost:8080/<project>-draft.mp4`.- 7. Wait for explicit sign-off on the full motion + audio playback.- 8. Then run the final `--quality standard` render; report the output path.-- Why two gates: the live Studio catches layout/timing/visual bugs on edits you just made — before spending ~2 minutes per render iteration. The rendered-MP4 gate catches pacing, audio sync, and beat-to-beat feel that only reads correctly in real-time playback. Skipping either one turns render cycles into expensive guesses.-- **If the master composition stalls in Studio** (software WebGL + multiple shader blocks): route Nate to individual sub-composition URLs instead. They load instantly and isolate the change you're previewing.-- The render is the ground truth. "The code looks correct" doesn't clear the bar.-- ## Asset Prep-- Re-encode raw recordings to H.264 MP4 before referencing as `<video src>`:-- ```bash- ffmpeg -i raw.mov -c:v libx264 -preset medium -crf 20 -c:a aac -b:a 192k -movflags +faststart assets/clip.mp4- ```-- Keeps `assets/` light and avoids codec issues during capture. Use `npx hyperframes doctor` if a render fails partway.-- ## Prompting Shorthand (what the `/hyperframes` skill understands)-- - **Motion easing:** smooth / snappy / bouncy / springy / dramatic / dreamy- - **Caption energy:** hype / corporate / tutorial / storytelling / social- - **Transition energy:** calm (blur) / medium (push) / high (zoom, glitch)- - **Audio reactivity:** bass→scale, treble→glow, amplitude→opacity, mids→shape. Keep text reactivity at 3–6%; backgrounds can go 10–30%.-- Cold-start prompt shape: *"Using /hyperframes, create a 10-second product intro with a fade-in title over a dark background and subtle background music."* Warm-start: *"Summarize this PDF into a 45-second pitch video using /hyperframes."*-- ## Registry (available via `npx hyperframes add <name>`)-- - **Blocks (38):** data viz (`data-chart`, `flowchart`), outros (`logo-outro`), social overlays (`instagram-follow`, `tiktok-follow`, `yt-lower-third`, `x-post`, `reddit-post`, `spotify-card`, `macos-notification`), app/UI (`app-showcase`, `ui-3d-reveal`), shader transitions (`glitch`, `whip-pan`, `cinematic-zoom`, `flash-through-white`, `light-leak`, `ripple-waves`, `chromatic-radial-split`, `cross-warp-morph`, `domain-warp-dissolve`, `gravitational-lens`, `ridged-burn`, `sdf-iris`, `swirl-vortex`, `thermal-distortion`), CSS transition packs (`transitions-3d|blur|cover|destruction|dissolve|distortion|grid|light|mechanical|other|push|radial|scale`)- - **Components (3):** `grain-overlay`, `shimmer-sweep`, `grid-pixelate-wipe`- - Browse: `npx hyperframes catalog --type block --json`-- ## Documentation — fetch when the skills don't cover enough-- The `/hyperframes*` skills encode the common authoring patterns, but the hosted docs are the source of truth for **every block's props, every package's API, and deeper usage examples**. Reach for them when brainstorming scenes, picking a transition or component, or digging into a package you haven't used before. The catalog pages in particular hide a lot of gems — don't guess at a block's props, fetch the page.-- **Entry points:**-- - **Agent index (fetch first if unsure of a path):** https://hyperframes.heygen.com/llms.txt — the complete sitemap- - **Full site:** https://hyperframes.heygen.com/introduction- - **Inline terminal docs:** `npx hyperframes docs <topic>` — topics: `data-attributes`, `gsap`, `rendering`, `examples`, `troubleshooting`, `compositions`- - **Source repo:** https://github.com/heygen-com/hyperframes-- **Known URL patterns (hit directly with WebFetch):**-- - **Catalog — Blocks (38):** `https://hyperframes.heygen.com/catalog/blocks/<slug>` — e.g. `instagram-follow`, `flowchart`, `data-chart`, `cinematic-zoom`, `glitch`, `whip-pan`, `sdf-iris`, `light-leak`, `logo-outro`, `app-showcase`, `ui-3d-reveal`, `macos-notification`, plus all the transition packs (`transitions-3d`, `transitions-blur`, …). Full props + examples for each.- - **Catalog — Components (3):** `https://hyperframes.heygen.com/catalog/components/<slug>` — `grain-overlay`, `grid-pixelate-wipe`, `shimmer-sweep`- - **Packages:** `https://hyperframes.heygen.com/packages/<name>` — `cli`, `core`, `engine`, `player`, `producer`, `studio`. Use when scripting beyond HTML (e.g. batch rendering via producer, player runtime hooks).- - **Reference:** `https://hyperframes.heygen.com/reference/html-schema` — authoritative data-attribute + timeline-registration spec- - **Core concepts & guides:** listed in `llms.txt` — covers compositions, deterministic rendering, frame adapters, GSAP animation, prompt guide, website-to-video, troubleshooting, common mistakes. Fetch `llms.txt` to resolve exact paths.-- **When to reach for this:** brainstorming a new scene ("what block could sell this beat?"), looking up a block's exact props before wiring it into a composition, deep-diving into a package API, or debugging something the render contract doesn't explain.-# HyperFrames Video Pipeline: workspace guide++# HyperFrames Student Kit: workspace guide++ Turn a talking-head recording into an intentional edit using local HyperFrames+ rendering, transcript-driven cuts, and reusable motion graphics.++ ## Runtime routing++ `AGENTS.md` and `CLAUDE.md` contain the same standing guide. Keep them synchronized.+ Claude Code uses `.claude/skills/`. Codex uses the generated `.agents/skills/`.+ Edit canonical skills in `.claude/skills/`, then run `npm run sync:skills`.+ Use `$edit-video` in Codex, `/edit-video` in Claude Code, or natural language.+ Model and permission choices belong to the user; `.codex/config.toml` only adds+ document loading defaults. Work locally unless the user requests subagents.++ ## Start and route++ Read `README.md` for installation and `docs/WORKFLOW.md` for a complete edit.+ Use `edit-video` to coordinate transcription, cuts, design, and verification.+ For one stage, load the matching local skill:++ | Need | Skill |+ | --- | --- |++| Reels, Shorts, and short advertisements | `short-form-edit` |++| Existing May Shorts example maintenance | `short-form-video` |++| New motion-graphics video from a brief | `make-a-video` |++| Website-inspired compositions | `website-to-hyperframes` |+ | Full raw-video edit | `edit-video` |+ | Silence removal | `cut-silences` |+ | Retakes, false starts, or stutters | `cut-mistakes` |+ | Narrative arc, persistent world, and visual callbacks | `video-storytelling` |+ | Overlay beats, paper takeovers, and glass cards | `hyperframes-video-beats` |+ | Select or extend styles and templates | `style-library` |+ | HTML compositions and media timing | `hyperframes` |+ | Preview, lint, and rendering | `hyperframes-cli` |+ | Timeline animation | `gsap` |+ | Install HyperFrames catalog blocks | `hyperframes-registry` |++ Before a creative session read `MOTION_PHILOSOPHY.md` and the project's DESIGN.md.+ The philosophy's fast sizzle pacing is a style reference. Give educational speech+ room to breathe. The project brief controls pacing, palette, and typography.+ Framework skill contracts override historical code recipes in the style guide.++ ## Workspace++ Create a project with `npm run new-video -- my-video`. Keep source media, EDLs,+ transcripts, compositions, and renders together under `video-projects/<slug>/`.+ Run HyperFrames from that project's directory. The root `scripts/` utilities+ accept paths from the working directory. `style-library/registry.json` indexes+ cards; each style has a DESIGN.md, CSS tokens, and named text slots.+ See `style-templates/README.md` for whole-scene templates.++ Preserve raw files. Use a new output filename for each editing stage. Archive+ obsolete work. Video projects, personal footage, transcripts, credentials, and-renders are gitignored. A public kit contains reusable resources and synthetic-fixtures only. Never print secrets or copy private media into library examples.++renders are gitignored. The 12 already-published projects are retained as teaching examples; new private++projects stay ignored. Do not treat existing public examples as permission to add++new personal footage. Never print secrets or copy private media into library examples.++ ## Editing and timing++ Use ElevenLabs Scribe for transcription via `scripts/transcribe-elevenlabs.mjs`;+ reuse existing word timestamps whenever possible. Audio is uploaded to ElevenLabs+ and consumes the user's credits. Use their own locally configured credentials.+ The synthetic demo requires no API key. Avoid implicit Whisper transcription.++ Cut silences first; use its edited video AND retimed transcript for cut-mistakes.+ Review each mistake in context. Intentional repetition is not a mistake. Record+ the reviewed decisions before applying them. If no cuts are needed, preserve the+ input or use an empty cuts list. Never mix original timestamps with edited footage.++ Load the relevant skills before changing HTML. Root compositions use a visible+ div with id, data-composition-id, data-start, duration, width, and height. Timed+ elements carry data-start, data-duration, and data-track-index; same-track clips+ must not overlap. Visible timed divs use class="clip"; videos do not.+ Mute videos and use sibling audio for the mix. Animate a non-timed video wrapper.+ Register one synchronous paused GSAP timeline per composition in window.__timelines+ using its exact composition ID. Keep finite timelines and explicit durations.+ HyperFrames owns media playback. Use deterministic animation and local assets.++ ## Verification and approvals++ Run `node scripts/preflight.mjs <project>` and HyperFrames lint. For anchored+ sub-compositions, run `node scripts/validate-beat-sync.mjs <project>`; each beat+ needs data-anchor with an exact transcript phrase. Enter between 0.2 seconds after+ and 1.8 seconds before that word. Inline timelines require manual timing review.++ Review Studio before draft rendering. Review the encoded draft, extract and+ inspect hero frames and transition boundaries, and listen to the audio joins.+ Check cropped faces, overflow, black flashes, readable labels, clipping, and A/V+ sync. Resolve problems before the final render. Save evidence in VERIFY.md.+ Use a Range-capable preview server for MP4 scrubbing (for example `npx serve`).++ Honor approvals already provided. When review approval is missing, prepare the+ concrete preview or cut proposal first. Never claim a lint result proves visual+ quality. Only publish or upload a finished video when the user authorizes it.+ Automated browser checks must be headless, with Pointer Lock and cursor capture+ disabled; synthetic input must remain inside the virtual browser.++++For short-form edits, read `docs/SHORT-FORM.md` and use the plan and footage++validators. Structural checks supplement rendered video and audio review.diff --cc README.mdindex 3e38674,a1813e9..5fe6354--- a/README.md+++ b/README.md@@@ -1,218 -1,87 +1,112 @@@- # Hyperframes Editor — Student Edition-- A workbench for building motion-graphics video pipelines in **plain HTML + GSAP**, powered by [Hyperframes](https://hyperframes.heygen.com). Twelve finished video projects you can clone, scrub through, rip apart, and rebuild as your own.-- > This is **not** a Remotion / React / Next.js video stack. Every composition in this repo is a regular HTML file with a paused GSAP timeline attached to `window.__timelines`. The Hyperframes CLI handles lint, preview, and render.-- ----- ## Who this is for-- Students who want to learn how professional short-form and promo video gets built end-to-end — storyboard, brand system, motion graphics, audio sync, render pipeline — by reverse-engineering real projects. Every project here shipped (or almost shipped). Scrub the compositions, read the HANDOFF/STORYBOARD docs, play the `final.mp4`, then change things and see what breaks.-- ## Prerequisites-- - **Node 20+** — run `node --version` to check- - **FFmpeg** on your `PATH` — needed for audio extraction and re-encoding- - **Chrome (latest)** — Hyperframes renders through a headless Chromium- - **~5 GB free disk** — node_modules is chunky; renders are bigger- - **16 GB RAM recommended** for smooth Studio preview with multiple shader blocks-- Run `npx hyperframes doctor` after `npm install` — it reports what's missing.-- ## Quickstart-- ```bash- git clone <your-fork-url> hyperframes-editor- cd hyperframes-editor- npm install-- # Optional — only if you want to use the ClickUp / OpenAI integrations- cp .env.example .env- # ...then edit .env with your own keys-- # Open Studio on one of the included projects- cd video-projects/may-shorts-19- npx hyperframes preview # http://localhost:3002-# HyperFrames Video Pipeline++# HyperFrames Student Kit++ ++ Nate Herk's reusable video-editing kit for **Codex and Claude Code**.+ Bring your own footage. Cut dead air, review mistakes, plan the story, and build+ motion graphics with HyperFrames and GSAP.+-- **10 complete skills**, mirrored for both assistants, with their helper scripts and references.++- **14 skills**, mirrored for both assistants, with their helper scripts and references.+ - **406 draft motion-graphics cards** across two styles, with manifests, CSS tokens, and editable slots.+ - **Two scene templates:** dark graph paper and a left glass popout.+ - Transcription, silence cutting, mistake detection, reviewed cut rendering,+ transcript retiming, EDL review, beat-sync validation, and preflight tools.++- **Short-form editing:** reels, YouTube Shorts, hook and payoff planning, precise captions, moving B-roll, and audio review.++- **12 existing teaching projects** preserved from the original student kit.+ - A synthetic starter composition and editing fixture that need no footage or API key.++ ## Install++ Install Node.js **22 or newer**, Git, FFmpeg (including ffprobe), and Chrome or+ Chromium. Make `node`, `ffmpeg`, and `ffprobe` available in your terminal.+ Then run these commands in PowerShell, macOS Terminal, or a Linux shell:++ ```sh-git clone https://github.com/nateherkai/hyperframes-video-pipeline.git-cd hyperframes-video-pipeline++git clone https://github.com/nateherkai/hyperframes-student-kit.git++cd hyperframes-student-kit+ npm ci+ npm run setup+ npm test```- Studio hot-reloads on file save. Scrub the timeline, inspect scenes, change colors, watch it re-render live.+ Setup checks the tools and creates `.env` only if it is absent. For your own+ recordings, add an ElevenLabs API key with `speech_to_text` access to that local+ file. Transcription uploads audio and uses your ElevenLabs credits. Everything+ else in the starter runs locally. [Setup and troubleshooting](docs/SETUP.md).- ## Repo layout+ ## Render your first example+ ```sh+ npm run demo+ cd video-projects/demo+ npx hyperframes lint+ npx hyperframes preview```- hyperframes-editor/- ├── README.md ← you are here- ├── LICENSE ← MIT (see note on brand assets)- ├── .env.example ← copy to .env, fill in your own keys- ├── CLAUDE.md ← full workspace guide for Claude Code users- ├── AGENTS.md ← agent-delegation notes- ├── MOTION_PHILOSOPHY.md ← the motion aesthetic this repo aspires to- ├── DESIGN.ais-example.md ← the AIS brand spec — your worked example- ├── assets/ ← shared brand examples (AIS logo + tokens)- │ ├── AIS Logo PNG.png- │ ├── AIS Background.png- │ ├── AIS Brand Guideline Small.jpg- │ └── brand-tokens.css ← CSS custom props every comp can import- ├── docs/ ← longer-form specs + plans- ├── scripts/ ← workspace-level preflight scripts- ├── .claude/ ← Claude Code skills (drop-in slash commands)- │ ├── launch.json- │ └── skills/ ← /hyperframes, /gsap, /make-a-video, etc.- ├── package.json- └── video-projects/ ← the 13 projects- └── <project>/- ├── index.html ← root composition entry- ├── compositions/ ← sub-comps loaded via data-composition-src- ├── assets/ ← video, audio, images, transcripts- ├── final.mp4 ← the target output — watch this first- ├── renders/ ← your local render scratch (gitignored)- ├── hyperframes.json ← CLI config (paths relative to this folder)- ├── meta.json ← id / name / dimensions / fps- └── (STORYBOARD.md, HANDOFF.md, NOTES.md as applicable)- ```-- ## The 12 projects, at a glance-- Start by opening each `final.mp4` to see the target, then open `index.html` to see how it's built.-- ### Short-form vertical (9:16, 1080×1920)- | Project | What it is |- |---|---|- | `may-shorts-19` | TikTok-style talking-head + motion graphics + karaoke captions. This one has the most polish — the `/short-form-video` skill was written around it. |- | `may-shorts-18` | Earlier short in the same series. Compare v2 vs may-shorts-19 to see what got refined. |-- ### Short-form landscape (16:9)- | Project | What it is |- |---|---|- | `may-shorts-6` | Landscape cut of a talking-head short, same production pattern as the vertical series. |-- ### Product promos- | Project | What it is |- |---|---|- | `clickup-demo` | 60s SaaS product demo — heavy registry-block use (x-post, ui-3d-reveal). Five render versions show the iteration curve. |- | `linear-promo-30s` | 30s Linear-style promo in the Infinite Payments aesthetic. Ships as a draft — finishing it is a good student exercise. See `NOTES.md`. |- | `hyperframes-sizzle` | Hyperframes × Claude Code sizzle reel. Uses the `/website-to-hyperframes` flow. |- | `first-agent-promo` | 32s "Your First AI Agent" launch film. Uses a React-via-Babel approach instead of the standard HTML pattern — a useful counter-example. |-- ### Educational lessons- | Project | What it is |- |---|---|- | `aisoc-lesson-5-1` | Full lesson video (face-cam + motion graphics). See CLAUDE.md for the new-lesson pipeline (transcribe → word-synced MG → sections). |- | `golden-ratio-demo` | AIS lesson on proportion in layout. Ships as a polished draft — see `NOTES.md` for what was left open. |- | `claude-edit-intro` | Promo-style intro to an editing workflow; minimal brand hardcoding — easy starting template. |-- ### Brand hype / launch- | Project | What it is |- |---|---|- | `aisoc-hype` | 30s AI Automation Society brand hype film — the scaffold many other AIS projects reference. |- | `aisoc-app-release` | 30s AIS mobile app release promo. Read `HANDOFF.md` — Nate documented every footgun. |-- ## ⚠️ Customizing for your brand-- **This is the most important section.** The repo ships with AI Automation Society (AIS) branding baked in as a worked example. Before you use any of this for your own work, swap these out:-- ### The global swap list-- | File | What it is | What to do |- |---|---|---|- | `assets/brand-tokens.css` | Defines `--ais-bg`, `--ais-accent`, `--ais-warn`, font variables | Replace hex values + font families with your own. Consider renaming the custom-prop prefix to your brand (`--acme-bg`, etc.) — but then you'll need to grep every composition for the old names. |- | `assets/AIS Logo PNG.png` | Logo used by AIS projects | Drop your own logo in; either keep the filename so existing references work, or rename and grep-replace. |- | `assets/AIS Background.png` | Background image occasionally used in AIS scenes | Same pattern as logo. |- | `assets/AIS Brand Guideline Small.jpg` | Reference image for the AIS brand | Delete; replace with your own guideline image if you have one. |- | `DESIGN.ais-example.md` | Full AIS brand spec | **Don't edit.** Use it as your template: copy it to your new project folder as `DESIGN.md` and rewrite colors, fonts, motion rules, and "What NOT to Do" for your brand. |- ### Per-project AIS coupling-- | Project | AIS coupling | Treat as |- |---|---|---|- | `aisoc-hype`, `aisoc-app-release`, `aisoc-lesson-5-1`, `golden-ratio-demo` | **Heavy** — hex values hardcoded in compositions, `@aiautomationsociety` handle, AIS logo glow recipe, Nate's on-camera identity in some scenes | Reference only. Rebuild from scratch for your brand. |- | `clickup-demo`, `first-agent-promo`, `hyperframes-sizzle`, `linear-promo-30s`, `may-shorts-*`, `context-session`, `claude-edit-intro` | **Minimal** | Good starting templates — swap the brand tokens and you're mostly there. |-- ### Find-and-fix sweep-- After you've swapped the global assets, run this grep to find any AIS references still living in compositions:-- ```bash- # Finds hardcoded hex values and AIS strings anywhere in video-projects/- grep -rEn "(#37bdf8|#f09025|#07121c|#195066|aisoc|AIS Logo|@aiautomationsociety)" video-projects/- ```-- Replace each hit either with the matching CSS custom prop from your new `brand-tokens.css`, or with your own hex/handle.-- ## Creating your own new video project-- 1. Pick a kebab-case name: `mkdir video-projects/my-brand-promo`- 2. Scaffold with the CLI or copy a sibling:- ```bash- cd video-projects/my-brand-promo- npx hyperframes init- ```- Or, faster: copy the `hyperframes.json` + `meta.json` from a sibling project you like, edit `meta.json` for your new id/name/dimensions, and start on `index.html` from scratch.- 3. Install the shared brand assets into your project:- ```bash- cp ../../assets/brand-tokens.css assets/- cp ../../assets/YourLogo.png assets/- ```- 4. Write your `DESIGN.md` (copy the shape of `DESIGN.ais-example.md` from the root).- 5. Build. Preview. Lint. Render.-- ## The authoring loop+ Scrub the eight-second animation in Studio. After reviewing it, stop the preview+ with Ctrl+C, then render:+ ```sh+ npx hyperframes render --quality draft --output renders/demo.mp4```- edit → lint → preview (Studio, live) → draft render → verify frames → final render- ```-- | Step | Command | What to check |- |---|---|---|- | Lint | `npx hyperframes lint` | Zero errors before you preview. Warnings are survivable. |- | Preview | `npx hyperframes preview` | Scrub the timeline, fix anything weird live. Hot reload works. |- | Draft render | `npx hyperframes render --quality draft --output renders/draft.mp4` | ~1–3 minutes. CRF 28 — pixelated but fast. |- | Verify frames | `ffmpeg -ss <t> -i renders/draft.mp4 -frames:v 1 out.png` | Pull one frame per scene at its hero moment. Look for cropped faces, misaligned text, blank frames. |- | Final render | `npx hyperframes render --quality standard --output renders/final.mp4` | Visually lossless 1080p. Ship this. |-- > **`MOTION_PHILOSOPHY.md` is your aesthetic gym.** Before you build anything, read section 0 (the 10 Laws) and section 4 (pre-flight checklist). This doc is the difference between "it rendered" and "it's good."-- ## Recommended reading order-- 1. **This README** (you're here)- 2. **`CLAUDE.md`** — full workspace guide, conventions, skills, render contract. Useful even if you're not using Claude Code — the 11 Render Contract rules apply to anyone editing a composition.- 3. **`MOTION_PHILOSOPHY.md`** — aesthetic rules. Read before brainstorming your first scene.- 4. **`DESIGN.ais-example.md`** — worked example of a brand spec.- 5. **Pick one generic project** (`claude-edit-intro` is a good start). Open `index.html`, `final.mp4` side by side, and the `compositions/` folder. Read, scrub, modify, re-render.- 6. **Then open an AIS project** — you'll have the vocabulary to see how far they push the framework.-- ## Using Claude Code with this repo-- The `.claude/skills/` folder ships a set of slash commands that encode framework-specific patterns (`window.__timelines` registration, `data-*` attribute semantics, shader-compatible CSS). If you use [Claude Code](https://claude.com/claude-code), these unlock automatically:-- - `/hyperframes` — authoring/editing compositions, captions, TTS, audio-reactive animation- - `/hyperframes-cli` — CLI reference (init, add, lint, preview, render, transcribe, tts)- - `/gsap` — GSAP animation: timelines, easing, stagger, plugins- - `/hyperframes-registry` — install catalog blocks/components- - `/website-to-hyperframes` — turn a URL into a composition (7-step capture-to-video)- - `/make-a-video` — end-to-end beginner flow- - `/short-form-video` — 9:16 talking-head + motion graphics playbook-- Not a Claude Code user? The skills are just markdown — open them up and read as documentation.-- ## Troubleshooting-- | Symptom | First thing to try |- |---|---|- | `npx hyperframes` — command not found | `npm install` in the repo root first |- | Render fails mid-way | `npx hyperframes doctor` — verifies Node, FFmpeg, Chrome |- | Studio preview stuck at 0s | Hard-refresh the browser (Ctrl+Shift+R). If that fails, try a specific sub-composition URL: `http://localhost:3002/?comp=<sub-comp-id>` |- | Lint errors about overlapping clips | Two clips on the same `data-track-index` overlap in time — assign different track indices or adjust `data-start` / `data-duration` |- | Lint errors about `missing_gsap_script` | Every sub-composition HTML needs its own `<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js"></script>` before its IIFE — GSAP doesn't inherit from the parent |- | Video frozen in a render, audio continues | A `<video>` element was animated directly (don't animate `width`/`height`/`top`/`left` on a `<video>`). Wrap it in a `<div>` and animate the wrapper. |-- More: `npx hyperframes docs <topic>` (topics: `data-attributes`, `gsap`, `rendering`, `examples`, `troubleshooting`, `compositions`).-- ## Credits and license-- - **Code and compositions** — MIT, see `LICENSE`.- - **AIS brand assets** (logo, background, brand guideline image, AIS tokens) — remain the property of AI Automation Society. Included as a worked example; not licensed for reuse. Replace them with your own before shipping.- - **Hyperframes** — framework © HeyGen, docs at https://hyperframes.heygen.com.- Built by [Nate Herk](https://aiautomationsociety.ai). Have fun ripping it apart.+ The demo uses local GSAP. HyperFrames may download and cache its font substitutions on the first render. It has no voiceover. The separate+ [synthetic transcript](examples/editing/source.json) exercises the cutting tools;+ it is fictional test data, not a transcript of the title animation.++ ## Edit your footage++ Open this repository folder in Codex or Claude Code and say:++ > Use edit-video to edit my recording at [local path]. Keep my examples and core+ > lessons. Tighten dead air, show me the proposed mistake cuts, and use the dark+ > graph-paper style with occasional glass cards. Produce a reviewed draft.++ Codex: `$edit-video`. Claude Code: `/edit-video`. For a single operation use+ `cut-silences`, `cut-mistakes`, `video-storytelling`, or `style-library`.+ See the [step-by-step workflow](docs/WORKFLOW.md), [prompt recipes](docs/PROMPTS.md),+ and [storytelling workbook](docs/STORYTELLING-WORKBOOK.md).+++## Create a reel or YouTube Short++++> Use short-form-edit to turn my recording at [local path] into a 9:16 reel.++> Build a truthful hook and payoff, preserve my meaning, tighten mistakes, and++> add precise captions, purposeful moving footage, and sound design. Prepare++> a draft for review. Use my existing footage before proposing generated assets.++++Codex: `$short-form-edit`. Claude Code: `/short-form-edit`.++The skill includes planning references and validators for caption timing, source++mapping, scene coverage, and footage reuse. It is an agent-guided workflow;++review the actual motion and audio before publishing.++[Short-form walkthrough and validation commands](docs/SHORT-FORM.md).++++## Existing examples and migration++++This is the main student-kit repository. The newer video-pipeline kit has been++merged here with both Git histories preserved. The original 12 projects remain++in `video-projects/`, alongside the original shared brand examples and the++`make-a-video`, `short-form-video`, and `website-to-hyperframes` skills.++Use `short-form-edit` for new reels; `short-form-video` documents the older May++Shorts compositions. [Migration and compatibility notes](docs/MIGRATION.md).+++ ## Explore and customize++ | Resource | Start here |+ | --- | --- |+ | Shared agent instructions | [AGENTS.md](AGENTS.md) |+ | Motion and transition vocabulary | [MOTION_PHILOSOPHY.md](MOTION_PHILOSOPHY.md) |+ | Card library and design tokens | [Library guide](style-library/GUIDE.md) |+ | Searchable card metadata | [registry.json](style-library/registry.json) |+ | Whole-scene templates | [Template guide](style-templates/README.md) |+ | Codex setup and mirroring | [.codex/README.md](.codex/README.md) |+ | Release checks and limits | [Verification](docs/VERIFICATION.md) |+ | Third-party resources | [Notices](THIRD_PARTY_NOTICES.md) |++ The cards are reusable **draft assets**. Test the cards you choose with your text+ and footage. Library templates may load GSAP and Google Fonts from their public+ CDNs; localize these dependencies when assembling a final project.+-This release excludes personal recordings, transcripts, finished video projects,-credentials, private workspace settings, and third-party reference screenshots.-Your own `video-projects/` folder is ignored by Git automatically.++No new private recordings, transcripts, credentials, or private workspace settings++were imported. Previously public examples remain in the repository. New folders++under `video-projects/` and `raw-media/` are ignored automatically; files already++tracked by Git remain tracked. Create a new project for your own footage.diff --cc THIRD_PARTY_NOTICES.mdindex 0000000,47c5544..9c00c27mode 000000,100644..100644--- a/THIRD_PARTY_NOTICES.md+++ b/THIRD_PARTY_NOTICES.md@@@ -1,0 -1,22 +1,26 @@@+ # Resource provenance++ This kit assembles original workspace workflows, design guidance, templates, and-card implementations for students. It does not include private source recordings,-third-party reference screenshots, paid stock assets, or third-party video clips.++card implementations for students. New pipeline resources exclude private source recordings and private reference++screenshots. The original student kit's previously published example media and++brand assets remain unchanged; their inclusion does not grant third-party rights.++ - HyperFrames: https://github.com/heygen-com/hyperframes (Apache-2.0).+ The hyperframes, hyperframes-cli, hyperframes-registry, and gsap skill packages+ were bundled with the original workspace from the HyperFrames skill ecosystem.+ The upstream Apache license is included in licenses/HYPERFRAMES-LICENSE.+ - GSAP is installed from npm; its own license applies. See the license files in+ node_modules/gsap and https://gsap.com/community/standard-license/.+ - Some library styles reference Google Fonts. Font licenses remain with their+ publishers. Install and preserve applicable licenses when localizing fonts.+ - Vox, Kallaway, and Infinite are aesthetic reference names. These templates are+ not official brand assets or endorsed by those creators or organizations.++ No blanket relicensing of third-party components is implied. See LICENSE for the-permission applying to the original teaching-kit material.++MIT permission for the original student-kit material. Imported pipeline resources++retain the grant in licenses/PIPELINE-USE-PERMISSION.txt. This includes the added++pipeline skills, style library, templates, shared editing tools, and new short-form++workflow. Third-party notices override these grants for their respective assets.++ Library names, handles, statistics, and source labels inside cards are illustrative+ placeholders. Replace them with your own verified copy before publishing a video.diff --cc docs/EXPORT-SCOPE.mdindex 0000000,cac2e13..b385adbmode 000000,100644..100644--- a/docs/EXPORT-SCOPE.md+++ b/docs/EXPORT-SCOPE.md@@@ -1,0 -1,11 +1,16 @@@+ # Export scope+-The release was assembled in a new directory using an allowlist of reusable-skills, helper scripts, style-library text sources, and template text sources.-It began with new Git history. No private project history was imported.++The pipeline portion was originally assembled from an allowlist of reusable++skills, helper scripts, library sources, and template sources with fresh public++history. This update merges that public history into the existing public student++kit; it does not import the private production workspace's Git history.+-Excluded: source and finished media, personal video projects, reference project-transcripts and EDLs, `.env`, private application state, old imports and archives,-binary caches, third-party reference screenshots, and machine-specific paths.-Synthetic examples were authored separately. Source templates and workflows were-adapted for portable paths and neutral example content.++The new short-form skill includes its instructions, generalized reference++worksheet, and validators. Personal reference-video filenames and the private++recording analysis were replaced with a reusable worksheet. Synthetic test data++was authored separately. No private recordings, transcripts, edit decisions,++credentials, or machine-specific settings were added.++++The original repository's already-public video examples and shared brand assets++remain unchanged. This combined repository therefore includes existing media;++it is not a media-free export. New student media and projects are gitignored.diff --cc docs/MIGRATION.mdindex 0000000,0000000..7a40381new file mode 100644--- /dev/null+++ b/docs/MIGRATION.md@@@ -1,0 -1,0 +1,33 @@@++# Consolidated student kit++++The existing `nateherkai/hyperframes-student-kit` is the canonical repository.++The reusable kit from `nateherkai/hyperframes-video-pipeline` was merged into it,++preserving both published histories and the original repository's stars and URL.++++## What was added++++- Codex instructions, project settings, and generated skill mirrors.++- Silence and mistake cutting, full-edit orchestration, storytelling, and beat tools.++- The new `short-form-edit` workflow, its references, and plan/footage validators.++- 406 draft cards, two reusable scene templates, a synthetic starter, and tests.++- Setup, prompt recipes, verification guidance, and CI on Windows, macOS, and Linux.++++## What remains++++All 12 existing `video-projects/` examples and root `assets/` were retained without++modification. The original three additional skills remain available. New reels++route to `short-form-edit`; `short-form-video` is the legacy May Shorts reference.++++The package retains CommonJS behavior for older `.js` helpers; new tools use++explicit `.mjs` modules. HyperFrames is pinned in the lockfile. Older examples++were not all re-rendered against that version, and may need project-specific++asset, font, dependency, or API setup. Their historical output is not a current++compatibility guarantee. Start new work with `npm run new-video -- my-video`.++++New private projects are ignored by Git. Already-tracked teaching files remain++tracked despite ignore rules, so avoid putting private footage into those folders.++No private workspace history, raw recordings, or credentials were imported.++++The original MIT license remains. Imported pipeline material retains its included++use permission, and third-party licenses remain applicable. See++[resource notices](../THIRD_PARTY_NOTICES.md).diff --cc docs/PROMPTS.mdindex 0000000,fa1ca4a..f71781bmode 000000,100644..100644--- a/docs/PROMPTS.md+++ b/docs/PROMPTS.md@@@ -1,0 -1,18 +1,28 @@@+ # Prompt recipes++ **Complete edit:** Use edit-video on [path]. Preserve the examples and core+ lessons. Tighten pauses, propose mistake cuts, plan the visual arc, and build a+ HyperFrames draft in video-projects/[slug].++ **Mistakes only:** Use cut-mistakes with [edited transcript] and its matching+ [edited video]. Explain each proposed removal and preserve intentional emphasis.++ **Story pass:** Use video-storytelling to plan a persistent visual world for+ [script]. Mark the hook, open loops, camera framing, callbacks, and payoff.++ **Motion graphics:** Use style-library and hyperframes-video-beats to select+ three useful overlays for this transcript. Give each a verbatim anchor and keep+ the speaker readable. Follow the project's DESIGN.md.++ **Verify:** Inspect the actual rendered MP4, its transition frames, and its audio+ joins. Fix visible defects and write VERIFY.md with evidence and limitations.++++## A reel with a clear payoff++++> Use short-form-edit to create a 9:16 reel from [local recording]. Explore three++> opening directions, then build the strongest truthful promise and payoff. Keep++> captions word-exact and choose moving footage for specific story beats. Show me++> the rough edit before polishing. Save the project and review evidence together.++++See [the short-form walkthrough](SHORT-FORM.md) for the expected plan files and++validator commands.diff --cc docs/SHORT-FORM.mdindex 0000000,0000000..0de19c7new file mode 100644--- /dev/null+++ b/docs/SHORT-FORM.md@@@ -1,0 -1,0 +1,56 @@@++# Reels and YouTube Shorts++++Use `short-form-edit` for a raw talking-head recording, reel, YouTube Short, or++short advertisement. It defaults to 1080x1920. Request a separately composed++1920x1080 version when needed; a center crop is not a second composition.++++## Start++++Run `npm run new-video -- my-reel`, then ask Codex (`$short-form-edit`) or Claude++Code (`/short-form-edit`) to edit your local recording into that project. State++the audience, intended action, target duration, and any brand preferences.++The starter is landscape; the skill must set the reel's composition dimensions,++layout, and metadata to 1080x1920 before authoring. Keep all source footage and++outputs inside the new project.++++1. Transcribe with ElevenLabs Scribe, or reuse verified word timestamps.++2. Review mistakes in context and establish one frame-aligned edit decision list.++3. Explore three opening directions and choose a truthful promise and payoff.++4. Plan scenes, exact captions, moving footage, and sound cues against retained words.++5. Build the composition with the HyperFrames and GSAP skills. Use a footage ledger++ to record provenance and prevent unintentional reuse of the same source scene.++6. Validate, preview, render a draft, inspect frames, and listen to the full edit.++7. Resolve timing, audio, and composition problems before exporting the final video.++++Transcription sends audio to ElevenLabs and uses your credits. Generated footage++is optional, requires your own provider account, and may cost money. Prepare the++asset proposal and honor the user's existing authorization. No paid service is++needed to run the bundled synthetic validation example.++++## Validate from the repository root++++```sh++npm run validate:short-form -- video-projects/my-reel++npm run validate:footage -- video-projects/my-reel++node scripts/preflight.mjs video-projects/my-reel++```++++The first validator reads `assets/plan.json`, `assets/transcript.json`, and++`assets/edit-decisions.json`. The second reads the plan and, for moving footage,++`assets/footage-ledger.json`, checks hashes, and confirms referenced files exist.++Follow the [plan schema](../.claude/skills/short-form-edit/references/plan-schema.md).++Use the [reference worksheet](../.claude/skills/short-form-edit/references/reference-analysis.md)++when analyzing a supplied reference video.++++Try the synthetic fixture without a recording or API key:++++```sh++npm run validate:short-form -- examples/short-form++npm run validate:footage -- examples/short-form++npm test++```++++The fixture contains invented words and timing data, not a rendered reel.++Validators check structure and declared timing. They do not prove a compelling++hook, factual claims, rights to footage, correct visual cropping, or audible sync.++The skill's quality gates require watching and listening to the actual output.diff --cc docs/VERIFICATION.mdindex 0000000,402c4bf..6247f67mode 000000,100644..100644--- a/docs/VERIFICATION.md+++ b/docs/VERIFICATION.md@@@ -1,0 -1,38 +1,59 @@@+ # Release verification+++## Consolidated student kit, version 2++++- All 14 canonical skills passed frontmatter validation, and all 94 skill resources++ match the Codex mirrors. The distribution check reports zero errors across++ 406 cards and both skill trees.++- A clean `npm ci` succeeded. All 11 behavior tests passed, including new checks++ for caption drift, incorrect source mapping, scene coverage, footage reuse,++ missing ledger rows, and changed footage hashes.++- The starter passed preflight and HyperFrames lint with zero errors or warnings.++- The synthetic media smoke check passed again: silence output 3.960 seconds,++ clean output 3.673 seconds versus a 3.660-second transcript.++- All original `video-projects/` and root `assets/` files were retained unchanged.++ They were not all re-rendered. No real reel or paid generation was run for this++ migration; short-form verification covers its validators and resource package.++++## Original pipeline release evidence++++The following rendering evidence comes from the pipeline release before this++merge. Its starter and editing implementation are retained.+++++ Verified locally on Windows, September 8, 2026, using Node 24.15.0,+ FFmpeg 8.1.1, and HyperFrames 0.7.109.++ - Clean dependency install succeeded; npm reported zero known vulnerabilities.+ - Root AGENTS.md and CLAUDE.md match. Ten skill packages and every supporting+ resource match their generated Codex mirrors.+ - The kit check validates JavaScript syntax, skill frontmatter and linked resources,+ registry counts, unique IDs, declared slots, and local card dependencies.+ All 406 card files resolve. Two cards construct some slots in JavaScript;+ their source declarations are checked, not their executed DOM.+ - Five behavior tests pass: silence retiming, reviewed stutter removal, empty-cut+ identity behavior, invalid cut bounds, and early/late beat timing. The CLI+ accepts explicit project paths and attribute order independent of old examples.+ - `npm run test:media` generated an eight-second test pattern with a sine tone,+ rendered both editing stages, and built the EDL review HTML. The silence output+ was 3.960 seconds; the clean output was 3.673 seconds against a 3.660-second+ transcript. A/V durations differ by less than 0.04 seconds.+ - The starter passed preflight and HyperFrames lint with zero errors/warnings.+ Studio loaded and played to eight seconds. Draft render produced 240 H.264+ frames at 1920x1080 and 30fps. Extracted frames were visually inspected across+ the eight-second sequence. No black interval of 0.1 seconds or longer was detected.++ ## Scope and limits++ This is a working toolkit, not a promise of fully automatic editorial judgment.+ The library's 406 cards retain draft status; this release did not individually+ render and visually approve all of them. Test each selected card with your copy.+ The starter is motion graphics only, with no speech. The media smoke exercise+ checks timing and stream integrity with a tone, not subjective speech-cut quality.+ Paid Scribe transcription was not called during release QA. The templates require+ adaptation; the glass popout needs the student's footage. HyperFrames can download+ font substitutions on the first render. Cross-platform checks run in GitHub CI;+ local media and rendering QA were performed on Windows.++ Repeat: `npm ci`, `npm run check`, `npm test`, `npm run test:media`, then create a+ new starter project and lint, preview, render, and inspect its output.diff --cc examples/short-form/assets/edit-decisions.jsonindex 0000000,0000000..5bc9369new file mode 100644--- /dev/null+++ b/examples/short-form/assets/edit-decisions.json@@@ -1,0 -1,0 +1,13 @@@++{++ "duration": 4,++ "fps": 30,++ "keeps": [++ {++ "sourceStart": 1,++ "sourceEnd": 5,++ "start": 0,++ "end": 4++ }++ ],++ "removals": []++}diff --cc examples/short-form/assets/plan.jsonindex 0000000,0000000..bbd492fnew file mode 100644--- /dev/null+++ b/examples/short-form/assets/plan.json@@@ -1,0 -1,0 +1,84 @@@++{++ "duration": 4,++ "fps": 30,++ "scenes": [++ {++ "id": "s00",++ "start": 0,++ "end": 2,++ "layout": "face",++ "kind": "hook",++ "anchor": "Grow",++ "anchorTime": 0.1++ },++ {++ "id": "s01",++ "start": 2,++ "end": 4,++ "layout": "face",++ "kind": "payoff",++ "anchor": "Start",++ "anchorTime": 2.1++ }++ ],++ "events": [++ {++ "time": 0,++ "type": "title",++ "visual": "s00",++ "anchor": "Grow"++ },++ {++ "time": 2,++ "type": "caption",++ "visual": "s01",++ "anchor": "Start"++ }++ ],++ "captions": [++ {++ "start": 0.1,++ "end": 1,++ "words": [++ {++ "text": "Grow",++ "start": 0.1,++ "end": 0.4,++ "sourceStart": 1.1,++ "sourceEnd": 1.4,++ "type": "word"++ },++ {++ "text": "something.",++ "start": 0.4,++ "end": 1,++ "sourceStart": 1.4,++ "sourceEnd": 2,++ "type": "word"++ }++ ]++ },++ {++ "start": 2.1,++ "end": 3,++ "words": [++ {++ "text": "Start",++ "start": 2.1,++ "end": 2.4,++ "sourceStart": 3.1,++ "sourceEnd": 3.4,++ "type": "word"++ },++ {++ "text": "small.",++ "start": 2.4,++ "end": 3,++ "sourceStart": 3.4,++ "sourceEnd": 4,++ "type": "word"++ }++ ]++ }++ ]++}diff --cc examples/short-form/assets/transcript.jsonindex 0000000,0000000..8dc328anew file mode 100644--- /dev/null+++ b/examples/short-form/assets/transcript.json@@@ -1,0 -1,0 +1,38 @@@++{++ "words": [++ {++ "text": "Grow",++ "start": 0.1,++ "end": 0.4,++ "sourceStart": 1.1,++ "sourceEnd": 1.4,++ "type": "word"++ },++ {++ "text": "something.",++ "start": 0.4,++ "end": 1,++ "sourceStart": 1.4,++ "sourceEnd": 2,++ "type": "word"++ },++ {++ "text": "Start",++ "start": 2.1,++ "end": 2.4,++ "sourceStart": 3.1,++ "sourceEnd": 3.4,++ "type": "word"++ },++ {++ "text": "small.",++ "start": 2.4,++ "end": 3,++ "sourceStart": 3.4,++ "sourceEnd": 4,++ "type": "word"++ }++ ],++ "audio_duration_secs": 4,++ "text": "Grow something. Start small."++}diff --cc licenses/PIPELINE-USE-PERMISSION.txtindex 0000000,0000000..812408bnew file mode 100644--- /dev/null+++ b/licenses/PIPELINE-USE-PERMISSION.txt@@@ -1,0 -1,0 +1,15 @@@++Student Kit Use Permission++++Copyright 2026 the contributors to this teaching kit.++++Permission is granted to students and other recipients to use, copy, modify,++and share the original teaching-kit code, templates, and documentation, and to++use them to produce personal or commercial videos. Retain this notice when++redistributing the kit or substantial portions of its source materials.++++Third-party software, fonts, and assets remain subject to their respective++licenses. No rights to third-party trademarks, likenesses, or excluded media++are granted. See THIRD_PARTY_NOTICES.md.++++THE MATERIAL IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND. THE CONTRIBUTORS++ARE NOT LIABLE FOR CLAIMS OR DAMAGES ARISING FROM ITS USE.diff --cc package-lock.jsonindex a059d45,99c8211..e943f84--- a/package-lock.json+++ b/package-lock.json@@@ -1,60 -1,2782 +1,2812 @@@{- "name": "hyperframes-editor",- "name": "hyperframes-video-pipeline",-- "version": "1.0.0",++ "name": "hyperframes-student-kit",++ "version": "2.0.0","lockfileVersion": 3,"requires": true,"packages": {"": {- "name": "hyperframes-editor",- "name": "hyperframes-video-pipeline",- "version": "1.0.0",++ "name": "hyperframes-student-kit",++ "version": "2.0.0",+ "devDependencies": {+ "gsap": "3.14.2",- "hyperframes": "0.7.109"++ "hyperframes": "0.7.109",++ "playwright": "^1.59.1"+ },+ "engines": {+ "node": ">=22"+ }+ },+ "node_modules/@emnapi/runtime": {+ "version": "1.11.3",+ "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.11.3.tgz",+ "integrity": "sha512-Xz4Tpyki7XyrpbUK1jR1AhdAdaXyhhY4lZ3neLodmhpuWfy2PAQN5B46sAiU4liOXGLkHypn/qU+jvfWSCYYLA==",+ "dev": true,+ "license": "MIT",+ "optional": true,+ "dependencies": {+ "tslib": "^2.4.0"+ }+ },+ "node_modules/@esbuild/aix-ppc64": {+ "version": "0.25.12",+ "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.25.12.tgz",+ "integrity": "sha512-Hhmwd6CInZ3dwpuGTF8fJG6yoWmsToE+vYgD4nytZVxcu1ulHpUQRAB1UJ8+N1Am3Mz4+xOByoQoSZf4D+CpkA==",+ "cpu": [+ "ppc64"+ ],+ "dev": true,+ "license": "MIT",+ "optional": true,+ "os": [+ "aix"+ ],+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@esbuild/android-arm": {+ "version": "0.25.12",+ "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.25.12.tgz",+ "integrity": "sha512-VJ+sKvNA/GE7Ccacc9Cha7bpS8nyzVv0jdVgwNDaR4gDMC/2TTRc33Ip8qrNYUcpkOHUT5OZ0bUcNNVZQ9RLlg==",+ "cpu": [+ "arm"+ ],+ "dev": true,+ "license": "MIT",+ "optional": true,+ "os": [+ "android"+ ],+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@esbuild/android-arm64": {+ "version": "0.25.12",+ "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.25.12.tgz",+ "integrity": "sha512-6AAmLG7zwD1Z159jCKPvAxZd4y/VTO0VkprYy+3N2FtJ8+BQWFXU+OxARIwA46c5tdD9SsKGZ/1ocqBS/gAKHg==",+ "cpu": [+ "arm64"+ ],+ "dev": true,+ "license": "MIT",+ "optional": true,+ "os": [+ "android"+ ],+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@esbuild/android-x64": {+ "version": "0.25.12",+ "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.25.12.tgz",+ "integrity": "sha512-5jbb+2hhDHx5phYR2By8GTWEzn6I9UqR11Kwf22iKbNpYrsmRB18aX/9ivc5cabcUiAT/wM+YIZ6SG9QO6a8kg==",+ "cpu": [+ "x64"+ ],+ "dev": true,+ "license": "MIT",+ "optional": true,+ "os": [+ "android"+ ],+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@esbuild/darwin-arm64": {+ "version": "0.25.12",+ "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.25.12.tgz",+ "integrity": "sha512-N3zl+lxHCifgIlcMUP5016ESkeQjLj/959RxxNYIthIg+CQHInujFuXeWbWMgnTo4cp5XVHqFPmpyu9J65C1Yg==",+ "cpu": [+ "arm64"+ ],+ "dev": true,+ "license": "MIT",+ "optional": true,+ "os": [+ "darwin"+ ],+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@esbuild/darwin-x64": {+ "version": "0.25.12",+ "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.25.12.tgz",+ "integrity": "sha512-HQ9ka4Kx21qHXwtlTUVbKJOAnmG1ipXhdWTmNXiPzPfWKpXqASVcWdnf2bnL73wgjNrFXAa3yYvBSd9pzfEIpA==",+ "cpu": [+ "x64"+ ],+ "dev": true,+ "license": "MIT",+ "optional": true,+ "os": [+ "darwin"+ ],+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@esbuild/freebsd-arm64": {+ "version": "0.25.12",+ "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.25.12.tgz",+ "integrity": "sha512-gA0Bx759+7Jve03K1S0vkOu5Lg/85dou3EseOGUes8flVOGxbhDDh/iZaoek11Y8mtyKPGF3vP8XhnkDEAmzeg==",+ "cpu": [+ "arm64"+ ],+ "dev": true,+ "license": "MIT",+ "optional": true,+ "os": [+ "freebsd"+ ],+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@esbuild/freebsd-x64": {+ "version": "0.25.12",+ "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.25.12.tgz",+ "integrity": "sha512-TGbO26Yw2xsHzxtbVFGEXBFH0FRAP7gtcPE7P5yP7wGy7cXK2oO7RyOhL5NLiqTlBh47XhmIUXuGciXEqYFfBQ==",+ "cpu": [+ "x64"+ ],+ "dev": true,+ "license": "MIT",+ "optional": true,+ "os": [+ "freebsd"+ ],+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@esbuild/linux-arm": {+ "version": "0.25.12",+ "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.25.12.tgz",+ "integrity": "sha512-lPDGyC1JPDou8kGcywY0YILzWlhhnRjdof3UlcoqYmS9El818LLfJJc3PXXgZHrHCAKs/Z2SeZtDJr5MrkxtOw==",+ "cpu": [+ "arm"+ ],+ "dev": true,+ "license": "MIT",+ "optional": true,+ "os": [+ "linux"+ ],+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@esbuild/linux-arm64": {+ "version": "0.25.12",+ "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.25.12.tgz",+ "integrity": "sha512-8bwX7a8FghIgrupcxb4aUmYDLp8pX06rGh5HqDT7bB+8Rdells6mHvrFHHW2JAOPZUbnjUpKTLg6ECyzvas2AQ==",+ "cpu": [+ "arm64"+ ],+ "dev": true,+ "license": "MIT",+ "optional": true,+ "os": [+ "linux"+ ],+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@esbuild/linux-ia32": {+ "version": "0.25.12",+ "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.25.12.tgz",+ "integrity": "sha512-0y9KrdVnbMM2/vG8KfU0byhUN+EFCny9+8g202gYqSSVMonbsCfLjUO+rCci7pM0WBEtz+oK/PIwHkzxkyharA==",+ "cpu": [+ "ia32"+ ],+ "dev": true,+ "license": "MIT",+ "optional": true,+ "os": [+ "linux"+ ],+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@esbuild/linux-loong64": {+ "version": "0.25.12",+ "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.25.12.tgz",+ "integrity": "sha512-h///Lr5a9rib/v1GGqXVGzjL4TMvVTv+s1DPoxQdz7l/AYv6LDSxdIwzxkrPW438oUXiDtwM10o9PmwS/6Z0Ng==",+ "cpu": [+ "loong64"+ ],+ "dev": true,+ "license": "MIT",+ "optional": true,+ "os": [+ "linux"+ ],+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@esbuild/linux-mips64el": {+ "version": "0.25.12",+ "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.25.12.tgz",+ "integrity": "sha512-iyRrM1Pzy9GFMDLsXn1iHUm18nhKnNMWscjmp4+hpafcZjrr2WbT//d20xaGljXDBYHqRcl8HnxbX6uaA/eGVw==",+ "cpu": [+ "mips64el"+ ],+ "dev": true,+ "license": "MIT",+ "optional": true,+ "os": [+ "linux"+ ],+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@esbuild/linux-ppc64": {+ "version": "0.25.12",+ "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.25.12.tgz",+ "integrity": "sha512-9meM/lRXxMi5PSUqEXRCtVjEZBGwB7P/D4yT8UG/mwIdze2aV4Vo6U5gD3+RsoHXKkHCfSxZKzmDssVlRj1QQA==",+ "cpu": [+ "ppc64"+ ],+ "dev": true,+ "license": "MIT",+ "optional": true,+ "os": [+ "linux"+ ],+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@esbuild/linux-riscv64": {+ "version": "0.25.12",+ "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.25.12.tgz",+ "integrity": "sha512-Zr7KR4hgKUpWAwb1f3o5ygT04MzqVrGEGXGLnj15YQDJErYu/BGg+wmFlIDOdJp0PmB0lLvxFIOXZgFRrdjR0w==",+ "cpu": [+ "riscv64"+ ],+ "dev": true,+ "license": "MIT",+ "optional": true,+ "os": [+ "linux"+ ],+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@esbuild/linux-s390x": {+ "version": "0.25.12",+ "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.25.12.tgz",+ "integrity": "sha512-MsKncOcgTNvdtiISc/jZs/Zf8d0cl/t3gYWX8J9ubBnVOwlk65UIEEvgBORTiljloIWnBzLs4qhzPkJcitIzIg==",+ "cpu": [+ "s390x"+ ],+ "dev": true,+ "license": "MIT",+ "optional": true,+ "os": [+ "linux"+ ],+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@esbuild/linux-x64": {+ "version": "0.25.12",+ "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.25.12.tgz",+ "integrity": "sha512-uqZMTLr/zR/ed4jIGnwSLkaHmPjOjJvnm6TVVitAa08SLS9Z0VM8wIRx7gWbJB5/J54YuIMInDquWyYvQLZkgw==",+ "cpu": [+ "x64"+ ],+ "dev": true,+ "license": "MIT",+ "optional": true,+ "os": [+ "linux"+ ],+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@esbuild/netbsd-arm64": {+ "version": "0.25.12",+ "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.25.12.tgz",+ "integrity": "sha512-xXwcTq4GhRM7J9A8Gv5boanHhRa/Q9KLVmcyXHCTaM4wKfIpWkdXiMog/KsnxzJ0A1+nD+zoecuzqPmCRyBGjg==",+ "cpu": [+ "arm64"+ ],+ "dev": true,+ "license": "MIT",+ "optional": true,+ "os": [+ "netbsd"+ ],+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@esbuild/netbsd-x64": {+ "version": "0.25.12",+ "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.25.12.tgz",+ "integrity": "sha512-Ld5pTlzPy3YwGec4OuHh1aCVCRvOXdH8DgRjfDy/oumVovmuSzWfnSJg+VtakB9Cm0gxNO9BzWkj6mtO1FMXkQ==",+ "cpu": [+ "x64"+ ],+ "dev": true,+ "license": "MIT",+ "optional": true,+ "os": [+ "netbsd"+ ],+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@esbuild/openbsd-arm64": {+ "version": "0.25.12",+ "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.25.12.tgz",+ "integrity": "sha512-fF96T6KsBo/pkQI950FARU9apGNTSlZGsv1jZBAlcLL1MLjLNIWPBkj5NlSz8aAzYKg+eNqknrUJ24QBybeR5A==",+ "cpu": [+ "arm64"+ ],+ "dev": true,+ "license": "MIT",+ "optional": true,+ "os": [+ "openbsd"+ ],+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@esbuild/openbsd-x64": {+ "version": "0.25.12",+ "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.25.12.tgz",+ "integrity": "sha512-MZyXUkZHjQxUvzK7rN8DJ3SRmrVrke8ZyRusHlP+kuwqTcfWLyqMOE3sScPPyeIXN/mDJIfGXvcMqCgYKekoQw==",+ "cpu": [+ "x64"+ ],+ "dev": true,+ "license": "MIT",+ "optional": true,+ "os": [+ "openbsd"+ ],+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@esbuild/openharmony-arm64": {+ "version": "0.25.12",+ "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.25.12.tgz",+ "integrity": "sha512-rm0YWsqUSRrjncSXGA7Zv78Nbnw4XL6/dzr20cyrQf7ZmRcsovpcRBdhD43Nuk3y7XIoW2OxMVvwuRvk9XdASg==",+ "cpu": [+ "arm64"+ ],+ "dev": true,+ "license": "MIT",+ "optional": true,+ "os": [+ "openharmony"+ ],+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@esbuild/sunos-x64": {+ "version": "0.25.12",+ "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.25.12.tgz",+ "integrity": "sha512-3wGSCDyuTHQUzt0nV7bocDy72r2lI33QL3gkDNGkod22EsYl04sMf0qLb8luNKTOmgF/eDEDP5BFNwoBKH441w==",+ "cpu": [+ "x64"+ ],+ "dev": true,+ "license": "MIT",+ "optional": true,+ "os": [+ "sunos"+ ],+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@esbuild/win32-arm64": {+ "version": "0.25.12",+ "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.25.12.tgz",+ "integrity": "sha512-rMmLrur64A7+DKlnSuwqUdRKyd3UE7oPJZmnljqEptesKM8wx9J8gx5u0+9Pq0fQQW8vqeKebwNXdfOyP+8Bsg==",+ "cpu": [+ "arm64"+ ],+ "dev": true,+ "license": "MIT",+ "optional": true,+ "os": [+ "win32"+ ],+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@esbuild/win32-ia32": {+ "version": "0.25.12",+ "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.25.12.tgz",+ "integrity": "sha512-HkqnmmBoCbCwxUKKNPBixiWDGCpQGVsrQfJoVGYLPT41XWF8lHuE5N6WhVia2n4o5QK5M4tYr21827fNhi4byQ==",+ "cpu": [+ "ia32"+ ],+ "dev": true,+ "license": "MIT",+ "optional": true,+ "os": [+ "win32"+ ],+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@esbuild/win32-x64": {+ "version": "0.25.12",+ "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.25.12.tgz",+ "integrity": "sha512-alJC0uCZpTFrSL0CCDjcgleBXPnCrEAhTBILpeAp7M/OFgoqtAetfBzX0xM00MUsVVPpVjlPuMbREqnZCXaTnA==",+ "cpu": [+ "x64"+ ],+ "dev": true,+ "license": "MIT",+ "optional": true,+ "os": [+ "win32"+ ],+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@google/genai": {+ "version": "1.52.0",+ "resolved": "https://registry.npmjs.org/@google/genai/-/genai-1.52.0.tgz",+ "integrity": "sha512-gwSvbpiN/17O9TbsqSsE/OzZcpv5Fo4RQjdngGgogtuB9RsyJ8ZHhX5KjHj1bp5N9snN2eK8LDGXSaWW2hof8Q==",+ "dev": true,+ "hasInstallScript": true,+ "license": "Apache-2.0",+ "optional": true,+ "dependencies": {+ "google-auth-library": "^10.3.0",+ "p-retry": "^4.6.2",+ "protobufjs": "^7.5.4",+ "ws": "^8.18.0"+ },+ "engines": {+ "node": ">=20.0.0"+ },+ "peerDependencies": {+ "@modelcontextprotocol/sdk": "^1.25.2"+ },+ "peerDependenciesMeta": {+ "@modelcontextprotocol/sdk": {+ "optional": true+ }+ }+ },+ "node_modules/@hono/node-server": {+ "version": "2.1.1",+ "resolved": "https://registry.npmjs.org/@hono/node-server/-/node-server-2.1.1.tgz",+ "integrity": "sha512-ELuehkj5VCBdgEw9zs+ivkKwyzzUCSQuE96YmiPvn1ECBoZCczbFXJLeEGMTYjphP6gydh4pHMqEYPVMYUVgQg==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">=20"+ },+ "peerDependencies": {+ "hono": "^4"+ }+ },+ "node_modules/@img/colour": {+ "version": "1.1.0",+ "resolved": "https://registry.npmjs.org/@img/colour/-/colour-1.1.0.tgz",+ "integrity": "sha512-Td76q7j57o/tLVdgS746cYARfSyxk8iEfRxewL9h4OMzYhbW4TAcppl0mT4eyqXddh6L/jwoM75mo7ixa/pCeQ==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/@img/sharp-darwin-arm64": {+ "version": "0.35.3",+ "resolved": "https://registry.npmjs.org/@img/sharp-darwin-arm64/-/sharp-darwin-arm64-0.35.3.tgz",+ "integrity": "sha512-RMnFX7YQsMoh7lWfcM4NEHHymBX/rLuKNPVM84XE9ONPcaSCDgE7CHIHpSgPcO2xcRthgBy1HfNO319mwhIAkg==",+ "cpu": [+ "arm64"+ ],+ "dev": true,+ "license": "Apache-2.0",+ "optional": true,+ "os": [+ "darwin"+ ],+ "engines": {+ "node": ">=20.9.0"+ },+ "funding": {+ "url": "https://opencollective.com/libvips"+ },+ "optionalDependencies": {+ "@img/sharp-libvips-darwin-arm64": "1.3.2"+ }+ },+ "node_modules/@img/sharp-darwin-x64": {+ "version": "0.35.3",+ "resolved": "https://registry.npmjs.org/@img/sharp-darwin-x64/-/sharp-darwin-x64-0.35.3.tgz",+ "integrity": "sha512-Xo+5uFBtLN0BKqieTxiFzFPQAUlBbbH5iBKyRX/z1JrbnYsHTfKJnUfL8+p2TPXr1pXqao4eeL4Rl144uDpK9w==",+ "cpu": [+ "x64"+ ],+ "dev": true,+ "license": "Apache-2.0",+ "optional": true,+ "os": [+ "darwin"+ ],+ "engines": {+ "node": ">=20.9.0"+ },+ "funding": {+ "url": "https://opencollective.com/libvips"+ },+ "optionalDependencies": {+ "@img/sharp-libvips-darwin-x64": "1.3.2"+ }+ },+ "node_modules/@img/sharp-freebsd-wasm32": {+ "version": "0.35.3",+ "resolved": "https://registry.npmjs.org/@img/sharp-freebsd-wasm32/-/sharp-freebsd-wasm32-0.35.3.tgz",+ "integrity": "sha512-lUxcqWIj2wMQ9BrwNjngcr1gWUr5xgaGThBRqPPalIC2n67Cqj1uPh8NnA/ZhAg8hUbKl+kVHKwgUIwe6ZYPrg==",+ "dev": true,+ "license": "Apache-2.0",+ "optional": true,+ "os": [+ "freebsd"+ ],+ "dependencies": {+ "@img/sharp-wasm32": "0.35.3"+ },+ "engines": {+ "node": ">=20.9.0"+ },+ "funding": {+ "url": "https://opencollective.com/libvips"+ }+ },+ "node_modules/@img/sharp-libvips-darwin-arm64": {+ "version": "1.3.2",+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-arm64/-/sharp-libvips-darwin-arm64-1.3.2.tgz",+ "integrity": "sha512-9J6ypZFpQBj4YnePGoq/S38w6nz+vqg5WZLrLGY4YuSemdMq47GMLBPO42MzwdGwpg/agZ7xzZcFHa48xlywfg==",+ "cpu": [+ "arm64"+ ],+ "dev": true,+ "license": "LGPL-3.0-or-later",+ "optional": true,+ "os": [+ "darwin"+ ],+ "funding": {+ "url": "https://opencollective.com/libvips"+ }+ },+ "node_modules/@img/sharp-libvips-darwin-x64": {+ "version": "1.3.2",+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-x64/-/sharp-libvips-darwin-x64-1.3.2.tgz",+ "integrity": "sha512-m2pW1n6cns9VaubNwsZ+c3CRYjxNQWgJ5gPlnL1nbBcpkBvFm6SCFN5o0psFHI8w9n11NKhFkeEDns98tiqbEw==",+ "cpu": [+ "x64"+ ],+ "dev": true,+ "license": "LGPL-3.0-or-later",+ "optional": true,+ "os": [+ "darwin"+ ],+ "funding": {+ "url": "https://opencollective.com/libvips"+ }+ },+ "node_modules/@img/sharp-libvips-linux-arm": {+ "version": "1.3.2",+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm/-/sharp-libvips-linux-arm-1.3.2.tgz",+ "integrity": "sha512-1eMLzy92I4J6rmi4mAT8yC3HxOtniyGELlzGbNMLLeqe052ahFQ0h6LFq+lh5DsDIdYViIDst08abvSbcEdLXQ==",+ "cpu": [+ "arm"+ ],+ "dev": true,+ "libc": [+ "glibc"+ ],+ "license": "LGPL-3.0-or-later",+ "optional": true,+ "os": [+ "linux"+ ],+ "funding": {+ "url": "https://opencollective.com/libvips"+ }+ },+ "node_modules/@img/sharp-libvips-linux-arm64": {+ "version": "1.3.2",+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm64/-/sharp-libvips-linux-arm64-1.3.2.tgz",+ "integrity": "sha512-dqVSFynCox4C/J8kT16V7SIFAns0IjgLwkvYT7p8LQVmJ5OS5b6tI9IGflxTeuBS//zXeFIUbwt5dwxyZ17cnA==",+ "cpu": [+ "arm64"+ ],+ "dev": true,+ "libc": [+ "glibc"+ ],+ "license": "LGPL-3.0-or-later",+ "optional": true,+ "os": [+ "linux"+ ],+ "funding": {+ "url": "https://opencollective.com/libvips"+ }+ },+ "node_modules/@img/sharp-libvips-linux-ppc64": {+ "version": "1.3.2",+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-ppc64/-/sharp-libvips-linux-ppc64-1.3.2.tgz",+ "integrity": "sha512-3z0NHDxD6n5I9gc05U1eW1AyRm+Gznzq3naMrthPNqE6oYykcogW0l/jfpJdjYnuNl8R7yI9pNbE1XiUeyq0Aw==",+ "cpu": [+ "ppc64"+ ],+ "dev": true,+ "libc": [+ "glibc"+ ],+ "license": "LGPL-3.0-or-later",+ "optional": true,+ "os": [+ "linux"+ ],+ "funding": {+ "url": "https://opencollective.com/libvips"+ }+ },+ "node_modules/@img/sharp-libvips-linux-riscv64": {+ "version": "1.3.2",+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-riscv64/-/sharp-libvips-linux-riscv64-1.3.2.tgz",+ "integrity": "sha512-bsb4rI+NldGOsXuej2r8OdSS8+zXDVaCWxyWrcv6kneTOlgAHtZABRzBBCwdsPiD90J4myNJuHpg6kA20ImW/w==",+ "cpu": [+ "riscv64"+ ],+ "dev": true,+ "libc": [+ "glibc"+ ],+ "license": "LGPL-3.0-or-later",+ "optional": true,+ "os": [+ "linux"+ ],+ "funding": {+ "url": "https://opencollective.com/libvips"+ }+ },+ "node_modules/@img/sharp-libvips-linux-s390x": {+ "version": "1.3.2",+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-s390x/-/sharp-libvips-linux-s390x-1.3.2.tgz",+ "integrity": "sha512-/ABshyj8gCpyIrNXnHn4LorDJ0HHm1VhXPBlxZ8zAtfVPAaSafXPGn+sUSIRiwaSBy0mmFjSjiXI5mkcwdChKQ==",+ "cpu": [+ "s390x"+ ],+ "dev": true,+ "libc": [+ "glibc"+ ],+ "license": "LGPL-3.0-or-later",+ "optional": true,+ "os": [+ "linux"+ ],+ "funding": {+ "url": "https://opencollective.com/libvips"+ }+ },+ "node_modules/@img/sharp-libvips-linux-x64": {+ "version": "1.3.2",+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-x64/-/sharp-libvips-linux-x64-1.3.2.tgz",+ "integrity": "sha512-ITPEtgffGJ0S6G9dRyw/366tJQqFRcHWPHhC+Stpg3Z8AEMrDrTr2lhdz4f/Y/HMbRh//7Z5mBzEpVdi62Oc3w==",+ "cpu": [+ "x64"+ ],+ "dev": true,+ "libc": [+ "glibc"+ ],+ "license": "LGPL-3.0-or-later",+ "optional": true,+ "os": [+ "linux"+ ],+ "funding": {+ "url": "https://opencollective.com/libvips"+ }+ },+ "node_modules/@img/sharp-libvips-linuxmusl-arm64": {+ "version": "1.3.2",+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-arm64/-/sharp-libvips-linuxmusl-arm64-1.3.2.tgz",+ "integrity": "sha512-zE9EdiUzUmg5mDT5a1rk5fYJ6GWPloTwWBYDS14naqHsL+EaMpDj1AWnpLgh3u0YCORv2Tt50wrcrpYqkP97Kw==",+ "cpu": [+ "arm64"+ ],+ "dev": true,+ "libc": [+ "musl"+ ],+ "license": "LGPL-3.0-or-later",+ "optional": true,+ "os": [+ "linux"+ ],+ "funding": {+ "url": "https://opencollective.com/libvips"+ }+ },+ "node_modules/@img/sharp-libvips-linuxmusl-x64": {+ "version": "1.3.2",+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-x64/-/sharp-libvips-linuxmusl-x64-1.3.2.tgz",+ "integrity": "sha512-m0lrLiUt+lBYnCFr8qV/65yMR4E/c7/wf78I5eKTdkEakFAlZ9QlzEM3QIhhAwVeUhLAHLcCq7a7Vszq/oFNZQ==",+ "cpu": [+ "x64"+ ],+ "dev": true,+ "libc": [+ "musl"+ ],+ "license": "LGPL-3.0-or-later",+ "optional": true,+ "os": [+ "linux"+ ],+ "funding": {+ "url": "https://opencollective.com/libvips"+ }+ },+ "node_modules/@img/sharp-linux-arm": {+ "version": "0.35.3",+ "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm/-/sharp-linux-arm-0.35.3.tgz",+ "integrity": "sha512-affVWCTLooy8TSxbDx2qkzuDeaWLNVBA+P//FNBirHsXpP2fuBhk5AuboYUnrDnzoXes8GFjpTx0SBFOCRg+FA==",+ "cpu": [+ "arm"+ ],+ "dev": true,+ "libc": [+ "glibc"+ ],+ "license": "Apache-2.0",+ "optional": true,+ "os": [+ "linux"+ ],+ "engines": {+ "node": ">=20.9.0"+ },+ "funding": {+ "url": "https://opencollective.com/libvips"+ },+ "optionalDependencies": {+ "@img/sharp-libvips-linux-arm": "1.3.2"+ }+ },+ "node_modules/@img/sharp-linux-arm64": {+ "version": "0.35.3",+ "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm64/-/sharp-linux-arm64-0.35.3.tgz",+ "integrity": "sha512-QgKDspHPnrU+GQ55XPhGwyhC8acLVOOSyAvo1oVfFmrIXLkDNmGWzAfDZ4xK8oSA1qBQrALcHX0G5UZni/SuFQ==",+ "cpu": [+ "arm64"+ ],+ "dev": true,+ "libc": [+ "glibc"+ ],+ "license": "Apache-2.0",+ "optional": true,+ "os": [+ "linux"+ ],+ "engines": {+ "node": ">=20.9.0"+ },+ "funding": {+ "url": "https://opencollective.com/libvips"+ },+ "optionalDependencies": {+ "@img/sharp-libvips-linux-arm64": "1.3.2"+ }+ },+ "node_modules/@img/sharp-linux-ppc64": {+ "version": "0.35.3",+ "resolved": "https://registry.npmjs.org/@img/sharp-linux-ppc64/-/sharp-linux-ppc64-0.35.3.tgz",+ "integrity": "sha512-sMd8rDxmpLOwv/7N44klFjOD5DUO7FLdjiXDI0hoxYaf7Ar262dQIEkosE98bps+5HPLtp/EvNqeqQtOycP/IA==",+ "cpu": [+ "ppc64"+ ],+ "dev": true,+ "libc": [+ "glibc"+ ],+ "license": "Apache-2.0",+ "optional": true,+ "os": [+ "linux"+ ],+ "engines": {+ "node": ">=20.9.0"+ },+ "funding": {+ "url": "https://opencollective.com/libvips"+ },+ "optionalDependencies": {+ "@img/sharp-libvips-linux-ppc64": "1.3.2"+ }+ },+ "node_modules/@img/sharp-linux-riscv64": {+ "version": "0.35.3",+ "resolved": "https://registry.npmjs.org/@img/sharp-linux-riscv64/-/sharp-linux-riscv64-0.35.3.tgz",+ "integrity": "sha512-0Eob78yjlYPfL5vMNWAW55l3R9Y6BQS/gOfe0ZcP9mEz9ohhKSt4im1hayiknXgf8AWrFqMvJcKIdmLmEe7yeQ==",+ "cpu": [+ "riscv64"+ ],+ "dev": true,+ "libc": [+ "glibc"+ ],+ "license": "Apache-2.0",+ "optional": true,+ "os": [+ "linux"+ ],+ "engines": {+ "node": ">=20.9.0"+ },+ "funding": {+ "url": "https://opencollective.com/libvips"+ },+ "optionalDependencies": {+ "@img/sharp-libvips-linux-riscv64": "1.3.2"+ }+ },+ "node_modules/@img/sharp-linux-s390x": {+ "version": "0.35.3",+ "resolved": "https://registry.npmjs.org/@img/sharp-linux-s390x/-/sharp-linux-s390x-0.35.3.tgz",+ "integrity": "sha512-KgAxQ0DxpNOq1rG2t5cgTgShJFGSuU7XO45cqC+1NVOuZnP6tlgZRuSYOfNupGkHID0o3cJOsw4DVeJpMovcGw==",+ "cpu": [+ "s390x"+ ],+ "dev": true,+ "libc": [+ "glibc"+ ],+ "license": "Apache-2.0",+ "optional": true,+ "os": [+ "linux"+ ],+ "engines": {+ "node": ">=20.9.0"+ },+ "funding": {+ "url": "https://opencollective.com/libvips"+ },+ "optionalDependencies": {+ "@img/sharp-libvips-linux-s390x": "1.3.2"+ }+ },+ "node_modules/@img/sharp-linux-x64": {+ "version": "0.35.3",+ "resolved": "https://registry.npmjs.org/@img/sharp-linux-x64/-/sharp-linux-x64-0.35.3.tgz",+ "integrity": "sha512-8pqvxubL2PGdhlPy6GLqzDYMUjyRmKAwKHYKixpdJYBUK7PJ0C029XdsnpFIdgRZG68fZiGdHVWcKPvtiPB4cA==",+ "cpu": [+ "x64"+ ],+ "dev": true,+ "libc": [+ "glibc"+ ],+ "license": "Apache-2.0",+ "optional": true,+ "os": [+ "linux"+ ],+ "engines": {+ "node": ">=20.9.0"+ },+ "funding": {+ "url": "https://opencollective.com/libvips"+ },+ "optionalDependencies": {+ "@img/sharp-libvips-linux-x64": "1.3.2"+ }+ },+ "node_modules/@img/sharp-linuxmusl-arm64": {+ "version": "0.35.3",+ "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-arm64/-/sharp-linuxmusl-arm64-0.35.3.tgz",+ "integrity": "sha512-Vz0iQjzzcSX3HCbfwFfCSG/9SCIqyO0mH2sXyiHaAYfBk0cRsCWXRyQYX0ovCK/PAQBbTzQ0dsPQHh5MAFL59w==",+ "cpu": [+ "arm64"+ ],+ "dev": true,+ "libc": [+ "musl"+ ],+ "license": "Apache-2.0",+ "optional": true,+ "os": [+ "linux"+ ],+ "engines": {+ "node": ">=20.9.0"+ },+ "funding": {+ "url": "https://opencollective.com/libvips"+ },+ "optionalDependencies": {+ "@img/sharp-libvips-linuxmusl-arm64": "1.3.2"+ }+ },+ "node_modules/@img/sharp-linuxmusl-x64": {+ "version": "0.35.3",+ "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-x64/-/sharp-linuxmusl-x64-0.35.3.tgz",+ "integrity": "sha512-6O1NPKcDVj9QEdg7Hx549EX8U0rp6yXQERqru6yRN7fGBn32UvIRJUlWnk+8xDCiG76hXVBbX82NZ/ZKr0euIg==",+ "cpu": [+ "x64"+ ],+ "dev": true,+ "libc": [+ "musl"+ ],+ "license": "Apache-2.0",+ "optional": true,+ "os": [+ "linux"+ ],+ "engines": {+ "node": ">=20.9.0"+ },+ "funding": {+ "url": "https://opencollective.com/libvips"+ },+ "optionalDependencies": {+ "@img/sharp-libvips-linuxmusl-x64": "1.3.2"+ }+ },+ "node_modules/@img/sharp-wasm32": {+ "version": "0.35.3",+ "resolved": "https://registry.npmjs.org/@img/sharp-wasm32/-/sharp-wasm32-0.35.3.tgz",+ "integrity": "sha512-cZ0XkcYGpHZkqW6iCkqTcmUC0CD9DhD5d/qeZlZkfRBn6GnHniZXLUo5+9xw8Iv76YE6LQFN9YNBlKREcCG76w==",+ "dev": true,+ "license": "Apache-2.0 AND LGPL-3.0-or-later AND MIT",+ "optional": true,+ "dependencies": {+ "@emnapi/runtime": "^1.11.1"+ },+ "engines": {+ "node": ">=20.9.0"+ },+ "funding": {+ "url": "https://opencollective.com/libvips"+ }+ },+ "node_modules/@img/sharp-webcontainers-wasm32": {+ "version": "0.35.3",+ "resolved": "https://registry.npmjs.org/@img/sharp-webcontainers-wasm32/-/sharp-webcontainers-wasm32-0.35.3.tgz",+ "integrity": "sha512-2rnq7bX3NzeR2T4YWgz8qiG4h3TSdMe+vN1iQXpJleSJ3SM5zQ8Fy2SyyXAWlbxpEZ2Y+Z4u1BePgJEYbSy80Q==",+ "cpu": [+ "wasm32"+ ],+ "dev": true,+ "license": "Apache-2.0",+ "optional": true,+ "dependencies": {+ "@img/sharp-wasm32": "0.35.3"+ },+ "engines": {+ "node": ">=20.9.0"+ },+ "funding": {+ "url": "https://opencollective.com/libvips"+ }+ },+ "node_modules/@img/sharp-win32-arm64": {+ "version": "0.35.3",+ "resolved": "https://registry.npmjs.org/@img/sharp-win32-arm64/-/sharp-win32-arm64-0.35.3.tgz",+ "integrity": "sha512-4bPwFdMbeC4JQ8L8LOyWp6nsHcboP5fxkp6iPOXz2Vg49R42TuMs2whkJ5OAP4/Ul035qOzy0AecOF9VOscn4w==",+ "cpu": [+ "arm64"+ ],+ "dev": true,+ "license": "Apache-2.0 AND LGPL-3.0-or-later",+ "optional": true,+ "os": [+ "win32"+ ],+ "engines": {+ "node": ">=20.9.0"+ },+ "funding": {+ "url": "https://opencollective.com/libvips"+ }+ },+ "node_modules/@img/sharp-win32-ia32": {+ "version": "0.35.3",+ "resolved": "https://registry.npmjs.org/@img/sharp-win32-ia32/-/sharp-win32-ia32-0.35.3.tgz",+ "integrity": "sha512-r53mXsBN6lFUDiST764SvgwUdHAqM4rPAiDzAmf4fLoB6X/rkfyTrLCg6+g17wJJiCmB3JYgHuUldCWUIRFSXw==",+ "cpu": [+ "ia32"+ ],+ "dev": true,+ "license": "Apache-2.0 AND LGPL-3.0-or-later",+ "optional": true,+ "os": [+ "win32"+ ],+ "engines": {+ "node": "^20.9.0"+ },+ "funding": {+ "url": "https://opencollective.com/libvips"+ }+ },+ "node_modules/@img/sharp-win32-x64": {+ "version": "0.35.3",+ "resolved": "https://registry.npmjs.org/@img/sharp-win32-x64/-/sharp-win32-x64-0.35.3.tgz",+ "integrity": "sha512-D4y1vNeZrIIJCN+uHaWVtH86B+aCrdMYYjicy9pXHvbGZeGYLLSd3wdVuC37FxVXlU1ARsk84eKWfWMXGYEqvA==",+ "cpu": [+ "x64"+ ],+ "dev": true,+ "license": "Apache-2.0 AND LGPL-3.0-or-later",+ "optional": true,+ "os": [+ "win32"+ ],+ "engines": {+ "node": ">=20.9.0"+ },+ "funding": {+ "url": "https://opencollective.com/libvips"+ }+ },+ "node_modules/@isaacs/fs-minipass": {+ "version": "4.0.1",+ "resolved": "https://registry.npmjs.org/@isaacs/fs-minipass/-/fs-minipass-4.0.1.tgz",+ "integrity": "sha512-wgm9Ehl2jpeqP3zw/7mo3kRHFp5MEDhqAdwy1fTGkHAwnkGOVsgpvQhL8B5n1qlb01jV3n/bI0ZfZp5lWA1k4w==",+ "dev": true,+ "license": "ISC",+ "dependencies": {+ "minipass": "^7.0.4"+ },+ "engines": {+ "node": ">=18.0.0"+ }+ },+ "node_modules/@protobufjs/aspromise": {+ "version": "1.1.2",+ "resolved": "https://registry.npmjs.org/@protobufjs/aspromise/-/aspromise-1.1.2.tgz",+ "integrity": "sha512-j+gKExEuLmKwvz3OgROXtrJ2UG2x8Ch2YZUxahh+s1F2HZ+wAceUNLkvy6zKCPVRkU++ZWQrdxsUeQXmcg4uoQ==",+ "dev": true,+ "license": "BSD-3-Clause",+ "optional": true+ },+ "node_modules/@protobufjs/base64": {+ "version": "1.1.2",+ "resolved": "https://registry.npmjs.org/@protobufjs/base64/-/base64-1.1.2.tgz",+ "integrity": "sha512-AZkcAA5vnN/v4PDqKyMR5lx7hZttPDgClv83E//FMNhR2TMcLUhfRUBHCmSl0oi9zMgDDqRUJkSxO3wm85+XLg==",+ "dev": true,+ "license": "BSD-3-Clause",+ "optional": true+ },+ "node_modules/@protobufjs/codegen": {+ "version": "2.0.5",+ "resolved": "https://registry.npmjs.org/@protobufjs/codegen/-/codegen-2.0.5.tgz",+ "integrity": "sha512-zgXFLzW3Ap33e6d0Wlj4MGIm6Ce8O89n/apUaGNB/jx+hw+ruWEp7EwGUshdLKVRCxZW12fp9r40E1mQrf/34g==",+ "dev": true,+ "license": "BSD-3-Clause",+ "optional": true+ },+ "node_modules/@protobufjs/eventemitter": {+ "version": "1.1.1",+ "resolved": "https://registry.npmjs.org/@protobufjs/eventemitter/-/eventemitter-1.1.1.tgz",+ "integrity": "sha512-vW1GmwMZNnL+gMRaovlh9yZX74kc+TTU3FObkkurpMaRtBfLP3ldjS9KQWlwZgraRE0+dheEEoAxdzcJQ8eXZg==",+ "dev": true,+ "license": "BSD-3-Clause",+ "optional": true+ },+ "node_modules/@protobufjs/fetch": {+ "version": "1.1.1",+ "resolved": "https://registry.npmjs.org/@protobufjs/fetch/-/fetch-1.1.1.tgz",+ "integrity": "sha512-GpptLrs57adMSuHi3VNj0mAF8dwh36LMaYF6XyJ6JMWlVsc+t42tm1HSEDmOs3A8fC9yyeisgLhsTVQokOZ0zw==",+ "dev": true,+ "license": "BSD-3-Clause",+ "optional": true,+ "dependencies": {+ "@protobufjs/aspromise": "^1.1.1"+ }+ },+ "node_modules/@protobufjs/float": {+ "version": "1.0.2",+ "resolved": "https://registry.npmjs.org/@protobufjs/float/-/float-1.0.2.tgz",+ "integrity": "sha512-Ddb+kVXlXst9d+R9PfTIxh1EdNkgoRe5tOX6t01f1lYWOvJnSPDBlG241QLzcyPdoNTsblLUdujGSE4RzrTZGQ==",+ "dev": true,+ "license": "BSD-3-Clause",+ "optional": true+ },+ "node_modules/@protobufjs/path": {+ "version": "1.1.2",+ "resolved": "https://registry.npmjs.org/@protobufjs/path/-/path-1.1.2.tgz",+ "integrity": "sha512-6JOcJ5Tm08dOHAbdR3GrvP+yUUfkjG5ePsHYczMFLq3ZmMkAD98cDgcT2iA1lJ9NVwFd4tH/iSSoe44YWkltEA==",+ "dev": true,+ "license": "BSD-3-Clause",+ "optional": true+ },+ "node_modules/@protobufjs/pool": {+ "version": "1.1.0",+ "resolved": "https://registry.npmjs.org/@protobufjs/pool/-/pool-1.1.0.tgz",+ "integrity": "sha512-0kELaGSIDBKvcgS4zkjz1PeddatrjYcmMWOlAuAPwAeccUrPHdUqo/J6LiymHHEiJT5NrF1UVwxY14f+fy4WQw==",+ "dev": true,+ "license": "BSD-3-Clause",+ "optional": true+ },+ "node_modules/@protobufjs/utf8": {+ "version": "1.1.2",+ "resolved": "https://registry.npmjs.org/@protobufjs/utf8/-/utf8-1.1.2.tgz",+ "integrity": "sha512-b1UQwcEZ4yCnMCD8DAL1VlbvBJE9/IX4FTIp7BG1xYpf29SLazLSrqUkj4w7Y5y7cCVP6E5tcqqcI0xemPkHug==",+ "dev": true,+ "license": "BSD-3-Clause",+ "optional": true+ },+ "node_modules/@puppeteer/browsers": {+ "version": "3.2.0",+ "resolved": "https://registry.npmjs.org/@puppeteer/browsers/-/browsers-3.2.0.tgz",+ "integrity": "sha512-LlBrE8oqGfU7b1Nk2d5Q1SbuPhZxTj0cJEMDPEws28OjNMELlflekmPPuf4FnK03x0ZRjKaYwJElUcKK4kyqJA==",+ "dev": true,+ "license": "Apache-2.0",+ "dependencies": {+ "modern-tar": "^0.8.0",+ "yargs": "^18.0.0"+ },+ "bin": {+ "browsers": "lib/main-cli.js"+ },+ "engines": {+ "node": ">=22.12.0"+ },+ "peerDependencies": {+ "proxy-agent": ">=8.0.1",+ "yauzl": "^2.10.0 || ^3.4.0"+ },+ "peerDependenciesMeta": {+ "proxy-agent": {+ "optional": true+ },+ "yauzl": {+ "optional": true+ }+ }+ },+ "node_modules/@swc/helpers": {+ "version": "0.5.23",+ "resolved": "https://registry.npmjs.org/@swc/helpers/-/helpers-0.5.23.tgz",+ "integrity": "sha512-5lSsMOTXURePglDfvuAQUqkGek9Hg2kksOYay2m0+XR++b2NWYL/4sWyuvVBIs8oKnJaxkdi9whaL/sqN13afw==",+ "dev": true,+ "license": "Apache-2.0",+ "dependencies": {+ "tslib": "^2.8.0"+ }+ },+ "node_modules/@types/node": {+ "version": "26.2.0",+ "resolved": "https://registry.npmjs.org/@types/node/-/node-26.2.0.tgz",+ "integrity": "sha512-5IviulTZeRNp2vAJ514cc/HUlY5nZ9fCbq9DMyC52BrhFZACo3nI0R7qBxhQmo/d27NFe96ur/b7Wwxklda+kg==",+ "dev": true,+ "license": "MIT",+ "optional": true,+ "dependencies": {+ "undici-types": "~8.3.0"+ }+ },+ "node_modules/@types/retry": {+ "version": "0.12.0",+ "resolved": "https://registry.npmjs.org/@types/retry/-/retry-0.12.0.tgz",+ "integrity": "sha512-wWKOClTTiizcZhXnPY4wikVAwmdYHp8q6DmC+EJUzAMsycb7HB32Kh9RN4+0gExjmPmZSAQjgURXIGATPegAvA==",+ "dev": true,+ "license": "MIT",+ "optional": true+ },+ "node_modules/adm-zip": {+ "version": "0.6.0",+ "resolved": "https://registry.npmjs.org/adm-zip/-/adm-zip-0.6.0.tgz",+ "integrity": "sha512-XleryMhbuksdKtofnWZ9Sk+4CUTbms4Mb/EU32SZwToAyZ5RgVos/ki8n+yr0LWHOGKuakbXTuuYNHLQjhddgg==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">=14.0"+ }+ },+ "node_modules/agent-base": {+ "version": "7.1.4",+ "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-7.1.4.tgz",+ "integrity": "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ==",+ "dev": true,+ "license": "MIT",+ "optional": true,+ "engines": {+ "node": ">= 14"+ }+ },+ "node_modules/ansi-regex": {+ "version": "6.3.0",+ "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.3.0.tgz",+ "integrity": "sha512-WpDfL7NO6j7tH88IDBNVdUJxDh9nmCteAVW9dsep846XdwF4naCBK+/tGLX3KJgcpgMRXCFlTM2hKGoK9FsdrQ==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">=12"+ },+ "funding": {+ "url": "https://github.com/chalk/ansi-regex?sponsor=1"+ }+ },+ "node_modules/ansi-styles": {+ "version": "6.2.3",+ "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.3.tgz",+ "integrity": "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">=12"+ },+ "funding": {+ "url": "https://github.com/chalk/ansi-styles?sponsor=1"+ }+ },+ "node_modules/base64-js": {+ "version": "1.5.1",+ "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz",+ "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==",+ "dev": true,+ "funding": [+ {+ "type": "github",+ "url": "https://github.com/sponsors/feross"+ },+ {+ "type": "patreon",+ "url": "https://www.patreon.com/feross"+ },+ {+ "type": "consulting",+ "url": "https://feross.org/support"+ }+ ],+ "license": "MIT"+ },+ "node_modules/bignumber.js": {+ "version": "9.3.1",+ "resolved": "https://registry.npmjs.org/bignumber.js/-/bignumber.js-9.3.1.tgz",+ "integrity": "sha512-Ko0uX15oIUS7wJ3Rb30Fs6SkVbLmPBAKdlm7q9+ak9bbIeFf0MwuBsQV6z7+X768/cHsfg+WlysDWJcmthjsjQ==",+ "dev": true,+ "license": "MIT",+ "optional": true,+ "engines": {+ "node": "*"+ }+ },+ "node_modules/boolean": {+ "version": "3.2.0",+ "resolved": "https://registry.npmjs.org/boolean/-/boolean-3.2.0.tgz",+ "integrity": "sha512-d0II/GO9uf9lfUHH2BQsjxzRJZBdsjgsBiW4BvhWk/3qoKwQFjIDVN19PfX8F2D/r9PCMTtLWjYVCFrpeYUzsw==",+ "deprecated": "Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.",+ "dev": true,+ "license": "MIT"+ },+ "node_modules/brotli": {+ "version": "1.3.3",+ "resolved": "https://registry.npmjs.org/brotli/-/brotli-1.3.3.tgz",+ "integrity": "sha512-oTKjJdShmDuGW94SyyaoQvAjf30dZaHnjJ8uAF+u2/vGJkJbJPJAT1gDiOJP5v1Zb6f9KEyW/1HpuaWIXtGHPg==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "base64-js": "^1.1.2"+ }+ },+ "node_modules/buffer-equal-constant-time": {+ "version": "1.0.1",+ "resolved": "https://registry.npmjs.org/buffer-equal-constant-time/-/buffer-equal-constant-time-1.0.1.tgz",+ "integrity": "sha512-zRpUiDwd/xk6ADqPMATG8vc9VPrkck7T07OIx0gnjmJAnHnTVXNQG3vfvWNuiZIkwu9KrKdA1iJKfsfTVxE6NA==",+ "dev": true,+ "license": "BSD-3-Clause",+ "optional": true+ },+ "node_modules/bundle-name": {+ "version": "4.1.0",+ "resolved": "https://registry.npmjs.org/bundle-name/-/bundle-name-4.1.0.tgz",+ "integrity": "sha512-tjwM5exMg6BGRI+kNmTntNsvdZS1X8BFYS6tnJ2hdH0kVxM6/eVZ2xy+FqStSWvYmtfFMDLIxurorHwDKfDz5Q==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "run-applescript": "^7.0.0"+ },+ "engines": {+ "node": ">=18"+ },+ "funding": {+ "url": "https://github.com/sponsors/sindresorhus"+ }+ },+ "node_modules/chownr": {+ "version": "3.0.0",+ "resolved": "https://registry.npmjs.org/chownr/-/chownr-3.0.0.tgz",+ "integrity": "sha512-+IxzY9BZOQd/XuYPRmrvEVjF/nqj5kgT4kEq7VofrDoM1MxoRjEWkrCC3EtLi59TVawxTAn+orJwFQcrqEN1+g==",+ "dev": true,+ "license": "BlueOak-1.0.0",+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/chromium-bidi": {+ "version": "17.0.2",+ "resolved": "https://registry.npmjs.org/chromium-bidi/-/chromium-bidi-17.0.2.tgz",+ "integrity": "sha512-5v9GQFhTktFvotn/OFNJBmKLKRAb6n9r0bVCwf7sHgWc3/JryK0bj1nn93L3pHFrfgcsu6Be6EWsDi+1XHTGDg==",+ "dev": true,+ "license": "Apache-2.0",+ "dependencies": {+ "mitt": "^3.0.1",+ "zod": "^3.24.1"+ },+ "engines": {+ "node": ">=20.19.0 <22.0.0 || >=22.12.0"+ },+ "peerDependencies": {+ "devtools-protocol": "*"+ }+ },+ "node_modules/citty": {+ "version": "0.2.2",+ "resolved": "https://registry.npmjs.org/citty/-/citty-0.2.2.tgz",+ "integrity": "sha512-+6vJA3L98yv+IdfKGZHBNiGW5KHn22e/JwID0Strsz8h4S/csAu/OuICwxrg44k5MRiZHWIo8XXuJgQTriRP4w==",+ "dev": true,+ "license": "MIT"+ },+ "node_modules/cliui": {+ "version": "9.0.1",+ "resolved": "https://registry.npmjs.org/cliui/-/cliui-9.0.1.tgz",+ "integrity": "sha512-k7ndgKhwoQveBL+/1tqGJYNz097I7WOvwbmmU2AR5+magtbjPWQTS1C5vzGkBC8Ym8UWRzfKUzUUqFLypY4Q+w==",+ "dev": true,+ "license": "ISC",+ "dependencies": {+ "string-width": "^7.2.0",+ "strip-ansi": "^7.1.0",+ "wrap-ansi": "^9.0.0"+ },+ "engines": {+ "node": ">=20"+ }+ },+ "node_modules/cliui/node_modules/string-width": {+ "version": "7.2.0",+ "resolved": "https://registry.npmjs.org/string-width/-/string-width-7.2.0.tgz",+ "integrity": "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "emoji-regex": "^10.3.0",+ "get-east-asian-width": "^1.0.0",+ "strip-ansi": "^7.1.0"+ },+ "engines": {+ "node": ">=18"+ },+ "funding": {+ "url": "https://github.com/sponsors/sindresorhus"+ }+ },+ "node_modules/clone": {+ "version": "2.1.2",+ "resolved": "https://registry.npmjs.org/clone/-/clone-2.1.2.tgz",+ "integrity": "sha512-3Pe/CF1Nn94hyhIYpjtiLhdCoEoz0DqQ+988E9gmeEdQZlojxnOb74wctFyuwWQHzqyf9X7C7MG8juUpqBJT8w==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">=0.8"+ }+ },+ "node_modules/compare-versions": {+ "version": "6.1.1",+ "resolved": "https://registry.npmjs.org/compare-versions/-/compare-versions-6.1.1.tgz",+ "integrity": "sha512-4hm4VPpIecmlg59CHXnRDnqGplJFrbLG4aFEl5vl6cK1u76ws3LLvX7ikFnTDl5vo39sjWD6AaDPYodJp/NNHg==",+ "dev": true,+ "license": "MIT"+ },+ "node_modules/data-uri-to-buffer": {+ "version": "4.0.1",+ "resolved": "https://registry.npmjs.org/data-uri-to-buffer/-/data-uri-to-buffer-4.0.1.tgz",+ "integrity": "sha512-0R9ikRb668HB7QDxT1vkpuUBtqc53YyAwMwGeUFKRojY/NWKvdZ+9UYtRfGmhqNbRkTSVpMbmyhXipFFv2cb/A==",+ "dev": true,+ "license": "MIT",+ "optional": true,+ "engines": {+ "node": ">= 12"+ }+ },+ "node_modules/debug": {+ "version": "4.4.3",+ "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",+ "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "ms": "^2.1.3"+ },+ "engines": {+ "node": ">=6.0"+ },+ "peerDependenciesMeta": {+ "supports-color": {+ "optional": true+ }+ }+ },+ "node_modules/default-browser": {+ "version": "5.5.0",+ "resolved": "https://registry.npmjs.org/default-browser/-/default-browser-5.5.0.tgz",+ "integrity": "sha512-H9LMLr5zwIbSxrmvikGuI/5KGhZ8E2zH3stkMgM5LpOWDutGM2JZaj460Udnf1a+946zc7YBgrqEWwbk7zHvGw==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "bundle-name": "^4.1.0",+ "default-browser-id": "^5.0.0"+ },+ "engines": {+ "node": ">=18"+ },+ "funding": {+ "url": "https://github.com/sponsors/sindresorhus"+ }+ },+ "node_modules/default-browser-id": {+ "version": "5.0.1",+ "resolved": "https://registry.npmjs.org/default-browser-id/-/default-browser-id-5.0.1.tgz",+ "integrity": "sha512-x1VCxdX4t+8wVfd1so/9w+vQ4vx7lKd2Qp5tDRutErwmR85OgmfX7RlLRMWafRMY7hbEiXIbudNrjOAPa/hL8Q==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">=18"+ },+ "funding": {+ "url": "https://github.com/sponsors/sindresorhus"+ }+ },+ "node_modules/define-data-property": {+ "version": "1.1.4",+ "resolved": "https://registry.npmjs.org/define-data-property/-/define-data-property-1.1.4.tgz",+ "integrity": "sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "es-define-property": "^1.0.0",+ "es-errors": "^1.3.0",+ "gopd": "^1.0.1"+ },+ "engines": {+ "node": ">= 0.4"+ },+ "funding": {+ "url": "https://github.com/sponsors/ljharb"+ }+ },+ "node_modules/define-lazy-prop": {+ "version": "3.0.0",+ "resolved": "https://registry.npmjs.org/define-lazy-prop/-/define-lazy-prop-3.0.0.tgz",+ "integrity": "sha512-N+MeXYoqr3pOgn8xfyRPREN7gHakLYjhsHhWGT3fWAiL4IkAt0iDw14QiiEm2bE30c5XX5q0FtAA3CK5f9/BUg==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">=12"+ },+ "funding": {+ "url": "https://github.com/sponsors/sindresorhus"+ }+ },+ "node_modules/define-properties": {+ "version": "1.2.1",+ "resolved": "https://registry.npmjs.org/define-properties/-/define-properties-1.2.1.tgz",+ "integrity": "sha512-8QmQKqEASLd5nx0U1B1okLElbUuuttJ/AnYmRXbbbGDWh6uS208EjD4Xqq/I9wK7u0v6O08XhTWnt5XtEbR6Dg==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "define-data-property": "^1.0.1",+ "has-property-descriptors": "^1.0.0",+ "object-keys": "^1.1.1"+ },+ "engines": {+ "node": ">= 0.4"+ },+ "funding": {+ "url": "https://github.com/sponsors/ljharb"+ }+ },+ "node_modules/detect-libc": {+ "version": "2.1.2",+ "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz",+ "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==",+ "dev": true,+ "license": "Apache-2.0",+ "engines": {+ "node": ">=8"+ }+ },+ "node_modules/detect-node": {+ "version": "2.1.0",+ "resolved": "https://registry.npmjs.org/detect-node/-/detect-node-2.1.0.tgz",+ "integrity": "sha512-T0NIuQpnTvFDATNuHN5roPwSBG83rFsuO+MXXH9/3N1eFbn4wcPjttvjMLEPWJ0RGUYgQE7cGgS3tNxbqCGM7g==",+ "dev": true,+ "license": "MIT"+ },+ "node_modules/devtools-protocol": {+ "version": "0.0.1666840",+ "resolved": "https://registry.npmjs.org/devtools-protocol/-/devtools-protocol-0.0.1666840.tgz",+ "integrity": "sha512-gCcO42XCHKEs7Ag0S7aGYsnJ7hlgrO3qderYqeiY0Eqk+0GFfuvT13IA0hHreJTa2KCdDVyGMeOhdMNmrrTjVg==",+ "dev": true,+ "license": "BSD-3-Clause"+ },+ "node_modules/dfa": {+ "version": "1.2.0",+ "resolved": "https://registry.npmjs.org/dfa/-/dfa-1.2.0.tgz",+ "integrity": "sha512-ED3jP8saaweFTjeGX8HQPjeC1YYyZs98jGNZx6IiBvxW7JG5v492kamAQB3m2wop07CvU/RQmzcKr6bgcC5D/Q==",+ "dev": true,+ "license": "MIT"+ },+ "node_modules/ecdsa-sig-formatter": {+ "version": "1.0.11",+ "resolved": "https://registry.npmjs.org/ecdsa-sig-formatter/-/ecdsa-sig-formatter-1.0.11.tgz",+ "integrity": "sha512-nagl3RYrbNv6kQkeJIpt6NJZy8twLB/2vtz6yN9Z4vRKHN4/QZJIEbqohALSgwKdnksuY3k5Addp5lg8sVoVcQ==",+ "dev": true,+ "license": "Apache-2.0",+ "optional": true,+ "dependencies": {+ "safe-buffer": "^5.0.1"+ }+ },+ "node_modules/emoji-regex": {+ "version": "10.6.0",+ "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-10.6.0.tgz",+ "integrity": "sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A==",+ "dev": true,+ "license": "MIT"+ },+ "node_modules/es-define-property": {+ "version": "1.0.1",+ "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",+ "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">= 0.4"+ }+ },+ "node_modules/es-errors": {+ "version": "1.3.0",+ "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",+ "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">= 0.4"+ }+ },+ "node_modules/es6-error": {+ "version": "4.1.1",+ "resolved": "https://registry.npmjs.org/es6-error/-/es6-error-4.1.1.tgz",+ "integrity": "sha512-Um/+FxMr9CISWh0bi5Zv0iOD+4cFh5qLeks1qhAopKVAJw3drgKbKySikp7wGhDL0HPeaja0P5ULZrxLkniUVg==",+ "dev": true,+ "license": "MIT"+ },+ "node_modules/esbuild": {+ "version": "0.25.12",+ "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.25.12.tgz",+ "integrity": "sha512-bbPBYYrtZbkt6Os6FiTLCTFxvq4tt3JKall1vRwshA3fdVztsLAatFaZobhkBC8/BrPetoa0oksYoKXoG4ryJg==",+ "dev": true,+ "hasInstallScript": true,+ "license": "MIT",+ "bin": {+ "esbuild": "bin/esbuild"+ },+ "engines": {+ "node": ">=18"+ },+ "optionalDependencies": {+ "@esbuild/aix-ppc64": "0.25.12",+ "@esbuild/android-arm": "0.25.12",+ "@esbuild/android-arm64": "0.25.12",+ "@esbuild/android-x64": "0.25.12",+ "@esbuild/darwin-arm64": "0.25.12",+ "@esbuild/darwin-x64": "0.25.12",+ "@esbuild/freebsd-arm64": "0.25.12",+ "@esbuild/freebsd-x64": "0.25.12",+ "@esbuild/linux-arm": "0.25.12",+ "@esbuild/linux-arm64": "0.25.12",+ "@esbuild/linux-ia32": "0.25.12",+ "@esbuild/linux-loong64": "0.25.12",+ "@esbuild/linux-mips64el": "0.25.12",+ "@esbuild/linux-ppc64": "0.25.12",+ "@esbuild/linux-riscv64": "0.25.12",+ "@esbuild/linux-s390x": "0.25.12",+ "@esbuild/linux-x64": "0.25.12",+ "@esbuild/netbsd-arm64": "0.25.12",+ "@esbuild/netbsd-x64": "0.25.12",+ "@esbuild/openbsd-arm64": "0.25.12",+ "@esbuild/openbsd-x64": "0.25.12",+ "@esbuild/openharmony-arm64": "0.25.12",+ "@esbuild/sunos-x64": "0.25.12",+ "@esbuild/win32-arm64": "0.25.12",+ "@esbuild/win32-ia32": "0.25.12",+ "@esbuild/win32-x64": "0.25.12"+ }+ },+ "node_modules/escalade": {+ "version": "3.2.0",+ "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz",+ "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">=6"+ }+ },+ "node_modules/escape-string-regexp": {+ "version": "4.0.0",+ "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz",+ "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">=10"+ },+ "funding": {+ "url": "https://github.com/sponsors/sindresorhus"+ }+ },+ "node_modules/extend": {+ "version": "3.0.2",+ "resolved": "https://registry.npmjs.org/extend/-/extend-3.0.2.tgz",+ "integrity": "sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g==",+ "dev": true,+ "license": "MIT",+ "optional": true+ },+ "node_modules/fast-deep-equal": {+ "version": "3.1.3",+ "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",+ "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==",+ "dev": true,+ "license": "MIT"+ },+ "node_modules/fetch-blob": {+ "version": "3.2.0",+ "resolved": "https://registry.npmjs.org/fetch-blob/-/fetch-blob-3.2.0.tgz",+ "integrity": "sha512-7yAQpD2UMJzLi1Dqv7qFYnPbaPx7ZfFK6PiIxQ4PfkGPyNyl2Ugx+a/umUonmKqjhM4DnfbMvdX6otXq83soQQ==",+ "dev": true,+ "funding": [+ {+ "type": "github",+ "url": "https://github.com/sponsors/jimmywarting"+ },+ {+ "type": "paypal",+ "url": "https://paypal.me/jimmywarting"+ }+ ],+ "license": "MIT",+ "optional": true,+ "dependencies": {+ "node-domexception": "^1.0.0",+ "web-streams-polyfill": "^3.0.3"+ },+ "engines": {+ "node": "^12.20 || >= 14.13"+ }+ },+ "node_modules/fontkit": {+ "version": "2.0.4",+ "resolved": "https://registry.npmjs.org/fontkit/-/fontkit-2.0.4.tgz",+ "integrity": "sha512-syetQadaUEDNdxdugga9CpEYVaQIxOwk7GlwZWWZ19//qW4zE5bknOKeMBDYAASwnpaSHKJITRLMF9m1fp3s6g==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "@swc/helpers": "^0.5.12",+ "brotli": "^1.3.2",+ "clone": "^2.1.2",+ "dfa": "^1.2.0",+ "fast-deep-equal": "^3.1.3",+ "restructure": "^3.0.0",+ "tiny-inflate": "^1.0.3",+ "unicode-properties": "^1.4.0",+ "unicode-trie": "^2.0.0"+ }+ },+ "node_modules/formdata-polyfill": {+ "version": "4.0.10",+ "resolved": "https://registry.npmjs.org/formdata-polyfill/-/formdata-polyfill-4.0.10.tgz",+ "integrity": "sha512-buewHzMvYL29jdeQTVILecSaZKnt/RJWjoZCF5OW60Z67/GmSLBkOFM7qh1PI3zFNtJbaZL5eQu1vLfazOwj4g==",+ "dev": true,+ "license": "MIT",+ "optional": true,+ "dependencies": {+ "fetch-blob": "^3.1.2"+ },+ "engines": {+ "node": ">=12.20.0"+ }+ },+ "node_modules/gaxios": {+ "version": "7.3.1",+ "resolved": "https://registry.npmjs.org/gaxios/-/gaxios-7.3.1.tgz",+ "integrity": "sha512-kB3rzJV7d9juLZh8/56QTXCwQfxyhdOMdyYk1HdQKFtF8TJTDTZQJtixWIwXdE9Jji91mC41DUNpjleo4L4eAQ==",+ "dev": true,+ "license": "Apache-2.0",+ "optional": true,+ "dependencies": {+ "extend": "^3.0.2",+ "https-proxy-agent": "^7.0.1",+ "node-fetch": "^3.3.2"+ },+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/gcp-metadata": {+ "version": "8.1.2",+ "resolved": "https://registry.npmjs.org/gcp-metadata/-/gcp-metadata-8.1.2.tgz",+ "integrity": "sha512-zV/5HKTfCeKWnxG0Dmrw51hEWFGfcF2xiXqcA3+J90WDuP0SvoiSO5ORvcBsifmx/FoIjgQN3oNOGaQ5PhLFkg==",+ "dev": true,+ "license": "Apache-2.0",+ "optional": true,+ "dependencies": {+ "gaxios": "^7.0.0",+ "google-logging-utils": "^1.0.0",+ "json-bigint": "^1.0.0"+ },+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/get-caller-file": {+ "version": "2.0.5",+ "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz",+ "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==",+ "dev": true,+ "license": "ISC",+ "engines": {+ "node": "6.* || 8.* || >= 10.*"+ }+ },+ "node_modules/get-east-asian-width": {+ "version": "1.6.0",+ "resolved": "https://registry.npmjs.org/get-east-asian-width/-/get-east-asian-width-1.6.0.tgz",+ "integrity": "sha512-QRbvDIbx6YklUe6RxeTeleMR0yv3cYH6PsPZHcnVn7xv7zO1BHN8r0XETu8n6Ye3Q+ahtSarc3WgtNWmehIBfA==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">=18"+ },+ "funding": {+ "url": "https://github.com/sponsors/sindresorhus"+ }+ },+ "node_modules/giget": {+ "version": "3.3.1",+ "resolved": "https://registry.npmjs.org/giget/-/giget-3.3.1.tgz",+ "integrity": "sha512-r+mvuDjrjMpsdw46Kmeydb8bdHm7wOKw8wNBtTndkjbPjgAp5oUJUxRE76wZFknxIPokfWvep2qSXK37aXE6zg==",+ "dev": true,+ "license": "MIT",+ "bin": {+ "giget": "dist/cli.mjs"+ }+ },+ "node_modules/global-agent": {+ "version": "3.0.0",+ "resolved": "https://registry.npmjs.org/global-agent/-/global-agent-3.0.0.tgz",+ "integrity": "sha512-PT6XReJ+D07JvGoxQMkT6qji/jVNfX/h364XHZOWeRzy64sSFr+xJ5OX7LI3b4MPQzdL4H8Y8M0xzPpsVMwA8Q==",+ "dev": true,+ "license": "BSD-3-Clause",+ "dependencies": {+ "boolean": "^3.0.1",+ "es6-error": "^4.1.1",+ "matcher": "^3.0.0",+ "roarr": "^2.15.3",+ "semver": "^7.3.2",+ "serialize-error": "^7.0.1"+ },+ "engines": {+ "node": ">=10.0"+ }+ },+ "node_modules/globalthis": {+ "version": "1.0.4",+ "resolved": "https://registry.npmjs.org/globalthis/-/globalthis-1.0.4.tgz",+ "integrity": "sha512-DpLKbNU4WylpxJykQujfCcwYWiV/Jhm50Goo0wrVILAv5jOr9d+H+UR3PhSCD2rCCEIg0uc+G+muBTwD54JhDQ==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "define-properties": "^1.2.1",+ "gopd": "^1.0.1"+ },+ "engines": {+ "node": ">= 0.4"+ },+ "funding": {+ "url": "https://github.com/sponsors/ljharb"+ }+ },+ "node_modules/google-auth-library": {+ "version": "10.9.1",+ "resolved": "https://registry.npmjs.org/google-auth-library/-/google-auth-library-10.9.1.tgz",+ "integrity": "sha512-i1ydyHrqcIxXkWh/uBmVkzCvIuq5yiK2ATndIe5XxKholrG/MTYP9xGYka4sQhrbIAgGjL2B6NOE7rFaiF3fXw==",+ "dev": true,+ "license": "Apache-2.0",+ "optional": true,+ "dependencies": {+ "base64-js": "^1.3.0",+ "ecdsa-sig-formatter": "^1.0.11",+ "gaxios": "^7.1.4",+ "gcp-metadata": "8.1.2",+ "google-logging-utils": "1.1.3",+ "jws": "^4.0.0"+ },+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/google-logging-utils": {+ "version": "1.1.3",+ "resolved": "https://registry.npmjs.org/google-logging-utils/-/google-logging-utils-1.1.3.tgz",+ "integrity": "sha512-eAmLkjDjAFCVXg7A1unxHsLf961m6y17QFqXqAXGj/gVkKFrEICfStRfwUlGNfeCEjNRa32JEWOUTlYXPyyKvA==",+ "dev": true,+ "license": "Apache-2.0",+ "optional": true,+ "engines": {+ "node": ">=14"+ }+ },+ "node_modules/gopd": {+ "version": "1.2.0",+ "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",+ "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">= 0.4"+ },+ "funding": {+ "url": "https://github.com/sponsors/ljharb"+ }+ },+ "node_modules/gsap": {+ "version": "3.14.2",+ "resolved": "https://registry.npmjs.org/gsap/-/gsap-3.14.2.tgz",+ "integrity": "sha512-P8/mMxVLU7o4+55+1TCnQrPmgjPKnwkzkXOK1asnR9Jg2lna4tEY5qBJjMmAaOBDDZWtlRjBXjLa0w53G/uBLA==",+ "dev": true,+ "license": "Standard 'no charge' license: https://gsap.com/standard-license."+ },+ "node_modules/has-property-descriptors": {+ "version": "1.0.2",+ "resolved": "https://registry.npmjs.org/has-property-descriptors/-/has-property-descriptors-1.0.2.tgz",+ "integrity": "sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "es-define-property": "^1.0.0"+ },+ "funding": {+ "url": "https://github.com/sponsors/ljharb"+ }+ },+ "node_modules/hono": {+ "version": "4.13.2",+ "resolved": "https://registry.npmjs.org/hono/-/hono-4.13.2.tgz",+ "integrity": "sha512-JydRilDRkYBQMt9qR9U92mXxmbGqsqSn/IKOrh4e7/gEbn+0zSr8igTu0obwJoNGN4sez28DIql7FBHWydoJpA==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">=16.9.0"+ }+ },+ "node_modules/https-proxy-agent": {+ "version": "7.0.6",+ "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-7.0.6.tgz",+ "integrity": "sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw==",+ "dev": true,+ "license": "MIT",+ "optional": true,+ "dependencies": {+ "agent-base": "^7.1.2",+ "debug": "4"+ },+ "engines": {+ "node": ">= 14"+ }+ },+ "node_modules/hyperframes": {+ "version": "0.7.109",+ "resolved": "https://registry.npmjs.org/hyperframes/-/hyperframes-0.7.109.tgz",+ "integrity": "sha512-VFvaPUPka7/rWpq/CGmH+7tTHFQwGMQ/76ihCHnRA7QC8CbtfGqxYFKZ4YhnDK879uxew72uFW7ImC8v6VaJ1w==",+ "dev": true,+ "license": "Apache-2.0",+ "dependencies": {+ "@hono/node-server": "^2.0.5",+ "@puppeteer/browsers": "^3.0.6",+ "adm-zip": "^0.6.0",+ "citty": "^0.2.1",+ "compare-versions": "^6.1.1",+ "debug": "^4.4.0",+ "esbuild": "^0.25.12",+ "fontkit": "^2.0.4",+ "giget": "^3.2.0",+ "hono": "^4.0.0",+ "ignore": "^5.3.2",+ "onnxruntime-node": "1.21.1",+ "open": "^10.0.0",+ "postcss": "^8.5.8",+ "prettier": "^3.8.1",+ "puppeteer-core": "^25.2.1",+ "sharp": "^0.35.0"+ },+ "bin": {+ "hyperframes": "bin/hyperframes.mjs"+ },+ "engines": {+ "node": ">=22"+ },+ "optionalDependencies": {+ "@google/genai": "^1.50.1"+ }+ },+ "node_modules/ignore": {+ "version": "5.3.2",+ "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz",+ "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">= 4"+ }+ },+ "node_modules/is-docker": {+ "version": "3.0.0",+ "resolved": "https://registry.npmjs.org/is-docker/-/is-docker-3.0.0.tgz",+ "integrity": "sha512-eljcgEDlEns/7AXFosB5K/2nCM4P7FQPkGc/DWLy5rmFEWvZayGrik1d9/QIY5nJ4f9YsVvBkA6kJpHn9rISdQ==",+ "dev": true,+ "license": "MIT",+ "bin": {+ "is-docker": "cli.js"+ },+ "engines": {+ "node": "^12.20.0 || ^14.13.1 || >=16.0.0"+ },+ "funding": {+ "url": "https://github.com/sponsors/sindresorhus"+ }+ },+ "node_modules/is-inside-container": {+ "version": "1.0.0",+ "resolved": "https://registry.npmjs.org/is-inside-container/-/is-inside-container-1.0.0.tgz",+ "integrity": "sha512-KIYLCCJghfHZxqjYBE7rEy0OBuTd5xCHS7tHVgvCLkx7StIoaxwNW3hCALgEUjFfeRk+MG/Qxmp/vtETEF3tRA==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "is-docker": "^3.0.0"+ },+ "bin": {+ "is-inside-container": "cli.js"+ },+ "engines": {+ "node": ">=14.16"+ },+ "funding": {+ "url": "https://github.com/sponsors/sindresorhus"+ }+ },+ "node_modules/is-wsl": {+ "version": "3.1.1",+ "resolved": "https://registry.npmjs.org/is-wsl/-/is-wsl-3.1.1.tgz",+ "integrity": "sha512-e6rvdUCiQCAuumZslxRJWR/Doq4VpPR82kqclvcS0efgt430SlGIk05vdCN58+VrzgtIcfNODjozVielycD4Sw==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "is-inside-container": "^1.0.0"+ },+ "engines": {+ "node": ">=16"+ },+ "funding": {+ "url": "https://github.com/sponsors/sindresorhus"+ }+ },+ "node_modules/json-bigint": {+ "version": "1.0.0",+ "resolved": "https://registry.npmjs.org/json-bigint/-/json-bigint-1.0.0.tgz",+ "integrity": "sha512-SiPv/8VpZuWbvLSMtTDU8hEfrZWg/mH/nV/b4o0CYbSxu1UIQPLdwKOCIyLQX+VIPO5vrLX3i8qtqFyhdPSUSQ==",+ "dev": true,+ "license": "MIT",+ "optional": true,+ "dependencies": {+ "bignumber.js": "^9.0.0"+ }+ },+ "node_modules/json-stringify-safe": {+ "version": "5.0.1",+ "resolved": "https://registry.npmjs.org/json-stringify-safe/-/json-stringify-safe-5.0.1.tgz",+ "integrity": "sha512-ZClg6AaYvamvYEE82d3Iyd3vSSIjQ+odgjaTzRuO3s7toCdFKczob2i0zCh7JE8kWn17yvAWhUVxvqGwUalsRA==",+ "dev": true,+ "license": "ISC"+ },+ "node_modules/jwa": {+ "version": "2.0.1",+ "resolved": "https://registry.npmjs.org/jwa/-/jwa-2.0.1.tgz",+ "integrity": "sha512-hRF04fqJIP8Abbkq5NKGN0Bbr3JxlQ+qhZufXVr0DvujKy93ZCbXZMHDL4EOtodSbCWxOqR8MS1tXA5hwqCXDg==",+ "dev": true,+ "license": "MIT",+ "optional": true,+ "dependencies": {+ "buffer-equal-constant-time": "^1.0.1",+ "ecdsa-sig-formatter": "1.0.11",+ "safe-buffer": "^5.0.1"+ }+ },+ "node_modules/jws": {+ "version": "4.0.1",+ "resolved": "https://registry.npmjs.org/jws/-/jws-4.0.1.tgz",+ "integrity": "sha512-EKI/M/yqPncGUUh44xz0PxSidXFr/+r0pA70+gIYhjv+et7yxM+s29Y+VGDkovRofQem0fs7Uvf4+YmAdyRduA==",+ "dev": true,+ "license": "MIT",+ "optional": true,+ "dependencies": {+ "jwa": "^2.0.1",+ "safe-buffer": "^5.0.1"+ }+ },+ "node_modules/long": {+ "version": "5.3.2",+ "resolved": "https://registry.npmjs.org/long/-/long-5.3.2.tgz",+ "integrity": "sha512-mNAgZ1GmyNhD7AuqnTG3/VQ26o760+ZYBPKjPvugO8+nLbYfX6TVpJPseBvopbdY+qpZ/lKUnmEc1LeZYS3QAA==",+ "dev": true,+ "license": "Apache-2.0",+ "optional": true+ },+ "node_modules/matcher": {+ "version": "3.0.0",+ "resolved": "https://registry.npmjs.org/matcher/-/matcher-3.0.0.tgz",+ "integrity": "sha512-OkeDaAZ/bQCxeFAozM55PKcKU0yJMPGifLwV4Qgjitu+5MoAfSQN4lsLJeXZ1b8w0x+/Emda6MZgXS1jvsapng==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "escape-string-regexp": "^4.0.0"+ },+ "engines": {+ "node": ">=10"+ }+ },+ "node_modules/minipass": {+ "version": "7.1.3",+ "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.1.3.tgz",+ "integrity": "sha512-tEBHqDnIoM/1rXME1zgka9g6Q2lcoCkxHLuc7ODJ5BxbP5d4c2Z5cGgtXAku59200Cx7diuHTOYfSBD8n6mm8A==",+ "dev": true,+ "license": "BlueOak-1.0.0",+ "engines": {+ "node": ">=16 || 14 >=14.17"+ }+ },+ "node_modules/minizlib": {+ "version": "3.1.0",+ "resolved": "https://registry.npmjs.org/minizlib/-/minizlib-3.1.0.tgz",+ "integrity": "sha512-KZxYo1BUkWD2TVFLr0MQoM8vUUigWD3LlD83a/75BqC+4qE0Hb1Vo5v1FgcfaNXvfXzr+5EhQ6ing/CaBijTlw==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "minipass": "^7.1.2"+ },+ "engines": {+ "node": ">= 18"+ }+ },+ "node_modules/mitt": {+ "version": "3.0.1",+ "resolved": "https://registry.npmjs.org/mitt/-/mitt-3.0.1.tgz",+ "integrity": "sha512-vKivATfr97l2/QBCYAkXYDbrIWPM2IIKEl7YPhjCvKlG3kE2gm+uBo6nEXK3M5/Ffh/FLpKExzOQ3JJoJGFKBw==",+ "dev": true,+ "license": "MIT"+ },+ "node_modules/modern-tar": {+ "version": "0.8.4",+ "resolved": "https://registry.npmjs.org/modern-tar/-/modern-tar-0.8.4.tgz",+ "integrity": "sha512-gN54ddmyzEg10orwZ2u4OOv+bjpMWdIl5jIkodK97bMq8QBSL5c0D7YX0lT1Ooz+99S7+PvFbnxzdjgHo1r41g==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">=18.0.0"+ }+ },+ "node_modules/ms": {+ "version": "2.1.3",+ "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",+ "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",+ "dev": true,+ "license": "MIT"+ },+ "node_modules/nanoid": {+ "version": "3.3.18",+ "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.18.tgz",+ "integrity": "sha512-DTg4MJbGMWkfi6VZFdNt2/caMbQy4Ou+Op/hJQvGEWcnVfoA1QA+xzRKAzw9jD6+GVOOeYr/mIcuDSdug6F6+w==",+ "dev": true,+ "funding": [+ {+ "type": "github",+ "url": "https://github.com/sponsors/ai"+ }+ ],+ "license": "MIT",+ "bin": {+ "nanoid": "bin/nanoid.cjs"+ },+ "engines": {+ "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"+ }+ },+ "node_modules/node-domexception": {"version": "1.0.0",- "license": "ISC",- "devDependencies": {- "playwright": "^1.59.1"+ "resolved": "https://registry.npmjs.org/node-domexception/-/node-domexception-1.0.0.tgz",+ "integrity": "sha512-/jKZoMpw0F8GRwl4/eLROPA3cfcXtLApP0QzLmUT/HuPCZWyB7IY9ZrMeKw2O/nFIqPQB3PVM9aYm0F312AXDQ==",+ "deprecated": "Use your platform's native DOMException instead",+ "dev": true,+ "funding": [+ {+ "type": "github",+ "url": "https://github.com/sponsors/jimmywarting"+ },+ {+ "type": "github",+ "url": "https://paypal.me/jimmywarting"+ }+ ],+ "license": "MIT",+ "optional": true,+ "engines": {+ "node": ">=10.5.0"}},- "node_modules/fsevents": {- "version": "2.3.2",- "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.2.tgz",- "integrity": "sha512-xiqMQR4xAeHTuB9uWm+fFRcIOgKBMiOBP+eXiyT7jsgVCq1bkVygt00oASowB7EdtpOHaaPgKt812P9ab+DDKA==",+ "node_modules/node-fetch": {+ "version": "3.3.2",+ "resolved": "https://registry.npmjs.org/node-fetch/-/node-fetch-3.3.2.tgz",+ "integrity": "sha512-dRB78srN/l6gqWulah9SrxeYnxeddIG30+GOqK/9OlLVyLg3HPnr6SqOWTWOXKRwC2eGYCkZ59NNuSgvSrpgOA==","dev": true,- "hasInstallScript": true,"license": "MIT","optional": true,+ "dependencies": {+ "data-uri-to-buffer": "^4.0.0",+ "fetch-blob": "^3.1.4",+ "formdata-polyfill": "^4.0.10"+ },+ "engines": {+ "node": "^12.20.0 || ^14.13.1 || >=16.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/node-fetch"+ }+ },+ "node_modules/object-keys": {+ "version": "1.1.1",+ "resolved": "https://registry.npmjs.org/object-keys/-/object-keys-1.1.1.tgz",+ "integrity": "sha512-NuAESUOUMrlIXOfHKzD6bpPu3tYt3xvjNdRIQ+FeT0lNb4K8WR70CaDxhuNguS2XG+GjkyMwOzsN5ZktImfhLA==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">= 0.4"+ }+ },+ "node_modules/onnxruntime-common": {+ "version": "1.21.1",+ "resolved": "https://registry.npmjs.org/onnxruntime-common/-/onnxruntime-common-1.21.1.tgz",+ "integrity": "sha512-E0q8+fMyJ+F8dvlwVsXcujrOc96lkPIDAZh3p6pjrZS4bzjowIcUMv48W5zOcFLtlWyycUlRPJWUUK2+3IL1eA==",+ "dev": true,+ "license": "MIT"+ },+ "node_modules/onnxruntime-node": {+ "version": "1.21.1",+ "resolved": "https://registry.npmjs.org/onnxruntime-node/-/onnxruntime-node-1.21.1.tgz",+ "integrity": "sha512-YThL/YYeGAeytecOvRcTKUORTIE2f8/iSo/JZgHFawWrV4zOY7fWLEaNuscgjmY5C5/VE/Wr7tm+ucSsc/AysQ==",+ "dev": true,+ "hasInstallScript": true,+ "license": "MIT","os": [- "darwin"+ "win32",+ "darwin",+ "linux"],+ "dependencies": {+ "global-agent": "^3.0.0",+ "onnxruntime-common": "1.21.1",+ "tar": "^7.0.1"+ }+ },+ "node_modules/open": {+ "version": "10.2.0",+ "resolved": "https://registry.npmjs.org/open/-/open-10.2.0.tgz",+ "integrity": "sha512-YgBpdJHPyQ2UE5x+hlSXcnejzAvD0b22U2OuAP+8OnlJT+PjWPxtgmGqKKc+RgTM63U9gN0YzrYc71R2WT/hTA==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "default-browser": "^5.2.1",+ "define-lazy-prop": "^3.0.0",+ "is-inside-container": "^1.0.0",+ "wsl-utils": "^0.1.0"+ },+ "engines": {+ "node": ">=18"+ },+ "funding": {+ "url": "https://github.com/sponsors/sindresorhus"+ }+ },+ "node_modules/p-retry": {+ "version": "4.6.2",+ "resolved": "https://registry.npmjs.org/p-retry/-/p-retry-4.6.2.tgz",+ "integrity": "sha512-312Id396EbJdvRONlngUx0NydfrIQ5lsYu0znKVUzVvArzEIt08V1qhtyESbGVd1FGX7UKtiFp5uwKZdM8wIuQ==",+ "dev": true,+ "license": "MIT",+ "optional": true,+ "dependencies": {+ "@types/retry": "0.12.0",+ "retry": "^0.13.1"+ },"engines": {- "node": "^8.16.0 || ^10.6.0 || >=11.0.0"+ "node": ">=8"}},+ "node_modules/pako": {+ "version": "0.2.9",+ "resolved": "https://registry.npmjs.org/pako/-/pako-0.2.9.tgz",+ "integrity": "sha512-NUcwaKxUxWrZLpDG+z/xZaCgQITkA/Dv4V/T6bw7VON6l1Xz/VnrBqrYjZQ12TamKHzITTfOEIYUj48y2KXImA==",+ "dev": true,+ "license": "MIT"+ },+ "node_modules/picocolors": {+ "version": "1.1.1",+ "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",+ "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",+ "dev": true,+ "license": "ISC"+ },+ "node_modules/playwright": {- "version": "1.59.1",- "resolved": "https://registry.npmjs.org/playwright/-/playwright-1.59.1.tgz",- "integrity": "sha512-C8oWjPR3F81yljW9o5OxcWzfh6avkVwDD2VYdwIGqTkl+OGFISgypqzfu7dOe4QNLL2aqcWBmI3PMtLIK233lw==",++ "version": "1.63.0",++ "resolved": "https://registry.npmjs.org/playwright/-/playwright-1.63.0.tgz",++ "integrity": "sha512-+7ziBLidS4NaNCdt57SUDT+wYmmd5fmiQejUic/kb+YsYSCPyOOE9sebzMjNmQrsnNpDJqd4WHvV/8lfKfUDUg==",+ "dev": true,+ "license": "Apache-2.0",+ "dependencies": {- "playwright-core": "1.59.1"++ "playwright-core": "1.63.0"+ },+ "bin": {+ "playwright": "cli.js"+ },+ "engines": {- "node": ">=18"- },- "optionalDependencies": {- "fsevents": "2.3.2"++ "node": ">=20"+ }+ },+ "node_modules/playwright-core": {- "version": "1.59.1",- "resolved": "https://registry.npmjs.org/playwright-core/-/playwright-core-1.59.1.tgz",- "integrity": "sha512-HBV/RJg81z5BiiZ9yPzIiClYV/QMsDCKUyogwH9p3MCP6IYjUFu/MActgYAvK0oWyV9NlwM3GLBjADyWgydVyg==",++ "version": "1.63.0",++ "resolved": "https://registry.npmjs.org/playwright-core/-/playwright-core-1.63.0.tgz",++ "integrity": "sha512-rYCsBF/M5HjUch52bbtVONEFjv6Xu8sm8h72dNlR5bzIE1fvC/bxgspzkjSfU+MweEMmPM8KJebG6nnyxo5mCg==",+ "dev": true,+ "license": "Apache-2.0",+ "bin": {+ "playwright-core": "cli.js"+ },++ "engines": {++ "node": ">=20"++ }++ },+ "node_modules/postcss": {+ "version": "8.5.26",+ "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.26.tgz",+ "integrity": "sha512-u82N74LFzG8ca+dD8puPnplTXoGH4fTPpVGuIbt36G3qvNlkvfD0lEAZSxaly3KX8TS/L1A1gsCEmvKmBcVbkQ==",+ "dev": true,+ "funding": [+ {+ "type": "opencollective",+ "url": "https://opencollective.com/postcss/"+ },+ {+ "type": "tidelift",+ "url": "https://tidelift.com/funding/github/npm/postcss"+ },+ {+ "type": "github",+ "url": "https://github.com/sponsors/ai"+ }+ ],+ "license": "MIT",+ "dependencies": {+ "nanoid": "^3.3.17",+ "picocolors": "^1.1.1",+ "source-map-js": "^1.2.1"+ },+ "engines": {+ "node": "^10 || ^12 || >=14"+ }+ },+ "node_modules/prettier": {+ "version": "3.9.6",+ "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.9.6.tgz",+ "integrity": "sha512-OpN0zzVdiaiAhxpuuj5efpIS4sY9j7bY6uR5mnj5yPzGkdkjNKSJeUThPb60Jw29QuAZgA4o+/iB49kFiaBX6g==",+ "dev": true,+ "license": "MIT",+ "bin": {+ "prettier": "bin/prettier.cjs"+ },+ "engines": {+ "node": ">=14"+ },+ "funding": {+ "url": "https://github.com/prettier/prettier?sponsor=1"+ }+ },+ "node_modules/protobufjs": {+ "version": "7.6.5",+ "resolved": "https://registry.npmjs.org/protobufjs/-/protobufjs-7.6.5.tgz",+ "integrity": "sha512-/FPD0nUc9jH6rfFjji9IBqOz4pcSE3CsT1m7Ep6Mdb0LxSUMj8hgl6GomOvZzpNpAqqGaXA0P3VSrZLFzIhQrw==",+ "dev": true,+ "hasInstallScript": true,+ "license": "BSD-3-Clause",+ "optional": true,+ "dependencies": {+ "@protobufjs/aspromise": "^1.1.2",+ "@protobufjs/base64": "^1.1.2",+ "@protobufjs/codegen": "^2.0.5",+ "@protobufjs/eventemitter": "^1.1.1",+ "@protobufjs/fetch": "^1.1.1",+ "@protobufjs/float": "^1.0.2",+ "@protobufjs/path": "^1.1.2",+ "@protobufjs/pool": "^1.1.0",+ "@protobufjs/utf8": "^1.1.1",+ "@types/node": ">=13.7.0",+ "long": "^5.3.2"+ },+ "engines": {+ "node": ">=12.0.0"+ }+ },+ "node_modules/puppeteer-core": {+ "version": "25.7.0",+ "resolved": "https://registry.npmjs.org/puppeteer-core/-/puppeteer-core-25.7.0.tgz",+ "integrity": "sha512-wgBBj7dU5ceGyoT2PCrJpkYOhxPY8mDOmcSKZP92Cj5GgqQ3kv/UxzawnOLxiYuupe4bDf/yiQm3bzs/1nI0rQ==",+ "dev": true,+ "license": "Apache-2.0",+ "dependencies": {+ "@puppeteer/browsers": "3.2.0",+ "chromium-bidi": "17.0.2",+ "devtools-protocol": "0.0.1666840",+ "typed-query-selector": "^2.12.2",+ "webdriver-bidi-protocol": "0.4.2",+ "ws": "^8.21.1"+ },+ "engines": {+ "node": ">=22.12.0"+ }+ },+ "node_modules/restructure": {+ "version": "3.0.2",+ "resolved": "https://registry.npmjs.org/restructure/-/restructure-3.0.2.tgz",+ "integrity": "sha512-gSfoiOEA0VPE6Tukkrr7I0RBdE0s7H1eFCDBk05l1KIQT1UIKNc5JZy6jdyW6eYH3aR3g5b3PuL77rq0hvwtAw==",+ "dev": true,+ "license": "MIT"+ },+ "node_modules/retry": {+ "version": "0.13.1",+ "resolved": "https://registry.npmjs.org/retry/-/retry-0.13.1.tgz",+ "integrity": "sha512-XQBQ3I8W1Cge0Seh+6gjj03LbmRFWuoszgK9ooCpwYIrhhoO80pfq4cUkU5DkknwfOfFteRwlZ56PYOGYyFWdg==",+ "dev": true,+ "license": "MIT",+ "optional": true,+ "engines": {+ "node": ">= 4"+ }+ },+ "node_modules/roarr": {+ "version": "2.15.4",+ "resolved": "https://registry.npmjs.org/roarr/-/roarr-2.15.4.tgz",+ "integrity": "sha512-CHhPh+UNHD2GTXNYhPWLnU8ONHdI+5DI+4EYIAOaiD63rHeYlZvyh8P+in5999TTSFgUYuKUAjzRI4mdh/p+2A==",+ "dev": true,+ "license": "BSD-3-Clause",+ "dependencies": {+ "boolean": "^3.0.1",+ "detect-node": "^2.0.4",+ "globalthis": "^1.0.1",+ "json-stringify-safe": "^5.0.1",+ "semver-compare": "^1.0.0",+ "sprintf-js": "^1.1.2"+ },+ "engines": {+ "node": ">=8.0"+ }+ },+ "node_modules/run-applescript": {+ "version": "7.1.0",+ "resolved": "https://registry.npmjs.org/run-applescript/-/run-applescript-7.1.0.tgz",+ "integrity": "sha512-DPe5pVFaAsinSaV6QjQ6gdiedWDcRCbUuiQfQa2wmWV7+xC9bGulGI8+TdRmoFkAPaBXk8CrAbnlY2ISniJ47Q==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">=18"+ },+ "funding": {+ "url": "https://github.com/sponsors/sindresorhus"+ }+ },+ "node_modules/safe-buffer": {+ "version": "5.2.1",+ "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",+ "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",+ "dev": true,+ "funding": [+ {+ "type": "github",+ "url": "https://github.com/sponsors/feross"+ },+ {+ "type": "patreon",+ "url": "https://www.patreon.com/feross"+ },+ {+ "type": "consulting",+ "url": "https://feross.org/support"+ }+ ],+ "license": "MIT",+ "optional": true+ },+ "node_modules/semver": {+ "version": "7.8.5",+ "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.5.tgz",+ "integrity": "sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==",+ "dev": true,+ "license": "ISC",+ "bin": {+ "semver": "bin/semver.js"+ },+ "engines": {+ "node": ">=10"+ }+ },+ "node_modules/semver-compare": {+ "version": "1.0.0",+ "resolved": "https://registry.npmjs.org/semver-compare/-/semver-compare-1.0.0.tgz",+ "integrity": "sha512-YM3/ITh2MJ5MtzaM429anh+x2jiLVjqILF4m4oyQB18W7Ggea7BfqdH/wGMK7dDiMghv/6WG7znWMwUDzJiXow==",+ "dev": true,+ "license": "MIT"+ },+ "node_modules/serialize-error": {+ "version": "7.0.1",+ "resolved": "https://registry.npmjs.org/serialize-error/-/serialize-error-7.0.1.tgz",+ "integrity": "sha512-8I8TjW5KMOKsZQTvoxjuSIa7foAwPWGOts+6o7sgjz41/qMD9VQHEDxi6PBvK2l0MXUmqZyNpUK+T2tQaaElvw==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "type-fest": "^0.13.1"+ },+ "engines": {+ "node": ">=10"+ },+ "funding": {+ "url": "https://github.com/sponsors/sindresorhus"+ }+ },+ "node_modules/sharp": {+ "version": "0.35.3",+ "resolved": "https://registry.npmjs.org/sharp/-/sharp-0.35.3.tgz",+ "integrity": "sha512-ej0zVHuZGHCiABXcNxeYhpRnPNPAcvbG8RMdBAhDAxLKkCRVSpK3Iyu7qbqw3JMzoj0REeM6f3tJLtVwl0023Q==",+ "dev": true,+ "license": "Apache-2.0",+ "dependencies": {+ "@img/colour": "^1.1.0",+ "detect-libc": "^2.1.2",+ "semver": "^7.8.5"+ },+ "engines": {+ "node": ">=20.9.0"+ },+ "funding": {+ "url": "https://opencollective.com/libvips"+ },+ "optionalDependencies": {+ "@img/sharp-darwin-arm64": "0.35.3",+ "@img/sharp-darwin-x64": "0.35.3",+ "@img/sharp-freebsd-wasm32": "0.35.3",+ "@img/sharp-libvips-darwin-arm64": "1.3.2",+ "@img/sharp-libvips-darwin-x64": "1.3.2",+ "@img/sharp-libvips-linux-arm": "1.3.2",+ "@img/sharp-libvips-linux-arm64": "1.3.2",+ "@img/sharp-libvips-linux-ppc64": "1.3.2",+ "@img/sharp-libvips-linux-riscv64": "1.3.2",+ "@img/sharp-libvips-linux-s390x": "1.3.2",+ "@img/sharp-libvips-linux-x64": "1.3.2",+ "@img/sharp-libvips-linuxmusl-arm64": "1.3.2",+ "@img/sharp-libvips-linuxmusl-x64": "1.3.2",+ "@img/sharp-linux-arm": "0.35.3",+ "@img/sharp-linux-arm64": "0.35.3",+ "@img/sharp-linux-ppc64": "0.35.3",+ "@img/sharp-linux-riscv64": "0.35.3",+ "@img/sharp-linux-s390x": "0.35.3",+ "@img/sharp-linux-x64": "0.35.3",+ "@img/sharp-linuxmusl-arm64": "0.35.3",+ "@img/sharp-linuxmusl-x64": "0.35.3",+ "@img/sharp-webcontainers-wasm32": "0.35.3",+ "@img/sharp-win32-arm64": "0.35.3",+ "@img/sharp-win32-ia32": "0.35.3",+ "@img/sharp-win32-x64": "0.35.3"+ },+ "peerDependenciesMeta": {+ "@types/node": {+ "optional": true+ }+ }+ },+ "node_modules/source-map-js": {+ "version": "1.2.1",+ "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",+ "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",+ "dev": true,+ "license": "BSD-3-Clause",+ "engines": {+ "node": ">=0.10.0"+ }+ },+ "node_modules/sprintf-js": {+ "version": "1.1.3",+ "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.1.3.tgz",+ "integrity": "sha512-Oo+0REFV59/rz3gfJNKQiBlwfHaSESl1pcGyABQsnnIfWOFt6JNj5gCog2U6MLZ//IGYD+nA8nI+mTShREReaA==",+ "dev": true,+ "license": "BSD-3-Clause"+ },+ "node_modules/string-width": {+ "version": "8.2.2",+ "resolved": "https://registry.npmjs.org/string-width/-/string-width-8.2.2.tgz",+ "integrity": "sha512-GaPUh5gfdrYzqeVNZvUfT23vYYxXzKYidUcnMtJg/3rxRV63EFZy3k6xfKlmfeJD0176lnUV/Usr3XcwSvFzpg==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "get-east-asian-width": "^1.5.0",+ "strip-ansi": "^7.1.2"+ },+ "engines": {+ "node": ">=20"+ },+ "funding": {+ "url": "https://github.com/sponsors/sindresorhus"+ }+ },+ "node_modules/strip-ansi": {+ "version": "7.2.0",+ "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.2.0.tgz",+ "integrity": "sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "ansi-regex": "^6.2.2"+ },+ "engines": {+ "node": ">=12"+ },+ "funding": {+ "url": "https://github.com/chalk/strip-ansi?sponsor=1"+ }+ },+ "node_modules/tar": {+ "version": "7.5.22",+ "resolved": "https://registry.npmjs.org/tar/-/tar-7.5.22.tgz",+ "integrity": "sha512-MFO/QzvtAOmJbkhOaCTvbGcFN9L9b+JunIsDwaKljSOdcLMea3NJ1k9Usz/rjdfSXTq4dfzfeS7W4p4YOAAHeA==",+ "dev": true,+ "license": "BlueOak-1.0.0",+ "dependencies": {+ "@isaacs/fs-minipass": "^4.0.0",+ "chownr": "^3.0.0",+ "minipass": "^7.1.2",+ "minizlib": "^3.1.0",+ "yallist": "^5.0.0"+ },+ "engines": {+ "node": ">=18"+ }+ },+ "node_modules/tiny-inflate": {+ "version": "1.0.3",+ "resolved": "https://registry.npmjs.org/tiny-inflate/-/tiny-inflate-1.0.3.tgz",+ "integrity": "sha512-pkY1fj1cKHb2seWDy0B16HeWyczlJA9/WW3u3c4z/NiWDsO3DOU5D7nhTLE9CF0yXv/QZFY7sEJmj24dK+Rrqw==",+ "dev": true,+ "license": "MIT"+ },+ "node_modules/tslib": {+ "version": "2.8.1",+ "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",+ "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==",+ "dev": true,+ "license": "0BSD"+ },+ "node_modules/type-fest": {+ "version": "0.13.1",+ "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.13.1.tgz",+ "integrity": "sha512-34R7HTnG0XIJcBSn5XhDd7nNFPRcXYRZrBB2O2jdKqYODldSzBAqzsWoZYYvduky73toYS/ESqxPvkDf/F0XMg==",+ "dev": true,+ "license": "(MIT OR CC0-1.0)",+ "engines": {+ "node": ">=10"+ },+ "funding": {+ "url": "https://github.com/sponsors/sindresorhus"+ }+ },+ "node_modules/typed-query-selector": {+ "version": "2.12.2",+ "resolved": "https://registry.npmjs.org/typed-query-selector/-/typed-query-selector-2.12.2.tgz",+ "integrity": "sha512-EOPFbyIub4ngnEdqi2yOcNeDLaX/0jcE1JoAXQDDMIthap7FoN795lc/SHfIq2d416VufXpM8z/lD+WRm2gfOQ==",+ "dev": true,+ "license": "MIT"+ },+ "node_modules/undici-types": {+ "version": "8.3.0",+ "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-8.3.0.tgz",+ "integrity": "sha512-j375ScV60dom+YkPFIfTLcOiPxkN/buHz5GobjLhixFuANaNs3C9l4GmrWqejgXWJ7BbJcFYpTEUkS1Ge8bpZQ==",+ "dev": true,+ "license": "MIT",+ "optional": true+ },+ "node_modules/unicode-properties": {+ "version": "1.4.1",+ "resolved": "https://registry.npmjs.org/unicode-properties/-/unicode-properties-1.4.1.tgz",+ "integrity": "sha512-CLjCCLQ6UuMxWnbIylkisbRj31qxHPAurvena/0iwSVbQ2G1VY5/HjV0IRabOEbDHlzZlRdCrD4NhB0JtU40Pg==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "base64-js": "^1.3.0",+ "unicode-trie": "^2.0.0"+ }+ },+ "node_modules/unicode-trie": {+ "version": "2.0.0",+ "resolved": "https://registry.npmjs.org/unicode-trie/-/unicode-trie-2.0.0.tgz",+ "integrity": "sha512-x7bc76x0bm4prf1VLg79uhAzKw8DVboClSN5VxJuQ+LKDOVEW9CdH+VY7SP+vX7xCYQqzzgQpFqz15zeLvAtZQ==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "pako": "^0.2.5",+ "tiny-inflate": "^1.0.0"+ }+ },+ "node_modules/web-streams-polyfill": {+ "version": "3.3.3",+ "resolved": "https://registry.npmjs.org/web-streams-polyfill/-/web-streams-polyfill-3.3.3.tgz",+ "integrity": "sha512-d2JWLCivmZYTSIoge9MsgFCZrt571BikcWGYkjC1khllbTeDlGqZ2D8vD8E/lJa8WGWbb7Plm8/XJYV7IJHZZw==",+ "dev": true,+ "license": "MIT",+ "optional": true,+ "engines": {+ "node": ">= 8"+ }+ },+ "node_modules/webdriver-bidi-protocol": {+ "version": "0.4.2",+ "resolved": "https://registry.npmjs.org/webdriver-bidi-protocol/-/webdriver-bidi-protocol-0.4.2.tgz",+ "integrity": "sha512-VSV+fzfChirL3e7jay2yUC7B4HQCGtEWEg/MSSQbK+qWbqeGlRLlXTzPpYr3XGUvbpDHumWZBJxgesg4N7dbtA==",+ "dev": true,+ "license": "Apache-2.0"+ },+ "node_modules/wrap-ansi": {+ "version": "9.0.2",+ "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-9.0.2.tgz",+ "integrity": "sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "ansi-styles": "^6.2.1",+ "string-width": "^7.0.0",+ "strip-ansi": "^7.1.0"+ },+ "engines": {+ "node": ">=18"+ },+ "funding": {+ "url": "https://github.com/chalk/wrap-ansi?sponsor=1"+ }+ },+ "node_modules/wrap-ansi/node_modules/string-width": {+ "version": "7.2.0",+ "resolved": "https://registry.npmjs.org/string-width/-/string-width-7.2.0.tgz",+ "integrity": "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "emoji-regex": "^10.3.0",+ "get-east-asian-width": "^1.0.0",+ "strip-ansi": "^7.1.0"+ },+ "engines": {+ "node": ">=18"+ },+ "funding": {+ "url": "https://github.com/sponsors/sindresorhus"+ }+ },+ "node_modules/ws": {+ "version": "8.21.3",+ "resolved": "https://registry.npmjs.org/ws/-/ws-8.21.3.tgz",+ "integrity": "sha512-201TZ/kPWxoPr/OKWjquZR1SWKXcvxdH+e1xrx89b3YbmzLMFCLfnaG1HFIgWzJOEWZ7MvpK++odZufgYR50Rw==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">=10.0.0"+ },+ "peerDependencies": {+ "bufferutil": "^4.0.1",+ "utf-8-validate": ">=5.0.2"+ },+ "peerDependenciesMeta": {+ "bufferutil": {+ "optional": true+ },+ "utf-8-validate": {+ "optional": true+ }+ }+ },+ "node_modules/wsl-utils": {+ "version": "0.1.0",+ "resolved": "https://registry.npmjs.org/wsl-utils/-/wsl-utils-0.1.0.tgz",+ "integrity": "sha512-h3Fbisa2nKGPxCpm89Hk33lBLsnaGBvctQopaBSOW/uIs6FTe1ATyAnKFJrzVs9vpGdsTe73WF3V4lIsk4Gacw==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "is-wsl": "^3.1.0"+ },+ "engines": {+ "node": ">=18"+ },+ "funding": {+ "url": "https://github.com/sponsors/sindresorhus"+ }+ },+ "node_modules/y18n": {+ "version": "5.0.8",+ "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz",+ "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==",+ "dev": true,+ "license": "ISC",+ "engines": {+ "node": ">=10"+ }+ },+ "node_modules/yallist": {+ "version": "5.0.0",+ "resolved": "https://registry.npmjs.org/yallist/-/yallist-5.0.0.tgz",+ "integrity": "sha512-YgvUTfwqyc7UXVMrB+SImsVYSmTS8X/tSrtdNZMImM+n7+QTriRXyXim0mBrTXNeqzVF0KWGgHPeiyViFFrNDw==",+ "dev": true,+ "license": "BlueOak-1.0.0","engines": {"node": ">=18"}diff --cc package.jsonindex 9ab6e15,c0adc75..a78f3b0--- a/package.json+++ b/package.json@@@ -1,18 -1,28 +1,32 @@@{- "name": "hyperframes-editor",- "name": "hyperframes-video-pipeline",-- "version": "1.0.0",- "description": "",- "main": "index.js",++ "name": "hyperframes-student-kit",++ "version": "2.0.0",+ "private": true,- "type": "module",- "description": "A reusable HyperFrames video-editing student kit for Codex and Claude Code.",++ "type": "commonjs",++ "description": "HyperFrames student kit for Codex and Claude Code: long-form edits, reels, storytelling, and motion graphics.","scripts": {- "test": "echo \"Error: no test specified\" && exit 1",+ "transcribe": "node scripts/transcribe-elevenlabs.mjs",+ "validate-beats": "node scripts/validate-beat-sync.mjs","preflight": "node scripts/preflight.mjs",- "preflight:all": "for d in video-projects/*/; do node scripts/preflight.mjs \"$d\" || true; done"+ "sync:skills": "node scripts/sync-codex-skills.mjs",+ "check:skills": "node scripts/sync-codex-skills.mjs --check",+ "setup": "node scripts/setup.mjs",+ "new-video": "node scripts/new-video.mjs",+ "demo": "node scripts/new-video.mjs demo",+ "test": "node --test tests/*.test.mjs",+ "check": "node scripts/check-kit.mjs",+ "catalog": "node scripts/style-library/build-registry.mjs",- "test:media": "node scripts/smoke-media.mjs"++ "test:media": "node scripts/smoke-media.mjs",++ "validate:short-form": "node .claude/skills/short-form-edit/scripts/validate-plan.mjs",++ "validate:footage": "node .claude/skills/short-form-edit/scripts/validate-footage.mjs",++ "preflight:all": "node scripts/preflight-all.mjs"+ },+ "engines": {+ "node": ">=22"},- "keywords": [],- "author": "",- "license": "ISC",- "type": "commonjs","devDependencies": {+ "hyperframes": "0.7.109",- "gsap": "3.14.2"++ "gsap": "3.14.2",+ "playwright": "^1.59.1"}}diff --cc scripts/preflight-all.mjsindex 0000000,0000000..9784888new file mode 100644--- /dev/null+++ b/scripts/preflight-all.mjs@@@ -1,0 -1,0 +1,13 @@@++import { readdirSync, existsSync } from 'node:fs';++import { resolve, join } from 'node:path';++import { spawnSync } from 'node:child_process';++++const root = resolve(import.meta.dirname, '..');++let failed = 0;++for (const entry of readdirSync(join(root, 'video-projects'), { withFileTypes: true })) {++ const project = join(root, 'video-projects', entry.name);++ if (!entry.isDirectory() || !existsSync(join(project, 'index.html'))) continue;++ const result = spawnSync(process.execPath, [join(root, 'scripts/preflight.mjs'), project], { stdio: 'inherit' });++ if (result.status !== 0) failed++;++}++process.exitCode = failed ? 1 : 0;diff --cc tests/short-form.test.mjsindex 0000000,0000000..08c0903new file mode 100644--- /dev/null+++ b/tests/short-form.test.mjs@@@ -1,0 -1,0 +1,62 @@@++import test from 'node:test';++import assert from 'node:assert/strict';++import { readFileSync, mkdtempSync, cpSync, writeFileSync } from 'node:fs';++import { resolve, join } from 'node:path';++import { tmpdir } from 'node:os';++import { createHash } from 'node:crypto';++import { spawnSync } from 'node:child_process';++import { validatePlan } from '../.agents/skills/short-form-edit/scripts/validate-plan.mjs';++import { validateFootage } from '../.agents/skills/short-form-edit/scripts/validate-footage.mjs';++++const root = resolve(import.meta.dirname, '..');++const fixture = join(root, 'examples/short-form');++const read = name => JSON.parse(readFileSync(join(fixture, 'assets', name)));++function planCheck(change = () => {}) {++ const plan = read('plan.json'), transcript = read('transcript.json'), edl = read('edit-decisions.json');++ change(plan, transcript, edl);++ return validatePlan(plan, transcript, edl);++}++test('short-form fixture has complete source-mapped captions and scenes', () => {++ assert.equal(planCheck().ok, true);++});++test('a caption that drifts from the retained word is rejected', () => {++ const result = planCheck(p => { p.captions[0].words[0].start += .1; });++ assert.equal(result.ok, false);++ assert.ok(result.errors.some(e => e.includes('timing differs')));++});++test('word source timestamps from the wrong edit are rejected', () => {++ const result = planCheck((p, t) => { t.words[0].sourceStart += .1; });++ assert.equal(result.ok, false);++ assert.ok(result.errors.some(e => e.includes('source mapping')));++});++test('scene gaps and duplicate scene identifiers are rejected', () => {++ const result = planCheck(p => { p.scenes[1].start += .1; p.scenes[1].id = p.scenes[0].id; });++ assert.equal(result.ok, false);++ assert.ok(result.errors.some(e => e.includes('gap or overlap')));++ assert.ok(result.errors.some(e => e.includes('Duplicate scene')));++});++test('footage cannot reuse a scene or overlap source ranges under a new name', () => {++ const row = { sourceSceneId: 'source-1', sha256: 'a'.repeat(64), sourceStart: 0, sourceEnd: 2 };++ assert.equal(validateFootage([row]).ok, true);++ assert.equal(validateFootage([row, { ...row }]).ok, false);++ assert.equal(validateFootage([row, { ...row, sourceSceneId: 'source-2', sourceStart: 1 }]).ok, false);++});++test('CLI accepts no-footage edits and rejects missing or changed footage', () => {++ const work = mkdtempSync(join(tmpdir(), 'short-form-kit-'));++ cpSync(fixture, work, { recursive: true });++ const run = script => spawnSync(process.execPath, [join(root, '.agents/skills/short-form-edit/scripts', script), work], { encoding: 'utf8' });++ assert.equal(run('validate-plan.mjs').status, 0);++ assert.equal(run('validate-footage.mjs').status, 0);++ const plan = read('plan.json');++ plan.scenes[1].layout = 'broll'; plan.scenes[1].kind = 'garden';++ writeFileSync(join(work, 'assets/plan.json'), JSON.stringify(plan));++ assert.equal(run('validate-footage.mjs').status, 1);++ // Hash-validation fixture only; these bytes deliberately are not a video.++ const bytes = Buffer.from('synthetic footage hash fixture');++ writeFileSync(join(work, 'assets/garden.mp4'), bytes);++ const ledger = [{ scene: 's01', sourceSceneId: 'garden-one', asset: 'assets/garden.mp4', sha256: createHash('sha256').update(bytes).digest('hex'), sourceStart: 0, sourceEnd: 2 }];++ writeFileSync(join(work, 'assets/footage-ledger.json'), JSON.stringify(ledger));++ assert.equal(run('validate-footage.mjs').status, 0);++ writeFileSync(join(work, 'assets/garden.mp4'), 'changed');++ assert.equal(run('validate-footage.mjs').status, 1);++});