npm - @lumy-pack/scene-sieve - Versions diffs - 0.0.14 → 0.1.0 - Mend

@lumy-pack/scene-sieve 0.0.14 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/dist/cli.mjs +1976 -2101
package/dist/index.cjs +1370 -1478
package/dist/index.mjs +1348 -1446
package/dist/pipeline-worker.mjs +1371 -1468
package/package.json +5 -4

package/dist/index.cjs CHANGED Viewed

@@ -1,1606 +1,1498 @@
-"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+//#region \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
 var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-// src/index.ts
-var src_exports = {};
-__export(src_exports, {
-  extractScenes: () => runPipeline
-});
-module.exports = __toCommonJS(src_exports);
-// ../../node_modules/tsup/assets/cjs_shims.js
-var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
-var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
-// src/core/orchestrator.ts
-var import_node_crypto2 = require("crypto");
-var import_common_utils7 = require("@winglet/common-utils");
+//#endregion
+let node_crypto = require("node:crypto");
+let _winglet_common_utils = require("@winglet/common-utils");
+let picocolors = require("picocolors");
+picocolors = __toESM(picocolors, 1);
+let node_module = require("node:module");
+let sharp = require("sharp");
+sharp = __toESM(sharp, 1);
+let node_os = require("node:os");
+let node_path = require("node:path");
+let node_fs_promises = require("node:fs/promises");
+let _ffprobe_installer_ffprobe = require("@ffprobe-installer/ffprobe");
+let execa = require("execa");
+let ffmpeg_static = require("ffmpeg-static");
+ffmpeg_static = __toESM(ffmpeg_static, 1);
-// src/utils/logger.ts
-var import_picocolors = __toESM(require("picocolors"), 1);
-var debugMode = false;
-var jsonMode = false;
+//#region src/utils/logger.ts
+let debugMode = false;
+let jsonMode = false;
 function setDebugMode(enabled) {
-  debugMode = enabled;
+	debugMode = enabled;
 }
 function timestamp() {
-  return (/* @__PURE__ */ new Date()).toLocaleTimeString("en-US", { hour12: false });
+	return (/* @__PURE__ */ new Date()).toLocaleTimeString("en-US", { hour12: false });
 }
