dsh-hyperframes 0.3.1 → 0.4.0

package/skills/media-use/scripts/lib/telemetry.test.mjs

@@ -1,373 +0,0 @@
-import { strict as assert } from "node:assert";
-import { test } from "node:test";
-import {
-  existsSync,
-  mkdirSync,
-  mkdtempSync,
-  readFileSync,
-  rmSync,
-  writeFileSync,
-  chmodSync,
-} from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { __anonymousIdForTest, __resetTelemetryForTest, optedOut, track } from "./telemetry.mjs";
-
-function sandbox() {
-  const root = mkdtempSync(join(tmpdir(), "mu-telemetry-"));
-  const home = join(root, "home");
-  mkdirSync(home, { recursive: true });
-  process.env.HOME = home;
-  return { root, home };
-}
-
-function restoreEnv(saved) {
-  for (const k of Object.keys(process.env)) if (!(k in saved)) delete process.env[k];
-  Object.assign(process.env, saved);
-}
-
-function withoutTelemetryOptOut() {
-  for (const k of ["DO_NOT_TRACK", "HYPERFRAMES_NO_TELEMETRY", "CI", "NODE_ENV"])
-    delete process.env[k];
-}
-
-function parseFetchBodies(calls) {
-  return calls.flatMap((call) => JSON.parse(call.options.body).batch);
-}
-
-test("optedOut respects DO_NOT_TRACK / HYPERFRAMES_NO_TELEMETRY / CI", () => {
-  const saved = { ...process.env };
-  try {
-    for (const k of ["DO_NOT_TRACK", "HYPERFRAMES_NO_TELEMETRY", "CI", "NODE_ENV"])
-      delete process.env[k];
-    assert.equal(optedOut(), false, "default: tracking allowed");
-    process.env.DO_NOT_TRACK = "1";
-    assert.equal(optedOut(), true, "DO_NOT_TRACK opts out");
-    delete process.env.DO_NOT_TRACK;
-    process.env.HYPERFRAMES_NO_TELEMETRY = "1";
-    assert.equal(optedOut(), true, "HYPERFRAMES_NO_TELEMETRY opts out");
-    delete process.env.HYPERFRAMES_NO_TELEMETRY;
-    process.env.CI = "true";
-    assert.equal(optedOut(), true, "CI opts out");
-  } finally {
-    for (const k of Object.keys(process.env)) if (!(k in saved)) delete process.env[k];
-    Object.assign(process.env, saved);
-  }
-});
-
-test("track is a no-op (no network, resolves) when opted out", async () => {
-  const savedEnv = { ...process.env };
-  const originalFetch = globalThis.fetch;
-  const { root, home } = sandbox();
-  const calls = [];
-  globalThis.fetch = async (...args) => {
-    calls.push(args);
-    return { ok: true };
-  };
-  process.env.DO_NOT_TRACK = "1";
-  try {
-    // must resolve immediately without throwing or hitting the network
-    await track("media_use_resolve", { type: "bgm", source: "search" });
-    assert.equal(calls.length, 0);
-    assert.equal(existsSync(join(home, ".hyperframes/config.json")), false);
-    assert.equal(existsSync(join(home, ".media/telemetry-notice-shown")), false);
-  } finally {
-    globalThis.fetch = originalFetch;
-    restoreEnv(savedEnv);
-    rmSync(root, { recursive: true, force: true });
-    __resetTelemetryForTest();
-  }
-});
-
-test("anonymous id uses the shared hyperframes config", () => {
-  const savedEnv = { ...process.env };
-  const { root, home } = sandbox();
-  try {
-    withoutTelemetryOptOut();
-    mkdirSync(join(home, ".hyperframes"), { recursive: true });
-    writeFileSync(
-      join(home, ".hyperframes/config.json"),
-      JSON.stringify({ anonymousId: "shared-install-id", keep: true }),
-    );
-    mkdirSync(join(home, ".media"), { recursive: true });
-    writeFileSync(join(home, ".media/anon-id"), "old-media-id");
-
-    assert.equal(__anonymousIdForTest(), "shared-install-id");
-  } finally {
-    restoreEnv(savedEnv);
-    rmSync(root, { recursive: true, force: true });
-    __resetTelemetryForTest();
-  }
-});
-
-test("anonymous id seeds missing config once and reuses it", () => {
-  const savedEnv = { ...process.env };
-  const { root, home } = sandbox();
-  try {
-    withoutTelemetryOptOut();
-    const first = __anonymousIdForTest();
-    const configPath = join(home, ".hyperframes/config.json");
-    assert.ok(existsSync(configPath));
-    assert.match(
-      first,
-      /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,
-    );
-    const second = __anonymousIdForTest();
-    assert.equal(second, first);
-    assert.equal(JSON.parse(readFileSync(configPath, "utf8")).anonymousId, first);
-  } finally {
-    restoreEnv(savedEnv);
-    rmSync(root, { recursive: true, force: true });
-    __resetTelemetryForTest();
-  }
-});
-
-test("anonymous id adopts a legacy ~/.media/anon-id on upgrade (persona continuity)", () => {
-  const savedEnv = { ...process.env };
-  const { root, home } = sandbox();
-  try {
-    withoutTelemetryOptOut();
-    mkdirSync(join(home, ".media"), { recursive: true });
-    writeFileSync(join(home, ".media/anon-id"), "legacy-media-id");
-    // no ~/.hyperframes/config.json yet — the old media-use-only id must carry over
-    assert.equal(__anonymousIdForTest(), "legacy-media-id");
-    // and it is persisted into the shared config so CLI/studio see the same id
-    assert.equal(
-      JSON.parse(readFileSync(join(home, ".hyperframes/config.json"), "utf8")).anonymousId,
-      "legacy-media-id",
-    );
-  } finally {
-    restoreEnv(savedEnv);
-    rmSync(root, { recursive: true, force: true });
-    __resetTelemetryForTest();
-  }
-});
-
-test("track identifies a signed-in HeyGen account once and still sends events", async () => {
-  const savedEnv = { ...process.env };
-  const originalFetch = globalThis.fetch;
-  const { root, home } = sandbox();
-  const calls = [];
-  globalThis.fetch = async (url, options) => {
-    calls.push({ url, options });
-    return { ok: true };
-  };
-  try {
-    withoutTelemetryOptOut();
-    mkdirSync(join(home, ".hyperframes"), { recursive: true });
-    writeFileSync(
-      join(home, ".hyperframes/config.json"),
-      JSON.stringify({ anonymousId: "anon-1" }),
-    );
-    mkdirSync(join(home, ".heygen"), { recursive: true });
-    writeFileSync(
-      join(home, ".heygen/credentials"),
-      JSON.stringify({ user: { email: "alice@example.com", username: "alice" } }),
-    );
-
-    await track("media_use_resolve", { type: "bgm", source: "search" });
-    await track("media_use_resolve", { type: "image", source: "generated" });
-
-    const batch = parseFetchBodies(calls);
-    const identify = batch.filter((item) => item.event === "$identify");
-    assert.equal(identify.length, 1);
-    assert.equal(identify[0].distinct_id, "alice@example.com");
-    assert.equal(identify[0].properties.$anon_distinct_id, "anon-1");
-    assert.equal(batch.filter((item) => item.event === "media_use_resolve").length, 2);
-  } finally {
-    globalThis.fetch = originalFetch;
-    restoreEnv(savedEnv);
-    rmSync(root, { recursive: true, force: true });
-    __resetTelemetryForTest();
-  }
-});
-
-test("track identifies with a lowercased email regardless of stored casing", async () => {
-  const savedEnv = { ...process.env };
-  const originalFetch = globalThis.fetch;
-  const { root, home } = sandbox();
-  const calls = [];
-  globalThis.fetch = async (url, options) => {
-    calls.push({ url, options });
-    return { ok: true };
-  };
-  try {
-    withoutTelemetryOptOut();
-    mkdirSync(join(home, ".hyperframes"), { recursive: true });
-    writeFileSync(
-      join(home, ".hyperframes/config.json"),
-      JSON.stringify({ anonymousId: "anon-3" }),
-    );
-    mkdirSync(join(home, ".heygen"), { recursive: true });
-    writeFileSync(
-      join(home, ".heygen/credentials"),
-      JSON.stringify({ user: { email: "Alice@Example.com", username: "alice" } }),
-    );
-
-    await track("media_use_resolve", { type: "bgm", source: "search" });
-
-    const batch = parseFetchBodies(calls);
-    const identify = batch.filter((item) => item.event === "$identify");
-    assert.equal(identify.length, 1);
-    // Lowercased so this joins with heygen-cli's own identify call regardless
-    // of the account's stored email casing -- otherwise the same person could
-    // split into two PostHog profiles by email case alone.
-    assert.equal(identify[0].distinct_id, "alice@example.com");
-  } finally {
-    globalThis.fetch = originalFetch;
-    restoreEnv(savedEnv);
-    rmSync(root, { recursive: true, force: true });
-    __resetTelemetryForTest();
-  }
-});
-
-test("track does not identify when signed out", async () => {
-  const savedEnv = { ...process.env };
-  const originalFetch = globalThis.fetch;
-  const { root, home } = sandbox();
-  const calls = [];
-  globalThis.fetch = async (url, options) => {
-    calls.push({ url, options });
-    return { ok: true };
-  };
-  try {
-    withoutTelemetryOptOut();
-    mkdirSync(join(home, ".hyperframes"), { recursive: true });
-    writeFileSync(
-      join(home, ".hyperframes/config.json"),
-      JSON.stringify({ anonymousId: "anon-2" }),
-    );
-
-    await track("media_use_resolve", { type: "bgm", source: "search" });
-
-    const batch = parseFetchBodies(calls);
-    assert.equal(
-      batch.some((item) => item.event === "$identify"),
-      false,
-    );
-    assert.equal(batch[0].event, "media_use_resolve");
-    assert.equal(batch[0].distinct_id, "anon-2");
-  } finally {
-    globalThis.fetch = originalFetch;
-    restoreEnv(savedEnv);
-    rmSync(root, { recursive: true, force: true });
-    __resetTelemetryForTest();
-  }
-});
-
-test("first run notice prints to stderr once and never stdout", async () => {
-  const savedEnv = { ...process.env };
-  const originalFetch = globalThis.fetch;
-  const originalError = console.error;
-  const originalLog = console.log;
-  const { root, home } = sandbox();
-  const stderr = [];
-  const stdout = [];
-  globalThis.fetch = async () => ({ ok: true });
-  console.error = (...args) => stderr.push(args.join(" "));
-  console.log = (...args) => stdout.push(args.join(" "));
-  try {
-    withoutTelemetryOptOut();
-    await track("media_use_resolve", { type: "bgm" });
-    await track("media_use_resolve", { type: "sfx" });
-
-    assert.equal(stderr.length, 1);
-    assert.match(stderr[0], /media-use sends usage telemetry/);
-    assert.equal(stdout.length, 0);
-    // notice-shown lives in the shared config (config.telemetryNoticeShown), so
-    // the CLI and media-use show it once per person — not a media-use-only marker.
-    assert.equal(
-      JSON.parse(readFileSync(join(home, ".hyperframes/config.json"), "utf8")).telemetryNoticeShown,
-      true,
-    );
-  } finally {
-    globalThis.fetch = originalFetch;
-    console.error = originalError;
-    console.log = originalLog;
-    restoreEnv(savedEnv);
-    rmSync(root, { recursive: true, force: true });
-    __resetTelemetryForTest();
-  }
-});
-
-test("warns once on stderr when MEDIA_USE_TELEMETRY_HOST is set outside a test/CI context", async () => {
-  const savedEnv = { ...process.env };
-  const originalFetch = globalThis.fetch;
-  const originalError = console.error;
-  const { root } = sandbox();
-  const stderr = [];
-  globalThis.fetch = async () => ({ ok: true });
-  console.error = (...args) => stderr.push(args.join(" "));
-  try {
-    // No opt-out, no CI/NODE_ENV signal — mirrors a real user's shell where
-    // this test-only var leaked in by accident and tracking is not disabled.
-    withoutTelemetryOptOut();
-    process.env.MEDIA_USE_TELEMETRY_HOST = "http://127.0.0.1:1"; // nothing listens; irrelevant here
-    await track("media_use_resolve", { type: "bgm" });
-    await track("media_use_resolve", { type: "bgm" });
-
-    const warnings = stderr.filter((line) => line.includes("MEDIA_USE_TELEMETRY_HOST"));
-    assert.equal(warnings.length, 1, "expected exactly one warning across repeated calls");
-  } finally {
-    globalThis.fetch = originalFetch;
-    console.error = originalError;
-    restoreEnv(savedEnv);
-    rmSync(root, { recursive: true, force: true });
-    __resetTelemetryForTest();
-  }
-});
-
-test("does not warn when MEDIA_USE_TELEMETRY_HOST is set the way the U7 interception test sets it", async () => {
-  const savedEnv = { ...process.env };
-  const originalFetch = globalThis.fetch;
-  const originalError = console.error;
-  const { root } = sandbox();
-  const stderr = [];
-  globalThis.fetch = async () => ({ ok: true });
-  console.error = (...args) => stderr.push(args.join(" "));
-  try {
-    withoutTelemetryOptOut();
-    // Same env shape resolve.test.mjs's U7 test uses to allow tracking through:
-    // DO_NOT_TRACK=0, CI unset/empty, NODE_ENV=test.
-    process.env.DO_NOT_TRACK = "0";
-    process.env.CI = "";
-    process.env.NODE_ENV = "test";
-    process.env.MEDIA_USE_TELEMETRY_HOST = "http://127.0.0.1:1";
-    await track("media_use_resolve", { type: "bgm" });
-
-    assert.equal(
-      stderr.some((line) => line.includes("MEDIA_USE_TELEMETRY_HOST")),
-      false,
-      "the U7 test's own use of the override must not print a spurious warning",
-    );
-  } finally {
-    globalThis.fetch = originalFetch;
-    console.error = originalError;
-    restoreEnv(savedEnv);
-    rmSync(root, { recursive: true, force: true });
-    __resetTelemetryForTest();
-  }
-});
-
-test("read-only telemetry state degrades without throwing", async () => {
-  const savedEnv = { ...process.env };
-  const originalFetch = globalThis.fetch;
-  const { root, home } = sandbox();
-  globalThis.fetch = async () => ({ ok: true });
-  try {
-    withoutTelemetryOptOut();
-    writeFileSync(join(home, ".hyperframes"), "not a directory");
-    writeFileSync(join(home, ".media"), "not a directory");
-    await track("media_use_resolve", { type: "bgm" });
-  } finally {
-    globalThis.fetch = originalFetch;
-    try {
-      chmodSync(join(home, ".hyperframes"), 0o600);
-    } catch {
-      // best effort for cleanup on platforms with different chmod behavior
-    }
-    restoreEnv(savedEnv);
-    rmSync(root, { recursive: true, force: true });
-    __resetTelemetryForTest();
-  }
-});

