dsh-hyperframes 0.9.1 → 0.9.3

package/skills/product-launch-video/scripts/stage-assets.test.mjs

@@ -1,52 +0,0 @@
-import assert from "node:assert/strict";
-import { existsSync, mkdirSync, mkdtempSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import test from "node:test";
-import { stageAssets } from "./lib/assets.mjs";
-
-// ── captured SVGs are stageable ──────────────────────────────────────────────
-// Regression: `hyperframes capture` extracts inline SVGs into capture/assets/svgs/
-// (assetDownloader.ts), and the capture manifest advertises them to the agent as
-// `assets/svgs/<name>.svg`, so a frame names one in `asset_candidates` exactly as
-// it names a screenshot. stageAssets only searched capture/{assets,assets/videos,
-// screenshots}, so every captured SVG resolved to nothing — reported as a
-// non-fatal anomaly, and the frame 404'd the logo it had been told to use.
-
-function projectWithCapturedSvg() {
-  const dir = mkdtempSync(join(tmpdir(), "product-launch-stage-assets-"));
-  mkdirSync(join(dir, "capture/assets/svgs"), { recursive: true });
-  mkdirSync(join(dir, "capture/screenshots"), { recursive: true });
-  writeFileSync(join(dir, "capture/assets/svgs/brand-mark.svg"), "<svg/>");
-  writeFileSync(join(dir, "capture/screenshots/hero.png"), "png");
-  return dir;
-}
-
-const frames = [
-  { extra: { asset_candidates: "assets/svgs/brand-mark.svg — the mark; assets/hero.png — hero" } },
-];
-
-test("stages an SVG that capture wrote into capture/assets/svgs/", () => {
-  const dir = projectWithCapturedSvg();
-
-  const { staged, wanted, anomalies } = stageAssets({ hyperframesDir: dir, frames });
-
-  assert.equal(wanted.size, 2);
-  assert.equal(staged, 2, `expected both assets staged, got anomalies: ${anomalies.join("; ")}`);
-  assert.deepEqual(anomalies, []);
-  assert.ok(existsSync(join(dir, "assets/brand-mark.svg")));
-  assert.ok(existsSync(join(dir, "assets/hero.png")));
-});
-
-test("still reports an asset that exists nowhere under capture/", () => {
-  const dir = projectWithCapturedSvg();
-
-  const { staged, anomalies } = stageAssets({
-    hyperframesDir: dir,
-    frames: [{ extra: { asset_candidates: "assets/svgs/absent.svg — never captured" } }],
-  });
-
-  assert.equal(staged, 0);
-  assert.equal(anomalies.length, 1);
-  assert.match(anomalies[0], /absent\.svg/);
-});

package/skills/product-launch-video/scripts/transitions.mjs

@@ -1,383 +0,0 @@
-#!/usr/bin/env node
-// transitions.mjs — inter-frame transition injector + verifier for the video workflow.
-//
-//   inject  — read STORYBOARD frame order + each frame's transition_in, overlap
-//             the frame clip wrappers in index.html, and stamp the GSAP template.
-//   verify  — deterministic gate over the injector's output.
-//
-// transition_in (written by story-design on the INCOMING frame) names a registry
-// type directly: crossfade | blur-crossfade | push-slide | zoom-through | squeeze,
-// optionally "<type> <DIR>" / "<type> <N>s" (e.g. "push-slide LEFT", "crossfade
-// 0.4s"). `cut` / `none` / empty ⇒ hard cut (no overlap, no stamp).
-//
-// Mechanics — EXTEND-OUTGOING-ONLY (keeps voice/SFX/captions synced; their timing
-// is keyed to the original frame start). At boundary i→i+1 (type = the incoming
-// frame's transition_in): extend ONLY the outgoing wrapper's data-duration by
-// `dur` so it holds its final frame across the window; do NOT move any data-start;
-// the incoming — already present from the cut on a higher track — fades/pushes in
-// over it. Then 0/1-ping-pong ALL frame clips' data-track-index (adjacent
-// overlapping wrappers never share a track — lint timeline_track_too_dense) and
-// stamp the token-substituted GSAP template into __timelines["main"] at T =
-// incoming start. captions(2)/voice(10)/bgm(11)/sfx(20+) are never touched.
-//
-//   node transitions.mjs inject --storyboard ./STORYBOARD.md --hyperframes .
-//   node transitions.mjs verify --storyboard ./STORYBOARD.md --index ./index.html
-
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { join, resolve } from "node:path";
-import { parseStoryboard } from "./lib/storyboard.mjs";
-import { parseFormat } from "./lib/dimensions.mjs";
-import { loadTransitionRegistry, transitionsByName } from "./lib/transition-registry.mjs";
-import { padFrameInternalDuration } from "./lib/pad-frame-duration.mjs";
-
-const flag = (argv, name, def) => {
-  const i = argv.indexOf(`--${name}`);
-  return i >= 0 && i + 1 < argv.length ? argv[i + 1] : def;
-};
-const NO_TRANSITION = new Set(["cut", "none", ""]);
-const r3 = (x) => Number(x.toFixed(3));
-
-// transition_in → { type, direction?, dur? } | null (hard cut).
-function parseTransitionIn(raw) {
-  const s = (raw ?? "").trim();
-  if (NO_TRANSITION.has(s.toLowerCase())) return null;
-  const parts = s.split(/\s+/);
-  const spec = { type: parts[0].toLowerCase() };
-  for (const p of parts.slice(1)) {
-    const m = p.match(/^(\d+(?:\.\d+)?)s?$/);
-    if (m) spec.dur = Number(m[1]);
-    else spec.direction = p.toUpperCase();
-  }
-  return spec;
-}
-
-// Mounted STORYBOARD frames present in index.html, in document order: { id, frame }.
-function mountedFramesInOrder(manifest, html) {
-  const out = [];
-  for (const f of manifest.frames) {
-    if (!f.src) continue;
-    const id = f.src
-      .split("/")
-      .pop()
-      .replace(/\.html?$/i, "");
-    if (html.includes(`id="el-${id}"`)) out.push({ id, frame: f });
-  }
-  return out;
-}
-
-// Frame clip wrappers parsed out of index.html (ids carry hyphens; excludes
-// el-captions and audio by keying off the known frame-id set). The id is matched
-// from anywhere in the tag's attribute list — never assume it is the first attribute
-// (the index assembler emits data-hf-id before id, so an id-first regex finds nothing
-// and inject crashes on the empty clip map).
-function parseFrameClips(html, frameIds) {
-  const clipRe = /<div\b([^>]*)><\/div>/g;
-  const clips = new Map();
-  let m;
-  while ((m = clipRe.exec(html)) !== null) {
-    const attrs = m[1];
-    const idm = attrs.match(/\bid="el-([A-Za-z0-9_-]+)"/);
-    if (!idm || !frameIds.has(idm[1])) continue;
-    const num = (re) => {
-      const x = attrs.match(re);
-      return x ? Number(x[1]) : null;
-    };
-    clips.set(idm[1], {
-      id: idm[1],
-      block: m[0],
-      start: num(/data-start="([\d.]+)"/),
-      duration: num(/data-duration="([\d.]+)"/),
-      track: num(/data-track-index="(\d+)"/) ?? 0,
-    });
-  }
-  return clips;
-}
-
-// The host wrapper is extended across an outgoing transition, so the mounted
-// frame must remain visually populated for the same local-time window. Extend
-// the frame root and every non-audio timed element that reached the original
-// storyboard boundary. This also repairs worker files whose root was already
-// inflated while their ground/content clips still ended at the synced duration.
-function extendFrameTail(hyperframesDir, frame, baseDuration, targetDuration, die) {
-  if (!frame?.src || targetDuration <= baseDuration) return;
-  const framePath = join(hyperframesDir, frame.src);
-  let html;
-  try {
-    html = readFileSync(framePath, "utf8");
-  } catch {
-    die(`outgoing frame file not found at ${framePath}`);
-  }
-
-  const compId = frame.src
-    .split("/")
-    .pop()
-    .replace(/\.html?$/i, "");
-  const EPS = 0.011;
-  let foundRoot = false;
-  let extended = 0;
-  const rewritten = html.replace(/<([A-Za-z][\w:-]*)\b([^>]*)>/g, (tag, name, attrs) => {
-    const durationMatch = attrs.match(/\bdata-duration="([\d.]+)"/);
-    const compositionMatch = attrs.match(/\bdata-composition-id="([^"]+)"/);
-    if (compositionMatch?.[1] === compId && !foundRoot) {
-      foundRoot = true;
-      return durationMatch
-        ? tag.replace(/\bdata-duration="[\d.]+"/, `data-duration="${targetDuration}"`)
-        : tag.replace(/(\s*\/?>)$/, ` data-duration="${targetDuration}"$1`);
-    }
-
-    if (!durationMatch) return tag;
-    const duration = Number(durationMatch[1]);
-    if (!Number.isFinite(duration)) return tag;
-
-    if (name.toLowerCase() === "audio") return tag;
-    const startMatch = attrs.match(/\bdata-start="([\d.]+)"/);
-    if (!startMatch) return tag;
-    const start = Number(startMatch[1]);
-    const end = start + duration;
-    if (end < baseDuration - EPS || end >= targetDuration - EPS) return tag;
-    extended++;
-    return tag.replace(/\bdata-duration="[\d.]+"/, `data-duration="${r3(targetDuration - start)}"`);
-  });
-
-  if (!foundRoot) die(`${frame.src} has no data-composition-id="${compId}" root`);
-  writeFileSync(framePath, rewritten);
-  console.log(
-    `  ${compId}: extended root + ${extended} tail clip(s) ${baseDuration}s→${targetDuration}s`,
-  );
-}
-
-// Resolve a transition_in spec to a registry record (calm default on unknown).
-function resolveRecord(spec, byName, reg, warn) {
-  let rec = byName.get(spec.type);
-  if (!rec) {
-    rec = byName.get(reg.default_calm);
-    warn(`transition_in "${spec.type}" not in registry — using ${reg.default_calm}`);
-  }
-  return rec;
-}
-function resolveDur(spec, rec, reg) {
-  let dur = spec.dur ?? rec.default_duration_s ?? 0.5;
-  return Math.min(dur, reg.max_duration_s ?? 2.0);
-}
-
-// GSAP lines for one transition record (token substitution).
-function buildGsap(rec, fromId, toId, dur, T, direction, canvasW, canvasH, die) {
-  const subs = {
-    __OLD__: `"#el-${fromId}"`,
-    __NEW__: `"#el-${toId}"`,
-    __T__: String(T),
-    __DUR__: String(dur),
-  };
-  let template;
-  if (rec.directions && rec.directions.length > 0) {
-    const dir = (direction || rec.default_direction || rec.directions[0]).toUpperCase();
-    const vertical = dir === "UP" || dir === "DOWN";
-    template = vertical ? rec.gsap_template_vertical : rec.gsap_template_horizontal;
-    if (!template)
-      die(`transition ${rec.name}: missing ${vertical ? "vertical" : "horizontal"} template`);
-    if (vertical) {
-      const dy = dir === "UP" ? -canvasH : canvasH;
-      subs.__DY__ = String(dy);
-      subs.__DYIN__ = String(-dy);
-    } else {
-      const dx = dir === "LEFT" ? -canvasW : canvasW;
-      subs.__DX__ = String(dx);
-      subs.__DXIN__ = String(-dx);
-    }
-  } else {
-    template = rec.gsap_template;
-    if (!template) die(`transition ${rec.name}: missing gsap_template`);
-  }
-  return template.map((line) => {
-    let out = line;
-    for (const [k, v] of Object.entries(subs)) out = out.split(k).join(v);
-    return out;
-  });
-}
-
-function runInject(argv) {
-  const hyperframesDir = resolve(flag(argv, "hyperframes", "."));
-  const storyboardPath = resolve(flag(argv, "storyboard", join(hyperframesDir, "STORYBOARD.md")));
-  const indexPath = join(hyperframesDir, "index.html");
-  const die = (msg) => {
-    console.error(`✗ transitions inject: ${msg}`);
-    process.exit(1);
-  };
-
-  if (!existsSync(storyboardPath)) die(`STORYBOARD.md not found at ${storyboardPath}`);
-
-  const manifest = parseStoryboard(readFileSync(storyboardPath, "utf8"));
-  const { width: CW, height: CH } = parseFormat(manifest.globals.format);
-  const reg = loadTransitionRegistry();
-  const byName = transitionsByName();
-
-  // Read directly and handle ENOENT here, rather than an existsSync precheck —
-  // the check→write pair (write-back below) is a TOCTOU race CodeQL flags.
-  let html = "";
-  try {
-    html = readFileSync(indexPath, "utf8");
-  } catch {
-    die(`index.html not found at ${indexPath} — run assemble-index.mjs first`);
-  }
-  const order = mountedFramesInOrder(manifest, html);
-  if (order.length === 0) die("no frame clips found in index.html");
-  const frameIds = new Set(order.map((x) => x.id));
-  const clips = parseFrameClips(html, frameIds);
-
-  const gsapLines = [];
-  const applied = [];
-  for (let i = 1; i < order.length; i++) {
-    const spec = parseTransitionIn(order[i].frame.transitionIn);
-    if (!spec) continue; // hard cut
-    const incoming = clips.get(order[i].id);
-    const outgoing = clips.get(order[i - 1].id);
-    const rec = resolveRecord(spec, byName, reg, (m) =>
-      console.error(`  ! frame ${order[i].id}: ${m}`),
-    );
-    const dur = resolveDur(spec, rec, reg);
-    const T = r3(incoming.start); // cut = incoming start (frames tile)
-    const baseDuration = outgoing.duration;
-    outgoing.duration = r3(baseDuration + dur); // extend outgoing only
-    extendFrameTail(hyperframesDir, order[i - 1].frame, baseDuration, outgoing.duration, die);
-    padFrameInternalDuration(
-      hyperframesDir,
-      order[i - 1].frame.src,
-      outgoing.id,
-      outgoing.duration,
-    );
-    gsapLines.push(
-      ...buildGsap(rec, outgoing.id, incoming.id, dur, T, spec.direction, CW, CH, die),
-    );
-    applied.push({ from: outgoing.id, to: incoming.id, type: rec.name, dur, T });
-  }
-
-  if (applied.length === 0) {
-    console.log(`✓ transitions inject: 0 transitions (all cuts) — index.html unchanged`);
-    return;
-  }
-
-  // 0/1 ping-pong all frame clips in play order.
-  const ordered = [...clips.values()].sort((a, b) => a.start - b.start || a.id.localeCompare(b.id));
-  ordered.forEach((c, i) => {
-    c.track = i % 2;
-  });
-
-  // rewrite each clip block: start unchanged; duration possibly extended; track ping-ponged.
-  for (const c of clips.values()) {
-    const nb = c.block
-      .replace(/data-duration="[\d.]+"/, `data-duration="${c.duration}"`)
-      .replace(/data-track-index="\d+"/, `data-track-index="${c.track}"`);
-    html = html.replace(c.block, nb);
-  }
-
-  // stamp the GSAP after the master timeline anchor.
-  const anchor = 'window.__timelines["main"] = gsap.timeline({ paused: true });';
-  if (!html.includes(anchor)) die("master timeline anchor not found in index.html");
-  // The transition tweens alone leave window.__timelines["main"] spanning only the
-  // last transition (e.g. 24.7s), shorter than the real composition. The Studio
-  // reads main.duration() as its master duration and parses clips against it, so a
-  // short master collapses its timeline (clips dropped, duration wrong, blank stage)
-  // — the render engine is unaffected (it trusts the root data-duration attr). Stamp
-  // a full-span anchor so main.duration() == composition total. Mirrors the
-  // `tl.to({}, { duration })` anchor captions.html already uses.
-  const rootDurMatch = html.match(/data-composition-id="main"[^>]*?data-duration="([\d.]+)"/);
-  const totalDur = rootDurMatch ? Number(rootDurMatch[1]) : null;
-  const block = [
-    anchor,
-    "      // ── frame transitions (injected by transitions.mjs) ──",
-    '      (function () { var tl = window.__timelines["main"];',
-    ...gsapLines.map((l) => "        " + l),
-    ...(totalDur
-      ? [
-          `        tl.to({}, { duration: ${totalDur} }, 0); // full-span anchor — main.duration() == composition total (Studio master duration)`,
-        ]
-      : []),
-    "      })();",
-  ].join("\n");
-  html = html.replace(anchor, block);
-
-  writeFileSync(indexPath, html);
-  console.log(`✓ transitions inject: ${applied.length} transition(s) stamped into index.html`);
-  for (const a of applied) console.log(`  ${a.from}→${a.to}: ${a.type} ${a.dur}s @ T=${a.T}s`);
-  const tracks = ordered
-    .map((c) => `${c.id}[t${c.track} ${c.start}→${r3(c.start + c.duration)}]`)
-    .join(" ");
-  console.log(`  tracks: ${tracks}`);
-}
-
-function runVerify(argv) {
-  const hyperframesDir = resolve(flag(argv, "hyperframes", "."));
-  const storyboardPath = resolve(flag(argv, "storyboard", join(hyperframesDir, "STORYBOARD.md")));
-  const indexPath = resolve(flag(argv, "index", join(hyperframesDir, "index.html")));
-  const bail = (msg) => {
-    console.error(`✗ transitions verify: ${msg}`);
-    process.exit(1);
-  };
-
-  if (!existsSync(storyboardPath)) bail("STORYBOARD.md not found");
-  if (!existsSync(indexPath)) bail("index.html not found");
-
-  const manifest = parseStoryboard(readFileSync(storyboardPath, "utf8"));
-  const html = readFileSync(indexPath, "utf8");
-  const order = mountedFramesInOrder(manifest, html);
-  const frameIds = new Set(order.map((x) => x.id));
-  const clips = parseFrameClips(html, frameIds);
-
-  const EPS = 0.011;
-  const overlaps = (a, b) =>
-    a.start < b.start + b.duration - EPS && b.start < a.start + a.duration - EPS;
-  const fail = [];
-
-  // (4) global no same-track overlap. This is this workflow's own lane convention,
-  //     not a lint rule: nothing in the framework rejects same-track overlap.
-  const all = [...clips.values()];
-  for (let i = 0; i < all.length; i++)
-    for (let j = i + 1; j < all.length; j++) {
-      const a = all[i];
-      const b = all[j];
-      if (a.track === b.track && overlaps(a, b))
-        fail.push(`same-track overlap: ${a.id}[t${a.track}] & ${b.id}[t${b.track}]`);
-    }
-
-  const bm = html.match(/frame transitions \(injected[\s\S]*?\}\)\(\);/);
-  const txBlock = bm ? bm[0] : "";
-
-  let expected = 0;
-  for (let i = 1; i < order.length; i++) {
-    const spec = parseTransitionIn(order[i].frame.transitionIn);
-    if (!spec) continue;
-    expected++;
-    const to = clips.get(order[i].id);
-    const from = clips.get(order[i - 1].id);
-    if (!to || !from) {
-      fail.push(`boundary ${order[i - 1].id}→${order[i].id}: wrapper missing`);
-      continue;
-    }
-    if (!txBlock.includes(`"#el-${from.id}"`) || !txBlock.includes(`"#el-${to.id}"`))
-      fail.push(`boundary ${from.id}→${to.id}: injected block does not reference both ids`);
-    const overlapAmt = r3(from.start + from.duration - to.start);
-    if (overlapAmt <= 0) fail.push(`boundary ${from.id}→${to.id}: no overlap (${overlapAmt}s)`);
-    if (from.track === to.track)
-      fail.push(`boundary ${from.id}→${to.id}: both on track ${from.track}`);
-  }
-  if (expected > 0 && !txBlock)
-    fail.push(`${expected} transition(s) expected but no injected block found`);
-
-  if (fail.length) {
-    console.error(`✗ transitions verify: ${fail.length} failure(s):`);
-    for (const f of fail) console.error(`  - ${f}`);
-    process.exit(1);
-  }
-  console.log(
-    `✓ transitions verify: ${expected} transition(s) verified (cross-track, overlap>0, both ids referenced, no same-track overlap)`,
-  );
-}
-
-const sub = process.argv[2];
-const rest = process.argv.slice(3);
-if (sub === "inject") runInject(rest);
-else if (sub === "verify") runVerify(rest);
-else {
-  console.error("usage: node transitions.mjs <inject|verify> [args...]");
-  process.exit(2);
-}

