hyperframes 0.8.151 → 0.8.152

package/dist/{check-6KQ433E6.js → check-NUZ62LIW.js}

@@ -5,18 +5,24 @@ var require = __hf_createRequire(import.meta.url);
 var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
+  pngDimensions,
   reportArtifacts,
   withProjectLock
-} from "./chunk-DHPFXAUF.js";
+} from "./chunk-57GN6KWT.js";
 import {
+  checkSnapshotDirectory,
   rectToBbox
-} from "./chunk-WBLXWOYK.js";
+} from "./chunk-XSEGMQYA.js";
+import {
+  captureArtifactRevision
+} from "./chunk-KCFF4ENE.js";
+import "./chunk-7TASSBN2.js";
 import {
   loadProducer
-} from "./chunk-POEEDPJI.js";
+} from "./chunk-3E4OCOC5.js";
 import {
   trackLintRun
-} from "./chunk-L6RIMCMG.js";
+} from "./chunk-3DZBQ7MH.js";
 import {
   assertionTargets,
   buildLayoutSampleTimes,
@@ -35,46 +41,49 @@ import {
   mergeSampleTimes,
   parseAt,
   readMotionSpec
-} from "./chunk-RJRGR5KF.js";
-import "./chunk-L3N7RJHS.js";
+} from "./chunk-BYJYQWEX.js";
+import "./chunk-GQETH4PE.js";
 import "./chunk-XUHOIDKG.js";
-import "./chunk-QLGBNGXC.js";
+import "./chunk-XEFFJRYX.js";
 import "./chunk-X7MTZ4T2.js";
-import "./chunk-RYL6ZIJP.js";
+import "./chunk-SWCSL6WS.js";
 import "./chunk-FH7WODJH.js";
-import "./chunk-RRBKEHST.js";
-import "./chunk-HVXRYMGQ.js";
+import "./chunk-4UMKAUZI.js";
+import "./chunk-PKO2EWO7.js";
 import "./chunk-WPNE5NEP.js";
-import "./chunk-BRF3O35X.js";
-import "./chunk-XNDXENJQ.js";
-import "./chunk-FJWEYVEM.js";
-import "./chunk-XXPYZBZ3.js";
-import "./chunk-3ZPFRDEJ.js";
-import "./chunk-AIJS74LG.js";
+import "./chunk-HBCRRCTX.js";
+import "./chunk-PRXAOZWZ.js";
+import "./chunk-C6TPGUWD.js";
+import {
+  recordArtifacts
+} from "./chunk-7FYFEXD2.js";
+import "./chunk-XINGD6MS.js";
+import "./chunk-FFDC5OWV.js";
 import {
   resolveProject
-} from "./chunk-KXX6NLOT.js";
+} from "./chunk-IBYC3VUA.js";
 import "./chunk-K2FLNJVB.js";
+import "./chunk-DQBY7FRR.js";
 import {
   resolveLocalBrowserGpuMode
-} from "./chunk-ZGCRVM5M.js";
+} from "./chunk-EVTHG34H.js";
 import "./chunk-442JNXRM.js";
-import "./chunk-FAIYEIZ4.js";
+import "./chunk-D6RJXQLD.js";
 import "./chunk-XT7X6QCP.js";
 import "./chunk-4YYJOFKS.js";
 import "./chunk-HVW7ABXD.js";
-import "./chunk-XGLNQDLN.js";
-import "./chunk-N4IXP3MY.js";
-import "./chunk-YZTVHRJ2.js";
+import "./chunk-QESSGUKX.js";
+import "./chunk-6Z4YJ5Q3.js";
+import "./chunk-3HPJM5IQ.js";
 import "./chunk-AWDFDFI3.js";
 import "./chunk-P6LJ4Y32.js";
 import "./chunk-GMECXFAN.js";
