hyperframes 0.8.191 → 0.8.193

package/dist/{sherpa-XZPG7QFF.js → sherpa-VVAKRCPL.js}

@@ -17,45 +17,46 @@ import {
   sherpaRuntimeLoadError,
   sherpaUnsupportedReason,
   transcribeWithSherpa
-} from "./chunk-BFFLKQVB.js";
+} from "./chunk-MFUNDJEV.js";
 import "./chunk-CZUAX3BV.js";
-import "./chunk-QH3T4WI2.js";
+import "./chunk-EXAX37XR.js";
 import "./chunk-6BEFEWFB.js";
-import "./chunk-AQB5M53R.js";
-import "./chunk-RWYUK7LM.js";
-import "./chunk-7LUJE3II.js";
+import "./chunk-M3KZBDPB.js";
+import "./chunk-BP4EMEGH.js";
+import "./chunk-VLLFORE2.js";
 import "./chunk-WQ6ZXHFQ.js";
-import "./chunk-GLG5JWLI.js";
+import "./chunk-DYNHVCBF.js";
 import "./chunk-EOVYQ3IG.js";
-import "./chunk-NMDUSCCE.js";
+import "./chunk-L4JB7LI4.js";
 import "./chunk-IZCW2NKT.js";
-import "./chunk-GM3WIOO6.js";
+import "./chunk-7HTH5PFK.js";
 import "./chunk-RQVDTPGD.js";
-import "./chunk-VYQYVYQ5.js";
-import "./chunk-LM265QNK.js";
+import "./chunk-3W4B6G7Y.js";
+import "./chunk-USWPZXEA.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-X7HBSTCZ.js";
-import "./chunk-B2A56S5C.js";
+import "./chunk-2MCXIY4B.js";
 import "./chunk-OFQWTKPW.js";
 import "./chunk-DPVXBVLL.js";
 import "./chunk-3GXQPCJC.js";
 import "./chunk-634HSJ3J.js";
 import "./chunk-FXMKHHPO.js";
-import "./chunk-W64L7IFS.js";
-import "./chunk-DYAPHNV6.js";
+import "./chunk-IW5G323T.js";
+import "./chunk-RWGASWT7.js";
 import "./chunk-XT6MXC7A.js";
 import "./chunk-4UMPIPCQ.js";
-import "./chunk-3NRB7YXW.js";
+import "./chunk-2VXY3PEF.js";
 import "./chunk-VAS6HQX3.js";
 import "./chunk-6BNTGNGD.js";
-import "./chunk-RUOG4VB7.js";
+import "./chunk-CZGHFATT.js";
+import "./chunk-PKZ7RK5N.js";
 import "./chunk-MMQ52NIZ.js";
 import "./chunk-BSQ7XANM.js";
 import "./chunk-SDYDNHEE.js";
-import "./chunk-IXLUTE6N.js";
-import "./chunk-I5JRXMCV.js";
+import "./chunk-3422KMTD.js";
+import "./chunk-RXATE6FZ.js";
 import "./chunk-W2LGJSEN.js";
-import "./chunk-KNU5COPB.js";
+import "./chunk-T2EUWCJE.js";
 import "./chunk-JZIEZCQM.js";
 import "./chunk-UOFAE5RF.js";
 import "./chunk-IR35BCLK.js";

package/dist/skills/hyperframes/references/format.md