-var logger = {
-  info(message) {
-    if (jsonMode) {
-      process.stderr.write(`${import_picocolors.default.blue("info")} ${message}
-`);
-    } else {
-      console.log(`${import_picocolors.default.blue("info")} ${message}`);
-    }
-  },
-  success(message) {
-    if (jsonMode) {
-      process.stderr.write(`${import_picocolors.default.green("done")} ${message}
-`);
-    } else {
-      console.log(`
-${import_picocolors.default.green("done")} ${message}`);
-    }
-  },
-  warn(message) {
-    console.warn(`${import_picocolors.default.yellow("warn")} ${message}`);
-  },
-  error(message) {
-    console.error(`${import_picocolors.default.red("error")} ${message}`);
-  },
-  debug(message) {
-    if (debugMode) {
-      if (jsonMode) {
-        process.stderr.write(`${import_picocolors.default.gray(`[${timestamp()}] debug`)} ${message}
-`);
-      } else {
-        console.log(`${import_picocolors.default.gray(`[${timestamp()}] debug`)} ${message}`);
-      }
-    }
-  }
+const logger = {
+	info(message) {
+		if (jsonMode) process.stderr.write(`${picocolors.default.blue("info")} ${message}\n`);
+		else console.log(`${picocolors.default.blue("info")} ${message}`);
+	},
+	success(message) {
+		if (jsonMode) process.stderr.write(`${picocolors.default.green("done")} ${message}\n`);
+		else console.log(`\n${picocolors.default.green("done")} ${message}`);
+	},
+	warn(message) {
+		console.warn(`${picocolors.default.yellow("warn")} ${message}`);
+	},
+	error(message) {
+		console.error(`${picocolors.default.red("error")} ${message}`);
+	},
+	debug(message) {
+		if (debugMode) if (jsonMode) process.stderr.write(`${picocolors.default.gray(`[${timestamp()}] debug`)} ${message}\n`);
+		else console.log(`${picocolors.default.gray(`[${timestamp()}] debug`)} ${message}`);
+	}
 };
-// src/core/analyzer.ts
-var import_node_module = require("module");
-var import_common_utils = require("@winglet/common-utils");
-var import_sharp = __toESM(require("sharp"), 1);
-// src/constants.ts
-var import_node_os = require("os");
-var import_node_path = require("path");
-var APP_NAME = "scene-sieve";
-var DEFAULT_COUNT = 20;
-var DEFAULT_THRESHOLD = 0.5;
-var DEFAULT_FPS = 5;
-var DEFAULT_SCALE = 720;
-var DEFAULT_QUALITY = 80;
-var DEFAULT_MAX_FRAMES = 300;
-var NORMALIZATION_LOGISTIC_K = 3;
-var NORMALIZATION_ALPHA = 0.4;
-var NORMALIZATION_MAD_COEFFICIENT = 1.4826;
-var NORMALIZATION_MIN_SAMPLE_SIZE = 10;
-var WORKSPACE_PREFIX = `${APP_NAME}-`;
-var TEMP_BASE_DIR = (0, import_node_os.tmpdir)();
-var FRAME_OUTPUT_EXTENSION = ".jpg";
-var FRAME_FILENAME_PATTERN = "frame_%06d.jpg";
-var OPENCV_BATCH_SIZE = 10;
-var DBSCAN_ALPHA = 0.03;
-var DBSCAN_MIN_PTS = 4;
-var IOU_THRESHOLD = 0.9;
-var DECAY_LAMBDA = 0.95;
-var ANIMATION_FRAME_THRESHOLD = 5;
-var MATCH_DISTANCE_THRESHOLD = 0.25;
-var PIXELDIFF_GAUSSIAN_KERNEL = 3;
-var PIXELDIFF_BINARY_THRESHOLD = 30;
-var PIXELDIFF_CONTOUR_MIN_AREA = 100;
-var PIXELDIFF_SAMPLE_SPACING = 8;
-var DEFAULT_MAX_SEGMENT_DURATION = 300;
-var DEFAULT_SEGMENT_CONCURRENCY = 2;
+//#endregion
+//#region src/constants.ts
+const APP_NAME = "scene-sieve";
+const DEFAULT_THRESHOLD = .5;
+const NORMALIZATION_ALPHA = .4;
+const NORMALIZATION_MAD_COEFFICIENT = 1.4826;
+const WORKSPACE_PREFIX = `${APP_NAME}-`;
+const TEMP_BASE_DIR = (0, node_os.tmpdir)();
+const FRAME_OUTPUT_EXTENSION = ".jpg";
+const FRAME_FILENAME_PATTERN = "frame_%06d.jpg";
+const DBSCAN_ALPHA = .03;
+const IOU_THRESHOLD = .9;
+const DECAY_LAMBDA = .95;
+const MATCH_DISTANCE_THRESHOLD = .25;
 function getTempWorkspaceDir(sessionId) {
-  return (0, import_node_path.join)(TEMP_BASE_DIR, `${WORKSPACE_PREFIX}${sessionId}`);
+	return (0, node_path.join)(TEMP_BASE_DIR, `${WORKSPACE_PREFIX}${sessionId}`);
 }
-// src/core/dbscan.ts
-var UNVISITED = -2;
-var NOISE = -1;
+//#endregion
+//#region src/core/dbscan.ts
+const UNVISITED = -2;
+const NOISE = -1;
+/**
+* DBSCAN clustering with resolution-independent eps.
+* eps = alpha * sqrt(width^2 + height^2)
+*/
 function dbscan(points, imageWidth, imageHeight, alpha, minPts) {
-  if (points.length === 0) {
-    return { labels: [], boundingBoxes: [] };
-  }
-  const eps = (alpha ?? DBSCAN_ALPHA) * Math.sqrt(imageWidth ** 2 + imageHeight ** 2);
-  const epsSquared = eps * eps;
-  const minPoints = minPts ?? DBSCAN_MIN_PTS;
-  const labels = new Array(points.length).fill(UNVISITED);
-  let clusterId = 0;
-  for (let i = 0; i < points.length; i++) {
-    if (labels[i] !== UNVISITED) continue;
-    const neighbors = findNeighbors(points, i, epsSquared);
-    if (neighbors.length < minPoints) {
-      labels[i] = NOISE;
-      continue;
-    }
-    labels[i] = clusterId;
-    const seeds = [...neighbors];
-    const seedSet = new Set(seeds);
-    for (let si = 0; si < seeds.length; si++) {
-      const q = seeds[si];
-      if (labels[q] === NOISE) {
-        labels[q] = clusterId;
-      }
-      if (labels[q] !== UNVISITED) continue;
-      labels[q] = clusterId;
-      const qNeighbors = findNeighbors(points, q, epsSquared);
-      if (qNeighbors.length >= minPoints) {
-        for (const n of qNeighbors) {
-          if (!seedSet.has(n)) {
-            seedSet.add(n);
-            seeds.push(n);
-          }
-        }
-      }
-    }
-    clusterId++;
-  }
-  const boundingBoxes = [];
-  for (let c = 0; c < clusterId; c++) {
-    let minX = Infinity;
-    let minY = Infinity;
-    let maxX = -Infinity;
-    let maxY = -Infinity;
-    for (let i = 0; i < points.length; i++) {
-      if (labels[i] !== c) continue;
-      const p = points[i];
-      if (p.x < minX) minX = p.x;
-      if (p.y < minY) minY = p.y;
-      if (p.x > maxX) maxX = p.x;
-      if (p.y > maxY) maxY = p.y;
-    }
-    boundingBoxes.push({
-      x: minX,
-      y: minY,
-      width: maxX - minX,
-      height: maxY - minY
-    });
-  }
-  return { labels, boundingBoxes };
+	if (points.length === 0) return {
+		labels: [],
+		boundingBoxes: []
+	};
+	const eps = (alpha ?? .03) * Math.sqrt(imageWidth ** 2 + imageHeight ** 2);
+	const epsSquared = eps * eps;
+	const minPoints = minPts ?? 4;
+	const labels = new Array(points.length).fill(UNVISITED);
+	let clusterId = 0;
+	for (let i = 0; i < points.length; i++) {
+		if (labels[i] !== UNVISITED) continue;
+		const neighbors = findNeighbors(points, i, epsSquared);
+		if (neighbors.length < minPoints) {
+			labels[i] = NOISE;
+			continue;
+		}
+		labels[i] = clusterId;
+		const seeds = [...neighbors];
+		const seedSet = new Set(seeds);
+		for (let si = 0; si < seeds.length; si++) {
+			const q = seeds[si];
+			if (labels[q] === NOISE) labels[q] = clusterId;
+			if (labels[q] !== UNVISITED) continue;
+			labels[q] = clusterId;
+			const qNeighbors = findNeighbors(points, q, epsSquared);
+			if (qNeighbors.length >= minPoints) {
+				for (const n of qNeighbors) if (!seedSet.has(n)) {
+					seedSet.add(n);
+					seeds.push(n);
+				}
+			}
+		}
+		clusterId++;
+	}
+	const boundingBoxes = [];
+	for (let c = 0; c < clusterId; c++) {
+		let minX = Infinity;
+		let minY = Infinity;
+		let maxX = -Infinity;
+		let maxY = -Infinity;
+		for (let i = 0; i < points.length; i++) {
+			if (labels[i] !== c) continue;
+			const p = points[i];
+			if (p.x < minX) minX = p.x;
+			if (p.y < minY) minY = p.y;
+			if (p.x > maxX) maxX = p.x;
+			if (p.y > maxY) maxY = p.y;
+		}
+		boundingBoxes.push({
+			x: minX,
+			y: minY,
+			width: maxX - minX,
+			height: maxY - minY
+		});
+	}
+	return {
+		labels,
+		boundingBoxes
+	};
 }
 function findNeighbors(points, idx, epsSquared) {
-  const p = points[idx];
-  const neighbors = [];
-  for (let i = 0; i < points.length; i++) {
-    if (i === idx) continue;
-    const q = points[i];
-    const distSq = (p.x - q.x) ** 2 + (p.y - q.y) ** 2;
-    if (distSq <= epsSquared) {
-      neighbors.push(i);
-    }
-  }
-  return neighbors;
+	const p = points[idx];
+	const neighbors = [];
+	for (let i = 0; i < points.length; i++) {
+		if (i === idx) continue;
+		const q = points[i];
+		if ((p.x - q.x) ** 2 + (p.y - q.y) ** 2 <= epsSquared) neighbors.push(i);
+	}
+	return neighbors;
 }
-// src/core/analyzer.ts
-var OPENCV_INIT_TIMEOUT_MS = 3e4;
-var require2 = (0, import_node_module.createRequire)(importMetaUrl);
-var cvReady = null;
+//#endregion
+//#region src/core/analyzer.ts
+const OPENCV_INIT_TIMEOUT_MS = 3e4;
+const require$1 = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href);
+let cvReady = null;
 async function ensureOpenCV() {
-  if (!cvReady) {
-    cvReady = (async () => {
-      const cvObj = require2("@techstark/opencv-js");
-      delete cvObj.then;
-      if (cvObj.Mat) return cvObj;
-      return new Promise((resolve2, reject) => {
-        const timeout = setTimeout(() => {
-          reject(new Error("OpenCV WASM initialization timed out after 30s"));
-        }, OPENCV_INIT_TIMEOUT_MS);
-        cvObj.onRuntimeInitialized = () => {
-          clearTimeout(timeout);
-          resolve2(cvObj);
-        };
-      });
-    })();
-  }
-  return cvReady;
+	if (!cvReady) cvReady = (async () => {
+		const cvObj = require$1("@techstark/opencv-js");
+		delete cvObj.then;
+		if (cvObj.Mat) return cvObj;
+		return new Promise((resolve, reject) => {
+			const timeout = setTimeout(() => {
+				reject(/* @__PURE__ */ new Error("OpenCV WASM initialization timed out after 30s"));
+			}, OPENCV_INIT_TIMEOUT_MS);
+			cvObj.onRuntimeInitialized = () => {
+				clearTimeout(timeout);
+				resolve(cvObj);
+			};
+		});
+	})();
+	return cvReady;
 }
 async function preprocessFrame(framePath, scale) {
-  const { data, info } = await (0, import_sharp.default)(framePath).resize({ width: scale, withoutEnlargement: true }).grayscale().blur(1).raw().toBuffer({ resolveWithObject: true });
-  return {
-    data: new Uint8Array(data.buffer, data.byteOffset, data.byteLength),
-    width: info.width,
-    height: info.height
-  };
+	const { data, info } = await (0, sharp.default)(framePath).resize({
+		width: scale,
+		withoutEnlargement: true
+	}).grayscale().blur(1).raw().toBuffer({ resolveWithObject: true });
+	return {
+		data: new Uint8Array(data.buffer, data.byteOffset, data.byteLength),
+		width: info.width,
+		height: info.height
+	};
 }
 function computeIoU(a, b) {
-  const ix1 = Math.max(a.x, b.x);
-  const iy1 = Math.max(a.y, b.y);
-  const ix2 = Math.min(a.x + a.width, b.x + b.width);
-  const iy2 = Math.min(a.y + a.height, b.y + b.height);
-  const iw = Math.max(0, ix2 - ix1);
-  const ih = Math.max(0, iy2 - iy1);
-  const intersection = iw * ih;
-  if (intersection === 0) return 0;
-  const aArea = a.width * a.height;
-  const bArea = b.width * b.height;
-  const union = aArea + bArea - intersection;
-  return union === 0 ? 0 : intersection / union;
+	const ix1 = Math.max(a.x, b.x);
+	const iy1 = Math.max(a.y, b.y);
+	const ix2 = Math.min(a.x + a.width, b.x + b.width);
+	const iy2 = Math.min(a.y + a.height, b.y + b.height);
+	const intersection = Math.max(0, ix2 - ix1) * Math.max(0, iy2 - iy1);
+	if (intersection === 0) return 0;
+	const union = a.width * a.height + b.width * b.height - intersection;
+	return union === 0 ? 0 : intersection / union;
 }
 var IoUTracker = class {
-  constructor(fps = DEFAULT_FPS, iouThreshold = IOU_THRESHOLD, animationThreshold = ANIMATION_FRAME_THRESHOLD) {
-    this.fps = fps;
-    this.iouThreshold = iouThreshold;
-    this.animationThreshold = animationThreshold;
-  }
-  regions = [];
-  extractedAnimations = [];
-  update(boxes, pairIndex) {
-    const animationIndices = /* @__PURE__ */ new Set();
-    const matched = /* @__PURE__ */ new Set();
-    for (let bi = 0; bi < boxes.length; bi++) {
-      const box = boxes[bi];
-      let bestIoU = 0;
-      let bestRegionIdx = -1;
-      for (let ri = 0; ri < this.regions.length; ri++) {
-        if (matched.has(ri)) continue;
-        const iou = computeIoU(box, this.regions[ri].box);
-        if (iou > bestIoU) {
-          bestIoU = iou;
-          bestRegionIdx = ri;
-        }
-      }
-      if (bestIoU > this.iouThreshold && bestRegionIdx !== -1) {
-        const region = this.regions[bestRegionIdx];
-        const gap = pairIndex - region.lastSeen;
-        region.box = box;
-        region.consecutiveCount++;
-        region.lastSeen = pairIndex;
-        region.weight *= Math.pow(DECAY_LAMBDA, gap);
-        matched.add(bestRegionIdx);
-        if (region.consecutiveCount >= this.animationThreshold) {
-          animationIndices.add(bi);
-        }
-      } else {
-        this.regions.push({
-          box,
-          consecutiveCount: 1,
-          firstSeen: pairIndex,
-          lastSeen: pairIndex,
-          weight: 1
-        });
-      }
-    }
-    for (let ri = 0; ri < this.regions.length; ri++) {
-      if (!matched.has(ri)) {
-        const gap = pairIndex - this.regions[ri].lastSeen;
-        this.regions[ri].weight *= Math.pow(DECAY_LAMBDA, gap);
-      }
-    }
-    for (let i = 0; i < this.regions.length; i++) {
-      const region = this.regions[i];
-      if (region.weight <= 0.01 && !matched.has(i)) {
-        this.collectAnimation(region);
-      }
-    }
-    this.regions = (0, import_common_utils.filter)(
-      this.regions,
-      (r, i) => r.weight > 0.01 || matched.has(i)
-    );
-    return animationIndices;
-  }
-  collectAnimation(region) {
-    if (region.consecutiveCount >= this.animationThreshold) {
-      const durationMs = region.consecutiveCount / this.fps * 1e3;
-      this.extractedAnimations.push({
-        type: "loading_spinner",
-        // 기본값으로 loading_spinner 사용
-        boundingBox: region.box,
-        startFrameId: region.firstSeen,
-        endFrameId: region.lastSeen,
-        durationMs
-      });
-    }
-  }
-  flushAndGetAnimations() {
-    for (const region of this.regions) {
-      this.collectAnimation(region);
-    }
-    this.regions = [];
-    return this.extractedAnimations;
-  }
-  getAnimationWeight(boxIndex, boxes) {
-    if (boxIndex >= boxes.length) return 0;
-    const box = boxes[boxIndex];
-    let maxWeight = 0;
-    for (const region of this.regions) {
-      if (region.consecutiveCount >= this.animationThreshold) {
-        const iou = computeIoU(box, region.box);
-        if (iou > this.iouThreshold) {
-          maxWeight = Math.max(maxWeight, region.weight);
-        }
-      }
-    }
-    return maxWeight;
-  }
+	fps;
+	iouThreshold;
+	animationThreshold;
+	regions = [];
+	extractedAnimations = [];
+	constructor(fps = 5, iouThreshold = IOU_THRESHOLD, animationThreshold = 5) {
+		this.fps = fps;
+		this.iouThreshold = iouThreshold;
+		this.animationThreshold = animationThreshold;
+	}
+	update(boxes, pairIndex) {
+		const animationIndices = /* @__PURE__ */ new Set();
+		const matched = /* @__PURE__ */ new Set();
+		for (let bi = 0; bi < boxes.length; bi++) {
+			const box = boxes[bi];
+			let bestIoU = 0;
+			let bestRegionIdx = -1;
+			for (let ri = 0; ri < this.regions.length; ri++) {
+				if (matched.has(ri)) continue;
+				const iou = computeIoU(box, this.regions[ri].box);
+				if (iou > bestIoU) {
+					bestIoU = iou;
+					bestRegionIdx = ri;
+				}
+			}
+			if (bestIoU > this.iouThreshold && bestRegionIdx !== -1) {
+				const region = this.regions[bestRegionIdx];
+				const gap = pairIndex - region.lastSeen;
+				region.box = box;
+				region.consecutiveCount++;
+				region.lastSeen = pairIndex;
+				region.weight *= Math.pow(DECAY_LAMBDA, gap);
+				matched.add(bestRegionIdx);
+				if (region.consecutiveCount >= this.animationThreshold) animationIndices.add(bi);
+			} else this.regions.push({
+				box,
+				consecutiveCount: 1,
+				firstSeen: pairIndex,
+				lastSeen: pairIndex,
+				weight: 1
+			});
+		}
+		for (let ri = 0; ri < this.regions.length; ri++) if (!matched.has(ri)) {
+			const gap = pairIndex - this.regions[ri].lastSeen;
+			this.regions[ri].weight *= Math.pow(DECAY_LAMBDA, gap);
+		}
+		for (let i = 0; i < this.regions.length; i++) {
+			const region = this.regions[i];
+			if (region.weight <= .01 && !matched.has(i)) this.collectAnimation(region);
+		}
+		this.regions = (0, _winglet_common_utils.filter)(this.regions, (r, i) => r.weight > .01 || matched.has(i));
+		return animationIndices;
+	}
+	collectAnimation(region) {
+		if (region.consecutiveCount >= this.animationThreshold) {
+			const durationMs = region.consecutiveCount / this.fps * 1e3;
+			this.extractedAnimations.push({
+				type: "loading_spinner",
+				boundingBox: region.box,
+				startFrameId: region.firstSeen,
+				endFrameId: region.lastSeen,
+				durationMs
+			});
+		}
+	}
+	flushAndGetAnimations() {
+		for (const region of this.regions) this.collectAnimation(region);
+		this.regions = [];
+		return this.extractedAnimations;
+	}
+	getAnimationWeight(boxIndex, boxes) {
+		if (boxIndex >= boxes.length) return 0;
+		const box = boxes[boxIndex];
+		let maxWeight = 0;
+		for (const region of this.regions) if (region.consecutiveCount >= this.animationThreshold) {
+			if (computeIoU(box, region.box) > this.iouThreshold) maxWeight = Math.max(maxWeight, region.weight);
+		}
+		return maxWeight;
+	}
 };
 async function computeAKAZEDiff(cvLib, frame1, frame2) {
-  const cv = cvLib;
-  const mat1 = new cv.Mat(frame1.height, frame1.width, cv.CV_8UC1);
-  mat1.data.set(frame1.data);
-  const mat2 = new cv.Mat(frame2.height, frame2.width, cv.CV_8UC1);
-  mat2.data.set(frame2.data);
-  const kp1 = new cvLib.KeyPointVector();
-  const kp2 = new cvLib.KeyPointVector();
-  const desc1 = new cvLib.Mat();
-  const desc2 = new cvLib.Mat();
-  const mask1 = new cvLib.Mat();
-  const mask2 = new cvLib.Mat();
-  const akaze = new cvLib.AKAZE();
-  let matches = null;
-  try {
-    akaze.detectAndCompute(mat1, mask1, kp1, desc1);
-    akaze.detectAndCompute(mat2, mask2, kp2, desc2);
-    const matchedKp1Indices = /* @__PURE__ */ new Set();
-    const matchedKp2Indices = /* @__PURE__ */ new Set();
-    if (desc1.rows > 0 && desc2.rows > 0) {
-      const matcher = new cvLib.BFMatcher(cvLib.NORM_HAMMING, false);
-      try {
-        matches = new cvLib.DMatchVectorVector();
-        matcher.knnMatch(desc1, desc2, matches, 2);
-        for (let i = 0; i < matches.size(); i++) {
-          const pair = matches.get(i);
-          if (pair.size() < 2) continue;
-          const m0 = pair.get(0);
-          const m1 = pair.get(1);
-          if (m0.distance < MATCH_DISTANCE_THRESHOLD * m1.distance) {
-            matchedKp1Indices.add(m0.queryIdx);
-            matchedKp2Indices.add(m0.trainIdx);
-          }
-        }
-      } finally {
-        matcher.delete();
-      }
-    }
-    const sNew = [];
-    for (let i = 0; i < kp2.size(); i++) {
-      if (!matchedKp2Indices.has(i)) {
-        const pt = kp2.get(i).pt;
-        sNew.push({ x: pt.x, y: pt.y });
-      }
-    }
-    const sLoss = [];
-    for (let i = 0; i < kp1.size(); i++) {
-      if (!matchedKp1Indices.has(i)) {
-        const pt = kp1.get(i).pt;
-        sLoss.push({ x: pt.x, y: pt.y });
-      }
-    }
-    return { sNew, sLoss };
-  } finally {
-    mat1.delete();
-    mat2.delete();
-    kp1.delete();
-    kp2.delete();
-    desc1.delete();
-    desc2.delete();
-    mask1.delete();
-    mask2.delete();
-    akaze.delete();
-    if (matches) matches.delete();
-  }
+	const cv = cvLib;
+	const mat1 = new cv.Mat(frame1.height, frame1.width, cv.CV_8UC1);
+	mat1.data.set(frame1.data);
+	const mat2 = new cv.Mat(frame2.height, frame2.width, cv.CV_8UC1);
+	mat2.data.set(frame2.data);
+	const kp1 = new cvLib.KeyPointVector();
+	const kp2 = new cvLib.KeyPointVector();
+	const desc1 = new cvLib.Mat();
+	const desc2 = new cvLib.Mat();
+	const mask1 = new cvLib.Mat();
+	const mask2 = new cvLib.Mat();
+	const akaze = new cvLib.AKAZE();
+	let matches = null;
+	try {
+		akaze.detectAndCompute(mat1, mask1, kp1, desc1);
+		akaze.detectAndCompute(mat2, mask2, kp2, desc2);
+		const matchedKp1Indices = /* @__PURE__ */ new Set();
+		const matchedKp2Indices = /* @__PURE__ */ new Set();
+		if (desc1.rows > 0 && desc2.rows > 0) {
+			const matcher = new cvLib.BFMatcher(cvLib.NORM_HAMMING, false);
+			try {
+				matches = new cvLib.DMatchVectorVector();
+				matcher.knnMatch(desc1, desc2, matches, 2);
+				for (let i = 0; i < matches.size(); i++) {
+					const pair = matches.get(i);
+					if (pair.size() < 2) continue;
+					const m0 = pair.get(0);
+					const m1 = pair.get(1);
+					if (m0.distance < .25 * m1.distance) {
+						matchedKp1Indices.add(m0.queryIdx);
+						matchedKp2Indices.add(m0.trainIdx);
+					}
+				}
+			} finally {
+				matcher.delete();
+			}
+		}
+		const sNew = [];
+		for (let i = 0; i < kp2.size(); i++) if (!matchedKp2Indices.has(i)) {
+			const pt = kp2.get(i).pt;
+			sNew.push({
+				x: pt.x,
+				y: pt.y
+			});
+		}
+		const sLoss = [];
+		for (let i = 0; i < kp1.size(); i++) if (!matchedKp1Indices.has(i)) {
+			const pt = kp1.get(i).pt;
+			sLoss.push({
+				x: pt.x,
+				y: pt.y
+			});
+		}
+		return {
+			sNew,
+			sLoss
+		};
+	} finally {
+		mat1.delete();
+		mat2.delete();
+		kp1.delete();
+		kp2.delete();
+		desc1.delete();
+		desc2.delete();
+		mask1.delete();
+		mask2.delete();
+		akaze.delete();
+		if (matches) matches.delete();
+	}
 }