-import "./chunk-374QQGBQ.js";
+import "./chunk-5CS4T6C6.js";
 import {
   trackCheckReport,
   trackCommandFailure
-} from "./chunk-ZD3RDNZI.js";
-import "./chunk-IZ7L6V76.js";
+} from "./chunk-H2SGM2V2.js";
+import "./chunk-KZ3L3W4Q.js";
 import "./chunk-VWG7OQKU.js";
 import "./chunk-XBSPQ52S.js";
 import {
@@ -98,26 +107,26 @@ import "./chunk-TJSTGSAW.js";
 import "./chunk-Q5X2B5WT.js";
 import {
   withMeta
-} from "./chunk-35PWWBGZ.js";
+} from "./chunk-YYEYOFHW.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-TCWMDCBX.js";
+import "./chunk-IZIRIDJH.js";
 import "./chunk-EOVYQ3IG.js";
 import "./chunk-AMKC3AXA.js";
 import {
   extractMediaMetadata,
   findHdrAutoPromotion
-} from "./chunk-IZPN423R.js";
-import "./chunk-3SVC7SW4.js";
+} from "./chunk-EXH6L2XZ.js";
+import "./chunk-RN5I2DP5.js";
 import "./chunk-NE55C6S5.js";
 import "./chunk-JYVGYKXG.js";
-import "./chunk-XQKVEQNY.js";
-import "./chunk-QBYHNRHU.js";
+import "./chunk-5ERVRJMV.js";
+import "./chunk-S3RCK56N.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";
@@ -127,16 +136,16 @@ import "./chunk-TWWSYAKJ.js";
 import {
   lintProject,
   shouldBlockRender
-} from "./chunk-GNTVYF7E.js";
+} from "./chunk-YOEGUBBY.js";
 import {
   resolveProjectRelativeSrc
 } 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
@@ -145,7 +154,9 @@ import "./chunk-3GXQPCJC.js";
 import "./chunk-M2WBOQ2Q.js";
 
 // src/commands/check.ts
-import { resolve } from "path";
+import { randomUUID } from "crypto";
+import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
+import { join as join2, resolve } from "path";
 
 // src/utils/checkPipeline.ts
 import { mkdirSync, writeFileSync } from "fs";