@@ -94,6 +94,7 @@ The detail behind the contract in `SKILL.md`. Full references: `npx hyperframes
 ## Fonts
 
 - Bundled, so they resolve by name: Inter, Montserrat, Outfit, Nunito, Oswald, League Gothic, Archivo Black, Space Mono, IBM Plex Mono, JetBrains Mono, EB Garamond, Playfair Display, Source Code Pro, Noto Sans JP, Roboto, Open Sans, Lato, Poppins. Common system fonts (Helvetica, Arial, Times, Menlo and the like) are swapped for the nearest of these.
+- The bundle only has Latin text at a few weights per family (Inter: 400, 700, 900). The compiler still fetches each of these families from Google Fonts for the other weights and scripts, and caches the result in `~/.cache/hyperframes/fonts`.
 - Any other family needs `@font-face` in the file that uses it, or lint fails `font_family_without_font_face`: `src: url('assets/fonts/x.woff2')` for a file in the project (a capture's own fonts, or one you download there), or `local('Exact Name')` for a font installed on this machine.
 
 ## Timing and the timeline

package/dist/skills/hyperframes/references/skill-lifecycle.md

@@ -9,11 +9,15 @@ For a plugin installation, follow [plugin execution rules](plugin-installation.m
 
 ## What `init` does
 
-`npx hyperframes init` checks GitHub and refreshes the core set plus other skills already installed. A current install is a no-op. Offline or rate-limited checks degrade gracefully and do not fail project scaffolding.
+`npx hyperframes init` installs the core set when it is missing and leaves every skill that is already installed as it is: it never refreshes, replaces or removes one. Updating is `npx hyperframes skills update`, run by you. Offline or rate-limited checks degrade gracefully and do not fail project scaffolding.
 
-The `--skip-skills` CLI flag is temporarily ignored. CI and tests may opt out with `HYPERFRAMES_SKIP_SKILLS=1`.
+`--skip-skills` makes `init` leave skills alone. `HYPERFRAMES_SKIP_SKILLS=1` does the same for CI and tests.
 
-`HYPERFRAMES_SKIP_SKILLS=1` also makes `skills update` (bare or named) and bare `skills` exit 0 without installing or pruning, so an install pinned to one commit stays pinned.
+`HYPERFRAMES_SKIP_SKILLS=1` also makes `skills update` (bare or named) and bare `skills` exit 0 without installing, so an install pinned to one commit stays pinned.
+
+## Stale-skills notice
+
+After `render`, `lint` and `validate`, the CLI prints `N HyperFrames skills out of date or missing` to stderr when the cached check finds stale skills, so an agent run without a terminal sees it too. It is off in CI, in dev, with `HYPERFRAMES_NO_UPDATE_CHECK=1` and with `HYPERFRAMES_SKIP_SKILLS=1`, and runs with `--json` too, since it only writes stderr and leaves `--json` stdout untouched.
 
 ## Diagnose and update
 
@@ -26,7 +30,7 @@ npx hyperframes skills
 ```
 
 - `skills check` exits non-zero when an installed skill is stale or the core set is incomplete. Skills available on demand but not installed are not failures.
-- Bare `skills update` refreshes the core set and everything already installed, and removes skills that are no longer published.
+- Bare `skills update` refreshes the core set and the HyperFrames skills already installed. It never removes a skill, and it leaves a skill the install record attributes to another publisher alone, even when the name matches one of ours.
 - Named `skills update <name...>` also installs those named skills.
 - Bare `skills` installs the full published set explicitly.
 

package/dist/skills/hyperframes-cli/references/init-and-scaffold.md

@@ -24,7 +24,7 @@ Other useful flags:
 
 - `--resolution` — preset: `landscape` (1920×1080), `portrait` (1080×1920), `landscape-4k`, `portrait-4k`, `square` (1080×1080), `square-4k`. Aliases: `1080p`, `4k`, `uhd`, `1080p-square`, `4k-square`.
 - `--skill=<slug>` — record the owning skill (e.g. `hyperframes`) in `hyperframes.json`, so every later render of this project — re-renders, `npm run render`, `--batch` — is attributed to it on anonymous telemetry without re-passing the flag. You rarely pass it by hand.
-- `--skip-skills` — **temporarily ignored**: `init` always checks AI coding skills against GitHub while the skills.sh registry catches up. To opt out (CI/tests), set the `HYPERFRAMES_SKIP_SKILLS=1` env var instead.
+- `--skip-skills` — leave AI coding skills alone: `init` does not install the core set. `HYPERFRAMES_SKIP_SKILLS=1` does the same.
 - `--skip-transcribe` — don't auto-transcribe `--audio` / `--video` with Whisper.
 - `--model`, `--language` — Whisper model / language for the auto-transcription.
 

package/dist/{skills-EYLB2V6F.js → skills-ZHBURVQG.js}