+/**
+* Pixel-level difference fallback for AKAZE blind spots.
+*
+* When AKAZE produces sparse results (typical for UI screen recordings
+* where form fields, dropdowns, or overlays change), this function
+* detects changed regions via cv.absdiff and generates synthetic
+* Point2D[] that feed into the existing DBSCAN → IoU → G(t) pipeline.
+*
+* Algorithm:
+* 1. absdiff(frame1, frame2) → grayscale difference
+* 2. GaussianBlur → reduce JPEG compression noise
+* 3. threshold → binary mask of significant changes
+* 4. findContours → bounding rects of changed regions
+* 5. Grid sampling within each bounding rect → Point2D[]
+*/
 function computePixelDiff(cvLib, frame1, frame2) {
-  const cv = cvLib;
-  const mat1 = new cv.Mat(frame1.height, frame1.width, cv.CV_8UC1);
-  const mat2 = new cv.Mat(frame2.height, frame2.width, cv.CV_8UC1);
-  const diff = new cv.Mat();
-  const blurred = new cv.Mat();
-  const binary = new cv.Mat();
-  const contours = new cv.MatVector();
-  const hierarchy = new cv.Mat();
-  try {
-    mat1.data.set(frame1.data);
-    mat2.data.set(frame2.data);
-    cv.absdiff(mat1, mat2, diff);
-    const ksize = new cv.Size(
-      PIXELDIFF_GAUSSIAN_KERNEL,
-      PIXELDIFF_GAUSSIAN_KERNEL
-    );
-    cv.GaussianBlur(diff, blurred, ksize, 0);
-    cv.threshold(
-      blurred,
-      binary,
-      PIXELDIFF_BINARY_THRESHOLD,
-      255,
-      cv.THRESH_BINARY
-    );
-    cv.findContours(
-      binary,
-      contours,
-      hierarchy,
-      cv.RETR_EXTERNAL,
-      cv.CHAIN_APPROX_SIMPLE
-    );
-    const points = [];
-    for (let c = 0; c < contours.size(); c++) {
-      const contour = contours.get(c);
-      const rect = cv.boundingRect(contour);
-      if (rect.width * rect.height < PIXELDIFF_CONTOUR_MIN_AREA) continue;
-      for (let y = rect.y; y < rect.y + rect.height; y += PIXELDIFF_SAMPLE_SPACING) {
-        for (let x = rect.x; x < rect.x + rect.width; x += PIXELDIFF_SAMPLE_SPACING) {
-          points.push({ x, y });
-        }
-      }
-    }
-    return points;
-  } finally {
-    mat1.delete();
-    mat2.delete();
-    diff.delete();
-    blurred.delete();
-    binary.delete();
-    contours.delete();
-    hierarchy.delete();
-  }
+	const cv = cvLib;
+	const mat1 = new cv.Mat(frame1.height, frame1.width, cv.CV_8UC1);
+	const mat2 = new cv.Mat(frame2.height, frame2.width, cv.CV_8UC1);
+	const diff = new cv.Mat();
+	const blurred = new cv.Mat();
+	const binary = new cv.Mat();
+	const contours = new cv.MatVector();
+	const hierarchy = new cv.Mat();
+	try {
+		mat1.data.set(frame1.data);
+		mat2.data.set(frame2.data);
+		cv.absdiff(mat1, mat2, diff);
+		const ksize = new cv.Size(3, 3);
+		cv.GaussianBlur(diff, blurred, ksize, 0);
+		cv.threshold(blurred, binary, 30, 255, cv.THRESH_BINARY);
+		cv.findContours(binary, contours, hierarchy, cv.RETR_EXTERNAL, cv.CHAIN_APPROX_SIMPLE);
+		const points = [];
+		for (let c = 0; c < contours.size(); c++) {
+			const contour = contours.get(c);
+			const rect = cv.boundingRect(contour);
+			if (rect.width * rect.height < 100) continue;
+			for (let y = rect.y; y < rect.y + rect.height; y += 8) for (let x = rect.x; x < rect.x + rect.width; x += 8) points.push({
+				x,
+				y
+			});
+		}
+		return points;
+	} finally {
+		mat1.delete();
+		mat2.delete();
+		diff.delete();
+		blurred.delete();
+		binary.delete();
+		contours.delete();
+		hierarchy.delete();
+	}
 }
 function computeInformationGain(clusters, clusterPoints, imageArea, animationIndices, animationWeights) {
-  if (clusters.length === 0) return 0;
-  let gain = 0;
-  for (let i = 0; i < clusters.length; i++) {
-    const box = clusters[i];
-    const clusterArea = box.width * box.height;
-    if (clusterArea <= 0) continue;
-    const normalizedArea = clusterArea / imageArea;
-    const featureDensity = clusterPoints[i] / clusterArea;
-    let contribution = normalizedArea * featureDensity;
-    if (animationIndices.has(i)) {
-      const animWeight = animationWeights[i] ?? 0;
-      contribution *= 1 - animWeight;
-    }
-    gain += contribution;
-  }
-  return gain;
+	if (clusters.length === 0) return 0;
+	let gain = 0;
+	for (let i = 0; i < clusters.length; i++) {
+		const box = clusters[i];
+		const clusterArea = box.width * box.height;
+		if (clusterArea <= 0) continue;
+		let contribution = clusterArea / imageArea * (clusterPoints[i] / clusterArea);
+		if (animationIndices.has(i)) {
+			const animWeight = animationWeights[i] ?? 0;
+			contribution *= 1 - animWeight;
+		}
+		gain += contribution;
+	}
+	return gain;
 }
 async function analyzeBatch(cvLib, frames, scale, tracker, pairOffset) {
-  const edges = [];
-  const preprocessed = await Promise.all(
-    (0, import_common_utils.map)(frames, (f) => preprocessFrame(f.extractPath, scale))
-  );
-  const imageWidth = preprocessed[0]?.width ?? scale;
-  const imageHeight = preprocessed[0]?.height ?? Math.round(scale * 9 / 16);
-  const imageArea = imageWidth * imageHeight;
-  for (let i = 0; i < frames.length - 1; i++) {
-    const pairIndex = pairOffset + i;
-    try {
-      const { sNew } = await computeAKAZEDiff(
-        cvLib,
-        preprocessed[i],
-        preprocessed[i + 1]
-      );
-      let dbscanResult = dbscan(sNew, imageWidth, imageHeight);
-      let clusters = dbscanResult.boundingBoxes;
-      if (clusters.length === 0) {
-        const pixelDiffPoints = computePixelDiff(
-          cvLib,
-          preprocessed[i],
-          preprocessed[i + 1]
-        );
-        if (pixelDiffPoints.length > 0) {
-          logger.debug(
-            `Edge ${frames[i].id}->${frames[i + 1].id}: pixel-diff fallback (${pixelDiffPoints.length} points)`
-          );
-          dbscanResult = dbscan(
-            pixelDiffPoints,
-            imageWidth,
-            imageHeight,
-            void 0,
-            2
-          );
-          clusters = dbscanResult.boundingBoxes;
-        }
-      }
-      const clusterPointCounts = new Array(clusters.length).fill(0);
-      for (const label of dbscanResult.labels) {
-        if (label >= 0) {
-          clusterPointCounts[label]++;
-        }
-      }
-      const animationIndices = tracker.update(clusters, pairIndex);
-      const animationWeights = (0, import_common_utils.map)(
-        clusters,
-        (_, ci) => animationIndices.has(ci) ? tracker.getAnimationWeight(ci, clusters) : 0
-      );
-      const score = computeInformationGain(
-        clusters,
-        clusterPointCounts,
-        imageArea,
-        animationIndices,
-        animationWeights
-      );
-      logger.debug(
-        `Edge ${frames[i].id}->${frames[i + 1].id} G(t)=${score.toFixed(6)}`
-      );
-      edges.push({
-        sourceId: frames[i].id,
-        targetId: frames[i + 1].id,
-        score
-      });
-    } catch (err) {
-      logger.debug(`Frame pair analysis failed: ${String(err)}`);
-      edges.push({
-        sourceId: frames[i].id,
-        targetId: frames[i + 1].id,
-        score: 0
-      });
-    }
-  }
-  return edges;
+	const edges = [];
+	const preprocessed = await Promise.all((0, _winglet_common_utils.map)(frames, (f) => preprocessFrame(f.extractPath, scale)));
+	const imageWidth = preprocessed[0]?.width ?? scale;
+	const imageHeight = preprocessed[0]?.height ?? Math.round(scale * 9 / 16);
+	const imageArea = imageWidth * imageHeight;
+	for (let i = 0; i < frames.length - 1; i++) {
+		const pairIndex = pairOffset + i;
+		try {
+			const { sNew } = await computeAKAZEDiff(cvLib, preprocessed[i], preprocessed[i + 1]);
+			let dbscanResult = dbscan(sNew, imageWidth, imageHeight);
+			let clusters = dbscanResult.boundingBoxes;
+			if (clusters.length === 0) {
+				const pixelDiffPoints = computePixelDiff(cvLib, preprocessed[i], preprocessed[i + 1]);
+				if (pixelDiffPoints.length > 0) {
+					logger.debug(`Edge ${frames[i].id}->${frames[i + 1].id}: pixel-diff fallback (${pixelDiffPoints.length} points)`);
+					dbscanResult = dbscan(pixelDiffPoints, imageWidth, imageHeight, void 0, 2);
+					clusters = dbscanResult.boundingBoxes;
+				}
+			}
+			const clusterPointCounts = new Array(clusters.length).fill(0);
+			for (const label of dbscanResult.labels) if (label >= 0) clusterPointCounts[label]++;
+			const animationIndices = tracker.update(clusters, pairIndex);
+			const animationWeights = (0, _winglet_common_utils.map)(clusters, (_, ci) => animationIndices.has(ci) ? tracker.getAnimationWeight(ci, clusters) : 0);
+			const score = computeInformationGain(clusters, clusterPointCounts, imageArea, animationIndices, animationWeights);
+			logger.debug(`Edge ${frames[i].id}->${frames[i + 1].id} G(t)=${score.toFixed(6)}`);
+			edges.push({
+				sourceId: frames[i].id,
+				targetId: frames[i + 1].id,
+				score
+			});
+		} catch (err) {
+			logger.debug(`Frame pair analysis failed: ${String(err)}`);
+			edges.push({
+				sourceId: frames[i].id,
+				targetId: frames[i + 1].id,
+				score: 0
+			});
+		}
+	}
+	return edges;
 }
+/**
+* Analyze adjacent frame pairs to compute information gain scores (G(t)).
+* Processes frames in batches for memory efficiency.
+*
+* Pipeline:
+* 1. AKAZE Feature Set Difference
+* 2. DBSCAN Spatial Clustering
+* 3. Spatio-temporal IoU Tracking
+* 4. G(t) Information Gain Scoring
+*/
 async function analyzeFrames(ctx) {
-  const { frames } = ctx;
-  if (frames.length < 2) return { edges: [], animations: [] };
-  logger.debug(
-    `Analyzing ${frames.length} frames in batches of ${OPENCV_BATCH_SIZE}`
-  );
-  const cvLib = await ensureOpenCV();
-  const edges = [];
-  const tracker = new IoUTracker(
-    ctx.options.fps,
-    ctx.options.iouThreshold,
-    ctx.options.animationThreshold
-  );
-  const scale = ctx.options.scale;
-  for (let i = 0; i < frames.length - 1; i += OPENCV_BATCH_SIZE) {
-    const batchEnd = Math.min(i + OPENCV_BATCH_SIZE + 1, frames.length);
-    const batch = frames.slice(i, batchEnd);
-    const batchEdges = await analyzeBatch(cvLib, batch, scale, tracker, i);
-    edges.push(...batchEdges);
-    const progress = Math.min(
-      100,
-      (i + OPENCV_BATCH_SIZE) / (frames.length - 1) * 100
-    );
-    ctx.emitProgress(progress);
-  }
-  const animations = tracker.flushAndGetAnimations();
-  logger.debug(
-    `Computed ${edges.length} score edges and ${animations.length} animations`
-  );
-  return { edges, animations };
+	const { frames } = ctx;
+	if (frames.length < 2) return {
+		edges: [],
+		animations: []
+	};
+	logger.debug(`Analyzing ${frames.length} frames in batches of ${10}`);
+	const cvLib = await ensureOpenCV();
+	const edges = [];
+	const tracker = new IoUTracker(ctx.options.fps, ctx.options.iouThreshold, ctx.options.animationThreshold);
+	const scale = ctx.options.scale;
+	for (let i = 0; i < frames.length - 1; i += 10) {
+		const batchEnd = Math.min(i + 10 + 1, frames.length);
+		const batchEdges = await analyzeBatch(cvLib, frames.slice(i, batchEnd), scale, tracker, i);
+		edges.push(...batchEdges);
+		const progress = Math.min(100, (i + 10) / (frames.length - 1) * 100);
+		ctx.emitProgress(progress);
+	}
+	const animations = tracker.flushAndGetAnimations();
+	logger.debug(`Computed ${edges.length} score edges and ${animations.length} animations`);
+	return {
+		edges,
+		animations
+	};
 }
-// src/core/extractor.ts
-var import_promises2 = require("fs/promises");
-var import_node_path3 = require("path");
-var import_ffprobe = require("@ffprobe-installer/ffprobe");
-var import_common_utils2 = require("@winglet/common-utils");
-var import_execa = require("execa");
-var import_ffmpeg_static = __toESM(require("ffmpeg-static"), 1);
-// src/utils/paths.ts
-var import_promises = require("fs/promises");
-var import_node_os2 = require("os");
-var import_node_path2 = require("path");
+//#endregion
+//#region src/utils/paths.ts
 async function ensureDir(dirPath) {
-  await (0, import_promises.mkdir)(dirPath, { recursive: true });
+	await (0, node_fs_promises.mkdir)(dirPath, { recursive: true });
 }
 async function fileExists(filePath) {
-  try {
-    await (0, import_promises.stat)(filePath);
-    return true;
-  } catch {
-    return false;
-  }
+	try {
+		await (0, node_fs_promises.stat)(filePath);
+		return true;
+	} catch {
+		return false;
+	}
 }
+/**
+* Expand leading ~ to homedir. Node's path.resolve() does not expand ~,
+* so paths like ~/Desktop/foo depend on process.cwd() and can produce
+* different results when run from different directories.
+*/
 function expandTilde(p) {
-  if (p === "~") return (0, import_node_os2.homedir)();
-  if (p.startsWith("~/") || p.startsWith("~\\")) {
-    return (0, import_node_path2.resolve)((0, import_node_os2.homedir)(), p.slice(2));
-  }
-  return p;
+	if (p === "~") return (0, node_os.homedir)();
+	if (p.startsWith("~/") || p.startsWith("~\\")) return (0, node_path.resolve)((0, node_os.homedir)(), p.slice(2));
+	return p;
 }
+/**
+* Resolve path to absolute. Expands ~ to homedir first so that the result
+* does not depend on process.cwd().
+*/
 function resolveAbsolute(p) {
-  return (0, import_node_path2.resolve)(expandTilde(p));
+	return (0, node_path.resolve)(expandTilde(p));
 }
+/**
+* Derive default output directory name from input file path.
+* e.g., /path/to/video.mp4 -> /path/to/video_scenes
+*/
 function deriveOutputPath(inputPath) {
-  const dir = (0, import_node_path2.resolve)(inputPath, "..");
-  const name = (0, import_node_path2.basename)(inputPath, (0, import_node_path2.extname)(inputPath));
-  return (0, import_node_path2.resolve)(dir, `${name}_scenes`);
+	return (0, node_path.resolve)((0, node_path.resolve)(inputPath, ".."), `${(0, node_path.basename)(inputPath, (0, node_path.extname)(inputPath))}_scenes`);
 }
