@reftrixmcp/mcp-server 0.1.7 → 0.2.0

package/dist/tools/layout/search.tool.js

@@ -1,1582 +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.layoutSearchToolDefinition = void 0;
-exports.setLayoutSearchServiceFactory = setLayoutSearchServiceFactory;
-exports.resetLayoutSearchServiceFactory = resetLayoutSearchServiceFactory;
-exports.setVisionSearchServiceFactory = setVisionSearchServiceFactory;
-exports.resetVisionSearchServiceFactory = resetVisionSearchServiceFactory;
-exports.resetProjectContextAnalyzer = resetProjectContextAnalyzer;
-exports.setMoodBrandToneSearchServiceFactory = setMoodBrandToneSearchServiceFactory;
-exports.resetMoodBrandToneSearchServiceFactory = resetMoodBrandToneSearchServiceFactory;
-exports.setLayoutSearchPrismaClientFactory = setLayoutSearchPrismaClientFactory;
-exports.resetLayoutSearchPrismaClientFactory = resetLayoutSearchPrismaClientFactory;
-exports.preprocessQuery = preprocessQuery;
-exports.calculateRrfScore = calculateRrfScore;
-exports.determineSearchMode = determineSearchMode;
-exports.layoutSearchHandler = layoutSearchHandler;
-/**
- * layout.search MCPツール
- * セクションパターンを自然言語クエリでセマンティック検索します
- *
- * 機能:
- * - 日本語/英語対応の自然言語検索
- * - pgvector HNSW インデックスによるベクトル検索
- * - multilingual-e5-baseによるクエリEmbedding生成
- * - セクションタイプ/ソースタイプ/利用範囲フィルタリング
- * - ページネーション対応
- *
- * @module tools/layout/search.tool
- */
-const zod_1 = require("zod");
-const logger_1 = require("../../utils/logger");
-const html_sanitizer_1 = require("../../utils/html-sanitizer");
-const schemas_1 = require("./schemas");
-const query_context_analyzer_1 = require("../../services/query-context-analyzer");
-const preference_rerank_helper_1 = require("../../services/preference-rerank.helper");
-const project_context_analyzer_1 = require("../../services/project-context-analyzer");
-// =====================================================
-// サービスファクトリー（DI）
-// =====================================================
-let serviceFactory = null;
-/**
- * VisionSearchサービスファクトリー（DI）
- * Phase 4-2: visionEmbeddingベースの検索
- */
-let visionSearchServiceFactory = null;
-/**
- * ProjectContextAnalyzer シングルトンインスタンス
- */
-let projectContextAnalyzer = null;
-/**
- * ProjectContextAnalyzer インスタンスを取得
- */
-function getProjectContextAnalyzer() {
-    if (!projectContextAnalyzer) {
-        projectContextAnalyzer = new project_context_analyzer_1.ProjectContextAnalyzer();
-    }
-    return projectContextAnalyzer;
-}
-/**
- * サービスファクトリーを設定
- */
-function setLayoutSearchServiceFactory(factory) {
-    serviceFactory = factory;
-}
-/**
- * サービスファクトリーをリセット
- */
-function resetLayoutSearchServiceFactory() {
-    serviceFactory = null;
-}
-/**
- * VisionSearchサービスファクトリーを設定
- * Phase 4-2: visionEmbeddingベースの検索
- */
-function setVisionSearchServiceFactory(factory) {
-    visionSearchServiceFactory = factory;
-}
-/**
- * VisionSearchサービスファクトリーをリセット
- */
-function resetVisionSearchServiceFactory() {
-    visionSearchServiceFactory = null;
-}
-/**
- * ProjectContextAnalyzer をリセット（テスト用）
- */
-function resetProjectContextAnalyzer() {
-    if (projectContextAnalyzer) {
-        projectContextAnalyzer.clearCache();
-    }
-    projectContextAnalyzer = null;
-}
-/**
- * MoodBrandToneSearchサービスファクトリー（DI）
- * GREEN Phase: mood/brandTone semantic search
- */
-let moodBrandToneSearchServiceFactory = null;
-/**
- * MoodBrandToneSearchサービスファクトリーを設定
- */
-function setMoodBrandToneSearchServiceFactory(factory) {
-    moodBrandToneSearchServiceFactory = factory;
-}
-/**
- * MoodBrandToneSearchサービスファクトリーをリセット
- */
-function resetMoodBrandToneSearchServiceFactory() {
-    moodBrandToneSearchServiceFactory = null;
-}
-/**
- * PrismaClientファクトリー（嗜好リランキング用DI）
- * PrismaClient factory (DI for preference reranking)
- */
-let prismaClientFactory = null;
-/**
- * PrismaClientファクトリーを設定（嗜好リランキング用）
- * Set PrismaClient factory (for preference reranking)
- */
-function setLayoutSearchPrismaClientFactory(factory) {
-    prismaClientFactory = factory;
-}
-/**
- * PrismaClientファクトリーをリセット（テスト用）
- * Reset PrismaClient factory (for testing)
- */
-function resetLayoutSearchPrismaClientFactory() {
-    prismaClientFactory = null;
-}
-// =====================================================
-// クエリ前処理
-// =====================================================
-/**
- * 検索クエリを前処理する
- * - E5モデル用のquery:プレフィックスを追加
- * - 空白の正規化
- * - 全角スペースの半角変換
- *
- * @param query - 元のクエリ文字列
- * @returns 前処理されたクエリ文字列
- */
-function preprocessQuery(query) {
-    // 1. 全角スペースを半角に変換
-    let normalized = query.replace(/\u3000/g, " ");
-    // 2. 改行・タブを空白に変換
-    normalized = normalized.replace(/[\n\t\r]/g, " ");
-    // 3. 連続する空白を1つに正規化
-    normalized = normalized.replace(/\s+/g, " ");
-    // 4. 前後の空白を除去
-    normalized = normalized.trim();
-    // 5. E5モデル用のquery:プレフィックスを追加
-    return `query: ${normalized}`;
-}
-// =====================================================
-// エラーコード判定
-// =====================================================
-/**
- * エラーからエラーコードを判定
- */
-function determineErrorCode(error) {
-    const message = typeof error === "string" ? error : error.message;
-    const lowerMessage = message.toLowerCase();
-    // Embeddingエラー
-    if (lowerMessage.includes("embedding") ||
-        lowerMessage.includes("model") ||
-        lowerMessage.includes("tensor")) {
-        return "EMBEDDING_ERROR";
-    }
-    // データベースエラー
-    if (lowerMessage.includes("database") ||
-        lowerMessage.includes("prisma") ||
-        lowerMessage.includes("connection")) {
-        return schemas_1.LAYOUT_MCP_ERROR_CODES.SEARCH_FAILED;
-    }
-    // タイムアウトエラー
-    if (lowerMessage.includes("timeout")) {
-        return schemas_1.LAYOUT_MCP_ERROR_CODES.TIMEOUT;
-    }
-    // その他は内部エラー
-    return schemas_1.LAYOUT_MCP_ERROR_CODES.INTERNAL_ERROR;
-}
-/**
- * HTMLスニペットからサニタイズ済みプレビューを生成
- *
- * @param htmlSnippet - 元のHTMLスニペット
- * @param maxLength - 最大文字数
- * @returns サニタイズ・切り詰め済みHTMLプレビューと元の長さ
- */
-function generateHtmlPreview(htmlSnippet, maxLength) {
-    // 1. HTMLをサニタイズ（XSS対策）
-    const sanitized = (0, html_sanitizer_1.sanitizeHtml)(htmlSnippet);
-    // 元の長さを記録
-    const previewLength = sanitized.length;
-    // 2. 最大長に切り詰め
-    let htmlPreview = sanitized;
-    if (sanitized.length > maxLength) {
-        // タグの途中で切らないように、最後の完全なタグまで切り詰める
-        htmlPreview = sanitized.substring(0, maxLength);
-        // 開いているタグを検出して閉じる試み
-        // 簡易的に最後の不完全なタグを除去
-        const lastOpenTagIndex = htmlPreview.lastIndexOf("<");
-        const lastCloseTagIndex = htmlPreview.lastIndexOf(">");
-        if (lastOpenTagIndex > lastCloseTagIndex) {
-            // 不完全なタグがある場合、その前まで切り詰め
-            htmlPreview = htmlPreview.substring(0, lastOpenTagIndex);
-        }
-        // 省略記号を追加
-        htmlPreview = htmlPreview.trimEnd() + "...";
-    }
-    return { htmlPreview, previewLength };
-}
-/**
- * バリデーション済み入力からinclude_htmlを取得
- * MCP-RESP-03: snake_case (include_html) を優先し、camelCase (includeHtml) はフォールバック
- */
-function getIncludeHtml(validated) {
-    // snake_case優先
-    if (validated.include_html !== undefined) {
-        return validated.include_html;
-    }
-    // camelCaseフォールバック（後方互換）
-    return validated.includeHtml ?? false;
-}
-/**
- * 検索結果をMCPレスポンス形式にマップ
- * @param result - 検索結果
- * @param include_html - HTMLを含めるか（snake_case正式形式）
- */
-function mapSearchResult(result, include_html, adaptability, semanticInfo, previewOptions, contextBoost) {
-    const preview = {};
-    // プレビュー情報を抽出
-    if (result.layoutInfo) {
-        if (result.layoutInfo.heading) {
-            preview.heading = result.layoutInfo.heading;
-        }
-        if (result.layoutInfo.description) {
-            preview.description = result.layoutInfo.description;
-        }
-    }
-    // サムネイル（スクリーンショットURL）
-    if (result.webPage.screenshotDesktopUrl) {
-        preview.thumbnail = result.webPage.screenshotDesktopUrl;
-    }
-    const item = {
-        id: result.id,
-        webPageId: result.webPageId,
-        type: result.sectionType,
-        similarity: result.similarity,
-        preview,
-        source: {
-            url: result.webPage.url,
-            type: result.webPage.sourceType,
-            usageScope: result.webPage.usageScope,
-        },
-    };
-    // HTMLを含める場合
-    if (include_html && result.htmlSnippet) {
-        item.html = (0, html_sanitizer_1.sanitizeHtml)(result.htmlSnippet);
-    }
-    // HTMLプレビューを含める場合（デフォルト有効）
-    const shouldIncludePreview = previewOptions?.includePreview ?? true;
-    const maxLength = previewOptions?.maxLength ?? 500;
-    if (shouldIncludePreview && result.htmlSnippet) {
-        const { htmlPreview, previewLength } = generateHtmlPreview(result.htmlSnippet, maxLength);
-        item.htmlPreview = htmlPreview;
-        item.previewLength = previewLength;
-    }
-    // Vision分析結果を含める（存在する場合）
-    if (result.layoutInfo?.visionAnalysis) {
-        item.visionAnalysis = result.layoutInfo.visionAnalysis;
-    }
-    // Adaptability情報を含める（project_context.enabled=true時）
-    if (adaptability) {
-        item.adaptability_score = adaptability.score;
-        item.integration_hints = adaptability.hints;
-    }
-    // TASK-06-3 Step 2: セマンティックメタデータを含める（mood/brandTone検索結果がある場合）
-    if (semanticInfo?.moodInfo) {
-        item.moodInfo = semanticInfo.moodInfo;
-    }
-    if (semanticInfo?.brandToneInfo) {
-        item.brandToneInfo = semanticInfo.brandToneInfo;
-    }
-    // REFTRIX-LAYOUT-02: Context boost
-    if (contextBoost !== undefined && contextBoost > 0) {
-        item.context_boost = contextBoost;
-    }
-    // RRF統合検索時の詳細情報（combined モード時のみ）
-    if (result.rrfDetails) {
-        item.rrfDetails = result.rrfDetails;
-    }
-    return item;
-}
-// =====================================================
-// Vision検索実行（Phase 4-2）
-// =====================================================
-/**
- * VisionSearchResult を SearchResult に変換
- */
-function mapVisionResultToSearchResult(visionResult) {
-    const result = {
-        id: visionResult.id,
-        webPageId: visionResult.webPageId,
-        sectionType: visionResult.sectionType,
-        similarity: visionResult.similarity,
-        webPage: {
-            id: visionResult.webPage.id,
-            url: visionResult.webPage.url,
-            sourceType: visionResult.webPage.sourceType,
-            usageScope: visionResult.webPage.usageScope,
-            screenshotDesktopUrl: visionResult.webPage.screenshotDesktopUrl,
-        },
-    };
-    // Optional fields - only set if defined
-    if (visionResult.sectionName) {
-        result.sectionName = visionResult.sectionName;
-    }
-    if (visionResult.webPage.title) {
-        result.webPage.title = visionResult.webPage.title;
-    }
-    // layoutInfo: 存在する場合にオブジェクトを構築
-    if (visionResult.layoutInfo !== undefined) {
-        const layoutInfoSrc = visionResult.layoutInfo;
-        const layoutInfo = {};
-        if (typeof layoutInfoSrc["type"] === "string") {
-            layoutInfo.type = layoutInfoSrc["type"];
-        }
-        if (typeof layoutInfoSrc["heading"] === "string") {
-            layoutInfo.heading = layoutInfoSrc["heading"];
-        }
-        if (typeof layoutInfoSrc["description"] === "string") {
-            layoutInfo.description = layoutInfoSrc["description"];
-        }
-        if (layoutInfoSrc["grid"] !== undefined) {
-            layoutInfo.grid = layoutInfoSrc["grid"];
-        }
-        if (layoutInfoSrc["visionAnalysis"] !== undefined) {
-            layoutInfo.visionAnalysis = layoutInfoSrc["visionAnalysis"];
-        }
-        if (layoutInfoSrc["visualFeatures"] !== undefined) {
-            layoutInfo.visualFeatures = layoutInfoSrc["visualFeatures"];
-        }
-        result.layoutInfo = layoutInfo;
-    }
-    // visualFeatures: 存在する場合にオブジェクトを構築
-    // VisualFeaturesはtheme?, colors?, density?の複合型
-    if (visionResult.visualFeatures !== undefined) {
-        const vfSrc = visionResult.visualFeatures;
-        const visualFeatures = {};
-        // theme: VisualFeaturesTheme型（type, backgroundColor, textColor, contrastRatio, luminance, source, confidence）
-        if (vfSrc["theme"] !== undefined && typeof vfSrc["theme"] === "object") {
-            visualFeatures.theme = vfSrc["theme"];
-        }
-        // colors: VisualFeaturesColors型（dominant?, accent?, palette?）
-        if (vfSrc["colors"] !== undefined && typeof vfSrc["colors"] === "object") {
-            visualFeatures.colors = vfSrc["colors"];
-        }
-        // density: VisualFeaturesDensity型（contentDensity?, whitespaceRatio?, visualBalance?）
-        if (vfSrc["density"] !== undefined && typeof vfSrc["density"] === "object") {
-            visualFeatures.density = vfSrc["density"];
-        }
-        result.visualFeatures = visualFeatures;
-    }
-    if (visionResult.htmlSnippet) {
-        result.htmlSnippet = visionResult.htmlSnippet;
-    }
-    // RRF詳細情報（combined モード時のみ）
-    if (visionResult.textRank !== undefined || visionResult.visionRank !== undefined) {
-        result.rrfDetails = {
-            textRank: visionResult.textRank ?? 0,
-            visionRank: visionResult.visionRank ?? 0,
-        };
-        if (visionResult.rrfDetails) {
-            if (visionResult.rrfDetails.textScore !== undefined) {
-                result.rrfDetails.textScore = visionResult.rrfDetails.textScore;
-            }
-            if (visionResult.rrfDetails.visionScore !== undefined) {
-                result.rrfDetails.visionScore = visionResult.rrfDetails.visionScore;
-            }
-            if (visionResult.rrfDetails.combinedScore !== undefined) {
-                result.rrfDetails.rrfScore = visionResult.rrfDetails.combinedScore;
-            }
-        }
-    }
-    return result;
-}
-/**
- * Vision検索を実行（Phase 4-2）
- * useVisionSearch=true の場合に呼び出される
- *
- * @param validated - バリデーション済み入力
- * @param startTime - 開始時刻
- */
-async function executeVisionSearch(validated, startTime) {
-    // VisionSearchサービスチェック
-    if (!visionSearchServiceFactory) {
-        if ((0, logger_1.isDevelopment)()) {
-            logger_1.logger.warn("[MCP Tool] layout.search vision search service not available, falling back to text search");
-        }
-        // フォールバック: 通常の検索を実行（サービスがない場合）
-        return {
-            success: false,
-            error: {
-                code: "VISION_SEARCH_UNAVAILABLE",
-                message: "Vision search service is not available. Set use_vision_search=false to use text-only search.",
-            },
-        };
-    }
-    const visionService = visionSearchServiceFactory();
-    // VisionSearchQueryの構築
-    const visionQuery = {
-        textQuery: validated.vision_search_query?.textQuery ?? validated.query,
-    };
-    // visualFeaturesが定義されている場合のみ追加
-    if (validated.vision_search_query?.visualFeatures) {
-        const vf = validated.vision_search_query.visualFeatures;
-        const visualFeatures = {};
-        if (vf.theme)
-            visualFeatures.theme = vf.theme;
-        if (vf.colors)
-            visualFeatures.colors = vf.colors;
-        if (vf.density)
-            visualFeatures.density = vf.density;
-        if (vf.gradient)
-            visualFeatures.gradient = vf.gradient;
-        if (vf.mood)
-            visualFeatures.mood = vf.mood;
-        if (vf.brandTone)
-            visualFeatures.brandTone = vf.brandTone;
-        visionQuery.visualFeatures = visualFeatures;
-    }
-    // sectionPatternIdが定義されている場合のみ追加
-    if (validated.vision_search_query?.sectionPatternId) {
-        visionQuery.sectionPatternId = validated.vision_search_query.sectionPatternId;
-    }
-    // VisionSearchOptionsの構築
-    const visionOptions = {
-        limit: validated.limit,
-        offset: validated.offset,
-        minSimilarity: validated.vision_search_options?.minSimilarity ?? 0.5,
-        visionWeight: validated.vision_search_options?.visionWeight ?? 0.6,
-        textWeight: validated.vision_search_options?.textWeight ?? 0.4,
-    };
-    // フィルターが定義されている場合のみ追加
-    if (validated.filters?.sectionType) {
-        visionOptions.sectionType = validated.filters.sectionType;
-    }
-    if (validated.filters?.sourceType) {
-        visionOptions.sourceType = validated.filters.sourceType;
-    }
-    if (validated.filters?.usageScope) {
-        visionOptions.usageScope = validated.filters.usageScope;
-    }
-    if ((0, logger_1.isDevelopment)()) {
-        logger_1.logger.debug("[MCP Tool] layout.search executing vision search", {
-            visionQuery,
-            visionOptions,
-        });
-    }
-    try {
-        // ハイブリッド検索を実行（text_embedding + vision_embedding のRRF統合）
-        const visionResult = await visionService.hybridSearch(validated.query, visionQuery, visionOptions);
-        if (!visionResult) {
-            return {
-                success: true,
-                data: {
-                    results: [],
-                    total: 0,
-                    query: validated.query,
-                    filters: validated.filters ?? {},
-                    searchTimeMs: Date.now() - startTime,
-                },
-            };
-        }
-        // Vision結果を標準形式にマップ
-        const previewOptions = {
-            includePreview: validated.include_preview,
-            maxLength: validated.preview_max_length,
-        };
-        const includeHtmlValue = getIncludeHtml(validated);
-        const mappedResults = visionResult.results.map((vr) => {
-            const searchResult = mapVisionResultToSearchResult(vr);
-            return mapSearchResult(searchResult, includeHtmlValue, undefined, // adaptability
-            undefined, // semanticInfo
-            previewOptions);
-        });
-        const searchTimeMs = Date.now() - startTime;
-        if ((0, logger_1.isDevelopment)()) {
-            logger_1.logger.info("[MCP Tool] layout.search vision search completed", {
-                query: validated.query,
-                use_vision_search: true,
-                resultCount: mappedResults.length,
-                total: visionResult.total,
-                searchTimeMs,
-            });
-        }
-        return {
-            success: true,
-            data: {
-                results: mappedResults,
-                total: visionResult.total,
-                query: validated.query,
-                filters: validated.filters ?? {},
-                searchTimeMs,
-            },
-        };
-    }
-    catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        const errorCode = determineErrorCode(error instanceof Error ? error : errorMessage);
-        if ((0, logger_1.isDevelopment)()) {
-            logger_1.logger.error("[MCP Tool] layout.search vision search error", {
-                code: errorCode,
-                error: errorMessage,
-            });
-        }
-        return {
-            success: false,
-            error: {
-                code: errorCode,
-                message: errorMessage,
-            },
-        };
-    }
-}
-// =====================================================
-// Multimodal Search / RRF Functions
-// =====================================================
-/**
- * RRF (Reciprocal Rank Fusion) スコアを計算
- *
- * 公式: score = 1 / (k + rank)
- *
- * @param textRank - テキスト検索でのランク（1から開始、0は未検索）
- * @param visionRank - Vision検索でのランク（1から開始、0は未検索）
- * @param textWeight - テキスト検索の重み（デフォルト0.6）
- * @param visionWeight - Vision検索の重み（デフォルト0.4）
- * @param k - RRFのkパラメータ（デフォルト60）
- */
-function calculateRrfScore(textRank, visionRank, textWeight = 0.6, visionWeight = 0.4, k = 60) {
-    const textScore = textRank > 0 ? 1 / (k + textRank) : 0;
-    const visionScore = visionRank > 0 ? 1 / (k + visionRank) : 0;
-    return textWeight * textScore + visionWeight * visionScore;
-}
-/**
- * 検索モードを決定し、必要に応じてフォールバック（Graceful Degradation）
- *
- * @param requestedMode - 要求された検索モード
- * @param hasVisionService - VisionSearchServiceが利用可能か
- * @param hasVisionEmbeddings - vision_embeddingが存在するか（DBチェック）
- * @returns 実際の検索モードと警告メッセージ
- */
-function determineSearchMode(requestedMode, hasVisionService, hasVisionEmbeddings = true) {
-    const warnings = [];
-    // text_only は常にそのまま
-    if (requestedMode === "text_only") {
-        return { actualMode: "text_only", warnings };
-    }
-    // VisionSearchServiceが利用不可
-    if (!hasVisionService) {
-        if (requestedMode === "vision_only") {
-            warnings.push("VisionSearchService unavailable, falling back to text_only");
-        }
-        else if (requestedMode === "combined") {
-            warnings.push("VisionSearchService unavailable, falling back to text_only");
-        }
-        return { actualMode: "text_only", warnings };
-    }
-    // vision_embeddingが存在しない
-    if (!hasVisionEmbeddings) {
-        if (requestedMode === "vision_only") {
-            warnings.push("vision_embedding not available, falling back to text_only");
-        }
-        else if (requestedMode === "combined") {
-            warnings.push("No vision embeddings available, falling back to text_only");
-        }
-        return { actualMode: "text_only", warnings };
-    }
-    // 要求されたモードをそのまま使用
-    return { actualMode: requestedMode, warnings };
-}
-/**
- * search_modeに基づくマルチモーダル検索実行
- */
-async function executeMultimodalSearch(validated, service, startTime) {
-    const searchMode = validated.search_mode ?? "text_only";
-    const multimodalOptions = validated.multimodal_options;
-    const textWeight = multimodalOptions?.textWeight ?? 0.6;
-    const visionWeight = multimodalOptions?.visionWeight ?? 0.4;
-    const rrfK = multimodalOptions?.rrfK ?? 60;
-    // VisionSearchServiceの可用性チェック
-    const hasVisionService = !!visionSearchServiceFactory;
-    // 検索モードを決定（Graceful Degradation）
-    const { actualMode, warnings } = determineSearchMode(searchMode, hasVisionService);
-    if ((0, logger_1.isDevelopment)()) {
-        logger_1.logger.debug("[MCP Tool] layout.search multimodal mode", {
-            requestedMode: searchMode,
-            actualMode,
-            warnings,
-        });
-    }
-    // text_only モード
-    if (actualMode === "text_only") {
-        const processedQuery = preprocessQuery(validated.query);
-        const queryEmbedding = await service.generateQueryEmbedding(processedQuery);
-        if (queryEmbedding === null) {
-            return {
-                success: true,
-                data: {
-                    results: [],
-                    total: 0,
-                    query: validated.query,
-                    filters: validated.filters ?? {},
-                    searchTimeMs: Date.now() - startTime,
-                    searchMode: searchMode,
-                    actualSearchMode: actualMode,
-                    warnings: warnings.length > 0 ? warnings : undefined,
-                },
-            };
-        }
-        const searchOptions = {
-            filters: validated.filters,
-            limit: validated.limit,
-            offset: validated.offset,
-            include_html: getIncludeHtml(validated),
-            project_context: validated.project_context,
-        };
-        // ハイブリッド検索（vector + fulltext RRF）が利用可能な場合はそちらを使用
-        const searchResult = service.searchSectionPatternsHybrid
-            ? await service.searchSectionPatternsHybrid(validated.query, queryEmbedding, searchOptions)
-            : await service.searchSectionPatterns(queryEmbedding, searchOptions);
-        if (!searchResult) {
-            return {
-                success: true,
-                data: {
-                    results: [],
-                    total: 0,
-                    query: validated.query,
-                    filters: validated.filters ?? {},
-                    searchTimeMs: Date.now() - startTime,
-                    searchMode: searchMode,
-                    actualSearchMode: actualMode,
-                    warnings: warnings.length > 0 ? warnings : undefined,
-                },
-            };
-        }
-        // 結果マッピング
-        const previewOptions = {
-            includePreview: validated.include_preview,
-            maxLength: validated.preview_max_length,
-        };
-        const includeHtmlValue = getIncludeHtml(validated);
-        const mappedResults = searchResult.results.map((sr) => mapSearchResult(sr, includeHtmlValue, undefined, // adaptability
-        undefined, // semanticInfo
-        previewOptions));
-        return {
-            success: true,
-            data: {
-                results: mappedResults,
-                total: searchResult.total,
-                query: validated.query,
-                filters: validated.filters ?? {},
-                searchTimeMs: Date.now() - startTime,
-                searchMode: searchMode,
-                actualSearchMode: actualMode,
-                warnings: warnings.length > 0 ? warnings : undefined,
-            },
-        };
-    }
-    // vision_only または combined モードではVisionSearchServiceを使用
-    if (!visionSearchServiceFactory) {
-        // これはdetermineSearchModeで処理されるはずだが、安全のため
-        return {
-            success: false,
-            error: {
-                code: "VISION_SEARCH_UNAVAILABLE",
-                message: "Vision search service is not available.",
-            },
-        };
-    }
-    const visionService = visionSearchServiceFactory();
-    // vision_only モード
-    if (actualMode === "vision_only") {
-        try {
-            const visionQuery = {
-                textQuery: validated.vision_search_query?.textQuery ?? validated.query,
-            };
-            const visionOptions = {
-                limit: validated.limit,
-                offset: validated.offset,
-                minSimilarity: 0.5,
-                visionWeight: 1.0, // vision_onlyなので100%
-                textWeight: 0.0,
-            };
-            if (validated.filters?.sectionType) {
-                visionOptions.sectionType = validated.filters.sectionType;
-            }
-            // searchByVisionEmbeddingを呼び出し（vision_onlyモード）
-            const visionResult = await visionService.searchByVisionEmbedding(visionQuery, visionOptions);
-            if (!visionResult) {
-                return {
-                    success: true,
-                    data: {
-                        results: [],
-                        total: 0,
-                        query: validated.query,
-                        filters: validated.filters ?? {},
-                        searchTimeMs: Date.now() - startTime,
-                        searchMode: searchMode,
-                        actualSearchMode: actualMode,
-                        warnings: warnings.length > 0 ? warnings : undefined,
-                    },
-                };
-            }
-            // Graceful Degradation - fallbackToTextOnly処理
-            if (visionResult.fallbackToTextOnly) {
-                warnings.push("vision_embedding not available, falling back to text_only");
-                // text_onlyで再検索（警告を保持したまま）
-                const processedQuery = preprocessQuery(validated.query);
-                const queryEmbedding = await service.generateQueryEmbedding(processedQuery);
-                if (queryEmbedding === null) {
-                    return {
-                        success: true,
-                        data: {
-                            results: [],
-                            total: 0,
-                            query: validated.query,
-                            filters: validated.filters ?? {},
-                            searchTimeMs: Date.now() - startTime,
-                            searchMode: searchMode,
-                            actualSearchMode: "text_only", // フォールバック後
-                            warnings: warnings,
-                        },
-                    };
-                }
-                const searchOptions = {
-                    filters: validated.filters,
-                    limit: validated.limit,
-                    offset: validated.offset,
-                    include_html: getIncludeHtml(validated),
-                    project_context: validated.project_context,
-                };
-                const searchResult = await service.searchSectionPatterns(queryEmbedding, searchOptions);
-                const previewOptionsForFallback = {
-                    includePreview: validated.include_preview,
-                    maxLength: validated.preview_max_length,
-                };
-                const includeHtmlValueForFallback = getIncludeHtml(validated);
-                const mappedResultsForFallback = (searchResult?.results ?? []).map((sr) => mapSearchResult(sr, includeHtmlValueForFallback, undefined, undefined, previewOptionsForFallback));
-                return {
-                    success: true,
-                    data: {
-                        results: mappedResultsForFallback,
-                        total: searchResult?.total ?? 0,
-                        query: validated.query,
-                        filters: validated.filters ?? {},
-                        searchTimeMs: Date.now() - startTime,
-                        searchMode: searchMode,
-                        actualSearchMode: "text_only", // フォールバック後
-                        warnings: warnings,
-                    },
-                };
-            }
-            const previewOptions = {
-                includePreview: validated.include_preview,
-                maxLength: validated.preview_max_length,
-            };
-            const includeHtmlValue = getIncludeHtml(validated);
-            const mappedResults = visionResult.results.map((vr) => {
-                const searchResult = mapVisionResultToSearchResult(vr);
-                return mapSearchResult(searchResult, includeHtmlValue, undefined, undefined, previewOptions);
-            });
-            return {
-                success: true,
-                data: {
-                    results: mappedResults,
-                    total: visionResult.total,
-                    query: validated.query,
-                    filters: validated.filters ?? {},
-                    searchTimeMs: Date.now() - startTime,
-                    searchMode: searchMode,
-                    actualSearchMode: actualMode,
-                    warnings: warnings.length > 0 ? warnings : undefined,
-                },
-            };
-        }
-        catch (error) {
-            // エラー時はtext_onlyにフォールバック（警告を保持）
-            warnings.push(`Vision search error: ${error instanceof Error ? error.message : String(error)}, falling back to text_only`);
-            const processedQuery = preprocessQuery(validated.query);
-            const queryEmbedding = await service.generateQueryEmbedding(processedQuery);
-            if (queryEmbedding === null) {
-                return {
-                    success: true,
-                    data: {
-                        results: [],
-                        total: 0,
-                        query: validated.query,
-                        filters: validated.filters ?? {},
-                        searchTimeMs: Date.now() - startTime,
-                        searchMode: searchMode,
-                        actualSearchMode: "text_only",
-                        warnings: warnings,
-                    },
-                };
-            }
-            const searchOptions = {
-                filters: validated.filters,
-                limit: validated.limit,
-                offset: validated.offset,
-                include_html: getIncludeHtml(validated),
-                project_context: validated.project_context,
-            };
-            const searchResult = await service.searchSectionPatterns(queryEmbedding, searchOptions);
-            const previewOptionsForError = {
-                includePreview: validated.include_preview,
-                maxLength: validated.preview_max_length,
-            };
-            const includeHtmlValueForError = getIncludeHtml(validated);
-            const mappedResultsForError = (searchResult?.results ?? []).map((sr) => mapSearchResult(sr, includeHtmlValueForError, undefined, undefined, previewOptionsForError));
-            return {
-                success: true,
-                data: {
-                    results: mappedResultsForError,
-                    total: searchResult?.total ?? 0,
-                    query: validated.query,
-                    filters: validated.filters ?? {},
-                    searchTimeMs: Date.now() - startTime,
-                    searchMode: searchMode,
-                    actualSearchMode: "text_only",
-                    warnings: warnings,
-                },
-            };
-        }
-    }
-    // combined モード（RRF統合検索）
-    if (actualMode === "combined") {
-        const rrfStartTime = Date.now();
-        try {
-            const visionQuery = {
-                textQuery: validated.vision_search_query?.textQuery ?? validated.query,
-            };
-            const hybridOptions = {
-                limit: validated.limit,
-                offset: validated.offset,
-                minSimilarity: 0.5,
-                visionWeight: visionWeight,
-                textWeight: textWeight,
-                rrfK: rrfK, // RRFのkパラメータ
-            };
-            if (validated.filters?.sectionType) {
-                hybridOptions.sectionType = validated.filters.sectionType;
-            }
-            // hybridSearchを呼び出し
-            const hybridResult = await visionService.hybridSearch(validated.query, visionQuery, hybridOptions);
-            const rrfCalculationTime = Date.now() - rrfStartTime;
-            if (!hybridResult) {
-                return {
-                    success: true,
-                    data: {
-                        results: [],
-                        total: 0,
-                        query: validated.query,
-                        filters: validated.filters ?? {},
-                        searchTimeMs: Date.now() - startTime,
-                        searchMode: searchMode,
-                        actualSearchMode: actualMode,
-                        warnings: warnings.length > 0 ? warnings : undefined,
-                        rrfDetails: {
-                            k: rrfK,
-                            textWeight,
-                            visionWeight,
-                            textResultCount: 0,
-                            visionResultCount: 0,
-                            fusedResultCount: 0,
-                            calculationTimeMs: rrfCalculationTime,
-                        },
-                    },
-                };
-            }
-            // Graceful Degradation - fallbackToTextOnly処理
-            if (hybridResult.fallbackToTextOnly) {
-                // フォールバック発生時は actualSearchMode を text_only に変更
-                const fallbackReason = hybridResult.fallbackReason ?? "No vision embeddings available";
-                warnings.push(fallbackReason);
-                const previewOptions = {
-                    includePreview: validated.include_preview,
-                    maxLength: validated.preview_max_length,
-                };
-                const includeHtmlValue = getIncludeHtml(validated);
-                const mappedResults = hybridResult.results.map((vr) => {
-                    const searchResult = mapVisionResultToSearchResult(vr);
-                    return mapSearchResult(searchResult, includeHtmlValue, undefined, undefined, previewOptions);
-                });
-                return {
-                    success: true,
-                    data: {
-                        results: mappedResults,
-                        total: hybridResult.total,
-                        query: validated.query,
-                        filters: validated.filters ?? {},
-                        searchTimeMs: Date.now() - startTime,
-                        searchMode: searchMode,
-                        actualSearchMode: "text_only", // フォールバック後のモード
-                        warnings: warnings.length > 0 ? warnings : undefined,
-                        fallbackReason: fallbackReason,
-                    },
-                };
-            }
-            const previewOptions = {
-                includePreview: validated.include_preview,
-                maxLength: validated.preview_max_length,
-            };
-            const includeHtmlValue = getIncludeHtml(validated);
-            const mappedResults = hybridResult.results.map((vr) => {
-                const searchResult = mapVisionResultToSearchResult(vr);
-                return mapSearchResult(searchResult, includeHtmlValue, undefined, undefined, previewOptions);
-            });
-            return {
-                success: true,
-                data: {
-                    results: mappedResults,
-                    total: hybridResult.total,
-                    query: validated.query,
-                    filters: validated.filters ?? {},
-                    searchTimeMs: Date.now() - startTime,
-                    searchMode: searchMode,
-                    actualSearchMode: actualMode,
-                    warnings: warnings.length > 0 ? warnings : undefined,
-                    rrfDetails: {
-                        k: rrfK,
-                        textWeight,
-                        visionWeight,
-                        textResultCount: hybridResult.results.length,
-                        visionResultCount: hybridResult.results.length,
-                        fusedResultCount: hybridResult.results.length,
-                        calculationTimeMs: rrfCalculationTime,
-                    },
-                },
-            };
-        }
-        catch (error) {
-            warnings.push(`Combined search error: ${error instanceof Error ? error.message : String(error)}, falling back to text_only`);
-            return executeMultimodalSearch({ ...validated, search_mode: "text_only" }, service, startTime);
-        }
-    }
-    // フォールバック（通常到達しない）
-    return {
-        success: false,
-        error: {
-            code: "INTERNAL_ERROR",
-            message: `Unexpected search mode: ${actualMode}`,
-        },
-    };
-}
-// =====================================================
-// メインハンドラー
-// =====================================================
-/**
- * layout.search ツールハンドラー
- *
- * @param input - 入力パラメータ
- * @returns 検索結果
- *
- * @example
- * ```typescript
- * const result = await layoutSearchHandler({
- *   query: 'modern hero section with gradient',
- *   filters: {
- *     sectionType: 'hero',
- *     sourceType: 'award_gallery',
- *   },
- *   limit: 10,
- *   offset: 0,
- * });
- * ```
- */
-async function layoutSearchHandler(input) {
-    const startTime = Date.now();
-    // 開発環境でのログ出力
-    if ((0, logger_1.isDevelopment)()) {
-        logger_1.logger.info("[MCP Tool] layout.search called", {
-            query: input?.query,
-        });
-    }
-    // 入力バリデーション
-    let validated;
-    try {
-        validated = schemas_1.layoutSearchInputSchema.parse(input);
-    }
-    catch (error) {
-        if (error instanceof zod_1.ZodError) {
-            const errorMessage = error.errors.map((e) => `${e.path.join(".")}: ${e.message}`).join(", ");
-            if ((0, logger_1.isDevelopment)()) {
-                logger_1.logger.error("[MCP Tool] layout.search validation error", {
-                    errors: error.errors,
-                });
-            }
-            return {
-                success: false,
-                error: {
-                    code: schemas_1.LAYOUT_MCP_ERROR_CODES.VALIDATION_ERROR,
-                    message: `Validation error: ${errorMessage}`,
-                },
-            };
-        }
-        throw error;
-    }
-    // サービスファクトリーチェック
-    if (!serviceFactory) {
-        if ((0, logger_1.isDevelopment)()) {
-            logger_1.logger.error("[MCP Tool] layout.search service factory not set");
-        }
-        return {
-            success: false,
-            error: {
-                code: "SERVICE_UNAVAILABLE",
-                message: "Search service is not available",
-            },
-        };
-    }
-    const service = serviceFactory();
-    try {
-        // search_mode ベースのルーティング（text_only以外の場合）
-        // search_mode が明示的に指定され、text_only以外の場合はマルチモーダル検索を実行
-        if (validated.search_mode && validated.search_mode !== "text_only") {
-            return executeMultimodalSearch(validated, service, startTime);
-        }
-        // Phase 4-2: Vision検索が有効な場合（レガシー互換性）
-        // use_vision_search=true かつ search_mode未指定の場合
-        if (validated.use_vision_search && !validated.search_mode) {
-            return executeVisionSearch(validated, startTime);
-        }
-        // 通常の検索（text_embedding）
-        // クエリ前処理
-        const processedQuery = preprocessQuery(validated.query);
-        if ((0, logger_1.isDevelopment)()) {
-            logger_1.logger.debug("[MCP Tool] layout.search processed query", {
-                original: validated.query,
-                processed: processedQuery,
-            });
-        }
-        // Embedding生成
-        const queryEmbedding = await service.generateQueryEmbedding(processedQuery);
-        // EmbeddingServiceが利用できない場合は空の結果を返す
-        if (queryEmbedding === null) {
-            if ((0, logger_1.isDevelopment)()) {
-                logger_1.logger.warn("[MCP Tool] layout.search embedding not available, returning empty results");
-            }
-            return {
-                success: true,
-                data: {
-                    results: [],
-                    total: 0,
-                    query: validated.query,
-                    filters: validated.filters ?? {},
-                    searchTimeMs: Date.now() - startTime,
-                },
-            };
-        }
-        // 検索オプション構築
-        // MCP-RESP-03: include_html (snake_case) を優先使用
-        const searchOptions = {
-            filters: validated.filters,
-            limit: validated.limit,
-            offset: validated.offset,
-            include_html: getIncludeHtml(validated),
-            project_context: validated.project_context,
-        };
-        // 検索実行: ハイブリッド検索（vector + fulltext RRF）が利用可能な場合はそちらを使用
-        const searchResult = service.searchSectionPatternsHybrid
-            ? await service.searchSectionPatternsHybrid(validated.query, queryEmbedding, searchOptions)
-            : await service.searchSectionPatterns(queryEmbedding, searchOptions);
-        // nullチェック
-        if (!searchResult) {
-            return {
-                success: true,
-                data: {
-                    results: [],
-                    total: 0,
-                    query: validated.query,
-                    filters: validated.filters ?? {},
-                    searchTimeMs: Date.now() - startTime,
-                },
-            };
-        }
-        const semanticMetadata = new Map();
-        // moodBrandToneSearchService インスタンスを取得
-        let moodBrandToneService = null;
-        if (moodBrandToneSearchServiceFactory) {
-            moodBrandToneService = moodBrandToneSearchServiceFactory();
-        }
-        // mood フィルターが提供されている場合、セマンティック検索を実行
-        if (moodBrandToneService && validated.filters?.mood) {
-            try {
-                const moodResults = await moodBrandToneService.searchByMood(validated.filters.mood);
-                if ((0, logger_1.isDevelopment)()) {
-                    logger_1.logger.debug("[MCP Tool] layout.search mood search completed", {
-                        resultCount: moodResults.length,
-                        mood: validated.filters.mood.primary,
-                    });
-                }
-                // 結果をマッピング用に保存
-                for (const moodResult of moodResults) {
-                    const patternId = moodResult.patternId;
-                    const existing = semanticMetadata.get(patternId) ?? {};
-                    if (moodResult.moodInfo !== undefined) {
-                        existing.moodInfo = moodResult.moodInfo;
-                    }
-                    semanticMetadata.set(patternId, existing);
-                }
-            }
-            catch (error) {
-                if ((0, logger_1.isDevelopment)()) {
-                    logger_1.logger.warn("[MCP Tool] layout.search mood search failed", {
-                        error: error instanceof Error ? error.message : String(error),
-                    });
-                }
-                // Graceful degradation: mood 検索失敗時は続行
-            }
-        }
-        // brandTone フィルターが提供されている場合、セマンティック検索を実行
-        if (moodBrandToneService && validated.filters?.brandTone) {
-            try {
-                const brandToneResults = await moodBrandToneService.searchByBrandTone(validated.filters.brandTone);
-                if ((0, logger_1.isDevelopment)()) {
-                    logger_1.logger.debug("[MCP Tool] layout.search brandTone search completed", {
-                        resultCount: brandToneResults.length,
-                        brandTone: validated.filters.brandTone.primary,
-                    });
-                }
-                // 結果をマッピング用に保存
-                for (const brandToneResult of brandToneResults) {
-                    const patternId = brandToneResult.patternId;
-                    const existing = semanticMetadata.get(patternId) ?? {};
-                    if (brandToneResult.brandToneInfo !== undefined) {
-                        existing.brandToneInfo = brandToneResult.brandToneInfo;
-                    }
-                    semanticMetadata.set(patternId, existing);
-                }
-            }
-            catch (error) {
-                if ((0, logger_1.isDevelopment)()) {
-                    logger_1.logger.warn("[MCP Tool] layout.search brandTone search failed", {
-                        error: error instanceof Error ? error.message : String(error),
-                    });
-                }
-                // Graceful degradation: brandTone 検索失敗時は続行
-            }
-        }
-        // ProjectContext解析（オプション）
-        let projectPatterns = null;
-        const projectContextOptions = validated.project_context;
-        const isProjectContextEnabled = projectContextOptions?.enabled !== false;
-        if (isProjectContextEnabled && projectContextOptions?.project_path) {
-            try {
-                const analyzer = getProjectContextAnalyzer();
-                projectPatterns = await analyzer.detectProjectPatterns(projectContextOptions.project_path);
-                if ((0, logger_1.isDevelopment)()) {
-                    logger_1.logger.debug("[MCP Tool] layout.search project patterns detected", {
-                        stylesCount: projectPatterns.designTokens.styles.length,
-                        hooksCount: projectPatterns.hooks.length,
-                        cssFramework: projectPatterns.cssFramework,
-                        animationsCount: projectPatterns.animations.length,
-                    });
-                }
-            }
-            catch (error) {
-                if ((0, logger_1.isDevelopment)()) {
-                    logger_1.logger.warn("[MCP Tool] layout.search project context analysis failed", {
-                        error: error instanceof Error ? error.message : String(error),
-                    });
-                }
-                // ProjectContext解析失敗時は続行（Graceful degradation）
-            }
-        }
-        // プレビューオプション
-        const previewOptions = {
-            includePreview: validated.include_preview,
-            maxLength: validated.preview_max_length,
-        };
-        // REFTRIX-LAYOUT-02: auto_detect_context によるコンテキスト推論
-        let inferredContext = null;
-        let contextBoostApplied = false;
-        if (validated.auto_detect_context !== false) {
-            try {
-                const queryAnalyzer = (0, query_context_analyzer_1.getQueryContextAnalyzer)();
-                inferredContext = queryAnalyzer.inferContext(validated.query);
-                if ((0, logger_1.isDevelopment)()) {
-                    logger_1.logger.debug("[MCP Tool] layout.search context inferred", {
-                        query: validated.query,
-                        industry: inferredContext.industry,
-                        style: inferredContext.style,
-                        confidence: inferredContext.confidence,
-                        detectedKeywords: inferredContext.detectedKeywords,
-                    });
-                }
-                // 信頼度が0.5以上の場合のみブーストを適用
-                if (inferredContext.confidence >= 0.5) {
-                    contextBoostApplied = true;
-                }
-            }
-            catch (error) {
-                if ((0, logger_1.isDevelopment)()) {
-                    logger_1.logger.warn("[MCP Tool] layout.search context inference failed", {
-                        error: error instanceof Error ? error.message : String(error),
-                    });
-                }
-                // コンテキスト推論失敗時は続行（Graceful degradation）
-            }
-        }
-        // 結果をマップ（ProjectContext解析が成功した場合はadaptabilityを計算、セマンティックメタデータを含める）
-        let mappedResults = searchResult.results.map((r) => {
-            let adaptabilityInfo;
-            if (projectPatterns && r.htmlSnippet) {
-                try {
-                    const analyzer = getProjectContextAnalyzer();
-                    const adaptabilityResult = analyzer.calculateAdaptabilityScore(r.htmlSnippet, projectPatterns);
-                    adaptabilityInfo = {
-                        score: adaptabilityResult.score,
-                        hints: adaptabilityResult.integration_hints,
-                    };
-                }
-                catch (error) {
-                    if ((0, logger_1.isDevelopment)()) {
-                        logger_1.logger.warn("[MCP Tool] layout.search adaptability calculation failed", {
-                            resultId: r.id,
-                            error: error instanceof Error ? error.message : String(error),
-                        });
-                    }
-                    // 個別の計算失敗は無視して続行
-                }
-            }
-            // TASK-06-3 Step 2: セマンティックメタデータを取得
-            const semanticInfo = semanticMetadata.get(r.id);
-            // REFTRIX-LAYOUT-02: コンテキストブーストを計算
-            let contextBoost;
-            if (contextBoostApplied && inferredContext) {
-                contextBoost = (0, query_context_analyzer_1.calculateContextBoost)({
-                    context: inferredContext,
-                    resultMetadata: {
-                        heading: r.layoutInfo?.heading,
-                        description: r.layoutInfo?.description,
-                        url: r.webPage.url,
-                        sectionType: r.sectionType,
-                    },
-                });
-            }
-            return mapSearchResult(r, getIncludeHtml(validated), adaptabilityInfo, semanticInfo, previewOptions, contextBoost);
-        });
-        // REFTRIX-LAYOUT-02: ブースト適用時は再ソート（similarity + boost で降順）
-        if (contextBoostApplied) {
-            mappedResults.sort((a, b) => {
-                const aTotal = a.similarity + (a.context_boost ?? 0);
-                const bTotal = b.similarity + (b.context_boost ?? 0);
-                return bTotal - aTotal;
-            });
-            // ブースト後の類似度を更新（1.0上限）
-            for (const result of mappedResults) {
-                if (result.context_boost !== undefined && result.context_boost > 0) {
-                    result.similarity = Math.min(1.0, result.similarity + result.context_boost);
-                }
-            }
-        }
-        const searchTimeMs = Date.now() - startTime;
-        // TASK-06-3 Step 4: filtersApplied の追跡
-        const filtersApplied = [];
-        if (validated.filters) {
-            if (validated.filters.mood) {
-                filtersApplied.push("mood");
-            }
-            if (validated.filters.brandTone) {
-                filtersApplied.push("brandTone");
-            }
-            if (validated.filters.visualFeatures) {
-                filtersApplied.push("visualFeatures");
-            }
-            if (validated.filters.sectionType) {
-                filtersApplied.push("sectionType");
-            }
-            if (validated.filters.sourceType) {
-                filtersApplied.push("sourceType");
-            }
-            if (validated.filters.usageScope) {
-                filtersApplied.push("usageScope");
-            }
-        }
-        if ((0, logger_1.isDevelopment)()) {
-            logger_1.logger.info("[MCP Tool] layout.search completed", {
-                query: validated.query,
-                resultCount: mappedResults.length,
-                total: searchResult.total,
-                searchTimeMs,
-                filtersApplied,
-                contextBoostApplied,
-            });
-        }
-        // 嗜好プロファイルによるリランキング / Preference profile reranking
-        mappedResults = await (0, preference_rerank_helper_1.applyPreferenceReranking)(mappedResults, validated.profile_id, prismaClientFactory, "layout", "layout.search");
-        // REFTRIX-LAYOUT-02: Build inferred_context output
-        let inferredContextOutput;
-        if (validated.auto_detect_context !== false && inferredContext) {
-            inferredContextOutput = {
-                industry: inferredContext.industry,
-                style: inferredContext.style,
-                confidence: inferredContext.confidence,
-                detected_keywords: inferredContext.detectedKeywords,
-            };
-        }
-        return {
-            success: true,
-            data: {
-                results: mappedResults,
-                total: searchResult.total,
-                query: validated.query,
-                filters: validated.filters ?? {},
-                filtersApplied,
-                searchTimeMs,
-                inferred_context: inferredContextOutput,
-                context_boost_applied: contextBoostApplied,
-            },
-        };
-    }
-    catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        const errorCode = determineErrorCode(error instanceof Error ? error : errorMessage);
-        if ((0, logger_1.isDevelopment)()) {
-            logger_1.logger.error("[MCP Tool] layout.search error", {
-                code: errorCode,
-                error: errorMessage,
-            });
-        }
-        return {
-            success: false,
-            error: {
-                code: errorCode,
-                message: errorMessage,
-            },
-        };
-    }
-}
-// =====================================================
-// ツール定義
-// =====================================================
-/**
- * layout.search MCPツール定義
- * MCP Protocol用のツール定義オブジェクト
- */
-exports.layoutSearchToolDefinition = {
-    name: "layout.search",
-    description: "セクションパターンを自然言語クエリでセマンティック検索します。" +
-        "日本語・英語の両方に対応しています。" +
-        "hero、feature、cta、testimonial、pricing、footer等のセクションタイプでフィルタリングできます。" +
-        "use_vision_search=trueでvision_embeddingを使用したハイブリッド検索（RRF: 60% vision + 40% text）が可能です。",
-    annotations: {
-        title: "Layout Search",
-        readOnlyHint: true,
-        idempotentHint: true,
-        openWorldHint: false,
-    },
-    inputSchema: {
-        type: "object",
-        properties: {
-            query: {
-                type: "string",
-                description: "検索クエリ（日本語または英語、1-500文字）",
-                minLength: 1,
-                maxLength: 500,
-            },
-            filters: {
-                type: "object",
-                description: "検索フィルター",
-                properties: {
-                    sectionType: {
-                        type: "string",
-                        enum: [
-                            "hero",
-                            "feature",
-                            "cta",
-                            "testimonial",
-                            "pricing",
-                            "footer",
-                            "navigation",
-                            "about",
-                            "contact",
-                            "gallery",
-                        ],
-                        description: "セクションタイプでフィルター",
-                    },
-                    sourceType: {
-                        type: "string",
-                        enum: ["award_gallery", "user_provided"],
-                        description: "ソースタイプでフィルター（award_gallery: アワードサイト、user_provided: ユーザー提供）",
-                    },
-                    usageScope: {
-                        type: "string",
-                        enum: ["inspiration_only", "owned_asset"],
-                        description: "利用範囲でフィルター（inspiration_only: インスピレーションのみ、owned_asset: 所有アセット）",
-                    },
-                },
-            },
-            limit: {
-                type: "number",
-                description: "取得件数（1-50、デフォルト: 10）",
-                minimum: 1,
-                maximum: 50,
-                default: 10,
-            },
-            offset: {
-                type: "number",
-                description: "オフセット（0以上、デフォルト: 0）",
-                minimum: 0,
-                default: 0,
-            },
-            // MCP-RESP-03: snake_case正式形式（新規オプション推奨形式）
-            include_html: {
-                type: "boolean",
-                description: "HTMLスニペットを含めるか（デフォルト: false）- snake_case正式形式",
-                default: false,
-            },
-            // レガシー互換: camelCaseは後方互換として維持
-            includeHtml: {
-                type: "boolean",
-                description: "HTMLスニペットを含めるか（デフォルト: false）- レガシー互換、include_html推奨",
-                default: false,
-            },
-            include_preview: {
-                type: "boolean",
-                description: "サニタイズ済みHTMLプレビューを含めるか（デフォルト: true）",
-                default: true,
-            },
-            preview_max_length: {
-                type: "number",
-                description: "HTMLプレビューの最大文字数（100-1000、デフォルト: 500）",
-                minimum: 100,
-                maximum: 1000,
-                default: 500,
-            },
-            project_context: {
-                type: "object",
-                description: "プロジェクトコンテキスト解析オプション。プロジェクトのデザインパターンを検出し、検索結果の適合度を評価します。",
-                properties: {
-                    enabled: {
-                        type: "boolean",
-                        description: "プロジェクトコンテキスト解析を有効化（デフォルト: true）",
-                        default: true,
-                    },
-                    project_path: {
-                        type: "string",
-                        description: "スキャン対象のプロジェクトパス（例: /home/user/my-project）",
-                    },
-                    design_tokens_path: {
-                        type: "string",
-                        description: "デザイントークンファイルの特定パス（オプション）",
-                    },
-                },
-            },
-            // Phase 4-3: Auto Context Detection
-            auto_detect_context: {
-                type: "boolean",
-                description: "クエリから業界・スタイルコンテキストを自動推論し、結果をブーストします。推論されたコンテキスト（業界: technology/ecommerce/healthcare等、スタイル: minimal/bold/corporate等）にマッチする結果の類似度スコアが最大0.15ブーストされます（デフォルト: true）",
-                default: true,
-            },
-            // Phase 4-2: Vision Search Parameters
-            use_vision_search: {
-                type: "boolean",
-                description: "Vision検索を有効化。vision_embeddingを使用したセマンティック検索を行います（デフォルト: false）",
-                default: false,
-            },
-            vision_search_query: {
-                type: "object",
-                description: "Vision検索クエリ（use_vision_search=true時に使用）",
-                properties: {
-                    textQuery: {
-                        type: "string",
-                        description: "テキストクエリ（視覚的特徴を自然言語で記述）",
-                    },
-                    visualFeatures: {
-                        type: "object",
-                        description: "構造化された視覚的特徴条件",
-                        properties: {
-                            theme: { type: "string", description: "テーマ（light/dark/mixed）" },
-                            colors: {
-                                type: "array",
-                                items: { type: "string" },
-                                description: "色指定（HEX形式配列）",
-                            },
-                            density: { type: "string", description: "密度（sparse/moderate/dense）" },
-                            gradient: { type: "string", description: "グラデーション（none/subtle/prominent）" },
-                            mood: { type: "string", description: "雰囲気（professional/playful/minimal等）" },
-                            brandTone: { type: "string", description: "ブランドトーン" },
-                        },
-                    },
-                    sectionPatternId: {
-                        type: "string",
-                        format: "uuid",
-                        description: "既存セクションIDで類似検索",
-                    },
-                },
-            },
-            vision_search_options: {
-                type: "object",
-                description: "Vision検索オプション（use_vision_search=true時に使用）",
-                properties: {
-                    minSimilarity: {
-                        type: "number",
-                        minimum: 0,
-                        maximum: 1,
-                        default: 0.5,
-                        description: "最小類似度（0-1、デフォルト: 0.5）",
-                    },
-                    visionWeight: {
-                        type: "number",
-                        minimum: 0,
-                        maximum: 1,
-                        default: 0.6,
-                        description: "RRFでのvision_embeddingの重み（0-1、デフォルト: 0.6）",
-                    },
-                    textWeight: {
-                        type: "number",
-                        minimum: 0,
-                        maximum: 1,
-                        default: 0.4,
-                        description: "RRFでのtext_embeddingの重み（0-1、デフォルト: 0.4）",
-                    },
-                },
-            },
-            // Multimodal Search Parameters
-            search_mode: {
-                type: "string",
-                enum: ["text_only", "vision_only", "combined"],
-                default: "text_only",
-                description: "検索モード。" +
-                    "text_only: text_embeddingのみを使用（デフォルト）。" +
-                    "vision_only: vision_embeddingのみを使用。" +
-                    "combined: 両方を使用してRRF統合検索。",
-            },
-            multimodal_options: {
-                type: "object",
-                description: "マルチモーダルオプション。search_mode='combined'時のRRF統合パラメータ。",
-                properties: {
-                    textWeight: {
-                        type: "number",
-                        minimum: 0,
-                        maximum: 1,
-                        default: 0.6,
-                        description: "text_embeddingの重み（0-1、デフォルト: 0.6）",
-                    },
-                    visionWeight: {
-                        type: "number",
-                        minimum: 0,
-                        maximum: 1,
-                        default: 0.4,
-                        description: "vision_embeddingの重み（0-1、デフォルト: 0.4）",
-                    },
-                    rrfK: {
-                        type: "number",
-                        minimum: 1,
-                        maximum: 100,
-                        default: 60,
-                        description: "RRFのkパラメータ（1-100、デフォルト: 60）",
-                    },
-                },
-            },
-            // Preference reranking
-            profile_id: {
-                type: "string",
-                format: "uuid",
-                description: "嗜好プロファイルID（検索結果のリランキングに使用） / Preference profile ID (used for search result reranking)",
-            },
-        },
-        required: ["query"],
-    },
-};
-// =====================================================
-// 開発環境ログ
-// =====================================================
-if ((0, logger_1.isDevelopment)()) {
-    logger_1.logger.debug("[layout.search] Tool module loaded");
-}
-//# sourceMappingURL=search.tool.js.map