@reftrixmcp/mcp-server 0.1.7

package/dist/services/motion/fade-detector.service.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Fade Detector 設定
+ */
+export interface FadeDetectorConfig {
+    /** アルファ変化閾値（0-1） */
+    alphaThreshold?: number;
+    /** 最小フェード持続フレーム数 */
+    minFadeDurationFrames?: number;
+    /** FPS（duration計算用） */
+    fps?: number;
+}
+/**
+ * フレームアルファ情報
+ */
+export interface FrameAlphaInfo {
+    /** 平均アルファ値（0-255） */
+    averageAlpha: number;
+    /** アルファ比率（0-1、255を1として正規化） */
+    alphaRatio: number;
+    /** 最小アルファ値 */
+    minAlpha: number;
+    /** 最大アルファ値 */
+    maxAlpha: number;
+    /** アルファ標準偏差 */
+    alphaStdDev: number;
+}
+/**
+ * フェードイベント
+ */
+export interface FadeEvent {
+    /** フェードタイプ */
+    type: "fade_in" | "fade_out";
+    /** 開始フレームインデックス */
+    startFrame: number;
+    /** 終了フレームインデックス */
+    endFrame: number;
+    /** 開始時アルファ比率（0-1） */
+    startAlpha: number;
+    /** 終了時アルファ比率（0-1） */
+    endAlpha: number;
+    /** 持続時間（ミリ秒） */
+    durationMs: number;
+    /** フレーム数 */
+    frameCount: number;
+    /** アルファ変化量（絶対値） */
+    alphaChange: number;
+}
+/**
+ * フェード検出結果
+ */
+export interface FadeDetectionResult {
+    /** 成功フラグ */
+    success: boolean;
+    /** 検出されたフェードイベント */
+    fadeEvents: FadeEvent[];
+    /** フェードインイベント数 */
+    fadeInCount: number;
+    /** フェードアウトイベント数 */
+    fadeOutCount: number;
+    /** 総フェードイベント数 */
+    totalFadeEvents: number;
+    /** 解析したフレーム数 */
+    analyzedFrames: number;
+    /** 処理時間（ミリ秒） */
+    processingTimeMs?: number;
+}
+/**
+ * 検出オプション
+ */
+export interface DetectOptions {
+    /** FPS（duration計算用） */
+    fps?: number;
+}
+/**
+ * フレームデータ
+ */
+interface FrameData {
+    /** フレームバッファ（RGBA形式） */
+    buffer: Buffer;
+    /** 画像幅 */
+    width: number;
+    /** 画像高さ */
+    height: number;
+    /** フレームインデックス */
+    index: number;
+}
+/**
+ * フェードイン/フェードアウト検出器
+ *
+ * フレームシーケンスの透明度変化を解析し、
+ * フェードイベントを検出します。
+ */
+export declare class FadeDetector {
+    private readonly config;
+    constructor(config?: FadeDetectorConfig);
+    /**
+     * 単一フレームのアルファ値を解析
+     */
+    analyzeFrameAlpha(buffer: Buffer, width: number, height: number): FrameAlphaInfo;
+    /**
+     * フレームシーケンスからフェードイベントを検出
+     */
+    detect(frames: FrameData[], options?: DetectOptions): FadeDetectionResult;
+    /**
+     * フェードイベントを検出（内部実装）
+     */
+    private detectFadeEvents;
+}
+/**
+ * FadeDetectorインスタンスを作成
+ */
+export declare function createFadeDetector(config?: FadeDetectorConfig): FadeDetector;
+export default FadeDetector;
+//# sourceMappingURL=fade-detector.service.d.ts.map

package/dist/services/motion/fade-detector.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fade-detector.service.d.ts","sourceRoot":"","sources":["../../../src/services/motion/fade-detector.service.ts"],"names":[],"mappings":"AAkCA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oBAAoB;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,uBAAuB;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,cAAc;IACd,IAAI,EAAE,SAAS,GAAG,UAAU,CAAC;IAC7B,mBAAmB;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,YAAY;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,oBAAoB;IACpB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uBAAuB;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,UAAU,SAAS;IACjB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU;IACV,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAsBD;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;gBAE1C,MAAM,GAAE,kBAAuB;IAiB3C;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc;IAkDhF;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,mBAAmB;IA2CzE;;OAEG;IACH,OAAO,CAAC,gBAAgB;CA+FzB;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,YAAY,CAE5E;AAED,eAAe,YAAY,CAAC"}

