14->12 reference files. Both advertised a retired "10 looks / 10 motion primitives"
model that contradicts the live 48-identity catalog, and neither is read by any
compiler.
Kernels migrated first (verified no-successor):
- direction-catalog's tone x shot x platform CLASSIFICATION MATRIX -> CATALOG.md as a
shortlisting crosswalk (verbatim table + a usage header tying direction labels to
current identities + the anchor-fallback). The 10 per-direction specs map ~1:1 onto
shipped identities and drop with the file.
- motion-vocabulary's "palette not a cage / pick by content tone / invent
deterministically" permission -> _motion.md intro. Its 10 move definitions are
redundant with _motion.md's richer mood->entrance catalog (type/fade-up/pop/whip/
glitch/blur-in + 50 moves) and drop; its 60% exit rule was DROPPED, not carried, as
it conflicts with _motion.md's canonical "exit ~= 75% of entry".
Repointed all 5 inbound links: SKILL:211 (matrix cross-ref -> CATALOG), the two SKILL
table rows (removed), SKILL:240 prose ("and direction catalog" dropped), and
typographic-moves.md:203 (the dead direction-catalog §1 parenthetical dropped; it
already names the `documentary` identity).
Verified: zero residual refs, no dangling file/anchor links, kernels present in their
new homes, CJK-free, oxfmt clean.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
15->14 reference files. scene-types and layout-heuristics were two halves of one
pipeline stage (is-a-surface-embeddable -> where-exactly). Folds the wall-embed
viability gate (the only no-successor kernel: 4 ALL-must-hold conditions + refusal
rule + 6-point checklist + 4 anti-examples) into a new "Step 0" at the head of
layout-heuristics; condition 3 reframed to the locked-DNA path (pick a fitting
identity, not switch blend). The ~6 duplicated sections (blend-by-luminance, side
selection, positioning, crown, portrait band, baked-in refusal) drop with the file.
Repointed all 3 inbound links (not just the SKILL row): SKILL Shared-knowledge row,
anti-patterns.md:45 (the 6-point checklist link) and anti-patterns.md:164/170 (the
companion-files + reading-order lists). Verified: zero residual scene-types refs,
no dangling links, kernel present in Step 0, oxfmt clean.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Completes the safe-to-collapse dedup that the prior commit left partial. 14 edits
across 10 files, each adversarially verified to lose no concrete detail before apply.
Canonical home gets the rule, restatements become pointers:
- animate-transform-only -> modes/shared/_anatomy.md (added the reflow allowlist;
also reconciled its line 21, which wrongly listed letterSpacing as freely
animatable). aesthetic-principles #10 trimmed to a pointer.
- footage-untouched -> SKILL.md Non-negotiables; trimmed modes/cinematic/README,
rail.md, typographic-moves; kept-brief dna/README + themes/README (engine context).
- embed-scarce -> SKILL.md Caption model; trimmed anti-patterns + aesthetic-principles
#15; kept-brief caption-grouping mechanics.
- never-italicize -> aesthetic-principles #8 (added the sanctioned-exceptions note so
editorial/intro/dream italic is not lost); trimmed typographic-moves bullet.
- luminance 60/180 -> dna/README (engine); pointered typographic-moves + bespoke blend.
- scene-admission -> SKILL decision gate; trimmed anti-patterns (failure-modes keeps
the deeper why). mix-blend prose in anti-patterns trimmed to a pointer.
Verified: CJK-free, all file links + anchor links resolve, canonical homes now state
each rule. No files deleted.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Conservative dedup pass (no file deletion — these are live Cinematic-engine
authoring docs, not superseded legacy; make-composition.cjs still consumes
crown/crown_position/custom_css and SKILL routes Cinematic authoring to them).
- dev-gotcha dedup: trim the near-verbatim flex-stack / CoreML / double-fade /
letter-spacing entries in anti-patterns.md to one-line self-checks + pointers
at failure-modes.md (the canonical bug catalog that holds the unique detail).
- motion-vocabulary.md: drop the literal "from anti-patterns.md" re-copy of the
two reflow bans (now a pointer); keep the 3 motion-pacing-specific bullets.
- reconcile the stale blend-override contradiction at 4 sites: the dna/theme
engine locks blend per DNA (plan.blend_mode ignored), so the luminance->blend
rules are tagged as the hand-authored / clone-and-tweak path only.
- legacy-stratum orientation banners on scene-types / layout-heuristics /
typography-presets / typographic-moves / direction-catalog: point to the live
routing (CATALOG -> dna/themes), name what each still teaches (crown geometry,
pillarbox math, gaze rule, font-size x column lookup, classification matrix).
Verified: CJK-free, all links resolve, no dangling links, failure-modes.md
retains the canonical detail the new pointers rely on.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The determinism / Theme-timing-copied / face-by-construction items required zero agent action
(it cannot introduce them — it authors JSON, the engine emits the GSAP) and are implied by the
authoring model + CLAUDE.md. Non-negotiables should list only what the agent must uphold, so the
section now has just the two actionable tiers: gate-caught-but-preview+iterate, and on-you.
Verified: YAML valid, zero CJK, oxfmt clean.
Per review: "a gate enforces it" is NOT the same as "the agent can ignore it." Some gated rules
are NOT predictable before previewing and the first compile/render usually won't pass — that
how-to-fix guidance must stay, not be demoted to "the compiler handles it."
Re-sorts the section into three tiers instead of two:
- Guaranteed by construction (nothing to do): determinism + no letter-spacing/blur (you author
JSON, engine emits GSAP), Theme word-timing copied exact from transcript, face-never-covered
(compositing order).
- Gate catches it BUT you must PREVIEW + ITERATE (not predictable upfront, first pass often
fails): subject-occludes-caption (>65% abort; embed target ~30-55%; depends on the live matte),
off-frame overflow (depends on rendered text metrics), Cinematic timing/group/overlap (fix per
the failed-compile message). Cross-refs the Visual QA section for the non-gated iterative checks.
- On you, no gate sees these: never-grade, rail-first/embed-scarce, contrast (no WCAG lint),
matte sampling, prop-blind, >=0.5s.
All distinct facts + escapes preserved (verified). YAML valid, zero CJK, oxfmt clean.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Re-sorts Non-negotiables into "enforced for you (gates/compiler guarantee)" vs "you must uphold
(gates can't see)", grounded in the real gate/compiler code, and fixes two FALSE enforcement
claims the old section asserted:
- "WCAG contrast — final render lints": there is NO contrast/WCAG lint anywhere in the skill
(grep-confirmed). Recast as a manual rule (scrim / pick a higher-contrast identity; bright
>180 luma -> ink/anchor, never recolour cream's locked screen blend).
- "Face bbox >=30% uncovered every 0.3s": no face detection exists in code. Face-safety is
by construction (embed composites BEHIND the subject matte; rail is a lower-third). What
check-occlusion --strict actually aborts on is the SUBJECT hiding a caption word (>65%).
Rest attributed accurately: word-timing 80ms + group-window + time/band-overlap are
check-timing.cjs --strict (Cinematic, on authored plan.json); Theme's make-theme matcher COPIES
transcript timings exactly (correct by construction) + hard-fails non-verbatim order. Determinism
+ no letter-spacing/blur are by construction (agent authors JSON, engine emits GSAP) + hyperframes
lint. Overflow warn-only (Theme) / hard-gate (Cinematic). Every distinct rule + escape kept
(CREATIVE_SUBS, allow_overlap, <br>->white-space, frames_fg sampling, prop-blind, >=0.5s, CoreML).
Verified by an adversarial sub-agent reading check-timing/occlusion/overflow + render-*.sh +
make-theme: all "enforced for you" claims confirmed against code; the two demoted claims
confirmed code-absent. YAML valid, zero CJK, oxfmt clean. SKILL.md isn't compiled (0 render impact).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The prior commit shipped an incomplete harness: fixtureA/B transcript.json + safe-zones.json
match the per-project artifact names in .gitignore, so they were silently excluded. Add .gitignore
negations for those four paths and commit them, so a fresh checkout can run golden-snapshot.sh.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Adds scripts/golden-snapshot.sh + a self-contained fixture (scripts/golden/). It compiles every
themes/*.json against a fixed input and hashes the generated output (index.html + rail.html +
_postfx.sh). make-theme.cjs is deterministic for fixed inputs, so a changed hash == a changed
frame. Run it before+after a risky refactor and diff the manifests; an empty diff proves zero
degrade across all 38 themes.
Two fixtures cover the per-theme hero-placement coverage check (A = hero separate from body lines;
B = hero in lines, for lastpage/stardust/stomp/terminal), so all 38 compile. Self-tested: 38/38
compile, two runs byte-identical.
This is the unlock for the audit's "needs care" items — the make-theme redundancy/nesting cleanups
were rated degrade-risky only because there was no render-diff oracle. Now there is. The Cinematic
engine (make-cinematic/make-composition over dna/) still needs a sibling fixture before refactoring.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Applies the degrade-free subset of the structural audit. Zero behavior change, PROVEN: all 38
themes compile byte-identical before/after via a golden render-diff over a fixed fixture.
Data (37 theme JSONs): drop keys the engine never reads — plate.grain (film grain removed
2026-06-17), hero.layer (fg/bg is the setpiece's call, not JSON), 4 dead params (ordnance.barDy,
stomp.flash, terminal.exit, seance.params.seed) + lastpage's bogus 'field-is-the-apex' linkage.
An auto-revert guard confirmed none were load-bearing (no theme's output changed).
Docs/staleness: CATALOG 'three engines'->'two'; dna/README 'Six'->'Ten'; cinematic/README six->ten
+ full pick list; composition-craft -> scripts/check-occlusion.cjs (was a deleted .py);
direction-catalog drops '~30% of templates'; _anatomy.md no longer claims a 54-template/templates/
model; render-and-composite log 'standard'->'theme'.
Code (comment / dead-param only): make-theme header drops removed 'grain'; cpslam marked as a
kept-but-unused porting option; matte.cjs extractFrames drops its always-[] `extra` param.
Verified: golden regen-diff 38/38 identical, node --check, oxfmt clean, zero CJK.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Flips EC_MATTE from opt-in to default-when-available: matting uses the HeyGen CLI
background-removal whenever the command is installed AND a HeyGen credential is present;
otherwise the local hyperframes remove-background.
- EC_MATTE=local forces local; EC_MATTE=cloud forces a cloud attempt (surfaces why if it can't).
- auto/default + cloud installed but no key: nudge once, then local.
- auto/default + no command/CLI: silent local. Any cloud runtime failure falls back to local.
- available() now returns a code (no-cli / no-command / no-cred) so matte.cjs can branch.
It's a no-op today — the background-removal command is codegen'd from PR #40076 (still open),
so available() is false and every run uses local until it ships, then it auto-activates for
key-configured users. (Free at launch; per-second billing planned — EC_MATTE=local opts out.)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
EC_MATTE=cloud routes matting to the HeyGen CLI's background-removal (Bria) instead of the
local hyperframes remove-background (u2net). Written ahead of the API shipping.
- matte-cloud.cjs (new): available() pre-checks the heygen CLI, the background-removal command,
and a HeyGen credential. toFramesFg() uploads the asset, creates + polls the job, downloads
the foreground alpha webm, and bursts it to RGBA frames_fg (same contract as the local path).
The credential probe + nudge mirror hyperframes-media/heygen-tts.mjs.
- matte.cjs: an opt-in branch before the local engine; on any failure (command absent, no key,
or API error) it logs the reason + get-a-key nudge and falls back to local. Default unchanged.
The heygen background-removal command is codegen'd from experiment-framework PR #40076 (still
open), so available() is false today and EC_MATTE=cloud no-ops to local until it ships. Flag
names are anticipated; confirm with --request-schema when it lands.
Verified node --check, oxfmt, zero CJK, available() reports pending-command, default untouched.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Reverses the prior opt-in gate: when uv is missing, transcribe.cjs now AUTO-INSTALLS it by
default (official standalone installer — single binary, no Python/npm) so the agent-driven
flow just works without the user pre-setting a flag.
- EC_NO_UV_INSTALL=1 opts OUT of auto-install (-> nudge + STOP, user decides).
- TRANSCRIBE_ENGINE=whisper still skips uv entirely (-> bundled whisper.cpp).
- If install is disabled or fails, it STOPS + nudges rather than silently downgrading.
Verified the agent harness does NOT block it: the exact path (node -> execSync ->
`curl ...astral.sh/uv/install.sh | sh`) installed uv into a sealed temp HOME and uvx ran.
(Holds in a network-open permission mode; a network-denied sandbox would fail -> nudge+stop.)
resolveUvx() tested all three paths: present->path; EC_NO_UV_INSTALL=1->nudge+null;
default-absent->installs to HOME/.local/bin and returns the path.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Skill no longer shells the user's `python3` at all — the last touchpoint is gone.
- gen-stroke-path.py -> gen-stroke-path.cjs: faithful Node port (regex + arithmetic, no
deps). Verified byte-identical stdout/stderr to the Python original across multiple words
on a real strokefont; brush + chalkboard recompile with identical [gen] output. make-theme.cjs's
7 call sites now run `process.execPath gen-stroke-path.cjs` (was python3). Deleted the .py.
WhisperX still runs inside uvx's isolated env (uv fetches its own Python), never the host's.
- transcribe.cjs: when uv is missing and NOT auto-installed, STOP + nudge instead of silently
downgrading. resolveUvx() prints a 2-choice prompt (EC_INSTALL_UV=1 to auto-install uv
[recommended], or TRANSCRIBE_ENGINE=whisper to opt into the looser whisper.cpp) and the
caller exits(7). whisper.cpp is reached only by explicit opt-in or a genuine whisperx runtime
failure (uv present).
- docs: SKILL.md / CATALOG.md / themes/README.md — "no host Python required"; drop the stale
"needs python3" caveats; .py -> .cjs.
Verified: node --check, oxfmt clean, zero CJK, py-vs-cjs byte-identical, brush+chalkboard render.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
transcribe.cjs: resolveUvx() resolves the WhisperX runner — checks `uvx` on PATH then
~/.local/bin/uvx; if absent AND EC_INSTALL_UV=1, installs uv via the official standalone
installer (single binary, no Python/npm) and re-probes; otherwise prints how to enable it
and returns null so the caller uses the bundled whisper.cpp. The whisperx gate is now
`if (UVX)` (was `if (wantWx)`), so a missing uv degrades to whisper.cpp instead of erroring.
SKILL.md: drop the misleading "no manual installs" — uv is NOT bundled and a stock
hyperframes install usually lacks it; document the whisper.cpp fallback + the EC_INSTALL_UV
opt-in.
Verified: node --check; resolveUvx returns the path when uv present, prints the fallback
message + returns null when absent (not opted-in).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Remove modes/cinematic/_archive/ (champion / memory-wall / portrait-header
spec.md + template.html) — retired pre-DNA template shells that shipped to
every install as dead weight, redundant with git history, and out of step
with the skill's own convention that retired material lives OUTSIDE the skill
(~/Downloads/embedded-captions-archive/). Recoverable from git history.
Scrub the only two references to the _archive path:
- modes/cinematic/README.md: drop the 'archived templates in _archive/' clause
- scripts/make-composition.cjs: legacy-path comment no longer points at _archive
The memory-wall / champion design-pattern citations across references/* are
left intact — they describe live patterns + files in references/example-renders/,
not the deleted dir.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
test-set.md was reachable by nothing — no doc links it and no script
reads it, so an agent could never open it — AND its content is stale:
it documents the retired 54-template system (TEXT_SHADOW / BLEND_MODE /
CAP_COLOR placeholders, a 2026-04-23 bug log) and points at local-only
clips (~/Downloads/heygen_relevant_videos/) that aren't in the repo.
Recoverable from git history if the regression-corpus idea is revived.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
38e8d9f4 (integrate 12 identities) rewrote this section from a base
without b6d3a9c4's fix, restoring the stale "ten/six visual languages"
+ "Both modes draw from dna/" text — leaving it inconsistent with the
rest of the now-modernized file (48 identities, two engines, Standard
retired).
Restore the pointer-style section, aligned to the current vocabulary:
name both registries (dna/ = 10 column-flow Cinematic, themes/ = 38
themed), reinforce CATALOG.md as the single routing surface, keep the
hero-three-act note. The full DNA table stays in dna/README.md.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The description is a plain (unquoted) YAML scalar that contains ": " (e.g.
"two engines: column-flow", "Pipeline: transcription"), which a strict YAML
parser rejects with "mapping values are not allowed in this context". Wrap the
value in single quotes (no apostrophes inside, so no escaping needed). Verified
the frontmatter now parses and the description value is unchanged (quotes
stripped). Pre-existing on main; surfaced after the recent edits.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The skill is now fully CJK-free — verified across both repo copies over all text
files (kana, ideographs, halfwidth + fullwidth forms). All changes are cosmetic
except one intentional behavior change (the brush seal).
- CATALOG.md / SKILL.md: chinese trigger aliases and shortlisting heuristics
translated to english keyword equivalents (explode/VFX, terminal/console,
ink-wash/brush, ...). chinese-prompt routing is dropped by design.
- themes/{arcade,aurora,biolume,ransom,spectrum,vhs}.json: `when` aliases -> english.
- make-theme.cjs:
- one comment translated to english.
- brush seal default glyph (a kanji) -> a monogram of the climax word:
(heroDisplay.trim()[0] || "*").toUpperCase().
- cpslam setpiece default tag (katakana) -> "CYBERPUNK" (latin); cpslam is a
registered-but-currently-unused setpiece, so no shipped theme is affected.
- themes/brush.json: drop the explicit kanji sealGlyph so it uses the monogram default.
Behavior: only the brush seal changes (now e.g. "R" for "remarkable"); every
other shipped theme produces byte-identical output. Verified: make-theme.cjs
syntax ok, all 7 theme JSONs valid, brush + nightcity compile, brush seal renders
a latin monogram, zero CJK in generated HTML.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The dir held the shared font bundle (fonts.css + woff2 + build-fonts-css) and the
_motion/_anatomy reference catalogs — all used by BOTH the Cinematic and Theme
engines, so 'standard' was a misnomer after the Standard engine's retirement.
Pure rename (git mv, 48 files, fonts.css byte-identical) + path updates in the 5
real consumers (inject-fonts, make-theme, preview-frames, measure-layout font
embedding) and 3 comments/meta. build-fonts-css uses __dirname-relative paths so
it needed no change. Verified: make-theme still embeds @font-face (3 blocks, 0
'not bundled' warnings), inject-fonts + preview-frames resolve the new path.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Standard mode was retired 2026-06-12 (anchor replaced it) but stale references
lingered in ~15 files. Rewrote all misleading ones to current reality:
- routing advice that said 'use Standard mode (opaque rail)' for bright scenes →
the anchor theme / ink (references: bespoke-vs-presets, test-set,
typographic-moves, motion-vocabulary, direction-catalog, composition-craft,
aesthetic-principles)
- CATALOG no longer offers 'Standard or Cinematic or Theme?' as a non-question;
two-engine framing throughout
- gate/script comments + runtime messages: 'Standard mode only' → 'rail-surface
identities'; dangling PIPELINE.md citations removed (it was archived)
- make-composition mode=standard guard now states the retirement + points to
make-theme/anchor instead of the deleted make-standard.cjs
- themes/README + anchor.json + build-fonts-css wording
Remaining 'Standard' mentions are only retirement notes, the NBS Hershey-font
license, and the modes/standard/ dir path (kept — renaming churns many font
references). Lint clean.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Per user request: drop the ffmpeg noise= pass from _postfx.sh. Captions/footage
are no longer unified by a shared grain field. Themes whose ONLY plate effect was
grain now emit NO _postfx.sh — final_fx becomes a clean lossless copy of final.mp4
(no needless second encode). punch (windowed) and pushIn paths keep their camera
move, just without grain. plate.grain in the DNA JSONs is now inert.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
final_fx was softer than final.mp4 because the plate-reaction zoompan ran a
scale-up→resample→scale-down roundtrip on EVERY frame (a mild low-pass even at
z=1), yet a punch only moves the camera in a ~0.5s window. Now the punch path
splits the clip and runs zoompan ONLY on the active window; the head/tail pass
through with grain only (no geometric resample) so the static 95% stays as sharp
as final.mp4. Handles 2-seg (apex at clip start/end) and 3-seg (apex mid) cases;
falls back to whole-clip when the window spans nearly all of it. pushIn
(continuous zoom) and grain-only paths unchanged. Verified: passthrough region
now pixel-matches final crf11; apex window still carries the punch/shake.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Brings the branch skill to the full 48-identity catalog (10 column-flow + 38 theme):
interface family (breaking/finance/cover/blueprint/xray/glass/magnet) + uncanny
family (constellation/seance/mirror/brand/redline), their paradigms/setpieces in
make-theme.cjs, SKILL.md count + retired-Standard doc cleanup, 10 dead decls
removed. 12/12 new themes compile in-repo; 16/16 fixture regression green.
make-theme.cjs is now 702 KB (38 themes' worth of generators) — over the 500 KB
non-LFS gate; committed with HF_MAX_NONLFS_KB override (it is reviewable source,
not a binary; LFS would break diffs). Candidate for a future per-family split.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The section duplicated dna/README.md's table and carried claims from
before the Theme engine existed:
- title said "ten" but the body said "six"; "Both modes draw from
dna/" is wrong — Theme loads from themes/, not dna/
- it presented dna/ as the only DNA registry, omitting themes/ entirely
Replace the duplicated table with a pointer naming both registries
(dna/ = Cinematic, themes/ = Theme), reinforce CATALOG.md as the single
routing surface, and keep the hero-three-act note. No content lost —
dna/README.md already holds the full, maintained table.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
set-version's stable-release next-steps printed `git push origin main --tags`,
which pushes every local tag and fails the whole push on any pre-existing tag
(it broke the v0.6.107 release). #1517 fixed CONTRIBUTING.md + annotated the tag
but missed this console message. Now prints `git push origin main` +
`git push origin v<version>`, matching the pre-release branch.
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
* fix(lint): promote rules to errors with registry exemptions and false-positive fixes
- Export isRegistrySourceFile/isRegistryInstalledFile from composition.ts
- Add registry exemptions to google_fonts_import and font_family_without_font_face
- Add registry exemption to requestanimationframe_in_composition
- Fix timed_element_missing_clip_class: data-track-index alone no longer triggers
- Fix caption_transcript_parse_error: balanced-bracket scanner replaces non-greedy regex
- Fix missing_timeline_registry: skips sub-compositions and template-wrapped files
- Fix scene_layer_missing_visibility_kill: strip JS comments before pattern matching
- Fix gsap_css_transform_conflict: exempt from() alongside fromTo()
- Fix gsap_from_opacity_noop: only fires when opacity value is actually 0
- Add regression test for data-track-index-only elements
* test(lint): add regression tests for false-positive fixes
Covers the 7 missing negative-case assertions flagged in PR review:
- registry marker suppresses google_fonts_import + font_family_without_font_face
- registry marker suppresses requestanimationframe_in_composition
- isSubComposition suppresses missing_timeline_registry
- scene_layer_missing_visibility_kill: fires, commented-kill fires, real kill suppresses
- gsap_css_transform_conflict: from() exempt alongside fromTo()
- gsap_from_opacity_noop: non-zero opacity (e.g. 0.5) is a valid reveal, not a noop
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* fix(examples): fix warm-grain template to pass promoted lint rules
- index.html: remove undeclared "Lexend" from font-family stack
- intro.html: replace Google Fonts @import with bundled Inter font
- captions.html: quote TRANSCRIPT keys for valid JSON + use Inter font
Fixes CLI smoke CI failure after google_fonts_import, font_family_without_font_face,
and caption_transcript_parse_error were promoted from warning to error.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* fix(cli): resolve warm-grain from repo registry in dev mode + bundle at build
getStaticTemplateDir now falls back to registry/examples/<id> in dev mode
so CI smoke tests use the PR-branch copy instead of fetching from main.
build-copy.mjs copies warm-grain to dist/templates/warm-grain at build time
so packed CLIs can scaffold it offline.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* fix(examples): remove trailing comma from warm-grain TRANSCRIPT array
JSON.parse rejects trailing commas (valid JS, invalid JSON).
caption_transcript_parse_error was still firing because of the comma
on the last entry after quoting all keys.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---------
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
The acorn addKeyframeToScript mixed ms.overwrite + ms.appendLeft on the
same _auto endpoint node, crashing MagicString ("Cannot split a chunk
that has already been edited") whenever an interior keyframe adjacent to
an _auto 0/100 endpoint introduced a new backfilled prop — the common SDK
path. It also replaced (not merged) existing keyframes, dropped ease and
_auto markers, corrupted commas on multi-prop backfill into empty {},
used a <0.001 percentage tolerance instead of recast's PCT_TOLERANCE=2,
and silently no-op'd on flat (non-keyframe) tweens.
Rebuild the node model to mirror recast: compute the FINAL property record
for every changed keyframe value node (target merge, _auto endpoint sync,
backfilled siblings) against the original AST, then emit exactly one
ms.overwrite per changed node (one insert for a brand-new key). No node is
ever both overwritten and appended into, so splices can never overlap.
- Merge: re-touching an existing keyframe merges new props over the
existing record, preserving untouched props, existing ease, and _auto.
- Convert-flat: first keyframe-add on a flat to()/from()/fromTo() tween
rebuilds its vars object to percentage keyframes (ease->easeEach,
ease:"none", from/fromTo->to) matching recast, then re-locates via the
-from-/-fromTo- -> -to- id fallback.
- Tolerance: PCT_TOLERANCE=2 for existing-keyframe detection.
- Shared serializeValue/safeJsKey for keyframe values (recast parity); the
tween-statement path keeps its local serializer for object/boolean extras.
- keyframeBackfill: only backfill props with a real numeric default; skip
unknown/string props so color:0 / filter:0 are never emitted.
- setGsapKeyframe move-path threads the same backfill defaults as the add
path so both entry points behave identically.
Differential tests (acorn vs recast parsed keyframe arrays) cover the
crash (2-endpoint + 0/25/100), empty-{} multi-prop backfill, merge with
extra props + ease, flat to()/fromTo() convert, "50.0%" non-byte-equal
key, near-% tolerance, and _auto-marker preservation onto an endpoint.
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
* docs(cloud): add managed cloud rendering guide + fix flag reference
Add a dedicated guide for the managed `hyperframes cloud render` path
(HeyGen-hosted, zero-infra) at docs/deploy/cloud.mdx, covering auth/setup,
the zip→upload→render→download flow, templates via --variables, webhooks /
fire-and-forget, render management, and idempotent retries. Register it at
the top of the Deploy nav group and link it from the local Rendering guide.
Also fix a stale flag reference in the CLI docs: the `cloud render`
`--resolution` row listed the local-render presets (landscape/portrait/...)
but the cloud command only accepts `1080p`/`4k`, and `--aspect-ratio` was
missing. Verified against `hyperframes cloud render --help`.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
* docs(cloud): correct aspect-ratio wording and flow-diagram status
Two accuracy fixes from review:
- `--aspect-ratio` is only auto-detected for a local project dir; for
`--asset-id`/`--url` there is no local composition, so detection is
skipped and the server defaults to 16:9. Reword both the guide and the
CLI-reference rows to say so.
- The flow diagram showed status `done`, which is not a real value
(HyperframesRenderStatus is queued | rendering | completed | failed).
Use `completed` and re-align the box.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- set-version: create the release tag with `git tag -a -m` instead of a
lightweight `git tag`, which fails ("no tag message?") when a contributor has
tag.forceSignAnnotated / required-annotation set globally — it silently broke
the v0.6.107 tag step.
- CONTRIBUTING: replace `git push origin main --tags` (pushes every local tag →
whole push rejected on any pre-existing collision) with pushing the specific
tag, and document the monotonicity guard (stale higher tag blocks tagging).
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
* fix(studio): serialize GSAP script commits per file (shadow request race)
Rapid GSAP edits (ease/duration/keyframe/property) fired overlapping
read-modify-write POSTs to one script file — coalesceKey only dedupes edit
history, not requests. The gsap_fidelity shadow then diffed an op against
whichever POST's scriptText resolved, which could predate that op → false
"expected null, actual power2.out" mismatches. Server persists correctly; a
pure client request-pairing race.
Adds createKeyedSerializer (per-key promise chain, rejection-safe, self-
cleaning). commitMutation now serializes every GSAP-script commit per target
file by default (key `gsap-file:<path>`) — covering all op types and all
animations, not just one meta family — so same-file POSTs can't interleave.
Distinct files run concurrently; an explicit serializeKey still overrides.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
* refactor(studio): dedup shadow numeric-equal + GSAP script extraction
Code-review cleanup (no behavior change):
- Extract the relative-epsilon float compare into shared sdkShadowNumeric.relEqual,
used by both timing parity (sdkShadow) and GSAP value fidelity (numericEqual) —
was duplicated verbatim, risking divergent tuning.
- Export extractGsapScript from sdkShadowGsapFidelity and import it in the keyframe
shadow instead of the byte-identical clone (the regex + marker set must stay in
sync with document.ts; one copy is safer).
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Rapid GSAP edits (ease/duration/keyframe/property) fired overlapping
read-modify-write POSTs to one script file — coalesceKey only dedupes edit
history, not requests. The gsap_fidelity shadow then diffed an op against
whichever POST's scriptText resolved, which could predate that op → false
"expected null, actual power2.out" mismatches. Server persists correctly; a
pure client request-pairing race.
Adds createKeyedSerializer (per-key promise chain, rejection-safe, self-
cleaning). commitMutation now serializes every GSAP-script commit per target
file by default (key `gsap-file:<path>`) — covering all op types and all
animations, not just one meta family — so same-file POSTs can't interleave.
Distinct files run concurrently; an explicit serializeKey still overrides.
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
* fix(sdk): setStyle removes hyphenated properties (was kebab/camel key mismatch)
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
* fix(sdk): agree removeElement/getElement on duplicate bare ids
A bare hf-id duplicated across a sub-composition element and a top-level
element resolved to different instances: removeElement → resolveScoped →
querySelector (document-order-first, the inner sub-comp dup) while getElement
preferred the canonical match (scopedId === id, the top-level dup). So
removeElement(bareId) removed the inner instance and getElement(bareId) still
found the surviving top-level one — they disagreed.
resolveScoped now resolves an ambiguous BARE id to the canonical (top-level)
instance via isCanonicalScope (walks ancestors for isNewHostBoundary), falling
back to document order when no canonical match exists — matching getElement.
Fully-scoped paths (hf-host/hf-dup) and non-duplicated bare ids are unchanged.
Surfaced by SDK shadow parity (op:delete expected removed, actual present).
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>