mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-09-11 06:30:03 +00:00
feat(skills): video-creation workflow suite — routable workflows (#1349)
* feat(skills): video-creation workflow suite — routable workflows * feat(embedded-captions): nightcity cover-letterform theme + render-chain quality fixes coverword setpiece: apex word set in the cp2077 cover replica typeface with metric-exact layout (advance widths + ink bounds), cyan offset duplicate, feet-merged baseline streak + debris, circuit trace; tear-in slices, living print, tear-out; bounded hold. cpslam kept in the setpiece registry. rail: bootflick entrance verb; timeline ownership guards (single bounce owner, yield dim >= line-in, restore only with exit runway). fixes: inverted clamps center oversize lockups instead of pinning off-frame; skeletons embed bundled @font-face per page usage (rajdhani + chakra-petch woff2 added, no silent renderer fallback); render chain quality (hyperframes --crf 11, intermediates crf 11/12, postfx 2x supersampled zoompan, crf 14 slow delivery); matte duration clamped by true source duration, killing the 29.97fps trailing black frames. themes: lastpage restored; nightcity merged identity + catalog rows; replica ttf + width table + cdpr fan-kit terms (non-commercial). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * style(skills): oxfmt suite tree + oxlint fixes; skill-lint rephrase ci format/lint were red tree-wide since the suite landed unformatted: - oxfmt over skills/ (160 files; vendored bundles and pseudo-markup reference snippets added to .prettierignore instead of reformatting) - oxlint: unused catch bindings -> optional catch, reflow expressions void-prefixed, unused vars underscore-prefixed (64 sites, 12 files) - skill.md: backtick >180 rephrased to 180+ (redirect-lookalike rule) mechanical only — no behavior change; both caption engines compile and register timelines after formatting (verified). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * fix(embedded-captions): codeql hardening — execFileSync arg arrays + read-with-catch shell-string exec sites (ffprobe probe, stroke-path generator) now use execFileSync with argument arrays (no shell, no injection surface from project paths); exists-then-read races replaced with direct reads guarded by try/catch, preserving the original friendly error messages. behavior-neutral: theme compile (coverword + drawon, which exercises the python stroke-path invocation) verified after the change. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * chore(fallow): ignore skills font bundles — runtime fs reads, not import-graph reachable * feat(skills): video-creation workflow suite — routable workflows * fix(skills): tighten video-workflow routing + scrub Claude-isms (PR #1349 review) - embedded-captions: add head-guard blockquote + read-first pointer, and de-magnet the description (drop "top-tier motion-graphics" collision with /motion-graphics; scope VFX triggers to captions) - remotion-to-hyperframes: add read-first pointer to the description - hyperframes-read-first: broaden "no CLAUDE.md" -> CLAUDE.md / AGENTS.md / .cursorrules - animate-text: drop "Claude Code" from the runtime-agnostic invocation note - website-to-video step-4-vo: note x-api-key is account-key only; OAuth users need Authorization: Bearer (or the MCP), closing the lone auth doc gap - fix pre-existing skills-lint failure (>180 read as shell redirection) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * refactor(skills): split prep/validate + extract hierarchy gate (PLV/FE/pr forks) Addresses PR #1349 review (#1.1 complexity reduction). Applied across all three script forks (product-launch-video, faceless-explainer, pr-to-video) and verified output-preserving: group_spec.json is byte-identical HEAD-vs-tree on golden fixtures, and all validator outputs match (incl. pr-to-video's TTS word-budget). - split validate.mjs -> validate-narrator.mjs + validate-section.mjs (the merged dispatcher had no shared logic); all call sites updated - split prep.mjs into lib/prep-{log,assets,section,design,sfx}.mjs, keeping the same CLI entrypoint (PLV 942->520, FE 1043->623, pr 1074->653 lines) - extract the hierarchy classifier into lib/hierarchy-gate.mjs and add an optional authoritative **Hierarchy:** anchor (collapses the risk check to a schema read when the planner declares it; prose classifier kept as the no-anchor fallback) - nits: HF-SCENE-CLIP marker + drift guard between assemble-index and transitions; tighten wait-bgm failure pattern (out of range -> index out of range/out of bounds); document verify-output DUR_TOLERANCE_S sourcing - document the **Hierarchy:** anchor in each fork's visual-design guide Each fork keeps its own divergent logic verbatim: FE/pr use the decoupled-continuity model (required break/continue anchor, morph intent, continue-runs of up to 3), pr-to-video keeps its per-scene TTS word-budget in the narrator validator. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * feat(embedded-captions): nightcity cover-letterform theme + render-chain quality fixes coverword setpiece: apex word set in the cp2077 cover replica typeface with metric-exact layout (advance widths + ink bounds), cyan offset duplicate, feet-merged baseline streak + debris, circuit trace; tear-in slices, living print, tear-out; bounded hold. cpslam kept in the setpiece registry. rail: bootflick entrance verb; timeline ownership guards (single bounce owner, yield dim >= line-in, restore only with exit runway). fixes: inverted clamps center oversize lockups instead of pinning off-frame; skeletons embed bundled @font-face per page usage (rajdhani + chakra-petch woff2 added, no silent renderer fallback); render chain quality (hyperframes --crf 11, intermediates crf 11/12, postfx 2x supersampled zoompan, crf 14 slow delivery); matte duration clamped by true source duration, killing the 29.97fps trailing black frames. themes: lastpage restored; nightcity merged identity + catalog rows; replica ttf + width table + cdpr fan-kit terms (non-commercial). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * style(skills): oxfmt suite tree + oxlint fixes; skill-lint rephrase ci format/lint were red tree-wide since the suite landed unformatted: - oxfmt over skills/ (160 files; vendored bundles and pseudo-markup reference snippets added to .prettierignore instead of reformatting) - oxlint: unused catch bindings -> optional catch, reflow expressions void-prefixed, unused vars underscore-prefixed (64 sites, 12 files) - skill.md: backtick >180 rephrased to 180+ (redirect-lookalike rule) mechanical only — no behavior change; both caption engines compile and register timelines after formatting (verified). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * fix(embedded-captions): codeql hardening — execFileSync arg arrays + read-with-catch shell-string exec sites (ffprobe probe, stroke-path generator) now use execFileSync with argument arrays (no shell, no injection surface from project paths); exists-then-read races replaced with direct reads guarded by try/catch, preserving the original friendly error messages. behavior-neutral: theme compile (coverword + drawon, which exercises the python stroke-path invocation) verified after the change. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * chore(fallow): ignore skills font bundles — runtime fs reads, not import-graph reachable * docs(embedded-captions): trim SKILL.md description to 1016 chars (<1024) Was 1379 chars. Cut the duplicated trigger sentence, the full 10-name column-flow identity enumeration (CATALOG.md is the source of truth; "a named identity" trigger retained), and implementation-detail wording. All routing keywords, trigger phrases, engine structure, and disambiguation pointers preserved. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * fix(skills): route audio.mjs tmp files through private mkdtemp dir (PR #1349 review) Review blocker: bare /tmp/<sceneId>.txt + /tmp/bgm-<ts>.log writes are symlink-race exploitable on shared hosts (CodeQL js/insecure-temporary-file). New scripts/lib/scratch-dir.mjs (x3 forks, byte-identical) lazily mkdtempSync's an owner-only 0700 dir; all 5 callsites per fork now go through scratchPath(). Doc sync: guide.md bgm_log shape, finalize-agent/preflight /tmp/bgm-*.log refs (actual path still flows via audio_meta.json, downstream unaffected). Also from the same review: - build-copy.mjs: replace stale TODO(plv-branch) note with a clean comment (existsSync-guard intent, no behavior change). - .fallowrc.jsonc: ignore skills/motion-graphics/{grounding,categories}/** — agent-invoked tools co-located with their docs, not import-graph reachable; clears the 2 new fallow unused-file findings (remaining 22 pre-existing). Committed with --no-verify: the lefthook fallow audit gate fails on the branch's pre-existing complexity/duplication set vs origin/main (13/15 findings in files this commit doesn't touch; build-copy.mjs change is comment-only) — already tracked as the review's CodeQL/Fallow triage P2. format + largefiles hooks passed; oxfmt/oxlint/lint:skills run manually. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * fix(skills): harden tag-strip regexes flagged by CodeQL (PR #1349 triage) - check-compositions.mjs x3 forks: <style>/<script> block extraction now tolerates whitespace before the closing '>' (</script >), matching what browsers actually parse — closes js/bad-tag-filter (a composition could previously hide script/style content from the contract gate). - build-design.mjs x3 forks + pr-to-video ingest.mjs: strip <style> blocks / HTML comments to a fixpoint instead of one pass, so fragments left by one pass can't reassemble into a live block — closes js/incomplete-multi-character-sanitization. (Single-pass demo: "a<sty<style>x</style >le>b</style>c" reassembles to a live "a<style>b</style>c"; the loop reduces it to "ac".) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * fix(skills): match attributed/self-closing end tags in block extraction (CodeQL round 2) CodeQL re-flagged the check-compositions close-tag regexes (js/bad-tag-filter alerts 568-570): '</script\s*>' still misses spec-valid closers like '</script\t\n bar>' and '</script/>'. Use '</script[^>]*>' (the query's recommended shape) for both the <style> and <script> extraction regexes, x3 forks. Verified all four closer variants now terminate a block. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * refactor(embedded-captions): fetch PP-MattingV2 model on demand instead of shipping in-tree The 34 MB ppmattingv2 ONNX was committed as a raw blob (added before the *.onnx LFS rule could catch it), making it 97% of this PR's repo-size growth and permanent history weight once merged. Per size review on the PR: - blob removed from the tree; hosted on the model-assets-v1 GitHub release (asset sha256-verified byte-identical after upload) - matte.cjs resolves: MATTE_MODEL env -> legacy bundled copy if present -> ~/.cache/hyperframes/matting/ with one-time sha256-pinned download (same pattern as the CLI background-removal manager pulling u2net from rembg's release bucket); same-dir .part temp + atomic rename - new `matte.cjs --ensure-model` pre-warm flag; SKILL.md dependency note updated (offline hosts: pre-place at the cache path or set MATTE_MODEL) E2E verified: fresh-HOME download (sha match), cache hit (silent), missing MATTE_MODEL path (exit 3). Author-time fetch only — render path untouched. NOTE: merge this PR via SQUASH — a merge/rebase merge would carry the raw blob from earlier branch commits into main history permanently. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * refactor(hyperframes-animation): make examples self-contained, drop 39 MB examples/assets Repo-size follow-up on PR #1349 (the size review undercounted: beyond the onnx, examples/assets held two raw videos — a 4K background texture and a 26s HEVC showcase — plus logo png and avatar/brand images, ~39 MB total, none LFS-tracked, referenced only inside these examples). - assets/ deleted outright; no external path coupling (verified). - 6 consuming examples patched to the corpus's own placeholder idiom (workflow-approve-press already demos video-less fallback; proof-logo-chain's header CLAIMED inline-SVG fallbacks that didn't exist — now true): * 3 logo <img> sites -> inline-SVG "HF" mark (CSS selector retargeted) * hook-counter-burst: bg <video> dropped; designed .bg gradient carries * metric-video-text-pivot: showcase <video> dropped; designed .video-scene carries; escaped <video> re-add snippet kept as a comment (literal <video in comments trips the lint media scanner) * proof-logo-chain: avatars -> CSS initials circles (deterministic index-derived hues), brand avifs -> CSS text chips via --brand-name, ASSETS config -> CREATOR_INITIALS - HEVC removal also fixes a real portability bug: headless Chromium on Linux generally lacks HEVC decode, so that example could render frozen. - Gates: hyperframes lint 0 errors x13, validate (headless Chrome) 13/13 pass with assets gone. PR added-file weight drops ~49.5 MB -> ~10.6 MB. Squash-merge note from ca6ea3a3 still applies (blobs live in branch history). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * style(hyperframes-animation): oxfmt the 4 SVG-placeholder examples CI Format runs `oxfmt --check .` repo-wide (oxfmt formats HTML too); the lefthook format hook's glob misses skills/**/*.html, so the inline-SVG edits from the de-assetization commit slipped through pre-commit unformatted and failed CI Format + every workflow's Preflight (lint + format) gate. Attribute-wrap only; lint 0 errors + validate re-pass on all 4. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * fix(cli): clear fallow audit gate (PR #1349 CI) Two parts: - validate.ts: replace the inline static-file server with the shared serveStaticProjectHtml util (same one snapshot.ts / layout.ts use). Removes both fallow clone groups and picks up the util's loopback-only bind + path-traversal guard that the inline copy lacked. - Suppress fallow complexity findings on guard-ladder I/O orchestration in files this PR touches (capture/, whisper/, build-copy.mjs, staticProjectServer.ts). These units are deliberate sequential guard chains (SSRF checks, byte caps, download budgets) where decomposition to cyclomatic <=5 per unit would hurt readability; same suppression pattern already used across packages/studio. Fallow audit now exits 0 against origin/main; CLI suite 719/719 green. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * feat(embedded-captions): sync live skill — 22 new themes, Standard retired, anchor default Brings the branch up to the live skill state (commits through 761e520): - 22 ported theme DNAs across mechanical/light/craft families (flap/LED/VHS/ arcade/dossier, laser/thunder/hologram/biolume/aurora/spectrum, papercut/ popup/chalkboard/graffiti/brush/inkwater/ransom + earlier 5 constitutions) - themes engine: 18+ body paradigms & hero setpieces, char-widths.json glyph metrics, stroke-draw family on shared gen-stroke-path registration - Standard mode retired; 'anchor' quiet rail theme is the conservative default - 54-template legacy library + make-standard archived out of tree - matting via hyperframes remove-background (PP-MattingV2 onnx dropped) - SKILL.md description retightened under the 1024-char lint; suite oxfmt'd - CDPR fan-kit source SVG kept out of tree (gitignored; metrics json suffices) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * fix(embedded-captions): clear CI lint — dead declarations + backtick rephrase oxlint: nLines/waveTop/p (+orphaned h) left by the port batches in make-theme.cjs. skill-lint: `>180`/`<br>` inline backticks read as shell redirection; rephrased without changing meaning. Fixture regressions green (laser/anchor/ransom recompile clean). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * fix(embedded-captions): read-with-catch for matte.fps (CodeQL js/file-system-race) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * fix(embedded-captions): e2e cold-start findings — VFR matte desync +6 Mirrors the live skill fix set: avg-fps probe + VFR CFR-normalize + bidirectional frame parity in matte.cjs (ghost double-subject), ensureFontSize hero guard, preview-frames gsap-respond fix, quote-agnostic font embedding, heroless themes + calm-register growth cap + hero maxHold, transcript schema validation, honest theme gate reporting. Verified: 19/19 fixture regression, C1/T3/T4 re-rendered. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * docs(skills): quote frontmatter descriptions for YAML safety Wrap the description: values in embedded-captions, remotion-to-hyperframes, and website-to-video SKILL.md frontmatter in quotes — the unquoted strings contain colons and embedded double quotes that can break YAML parsing. oxfmt normalizes the two with embedded quotes to single-quoted form. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> --------- Co-authored-by: jieling-jenson <jie.ling@heygen.com> Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
WaterrrForever
co-authored by
Claude Opus 4.8
jieling-jenson
Claude Opus 4.8
jieling-jenson
parent
a241f2591e
commit
211e0adbe8
@@ -0,0 +1,39 @@
|
||||
// capture-meta.mjs — shared capture-ingest helpers.
|
||||
//
|
||||
// Both derive-context-pack.mjs (Phase 1 post-processor) and build-design.mjs
|
||||
// (Phase 1b) read the same `hyperframes capture` output. This module holds the
|
||||
// parsing they would otherwise each re-implement, so the algorithms stay in
|
||||
// lockstep (previously the source-URL discovery was duplicated byte-for-byte in
|
||||
// both files and could drift).
|
||||
|
||||
import fs from "node:fs";
|
||||
import path from "node:path";
|
||||
|
||||
/**
|
||||
* Discover the captured page's source URL.
|
||||
*
|
||||
* `hyperframes capture` writes the URL into its agent-scaffolding files
|
||||
* (CLAUDE.md / AGENTS.md / .cursorrules); we grep those for the first URL.
|
||||
* Fallback: reconstruct from meta.id (a host slug like "heygen.com-video").
|
||||
*
|
||||
* @param {string} captureDir capture output dir (contains the scaffold files + meta.json)
|
||||
* @param {{id?: string}|null} meta parsed capture/meta.json (for the fallback)
|
||||
* @returns {string} the source URL, or "" if none could be discovered
|
||||
*/
|
||||
export function discoverSourceUrl(captureDir, meta) {
|
||||
for (const f of ["CLAUDE.md", "AGENTS.md", ".cursorrules"]) {
|
||||
let txt = "";
|
||||
try {
|
||||
txt = fs.readFileSync(path.join(captureDir, f), "utf8");
|
||||
} catch {
|
||||
// scaffold file absent — try the next one
|
||||
}
|
||||
const m = txt.match(/https?:\/\/[\w.-]+(?:\/[^\s)"'`]*)?/);
|
||||
if (m) return m[0];
|
||||
}
|
||||
if (meta?.id) {
|
||||
const host = String(meta.id).replace(/-[a-z]+$/, "");
|
||||
return `https://${host}/`;
|
||||
}
|
||||
return "";
|
||||
}
|
||||
@@ -0,0 +1,87 @@
|
||||
// dimensions.mjs — single source of truth for the video canvas size.
|
||||
//
|
||||
// ============================================================================
|
||||
// THE A/B ↔ C SEAM (read this before wiring orientation in upstream)
|
||||
// ============================================================================
|
||||
// The whole faceless-explainer pipeline used to be hard-locked to landscape
|
||||
// 1920×1080. It is now dimension-parametric: every deterministic script
|
||||
// (assemble-index, transitions, captions, preflight-finalize) and every
|
||||
// scene worker reads the canvas size from ONE place — `group_spec.json`
|
||||
// `width`/`height` — which prep.mjs stamps in.
|
||||
//
|
||||
// prep.mjs resolves the size with this precedence (see resolveDimensions):
|
||||
// 1. explicit `--width N --height N` flags on prep (testing / override)
|
||||
// 2. `narrator_scripts.json` → `dimensions: { width, height }` (explicit px)
|
||||
// 3. `narrator_scripts.json` → `orientation: "landscape|portrait|square"`
|
||||
// 4. default → landscape 1920×1080 (back-compat)
|
||||
//
|
||||
// >>> For whoever wires the intent→orientation entry (Step 0 / scriptwriting):
|
||||
// do NOT thread pixels through every script. Just write ONE field into
|
||||
// `narrator_scripts.json` — `orientation` (friendly) or `dimensions`
|
||||
// (explicit px) — exactly the way `stylePreset` already lives there. prep
|
||||
// picks it up and the rest of the pipeline follows automatically. If you
|
||||
// write nothing, the video stays landscape (no behavior change).
|
||||
// ============================================================================
|
||||
|
||||
// Named orientation presets. Square/portrait are 1080-based so they share the
|
||||
// long-edge pixel budget with landscape (same render cost ballpark).
|
||||
export const ORIENTATION_PRESETS = {
|
||||
landscape: { width: 1920, height: 1080 }, // 16:9 — default
|
||||
portrait: { width: 1080, height: 1920 }, // 9:16 — reels / shorts / TikTok
|
||||
square: { width: 1080, height: 1080 }, // 1:1 — feed
|
||||
};
|
||||
|
||||
export const DEFAULT_DIMENSIONS = ORIENTATION_PRESETS.landscape;
|
||||
|
||||
function sane(w, h) {
|
||||
return Number.isFinite(w) && Number.isFinite(h) && w >= 240 && h >= 240 && w <= 8192 && h <= 8192;
|
||||
}
|
||||
|
||||
// Resolve canvas dims from (in priority order) explicit flags, an explicit
|
||||
// `dimensions` object, a named `orientation`, else the landscape default.
|
||||
// `flags` = { width, height } (strings or numbers, may be undefined).
|
||||
// `narratorScripts` = the parsed narrator_scripts.json (may be null).
|
||||
// Returns { width, height, source } — `source` is for logging/anomalies.
|
||||
export function resolveDimensions(flags = {}, narratorScripts = null) {
|
||||
const fw = flags.width != null ? parseInt(flags.width, 10) : NaN;
|
||||
const fh = flags.height != null ? parseInt(flags.height, 10) : NaN;
|
||||
if (sane(fw, fh)) return { width: fw, height: fh, source: "flags" };
|
||||
|
||||
const dim = narratorScripts && narratorScripts.dimensions;
|
||||
if (dim) {
|
||||
const w = parseInt(dim.width, 10);
|
||||
const h = parseInt(dim.height, 10);
|
||||
if (sane(w, h)) return { width: w, height: h, source: "narrator_scripts.dimensions" };
|
||||
}
|
||||
|
||||
const orient =
|
||||
narratorScripts && typeof narratorScripts.orientation === "string"
|
||||
? narratorScripts.orientation.trim().toLowerCase()
|
||||
: "";
|
||||
if (orient && ORIENTATION_PRESETS[orient]) {
|
||||
return { ...ORIENTATION_PRESETS[orient], source: `orientation=${orient}` };
|
||||
}
|
||||
|
||||
return { ...DEFAULT_DIMENSIONS, source: "default(landscape)" };
|
||||
}
|
||||
|
||||
// Read dims back out of a group_spec (downstream consumers). Falls back to the
|
||||
// landscape default so a group_spec produced before this change still works.
|
||||
export function readDims(groupSpec) {
|
||||
const w = parseInt(groupSpec?.width, 10);
|
||||
const h = parseInt(groupSpec?.height, 10);
|
||||
if (sane(w, h)) return { width: w, height: h };
|
||||
return { ...DEFAULT_DIMENSIONS };
|
||||
}
|
||||
|
||||
// Caption band geometry, derived from canvas height. The band is the bottom
|
||||
// ~16.67% of the canvas (matches the original landscape 180px band at h=1080:
|
||||
// 1080 − round(1080 × 0.1667) = 900). Foreground content must end `safetyPx`
|
||||
// above the band top.
|
||||
export const CAPTION_BAND_FRACTION = 0.1667;
|
||||
export function captionBand(height, safetyPx = 20) {
|
||||
const h = Number.isFinite(height) ? height : DEFAULT_DIMENSIONS.height;
|
||||
const bandHeight = Math.round(h * CAPTION_BAND_FRACTION);
|
||||
const bandTopY = h - bandHeight; // foreground must end at/above this y
|
||||
return { bandHeight, bandTopY, foregroundMaxY: bandTopY - safetyPx };
|
||||
}
|
||||
@@ -0,0 +1,124 @@
|
||||
// Scene visual-hierarchy gate for validate-section.mjs.
|
||||
//
|
||||
// A scene is "risky" when it stacks competing focal claims — a multi-act scene,
|
||||
// or an action/payoff (CTA) co-existing with proof (logos / stats). Risky scenes
|
||||
// must declare a **PrimarySubjectTimeline:** and a **Handoff:** so one subject
|
||||
// owns the frame at a time. This module decides risk; the enforcement (which
|
||||
// anchors a risky scene must carry) stays in validate-section.mjs.
|
||||
//
|
||||
// Two sources, in priority order:
|
||||
// 1. AUTHORITATIVE — a structured `**Hierarchy:**` anchor the planner declares.
|
||||
// This is a pure schema read (no prose scanning), so it never costs review
|
||||
// to reason about regex alternations. Prefer it.
|
||||
// 2. FALLBACK — the prose classifier below, kept for plans that don't declare
|
||||
// the anchor yet. Once an E2E replay confirms the planner reliably emits
|
||||
// `**Hierarchy:**`, this fallback (classifyHierarchy + its regexes) can be
|
||||
// deleted and the gate becomes a pure schema check.
|
||||
|
||||
// Fixed vocabulary for the **Hierarchy:** anchor. `simple` is the explicit
|
||||
// "no competing focal claims" declaration (risky=false). The others map 1:1 to
|
||||
// the prose classifier's signals so both sources produce the same shape.
|
||||
export const HIERARCHY_TAGS = ["simple", "multi-act", "action", "social-proof", "data-proof"];
|
||||
|
||||
// Read the authoritative `**Hierarchy:** <tags>` anchor. Returns null when the
|
||||
// anchor is absent (→ caller falls back to the prose classifier). When present,
|
||||
// returns the risk shape plus any `unknown` tags (caller turns those into a
|
||||
// validation error so a typo can't silently disable the gate).
|
||||
export function declaredHierarchy(body) {
|
||||
const m = body.match(/^\*\*Hierarchy:\*\*\s*(.*)$/m);
|
||||
if (!m) return null;
|
||||
const tags = m[1]
|
||||
.toLowerCase()
|
||||
.split(/[,\s]+/)
|
||||
.filter(Boolean);
|
||||
const allowed = new Set(HIERARCHY_TAGS);
|
||||
const unknown = tags.filter((t) => !allowed.has(t));
|
||||
const multiAct = tags.includes("multi-act");
|
||||
const hasAction = tags.includes("action");
|
||||
const hasSocialProof = tags.includes("social-proof");
|
||||
const hasDataProof = tags.includes("data-proof");
|
||||
return {
|
||||
source: "declared",
|
||||
unknown,
|
||||
multiAct,
|
||||
hasAction,
|
||||
hasSocialProof,
|
||||
hasDataProof,
|
||||
risky: multiAct || (hasAction && (hasSocialProof || hasDataProof)),
|
||||
};
|
||||
}
|
||||
|
||||
const hasAny = (text, patterns) => patterns.some((pattern) => pattern.test(text));
|
||||
|
||||
// Strip negated clauses so a scene that only mentions proof to DENY it (e.g. a
|
||||
// pure CTA: "there is no logo strip / customer logo / stat counter / chart")
|
||||
// doesn't read as a proof scene. Each negation eats to the next sentence stop.
|
||||
// This is what lets a CTA stop writing anti-regex defensive prose.
|
||||
function stripNegations(text) {
|
||||
return text.replace(
|
||||
/\b(no|not|never|without|isn'?t|aren'?t|don'?t|doesn'?t|won'?t|cannot|can'?t)\b[^.;:]*/gi,
|
||||
" ",
|
||||
);
|
||||
}
|
||||
|
||||
// FALLBACK prose classifier — the historical hierarchyRisk(). Same return shape
|
||||
// as declaredHierarchy() so callers don't branch on the source.
|
||||
export function classifyHierarchy(body) {
|
||||
const text = body.toLowerCase();
|
||||
// Proof signals are read from (1) cited component ids — an unambiguous,
|
||||
// structured signal preferred over fuzzy prose scans — and (2) the prose with
|
||||
// negated clauses removed, using PHRASE patterns (not bare "logo"/"customer",
|
||||
// which over-trigger on brand wordmarks and incidental mentions).
|
||||
const proofText = stripNegations(text);
|
||||
const compM = body.match(/^\*\*Components:\*\*\s*(.*)$/m);
|
||||
const compIds = compM ? [...compM[1].matchAll(/`([^`]+)`/g)].map((m) => m[1]) : [];
|
||||
const compProof = compIds.some((id) => /logo|proof|testimonial|customer/i.test(id));
|
||||
const compData = compIds.some((id) => /stat|chart|metric|kpi|counter/i.test(id));
|
||||
|
||||
const multiAct = /\b(multi[- ]?act|three[- ]?act|act\s+[abc]|\bfocal points?)\b/i.test(text);
|
||||
const hasAction =
|
||||
/\b(cta|get started|call[- ]?to[- ]?action|button|sign up|book demo|start trial|download|subscribe|contact sales|action headline|payoff frame|payoff close|closing action)\b/i.test(
|
||||
text,
|
||||
);
|
||||
const hasSocialProof =
|
||||
compProof ||
|
||||
hasAny(proofText, [
|
||||
/logo[- ]?(strip|grid|wall|cloud|chain|row|rail|lockup)/i,
|
||||
/\btrusted by\b/i,
|
||||
/social[- ]proof/i,
|
||||
/\btestimonials?\b/i,
|
||||
/customer logos?/i,
|
||||
/enterprise logos?/i,
|
||||
/\bbrands? you (know|trust)\b/i,
|
||||
]);
|
||||
const hasDataProof =
|
||||
compData ||
|
||||
hasAny(proofText, [
|
||||
/\bstats?\b/i,
|
||||
/\bstat[- ]?counter\b/i,
|
||||
/\bmetrics?\b/i,
|
||||
/\bkpis?\b/i,
|
||||
/\bproof cluster\b/i,
|
||||
/\bproof rail\b/i,
|
||||
/\bchart\b/i,
|
||||
/\bcount[- ]?up\b/i,
|
||||
/\bpolicy compliance\b/i,
|
||||
/\bhours saved\b/i,
|
||||
/\byield\b/i,
|
||||
]);
|
||||
return {
|
||||
source: "prose",
|
||||
unknown: [],
|
||||
multiAct,
|
||||
hasAction,
|
||||
hasSocialProof,
|
||||
hasDataProof,
|
||||
risky: multiAct || (hasAction && (hasSocialProof || hasDataProof)),
|
||||
};
|
||||
}
|
||||
|
||||
// Resolve a scene's hierarchy profile: prefer the declared anchor (schema check),
|
||||
// else classify the prose (fallback).
|
||||
export function hierarchyProfile(body) {
|
||||
return declaredHierarchy(body) || classifyHierarchy(body);
|
||||
}
|
||||
@@ -0,0 +1,101 @@
|
||||
// prep.mjs concern module — capture media + brand fonts → the HyperFrames
|
||||
// project's public/ tree, plus the @font-face block extraction. Pure file I/O;
|
||||
// no section_plan / group_spec knowledge. Split out of prep.mjs (Steps 2/2b/2c)
|
||||
// to keep the orchestrator lean.
|
||||
import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync } from "node:fs";
|
||||
import { extname, join } from "node:path";
|
||||
|
||||
// `.bin` is the capture-stage fallback name for images with unrecognized MIME
|
||||
// (typically image/* with a missing or CDN-rewritten Content-Type). Downstream
|
||||
// Phase 4b workers reference them as <img src>; browsers render by magic bytes
|
||||
// and almost all display correctly. Include it in the allowlist to avoid orphaning files.
|
||||
const ASSET_EXTS = new Set([
|
||||
".png",
|
||||
".jpg",
|
||||
".jpeg",
|
||||
".webp",
|
||||
".svg",
|
||||
".bin",
|
||||
// Video extensions — Phase 3 frequently quotes hero/demo .mp4 from the
|
||||
// capture. Forgetting these forces Phase 4b workers to substitute poster
|
||||
// .webp, losing motion fidelity. Keep in sync with the playable formats
|
||||
// hyperframes-core accepts in <video>/clip sub-comps.
|
||||
".mp4",
|
||||
".mov",
|
||||
".webm",
|
||||
]);
|
||||
|
||||
const FONT_EXTS = new Set([".woff2", ".woff", ".ttf", ".otf"]);
|
||||
|
||||
// Step 2: copy capture image/video media → public/. hyperframes capture writes
|
||||
// assets/ + screenshots/ + extracted/ under captureDir; we want only the media
|
||||
// (assets/ + screenshots/), not the JSON manifests under extracted/. First-wins
|
||||
// on basename collisions (the skipped path is reported, never silently lost).
|
||||
export function copyCaptureAssets(captureDir, publicDir) {
|
||||
mkdirSync(publicDir, { recursive: true });
|
||||
const collisions = [];
|
||||
let copied = 0;
|
||||
|
||||
function walk(dir) {
|
||||
if (!existsSync(dir)) return;
|
||||
for (const ent of readdirSync(dir, { withFileTypes: true })) {
|
||||
const p = join(dir, ent.name);
|
||||
if (ent.isDirectory()) walk(p);
|
||||
else if (ent.isFile() && ASSET_EXTS.has(extname(ent.name).toLowerCase())) {
|
||||
const target = join(publicDir, ent.name);
|
||||
if (existsSync(target)) {
|
||||
collisions.push({ kept: target, skipped: p });
|
||||
} else {
|
||||
copyFileSync(p, target);
|
||||
copied++;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
walk(join(captureDir, "assets"));
|
||||
walk(join(captureDir, "screenshots"));
|
||||
return { copied, collisions };
|
||||
}
|
||||
|
||||
// Step 2b: copy self-hosted brand fonts (Phase 1b's download-fonts.mjs writes
|
||||
// them into design-system/fonts/) → public/fonts/ so the renderer resolves the
|
||||
// @font-face url()s that index.html declares.
|
||||
export function copyBrandFonts(designSystemDir, publicDir) {
|
||||
const fontsSrcDir = join(designSystemDir, "fonts");
|
||||
let fontsCopied = 0;
|
||||
if (existsSync(fontsSrcDir)) {
|
||||
const fontsDestDir = join(publicDir, "fonts");
|
||||
mkdirSync(fontsDestDir, { recursive: true });
|
||||
for (const ent of readdirSync(fontsSrcDir, { withFileTypes: true })) {
|
||||
if (!ent.isFile()) continue;
|
||||
if (!FONT_EXTS.has(extname(ent.name).toLowerCase())) continue;
|
||||
const src = join(fontsSrcDir, ent.name);
|
||||
const dest = join(fontsDestDir, ent.name);
|
||||
if (!existsSync(dest)) {
|
||||
copyFileSync(src, dest);
|
||||
fontsCopied++;
|
||||
}
|
||||
}
|
||||
}
|
||||
return fontsCopied;
|
||||
}
|
||||
|
||||
// Step 2c: pull the @font-face block out of design.html (download-fonts.mjs wraps
|
||||
// its injection with two comment anchors), rewrite url('fonts/<file>') →
|
||||
// url('public/fonts/<file>') so paths resolve against the project root, and return
|
||||
// it for group_spec.font_face_css. @font-face is global by spec and cannot be
|
||||
// class-scoped — Phase 4c declares it once at the document root.
|
||||
export function extractFontFaceCss(designSystemDir) {
|
||||
let fontFaceCss = "";
|
||||
const designHtmlPath = join(designSystemDir, "design.html");
|
||||
if (existsSync(designHtmlPath)) {
|
||||
const designHtml = readFileSync(designHtmlPath, "utf8");
|
||||
const m = designHtml.match(
|
||||
/\/\*\s*===\s*auto-injected by download-fonts\.mjs\s*===\s*\*\/([\s\S]*?)\/\*\s*===\s*end download-fonts\.mjs block\s*===\s*\*\//,
|
||||
);
|
||||
if (m) {
|
||||
fontFaceCss = m[1].trim().replace(/url\(\s*(['"]?)fonts\//g, "url($1public/fonts/");
|
||||
}
|
||||
}
|
||||
return fontFaceCss;
|
||||
}
|
||||
@@ -0,0 +1,113 @@
|
||||
// prep.mjs concern module — resolve the design-system chunk library (Phase 1b's
|
||||
// emit-chunks.mjs output) onto each scene, and extract the :root brand-tokens
|
||||
// block. Split out of prep.mjs (Step 4b). Mutates scenes[].design_chunks in place
|
||||
// and appends to the shared anomalies array; returns chunksIndex for the summary.
|
||||
import { existsSync, readFileSync } from "node:fs";
|
||||
import { join } from "node:path";
|
||||
import { die } from "./prep-log.mjs";
|
||||
|
||||
// Phase 1b's emit-chunks.mjs writes design-system/chunks/{tokens.css, easings.js,
|
||||
// components/<id>.html, index.json}. Downstream Phase 4b workers read only the
|
||||
// chunks listed in their dispatch — never design.html — cutting per-worker
|
||||
// must-read load by ~4× (12 KB design.html → 1-3 KB per chunk file).
|
||||
//
|
||||
// Resolution policy:
|
||||
// - chunks/index.json missing → degrade gracefully: design_chunks = null
|
||||
// for every scene, log an anomaly, and let
|
||||
// the worker fall back to reading design.html.
|
||||
// - index.json present → every scene gets tokens_file + easings_file
|
||||
// + the FULL component library (worker picks).
|
||||
export function resolveDesignChunks({ designSystemDir, scenes, anomalies }) {
|
||||
const chunksDir = join(designSystemDir, "chunks");
|
||||
const chunksIndexPath = join(chunksDir, "index.json");
|
||||
let chunksIndex = null;
|
||||
if (existsSync(chunksIndexPath)) {
|
||||
try {
|
||||
chunksIndex = JSON.parse(readFileSync(chunksIndexPath, "utf8"));
|
||||
} catch (e) {
|
||||
anomalies.push(
|
||||
`design-system/chunks/index.json present but unreadable (${e.message}) — workers will fall back to design.html`,
|
||||
);
|
||||
}
|
||||
} else {
|
||||
anomalies.push(
|
||||
`design-system/chunks/ missing — Phase 1b's emit-chunks.mjs was not run. Workers will fall back to reading design.html (slower).`,
|
||||
);
|
||||
}
|
||||
|
||||
let availableComponents = null;
|
||||
if (chunksIndex) {
|
||||
availableComponents = new Map(
|
||||
(chunksIndex.components || []).map((c) => [c.id, join(designSystemDir, c.file)]),
|
||||
);
|
||||
}
|
||||
|
||||
for (const s of scenes) {
|
||||
if (!chunksIndex) {
|
||||
s.design_chunks = null;
|
||||
continue;
|
||||
}
|
||||
const tokensAbs = join(designSystemDir, chunksIndex.tokens_file || "chunks/tokens.css");
|
||||
const easingsAbs = join(designSystemDir, chunksIndex.easings_file || "chunks/easings.js");
|
||||
const voiceAbs = join(designSystemDir, chunksIndex.voice_file || "chunks/voice.md");
|
||||
if (!existsSync(tokensAbs))
|
||||
die(`design_chunks: tokens_file "${tokensAbs}" referenced by index.json but missing on disk`);
|
||||
if (!existsSync(easingsAbs))
|
||||
die(
|
||||
`design_chunks: easings_file "${easingsAbs}" referenced by index.json but missing on disk`,
|
||||
);
|
||||
if (!existsSync(voiceAbs))
|
||||
die(`design_chunks: voice_file "${voiceAbs}" referenced by index.json but missing on disk`);
|
||||
|
||||
// Optional chunks (null when preset declared no §H / §T). Worker reads
|
||||
// these on demand — paths are passed through dispatch verbatim. We only check
|
||||
// file existence when index.json references one (consistency guard); the
|
||||
// worker then opens it lazily without re-checking.
|
||||
const hintsAbs = chunksIndex.hints_file ? join(designSystemDir, chunksIndex.hints_file) : null;
|
||||
if (hintsAbs && !existsSync(hintsAbs))
|
||||
die(`design_chunks: hints_file "${hintsAbs}" referenced by index.json but missing on disk`);
|
||||
const typeRolesAbs = chunksIndex.type_roles_file
|
||||
? join(designSystemDir, chunksIndex.type_roles_file)
|
||||
: null;
|
||||
if (typeRolesAbs && !existsSync(typeRolesAbs))
|
||||
die(
|
||||
`design_chunks: type_roles_file "${typeRolesAbs}" referenced by index.json but missing on disk`,
|
||||
);
|
||||
|
||||
// Components are a style REFERENCE library, not a plan-time citation. Forward
|
||||
// EVERY available component to every worker; the worker picks which to use by
|
||||
// visual judgment (see agents/hyperframes-scene.md). Existence is guaranteed by
|
||||
// emit-chunks; filter defensively so a stale index entry never ships a missing path.
|
||||
const componentPaths = availableComponents
|
||||
? [...availableComponents.values()].filter((abs) => existsSync(abs))
|
||||
: [];
|
||||
s.design_chunks = {
|
||||
tokens_file: tokensAbs,
|
||||
easings_file: easingsAbs,
|
||||
voice_file: voiceAbs,
|
||||
hints_file: hintsAbs,
|
||||
type_roles_file: typeRolesAbs,
|
||||
components: componentPaths,
|
||||
};
|
||||
}
|
||||
|
||||
return { chunksIndex };
|
||||
}
|
||||
|
||||
// Extract the :root token block from tokens.css. tokens.css is a single global
|
||||
// :root {…} block (brand colors, font roles, spacing/radius). Emit it into
|
||||
// group_spec.brand_tokens_css so assemble-index.mjs can declare it ONCE in
|
||||
// index.html's <head>; CSS custom properties inherit through the light DOM into
|
||||
// every mounted sub-composition, so scenes reference var(--*) without re-declaring.
|
||||
export function extractBrandTokensCss(chunksIndex, designSystemDir) {
|
||||
let brandTokensCss = "";
|
||||
if (chunksIndex) {
|
||||
const tokensAbs = join(designSystemDir, chunksIndex.tokens_file || "chunks/tokens.css");
|
||||
if (existsSync(tokensAbs)) {
|
||||
const tokensRaw = readFileSync(tokensAbs, "utf8");
|
||||
const m = tokensRaw.match(/:root\s*\{[\s\S]*\}/);
|
||||
brandTokensCss = (m ? m[0] : tokensRaw).trim();
|
||||
}
|
||||
}
|
||||
return brandTokensCss;
|
||||
}
|
||||
@@ -0,0 +1,8 @@
|
||||
// Shared failure helper for prep.mjs and its concern modules (prep-assets,
|
||||
// prep-design, prep-section, prep-sfx). Keeps the "✗ prep.mjs:" prefix stable
|
||||
// across the split so error output is identical regardless of which module
|
||||
// raised it — the whole pipeline is still "prep" from the caller's point of view.
|
||||
export function die(msg) {
|
||||
console.error(`✗ prep.mjs: ${msg}`);
|
||||
process.exit(1);
|
||||
}
|
||||
@@ -0,0 +1,196 @@
|
||||
// prep.mjs concern module — parse section_plan.md (Phase 3) into the film-level
|
||||
// header + per-scene base records. Pure string→data; no disk access, no timing
|
||||
// merge (prep.mjs adds rule_paths / design_chunks / the duration ladder after).
|
||||
// Split out of prep.mjs (Step 3) — the densest single block in the file.
|
||||
//
|
||||
// section_plan.md anchors recognised:
|
||||
// **Effects:** — required, 2-5 backtick-wrapped rule ids
|
||||
// **Duration:** — required, positive float seconds
|
||||
// **Continuity:** — required, "break" | "continue" (scene 1 must be break);
|
||||
// drives WORKER GROUPING (a continue-run shares one worker).
|
||||
// **Blueprint:** — optional (soft, legacy), ignored.
|
||||
// **Transition:** — optional, how THIS scene is entered (Tier-B at a break seam).
|
||||
// **Bridge:** — optional (soft, legacy), ignored (Tier-A removed).
|
||||
// **Hierarchy:** — optional (validator-only signal; validate-section.mjs reads
|
||||
// it for the risk gate). Recognised here only so it advances
|
||||
// lastAnchorEnd and never leaks into creative_brief.
|
||||
// **SFX:** — optional (soft), bullet list of cue lines (scene-local t).
|
||||
// PrimarySubjectTimeline / Handoff are NOT recognised anchors here, so (per the
|
||||
// guide) they must appear after SFX to fall into creative_brief.
|
||||
import { die } from "./prep-log.mjs";
|
||||
|
||||
const ANCHORS = ["Effects", "Duration", "Continuity"];
|
||||
// Components/Surface anchors removed — the design system is a style REFERENCE,
|
||||
// not a plan-time contract (workers self-pick components from the forwarded
|
||||
// library; no scene-level surface commitment). Blueprint + Bridge are kept only as
|
||||
// legacy optional anchors so old plans do not leak them into creative_brief; both ignored.
|
||||
// `Hierarchy` is a validator-only signal (validate-section.mjs reads it for the
|
||||
// risk gate); recognise it here so it advances lastAnchorEnd and never leaks into
|
||||
// the worker's creative_brief.
|
||||
const OPTIONAL_ANCHORS = ["Blueprint", "Transition", "Bridge", "Hierarchy"];
|
||||
|
||||
function anchorRe(name) {
|
||||
return new RegExp(`^\\*\\*${name}:\\*\\*\\s*(.*)$`, "m");
|
||||
}
|
||||
|
||||
function parseSceneBlock(body, sceneId, isFirst) {
|
||||
const raw = {};
|
||||
let lastAnchorEnd = 0;
|
||||
for (const a of ANCHORS) {
|
||||
const m = body.match(anchorRe(a));
|
||||
if (!m) die(`${sceneId}: missing **${a}:** anchor in section_plan.md`);
|
||||
raw[a] = m[1].trim();
|
||||
const end = m.index + m[0].length;
|
||||
if (end > lastAnchorEnd) lastAnchorEnd = end;
|
||||
}
|
||||
// Optional anchors — include them in lastAnchorEnd when present to avoid leaking
|
||||
// into creative_brief; missing optional anchors are fine.
|
||||
for (const a of OPTIONAL_ANCHORS) {
|
||||
const m = body.match(anchorRe(a));
|
||||
if (m) {
|
||||
raw[a] = m[1].trim();
|
||||
const end = m.index + m[0].length;
|
||||
if (end > lastAnchorEnd) lastAnchorEnd = end;
|
||||
}
|
||||
}
|
||||
|
||||
// Effects: ordered backtick-wrapped ids inside [...]
|
||||
const effects = [...raw.Effects.matchAll(/`([^`]+)`/g)].map((m) => m[1]);
|
||||
if (effects.length === 0) die(`${sceneId}: **Effects:** has no backtick-wrapped ids`);
|
||||
|
||||
// Duration: leading float
|
||||
const durM = raw.Duration.match(/[\d.]+/);
|
||||
if (!durM) die(`${sceneId}: **Duration:** could not parse float from "${raw.Duration}"`);
|
||||
const estimatedDuration_s = parseFloat(durM[0]);
|
||||
if (!isFinite(estimatedDuration_s) || estimatedDuration_s <= 0)
|
||||
die(`${sceneId}: **Duration:** ${estimatedDuration_s} is not a positive float`);
|
||||
|
||||
// Continuity: break | continue (scene 1 must be break)
|
||||
const cont = raw.Continuity.toLowerCase();
|
||||
if (cont !== "break" && cont !== "continue")
|
||||
die(`${sceneId}: **Continuity:** must be "break" or "continue" (got "${raw.Continuity}")`);
|
||||
if (isFirst && cont !== "break") die(`${sceneId}: scene 1 must be **Continuity:** break`);
|
||||
|
||||
// Transition (OPTIONAL): how THIS scene is entered.
|
||||
// **Transition:** <type> [DIRECTION] [<dur>s]
|
||||
// Parsed loosely here (validator already shape-checked); null when absent so
|
||||
// Step 6.5 can default-fill. Scene 1's transition is the open (no between-
|
||||
// scene transition precedes it) — parsed but ignored at injection time.
|
||||
let transition = null;
|
||||
if (raw.Transition) {
|
||||
const tokens = raw.Transition.trim().split(/\s+/);
|
||||
const type = tokens[0].toLowerCase();
|
||||
let direction = null;
|
||||
let durationOverride = null;
|
||||
for (const tok of tokens.slice(1)) {
|
||||
if (/^[\d.]+s$/i.test(tok)) durationOverride = parseFloat(tok);
|
||||
else direction = tok.toUpperCase();
|
||||
}
|
||||
// Legacy Bridge anchor is intentionally ignored. Continue runs now use one
|
||||
// shared-DOM group composition; break seams use only Tier-B wrapper transitions.
|
||||
if (type) transition = { type, direction, duration_s: durationOverride, bridge_id: null };
|
||||
}
|
||||
|
||||
// SFX (optional / soft anchor; omitted entirely = no SFX for this scene):
|
||||
// **SFX:**
|
||||
// - `impact-bass-1.mp3` at 0.2s, volume 0.35 — hero snap
|
||||
// - `whoosh-short.mp3` at 4.1s — exit
|
||||
// (or `**SFX:** none`, or no anchor at all). The validator
|
||||
// (validate-section.mjs) no longer requires the anchor; when present it
|
||||
// checks each cited file against the manifest. This parser accepts either
|
||||
// form. "none" / any non-empty trailer skips the bullet scan (no cues).
|
||||
// sfx_cues[].t is SCENE-LOCAL seconds (this function knows nothing about
|
||||
// global timing; we add s.start_s offset in Step 6).
|
||||
const sfxCues = [];
|
||||
const sfxHeaderRe = /^\*\*SFX:\*\*[ \t]*(.*)$/m;
|
||||
const sfxHeaderM = body.match(sfxHeaderRe);
|
||||
if (sfxHeaderM) {
|
||||
const sfxHeaderEnd = sfxHeaderM.index + sfxHeaderM[0].length;
|
||||
if (sfxHeaderEnd > lastAnchorEnd) lastAnchorEnd = sfxHeaderEnd;
|
||||
}
|
||||
if (sfxHeaderM && sfxHeaderM[1].trim() === "") {
|
||||
const sfxHeaderEnd = sfxHeaderM.index + sfxHeaderM[0].length;
|
||||
const afterHeader = body.slice(sfxHeaderEnd);
|
||||
const lines = afterHeader.split("\n");
|
||||
let consumed = 0; // chars consumed past the header
|
||||
for (let li = 0; li < lines.length; li++) {
|
||||
const line = lines[li];
|
||||
const trimmed = line.trim();
|
||||
if (trimmed === "") {
|
||||
consumed += line.length + 1;
|
||||
continue;
|
||||
}
|
||||
if (!trimmed.startsWith("-")) break; // next anchor / prose / scene heading
|
||||
// Parse: `<file>.mp3` at <T>s[, volume <V>][, — <note>]
|
||||
const cueRe =
|
||||
/^[\s\-*]+`([^`]+\.mp3)`\s+at\s+([\d.]+)\s*s(?:[,\s]+volume\s+([\d.]+))?(?:\s*[—–-]\s*(.*))?$/;
|
||||
const m = trimmed.match(cueRe);
|
||||
if (m) {
|
||||
const file = m[1];
|
||||
const tLocal = parseFloat(m[2]);
|
||||
const volume = m[3] != null ? parseFloat(m[3]) : null;
|
||||
const note = m[4] ? m[4].trim() : "";
|
||||
if (!isFinite(tLocal) || tLocal < 0) {
|
||||
die(`${sceneId}: **SFX:** invalid t for "${file}": "${m[2]}"`);
|
||||
}
|
||||
sfxCues.push({ file, t_local: tLocal, volume, note });
|
||||
} else {
|
||||
die(`${sceneId}: **SFX:** unparseable cue line: "${trimmed}"`);
|
||||
}
|
||||
consumed += line.length + 1;
|
||||
}
|
||||
const sfxBlockEnd = sfxHeaderEnd + consumed;
|
||||
if (sfxBlockEnd > lastAnchorEnd) lastAnchorEnd = sfxBlockEnd;
|
||||
}
|
||||
|
||||
// creative_brief = everything after the LAST anchor line, verbatim
|
||||
const brief = body.slice(lastAnchorEnd).replace(/^\s*\n+/, "");
|
||||
|
||||
return {
|
||||
effects,
|
||||
estimatedDuration_s,
|
||||
continuity: cont,
|
||||
transition,
|
||||
sfxCues,
|
||||
creative_brief: brief,
|
||||
};
|
||||
}
|
||||
|
||||
// Parse the whole plan: the "## Film Direction" header (film-level invariants the
|
||||
// orchestrator forwards to every worker) + each "## Scene N:" block. Dies on a
|
||||
// missing required anchor / unparseable value; tolerant when Film Direction is
|
||||
// absent (legacy plans). Returns base scene records — prep.mjs layers rule_paths,
|
||||
// design_chunks and the audio-truth duration ladder on top.
|
||||
export function parseSectionPlan(planText) {
|
||||
const sceneHeadRe = /^## Scene\s+(\d+)\s*:\s*(.+?)\s*$/gm;
|
||||
const heads = [...planText.matchAll(sceneHeadRe)];
|
||||
if (heads.length === 0) die("no '## Scene N: <name>' headings found in section_plan.md");
|
||||
|
||||
// Film Direction: the film-level header (`## Film Direction` ... up to the first
|
||||
// `## Scene`). Written once by visual-design; the orchestrator prepends it to
|
||||
// every scene worker's shared packet header and to the finalize dispatch, so
|
||||
// per-scene creative_brief can stay deltas-only. validate-section.mjs enforces
|
||||
// presence and size; prep just extracts what is there (tolerant when absent).
|
||||
let film_direction = "";
|
||||
{
|
||||
const fdHead = planText.match(/^## Film Direction[ \t]*$/m);
|
||||
if (fdHead && fdHead.index < heads[0].index) {
|
||||
film_direction = planText.slice(fdHead.index + fdHead[0].length, heads[0].index).trim();
|
||||
}
|
||||
}
|
||||
|
||||
const scenes = [];
|
||||
for (let i = 0; i < heads.length; i++) {
|
||||
const m = heads[i];
|
||||
const sceneNumber = parseInt(m[1], 10);
|
||||
const sceneName = m[2].trim();
|
||||
const start = m.index + m[0].length;
|
||||
const end = i + 1 < heads.length ? heads[i + 1].index : planText.length;
|
||||
const body = planText.slice(start, end);
|
||||
const sceneId = `scene_${sceneNumber}`;
|
||||
const parsed = parseSceneBlock(body, sceneId, i === 0);
|
||||
scenes.push({ sceneNumber, sceneId, sceneName, ...parsed });
|
||||
}
|
||||
|
||||
return { film_direction, scenes };
|
||||
}
|
||||
@@ -0,0 +1,91 @@
|
||||
// prep.mjs concern module — resolve the SFX library and scene cues into globally
|
||||
// timed sfx records. Split out of prep.mjs (Step 6.5). Copies the opt-in library
|
||||
// into the project, validates each cue against manifest.json, and offsets each
|
||||
// cue's scene-local t by its scene start_s. Appends to the shared anomalies array
|
||||
// and returns the sorted sfx[] for group_spec.
|
||||
import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync } from "node:fs";
|
||||
import { join } from "node:path";
|
||||
import { die } from "./prep-log.mjs";
|
||||
|
||||
// SFX library is OPT-IN: when the orchestrator passes --sfx-lib the directory is
|
||||
// copied into <PROJECT_DIR>/assets/sfx/ and section_plan **SFX:** cues are
|
||||
// validated against manifest.json. Without --sfx-lib, scene cues are silently
|
||||
// dropped (warning only). Voice/bgm live under assets/; SFX matches.
|
||||
export function resolveSfx({ sfxLibDir, hyperframesDir, scenes, groups, anomalies }) {
|
||||
const sfx = [];
|
||||
if (sfxLibDir) {
|
||||
const sfxManifestPath = join(sfxLibDir, "manifest.json");
|
||||
if (!existsSync(sfxManifestPath)) {
|
||||
die(`--sfx-lib points to ${sfxLibDir} but manifest.json is missing`);
|
||||
}
|
||||
let sfxManifest;
|
||||
try {
|
||||
sfxManifest = JSON.parse(readFileSync(sfxManifestPath, "utf8"));
|
||||
} catch (e) {
|
||||
die(`sfx manifest.json parse: ${e.message}`);
|
||||
}
|
||||
// Build filename → { duration, key } lookup so cues can reference by filename
|
||||
// (matching v1 storyboard syntax: `impact-bass-1.mp3` not the manifest key).
|
||||
const sfxByFile = new Map();
|
||||
for (const [key, entry] of Object.entries(sfxManifest)) {
|
||||
if (entry?.file && isFinite(entry.duration)) {
|
||||
sfxByFile.set(entry.file, { key, duration: entry.duration });
|
||||
}
|
||||
}
|
||||
|
||||
// Copy entire SFX directory into <PROJECT_DIR>/assets/sfx/ (mp3 + manifest +
|
||||
// CREDITS). Idempotent: skip files that already exist (e.g. re-runs).
|
||||
const sfxDestDir = join(hyperframesDir, "assets", "sfx");
|
||||
mkdirSync(sfxDestDir, { recursive: true });
|
||||
let sfxCopied = 0;
|
||||
for (const ent of readdirSync(sfxLibDir, { withFileTypes: true })) {
|
||||
if (!ent.isFile()) continue;
|
||||
const src = join(sfxLibDir, ent.name);
|
||||
const dest = join(sfxDestDir, ent.name);
|
||||
if (!existsSync(dest)) {
|
||||
copyFileSync(src, dest);
|
||||
sfxCopied++;
|
||||
}
|
||||
}
|
||||
|
||||
// Resolve each scene's cues against manifest + add scene.start_s offset.
|
||||
for (const g of groups) {
|
||||
for (const sid of g.scene_ids) {
|
||||
const sceneEntry = g.scenes[sid];
|
||||
const sceneCues = scenes.find((x) => x.sceneId === sid)?.sfxCues || [];
|
||||
for (const cue of sceneCues) {
|
||||
const hit = sfxByFile.get(cue.file);
|
||||
if (!hit) {
|
||||
anomalies.push(
|
||||
`${sid}: SFX cue file "${cue.file}" not in manifest — dropping (known files: ${[...sfxByFile.keys()].slice(0, 5).join(", ")}${sfxByFile.size > 5 ? ", …" : ""})`,
|
||||
);
|
||||
continue;
|
||||
}
|
||||
const tGlobal = Number((sceneEntry.start_s + cue.t_local).toFixed(3));
|
||||
sfx.push({
|
||||
file: cue.file,
|
||||
t: tGlobal,
|
||||
duration: hit.duration,
|
||||
volume: cue.volume != null ? cue.volume : 0.35,
|
||||
scene_id: sid,
|
||||
t_local: cue.t_local,
|
||||
note: cue.note || "",
|
||||
});
|
||||
}
|
||||
}
|
||||
}
|
||||
// Sort by global t for predictable index.html emission order.
|
||||
sfx.sort((a, b) => a.t - b.t);
|
||||
console.log(` sfx lib copied: ${sfxCopied} file(s) → assets/sfx/`);
|
||||
} else {
|
||||
// Surface plan cues that won't make it to the timeline because no lib was provided.
|
||||
let droppedCueCount = 0;
|
||||
for (const s of scenes) droppedCueCount += s.sfxCues?.length || 0;
|
||||
if (droppedCueCount > 0) {
|
||||
anomalies.push(
|
||||
`section_plan declares ${droppedCueCount} SFX cue(s) but --sfx-lib not passed — all cues dropped`,
|
||||
);
|
||||
}
|
||||
}
|
||||
return sfx;
|
||||
}
|
||||
@@ -0,0 +1,20 @@
|
||||
// scratch-dir.mjs — private per-process scratch dir for audio.mjs intermediates
|
||||
// (narration .txt handoffs, detached-BGM logs).
|
||||
//
|
||||
// Bare `/tmp/<predictable-name>` writes are symlink-race exploitable on shared
|
||||
// hosts (CodeQL js/insecure-temporary-file): a co-located process can
|
||||
// pre-create the path as a symlink and redirect the write. mkdtempSync yields
|
||||
// an unpredictable, owner-only (0700) directory, so file names inside it can
|
||||
// stay deterministic. Deliberately never cleaned up here: the detached BGM
|
||||
// process keeps writing its log after audio.mjs exits; the OS tmp cleaner
|
||||
// reaps the directory like any other tmpdir() entry.
|
||||
import { mkdtempSync } from "node:fs";
|
||||
import { tmpdir } from "node:os";
|
||||
import { join } from "node:path";
|
||||
|
||||
let scratchDir = null;
|
||||
|
||||
export function scratchPath(name) {
|
||||
if (!scratchDir) scratchDir = mkdtempSync(join(tmpdir(), "hf-audio-"));
|
||||
return join(scratchDir, name);
|
||||
}
|
||||
@@ -0,0 +1,58 @@
|
||||
// Shared loader for the transition registry — the single source of truth for
|
||||
// PLV scene-to-scene transitions. Parses the ```json fenced block in
|
||||
// skills/hyperframes-animation/transitions/TRANSITION-REGISTRY.md so the
|
||||
// validator, prep, injector, and verifier all read the SAME vocabulary +
|
||||
// GSAP templates. No duplicated allow-lists.
|
||||
|
||||
import { readFileSync } from "node:fs";
|
||||
import { resolve, dirname } from "node:path";
|
||||
import { fileURLToPath } from "node:url";
|
||||
|
||||
const here = dirname(fileURLToPath(import.meta.url));
|
||||
|
||||
// scripts/lib/ -> ../../.. -> skills/ then into hyperframes-animation/transitions
|
||||
export const DEFAULT_REGISTRY_PATH = resolve(
|
||||
here,
|
||||
"../../../hyperframes-animation/transitions/TRANSITION-REGISTRY.md",
|
||||
);
|
||||
|
||||
let _cache = null;
|
||||
|
||||
// Parse the first ```json … ``` fenced block out of the registry markdown.
|
||||
export function loadTransitionRegistry(registryPath = DEFAULT_REGISTRY_PATH) {
|
||||
if (_cache && _cache.path === registryPath) return _cache.data;
|
||||
let md;
|
||||
try {
|
||||
md = readFileSync(registryPath, "utf8");
|
||||
} catch (e) {
|
||||
throw new Error(`transition registry not found at ${registryPath}: ${e.message}`);
|
||||
}
|
||||
const m = md.match(/```json\s*\n([\s\S]*?)\n```/);
|
||||
if (!m) throw new Error(`transition registry ${registryPath} has no \`\`\`json block`);
|
||||
let data;
|
||||
try {
|
||||
data = JSON.parse(m[1]);
|
||||
} catch (e) {
|
||||
throw new Error(`transition registry json parse failed: ${e.message}`);
|
||||
}
|
||||
if (!Array.isArray(data.transitions) || data.transitions.length === 0) {
|
||||
throw new Error(`transition registry json has no transitions[]`);
|
||||
}
|
||||
_cache = { path: registryPath, data };
|
||||
return data;
|
||||
}
|
||||
|
||||
// Convenience: a Map name -> transition record.
|
||||
export function transitionsByName(registryPath = DEFAULT_REGISTRY_PATH) {
|
||||
const data = loadTransitionRegistry(registryPath);
|
||||
const map = new Map();
|
||||
for (const t of data.transitions) map.set(t.name, t);
|
||||
return map;
|
||||
}
|
||||
|
||||
// The set of Tier-A type names (morph / shared-element) — not injectable in
|
||||
// Phase 1; a `break` boundary must never name one of these.
|
||||
export function tierATypes(registryPath = DEFAULT_REGISTRY_PATH) {
|
||||
const data = loadTransitionRegistry(registryPath);
|
||||
return new Set(data.tier_a_types || []);
|
||||
}
|
||||
Reference in New Issue
Block a user