@@ -153,7 +164,7 @@ import { join, relative } from "path";
 
 // src/utils/hdrPromotion.ts
 async function bundleProjectHtml(projectDir) {
-  const { bundleToSingleHtml } = await import("./compiler-ZXT27Z62.js");
+  const { bundleToSingleHtml } = await import("./compiler-NCN6PTVH.js");
   return bundleToSingleHtml(projectDir);
 }
 async function collectBundledRenderMedia(html) {
@@ -1390,19 +1401,19 @@ function resolveMotionSpec(projectDir) {
   };
 }
 async function runBrowserCheck(project, options, motion) {
-  const module = await import("./checkBrowser-PRDR6XBY.js");
+  const module = await import("./checkBrowser-MSTVEL4V.js");
   return module.runBrowserCheck(project, options, motion, runAuditGrid);
 }
 async function writeSnapshot(projectDir, index, time, pngBase64) {
-  const snapshotDir = join(projectDir, "snapshots");
+  const snapshotDir = checkSnapshotDirectory(projectDir);
   mkdirSync(snapshotDir, { recursive: true });
   const filename = `frame-${String(index).padStart(2, "0")}-at-${time.toFixed(1)}s.png`;
   const path = join(snapshotDir, filename);
   writeFileSync(path, Buffer.from(pngBase64, "base64"));
-  return join("snapshots", filename);
+  return relative(projectDir, path);
 }
 async function captureFindingCrops(project, options, requests) {
-  const module = await import("./checkBrowser-PRDR6XBY.js");
+  const module = await import("./checkBrowser-MSTVEL4V.js");
   return module.captureFindingCrops(project, options, requests);
 }
 var DEFAULT_DEPENDENCIES2 = {
@@ -1424,14 +1435,85 @@ var examples = [
 var DEFAULT_COMMAND_DEPENDENCIES = {
   resolveProject,
   async runPipeline(project, options) {
+    const capture = await captureArtifactRevision(project.dir).catch(warnNotRecorded);
     const report = await runCheckPipeline(project, options);
     const images = (files) => files.map((file) => resolve(project.dir, file));
     reportArtifacts("check", "frame", images(report.snapshots.files));
     reportArtifacts("check", "finding", images(report.snapshots.findingFiles));
-    return report;
+    if (!capture) return report;
+    try {
+      return { ...report, saved: await saveCheckReport(project, options, report, capture) };
+    } catch (error) {
+      warnNotRecorded(error);
+      return report;
+    }
   },
   withMeta
 };
+function warnNotRecorded(error) {
+  console.warn(`${c.warn("\u26A0")}  Check report was not recorded: ${normalizeErrorMessage(error)}`);
+  return void 0;
+}
+async function saveCheckReport(project, options, report, capture) {
+  const id = randomUUID();
+  const directory = join2(project.dir, ".hyperframes", "artifacts", "checks");
+  mkdirSync2(directory, { recursive: true });
+  const path = join2(directory, `${id}.json`);
+  writeFileSync2(path, JSON.stringify(report, null, 2) + "\n", { flag: "wx" });
+  const reportScope = "scope" in report && typeof report.scope === "object" && report.scope !== null ? report.scope : void 0;
+  const artifacts = [
+    {
+      kind: "check",
+      id,
+      scope: reportScope ? "scoped" : "project",
+      report: resolve(path),
+      metadata: {
+        ok: report.ok,
+        browserSkipped: report.browserSkipped,
+        scope: reportScope,
+        options
+      }
+    }
+  ];
+  for (const [index, image] of report.snapshots.files.entries()) {
+    artifacts.push({
+      kind: "snapshot",
+      id: `${id}-${index}`,
+      scope: "full",
+      image: resolve(project.dir, image),
+      time: report.snapshots.times[index],
+      metadata: {
+        checkId: id,
+        ...pngDimensions(resolve(project.dir, image))
+      }
+    });
+  }
+  const crops = selectFindingCropRequests(report);
+  for (const [index, image] of report.snapshots.findingFiles.entries()) {
+    const crop = crops.find((request) => image.endsWith(request.filename));
+    artifacts.push({
+      kind: "snapshot",
+      id: `${id}-crop-${index}`,
+      scope: "finding",
+      image: resolve(project.dir, image),
+      time: crop?.time,
+      metadata: {
+        checkId: id,
+        finding: crop,
+        ...pngDimensions(resolve(project.dir, image))
+      }
+    });
+  }
+  const [saved] = await recordArtifacts(project.dir, capture, artifacts);
+  if (!saved) throw new Error("no history record was written");
+  reportArtifacts("check", "check-report", [resolve(path)]);
+  return {
+    id: saved.id,
+    revision: saved.revision,
+    report: saved.report,
+    attribution: saved.attribution
+  };
+}
 var CHECK_COMMAND_ARGS = {
   dir: { type: "positional", description: "Project directory", required: false },
   json: { type: "boolean", description: "Output agent-readable JSON", default: false },
@@ -1503,7 +1585,7 @@ var CHECK_COMMAND_ARGS = {
   },
   snapshots: {
     type: "boolean",
-    description: "Save the five contrast-pass PNGs under snapshots/",
+    description: "Save contrast-pass PNGs under .hyperframes/artifacts/snapshots/",
     default: false
   },
   "caption-zone": {
@@ -1544,6 +1626,12 @@ function createCheckCommand(dependencies = DEFAULT_COMMAND_DEPENDENCIES) {
           console.log(JSON.stringify(dependencies.withMeta(report), null, 2));
         } else {
           printHumanReport(report);
+          if (report.saved) {
+            console.log(`Report: ${report.saved.report}`);
+            console.log(
+              `Revision: ${report.saved.revision ?? "none"} (${report.saved.attribution})`
+            );
+          }
         }
         setCommandExitCode(checkExitCode(report));
       } catch (error) {

package/dist/{checkBrowser-PRDR6XBY.js → checkBrowser-MSTVEL4V.js}

@@ -8,19 +8,20 @@ import {
   auditClipDurations,
   shouldIgnoreHttpError,
   shouldIgnoreRequestFailure
-} from "./chunk-IP73NMQT.js";
+} from "./chunk-ANS56TPS.js";
 import {
+  checkSnapshotDirectory,
   rectToBbox
-} from "./chunk-WBLXWOYK.js";
+} from "./chunk-XSEGMQYA.js";
 import {
   ambiguousIssue,
   loadBrowserScript
-} from "./chunk-RJRGR5KF.js";
+} from "./chunk-BYJYQWEX.js";
 import {
   serveStaticProjectHtml
-} from "./chunk-L3N7RJHS.js";
+} from "./chunk-GQETH4PE.js";
 import "./chunk-XUHOIDKG.js";
