@lumy-pack/scene-sieve 0.0.5 → 0.0.7

package/dist/index.cjs

@@ -88,15 +88,8 @@ var DEFAULT_MAX_FRAMES = 300;
 var NORMALIZATION_PERCENTILE = 0.9;
 var WORKSPACE_PREFIX = `${APP_NAME}-`;
 var TEMP_BASE_DIR = (0, import_node_os.tmpdir)();
-var SUPPORTED_VIDEO_EXTENSIONS = [
-  ".mp4",
-  ".mov",
-  ".avi",
-  ".mkv",
-  ".webm"
-];
-var SUPPORTED_GIF_EXTENSIONS = [".gif"];
 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;
@@ -236,7 +229,13 @@ function computeIoU(a, b) {
   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();
@@ -252,7 +251,7 @@ var IoUTracker = class {
           bestRegionIdx = ri;
         }
       }
-      if (bestIoU > IOU_THRESHOLD && bestRegionIdx !== -1) {
+      if (bestIoU > this.iouThreshold && bestRegionIdx !== -1) {
         const region = this.regions[bestRegionIdx];
         const gap = pairIndex - region.lastSeen;
         region.box = box;
@@ -260,13 +259,14 @@ var IoUTracker = class {
         region.lastSeen = pairIndex;
         region.weight *= Math.pow(DECAY_LAMBDA, gap);
         matched.add(bestRegionIdx);
-        if (region.consecutiveCount >= ANIMATION_FRAME_THRESHOLD) {
+        if (region.consecutiveCount >= this.animationThreshold) {
           animationIndices.add(bi);
         }
       } else {
         this.regions.push({
           box,
           consecutiveCount: 1,
+          firstSeen: pairIndex,
           lastSeen: pairIndex,
           weight: 1
         });
@@ -278,17 +278,45 @@ var IoUTracker = class {
         this.regions[ri].weight *= Math.pow(DECAY_LAMBDA, gap);
       }
     }
-    this.regions = this.regions.filter((r) => r.weight > 0.01);
+    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 = this.regions.filter(
+      (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 >= ANIMATION_FRAME_THRESHOLD) {
+      if (region.consecutiveCount >= this.animationThreshold) {
         const iou = computeIoU(box, region.box);
-        if (iou > IOU_THRESHOLD) {
+        if (iou > this.iouThreshold) {
           maxWeight = Math.max(maxWeight, region.weight);
         }
       }
@@ -510,13 +538,17 @@ async function analyzeBatch(cvLib, frames, scale, tracker, pairOffset) {
 }
 async function analyzeFrames(ctx) {
   const { frames } = ctx;
-  if (frames.length < 2) return [];
+  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();
+  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);
@@ -529,8 +561,11 @@ async function analyzeFrames(ctx) {
     );
     ctx.emitProgress(progress);
   }
-  logger.debug(`Computed ${edges.length} score edges`);
-  return edges;
+  const animations = tracker.flushAndGetAnimations();
+  logger.debug(
+    `Computed ${edges.length} score edges and ${animations.length} animations`
+  );
+  return { edges, animations };
 }
 
 // src/core/extractor.ts
@@ -570,9 +605,6 @@ function deriveOutputPath(inputPath) {
   const name = (0, import_node_path2.basename)(inputPath, (0, import_node_path2.extname)(inputPath));
   return (0, import_node_path2.resolve)(dir, `${name}_scenes`);
 }
-function isSupportedFile(filePath, extensions) {
-  return extensions.includes((0, import_node_path2.extname)(filePath).toLowerCase());
-}
 
 // src/core/extractor.ts
 async function extractFrames(ctx) {
@@ -585,32 +617,47 @@ async function extractFrames(ctx) {
   if (!exists) {
     throw new Error(`Input file not found: ${inputPath}`);
   }
-  const allExtensions = [
-    ...SUPPORTED_VIDEO_EXTENSIONS,
-    ...SUPPORTED_GIF_EXTENSIONS
-  ];
-  if (!isSupportedFile(inputPath, allExtensions)) {
-    throw new Error(`Unsupported file format: ${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}`);
   }
-  logger.debug(`Extracting frames from: ${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;
-  const duration = await getVideoDuration(inputPath).catch(() => 0);
   if (duration > 0) {
     const fpsCap = maxFrames / duration;
     effectiveFps = Math.min(fps, fpsCap);
     effectiveFps = Math.max(0.5, effectiveFps);
     logger.debug(
-      `Duration: ${duration.toFixed(1)}s, FPS: ${fps} \u2192 effective: ${effectiveFps.toFixed(2)} (maxFrames: ${maxFrames})`
+      `FPS: ${fps} \u2192 effective: ${effectiveFps.toFixed(2)} (maxFrames: ${maxFrames})`
     );
   }
-  const frames = await extractByFps(inputPath, framesDir, effectiveFps, scale);
+  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) {
-  const outputPattern = (0, import_node_path3.join)(outputDir, "frame_%06d.jpg");
+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,
@@ -620,34 +667,26 @@ async function extractByFps(inputPath, outputDir, fps, scale) {
     "2",
     outputPattern
   ]);
-  return buildFrameList(outputDir, inputPath);
+  return buildFrameList(outputDir, duration);
 }
-async function getVideoDuration(inputPath) {
+async function getVideoMetadata(inputPath) {
   const { stdout } = await (0, import_execa.execa)(import_ffprobe.path, [
     "-v",
     "quiet",
     "-print_format",
     "json",
     "-show_format",
+    "-show_streams",
     inputPath
   ]);
-  const metadata = JSON.parse(stdout);
-  return parseFloat(metadata.format?.duration ?? "0");
+  return JSON.parse(stdout);
 }
-async function buildFrameList(framesDir, inputPath) {
+async function buildFrameList(framesDir, duration) {
   const files = await (0, import_promises2.readdir)(framesDir);
   const jpgFiles = files.filter((f) => f.endsWith(".jpg")).sort();
   if (jpgFiles.length === 0) {
     return [];
   }
-  let duration = 0;
-  try {
-    duration = await getVideoDuration(inputPath);
-  } catch {
-    logger.debug(
-      "Could not determine video duration; using frame index for timestamps"
-    );
-  }
   return jpgFiles.map((file, index) => ({
     id: index,
     timestamp: duration > 0 && jpgFiles.length > 1 ? duration * index / (jpgFiles.length - 1) : index,
@@ -673,13 +712,44 @@ async function finalizeOutput(ctx, selectedFrames) {
   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 destName = `scene_${String(i + 1).padStart(3, "0")}.jpg`;
-    const destPath = (0, import_node_path4.join)(stagingDir, destName);
+    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, destName));
+    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: (ctx.animations || []).map((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);
@@ -743,6 +813,8 @@ function resolveOptions(options) {
     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
   };
 }
@@ -1013,7 +1085,9 @@ async function runPipeline(options) {
     }
     ctx.emitProgress(100);
     ctx.status = "ANALYZING";
-    ctx.graph = await analyzeFrames(ctx);
+    const { edges, animations } = await analyzeFrames(ctx);
+    ctx.graph = edges;
+    ctx.animations = animations;
     ctx.status = "PRUNING";
     const survivingIds = pruneByThresholdWithCap(
       ctx.graph,
@@ -1046,6 +1120,15 @@ async function runPipeline(options) {
       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) {

package/dist/index.mjs

@@ -48,15 +48,8 @@ var DEFAULT_MAX_FRAMES = 300;
 var NORMALIZATION_PERCENTILE = 0.9;
 var WORKSPACE_PREFIX = `${APP_NAME}-`;
 var TEMP_BASE_DIR = tmpdir();
-var SUPPORTED_VIDEO_EXTENSIONS = [
-  ".mp4",
-  ".mov",
-  ".avi",
-  ".mkv",
-  ".webm"
-];
-var SUPPORTED_GIF_EXTENSIONS = [".gif"];
 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;
@@ -196,7 +189,13 @@ function computeIoU(a, b) {
   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();
@@ -212,7 +211,7 @@ var IoUTracker = class {
           bestRegionIdx = ri;
         }
       }
-      if (bestIoU > IOU_THRESHOLD && bestRegionIdx !== -1) {
+      if (bestIoU > this.iouThreshold && bestRegionIdx !== -1) {
         const region = this.regions[bestRegionIdx];
         const gap = pairIndex - region.lastSeen;
         region.box = box;
@@ -220,13 +219,14 @@ var IoUTracker = class {
         region.lastSeen = pairIndex;
         region.weight *= Math.pow(DECAY_LAMBDA, gap);
         matched.add(bestRegionIdx);
-        if (region.consecutiveCount >= ANIMATION_FRAME_THRESHOLD) {
+        if (region.consecutiveCount >= this.animationThreshold) {
           animationIndices.add(bi);
         }
       } else {
         this.regions.push({
           box,
           consecutiveCount: 1,
+          firstSeen: pairIndex,
           lastSeen: pairIndex,
           weight: 1
         });
@@ -238,17 +238,45 @@ var IoUTracker = class {
         this.regions[ri].weight *= Math.pow(DECAY_LAMBDA, gap);
       }
     }
-    this.regions = this.regions.filter((r) => r.weight > 0.01);
+    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 = this.regions.filter(
+      (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 >= ANIMATION_FRAME_THRESHOLD) {
+      if (region.consecutiveCount >= this.animationThreshold) {
         const iou = computeIoU(box, region.box);
-        if (iou > IOU_THRESHOLD) {
+        if (iou > this.iouThreshold) {
           maxWeight = Math.max(maxWeight, region.weight);
         }
       }
@@ -470,13 +498,17 @@ async function analyzeBatch(cvLib, frames, scale, tracker, pairOffset) {
 }
 async function analyzeFrames(ctx) {
   const { frames } = ctx;
-  if (frames.length < 2) return [];
+  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();
+  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);
@@ -489,8 +521,11 @@ async function analyzeFrames(ctx) {
     );
     ctx.emitProgress(progress);
   }
-  logger.debug(`Computed ${edges.length} score edges`);
-  return edges;
+  const animations = tracker.flushAndGetAnimations();
+  logger.debug(
+    `Computed ${edges.length} score edges and ${animations.length} animations`
+  );
+  return { edges, animations };
 }
 
 // src/core/extractor.ts
@@ -530,9 +565,6 @@ function deriveOutputPath(inputPath) {
   const name = basename(inputPath, extname(inputPath));
   return resolve(dir, `${name}_scenes`);
 }
-function isSupportedFile(filePath, extensions) {
-  return extensions.includes(extname(filePath).toLowerCase());
-}
 
 // src/core/extractor.ts
 async function extractFrames(ctx) {
@@ -545,32 +577,47 @@ async function extractFrames(ctx) {
   if (!exists) {
     throw new Error(`Input file not found: ${inputPath}`);
   }
-  const allExtensions = [
-    ...SUPPORTED_VIDEO_EXTENSIONS,
-    ...SUPPORTED_GIF_EXTENSIONS
-  ];
-  if (!isSupportedFile(inputPath, allExtensions)) {
-    throw new Error(`Unsupported file format: ${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}`);
   }
-  logger.debug(`Extracting frames from: ${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;
-  const duration = await getVideoDuration(inputPath).catch(() => 0);
   if (duration > 0) {
     const fpsCap = maxFrames / duration;
     effectiveFps = Math.min(fps, fpsCap);
     effectiveFps = Math.max(0.5, effectiveFps);
     logger.debug(
-      `Duration: ${duration.toFixed(1)}s, FPS: ${fps} \u2192 effective: ${effectiveFps.toFixed(2)} (maxFrames: ${maxFrames})`
+      `FPS: ${fps} \u2192 effective: ${effectiveFps.toFixed(2)} (maxFrames: ${maxFrames})`
     );
   }
-  const frames = await extractByFps(inputPath, framesDir, effectiveFps, scale);
+  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) {
-  const outputPattern = join2(outputDir, "frame_%06d.jpg");
+async function extractByFps(inputPath, outputDir, fps, scale, duration) {
+  const outputPattern = join2(outputDir, FRAME_FILENAME_PATTERN);
   await execa(ffmpegPath, [
     "-i",
     inputPath,
@@ -580,34 +627,26 @@ async function extractByFps(inputPath, outputDir, fps, scale) {
     "2",
     outputPattern
   ]);
-  return buildFrameList(outputDir, inputPath);
+  return buildFrameList(outputDir, duration);
 }
-async function getVideoDuration(inputPath) {
+async function getVideoMetadata(inputPath) {
   const { stdout } = await execa(ffprobePath, [
     "-v",
     "quiet",
     "-print_format",
     "json",
     "-show_format",
+    "-show_streams",
     inputPath
   ]);
-  const metadata = JSON.parse(stdout);
-  return parseFloat(metadata.format?.duration ?? "0");
+  return JSON.parse(stdout);
 }
-async function buildFrameList(framesDir, inputPath) {
+async function buildFrameList(framesDir, duration) {
   const files = await readdir(framesDir);
   const jpgFiles = files.filter((f) => f.endsWith(".jpg")).sort();
   if (jpgFiles.length === 0) {
     return [];
   }
-  let duration = 0;
-  try {
-    duration = await getVideoDuration(inputPath);
-  } catch {
-    logger.debug(
-      "Could not determine video duration; using frame index for timestamps"
-    );
-  }
   return jpgFiles.map((file, index) => ({
     id: index,
     timestamp: duration > 0 && jpgFiles.length > 1 ? duration * index / (jpgFiles.length - 1) : index,
@@ -633,13 +672,44 @@ async function finalizeOutput(ctx, selectedFrames) {
   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 destName = `scene_${String(i + 1).padStart(3, "0")}.jpg`;
-    const destPath = join3(stagingDir, destName);
+    const fileName = `frame_${String(frame.id + 1).padStart(padding, "0")}.jpg`;
+    const destPath = join3(stagingDir, fileName);
     await sharp2(frame.extractPath).jpeg({ quality, mozjpeg: true }).toFile(destPath);
-    outputFiles.push(join3(outputPath, destName));
+    outputFiles.push(join3(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: (ctx.animations || []).map((anim) => ({
+      ...anim,
+      startFrameId: anim.startFrameId + 1,
+      endFrameId: anim.endFrameId + 1,
+      durationMs: Math.round(anim.durationMs)
+    }))
+  };
+  const metadataPath = join3(stagingDir, ".metadata.json");
+  await writeFile(metadataPath, JSON.stringify(metadata, null, 2));
+  outputFiles.push(join3(outputPath, ".metadata.json"));
   await ensureDir(join3(outputPath, ".."));
   await rm(outputPath, { recursive: true, force: true });
   await rename(stagingDir, outputPath);
@@ -703,6 +773,8 @@ function resolveOptions(options) {
     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
   };
 }
@@ -973,7 +1045,9 @@ async function runPipeline(options) {
     }
     ctx.emitProgress(100);
     ctx.status = "ANALYZING";
-    ctx.graph = await analyzeFrames(ctx);
+    const { edges, animations } = await analyzeFrames(ctx);
+    ctx.graph = edges;
+    ctx.animations = animations;
     ctx.status = "PRUNING";
     const survivingIds = pruneByThresholdWithCap(
       ctx.graph,
@@ -1006,6 +1080,15 @@ async function runPipeline(options) {
       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) {