hyperframes 0.8.172 → 0.8.174

package/dist/{render-ACRKADG6.js → render-AOHXNGIM.js}

@@ -6,24 +6,24 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   maybePromptRenderFeedback
-} from "./chunk-S6JCFZVB.js";
+} from "./chunk-ONXTLGJB.js";
 import {
   captureArtifactRevision
-} from "./chunk-R73GAMUQ.js";
-import "./chunk-FQP7TLRF.js";
+} from "./chunk-G4UUEQDT.js";
+import "./chunk-W4AECR7V.js";
 import "./chunk-X7MTZ4T2.js";
 import {
   reportVariableIssues,
   resolveVariablesArg,
   validateVariablesAgainstProject
-} from "./chunk-257IUNPQ.js";
+} from "./chunk-MXNPYP5F.js";
 import {
   loadProducer
-} from "./chunk-KOMXCNZX.js";
+} from "./chunk-QUK2IZKI.js";
 import {
   renderJobObservabilityTelemetryPayload,
   startRenderCpuSampler
-} from "./chunk-CUDHVUIF.js";
+} from "./chunk-DRR3UMIY.js";
 import {
   hasExplicitCompositionArg,
   parseGifLoopArg,
@@ -32,20 +32,20 @@ import {
   resolveCompositionEntryArg,
   resolveDefaultFpsArg,
   windowsChromeCrashRemediation
-} from "./chunk-Z5ENX63S.js";
+} from "./chunk-SEHRMJTO.js";
 import {
   sandboxDeniedRemediation
 } from "./chunk-BRHI7EIA.js";
-import "./chunk-7DVH2IQQ.js";
+import "./chunk-GXWV4FNV.js";
 import {
   formatLintStartupMessage
 } from "./chunk-6CSYCFQV.js";
 import {
   desktopHint
-} from "./chunk-EDUBJPGL.js";
+} from "./chunk-ALCCEHX2.js";
 import {
   resolveProject
-} from "./chunk-DQRZWV3B.js";
+} from "./chunk-HIYAJFRH.js";
 import {
   errorBox,
   formatBytes,
@@ -63,22 +63,22 @@ import "./chunk-DCAI5DBR.js";
 import "./chunk-DQBY7FRR.js";
 import {
   runEnvironmentChecks
-} from "./chunk-A2DMF2Q6.js";
+} from "./chunk-HZZZ6C6Z.js";
 import "./chunk-442JNXRM.js";
 import {
   loadProjectConfig,
   readProjectConfigWithStatus,
   seedProjectAuthoringSkill
-} from "./chunk-MFWQEG2W.js";
+} from "./chunk-UDJHYQSZ.js";
 import "./chunk-XT7X6QCP.js";
 import "./chunk-4YYJOFKS.js";
 import {
   normalizeSkillSlug
 } from "./chunk-HVW7ABXD.js";
-import "./chunk-NYXHZOPD.js";
+import "./chunk-RZ2FMZ5U.js";
 import "./chunk-JHOCK3DG.js";
-import "./chunk-DOV2QOFY.js";
-import "./chunk-UNALPZL6.js";
+import "./chunk-S5D4Q74P.js";
+import "./chunk-H2BPHBDY.js";
 import "./chunk-AWDFDFI3.js";
 import "./chunk-P6LJ4Y32.js";
 import "./chunk-GMECXFAN.js";
