@reftrixmcp/mcp-server 0.1.7

package/dist/services/page/fallback-analyzer.service.d.ts

@@ -0,0 +1,140 @@
+/** フォールバックレベル (1, 2, 3) */
+export type FallbackLevel = 1 | 2 | 3;
+/** 警告情報 */
+export interface FallbackWarning {
+    code: string;
+    message: string;
+    level: "info" | "warning" | "error";
+}
+/** レベル試行結果 */
+export interface LevelAttempt {
+    level: FallbackLevel;
+    success: boolean;
+    durationMs: number;
+    error?: string;
+}
+/** レイアウト結果 */
+export interface LayoutResult {
+    success: boolean;
+    sectionCount: number;
+    sectionTypes: Record<string, number>;
+    processingTimeMs: number;
+}
+/** モーション結果 */
+export interface MotionResult {
+    success: boolean;
+    patternCount: number;
+    categoryBreakdown: Record<string, number>;
+    warningCount: number;
+    processingTimeMs: number;
+}
+/** 品質結果 */
+export interface QualityResult {
+    success: boolean;
+    overallScore: number;
+    grade: string;
+    axisScores: {
+        originality: number;
+        craftsmanship: number;
+        contextuality: number;
+    };
+    processingTimeMs: number;
+}
+/** 分析機能フラグ */
+export interface FallbackFeatures {
+    layout?: boolean;
+    motion?: boolean;
+    quality?: boolean;
+}
+/** フォールバック分析オプション */
+export interface FallbackAnalyzeOptions {
+    url: string;
+    features?: FallbackFeatures;
+    timeoutMultiplier?: number;
+}
+/** フォールバック分析結果（成功時） */
+export interface FallbackAnalyzeSuccessResult {
+    success: true;
+    partial?: boolean | undefined;
+    warnings?: FallbackWarning[] | undefined;
+    webPageId?: string | undefined;
+    url?: string | undefined;
+    appliedLevel?: number | undefined;
+    appliedLevelDescription?: string | undefined;
+    layout?: LayoutResult | undefined;
+    motion?: MotionResult | undefined;
+    quality?: QualityResult | undefined;
+    totalProcessingTimeMs?: number | undefined;
+    analyzedAt?: string | undefined;
+    levelAttempts?: LevelAttempt[] | undefined;
+}
+/** フォールバック分析結果（エラー時） */
+export interface FallbackAnalyzeErrorResult {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+    };
+}
+/** フォールバック分析結果 */
+export type FallbackAnalyzeResult = FallbackAnalyzeSuccessResult | FallbackAnalyzeErrorResult;
+/** フォールバックレベル設定 */
+export interface FallbackLevelConfig {
+    level: FallbackLevel;
+    timeout: number;
+    waitUntil: "load" | "domcontentloaded" | "networkidle";
+    disableJavaScript: boolean;
+    disableWebGL: boolean;
+    description: string;
+}
+/** ページ分析サービスインターフェース */
+export interface IPageAnalyzeService {
+    analyze: (options: FallbackAnalyzeOptions & {
+        level: FallbackLevel;
+        timeout: number;
+        waitUntil: "load" | "domcontentloaded" | "networkidle";
+        disableJavaScript: boolean;
+        disableWebGL: boolean;
+        features: FallbackFeatures;
+    }) => Promise<FallbackAnalyzeResult>;
+}
+/**
+ * フォールバックレベル定義
+ *
+ * Level 1: 標準分析
+ * Level 2: 軽量分析（JavaScript無効）
+ * Level 3: 最小分析（WebGL無効）
+ */
+export declare const FALLBACK_LEVELS: Record<FallbackLevel, FallbackLevelConfig>;
+/**
+ * FallbackAnalyzerService
+ *
+ * 段階的フォールバック戦略でWebページを分析するサービス
+ */
+export declare class FallbackAnalyzerService {
+    private pageAnalyzeService;
+    /**
+     * ページ分析サービスを設定
+     */
+    setPageAnalyzeService(service: IPageAnalyzeService): void;
+    /**
+     * 段階的フォールバックで分析を実行
+     *
+     * @param options - 分析オプション
+     * @returns 分析結果
+     */
+    analyzeWithFallback(options: FallbackAnalyzeOptions): Promise<FallbackAnalyzeResult>;
+    /**
+     * オプションのバリデーション
+     */
+    private validateOptions;
+}
+/**
+ * FallbackAnalyzerServiceのシングルトンインスタンスを取得
+ */
+export declare function createFallbackAnalyzerService(): FallbackAnalyzerService;
+/**
+ * シングルトンインスタンスをリセット
+ */
+export declare function resetFallbackAnalyzerService(): void;
+//# sourceMappingURL=fallback-analyzer.service.d.ts.map