-// src/core/extractor.ts
+//#endregion
+//#region src/core/extractor.ts
+/**
+* Extract frames from video/GIF using FFmpeg.
+* Always uses FPS-based extraction. For long videos, FPS is automatically
+* reduced to stay within maxFrames budget.
+*/
 async function extractFrames(ctx) {
-  const framesDir = (0, import_node_path3.join)(ctx.workspacePath, "frames");
-  const { inputPath, fps, maxFrames, scale } = ctx.options;
-  if (!inputPath) {
-    throw new Error("inputPath is required for frame extraction");
-  }
-  const exists = await fileExists(inputPath);
-  if (!exists) {
-    throw new Error(`Input file not found: ${inputPath}`);
-  }
-  const metadata = await getVideoMetadata(inputPath).catch((err) => {
-    logger.debug(`ffprobe failed: ${err.message}`);
-    return null;
-  });
-  if (!metadata || !metadata.format) {
-    throw new Error(`Could not read file metadata: ${inputPath}`);
-  }
-  const formatName = metadata.format.format_name ?? "";
-  const duration = parseFloat(metadata.format.duration ?? "0");
-  const hasVideoStream = metadata.streams?.some((s) => s.codec_type === "video") ?? false;
-  if (!hasVideoStream) {
-    throw new Error(
-      `No video stream found in file: ${inputPath} (detected format: ${formatName})`
-    );
-  }
-  logger.debug(
-    `Detected format: ${formatName} (Duration: ${duration.toFixed(1)}s), path: ${inputPath}`
-  );
-  await ensureDir(framesDir);
-  let effectiveFps = fps;
-  if (duration > 0) {
-    const fpsCap = maxFrames / duration;
-    effectiveFps = Math.min(fps, fpsCap);
-    effectiveFps = Math.max(0.5, effectiveFps);
-    logger.debug(
-      `FPS: ${fps} \u2192 effective: ${effectiveFps.toFixed(2)} (maxFrames: ${maxFrames})`
-    );
-  }
-  const frames = await extractByFps(
-    inputPath,
-    framesDir,
-    effectiveFps,
-    scale,
-    duration
-  );
-  ctx.emitProgress(100);
-  logger.debug(`Extracted ${frames.length} frames`);
-  return frames;
+	const framesDir = (0, node_path.join)(ctx.workspacePath, "frames");
+	const { inputPath, fps, maxFrames, scale } = ctx.options;
+	if (!inputPath) throw new Error("inputPath is required for frame extraction");
+	if (!await fileExists(inputPath)) throw new Error(`Input file not found: ${inputPath}`);
+	const metadata = await getVideoMetadata(inputPath).catch((err) => {
+		logger.debug(`ffprobe failed: ${err.message}`);
+		return null;
+	});
+	if (!metadata || !metadata.format) throw new Error(`Could not read file metadata: ${inputPath}`);
+	const formatName = metadata.format.format_name ?? "";
+	const duration = parseFloat(metadata.format.duration ?? "0");
+	if (!(metadata.streams?.some((s) => s.codec_type === "video") ?? false)) throw new Error(`No video stream found in file: ${inputPath} (detected format: ${formatName})`);
+	logger.debug(`Detected format: ${formatName} (Duration: ${duration.toFixed(1)}s), path: ${inputPath}`);
+	await ensureDir(framesDir);
+	let effectiveFps = fps;
+	if (duration > 0) {
+		const fpsCap = maxFrames / duration;
+		effectiveFps = Math.min(fps, fpsCap);
+		effectiveFps = Math.max(.5, effectiveFps);
+		logger.debug(`FPS: ${fps} → effective: ${effectiveFps.toFixed(2)} (maxFrames: ${maxFrames})`);
+	}
+	const frames = await extractByFps(inputPath, framesDir, effectiveFps, scale, duration);
+	ctx.emitProgress(100);
+	logger.debug(`Extracted ${frames.length} frames`);
+	return frames;
 }
 async function extractByFps(inputPath, outputDir, fps, scale, duration) {
-  const outputPattern = (0, import_node_path3.join)(outputDir, FRAME_FILENAME_PATTERN);
-  await (0, import_execa.execa)(import_ffmpeg_static.default, [
-    "-i",
-    inputPath,
-    "-vf",
-    `fps=${fps},scale=-1:${scale}`,
-    "-q:v",
-    "2",
-    outputPattern
-  ]);
-  return buildFrameList(outputDir, duration);
+	const outputPattern = (0, node_path.join)(outputDir, FRAME_FILENAME_PATTERN);
+	await (0, execa.execa)(ffmpeg_static.default, [
+		"-i",
+		inputPath,
+		"-vf",
+		`fps=${fps},scale=-1:${scale}`,
+		"-q:v",
+		"2",
+		outputPattern
+	]);
+	return buildFrameList(outputDir, duration);
 }
 async function getVideoMetadata(inputPath) {
-  const { stdout } = await (0, import_execa.execa)(import_ffprobe.path, [
-    "-v",
-    "quiet",
-    "-print_format",
-    "json",
-    "-show_format",
-    "-show_streams",
-    inputPath
-  ]);
-  return JSON.parse(stdout);
+	const { stdout } = await (0, execa.execa)(_ffprobe_installer_ffprobe.path, [
+		"-v",
+		"quiet",
+		"-print_format",
+		"json",
+		"-show_format",
+		"-show_streams",
+		inputPath
+	]);
+	return JSON.parse(stdout);
 }
 async function buildFrameList(framesDir, duration) {
-  const files = await (0, import_promises2.readdir)(framesDir);
-  const jpgFiles = (0, import_common_utils2.filter)(files, (f) => f.endsWith(".jpg")).sort();
-  if (jpgFiles.length === 0) {
-    return [];
-  }
-  return (0, import_common_utils2.map)(jpgFiles, (file, index) => ({
-    id: index,
-    timestamp: duration > 0 && jpgFiles.length > 1 ? duration * index / (jpgFiles.length - 1) : index,
-    extractPath: (0, import_node_path3.join)(framesDir, file)
-  }));
+	const jpgFiles = (0, _winglet_common_utils.filter)(await (0, node_fs_promises.readdir)(framesDir), (f) => f.endsWith(".jpg")).sort();
+	if (jpgFiles.length === 0) return [];
+	return (0, _winglet_common_utils.map)(jpgFiles, (file, index) => ({
+		id: index,
+		timestamp: duration > 0 && jpgFiles.length > 1 ? duration * index / (jpgFiles.length - 1) : index,
+		extractPath: (0, node_path.join)(framesDir, file)
+	}));
 }
+/**
+* Extract frames from a specific time range of a video using FFmpeg.
+* Uses input seeking (-ss before -i) for fast seek + -t for duration.
+*
+* @param inputPath - Path to the video file
+* @param outputDir - Directory to write extracted frames
+* @param fps - Frames per second for extraction
+* @param scale - Height scale for vision analysis
+* @param startTime - Start time in seconds
+* @param duration - Duration in seconds to extract
+* @returns Array of FrameNode with segment-local timestamps (starting from 0)
+*/
 async function extractFramesForRange(inputPath, outputDir, fps, scale, startTime, duration) {
-  const outputPattern = (0, import_node_path3.join)(outputDir, FRAME_FILENAME_PATTERN);
-  await (0, import_execa.execa)(import_ffmpeg_static.default, [
-    "-ss",
-    String(startTime),
-    "-i",
-    inputPath,
-    "-t",
-    String(duration),
-    "-vf",
-    `fps=${fps},scale=-1:${scale}`,
-    "-q:v",
-    "2",
-    outputPattern
-  ]);
-  return buildFrameList(outputDir, duration);
+	const outputPattern = (0, node_path.join)(outputDir, FRAME_FILENAME_PATTERN);
+	await (0, execa.execa)(ffmpeg_static.default, [
+		"-ss",
+		String(startTime),
+		"-i",
+		inputPath,
+		"-t",
+		String(duration),
+		"-vf",
+		`fps=${fps},scale=-1:${scale}`,
+		"-q:v",
+		"2",
+		outputPattern
+	]);
+	return buildFrameList(outputDir, duration);
 }
-// src/core/input-resolver.ts
-var import_node_path5 = require("path");
-// src/core/workspace.ts
-var import_promises3 = require("fs/promises");
-var import_node_path4 = require("path");
-var import_common_utils3 = require("@winglet/common-utils");
-var import_sharp2 = __toESM(require("sharp"), 1);
+//#endregion
+//#region src/core/workspace.ts
 async function createWorkspace(sessionId) {
-  const workspacePath = getTempWorkspaceDir(sessionId);
-  await ensureDir((0, import_node_path4.join)(workspacePath, "frames"));
-  await ensureDir((0, import_node_path4.join)(workspacePath, "output"));
-  return workspacePath;
+	const workspacePath = getTempWorkspaceDir(sessionId);
+	await ensureDir((0, node_path.join)(workspacePath, "frames"));
+	await ensureDir((0, node_path.join)(workspacePath, "output"));
+	return workspacePath;
 }
 async function finalizeOutput(ctx, selectedFrames) {
-  const stagingDir = (0, import_node_path4.join)(ctx.workspacePath, "output");
-  const outputPath = ctx.options.outputPath;
-  const quality = ctx.options.quality;
-  const outputFiles = [];
-  const framesMetadata = [];
-  const totalFramesCount = ctx.frames.length;
-  const padding = Math.max(4, String(totalFramesCount).length);
-  for (let i = 0; i < selectedFrames.length; i++) {
-    const frame = selectedFrames[i];
-    const fileName = `frame_${String(frame.id + 1).padStart(padding, "0")}.jpg`;
-    const destPath = (0, import_node_path4.join)(stagingDir, fileName);
-    await (0, import_sharp2.default)(frame.extractPath).jpeg({ quality, mozjpeg: true }).toFile(destPath);
-    outputFiles.push((0, import_node_path4.join)(outputPath, fileName));
-    framesMetadata.push({
-      step: i + 1,
-      fileName,
-      frameId: frame.id + 1,
-      timestampMs: Math.round(frame.timestamp * 1e3)
-    });
-  }
-  const metadata = {
-    video: {
-      originalDurationMs: Math.round(
-        (ctx.frames.length > 0 ? ctx.frames[ctx.frames.length - 1].timestamp : 0) * 1e3
-      ),
-      fps: ctx.options.fps,
-      resolution: {
-        width: ctx.options.scale,
-        height: Math.round(ctx.options.scale * 9 / 16)
-      }
-    },
-    frames: framesMetadata,
-    animations: (0, import_common_utils3.map)(ctx.animations || [], (anim) => ({
-      ...anim,
-      startFrameId: anim.startFrameId + 1,
-      endFrameId: anim.endFrameId + 1,
-      durationMs: Math.round(anim.durationMs)
-    }))
-  };
-  const metadataPath = (0, import_node_path4.join)(stagingDir, ".metadata.json");
-  await (0, import_promises3.writeFile)(metadataPath, JSON.stringify(metadata, null, 2));
-  outputFiles.push((0, import_node_path4.join)(outputPath, ".metadata.json"));
-  await ensureDir((0, import_node_path4.join)(outputPath, ".."));
-  await (0, import_promises3.rm)(outputPath, { recursive: true, force: true });
-  await (0, import_promises3.rename)(stagingDir, outputPath);
-  return outputFiles;
+	const stagingDir = (0, node_path.join)(ctx.workspacePath, "output");
+	const outputPath = ctx.options.outputPath;
+	const quality = ctx.options.quality;
+	const outputFiles = [];
+	const framesMetadata = [];
+	const totalFramesCount = ctx.frames.length;
+	const padding = Math.max(4, String(totalFramesCount).length);
+	for (let i = 0; i < selectedFrames.length; i++) {
+		const frame = selectedFrames[i];
+		const fileName = `frame_${String(frame.id + 1).padStart(padding, "0")}.jpg`;
+		const destPath = (0, node_path.join)(stagingDir, fileName);
+		await (0, sharp.default)(frame.extractPath).jpeg({
+			quality,
+			mozjpeg: true
+		}).toFile(destPath);
+		outputFiles.push((0, node_path.join)(outputPath, fileName));
+		framesMetadata.push({
+			step: i + 1,
+			fileName,
+			frameId: frame.id + 1,
+			timestampMs: Math.round(frame.timestamp * 1e3)
+		});
+	}
+	const metadata = {
+		video: {
+			originalDurationMs: Math.round((ctx.frames.length > 0 ? ctx.frames[ctx.frames.length - 1].timestamp : 0) * 1e3),
+			fps: ctx.options.fps,
+			resolution: {
+				width: ctx.options.scale,
+				height: Math.round(ctx.options.scale * 9 / 16)
+			}
+		},
+		frames: framesMetadata,
+		animations: (0, _winglet_common_utils.map)(ctx.animations || [], (anim) => ({
+			...anim,
+			startFrameId: anim.startFrameId + 1,
+			endFrameId: anim.endFrameId + 1,
+			durationMs: Math.round(anim.durationMs)
+		}))
+	};
+	await (0, node_fs_promises.writeFile)((0, node_path.join)(stagingDir, ".metadata.json"), JSON.stringify(metadata, null, 2));
+	outputFiles.push((0, node_path.join)(outputPath, ".metadata.json"));
+	await ensureDir((0, node_path.join)(outputPath, ".."));
+	await (0, node_fs_promises.rm)(outputPath, {
+		recursive: true,
+		force: true
+	});
+	await (0, node_fs_promises.rename)(stagingDir, outputPath);
+	return outputFiles;
 }
 async function createSegmentWorkspace(parentWorkspacePath, segmentIndex) {
-  const segmentPath = (0, import_node_path4.join)(
-    parentWorkspacePath,
-    "segments",
-    String(segmentIndex)
-  );
-  await ensureDir((0, import_node_path4.join)(segmentPath, "frames"));
-  return segmentPath;
+	const segmentPath = (0, node_path.join)(parentWorkspacePath, "segments", String(segmentIndex));
+	await ensureDir((0, node_path.join)(segmentPath, "frames"));
+	return segmentPath;
 }
 async function cleanupWorkspace(workspacePath) {
-  if (!workspacePath) return;
-  try {
-    await (0, import_promises3.rm)(workspacePath, { recursive: true, force: true });
-  } catch {
-  }
+	if (!workspacePath) return;
+	try {
+		await (0, node_fs_promises.rm)(workspacePath, {
+			recursive: true,
+			force: true
+		});
+	} catch {}
 }
-var STALE_THRESHOLD_MS = 60 * 60 * 1e3;
+/**
+* Write a video buffer to a temp file in the workspace and return the path.
+* Used by 'buffer' input mode.
+*/
 async function writeInputBuffer(buffer, workspacePath) {
-  const inputDir = (0, import_node_path4.join)(workspacePath, "input");
-  await ensureDir(inputDir);
-  const tempPath = (0, import_node_path4.join)(inputDir, "input.mp4");
-  await (0, import_promises3.writeFile)(tempPath, buffer);
-  return tempPath;
+	const inputDir = (0, node_path.join)(workspacePath, "input");
+	await ensureDir(inputDir);
+	const tempPath = (0, node_path.join)(inputDir, "input.mp4");
+	await (0, node_fs_promises.writeFile)(tempPath, buffer);
+	return tempPath;
 }
+/**
+* Write an array of frame Buffers as JPG files and return FrameNode[].
+* Used by 'frames' input mode.
+*/
 async function writeInputFrames(frames, workspacePath) {
-  const framesDir = (0, import_node_path4.join)(workspacePath, "frames");
-  await ensureDir(framesDir);
-  const frameNodes = [];
-  for (let i = 0; i < frames.length; i++) {
-    const filename = `frame_${String(i).padStart(6, "0")}${FRAME_OUTPUT_EXTENSION}`;
-    const extractPath = (0, import_node_path4.join)(framesDir, filename);
-    await (0, import_promises3.writeFile)(extractPath, frames[i]);
-    frameNodes.push({ id: i, timestamp: i, extractPath });
-  }
-  return frameNodes;
+	const framesDir = (0, node_path.join)(workspacePath, "frames");
+	await ensureDir(framesDir);
+	const frameNodes = [];
+	for (let i = 0; i < frames.length; i++) {
+		const extractPath = (0, node_path.join)(framesDir, `frame_${String(i).padStart(6, "0")}${FRAME_OUTPUT_EXTENSION}`);
+		await (0, node_fs_promises.writeFile)(extractPath, frames[i]);
+		frameNodes.push({
+			id: i,
+			timestamp: i,
+			extractPath
+		});
+	}
+	return frameNodes;
 }
