@reftrixmcp/mcp-server 0.1.7 → 0.2.0

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

@@ -1,1421 +0,0 @@
-"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