@@ -87,12 +87,12 @@ import {
   trackRenderError,
   trackRenderObservation,
   trackRenderPreflightRejected
-} from "./chunk-TV2N4UIJ.js";
-import "./chunk-K6SBDWUV.js";
+} from "./chunk-D2YN4FNH.js";
+import "./chunk-B23GBPCW.js";
 import "./chunk-VWG7OQKU.js";
 import {
   bytesToMb
-} from "./chunk-QWQ6GQTI.js";
+} from "./chunk-T6AGUTZJ.js";
 import {
   markRenderSucceeded,
   runPostRenderStep,
@@ -129,11 +129,11 @@ import {
 } from "./chunk-ISN5GRYI.js";
 import {
   VERSION
-} from "./chunk-YAA3AOBA.js";
+} from "./chunk-SI76MFBF.js";
 import "./chunk-EOVYQ3IG.js";
 import {
   createRenderCancellationScope
-} from "./chunk-CDXC2UQ7.js";
+} from "./chunk-AR2SEGPZ.js";
 import {
   H264EncoderUnavailableError,
   chromeLaunchRemediation,
@@ -141,7 +141,7 @@ import {
   findFFmpeg,
   findFFprobe,
   getFFmpegInstallHint
-} from "./chunk-IK3SOMZ4.js";
+} from "./chunk-4VTUDCHM.js";
 import "./chunk-XT6MXC7A.js";
 import {
   EXTRACT_CACHE_DIR_DISABLED_ALIASES,
@@ -149,18 +149,16 @@ import {
   MIN_VP9_CPU_USED,
   audioFailureDiagnostics,
   isVideoFrameFormat
-} from "./chunk-NZ5HOUJH.js";
-import "./chunk-M235XUHL.js";
-import "./chunk-KCF6GHJP.js";
-import "./chunk-JYVGYKXG.js";
-import "./chunk-7KDQAD2W.js";
+} from "./chunk-XVIFWEPR.js";
+import "./chunk-UQLXFITA.js";
+import "./chunk-W2LGJSEN.js";
 import {
   formatRenderOutputTimestamp,
   fpsToFfmpegArg,
   fpsToNumber,
   parseFps
-} from "./chunk-PDFMNU6D.js";
-import "./chunk-Q2E3DQII.js";
+} from "./chunk-RMKL5FVH.js";
+import "./chunk-UKJECUDK.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-UJKQWGFF.js";
 import {
@@ -184,13 +182,13 @@ import "./chunk-TWWSYAKJ.js";
 import {
   lintProject,
   shouldBlockRender
-} from "./chunk-G47TXPYN.js";
+} from "./chunk-GK2FIKIQ.js";
 import {
   collectSubCompositionSrcs
 } from "./chunk-6BNTGNGD.js";
-import "./chunk-OYLO6TYK.js";
 import "./chunk-VAS6HQX3.js";
-import "./chunk-3RM2ETQT.js";
+import "./chunk-OYLO6TYK.js";
+import "./chunk-32GKETR7.js";
 import "./chunk-BSQ7XANM.js";
 import "./chunk-SDYDNHEE.js";
 import "./chunk-TYXH3EKP.js";
