@reconcrap/boss-recommend-mcp 1.3.39 → 2.0.0

package/vendor/boss-recommend-screen-cli/scripts/capture-full-resume-canvas.cjs

@@ -1,817 +0,0 @@
-#!/usr/bin/env node
-const fs = require("node:fs");
-const path = require("node:path");
-const http = require("node:http");
-const { spawnSync } = require("node:child_process");
-const WebSocket = require("ws");
-let sharpFactory = null;
-
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
-function shouldBringChromeToFront() {
-  const envValue = String(process.env.BOSS_RECOMMEND_BRING_TO_FRONT || "").trim().toLowerCase();
-  if (envValue) {
-    if (["1", "true", "yes", "y", "on"].includes(envValue)) return true;
-    if (["0", "false", "no", "n", "off"].includes(envValue)) return false;
-  }
-  return false;
-}
-
-const SHOULD_BRING_TO_FRONT = shouldBringChromeToFront();
-
-const EARLY_FAIL_NO_RESUME_IFRAME_MIN_WAIT_MS = 5000;
-const EARLY_FAIL_NO_RESUME_IFRAME_STABLE_POLLS = 4;
-const RESUME_VIEWPORT_STABILITY_POLL_MS = 80;
-const RESUME_VIEWPORT_STABLE_POLLS = 2;
-
-function clampInteger(value, low, high) {
-  return Math.max(low, Math.min(high, value));
-}
-
-function loadSharp() {
-  if (!sharpFactory) {
-    sharpFactory = require("sharp");
-  }
-  return sharpFactory;
-}
-
-function getJson(url) {
-  return new Promise((resolve, reject) => {
-    http
-      .get(url, (res) => {
-        let data = "";
-        res.on("data", (chunk) => {
-          data += chunk;
-        });
-        res.on("end", () => {
-          try {
-            resolve(JSON.parse(data));
-          } catch (error) {
-            reject(new Error(`Parse JSON failed for ${url}: ${error.message}`));
-          }
-        });
-      })
-      .on("error", reject);
-  });
-}
-
-function pickTarget(targets, targetPattern) {
-  const pages = targets.filter((item) => item.type === "page");
-  if (!pages.length) return null;
-  return (
-    pages.find((item) => typeof item.url === "string" && item.url.includes(targetPattern))
-    || pages.find((item) => /zhipin\.com/i.test(item.url || ""))
-    || pages[0]
-  );
-}
-
-function oneLineJson(value, maxLength = 1200) {
-  try {
-    const text = JSON.stringify(value);
-    if (text.length <= maxLength) return text;
-    return `${text.slice(0, maxLength)}...`;
-  } catch {
-    return "\"<unserializable>\"";
-  }
-}
-
-function summarizeProbeReason(probe) {
-  if (!probe || typeof probe !== "object") return "NO_PROBE";
-  if (probe.ok === true) return "INVALID_CLIP";
-  return String(probe.reason || "UNKNOWN");
-}
-
-function buildResumeProbeTimeoutMessage(waitResumeMs, probe) {
-  const reason = summarizeProbeReason(probe);
-  const payload = {
-    reason,
-    clip: probe?.clip || null,
-    scroll_top: Number.isFinite(Number(probe?.scrollTop)) ? Number(probe.scrollTop) : null,
-    client_height: Number.isFinite(Number(probe?.clientHeight)) ? Number(probe.clientHeight) : null,
-    scroll_height: Number.isFinite(Number(probe?.scrollHeight)) ? Number(probe.scrollHeight) : null,
-    max_scroll: Number.isFinite(Number(probe?.maxScroll)) ? Number(probe.maxScroll) : null,
-    debug: probe?.debug || null
-  };
-  return `Resume canvas not found: wait_resume_ms=${waitResumeMs}; last_reason=${reason}; probe=${oneLineJson(payload)}`;
-}
-
-function isStableNoResumeIframeProbe(probe) {
-  if (!probe || probe.ok === true || probe.reason !== "NO_CRESUME_IFRAME") {
-    return false;
-  }
-  const activeScopeCount = Number(probe?.debug?.activeScopeCount ?? -1);
-  const totalResumeIframes = Number(probe?.debug?.totalResumeIframes ?? -1);
-  const visibleResumeIframes = Number(probe?.debug?.visibleResumeIframes ?? -1);
-  return activeScopeCount === 0 && totalResumeIframes === 0 && visibleResumeIframes === 0;
-}
-
-function shouldAbortResumeProbeEarly({ probe, stableNoResumeIframePolls, elapsedMs, waitResumeMs }) {
-  if (!isStableNoResumeIframeProbe(probe)) {
-    return false;
-  }
-  const minWaitMs = Math.min(waitResumeMs, EARLY_FAIL_NO_RESUME_IFRAME_MIN_WAIT_MS);
-  return stableNoResumeIframePolls >= EARLY_FAIL_NO_RESUME_IFRAME_STABLE_POLLS
-    && elapsedMs >= minWaitMs;
-}
-
-function parseBooleanOption(value, fallback = false) {
-  if (value === undefined || value === null || value === "") return fallback;
-  if (typeof value === "boolean") return value;
-  const normalized = String(value).trim().toLowerCase();
-  if (["1", "true", "yes", "y", "on"].includes(normalized)) return true;
-  if (["0", "false", "no", "n", "off"].includes(normalized)) return false;
-  return fallback;
-}
-
-function numbersClose(left, right, tolerance = 1) {
-  return Math.abs(Number(left || 0) - Number(right || 0)) <= tolerance;
-}
-
-function isStableResumeViewport(previous, current, targetScroll) {
-  if (!previous?.ok || !current?.ok) return false;
-  const target = Number(targetScroll || 0);
-  const scrollTop = Number(current.scrollTop || 0);
-  const maxScroll = Number(current.maxScroll || 0);
-  const targetReached = numbersClose(scrollTop, target, 2)
-    || (target >= maxScroll && numbersClose(scrollTop, maxScroll, 2));
-  if (!targetReached) return false;
-  const prevClip = previous.clip || {};
-  const currentClip = current.clip || {};
-  return numbersClose(previous.scrollTop, current.scrollTop, 1)
-    && numbersClose(previous.scrollHeight, current.scrollHeight, 1)
-    && numbersClose(previous.clientHeight, current.clientHeight, 1)
-    && numbersClose(prevClip.x, currentClip.x, 1)
-    && numbersClose(prevClip.y, currentClip.y, 1)
-    && numbersClose(prevClip.width, currentClip.width, 1)
-    && numbersClose(prevClip.height, currentClip.height, 1);
-}
-
-async function waitForStableResumeViewport(evaluate, targetScroll, maxWaitMs) {
-  const maxWait = Math.max(160, Number(maxWaitMs || 0));
-  const start = Date.now();
-  let previous = null;
-  let latest = null;
-  let stablePolls = 0;
-  while (Date.now() - start < maxWait) {
-    await sleep(RESUME_VIEWPORT_STABILITY_POLL_MS);
-    const current = await evaluate(buildResumeProbeExpr({ init: false, targetScroll: null }));
-    if (current?.ok) {
-      latest = current;
-      if (isStableResumeViewport(previous, current, targetScroll)) {
-        stablePolls += 1;
-        if (stablePolls >= RESUME_VIEWPORT_STABLE_POLLS) {
-          return current;
-        }
-      } else {
-        stablePolls = 0;
-      }
-      previous = current;
-    }
-  }
-  return latest;
-}
-
-async function stitchWithSharp(metadataFile, stitchedImage) {
-  const sharp = loadSharp();
-  let metadata;
-  try {
-    metadata = JSON.parse(fs.readFileSync(metadataFile, "utf8"));
-  } catch (error) {
-    throw new Error(`Invalid stitch metadata: ${error.message || error}`);
-  }
-  const rawChunks = Array.isArray(metadata?.chunks) ? metadata.chunks : [];
-  if (rawChunks.length === 0) {
-    throw new Error("No chunks found in metadata.");
-  }
-
-  const chunks = rawChunks.map((chunk, index) => {
-    const file = path.resolve(String(chunk?.file || ""));
-    if (!file || !fs.existsSync(file)) {
-      throw new Error(`Chunk image missing: ${file || "<empty>"}`);
-    }
-    return {
-      index: Number.isInteger(chunk?.index) ? chunk.index : index,
-      file,
-      scrollTop: Number(chunk?.scrollTop || 0),
-      clipHeightCss: Number(chunk?.clipHeightCss || 0)
-    };
-  }).sort((a, b) => {
-    if (a.scrollTop !== b.scrollTop) return a.scrollTop - b.scrollTop;
-    return a.index - b.index;
-  });
-
-  const composites = [];
-  const used = [];
-  let outWidth = 1;
-  let outHeight = 0;
-  let prevChunk = null;
-
-  for (const chunk of chunks) {
-    const info = await sharp(chunk.file).metadata();
-    const width = Number(info?.width || 0);
-    const height = Number(info?.height || 0);
-    if (width <= 0 || height <= 0) {
-      throw new Error(`Invalid chunk image size: ${chunk.file}`);
-    }
-
-    if (prevChunk) {
-      const deltaCss = chunk.scrollTop - prevChunk.scrollTop;
-      if (!(deltaCss > 0.5)) {
-        prevChunk = chunk;
-        continue;
-      }
-      const clipHeightCss = chunk.clipHeightCss > 1 ? chunk.clipHeightCss : prevChunk.clipHeightCss;
-      const ratio = clipHeightCss > 1 ? (height / clipHeightCss) : 1;
-      const newPixels = clampInteger(Math.round(deltaCss * ratio), 1, height);
-      const cropTop = clampInteger(height - newPixels, 0, height - 1);
-      const segHeight = height - cropTop;
-      const segment = await sharp(chunk.file)
-        .removeAlpha()
-        .extract({
-          left: 0,
-          top: cropTop,
-          width,
-          height: segHeight
-        })
-        .png()
-        .toBuffer();
-      composites.push({
-        input: segment,
-        top: outHeight,
-        left: 0
-      });
-      used.push({
-        file: chunk.file,
-        scrollTop: chunk.scrollTop,
-        cropTopPx: cropTop,
-        keptHeightPx: segHeight
-      });
-      outWidth = Math.max(outWidth, width);
-      outHeight += segHeight;
-      prevChunk = chunk;
-      continue;
-    }
-
-    const segment = await sharp(chunk.file)
-      .removeAlpha()
-      .png()
-      .toBuffer();
-    composites.push({
-      input: segment,
-      top: outHeight,
-      left: 0
-    });
-    used.push({
-      file: chunk.file,
-      scrollTop: chunk.scrollTop,
-      cropTopPx: 0,
-      keptHeightPx: height
-    });
-    outWidth = Math.max(outWidth, width);
-    outHeight += height;
-    prevChunk = chunk;
-  }
-
-  if (composites.length === 0 || outHeight <= 0 || outWidth <= 0) {
-    throw new Error("No valid segments to stitch with sharp.");
-  }
-
-  await sharp({
-    create: {
-      width: outWidth,
-      height: outHeight,
-      channels: 3,
-      background: { r: 255, g: 255, b: 255 }
-    }
-  })
-    .composite(composites)
-    .png()
-    .toFile(stitchedImage);
-
-  return {
-    ok: true,
-    engine: "sharp",
-    output: path.resolve(stitchedImage),
-    segments: composites.length,
-    size: {
-      width: outWidth,
-      height: outHeight
-    },
-    used
-  };
-}
-
-function stitchWithAvailablePython(stitchScript, metadataFile, stitchedImage, spawnSyncImpl = spawnSync) {
-  const candidates = ["python3", "python"];
-  const attempts = [];
-  if (!fs.existsSync(stitchScript)) {
-    return {
-      ok: false,
-      attempts: candidates.map((command) => ({
-        command,
-        status: null,
-        signal: null,
-        error: `Missing stitch script: ${stitchScript}`,
-        stderr: "",
-        stdout: ""
-      }))
-    };
-  }
-  for (const command of candidates) {
-    const result = spawnSyncImpl(command, [stitchScript, metadataFile, stitchedImage], {
-      encoding: "utf8"
-    });
-    attempts.push({
-      command,
-      status: Number.isInteger(result.status) ? result.status : null,
-      signal: result.signal || null,
-      error: result.error ? String(result.error.message || result.error) : null,
-      stderr: result.stderr || "",
-      stdout: result.stdout || ""
-    });
-    if (result.status === 0) {
-      return {
-        ok: true,
-        engine: "python",
-        command,
-        result,
-        attempts
-      };
-    }
-  }
-  return {
-    ok: false,
-    attempts
-  };
-}
-
-function buildResumeProbeExpr({ init, targetScroll }) {
-  const initLiteral = init ? "true" : "false";
-  const scrollLiteral = typeof targetScroll === "number" && Number.isFinite(targetScroll)
-    ? String(targetScroll)
-    : "null";
-
-  return `(() => {
-    const INIT = ${initLiteral};
-    const TARGET_SCROLL = ${scrollLiteral};
-
-    function absRect(el) {
-      const rect = el.getBoundingClientRect();
-      let x = rect.left;
-      let y = rect.top;
-      let win = el.ownerDocument.defaultView;
-      while (win && win !== win.parent) {
-        const frameEl = win.frameElement;
-        if (!frameEl) break;
-        const frameRect = frameEl.getBoundingClientRect();
-        x += frameRect.left;
-        y += frameRect.top;
-        win = win.parent;
-      }
-      return { x, y, width: rect.width, height: rect.height };
-    }
-
-    function canScroll(el) {
-      return Boolean(el && (el.scrollHeight || 0) > (el.clientHeight || 0) + 8);
-    }
-
-    function chooseScrollableAncestor(startEl) {
-      const candidates = [];
-      let cur = startEl;
-      let depth = 0;
-      while (cur && depth < 24) {
-        if ((cur.clientHeight || 0) > 40 && canScroll(cur)) {
-          const style = getComputedStyle(cur);
-          const overflowY = String(style.overflowY || '').toLowerCase();
-          const key = (((cur.id || '') + ' ' + (cur.className || '')).toLowerCase());
-          let score = 0;
-          if (/auto|scroll|overlay/.test(overflowY)) score += 1000;
-          if (key.includes('resume')) score += 600;
-          if (key.includes('detail')) score += 300;
-          score += Math.min(250, Math.floor((cur.scrollHeight - cur.clientHeight) / 2));
-          score -= depth * 10;
-          candidates.push({ el: cur, score });
-        }
-        cur = cur.parentElement;
-        depth += 1;
-      }
-      if (!candidates.length) return null;
-      candidates.sort((a, b) => b.score - a.score);
-      return candidates[0].el;
-    }
-
-    function isVisible(el) {
-      if (!el) return false;
-      const style = getComputedStyle(el);
-      if (style.display === 'none' || style.visibility === 'hidden' || Number(style.opacity || '1') < 0.01) {
-        return false;
-      }
-      const rect = el.getBoundingClientRect();
-      return rect.width > 80 && rect.height > 80;
-    }
-
-    function locateContext() {
-      const recommendFrame = document.querySelector('iframe[name="recommendFrame"]')
-        || document.querySelector('iframe[src*="/web/frame/recommend/"]')
-        || document.querySelector('iframe');
-      const recommendDoc = recommendFrame && recommendFrame.contentDocument;
-      if (!recommendFrame || !recommendDoc) {
-        return {
-          ok: false,
-          reason: 'NO_RECOMMEND_IFRAME',
-          debug: {
-            topIframeCount: document.querySelectorAll('iframe').length
-          }
-        };
-      }
-
-      const scopes = Array.from(
-        recommendDoc.querySelectorAll('.dialog-wrap.active, .boss-popup__wrapper.boss-dialog, .boss-dialog__wrapper')
-      ).filter(isVisible);
-      const allResumeFrames = Array.from(
-        recommendDoc.querySelectorAll('iframe[src*="/web/frame/c-resume/"], iframe[name*="resume"]')
-      );
-      const visibleResumeFrames = allResumeFrames.filter(isVisible);
-
-      let resumeFrame = null;
-      for (const scope of scopes) {
-        const found = scope.querySelector('iframe[src*="/web/frame/c-resume/"], iframe[name*="resume"]');
-        if (found && isVisible(found)) {
-          resumeFrame = found;
-          break;
-        }
-      }
-
-      if (!resumeFrame) {
-        resumeFrame = visibleResumeFrames[0] || null;
-      }
-
-      if (!resumeFrame) {
-        return {
-          ok: false,
-          reason: 'NO_CRESUME_IFRAME',
-          debug: {
-            activeScopeCount: scopes.length,
-            totalResumeIframes: allResumeFrames.length,
-            visibleResumeIframes: visibleResumeFrames.length,
-            recommendFrameUrl: (() => {
-              try { return String(recommendFrame.contentWindow.location.href || ''); } catch { return ''; }
-            })()
-          }
-        };
-      }
-
-      const resumeDoc = resumeFrame.contentDocument;
-      const canvas = resumeDoc ? (resumeDoc.querySelector('canvas#resume') || resumeDoc.querySelector('canvas')) : null;
-      const scroller = chooseScrollableAncestor(resumeFrame.parentElement || resumeFrame)
-        || recommendDoc.querySelector('.resume-detail-wrap')
-        || chooseScrollableAncestor(resumeFrame)
-        || null;
-      if (!scroller || !isVisible(scroller)) {
-        return {
-          ok: false,
-          reason: 'NO_SCROLL_CONTAINER',
-          debug: {
-            activeScopeCount: scopes.length,
-            totalResumeIframes: allResumeFrames.length,
-            visibleResumeIframes: visibleResumeFrames.length,
-            resumeFrameSrc: String(resumeFrame.src || ''),
-            scrollerFound: Boolean(scroller),
-            scrollerVisible: Boolean(scroller && isVisible(scroller)),
-            scrollerClass: scroller ? String(scroller.className || '') : ''
-          }
-        };
-      }
-
-      return {
-        ok: true,
-        frame: resumeFrame,
-        canvas,
-        scroller,
-        clipEl: scroller,
-        debug: {
-          recommendFrameUrl: (() => {
-            try { return String(recommendFrame.contentWindow.location.href || ''); } catch { return ''; }
-          })(),
-          resumeFrameSrc: String(resumeFrame.src || ''),
-          scrollerClass: String(scroller.className || '')
-        }
-      };
-    }
-
-    if (INIT || !window.__bossRecommendResumeCtx || !window.__bossRecommendResumeCtx.scroller || !window.__bossRecommendResumeCtx.scroller.isConnected) {
-      const located = locateContext();
-      if (!located.ok) {
-        return located;
-      }
-      window.__bossRecommendResumeCtx = located;
-    }
-
-    const ctx = window.__bossRecommendResumeCtx;
-    if (typeof TARGET_SCROLL === 'number' && Number.isFinite(TARGET_SCROLL)) {
-      try {
-        ctx.scroller.scrollTop = TARGET_SCROLL;
-        if (typeof ctx.scroller.scrollTo === 'function') {
-          ctx.scroller.scrollTo({ top: TARGET_SCROLL, left: 0, behavior: 'instant' });
-        }
-        ctx.scroller.dispatchEvent(new Event('scroll', { bubbles: true }));
-      } catch {}
-    }
-
-    const scrollTop = Number(ctx.scroller.scrollTop || 0);
-    const scrollHeight = Number(ctx.scroller.scrollHeight || 0);
-    const clientHeight = Number(ctx.scroller.clientHeight || 0);
-    const maxScroll = Math.max(0, scrollHeight - clientHeight);
-    const clipRaw = absRect(ctx.clipEl);
-
-    return {
-      ok: true,
-      scrollTop,
-      scrollHeight,
-      clientHeight,
-      maxScroll,
-      clip: {
-        x: clipRaw.x,
-        y: clipRaw.y,
-        width: Math.max(1, Math.min(clipRaw.width, Number(ctx.scroller.clientWidth || clipRaw.width))),
-        height: Math.max(1, Math.min(clipRaw.height, Number(ctx.scroller.clientHeight || clipRaw.height)))
-      },
-      canvas: ctx.canvas ? {
-        width: Number(ctx.canvas.width || 0),
-        height: Number(ctx.canvas.height || 0)
-      } : null,
-      debug: ctx.debug || {}
-    };
-  })()`;
-}
-
-async function captureFullResumeCanvas(options = {}) {
-  const host = options.host || process.env.CDP_HOST || "127.0.0.1";
-  const port = Number(options.port || process.env.CDP_PORT || 9222);
-  const waitResumeMs = Number(options.waitResumeMs || process.env.WAIT_RESUME_MS || 30000);
-  const scrollSettleMs = Number(options.scrollSettleMs || process.env.SCROLL_SETTLE_MS || 500);
-  const stitchFullImage = parseBooleanOption(
-    options.stitchFullImage,
-    parseBooleanOption(process.env.BOSS_RECOMMEND_STITCH_FULL_IMAGE, true)
-  );
-  const outPrefix = options.outPrefix || process.env.OUT_PREFIX || path.resolve(process.cwd(), "recommend_resume_full");
-  const targetPattern = options.targetPattern || process.env.TARGET_PATTERN || "/web/chat/recommend";
-  const stitchScript = path.resolve(__dirname, "stitch_resume_chunks.py");
-  const chunkDir = `${outPrefix}_chunks`;
-  const metadataFile = `${outPrefix}_chunks.json`;
-  const stitchedImage = `${outPrefix}.png`;
-
-  fs.mkdirSync(chunkDir, { recursive: true });
-
-  const targets = await getJson(`http://${host}:${port}/json/list`);
-  const target = pickTarget(targets, targetPattern);
-  if (!target?.webSocketDebuggerUrl) {
-    throw new Error("No debuggable zhipin page target found.");
-  }
-
-  const ws = new WebSocket(target.webSocketDebuggerUrl);
-  let seq = 0;
-  const pending = new Map();
-
-  function send(method, params = {}) {
-    const id = ++seq;
-    ws.send(JSON.stringify({ id, method, params }));
-    return new Promise((resolve, reject) => {
-      pending.set(id, { resolve, reject, method });
-      setTimeout(() => {
-        if (!pending.has(id)) return;
-        pending.delete(id);
-        reject(new Error(`Timeout: ${method}`));
-      }, 30000);
-    });
-  }
-
-  function evaluate(expression) {
-    return send("Runtime.evaluate", {
-      expression,
-      returnByValue: true,
-      awaitPromise: true
-    }).then((response) => response.result?.value);
-  }
-
-  ws.on("message", (data) => {
-    let message;
-    try {
-      message = JSON.parse(String(data));
-    } catch {
-      return;
-    }
-    if (!message.id) return;
-    const promise = pending.get(message.id);
-    if (!promise) return;
-    pending.delete(message.id);
-    if (message.error) {
-      promise.reject(new Error(JSON.stringify(message.error)));
-    } else {
-      promise.resolve(message.result);
-    }
-  });
-
-  await new Promise((resolve, reject) => {
-    ws.once("open", resolve);
-    ws.once("error", reject);
-  });
-
-  try {
-    await send("Page.enable");
-    await send("Runtime.enable");
-    if (SHOULD_BRING_TO_FRONT) {
-      await send("Page.bringToFront");
-    }
-
-    let probe = null;
-    let lastProbe = null;
-    let stableNoResumeIframePolls = 0;
-    const startTime = Date.now();
-    while (Date.now() - startTime < waitResumeMs) {
-      try {
-        probe = await evaluate(buildResumeProbeExpr({ init: true, targetScroll: 0 }));
-      } catch (error) {
-        probe = {
-          ok: false,
-          reason: "PROBE_EVALUATE_FAILED",
-          debug: {
-            message: String(error?.message || error || "unknown")
-          }
-        };
-      }
-      if (probe && typeof probe === "object") {
-        lastProbe = probe;
-      }
-      if (probe?.ok && probe.clip?.height > 80 && probe.clip?.width > 120) {
-        break;
-      }
-      if (isStableNoResumeIframeProbe(probe)) {
-        stableNoResumeIframePolls += 1;
-      } else {
-        stableNoResumeIframePolls = 0;
-      }
-      const elapsedMs = Date.now() - startTime;
-      if (shouldAbortResumeProbeEarly({
-        probe,
-        stableNoResumeIframePolls,
-        elapsedMs,
-        waitResumeMs
-      })) {
-        if (probe && typeof probe === "object") {
-          probe = {
-            ...probe,
-            debug: {
-              ...(probe.debug && typeof probe.debug === "object" ? probe.debug : {}),
-              earlyAbort: true,
-              stableNoResumeIframePolls,
-              elapsedMs
-            }
-          };
-          lastProbe = probe;
-        }
-        break;
-      }
-      await sleep(700);
-    }
-
-    if (!probe?.ok) {
-      const elapsedMs = Math.max(0, Date.now() - startTime);
-      throw new Error(buildResumeProbeTimeoutMessage(Math.min(waitResumeMs, elapsedMs), lastProbe || probe));
-    }
-
-    const maxScroll = Math.max(0, Number(probe.maxScroll || 0));
-    const step = Math.max(120, Math.floor(Number(probe.clientHeight || probe.clip.height || 800)));
-    const positions = [];
-    for (let pos = 0; pos <= maxScroll; pos += step) {
-      positions.push(Math.min(pos, maxScroll));
-    }
-    if (!positions.length || positions[positions.length - 1] !== maxScroll) {
-      positions.push(maxScroll);
-    }
-
-    const uniquePositions = [...new Set(positions.map((value) => Math.round(value)))].sort((a, b) => a - b);
-    const chunks = [];
-    const seenScroll = [];
-
-    for (let index = 0; index < uniquePositions.length; index += 1) {
-      const targetScroll = uniquePositions[index];
-      await evaluate(buildResumeProbeExpr({ init: false, targetScroll }));
-      const current = await waitForStableResumeViewport(evaluate, targetScroll, scrollSettleMs);
-      if (!current?.ok) continue;
-
-      const actualScroll = Number(current.scrollTop || 0);
-      if (seenScroll.some((value) => Math.abs(value - actualScroll) < 1)) {
-        continue;
-      }
-
-      const clip = current.clip || {};
-      const width = Number(clip.width || 0);
-      const height = Number(clip.height || 0);
-      if (width < 50 || height < 50) {
-        continue;
-      }
-
-      const shot = await send("Page.captureScreenshot", {
-        format: "png",
-        captureBeyondViewport: true,
-        clip: {
-          x: Number(clip.x.toFixed(2)),
-          y: Number(clip.y.toFixed(2)),
-          width: Number(width.toFixed(2)),
-          height: Number(height.toFixed(2)),
-          scale: 1
-        }
-      });
-
-      const file = path.resolve(chunkDir, `chunk_${String(chunks.length).padStart(3, "0")}.png`);
-      fs.writeFileSync(file, Buffer.from(shot.data, "base64"));
-      seenScroll.push(actualScroll);
-      chunks.push({
-        index: chunks.length,
-        file,
-        scrollTop: actualScroll,
-        clipHeightCss: height,
-        clipWidthCss: width
-      });
-    }
-
-    if (!chunks.length) {
-      throw new Error("No screenshot chunks captured.");
-    }
-
-    const metadata = {
-      createdAt: new Date().toISOString(),
-      target: { title: target.title, url: target.url },
-      probe,
-      chunks
-    };
-    fs.writeFileSync(metadataFile, JSON.stringify(metadata, null, 2), "utf8");
-
-    let stitchEngine = "skipped";
-    if (stitchFullImage) {
-      stitchEngine = "sharp";
-      try {
-        await stitchWithSharp(metadataFile, stitchedImage);
-      } catch (sharpError) {
-        const fallback = stitchWithAvailablePython(stitchScript, metadataFile, stitchedImage);
-        if (!fallback.ok) {
-          const fallbackSummary = fallback.attempts
-            .map((item) => {
-              const message = item.stderr || item.stdout || item.error || "unknown error";
-              return `${item.command}(status=${item.status ?? "null"}): ${message}`;
-            })
-            .join(" | ");
-          throw new Error(
-            `Stitch failed (sharp + python fallback). sharp=${sharpError?.message || sharpError}; fallback=${fallbackSummary}`
-          );
-        }
-        stitchEngine = fallback.command || "python";
-      }
-    }
-
-    return {
-      stitchedImage: stitchFullImage ? stitchedImage : "",
-      metadataFile,
-      chunkDir,
-      chunkCount: chunks.length,
-      chunkFiles: chunks.map((chunk) => chunk.file),
-      modelImagePaths: chunks.map((chunk) => chunk.file),
-      stitch_engine: stitchEngine,
-      target: {
-        title: target.title,
-        url: target.url
-      }
-    };
-  } finally {
-    try {
-      ws.close();
-    } catch {}
-  }
-}
-
-module.exports = {
-  captureFullResumeCanvas,
-  __testables: {
-    EARLY_FAIL_NO_RESUME_IFRAME_MIN_WAIT_MS,
-    EARLY_FAIL_NO_RESUME_IFRAME_STABLE_POLLS,
-    isStableNoResumeIframeProbe,
-    isStableResumeViewport,
-    shouldAbortResumeProbeEarly,
-    stitchWithAvailablePython,
-    stitchWithSharp
-  }
-};
-
-if (require.main === module) {
-  captureFullResumeCanvas()
-    .then((result) => {
-      console.log(JSON.stringify(result, null, 2));
-    })
-    .catch((error) => {
-      console.error(String(error?.message || error));
-      process.exit(1);
-    });
-}