hyperframes 0.8.151 → 0.8.153

package/dist/{render-FKVRCDT2.js → render-YSD2SRBL.js}

@@ -6,15 +6,19 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   maybePromptRenderFeedback
-} from "./chunk-OZ4K46OV.js";
+} from "./chunk-4IRCZWND.js";
+import {
+  captureArtifactRevision
+} from "./chunk-3DMR7RF6.js";
+import "./chunk-ZQMYD22O.js";
 import {
   reportVariableIssues,
   resolveVariablesArg,
   validateVariablesAgainstProject
-} from "./chunk-4LE27ST4.js";
+} from "./chunk-XQYLUY2F.js";
 import {
   loadProducer
-} from "./chunk-POEEDPJI.js";
+} from "./chunk-5ZGSN5YK.js";
 import {
   renderJobObservabilityTelemetryPayload
 } from "./chunk-VXVRPIJA.js";
@@ -26,11 +30,16 @@ import {
   resolveCompositionEntryArg,
   resolveDefaultFpsArg,
   windowsChromeCrashRemediation
-} from "./chunk-HVXRYMGQ.js";
+} from "./chunk-TXWPPBIW.js";
 import "./chunk-WPNE5NEP.js";
+import {
+  recordRenderSuccess,
+  registerRenderOutput
+} from "./chunk-7FYFEXD2.js";
+import "./chunk-FFDC5OWV.js";
 import {
   resolveProject
-} from "./chunk-KXX6NLOT.js";
+} from "./chunk-JQ57FAYN.js";
 import {
   formatLintStartupMessage
 } from "./chunk-6CSYCFQV.js";
@@ -46,6 +55,7 @@ import {
   resolvePrintedCaptureMode
 } from "./chunk-K2FLNJVB.js";
 import "./chunk-DCAI5DBR.js";
+import "./chunk-DQBY7FRR.js";
 import {
   runEnvironmentChecks
 } from "./chunk-WUUOFMHU.js";
@@ -54,15 +64,15 @@ import {
   loadProjectConfig,
   readProjectConfigWithStatus,
   seedProjectAuthoringSkill
-} from "./chunk-FAIYEIZ4.js";
+} from "./chunk-YYMJEQ4D.js";
 import "./chunk-XT7X6QCP.js";
 import "./chunk-4YYJOFKS.js";
 import {
   normalizeSkillSlug
 } from "./chunk-HVW7ABXD.js";
-import "./chunk-XGLNQDLN.js";
-import "./chunk-N4IXP3MY.js";
-import "./chunk-YZTVHRJ2.js";
+import "./chunk-PXOFFSO3.js";
+import "./chunk-HGAOO43L.js";
+import "./chunk-2XEBNYG5.js";
 import "./chunk-AWDFDFI3.js";
 import "./chunk-P6LJ4Y32.js";
 import "./chunk-GMECXFAN.js";
@@ -71,8 +81,8 @@ import {
   trackRenderError,
   trackRenderObservation,
   trackRenderPreflightRejected
-} from "./chunk-ZD3RDNZI.js";
-import "./chunk-IZ7L6V76.js";
+} from "./chunk-CBMZYOWC.js";
+import "./chunk-AUK5QCRH.js";
 import "./chunk-VWG7OQKU.js";
 import {
   bytesToMb
@@ -95,6 +105,7 @@ import {
 import {
   c
 } from "./chunk-ZTZA4UWZ.js";
+import "./chunk-EOOEC32M.js";
 import {
   hasDefinitiveEntryMismatch
 } from "./chunk-Q5X2B5WT.js";
@@ -112,11 +123,11 @@ import {
 } from "./chunk-ISN5GRYI.js";
 import {
   VERSION
-} from "./chunk-TCWMDCBX.js";
+} from "./chunk-2X3UJ4Q3.js";
 import "./chunk-EOVYQ3IG.js";
 import {
   createRenderCancellationScope
-} from "./chunk-KQGWP4KH.js";
+} from "./chunk-OSASJLU4.js";
 import {
   H264EncoderUnavailableError,
   chromeLaunchRemediation,
@@ -131,8 +142,8 @@ import {
   MAX_VP9_CPU_USED,
   MIN_VP9_CPU_USED,
   isVideoFrameFormat
-} from "./chunk-IZPN423R.js";
-import "./chunk-3SVC7SW4.js";
+} from "./chunk-2F6LWCSF.js";
+import "./chunk-V6UUZGP6.js";
 import "./chunk-NE55C6S5.js";
 import "./chunk-JYVGYKXG.js";
 import {
@@ -140,8 +151,8 @@ import {
   fpsToFfmpegArg,
   fpsToNumber,
   parseFps
-} from "./chunk-XQKVEQNY.js";
-import "./chunk-QBYHNRHU.js";
+} from "./chunk-ZDEEHQ2Y.js";
+import "./chunk-GV7I3ZSQ.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-UJKQWGFF.js";
 import {
@@ -149,7 +160,7 @@ import {
   isAspectAgnosticResolutionAlias,
   normalizeResolutionFlag,
   suggestMatchingPreset
-} from "./chunk-LFNQDTSH.js";
+} from "./chunk-VYKPBRCB.js";
 import "./chunk-OFQWTKPW.js";
 import "./chunk-DPVXBVLL.js";
 import "./chunk-T76PLPD6.js";
