hyperframes 0.8.151 → 0.8.153

package/dist/{catch-up-KVV5X6BF.js → catch-up-WCSN4K4A.js}

@@ -6,7 +6,7 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   resolveProject
-} from "./chunk-KXX6NLOT.js";
+} from "./chunk-JQ57FAYN.js";
 import "./chunk-K2FLNJVB.js";
 import {
   filesChangedSince,
@@ -14,8 +14,8 @@ import {
   readSeen,
   unseenTurns
 } from "./chunk-DCAI5DBR.js";
-import "./chunk-ZD3RDNZI.js";
-import "./chunk-IZ7L6V76.js";
+import "./chunk-CBMZYOWC.js";
+import "./chunk-AUK5QCRH.js";
 import "./chunk-VWG7OQKU.js";
 import "./chunk-XBSPQ52S.js";
 import {
@@ -30,7 +30,7 @@ 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-EOVYQ3IG.js";
 import "./chunk-AMKC3AXA.js";
 import "./chunk-JYVGYKXG.js";

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

@@ -5,18 +5,27 @@ 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 {
+  withRemainingBudget
+} from "./chunk-AWNBM3MZ.js";
+import {
+  checkSnapshotDirectory,
   rectToBbox
-} from "./chunk-WBLXWOYK.js";
+} from "./chunk-XSEGMQYA.js";
+import {
+  captureArtifactRevision
+} from "./chunk-3DMR7RF6.js";
+import "./chunk-ZQMYD22O.js";
 import {
   loadProducer
-} from "./chunk-POEEDPJI.js";
+} from "./chunk-5ZGSN5YK.js";
 import {
   trackLintRun
-} from "./chunk-L6RIMCMG.js";
+} from "./chunk-T2Y2WC5I.js";
 import {
   assertionTargets,
   buildLayoutSampleTimes,
@@ -35,46 +44,52 @@ import {
   mergeSampleTimes,
   parseAt,
   readMotionSpec
-} from "./chunk-RJRGR5KF.js";
-import "./chunk-L3N7RJHS.js";
+} from "./chunk-UNOALNYO.js";
+import "./chunk-7NKLNOHW.js";
 import "./chunk-XUHOIDKG.js";
-import "./chunk-QLGBNGXC.js";
+import "./chunk-TCJM3KF2.js";
 import "./chunk-X7MTZ4T2.js";
-import "./chunk-RYL6ZIJP.js";
+import "./chunk-OIONMNWN.js";
 import "./chunk-FH7WODJH.js";
-import "./chunk-RRBKEHST.js";
-import "./chunk-HVXRYMGQ.js";
+import {
+  BrowserCleanupError,
+  closeManagedBrowser
+} from "./chunk-KFBEMIMD.js";
+import "./chunk-TXWPPBIW.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-5FS4HCHN.js";
+import "./chunk-WQMTHPTK.js";
+import "./chunk-C6TPGUWD.js";
+import {
+  recordArtifacts
+} from "./chunk-7FYFEXD2.js";
+import "./chunk-PVGDU7SE.js";
+import "./chunk-FFDC5OWV.js";
 import {
   resolveProject
-} from "./chunk-KXX6NLOT.js";
+} from "./chunk-JQ57FAYN.js";
 import "./chunk-K2FLNJVB.js";
+import "./chunk-DQBY7FRR.js";
 import {
   resolveLocalBrowserGpuMode
-} from "./chunk-ZGCRVM5M.js";
+} from "./chunk-DAKXCEE3.js";
 import "./chunk-442JNXRM.js";
