@hyperframes/producer 0.8.227 → 0.8.228

package/dist/public-server.js

@@ -2,7 +2,7 @@
 
 // src/server.ts
 import {
-  existsSync as existsSync20,
+  existsSync as existsSync21,
   mkdirSync as mkdirSync11,
   statSync as statSync10,
   mkdtempSync as mkdtempSync4,
@@ -10,7 +10,7 @@ import {
   rmSync as rmSync11,
   createReadStream as createReadStream3
 } from "node:fs";
-import { resolve as resolve10, dirname as dirname13, join as join31 } from "node:path";
+import { resolve as resolve10, dirname as dirname14, join as join32 } from "node:path";
 import { tmpdir as tmpdir3 } from "node:os";
 import { parseArgs } from "node:util";
 import crypto from "node:crypto";
@@ -22,7 +22,7 @@ import { fetchPublicHttpsText as fetchPublicHttpsText2 } from "@hyperframes/engi
 // src/services/renderOrchestrator.ts
 import { audioFailureDiagnostics as audioFailureDiagnostics2 } from "@hyperframes/engine";
 import {
-  existsSync as existsSync17,
+  existsSync as existsSync18,
   mkdirSync as mkdirSync10,
   readdirSync as readdirSync5,
   rmSync as rmSync10,
@@ -77,7 +77,7 @@ import {
   augmentProtocolTimeoutError,
   augmentPageNavigationTimeoutError
 } from "@hyperframes/engine";
-import { join as join27, dirname as dirname11, resolve as resolve8 } from "path";
+import { join as join28, dirname as dirname12, resolve as resolve8 } from "path";
 import { totalmem as totalmem2 } from "node:os";
 import { randomUUID } from "crypto";
 import { fileURLToPath as fileURLToPath4 } from "url";
@@ -9809,7 +9809,7 @@ async function planVideoLayerPassthrough(input) {
 }
 
 // src/services/render/stages/audioStage.ts
-import { join as join20 } from "node:path";
+import { join as join21 } from "node:path";
 import {
   MIXED_AUDIO_FILENAME,
   audioFailureDiagnostics,
@@ -9818,6 +9818,16 @@ import {
   collectScratchLeftovers
 } from "@hyperframes/engine";
 
+// src/services/render/audioDeliveryLimit.ts
+import { existsSync as existsSync13 } from "node:fs";
+import { dirname as dirname9, join as join20 } from "node:path";
+import {
+  applyAudioFxChain,
+  describeFfmpegFailure as describeFfmpegFailure3,
+  encodeAac as encodeAac2,
+  renameWithRetry as renameWithRetry6
+} from "@hyperframes/engine";
+
 // src/services/render/audioPadTrim.ts
 import { spawn } from "node:child_process";
 import { mkdtempSync as mkdtempSync3 } from "node:fs";
@@ -10278,6 +10288,48 @@ async function runFfprobeJson(args, signal) {
   }
 }
 
+// src/services/render/audioDeliveryLimit.ts
+var LIMIT_CEILING_DBTP = AAC_DELIVERY_TRUE_PEAK_DBFS - 2;
+var LIMIT_CHAIN = {
+  version: 1,
+  nodes: [{ type: "truepeak", id: "delivery", params: { ceiling: LIMIT_CEILING_DBTP } }]
+};
+async function limitDeliveryPeaks(input, deps = {
+  measure: measureTruePeakDbfs,
+  applyChain: applyAudioFxChain,
+  encode: encodeAac2,
+  rename: renameWithRetry6,
+  sourceExists: existsSync13
+}) {
+  const { audioPath, sourcePath, signal, timeoutMs } = input;
+  if (!deps.sourceExists(sourcePath)) return { success: true };
+  const peak = await deps.measure(audioPath, { timeoutMs, signal });
+  if (peak <= AAC_DELIVERY_TRUE_PEAK_DBFS) return { success: true };
+  const limitedPath = join20(dirname9(sourcePath), "audio-source-limited.wav");
+  try {
+    await deps.applyChain(sourcePath, LIMIT_CHAIN, limitedPath, { trackId: "delivery", signal });
+  } catch (error) {
+    if (signal?.aborted) throw error;
+    input.warn?.("[audio] true-peak limit failed, the whole-mix cut applies", {
+      error: error instanceof Error ? error.message : String(error)
+    });
+    return { success: true };
+  }
+  const encoded = await deps.encode(limitedPath, audioPath, input.targetDurationSeconds, {
+    signal,
+    timeout: timeoutMs
+  });
+  if (!encoded.success) {
+    return {
+      success: false,
+      error: `[audioDeliveryLimit] ${describeFfmpegFailure3(encoded, timeoutMs)}`,
+      failureReason: encoded.failureReason
+    };
+  }
+  deps.rename(limitedPath, sourcePath, { copyFallback: true });
+  return { success: true };
+}
+
 // src/services/render/stages/audioStage.ts
 function assertAudioNotInterrupted(failures) {
   const interrupted = failures?.find((failure) => failure.reason === "external_interruption");
@@ -10301,13 +10353,22 @@ function runAudioStage(input) {
 }
 async function runAudioStageScoped(input) {
   const stageStart = Date.now();
-  const pcmSourcePath = join20(input.workDir, "audio-source.wav");
+  const pcmSourcePath = join21(input.workDir, "audio-source.wav");
   const duration = input.totalFrames * input.fps.den / input.fps.num;
   try {
     const result = await mixAudioForDelivery(input, duration, pcmSourcePath);
     let audioLoweredDb;
     if (result.hasAudio) {
       const guardStart = Date.now();
+      const limited = await limitDeliveryPeaks({
+        audioPath: result.audioOutputPath,
+        sourcePath: pcmSourcePath,
+        targetDurationSeconds: duration,
+        signal: input.abortSignal,
+        timeoutMs: input.ffmpegProcessTimeout,
+        warn: (message, details) => input.log?.warn?.(message, details)
+      });
+      if (!limited.success) throw encoderFailureError("Audio true-peak limit failed", limited);
       const peak = await constrainAacTruePeak({
         audioPath: result.audioOutputPath,
         sourcePath: pcmSourcePath,
@@ -10339,7 +10400,7 @@ async function mixAudioForDelivery(input, duration, pcmSourcePath) {
     assertNotAborted,
     log
   } = input;
-  const audioOutputPath = join20(workDir, MIXED_AUDIO_FILENAME);
+  const audioOutputPath = join21(workDir, MIXED_AUDIO_FILENAME);
   let hasAudio = false;
   let audioError;
   let audioFailures;
@@ -10350,7 +10411,7 @@ async function mixAudioForDelivery(input, duration, pcmSourcePath) {
       audioResult = await processCompositionAudio(
         audios,
         projectDir,
-        join20(workDir, "audio-work"),
+        join21(workDir, "audio-work"),
         audioOutputPath,
         duration,
         abortSignal,
@@ -10418,8 +10479,8 @@ async function mixAudioForDelivery(input, duration, pcmSourcePath) {
 }
 
 // src/services/render/stages/captureStage.ts
-import { existsSync as existsSync13, readdirSync as readdirSync3, statfsSync as statfsSync2 } from "node:fs";
-import { join as join21 } from "node:path";
+import { existsSync as existsSync14, readdirSync as readdirSync3, statfsSync as statfsSync2 } from "node:fs";
+import { join as join22 } from "node:path";
 import {
   classifyCaptureFailure as classifyCaptureFailure2,
   frameFileExtension,
@@ -10489,16 +10550,16 @@ function diskCaptureShortfallError(needBytes, freeBytes, framesDir, basis, remed
 }
 function measureCaptureFrameBytes(workDir, framesDir) {
   let total = sampleDirectoryBytes(framesDir);
-  if (!existsSync13(workDir)) return total;
+  if (!existsSync14(workDir)) return total;
   for (const attempt of readdirSync3(workDir)) {
     if (/^retry-\d+-batch-\d+-worker-\d+$/.test(attempt)) {
-      total += sampleDirectoryBytes(join21(workDir, attempt));
+      total += sampleDirectoryBytes(join22(workDir, attempt));
       continue;
     }
     if (!/^capture-attempt-\d+$/.test(attempt)) continue;
-    const attemptDir = join21(workDir, attempt);
+    const attemptDir = join22(workDir, attempt);
     for (const name of readdirSync3(attemptDir)) {
-      if (/^worker-\d+$/.test(name)) total += sampleDirectoryBytes(join21(attemptDir, name));
+      if (/^worker-\d+$/.test(name)) total += sampleDirectoryBytes(join22(attemptDir, name));
     }
   }
   return total;
@@ -10792,8 +10853,8 @@ async function captureSessionFrames(session, { input, rangeStart, rangeEnd, resu
 }
 
 // src/services/render/stages/captureHdrStage.ts
-import { existsSync as existsSync15, mkdirSync as mkdirSync8 } from "node:fs";
-import { join as join25 } from "node:path";
+import { existsSync as existsSync16, mkdirSync as mkdirSync8 } from "node:fs";
+import { join as join26 } from "node:path";
 import {
   closeCaptureSession as closeCaptureSession7,
   cloneCaptureWarnings as cloneCaptureWarnings2,
@@ -10865,7 +10926,7 @@ function createHdrImageTransferCache(options = {}) {
 }
 
 // src/services/render/stages/captureHdrSequentialLoop.ts
-import { join as join22 } from "node:path";
+import { join as join23 } from "node:path";
 import {
   TRANSITIONS,
   crossfade
@@ -10990,7 +11051,7 @@ async function runSequentialLayeredFrameLoop(input) {
       );
       if (debugDumpEnabled && debugDumpDir && i % 30 === 0) {
         writeFileExclusiveSync(
-          join22(debugDumpDir, `frame_${String(i).padStart(4, "0")}_final_rgb48le.bin`),
+          join23(debugDumpDir, `frame_${String(i).padStart(4, "0")}_final_rgb48le.bin`),
           normalCanvas
         );
       }
@@ -11022,7 +11083,7 @@ async function runSequentialLayeredFrameLoop(input) {
 }
 
 // src/services/render/stages/captureHdrHybridLoop.ts
-import { join as join24 } from "node:path";
+import { join as join25 } from "node:path";
 import {
   TRANSITIONS as TRANSITIONS2,
   closeCaptureSession as closeCaptureSession6,
@@ -11036,9 +11097,9 @@ import {
 // src/services/shaderTransitionWorkerPool.ts
 import { Worker } from "node:worker_threads";
 import { fileURLToPath as fileURLToPath3, pathToFileURL } from "node:url";
-import { dirname as dirname9, join as join23 } from "node:path";
+import { dirname as dirname10, join as join24 } from "node:path";
 import { createRequire } from "node:module";
-import { existsSync as existsSync14 } from "node:fs";
+import { existsSync as existsSync15 } from "node:fs";
 import { cpus as cpus2 } from "node:os";
 function resolveWorkerEntry(explicit) {
   if (explicit && explicit.length > 0) {
@@ -11049,10 +11110,10 @@ function resolveWorkerEntry(explicit) {
     const isTs = override.endsWith(".ts");
     return { path: override, isTs };
   }
-  const moduleDir = dirname9(fileURLToPath3(import.meta.url));
-  const jsPath = join23(moduleDir, "shaderTransitionWorker.js");
-  if (existsSync14(jsPath)) return { path: jsPath, isTs: false };
-  const tsPath = join23(moduleDir, "shaderTransitionWorker.ts");
+  const moduleDir = dirname10(fileURLToPath3(import.meta.url));
+  const jsPath = join24(moduleDir, "shaderTransitionWorker.js");
+  if (existsSync15(jsPath)) return { path: jsPath, isTs: false };
+  const tsPath = join24(moduleDir, "shaderTransitionWorker.ts");
   return { path: tsPath, isTs: true };
 }
 function buildExecArgv(entryIsTs) {
@@ -11420,7 +11481,7 @@ async function runHybridLayeredFrameLoop(input) {
           );
           if (debugDumpEnabled && debugDumpDir && i % 30 === 0) {
             writeFileExclusiveSync(
-              join24(debugDumpDir, `frame_${String(i).padStart(4, "0")}_final_rgb48le.bin`),
+              join25(debugDumpDir, `frame_${String(i).padStart(4, "0")}_final_rgb48le.bin`),
               canvas
             );
           }
@@ -11611,8 +11672,8 @@ async function runCaptureHdrStage(input) {
         if (hdrVideoFrameSources.has(v.id)) hdrVideoEndTimes.set(v.id, v.end);
       }
       const debugDumpEnabled = process.env.KEEP_TEMP === "1";
-      const debugDumpDir = debugDumpEnabled ? join25(framesDir, "debug-composite") : null;
-      if (debugDumpDir && !existsSync15(debugDumpDir)) {
+      const debugDumpDir = debugDumpEnabled ? join26(framesDir, "debug-composite") : null;
+      if (debugDumpDir && !existsSync16(debugDumpDir)) {
         mkdirSync8(debugDumpDir, { recursive: true });
       }
       const compositeTransfer = resolveCompositeTransfer(hasHdrContent, effectiveHdr);
@@ -11769,7 +11830,7 @@ async function runCaptureHdrStage(input) {
 // src/services/render/stages/encodeStage.ts
 import {
   copyFileSync as copyFileSync4,
-  existsSync as existsSync16,
+  existsSync as existsSync17,
   mkdirSync as mkdirSync9,
   readdirSync as readdirSync4,
   readFileSync as readFileSync7,
@@ -11778,7 +11839,7 @@ import {
   writeFileSync as writeFileSync5
 } from "node:fs";
 import { readFile as readFile2 } from "node:fs/promises";
-import { dirname as dirname10, join as join26 } from "node:path";
+import { dirname as dirname11, join as join27 } from "node:path";
 import {
   encodeFramesChunkedConcat,
   encodeFramesFromDir,
@@ -11903,7 +11964,7 @@ async function encodeGifFromDir(framesDir, framePattern, outputPath, input) {
       const failure = await reencodeWithClearedWholeFrames(argsInput, run, startTime);
       if (failure) return failure;
     }
-    const fileSize = existsSync16(outputPath) ? statSync7(outputPath).size : 0;
+    const fileSize = existsSync17(outputPath) ? statSync7(outputPath).size : 0;
     return {
       success: true,
       outputPath,
@@ -11989,7 +12050,7 @@ function encodeWhileCapturing(input, totalFrames) {
         await new Promise((resolve11) => wake = resolve11);
       }
       if (signal.aborted) return;
-      const mergedPath = join26(input.framesDir, formatCaptureFrameName(next, "jpg"));
+      const mergedPath = join27(input.framesDir, formatCaptureFrameName(next, "jpg"));
       const frame = await readLandedFrame(landed.get(next), mergedPath);
       landed.delete(next);
       if (!await stream.writeFrame(frame)) {
@@ -12064,7 +12125,7 @@ async function runEncodeStage(input) {
   const stage5Start = Date.now();
   if (isPngSequence) {
     const encoded = startEncodeProgress(job, "Writing PNG sequence", onProgress);
-    if (!existsSync16(outputPath)) mkdirSync9(outputPath, { recursive: true });
+    if (!existsSync17(outputPath)) mkdirSync9(outputPath, { recursive: true });
     const captured = readdirSync4(framesDir).filter((name) => name.endsWith(".png")).sort();
     if (captured.length === 0) {
       throw new Error(
@@ -12072,11 +12133,11 @@ async function runEncodeStage(input) {
       );
     }
     captured.forEach((name, i) => {
-      const dst = join26(outputPath, formatExportFrameName(i, "png"));
-      copyFileSync4(join26(framesDir, name), dst);
+      const dst = join27(outputPath, formatExportFrameName(i, "png"));
+      copyFileSync4(join27(framesDir, name), dst);
     });
-    if (hasAudio && audioOutputPath && existsSync16(audioOutputPath)) {
-      copyFileSync4(audioOutputPath, join26(outputPath, MIXED_AUDIO_FILENAME2));
+    if (hasAudio && audioOutputPath && existsSync17(audioOutputPath)) {
+      copyFileSync4(audioOutputPath, join27(outputPath, MIXED_AUDIO_FILENAME2));
       log.info(
         `[Render] png-sequence: ${MIXED_AUDIO_FILENAME2} sidecar written to ${outputPath}/${MIXED_AUDIO_FILENAME2}`
       );
@@ -12096,7 +12157,7 @@ async function runEncodeStage(input) {
     const encodeResult2 = await encodeGifFromDir(framesDir, framePattern2, outputPath, {
       fps: job.config.fps,
       loop,
-      palettePath: join26(dirname10(videoOnlyPath), "gif-palette.png"),
+      palettePath: join27(dirname11(videoOnlyPath), "gif-palette.png"),
       preserveAlpha: needsAlpha,
       signal: abortSignal,
       timeout: engineCfg.ffmpegEncodeTimeout
@@ -12306,7 +12367,7 @@ function sampleDirectoryBytes(dir) {
       continue;
     }
     for (const name of entries) {
-      const full = join27(current, name);
+      const full = join28(current, name);
       try {
         const st = statSync8(full);
         if (st.isDirectory()) {
@@ -12455,8 +12516,8 @@ function findMissingFrameRanges(totalFrames, framesDir, frameExt) {
   const ranges = [];
   let rangeStart = null;
   for (let frameIndex = 0; frameIndex < totalFrames; frameIndex++) {
-    const framePath = join27(framesDir, formatCaptureFrameName(frameIndex, frameExt));
-    const missing = !existsSync17(framePath) || statSync8(framePath).size <= 8;
+    const framePath = join28(framesDir, formatCaptureFrameName(frameIndex, frameExt));
+    const missing = !existsSync18(framePath) || statSync8(framePath).size <= 8;
     if (missing && rangeStart === null) {
       rangeStart = frameIndex;
     } else if (!missing && rangeStart !== null) {
@@ -12472,7 +12533,7 @@ function findMissingFrameRanges(totalFrames, framesDir, frameExt) {
 function buildMissingFrameRetryBatches(ranges, maxWorkers, workDir, attempt, rangeStart = 0, stride = 1) {
   const workersPerBatch = Math.max(1, Math.floor(maxWorkers));
   const batches = [];
-  const outputDirFor = (batchIndex, workerId) => join27(workDir, `retry-${attempt}-batch-${batchIndex}-worker-${workerId}`);
+  const outputDirFor = (batchIndex, workerId) => join28(workDir, `retry-${attempt}-batch-${batchIndex}-worker-${workerId}`);
   if (stride > 1) {
     const spans = /* @__PURE__ */ new Map();
     for (const range of ranges) {
@@ -12532,8 +12593,8 @@ function getNextRetryWorkerCount(currentWorkers) {
   return Math.max(1, Math.floor(currentWorkers / 2));
 }
 function resolveRenderWorkDirPrefix(outputPath, jobId, platform2 = process.platform, systemTempDir = tmpdir2()) {
-  if (platform2 === "win32" || platform2 === "darwin") return join27(systemTempDir, "hf-render-");
-  return join27(dirname11(outputPath), `work-${jobId}-`);
+  if (platform2 === "win32" || platform2 === "darwin") return join28(systemTempDir, "hf-render-");
+  return join28(dirname12(outputPath), `work-${jobId}-`);
 }
 var MAX_TRANSIENT_CAPTURE_RETRIES = 1;
 function isTransientCaptureRetryEligible(failureKind, missing, retriesUsed) {
@@ -12580,8 +12641,8 @@ The composition is too large for the available memory. To reduce memory pressure
 function countCapturedFrames(totalFrames, framesDir, frameExt) {
   let captured = 0;
   for (let frameIndex = 0; frameIndex < totalFrames; frameIndex++) {
-    const framePath = join27(framesDir, formatCaptureFrameName(frameIndex, frameExt));
-    if (existsSync17(framePath)) captured++;
+    const framePath = join28(framesDir, formatCaptureFrameName(frameIndex, frameExt));
+    if (existsSync18(framePath)) captured++;
   }
   return captured;
 }
@@ -12606,7 +12667,7 @@ async function executeDiskCaptureWithAdaptiveRetry(options) {
       reason: attempt === 0 ? "initial" : pendingTransientRetry ? "transient-retry" : "retry"
     });
     pendingTransientRetry = false;
-    const attemptWorkDir = join27(options.workDir, `capture-attempt-${attempt}`);
+    const attemptWorkDir = join28(options.workDir, `capture-attempt-${attempt}`);
     const batches = missingRanges ? buildMissingFrameRetryBatches(
       missingRanges,
       currentWorkers,
@@ -13236,19 +13297,19 @@ function deVerifyFallbackTelemetry(err) {
   };
 }
 function resolveRenderDebugDir() {
-  const producerRoot = process.env.PRODUCER_RENDERS_DIR ? resolve8(process.env.PRODUCER_RENDERS_DIR, "..") : resolve8(dirname11(fileURLToPath4(import.meta.url)), "../..");
-  return join27(producerRoot, ".debug");
+  const producerRoot = process.env.PRODUCER_RENDERS_DIR ? resolve8(process.env.PRODUCER_RENDERS_DIR, "..") : resolve8(dirname12(fileURLToPath4(import.meta.url)), "../..");
+  return join28(producerRoot, ".debug");
 }
 async function executeRenderJob(job, projectDir, outputPath, progressSink, abortSignal, assertRenderActive) {
   validateHlsRenderConfig(job.config);
   validateDeliveryEncoderConfig(job.config);
   const debugDir = resolveRenderDebugDir();
-  const outputDir = dirname11(outputPath);
-  if (!existsSync17(outputDir)) mkdirSync10(outputDir, { recursive: true });
-  const workDir = job.config.debug ? join27(debugDir, job.id) : createRenderWorkDir(resolveRenderWorkDirPrefix(outputPath, job.id), outputDir);
+  const outputDir = dirname12(outputPath);
+  if (!existsSync18(outputDir)) mkdirSync10(outputDir, { recursive: true });
+  const workDir = job.config.debug ? join28(debugDir, job.id) : createRenderWorkDir(resolveRenderWorkDirPrefix(outputPath, job.id), outputDir);
   const pipelineStart = Date.now();
   const baseLog = job.config.logger ?? defaultLogger;
-  const logPath = job.config.debug ? join27(workDir, "render.log") : null;
+  const logPath = job.config.debug ? join28(workDir, "render.log") : null;
   const execution = new RenderExecutionContext({
     request: { renderJobId: job.id, projectDir, outputPath },
     logger: logPath ? createRenderFileLogger(logPath, baseLog) : baseLog,
@@ -13309,7 +13370,7 @@ async function executeRenderPipeline(input) {
     imageDecodeFailures: 0
   };
   let hdrPerf;
-  const perfOutputPath = join27(workDir, "perf-summary.json");
+  const perfOutputPath = join28(workDir, "perf-summary.json");
   const cfg = { ...job.config.producerConfig ?? resolveConfig2() };
   const observability = new RenderObservabilityRecorder({
     pipelineStartMs: pipelineStart,
@@ -13385,7 +13446,7 @@ async function executeRenderPipeline(input) {
     job.startedAt = /* @__PURE__ */ new Date();
     assertNotAborted();
     assertConfiguredFfmpegBinariesExist();
-    if (!existsSync17(workDir)) mkdirSync10(workDir, { recursive: true });
+    if (!existsSync18(workDir)) mkdirSync10(workDir, { recursive: true });
     if (job.config.debug) {
       log.info("[Render] Debug artifacts enabled", { workDir, logPath });
     }
@@ -13414,16 +13475,16 @@ async function executeRenderPipeline(input) {
       requestedWorkers: job.config.workers ?? "auto"
     });
     const entryFile = job.config.entryFile || "index.html";
-    let htmlPath = join27(projectDir, entryFile);
-    if (!existsSync17(htmlPath)) {
+    let htmlPath = join28(projectDir, entryFile);
+    if (!existsSync18(htmlPath)) {
       throw new Error(`Entry file not found: ${htmlPath}`);
     }
     assertNotAborted();
     const rawEntry = readTextFile2(htmlPath);
     if (entryFile !== "index.html" && isTemplateEntry(rawEntry)) {
-      const wrapperPath = join27(workDir, "standalone-entry.html");
-      const projectIndexPath = join27(projectDir, "index.html");
-      if (!existsSync17(projectIndexPath)) {
+      const wrapperPath = join28(workDir, "standalone-entry.html");
+      const projectIndexPath = join28(projectDir, "index.html");
+      if (!existsSync18(projectIndexPath)) {
         throw new Error(
           `Template entry file "${entryFile}" requires a project index.html to extract its render shell.`
         );
@@ -13613,7 +13674,7 @@ async function executeRenderPipeline(input) {
           canvas: { width, height },
           page: probeSession.page,
           projectDir,
-          compiledDir: join27(workDir, "compiled")
+          compiledDir: join28(workDir, "compiled")
         });
         if (videoLayerPlan.videoId === void 0) {
           log.info(`[Render] Video layer passthrough off: ${videoLayerPlan.reason}`);
@@ -13631,7 +13692,7 @@ async function executeRenderPipeline(input) {
     updateJobStatus(job, "preprocessing", "Extracting video frames", 10, onProgress, {
       code: "extract_video"
     });
-    const compiledDir = join27(workDir, "compiled");
+    const compiledDir = join28(workDir, "compiled");
     const extractResult = await observeRenderStage(
       observability,
       "video_extract",
@@ -13743,7 +13804,7 @@ async function executeRenderPipeline(input) {
       try {
         fileServer = await createFileServer({
           projectDir,
-          compiledDir: join27(workDir, "compiled"),
+          compiledDir: join28(workDir, "compiled"),
           port: 0,
           preHeadScripts: [VIRTUAL_TIME_SHIM],
           fps: job.config.fps
@@ -13761,8 +13822,8 @@ async function executeRenderPipeline(input) {
     if (!activeFileServer) {
       throw new Error("File server failed to initialize before frame capture");
     }
-    const framesDir = join27(workDir, "captured-frames");
-    if (!existsSync17(framesDir)) mkdirSync10(framesDir, { recursive: true });
+    const framesDir = join28(workDir, "captured-frames");
+    if (!existsSync18(framesDir)) mkdirSync10(framesDir, { recursive: true });
     updateJobStatus(job, "rendering", "Checking browser GPU", 25, onProgress, {
       code: "start_browsers"
     });
@@ -14259,7 +14320,7 @@ async function executeRenderPipeline(input) {
       hls: ".mp4"
     };
     const videoExt = FORMAT_EXT[outputFormat] ?? ".mp4";
-    const videoOnlyPath = join27(workDir, `video-only${videoExt}`);
+    const videoOnlyPath = join28(workDir, `video-only${videoExt}`);
     const usePageSideCompositingForTransitions = (cfg.enablePageSideCompositing || isGif) && compiled.hasShaderTransitions && !hasHdrContent && outputSupportsPageSideShaderCompositing(outputFormat);
     if (usePageSideCompositingForTransitions) {
       activeFileServer.addPreHeadScript(HF_PAGE_SIDE_COMPOSITING_STUB);
@@ -14547,7 +14608,7 @@ async function executeRenderPipeline(input) {
           pageMotionBlur: job.config.pageMotionBlur,
           captureQuality: captureOptions.quality
         });
-        const segmentDir = segmentDirFor(join27(projectDir, "renders"), segmentPlanHash);
+        const segmentDir = segmentDirFor(join28(projectDir, "renders"), segmentPlanHash);
         let completedSegments = /* @__PURE__ */ new Set();
         if (job.config.resumeSegments === true) {
           const existing = readSegmentManifest(segmentDir);
@@ -15084,7 +15145,7 @@ async function executeRenderPipeline(input) {
       })
     );
     const totalElapsed = Date.now() - pipelineStart;
-    const tmpPeakBytes = existsSync17(workDir) ? sampleDirectoryBytes(workDir) : 0;
+    const tmpPeakBytes = existsSync18(workDir) ? sampleDirectoryBytes(workDir) : 0;
     recordTransientRetryObservability();
     observability.checkpoint("pipeline", "artifact validated", { totalElapsedMs: totalElapsed });
     const observabilitySummary = observability.summary({
@@ -15165,8 +15226,8 @@ async function executeRenderPipeline(input) {
       }
     }
     if (job.config.debug) {
-      if (!isPngSequence && !isHls && existsSync17(stagedOutputPath)) {
-        const debugOutput = join27(workDir, `output${videoExt}`);
+      if (!isPngSequence && !isHls && existsSync18(stagedOutputPath)) {
+        const debugOutput = join28(workDir, `output${videoExt}`);
         copyFileSync5(stagedOutputPath, debugOutput);
       }
     }
@@ -15272,7 +15333,7 @@ async function executeRenderPipeline(input) {
 
 // src/services/hyperframeLint.ts
 import {
-  existsSync as existsSync18,
+  existsSync as existsSync19,
   readFileSync as readFileSync8,
   statSync as statSync9,
   openSync as openSync5,
@@ -15280,7 +15341,7 @@ import {
   closeSync as closeSync5,
   constants as constants3
 } from "node:fs";
-import { resolve as resolve9, join as join28, relative as relative3, isAbsolute as isAbsolute3, sep as sep2 } from "node:path";
+import { resolve as resolve9, join as join29, relative as relative3, isAbsolute as isAbsolute3, sep as sep2 } from "node:path";
 import { lintHyperframeHtml } from "@hyperframes/lint";
 function isStringRecord(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
@@ -15326,7 +15387,7 @@ function readEntryHtml(filePath) {
 }
 function readProjectEntryFile(projectDir, preferredEntryFile) {
   const absProjectDir = resolve9(projectDir);
-  if (!existsSync18(absProjectDir) || !statSync9(absProjectDir).isDirectory()) {
+  if (!existsSync19(absProjectDir) || !statSync9(absProjectDir).isDirectory()) {
     return { error: `Project directory not found: ${absProjectDir}` };
   }
   const entryCandidates = [preferredEntryFile, "index.html", "src/index.html"].filter(
@@ -15348,7 +15409,7 @@ function readProjectEntryFile(projectDir, preferredEntryFile) {
     }
   }
   return {
-    error: `No HTML entry file found in project directory: ${join28(absProjectDir, preferredEntryFile || "index.html")}`
+    error: `No HTML entry file found in project directory: ${join29(absProjectDir, preferredEntryFile || "index.html")}`
   };
 }
 function prepareHyperframeLintBody(body) {
@@ -15394,8 +15455,8 @@ async function runHyperframeLint(prepared) {
 // src/services/healthWorker.ts
 import { Worker as Worker2 } from "node:worker_threads";
 import { fileURLToPath as fileURLToPath5 } from "node:url";
-import { dirname as dirname12, join as join29 } from "node:path";
-import { existsSync as existsSync19 } from "node:fs";
+import { dirname as dirname13, join as join30 } from "node:path";
+import { existsSync as existsSync20 } from "node:fs";
 var DEFAULT_HEALTH_PORT = 9848;
 async function startHealthWorker(options = {}) {
   const log = options.logger ?? defaultLogger2();
@@ -15469,10 +15530,10 @@ function defaultLogger2() {
   };
 }
 function resolveWorkerEntry2() {
-  const here = dirname12(fileURLToPath5(import.meta.url));
-  const candidates = [join29(here, "healthWorkerThread.js"), join29(here, "healthWorkerThread.ts")];
+  const here = dirname13(fileURLToPath5(import.meta.url));
+  const candidates = [join30(here, "healthWorkerThread.js"), join30(here, "healthWorkerThread.ts")];
   for (const candidate of candidates) {
-    if (existsSync19(candidate)) return candidate;
+    if (existsSync20(candidate)) return candidate;
   }
   return void 0;
 }
@@ -15507,7 +15568,7 @@ import { DISTRIBUTED_FPS, isDistributedFps } from "@hyperframes/core";
 
 // src/services/distributed/plan.ts
 import { audioFailureDiagnostics as audioFailureDiagnostics3 } from "@hyperframes/engine";
-import { extname as extname4, isAbsolute as isAbsolute4, join as join30, relative as relative4, sep as sep3 } from "node:path";
+import { extname as extname4, isAbsolute as isAbsolute4, join as join31, relative as relative4, sep as sep3 } from "node:path";
 import {
   fpsToNumber as fpsToNumber9,
   HF_COLOR_GRADING_ATTR as HF_COLOR_GRADING_ATTR2
@@ -15518,7 +15579,7 @@ import {
   normalizeVp9CpuUsed,
   resolveConfig as resolveConfig3,
   declareContentAddressedUrl,
-  renameWithRetry as renameWithRetry7,
+  renameWithRetry as renameWithRetry8,
   declareProbeFactsUrl
 } from "@hyperframes/engine";
 
@@ -15589,10 +15650,10 @@ var DISTRIBUTED_RENDER_CAPABILITIES = Object.freeze({
 var FIELD_DELIMITER = Buffer.from([0]);
 
 // src/services/distributed/chunkAudio.ts
-import { appendRenderProvenanceArgs, describeFfmpegFailure as describeFfmpegFailure3, runFfmpeg as runFfmpeg7 } from "@hyperframes/engine";
+import { appendRenderProvenanceArgs, describeFfmpegFailure as describeFfmpegFailure4, runFfmpeg as runFfmpeg7 } from "@hyperframes/engine";
 
 // src/services/distributed/mp4Stitch.ts
-import { renameWithRetry as renameWithRetry6 } from "@hyperframes/engine";
+import { renameWithRetry as renameWithRetry7 } from "@hyperframes/engine";
 var SCAN_BYTES = 64 * 1024;
 
 // src/services/distributed/chunkAudio.ts
@@ -15612,9 +15673,9 @@ var PLAN_ROOT_CATEGORY = {
 var PLAN_DIR_SIZE_LIMIT_BYTES = 2 * 1024 * 1024 * 1024;
 var FREEZE_OWNED_PLAN_FILES = [
   "plan.json",
-  join30("meta", "composition.json"),
-  join30("meta", "encoder.json"),
-  join30("meta", "chunks.json")
+  join31("meta", "composition.json"),
+  join31("meta", "encoder.json"),
+  join31("meta", "chunks.json")
 ];
 
 // src/services/distributed/renderConfigValidation.ts
@@ -15998,8 +16059,8 @@ function buildRenderJobConfig(input, outputPath, log) {
 function resolvePreparedRenderOutput(prepared, rendersDir, log) {
   const { input, cleanupProjectDir } = prepared;
   const absoluteOutputPath = resolveOutputPath(input.projectDir, input.outputPath, rendersDir, log);
-  const outputDir = dirname13(absoluteOutputPath);
-  if (!existsSync20(outputDir)) mkdirSync11(outputDir, { recursive: true });
+  const outputDir = dirname14(absoluteOutputPath);
+  if (!existsSync21(outputDir)) mkdirSync11(outputDir, { recursive: true });
   return { input, cleanupProjectDir, absoluteOutputPath };
 }
 function validateRenderOverrides(body) {
@@ -16040,11 +16101,11 @@ function prepareProjectDirectory(projectDir, options) {
   const candidate = nonEmptyString(projectDir);
   if (!candidate) return null;
   const absProjectDir = resolve10(candidate);
-  if (!existsSync20(absProjectDir) || !statSync10(absProjectDir).isDirectory()) {
+  if (!existsSync21(absProjectDir) || !statSync10(absProjectDir).isDirectory()) {
     return { error: `Project directory not found: ${absProjectDir}` };
   }
   const entry = options.entryFile || "index.html";
-  if (!existsSync20(resolve10(absProjectDir, entry))) {
+  if (!existsSync21(resolve10(absProjectDir, entry))) {
     return { error: `Entry file "${entry}" not found in project directory: ${absProjectDir}` };
   }
   return { prepared: { input: { projectDir: absProjectDir, ...options } } };
@@ -16065,8 +16126,8 @@ async function resolveInlineRenderHtml(body) {
 }
 function materializeInlineProject(html, options) {
   const tempRoot = process.env.PRODUCER_TMP_PROJECT_DIR || tmpdir3();
-  const tempProjectDir = mkdtempSync4(join31(tempRoot, "producer-project-"));
-  writeFileSync7(join31(tempProjectDir, "index.html"), html, "utf-8");
+  const tempProjectDir = mkdtempSync4(join32(tempRoot, "producer-project-"));
+  writeFileSync7(join32(tempProjectDir, "index.html"), html, "utf-8");
   return {
     prepared: {
       input: { projectDir: tempProjectDir, ...options },
@@ -16136,7 +16197,7 @@ function cleanupTempDir(dir, log) {
   }
 }
 function outputFileSize(path) {
-  return existsSync20(path) ? statSync10(path).size : 0;
+  return existsSync21(path) ? statSync10(path).size : 0;
 }
 function createBlockingProgressReporter(log, requestId) {
   let lastLoggedPct = -10;
@@ -16438,7 +16499,7 @@ function createRenderHandlers(options = {}) {
     if (!artifact) {
       return c.json({ success: false, error: "Output artifact not found or expired" }, 404);
     }
-    if (!existsSync20(artifact.path)) {
+    if (!existsSync21(artifact.path)) {
       store.delete(token);
       return c.json({ success: false, error: "Output artifact file missing" }, 404);
     }