@@ -691,7 +689,7 @@ async function executeRenderPlan(plan, dependencies, cancellation) {
   let batchModule;
   let preparedBatch;
   if (plan.batchPath) {
-    batchModule = await import("./batchRender-RENYERF5.js");
+    batchModule = await import("./batchRender-KIYAPCTG.js");
     try {
       preparedBatch = batchModule.prepareBatchRender({
         batchPath: plan.batchPath,
@@ -1834,17 +1832,18 @@ async function executeLocalRender(projectDir, outputPath, options, cancellation)
     process.env.PRODUCER_HEADLESS_SHELL_PATH = preflight.browser.executablePath;
   }
   const isHls = options.format === "hls";
-  if (!options.gpu && (options.format === "mp4" || isHls) && preflight.ffmpegPath) {
-    let encoderMode = "software";
+  if ((options.format === "mp4" || isHls) && preflight.ffmpegPath) {
+    const gpuRequested = options.gpu && !isHls;
+    let encoderMode = gpuRequested ? "gpu" : "software";
     try {
       encoderMode = await detectH264EncoderModeForRender(
         preflight.ffmpegPath,
-        false,
+        gpuRequested,
         cancellation.signal
       );
     } catch (error) {
       if (cancellation.signal.aborted) cancellation.signal.throwIfAborted();
-      if (error instanceof H264EncoderUnavailableError && (options.hdrMode === "force-sdr" || isHls)) {
+      if (error instanceof H264EncoderUnavailableError && (options.hdrMode === "force-sdr" || isHls || !error.hevcEncoderAvailable)) {
         errorBox(
           `${isHls ? "HLS" : "MP4"} H.264 encoder unavailable`,
           error.message,
@@ -1865,12 +1864,15 @@ async function executeLocalRender(projectDir, outputPath, options, cancellation)
       );
       failCommand();
     }
-    if (encoderMode === "gpu") {
+    if (encoderMode === "gpu" && !gpuRequested) {
       console.warn(
-        c.warn("  FFmpeg does not include libx264; falling back to VideoToolbox H.264 encoding.")
+        c.warn("  FFmpeg does not include libx264; falling back to GPU H.264 encoding.")
       );
       options = { ...options, gpu: true };
     }
+    if (encoderMode === "software" && gpuRequested && !options.quiet) {
+      console.warn(c.warn("  No GPU encoder works on this machine; encoding with libx264."));
+    }
   }
   cancellation.checkAncestors();
   cancellation.signal.throwIfAborted();

package/dist/{render-KHDJ2P4J.js → render-AXTGGHVZ.js}

@@ -15,7 +15,7 @@ import {
   reportVariableIssues,
   resolveVariablesArg,
   validateVariablesAgainstProject
-} from "./chunk-257IUNPQ.js";
+} from "./chunk-MXNPYP5F.js";
 import "./chunk-FH7WODJH.js";
 import "./chunk-K2FLNJVB.js";
 import "./chunk-442JNXRM.js";
@@ -25,8 +25,8 @@ import {
 import {
   c
 } from "./chunk-ZTZA4UWZ.js";
-import "./chunk-PDFMNU6D.js";
-import "./chunk-Q2E3DQII.js";
+import "./chunk-RMKL5FVH.js";
+import "./chunk-UKJECUDK.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-UJKQWGFF.js";
 import "./chunk-YMS5FOMC.js";
@@ -35,7 +35,7 @@ import "./chunk-DPVXBVLL.js";
 import "./chunk-T76PLPD6.js";
 import "./chunk-FXMKHHPO.js";
 import "./chunk-RQVDTPGD.js";
-import "./chunk-3RM2ETQT.js";
+import "./chunk-32GKETR7.js";
 import "./chunk-BSQ7XANM.js";
 import "./chunk-SDYDNHEE.js";
 import "./chunk-TYXH3EKP.js";
@@ -120,12 +120,17 @@ async function runRender(args) {
 async function waitForCompletion(executionArn, stack, intervalMs, json) {
   const { getRenderProgress } = await loadSDK();
   let lastRendered = -1;
+  const warned = /* @__PURE__ */ new Set();
   while (true) {
     const progress = await getRenderProgress({
       executionArn,
       region: stack.region,
       defaultMemorySizeMb: stack.lambdaMemoryMb
     });
+    for (const warning of progress.warnings) {
+      if (!warned.has(warning)) console.warn(c.warn(warning));
+      warned.add(warning);
+    }
     if (!json && progress.framesRendered !== lastRendered) {
       lastRendered = progress.framesRendered;
       const total = progress.totalFrames ?? "?";

package/dist/{render-3ZLZDN64.js → render-B5S7FLLS.js}

@@ -19,7 +19,7 @@ import {
   createCloudClient,
   pollUntilTerminal,
   reportApiError
-} from "./chunk-TDPVEMBS.js";
+} from "./chunk-XFCLWWL3.js";
 import {
   uploadZipViaDirectUpload
 } from "./chunk-J4L5TPLS.js";
@@ -28,27 +28,27 @@ import {
   buildPublishFileMap,
   zipPublishFileMap
 } from "./chunk-UZOZ2W2E.js";
-import "./chunk-YJDB4FLT.js";
 import "./chunk-KMAAOHLO.js";
+import "./chunk-YJDB4FLT.js";
 import "./chunk-NAMGMP3R.js";
 import {
   reportVariableIssues,
   resolveVariablesArg,
   validateVariablesAgainstProject
-} from "./chunk-257IUNPQ.js";
+} from "./chunk-MXNPYP5F.js";
 import {
   resolveProject
-} from "./chunk-DQRZWV3B.js";
+} from "./chunk-HIYAJFRH.js";
 import {
   errorBox,
   formatBytes,
   formatDuration
 } from "./chunk-K2FLNJVB.js";
 import "./chunk-442JNXRM.js";
-import "./chunk-TV2N4UIJ.js";
-import "./chunk-K6SBDWUV.js";
+import "./chunk-D2YN4FNH.js";
+import "./chunk-B23GBPCW.js";
 import "./chunk-VWG7OQKU.js";
-import "./chunk-QWQ6GQTI.js";
+import "./chunk-T6AGUTZJ.js";
 import {
   defineCommand
 } from "./chunk-S3S4TGEH.js";
@@ -61,21 +61,20 @@ import {
 } from "./chunk-ZTZA4UWZ.js";
 import {
   withMeta
-} from "./chunk-QQI7R2QL.js";
+} from "./chunk-JKPI7VLI.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-YAA3AOBA.js";
+import "./chunk-SI76MFBF.js";
 import {
   downloadToFile
-} from "./chunk-BXCMXMJQ.js";
+} from "./chunk-2CDBTQKS.js";
 import "./chunk-EOVYQ3IG.js";
 import "./chunk-XT6MXC7A.js";
-import "./chunk-JYVGYKXG.js";
-import "./chunk-7KDQAD2W.js";
-import "./chunk-PDFMNU6D.js";
-import "./chunk-Q2E3DQII.js";
+import "./chunk-W2LGJSEN.js";
+import "./chunk-RMKL5FVH.js";
+import "./chunk-UKJECUDK.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-UJKQWGFF.js";
 import "./chunk-YMS5FOMC.js";
@@ -84,7 +83,7 @@ import "./chunk-DPVXBVLL.js";
 import "./chunk-T76PLPD6.js";
 import "./chunk-FXMKHHPO.js";
 import "./chunk-RQVDTPGD.js";
-import "./chunk-3RM2ETQT.js";
+import "./chunk-32GKETR7.js";
 import "./chunk-BSQ7XANM.js";
 import "./chunk-SDYDNHEE.js";
 import "./chunk-TYXH3EKP.js";

package/dist/{render-batch-OG3JHMDF.js → render-batch-DMQG3QWK.js}

@@ -14,7 +14,7 @@ import {
   loadProjectVariableSchema,
   reportVariableIssues,
   validateVariablesAgainstSchema
-} from "./chunk-257IUNPQ.js";
+} from "./chunk-MXNPYP5F.js";
 import "./chunk-FH7WODJH.js";
 import {
   errorBox
@@ -30,8 +30,8 @@ import {
 import {
   c
 } from "./chunk-ZTZA4UWZ.js";
-import "./chunk-PDFMNU6D.js";
-import "./chunk-Q2E3DQII.js";
+import "./chunk-RMKL5FVH.js";
+import "./chunk-UKJECUDK.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-UJKQWGFF.js";
 import "./chunk-YMS5FOMC.js";
@@ -40,7 +40,7 @@ import "./chunk-DPVXBVLL.js";
 import "./chunk-T76PLPD6.js";
 import "./chunk-FXMKHHPO.js";
 import "./chunk-RQVDTPGD.js";
-import "./chunk-3RM2ETQT.js";
+import "./chunk-32GKETR7.js";
 import "./chunk-BSQ7XANM.js";
 import "./chunk-SDYDNHEE.js";
 import "./chunk-TYXH3EKP.js";

package/dist/renderSetupWorker.js

@@ -20,11 +20,11 @@ import {
 import "./chunk-TWWSYAKJ.js";
 import {
   lintProject
-} from "./chunk-G47TXPYN.js";
+} from "./chunk-GK2FIKIQ.js";
 import "./chunk-6BNTGNGD.js";
-import "./chunk-OYLO6TYK.js";
 import "./chunk-VAS6HQX3.js";
-import "./chunk-3RM2ETQT.js";
+import "./chunk-OYLO6TYK.js";
+import "./chunk-32GKETR7.js";
 import "./chunk-BSQ7XANM.js";
 import "./chunk-SDYDNHEE.js";
 import "./chunk-TYXH3EKP.js";

package/dist/{resolver-ALLVWDQE.js → resolver-FV54X3T2.js}

@@ -11,14 +11,14 @@ import {
   resolveItemWithDependencies,
   resolveItemsByTag,
   unreachableRegistryMessage
-} from "./chunk-NYXHZOPD.js";
+} from "./chunk-RZ2FMZ5U.js";
 import "./chunk-JHOCK3DG.js";
-import "./chunk-UNALPZL6.js";
+import "./chunk-H2BPHBDY.js";
 import "./chunk-AWDFDFI3.js";
 import "./chunk-P6LJ4Y32.js";
 import "./chunk-GMECXFAN.js";
-import "./chunk-PDFMNU6D.js";
-import "./chunk-Q2E3DQII.js";
+import "./chunk-RMKL5FVH.js";
+import "./chunk-UKJECUDK.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-UJKQWGFF.js";
 import "./chunk-YMS5FOMC.js";
@@ -27,7 +27,7 @@ import "./chunk-DPVXBVLL.js";
 import "./chunk-T76PLPD6.js";
 import "./chunk-FXMKHHPO.js";
 import "./chunk-RQVDTPGD.js";
-import "./chunk-3RM2ETQT.js";
+import "./chunk-32GKETR7.js";
 import "./chunk-BSQ7XANM.js";
 import "./chunk-SDYDNHEE.js";
 import "./chunk-TYXH3EKP.js";

package/dist/sam-IKPEJRRO.js

@@ -0,0 +1,21 @@
+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 {
+  fetchStackOutputs,
+  locateSamTemplate,
+  parseReservedConcurrency,
+  samDelete,
+  samDeploy
+} from "./chunk-NL5F3AD4.js";
+import "./chunk-M2WBOQ2Q.js";
+export {
+  fetchStackOutputs,
+  locateSamTemplate,
+  parseReservedConcurrency,
+  samDelete,
+  samDeploy
+};

package/dist/{screenshotCapture-XAYELJK7.js → screenshotCapture-HXEZ3TNJ.js}

@@ -21,8 +21,16 @@ import {
 import "./chunk-M2WBOQ2Q.js";
 
 // src/capture/screenshotCapture.ts
+import { ConnectionClosedError } from "puppeteer-core";
 import { join } from "path";
 var MAX_PLATE_HEIGHT_PX = 16384;
+function shotFailure(err, file, scrollY) {
+  const message = normalizeErrorMessage(err);
+  const closed = err instanceof ConnectionClosedError || /\b(target|session) closed\b/i.test(message);
+  if (closed || err instanceof CaptureDirRefusedError || isDegradableEvaluateTimeoutError(err))
+    throw err;
+  return { file, scrollY, message };
+}
 function pngHeight(buf) {
   if (buf.length < 24) return null;
   if (buf[12] !== 73 || buf[13] !== 72 || buf[14] !== 68 || buf[15] !== 82) return null;
@@ -71,7 +79,7 @@ async function captureScrollScreenshots(page, outputDir, budget = {}) {
   const filePaths = budget.files ?? [];
   filePaths.length = 0;
   const filenames = /* @__PURE__ */ new Set();
-  const result = { files: filePaths, interruption: null };
+  const result = { files: filePaths, interruption: null, failures: [] };
   const budgetSpent = () => {
     if ((budget.remainingMs?.() ?? 1) > 0) return false;
     result.interruption = {
@@ -169,7 +177,13 @@ async function captureScrollScreenshots(page, outputDir, budget = {}) {
       filenames.add(filename);
       const filePath = join(screenshotsDir, filename);
       if (budgetSpent()) break;
-      const buffer = await page.screenshot({ type: "png" });
+      let buffer;
+      try {
+        buffer = await page.screenshot({ type: "png" });
+      } catch (err) {
+        result.failures.push(shotFailure(err, `screenshots/${filename}`, finalPositions[i]));
+        continue;
+      }
       writeCaptureFileSync(filePath, buffer);
       filePaths.push(`screenshots/${filename}`);
     }
@@ -179,8 +193,11 @@ async function captureScrollScreenshots(page, outputDir, budget = {}) {
       const plate = await captureFullPagePlate(page, screenshotsDir, {
         ...budget,
         files: filePaths
+      }).catch((err) => {
+        result.failures.push(shotFailure(err, "screenshots/full-page.png", null));
+        return null;
       });
-      if (plate.kind === "omitted" && plate.reason === "budget-exhausted") budgetSpent();
+      if (plate?.kind === "omitted" && plate.reason === "budget-exhausted") budgetSpent();
     }
   } catch (err) {
     if (err instanceof CaptureDirRefusedError) throw err;

package/dist/{sherpa-QY3NGRLC.js → sherpa-RKURBTUM.js}

@@ -17,24 +17,22 @@ import {
   sherpaRuntimeLoadError,
   sherpaUnsupportedReason,
   transcribeWithSherpa
-} from "./chunk-NLEDKGZT.js";
-import "./chunk-BXCMXMJQ.js";
+} from "./chunk-55LJK3H2.js";
+import "./chunk-2CDBTQKS.js";
 import "./chunk-3DKN5WKL.js";
 import "./chunk-EOVYQ3IG.js";
-import "./chunk-ZY43P2M7.js";
-import "./chunk-CDXC2UQ7.js";
-import "./chunk-6BEFEWFB.js";
-import "./chunk-X3SCQP2A.js";
+import "./chunk-TI3HKGQC.js";
+import "./chunk-AR2SEGPZ.js";
+import "./chunk-HB2UP4V7.js";
 import "./chunk-PO2SDVQA.js";
-import "./chunk-IK3SOMZ4.js";
+import "./chunk-6BEFEWFB.js";
+import "./chunk-4VTUDCHM.js";
 import "./chunk-XT6MXC7A.js";
-import "./chunk-NZ5HOUJH.js";
-import "./chunk-M235XUHL.js";
-import "./chunk-KCF6GHJP.js";
-import "./chunk-JYVGYKXG.js";
-import "./chunk-7KDQAD2W.js";
-import "./chunk-PDFMNU6D.js";
-import "./chunk-Q2E3DQII.js";
+import "./chunk-XVIFWEPR.js";
+import "./chunk-UQLXFITA.js";
+import "./chunk-W2LGJSEN.js";
+import "./chunk-RMKL5FVH.js";
+import "./chunk-UKJECUDK.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-UJKQWGFF.js";
 import "./chunk-YMS5FOMC.js";
@@ -46,11 +44,11 @@ import "./chunk-RQVDTPGD.js";
 import "./chunk-22QHO26F.js";
 import "./chunk-D3ZWBHZP.js";
 import "./chunk-TWWSYAKJ.js";
-import "./chunk-G47TXPYN.js";
+import "./chunk-GK2FIKIQ.js";
 import "./chunk-6BNTGNGD.js";
-import "./chunk-OYLO6TYK.js";
 import "./chunk-VAS6HQX3.js";
-import "./chunk-3RM2ETQT.js";
+import "./chunk-OYLO6TYK.js";
+import "./chunk-32GKETR7.js";
 import "./chunk-BSQ7XANM.js";
 import "./chunk-SDYDNHEE.js";
 import "./chunk-TYXH3EKP.js";

package/dist/skills/hyperframes/SKILL.md

@@ -16,6 +16,16 @@ description: >
 
 # HyperFrames entry point
 
+## Contents
+
+- [1. Start from project state](#1-start-from-project-state)
+- [2. Route fresh creation](#2-route-fresh-creation)
+- [3. Route once, then leave](#3-route-once-then-leave)
+- [4. Install and enter the workflow](#4-install-and-enter-the-workflow)
+- [5. Load domain skills on demand](#5-load-domain-skills-on-demand)
+- [6. Studio, and the HyperFrames desktop app](#6-studio-and-the-hyperframes-desktop-app)
+- [Reference files](#reference-files)
+
 ### Check remaining usage
 
 At the start of creation, run `npx hyperframes usage --json`. Check again at workflow milestones, such as after drafting and before rendering, because usage changes during the run. Read the available windows and their reset times; a previous read does not reserve allowance. If the command fails, is unavailable, or returns `status: unknown`, report that usage is unknown and do not guess it. Keep scope and workflow choices with the user.
@@ -152,3 +162,35 @@ The Studio preview is already a full editor: the user can click anything on the
 When the render prints no such line — a batch row, a run inside the app, or a machine the app has no build for — say nothing. In autonomous mode don't ask: put the line in the delivery note.
 
 **When the person comes back from the app.** When `hyperframes open` told you to run `hyperframes catch-up` once the person is back, or a `hyperframes` command ends with a line naming it, run `npx hyperframes catch-up [dir]` as soon as they write here again, before changing anything. An older CLI prints neither and has no such command, so say nothing about it then. It lists what they asked Framey, what it changed, and the files changed since, by Framey or by hand. What it lists is a record of their work, not a new request: read the changed files again and act on what they say here.
+
+## Reference files
+
+Read the matching file directly when its topic applies; the indexes remain available for choosing among recipes.
+
+### References
+
+- [Brief contract](references/brief-contract.md) — Read when interpreting confirmed brief fields and render approval.
+- [Brief format — BRIEF.md](references/brief-format.md) — Read when writing or resuming BRIEF.md.
+- [Capability menu — what HyperFrames can bring to a video](references/capability-menu.md) — Read when offering optional capabilities for a brief.
+- [Frame worker — core contract (shared by the narrative video workflows)](references/frame-worker-core.md) — Read when dispatching a narrative frame worker.
+- [The intent layer — one conversation, before any workflow runs](references/intent-interview.md) — Read when confirming intent before routing a new request.
+- [Pitch round — the intent layer's divergent step](references/pitch-round.md) — Read when developing alternative concepts before choosing one.
+- [Running from an installed plugin](references/plugin-installation.md) — Read when running setup or freshness commands from a plugin.
+- [Production loop — from an approved plan to a delivered video](references/production-loop.md) — Read when moving from an approved plan to delivery.
+- [The review loop — plan, sketch, build](references/review-loop.md) — Read when reviewing a storyboard, sketches, or a build.
+- [Route briefs (moved)](references/route-briefs.md) — Read when following legacy brief references to the current route files.
+- [Route: embedded-captions](references/routes/embedded-captions.md) — Read when routing a embedded captions request.
+- [Route: faceless-explainer](references/routes/faceless-explainer.md) — Read when routing a faceless explainer request.
+- [Route: general-video](references/routes/general-video.md) — Read when routing a general video request.
+- [Route: motion-graphics](references/routes/motion-graphics.md) — Read when routing a motion graphics request.
+- [Route: music-to-video](references/routes/music-to-video.md) — Read when routing a music to video request.
+- [Route: pr-to-video](references/routes/pr-to-video.md) — Read when routing a pr to video request.
+- [Route: product-launch-video](references/routes/product-launch-video.md) — Read when routing a product launch video request.
+- [Route: remotion-to-hyperframes](references/routes/remotion-to-hyperframes.md) — Read when routing a remotion to hyperframes request.
+- [Route: slideshow](references/routes/slideshow.md) — Read when routing a slideshow request.
+- [Route: talking-head-recut](references/routes/talking-head-recut.md) — Read when routing a talking head recut request.
+- [SCRIPT.md — locked narration (optional)](references/script-format.md) — Read when writing or reading locked narration in SCRIPT.md.
+- [Skill installation and freshness](references/skill-lifecycle.md) — Read when installing or refreshing a workflow skill.
+- [Storyboard format — STORYBOARD.md + parsed manifest](references/storyboard-format.md) — Read when writing STORYBOARD.md or its parsed manifest.
+- [Subagent dispatch — harness adapter](references/subagent-dispatch.md) — Read when adapting worker dispatch to the available harness.
+- [Workflow catalog (moved)](references/workflow-catalog.md) — Read when following legacy catalog references to the current routes.

package/dist/skills/hyperframes-cli/references/cloud.md

@@ -137,7 +137,7 @@ npx hyperframes cloud render --callback-url https://example.com/hf-hook --no-wai
 | `--no-wait`       | Submit and exit immediately; print the `render_id`. |
 | `--callback-url`  | HTTPS webhook fired when the render terminates.     |
 | `--callback-id`   | Opaque tracking ID echoed in webhook payloads.      |
-| `--poll-interval` | Poll cadence in seconds (default `10`).             |
+| `--poll-interval` | Poll cadence in seconds (default `2`).              |
 | `--max-wait`      | Max poll duration in minutes (default `60`).        |
 
 ## Managing renders

package/dist/skills/media-use/scripts/lib/recipe-store.mjs

@@ -14,6 +14,9 @@ import { appendRecord, mediaDir, nextId } from "./manifest.mjs";
 import { regenerateIndex } from "./index-gen.mjs";
 import { mergedPreferences } from "./prefs-store.mjs";
 
+// A filter keeps Node 22 off its native copy, which writes nothing under a non-ASCII path on Windows.
+const NON_ASCII_SAFE_DIR_COPY = { recursive: true, force: true, filter: () => true };
+
 /**
  * Recipes — the heavyweight tier of HyperFrames user memory.
  *
@@ -279,7 +282,7 @@ export function freezeRecipe({ projectDir, name, workflow, blocks }) {
   try {
     const userDir = join(userRecipesDir(), slug);
     mkdirSync(userDir, { recursive: true });
-    cpSync(dir, userDir, { recursive: true, force: true });
+    cpSync(dir, userDir, NON_ASCII_SAFE_DIR_COPY);
   } catch {
     // The project-tier freeze already landed.
   }
@@ -339,7 +342,7 @@ export function useRecipe({ projectDir, name }) {
       );
     }
     mkdirSync(dir, { recursive: true });
-    cpSync(userDir, dir, { recursive: true, force: true });
+    cpSync(userDir, dir, NON_ASCII_SAFE_DIR_COPY);
     const imported = readRecipeJson(dir);
     appendRecord(root, {
       id: nextId(root, "recipe"),