package/dist/services/motion/fade-detector.service.js

@@ -0,0 +1,249 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FadeDetector = void 0;
+exports.createFadeDetector = createFadeDetector;
+/**
+ * Fade Detector Service
+ *
+ * 透明度変化検出によるフェードイン/フェードアウト検出サービス
+ *
+ * 機能:
+ * - フレームごとのアルファ値解析
+ * - フェードイン/フェードアウトイベント検出
+ * - 持続時間・変化量の計算
+ * - MotionPattern記録用データ生成
+ *
+ * @module @reftrixmcp/mcp-server/services/motion/fade-detector
+ */
+// =============================================================================
+// 定数
+// =============================================================================
+const DEFAULTS = {
+    /** アルファ変化閾値（0-1、この値以上の変化をフェードとして検出） */
+    ALPHA_THRESHOLD: 0.1,
+    /** 最小フェード持続フレーム数 */
+    MIN_FADE_DURATION_FRAMES: 3,
+    /** デフォルトFPS */
+    FPS: 30,
+};
+// =============================================================================
+// 内部ヘルパー
+// =============================================================================
+/**
+ * アルファ変化の方向を判定
+ */
+function determineFadeType(startAlpha, endAlpha) {
+    if (endAlpha > startAlpha) {
+        return "fade_in";
+    }
+    else if (endAlpha < startAlpha) {
+        return "fade_out";
+    }
+    return null;
+}
+// =============================================================================
+// FadeDetector クラス
+// =============================================================================
+/**
+ * フェードイン/フェードアウト検出器
+ *
+ * フレームシーケンスの透明度変化を解析し、
+ * フェードイベントを検出します。
+ */
+class FadeDetector {
+    config;
+    constructor(config = {}) {
+        this.config = {
+            alphaThreshold: config.alphaThreshold ?? DEFAULTS.ALPHA_THRESHOLD,
+            minFadeDurationFrames: config.minFadeDurationFrames ?? DEFAULTS.MIN_FADE_DURATION_FRAMES,
+            fps: config.fps ?? DEFAULTS.FPS,
+        };
+        if (process.env.NODE_ENV === "development") {
+            // eslint-disable-next-line no-console -- Intentional debug log in development
+            console.log("[FadeDetector] Created with config:", this.config);
+        }
+    }
+    // ===========================================================================
+    // Public Methods
+    // ===========================================================================
+    /**
+     * 単一フレームのアルファ値を解析
+     */
+    analyzeFrameAlpha(buffer, width, height) {
+        const totalPixels = width * height;
+        const expectedSize = totalPixels * 4;
+        // 空フレームまたはサイズ不正の場合
+        if (totalPixels === 0 || buffer.length < expectedSize) {
+            return {
+                averageAlpha: 0,
+                alphaRatio: 0,
+                minAlpha: 0,
+                maxAlpha: 0,
+                alphaStdDev: 0,
+            };
+        }
+        let sumAlpha = 0;
+        let minAlpha = 255;
+        let maxAlpha = 0;
+        const alphaValues = [];
+        // アルファ値を収集
+        for (let i = 3; i < expectedSize; i += 4) {
+            const alpha = buffer[i] ?? 0;
+            sumAlpha += alpha;
+            alphaValues.push(alpha);
+            if (alpha < minAlpha)
+                minAlpha = alpha;
+            if (alpha > maxAlpha)
+                maxAlpha = alpha;
+        }
+        const averageAlpha = sumAlpha / totalPixels;
+        const alphaRatio = averageAlpha / 255;
+        // 標準偏差計算
+        let sumSquaredDiff = 0;
+        for (const alpha of alphaValues) {
+            const diff = alpha - averageAlpha;
+            sumSquaredDiff += diff * diff;
+        }
+        const alphaStdDev = Math.sqrt(sumSquaredDiff / totalPixels);
+        return {
+            averageAlpha,
+            alphaRatio,
+            minAlpha,
+            maxAlpha,
+            alphaStdDev,
+        };
+    }
+    /**
+     * フレームシーケンスからフェードイベントを検出
+     */
+    detect(frames, options) {
+        const startTime = performance.now();
+        const fps = options?.fps ?? this.config.fps;
+        // 空配列または単一フレームの場合
+        if (frames.length <= 1) {
+            return {
+                success: true,
+                fadeEvents: [],
+                fadeInCount: 0,
+                fadeOutCount: 0,
+                totalFadeEvents: 0,
+                analyzedFrames: frames.length,
+                processingTimeMs: performance.now() - startTime,
+            };
+        }
+        // 各フレームのアルファ情報を計算
+        const alphaInfos = frames.map((frame) => this.analyzeFrameAlpha(frame.buffer, frame.width, frame.height));
+        // フェードイベントを検出
+        const fadeEvents = this.detectFadeEvents(frames, alphaInfos, fps);
+        const fadeInCount = fadeEvents.filter((e) => e.type === "fade_in").length;
+        const fadeOutCount = fadeEvents.filter((e) => e.type === "fade_out").length;
+        return {
+            success: true,
+            fadeEvents,
+            fadeInCount,
+            fadeOutCount,
+            totalFadeEvents: fadeEvents.length,
+            analyzedFrames: frames.length,
+            processingTimeMs: performance.now() - startTime,
+        };
+    }
+    // ===========================================================================
+    // Private Methods
+    // ===========================================================================
+    /**
+     * フェードイベントを検出（内部実装）
+     */
+    detectFadeEvents(frames, alphaInfos, fps) {
+        const events = [];
+        const msPerFrame = 1000 / fps;
+        let fadeStartIndex = null;
+        let fadeStartAlpha = null;
+        let currentFadeType = null;
+        for (let i = 1; i < alphaInfos.length; i++) {
+            const prevAlpha = alphaInfos[i - 1]?.alphaRatio ?? 0;
+            const currentAlpha = alphaInfos[i]?.alphaRatio ?? 0;
+            const alphaDiff = currentAlpha - prevAlpha;
+            const absAlphaDiff = Math.abs(alphaDiff);
+            // フェード開始検出
+            if (fadeStartIndex === null) {
+                // 閾値を超える変化があるか確認
+                if (absAlphaDiff > this.config.alphaThreshold * 0.1) {
+                    fadeStartIndex = i - 1;
+                    fadeStartAlpha = prevAlpha;
+                    currentFadeType = determineFadeType(prevAlpha, currentAlpha);
+                }
+            }
+            else {
+                // フェード継続中
+                const expectedType = determineFadeType(fadeStartAlpha, currentAlpha);
+                // フェード方向が変わった、または変化が止まった場合
+                if (expectedType !== currentFadeType || absAlphaDiff < 0.001) {
+                    // フェードイベントを確定
+                    const fadeFrameCount = i - fadeStartIndex;
+                    const totalAlphaChange = Math.abs((alphaInfos[i - 1]?.alphaRatio ?? 0) - fadeStartAlpha);
+                    // 最小持続時間と閾値を満たすか確認
+                    if (fadeFrameCount >= this.config.minFadeDurationFrames &&
+                        totalAlphaChange >= this.config.alphaThreshold) {
+                        const endAlpha = alphaInfos[i - 1]?.alphaRatio ?? 0;
+                        events.push({
+                            type: currentFadeType,
+                            startFrame: frames[fadeStartIndex]?.index ?? fadeStartIndex,
+                            endFrame: frames[i - 1]?.index ?? i - 1,
+                            startAlpha: fadeStartAlpha,
+                            endAlpha,
+                            durationMs: fadeFrameCount * msPerFrame,
+                            frameCount: fadeFrameCount,
+                            alphaChange: totalAlphaChange,
+                        });
+                    }
+                    // 新しいフェードの開始をチェック
+                    if (absAlphaDiff > this.config.alphaThreshold * 0.1) {
+                        fadeStartIndex = i - 1;
+                        fadeStartAlpha = alphaInfos[i - 1]?.alphaRatio ?? 0;
+                        currentFadeType = determineFadeType(fadeStartAlpha, currentAlpha);
+                    }
+                    else {
+                        fadeStartIndex = null;
+                        fadeStartAlpha = null;
+                        currentFadeType = null;
+                    }
+                }
+            }
+        }
+        // 最後まで続くフェードの処理
+        if (fadeStartIndex !== null && fadeStartAlpha !== null && currentFadeType !== null) {
+            const lastIndex = alphaInfos.length - 1;
+            const fadeFrameCount = lastIndex - fadeStartIndex + 1;
+            const endAlpha = alphaInfos[lastIndex]?.alphaRatio ?? 0;
+            const totalAlphaChange = Math.abs(endAlpha - fadeStartAlpha);
+            if (fadeFrameCount >= this.config.minFadeDurationFrames &&
+                totalAlphaChange >= this.config.alphaThreshold) {
+                events.push({
+                    type: currentFadeType,
+                    startFrame: frames[fadeStartIndex]?.index ?? fadeStartIndex,
+                    endFrame: frames[lastIndex]?.index ?? lastIndex,
+                    startAlpha: fadeStartAlpha,
+                    endAlpha,
+                    durationMs: fadeFrameCount * msPerFrame,
+                    frameCount: fadeFrameCount,
+                    alphaChange: totalAlphaChange,
+                });
+            }
+        }
+        return events;
+    }
+}
+exports.FadeDetector = FadeDetector;
+// =============================================================================
+// Factory Functions
+// =============================================================================
+/**
+ * FadeDetectorインスタンスを作成
+ */
+function createFadeDetector(config) {
+    return new FadeDetector(config);
+}
+exports.default = FadeDetector;
+//# sourceMappingURL=fade-detector.service.js.map