package/skills/product-launch-video/scripts/transitions.test.mjs

@@ -1,68 +0,0 @@
-import assert from "node:assert/strict";
-import { spawnSync } from "node:child_process";
-import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import test from "node:test";
-
-const workflowScripts = [
-  ["product-launch-video", new URL("./transitions.mjs", import.meta.url).pathname],
-  ["pr-to-video", new URL("../../pr-to-video/scripts/transitions.mjs", import.meta.url).pathname],
-];
-
-function runInject(script, rootId) {
-  const project = mkdtempSync(join(tmpdir(), "hf-transition-root-"));
-  const framesDir = join(project, "compositions", "frames");
-  mkdirSync(framesDir, { recursive: true });
-  writeFileSync(
-    join(project, "STORYBOARD.md"),
-    `---\nformat: 1920x1080\n---\n\n## Frame 1 — First\n\n- duration: 3s\n- transition_in: cut\n- src: compositions/frames/frame-01.html\n\n## Frame 2 — Second\n\n- duration: 3s\n- transition_in: crossfade 0.5s\n- src: compositions/frames/frame-02.html\n`,
-  );
-  writeFileSync(
-    join(framesDir, "frame-01.html"),
-    `<div data-composition-id="${rootId}" data-width="1920" data-height="1080"><div class="clip" data-start="0" data-duration="3"></div></div>`,
-  );
-  writeFileSync(
-    join(framesDir, "frame-02.html"),
-    '<div data-composition-id="frame-02" data-duration="3"></div>',
-  );
-  writeFileSync(
-    join(project, "index.html"),
-    `<div data-composition-id="main" data-duration="6">
-      <div id="el-frame-01" data-start="0" data-duration="3" data-track-index="0"></div>
-      <div id="el-frame-02" data-start="3" data-duration="3" data-track-index="0"></div>
-    </div><script>window.__timelines = {}; window.__timelines["main"] = gsap.timeline({ paused: true });</script>`,
-  );
-  const result = spawnSync(
-    process.execPath,
-    [script, "inject", "--storyboard", join(project, "STORYBOARD.md"), "--hyperframes", project],
-    { encoding: "utf8" },
-  );
-  return {
-    project,
-    result,
-    frameHtml: () => readFileSync(join(framesDir, "frame-01.html"), "utf8"),
-  };
-}
-
-for (const [workflow, script] of workflowScripts) {
-  test(`${workflow} inserts duration on a valid durationless frame root`, () => {
-    const fixture = runInject(script, "frame-01");
-    try {
-      assert.equal(fixture.result.status, 0, fixture.result.stderr);
-      assert.match(fixture.frameHtml(), /data-composition-id="frame-01"[^>]*data-duration="3\.5"/);
-    } finally {
-      rmSync(fixture.project, { recursive: true, force: true });
-    }
-  });
-
-  test(`${workflow} still rejects a genuinely mismatched frame root`, () => {
-    const fixture = runInject(script, "wrong-root");
-    try {
-      assert.notEqual(fixture.result.status, 0);
-      assert.match(fixture.result.stderr, /has no data-composition-id="frame-01" root/);
-    } finally {
-      rmSync(fixture.project, { recursive: true, force: true });
-    }
-  });
-}