-import "./chunk-FAIYEIZ4.js";
+import "./chunk-YYMJEQ4D.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-PXOFFSO3.js";
+import "./chunk-HGAOO43L.js";
+import "./chunk-2XEBNYG5.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-CBMZYOWC.js";
+import "./chunk-AUK5QCRH.js";
 import "./chunk-VWG7OQKU.js";
 import "./chunk-XBSPQ52S.js";
 import {
@@ -98,26 +113,26 @@ import "./chunk-TJSTGSAW.js";
 import "./chunk-Q5X2B5WT.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 "./chunk-EOVYQ3IG.js";
 import "./chunk-AMKC3AXA.js";
 import {
   extractMediaMetadata,
   findHdrAutoPromotion
-} 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 "./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";
@@ -127,16 +142,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 +160,100 @@ 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/checkDeadline.ts
+var CHECK_DEADLINE_MS = 12e4;
+var SCRIPT_START = "[hyperframes:script:start] ";
+var SCRIPT_FINISH = "[hyperframes:script:finish] ";
+var CheckDeadlineError = class extends Error {
+  constructor(sourceFile) {
+    super(
+      sourceFile === void 0 ? "Check did not finish within its deadline." : `${sourceFile}: its script did not finish within the check deadline.`
+    );
+    this.sourceFile = sourceFile;
+  }
+  sourceFile;
+};
+var CheckDeadline = class {
+  abort = new AbortController();
+  operations = /* @__PURE__ */ new Set();
+  signal = this.abort.signal;
+  browsers = /* @__PURE__ */ new Set();
+  scripts = [];
+  expired;
+  timer;
+  expiry;
+  rejectExpiry;
+  phase = "waiting";
+  constructor() {
+    this.expiry = new Promise((_, reject) => {
+      this.rejectExpiry = reject;
+    });
+  }
+  start = () => {
+    if (this.phase !== "waiting") return;
+    this.phase = "started";
+    this.timer = setTimeout(() => {
+      this.expired = new CheckDeadlineError(this.scripts.at(-1));
+      this.rejectExpiry(this.expired);
+      this.abort.abort(this.expired);
+    }, CHECK_DEADLINE_MS);
+  };
+  ownBrowser = (browser) => {
+    if (this.expired) throw this.expired;
+    if (this.phase === "closed") throw new Error("Check has already finished.");
+    this.browsers.add(browser);
+  };
+  async preparePage(page) {
+    page.on("console", (message) => {
+      const text = message.text();
+      if (text.startsWith(SCRIPT_START)) this.scripts.push(text.slice(SCRIPT_START.length));
+      if (text.startsWith(SCRIPT_FINISH)) {
+        const index = this.scripts.lastIndexOf(text.slice(SCRIPT_FINISH.length));
+        if (index !== -1) this.scripts.splice(index, 1);
+      }
+    });
+    await page.evaluateOnNewDocument(
+      (start, finish) => {
+        Reflect.set(window, "__hfScriptState", (phase, source) => {
+          console.debug((phase === "start" ? start : finish) + source);
+        });
+      },
+      SCRIPT_START,
+      SCRIPT_FINISH
+    );
+  }
+  run(operation) {
+    if (this.expired) return Promise.reject(this.expired);
+    const pending = operation();
+    this.operations.add(pending);
+    return Promise.race([pending, this.expiry]);
+  }
+  async close() {
+    this.phase = "closed";
+    clearTimeout(this.timer);
+    const closes = await Promise.allSettled([...this.browsers].map(closeManagedBrowser));
+    const errors = closes.filter((entry) => entry.status === "rejected").map((entry) => entry.reason);
+    try {
+      const drained = await withRemainingBudget(
+        Promise.allSettled(this.operations),
+        1e3,
+        "draining check cleanup"
+      );
+      for (const entry of drained) {
+        if (entry.status === "rejected" && entry.reason instanceof BrowserCleanupError)
+          errors.push(entry.reason);
+      }
+    } catch (error) {
+      errors.push(error);
+    }
+    if (errors.length > 0)
+      throw new BrowserCleanupError(errors, errors.map(normalizeErrorMessage).join("; "));
+  }
+};
 
 // src/utils/checkPipeline.ts
 import { mkdirSync, writeFileSync } from "fs";
@@ -153,7 +261,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-WHUQZITN.js");
   return bundleToSingleHtml(projectDir);
 }
 async function collectBundledRenderMedia(html) {
@@ -1034,25 +1142,57 @@ async function runCheckPipeline(project, options, dependencies = DEFAULT_DEPENDE
       relative(project.dir, motion.path) || "index.motion.json"
     )
   ] : [];
