hyperframes 0.8.34 → 0.8.35

package/dist/cli.js

@@ -50,7 +50,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.8.34" : "0.0.0-dev";
+    VERSION = true ? "0.8.35" : "0.0.0-dev";
   }
 });
 
@@ -65353,6 +65353,34 @@ var init_pageNavigationTimeoutErrorHint = __esm({
   }
 });
 
+// ../engine/src/services/drawElementCaptureError.ts
+function isDrawElementCaptureError(error) {
+  let current2 = error;
+  for (let depth = 0; depth < 5 && typeof current2 === "object" && current2 !== null; depth++) {
+    if ("deCaptureFailure" in current2 && current2.deCaptureFailure === true) return true;
+    current2 = "cause" in current2 ? current2.cause : void 0;
+  }
+  return false;
+}
+var DrawElementCaptureError;
+var init_drawElementCaptureError = __esm({
+  "../engine/src/services/drawElementCaptureError.ts"() {
+    "use strict";
+    DrawElementCaptureError = class extends Error {
+      frameIndex;
+      constructor(frameIndex, reason, cause) {
+        super(
+          `drawElement capture failed at frame ${frameIndex}: ${reason}; fresh screenshot capture required`,
+          { cause }
+        );
+        this.name = "DrawElementCaptureError";
+        Object.defineProperty(this, "deCaptureFailure", { value: true, enumerable: true });
+        this.frameIndex = frameIndex;
+      }
+    };
+  }
+});
+
 // ../engine/src/services/screenshotService.ts
 async function getCdpSession(page) {
   let client = cdpSessionCache.get(page);
@@ -69417,7 +69445,10 @@ async function captureFrameCore(session, frameIndex, time) {
       else session.beginFrameNoDamageCount++;
       screenshotBuffer = result.buffer;
     } else if (session.captureMode === "drawelement" && session.clipBoundaryFrames?.has(frameIndex) && process.env.HF_FAST_CAPTURE_BOUNDARY_SS === "true") {
-      screenshotBuffer = await pageScreenshotCapture(page, options);
+      throw new DrawElementCaptureError(
+        frameIndex,
+        "boundary screenshot requested on an injected canvas page"
+      );
     } else if (session.captureMode === "drawelement") {
       if (session.beginFrameTimeTicks > 0) {
         const client = await getCdpSession(page);
@@ -69446,10 +69477,10 @@ async function captureFrameCore(session, frameIndex, time) {
           const median3 = sorted ? sorted[sorted.length >> 1] ?? 0 : 0;
           const floor = Math.max(2e4, median3 * 0.12);
           if (screenshotBuffer.length < floor) {
-            console.log(
-              `[engine] fast capture: frame ${frameIndex} \u2014 drawElement frame anomalously small (${screenshotBuffer.length}B < ${Math.round(floor)}B, likely a silent paint-record drop); screenshot fallback (see fast-capture-limitations.md)`
+            throw new DrawElementCaptureError(
+              frameIndex,
+              `suspect small frame (${screenshotBuffer.length}B < ${Math.round(floor)}B)`
             );
-            screenshotBuffer = await pageScreenshotCapture(page, options);
           } else {
             if (sizes.length >= 60) sizes.shift();
             sizes.push(screenshotBuffer.length);
@@ -69459,10 +69490,7 @@ async function captureFrameCore(session, frameIndex, time) {
         if (isRecoverableDrawElementError(err)) {
           session.deNcprFallbacks = (session.deNcprFallbacks ?? 0) + 1;
           const reason = isCanvasNotInitializedError(err) ? "drawElement canvas not initialized" : "No cached paint record";
-          console.log(
-            `[engine] fast capture: frame ${frameIndex} \u2014 ${reason}; screenshot fallback for this frame (see fast-capture-limitations.md)`
-          );
-          screenshotBuffer = await pageScreenshotCapture(page, options);
+          throw new DrawElementCaptureError(frameIndex, reason, err);
         } else {
           throw err;
         }
@@ -69551,21 +69579,10 @@ async function captureFrameToBufferPipelined(session, frameIndex, time) {
     );
     void quantizedTime;
     if (session.clipBoundaryFrames?.has(frameIndex) && process.env.HF_FAST_CAPTURE_BOUNDARY_SS === "true") {
-      const buffer = await pageScreenshotCapture(page, options);
-      session.capturePerf.frames += 1;
-      session.capturePerf.seekMs += seekMs;
-      session.capturePerf.beforeCaptureMs += beforeCaptureMs;
-      {
-        const boundaryMs = Date.now() - startTime;
-        session.capturePerf.totalMs += boundaryMs;
-        session.capturePerf.frameMs.push(boundaryMs);
-      }
-      const boundaryResult = Promise.resolve(buffer);
-      if (session.staticFrames) {
-        session.lastEncodeResult = boundaryResult;
-        session.lastEncodeResultFrame = frameIndex;
-      }
-      return { encodeResult: boundaryResult, captureTimeMs: Date.now() - startTime };
+      throw new DrawElementCaptureError(
+        frameIndex,
+        "boundary screenshot requested on an injected canvas page"
+      );
     }
     const { encodeResult } = await produceDrawElementFrame(
       page,
@@ -69587,15 +69604,6 @@ async function captureFrameToBufferPipelined(session, frameIndex, time) {
     }
     return { encodeResult, captureTimeMs };
   } catch (captureError) {
-    if (isRecoverableDrawElementError(captureError)) {
-      session.deNcprFallbacks = (session.deNcprFallbacks ?? 0) + 1;
-      const reason = isCanvasNotInitializedError(captureError) ? "drawElement canvas not initialized" : "No cached paint record";
-      console.log(
-        `[engine] fast capture: frame ${frameIndex} \u2014 ${reason}; screenshot fallback for this frame (see fast-capture-limitations.md)`
-      );
-      const buffer = await pageScreenshotCapture(page, options);
-      return { encodeResult: Promise.resolve(buffer), captureTimeMs: Date.now() - startTime };
-    }
     if (session.isInitialized) {
       await captureFrameErrorDiagnostics(
         session,
@@ -69604,6 +69612,11 @@ async function captureFrameToBufferPipelined(session, frameIndex, time) {
         captureError instanceof Error ? captureError : new Error(String(captureError))
       );
     }
+    if (isRecoverableDrawElementError(captureError)) {
+      session.deNcprFallbacks = (session.deNcprFallbacks ?? 0) + 1;
+      const reason = isCanvasNotInitializedError(captureError) ? "drawElement canvas not initialized" : "No cached paint record";
+      throw new DrawElementCaptureError(frameIndex, reason, captureError);
+    }
     throw captureError;
   }
 }
@@ -69637,6 +69650,8 @@ async function captureFramesBatchPipelined(session, frameIndices, times) {
     options.height,
     options.quality ?? 80
   );
+  for (const result of encodeResults) void result.catch(() => {
+  });
   const okCount = failedAt === null ? frameIndices.length : failedAt;
   const elapsed = Date.now() - startTime;
   session.capturePerf.frames += okCount;
@@ -69656,23 +69671,8 @@ async function captureFramesBatchPipelined(session, frameIndices, times) {
   if (failedAt !== null) {
     if (isRecoverableDrawElementError(error)) {
       const reason = isCanvasNotInitializedError(error) ? "drawElement canvas not initialized" : "No cached paint record";
-      console.log(
-        `[engine] fast capture: batch produce failed at frame ${frameIndices[failedAt] ?? "?"} (${reason}); screenshot fallback for ${frameIndices.length - failedAt} frame(s) (see fast-capture-limitations.md)`
-      );
-      for (let i2 = failedAt; i2 < frameIndices.length; i2++) {
-        const frameIndex = frameIndices[i2];
-        const time = times[i2];
-        if (frameIndex === void 0 || time === void 0) break;
-        session.deNcprFallbacks = (session.deNcprFallbacks ?? 0) + 1;
-        await prepareFrameForCapture(session, frameIndex, time);
-        const buffer = await pageScreenshotCapture(page, options);
-        const encodeResult = Promise.resolve(buffer);
-        if (session.staticFrames) {
-          session.lastEncodeResult = encodeResult;
-          session.lastEncodeResultFrame = frameIndex;
-        }
-        results.push({ frameIndex, encodeResult });
-      }
+      session.deNcprFallbacks = (session.deNcprFallbacks ?? 0) + 1;
+      throw new DrawElementCaptureError(frameIndices[failedAt] ?? failedAt, reason, error);
     } else {
       console.log(
         `[engine] fast capture: batch produce failed at frame ${frameIndices[failedAt] ?? "?"} (${error ?? "?"}); re-capturing ${frameIndices.length - failedAt} frame(s) per-frame`
@@ -69845,7 +69845,7 @@ function getCapturePerfSummary(session) {
   if (frames > 0 && ncprFallbacks / frames > DE_FALLBACK_RATIO_WARN_THRESHOLD) {
     const pct = Math.round(ncprFallbacks / frames * 100);
     console.warn(
-      `[engine] fast capture: ${ncprFallbacks}/${frames} frame(s) (${pct}%) fell back to screenshot capture (canvas-not-initialized / no-cached-paint-record) \u2014 drawElement likely failed to engage for this render rather than recovering a few edge-case frames; see fast-capture-limitations.md.`
+      `[engine] fast capture: ${ncprFallbacks}/${frames} frame(s) (${pct}%) rejected due to missing canvas/paint records; fresh screenshot capture required.`
     );
   }
   return {
@@ -69895,6 +69895,7 @@ var init_frameCapture = __esm({
   "../engine/src/services/frameCapture.ts"() {
     "use strict";
     init_dist3();
+    init_drawElementCaptureError();
     init_browserManager();
     init_screenshotService();
     init_drawElementService();
@@ -79752,6 +79753,21 @@ function findRootTag(source, parsedTags) {
   }
   return null;
 }
+function hasUnquotedLessThan(attrs2) {
+  let quote = null;
+  for (const ch of attrs2) {
+    if (quote) {
+      if (ch === quote) quote = null;
+      continue;
+    }
+    if (ch === '"' || ch === "'") {
+      quote = ch;
+    } else if (ch === "<") {
+      return true;
+    }
+  }
+  return false;
+}
 function readAttr(tagSource, attr2) {
   if (!tagSource) return null;
   const escaped = attr2.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -82765,6 +82781,21 @@ var init_dist4 = __esm({
         }
         return findings;
       },
+      // unclosed_tag_swallowed_element
+      ({ tags }) => {
+        const findings = [];
+        for (const tag of tags) {
+          if (!hasUnquotedLessThan(tag.attrs)) continue;
+          findings.push({
+            code: "unclosed_tag_swallowed_element",
+            severity: "error",
+            message: `<${tag.name}> is missing its closing \`>\` before the next \`<\` \u2014 the following element is swallowed as bogus attribute text and never becomes a real node.`,
+            fixHint: "Close the previous tag's `>` before opening the next element.",
+            snippet: truncateSnippet(tag.raw)
+          });
+        }
+        return findings;
+      },
       // invalid_inline_script_syntax (malformed close tag)
       ({ source }) => {
         if (!INVALID_SCRIPT_CLOSE_PATTERN.test(source)) return [];
@@ -94476,6 +94507,7 @@ __export(src_exports, {
   DEFAULT_HDR10_MASTERING: () => DEFAULT_HDR10_MASTERING,
   DEFAULT_VP9_CPU_USED: () => DEFAULT_VP9_CPU_USED,
   DOM_LAYER_MASK_STYLE_ID: () => DOM_LAYER_MASK_STYLE_ID,
+  DrawElementCaptureError: () => DrawElementCaptureError,
   DrawElementVerificationError: () => DrawElementVerificationError,
   ENABLE_BROWSER_POOL: () => ENABLE_BROWSER_POOL,
   ENCODER_PRESETS: () => ENCODER_PRESETS,
@@ -94590,6 +94622,7 @@ __export(src_exports, {
   initializeSession: () => initializeSession,
   injectVideoFramesBatch: () => injectVideoFramesBatch,
   isBlockedNetworkHost: () => isBlockedNetworkHost,
+  isDrawElementCaptureError: () => isDrawElementCaptureError,
   isDrawElementVerificationError: () => isDrawElementVerificationError,
   isExternalFfmpegInterruption: () => isExternalFfmpegInterruption,
   isFatalCaptureFailure: () => isFatalCaptureFailure,
@@ -94705,6 +94738,7 @@ var init_src = __esm({
     init_videoFrameInjector();
     init_hdr();
     init_renderProvenance();
+    init_drawElementCaptureError();
   }
 });
 
@@ -126935,7 +126969,7 @@ function revertedRouting(routing) {
   return freezeRouting({ ...routing, state: "reverted" });
 }
 function replanAfterFailure(plan2, failure) {
-  if (plan2.kind === "sdr_disk" && failure.kind === "draw_element_verification") {
+  if (plan2.kind === "sdr_disk" && (failure.kind === "draw_element_verification" || failure.kind === "draw_element_capture")) {
     return createCapturePlan({
       ...plan2,
       forceScreenshot: true,
@@ -139692,7 +139726,7 @@ async function executeDiskCaptureWithAdaptiveRetry(options) {
       if (failure.kind === "cancelled") {
         throw error;
       }
-      if (isDrawElementVerificationError(error)) {
+      if (isDrawElementVerificationError(error) || isDrawElementCaptureError(error)) {
         throw error;
       }
       const remaining = findMissingFrameRanges(
@@ -139920,7 +139954,7 @@ function resolveParallelRouterRetryPlan(args) {
 }
 function shouldRetryViaPinnedFallback(args) {
   if (args.isCancellation || args.isEncoderInterrupted) return false;
-  if (args.isVerifyError) return true;
+  if (args.isVerifyError || args.isDeCaptureError) return true;
   if (args.isDeRendererStall === true || args.isSequentialCaptureStall === true) return true;
   return args.deWorkerInversion === "inverted" || args.deParallelRouter === "routed";
 }
@@ -139946,6 +139980,9 @@ async function closeOrphanedProbeForRetry(probe2, closer, log2, retryContext) {
 function shouldStreamParallelCapture(args) {
   return args.routerEnabled && args.workerCount > 1 && !args.useDrawElement && args.outputFormat === "mp4" && args.streamingOk && !args.layeredOrEffectRoute;
 }
+function shouldClampDefaultDrawElement(args) {
+  return args.useDrawElement && !args.fastCaptureExplicitOptIn && (!args.useStreamingEncode || args.workerCount > 1) && !args.deParallelStreamVerified;
+}
 function resolveCaptureForceScreenshotForPageSideCompositing(args) {
   return args.usePageSideCompositing ? true : args.forceScreenshot;
 }
@@ -140688,6 +140725,32 @@ async function executeRenderPipeline(input2) {
       deWorkerInversion: deWorkerInversion ?? "none",
       deParallelRouter: deParallelRouter ?? "none"
     });
+    let useStreamingEncode = shouldUseStreamingEncode(
+      cfg,
+      outputFormat,
+      workerCount,
+      job.duration,
+      deParallelStreamForced
+    );
+    const deParallelStreamVerified = (deParallelStreamForced || process.env.HF_DE_PARALLEL_STREAM === "true") && useStreamingEncode && workerCount > 1;
+    if (shouldClampDefaultDrawElement({
+      useDrawElement: cfg.useDrawElement,
+      fastCaptureExplicitOptIn: process.env.PRODUCER_EXPERIMENTAL_FAST_CAPTURE === "true",
+      useStreamingEncode,
+      workerCount,
+      deParallelStreamVerified
+    })) {
+      cfg.useDrawElement = false;
+      deClampReason = workerCount > 1 ? "parallel" : "disk_path";
+      log2.info(
+        "[Render] Fast capture: default-on drawElement disabled for this render \u2014 " + (workerCount > 1 ? "parallel capture" : "the disk capture path") + " has no runtime self-verification. Set PRODUCER_EXPERIMENTAL_FAST_CAPTURE=true to override."
+      );
+      if (probeSession && probeSession.captureMode === "drawelement") {
+        lastBrowserConsole = probeSession.browserConsoleBuffer;
+        await closeCaptureSession(probeSession);
+        probeSession = null;
+      }
+    }
     const captureParallelStreamRouterEnabled = process.env.HF_CAPTURE_PARALLEL_STREAM === "true";
     const captureParallelStreamArgs = {
       workerCount,
@@ -140719,7 +140782,7 @@ async function executeRenderPipeline(input2) {
       await closeCaptureSession(probeSession);
       probeSession = null;
     }
-    let useStreamingEncode = shouldUseStreamingEncode(
+    useStreamingEncode = shouldUseStreamingEncode(
       cfg,
       outputFormat,
       workerCount,
@@ -140734,18 +140797,6 @@ async function executeRenderPipeline(input2) {
       durationSeconds: job.duration,
       maxDurationSeconds: cfg.streamingEncodeMaxDurationSeconds
     });
-    const deParallelStreamVerified = (deParallelStreamForced || process.env.HF_DE_PARALLEL_STREAM === "true") && useStreamingEncode && workerCount > 1;
-    if (cfg.useDrawElement && process.env.PRODUCER_EXPERIMENTAL_FAST_CAPTURE !== "true" && (!useStreamingEncode || workerCount > 1) && !deParallelStreamVerified) {
-      cfg.useDrawElement = false;
-      deClampReason = workerCount > 1 ? "parallel" : "disk_path";
-      log2.info(
-        "[Render] Fast capture: default-on drawElement disabled for this render \u2014 " + (workerCount > 1 ? "parallel capture" : "the disk capture path") + " has no runtime self-verification. Set PRODUCER_EXPERIMENTAL_FAST_CAPTURE=true to override."
-      );
-      if (probeSession && probeSession.captureMode === "drawelement") {
-        await closeCaptureSession(probeSession);
-        probeSession = null;
-      }
-    }
     const FORMAT_EXT3 = {
       mp4: ".mp4",
       webm: ".webm",
@@ -141006,11 +141057,13 @@ async function executeRenderPipeline(input2) {
           streamingRes = await invokeStreaming();
         } catch (err) {
           const isVerifyError = isDrawElementVerificationError(err);
+          const isDeCaptureError = isDrawElementCaptureError(err);
           const isDeStall = isDeRendererStallError(err);
           const isSequentialStall = isSequentialCaptureStallError(err);
           const isCancellation = err instanceof RenderCancelledError || executionSignal?.aborted === true;
           if (!shouldRetryViaPinnedFallback({
             isVerifyError,
+            isDeCaptureError,
             isCancellation,
             isEncoderInterrupted: err instanceof EncoderInterruptedError,
             deWorkerInversion,
@@ -141031,12 +141084,12 @@ async function executeRenderPipeline(input2) {
             deFallbackReason = isMemoryExhaustion ? "oom" : isDeStall ? "de_renderer_stall" : "capture_error";
           }
           log2.warn(
-            isVerifyError ? "[Render] drawElement self-verification failed; re-rendering via screenshot" : isDeStall ? "[Render] drawElement renderer stalled; re-rendering via screenshot" : isSequentialStall ? "[Render] sequential capture stalled; retrying on a fresh screenshot session" : "[Render] capture failed on the pinned worker count; re-rendering via screenshot",
+            isVerifyError ? "[Render] drawElement self-verification failed; re-rendering via screenshot" : isDeStall ? "[Render] drawElement renderer stalled; re-rendering via screenshot" : isSequentialStall ? "[Render] sequential capture stalled; retrying on a fresh screenshot session" : "[Render] capture failed; re-rendering via a fresh screenshot session",
             { error: err instanceof Error ? err.message : String(err) }
           );
           observability.checkpoint(
             "capture_streaming",
-            isVerifyError ? "drawElement self-verify failed; retrying with forceScreenshot" : isDeStall ? "drawElement renderer stalled; retrying with forceScreenshot" : isSequentialStall ? "sequential capture stalled; retrying with a fresh screenshot session" : "capture failed on pinned worker count; retrying with forceScreenshot"
+            isVerifyError ? "drawElement self-verify failed; retrying with forceScreenshot" : isDeStall ? "drawElement renderer stalled; retrying with forceScreenshot" : isSequentialStall ? "sequential capture stalled; retrying with a fresh screenshot session" : "capture failed; retrying with a fresh screenshot session"
           );
           const failedRouting = capturePlan.routing.kind;
           capturePlan = replanAfterFailure(
@@ -141149,22 +141202,22 @@ async function executeRenderPipeline(input2) {
         try {
           captureRes = await invokeDiskCapture(capturePlan);
         } catch (err) {
-          if (!isDrawElementVerificationError(err) || err instanceof RenderCancelledError || executionSignal?.aborted === true) {
+          if (!isDrawElementVerificationError(err) && !isDrawElementCaptureError(err) || err instanceof RenderCancelledError || executionSignal?.aborted === true) {
             throw err;
           }
-          deSelfVerifyFallback = true;
+          deSelfVerifyFallback = isDrawElementVerificationError(err);
           const t2 = deVerifyFallbackTelemetry(err);
-          deFallbackReason = t2.reason;
+          deFallbackReason = deSelfVerifyFallback ? t2.reason : "capture_error";
           deFallbackFailedDb = t2.failedDb;
           deFallbackFrameIndex = t2.frameIndex;
           deFallbackThresholdDb = t2.thresholdDb;
           log2.warn(
-            "[Render] drawElement self-verification failed on the parallel disk path; re-rendering via screenshot",
+            "[Render] drawElement capture failed on the parallel disk path; re-rendering via screenshot",
             { error: err instanceof Error ? err.message : String(err) }
           );
           observability.checkpoint(
             "capture_disk",
-            "drawElement self-verify failed; retrying with forceScreenshot"
+            "drawElement capture failed; retrying with a fresh screenshot session"
           );
           rmSync23(framesDir, { recursive: true, force: true });
           mkdirSync27(framesDir, { recursive: true });
@@ -141177,7 +141230,9 @@ async function executeRenderPipeline(input2) {
             probeSession = null;
             await closeOrphanedProbeForRetry(orphaned, closeCaptureSession, log2, "disk verify");
           }
-          capturePlan = replanAfterFailure(capturePlan, { kind: "draw_element_verification" });
+          capturePlan = replanAfterFailure(capturePlan, {
+            kind: deSelfVerifyFallback ? "draw_element_verification" : "draw_element_capture"
+          });
           syncCapturePlan();
           updateCaptureObservability({
             forceScreenshot: capturePlan.forceScreenshot,
@@ -150848,10 +150903,10 @@ function searchMissCommand(query2, tier) {
   const quoted = query2.replace(/(["\\$`])/g, "\\$1");
   return `npx hyperframes feedback --search-miss "${quoted}" --wanted "<the move you needed>" --tier ${tier}`;
 }
-function reportLocalModelOption(json) {
-  if (!json && process.stdout.isTTY) return;
-  if (localModelStatus().status !== "not-asked") return;
-  console.error(nonInteractiveConsentMessage());
+function localModelHint(json, status) {
+  if (!json && process.stdout.isTTY) return null;
+  if (status?.status !== "not-asked") return null;
+  return nonInteractiveConsentMessage();
 }
 async function offerLocalModel(matchCount, json, registryBaseUrl, artifactRevision) {
   if (json || !process.stdout.isTTY) return;
@@ -150982,6 +151037,11 @@ var init_catalog = __esm({
         const matching = searched ? searched.items : tagged;
         if (matching.length === 0) {
           const unsearchable = Boolean(query2) && searched?.localMode === "words" && hasNoSearchableTokens(query2);
+          const tierHint = query2 && !unsearchable && warnings.length === 0 ? localModelHint(json, effectiveStatus) : null;
+          if (tierHint) {
+            warnings.push(tierHint);
+            console.error(tierHint);
+          }
           if (json && query2) {
             console.log(
               JSON.stringify(
@@ -151087,7 +151147,8 @@ var init_catalog = __esm({
           }
           if (searched.localMode === "words") {
             if (warnings.length === 0) {
-              reportLocalModelOption(json);
+              const hint2 = localModelHint(json, effectiveStatus);
+              if (hint2) console.error(hint2);
               await offerLocalModel(matching.length, json, config.registry, artifactRevision);
             }
           }
@@ -153388,7 +153449,7 @@ function uploadTimeoutMs(byteLength) {
   );
 }
 function shouldIgnoreSegment(segment) {
-  return segment.startsWith(".") || IGNORED_DIRS.has(segment) || IGNORED_FILES.has(segment);
+  return IGNORED_DIRS.has(segment) || IGNORED_FILES.has(segment);
 }
 function createProjectIgnore(rootDir) {
   const matcher = ignore2().add(DEFAULT_PROJECT_IGNORE);
@@ -153714,7 +153775,7 @@ var init_publishProject = __esm({
     IGNORED_DIRS = /* @__PURE__ */ new Set([".git", "node_modules", "dist", ".next", "coverage"]);
     IGNORED_FILES = /* @__PURE__ */ new Set([".DS_Store", "Thumbs.db"]);
     HYPERFRAMES_IGNORE_FILE = ".hyperframesignore";
-    DEFAULT_PROJECT_IGNORE = ["/renders/", "/snapshots/"];
+    DEFAULT_PROJECT_IGNORE = ["/renders/", "/snapshots/", ".*"];
     PUBLISH_CONTENT_TYPE = "application/zip";
     PUBLISH_METADATA_TIMEOUT_MS = 3e4;
     PUBLISH_UPLOAD_MIN_TIMEOUT_MS = 12e4;
@@ -164939,7 +165000,7 @@ function createKeyframesCommand(options = {}) {
       },
       layout: {
         type: "string",
-        description: "--shot layout: 'path' (ghosts at real positions + path, default) or 'strip' (filmstrip by time \u2014 for in-place/overlapping motion)."
+        description: "--shot layout: 'path' (ghosts at real positions + path, default) or 'strip' (for in-place/overlapping motion). 'strip' captures a real per-time pixel filmstrip only when --selector targets an SVG element; any other selector (e.g. a DOM/sub-composition host) instead gets one live frame plus vector position markers."
       },
       from: { type: "string", description: "--shot: sample only from this time (seconds)." },
       to: { type: "string", description: "--shot: sample only up to this time (seconds)." },
@@ -166446,19 +166507,25 @@ var init_manager4 = __esm({
 
 // src/tts/python.ts
 import { execFileSync as execFileSync14 } from "child_process";
+function validatePythonOverride(override) {
+  try {
+    const version2 = execFileSync14(override, ["--version"], {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"],
+      timeout: 5e3
+    });
+    if (/Python 3/.test(version2)) return { ok: true };
+    return {
+      ok: false,
+      reason: `did not report a Python 3 version (got ${JSON.stringify(version2.trim())})`
+    };
+  } catch (error) {
+    return { ok: false, reason: error instanceof Error ? error.message : String(error) };
+  }
+}
 function findPython() {
   const override = process.env.HYPERFRAMES_PYTHON;
-  if (override) {
-    try {
-      const version2 = execFileSync14(override, ["--version"], {
-        encoding: "utf-8",
-        stdio: ["pipe", "pipe", "pipe"],
-        timeout: 5e3
-      });
-      if (/Python 3/.test(version2)) return override;
-    } catch {
-    }
-  }
+  if (override && validatePythonOverride(override).ok) return override;
   for (const name of ["python3", "python"]) {
     try {
       const cmd = process.platform === "win32" ? "where" : "which";
@@ -166480,6 +166547,13 @@ function findPython() {
   }
   return void 0;
 }
+function describeRejectedPythonOverride() {
+  const override = process.env.HYPERFRAMES_PYTHON;
+  if (!override) return null;
+  const validation = validatePythonOverride(override);
+  if (validation.ok) return null;
+  return `HYPERFRAMES_PYTHON="${override}" was rejected: ${validation.reason}`;
+}
 function hasPythonPackage(python, pkg) {
   try {
     execFileSync14(python, ["-c", `import ${pkg}`], {
@@ -167260,11 +167334,15 @@ async function checkWhisper() {
     hint: getInstallInstructions2()
   };
 }
+function notInstalledDetail(base2) {
+  const overrideRejection = describeRejectedPythonOverride();
+  return overrideRejection ? `${base2}. ${overrideRejection}` : base2;
+}
 function checkLocalVoice() {
   if (hasPythonModules(KOKORO_MODULES)) return { ok: true, detail: "Kokoro deps installed" };
   return {
     ok: false,
-    detail: "Not installed (optional \u2014 local voice fallback)",
+    detail: notInstalledDetail("Not installed (optional \u2014 local voice fallback)"),
     hint: KOKORO_PIP
   };
 }
@@ -167272,7 +167350,7 @@ function checkLocalMusic() {
   if (hasPythonModules(MUSICGEN_MODULES)) return { ok: true, detail: "MusicGen deps installed" };
   return {
     ok: false,
-    detail: "Not installed (optional \u2014 local music fallback)",
+    detail: notInstalledDetail("Not installed (optional \u2014 local music fallback)"),
     hint: MUSICGEN_PIP
   };
 }

package/dist/commands/layout-audit.browser.js

@@ -1689,7 +1689,13 @@
         axes && axes !== "normal" ? axes : ""
       }`;
     });
-    for (const media of root.querySelectorAll("canvas, video")) {
+    // img shares the same pixel-only-motion blind spot as canvas/video: an
+    // equal-size, equal-position opaque src/visibility swap moves no
+    // geometry and no opacity. mediaPixelHash already handles it generically
+    // (drawImage accepts any CanvasImageSource; width/height fall back to
+    // rect.width/height same as canvas/video), so only the element selector
+    // needed widening.
+    for (const media of root.querySelectorAll("canvas, video, img")) {
       if (!isVisibleElement(media)) continue;
       parts.push(`p:${mediaPixelHash(media)}`);
     }