@reftrixmcp/mcp-server 0.1.7

package/dist/services/motion/webgl-animation-embedding.service.d.ts

@@ -0,0 +1,238 @@
+/** デフォルトのモデル名 */
+export declare const DEFAULT_MODEL_NAME = "multilingual-e5-base";
+/** デフォルトのEmbedding次元数 */
+export declare const DEFAULT_EMBEDDING_DIMENSIONS = 768;
+/**
+ * WebGLアニメーションパターン入力型（Embedding生成用）
+ * フレーム画像解析で検出されたWebGLアニメーションの特徴を表現
+ */
+export interface WebGLAnimationPatternData {
+    /** パターンID（UUIDv7） */
+    id: string;
+    /** アニメーションカテゴリ（wave, particle-system, morphing, unknown等） */
+    category: string;
+    /** 検出されたライブラリ（Three.js, Babylon.js, PixiJS等） */
+    libraries: string[];
+    /** アニメーションの説明 */
+    description?: string | null;
+    /** 周期性情報 */
+    periodicity?: {
+        /** 周期的かどうか */
+        isPeriodic: boolean;
+        /** 1サイクルの秒数（周期的な場合） */
+        cycleSeconds: number | null;
+        /** 周期性検出の信頼度（0-1） */
+        confidence: number;
+    } | null;
+    /** 平均変化率（0-1） */
+    avgChangeRatio: number;
+    /** ピーク変化率（0-1） */
+    peakChangeRatio?: number | null;
+    /** ビジュアル特徴（gradient-colors, particles, mesh-deformation等） */
+    visualFeatures?: string[] | null;
+    /** キャンバスサイズ */
+    canvasDimensions: {
+        width: number;
+        height: number;
+    };
+    /** WebGLバージョン（1または2） */
+    webglVersion: 1 | 2;
+    /** 解析したフレーム数 */
+    framesAnalyzed?: number | null;
+    /** 解析したアニメーションの持続時間（ミリ秒） */
+    durationMs?: number | null;
+    /** WebPageへの参照（任意） */
+    webPageId?: string | null;
+    /** ソースURL（任意） */
+    sourceUrl?: string | null;
+}
+/**
+ * Embedding生成結果
+ */
+export interface WebGLAnimationEmbeddingResult {
+    /** 768次元ベクトル */
+    embedding: number[];
+    /** Embedding生成に使用したテキスト */
+    textRepresentation: string;
+    /** 使用したモデル名 */
+    modelVersion: string;
+    /** 処理時間（ミリ秒） */
+    processingTimeMs?: number;
+    /** DB保存ID（保存した場合） */
+    savedEmbeddingId?: string;
+}
+/**
+ * 類似パターン検索結果
+ */
+export interface SimilarWebGLAnimationResult {
+    /** パターンID */
+    id: string;
+    /** 類似度スコア（0-1） */
+    similarity: number;
+    /** パターンカテゴリ */
+    category?: string;
+    /** パターン説明 */
+    description?: string;
+    /** WebGLバージョン */
+    webglVersion?: 1 | 2;
+    /** ソースURL */
+    sourceUrl?: string;
+}
+/**
+ * EmbeddingServiceインターフェース（DI用）
+ */
+export interface IEmbeddingService {
+    generateEmbedding(text: string, type: "query" | "passage"): Promise<number[]>;
+    generateBatchEmbeddings(texts: string[], type: "query" | "passage"): Promise<number[][]>;
+    getCacheStats(): {
+        hits: number;
+        misses: number;
+        size: number;
+        evictions: number;
+    };
+    clearCache(): void;
+}
+/**
+ * PrismaClientインターフェース（部分的、WebGLAnimationEmbedding用）
+ */
+export interface IWebGLPrismaClient {
+    webGLAnimationEmbedding: {
+        upsert: (args: {
+            where: {
+                webglAnimationPatternId: string;
+            };
+            create: {
+                webglAnimationPatternId: string;
+                textRepresentation: string;
+                modelVersion: string;
+            };
+            update: {
+                textRepresentation?: string;
+                modelVersion?: string;
+                embeddingTimestamp?: Date;
+            };
+        }) => Promise<{
+            id: string;
+        }>;
+    };
+    $executeRawUnsafe: (query: string, ...values: unknown[]) => Promise<unknown>;
+}
+/**
+ * WebGLAnimationEmbeddingServiceオプション
+ */
+export interface WebGLAnimationEmbeddingServiceOptions {
+    /** EmbeddingService（DI用） */
+    embeddingService?: IEmbeddingService;
+    /** モデル名 */
+    modelName?: string;
+    /** L2正規化を行うか（デフォルト: true） */
+    normalize?: boolean;
+}
+/**
+ * EmbeddingServiceファクトリを設定
+ */
+export declare function setWebGLAnimationEmbeddingServiceFactory(factory: () => IEmbeddingService): void;
+/**
+ * EmbeddingServiceファクトリをリセット
+ */
+export declare function resetWebGLAnimationEmbeddingServiceFactory(): void;
+/**
+ * PrismaClientファクトリを設定
+ */
+export declare function setWebGLPrismaClientFactory(factory: () => IWebGLPrismaClient): void;
+/**
+ * PrismaClientファクトリをリセット
+ */
+export declare function resetWebGLPrismaClientFactory(): void;
+/**
+ * WebGLAnimationPatternからEmbedding用テキスト表現を生成
+ *
+ * E5モデル用にpassage:プレフィックスを付与
+ * 768次元ベクトル生成に最適化されたテキスト形式
+ *
+ * @param pattern - WebGLアニメーションパターン情報
+ * @returns Embedding用テキスト表現（passage:プレフィックス付き）
+ *
+ * @example
+ * "passage: WebGL wave animation with Three.js, Perlin noise-based smooth color transitions,
+ * periodic 2-second cycle, moderate motion intensity 0.12, gradient colors, geometry-based rendering,
+ * full-screen canvas 1920x1080, WebGL 2.0."
+ */
+export declare function generateWebGLAnimationTextRepresentation(pattern: WebGLAnimationPatternData): string;
+/**
+ * WebGLアニメーションパターン用のEmbedding生成サービス
+ *
+ * @example
+ * ```typescript
+ * const service = new WebGLAnimationEmbeddingService({
+ *   embeddingService: myEmbeddingService,
+ * });
+ *
+ * const result = await service.generateAndSave(pattern, patternId);
+ * console.log(result.embedding.length); // 768
+ * ```
+ */
+export declare class WebGLAnimationEmbeddingService {
+    private readonly modelName;
+    private readonly normalize;
+    private embeddingService;
+    private prismaClient;
+    constructor(options?: WebGLAnimationEmbeddingServiceOptions);
+    /**
+     * EmbeddingServiceを取得
+     */
+    private getEmbeddingService;
+    /**
+     * PrismaClientを取得
+     */
+    private getPrismaClient;
+    /**
+     * テキスト表現を生成（公開メソッド）
+     *
+     * @param pattern - WebGLアニメーションパターン
+     * @returns テキスト表現（passage:プレフィックス付き）
+     */
+    generateTextRepresentation(pattern: WebGLAnimationPatternData): string;
+    /**
+     * WebGLアニメーションパターンからEmbeddingを生成・保存
+     *
+     * @param pattern - WebGLアニメーションパターン情報
+     * @param patternId - パターンID（DB保存に使用）
+     * @returns Embedding結果
+     */
+    generateAndSave(pattern: WebGLAnimationPatternData, patternId: string): Promise<WebGLAnimationEmbeddingResult>;
+    /**
+     * 類似WebGLアニメーション検索
+     *
+     * @param queryEmbedding - クエリEmbedding（768次元）
+     * @param options - 検索オプション
+     * @returns 類似パターン結果配列
+     */
+    findSimilar(queryEmbedding: number[], options: {
+        limit?: number;
+        minSimilarity?: number;
+    }): Promise<SimilarWebGLAnimationResult[]>;
+    /**
+     * キャッシュ統計を取得
+     */
+    getCacheStats(): {
+        hits: number;
+        misses: number;
+        size: number;
+        evictions: number;
+    };
+    /**
+     * キャッシュをクリア
+     */
+    clearCache(): void;
+}
+/**
+ * WebGLAnimationEmbeddingServiceインスタンスを取得
+ */
+export declare function getWebGLAnimationEmbeddingService(): WebGLAnimationEmbeddingService;
+/**
+ * WebGLAnimationEmbeddingServiceインスタンスをリセット
+ */
+export declare function resetWebGLAnimationEmbeddingService(): void;
+export default WebGLAnimationEmbeddingService;
+//# sourceMappingURL=webgl-animation-embedding.service.d.ts.map