package/dist/services/motion/fade-detector.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fade-detector.service.js","sourceRoot":"","sources":["../../../src/services/motion/fade-detector.service.ts"],"names":[],"mappings":"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"}

package/dist/services/motion/frame-analysis-save.helper.d.ts

@@ -0,0 +1,41 @@
+import { type BatchSaveResult } from "./motion-db.service";
+import type { FrameAnalysisResult, FrameCaptureResult } from "../../tools/page/handlers/types";
+/**
+ * Frame analysis DB保存に必要な入力データ
+ */
+export interface FrameAnalysisSaveInput {
+    /** MotionServiceResult.frame_analysis */
+    frameAnalysis: FrameAnalysisResult;
+    /** MotionServiceResult.frame_capture（metadata用、optional） */
+    frameCapture?: FrameCaptureResult | undefined;
+    /** 保存先 web_page ID */
+    webPageId: string;
+    /** 元URL */
+    sourceUrl: string;
+}
+/**
+ * Frame analysis DB保存結果
+ */
+export interface FrameAnalysisSaveResult {
+    /** 保存が成功したか */
+    saved: boolean;
+    /** BatchSaveResult（成功時） */
+    batchResult?: BatchSaveResult;
+    /** エラーメッセージ（失敗時） */
+    error?: string;
+    /** スキップ理由（MotionDbService利用不可時等） */
+    skipped?: string;
+}
+/**
+ * Frame analysis結果をDB保存する共有ヘルパー
+ *
+ * MotionServiceResult.frame_analysis から FrameImageAnalysisOutput 形式を構築し、
+ * MotionDbService.saveFrameAnalysis() でDB保存する。
+ *
+ * 同期モード（analyze.tool.ts）と非同期モード（page-analyze-worker.ts）の両方から呼ばれる。
+ *
+ * @param input - Frame analysis保存入力データ
+ * @returns 保存結果
+ */
+export declare function saveFrameAnalysisToDb(input: FrameAnalysisSaveInput): Promise<FrameAnalysisSaveResult>;
+//# sourceMappingURL=frame-analysis-save.helper.d.ts.map