@@ -15,8 +15,8 @@ import {
 } from "./chunk-WMQNIQDJ.js";
 import {
   trackSkillsInstallSkipped
-} from "./chunk-TFGO5YMI.js";
-import "./chunk-W3CS2KFV.js";
+} from "./chunk-RTLPWOO6.js";
+import "./chunk-ZZPBXRYQ.js";
 import {
   diag
 } from "./chunk-VWG7OQKU.js";
@@ -39,24 +39,22 @@ import "./chunk-W2LGJSEN.js";
 import {
   FALLBACK_CORE_SKILLS,
   RETIRED_SKILLS,
-  SKILLS_CLI_LOCK_PATHS_VERIFIED_AT,
   checkSkills,
   hyperframesSkillNames,
   invalidateSkillsCache,
   isCoreSkill,
   presentSkills,
-  pruneOrphanedLockEntries,
   retiredSkillNotice
-} from "./chunk-FBDOHH3Q.js";
+} from "./chunk-V7ZA2BNW.js";
 import {
   withMeta
-} from "./chunk-KAC2WR7P.js";
+} from "./chunk-TZEKVLPV.js";
 import "./chunk-K4WIOZFP.js";
-import "./chunk-XUXGIA7H.js";
+import "./chunk-6NLPPKBO.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-MSM6VRQ4.js";
-import "./chunk-KNU5COPB.js";
+import "./chunk-LFUVTS6V.js";
+import "./chunk-T2EUWCJE.js";
 import "./chunk-M2WBOQ2Q.js";
 
 // src/commands/skills.ts
@@ -421,15 +419,6 @@ function runSkillsAdd(source, selection, opts = {}) {
   );
 }
 var PLAIN_SKILL_NAME = /^[a-z0-9][a-z0-9._-]*$/i;