+/**
+* Read selected FrameNode files as Buffers with JPEG compression.
+* Used to return output buffers in 'buffer' and 'frames' modes.
+*/
 async function readFramesAsBuffers(frameNodes, quality) {
-  return Promise.all(
-    (0, import_common_utils3.map)(
-      frameNodes,
-      (f) => (0, import_sharp2.default)(f.extractPath).jpeg({ quality, mozjpeg: true }).toBuffer()
-    )
-  );
+	return Promise.all((0, _winglet_common_utils.map)(frameNodes, (f) => (0, sharp.default)(f.extractPath).jpeg({
+		quality,
+		mozjpeg: true
+	}).toBuffer()));
 }
-// src/core/input-resolver.ts
+//#endregion
+//#region src/core/input-resolver.ts
 function resolveOptions(options) {
-  const mode = options.mode;
-  const inputPath = mode === "file" ? resolveAbsolute(options.inputPath) : void 0;
-  const outputPath = options.outputPath ?? (inputPath ? deriveOutputPath(inputPath) : (0, import_node_path5.join)(process.cwd(), "scene-sieve-output"));
-  const threshold = options.threshold ?? DEFAULT_THRESHOLD;
-  if (threshold <= 0 || threshold > 1) {
-    throw new Error(
-      `threshold must be in range (0, 1], received: ${threshold}`
-    );
-  }
-  const pruneMode = "threshold-with-cap";
-  return {
-    mode,
-    inputPath,
-    count: options.count ?? DEFAULT_COUNT,
-    threshold,
-    pruneMode,
-    outputPath,
-    fps: options.fps ?? DEFAULT_FPS,
-    maxFrames: options.maxFrames ?? DEFAULT_MAX_FRAMES,
-    scale: options.scale ?? DEFAULT_SCALE,
-    quality: options.quality ?? DEFAULT_QUALITY,
-    iouThreshold: options.iouThreshold ?? IOU_THRESHOLD,
-    animationThreshold: options.animationThreshold ?? ANIMATION_FRAME_THRESHOLD,
-    debug: options.debug ?? false,
-    maxSegmentDuration: options.maxSegmentDuration ?? DEFAULT_MAX_SEGMENT_DURATION,
-    concurrency: options.concurrency ?? DEFAULT_SEGMENT_CONCURRENCY
-  };
+	const mode = options.mode;
+	const inputPath = mode === "file" ? resolveAbsolute(options.inputPath) : void 0;
+	const outputPath = options.outputPath ?? (inputPath ? deriveOutputPath(inputPath) : (0, node_path.join)(process.cwd(), "scene-sieve-output"));
+	const threshold = options.threshold ?? .5;
+	if (threshold <= 0 || threshold > 1) throw new Error(`threshold must be in range (0, 1], received: ${threshold}`);
+	return {
+		mode,
+		inputPath,
+		count: options.count ?? 20,
+		threshold,
+		pruneMode: "threshold-with-cap",
+		outputPath,
+		fps: options.fps ?? 5,
+		maxFrames: options.maxFrames ?? 300,
+		scale: options.scale ?? 720,
+		quality: options.quality ?? 80,
+		iouThreshold: options.iouThreshold ?? .9,
+		animationThreshold: options.animationThreshold ?? 5,
+		debug: options.debug ?? false,
+		maxSegmentDuration: options.maxSegmentDuration ?? 300,
+		concurrency: options.concurrency ?? 2
+	};
 }
+/**
+* Resolve the input source to a list of FrameNode[].
+*
+* - 'file'   mode: validate file exists and delegate to extractor (caller's responsibility)
+* - 'buffer' mode: write buffer as temp video file, return path via FrameNode trick (empty list)
+* - 'frames' mode: write frame buffers as JPGs, return FrameNode[]
+*/
 async function resolveInput(options, workspacePath) {
-  if (options.mode === "file") {
-    return {
-      frames: [],
-      resolvedInputPath: resolveAbsolute(options.inputPath)
-    };
-  }
-  if (options.mode === "buffer") {
-    const resolvedInputPath = await writeInputBuffer(
-      options.inputBuffer,
-      workspacePath
-    );
-    return { frames: [], resolvedInputPath };
-  }
-  if (options.mode === "frames") {
-    const frames = await writeInputFrames(options.inputFrames, workspacePath);
-    return { frames };
-  }
-  throw new Error(`Unsupported input mode: ${options.mode}`);
+	if (options.mode === "file") return {
+		frames: [],
+		resolvedInputPath: resolveAbsolute(options.inputPath)
+	};
+	if (options.mode === "buffer") return {
+		frames: [],
+		resolvedInputPath: await writeInputBuffer(options.inputBuffer, workspacePath)
+	};
+	if (options.mode === "frames") return { frames: await writeInputFrames(options.inputFrames, workspacePath) };
+	throw new Error(`Unsupported input mode: ${options.mode}`);
 }
-// src/core/pruner.ts
-var import_common_utils5 = require("@winglet/common-utils");
-// src/utils/math.ts
-var import_common_utils4 = require("@winglet/common-utils");
+//#endregion
+//#region src/utils/math.ts
+/**
+* Normalize raw scores to [0, 1] range via Robust Hybrid Normalization.
+*
+* This model combines two mathematical approaches to provide a stable "relative" threshold:
+*
+* 1. Logistic-Robust-Z (Intensity):
+*    Calculates Z-scores using Median and Median Absolute Deviation (MAD).
+*    Maps these to a sigmoid (logistic) curve. This suppresses noise (scores near median)
+*    and highlights significant signals (outliers) without letting extreme outliers
+*    crush other meaningful transitions.
+*
+* 2. CDF / Percentile Rank (Relative Position):
+*    Maps each score to its percentile rank in the sequence. This ensures that 't'
+*    always has a consistent meaning as a "relative rank" regardless of absolute values.
+*
+* The final score is a weighted sum (NORMALIZATION_ALPHA) of both.
+*
+* @param items - Array of items with scores to normalize
+* @returns normalized scores array (same length as input)
+*/
 function normalizeScores(items) {
-  if (items.length === 0) return [];
-  const safeScores = (0, import_common_utils4.map)(
-    items,
-    (e) => Number.isFinite(e.score) && e.score > 0 ? e.score : 0
-  );
-  const positiveScores = (0, import_common_utils4.filter)(safeScores, (s) => s > 0);
-  if (positiveScores.length === 0) return safeScores;
-  const sorted = [...positiveScores].sort((a, b) => a - b);
-  if (positiveScores.length <= NORMALIZATION_MIN_SAMPLE_SIZE) {
-    const min = sorted[0];
-    const max = sorted[sorted.length - 1];
-    if (max === min) return (0, import_common_utils4.map)(safeScores, (s) => s > 0 ? 1 : 0);
-    return (0, import_common_utils4.map)(
-      safeScores,
-      (s) => s <= 0 ? 0 : Math.max(0, Math.min((s - min) / (max - min), 1))
-    );
-  }
-  const median = sorted[Math.floor(sorted.length / 2)];
-  const absoluteDiffs = (0, import_common_utils4.map)(positiveScores, (v) => Math.abs(v - median));
-  const mad = [...absoluteDiffs].sort((a, b) => a - b)[Math.floor(absoluteDiffs.length / 2)];
-  const scale = mad === 0 ? median : mad * NORMALIZATION_MAD_COEFFICIENT;
-  const logisticZ = (0, import_common_utils4.map)(safeScores, (s) => {
-    if (s <= 0) return 0;
-    if (scale === 0) return 1;
-    const z = (s - median) / scale;
-    return 1 / (1 + Math.exp(-NORMALIZATION_LOGISTIC_K * z));
-  });
-  const cdf = (0, import_common_utils4.map)(safeScores, (s) => {
-    if (s <= 0) return 0;
-    const rank = sorted.findIndex((v) => v >= s);
-    return rank / sorted.length;
-  });
-  return (0, import_common_utils4.map)(
-    logisticZ,
-    (z, i) => z * (1 - NORMALIZATION_ALPHA) + cdf[i] * NORMALIZATION_ALPHA
-  );
+	if (items.length === 0) return [];
+	const safeScores = (0, _winglet_common_utils.map)(items, (e) => Number.isFinite(e.score) && e.score > 0 ? e.score : 0);
+	const positiveScores = (0, _winglet_common_utils.filter)(safeScores, (s) => s > 0);
+	if (positiveScores.length === 0) return safeScores;
+	const sorted = [...positiveScores].sort((a, b) => a - b);
+	if (positiveScores.length <= 10) {
+		const min = sorted[0];
+		const max = sorted[sorted.length - 1];
+		if (max === min) return (0, _winglet_common_utils.map)(safeScores, (s) => s > 0 ? 1 : 0);
+		return (0, _winglet_common_utils.map)(safeScores, (s) => s <= 0 ? 0 : Math.max(0, Math.min((s - min) / (max - min), 1)));
+	}
+	const median = sorted[Math.floor(sorted.length / 2)];
+	const absoluteDiffs = (0, _winglet_common_utils.map)(positiveScores, (v) => Math.abs(v - median));
+	const mad = [...absoluteDiffs].sort((a, b) => a - b)[Math.floor(absoluteDiffs.length / 2)];
+	const scale = mad === 0 ? median : mad * NORMALIZATION_MAD_COEFFICIENT;
+	const logisticZ = (0, _winglet_common_utils.map)(safeScores, (s) => {
+		if (s <= 0) return 0;
+		if (scale === 0) return 1;
+		const z = (s - median) / scale;
+		return 1 / (1 + Math.exp(-3 * z));
+	});
+	const cdf = (0, _winglet_common_utils.map)(safeScores, (s) => {
+		if (s <= 0) return 0;
+		return sorted.findIndex((v) => v >= s) / sorted.length;
+	});
+	return (0, _winglet_common_utils.map)(logisticZ, (z, i) => z * (1 - NORMALIZATION_ALPHA) + cdf[i] * NORMALIZATION_ALPHA);
 }
-// src/utils/min-heap.ts
+//#endregion
+//#region src/utils/min-heap.ts
+/**
+* Generic binary min-heap.
+*
+* Elements are ordered by a numeric `score` field.
+* push/pop: O(log N), size: O(1).
+*/
 var MinHeap = class {
-  h = [];
-  get size() {
-    return this.h.length;
-  }
-  push(entry) {
-    this.h.push(entry);
-    this.siftUp(this.h.length - 1);
-  }
-  pop() {
-    const n = this.h.length;
-    if (n === 0) return void 0;
-    const top = this.h[0];
-    const last = this.h.pop();
-    if (n > 1) {
-      this.h[0] = last;
-      this.siftDown(0);
-    }
-    return top;
-  }
-  siftUp(i) {
-    while (i > 0) {
-      const p = i - 1 >> 1;
-      if (this.h[p].score <= this.h[i].score) break;
-      [this.h[p], this.h[i]] = [this.h[i], this.h[p]];
-      i = p;
-    }
-  }
-  siftDown(i) {
-    const n = this.h.length;
-    for (; ; ) {
-      let m = i;
-      const l = 2 * i + 1;
-      const r = 2 * i + 2;
-      if (l < n && this.h[l].score < this.h[m].score) m = l;
-      if (r < n && this.h[r].score < this.h[m].score) m = r;
-      if (m === i) break;
-      [this.h[m], this.h[i]] = [this.h[i], this.h[m]];
-      i = m;
-    }
-  }
+	h = [];
+	get size() {
+		return this.h.length;
+	}
+	push(entry) {
+		this.h.push(entry);
+		this.siftUp(this.h.length - 1);
+	}
+	pop() {
+		const n = this.h.length;
+		if (n === 0) return void 0;
+		const top = this.h[0];
+		const last = this.h.pop();
+		if (n > 1) {
+			this.h[0] = last;
+			this.siftDown(0);
+		}
+		return top;
+	}
+	siftUp(i) {
+		while (i > 0) {
+			const p = i - 1 >> 1;
+			if (this.h[p].score <= this.h[i].score) break;
+			[this.h[p], this.h[i]] = [this.h[i], this.h[p]];
+			i = p;
+		}
+	}
+	siftDown(i) {
+		const n = this.h.length;
+		for (;;) {
+			let m = i;
+			const l = 2 * i + 1;
+			const r = 2 * i + 2;
+			if (l < n && this.h[l].score < this.h[m].score) m = l;
+			if (r < n && this.h[r].score < this.h[m].score) m = r;
+			if (m === i) break;
+			[this.h[m], this.h[i]] = [this.h[i], this.h[m]];
+			i = m;
+		}
+	}
 };
