Add HyperFrames skills

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011h6NB8JQtfPc6eRCefEzBB

.agents/skills/media-use/audio/scripts/lib/host-audio.test.mjs

@@ -0,0 +1,106 @@
+import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
+import test from "node:test";
+import { hostAudio, keepHostAudio } from "./host-audio.mjs";
+
+const onDisk = new Set([
+  "assets/bgm/host.mp3",
+  "assets/sfx/custom-whoosh.mp3",
+  "assets/sfx/whoosh.mp3",
+]);
+const exists = (path) => onDisk.has(path);
+const hostWhoosh = {
+  frame: 1,
+  file: "assets/sfx/custom-whoosh.mp3",
+  offset_s: 0,
+  duration_s: 2,
+  source: "host",
+};
+
+test("a host sound and bed survive a rebuild, and the host's frame takes no looked-up sound", () => {
+  const previous = {
+    bgm: { path: "assets/bgm/host.mp3", source: "host" },
+    sfx: [hostWhoosh, { frame: 2, file: "assets/sfx/whoosh.mp3", offset_s: 0 }],
+  };
+  const rebuilt = {
+    bgm: null,
+    voices: [],
+    sfx: [
+      { frame: 1, file: "assets/sfx/whoosh.mp3", offset_s: 0 },
+      { frame: 2, file: "assets/sfx/whoosh.mp3", offset_s: 0 },
+    ],
+  };
+  const kept = keepHostAudio(rebuilt, hostAudio(previous, exists));
+  assert.deepEqual(kept.bgm, previous.bgm);
+  assert.deepEqual(kept.sfx, [hostWhoosh, rebuilt.sfx[1]]);
+});
+
+test("an unmarked entry or a missing file is not the host's", () => {
+  const previous = {
+    bgm: { path: "assets/bgm/gone.mp3", source: "host" },
+    sfx: [
+      { frame: 1, file: "assets/sfx/whoosh.mp3", offset_s: 0 },
+      { frame: 3, file: "assets/sfx/gone.mp3", source: "host" },
+    ],
+  };
+  const host = hostAudio(previous, exists);
+  assert.equal(host.bgm, null);
+  assert.deepEqual(host.sfx, []);
+  const rebuilt = { bgm: { path: "assets/bgm/looked.mp3" }, voices: [], sfx: [] };
+  assert.deepEqual(keepHostAudio(rebuilt, host), rebuilt);
+});
+
+test("no earlier audio_meta.json keeps the rebuild as it is", () => {
+  const rebuilt = { bgm: null, voices: [], sfx: [{ frame: 1, file: "assets/sfx/whoosh.mp3" }] };
+  assert.deepEqual(keepHostAudio(rebuilt, hostAudio(null, exists)), rebuilt);
+});
+
+// The narrated workflows tell the agent the same host-audio contract and the same meaning of silent.
+const workflowText = (skill, file) =>
+  readFileSync(new URL(`../../../../${skill}/${file}`, import.meta.url), "utf8");
+
+test("each narrated workflow tells a host app's music and sounds the way in, and when a film is silent", () => {
+  for (const skill of ["product-launch-video", "pr-to-video", "faceless-explainer"]) {
+    const steps = workflowText(skill, "SKILL.md");
+    assert.match(
+      steps,
+      /host app's own tools make the music or a sound effect[^\n]+"source": "host"/,
+      skill,
+    );
+    assert.match(steps, /"duration_s": <its length>[^\n]+Every audio pass keeps these/, skill);
+    assert.match(steps, /no `SCRIPT.md`, \*\*and\*\* no `sfx:` cues or host audio/, skill);
+    assert.match(
+      steps,
+      /marked silent \(`music: none`, no `SCRIPT.md`, no `sfx:` cues or host audio\)/,
+      skill,
+    );
+    assert.match(
+      workflowText(skill, "references/story-design.md"),
+      /no `SCRIPT.md` \+ no `sfx:` cues or host audio\*\* — the canonical/,
+      skill,
+    );
+  }
+});
+
+test("a frame written as a string is the same frame, and a gone host file is reported", () => {
+  const previous = {
+    bgm: { path: "assets/bgm/gone.mp3", source: "host" },
+    sfx: [{ ...hostWhoosh, frame: "1" }],
+  };
+  const host = hostAudio(previous, exists);
+  assert.deepEqual(host.sfx, [hostWhoosh]);
+  assert.ok(host.frames.has(1));
+  assert.deepEqual(host.dropped, ["assets/bgm/gone.mp3 is not on disk"]);
+  const rebuilt = { bgm: null, voices: [], sfx: [{ frame: 1, file: "assets/sfx/whoosh.mp3" }] };
+  assert.deepEqual(keepHostAudio(rebuilt, host).sfx, [hostWhoosh]);
+});
+
+test("a host entry with no path is reported, not thrown", () => {
+  const throwsOnNonString = (path) => {
+    if (typeof path !== "string") throw new TypeError("path must be a string");
+    return onDisk.has(path);
+  };
+  const host = hostAudio({ bgm: { src: "x.mp3", source: "host" }, sfx: [] }, throwsOnNonString);
+  assert.equal(host.bgm, null);
+  assert.deepEqual(host.dropped, ['a host entry has no "path"']);
+});