@@ -165,16 +176,16 @@ import "./chunk-TWWSYAKJ.js";
 import {
   lintProject,
   shouldBlockRender
-} from "./chunk-GNTVYF7E.js";
+} from "./chunk-YOEGUBBY.js";
 import {
   collectSubCompositionSrcs
 } from "./chunk-IWFLMU2N.js";
-import "./chunk-APDLWWFG.js";
+import "./chunk-3VGU2SH7.js";
 import "./chunk-VAS6HQX3.js";
 import "./chunk-3RM2ETQT.js";
 import "./chunk-BSQ7XANM.js";
 import "./chunk-SDYDNHEE.js";
-import "./chunk-2PSPARWP.js";
+import "./chunk-TYXH3EKP.js";
 import "./chunk-IXLUTE6N.js";
 import {
   normalizeErrorMessage
@@ -672,7 +683,7 @@ async function executeRenderPlan(plan, dependencies, cancellation) {
   let batchModule;
   let preparedBatch;
   if (plan.batchPath) {
-    batchModule = await import("./batchRender-NFLVIDB4.js");
+    batchModule = await import("./batchRender-6TD4XSIP.js");
     try {
       preparedBatch = batchModule.prepareBatchRender({
         batchPath: plan.batchPath,
@@ -1601,7 +1612,14 @@ function resolveDockerHostPlatform(options) {
   }
   return platform;
 }
+async function registerRenderOutputOrWarn(projectDir, outputPath) {
+  await registerRenderOutput(projectDir, outputPath).catch(
+    (error) => console.warn(`Render output was not registered: ${normalizeErrorMessage(error)}`)
+  );
+}
 async function renderDocker(projectDir, outputPath, options) {
+  await registerRenderOutputOrWarn(projectDir, outputPath);
+  const capture = await captureArtifactRevision(projectDir).catch(() => void 0);
   const startTime = Date.now();
   const dockerVersion = isDevMode() ? "latest" : VERSION;
   if (!options.quiet && isDevMode()) {
@@ -1677,6 +1695,11 @@ async function renderDocker(projectDir, outputPath, options) {
   }
   const elapsed = Date.now() - startTime;
   markRenderSucceeded();
+  await runPostRenderStepAsync(
+    "recordRenderSuccess",
+    () => recordRenderSuccess(projectDir, outputPath, "completed", capture).then(() => {
+    })
+  );
   runPostRenderStep(
     "trackRenderComplete",
     () => trackRenderComplete({
@@ -1723,6 +1746,8 @@ async function renderLocal(projectDir, outputPath, options, commandCancellation)
   }
 }
 async function executeLocalRender(projectDir, outputPath, options, cancellation) {
+  await registerRenderOutputOrWarn(projectDir, outputPath);
+  const capture = await captureArtifactRevision(projectDir).catch(() => void 0);
   cancellation.checkAncestors();
   cancellation.signal.throwIfAborted();
   let recoveredOrphanTrees = 0;
@@ -1893,6 +1918,16 @@ async function executeLocalRender(projectDir, outputPath, options, cancellation)
     );
   }
   markRenderSucceeded();
+  await runPostRenderStepAsync(
+    "recordRenderSuccess",
+    () => recordRenderSuccess(
+      projectDir,
+      outputPath,
+      job.outcome === "completed_with_warnings" ? "completed_with_warnings" : "completed",
+      capture
+    ).then(() => {
+    })
+  );
   maybeConsumeDeParallelRouterTrial(deParallelRouterActive, job, options.quiet);
   const elapsed = Date.now() - startTime;
   if (job.outcome === "completed_with_warnings") {

package/dist/{render-batch-AQHU2JWZ.js → render-batch-6UN3HT5A.js}

@@ -14,7 +14,7 @@ import {
   loadProjectVariableSchema,
   reportVariableIssues,
   validateVariablesAgainstSchema
-} from "./chunk-4LE27ST4.js";
+} from "./chunk-XQYLUY2F.js";
 import "./chunk-FH7WODJH.js";
 import {
   errorBox
@@ -27,11 +27,11 @@ import {
 import {
   c
 } from "./chunk-ZTZA4UWZ.js";
-import "./chunk-XQKVEQNY.js";
-import "./chunk-QBYHNRHU.js";
+import "./chunk-ZDEEHQ2Y.js";
+import "./chunk-GV7I3ZSQ.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-UJKQWGFF.js";
-import "./chunk-LFNQDTSH.js";
+import "./chunk-VYKPBRCB.js";
 import "./chunk-OFQWTKPW.js";
 import "./chunk-DPVXBVLL.js";
 import "./chunk-T76PLPD6.js";
@@ -40,7 +40,7 @@ import "./chunk-RQVDTPGD.js";
 import "./chunk-3RM2ETQT.js";
 import "./chunk-BSQ7XANM.js";
 import "./chunk-SDYDNHEE.js";
-import "./chunk-2PSPARWP.js";
+import "./chunk-TYXH3EKP.js";
 import "./chunk-IXLUTE6N.js";
 import {
   normalizeErrorMessage

package/dist/renderSetupWorker.js

@@ -20,14 +20,14 @@ import {
 import "./chunk-TWWSYAKJ.js";
 import {
   lintProject
-} from "./chunk-GNTVYF7E.js";
+} from "./chunk-YOEGUBBY.js";
 import "./chunk-IWFLMU2N.js";
-import "./chunk-APDLWWFG.js";
+import "./chunk-3VGU2SH7.js";
 import "./chunk-VAS6HQX3.js";
 import "./chunk-3RM2ETQT.js";
 import "./chunk-BSQ7XANM.js";
 import "./chunk-SDYDNHEE.js";
-import "./chunk-2PSPARWP.js";
+import "./chunk-TYXH3EKP.js";
 import "./chunk-IXLUTE6N.js";
 import "./chunk-KNU5COPB.js";
 import "./chunk-KGPLIH7B.js";

package/dist/{resolver-L5BDZJKU.js → resolver-O6ZENVYP.js}

@@ -11,16 +11,16 @@ import {
   resolveItemWithDependencies,
   resolveItemsByTag,
   unreachableRegistryMessage
-} from "./chunk-XGLNQDLN.js";
-import "./chunk-YZTVHRJ2.js";
+} from "./chunk-PXOFFSO3.js";
+import "./chunk-2XEBNYG5.js";
 import "./chunk-AWDFDFI3.js";
 import "./chunk-P6LJ4Y32.js";
 import "./chunk-GMECXFAN.js";
-import "./chunk-XQKVEQNY.js";
-import "./chunk-QBYHNRHU.js";
+import "./chunk-ZDEEHQ2Y.js";
+import "./chunk-GV7I3ZSQ.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-UJKQWGFF.js";
-import "./chunk-LFNQDTSH.js";
+import "./chunk-VYKPBRCB.js";
 import "./chunk-OFQWTKPW.js";
 import "./chunk-DPVXBVLL.js";
 import "./chunk-T76PLPD6.js";
@@ -29,7 +29,7 @@ import "./chunk-RQVDTPGD.js";
 import "./chunk-3RM2ETQT.js";
 import "./chunk-BSQ7XANM.js";
 import "./chunk-SDYDNHEE.js";
-import "./chunk-2PSPARWP.js";
+import "./chunk-TYXH3EKP.js";
 import "./chunk-IXLUTE6N.js";
 import "./chunk-M2WBOQ2Q.js";
 export {

package/dist/{sherpa-3S3ISG7G.js → sherpa-RWHRDO53.js}

@@ -16,26 +16,26 @@ import {
   sherpaRuntimeLoadError,
   sherpaUnsupportedReason,
   transcribeWithSherpa
-} from "./chunk-DIOBKUBV.js";
+} from "./chunk-5OKZRXLT.js";
 import "./chunk-BXCMXMJQ.js";
 import "./chunk-3DKN5WKL.js";
 import "./chunk-EOVYQ3IG.js";
-import "./chunk-QF7AE3DB.js";
-import "./chunk-KQGWP4KH.js";
+import "./chunk-J5LEAKUA.js";
+import "./chunk-OSASJLU4.js";
 import "./chunk-6BEFEWFB.js";
 import "./chunk-YG2Y55KF.js";
 import "./chunk-PO2SDVQA.js";
 import "./chunk-4MLYMDQ4.js";
 import "./chunk-AMKC3AXA.js";
-import "./chunk-IZPN423R.js";
-import "./chunk-3SVC7SW4.js";
+import "./chunk-2F6LWCSF.js";
+import "./chunk-V6UUZGP6.js";
 import "./chunk-NE55C6S5.js";
 import "./chunk-JYVGYKXG.js";
-import "./chunk-XQKVEQNY.js";
-import "./chunk-QBYHNRHU.js";
+import "./chunk-ZDEEHQ2Y.js";
+import "./chunk-GV7I3ZSQ.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-UJKQWGFF.js";
-import "./chunk-LFNQDTSH.js";
+import "./chunk-VYKPBRCB.js";
 import "./chunk-OFQWTKPW.js";
 import "./chunk-DPVXBVLL.js";
 import "./chunk-T76PLPD6.js";
@@ -44,14 +44,14 @@ import "./chunk-RQVDTPGD.js";
 import "./chunk-YIJMVFEJ.js";
 import "./chunk-54DMWFQZ.js";
 import "./chunk-TWWSYAKJ.js";
-import "./chunk-GNTVYF7E.js";
+import "./chunk-YOEGUBBY.js";
 import "./chunk-IWFLMU2N.js";
-import "./chunk-APDLWWFG.js";
+import "./chunk-3VGU2SH7.js";
 import "./chunk-VAS6HQX3.js";
 import "./chunk-3RM2ETQT.js";
 import "./chunk-BSQ7XANM.js";
 import "./chunk-SDYDNHEE.js";
-import "./chunk-2PSPARWP.js";
+import "./chunk-TYXH3EKP.js";
 import "./chunk-IXLUTE6N.js";
 import "./chunk-KNU5COPB.js";
 import "./chunk-JZIEZCQM.js";

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

@@ -79,6 +79,9 @@ Static audits cannot catch every mount failure. When the project uses sub-compos
 
 ```bash
 npx hyperframes snapshot --at <t1>,<t2>,<t3>
+# For multiple samples within one scene or interval:
+npx hyperframes snapshot --composition <data-composition-id> --frames 8
+npx hyperframes snapshot --range 3:5 --frames 8
 ```
 
 Treat tiny unstyled content, canvas-sized icons, missing hero elements, or timeline-registration timeouts as render-blocking mount defects. See `hyperframes-core/references/sub-compositions.md` for the corresponding fixes.

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

@@ -104,9 +104,13 @@ Drop a `*.motion.json` sidecar next to the composition (matching the html basena
 npx hyperframes snapshot                       # 5 key frames as PNG
 npx hyperframes snapshot ./my-project          # specific project
 npx hyperframes snapshot --frames 10           # evenly-spaced N frames
+npx hyperframes snapshot --range 3:5 --frames 8 # 8 frames within root-timeline seconds 3–5
+npx hyperframes snapshot --composition intro --frames 8 # 8 frames within this data-composition-id
 ```
 
-Captures still PNGs from the composition for visual diffing, thumbnails, or attaching to a PR. Faster than rendering a video when you only need a few hero frames. Output lands in the project's snapshots directory. Not deprecated: it remains the standalone capture utility, while `check --snapshots` covers the gate's needs (overview frames annotated with labeled finding boxes, plus `finding-NN-<code>.png` crops for every error finding with a bbox).
+Still PNGs. Each run writes `.hyperframes/artifacts/snapshots/<id>/` unless `--output` is set. `snapshot` is the standalone capture; `check --snapshots` is the gate.
+
+One of `--at`, `--range START:END` (seconds), or `--composition <data-composition-id>` (not a CSS selector). `--frames` defaults to 5. Range and composition sample just before the end and add no extra end frame; `--at` adds one unless `--no-end`.
 
 ### Zooming into a reported finding
 

package/dist/{skills-X4WQEKNF.js → skills-KC6IGXDU.js}

@@ -6,8 +6,8 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   trackSkillsInstallSkipped
-} from "./chunk-ZD3RDNZI.js";
-import "./chunk-IZ7L6V76.js";
+} from "./chunk-CBMZYOWC.js";
+import "./chunk-AUK5QCRH.js";
 import {
   diag
 } from "./chunk-VWG7OQKU.js";
@@ -35,15 +35,15 @@ import {
   isCoreSkill,
   presentSkills,
   pruneOrphanedLockEntries
-} from "./chunk-OSAH7S5M.js";
+} from "./chunk-FZC4UM4G.js";
 import {
   withMeta
-} from "./chunk-35PWWBGZ.js";
+} from "./chunk-YI6OBVWQ.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-TCWMDCBX.js";
+import "./chunk-2X3UJ4Q3.js";
 import {
   buildNpxCommand
 } from "./chunk-6BEFEWFB.js";

package/dist/{skillsUpdateCheck-UYCVHDZ6.js → skillsUpdateCheck-7C4TD7EL.js}

@@ -9,13 +9,13 @@ import {
   printSkillsUpdateNotice,
   refreshSkillsCache,
   skillsCheckDue
-} from "./chunk-OSAH7S5M.js";
-import "./chunk-35PWWBGZ.js";
+} from "./chunk-FZC4UM4G.js";
+import "./chunk-YI6OBVWQ.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-TCWMDCBX.js";
+import "./chunk-2X3UJ4Q3.js";
 import "./chunk-KNU5COPB.js";
 import "./chunk-M2WBOQ2Q.js";
 export {