package/skills/product-launch-video/sub-agents/frame-worker.md

@@ -1,21 +0,0 @@
-# Frame worker — product-launch delta
-
-> The shared law is the core contract above (the packet builder prepends `../hyperframes/references/frame-worker-core.md` to this file as `_role.md`) — read the two as one role. This file carries only what's specific to a product-launch frame; you run N-up, **one frame each** — your dispatch carries exactly one packet. Tempted to add a generic GSAP / timeline rule here? Wrong home — it belongs in the core contract or `hyperframes-core`.
-
-## Your `focal:` / `roles:` — real captured media
-
-- `focal:` — which candidate is the hero.
-- `roles:` — each candidate's role: `cutout` foreground / `background` full-bleed / supporting — plus the real media available (each `public/<basename> — description`; a **`[video]`** tag marks a `.mp4` motion source that cannot be mounted by this sub-composition worker).
-- **Asset paths are project-root relative everywhere.** This includes HTML attributes and CSS `url(...)` values such as `@font-face src`: use `assets/...` (or the supplied `capture/assets/...` path), never `../` or `../../`. Shared fonts are staged before dispatch so every parallel frame resolves the same local files; never fall back to a network `@import`.
-
-## Placing candidates (product-launch constraint)
-
-**Place each candidate by its `roles`** (the `focal` is the hero): a `cutout` is a foreground subject — respect the 83% keep-out, lay text around it, not over its face; a `background` is full-bleed and dimmed ~30–50% so foreground content stays legible. Frame files are sub-compositions. Audio remains orchestrator-owned: never author `<audio>` in a frame. An approved `[video]` candidate may be declared as a frame-local `<video data-frame-video="approved" data-start="..." data-duration="..." data-track-index="...">`; `assemble-index.mjs` hoists it to the host root and translates its timing. Give every approved video explicit host geometry with numeric `data-frame-video-x`, `data-frame-video-y`, `data-frame-video-width`, and `data-frame-video-height`; optionally set `data-frame-video-fit="cover|contain|fill|none|scale-down"` (default `cover`). The assembler converts only those values to host CSS: frame-local classes and inline styles do not cross the hoist boundary. Do not use this declaration for audio, unapproved URLs, or videos without explicit timing and geometry. If no approved video is supplied, use an explicitly supplied static still/key art (`[video-still]` or another image candidate) as `<img>`; do not extract a frame, fabricate a URL, or silently embed an unapproved clip.
-
-When a frame showcases a captured website, use the supplied screenshot as the page. Do not rebuild the full site in HTML: even a close recreation can change the real layout, spacing, or branding. If the shot needs motion inside the page, overlay the supplied real assets at measured positions or rebuild only the moving component.
-
-Brand text comes from your frame's `scene` / narrative — never from `frame.md` (a style spec, not the product's content). Place the named assets, and never invent new ones.
-
-## Cross-frame handoffs
-
-If the packet includes `handoff_in:` or `handoff_out:`, treat those values as a hard boundary contract. Start or end the named element at the exact x/y position, scale, opacity, and motion direction/speed provided; a field the packet states as unchanged is still binding, not optional. Do not restyle or reinterpret that boundary state. The neighboring frame is being built by another worker and will use the matching values.

package/skills/talking-head-recut/NOTICE.md

@@ -1,39 +0,0 @@
-# Attribution
-
-The `talking-head-recut` skill (its card-based design system — styles, layouts, frames,
-fonts, and the GSAP-driven composition workflow) is **adapted from** the open-source
-**vtake-skills** project (`vtake-cut`):
-
-> https://github.com/notedit/vtake-skills
-
-Adaptations for this repo: renamed to `talking-head-recut`; transcription repointed to
-local Whisper via `hyperframes transcribe` (dropping the third-party `@notedit/vtake`
-CLI and the `vtake.app` proxy); audio/metadata extraction inlined with `ffmpeg`/`ffprobe`;
-the fixed third-party brand outro removed in favour of an optional, neutral outro;
-artifacts aligned to the `videos/<project>/` convention.
-
-The original is MIT-licensed; its notice is retained below as required.
-
-```
-MIT License
-
-Copyright (c) 2026 leeoxiang
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-```