-function runSkillsRemove(names, opts) {
-  const safe = names.filter((n) => PLAIN_SKILL_NAME.test(n));
-  const rejected = names.filter((n) => !PLAIN_SKILL_NAME.test(n));
-  if (rejected.length) {
-    R.warn(c.warn(`Skipping unexpected skill name(s): ${rejected.join(", ")}`));
-  }
-  if (!safe.length) return Promise.resolve();
-  return spawnNpx(["skills", "remove", ...safe, ...opts.global ? ["-g"] : [], "--yes"]);
-}
 var SOURCES = [{ name: "HyperFrames", url: "https://github.com/heygen-com/hyperframes" }];
 function mirrorToInstalledAgents() {
   try {
@@ -533,7 +522,7 @@ async function updateSkills(opts = {}) {
     }
     return { ...await updateSkillsOffline(requested, { strict, cwd: opts.cwd }), retired };
   }
-  const manifestSkills = check.skills.filter((s) => s.status !== "removed");
+  const manifestSkills = check.skills;
   const manifestNames = new Set(manifestSkills.map((s) => s.name));
   const unknown = requested.filter((name) => !manifestNames.has(name));
   if (unknown.length) {
@@ -544,7 +533,9 @@ async function updateSkills(opts = {}) {
   const targets = manifestSkills.filter(
     (s) => opts.all === true || requested.includes(s.name) || isCoreSkill(s.name) || opts.refreshInstalled === true && s.status !== "missing"
   );
-  const toInstall = targets.filter((s) => s.status === "missing" || s.status === "outdated");
+  const toInstall = targets.filter(
+    (s) => s.status === "missing" || s.status === "outdated" && opts.onlyMissing !== true
+  );
   const result = {
     targets: targets.map((s) => s.name),
     installed: toInstall.map((s) => s.name),
@@ -619,7 +610,6 @@ function renderCheck(result) {
   if (summary.outdated) parts.push(c.warn(`\u2191 ${summary.outdated} outdated`));
   if (summary.coreMissing) parts.push(c.warn(`\u25E6 ${summary.coreMissing} core not installed`));
   if (onDemandMissing) parts.push(c.dim(`\u25E6 ${onDemandMissing} available on demand`));
-  if (summary.removed) parts.push(c.warn(`\u2717 ${summary.removed} removed upstream`));
   console.log(`  ${parts.join("   ")}`);
   printSkillSection(result, "outdated", "Outdated:", "\u2191", c.warn);
   printSkillSection(
@@ -638,22 +628,6 @@ function renderCheck(result) {
     c.dim,
     (s) => !isCoreSkill(s.name)
   );
-  printSkillSection(
-    result,
-    "removed",
-    "Removed upstream (renamed or dropped \u2014 no longer published):",
-    "\u2717",
-    c.warn
-  );
-  if (result.lockMissing) {
-    console.log();
-    console.log(
-      `  ${c.warn(`! Skills lock not found \u2014 can't check for skills removed upstream.`)}`
-    );
-    console.log(
-      `  ${c.dim(`  (lock paths verified against ${SKILLS_CLI_LOCK_PATHS_VERIFIED_AT})`)}`
-    );
-  }
   console.log();
   if (result.updateAvailable) {
     console.log(`  ${c.accent("Update: npx hyperframes skills update")}`);
@@ -737,26 +711,12 @@ function reportUpdateFailure(message, json) {
 var updateCommand = defineCommand({
   meta: {
     name: "update",
-    description: "Update the core set plus every installed HyperFrames skill to the latest, and remove any no longer published. Pass skill names to also install those (how on-demand skills install) \u2014 without names it never expands a partial install"
+    description: "Update the core set plus every installed HyperFrames skill to the latest. Pass skill names to also install those (how on-demand skills install) \u2014 without names it never expands a partial install, and it never removes a skill"
   },
-  // Mirror `check`'s flags: the prune step runs the same removed-detection, so it
-  // must respect the same overrides. Without these, `update`'s internal
-  // checkSkills() fell back to defaults — pruning the auto-detected install
-  // against the default manifest even when the user pointed `check` elsewhere.
   args: {
-    json: { type: "boolean", description: "Output as JSON", default: false },
-    dir: {
-      type: "string",
-      description: "Skills dir for removed-detection only \u2014 scopes the prune, not the install (default: auto-detect)"
-    },
-    source: {
-      type: "string",
-      description: "Where 'latest' comes from for removed-detection (local path, owner/repo, or URL) \u2014 does not change the install source"
-    }
+    json: { type: "boolean", description: "Output as JSON", default: false }
   },
   async run({ args }) {
-    const dir = args.dir;
-    const source = args.source;
     const { requested, rejected } = requestedNamesFrom(args._ ?? []);
     if (rejected.length) {
       reportUpdateFailure(`Invalid skill name(s): ${rejected.join(", ")}`, args.json === true);
@@ -775,28 +735,6 @@ var updateCommand = defineCommand({
       setCommandExitCode(1);
       return;
     }
-    try {
-      const { skills, scope } = await checkSkills({ dir, source, canonical: true });
-      const removed = skills.filter((s) => s.status === "removed").map((s) => s.name);
-      if (removed.length) {
-        console.log();
-        console.log(
-          c.dim(`Removing ${removed.length} skill(s) no longer published: ${removed.join(", ")}`)
-        );
-        await runSkillsRemove(removed, { global: scope === "global" });
-        const scopeForPrune = scope ?? "global";
-        const stillOrphaned = pruneOrphanedLockEntries(removed, scopeForPrune);
-        if (stillOrphaned.length) {
-          console.log(
-            c.dim(
-              `Reconciled ${stillOrphaned.length} orphaned lock entr${stillOrphaned.length === 1 ? "y" : "ies"} with no on-disk bundle: ${stillOrphaned.join(", ")}`
-            )
-          );
-        }
-      }
-    } catch (err) {
-      R.warn(c.warn(`Skipped removed-skill cleanup: ${err.message}`));
-    }
   }
 });
 var skills_default = defineCommand({

package/dist/{skillsUpdateCheck-TE6K5ROM.js → skillsUpdateCheck-VMDAL2O2.js}

@@ -9,14 +9,14 @@ import {
   printSkillsUpdateNotice,
   refreshSkillsCache,
   skillsCheckDue
-} from "./chunk-FBDOHH3Q.js";
-import "./chunk-KAC2WR7P.js";
+} from "./chunk-V7ZA2BNW.js";
+import "./chunk-TZEKVLPV.js";
 import "./chunk-K4WIOZFP.js";
-import "./chunk-XUXGIA7H.js";
+import "./chunk-6NLPPKBO.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-MSM6VRQ4.js";
-import "./chunk-KNU5COPB.js";
+import "./chunk-LFUVTS6V.js";
+import "./chunk-T2EUWCJE.js";
 import "./chunk-M2WBOQ2Q.js";
 export {
   invalidateSkillsCache,

package/dist/{slideshow-YTWATJRT.js → slideshow-SJGK4RQS.js}

@@ -12,7 +12,7 @@ import {
   parseSlideshowManifest,
   resolveSlideshow,
   slideshowIslandRegex
-} from "./chunk-IXLUTE6N.js";
+} from "./chunk-3422KMTD.js";
 import "./chunk-M2WBOQ2Q.js";
 export {
   SLIDESHOW_ISLAND_TYPE,

package/dist/{snapshot-FE4T3SCN.js → snapshot-KEOG56SL.js}

@@ -19,13 +19,13 @@ import {
 import {
   loadInstalledSharp,
   loadOptionalPackage
-} from "./chunk-QH3T4WI2.js";
+} from "./chunk-EXAX37XR.js";
 import "./chunk-6BEFEWFB.js";
 import {
   findFFmpeg,
   findFFprobe,
   getFFmpegInstallHint
-} from "./chunk-GLG5JWLI.js";
+} from "./chunk-DYNHVCBF.js";
 import {
   pngDimensions,
   reportArtifacts,
@@ -33,30 +33,30 @@ import {
 } from "./chunk-57GN6KWT.js";
 import {
   captureArtifactRevision
-} from "./chunk-7A65UCMI.js";
-import "./chunk-JOLZ3BSL.js";
+} from "./chunk-F5LLORBP.js";
+import "./chunk-2LSCYS2H.js";
 import "./chunk-X7MTZ4T2.js";
 import {
   resolveProject
-} from "./chunk-7ZJEQY7Q.js";
+} from "./chunk-LMNZLZMJ.js";
 import {
   serveStaticProjectHtml
-} from "./chunk-T5YF32WV.js";
-import "./chunk-ALEF2F5N.js";
+} from "./chunk-VPC4XIVI.js";
+import "./chunk-L5YLA54L.js";
 import "./chunk-X7MTZ4T2.js";
 import "./chunk-XUHOIDKG.js";
-import "./chunk-2WNVHZHA.js";
-import "./chunk-KHCTBZGJ.js";
+import "./chunk-UNATIAOT.js";
+import "./chunk-XQPA4W3M.js";
 import "./chunk-6JR2XUEE.js";
-import "./chunk-EI7FP7F3.js";
+import "./chunk-FBVUAH7N.js";
 import {
   artifactDirectory,
   finishSnapshotRun,
   forgetRecordedArtifacts,
   recordArtifacts,
   retainSnapshotOutput
-} from "./chunk-TMBUBLZB.js";
-import "./chunk-COETAXRN.js";
+} from "./chunk-C4Y3ZREE.js";
+import "./chunk-7YSFE4SZ.js";
 import "./chunk-ALVXFXUG.js";
 import {
   DEFAULT_ZOOM_SCALE,
@@ -68,37 +68,37 @@ import {
   runFfmpegOnce,
   seekCompositionTimelineOnly,
   settleCompositionSeek
-} from "./chunk-JYSSPQDT.js";
-import "./chunk-WY3TQ2PT.js";
+} from "./chunk-4LXZJIVY.js";
+import "./chunk-UIC7B5KW.js";
 import "./chunk-MOEGCMKI.js";
-import "./chunk-TJKE4EYX.js";
+import "./chunk-UB7BIDBS.js";
 import "./chunk-DKPNNYBZ.js";
-import "./chunk-7FF36MAD.js";
+import "./chunk-VW63MHQU.js";
 import "./chunk-K2FLNJVB.js";
 import "./chunk-EHSBBBR2.js";
-import "./chunk-COWQITWP.js";
+import "./chunk-4TKJWWPL.js";
 import "./chunk-442JNXRM.js";
 import "./chunk-DQBY7FRR.js";
 import {
   resolveLocalBrowserGpuMode
-} from "./chunk-XMSQRDAK.js";
-import "./chunk-JJJCFKMF.js";
+} from "./chunk-YS4JUGNI.js";
+import "./chunk-6XUJVEY2.js";
 import "./chunk-XT7X6QCP.js";
 import "./chunk-4YYJOFKS.js";
 import "./chunk-HVW7ABXD.js";
-import "./chunk-3XI7MIZB.js";
+import "./chunk-X5CECNCK.js";
 import {
   runWithConcurrencyLimit
 } from "./chunk-JHOCK3DG.js";
-import "./chunk-TRZVS6TL.js";
-import "./chunk-LBNEH6IQ.js";
+import "./chunk-QKX7ITER.js";
+import "./chunk-7QNIXBQD.js";
 import "./chunk-AWDFDFI3.js";
 import "./chunk-P6LJ4Y32.js";
 import "./chunk-GMECXFAN.js";
-import "./chunk-7L37AB57.js";
+import "./chunk-E3P3LJG6.js";
 import "./chunk-EOVYQ3IG.js";
-import "./chunk-TFGO5YMI.js";
-import "./chunk-W3CS2KFV.js";
+import "./chunk-RTLPWOO6.js";
+import "./chunk-ZZPBXRYQ.js";
 import "./chunk-VWG7OQKU.js";
 import {
   defineCommand
@@ -114,26 +114,26 @@ import {
 import "./chunk-KLIKCX6Q.js";
 import "./chunk-EVMY7IPL.js";
 import "./chunk-7FMUTGOH.js";
-import "./chunk-NMDUSCCE.js";
+import "./chunk-L4JB7LI4.js";
 import "./chunk-IZCW2NKT.js";
 import {
   createRuntimeStartTimeResolver,
   isClipVisibleAt,
   isInClipWindow
-} from "./chunk-GM3WIOO6.js";
+} from "./chunk-7HTH5PFK.js";
 import "./chunk-RQVDTPGD.js";
-import "./chunk-VYQYVYQ5.js";
+import "./chunk-3W4B6G7Y.js";
 import {
   readElementRateSpec,
   sourceTimeAt,
   timeAtSourceTime
-} from "./chunk-LM265QNK.js";
+} from "./chunk-USWPZXEA.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-X7HBSTCZ.js";
 import {
   topLevelElements,
   trackKindOf
-} from "./chunk-B2A56S5C.js";
+} from "./chunk-2MCXIY4B.js";
 import "./chunk-OFQWTKPW.js";
 import "./chunk-DPVXBVLL.js";
 import "./chunk-3GXQPCJC.js";
@@ -141,7 +141,7 @@ import "./chunk-634HSJ3J.js";
 import "./chunk-FXMKHHPO.js";
 import {
   runCancellableProcess
-} from "./chunk-DYAPHNV6.js";
+} from "./chunk-RWGASWT7.js";
 import {
   definitiveEntryMismatchComposition,
   hasDefinitiveEntryMismatch
@@ -151,29 +151,30 @@ import "./chunk-XT6MXC7A.js";
 import "./chunk-4UMPIPCQ.js";
 import {
   lintProject
-} from "./chunk-3NRB7YXW.js";
+} from "./chunk-2VXY3PEF.js";
 import "./chunk-VAS6HQX3.js";
 import "./chunk-6BNTGNGD.js";
-import "./chunk-RUOG4VB7.js";
+import "./chunk-CZGHFATT.js";
+import "./chunk-PKZ7RK5N.js";
 import "./chunk-MMQ52NIZ.js";
 import "./chunk-BSQ7XANM.js";
 import {
   parseHTML
 } from "./chunk-SDYDNHEE.js";
-import "./chunk-IXLUTE6N.js";
-import "./chunk-I5JRXMCV.js";
+import "./chunk-3422KMTD.js";
+import "./chunk-RXATE6FZ.js";
 import "./chunk-W2LGJSEN.js";
 import {
   withMeta
-} from "./chunk-KAC2WR7P.js";
+} from "./chunk-TZEKVLPV.js";
 import "./chunk-K4WIOZFP.js";
-import "./chunk-XUXGIA7H.js";
+import "./chunk-6NLPPKBO.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-MSM6VRQ4.js";
+import "./chunk-LFUVTS6V.js";
 import {
   normalizeErrorMessage
-} from "./chunk-KNU5COPB.js";
+} from "./chunk-T2EUWCJE.js";
 import "./chunk-KGPLIH7B.js";
 import "./chunk-M2WBOQ2Q.js";
 
@@ -185,6 +186,12 @@ function parseSnapshotRange(value) {
     throw new Error("--range must be START,END in seconds, with 0 <= START < END");
   return [range[0], range[1]];
 }
+function parseSnapshotAt(value) {
+  const times = value.split(",").map((part) => part.trim() === "" ? NaN : Number(part));
+  if (!times.every((time) => Number.isFinite(time) && time >= 0))
+    throw new Error("--at must be comma-separated times in seconds, each 0 or more");
+  return times;
+}
 function sampleSnapshotRange([start, end], frames, duration, exclusiveEnd = false) {
   if (!Number.isInteger(frames) || frames < 1)
     throw new Error("--frames must be a positive integer");
@@ -380,7 +387,7 @@ function reviewFrames(plan) {
 }
 var BEAT_SHEET_PAGE = 16;
 async function writeReviewSheets(dir, frames, written) {
-  const { createContactSheet } = await import("./contactSheet-CAGMKI3E.js");
+  const { createContactSheet } = await import("./contactSheet-SZBJDOMT.js");
   const { join: join2 } = await import("path");
   const captured = frames.flatMap((frame) => {
     const path = written(frame);
@@ -461,6 +468,7 @@ var VIDEO_FRAME_EXTRACT_CONCURRENCY = 4;
 function formatSnapshotTimestamp(time) {
   return `${Number(time.toFixed(3))}s`;
 }
+var SNAPSHOT_IMAGE_NAME = /^(?:(?:frame-\d+-|ref-(?:\d+-)?)?at-[\d.]+s\.png|pair-(?:\d+-)?at-[\d.]+s\.jpg|(?:beat-\d+|seam-\d+-\d+)-at-[\d.]+s\.png|(?:contact-sheet|review-beats|review-phone)(?:-\d+)?\.jpg|review-seam-\d+\.jpg)$/;
 function assertDistinctKeepNames(times) {
   const timeByLabel = /* @__PURE__ */ new Map();
   for (const time of times) {
@@ -594,6 +602,7 @@ async function probeContainingSourceFrameSeek(videoPath, time, holdLastFrame) {
     const landed = await landing(candidate.pts);
     if (landed === null) break;
     if (landed <= 0 || landed > frame) continue;
+    if (landed < candidate.pts - 1e-6) return { seek: candidate.pts, select: mid - candidate.pts };
     const again = Math.abs(landed - candidate.pts) < 1e-6 ? landed : await landing(landed);
     if (again !== null && Math.abs(again - landed) < 1e-6)
       return { seek: landed, select: mid - landed };
@@ -696,7 +705,7 @@ function serveCapturePage(projectDir, html, proxy) {
 }
 async function captureSnapshots(projectDir, opts) {
   const log = opts.log ?? ((message) => console.log(message));
-  const { bundleWithLocalizedFonts } = await import("./bundleWithLocalizedFonts-23QDKFSN.js");
+  const { bundleWithLocalizedFonts } = await import("./bundleWithLocalizedFonts-JLB2OYMT.js");
   const capture = await captureArtifactRevision(projectDir).catch(warnSnapshotsNotRecorded);
   const invocation = randomUUID();
   const artifacts = [];
@@ -816,7 +825,7 @@ async function captureSnapshots(projectDir, opts) {
       try {
         const { readdirSync } = await import("fs");
         for (const file of opts.keep ? [] : readdirSync(snapshotDir)) {
-          if (/\.(png|jpg|jpeg)$/i.test(file)) {
+          if (SNAPSHOT_IMAGE_NAME.test(file)) {
             const path = resolve(snapshotDir, file);
             replaced.push(path);
             rmSync(path, { force: true });
@@ -828,7 +837,7 @@ async function captureSnapshots(projectDir, opts) {
       let syncVideoFrameVisibility = null;
       let extractMediaMetadata = null;
       try {
-        const engine = await import("./src-ZOXSEJCD.js");
+        const engine = await import("./src-BH5NICGQ.js");
         injectVideoFramesBatch = engine.injectVideoFramesBatch;
         syncVideoFrameVisibility = engine.syncVideoFrameVisibility;
         extractMediaMetadata = engine.extractMediaMetadata;
@@ -1023,7 +1032,7 @@ async function captureSnapshots(projectDir, opts) {
             const refPath = join(snapshotDir, `ref-${slot}.png`);
             writeCaptureFileSync(refPath, refPng);
             const pairPath = join(snapshotDir, `pair-${slot}.jpg`);
-            const { createContactSheet } = await import("./contactSheet-CAGMKI3E.js");
+            const { createContactSheet } = await import("./contactSheet-SZBJDOMT.js");
             await createContactSheet([framePath, refPath], pairPath, {
               cols: 2,
               maxImages: 2,
@@ -1268,6 +1277,8 @@ var snapshot_default = defineCommand({
     }
     const frames = parseInt(args.frames, 10) || 5;
     const range = args.range === void 0 ? void 0 : parseSnapshotRange(String(args.range));
+    const atTimestamps = args.at === void 0 ? void 0 : parseSnapshotAt(String(args.at));
+    if (args.keep === true && atTimestamps) assertDistinctKeepNames(atTimestamps);
     const composition = args.composition === void 0 ? void 0 : String(args.composition).trim();
     if (composition === "") throw new Error("--composition requires a composition ID");
     const project = resolveProject(args.dir);
@@ -1303,8 +1314,6 @@ var snapshot_default = defineCommand({
       failCommand();
     }
     const timeout = parseInt(args.timeout, 10) || 5e3;
-    const atTimestamps = args.at ? String(args.at).split(",").map((s) => parseFloat(s.trim())).filter((n) => !isNaN(n)) : void 0;
-    if (args.keep === true && atTimestamps) assertDistinctKeepNames(atTimestamps);
     const describeArg = args.describe === void 0 ? "true" : String(args.describe) === "false" ? null : String(args.describe);
     const camera = args.angle ? parseAngle(String(args.angle)) : void 0;
     const zoomTarget = args.zoom ? parseZoomTarget(String(args.zoom)) : void 0;
@@ -1340,11 +1349,8 @@ var snapshot_default = defineCommand({
           log
         });
         const paths = captured.paths;
-        reportArtifacts(
-          "snapshot",
-          "frame",
-          paths.map((path) => resolve(project.dir, path))
-        );
+        const framePaths = paths.map((path) => resolve(project.dir, path));
+        reportArtifacts("snapshot", "frame", framePaths);
         if (paths.length === 0) {
           fail(`
 ${c.error("\u2717")} Could not determine composition duration \u2014 no frames captured`);
@@ -1362,7 +1368,7 @@ ${c.success("\u25C7")}  ${paths.length} snapshots saved to ${snapshotDir}`);
         let contactSheets = [];
         let reviewSheets;
         try {
-          const { createSnapshotContactSheet } = await import("./contactSheet-CAGMKI3E.js");
+          const { createSnapshotContactSheet } = await import("./contactSheet-SZBJDOMT.js");
           if (captured.review) {
             const written = new Map(
               captured.review.frames.map((frame) => [frame.file, frame.path])
@@ -1376,7 +1382,7 @@ ${c.success("\u25C7")}  ${paths.length} snapshots saved to ${snapshotDir}`);
             printReview(captured.review, reviewSheets, log);
           } else if (args.keep !== true) {
             contactSheets = await createSnapshotContactSheet(
-              snapshotDir,
+              framePaths,
               join(snapshotDir, "contact-sheet.jpg")
             );
           }
@@ -1498,6 +1504,7 @@ ${c.error("\u2717")} Snapshot failed: ${msg}`);
   }
 });
 export {
+  SNAPSHOT_IMAGE_NAME,
   computeSnapshotTimes,
   containingSourceFrameIndex,
   snapshot_default as default,
@@ -1505,6 +1512,7 @@ export {
   extractVideoFrameToBuffer,
   formatSnapshotTimestamp,
   parseZoomScale,
+  probeContainingSourceFrameSeek,
   recaptureSnapshotComposite,
   requireSnapshotFfmpeg,
   resolveSnapshotVideoClipStart,