@reftrixmcp/mcp-server 0.1.7

package/dist/tools/motion/detect.tool.js

@@ -0,0 +1,1421 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleMotionDetect = exports.motionDetectToolDefinition = exports.getWebPageService = exports.getJSAnimationDetectorService = exports.getFrameImageAnalysisService = exports.getFrameCaptureService = exports.resetWebPageServiceFactory = exports.setWebPageServiceFactory = exports.resetJSAnimationDetectorFactory = exports.setJSAnimationDetectorFactory = exports.resetFrameImageAnalysisServiceFactory = exports.setFrameImageAnalysisServiceFactory = exports.resetAnimationMetricsCollectorFactory = exports.setAnimationMetricsCollectorFactory = exports.resetLighthouseDetectorServiceFactory = exports.setLighthouseDetectorServiceFactory = exports.resetFrameCaptureServiceFactory = exports.setFrameCaptureServiceFactory = exports.resetRuntimeAnimationDetectorFactory = exports.setRuntimeAnimationDetectorFactory = exports.resetFrameAnalyzerServiceFactory = exports.setFrameAnalyzerServiceFactory = exports.resetVideoRecorderServiceFactory = exports.setVideoRecorderServiceFactory = exports.resetMotionPersistenceServiceFactory = exports.setMotionPersistenceServiceFactory = exports.resetMotionDetectServiceFactory = exports.setMotionDetectServiceFactory = exports.executeFrameCapture = exports.FrameAnalysisError = exports.VideoRecordError = exports.SSRFBlockedError = exports.motionDetectInputSchema = exports.MotionTimeoutError = exports.TimeoutWarningCode = exports.MIN_MOTION_TIMEOUT = exports.DEFAULT_MOTION_TIMEOUT = void 0;
+exports.withTimeout = withTimeout;
+exports.createTimeoutResponse = createTimeoutResponse;
+exports.motionDetectHandler = motionDetectHandler;
+/**
+ * motion.detect MCPツール
+ * Webページからモーション/アニメーションパターンを検出・分類します
+ *
+ * 機能:
+ * - CSS Animation (@keyframes) 検出
+ * - CSS Transition 検出
+ * - パターン分類（scroll_trigger, hover_effect, loading_state等）
+ * - パフォーマンス分析
+ * - アクセシビリティ警告
+ *
+ * このファイルはオーケストレーターとして機能し、
+ * 各サブモジュールに処理を委譲します。
+ *
+ * @module tools/motion/detect.tool
+ */
+const zod_1 = require("zod");
+const logger_1 = require("../../utils/logger");
+const error_messages_1 = require("../../utils/error-messages");
+const schemas_1 = require("./schemas");
+Object.defineProperty(exports, "motionDetectInputSchema", { enumerable: true, get: function () { return schemas_1.motionDetectInputSchema; } });
+// DI factories
+const di_factories_1 = require("./di-factories");
+Object.defineProperty(exports, "setMotionDetectServiceFactory", { enumerable: true, get: function () { return di_factories_1.setMotionDetectServiceFactory; } });
+Object.defineProperty(exports, "resetMotionDetectServiceFactory", { enumerable: true, get: function () { return di_factories_1.resetMotionDetectServiceFactory; } });
+Object.defineProperty(exports, "setMotionPersistenceServiceFactory", { enumerable: true, get: function () { return di_factories_1.setMotionPersistenceServiceFactory; } });
+Object.defineProperty(exports, "resetMotionPersistenceServiceFactory", { enumerable: true, get: function () { return di_factories_1.resetMotionPersistenceServiceFactory; } });
+Object.defineProperty(exports, "setVideoRecorderServiceFactory", { enumerable: true, get: function () { return di_factories_1.setVideoRecorderServiceFactory; } });
+Object.defineProperty(exports, "resetVideoRecorderServiceFactory", { enumerable: true, get: function () { return di_factories_1.resetVideoRecorderServiceFactory; } });
+Object.defineProperty(exports, "setFrameAnalyzerServiceFactory", { enumerable: true, get: function () { return di_factories_1.setFrameAnalyzerServiceFactory; } });
+Object.defineProperty(exports, "resetFrameAnalyzerServiceFactory", { enumerable: true, get: function () { return di_factories_1.resetFrameAnalyzerServiceFactory; } });
+Object.defineProperty(exports, "setRuntimeAnimationDetectorFactory", { enumerable: true, get: function () { return di_factories_1.setRuntimeAnimationDetectorFactory; } });
+Object.defineProperty(exports, "resetRuntimeAnimationDetectorFactory", { enumerable: true, get: function () { return di_factories_1.resetRuntimeAnimationDetectorFactory; } });
+Object.defineProperty(exports, "setFrameCaptureServiceFactory", { enumerable: true, get: function () { return di_factories_1.setFrameCaptureServiceFactory; } });
+Object.defineProperty(exports, "resetFrameCaptureServiceFactory", { enumerable: true, get: function () { return di_factories_1.resetFrameCaptureServiceFactory; } });
+Object.defineProperty(exports, "setLighthouseDetectorServiceFactory", { enumerable: true, get: function () { return di_factories_1.setLighthouseDetectorServiceFactory; } });
+Object.defineProperty(exports, "resetLighthouseDetectorServiceFactory", { enumerable: true, get: function () { return di_factories_1.resetLighthouseDetectorServiceFactory; } });
+Object.defineProperty(exports, "setAnimationMetricsCollectorFactory", { enumerable: true, get: function () { return di_factories_1.setAnimationMetricsCollectorFactory; } });
+Object.defineProperty(exports, "resetAnimationMetricsCollectorFactory", { enumerable: true, get: function () { return di_factories_1.resetAnimationMetricsCollectorFactory; } });
+Object.defineProperty(exports, "setFrameImageAnalysisServiceFactory", { enumerable: true, get: function () { return di_factories_1.setFrameImageAnalysisServiceFactory; } });
+Object.defineProperty(exports, "resetFrameImageAnalysisServiceFactory", { enumerable: true, get: function () { return di_factories_1.resetFrameImageAnalysisServiceFactory; } });
+Object.defineProperty(exports, "setJSAnimationDetectorFactory", { enumerable: true, get: function () { return di_factories_1.setJSAnimationDetectorFactory; } });
+Object.defineProperty(exports, "resetJSAnimationDetectorFactory", { enumerable: true, get: function () { return di_factories_1.resetJSAnimationDetectorFactory; } });
+Object.defineProperty(exports, "setWebPageServiceFactory", { enumerable: true, get: function () { return di_factories_1.setWebPageServiceFactory; } });
+Object.defineProperty(exports, "resetWebPageServiceFactory", { enumerable: true, get: function () { return di_factories_1.resetWebPageServiceFactory; } });
+Object.defineProperty(exports, "getFrameCaptureService", { enumerable: true, get: function () { return di_factories_1.getFrameCaptureServiceInstance; } });
+Object.defineProperty(exports, "getFrameImageAnalysisService", { enumerable: true, get: function () { return di_factories_1.getFrameImageAnalysisService; } });
+Object.defineProperty(exports, "getJSAnimationDetectorService", { enumerable: true, get: function () { return di_factories_1.getJSAnimationDetectorService; } });
+Object.defineProperty(exports, "getWebPageService", { enumerable: true, get: function () { return di_factories_1.getWebPageService; } });
+// Detection modes
+const detection_modes_1 = require("./detection-modes");
+Object.defineProperty(exports, "SSRFBlockedError", { enumerable: true, get: function () { return detection_modes_1.SSRFBlockedError; } });
+Object.defineProperty(exports, "VideoRecordError", { enumerable: true, get: function () { return detection_modes_1.VideoRecordError; } });
+Object.defineProperty(exports, "FrameAnalysisError", { enumerable: true, get: function () { return detection_modes_1.FrameAnalysisError; } });
+Object.defineProperty(exports, "executeFrameCapture", { enumerable: true, get: function () { return detection_modes_1.executeFrameCapture; } });
+// CSS mode handler
+const css_mode_handler_1 = require("./css-mode-handler");
+// JS Animation DB保存（page.analyze と共有）
+const js_animation_handler_1 = require("../page/handlers/js-animation-handler");
+const di_factories_2 = require("./di-factories");
+// =====================================================
+// タイムアウト設定定数 (v0.1.0)
+// =====================================================
+/** デフォルトタイムアウト: 3分 (180秒) */
+exports.DEFAULT_MOTION_TIMEOUT = 180000;
+/** 最小タイムアウト: 30秒 */
+exports.MIN_MOTION_TIMEOUT = 30000;
+/**
+ * タイムアウト警告コード
+ * Graceful degradation 時に警告に含めるコード
+ */
+exports.TimeoutWarningCode = {
+    /** motion.detect 全体のタイムアウト */
+    MOTION_DETECTION_TIMEOUT: "MOTION_DETECTION_TIMEOUT",
+    /** JSアニメーション検出のタイムアウト */
+    JS_ANIMATION_TIMEOUT: "JS_ANIMATION_TIMEOUT",
+    /** フレームキャプチャのタイムアウト */
+    FRAME_CAPTURE_TIMEOUT: "FRAME_CAPTURE_TIMEOUT",
+    /** 部分的な結果（一部処理がタイムアウト） */
+    PARTIAL_RESULT: "PARTIAL_RESULT",
+};
+// =====================================================
+// タイムアウトヘルパー (v0.1.0)
+// =====================================================
+/**
+ * タイムアウトエラークラス
+ * Promise.raceでタイムアウトした場合にスローされる
+ */
+class MotionTimeoutError extends Error {
+    phase;
+    elapsedMs;
+    constructor(phase, elapsedMs) {
+        super(`Motion detection timeout in ${phase} phase after ${elapsedMs}ms`);
+        this.name = "MotionTimeoutError";
+        this.phase = phase;
+        this.elapsedMs = elapsedMs;
+    }
+}
+exports.MotionTimeoutError = MotionTimeoutError;
+/**
+ * タイムアウト付きでPromiseを実行
+ * タイムアウト時は MotionTimeoutError をスロー
+ */
+async function withTimeout(promise, timeoutMs, phase, startTime) {
+    const timeoutPromise = new Promise((_, reject) => {
+        const timer = setTimeout(() => {
+            const elapsedMs = Date.now() - startTime;
+            reject(new MotionTimeoutError(phase, elapsedMs));
+        }, timeoutMs);
+        // Node.js特有: タイマーがプロセス終了を阻止しないようにする
+        if (typeof timer === "object" && timer !== null && "unref" in timer) {
+            timer.unref();
+        }
+    });
+    return Promise.race([promise, timeoutPromise]);
+}
+/**
+ * タイムアウト時のgraceful degradation用レスポンスを生成
+ */
+function createTimeoutResponse(phase, elapsedMs, partialPatterns = []) {
+    const warnings = [
+        {
+            code: exports.TimeoutWarningCode.MOTION_DETECTION_TIMEOUT,
+            severity: "warning",
+            message: `Motion detection timed out in ${phase} phase after ${elapsedMs}ms`,
+            context: { elapsedMs, phase },
+        },
+    ];
+    if (partialPatterns.length > 0) {
+        warnings.push({
+            code: exports.TimeoutWarningCode.PARTIAL_RESULT,
+            severity: "info",
+            message: `Partial results available: ${partialPatterns.length} patterns detected before timeout`,
+        });
+    }
+    // 無限アニメーションがあるかチェック（iterationsはanimationオブジェクト内）
+    const hasInfiniteAnimations = partialPatterns.some((p) => p.animation?.iterations === -1 || p.animation?.iterations === Infinity);
+    return {
+        success: true,
+        data: {
+            patterns: partialPatterns,
+            summary: {
+                totalPatterns: partialPatterns.length,
+                byType: (0, schemas_1.countByType)(partialPatterns),
+                byTrigger: (0, schemas_1.countByTrigger)(partialPatterns),
+                byCategory: (0, schemas_1.countByCategory)(partialPatterns),
+                complexityScore: (0, schemas_1.calculateComplexityScore)(partialPatterns),
+                averageDuration: (0, schemas_1.calculateAverageDuration)(partialPatterns),
+                hasInfiniteAnimations,
+            },
+            warnings,
+            metadata: {
+                had_timeout: true,
+                timeout_phase: phase,
+                timeout_elapsed_ms: elapsedMs,
+                processingTimeMs: elapsedMs,
+                detection_mode: "css",
+                detectedAt: new Date().toISOString(),
+                schemaVersion: "0.1.0",
+            },
+        },
+    };
+}
+// =====================================================
+// メインハンドラー（オーケストレーター）
+// =====================================================
+/**
+ * motion.detect ツールハンドラー
+ *
+ * 検出モードに応じて適切なサブモジュールに処理を委譲します。
+ * - video: executeVideoDetection
+ * - runtime: executeRuntimeDetection
+ * - hybrid: runtime + CSS
+ * - css (default): handleCssMode
+ */
+async function motionDetectHandler(input) {
+    const startTime = Date.now();
+    if ((0, logger_1.isDevelopment)()) {
+        logger_1.logger.info("[MCP Tool] motion.detect called", {
+            hasInput: input !== null && input !== undefined,
+        });
+    }
+    // 入力バリデーション
+    let validated;
+    try {
+        validated = schemas_1.motionDetectInputSchema.parse(input);
+    }
+    catch (error) {
+        if (error instanceof zod_1.ZodError) {
+            const errorWithHints = (0, error_messages_1.createValidationErrorWithHints)(error, "motion.detect");
+            const detailedMessage = (0, error_messages_1.formatMultipleDetailedErrors)(errorWithHints.errors);
+            const formattedErrors = (0, error_messages_1.formatZodError)(error);
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.error("[MCP Tool] motion.detect validation error", {
+                    errors: errorWithHints.errors,
+                });
+            }
+            return {
+                success: false,
+                error: {
+                    code: schemas_1.MOTION_MCP_ERROR_CODES.VALIDATION_ERROR,
+                    message: `Validation error:\n${detailedMessage}`,
+                    details: {
+                        errors: formattedErrors,
+                        detailedErrors: errorWithHints.errors,
+                    },
+                },
+            };
+        }
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.error("[MCP Tool] motion.detect validation error", { error });
+        }
+        return {
+            success: false,
+            error: {
+                code: schemas_1.MOTION_MCP_ERROR_CODES.VALIDATION_ERROR,
+                message: error instanceof Error ? error.message : "Invalid input",
+            },
+        };
+    }
+    // =====================================================
+    // タイムアウトチェック (v0.1.0)
+    // バリデーション完了後、既にタイムアウトしている場合は即座にgraceful degradation
+    // =====================================================
+    const timeout = validated.timeout ?? exports.DEFAULT_MOTION_TIMEOUT;
+    const elapsedAfterValidation = Date.now() - startTime;
+    if (elapsedAfterValidation >= timeout) {
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.warn("[MCP Tool] motion.detect timeout before processing", {
+                timeout,
+                elapsed: elapsedAfterValidation,
+            });
+        }
+        return createTimeoutResponse("validation", elapsedAfterValidation);
+    }
+    // 残りの時間でタイムアウト付き処理を実行
+    const remainingTimeout = timeout - elapsedAfterValidation;
+    // =====================================================
+    // Video Mode Detection
+    // =====================================================
+    if (validated.detection_mode === "video" && validated.url) {
+        try {
+            return await withTimeout(handleVideoMode(validated, startTime), remainingTimeout, "video", startTime);
+        }
+        catch (error) {
+            if (error instanceof MotionTimeoutError) {
+                return createTimeoutResponse(error.phase, error.elapsedMs);
+            }
+            throw error;
+        }
+    }
+    // =====================================================
+    // Runtime Mode Detection
+    // =====================================================
+    if (validated.detection_mode === "runtime" && validated.url) {
+        try {
+            return await withTimeout(handleRuntimeMode(validated, startTime), remainingTimeout, "runtime", startTime);
+        }
+        catch (error) {
+            if (error instanceof MotionTimeoutError) {
+                return createTimeoutResponse(error.phase, error.elapsedMs);
+            }
+            throw error;
+        }
+    }
+    // =====================================================
+    // Hybrid Mode Detection (CSS + Runtime)
+    // =====================================================
+    if (validated.detection_mode === "hybrid" && validated.url) {
+        try {
+            return await withTimeout(handleHybridMode(validated, startTime), remainingTimeout, "hybrid", startTime);
+        }
+        catch (error) {
+            if (error instanceof MotionTimeoutError) {
+                return createTimeoutResponse(error.phase, error.elapsedMs);
+            }
+            throw error;
+        }
+    }
+    // =====================================================
+    // Library Only Mode Detection (v0.1.0)
+    // 注: library_only モードは layout_first モード経由で使用される
+    // 直接呼び出しの場合はデフォルトモードにフォールバック
+    // =====================================================
+    if (validated.detection_mode === "library_only") {
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[MCP Tool] library_only mode: falling back to css mode with JS animation detection", {
+                url: validated.url,
+            });
+        }
+        // デフォルトモードで処理（layout_first経由で呼び出される場合はJS animation optionsが設定済み）
+    }
+    // =====================================================
+    // CSS Mode Detection (Default)
+    // =====================================================
+    try {
+        return await withTimeout(handleDefaultMode(validated, startTime), remainingTimeout, "css", startTime);
+    }
+    catch (error) {
+        if (error instanceof MotionTimeoutError) {
+            return createTimeoutResponse(error.phase, error.elapsedMs);
+        }
+        throw error;
+    }
+}
+// =====================================================
+// WebPage Auto-Create Helper (v0.1.0)
+// URL modeで自動的にWebPageレコードを作成・取得
+// =====================================================
+/**
+ * URL modeでWebPageを自動作成または取得
+ *
+ * motion.detect URL modeで実行時に:
+ * 1. 既存のWebPageをURLで検索（完全一致）
+ * 2. 存在しなければ新規WebPageレコードを作成
+ * 3. webPageIdを返す（savePatternsToDbに渡す）
+ *
+ * @param url - 対象URL
+ * @returns webPageIdとcreatedフラグ、またはエラー時はnull
+ */
+async function findOrCreateWebPageForUrl(url) {
+    try {
+        const webPageService = (0, di_factories_1.getWebPageService)();
+        const result = await webPageService.findOrCreateByUrl(url, {
+            sourceType: "user_provided",
+            usageScope: "inspiration_only",
+        });
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[MCP Tool] motion.detect WebPage findOrCreate result", {
+                url,
+                webPageId: result.id,
+                created: result.created,
+            });
+        }
+        return {
+            webPageId: result.id,
+            created: result.created,
+        };
+    }
+    catch (error) {
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.warn("[MCP Tool] motion.detect WebPage findOrCreate failed", {
+                url,
+                error: error instanceof Error ? error.message : "Unknown error",
+            });
+        }
+        // エラー時はnullを返す（graceful degradation: 保存は source_url のみで続行）
+        return null;
+    }
+}
+// =====================================================
+// Video Mode Handler
+// =====================================================
+async function handleVideoMode(validated, startTime) {
+    if ((0, logger_1.isDevelopment)()) {
+        logger_1.logger.info("[MCP Tool] motion.detect using video mode", {
+            url: validated.url,
+            videoOptions: validated.video_options,
+        });
+    }
+    try {
+        const { videoInfo, patterns, warnings } = await (0, detection_modes_1.executeVideoDetection)(validated.url, validated.video_options);
+        // Phase0: WebPage自動作成（v0.1.0）
+        // URL modeではWebPageを自動作成し、web_page_idを取得
+        let webPageId;
+        let webPageCreated = false;
+        if (validated.save_to_db) {
+            const webPageResult = await findOrCreateWebPageForUrl(validated.url);
+            if (webPageResult) {
+                webPageId = webPageResult.webPageId;
+                webPageCreated = webPageResult.created;
+            }
+        }
+        // Phase5: Frame Capture実行
+        let frameCaptureResult = null;
+        let frameCaptureError;
+        let frameCaptureProcessingTimeMs = 0;
+        if (validated.enable_frame_capture === true) {
+            const frameCaptureStartTime = Date.now();
+            try {
+                const frameCaptureOpts = validated.frame_capture_options ?? {};
+                const frameCaptureExecOpts = {
+                    scroll_px_per_frame: frameCaptureOpts.scroll_px_per_frame ?? 15,
+                    frame_interval_ms: frameCaptureOpts.frame_interval_ms ?? 33,
+                    output_dir: frameCaptureOpts.output_dir ?? "/tmp/reftrix-frames/",
+                    output_format: frameCaptureOpts.output_format ?? "png",
+                    filename_pattern: frameCaptureOpts.filename_pattern ?? "frame-{0000}.png",
+                };
+                if (validated.video_options?.viewport) {
+                    frameCaptureExecOpts.viewport = validated.video_options.viewport;
+                }
+                frameCaptureResult = await (0, detection_modes_1.executeFrameCapture)(validated.url, frameCaptureExecOpts);
+                frameCaptureProcessingTimeMs = Date.now() - frameCaptureStartTime;
+            }
+            catch (fcErr) {
+                frameCaptureProcessingTimeMs = Date.now() - frameCaptureStartTime;
+                const errorObj = fcErr;
+                frameCaptureError = {
+                    code: errorObj.name === "SSRFBlockedError"
+                        ? "FRAME_CAPTURE_SSRF_BLOCKED"
+                        : "FRAME_CAPTURE_ERROR",
+                    message: fcErr instanceof Error ? fcErr.message : "Frame capture failed",
+                };
+            }
+        }
+        // Phase3: Lighthouse実行
+        const lighthouseOptions = validated.lighthouse_options;
+        const lighthouseResults = await executeLighthouseIfEnabled(validated.url, lighthouseOptions);
+        // Phase4: AnimationMetrics実行
+        const animationMetricsResults = await executeAnimationMetricsIfEnabled(validated.analyze_metrics, patterns, lighthouseResults.metrics, validated.analyze_metrics_options);
+        // Phase5: Frame Image Analysis実行
+        const frameAnalysisResults = await executeFrameImageAnalysisIfEnabled(validated.analyze_frames, validated.frame_analysis_options, frameCaptureResult?.output_dir, validated.frame_capture_options?.output_dir, frameCaptureResult?.total_frames // キャプチャされたフレーム数を渡す
+        );
+        // Phase6 v0.1.0: JS Animation検出実行
+        const jsAnimationResults = await executeJSAnimationDetectionWithUrl(validated.url, validated.detect_js_animations, validated.js_animation_options);
+        // Phase7: Frame Analysis DB保存（非同期、メインレスポンスをブロックしない）
+        let frameAnalysisSaveResult;
+        if (validated.save_to_db && frameAnalysisResults.result) {
+            const frameAnalysisSaveResultPromise = executeFrameAnalysisSave(frameAnalysisResults.result, validated.url);
+            // 非同期でDB保存を実行し、結果を待つ
+            // エラー時は警告ログのみ出力し、メインレスポンスには影響しない
+            try {
+                frameAnalysisSaveResult = await frameAnalysisSaveResultPromise;
+                if ((0, logger_1.isDevelopment)()) {
+                    logger_1.logger.info("[MCP Tool] motion.detect frame analysis DB save completed", {
+                        saved: frameAnalysisSaveResult.saved,
+                        savedCount: frameAnalysisSaveResult.savedCount,
+                        patternIds: frameAnalysisSaveResult.patternIds.length,
+                    });
+                }
+            }
+            catch (saveError) {
+                if ((0, logger_1.isDevelopment)()) {
+                    logger_1.logger.warn("[MCP Tool] motion.detect frame analysis DB save failed", {
+                        error: saveError instanceof Error ? saveError.message : "Unknown error",
+                    });
+                }
+                // エラー時も結果を返す（saved: false）
+                frameAnalysisSaveResult = {
+                    saved: false,
+                    savedCount: 0,
+                    patternIds: [],
+                    embeddingIds: [],
+                    reason: saveError instanceof Error ? saveError.message : "DB save failed",
+                };
+            }
+        }
+        // Phase8: Motion Pattern DB保存（v0.1.0）
+        // webPageId をセットしてパターンを保存（source_url は後方互換性のため両方セット）
+        let patternSaveResult;
+        if (validated.save_to_db && patterns.length > 0) {
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.info("[MCP Tool] motion.detect saving patterns to DB (video mode)", {
+                    patternsCount: patterns.length,
+                    webPageId,
+                    webPageCreated,
+                    url: validated.url,
+                });
+            }
+            // webPageId（自動作成または既存）と source_url（後方互換性）の両方を渡す
+            patternSaveResult = await (0, css_mode_handler_1.savePatternsToDb)(patterns, webPageId, validated.url);
+        }
+        // Phase9: JS Animation Pattern DB保存（v0.1.0）
+        let jsAnimationSaveResult;
+        if (validated.save_to_db && jsAnimationResults.result) {
+            jsAnimationSaveResult = await saveJSAnimationsToDb(jsAnimationResults.result, webPageId, validated.url);
+        }
+        // 警告をマージ
+        const allWarnings = [
+            ...warnings,
+            ...lighthouseResults.warnings,
+            ...animationMetricsResults.warnings,
+            ...frameAnalysisResults.warnings,
+            ...jsAnimationResults.warnings,
+        ];
+        // WebGL/Canvas検出警告（patterns=0件 かつ detect_js_animations=false の場合）
+        const webglWarning = (0, css_mode_handler_1.generateWebglDetectionWarning)(patterns.length, validated.detect_js_animations ?? false);
+        if (webglWarning) {
+            allWarnings.push(webglWarning);
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.info("[MCP Tool] motion.detect WebGL detection warning added (video mode)", {
+                    patternCount: patterns.length,
+                    detectJsAnimations: validated.detect_js_animations ?? false,
+                });
+            }
+        }
+        const processingTimeMs = Date.now() - startTime;
+        const summary = {
+            totalPatterns: patterns.length,
+            byType: (0, schemas_1.countByType)(patterns),
+            byTrigger: (0, schemas_1.countByTrigger)(patterns),
+            byCategory: (0, schemas_1.countByCategory)(patterns),
+            averageDuration: (0, schemas_1.calculateAverageDuration)(patterns),
+            hasInfiniteAnimations: false,
+            complexityScore: (0, schemas_1.calculateComplexityScore)(patterns),
+        };
+        const metadata = {
+            detectedAt: new Date().toISOString(),
+            processingTimeMs,
+            schemaVersion: "0.1.0",
+            detection_mode: "video",
+            lighthouse_processing_time_ms: lighthouseResults.processingTimeMs,
+            analyze_metrics_processing_time_ms: animationMetricsResults.processingTimeMs,
+            frame_analysis_processing_time_ms: frameAnalysisResults.processingTimeMs,
+            frame_capture_processing_time_ms: validated.enable_frame_capture
+                ? frameCaptureProcessingTimeMs
+                : undefined,
+            js_animation_processing_time_ms: jsAnimationResults.processingTimeMs,
+        };
+        return {
+            success: true,
+            data: {
+                pageId: webPageId, // v0.1.0: 自動作成または既存のWebPage ID
+                patterns,
+                warnings: validated.includeWarnings !== false ? allWarnings : undefined,
+                summary: validated.includeSummary !== false ? summary : undefined,
+                metadata,
+                saveResult: patternSaveResult?.saveResult, // v0.1.0: パターン保存結果
+                video_info: videoInfo,
+                lighthouse_metrics: lighthouseResults.metrics,
+                lighthouse_error: lighthouseResults.error,
+                lighthouse_save_result: lighthouseResults.saveResult,
+                animation_metrics: animationMetricsResults.metrics,
+                animation_metrics_error: animationMetricsResults.error,
+                frame_analysis: frameAnalysisResults.result,
+                frame_analysis_error: frameAnalysisResults.error,
+                frame_analysis_save_result: frameAnalysisSaveResult,
+                frame_capture: frameCaptureResult
+                    ? {
+                        total_frames: frameCaptureResult.total_frames,
+                        output_dir: frameCaptureResult.output_dir,
+                        config: frameCaptureResult.config,
+                        files: frameCaptureResult.files,
+                        duration_ms: frameCaptureResult.duration_ms,
+                    }
+                    : undefined,
+                frame_capture_error: frameCaptureError,
+                js_animations: jsAnimationResults.result,
+                js_animations_error: jsAnimationResults.error,
+                js_animation_save_result: jsAnimationSaveResult, // v0.1.0: JS Animation保存結果
+            },
+        };
+    }
+    catch (error) {
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.error("[MCP Tool] motion.detect video mode error", { error });
+        }
+        let errorCode = schemas_1.MOTION_MCP_ERROR_CODES.VIDEO_RECORD_ERROR;
+        if (error instanceof detection_modes_1.SSRFBlockedError) {
+            errorCode = schemas_1.MOTION_MCP_ERROR_CODES.SSRF_BLOCKED;
+        }
+        else if (error instanceof detection_modes_1.FrameAnalysisError) {
+            errorCode = schemas_1.MOTION_MCP_ERROR_CODES.FRAME_ANALYSIS_ERROR;
+        }
+        else if (error instanceof detection_modes_1.VideoRecordError) {
+            errorCode =
+                error.message.includes("timeout") || error.message.includes("Timeout")
+                    ? schemas_1.MOTION_MCP_ERROR_CODES.VIDEO_TIMEOUT_ERROR
+                    : schemas_1.MOTION_MCP_ERROR_CODES.VIDEO_RECORD_ERROR;
+        }
+        return {
+            success: false,
+            error: {
+                code: errorCode,
+                message: error instanceof Error ? error.message : "Video detection failed",
+            },
+        };
+    }
+}
+// =====================================================
+// Runtime Mode Handler
+// =====================================================
+async function handleRuntimeMode(validated, startTime) {
+    if ((0, logger_1.isDevelopment)()) {
+        logger_1.logger.info("[MCP Tool] motion.detect using runtime mode", {
+            url: validated.url,
+            runtimeOptions: validated.runtime_options,
+        });
+    }
+    try {
+        const { patterns, warnings, runtime_info } = await (0, detection_modes_1.executeRuntimeDetection)(validated.url, validated.runtime_options);
+        // Phase0: WebPage自動作成（v0.1.0）
+        let webPageId;
+        let webPageCreated = false;
+        if (validated.save_to_db) {
+            const webPageResult = await findOrCreateWebPageForUrl(validated.url);
+            if (webPageResult) {
+                webPageId = webPageResult.webPageId;
+                webPageCreated = webPageResult.created;
+            }
+        }
+        // v0.1.0: JS Animation検出実行
+        const jsAnimationResults = await executeJSAnimationDetectionWithUrl(validated.url, validated.detect_js_animations, validated.js_animation_options);
+        // Motion Pattern DB保存（v0.1.0）
+        let patternSaveResult;
+        if (validated.save_to_db && patterns.length > 0) {
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.info("[MCP Tool] motion.detect saving patterns to DB (runtime mode)", {
+                    patternsCount: patterns.length,
+                    webPageId,
+                    webPageCreated,
+                    url: validated.url,
+                });
+            }
+            patternSaveResult = await (0, css_mode_handler_1.savePatternsToDb)(patterns, webPageId, validated.url);
+        }
+        // Phase: JS Animation Pattern DB保存（v0.1.0）
+        let jsAnimationSaveResult;
+        if (validated.save_to_db && jsAnimationResults.result) {
+            jsAnimationSaveResult = await saveJSAnimationsToDb(jsAnimationResults.result, webPageId, validated.url);
+        }
+        // 警告をマージ
+        const allWarnings = [...warnings, ...jsAnimationResults.warnings];
+        // WebGL/Canvas検出警告（patterns=0件 かつ detect_js_animations=false の場合）
+        const webglWarning = (0, css_mode_handler_1.generateWebglDetectionWarning)(patterns.length, validated.detect_js_animations ?? false);
+        if (webglWarning) {
+            allWarnings.push(webglWarning);
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.info("[MCP Tool] motion.detect WebGL detection warning added (runtime mode)", {
+                    patternCount: patterns.length,
+                    detectJsAnimations: validated.detect_js_animations ?? false,
+                });
+            }
+        }
+        const processingTimeMs = Date.now() - startTime;
+        const summary = {
+            totalPatterns: patterns.length,
+            byType: (0, schemas_1.countByType)(patterns),
+            byTrigger: (0, schemas_1.countByTrigger)(patterns),
+            byCategory: (0, schemas_1.countByCategory)(patterns),
+            averageDuration: (0, schemas_1.calculateAverageDuration)(patterns),
+            hasInfiniteAnimations: patterns.some((p) => p.animation?.iterations === "infinite"),
+            complexityScore: (0, schemas_1.calculateComplexityScore)(patterns),
+        };
+        const metadata = {
+            detectedAt: new Date().toISOString(),
+            processingTimeMs,
+            schemaVersion: "0.1.0",
+            detection_mode: "runtime",
+            js_animation_processing_time_ms: jsAnimationResults.processingTimeMs,
+        };
+        return {
+            success: true,
+            data: {
+                pageId: webPageId, // v0.1.0: 自動作成または既存のWebPage ID
+                patterns,
+                warnings: validated.includeWarnings !== false ? allWarnings : undefined,
+                summary: validated.includeSummary !== false ? summary : undefined,
+                metadata,
+                saveResult: patternSaveResult?.saveResult, // v0.1.0: パターン保存結果
+                runtime_info,
+                js_animations: jsAnimationResults.result,
+                js_animations_error: jsAnimationResults.error,
+                js_animation_save_result: jsAnimationSaveResult, // v0.1.0: JS Animation保存結果
+            },
+        };
+    }
+    catch (error) {
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.error("[MCP Tool] motion.detect runtime mode error", { error });
+        }
+        return {
+            success: false,
+            error: {
+                code: error instanceof detection_modes_1.SSRFBlockedError
+                    ? schemas_1.MOTION_MCP_ERROR_CODES.SSRF_BLOCKED
+                    : schemas_1.MOTION_MCP_ERROR_CODES.INTERNAL_ERROR,
+                message: error instanceof Error ? error.message : "Runtime detection failed",
+            },
+        };
+    }
+}
+// =====================================================
+// Hybrid Mode Handler
+// =====================================================
+async function handleHybridMode(validated, startTime) {
+    if ((0, logger_1.isDevelopment)()) {
+        logger_1.logger.info("[MCP Tool] motion.detect using hybrid mode", {
+            url: validated.url,
+            runtimeOptions: validated.runtime_options,
+        });
+    }
+    try {
+        // 1. Runtime検出を実行
+        const runtimeResult = await (0, detection_modes_1.executeRuntimeDetection)(validated.url, validated.runtime_options);
+        // 2. CSS検出も実行
+        const { chromium } = await import("playwright");
+        let browser = null;
+        let htmlContent = "";
+        try {
+            browser = await chromium.launch({
+                headless: true,
+                args: ["--no-sandbox", "--disable-setuid-sandbox"],
+            });
+            const context = await browser.newContext();
+            const page = await context.newPage();
+            // WebGL/3Dサイト対応: domcontentloadedで待機（loadは3Dサイトで非常に時間がかかる）
+            await page.goto(validated.url, { waitUntil: "domcontentloaded", timeout: 30000 });
+            htmlContent = await page.content();
+        }
+        catch {
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.warn("[MCP Tool] motion.detect hybrid mode: failed to get HTML for CSS detection");
+            }
+        }
+        finally {
+            // ブラウザリソースを確実に解放
+            if (browser) {
+                await browser.close().catch(() => { });
+            }
+        }
+        let cssPatterns = [];
+        let cssWarnings = [];
+        if (htmlContent) {
+            const cssResult = (0, detection_modes_1.defaultDetect)(htmlContent, undefined, {
+                includeInlineStyles: validated.includeInlineStyles,
+                includeStyleSheets: validated.includeStyleSheets,
+                minDuration: validated.minDuration,
+                maxPatterns: validated.maxPatterns,
+                verbose: validated.verbose,
+            });
+            cssPatterns = cssResult.patterns;
+            cssWarnings = cssResult.warnings;
+        }
+        // 3. パターンをマージ
+        const runtimePatternIds = new Set(runtimeResult.patterns.map((p) => p.id));
+        const uniqueCssPatterns = cssPatterns.filter((p) => !runtimePatternIds.has(p.id));
+        const mergedPatterns = [...runtimeResult.patterns, ...uniqueCssPatterns];
+        const mergedWarnings = [...runtimeResult.warnings, ...cssWarnings];
+        // 4. JS Animation検出実行（v0.1.0）
+        const jsAnimationResults = await executeJSAnimationDetectionWithUrl(validated.url, validated.detect_js_animations, validated.js_animation_options);
+        mergedWarnings.push(...jsAnimationResults.warnings);
+        // WebGL/Canvas検出警告（patterns=0件 かつ detect_js_animations=false の場合）
+        const webglWarning = (0, css_mode_handler_1.generateWebglDetectionWarning)(mergedPatterns.length, validated.detect_js_animations ?? false);
+        if (webglWarning) {
+            mergedWarnings.push(webglWarning);
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.info("[MCP Tool] motion.detect WebGL detection warning added (hybrid mode)", {
+                    patternCount: mergedPatterns.length,
+                    detectJsAnimations: validated.detect_js_animations ?? false,
+                });
+            }
+        }
+        // Phase0: WebPage自動作成（v0.1.0）
+        let webPageId;
+        let webPageCreated = false;
+        if (validated.save_to_db) {
+            const webPageResult = await findOrCreateWebPageForUrl(validated.url);
+            if (webPageResult) {
+                webPageId = webPageResult.webPageId;
+                webPageCreated = webPageResult.created;
+            }
+        }
+        // Motion Pattern DB保存（v0.1.0）
+        let patternSaveResult;
+        if (validated.save_to_db && mergedPatterns.length > 0) {
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.info("[MCP Tool] motion.detect saving patterns to DB (hybrid mode)", {
+                    patternsCount: mergedPatterns.length,
+                    webPageId,
+                    webPageCreated,
+                    url: validated.url,
+                });
+            }
+            patternSaveResult = await (0, css_mode_handler_1.savePatternsToDb)(mergedPatterns, webPageId, validated.url);
+        }
+        // Phase: JS Animation Pattern DB保存（v0.1.0）
+        let jsAnimationSaveResult;
+        if (validated.save_to_db && jsAnimationResults.result) {
+            jsAnimationSaveResult = await saveJSAnimationsToDb(jsAnimationResults.result, webPageId, validated.url);
+        }
+        const processingTimeMs = Date.now() - startTime;
+        const summary = {
+            totalPatterns: mergedPatterns.length,
+            byType: (0, schemas_1.countByType)(mergedPatterns),
+            byTrigger: (0, schemas_1.countByTrigger)(mergedPatterns),
+            byCategory: (0, schemas_1.countByCategory)(mergedPatterns),
+            averageDuration: (0, schemas_1.calculateAverageDuration)(mergedPatterns),
+            hasInfiniteAnimations: mergedPatterns.some((p) => p.animation?.iterations === "infinite"),
+            complexityScore: (0, schemas_1.calculateComplexityScore)(mergedPatterns),
+        };
+        const metadata = {
+            detectedAt: new Date().toISOString(),
+            processingTimeMs,
+            schemaVersion: "0.1.0",
+            detection_mode: "hybrid",
+            js_animation_processing_time_ms: jsAnimationResults.processingTimeMs,
+        };
+        const hybridInfo = {
+            runtime_patterns_count: runtimeResult.patterns.length,
+            css_patterns_count: uniqueCssPatterns.length,
+            total_merged_patterns: mergedPatterns.length,
+        };
+        return {
+            success: true,
+            data: {
+                pageId: webPageId, // v0.1.0: 自動作成または既存のWebPage ID
+                patterns: mergedPatterns,
+                warnings: validated.includeWarnings !== false ? mergedWarnings : undefined,
+                summary: validated.includeSummary !== false ? summary : undefined,
+                metadata: {
+                    ...metadata,
+                    hybrid_info: hybridInfo,
+                },
+                saveResult: patternSaveResult?.saveResult, // v0.1.0: パターン保存結果
+                runtime_info: runtimeResult.runtime_info,
+                js_animations: jsAnimationResults.result, // v0.1.0: JS Animation検出結果
+                js_animations_error: jsAnimationResults.error,
+                js_animation_save_result: jsAnimationSaveResult, // v0.1.0: JS Animation保存結果
+            },
+        };
+    }
+    catch (error) {
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.error("[MCP Tool] motion.detect hybrid mode error", { error });
+        }
+        return {
+            success: false,
+            error: {
+                code: error instanceof detection_modes_1.SSRFBlockedError
+                    ? schemas_1.MOTION_MCP_ERROR_CODES.SSRF_BLOCKED
+                    : schemas_1.MOTION_MCP_ERROR_CODES.INTERNAL_ERROR,
+                message: error instanceof Error ? error.message : "Hybrid detection failed",
+            },
+        };
+    }
+}
+// =====================================================
+// Default (CSS) Mode Handler
+// =====================================================
+async function handleDefaultMode(validated, startTime) {
+    let html = validated.html;
+    let css = validated.css;
+    let pageId;
+    // pageIdが指定されている場合はDBから取得
+    if (validated.pageId && !html) {
+        try {
+            const serviceFactory = (0, di_factories_1.getMotionDetectServiceFactory)();
+            const service = serviceFactory?.();
+            if (!service?.getPageById) {
+                return {
+                    success: false,
+                    error: {
+                        code: schemas_1.MOTION_MCP_ERROR_CODES.SERVICE_UNAVAILABLE,
+                        message: "Page service is not available",
+                    },
+                };
+            }
+            const page = await service.getPageById(validated.pageId);
+            if (!page) {
+                return {
+                    success: false,
+                    error: {
+                        code: schemas_1.MOTION_MCP_ERROR_CODES.PAGE_NOT_FOUND,
+                        message: `Page not found: ${validated.pageId}`,
+                    },
+                };
+            }
+            html = page.htmlContent;
+            css = page.cssContent;
+            pageId = page.id;
+        }
+        catch (error) {
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.error("[MCP Tool] motion.detect DB error", { error });
+            }
+            return {
+                success: false,
+                error: {
+                    code: schemas_1.MOTION_MCP_ERROR_CODES.DB_ERROR,
+                    message: error instanceof Error ? error.message : "Database error",
+                },
+            };
+        }
+    }
+    if (!html) {
+        return {
+            success: false,
+            error: {
+                code: schemas_1.MOTION_MCP_ERROR_CODES.VALIDATION_ERROR,
+                message: "No HTML content provided",
+            },
+        };
+    }
+    return (0, css_mode_handler_1.handleCssMode)(validated, html, css, pageId, startTime);
+}
+async function executeLighthouseIfEnabled(url, options) {
+    if (!options?.enabled) {
+        return { metrics: null, warnings: [], processingTimeMs: undefined };
+    }
+    const warnings = [];
+    const startTime = Date.now();
+    const lighthouseService = (0, di_factories_1.getLighthouseDetectorService)();
+    if (!lighthouseService) {
+        warnings.push({
+            code: schemas_1.MOTION_WARNING_CODES.LIGHTHOUSE_UNAVAILABLE,
+            severity: "warning",
+            message: "Lighthouse detector service factory not configured",
+        });
+        return { metrics: null, warnings, processingTimeMs: Date.now() - startTime };
+    }
+    try {
+        const isAvailable = await lighthouseService.isAvailable();
+        if (!isAvailable) {
+            warnings.push({
+                code: schemas_1.MOTION_WARNING_CODES.LIGHTHOUSE_UNAVAILABLE,
+                severity: "warning",
+                message: "Lighthouse service is not available",
+            });
+            return { metrics: null, warnings, processingTimeMs: Date.now() - startTime };
+        }
+        const analyzeOpts = {
+            categories: options.categories || ["performance"],
+            throttling: options.throttling ?? false,
+        };
+        if (options.timeout !== undefined) {
+            analyzeOpts.timeout = options.timeout;
+        }
+        const result = await lighthouseService.analyze(url, analyzeOpts);
+        const returnResult = {
+            metrics: result.metrics,
+            warnings,
+            processingTimeMs: Date.now() - startTime,
+        };
+        if (options.save_to_db) {
+            returnResult.saveResult = { saved: true };
+        }
+        return returnResult;
+    }
+    catch (err) {
+        const errorObj = err;
+        const isTimeout = errorObj.message?.toLowerCase().includes("timeout") ||
+            errorObj.message?.toLowerCase().includes("timed out") ||
+            errorObj.code === "TIMEOUT";
+        return {
+            metrics: null,
+            error: {
+                code: isTimeout ? "LIGHTHOUSE_TIMEOUT" : "LIGHTHOUSE_ERROR",
+                message: err instanceof Error ? err.message : "Lighthouse analysis failed",
+            },
+            warnings,
+            processingTimeMs: Date.now() - startTime,
+        };
+    }
+}
+async function executeAnimationMetricsIfEnabled(enabled, patterns, lighthouseMetrics, options) {
+    if (!enabled) {
+        return { metrics: null, warnings: [], processingTimeMs: undefined };
+    }
+    const warnings = [];
+    const startTime = Date.now();
+    const collector = (0, di_factories_1.getAnimationMetricsCollector)();
+    if (!collector) {
+        warnings.push({
+            code: schemas_1.MOTION_WARNING_CODES.ANIMATION_METRICS_UNAVAILABLE,
+            severity: "warning",
+            message: "Animation metrics collector factory not configured",
+        });
+        return { metrics: null, warnings, processingTimeMs: Date.now() - startTime };
+    }
+    try {
+        const result = await collector.analyze({
+            patterns,
+            lighthouseMetrics: lighthouseMetrics ?? null,
+        });
+        const metrics = {
+            patternImpacts: result.patternImpacts.map((impact) => ({
+                patternId: impact.patternId,
+                patternName: impact.patternName,
+                impactScore: impact.score,
+                layoutImpact: Math.min(100, impact.factors.filter((f) => f.includes("layout")).length * 25),
+                renderImpact: Math.min(100, impact.factors.filter((f) => f.includes("paint") || f.includes("render")).length * 25),
+                cpuImpact: Math.min(100, impact.factors.filter((f) => f.includes("cpu") || f.includes("duration")).length * 25),
+                severity: impact.impactLevel === "high" ? "critical" : impact.impactLevel,
+                details: { factors: impact.factors },
+            })),
+            overallScore: result.overallScore,
+            clsContributors: options?.include_cls_contributors !== false
+                ? result.clsContributors.map((c) => ({
+                    selector: c.patternName,
+                    contribution: c.estimatedContribution,
+                    relatedPatternId: c.patternId,
+                }))
+                : [],
+            layoutTriggeringProperties: result.layoutTriggeringProperties,
+            recommendations: options?.include_recommendations !== false
+                ? result.recommendations.map((r) => ({
+                    id: `rec-${r.category}-${r.priority}`,
+                    priority: r.priority,
+                    category: r.category.includes("transform") || r.category.includes("layout")
+                        ? "layout"
+                        : r.category.includes("paint")
+                            ? "rendering"
+                            : r.category.includes("animation") || r.category.includes("duration")
+                                ? "animation"
+                                : "accessibility",
+                    title: r.description.split(".")[0] || r.description,
+                    description: r.description,
+                    affectedPatterns: r.affectedPatternIds,
+                    estimatedImpact: r.estimatedImprovement ? 0.5 : 0.3,
+                    effort: r.priority === "high" ? "low" : r.priority === "medium" ? "medium" : "high",
+                }))
+                : [],
+            lighthouseAvailable: result.lighthouseAvailable,
+            analyzedAt: result.analyzedAt,
+        };
+        return { metrics, warnings, processingTimeMs: Date.now() - startTime };
+    }
+    catch (err) {
+        const errorObj = err;
+        const isTimeout = errorObj.message?.toLowerCase().includes("timeout") || errorObj.code === "TIMEOUT";
+        return {
+            metrics: null,
+            error: {
+                code: isTimeout ? "ANIMATION_METRICS_TIMEOUT" : "ANIMATION_METRICS_ERROR",
+                message: err instanceof Error ? err.message : "Animation metrics analysis failed",
+            },
+            warnings,
+            processingTimeMs: Date.now() - startTime,
+        };
+    }
+}
+async function executeFrameImageAnalysisIfEnabled(enabled, options, capturedOutputDir, configuredOutputDir, capturedTotalFrames // キャプチャされたフレーム数（古いフレームとの混在防止）
+) {
+    if (!enabled) {
+        return { result: null, warnings: [], processingTimeMs: undefined };
+    }
+    const warnings = [];
+    const startTime = Date.now();
+    const service = (0, di_factories_1.getFrameImageAnalysisService)();
+    if (!service) {
+        warnings.push({
+            code: schemas_1.MOTION_WARNING_CODES.FRAME_ANALYSIS_UNAVAILABLE,
+            severity: "warning",
+            message: "Frame image analysis service factory not configured",
+        });
+        return { result: null, warnings, processingTimeMs: Date.now() - startTime };
+    }
+    if (!service.isAvailable()) {
+        warnings.push({
+            code: schemas_1.MOTION_WARNING_CODES.FRAME_ANALYSIS_UNAVAILABLE,
+            severity: "warning",
+            message: "Frame image analysis service is not available",
+        });
+        return { result: null, warnings, processingTimeMs: Date.now() - startTime };
+    }
+    const frameDir = options?.frame_dir ?? capturedOutputDir ?? configuredOutputDir ?? "/tmp/reftrix-frames/";
+    try {
+        const result = await service.analyze(frameDir, {
+            sampleInterval: options?.sample_interval ?? 10,
+            diffThreshold: options?.diff_threshold ?? 0.1,
+            clsThreshold: options?.cls_threshold ?? 0.05,
+            motionThreshold: options?.motion_threshold ?? 50,
+            outputDiffImages: options?.output_diff_images ?? false,
+            parallel: options?.parallel ?? true,
+            scrollPxPerFrame: 15,
+            // キャプチャされたフレーム数のみを分析対象にする（exactOptionalPropertyTypes対応）
+            ...(capturedTotalFrames !== undefined ? { maxFrames: capturedTotalFrames } : {}),
+        });
+        return { result, warnings, processingTimeMs: Date.now() - startTime };
+    }
+    catch (err) {
+        const errorObj = err;
+        const isTimeout = errorObj.message?.toLowerCase().includes("timeout") || errorObj.code === "TIMEOUT";
+        return {
+            result: null,
+            error: {
+                code: isTimeout ? "FRAME_ANALYSIS_TIMEOUT" : "FRAME_ANALYSIS_ERROR",
+                message: err instanceof Error ? err.message : "Frame image analysis failed",
+            },
+            warnings,
+            processingTimeMs: Date.now() - startTime,
+        };
+    }
+}
+/**
+ * フレーム画像分析結果をDBに保存
+ *
+ * FrameEmbeddingService を使用して、AnimationZone/LayoutShift/MotionVector を
+ * MotionPattern として保存し、Embedding を生成します。
+ *
+ * @param analysisResult - フレーム画像分析結果
+ * @param sourceUrl - ソースURL（任意）
+ * @returns 保存結果
+ */
+async function executeFrameAnalysisSave(analysisResult, sourceUrl) {
+    const service = (0, di_factories_1.getFrameEmbeddingServiceInstance)();
+    if (!service) {
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.warn("[MCP Tool] motion.detect frame embedding service not available");
+        }
+        return {
+            saved: false,
+            savedCount: 0,
+            patternIds: [],
+            embeddingIds: [],
+            reason: "Frame embedding service not available",
+        };
+    }
+    if (!service.isAvailable()) {
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.warn("[MCP Tool] motion.detect frame embedding service not ready");
+        }
+        return {
+            saved: false,
+            savedCount: 0,
+            patternIds: [],
+            embeddingIds: [],
+            reason: "Frame embedding service is not ready (check PrismaClient/EmbeddingService factories)",
+        };
+    }
+    if ((0, logger_1.isDevelopment)()) {
+        logger_1.logger.info("[MCP Tool] motion.detect saving frame analysis to DB", {
+            animationZones: analysisResult.animationZones.length,
+            layoutShifts: analysisResult.layoutShifts.length,
+            motionVectors: analysisResult.motionVectors.length,
+            sourceUrl,
+        });
+    }
+    const result = await service.saveFrameAnalysis({
+        analysisResult,
+        sourceUrl,
+    });
+    return result;
+}
+/**
+ * URLからPlaywrightページを作成してJS Animation検出を実行
+ *
+ * runtime/hybrid/video モードで使用
+ *
+ * @param url - 対象URL
+ * @param enabled - detect_js_animations パラメータ
+ * @param options - js_animation_options パラメータ
+ * @returns 検出結果ラッパー
+ */
+async function executeJSAnimationDetectionWithUrl(url, enabled, options) {
+    if (!enabled) {
+        return { result: null, warnings: [], processingTimeMs: undefined };
+    }
+    const warnings = [];
+    const startTime = Date.now();
+    // Playwrightを動的にインポートしてブラウザを起動
+    const { chromium } = await import("playwright");
+    let browser = null;
+    try {
+        browser = await chromium.launch({
+            headless: true,
+            args: ["--no-sandbox", "--disable-setuid-sandbox", "--disable-dev-shm-usage"],
+        });
+        const context = await browser.newContext({
+            viewport: { width: 1280, height: 720 },
+            userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 Reftrix/0.1.0",
+        });
+        const page = await context.newPage();
+        // WebGL/3Dサイト対応: domcontentloadedで待機（loadは3Dサイトで非常に時間がかかる）
+        await page.goto(url, {
+            waitUntil: "domcontentloaded",
+            timeout: 30000,
+        });
+        // 少し待機してアニメーションが開始されるのを待つ
+        await page.waitForTimeout(500);
+        // JS Animation検出を実行
+        const detector = (0, di_factories_1.getJSAnimationDetectorService)();
+        const result = await detector.detect(page, {
+            enableCDP: options?.enable_cdp ?? true,
+            enableWebAnimations: options?.enable_web_animations ?? true,
+            enableLibraryDetection: options?.enable_library_detection ?? true,
+            waitTime: options?.wait_time ?? 1000,
+        });
+        // クリーンアップ
+        await detector.cleanup();
+        return {
+            result,
+            warnings,
+            processingTimeMs: Date.now() - startTime,
+        };
+    }
+    catch (err) {
+        const errorObj = err;
+        const isTimeout = errorObj.message?.toLowerCase().includes("timeout") || errorObj.code === "TIMEOUT";
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.warn("[MCP Tool] motion.detect JS animation detection with URL failed", {
+                url,
+                error: err instanceof Error ? err.message : "Unknown error",
+            });
+        }
+        return {
+            result: null,
+            error: {
+                code: isTimeout ? "JS_ANIMATION_TIMEOUT" : "JS_ANIMATION_ERROR",
+                message: err instanceof Error ? err.message : "JS animation detection failed",
+            },
+            warnings,
+            processingTimeMs: Date.now() - startTime,
+        };
+    }
+    finally {
+        // ブラウザリソースを確実に解放
+        if (browser) {
+            await browser.close().catch(() => { });
+        }
+    }
+}
+/**
+ * JSアニメーション検出結果をDBに保存
+ *
+ * JSAnimationResultをJSAnimationPatternCreateDataに変換し、
+ * js_animation_patterns テーブルと js_animation_embeddings テーブルに保存する。
+ * page.analyze と同じ保存ロジック（mapJSAnimationResultToPatterns + saveJSAnimationPatternsWithEmbeddings）を使用。
+ *
+ * @param jsAnimationResult - JSAnimationDetectorService の検出結果
+ * @param webPageId - WebPage ID（保存先のページID）
+ * @param sourceUrl - ソースURL
+ * @returns 保存結果
+ */
+async function saveJSAnimationsToDb(jsAnimationResult, webPageId, sourceUrl) {
+    // PrismaClientを取得
+    const prisma = (0, di_factories_2.getJSAnimationPersistencePrismaClient)();
+    if (!prisma) {
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.warn("[motion.detect] JS animation persistence PrismaClient not available, skipping DB save");
+        }
+        return { savedPatternCount: 0, embeddingCount: 0, error: "PrismaClient not available" };
+    }
+    try {
+        // JSAnimationResult -> JSAnimationFullResult は構造的に互換
+        // （CDPAnimation extends CDPAnimationData, WebAnimation extends WebAnimationData）
+        const fullResult = jsAnimationResult;
+        // JSAnimationFullResult -> JSAnimationPatternCreateData[] に変換
+        const patterns = (0, js_animation_handler_1.mapJSAnimationResultToPatterns)(fullResult, webPageId, sourceUrl);
+        if (patterns.length === 0) {
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.debug("[motion.detect] No JS animation patterns to save");
+            }
+            return { savedPatternCount: 0, embeddingCount: 0 };
+        }
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[motion.detect] Saving JS animation patterns to DB", {
+                patternsCount: patterns.length,
+                webPageId,
+                sourceUrl,
+            });
+        }
+        // page.analyze と同じ保存ロジックを使用（IPageAnalyzePrismaClient互換のキャスト）
+        const saveResult = await (0, js_animation_handler_1.saveJSAnimationPatternsWithEmbeddings)(
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        prisma, patterns, webPageId, {
+            generateEmbedding: true,
+        });
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[motion.detect] JS animation DB save completed", {
+                savedPatternCount: saveResult.savedPatternCount,
+                embeddingCount: saveResult.embeddingCount,
+            });
+        }
+        return saveResult;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Unknown error";
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.error("[motion.detect] JS animation DB save error", { error: errorMessage });
+        }
+        return { savedPatternCount: 0, embeddingCount: 0, error: errorMessage };
+    }
+}
+// =====================================================
+// ツール定義
+// =====================================================
+exports.motionDetectToolDefinition = {
+    name: "motion.detect",
+    description: "Detect/classify motion patterns from web page. Parses CSS animations, transitions, keyframes. Warns about performance/accessibility issues.",
+    annotations: {
+        title: "Motion Detect",
+        readOnlyHint: true,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    inputSchema: {
+        type: "object",
+        properties: {
+            pageId: {
+                type: "string",
+                format: "uuid",
+                description: "WebPage ID (UUID, from DB)",
+            },
+            html: {
+                type: "string",
+                minLength: 1,
+                maxLength: 10000000,
+                description: "HTML content (direct, max 10MB)",
+            },
+            css: {
+                type: "string",
+                maxLength: 5000000,
+                description: "Additional CSS content (max 5MB)",
+            },
+            includeInlineStyles: {
+                type: "boolean",
+                default: true,
+                description: "Parse inline styles (default: true)",
+            },
+            includeStyleSheets: {
+                type: "boolean",
+                default: true,
+                description: "Parse stylesheets (default: true)",
+            },
+            minDuration: {
+                type: "number",
+                minimum: 0,
+                maximum: 60000,
+                default: 0,
+                description: "Minimum duration to detect (ms, default: 0)",
+            },
+            maxPatterns: {
+                type: "number",
+                minimum: 1,
+                maximum: 4000,
+                default: 100,
+                description: "Max patterns to detect (default: 100)",
+            },
+            includeWarnings: {
+                type: "boolean",
+                default: true,
+                description: "Include warnings (default: true)",
+            },
+            min_severity: {
+                type: "string",
+                enum: ["info", "warning", "error"],
+                default: "info",
+                description: "Minimum severity level to include in warnings (default: info)",
+            },
+            includeSummary: {
+                type: "boolean",
+                default: true,
+                description: "Include summary (default: true)",
+            },
+            verbose: {
+                type: "boolean",
+                default: false,
+                description: "Verbose mode: include rawCss (default: false)",
+            },
+            fetchExternalCss: {
+                type: "boolean",
+                default: true,
+                description: "Fetch external CSS from <link> tags (default: true)",
+            },
+            baseUrl: {
+                type: "string",
+                format: "uri",
+                description: "Base URL for resolving relative CSS paths (required if fetchExternalCss is true)",
+            },
+            externalCssOptions: {
+                type: "object",
+                description: "Options for external CSS fetching",
+                properties: {
+                    timeout: {
+                        type: "number",
+                        minimum: 1000,
+                        maximum: 30000,
+                        default: 5000,
+                        description: "Fetch timeout in ms (default: 5000)",
+                    },
+                    maxConcurrent: {
+                        type: "number",
+                        minimum: 1,
+                        maximum: 10,
+                        default: 5,
+                        description: "Max concurrent fetches (default: 5)",
+                    },
+                },
+            },
+            save_to_db: {
+                type: "boolean",
+                default: true,
+                description: "Save detected patterns to motion_patterns table with embeddings (default: true)",
+            },
+            detection_mode: {
+                type: "string",
+                enum: ["css", "video", "runtime", "hybrid"],
+                default: "video",
+                description: "Detection mode: 'css' (requires html/pageId) for static CSS parsing without browser, 'video' (default, requires url) for visual motion detection with frame capture, 'runtime' (requires url) for JS-driven animations, 'hybrid' (requires url) for CSS+runtime combined.",
+            },
+            url: {
+                type: "string",
+                format: "uri",
+                description: "Target URL for video/runtime/hybrid modes. Required when detection_mode='video', 'runtime', or 'hybrid'.",
+            },
+            detect_js_animations: {
+                type: "boolean",
+                default: false,
+                description: "Enable JavaScript animation detection via CDP + Web Animations API. Requires Playwright. Default: false (disabled for performance).",
+            },
+            timeout: {
+                type: "integer",
+                minimum: 30000,
+                maximum: 600000,
+                default: 180000,
+                description: "Overall timeout in milliseconds (30000-600000, default: 180000 = 3 minutes). On timeout, returns partial results with warnings (graceful degradation).",
+            },
+        },
+        required: ["html"],
+    },
+};
+// =====================================================
+// handleMotionDetect エイリアス (v0.1.0)
+// テストとの互換性のため motionDetectHandler のエイリアスをエクスポート
+// =====================================================
+/**
+ * motion.detect ツールハンドラーのエイリアス
+ * テストとの互換性のために提供
+ */
+exports.handleMotionDetect = motionDetectHandler;
+//# sourceMappingURL=detect.tool.js.map