-import "./chunk-QLGBNGXC.js";
+import "./chunk-XEFFJRYX.js";
 import "./chunk-X7MTZ4T2.js";
 import {
   AUDIT_SEEK_OPTIONS,
@@ -33,42 +34,42 @@ import {
   resolveCliChromeGpuMode,
   seekCompositionTimeline,
   waitForPreferredSeekTarget
-} from "./chunk-RYL6ZIJP.js";
+} from "./chunk-SWCSL6WS.js";
 import "./chunk-FH7WODJH.js";
-import "./chunk-RRBKEHST.js";
-import "./chunk-HVXRYMGQ.js";
+import "./chunk-4UMKAUZI.js";
+import "./chunk-PKO2EWO7.js";
 import "./chunk-WPNE5NEP.js";
-import "./chunk-BRF3O35X.js";
-import "./chunk-XNDXENJQ.js";
-import "./chunk-FJWEYVEM.js";
-import "./chunk-XXPYZBZ3.js";
+import "./chunk-HBCRRCTX.js";
+import "./chunk-PRXAOZWZ.js";
+import "./chunk-C6TPGUWD.js";
+import "./chunk-7FYFEXD2.js";
 import {
   FfmpegUnavailableError,
   decideMediaProxyEligibility,
   proxyVariantFor,
   resolveProxies,
   scanProjectMediaCodecMap
-} from "./chunk-3ZPFRDEJ.js";
-import "./chunk-AIJS74LG.js";
-import "./chunk-KXX6NLOT.js";
+} from "./chunk-XINGD6MS.js";
+import "./chunk-FFDC5OWV.js";
+import "./chunk-IBYC3VUA.js";
 import "./chunk-K2FLNJVB.js";
-import "./chunk-ZGCRVM5M.js";
+import "./chunk-EVTHG34H.js";
 import "./chunk-442JNXRM.js";
 import {
   resolveAutoProxy
-} from "./chunk-FAIYEIZ4.js";
+} from "./chunk-D6RJXQLD.js";
 import "./chunk-XT7X6QCP.js";
 import "./chunk-4YYJOFKS.js";
 import "./chunk-HVW7ABXD.js";
-import "./chunk-XGLNQDLN.js";
-import "./chunk-N4IXP3MY.js";
-import "./chunk-YZTVHRJ2.js";
+import "./chunk-QESSGUKX.js";
+import "./chunk-6Z4YJ5Q3.js";
+import "./chunk-3HPJM5IQ.js";
 import "./chunk-AWDFDFI3.js";
 import "./chunk-P6LJ4Y32.js";
 import "./chunk-GMECXFAN.js";
-import "./chunk-374QQGBQ.js";
-import "./chunk-ZD3RDNZI.js";
-import "./chunk-IZ7L6V76.js";
+import "./chunk-5CS4T6C6.js";
+import "./chunk-H2SGM2V2.js";
+import "./chunk-KZ3L3W4Q.js";
 import "./chunk-VWG7OQKU.js";
 import "./chunk-XBSPQ52S.js";
 import "./chunk-S3S4TGEH.js";
@@ -77,37 +78,37 @@ import "./chunk-PBN6GBJE.js";
 import "./chunk-ZTZA4UWZ.js";
 import "./chunk-EOOEC32M.js";
 import "./chunk-TJSTGSAW.js";
-import "./chunk-35PWWBGZ.js";
+import "./chunk-YYEYOFHW.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-TCWMDCBX.js";
+import "./chunk-IZIRIDJH.js";
 import "./chunk-EOVYQ3IG.js";
 import "./chunk-AMKC3AXA.js";
-import "./chunk-IZPN423R.js";
-import "./chunk-3SVC7SW4.js";
+import "./chunk-EXH6L2XZ.js";
+import "./chunk-RN5I2DP5.js";
 import "./chunk-NE55C6S5.js";
 import "./chunk-JYVGYKXG.js";