-// src/core/pruner.ts
+//#endregion
+//#region src/core/pruner.ts
+/**
+* Edge-aware greedy merge with re-linking — O(N log N).
+*
+* 1. Build a doubly-linked list of frames
+* 2. Insert all edges into a min-heap
+* 3. Pop the lowest-score edge (most similar pair)
+* 4. Remove the later frame (tgtId), re-link neighbors
+* 5. Push synthetic edge with score = max(left, right)
+* 6. Repeat until surviving count === targetCount
+* 7. First and last frames are never removed (boundary preservation)
+*
+* Stale heap entries (involving removed frames) are lazily skipped on pop.
+*/
 function pruneTo(graph, frames, targetCount) {
-  if (frames.length <= targetCount) {
-    return new Set((0, import_common_utils5.map)(frames, (f) => f.id));
-  }
-  const prev = /* @__PURE__ */ new Map();
-  const next = /* @__PURE__ */ new Map();
-  for (let i = 0; i < frames.length; i++) {
-    if (i > 0) prev.set(frames[i].id, frames[i - 1].id);
-    if (i < frames.length - 1) next.set(frames[i].id, frames[i + 1].id);
-  }
-  const edgeScore = /* @__PURE__ */ new Map();
-  const heap = new MinHeap();
-  for (const edge of graph) {
-    edgeScore.set(`${edge.sourceId}:${edge.targetId}`, edge.score);
-    heap.push({
-      score: edge.score,
-      srcId: edge.sourceId,
-      tgtId: edge.targetId
-    });
-  }
-  const surviving = new Set((0, import_common_utils5.map)(frames, (f) => f.id));
-  const firstId = frames[0].id;
-  const lastId = frames[frames.length - 1].id;
-  while (surviving.size > targetCount && heap.size > 0) {
-    const entry = heap.pop();
-    if (!surviving.has(entry.srcId) || !surviving.has(entry.tgtId)) continue;
-    const key = `${entry.srcId}:${entry.tgtId}`;
-    if (edgeScore.get(key) !== entry.score) continue;
-    if (entry.tgtId === firstId || entry.tgtId === lastId) continue;
-    surviving.delete(entry.tgtId);
-    edgeScore.delete(key);
-    const tgtNext = next.get(entry.tgtId);
-    if (tgtNext !== void 0) {
-      const rightKey = `${entry.tgtId}:${tgtNext}`;
-      const rightScore = edgeScore.get(rightKey) ?? 0;
-      edgeScore.delete(rightKey);
-      const newScore = Math.max(entry.score, rightScore);
-      edgeScore.set(`${entry.srcId}:${tgtNext}`, newScore);
-      heap.push({ score: newScore, srcId: entry.srcId, tgtId: tgtNext });
-      next.set(entry.srcId, tgtNext);
-      prev.set(tgtNext, entry.srcId);
-    } else {
-      next.delete(entry.srcId);
-    }
-    prev.delete(entry.tgtId);
-    next.delete(entry.tgtId);
-  }
-  return surviving;
+	if (frames.length <= targetCount) return new Set((0, _winglet_common_utils.map)(frames, (f) => f.id));
+	const prev = /* @__PURE__ */ new Map();
+	const next = /* @__PURE__ */ new Map();
+	for (let i = 0; i < frames.length; i++) {
+		if (i > 0) prev.set(frames[i].id, frames[i - 1].id);
+		if (i < frames.length - 1) next.set(frames[i].id, frames[i + 1].id);
+	}
+	const edgeScore = /* @__PURE__ */ new Map();
+	const heap = new MinHeap();
+	for (const edge of graph) {
+		edgeScore.set(`${edge.sourceId}:${edge.targetId}`, edge.score);
+		heap.push({
+			score: edge.score,
+			srcId: edge.sourceId,
+			tgtId: edge.targetId
+		});
+	}
+	const surviving = new Set((0, _winglet_common_utils.map)(frames, (f) => f.id));
+	const firstId = frames[0].id;
+	const lastId = frames[frames.length - 1].id;
+	while (surviving.size > targetCount && heap.size > 0) {
+		const entry = heap.pop();
+		if (!surviving.has(entry.srcId) || !surviving.has(entry.tgtId)) continue;
+		const key = `${entry.srcId}:${entry.tgtId}`;
+		if (edgeScore.get(key) !== entry.score) continue;
+		if (entry.tgtId === firstId || entry.tgtId === lastId) continue;
+		surviving.delete(entry.tgtId);
+		edgeScore.delete(key);
+		const tgtNext = next.get(entry.tgtId);
+		if (tgtNext !== void 0) {
+			const rightKey = `${entry.tgtId}:${tgtNext}`;
+			const rightScore = edgeScore.get(rightKey) ?? 0;
+			edgeScore.delete(rightKey);
+			const newScore = Math.max(entry.score, rightScore);
+			edgeScore.set(`${entry.srcId}:${tgtNext}`, newScore);
+			heap.push({
+				score: newScore,
+				srcId: entry.srcId,
+				tgtId: tgtNext
+			});
+			next.set(entry.srcId, tgtNext);
+			prev.set(tgtNext, entry.srcId);
+		} else next.delete(entry.srcId);
+		prev.delete(entry.tgtId);
+		next.delete(entry.tgtId);
+	}
+	return surviving;
 }
+/**
+* Non-Maximum Suppression (NMS) for consecutive edge runs.
+*
+* Consecutive edges share overlapping frames (edge i: frame i->i+1,
+* edge i+1: frame i+1->i+2), so consecutive passing edges indicate
+* the same visual transition region. This function groups consecutive
+* passing edge indices into "runs" and keeps all distinct peaks per run.
+*
+* Multi-peak detection: within each run, strict local maxima (score higher
+* than both neighbors) are identified. Each local maximum represents a
+* distinct visual transition. If no strict local maxima exist (plateau or
+* monotonic sequence), the global peak of the run is selected as fallback.
+*
+* Single-element runs are unaffected (isolated transitions preserved).
+*
+* @param graph - full ScoreEdge array (for targetId lookup)
+* @param passingIndices - edge indices that passed threshold filtering (sorted ascending)
+* @param normalizedScores - normalized score array (same length as graph)
+* @returns Set of targetIds to add to surviving set (one or more per run)
+*/
 function suppressConsecutiveRuns(graph, passingIndices, normalizedScores) {
-  const result = /* @__PURE__ */ new Set();
-  let runStart = 0;
-  while (runStart < passingIndices.length) {
-    let runEnd = runStart;
-    while (runEnd + 1 < passingIndices.length && passingIndices[runEnd + 1] === passingIndices[runEnd] + 1) {
-      runEnd++;
-    }
-    const runLen = runEnd - runStart + 1;
-    if (runLen === 1) {
-      result.add(graph[passingIndices[runStart]].targetId);
-    } else {
-      const peaks = [];
-      for (let j = runStart; j <= runEnd; j++) {
-        const idx = passingIndices[j];
-        const score = normalizedScores[idx];
-        const prevScore = j > runStart ? normalizedScores[passingIndices[j - 1]] : -Infinity;
-        const nextScore = j < runEnd ? normalizedScores[passingIndices[j + 1]] : -Infinity;
-        if (score > prevScore && score > nextScore) {
-          peaks.push(idx);
-        }
-      }
-      if (peaks.length > 0) {
-        for (const peakIdx of peaks) {
-          result.add(graph[peakIdx].targetId);
-        }
-      } else {
-        let peakIdx = passingIndices[runStart];
-        for (let j = runStart + 1; j <= runEnd; j++) {
-          const idx = passingIndices[j];
-          if (normalizedScores[idx] > normalizedScores[peakIdx]) {
-            peakIdx = idx;
-          }
-        }
-        result.add(graph[peakIdx].targetId);
-      }
-    }
-    runStart = runEnd + 1;
-  }
-  return result;
+	const result = /* @__PURE__ */ new Set();
+	let runStart = 0;
+	while (runStart < passingIndices.length) {
+		let runEnd = runStart;
+		while (runEnd + 1 < passingIndices.length && passingIndices[runEnd + 1] === passingIndices[runEnd] + 1) runEnd++;
+		if (runEnd - runStart + 1 === 1) result.add(graph[passingIndices[runStart]].targetId);
+		else {
+			const peaks = [];
+			for (let j = runStart; j <= runEnd; j++) {
+				const idx = passingIndices[j];
+				const score = normalizedScores[idx];
+				const prevScore = j > runStart ? normalizedScores[passingIndices[j - 1]] : -Infinity;
+				const nextScore = j < runEnd ? normalizedScores[passingIndices[j + 1]] : -Infinity;
+				if (score > prevScore && score > nextScore) peaks.push(idx);
+			}
+			if (peaks.length > 0) for (const peakIdx of peaks) result.add(graph[peakIdx].targetId);
+			else {
+				let peakIdx = passingIndices[runStart];
+				for (let j = runStart + 1; j <= runEnd; j++) {
+					const idx = passingIndices[j];
+					if (normalizedScores[idx] > normalizedScores[peakIdx]) peakIdx = idx;
+				}
+				result.add(graph[peakIdx].targetId);
+			}
+		}
+		runStart = runEnd + 1;
+	}
+	return result;
 }
+/**
+* Threshold-based pruning with NMS -- O(N).
+*
+* 1. Scores are normalized to [0, 1] via percentile normalization.
+* 2. Edges with normalized score >= threshold are collected.
+* 3. Non-Maximum Suppression groups consecutive passing edges and keeps
+*    only the peak per run, preventing near-duplicate frame selection
+*    from a single visual transition.
+*
+* First and last frames are always preserved (boundary protection).
+*/
 function pruneByThreshold(graph, frames, threshold) {
-  if (frames.length === 0) return /* @__PURE__ */ new Set();
-  const surviving = /* @__PURE__ */ new Set();
-  surviving.add(frames[0].id);
-  surviving.add(frames[frames.length - 1].id);
-  const normalized = normalizeScores(graph);
-  const passingIndices = [];
-  for (let i = 0; i < graph.length; i++) {
-    if (normalized[i] >= threshold) {
-      passingIndices.push(i);
-    }
-  }
-  const nmsTargets = suppressConsecutiveRuns(graph, passingIndices, normalized);
-  for (const id of nmsTargets) {
-    surviving.add(id);
-  }
-  return surviving;
+	if (frames.length === 0) return /* @__PURE__ */ new Set();
+	const surviving = /* @__PURE__ */ new Set();
+	surviving.add(frames[0].id);
+	surviving.add(frames[frames.length - 1].id);
+	const normalized = normalizeScores(graph);
+	const passingIndices = [];
+	for (let i = 0; i < graph.length; i++) if (normalized[i] >= threshold) passingIndices.push(i);
+	const nmsTargets = suppressConsecutiveRuns(graph, passingIndices, normalized);
+	for (const id of nmsTargets) surviving.add(id);
+	return surviving;
 }
+/**
+* Combined threshold + count pruning -- 2-stage pipeline.
+*
+* Stage 1: pruneByThreshold -- keep all frames with normalized score >= threshold
+* Stage 2: if result exceeds maxCount, rebuild subgraph with synthetic edges
+*          (min-score over each gap) and apply pruneTo on the surviving subset
+*
+* Edge reconstruction: for consecutive survivors A, B with removed frames
+* [x1, x2, ...] between them, the synthetic edge score is:
+*   min(score(A->x1), score(x1->x2), ..., score(xN->B))
+* This preserves the "weakest link" semantics.
+*/
 function pruneByThresholdWithCap(graph, frames, threshold, maxCount) {
-  const thresholdSurvivors = pruneByThreshold(graph, frames, threshold);
-  if (thresholdSurvivors.size <= maxCount) {
-    return thresholdSurvivors;
-  }
-  const survivingFrames = (0, import_common_utils5.filter)(frames, (f) => thresholdSurvivors.has(f.id));
-  const idToOrigIdx = /* @__PURE__ */ new Map();
-  for (let i = 0; i < frames.length; i++) {
-    idToOrigIdx.set(frames[i].id, i);
-  }
-  const edgeLookup = /* @__PURE__ */ new Map();
-  for (const e of graph) {
-    edgeLookup.set(`${e.sourceId}:${e.targetId}`, e.score);
-  }
-  const syntheticEdges = [];
-  for (let i = 0; i < survivingFrames.length - 1; i++) {
-    const srcSurvivor = survivingFrames[i];
-    const tgtSurvivor = survivingFrames[i + 1];
-    const srcOrigIdx = idToOrigIdx.get(srcSurvivor.id);
-    const tgtOrigIdx = idToOrigIdx.get(tgtSurvivor.id);
-    let minScore = Infinity;
-    for (let j = srcOrigIdx; j < tgtOrigIdx; j++) {
-      const fromId = frames[j].id;
-      const toId = frames[j + 1].id;
-      const score = edgeLookup.get(`${fromId}:${toId}`) ?? 0;
-      if (score < minScore) {
-        minScore = score;
-      }
-    }
-    syntheticEdges.push({
-      sourceId: srcSurvivor.id,
-      targetId: tgtSurvivor.id,
-      score: minScore === Infinity ? 0 : minScore
-    });
-  }
-  return pruneTo(syntheticEdges, survivingFrames, maxCount);
+	const thresholdSurvivors = pruneByThreshold(graph, frames, threshold);
+	if (thresholdSurvivors.size <= maxCount) return thresholdSurvivors;
+	const survivingFrames = (0, _winglet_common_utils.filter)(frames, (f) => thresholdSurvivors.has(f.id));
+	const idToOrigIdx = /* @__PURE__ */ new Map();
+	for (let i = 0; i < frames.length; i++) idToOrigIdx.set(frames[i].id, i);
+	const edgeLookup = /* @__PURE__ */ new Map();
+	for (const e of graph) edgeLookup.set(`${e.sourceId}:${e.targetId}`, e.score);
+	const syntheticEdges = [];
+	for (let i = 0; i < survivingFrames.length - 1; i++) {
+		const srcSurvivor = survivingFrames[i];
+		const tgtSurvivor = survivingFrames[i + 1];
+		const srcOrigIdx = idToOrigIdx.get(srcSurvivor.id);
+		const tgtOrigIdx = idToOrigIdx.get(tgtSurvivor.id);
+		let minScore = Infinity;
+		for (let j = srcOrigIdx; j < tgtOrigIdx; j++) {
+			const fromId = frames[j].id;
+			const toId = frames[j + 1].id;
+			const score = edgeLookup.get(`${fromId}:${toId}`) ?? 0;
+			if (score < minScore) minScore = score;
+		}
+		syntheticEdges.push({
+			sourceId: srcSurvivor.id,
+			targetId: tgtSurvivor.id,
+			score: minScore === Infinity ? 0 : minScore
+		});
+	}
+	return pruneTo(syntheticEdges, survivingFrames, maxCount);
 }
-// src/core/segmenter.ts
-var import_node_crypto = require("crypto");
-var import_node_path6 = require("path");
-var import_common_utils6 = require("@winglet/common-utils");
-// src/utils/concurrency.ts
+//#endregion
+//#region src/utils/concurrency.ts
+/**
+* Creates a concurrency limiter that runs at most `limit` tasks in parallel.
+* Lightweight replacement for p-limit to avoid external dependency.
+*/
 function concurrencyLimit(limit) {
-  limit = Math.max(1, limit);
-  let active = 0;
-  const queue = [];
-  return async (fn) => {
-    while (active >= limit) {
-      await new Promise((resolve2) => queue.push(resolve2));
-    }
-    active++;
-    try {
-      return await fn();
-    } finally {
-      active--;
-      queue.shift()?.();
-    }
-  };
+	limit = Math.max(1, limit);
+	let active = 0;
+	const queue = [];
+	return async (fn) => {
+		while (active >= limit) await new Promise((resolve) => queue.push(resolve));
+		active++;
+		try {
+			return await fn();
+		} finally {
+			active--;
+			queue.shift()?.();
+		}
+	};
 }
-// src/core/segmenter.ts
+//#endregion
+//#region src/core/segmenter.ts
+/**
+* Determine whether segmentation should be used.
+* Returns false for frames mode and GIF files.
+* Actual duration check happens inside runSegmentedPipeline after metadata fetch.
+*/
 function shouldSegment(resolvedOptions, originalOptions) {
-  if (resolvedOptions.mode === "frames") return false;
-  if (originalOptions.mode === "file") {
-    if (originalOptions.inputPath.toLowerCase().endsWith(".gif")) return false;
-  }
-  return true;
+	if (resolvedOptions.mode === "frames") return false;
+	if (originalOptions.mode === "file") {
+		if (originalOptions.inputPath.toLowerCase().endsWith(".gif")) return false;
+	}
+	return true;
 }