-  let browser;
+  const deadline = new CheckDeadline();
+  let outcome;
   try {
-    browser = await dependencies.runBrowserCheck(project, options, motion);
+    let browser;
+    try {
+      browser = await deadline.run(
+        () => dependencies.runBrowserCheck(project, options, motion, deadline)
+      );
+    } catch (error) {
+      browser = emptyBrowserResult();
+      browser.runtimeFindings.push(runtimeFailure(error));
+    }
+    const snapshotFiles = options.snapshots ? await writeContrastSnapshots(dependencies, project.dir, browser) : [];
+    const report = buildReport(
+      options,
+      lint,
+      browser,
+      motion,
+      specFindings,
+      snapshotFiles,
+      hdrPromotion,
+      hdrInspection
+    );
+    outcome = {
+      kind: "report",
+      report: options.snapshots ? await withFindingCrops(dependencies, project, options, report, deadline) : report
+    };
   } catch (error) {
-    browser = emptyBrowserResult();
-    browser.runtimeFindings.push(runtimeFailure(error));
+    outcome = { kind: "failed", error };
   }
-  const snapshotFiles = options.snapshots ? await writeContrastSnapshots(dependencies, project.dir, browser) : [];
-  const report = buildReport(
-    options,
-    lint,
-    browser,
-    motion,
-    specFindings,
-    snapshotFiles,
-    hdrPromotion,
-    hdrInspection
-  );
-  return options.snapshots ? await withFindingCrops(dependencies, project, options, report) : report;
+  try {
+    await deadline.close();
+  } catch (error) {
+    if (outcome.kind === "failed") {
+      throw new BrowserCleanupError(
+        [outcome.error, error],
+        `${normalizeErrorMessage(outcome.error)}; ${normalizeErrorMessage(error)}`
+      );
+    }
+    const report = outcome.report;
+    return {
+      ...report,
+      ok: false,
+      runtime: section([
+        ...report.runtime.findings,
+        runtimeFailure(error, "check_cleanup_failure")
+      ])
+    };
+  }
+  if (outcome.kind === "failed") throw outcome.error;
+  return outcome.report;
 }
 async function writeContrastSnapshots(dependencies, projectDir, browser) {
   const files = [];
@@ -1067,13 +1207,19 @@ async function writeContrastSnapshots(dependencies, projectDir, browser) {
   }
   return files;
 }
-async function withFindingCrops(dependencies, project, options, report) {
+async function withFindingCrops(dependencies, project, options, report, deadline) {
   const cropRequests = selectFindingCropRequests(report);
   if (cropRequests.length === 0) return report;
   try {
-    const findingFiles = await dependencies.captureFindingCrops(project, options, cropRequests);
+    const findingFiles = await deadline.run(
+      () => dependencies.captureFindingCrops(project, options, cropRequests, deadline)
+    );
     return { ...report, snapshots: { ...report.snapshots, findingFiles } };
   } catch (error) {
+    if (error instanceof CheckDeadlineError) {
+      const finding = runtimeFailure(error);
+      return { ...report, ok: false, runtime: section([...report.runtime.findings, finding]) };
+    }
     console.error("   finding crops skipped: " + normalizeErrorMessage(error));
     trackCommandFailure("check-finding-crops", error);
     return report;
@@ -1351,7 +1497,12 @@ function emptyBrowserResult() {
   };
 }
 function runtimeFailure(error, code = "check_runtime_failure") {
-  return findingAtRoot(code, "error", normalizeErrorMessage(error), "index.html");
+  return findingAtRoot(
+    code,
+    "error",
+    normalizeErrorMessage(error),
+    error instanceof CheckDeadlineError ? error.sourceFile ?? "index.html" : "index.html"
+  );
 }
 function findingAtRoot(code, severity, message, sourceFile) {
   return {
@@ -1389,21 +1540,21 @@ function resolveMotionSpec(projectDir) {
     message: `Invalid motion spec ${path}: ${result.errors.join("; ")}`
   };
 }
-async function runBrowserCheck(project, options, motion) {
-  const module = await import("./checkBrowser-PRDR6XBY.js");
-  return module.runBrowserCheck(project, options, motion, runAuditGrid);
+async function runBrowserCheck(project, options, motion, deadline) {
+  const module = await import("./checkBrowser-73SOMDG3.js");
+  return module.runBrowserCheck(project, options, motion, runAuditGrid, deadline);
 }
 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");
-  return module.captureFindingCrops(project, options, requests);
+async function captureFindingCrops(project, options, requests, deadline) {
+  const module = await import("./checkBrowser-73SOMDG3.js");
+  return module.captureFindingCrops(project, options, requests, deadline);
 }
 var DEFAULT_DEPENDENCIES2 = {
   lintProject,
@@ -1424,14 +1575,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 +1725,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 +1766,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) {