package/skills/media-use/scripts/lib/tts-local-provider.mjs

@@ -1,92 +0,0 @@
-import { execFileSync } from "node:child_process";
-import { existsSync, statSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { resolveSpawnCommand } from "../../audio/scripts/lib/tts.mjs";
-
-// Local voiceover via the packaged Kokoro-82M TTS (the `hyperframes tts` CLI),
-// the free/private default now that HeyGen TTS costs wallet credits. Kokoro runs
-// on-device (CPU, faster-than-realtime, bundled voices, native word timestamps),
-// so no key and no per-call charge. When Kokoro is not set up, this returns null
-// and the registry falls through to the HeyGen TTS upsell.
-//
-// Delegated to the hyperframes CLI (same as transcribe / remove-background), not
-// re-implemented here. ffprobe reads the duration back for the ledger.
-
-function probeDurationSeconds(file) {
-  try {
-    const out = execFileSync(
-      "ffprobe",
-      ["-v", "error", "-show_entries", "format=duration", "-of", "csv=p=0", "--", file],
-      { encoding: "utf8", timeout: 15000 },
-    );
-    const d = parseFloat(String(out).trim());
-    return Number.isFinite(d) ? d : undefined;
-  } catch {
-    return undefined;
-  }
-}
-
-// `platform`/`execFn`/`env`/`pathExists` params (defaulting to the real
-// values) exist so tests can exercise the win32 branch without mocking
-// node:child_process (its ESM exports are non-configurable) — same idiom as
-// spawnP in ../../audio/scripts/lib/tts.mjs.
-export async function localTtsGenerate(
-  intent,
-  ctx,
-  platform = process.platform,
-  execFn = execFileSync,
-  env = process.env,
-  pathExists = existsSync,
-) {
-  const outPath = join(tmpdir(), `media-use-kokoro-${process.pid}-${Date.now()}.wav`);
-  const argv = ["hyperframes", "tts", intent, "--output", outPath];
-  if (ctx?.voice) argv.push("--voice", ctx.voice);
-  if (ctx?.lang && ctx.lang !== "en") argv.push("--lang", ctx.lang);
-  // On Windows a bare "npx" is npx.cmd, which execFileSync cannot exec
-  // (spawnSync npx ENOENT) — resolveSpawnCommand reroutes it through
-  // node + npx-cli.js, same as the audio engine's TTS spawns.
-  const resolved = resolveSpawnCommand(
-    "npx",
-    argv,
-    { encoding: "utf8", timeout: 300000, stdio: ["ignore", "pipe", "pipe"] },
-    platform,
-    env,
-    pathExists,
-  );
-  if (!resolved) {
-    // npx-on-win32 with no resolvable npx-cli.js — same terminal condition
-    // spawnP warns about. Fall through to the next provider rather than crash.
-    console.error(
-      "media-use: local voice not enabled (kokoro). Cannot run npx on Windows: " +
-        "npm's npx-cli.js was not found (install npm with Node, or run via npx/npm run so npm_execpath is set).",
-    );
-    return null;
-  }
-  try {
-    execFn(resolved.cmd, resolved.args, resolved.opts);
-  } catch (err) {
-    // `hyperframes tts` prints its "kokoro-onnx not installed" hint to stdout
-    // (clack UI), so read both streams and surface the actionable enable-command
-    // rather than a bare "Command failed": otherwise resolve silently falls
-    // through to the PAID HeyGen TTS upsell when free local voice was one pip away.
-    const out = `${err.stdout?.toString() ?? ""}${err.stderr?.toString() ?? ""}`.trim();
-    const hint = /not installed|pip install kokoro/i.test(out)
-      ? "install for free on-device voice: pip install kokoro-onnx soundfile (or set HYPERFRAMES_PYTHON to a venv that has it)"
-      : out.slice(-200) || err.message;
-    console.error(`media-use: local voice not enabled (kokoro). ${hint}`);
-    return null;
-  }
-  if (!existsSync(outPath) || statSync(outPath).size === 0) return null;
-  return {
-    localPath: outPath,
-    ext: ".wav",
-    source: "generated",
-    metadata: {
-      description: intent,
-      provider: "kokoro.local",
-      duration: probeDurationSeconds(outPath),
-      provenance: { engine: "kokoro-82m", prompt: intent },
-    },
-  };
-}

package/skills/media-use/scripts/lib/tts-local-provider.test.mjs

@@ -1,72 +0,0 @@
-import { test } from "node:test";
-import assert from "node:assert/strict";
-import { localTtsGenerate } from "./tts-local-provider.mjs";
-
-// Regression: on Windows, a bare "npx" is npx.cmd, which execFileSync cannot
-// exec — the Kokoro delegation failed with `spawnSync npx ENOENT` instead of
-// synthesizing (or cleanly falling through to the next provider). The spawn
-// must route through node + npx-cli.js on win32, same as the audio engine's
-// TTS spawns (see ../../audio/scripts/lib/tts.spawn.test.mjs).
-
-const envWithNpxCli = {
-  npm_execpath: "C:/Program Files/nodejs/node_modules/npm/bin/npm-cli.js",
-  npm_node_execpath: "C:/Program Files/nodejs/node.exe",
-};
-const npxCliPath = "C:/Program Files/nodejs/node_modules/npm/bin/npx-cli.js";
-const pathExists = (path) => path === npxCliPath;
-
-test("win32: routes the hyperframes tts call through node + npx-cli, never bare npx", async () => {
-  const captured = [];
-  const fakeExec = (cmd, args, opts) => {
-    captured.push({ cmd, args, opts });
-    // Synthesize nothing — the provider then returns null via the
-    // missing-output check, which is fine: we only assert the spawn shape.
-  };
-
-  await localTtsGenerate(
-    "hello there",
-    { voice: "am_michael" },
-    "win32",
-    fakeExec,
-    envWithNpxCli,
-    pathExists,
-  );
-
-  assert.equal(captured.length, 1);
-  assert.equal(captured[0].cmd, envWithNpxCli.npm_node_execpath);
-  assert.equal(captured[0].args[0], npxCliPath);
-  assert.deepEqual(captured[0].args.slice(1, 4), ["hyperframes", "tts", "hello there"]);
-  assert.ok(captured[0].args.includes("--voice"));
-  // execFileSync options survive the rerouting (pipes are what let the caller
-  // read the "kokoro-onnx not installed" hint back out).
-  assert.deepEqual(captured[0].opts.stdio, ["ignore", "pipe", "pipe"]);
-});
-
-test("win32 without a resolvable npx-cli: falls through to the next provider (null), no spawn", async () => {
-  const captured = [];
-  const fakeExec = (...call) => captured.push(call);
-
-  const result = await localTtsGenerate(
-    "hello",
-    {},
-    "win32",
-    fakeExec,
-    {}, // no npm_execpath, and pathExists finds nothing
-    () => false,
-  );
-
-  assert.equal(result, null);
-  assert.equal(captured.length, 0);
-});
-
-test("non-win32: spawns plain npx unchanged", async () => {
-  const captured = [];
-  const fakeExec = (cmd, args) => captured.push({ cmd, args });
-
-  await localTtsGenerate("hola", { lang: "es" }, "darwin", fakeExec, {}, () => false);
-
-  assert.equal(captured.length, 1);
-  assert.equal(captured[0].cmd, "npx");
-  assert.deepEqual(captured[0].args.slice(0, 3), ["hyperframes", "tts", "hola"]);
-  assert.ok(captured[0].args.includes("--lang"));
-});

package/skills/media-use/scripts/lib/usage.mjs

@@ -1,57 +0,0 @@
-import { readFileSync, readdirSync, existsSync } from "node:fs";
-import { join } from "node:path";
-
-// Asset in-use detection: which manifest assets are actually referenced by the
-// project's compositions. Answers "is this safe to prune?" from the CLI. (The
-// Studio Asset tab computes its in-use filter separately from the live timeline;
-// this is the skill-side equivalent for headless use.)
-//
-// ponytail: substring match of each asset's filename against the .html text
-// (covers src= / href= / url() / data-* without parsing HTML). False positives
-// only if a filename literally appears in prose; fine for a filter. Upgrade to
-// attribute parsing if that ever bites.
-
-function compositionHtml(projectDir) {
-  let files = [];
-  try {
-    files = readdirSync(projectDir).filter((f) => f.endsWith(".html"));
-  } catch {
-    return "";
-  }
-  const sub = join(projectDir, "compositions");
-  if (existsSync(sub)) {
-    try {
-      for (const f of readdirSync(sub))
-        if (f.endsWith(".html")) files.push(join("compositions", f));
-    } catch {
-      // ignore unreadable subdir
-    }
-  }
-  return files
-    .map((f) => {
-      try {
-        return readFileSync(join(projectDir, f), "utf8");
-      } catch {
-        return "";
-      }
-    })
-    .join("\n");
-}
-
-/** Tag each record with `inUse` (referenced by some composition). */
-export function tagUsage(records, projectDir) {
-  const html = compositionHtml(projectDir);
-  return records.map((r) => {
-    const file = r.path ? r.path.split("/").pop() : r.id;
-    return { ...r, inUse: Boolean(file) && html.includes(file) };
-  });
-}
-
-/** Split records into { used, unused } for the filter. */
-export function partitionUsage(records, projectDir) {
-  const tagged = tagUsage(records, projectDir);
-  return {
-    used: tagged.filter((r) => r.inUse),
-    unused: tagged.filter((r) => !r.inUse),
-  };
-}

package/skills/media-use/scripts/lib/usage.test.mjs

@@ -1,54 +0,0 @@
-import { strict as assert } from "node:assert";
-import { test } from "node:test";
-import { mkdtempSync, writeFileSync, rmSync } from "node:fs";
-import { join } from "node:path";
-import { tmpdir } from "node:os";
-import { tagUsage, partitionUsage } from "./usage.mjs";
-
-function project(html) {
-  const dir = mkdtempSync(join(tmpdir(), "mu-usage-"));
-  writeFileSync(join(dir, "index.html"), html);
-  return dir;
-}
-
-const records = [
-  { id: "bgm_001", path: ".media/audio/bgm/bgm_001.wav", description: "used track" },
-  { id: "bgm_002", path: ".media/audio/bgm/bgm_002.wav", description: "orphan track" },
-];
-
-test("an asset referenced by a composition is marked in-use", () => {
-  const dir = project(`<audio src="assets/bgm_001.wav"></audio>`);
-  try {
-    const tagged = tagUsage(records, dir);
-    assert.equal(tagged.find((r) => r.id === "bgm_001").inUse, true);
-    assert.equal(tagged.find((r) => r.id === "bgm_002").inUse, false);
-  } finally {
-    rmSync(dir, { recursive: true, force: true });
-  }
-});
-
-test("partitionUsage splits used vs unused for the filter", () => {
-  const dir = project(`<img src="bgm_001.wav">`);
-  try {
-    const { used, unused } = partitionUsage(records, dir);
-    assert.deepEqual(
-      used.map((r) => r.id),
-      ["bgm_001"],
-    );
-    assert.deepEqual(
-      unused.map((r) => r.id),
-      ["bgm_002"],
-    );
-  } finally {
-    rmSync(dir, { recursive: true, force: true });
-  }
-});
-
-test("no compositions -> everything reads as unused (safe default)", () => {
-  const dir = mkdtempSync(join(tmpdir(), "mu-usage-"));
-  try {
-    assert.equal(partitionUsage(records, dir).used.length, 0);
-  } finally {
-    rmSync(dir, { recursive: true, force: true });
-  }
-});