+/**
+* Compute segment boundaries with overlap, frame allocation, and effectiveFps.
+* Pure function — no I/O.
+*
+* - effectiveFps is uniform across all segments
+* - Overlap: 1 frame at each internal boundary
+* - allocatedFrames total <= maxFrames (last segment adjusted if needed)
+*/
 function computeSegmentPlan(totalDuration, maxSegmentDuration, maxFrames, fps) {
-  const effectiveFps = Math.max(0.5, Math.min(fps, maxFrames / totalDuration));
-  if (totalDuration <= maxSegmentDuration) {
-    return [
-      {
-        index: 0,
-        startTime: 0,
-        endTime: totalDuration,
-        duration: totalDuration,
-        allocatedFrames: Math.min(
-          Math.ceil(effectiveFps * totalDuration),
-          maxFrames
-        ),
-        effectiveFps,
-        overlapBefore: 0,
-        overlapAfter: 0,
-        extractStartTime: 0,
-        extractDuration: totalDuration
-      }
-    ];
-  }
-  const segmentCount = Math.ceil(totalDuration / maxSegmentDuration);
-  const overlapTime = 1 / effectiveFps;
-  const segments = [];
-  for (let i = 0; i < segmentCount; i++) {
-    const startTime = i * maxSegmentDuration;
-    const endTime = Math.min((i + 1) * maxSegmentDuration, totalDuration);
-    const duration = endTime - startTime;
-    const overlapBefore = i > 0 ? 1 : 0;
-    const overlapAfter = i < segmentCount - 1 ? 1 : 0;
-    const extractStartTime = Math.max(
-      0,
-      startTime - overlapBefore * overlapTime
-    );
-    const extractEndTime = Math.min(
-      totalDuration,
-      endTime + overlapAfter * overlapTime
-    );
-    const extractDuration = extractEndTime - extractStartTime;
-    segments.push({
-      index: i,
-      startTime,
-      endTime,
-      duration,
-      allocatedFrames: Math.ceil(effectiveFps * duration),
-      effectiveFps,
-      overlapBefore,
-      overlapAfter,
-      extractStartTime,
-      extractDuration
-    });
-  }
-  const totalAllocated = segments.reduce(
-    (sum, s) => sum + s.allocatedFrames,
-    0
-  );
-  if (totalAllocated > maxFrames) {
-    segments[segments.length - 1].allocatedFrames -= totalAllocated - maxFrames;
-  }
-  return segments;
+	const effectiveFps = Math.max(.5, Math.min(fps, maxFrames / totalDuration));
+	if (totalDuration <= maxSegmentDuration) return [{
+		index: 0,
+		startTime: 0,
+		endTime: totalDuration,
+		duration: totalDuration,
+		allocatedFrames: Math.min(Math.ceil(effectiveFps * totalDuration), maxFrames),
+		effectiveFps,
+		overlapBefore: 0,
+		overlapAfter: 0,
+		extractStartTime: 0,
+		extractDuration: totalDuration
+	}];
+	const segmentCount = Math.ceil(totalDuration / maxSegmentDuration);
+	const overlapTime = 1 / effectiveFps;
+	const segments = [];
+	for (let i = 0; i < segmentCount; i++) {
+		const startTime = i * maxSegmentDuration;
+		const endTime = Math.min((i + 1) * maxSegmentDuration, totalDuration);
+		const duration = endTime - startTime;
+		const overlapBefore = i > 0 ? 1 : 0;
+		const overlapAfter = i < segmentCount - 1 ? 1 : 0;
+		const extractStartTime = Math.max(0, startTime - overlapBefore * overlapTime);
+		const extractDuration = Math.min(totalDuration, endTime + overlapAfter * overlapTime) - extractStartTime;
+		segments.push({
+			index: i,
+			startTime,
+			endTime,
+			duration,
+			allocatedFrames: Math.ceil(effectiveFps * duration),
+			effectiveFps,
+			overlapBefore,
+			overlapAfter,
+			extractStartTime,
+			extractDuration
+		});
+	}
+	const totalAllocated = segments.reduce((sum, s) => sum + s.allocatedFrames, 0);
+	if (totalAllocated > maxFrames) segments[segments.length - 1].allocatedFrames -= totalAllocated - maxFrames;
+	return segments;
 }
+/**
+* Collect all frames from every segment, adjusting timestamps by extractStartTime.
+*/
 function collectAllFrames(segmentResults) {
-  const allFrames = [];
-  for (const result of segmentResults) {
-    for (const frame of result.frames) {
-      allFrames.push({
-        frame: {
-          ...frame,
-          // Use extractStartTime for timestamp correction (Section 18 note 1)
-          timestamp: frame.timestamp + result.segment.extractStartTime
-        },
-        segmentIndex: result.segment.index,
-        localId: frame.id
-      });
-    }
-  }
-  return allFrames;
+	const allFrames = [];
+	for (const result of segmentResults) for (const frame of result.frames) allFrames.push({
+		frame: {
+			...frame,
+			timestamp: frame.timestamp + result.segment.extractStartTime
+		},
+		segmentIndex: result.segment.index,
+		localId: frame.id
+	});
+	return allFrames;
 }
+/**
+* Sort frames by timestamp then remove overlap duplicates.
+* Threshold: 1/(effectiveFps * 2) — adaptive to fps (Section 18 note 5).
+* Keeps the first occurrence (earlier segment).
+*/
 function deduplicateFrames(frames, effectiveFps) {
-  frames.sort((a, b) => a.frame.timestamp - b.frame.timestamp);
-  const dupThreshold = 1 / (effectiveFps * 2);
-  const unique = [];
-  for (const entry of frames) {
-    if (unique.length > 0) {
-      const last = unique[unique.length - 1];
-      if (Math.abs(entry.frame.timestamp - last.frame.timestamp) < dupThreshold) {
-        continue;
-      }
-    }
-    unique.push(entry);
-  }
-  return unique;
+	frames.sort((a, b) => a.frame.timestamp - b.frame.timestamp);
+	const dupThreshold = 1 / (effectiveFps * 2);
+	const unique = [];
+	for (const entry of frames) {
+		if (unique.length > 0) {
+			const last = unique[unique.length - 1];
+			if (Math.abs(entry.frame.timestamp - last.frame.timestamp) < dupThreshold) continue;
+		}
+		unique.push(entry);
+	}
+	return unique;
 }
+/**
+* Assign sequential global IDs to deduplicated frames and build a lookup map.
+* Returns the remapped FrameNode array and the "segmentIndex:localId" -> globalId map.
+*/
 function remapFrameIds(uniqueFrames) {
-  const globalIdMap = /* @__PURE__ */ new Map();
-  const frames = uniqueFrames.map((entry, globalId) => {
-    globalIdMap.set(`${entry.segmentIndex}:${entry.localId}`, globalId);
-    return {
-      id: globalId,
-      timestamp: entry.frame.timestamp,
-      extractPath: entry.frame.extractPath
-    };
-  });
-  return { frames, globalIdMap };
+	const globalIdMap = /* @__PURE__ */ new Map();
+	return {
+		frames: uniqueFrames.map((entry, globalId) => {
+			globalIdMap.set(`${entry.segmentIndex}:${entry.localId}`, globalId);
+			return {
+				id: globalId,
+				timestamp: entry.frame.timestamp,
+				extractPath: entry.frame.extractPath
+			};
+		}),
+		globalIdMap
+	};
 }
+/**
+* Remap edge source/target IDs using the global ID map.
+* Duplicate edges (same source-target pair) retain the higher score.
+*/
 function remapEdges(segmentResults, globalIdMap) {
-  const edges = [];
-  const edgeMap = /* @__PURE__ */ new Map();
-  for (const result of segmentResults) {
-    for (const edge of result.edges) {
-      const newSourceId = globalIdMap.get(
-        `${result.segment.index}:${edge.sourceId}`
-      );
-      const newTargetId = globalIdMap.get(
-        `${result.segment.index}:${edge.targetId}`
-      );
-      if (newSourceId === void 0 || newTargetId === void 0) continue;
-      const edgeKey = `${newSourceId}-${newTargetId}`;
-      const existingIdx = edgeMap.get(edgeKey);
-      if (existingIdx !== void 0) {
-        if (edges[existingIdx].score < edge.score) {
-          edges[existingIdx] = {
-            sourceId: newSourceId,
-            targetId: newTargetId,
-            score: edge.score
-          };
-        }
-      } else {
-        edgeMap.set(edgeKey, edges.length);
-        edges.push({
-          sourceId: newSourceId,
-          targetId: newTargetId,
-          score: edge.score
-        });
-      }
-    }
-  }
-  return edges;
+	const edges = [];
+	const edgeMap = /* @__PURE__ */ new Map();
+	for (const result of segmentResults) for (const edge of result.edges) {
+		const newSourceId = globalIdMap.get(`${result.segment.index}:${edge.sourceId}`);
+		const newTargetId = globalIdMap.get(`${result.segment.index}:${edge.targetId}`);
+		if (newSourceId === void 0 || newTargetId === void 0) continue;
+		const edgeKey = `${newSourceId}-${newTargetId}`;
+		const existingIdx = edgeMap.get(edgeKey);
+		if (existingIdx !== void 0) {
+			if (edges[existingIdx].score < edge.score) edges[existingIdx] = {
+				sourceId: newSourceId,
+				targetId: newTargetId,
+				score: edge.score
+			};
+		} else {
+			edgeMap.set(edgeKey, edges.length);
+			edges.push({
+				sourceId: newSourceId,
+				targetId: newTargetId,
+				score: edge.score
+			});
+		}
+	}
+	return edges;
 }
+/**
+* Remap animation startFrameId/endFrameId using the global ID map.
+* Animations whose frame IDs were deduplicated (not in map) are dropped.
+*/
 function remapAnimations(segmentResults, globalIdMap) {
-  const animations = [];
-  for (const result of segmentResults) {
-    for (const anim of result.animations) {
-      const newStartId = globalIdMap.get(
-        `${result.segment.index}:${anim.startFrameId}`
-      );
-      const newEndId = globalIdMap.get(
-        `${result.segment.index}:${anim.endFrameId}`
-      );
-      if (newStartId === void 0 || newEndId === void 0) continue;
-      animations.push({
-        ...anim,
-        startFrameId: newStartId,
-        endFrameId: newEndId
-      });
-    }
-  }
-  return animations;
+	const animations = [];
+	for (const result of segmentResults) for (const anim of result.animations) {
+		const newStartId = globalIdMap.get(`${result.segment.index}:${anim.startFrameId}`);
+		const newEndId = globalIdMap.get(`${result.segment.index}:${anim.endFrameId}`);
+		if (newStartId === void 0 || newEndId === void 0) continue;
+		animations.push({
+			...anim,
+			startFrameId: newStartId,
+			endFrameId: newEndId
+		});
+	}
+	return animations;
 }
+/**
+* Merge multiple segment results into a single unified frame/edge/animation set.
+* - Timestamps adjusted using extractStartTime (Section 18 note 1)
+* - Overlap frames deduplicated by threshold 1/(effectiveFps*2) (Section 18 note 5)
+* - Global IDs reassigned after dedup
+* - Duplicate edges keep higher score
+*/
 function mergeSegmentFrames(segmentResults) {
-  if (segmentResults.length === 0) {
-    return { frames: [], edges: [], animations: [] };
-  }
-  const effectiveFps = segmentResults[0].segment.effectiveFps;
-  const allFrames = collectAllFrames(segmentResults);
-  const uniqueFrames = deduplicateFrames(allFrames, effectiveFps);
-  const { frames, globalIdMap } = remapFrameIds(uniqueFrames);
-  const edges = remapEdges(segmentResults, globalIdMap);
-  const animations = remapAnimations(segmentResults, globalIdMap);
-  return { frames, edges, animations };
+	if (segmentResults.length === 0) return {
+		frames: [],
+		edges: [],
+		animations: []
+	};
+	const effectiveFps = segmentResults[0].segment.effectiveFps;
+	const { frames, globalIdMap } = remapFrameIds(deduplicateFrames(collectAllFrames(segmentResults), effectiveFps));
+	return {
+		frames,
+		edges: remapEdges(segmentResults, globalIdMap),
+		animations: remapAnimations(segmentResults, globalIdMap)
+	};
 }
 function buildSegmentContext(segment, frames, segmentWorkspacePath, resolvedOptions, onProgress) {
-  return {
-    options: {
-      ...resolvedOptions,
-      fps: segment.effectiveFps,
-      maxFrames: segment.allocatedFrames
-    },
-    workspacePath: segmentWorkspacePath,
-    frames,
-    graph: [],
-    status: "ANALYZING",
-    emitProgress: onProgress
-  };
+	return {
+		options: {
+			...resolvedOptions,
+			fps: segment.effectiveFps,
+			maxFrames: segment.allocatedFrames
+		},
+		workspacePath: segmentWorkspacePath,
+		frames,
+		graph: [],
+		status: "ANALYZING",
+		emitProgress: onProgress
+	};
 }
+/**
+* Extract frames for a single segment and analyze them.
+* Each segment uses an isolated workspace directory.
+*/
 async function processSegment(inputPath, segment, workspacePath, resolvedOptions, onProgress) {
-  const framesDir = (0, import_node_path6.join)(workspacePath, "frames");
-  const frames = await extractFramesForRange(
-    inputPath,
-    framesDir,
-    segment.effectiveFps,
-    resolvedOptions.scale,
-    segment.extractStartTime,
-    segment.extractDuration
-  );
-  if (frames.length < 2) {
-    return { segment, frames, edges: [], animations: [] };
-  }
-  const ctx = buildSegmentContext(
-    segment,
-    frames,
-    workspacePath,
-    resolvedOptions,
-    onProgress
-  );
-  const { edges, animations } = await analyzeFrames(ctx);
-  return { segment, frames, edges, animations };
+	const frames = await extractFramesForRange(inputPath, (0, node_path.join)(workspacePath, "frames"), segment.effectiveFps, resolvedOptions.scale, segment.extractStartTime, segment.extractDuration);
+	if (frames.length < 2) return {
+		segment,
+		frames,
+		edges: [],
+		animations: []
+	};
+	const { edges, animations } = await analyzeFrames(buildSegmentContext(segment, frames, workspacePath, resolvedOptions, onProgress));
+	return {
+		segment,
+		frames,
+		edges,
+		animations
+	};
 }