package/dist/services/page/fallback-analyzer.service.d.ts.map

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

package/dist/services/page/fallback-analyzer.service.js

@@ -0,0 +1,289 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FallbackAnalyzerService = exports.FALLBACK_LEVELS = void 0;
+exports.createFallbackAnalyzerService = createFallbackAnalyzerService;
+exports.resetFallbackAnalyzerService = resetFallbackAnalyzerService;
+/**
+ * FallbackAnalyzerService
+ *
+ * WebGLを多用する重いサイト（例: lbproject.dev）の分析時に、
+ * タイムアウトを防ぐため3段階のフォールバック戦略を実装する。
+ *
+ * フォールバックレベル:
+ * - Level 1: 標準分析（timeout: 30s, waitUntil: 'load'）
+ * - Level 2: 軽量分析（timeout: 60s, waitUntil: 'domcontentloaded', disableJavaScript: true）
+ * - Level 3: 最小分析（timeout: 120s, waitUntil: 'domcontentloaded', disableWebGL: true）
+ *
+ * 全レベル失敗時:
+ * - success: true, partial: true で部分結果を返す
+ * - warnings に失敗情報を含める
+ *
+ * @module services/page/fallback-analyzer.service
+ */
+const logger_1 = require("../../utils/logger");
+// ============================================================================
+// Constants
+// ============================================================================
+/**
+ * フォールバックレベル定義
+ *
+ * Level 1: 標準分析
+ * Level 2: 軽量分析（JavaScript無効）
+ * Level 3: 最小分析（WebGL無効）
+ */
+exports.FALLBACK_LEVELS = {
+    1: {
+        level: 1,
+        timeout: 30000,
+        waitUntil: "load",
+        disableJavaScript: false,
+        disableWebGL: false,
+        description: "Standard analysis",
+    },
+    2: {
+        level: 2,
+        timeout: 60000,
+        waitUntil: "domcontentloaded",
+        disableJavaScript: true,
+        disableWebGL: false,
+        description: "Lightweight analysis (JavaScript disabled)",
+    },
+    3: {
+        level: 3,
+        timeout: 120000,
+        waitUntil: "domcontentloaded",
+        disableJavaScript: true,
+        disableWebGL: true,
+        description: "Minimal analysis (WebGL disabled)",
+    },
+};
+// SSRFブロック対象のプライベートIP/ホスト
+const SSRF_BLOCKED_HOSTS = ["localhost", "127.0.0.1", "0.0.0.0", "::1", "[::1]"];
+const SSRF_BLOCKED_IP_PATTERNS = [
+    /^10\./,
+    /^172\.(1[6-9]|2[0-9]|3[0-1])\./,
+    /^192\.168\./,
+    /^169\.254\./,
+    /^fc00:/i,
+    /^fe80:/i,
+];
+// ============================================================================
+// Service Implementation
+// ============================================================================
+/**
+ * FallbackAnalyzerService
+ *
+ * 段階的フォールバック戦略でWebページを分析するサービス
+ */
+class FallbackAnalyzerService {
+    pageAnalyzeService = null;
+    /**
+     * ページ分析サービスを設定
+     */
+    setPageAnalyzeService(service) {
+        this.pageAnalyzeService = service;
+    }
+    /**
+     * 段階的フォールバックで分析を実行
+     *
+     * @param options - 分析オプション
+     * @returns 分析結果
+     */
+    async analyzeWithFallback(options) {
+        const startTime = Date.now();
+        // バリデーション
+        const validationError = this.validateOptions(options);
+        if (validationError) {
+            return validationError;
+        }
+        // サービス未設定チェック
+        if (!this.pageAnalyzeService) {
+            return {
+                success: false,
+                error: {
+                    code: "SERVICE_NOT_CONFIGURED",
+                    message: "Page analyze service is not configured",
+                },
+            };
+        }
+        const warnings = [];
+        const levelAttempts = [];
+        const timeoutMultiplier = options.timeoutMultiplier ?? 1;
+        const features = options.features ?? {
+            layout: true,
+            motion: true,
+            quality: true,
+        };
+        // Level 1, 2, 3 の順に試行
+        for (const level of [1, 2, 3]) {
+            const levelConfig = exports.FALLBACK_LEVELS[level];
+            const levelStartTime = Date.now();
+            // Level 3ではmotionを強制無効化
+            const levelFeatures = level === 3 ? { ...features, motion: false } : { ...features };
+            const analyzeOptions = {
+                ...options,
+                level,
+                timeout: Math.round(levelConfig.timeout * timeoutMultiplier),
+                waitUntil: levelConfig.waitUntil,
+                disableJavaScript: levelConfig.disableJavaScript,
+                disableWebGL: levelConfig.disableWebGL,
+                features: levelFeatures,
+            };
+            logger_1.logger.debug(`[FallbackAnalyzer] Attempting Level ${level}`, {
+                url: options.url,
+                timeout: analyzeOptions.timeout,
+                waitUntil: analyzeOptions.waitUntil,
+            });
+            try {
+                const result = await this.pageAnalyzeService.analyze(analyzeOptions);
+                const levelDurationMs = Date.now() - levelStartTime;
+                levelAttempts.push({
+                    level,
+                    success: true,
+                    durationMs: levelDurationMs,
+                });
+                if (result.success) {
+                    // 成功時: 警告とメタデータを追加して返す
+                    return {
+                        ...result,
+                        appliedLevel: level,
+                        appliedLevelDescription: levelConfig.description,
+                        warnings: warnings.length > 0 ? warnings : undefined,
+                        totalProcessingTimeMs: Date.now() - startTime,
+                        levelAttempts,
+                    };
+                }
+            }
+            catch (error) {
+                const levelDurationMs = Date.now() - levelStartTime;
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                levelAttempts.push({
+                    level,
+                    success: false,
+                    durationMs: levelDurationMs,
+                    error: errorMessage,
+                });
+                // 失敗警告を記録
+                warnings.push({
+                    code: `LEVEL_${level}_FAILED`,
+                    message: `Level ${level} analysis failed: ${errorMessage}`,
+                    level: "info",
+                });
+                logger_1.logger.debug(`[FallbackAnalyzer] Level ${level} failed`, {
+                    error: errorMessage,
+                    durationMs: levelDurationMs,
+                });
+            }
+        }
+        // 全レベル失敗時: 部分結果を返す
+        warnings.push({
+            code: "ALL_LEVELS_FAILED",
+            message: "All fallback levels failed for this URL",
+            level: "error",
+        });
+        logger_1.logger.debug("[FallbackAnalyzer] All levels failed", {
+            url: options.url,
+            warnings,
+        });
+        return {
+            success: true,
+            partial: true,
+            url: options.url,
+            warnings,
+            appliedLevel: 0,
+            appliedLevelDescription: "All levels failed",
+            layout: undefined,
+            motion: undefined,
+            quality: undefined,
+            webPageId: undefined,
+            totalProcessingTimeMs: Date.now() - startTime,
+            analyzedAt: new Date().toISOString(),
+            levelAttempts,
+        };
+    }
+    /**
+     * オプションのバリデーション
+     */
+    validateOptions(options) {
+        // URL必須チェック
+        if (!options.url || options.url.trim() === "") {
+            return {
+                success: false,
+                error: {
+                    code: "VALIDATION_ERROR",
+                    message: "URL is required",
+                },
+            };
+        }
+        // URL形式チェック
+        let parsedUrl;
+        try {
+            parsedUrl = new URL(options.url);
+        }
+        catch {
+            return {
+                success: false,
+                error: {
+                    code: "VALIDATION_ERROR",
+                    message: "Invalid URL format",
+                },
+            };
+        }
+        // プロトコルチェック
+        if (!["http:", "https:"].includes(parsedUrl.protocol)) {
+            return {
+                success: false,
+                error: {
+                    code: "VALIDATION_ERROR",
+                    message: "Only http:// and https:// protocols are allowed",
+                },
+            };
+        }
+        // SSRFチェック
+        const hostname = parsedUrl.hostname.toLowerCase();
+        if (SSRF_BLOCKED_HOSTS.includes(hostname)) {
+            return {
+                success: false,
+                error: {
+                    code: "SSRF_BLOCKED",
+                    message: "Access to local/private hosts is blocked",
+                },
+            };
+        }
+        for (const pattern of SSRF_BLOCKED_IP_PATTERNS) {
+            if (pattern.test(hostname)) {
+                return {
+                    success: false,
+                    error: {
+                        code: "SSRF_BLOCKED",
+                        message: "Access to private IP addresses is blocked",
+                    },
+                };
+            }
+        }
+        return null;
+    }
+}
+exports.FallbackAnalyzerService = FallbackAnalyzerService;
+// ============================================================================
+// Singleton Factory
+// ============================================================================
+let instance = null;
+/**
+ * FallbackAnalyzerServiceのシングルトンインスタンスを取得
+ */
+function createFallbackAnalyzerService() {
+    if (!instance) {
+        instance = new FallbackAnalyzerService();
+    }
+    return instance;
+}
+/**
+ * シングルトンインスタンスをリセット
+ */
+function resetFallbackAnalyzerService() {
+    instance = null;
+}
+//# sourceMappingURL=fallback-analyzer.service.js.map