-import "./chunk-XQKVEQNY.js";
-import "./chunk-QBYHNRHU.js";
+import "./chunk-5ERVRJMV.js";
+import "./chunk-S3RCK56N.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";
 import "./chunk-FXMKHHPO.js";
 import "./chunk-RQVDTPGD.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 {
   normalizeErrorMessage
@@ -284,7 +285,7 @@ function proxyFailedDraft(message) {
   return { code: "media_proxy_failed", severity: "warning", message, time: 0 };
 }
 async function runBrowserCheck(project, options, motion, runGrid) {
-  const { bundleWithLocalizedFonts } = await import("./bundleWithLocalizedFonts-26MXQOZG.js");
+  const { bundleWithLocalizedFonts } = await import("./bundleWithLocalizedFonts-76DMCRIW.js");
   const html = await bundleWithLocalizedFonts(project.dir);
   const { findings: drafts, failedPaths } = await preResolveHostileMediaProxies(
     project.dir,
@@ -314,7 +315,7 @@ async function runBrowserCheck(project, options, motion, runGrid) {
     await waitForPreferredSeekTarget(page);
     const rootAnchor = await resolveRootAnchor(page);
     const launchSettleMs = Date.now() - launchSettleStart;
-    const { analyzeClipMediaFit } = await import("./src-2NN2WB6X.js");
+    const { analyzeClipMediaFit } = await import("./src-AVQBAECC.js");
     for (const entry of await auditClipDurations(page, analyzeClipMediaFit, options.timeout)) {
       drafts.push({ code: "clip_media_fit", severity: entry.level, message: entry.text, time: 0 });
     }
@@ -342,7 +343,7 @@ async function runBrowserCheck(project, options, motion, runGrid) {
 }
 async function captureFindingCrops(project, options, requests) {
   if (requests.length === 0) return [];
-  const { bundleWithLocalizedFonts } = await import("./bundleWithLocalizedFonts-26MXQOZG.js");
+  const { bundleWithLocalizedFonts } = await import("./bundleWithLocalizedFonts-76DMCRIW.js");
   const html = await bundleWithLocalizedFonts(project.dir);
   const server = await serveStaticProjectHtml(
     project.dir,
@@ -363,7 +364,7 @@ async function captureFindingCrops(project, options, requests) {
     chromeBrowser = session.browser;
     const page = session.page;
     await waitForPreferredSeekTarget(page);
-    const snapshotDir = join(project.dir, "snapshots");
+    const snapshotDir = checkSnapshotDirectory(project.dir);
     mkdirSync(snapshotDir, { recursive: true });
     for (const request of requests) {
       await seekCompositionTimeline(page, request.time, AUDIT_SEEK_OPTIONS);
@@ -374,7 +375,7 @@ async function captureFindingCrops(project, options, requests) {
       const region = padCropRegion(request.bbox, canvas, DEFAULT_ZOOM_PADDING_PX);
       const buffer = await captureRegionCrop(page, region, DEFAULT_ZOOM_SCALE);
       writeFileSync(join(snapshotDir, request.filename), buffer);
-      written.push(join("snapshots", request.filename));
+      written.push(join(snapshotDir, request.filename));
     }
     return written;
   } finally {

package/dist/{chunk-L6RIMCMG.js → chunk-3DZBQ7MH.js}

@@ -7,14 +7,14 @@ var __dirname = __hf_dirname(__filename);
 import {
   trackLintReport,
   trackLintRuleStreak
-} from "./chunk-ZD3RDNZI.js";
+} from "./chunk-H2SGM2V2.js";
 import {
   shouldTrack
-} from "./chunk-IZ7L6V76.js";
+} from "./chunk-KZ3L3W4Q.js";
 import {
   LINT_RULE_COUNT,
   LINT_RULE_GROUP_COUNTS
-} from "./chunk-GNTVYF7E.js";
+} from "./chunk-YOEGUBBY.js";
 
 // src/telemetry/lintStreaks.ts
 import { createHash } from "crypto";

package/dist/{chunk-POEEDPJI.js → chunk-3E4OCOC5.js}

@@ -7,7 +7,7 @@ var __dirname = __hf_dirname(__filename);
 
 // src/utils/producer.ts
 async function loadProducer() {
-  return await import("./src-OLBDPEG6.js");
+  return await import("./src-V7263E47.js");
 }
 
 export {

package/dist/{chunk-YZTVHRJ2.js → chunk-3HPJM5IQ.js}

@@ -27,7 +27,7 @@ import {
 } from "./chunk-GMECXFAN.js";
 import {
   ITEM_TYPE_DIRS
-} from "./chunk-XQKVEQNY.js";
+} from "./chunk-5ERVRJMV.js";
 import {
   realProjectRoot
 } from "./chunk-OFQWTKPW.js";

package/dist/{chunk-OZ4K46OV.js → chunk-3LO7BBJX.js}

@@ -7,10 +7,10 @@ var __dirname = __hf_dirname(__filename);
 import {
   parseFeedbackRating,
   trackRenderFeedback
-} from "./chunk-ZD3RDNZI.js";
+} from "./chunk-H2SGM2V2.js";
 import {
   shouldTrack
-} from "./chunk-IZ7L6V76.js";
+} from "./chunk-KZ3L3W4Q.js";
 import {
   detectAgentRuntime
 } from "./chunk-XBSPQ52S.js";

package/dist/{chunk-APDLWWFG.js → chunk-3VGU2SH7.js}

@@ -7,7 +7,7 @@ var __dirname = __hf_dirname(__filename);
 import {
   parse,
   simple
-} from "./chunk-2PSPARWP.js";
+} from "./chunk-TYXH3EKP.js";
 
 // ../parsers/dist/composition.js
 var CANVAS_DIMENSIONS = {

package/dist/{chunk-RRBKEHST.js → chunk-4UMKAUZI.js}

@@ -6,7 +6,7 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   resolveCaptureBrowserGpuMode
-} from "./chunk-ZGCRVM5M.js";
+} from "./chunk-EVTHG34H.js";
 import {
   requestCliExit
 } from "./chunk-PBN6GBJE.js";