+/**
+* Full segmented pipeline: metadata → plan → parallel extract+analyze → merge → prune → finalize.
+* Called from runPipeline when shouldSegment() returns true.
+*/
 async function runSegmentedPipeline(options, resolvedOptions) {
-  const pipelineStart = Date.now();
-  const sessionId = (0, import_node_crypto.randomUUID)();
-  let mainWorkspace = "";
-  try {
-    mainWorkspace = await createWorkspace(sessionId);
-    logger.debug(`Segmented pipeline: workspace at ${mainWorkspace}`);
-    const { resolvedInputPath } = await resolveInput(options, mainWorkspace);
-    const inputPath = resolvedInputPath ?? resolvedOptions.inputPath;
-    if (!inputPath) {
-      throw new Error("No input path available for segmented pipeline");
-    }
-    const metadata = await getVideoMetadata(inputPath);
-    const totalDuration = parseFloat(metadata.format?.duration ?? "0");
-    if (totalDuration <= 0) {
-      throw new Error(`Invalid video duration: ${totalDuration}`);
-    }
-    logger.debug(`Video duration: ${totalDuration}s`);
-    const segments = computeSegmentPlan(
-      totalDuration,
-      resolvedOptions.maxSegmentDuration,
-      resolvedOptions.maxFrames,
-      resolvedOptions.fps
-    );
-    logger.debug(`Segment plan: ${segments.length} segments`);
-    const limit = concurrencyLimit(resolvedOptions.concurrency);
-    const segmentProgresses = new Array(segments.length).fill(0);
-    const weights = (0, import_common_utils6.map)(segments, (s) => s.duration / totalDuration);
-    const emitOverallProgress = (phase) => {
-      if (!options.onProgress) return;
-      const overall = weights.reduce(
-        (sum, w, i) => sum + w * (segmentProgresses[i] ?? 0),
-        0
-      );
-      options.onProgress(phase, Math.min(100, overall));
-    };
-    options.onProgress?.("EXTRACTING", 0);
-    const results = await Promise.all(
-      (0, import_common_utils6.map)(
-        segments,
-        (segment) => limit(async () => {
-          const segWorkspace = await createSegmentWorkspace(
-            mainWorkspace,
-            segment.index
-          );
-          const result = await processSegment(
-            inputPath,
-            segment,
-            segWorkspace,
-            resolvedOptions,
-            (percent) => {
-              segmentProgresses[segment.index] = percent;
-              emitOverallProgress("ANALYZING");
-            }
-          );
-          return result;
-        })
-      )
-    );
-    options.onProgress?.("ANALYZING", 100);
-    const { frames, edges, animations } = mergeSegmentFrames(results);
-    logger.debug(
-      `Merged: ${frames.length} frames, ${edges.length} edges, ${animations.length} animations`
-    );
-    options.onProgress?.("PRUNING", 0);
-    const survivingIds = pruneByThresholdWithCap(
-      edges,
-      frames,
-      resolvedOptions.threshold,
-      resolvedOptions.count
-    );
-    const prunedFrames = (0, import_common_utils6.filter)(frames, (f) => survivingIds.has(f.id));
-    options.onProgress?.("PRUNING", 100);
-    options.onProgress?.("FINALIZING", 0);
-    const ctx = {
-      options: resolvedOptions,
-      workspacePath: mainWorkspace,
-      frames,
-      graph: edges,
-      animations,
-      status: "FINALIZING",
-      emitProgress: (percent) => options.onProgress?.("FINALIZING", percent)
-    };
-    let outputFiles = [];
-    let outputBuffers;
-    if (resolvedOptions.mode === "buffer" || resolvedOptions.mode === "frames") {
-      outputBuffers = await readFramesAsBuffers(
-        prunedFrames,
-        resolvedOptions.quality
-      );
-    } else {
-      outputFiles = await finalizeOutput(ctx, prunedFrames);
-    }
-    options.onProgress?.("FINALIZING", 100);
-    logger.success(
-      `Segmented pipeline: ${prunedFrames.length} scenes from ${frames.length} frames (${segments.length} segments)`
-    );
-    return {
-      success: true,
-      originalFramesCount: frames.length,
-      prunedFramesCount: prunedFrames.length,
-      outputFiles,
-      outputBuffers,
-      animations,
-      video: {
-        originalDurationMs: totalDuration * 1e3,
-        fps: resolvedOptions.fps,
-        resolution: {
-          width: resolvedOptions.scale,
-          height: Math.round(resolvedOptions.scale * 9 / 16)
-        }
-      },
-      executionTimeMs: Date.now() - pipelineStart
-    };
-  } catch (error) {
-    const err = error instanceof Error ? error : new Error(String(error));
-    logger.error(`Segmented pipeline failed: ${err.message}`);
-    throw err;
-  } finally {
-    if (!resolvedOptions.debug) {
-      await cleanupWorkspace(mainWorkspace);
-    } else {
-      logger.debug(`Debug mode: workspace preserved at ${mainWorkspace}`);
-    }
-  }
+	const pipelineStart = Date.now();
+	const sessionId = (0, node_crypto.randomUUID)();
+	let mainWorkspace = "";
+	try {
+		mainWorkspace = await createWorkspace(sessionId);
+		logger.debug(`Segmented pipeline: workspace at ${mainWorkspace}`);
+		const { resolvedInputPath } = await resolveInput(options, mainWorkspace);
+		const inputPath = resolvedInputPath ?? resolvedOptions.inputPath;
+		if (!inputPath) throw new Error("No input path available for segmented pipeline");
+		const metadata = await getVideoMetadata(inputPath);
+		const totalDuration = parseFloat(metadata.format?.duration ?? "0");
+		if (totalDuration <= 0) throw new Error(`Invalid video duration: ${totalDuration}`);
+		logger.debug(`Video duration: ${totalDuration}s`);
+		const segments = computeSegmentPlan(totalDuration, resolvedOptions.maxSegmentDuration, resolvedOptions.maxFrames, resolvedOptions.fps);
+		logger.debug(`Segment plan: ${segments.length} segments`);
+		const limit = concurrencyLimit(resolvedOptions.concurrency);
+		const segmentProgresses = new Array(segments.length).fill(0);
+		const weights = (0, _winglet_common_utils.map)(segments, (s) => s.duration / totalDuration);
+		const emitOverallProgress = (phase) => {
+			if (!options.onProgress) return;
+			const overall = weights.reduce((sum, w, i) => sum + w * (segmentProgresses[i] ?? 0), 0);
+			options.onProgress(phase, Math.min(100, overall));
+		};
+		options.onProgress?.("EXTRACTING", 0);
+		const results = await Promise.all((0, _winglet_common_utils.map)(segments, (segment) => limit(async () => {
+			const segWorkspace = await createSegmentWorkspace(mainWorkspace, segment.index);
+			return await processSegment(inputPath, segment, segWorkspace, resolvedOptions, (percent) => {
+				segmentProgresses[segment.index] = percent;
+				emitOverallProgress("ANALYZING");
+			});
+		})));
+		options.onProgress?.("ANALYZING", 100);
+		const { frames, edges, animations } = mergeSegmentFrames(results);
+		logger.debug(`Merged: ${frames.length} frames, ${edges.length} edges, ${animations.length} animations`);
+		options.onProgress?.("PRUNING", 0);
+		const survivingIds = pruneByThresholdWithCap(edges, frames, resolvedOptions.threshold, resolvedOptions.count);
+		const prunedFrames = (0, _winglet_common_utils.filter)(frames, (f) => survivingIds.has(f.id));
+		options.onProgress?.("PRUNING", 100);
+		options.onProgress?.("FINALIZING", 0);
+		const ctx = {
+			options: resolvedOptions,
+			workspacePath: mainWorkspace,
+			frames,
+			graph: edges,
+			animations,
+			status: "FINALIZING",
+			emitProgress: (percent) => options.onProgress?.("FINALIZING", percent)
+		};
+		let outputFiles = [];
+		let outputBuffers;
+		if (resolvedOptions.mode === "buffer" || resolvedOptions.mode === "frames") outputBuffers = await readFramesAsBuffers(prunedFrames, resolvedOptions.quality);
+		else outputFiles = await finalizeOutput(ctx, prunedFrames);
+		options.onProgress?.("FINALIZING", 100);
+		logger.success(`Segmented pipeline: ${prunedFrames.length} scenes from ${frames.length} frames (${segments.length} segments)`);
+		return {
+			success: true,
+			originalFramesCount: frames.length,
+			prunedFramesCount: prunedFrames.length,
+			outputFiles,
+			outputBuffers,
+			animations,
+			video: {
+				originalDurationMs: totalDuration * 1e3,
+				fps: resolvedOptions.fps,
+				resolution: {
+					width: resolvedOptions.scale,
+					height: Math.round(resolvedOptions.scale * 9 / 16)
+				}
+			},
+			executionTimeMs: Date.now() - pipelineStart
+		};
+	} catch (error) {
+		const err = error instanceof Error ? error : new Error(String(error));
+		logger.error(`Segmented pipeline failed: ${err.message}`);
+		throw err;
+	} finally {
+		if (!resolvedOptions.debug) await cleanupWorkspace(mainWorkspace);
+		else logger.debug(`Debug mode: workspace preserved at ${mainWorkspace}`);
+	}
 }
-// src/core/orchestrator.ts
+//#endregion
+//#region src/core/orchestrator.ts
 async function runPipeline(options) {
-  const debug = options.debug ?? false;
-  if (debug) setDebugMode(true);
-  const resolvedOptions = resolveOptions(options);
-  if (shouldSegment(resolvedOptions, options)) {
-    return runSegmentedPipeline(options, resolvedOptions);
-  }
-  const startTime = Date.now();
-  const sessionId = (0, import_node_crypto2.randomUUID)();
-  const ctx = {
-    options: resolvedOptions,
-    workspacePath: "",
-    frames: [],
-    graph: [],
-    status: "INIT",
-    emitProgress: (percent) => {
-      if (options.onProgress && ctx.status !== "INIT" && ctx.status !== "SUCCESS" && ctx.status !== "FAILED") {
-        options.onProgress(ctx.status, percent);
-      }
-    }
-  };
-  try {
-    ctx.workspacePath = await createWorkspace(sessionId);
-    logger.debug(`Workspace created: ${ctx.workspacePath}`);
-    ctx.status = "EXTRACTING";
-    const { frames: resolvedFrames, resolvedInputPath } = await resolveInput(
-      options,
-      ctx.workspacePath
-    );
-    if (resolvedOptions.mode === "frames") {
-      ctx.frames = resolvedFrames;
-    } else {
-      const extractCtx = {
-        ...ctx,
-        options: {
-          ...resolvedOptions,
-          inputPath: resolvedInputPath
-        }
-      };
-      ctx.frames = await extractFrames(extractCtx);
-    }
-    ctx.emitProgress(100);
-    ctx.status = "ANALYZING";
-    const { edges, animations } = await analyzeFrames(ctx);
-    ctx.graph = edges;
-    ctx.animations = animations;
-    ctx.status = "PRUNING";
-    const survivingIds = pruneByThresholdWithCap(
-      ctx.graph,
-      ctx.frames,
-      resolvedOptions.threshold,
-      resolvedOptions.count
-    );
-    const prunedFrames = (0, import_common_utils7.filter)(ctx.frames, (f) => survivingIds.has(f.id));
-    ctx.emitProgress(100);
-    ctx.status = "FINALIZING";
-    let outputFiles = [];
-    let outputBuffers;
-    if (resolvedOptions.mode === "buffer" || resolvedOptions.mode === "frames") {
-      outputBuffers = await readFramesAsBuffers(
-        prunedFrames,
-        resolvedOptions.quality
-      );
-      ctx.emitProgress(100);
-    } else {
-      outputFiles = await finalizeOutput(ctx, prunedFrames);
-      ctx.emitProgress(100);
-    }
-    ctx.status = "SUCCESS";
-    logger.success(
-      `Extracted ${prunedFrames.length} scenes from ${ctx.frames.length} frames`
-    );
-    return {
-      success: true,
-      originalFramesCount: ctx.frames.length,
-      prunedFramesCount: prunedFrames.length,
-      outputFiles,
-      outputBuffers,
-      animations: ctx.animations,
-      video: {
-        originalDurationMs: ctx.frames.length / ctx.options.fps * 1e3,
-        fps: ctx.options.fps,
-        resolution: {
-          width: ctx.options.scale,
-          height: Math.round(ctx.options.scale * 9 / 16)
-        }
-      },
-      executionTimeMs: Date.now() - startTime
-    };
-  } catch (error) {
-    ctx.status = "FAILED";
-    ctx.error = error instanceof Error ? error : new Error(String(error));
-    logger.error(`Pipeline failed: ${ctx.error.message}`);
-    throw ctx.error;
-  } finally {
-    if (!resolvedOptions.debug) {
-      await cleanupWorkspace(ctx.workspacePath);
-    } else {
-      logger.debug(`Debug mode: workspace preserved at ${ctx.workspacePath}`);
-    }
-  }
+	if (options.debug ?? false) setDebugMode(true);
+	const resolvedOptions = resolveOptions(options);
+	if (shouldSegment(resolvedOptions, options)) return runSegmentedPipeline(options, resolvedOptions);
+	const startTime = Date.now();
+	const sessionId = (0, node_crypto.randomUUID)();
+	const ctx = {
+		options: resolvedOptions,
+		workspacePath: "",
+		frames: [],
+		graph: [],
+		status: "INIT",
+		emitProgress: (percent) => {
+			if (options.onProgress && ctx.status !== "INIT" && ctx.status !== "SUCCESS" && ctx.status !== "FAILED") options.onProgress(ctx.status, percent);
+		}
+	};
+	try {
+		ctx.workspacePath = await createWorkspace(sessionId);
+		logger.debug(`Workspace created: ${ctx.workspacePath}`);
+		ctx.status = "EXTRACTING";
+		const { frames: resolvedFrames, resolvedInputPath } = await resolveInput(options, ctx.workspacePath);
+		if (resolvedOptions.mode === "frames") ctx.frames = resolvedFrames;
+		else ctx.frames = await extractFrames({
+			...ctx,
+			options: {
+				...resolvedOptions,
+				inputPath: resolvedInputPath
+			}
+		});
+		ctx.emitProgress(100);
+		ctx.status = "ANALYZING";
+		const { edges, animations } = await analyzeFrames(ctx);
+		ctx.graph = edges;
+		ctx.animations = animations;
+		ctx.status = "PRUNING";
+		const survivingIds = pruneByThresholdWithCap(ctx.graph, ctx.frames, resolvedOptions.threshold, resolvedOptions.count);
+		const prunedFrames = (0, _winglet_common_utils.filter)(ctx.frames, (f) => survivingIds.has(f.id));
+		ctx.emitProgress(100);
+		ctx.status = "FINALIZING";
+		let outputFiles = [];
+		let outputBuffers;
+		if (resolvedOptions.mode === "buffer" || resolvedOptions.mode === "frames") {
+			outputBuffers = await readFramesAsBuffers(prunedFrames, resolvedOptions.quality);
+			ctx.emitProgress(100);
+		} else {
+			outputFiles = await finalizeOutput(ctx, prunedFrames);
+			ctx.emitProgress(100);
+		}
+		ctx.status = "SUCCESS";
+		logger.success(`Extracted ${prunedFrames.length} scenes from ${ctx.frames.length} frames`);
+		return {
+			success: true,
+			originalFramesCount: ctx.frames.length,
+			prunedFramesCount: prunedFrames.length,
+			outputFiles,
+			outputBuffers,
+			animations: ctx.animations,
+			video: {
+				originalDurationMs: ctx.frames.length / ctx.options.fps * 1e3,
+				fps: ctx.options.fps,
+				resolution: {
+					width: ctx.options.scale,
+					height: Math.round(ctx.options.scale * 9 / 16)
+				}
+			},
+			executionTimeMs: Date.now() - startTime
+		};
+	} catch (error) {
+		ctx.status = "FAILED";
+		ctx.error = error instanceof Error ? error : new Error(String(error));
+		logger.error(`Pipeline failed: ${ctx.error.message}`);
+		throw ctx.error;
+	} finally {
+		if (!resolvedOptions.debug) await cleanupWorkspace(ctx.workspacePath);
+		else logger.debug(`Debug mode: workspace preserved at ${ctx.workspacePath}`);
+	}
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  extractScenes
-});
+//#endregion
+exports.extractScenes = runPipeline;