package/dist/services/page/fallback-analyzer.service.js.map

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

package/dist/services/page/frame-analyzer.service.d.ts

@@ -0,0 +1,208 @@
+/**
+ * フレーム抽出オプション
+ */
+export interface ExtractOptions {
+    /** フレームレート（fps） デフォルト: 10 */
+    fps?: number;
+    /** 開始時間（秒） デフォルト: 0 */
+    startTime?: number;
+    /** 終了時間（秒） デフォルト: 動画全長 */
+    endTime?: number;
+    /** 出力フォーマット デフォルト: png */
+    format?: "png" | "jpeg";
+    /** 出力サイズ デフォルト: 動画と同じ */
+    outputSize?: {
+        width: number;
+        height: number;
+    };
+}
+/**
+ * 抽出されたフレーム情報
+ */
+export interface ExtractedFrame {
+    /** フレームインデックス（0開始） */
+    index: number;
+    /** タイムスタンプ（ミリ秒） */
+    timestampMs: number;
+    /** フレーム画像パス */
+    imagePath: string;
+    /** 画像サイズ（バイト） */
+    sizeBytes: number;
+}
+/**
+ * フレーム抽出結果
+ */
+export interface ExtractResult {
+    /** 抽出されたフレーム配列 */
+    frames: ExtractedFrame[];
+    /** 総フレーム数 */
+    totalFrames: number;
+    /** フレームレート */
+    fps: number;
+    /** 動画長さ（ミリ秒） */
+    durationMs: number;
+    /** フレーム出力ディレクトリ */
+    outputDir: string;
+    /** 処理時間（ミリ秒） */
+    processingTimeMs: number;
+}
+/**
+ * フレーム間差分情報
+ */
+export interface FrameDiff {
+    /** 比較元フレームインデックス */
+    fromIndex: number;
+    /** 比較先フレームインデックス */
+    toIndex: number;
+    /** タイムスタンプ差分（ミリ秒） */
+    timestampDiffMs: number;
+    /** 変化率（0-1） */
+    changeRatio: number;
+    /** 変化ピクセル数 */
+    changedPixels: number;
+    /** 総ピクセル数 */
+    totalPixels: number;
+    /** 変化が検出されたか（閾値以上） */
+    hasMotion: boolean;
+}
+/**
+ * モーションセグメント（アニメーション期間）
+ */
+export interface MotionSegment {
+    /** 開始タイムスタンプ（ミリ秒） */
+    startMs: number;
+    /** 終了タイムスタンプ（ミリ秒） */
+    endMs: number;
+    /** 継続時間（ミリ秒） */
+    durationMs: number;
+    /** 平均変化率 */
+    avgChangeRatio: number;
+    /** 最大変化率 */
+    maxChangeRatio: number;
+    /** モーションタイプ推定 */
+    estimatedType: "fade" | "slide" | "scale" | "rotate" | "complex" | "unknown";
+    /** 推定イージング */
+    estimatedEasing: "linear" | "ease-in" | "ease-out" | "ease-in-out" | "unknown";
+}
+/**
+ * モーション解析結果
+ */
+export interface AnalyzeResult {
+    /** フレーム間差分配列 */
+    diffs: FrameDiff[];
+    /** 検出されたモーションセグメント */
+    motionSegments: MotionSegment[];
+    /** 総フレーム数 */
+    totalFrames: number;
+    /** 動画長さ（ミリ秒） */
+    durationMs: number;
+    /** モーション検出された割合（0-1） */
+    motionCoverage: number;
+    /** 処理時間（ミリ秒） */
+    processingTimeMs: number;
+}
+/**
+ * フレーム解析オプション
+ */
+export interface AnalyzeOptions {
+    /** 変化検出閾値（0-1） デフォルト: 0.01 (1%) */
+    changeThreshold?: number;
+    /** 最小モーション継続時間（ミリ秒） デフォルト: 100 */
+    minMotionDurationMs?: number;
+    /** モーションセグメント間のギャップ許容（ミリ秒） デフォルト: 50 */
+    gapToleranceMs?: number;
+}
+/**
+ * デフォルトの抽出オプション
+ */
+export declare const DEFAULT_EXTRACT_OPTIONS: Required<ExtractOptions>;
+/**
+ * デフォルトの解析オプション
+ */
+export declare const DEFAULT_ANALYZE_OPTIONS: Required<AnalyzeOptions>;
+/**
+ * フレーム解析エラー
+ */
+export declare class FrameAnalyzerError extends Error {
+    constructor(message: string);
+}
+/**
+ * 動画フレームからモーション検出するサービス
+ */
+export declare class FrameAnalyzerService {
+    private tempDirs;
+    /**
+     * 動画ファイルからフレームを抽出
+     *
+     * @param videoPath - 動画ファイルのパス
+     * @param options - 抽出オプション
+     * @returns フレーム抽出結果
+     * @throws FrameAnalyzerError
+     */
+    extractFrames(videoPath: string, options?: ExtractOptions): Promise<ExtractResult>;
+    /**
+     * フレーム間のモーションを解析
+     *
+     * @param extractResult - フレーム抽出結果
+     * @param options - 解析オプション
+     * @returns モーション解析結果
+     */
+    analyzeMotion(extractResult: ExtractResult, options?: AnalyzeOptions): Promise<AnalyzeResult>;
+    /**
+     * モーションセグメントを閉じて追加
+     */
+    private closeSegment;
+    /**
+     * 抽出結果をクリーンアップ
+     *
+     * @param extractResult - クリーンアップするフレーム抽出結果
+     */
+    cleanup(extractResult: ExtractResult): Promise<void>;
+    /**
+     * ディレクトリをクリーンアップ
+     */
+    private cleanupDir;
+    /**
+     * すべての一時ファイルをクリーンアップ
+     */
+    closeAll(): Promise<void>;
+}
+/**
+ * 動画ファイルからフレームを抽出（スタンドアロン関数）
+ *
+ * @param videoPath - 動画ファイルのパス
+ * @param options - 抽出オプション
+ * @returns フレーム抽出結果
+ *
+ * @example
+ * ```typescript
+ * const result = await extractFrames('/path/to/video.webm', {
+ *   fps: 10,
+ *   format: 'png',
+ * });
+ * console.log(result.frames.length); // 抽出されたフレーム数
+ * ```
+ */
+export declare function extractFrames(videoPath: string, options?: ExtractOptions): Promise<ExtractResult>;
+/**
+ * フレーム間のモーションを解析（スタンドアロン関数）
+ *
+ * @param extractResult - フレーム抽出結果
+ * @param options - 解析オプション
+ * @returns モーション解析結果
+ *
+ * @example
+ * ```typescript
+ * const extractResult = await extractFrames('/path/to/video.webm', { fps: 10 });
+ * const analyzeResult = await analyzeMotion(extractResult, {
+ *   changeThreshold: 0.01,
+ * });
+ * console.log(analyzeResult.motionSegments); // 検出されたモーション
+ * ```
+ */
+export declare function analyzeMotion(extractResult: ExtractResult, options?: AnalyzeOptions): Promise<AnalyzeResult>;
+/**
+ * 共有サービスを閉じる
+ */
+export declare function closeSharedAnalyzer(): Promise<void>;
+//# sourceMappingURL=frame-analyzer.service.d.ts.map

package/dist/services/page/frame-analyzer.service.d.ts.map

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