package/dist/services/motion/webgl-animation-embedding.service.d.ts.map

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

package/dist/services/motion/webgl-animation-embedding.service.js

@@ -0,0 +1,368 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebGLAnimationEmbeddingService = exports.DEFAULT_EMBEDDING_DIMENSIONS = exports.DEFAULT_MODEL_NAME = void 0;
+exports.setWebGLAnimationEmbeddingServiceFactory = setWebGLAnimationEmbeddingServiceFactory;
+exports.resetWebGLAnimationEmbeddingServiceFactory = resetWebGLAnimationEmbeddingServiceFactory;
+exports.setWebGLPrismaClientFactory = setWebGLPrismaClientFactory;
+exports.resetWebGLPrismaClientFactory = resetWebGLPrismaClientFactory;
+exports.generateWebGLAnimationTextRepresentation = generateWebGLAnimationTextRepresentation;
+exports.getWebGLAnimationEmbeddingService = getWebGLAnimationEmbeddingService;
+exports.resetWebGLAnimationEmbeddingService = resetWebGLAnimationEmbeddingService;
+/**
+ * WebGLAnimationEmbeddingService
+ * WebGLアニメーションパターン用のEmbedding生成サービス
+ *
+ * 機能:
+ * - WebGLAnimationPatternからテキスト表現を生成
+ * - multilingual-e5-base (768次元) Embeddingを生成
+ * - DB保存連携（WebGLAnimationEmbeddingテーブル）
+ * - 類似パターン検索（HNSW cosine similarity）
+ *
+ * パフォーマンス目標:
+ * - 単一Embedding生成: < 200ms
+ * - バッチ100件: < 10s
+ * - 類似検索: < 100ms
+ *
+ * @module services/motion/webgl-animation-embedding.service
+ */
+const logger_1 = require("../../utils/logger");
+const embedding_validation_service_1 = require("../embedding-validation.service");
+// =====================================================
+// 定数
+// =====================================================
+/** デフォルトのモデル名 */
+exports.DEFAULT_MODEL_NAME = "multilingual-e5-base";
+/** デフォルトのEmbedding次元数 */
+exports.DEFAULT_EMBEDDING_DIMENSIONS = 768;
+// =====================================================
+// サービスファクトリ（DI用）
+// =====================================================
+let embeddingServiceFactory = null;
+let prismaClientFactory = null;
+/**
+ * EmbeddingServiceファクトリを設定
+ */
+function setWebGLAnimationEmbeddingServiceFactory(factory) {
+    embeddingServiceFactory = factory;
+}
+/**
+ * EmbeddingServiceファクトリをリセット
+ */
+function resetWebGLAnimationEmbeddingServiceFactory() {
+    embeddingServiceFactory = null;
+}
+/**
+ * PrismaClientファクトリを設定
+ */
+function setWebGLPrismaClientFactory(factory) {
+    prismaClientFactory = factory;
+}
+/**
+ * PrismaClientファクトリをリセット
+ */
+function resetWebGLPrismaClientFactory() {
+    prismaClientFactory = null;
+}
+// =====================================================
+// ヘルパー関数
+// =====================================================
+/**
+ * L2正規化
+ */
+function normalizeL2(vector) {
+    const norm = Math.sqrt(vector.reduce((sum, val) => sum + val * val, 0));
+    if (norm === 0)
+        return vector;
+    return vector.map((val) => val / norm);
+}
+/**
+ * モーション強度をテキストに変換
+ */
+function getMotionIntensityText(avgChangeRatio) {
+    if (avgChangeRatio >= 0.4) {
+        return "high motion intensity";
+    }
+    else if (avgChangeRatio >= 0.2) {
+        return "moderate motion intensity";
+    }
+    else if (avgChangeRatio >= 0.1) {
+        return "low motion intensity";
+    }
+    return "minimal motion";
+}
+// =====================================================
+// テキスト表現生成関数
+// =====================================================
+/**
+ * WebGLAnimationPatternからEmbedding用テキスト表現を生成
+ *
+ * E5モデル用にpassage:プレフィックスを付与
+ * 768次元ベクトル生成に最適化されたテキスト形式
+ *
+ * @param pattern - WebGLアニメーションパターン情報
+ * @returns Embedding用テキスト表現（passage:プレフィックス付き）
+ *
+ * @example
+ * "passage: WebGL wave animation with Three.js, Perlin noise-based smooth color transitions,
+ * periodic 2-second cycle, moderate motion intensity 0.12, gradient colors, geometry-based rendering,
+ * full-screen canvas 1920x1080, WebGL 2.0."
+ */
+function generateWebGLAnimationTextRepresentation(pattern) {
+    const parts = [];
+    // カテゴリ（必須）
+    parts.push(`WebGL ${pattern.category} animation`);
+    // ライブラリ（任意）
+    if (pattern.libraries && pattern.libraries.length > 0) {
+        parts.push(`with ${pattern.libraries.join(", ")}`);
+    }
+    // 説明（任意）
+    if (pattern.description) {
+        parts.push(pattern.description);
+    }
+    // 周期性情報（任意）
+    if (pattern.periodicity) {
+        if (pattern.periodicity.isPeriodic && pattern.periodicity.cycleSeconds !== null) {
+            parts.push(`periodic ${pattern.periodicity.cycleSeconds}-second cycle`);
+        }
+        // 非周期的な場合は特に記載しない
+    }
+    // モーション強度
+    const intensityText = getMotionIntensityText(pattern.avgChangeRatio);
+    parts.push(`${intensityText} ${pattern.avgChangeRatio.toFixed(2)}`);
+    // ビジュアル特徴（任意）
+    if (pattern.visualFeatures && pattern.visualFeatures.length > 0) {
+        parts.push(pattern.visualFeatures.join(", "));
+    }
+    // キャンバスサイズ
+    const { width, height } = pattern.canvasDimensions;
+    parts.push(`canvas ${width}x${height}`);
+    // WebGLバージョン
+    parts.push(`WebGL ${pattern.webglVersion}.0`);
+    // E5モデル用プレフィックス付きで返す
+    return `passage: ${parts.join(", ")}.`;
+}
+// =====================================================
+// WebGLAnimationEmbeddingService クラス
+// =====================================================
+/**
+ * WebGLアニメーションパターン用のEmbedding生成サービス
+ *
+ * @example
+ * ```typescript
+ * const service = new WebGLAnimationEmbeddingService({
+ *   embeddingService: myEmbeddingService,
+ * });
+ *
+ * const result = await service.generateAndSave(pattern, patternId);
+ * console.log(result.embedding.length); // 768
+ * ```
+ */
+class WebGLAnimationEmbeddingService {
+    modelName;
+    normalize;
+    embeddingService = null;
+    prismaClient = null;
+    constructor(options) {
+        this.modelName = options?.modelName ?? exports.DEFAULT_MODEL_NAME;
+        this.normalize = options?.normalize ?? true;
+        if (options?.embeddingService) {
+            this.embeddingService = options.embeddingService;
+        }
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[WebGLAnimationEmbedding] Service created", {
+                modelName: this.modelName,
+                normalize: this.normalize,
+            });
+        }
+    }
+    /**
+     * EmbeddingServiceを取得
+     */
+    getEmbeddingService() {
+        if (this.embeddingService) {
+            return this.embeddingService;
+        }
+        if (embeddingServiceFactory) {
+            this.embeddingService = embeddingServiceFactory();
+            return this.embeddingService;
+        }
+        throw new Error("EmbeddingService not initialized. Provide embeddingService in constructor options or set factory.");
+    }
+    /**
+     * PrismaClientを取得
+     */
+    getPrismaClient() {
+        if (this.prismaClient) {
+            return this.prismaClient;
+        }
+        if (prismaClientFactory) {
+            this.prismaClient = prismaClientFactory();
+            return this.prismaClient;
+        }
+        throw new Error("PrismaClient not initialized. Set factory with setWebGLPrismaClientFactory.");
+    }
+    /**
+     * テキスト表現を生成（公開メソッド）
+     *
+     * @param pattern - WebGLアニメーションパターン
+     * @returns テキスト表現（passage:プレフィックス付き）
+     */
+    generateTextRepresentation(pattern) {
+        return generateWebGLAnimationTextRepresentation(pattern);
+    }
+    /**
+     * WebGLアニメーションパターンからEmbeddingを生成・保存
+     *
+     * @param pattern - WebGLアニメーションパターン情報
+     * @param patternId - パターンID（DB保存に使用）
+     * @returns Embedding結果
+     */
+    async generateAndSave(pattern, patternId) {
+        // バリデーション
+        if (!pattern || typeof pattern !== "object") {
+            throw new Error("Invalid pattern: must be a valid object");
+        }
+        if (!pattern.category || !pattern.canvasDimensions) {
+            throw new Error("Invalid pattern: category and canvasDimensions are required");
+        }
+        const startTime = Date.now();
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[WebGLAnimationEmbedding] Generating embedding", {
+                patternId,
+                category: pattern.category,
+                libraries: pattern.libraries,
+            });
+        }
+        // テキスト表現を生成
+        const textRepresentation = generateWebGLAnimationTextRepresentation(pattern);
+        // Embedding生成
+        const service = this.getEmbeddingService();
+        let embedding = await service.generateEmbedding(textRepresentation, "passage");
+        // Embeddingベクトルの検証
+        const validationResult = (0, embedding_validation_service_1.validateEmbeddingVector)(embedding);
+        if (!validationResult.isValid) {
+            const error = validationResult.error;
+            const errorMessage = error?.index !== undefined
+                ? `${error.message} at index ${error.index}`
+                : (error?.message ?? "Unknown validation error");
+            throw new embedding_validation_service_1.EmbeddingValidationError(error?.code ?? "INVALID_VECTOR", errorMessage, error?.index);
+        }
+        // L2正規化
+        if (this.normalize) {
+            embedding = normalizeL2(embedding);
+        }
+        const processingTimeMs = Date.now() - startTime;
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[WebGLAnimationEmbedding] Generated embedding", {
+                patternId,
+                dimensions: embedding.length,
+                processingTimeMs,
+            });
+        }
+        return {
+            embedding,
+            textRepresentation,
+            modelVersion: this.modelName,
+            processingTimeMs,
+        };
+    }
+    /**
+     * 類似WebGLアニメーション検索
+     *
+     * @param queryEmbedding - クエリEmbedding（768次元）
+     * @param options - 検索オプション
+     * @returns 類似パターン結果配列
+     */
+    async findSimilar(queryEmbedding, options) {
+        const limit = options.limit ?? 10;
+        const minSimilarity = options.minSimilarity ?? 0.5;
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[WebGLAnimationEmbedding] Finding similar patterns", {
+                limit,
+                minSimilarity,
+            });
+        }
+        try {
+            const prisma = this.getPrismaClient();
+            // pgvector cosine similarity検索
+            const vectorString = `[${queryEmbedding.join(",")}]`;
+            const results = (await prisma.$executeRawUnsafe(`
+        SELECT
+          wae.webgl_animation_pattern_id as id,
+          1 - (wae.embedding <=> $1::vector) as similarity,
+          wap.category,
+          wap.description,
+          wap.webgl_version as "webglVersion",
+          wap.source_url as "sourceUrl"
+        FROM webgl_animation_embeddings wae
+        JOIN webgl_animation_patterns wap ON wap.id = wae.webgl_animation_pattern_id
+        WHERE 1 - (wae.embedding <=> $1::vector) >= $2
+        ORDER BY similarity DESC
+        LIMIT $3
+        `, vectorString, minSimilarity, limit));
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.info("[WebGLAnimationEmbedding] Found similar patterns", {
+                    count: results.length,
+                });
+            }
+            return results;
+        }
+        catch (error) {
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.warn("[WebGLAnimationEmbedding] findSimilar failed", {
+                    error: error instanceof Error ? error.message : "Unknown error",
+                });
+            }
+            // PrismaClientが初期化されていない場合は空配列を返す
+            return [];
+        }
+    }
+    /**
+     * キャッシュ統計を取得
+     */
+    getCacheStats() {
+        try {
+            const service = this.getEmbeddingService();
+            return service.getCacheStats();
+        }
+        catch {
+            return { hits: 0, misses: 0, size: 0, evictions: 0 };
+        }
+    }
+    /**
+     * キャッシュをクリア
+     */
+    clearCache() {
+        try {
+            const service = this.getEmbeddingService();
+            service.clearCache();
+        }
+        catch {
+            // サービスが初期化されていない場合は何もしない
+        }
+    }
+}
+exports.WebGLAnimationEmbeddingService = WebGLAnimationEmbeddingService;
+// =====================================================
+// シングルトンインスタンス
+// =====================================================
+let webglAnimationEmbeddingServiceInstance = null;
+/**
+ * WebGLAnimationEmbeddingServiceインスタンスを取得
+ */
+function getWebGLAnimationEmbeddingService() {
+    if (!webglAnimationEmbeddingServiceInstance) {
+        webglAnimationEmbeddingServiceInstance = new WebGLAnimationEmbeddingService();
+    }
+    return webglAnimationEmbeddingServiceInstance;
+}
+/**
+ * WebGLAnimationEmbeddingServiceインスタンスをリセット
+ */
+function resetWebGLAnimationEmbeddingService() {
+    webglAnimationEmbeddingServiceInstance = null;
+}
+exports.default = WebGLAnimationEmbeddingService;
+//# sourceMappingURL=webgl-animation-embedding.service.js.map

package/dist/services/motion/webgl-animation-embedding.service.js.map

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