package/dist/services/motion/frame-analysis-save.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-analysis-save.helper.d.ts","sourceRoot":"","sources":["../../../src/services/motion/frame-analysis-save.helper.ts"],"names":[],"mappings":"AAaA,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAO/F;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,yCAAyC;IACzC,aAAa,EAAE,mBAAmB,CAAC;IACnC,4DAA4D;IAC5D,YAAY,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAC9C,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,eAAe;IACf,KAAK,EAAE,OAAO,CAAC;IACf,2BAA2B;IAC3B,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA0LD;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CAsFlC"}

package/dist/services/motion/frame-analysis-save.helper.js

@@ -0,0 +1,235 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.saveFrameAnalysisToDb = saveFrameAnalysisToDb;
+/**
+ * Frame Analysis DB Save Helper
+ *
+ * MotionServiceResultのframe_analysis結果をFrameImageAnalysisOutput形式に変換し、
+ * MotionDbServiceでDB保存するヘルパー関数。
+ * 同期モード（analyze.tool.ts）と非同期モード（page-analyze-worker.ts）の両方から呼ばれる。
+ *
+ * @module @reftrixmcp/mcp-server/services/motion/frame-analysis-save.helper
+ */
+const logger_1 = require("../../utils/logger");
+const motion_db_service_1 = require("./motion-db.service");
+// =====================================================
+// Constants
+// =====================================================
+/** Reftrix default scroll pixels per frame */
+const SCROLL_PX_PER_FRAME = 15;
+/** Layout shift score threshold (Core Web Vitals) */
+const LAYOUT_SHIFT_THRESHOLD = 0.05;
+/** Minimum magnitude to determine motion vector direction */
+const MOTION_VECTOR_MIN_MAGNITUDE = 5;
+/** Max frames gap to consider as continuous zone */
+const CONTINUOUS_ZONE_GAP = 5;
+// =====================================================
+// Internal helpers
+// =====================================================
+/**
+ * Classify animation type based on scroll duration (px)
+ */
+function classifyAnimationType(duration) {
+    if (duration < 500)
+        return "micro-interaction";
+    if (duration < 1500)
+        return "fade/slide transition";
+    if (duration < 3000)
+        return "scroll-linked animation";
+    return "long-form reveal";
+}
+/**
+ * Determine motion direction from angle
+ */
+function determineDirection(angle, magnitude) {
+    if (magnitude < MOTION_VECTOR_MIN_MAGNITUDE)
+        return "stationary";
+    if (angle >= -45 && angle < 45)
+        return "right";
+    if (angle >= 45 && angle < 135)
+        return "down";
+    if (angle >= -135 && angle < -45)
+        return "up";
+    return "left";
+}
+/**
+ * Format frame index as zero-padded filename
+ */
+function frameFileName(index) {
+    return `frame-${String(index).padStart(4, "0")}.png`;
+}
+/**
+ * timeline の significant_change_frames から AnimationZones を構築
+ */
+function buildAnimationZones(frameAnalysis) {
+    const zones = [];
+    const significantFrames = frameAnalysis.summary?.significant_change_frames ?? [];
+    if (significantFrames.length === 0)
+        return zones;
+    let zoneStart = significantFrames[0] ?? 0;
+    let zoneEnd = zoneStart;
+    const diffs = [];
+    for (let i = 0; i < significantFrames.length; i++) {
+        const currentFrame = significantFrames[i] ?? 0;
+        const nextFrame = significantFrames[i + 1];
+        const timelineEntry = frameAnalysis.timeline.find((t) => t.frame_index === currentFrame);
+        if (timelineEntry) {
+            diffs.push(timelineEntry.diff_percentage * 100);
+        }
+        if (nextFrame !== undefined && nextFrame - currentFrame <= CONTINUOUS_ZONE_GAP) {
+            zoneEnd = nextFrame;
+        }
+        else {
+            if (diffs.length > 0) {
+                const avgDiff = diffs.reduce((a, b) => a + b, 0) / diffs.length;
+                const peakDiff = Math.max(...diffs);
+                const duration = (zoneEnd - zoneStart) * SCROLL_PX_PER_FRAME;
+                zones.push({
+                    frameStart: frameFileName(zoneStart),
+                    frameEnd: frameFileName(zoneEnd),
+                    scrollStart: zoneStart * SCROLL_PX_PER_FRAME,
+                    scrollEnd: zoneEnd * SCROLL_PX_PER_FRAME,
+                    duration,
+                    avgDiff: avgDiff.toFixed(2),
+                    peakDiff: peakDiff.toFixed(2),
+                    animationType: classifyAnimationType(duration),
+                });
+            }
+            if (nextFrame !== undefined) {
+                zoneStart = nextFrame;
+                zoneEnd = nextFrame;
+                diffs.length = 0;
+            }
+        }
+    }
+    return zones;
+}
+/**
+ * timeline から layoutShifts を構築（layout_shift_score > threshold）
+ */
+function buildLayoutShifts(frameAnalysis) {
+    const shifts = [];
+    for (const entry of frameAnalysis.timeline) {
+        const shiftScore = entry.layout_shift_score;
+        if (shiftScore !== undefined && shiftScore > LAYOUT_SHIFT_THRESHOLD) {
+            shifts.push({
+                frameRange: frameFileName(entry.frame_index),
+                scrollRange: `${entry.frame_index * SCROLL_PX_PER_FRAME}px`,
+                impactFraction: shiftScore.toFixed(4),
+                boundingBox: { x: 0, y: 0, width: 1920, height: 1080 },
+            });
+        }
+    }
+    return shifts;
+}
+/**
+ * timeline の motion_vectors から MotionVectors を構築
+ */
+function buildMotionVectors(frameAnalysis) {
+    const vectors = [];
+    for (const entry of frameAnalysis.timeline) {
+        const entryVectors = entry.motion_vectors;
+        if (entryVectors && entryVectors.length > 0) {
+            for (const vector of entryVectors) {
+                const angle = Math.atan2(vector.y, vector.x) * (180 / Math.PI);
+                vectors.push({
+                    frameRange: frameFileName(entry.frame_index),
+                    dx: vector.x,
+                    dy: vector.y,
+                    magnitude: vector.magnitude.toFixed(2),
+                    direction: determineDirection(angle, vector.magnitude),
+                    angle: angle.toFixed(2),
+                });
+            }
+        }
+    }
+    return vectors;
+}
+// =====================================================
+// Main helper function
+// =====================================================
+/**
+ * Frame analysis結果をDB保存する共有ヘルパー
+ *
+ * MotionServiceResult.frame_analysis から FrameImageAnalysisOutput 形式を構築し、
+ * MotionDbService.saveFrameAnalysis() でDB保存する。
+ *
+ * 同期モード（analyze.tool.ts）と非同期モード（page-analyze-worker.ts）の両方から呼ばれる。
+ *
+ * @param input - Frame analysis保存入力データ
+ * @returns 保存結果
+ */
+async function saveFrameAnalysisToDb(input) {
+    const { frameAnalysis, frameCapture, webPageId, sourceUrl } = input;
+    if ((0, logger_1.isDevelopment)()) {
+        logger_1.logger.info("[FrameAnalysisSaveHelper] Starting frame analysis DB save", {
+            webPageId,
+            timelineLength: frameAnalysis.timeline?.length ?? 0,
+            totalLayoutShifts: frameAnalysis.summary?.total_layout_shifts ?? 0,
+        });
+    }
+    try {
+        const motionDbService = (0, motion_db_service_1.getMotionDbService)();
+        if (!motionDbService.isAvailable()) {
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.warn("[FrameAnalysisSaveHelper] MotionDbService not available, skipping frame analysis DB save");
+            }
+            return { saved: false, skipped: "MotionDbService not available" };
+        }
+        // Build sub-structures
+        const animationZones = buildAnimationZones(frameAnalysis);
+        const layoutShifts = buildLayoutShifts(frameAnalysis);
+        const motionVectors = buildMotionVectors(frameAnalysis);
+        const significantFrames = frameAnalysis.summary?.significant_change_frames ?? [];
+        // Build FrameImageAnalysisOutput
+        const frameAnalysisOutput = {
+            metadata: {
+                framesDir: frameCapture?.output_dir ?? "/tmp/reftrix-frames/",
+                totalFrames: frameCapture?.total_frames ?? 0,
+                analyzedPairs: frameAnalysis.timeline.length,
+                sampleInterval: 1,
+                scrollPxPerFrame: SCROLL_PX_PER_FRAME,
+                analysisTime: `${(frameAnalysis.summary?.processing_time_ms ?? 0) / 1000}s`,
+                analyzedAt: new Date().toISOString(),
+            },
+            statistics: {
+                averageDiffPercentage: ((frameAnalysis.summary?.avg_diff ?? 0) * 100).toFixed(2),
+                significantChangeCount: significantFrames.length,
+                significantChangePercentage: frameAnalysis.timeline.length > 0
+                    ? ((significantFrames.length / frameAnalysis.timeline.length) * 100).toFixed(2)
+                    : "0.00",
+                layoutShiftCount: frameAnalysis.summary?.total_layout_shifts ?? 0,
+                motionVectorCount: motionVectors.length,
+            },
+            animationZones,
+            layoutShifts,
+            motionVectors,
+        };
+        // Save via MotionDbService
+        const batchResult = await motionDbService.saveFrameAnalysis(frameAnalysisOutput, {
+            webPageId,
+            sourceUrl,
+            continueOnError: true,
+        });
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[FrameAnalysisSaveHelper] Frame analysis DB save completed", {
+                saved: batchResult.saved,
+                savedCount: batchResult.savedCount,
+                byCategory: batchResult.byCategory,
+                reason: batchResult.reason,
+            });
+        }
+        return { saved: batchResult.saved, batchResult };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Unknown error";
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.warn("[FrameAnalysisSaveHelper] Frame analysis DB save failed (graceful degradation)", {
+                error: errorMessage,
+            });
+        }
+        return { saved: false, error: errorMessage };
+    }
+}
+//# sourceMappingURL=frame-analysis-save.helper.js.map