package/dist/{chunk-DHPFXAUF.js → chunk-57GN6KWT.js}

@@ -5,6 +5,18 @@ var require = __hf_createRequire(import.meta.url);
 var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 
+// src/utils/pngDimensions.ts
+import { readFileSync } from "fs";
+function pngDimensions(path) {
+  try {
+    const png = readFileSync(path);
+    if (png.length < 24) return {};
+    return { width: png.readUInt32BE(16), height: png.readUInt32BE(20) };
+  } catch {
+    return {};
+  }
+}
+
 // src/utils/toolContext.ts
 import { appendFileSync } from "fs";
 import { extname, isAbsolute, resolve } from "path";
@@ -39,7 +51,8 @@ function readToolContext(raw = process.env.HF_TOOL_CONTEXT) {
 var MEDIA_TYPES = {
   ".png": "image/png",
   ".jpg": "image/jpeg",
-  ".jpeg": "image/jpeg"
+  ".jpeg": "image/jpeg",
+  ".json": "application/json"
 };
 function reportArtifacts(command, role, paths, context = readToolContext()) {
   if (!context.events || paths.length === 0) return;
@@ -65,7 +78,7 @@ function reportArtifacts(command, role, paths, context = readToolContext()) {
 }
 
 // src/utils/projectLock.ts
-import { linkSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "fs";
+import { linkSync, mkdirSync, readFileSync as readFileSync2, unlinkSync, writeFileSync } from "fs";
 import { dirname, join } from "path";
 import { setTimeout as sleep } from "timers/promises";
 var ProjectLockTimeout = class extends Error {
@@ -74,7 +87,7 @@ var POLL_MS = 250;
 var projectLockPath = (projectDir) => join(projectDir, ".hyperframes", "project.lock");
 function readHolder(path) {
   try {
-    return JSON.parse(readFileSync(path, "utf8"));
+    return JSON.parse(readFileSync2(path, "utf8"));
   } catch {
     return null;
   }
@@ -160,6 +173,7 @@ async function withProjectLock(projectDir, command, run, context = readToolConte
 }
 
 export {
+  pngDimensions,
   reportArtifacts,
   withProjectLock
 };