hyperframes 0.8.143 → 0.8.145

package/dist/{render-TSE75QUL.js → render-Z253WHBK.js}

@@ -6,21 +6,21 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   maybePromptRenderFeedback
-} from "./chunk-3NE7ZYU2.js";
+} from "./chunk-ZSVUAVMT.js";
 import {
   reportVariableIssues,
   resolveVariablesArg,
   validateVariablesAgainstProject
-} from "./chunk-LW6HO6U3.js";
+} from "./chunk-R42WWQVB.js";
 import {
   loadProducer
-} from "./chunk-QVYVUCWD.js";
+} from "./chunk-HB7FJOY4.js";
 import {
   formatLintStartupMessage
 } from "./chunk-6CSYCFQV.js";
 import {
   resolveProject
-} from "./chunk-VIVBA6E6.js";
+} from "./chunk-XBX4QJP7.js";
 import {
   renderJobObservabilityTelemetryPayload
 } from "./chunk-VXVRPIJA.js";
@@ -32,7 +32,7 @@ import {
   resolveCompositionEntryArg,
   resolveDefaultFpsArg,
   windowsChromeCrashRemediation
-} from "./chunk-P7THMINS.js";
+} from "./chunk-FXJJCPPB.js";
 import "./chunk-WPNE5NEP.js";
 import {
   desktopHint
@@ -49,24 +49,24 @@ import "./chunk-DCAI5DBR.js";
 import "./chunk-EOVYQ3IG.js";
 import {
   runEnvironmentChecks
-} from "./chunk-KOEWEFHK.js";
+} from "./chunk-DIRJ322I.js";
 import "./chunk-442JNXRM.js";
 import {
   createRenderCancellationScope
-} from "./chunk-UICWP23D.js";
+} from "./chunk-FBCULCAL.js";
 import {
   loadProjectConfig,
   readProjectConfigWithStatus,
   seedProjectAuthoringSkill
-} from "./chunk-2LBBHMKT.js";
+} from "./chunk-CFUXNBWH.js";
 import "./chunk-XT7X6QCP.js";
 import "./chunk-4YYJOFKS.js";
 import {
   normalizeSkillSlug
 } from "./chunk-HVW7ABXD.js";
-import "./chunk-HW4AKJ5F.js";
-import "./chunk-CLOH4LIB.js";
-import "./chunk-TAMQYQGJ.js";
+import "./chunk-BIAC7IJT.js";
+import "./chunk-XIHCMVMG.js";
+import "./chunk-LAFJSYDL.js";
 import "./chunk-AWDFDFI3.js";
 import "./chunk-P6LJ4Y32.js";
 import {
@@ -76,14 +76,14 @@ import {
   findFFmpeg,
   findFFprobe,
   getFFmpegInstallHint
-} from "./chunk-TVCRUG2S.js";
+} from "./chunk-ZEUONDQG.js";
 import {
   trackRenderComplete,
   trackRenderError,
   trackRenderObservation,
   trackRenderPreflightRejected
-} from "./chunk-QFN7NVWM.js";
-import "./chunk-OSSHSIMD.js";
+} from "./chunk-ICKDMTLA.js";
+import "./chunk-ZF7SXQJ7.js";
 import "./chunk-VWG7OQKU.js";
 import {
   bytesToMb
@@ -110,8 +110,8 @@ import {
   MAX_VP9_CPU_USED,
   MIN_VP9_CPU_USED,
   isVideoFrameFormat
-} from "./chunk-33RZPZ4K.js";
-import "./chunk-F26LCYRY.js";
+} from "./chunk-UXO2L7HJ.js";
+import "./chunk-FDT6KQV4.js";
 import "./chunk-NE55C6S5.js";
 import "./chunk-USDEMXXL.js";
 import {
@@ -119,8 +119,8 @@ import {
   fpsToFfmpegArg,
   fpsToNumber,
   parseFps
-} from "./chunk-4M4EC7JX.js";
-import "./chunk-6TPZSTCL.js";
+} from "./chunk-VRW6EBHV.js";
+import "./chunk-AUWHD7RA.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-YA62XGXS.js";
 import {
@@ -137,25 +137,25 @@ import "./chunk-RQVDTPGD.js";
 import {
   hasDefinitiveEntryMismatch
 } from "./chunk-Q5X2B5WT.js";
-import "./chunk-4PFZPP2N.js";
+import "./chunk-A6S35NYA.js";
 import {
   killOrphanedProcessesForRender
-} from "./chunk-LAOCA3MQ.js";
+} from "./chunk-A4Q7W4LV.js";
 import {
   runRenderSetupWorker
-} from "./chunk-LCSMOLGX.js";
+} from "./chunk-BYSBRF24.js";
 import "./chunk-TWWSYAKJ.js";
 import {
   lintProject,
   shouldBlockRender
-} from "./chunk-XONFUK3M.js";
+} from "./chunk-IEIJRMLZ.js";
 import {
   collectSubCompositionSrcs
 } from "./chunk-IWFLMU2N.js";
 import "./chunk-APDLWWFG.js";
 import "./chunk-PJ3HDUCY.js";
 import "./chunk-3RM2ETQT.js";
-import "./chunk-ZLW2V65P.js";
+import "./chunk-BSQ7XANM.js";
 import "./chunk-SDYDNHEE.js";
 import "./chunk-2PSPARWP.js";
 import "./chunk-T42U2W2R.js";
@@ -172,7 +172,7 @@ import {
 } from "./chunk-ISN5GRYI.js";
 import {
   VERSION
-} from "./chunk-W35EKBS6.js";
+} from "./chunk-BFACGEII.js";
 import {
   normalizeErrorMessage
 } from "./chunk-KNU5COPB.js";
@@ -671,7 +671,7 @@ async function executeRenderPlan(plan, dependencies, cancellation) {
   let batchModule;
   let preparedBatch;
   if (plan.batchPath) {
-    batchModule = await import("./batchRender-4U73BYTU.js");
+    batchModule = await import("./batchRender-T6JEGCQV.js");
     try {
       preparedBatch = batchModule.prepareBatchRender({
         batchPath: plan.batchPath,
@@ -760,7 +760,7 @@ function assertRenderActive(cancellation) {
   cancellation?.signal.throwIfAborted();
 }
 async function ensureRenderBrowser(plan, signal) {
-  const { ensureBrowser } = await import("./manager-CT3D67CG.js");
+  const { ensureBrowser } = await import("./manager-BPSR6D3V.js");
   let browserSpinner;
   try {
     if (plan.effectiveQuiet) {

package/dist/{render-batch-GGUOK3DS.js → render-batch-46IIBFKL.js}

@@ -14,7 +14,7 @@ import {
   loadProjectVariableSchema,
   reportVariableIssues,
   validateVariablesAgainstSchema
-} from "./chunk-LW6HO6U3.js";
+} from "./chunk-R42WWQVB.js";
 import "./chunk-FH7WODJH.js";
 import {
   errorBox
@@ -24,8 +24,8 @@ import {
   failCommand,
   setCommandExitCode
 } from "./chunk-PBN6GBJE.js";
-import "./chunk-4M4EC7JX.js";
-import "./chunk-6TPZSTCL.js";
+import "./chunk-VRW6EBHV.js";
+import "./chunk-AUWHD7RA.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-YA62XGXS.js";
 import "./chunk-MQZVBHEY.js";
@@ -35,7 +35,7 @@ import "./chunk-T76PLPD6.js";
 import "./chunk-FXMKHHPO.js";
 import "./chunk-RQVDTPGD.js";
 import "./chunk-3RM2ETQT.js";
-import "./chunk-ZLW2V65P.js";
+import "./chunk-BSQ7XANM.js";
 import "./chunk-SDYDNHEE.js";
 import "./chunk-2PSPARWP.js";
 import "./chunk-T42U2W2R.js";

package/dist/{renderCancellation-PZRWB53I.js → renderCancellation-QTZOCDJ2.js}

@@ -7,13 +7,13 @@ var __dirname = __hf_dirname(__filename);
 import {
   createRenderCancellationScope,
   stoppedByCancelSignal
-} from "./chunk-UICWP23D.js";
-import "./chunk-33RZPZ4K.js";
-import "./chunk-F26LCYRY.js";
+} from "./chunk-FBCULCAL.js";
+import "./chunk-UXO2L7HJ.js";
+import "./chunk-FDT6KQV4.js";
 import "./chunk-NE55C6S5.js";
 import "./chunk-USDEMXXL.js";
-import "./chunk-4M4EC7JX.js";
-import "./chunk-6TPZSTCL.js";
+import "./chunk-VRW6EBHV.js";
+import "./chunk-AUWHD7RA.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-YA62XGXS.js";
 import "./chunk-MQZVBHEY.js";
@@ -22,18 +22,19 @@ import "./chunk-DPVXBVLL.js";
 import "./chunk-T76PLPD6.js";
 import "./chunk-FXMKHHPO.js";
 import "./chunk-RQVDTPGD.js";
-import "./chunk-LAOCA3MQ.js";
-import "./chunk-LCSMOLGX.js";
+import "./chunk-A4Q7W4LV.js";
+import "./chunk-BYSBRF24.js";
 import "./chunk-TWWSYAKJ.js";
-import "./chunk-XONFUK3M.js";
+import "./chunk-IEIJRMLZ.js";
 import "./chunk-IWFLMU2N.js";
 import "./chunk-APDLWWFG.js";
 import "./chunk-PJ3HDUCY.js";
 import "./chunk-3RM2ETQT.js";
-import "./chunk-ZLW2V65P.js";
+import "./chunk-BSQ7XANM.js";
 import "./chunk-SDYDNHEE.js";
 import "./chunk-2PSPARWP.js";
 import "./chunk-T42U2W2R.js";
+import "./chunk-KNU5COPB.js";
 import "./chunk-3GXQPCJC.js";
 import "./chunk-M2WBOQ2Q.js";
 export {

package/dist/renderSetupWorker.js

@@ -8,20 +8,24 @@ import "./chunk-Q5X2B5WT.js";
 import {
   ensureBrowser,
   releaseOwnedBrowserInstallLock
-} from "./chunk-4PFZPP2N.js";
+} from "./chunk-A6S35NYA.js";
 import {
   killOrphanedProcesses
-} from "./chunk-LAOCA3MQ.js";
-import "./chunk-LCSMOLGX.js";
+} from "./chunk-A4Q7W4LV.js";
+import {
+  installRenderSetupSignalHandlers,
+  renderSetupErrorLine,
+  renderSetupResultLine
+} from "./chunk-BYSBRF24.js";
 import "./chunk-TWWSYAKJ.js";
 import {
   lintProject
-} from "./chunk-XONFUK3M.js";
+} from "./chunk-IEIJRMLZ.js";
 import "./chunk-IWFLMU2N.js";
 import "./chunk-APDLWWFG.js";
 import "./chunk-PJ3HDUCY.js";
 import "./chunk-3RM2ETQT.js";
-import "./chunk-ZLW2V65P.js";
+import "./chunk-BSQ7XANM.js";
 import "./chunk-SDYDNHEE.js";
 import "./chunk-2PSPARWP.js";
 import "./chunk-T42U2W2R.js";
@@ -30,28 +34,6 @@ import "./chunk-M2WBOQ2Q.js";
 
 // src/renderSetupWorker.ts
 import { constants, setPriority } from "os";
-
-// src/renderSetupWorkerLifecycle.ts
-var RENDER_SETUP_SIGNALS = ["SIGINT", "SIGTERM", "SIGHUP"];
-function installRenderSetupSignalHandlers(signalTarget, releaseLock, resendSignal, handleHangup = true) {
-  const handlers = /* @__PURE__ */ new Map();
-  const handledSignals = handleHangup ? RENDER_SETUP_SIGNALS : RENDER_SETUP_SIGNALS.filter((signal) => signal !== "SIGHUP");
-  for (const signal of handledSignals) {
-    const handler = () => {
-      releaseLock();
-      signalTarget.off(signal, handler);
-      resendSignal(signal);
-    };
-    handlers.set(signal, handler);
-    signalTarget.on(signal, handler);
-  }
-  return () => {
-    for (const [signal, handler] of handlers) signalTarget.off(signal, handler);
-  };
-}
-
-// src/renderSetupWorker.ts
-var RESULT_PREFIX = "HYPERFRAMES_RENDER_SETUP_RESULT:";
 var mode = process.argv[2];
 var input = JSON.parse(process.env.HYPERFRAMES_RENDER_SETUP_INPUT ?? "{}");
 var disposeSignalHandlers = installRenderSetupSignalHandlers(
@@ -60,22 +42,28 @@ var disposeSignalHandlers = installRenderSetupSignalHandlers(
   (signal) => process.kill(process.pid, signal),
   process.env.HYPERFRAMES_RENDER_DETACHED !== "1"
 );
-var result;
-if (mode === "browser") {
-  result = await ensureBrowser(input);
-} else if (mode === "lint") {
-  setPriority(constants.priority.PRIORITY_LOW);
-  result = await lintProject(
-    input.projectDir,
-    input.entryFile,
-    input.host ? { host: input.host } : void 0
-  );
-} else if (mode === "orphan-cleanup") {
-  const killed = killOrphanedProcesses();
-  result = killed;
-  if (killed > 0) await new Promise((resolve) => setTimeout(resolve, 600));
-} else {
+async function runMode() {
+  if (mode === "browser") return ensureBrowser(input);
+  if (mode === "lint") {
+    setPriority(constants.priority.PRIORITY_LOW);
+    return lintProject(
+      input.projectDir,
+      input.entryFile,
+      input.host ? { host: input.host } : void 0
+    );
+  }
+  if (mode === "orphan-cleanup") {
+    const killed = killOrphanedProcesses();
+    if (killed > 0) await new Promise((resolve) => setTimeout(resolve, 600));
+    return killed;
+  }
   throw new Error(`Unknown render setup mode: ${mode}`);
 }
-disposeSignalHandlers();
-process.stdout.write(RESULT_PREFIX + JSON.stringify(result) + "\n");
+try {
+  const result = await runMode().finally(disposeSignalHandlers);
+  process.stdout.write(renderSetupResultLine(result));
+} catch (error) {
+  process.stderr.write(renderSetupErrorLine(error), () => {
+    throw error;
+  });
+}

package/dist/{resolver-S5VK6UCB.js → resolver-J2PL5FVJ.js}

@@ -11,13 +11,13 @@ import {
   resolveItemWithDependencies,
   resolveItemsByTag,
   unreachableRegistryMessage
-} from "./chunk-HW4AKJ5F.js";
-import "./chunk-TAMQYQGJ.js";
+} from "./chunk-BIAC7IJT.js";
+import "./chunk-LAFJSYDL.js";
 import "./chunk-AWDFDFI3.js";
 import "./chunk-P6LJ4Y32.js";
 import "./chunk-GMECXFAN.js";
-import "./chunk-4M4EC7JX.js";
-import "./chunk-6TPZSTCL.js";
+import "./chunk-VRW6EBHV.js";
+import "./chunk-AUWHD7RA.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-YA62XGXS.js";
 import "./chunk-MQZVBHEY.js";
@@ -27,7 +27,7 @@ import "./chunk-T76PLPD6.js";
 import "./chunk-FXMKHHPO.js";
 import "./chunk-RQVDTPGD.js";
 import "./chunk-3RM2ETQT.js";
-import "./chunk-ZLW2V65P.js";
+import "./chunk-BSQ7XANM.js";
 import "./chunk-SDYDNHEE.js";
 import "./chunk-2PSPARWP.js";
 import "./chunk-T42U2W2R.js";

package/dist/sherpa-ZF42V3RN.js

@@ -0,0 +1,75 @@
+import { createRequire as __hf_createRequire } from "node:module";
+import { fileURLToPath as __hf_fileURLToPath } from "node:url";
+import { dirname as __hf_dirname } from "node:path";
+var require = __hf_createRequire(import.meta.url);
+var __filename = __hf_fileURLToPath(import.meta.url);
+var __dirname = __hf_dirname(__filename);
+import {
+  DecodeCancelled,
+  PARAKEET_MODEL_DIR,
+  SHERPA_RUNTIME_DIR,
+  ensureParakeetModel,
+  installSherpaRuntime,
+  prepareSherpaWav,
+  sherpaParakeetInstalled,
+  sherpaPlatformPackage,
+  sherpaRuntimeLoadError,
+  sherpaUnsupportedReason,
+  transcribeWithSherpa
+} from "./chunk-GEMJYBRU.js";
+import "./chunk-BXCMXMJQ.js";
+import "./chunk-3DKN5WKL.js";
+import "./chunk-EOVYQ3IG.js";
+import "./chunk-OTHDVXOJ.js";
+import "./chunk-6IHWCZ3W.js";
+import "./chunk-FBCULCAL.js";
+import "./chunk-6BEFEWFB.js";
+import "./chunk-MAYCCGMQ.js";
+import "./chunk-BHVFTYSI.js";
+import "./chunk-ZEUONDQG.js";
+import "./chunk-AMKC3AXA.js";
+import "./chunk-UXO2L7HJ.js";
+import "./chunk-FDT6KQV4.js";
+import "./chunk-NE55C6S5.js";
+import "./chunk-USDEMXXL.js";
+import "./chunk-VRW6EBHV.js";
+import "./chunk-AUWHD7RA.js";
+import "./chunk-VC76R6W2.js";
+import "./chunk-YA62XGXS.js";
+import "./chunk-MQZVBHEY.js";
+import "./chunk-OFQWTKPW.js";
+import "./chunk-DPVXBVLL.js";
+import "./chunk-T76PLPD6.js";
+import "./chunk-FXMKHHPO.js";
+import "./chunk-RQVDTPGD.js";
+import "./chunk-A4Q7W4LV.js";
+import "./chunk-BYSBRF24.js";
+import "./chunk-TWWSYAKJ.js";
+import "./chunk-IEIJRMLZ.js";
+import "./chunk-IWFLMU2N.js";
+import "./chunk-APDLWWFG.js";
+import "./chunk-PJ3HDUCY.js";
+import "./chunk-3RM2ETQT.js";
+import "./chunk-BSQ7XANM.js";
+import "./chunk-SDYDNHEE.js";
+import "./chunk-2PSPARWP.js";
+import "./chunk-T42U2W2R.js";
+import "./chunk-KNU5COPB.js";
+import "./chunk-KBB4RG6F.js";
+import "./chunk-UOFAE5RF.js";
+import "./chunk-IR35BCLK.js";
+import "./chunk-3GXQPCJC.js";
+import "./chunk-M2WBOQ2Q.js";
+export {
+  DecodeCancelled,
+  PARAKEET_MODEL_DIR,
+  SHERPA_RUNTIME_DIR,
+  ensureParakeetModel,
+  installSherpaRuntime,
+  prepareSherpaWav,
+  sherpaParakeetInstalled,
+  sherpaPlatformPackage,
+  sherpaRuntimeLoadError,
+  sherpaUnsupportedReason,
+  transcribeWithSherpa
+};

package/dist/sherpaWorker.js

@@ -11,10 +11,11 @@ import {
   droppedSpeechGaps,
   silenceCuts,
   spliceGap
-} from "./chunk-KDPYVTEU.js";
+} from "./chunk-KBB4RG6F.js";
 import {
   readWav
 } from "./chunk-UOFAE5RF.js";
+import "./chunk-IR35BCLK.js";
 import "./chunk-M2WBOQ2Q.js";
 
 // src/whisper/sherpaWorker.ts

package/dist/skills/hyperframes/scripts/lib/frame-packets-core.mjs

@@ -2,16 +2,8 @@
 // Workflow wrappers supply resource paths and workflow-specific sections.
 // The role combines the shared worker contract with the workflow delta.
 
-import {
-  existsSync,
-  mkdirSync,
-  readFileSync,
-  readdirSync,
-  realpathSync,
-  writeFileSync,
-} from "node:fs";
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
 import { basename, join, resolve } from "node:path";
-import { pathToFileURL } from "node:url";
 
 export function field(block, name) {
   const match = block.match(new RegExp(`^-\\s+${name}:\\s*(.+)$`, "im"));
@@ -160,17 +152,7 @@ export function flag(argv, name, fallback) {
   return index >= 0 && argv[index + 1] ? argv[index + 1] : fallback;
 }
 
-// realpath both sides: on macOS /tmp → /private/tmp, and node resolves the main
-// module's symlinks in import.meta.url while argv[1] keeps the invoked spelling —
-// a raw compare silently skips main() when invoked through any symlinked path.
-export function isMainModule(importMetaUrl) {
-  if (!process.argv[1]) return false;
-  try {
-    return pathToFileURL(realpathSync(process.argv[1])).href === importMetaUrl;
-  } catch {
-    return false;
-  }
-}
+export { isMainModule } from "./main-module.mjs";
 
 export function runCli({ buildFramePackets: build, buildRolePayload: buildRole }) {
   const argv = process.argv.slice(2);

package/dist/skills/hyperframes/scripts/lib/main-module.mjs

@@ -0,0 +1,13 @@
+import { realpathSync } from "node:fs";
+import { pathToFileURL } from "node:url";
+
+// Node resolves symlinks in the main module's import.meta.url but argv[1] keeps the invoked
+// spelling (a symlinked skills dir, or /tmp vs /private/tmp on macOS), so compare real paths.
+export function isMainModule(importMetaUrl) {
+  if (!process.argv[1]) return false;
+  try {
+    return pathToFileURL(realpathSync(process.argv[1])).href === importMetaUrl;
+  } catch {
+    return false;
+  }
+}

package/dist/skills/hyperframes/scripts/lib/main-module.test.mjs

@@ -0,0 +1,51 @@
+import { strict as assert } from "node:assert";
+import { test } from "node:test";
+import { mkdtempSync, readFileSync, readdirSync, rmSync, symlinkSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import { dirname, join, relative, resolve } from "node:path";
+import { tmpdir } from "node:os";
+import { fileURLToPath } from "node:url";
+
+const SKILLS = resolve(dirname(fileURLToPath(import.meta.url)), "../../..");
+const CLI_MEDIA_USE = resolve(SKILLS, "../packages/cli/src/media-use");
+
+// Agents install skills by symlinking the skills dir, so each script must still run its CLI.
+test("skill CLIs run when invoked through a symlinked skills dir", () => {
+  const dir = mkdtempSync(join(tmpdir(), "skills-link-"));
+  try {
+    symlinkSync(SKILLS, join(dir, "skills"), "dir");
+    for (const script of [
+      "faceless-explainer/scripts/captions.mjs",
+      "pr-to-video/scripts/captions.mjs",
+      "product-launch-video/scripts/captions.mjs",
+      "media-use/audio/scripts/heygen-voice.mjs",
+    ]) {
+      const run = spawnSync(process.execPath, [join(dir, "skills", script), "not-a-command"], {
+        encoding: "utf8",
+      });
+      assert.notEqual(run.status, 0, `${script} exited ${run.status} without running its CLI`);
+      assert.match(run.stderr, /usage/, script);
+    }
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+});
+
+function skillScripts(dir) {
+  return readdirSync(dir, { withFileTypes: true }).flatMap((entry) => {
+    const path = join(dir, entry.name);
+    if (entry.isDirectory()) return entry.name === "node_modules" ? [] : skillScripts(path);
+    return /\.(mjs|js)$/.test(entry.name) && !/\.test\.mjs$/.test(entry.name) ? [path] : [];
+  });
+}
+
+test("skill scripts detect their CLI entry through lib/main-module.mjs only", () => {
+  const handRolled = [...skillScripts(SKILLS), ...skillScripts(CLI_MEDIA_USE)].filter(
+    (path) =>
+      !path.endsWith("main-module.mjs") && readFileSync(path, "utf8").includes("process.argv[1]"),
+  );
+  assert.deepEqual(
+    handRolled.map((path) => relative(SKILLS, path)),
+    [],
+  );
+});

package/dist/skills/hyperframes/scripts/plugin-cli.mjs

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 // Run from the user's project; locate the release from this installed file.
 import { spawnSync } from "node:child_process";
-import { existsSync, readFileSync, realpathSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { join, win32 } from "node:path";
-import { fileURLToPath, pathToFileURL } from "node:url";
+import { fileURLToPath } from "node:url";
+import { isMainModule } from "./lib/main-module.mjs";
 
 const root = fileURLToPath(new URL("../../../", import.meta.url));
 const manifests = [
@@ -71,7 +72,7 @@ export function invocation(
   return { command: node, args: [npx, ...cliArgs], env: childEnv };
 }
 
-if (process.argv[1] && pathToFileURL(realpathSync(process.argv[1])).href === import.meta.url) {
+if (isMainModule(import.meta.url)) {
   try {
     const command = invocation(process.argv.slice(2));
     const result = spawnSync(command.command, command.args, {

package/dist/skills/hyperframes/scripts/plugin-cli.test.mjs

@@ -17,11 +17,15 @@ import { invocation, pluginVersion } from "./plugin-cli.mjs";
 function fixture(t, manifest = "plugin.json", version = "1.2.3") {
   const root = mkdtempSync(join(tmpdir(), "hf-plugin-"));
   t.after(() => rmSync(root, { recursive: true, force: true }));
-  mkdirSync(join(root, "skills/hyperframes/scripts"), { recursive: true });
+  mkdirSync(join(root, "skills/hyperframes/scripts/lib"), { recursive: true });
   mkdirSync(join(root, manifest, ".."), { recursive: true });
   writeFileSync(join(root, manifest), JSON.stringify({ name: "hyperframes", version }));
   const launcher = join(root, "skills/hyperframes/scripts/plugin-cli.mjs");
   copyFileSync(new URL("./plugin-cli.mjs", import.meta.url), launcher);
+  copyFileSync(
+    new URL("./lib/main-module.mjs", import.meta.url),
+    join(root, "skills/hyperframes/scripts/lib/main-module.mjs"),
+  );
   return { root, launcher };
 }
 

package/dist/skills/hyperframes-cli/SKILL.md

@@ -130,6 +130,8 @@ Use `selection.target.hfId` when available, otherwise its selector and source fi
 | Self-managed distributed AWS render      | `npx hyperframes lambda render <project> --width 1920 --height 1080 --wait`   |
 | Self-managed distributed GCP render      | `npx hyperframes cloudrun render <project> --width 1920 --height 1080 --wait` |
 
+A render stops when whatever started it stops, so a Ctrl-C or a closed terminal never leaves Chrome running. If your tool kills its whole process group when a command times out or ends, a long render dies with it. Start such a render in its own process group with `HYPERFRAMES_RENDER_DETACHED=1`, for example `bash -c 'set -m; HYPERFRAMES_RENDER_DETACHED=1 npx hyperframes render --output out.mp4 < /dev/null > render.log 2>&1 &'` (works on macOS and Linux), then check the log and the output file instead of waiting on the command.
+
 Skill attribution is automatic — the examples above need no `--skill`. A project scaffolded by a workflow (`hyperframes init --skill=<workflow>`) records its owning skill in `hyperframes.json`, and every later render inherits it on anonymous telemetry: re-renders, `npm run render`, and `--batch` alike. Pass `--skill=<slug>` explicitly only to stamp a project that was not created through a workflow (its first render then persists it).
 
 Use cloud rendering when the user wants hosted rendering without local Chrome, FFmpeg, or AWS. Use Lambda only when AWS ownership is a requirement. Use Cloud Run only when GCP ownership is a requirement. Read the matching reference before running any cloud path.

package/dist/skills/hyperframes-cli/references/lint-validate-inspect.md

@@ -50,7 +50,7 @@ One command, one Chrome boot. `check` runs the linter first and skips the browse
 
 Every finding carries a selector, the element's `data-*` identity, the composition source file, a bbox, and the sample time: jump straight from the JSON to the HTML you must edit and re-run.
 
-**Severity is persistence-aware.** A dynamic issue observed at a single grid sample (an entrance/exit transient) demotes to info and never gates. Issues held across samples gate the exit code, a held `content_overlap` is an error, and a held, partially-visible `canvas_overflow` breaching ≥5% of the canvas promotes to warning. Coordinate-frame findings (`escaped_container`, `panel_out_of_canvas`, `connector_detached`) flag geometry computed in one frame but rendered in another — an element far outside its offset parent, a painted panel stuck across the canvas edge, a connector line detached from every node. Text drawn into a `<canvas>` has no DOM box, so `canvas_overflow` cannot see it; `canvas_content_at_edge` warns when a canvas's pixels show sharp content (drawn text, hard shapes) along the frame edge — mark intentional full-bleed art (particles, photos) with `data-layout-allow-overflow`. If a 3s+ composition shows no visible change across every sample, `check` fails with `sweep_static`: a frozen timeline makes every green verdict unreliable, so it refuses to pass. When only audio advanced, it warns instead; a composition meant to be still takes `data-no-timeline` on its root. The fingerprint includes per-element opacity, so opacity-only reveals (code typing, staggered fades) count as motion — but only while they're still in flight at the sampled times. The classic trap is a reveal that completes early and then holds a static frame for the rest of the duration: every sample lands on the settled state and the run fails. Spread the reveal across the timeline or keep one continuously animated element alive (a blinking caret is idiomatic for code typing) — don't bolt on a slow position drift just to appease the check.
+**Severity is persistence-aware.** A dynamic issue observed at a single grid sample (an entrance/exit transient) demotes to info and never gates. Issues held across samples gate the exit code, a held `content_overlap` is an error, and a held, partially-visible `canvas_overflow` breaching ≥5% of the canvas promotes to warning. Coordinate-frame findings (`escaped_container`, `panel_out_of_canvas`, `connector_detached`) flag geometry computed in one frame but rendered in another — an element far outside its offset parent, a painted panel stuck across the canvas edge, a connector line detached from every node. Text drawn into a `<canvas>` has no DOM box, so `canvas_overflow` cannot see it; `canvas_content_at_edge` warns when a canvas's pixels show sharp content (drawn text, hard shapes) along the frame edge — mark intentional full-bleed art (particles, photos) with `data-layout-allow-overflow`. If a 3s+ composition shows no visible change across every sample, `check` fails with `sweep_static`: a frame that never changes while a GSAP timeline or tween, or a CSS or Web animation, holds the same time without ever finishing means the seek is not driving the page, so it refuses to pass. Any other frame that never changes (a still title card, an audio-only advance) is a warning that `--strict` fails; a composition meant to be still can take `data-no-timeline` on its root to skip it. The fingerprint includes per-element opacity, so opacity-only reveals (code typing, staggered fades) count as motion — but only while they're still in flight at the sampled times. The classic trap is a reveal that completes early and then holds a static frame for the rest of the duration: every sample lands on the settled state and check warns that nothing on screen moved (`--strict` fails it). Spread the reveal across the timeline or keep one continuously animated element alive (a blinking caret is idiomatic for code typing) — don't bolt on a slow position drift just to appease the check.
 
 **Escape hatches** (mark intent in the HTML, then re-run):
 

package/dist/skills/media-use/audio/scripts/heygen-voice.mjs

@@ -5,9 +5,9 @@
 
 import { readFileSync } from "node:fs";
 import { extname } from "node:path";
-import { fileURLToPath } from "node:url";
 import { parseArgs } from "node:util";
 import { heygenAuthHeaders, heygenJSON, heygenMessage, loadEnvFromDir } from "./lib/heygen.mjs";
+import { isMainModule } from "./lib/main-module.mjs";
 
 const MEDIA_TYPES = { ".mp3": "audio/mpeg", ".wav": "audio/wav" };
 const POLL_MS = 2_000;
@@ -92,7 +92,7 @@ export async function main(
   }
 }
 
-if (process.argv[1] === fileURLToPath(import.meta.url)) {
+if (isMainModule(import.meta.url)) {
   loadEnvFromDir(process.cwd());
   process.exitCode = await main(process.argv.slice(2));
 }

package/dist/skills/media-use/audio/scripts/lib/main-module.mjs

@@ -0,0 +1,13 @@
+import { realpathSync } from "node:fs";
+import { pathToFileURL } from "node:url";
+
+// Node resolves symlinks in the main module's import.meta.url but argv[1] keeps the invoked
+// spelling (a symlinked skills dir, or /tmp vs /private/tmp on macOS), so compare real paths.
+export function isMainModule(importMetaUrl) {
+  if (!process.argv[1]) return false;
+  try {
+    return pathToFileURL(realpathSync(process.argv[1])).href === importMetaUrl;
+  } catch {
+    return false;
+  }
+}