@reftrixmcp/mcp-server 0.1.7 → 0.2.0

package/dist/tools/quality/evaluate.tool.js

@@ -1,815 +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.qualityEvaluateToolDefinition = exports.evaluateCraftsmanshipSync = exports.evaluateOriginality = exports.detectCliches = void 0;
-exports.setQualityEvaluateServiceFactory = setQualityEvaluateServiceFactory;
-exports.resetQualityEvaluateServiceFactory = resetQualityEvaluateServiceFactory;
-exports.setBenchmarkServiceFactory = setBenchmarkServiceFactory;
-exports.resetBenchmarkServiceFactory = resetBenchmarkServiceFactory;
-exports.getBenchmarkServiceFactory = getBenchmarkServiceFactory;
-exports.setPatternMatcherServiceFactory = setPatternMatcherServiceFactory;
-exports.resetPatternMatcherServiceFactory = resetPatternMatcherServiceFactory;
-exports.getPatternMatcherServiceFactory = getPatternMatcherServiceFactory;
-exports.setAxeAccessibilityServiceFactory = setAxeAccessibilityServiceFactory;
-exports.resetAxeAccessibilityServiceFactory = resetAxeAccessibilityServiceFactory;
-exports.getAxeAccessibilityServiceFactory = getAxeAccessibilityServiceFactory;
-exports.setPlaywrightAxeServiceFactory = setPlaywrightAxeServiceFactory;
-exports.resetPlaywrightAxeServiceFactory = resetPlaywrightAxeServiceFactory;
-exports.getPlaywrightAxeServiceFactory = getPlaywrightAxeServiceFactory;
-exports.qualityEvaluateHandler = qualityEvaluateHandler;
-/**
- * quality.evaluate MCPツールハンドラー（v0.1.0 Pattern-Driven Evaluation）
- *
- * MCPツールインターフェース: 入力バリデーション、DI管理、レスポンス構築。
- * 品質評価エンジンロジックは evaluate-engine.ts に分離。
- *
- * @module tools/quality/evaluate.tool
- */
-const zod_1 = require("zod");
-const logger_1 = require("../../utils/logger");
-const error_messages_1 = require("../../utils/error-messages");
-const improvement_utils_1 = require("./improvement-utils");
-const axe_accessibility_service_1 = require("../../services/quality/axe-accessibility.service");
-const schemas_1 = require("./schemas");
-const playwright_axe_service_1 = require("../../services/quality/playwright-axe.service");
-// 品質評価エンジンからのインポート
-const evaluate_engine_1 = require("./evaluate-engine");
-Object.defineProperty(exports, "detectCliches", { enumerable: true, get: function () { return evaluate_engine_1.detectCliches; } });
-Object.defineProperty(exports, "evaluateOriginality", { enumerable: true, get: function () { return evaluate_engine_1.evaluateOriginality; } });
-Object.defineProperty(exports, "evaluateCraftsmanshipSync", { enumerable: true, get: function () { return evaluate_engine_1.evaluateCraftsmanshipSync; } });
-// =====================================================
-// DI Factories
-// =====================================================
-let serviceFactory = null;
-let benchmarkServiceFactory = null;
-let patternMatcherServiceFactory = null;
-/**
- * IQualityEvaluateService ファクトリを設定
- *
- * @param factory - サービスファクトリ関数
- */
-function setQualityEvaluateServiceFactory(factory) {
-    serviceFactory = factory;
-}
-/**
- * IQualityEvaluateService ファクトリをリセット（テスト用）
- */
-function resetQualityEvaluateServiceFactory() {
-    serviceFactory = null;
-}
-/**
- * IBenchmarkService ファクトリを設定
- *
- * @param factory - ベンチマークサービスファクトリ関数
- */
-function setBenchmarkServiceFactory(factory) {
-    benchmarkServiceFactory = factory;
-}
-/**
- * IBenchmarkService ファクトリをリセット（テスト用）
- */
-function resetBenchmarkServiceFactory() {
-    benchmarkServiceFactory = null;
-}
-/**
- * 現在のBenchmarkServiceファクトリを取得（内部用）
- */
-function getBenchmarkServiceFactory() {
-    return benchmarkServiceFactory;
-}
-/**
- * IPatternMatcherService ファクトリを設定
- *
- * @param factory - パターンマッチャーサービスファクトリ関数
- */
-function setPatternMatcherServiceFactory(factory) {
-    patternMatcherServiceFactory = factory;
-}
-/**
- * IPatternMatcherService ファクトリをリセット（テスト用）
- */
-function resetPatternMatcherServiceFactory() {
-    patternMatcherServiceFactory = null;
-}
-/**
- * 現在のPatternMatcherServiceファクトリを取得（内部用）
- */
-function getPatternMatcherServiceFactory() {
-    return patternMatcherServiceFactory;
-}
-// =====================================================
-// aXe Accessibility Service DI (JSDOM版)
-// =====================================================
-let axeServiceFactory = null;
-/**
- * AxeAccessibilityService ファクトリを設定
- *
- * @param factory - サービスファクトリ関数
- */
-function setAxeAccessibilityServiceFactory(factory) {
-    axeServiceFactory = factory;
-}
-/**
- * AxeAccessibilityService ファクトリをリセット（テスト用）
- */
-function resetAxeAccessibilityServiceFactory() {
-    axeServiceFactory = null;
-}
-/**
- * 現在のAxeAccessibilityServiceファクトリを取得（内部用）
- */
-function getAxeAccessibilityServiceFactory() {
-    return axeServiceFactory;
-}
-// デフォルトaXeサービスインスタンス（ファクトリが未設定の場合）
-let defaultAxeService = null;
-/**
- * aXeサービスインスタンスを取得
- */
-function getAxeService() {
-    if (axeServiceFactory) {
-        return axeServiceFactory();
-    }
-    // デフォルトインスタンスを作成（シングルトン）
-    if (!defaultAxeService) {
-        defaultAxeService = new axe_accessibility_service_1.AxeAccessibilityService();
-    }
-    return defaultAxeService;
-}
-// =====================================================
-// Playwright aXe Service DI (v0.1.0新規)
-// =====================================================
-let playwrightAxeServiceFactory = null;
-let defaultPlaywrightAxeService = null;
-let playwrightAvailabilityChecked = false;
-let playwrightIsAvailable = false;
-/**
- * PlaywrightAxeService ファクトリを設定
- *
- * @param factory - サービスファクトリ関数
- */
-function setPlaywrightAxeServiceFactory(factory) {
-    playwrightAxeServiceFactory = factory;
-}
-/**
- * PlaywrightAxeService ファクトリをリセット（テスト用）
- */
-function resetPlaywrightAxeServiceFactory() {
-    playwrightAxeServiceFactory = null;
-    defaultPlaywrightAxeService = null;
-}
-/**
- * 現在のPlaywrightAxeServiceファクトリを取得（内部用）
- */
-function getPlaywrightAxeServiceFactory() {
-    return playwrightAxeServiceFactory;
-}
-/**
- * Playwright aXeサービスインスタンスを取得
- * Playwrightが利用不可の場合はnullを返す（Graceful Degradation）
- */
-async function getPlaywrightAxeService() {
-    // Playwright可用性をチェック（初回のみ）
-    if (!playwrightAvailabilityChecked) {
-        playwrightIsAvailable = await (0, playwright_axe_service_1.isPlaywrightAvailable)();
-        playwrightAvailabilityChecked = true;
-        if ((0, logger_1.isDevelopment)()) {
-            logger_1.logger.info("[PlaywrightAxe] Availability check", {
-                available: playwrightIsAvailable,
-            });
-        }
-    }
-    // Playwright利用不可の場合はnull
-    if (!playwrightIsAvailable) {
-        return null;
-    }
-    // ファクトリが設定されている場合はそれを使用
-    if (playwrightAxeServiceFactory) {
-        return playwrightAxeServiceFactory();
-    }
-    // デフォルトインスタンスを作成（シングルトン）
-    if (!defaultPlaywrightAxeService) {
-        defaultPlaywrightAxeService = (0, playwright_axe_service_1.createPlaywrightAxeService)();
-    }
-    return defaultPlaywrightAxeService;
-}
-// =====================================================
-// ハンドラー
-// =====================================================
-/**
- * quality.evaluate ツールハンドラー
- *
- * action パラメータにより動作を切り替え:
- * - "evaluate" (デフォルト): 品質評価を実行
- * - "suggest_improvements": 改善提案を生成
- */
-async function qualityEvaluateHandler(input) {
-    if ((0, logger_1.isDevelopment)()) {
-        logger_1.logger.info("[MCP Tool] quality.evaluate called", {
-            hasInput: input !== null && input !== undefined,
-        });
-    }
-    // 入力バリデーション
-    let validated;
-    try {
-        validated = schemas_1.qualityEvaluateInputSchema.parse(input);
-    }
-    catch (error) {
-        if (error instanceof zod_1.ZodError) {
-            const errorWithHints = (0, error_messages_1.createValidationErrorWithHints)(error, "quality.evaluate");
-            const detailedMessage = (0, error_messages_1.formatMultipleDetailedErrors)(errorWithHints.errors);
-            const formattedErrors = (0, error_messages_1.formatZodError)(error);
-            if ((0, logger_1.isDevelopment)()) {
-                logger_1.logger.error("[MCP Tool] quality.evaluate validation error", {
-                    errors: errorWithHints.errors,
-                });
-            }
-            return {
-                success: false,
-                error: {
-                    code: schemas_1.QUALITY_MCP_ERROR_CODES.VALIDATION_ERROR,
-                    message: `Validation error:\n${detailedMessage}`,
-                    details: {
-                        errors: formattedErrors,
-                        detailedErrors: errorWithHints.errors,
-                    },
-                },
-            };
-        }
-        throw error;
-    }
-    // action パラメータに基づいて処理を分岐
-    const action = validated.action ?? "evaluate";
-    if ((0, logger_1.isDevelopment)()) {
-        logger_1.logger.info("[MCP Tool] quality.evaluate action", { action });
-    }
-    let html = validated.html;
-    let pageId;
-    // pageIdが指定されている場合はDBから取得
-    if (validated.pageId && !html) {
-        try {
-            const service = serviceFactory?.();
-            if (!service?.getPageById) {
-                return {
-                    success: false,
-                    error: {
-                        code: schemas_1.QUALITY_MCP_ERROR_CODES.SERVICE_UNAVAILABLE,
-                        message: "Page service is not available",
-                    },
-                };
-            }
-            const page = await service.getPageById(validated.pageId);
-            if (!page) {
-                return {
-                    success: false,
-                    error: {
-                        code: schemas_1.QUALITY_MCP_ERROR_CODES.PAGE_NOT_FOUND,
-                        message: `Page not found: ${validated.pageId}`,
-                    },
-                };
-            }
-            html = page.htmlContent;
-            pageId = page.id;
-        }
-        catch (error) {
-            if ((0, logger_1.isDevelopment)()) {
-                logger_1.logger.error("[MCP Tool] quality.evaluate DB error", { error });
-            }
-            return {
-                success: false,
-                error: {
-                    code: schemas_1.QUALITY_MCP_ERROR_CODES.DB_ERROR,
-                    message: error instanceof Error ? error.message : "Database error",
-                },
-            };
-        }
-    }
-    if (!html) {
-        return {
-            success: false,
-            error: {
-                code: schemas_1.QUALITY_MCP_ERROR_CODES.VALIDATION_ERROR,
-                message: "No HTML content provided",
-            },
-        };
-    }
-    try {
-        // デフォルト重み
-        const weights = validated.weights ?? {
-            originality: 0.35,
-            craftsmanship: 0.4,
-            contextuality: 0.25,
-        };
-        // AIクリシェ検出
-        const clicheDetection = (0, evaluate_engine_1.detectCliches)(html, validated.strict);
-        // 3軸評価（aXe統合版を使用）
-        const originality = (0, evaluate_engine_1.evaluateOriginality)(html, clicheDetection, validated.strict);
-        const craftsmanshipOpts = {
-            use_playwright: validated.use_playwright,
-        };
-        if (validated.responsive_evaluation) {
-            craftsmanshipOpts.responsive_evaluation = validated.responsive_evaluation;
-        }
-        // DI解決: aXeサービスインスタンスを取得
-        const axeService = getAxeService();
-        const playwrightAxeService = craftsmanshipOpts.use_playwright
-            ? await getPlaywrightAxeService()
-            : null;
-        const craftsmanshipResult = await (0, evaluate_engine_1.evaluateCraftsmanshipWithAxe)(html, craftsmanshipOpts, {
-            axeService,
-            playwrightAxeService,
-        });
-        const craftsmanship = {
-            score: craftsmanshipResult.score,
-            grade: craftsmanshipResult.grade,
-            details: craftsmanshipResult.details,
-        };
-        const contextuality = (0, evaluate_engine_1.evaluateContextuality)(html, validated.targetIndustry, validated.targetAudience);
-        // aXeアクセシビリティ結果を保存（後でレスポンスに含める）
-        const axeAccessibilityResult = craftsmanshipResult.axeResult;
-        // 総合スコア計算
-        const overall = (0, schemas_1.calculateWeightedScore)(originality.score, craftsmanship.score, contextuality.score, weights);
-        const grade = (0, schemas_1.scoreToGrade)(overall);
-        // ============================================
-        // action: "suggest_improvements" ブランチ
-        // ============================================
-        if (action === "suggest_improvements") {
-            // 評価データを構築
-            const evaluation = {
-                overall,
-                grade,
-                originality,
-                craftsmanship,
-                contextuality,
-                clicheDetection,
-                evaluatedAt: new Date().toISOString(),
-            };
-            // 改善提案を生成
-            const improvements = (0, improvement_utils_1.generateImprovements)(evaluation, html, {
-                categories: validated.categories,
-                minPriority: validated.minPriority,
-                maxSuggestions: validated.maxSuggestions ?? 10,
-            });
-            // サマリーを計算
-            const summary = (0, improvement_utils_1.calculateSummary)(improvements);
-            if ((0, logger_1.isDevelopment)()) {
-                logger_1.logger.info("[MCP Tool] quality.evaluate action=suggest_improvements completed", {
-                    improvementCount: improvements.length,
-                    estimatedScoreGain: summary.estimatedScoreGain,
-                });
-            }
-            return {
-                success: true,
-                action: "suggest_improvements",
-                data: {
-                    improvements,
-                    summary,
-                    generatedAt: new Date().toISOString(),
-                },
-            };
-        }
-        // ============================================
-        // action: "evaluate" (デフォルト) ブランチ
-        // ============================================
-        // 推奨事項生成（基礎推奨事項）
-        const baseRecommendations = validated.includeRecommendations
-            ? (0, evaluate_engine_1.generateRecommendations)(originality, craftsmanship, contextuality, clicheDetection)
-            : [];
-        // 基礎スコア
-        const baseScores = {
-            originality: originality.score,
-            craftsmanship: craftsmanship.score,
-            contextuality: contextuality.score,
-        };
-        // ============================================
-        // パターン駆動評価（v0.1.0新機能）
-        // ============================================
-        let patternAnalysis;
-        let contextualRecommendations;
-        let finalOriginality = originality;
-        let finalCraftsmanship = craftsmanship;
-        let finalContextuality = contextuality;
-        let finalOverall = overall;
-        let finalGrade = grade;
-        // パターン比較オプションのデフォルト値
-        const patternComparisonOptions = {
-            enabled: validated.patternComparison?.enabled ?? true,
-            minSimilarity: validated.patternComparison?.minSimilarity ?? 0.7,
-            maxPatterns: validated.patternComparison?.maxPatterns ?? 5,
-        };
-        // パターン駆動評価が有効かつDIサービスが利用可能な場合
-        if (patternComparisonOptions.enabled && patternMatcherServiceFactory && serviceFactory) {
-            const patternResult = await (0, evaluate_engine_1.executePatternDrivenEvaluation)(html, baseScores, baseRecommendations, patternComparisonOptions, {
-                patternMatcher: patternMatcherServiceFactory(),
-                qualityService: serviceFactory(),
-            });
-            if (patternResult) {
-                // パターン駆動評価が成功
-                patternAnalysis = patternResult.patternAnalysis;
-                contextualRecommendations = patternResult.contextualRecommendations;
-                // スコアを調整後の値で上書き
-                finalOriginality = {
-                    ...originality,
-                    score: patternResult.adjustedScores.originality,
-                    grade: (0, schemas_1.scoreToGrade)(patternResult.adjustedScores.originality),
-                };
-                finalCraftsmanship = {
-                    ...craftsmanship,
-                    score: patternResult.adjustedScores.craftsmanship,
-                    grade: (0, schemas_1.scoreToGrade)(patternResult.adjustedScores.craftsmanship),
-                };
-                finalContextuality = {
-                    ...contextuality,
-                    score: patternResult.adjustedScores.contextuality,
-                    grade: (0, schemas_1.scoreToGrade)(patternResult.adjustedScores.contextuality),
-                };
-                // 総合スコア再計算
-                finalOverall = (0, schemas_1.calculateWeightedScore)(patternResult.adjustedScores.originality, patternResult.adjustedScores.craftsmanship, patternResult.adjustedScores.contextuality, weights);
-                finalGrade = (0, schemas_1.scoreToGrade)(finalOverall);
-                if ((0, logger_1.isDevelopment)()) {
-                    logger_1.logger.info("[MCP Tool] Pattern-driven evaluation applied", {
-                        baseOverall: overall,
-                        finalOverall,
-                        patternSimilarityAvg: patternAnalysis.patternSimilarityAvg,
-                        uniquenessScore: patternAnalysis.uniquenessScore,
-                    });
-                }
-            }
-            else {
-                // パターン駆動評価が失敗（フォールバック）
-                patternAnalysis = (0, evaluate_engine_1.createFallbackPatternAnalysis)("Pattern services unavailable");
-                if ((0, logger_1.isDevelopment)()) {
-                    logger_1.logger.info("[MCP Tool] Pattern-driven evaluation fallback used");
-                }
-            }
-        }
-        else if (patternComparisonOptions.enabled) {
-            // DIサービスが未登録の場合もフォールバック
-            patternAnalysis = (0, evaluate_engine_1.createFallbackPatternAnalysis)("Pattern services unavailable");
-            if ((0, logger_1.isDevelopment)()) {
-                logger_1.logger.warn("[MCP Tool] Pattern services not registered, using fallback");
-            }
-        }
-        // ============================================
-        // レスポンス軽量化（v0.1.0 MCP-RESP-01）
-        // ============================================
-        const isSummaryMode = validated.summary === true;
-        // summaryモード時の制限適用
-        let truncatedRecommendations = baseRecommendations;
-        let truncatedContextualRecommendations = contextualRecommendations;
-        let truncatedPatternAnalysis = patternAnalysis;
-        let truncatedClicheDetection = clicheDetection;
-        let truncatedAxeResult = axeAccessibilityResult;
-        if (isSummaryMode) {
-            // 推奨事項: 最大3件（高優先度のみ）
-            truncatedRecommendations = baseRecommendations
-                .filter((r) => r.priority === "high")
-                .slice(0, 3);
-            // コンテキスト付き推奨事項: 最大3件
-            if (contextualRecommendations) {
-                truncatedContextualRecommendations = contextualRecommendations.slice(0, 3);
-            }
-            // パターン分析: 各配列を最大3件に制限
-            if (patternAnalysis) {
-                truncatedPatternAnalysis = {
-                    ...patternAnalysis,
-                    similarSections: patternAnalysis.similarSections.slice(0, 3),
-                    similarMotions: patternAnalysis.similarMotions.slice(0, 3),
-                    benchmarksUsed: patternAnalysis.benchmarksUsed.slice(0, 3),
-                };
-            }
-            // クリシェ検出: 最大3件
-            truncatedClicheDetection = {
-                ...clicheDetection,
-                patterns: clicheDetection.patterns.slice(0, 3),
-            };
-            // aXe違反: 最大5件
-            if (axeAccessibilityResult) {
-                truncatedAxeResult = {
-                    ...axeAccessibilityResult,
-                    violations: axeAccessibilityResult.violations.slice(0, 5),
-                };
-            }
-            if ((0, logger_1.isDevelopment)()) {
-                logger_1.logger.info("[MCP Tool] quality.evaluate summary mode applied", {
-                    originalRecommendations: baseRecommendations.length,
-                    truncatedRecommendations: truncatedRecommendations.length,
-                    originalPatternSections: patternAnalysis?.similarSections.length ?? 0,
-                    truncatedPatternSections: truncatedPatternAnalysis?.similarSections.length ?? 0,
-                });
-            }
-        }
-        // レスポンスデータ構築
-        const data = {
-            overall: finalOverall,
-            grade: finalGrade,
-            originality: finalOriginality,
-            craftsmanship: finalCraftsmanship,
-            contextuality: finalContextuality,
-            clicheDetection: truncatedClicheDetection,
-            evaluatedAt: new Date().toISOString(),
-        };
-        if (pageId) {
-            data.pageId = pageId;
-        }
-        // 推奨事項（後方互換性のため baseRecommendations も含める）
-        if (truncatedRecommendations.length > 0) {
-            data.recommendations = truncatedRecommendations;
-        }
-        // コンテキスト付き推奨事項（v0.1.0新規）
-        if (truncatedContextualRecommendations && truncatedContextualRecommendations.length > 0) {
-            data.contextualRecommendations = truncatedContextualRecommendations;
-        }
-        // パターン分析結果（v0.1.0新規）
-        if (truncatedPatternAnalysis) {
-            data.patternAnalysis = truncatedPatternAnalysis;
-        }
-        // aXeアクセシビリティ結果（v0.1.0新規）
-        if (truncatedAxeResult) {
-            data.axeAccessibility = truncatedAxeResult;
-        }
-        // レスポンシブデザイン品質評価結果（v0.1.0新規）
-        if (craftsmanshipResult.responsiveResult) {
-            data.responsiveDesign = {
-                overallScore: craftsmanshipResult.responsiveResult.overallScore,
-                evaluationTimeMs: craftsmanshipResult.responsiveResult.evaluationTimeMs,
-                viewportSummaries: craftsmanshipResult.responsiveResult.viewportResults.map((vr) => {
-                    const totalTargets = vr.touchTargets.passed + vr.touchTargets.failed;
-                    const touchTargetScore = totalTargets > 0 ? Math.round((vr.touchTargets.passed / totalTargets) * 100) : 100;
-                    const readabilityScore = (vr.readability.fontSizeOk ? 33 : 0) +
-                        (vr.readability.lineLengthOk ? 33 : 0) +
-                        (vr.readability.lineHeightOk ? 34 : 0);
-                    const totalImages = vr.images.srcsetCount + vr.images.missingResponsive;
-                    const responsiveImageScore = totalImages > 0
-                        ? Math.round(Math.min(((vr.images.srcsetCount + vr.images.pictureCount) / totalImages) * 100, 100))
-                        : 100;
-                    return {
-                        viewport: vr.viewport.name,
-                        touchTargetScore,
-                        readabilityScore,
-                        overflowOk: !vr.overflow.horizontalScroll && vr.overflow.overflowElements.length === 0,
-                        responsiveImageScore,
-                    };
-                }),
-            };
-        }
-        if (validated.weights) {
-            data.weights = weights;
-        }
-        if (validated.targetIndustry) {
-            data.targetIndustry = validated.targetIndustry;
-        }
-        if (validated.targetAudience) {
-            data.targetAudience = validated.targetAudience;
-        }
-        // 評価コンテキストを追加（v0.1.0新規）
-        if (validated.context) {
-            data.evaluationContext = validated.context;
-        }
-        if ((0, logger_1.isDevelopment)()) {
-            logger_1.logger.info("[MCP Tool] quality.evaluate completed", {
-                action,
-                overall: finalOverall,
-                grade: finalGrade,
-                originality: finalOriginality.score,
-                craftsmanship: finalCraftsmanship.score,
-                contextuality: finalContextuality.score,
-                clicheCount: clicheDetection.count,
-                patternDrivenEnabled: patternAnalysis?.patternDrivenEnabled ?? false,
-                fallbackUsed: patternAnalysis?.fallbackUsed ?? true,
-                axeViolations: axeAccessibilityResult?.violations.length ?? 0,
-                axeWcagLevel: axeAccessibilityResult?.wcagLevel ?? "N/A",
-            });
-        }
-        // DB永続化処理（v0.1.0 MCP-QUALITY-02）
-        // save_to_db: true かつ pageId が指定されている場合のみ保存
-        if (validated.save_to_db && validated.pageId && serviceFactory) {
-            try {
-                const service = serviceFactory();
-                // PatternReferences を構築
-                const patternRefs = {
-                    similarSections: patternAnalysis?.similarSections?.map((s) => s.id) ?? [],
-                    similarMotions: patternAnalysis?.similarMotions?.map((m) => m.id) ?? [],
-                    benchmarksUsed: patternAnalysis?.benchmarksUsed?.map((b) => b.id) ?? [],
-                };
-                const evaluationId = await service.saveEvaluationWithPatterns(data, patternRefs);
-                if ((0, logger_1.isDevelopment)()) {
-                    logger_1.logger.info("[MCP Tool] quality.evaluate saved to DB", {
-                        evaluationId,
-                        pageId: validated.pageId,
-                    });
-                }
-            }
-            catch (saveError) {
-                // Graceful degradation: 保存失敗時は警告ログを出力するが、評価結果は正常に返却
-                logger_1.logger.warn("[MCP Tool] quality.evaluate DB save failed (graceful degradation)", {
-                    pageId: validated.pageId,
-                    error: saveError instanceof Error ? saveError.message : String(saveError),
-                });
-            }
-        }
-        return {
-            success: true,
-            data,
-        };
-    }
-    catch (error) {
-        if ((0, logger_1.isDevelopment)()) {
-            logger_1.logger.error("[MCP Tool] quality.evaluate error", { error });
-        }
-        return {
-            success: false,
-            error: {
-                code: schemas_1.QUALITY_MCP_ERROR_CODES.INTERNAL_ERROR,
-                message: error instanceof Error ? error.message : "Evaluation failed",
-            },
-        };
-    }
-}
-// =====================================================
-// ツール定義
-// =====================================================
-exports.qualityEvaluateToolDefinition = {
-    name: "quality.evaluate",
-    description: "Evaluate web design quality on 3 axes (originality, craftsmanship, contextuality) with AI cliche detection",
-    annotations: {
-        title: "Quality Evaluate",
-        readOnlyHint: true,
-        idempotentHint: true,
-        openWorldHint: false,
-    },
-    inputSchema: {
-        type: "object",
-        properties: {
-            pageId: {
-                type: "string",
-                format: "uuid",
-                description: "WebPage ID (UUID, from DB)",
-            },
-            html: {
-                type: "string",
-                minLength: 1,
-                maxLength: 10000000,
-                description: "HTML content (direct, max 10MB)",
-            },
-            weights: {
-                type: "object",
-                description: "Axis weights (sum 1.0)",
-                properties: {
-                    originality: {
-                        type: "number",
-                        minimum: 0,
-                        maximum: 1,
-                        default: 0.35,
-                        description: "Originality weight (default: 0.35)",
-                    },
-                    craftsmanship: {
-                        type: "number",
-                        minimum: 0,
-                        maximum: 1,
-                        default: 0.4,
-                        description: "Craftsmanship weight (default: 0.4)",
-                    },
-                    contextuality: {
-                        type: "number",
-                        minimum: 0,
-                        maximum: 1,
-                        default: 0.25,
-                        description: "Contextuality weight (default: 0.25)",
-                    },
-                },
-            },
-            targetIndustry: {
-                type: "string",
-                maxLength: 100,
-                description: "Target industry (e.g. healthcare, finance, technology)",
-            },
-            targetAudience: {
-                type: "string",
-                maxLength: 100,
-                description: "Target audience (e.g. enterprise, consumer, professionals)",
-            },
-            includeRecommendations: {
-                type: "boolean",
-                default: true,
-                description: "Include recommendations (default: true)",
-            },
-            strict: {
-                type: "boolean",
-                default: false,
-                description: "Strict mode: stricter AI cliche detection (default: false)",
-            },
-            patternComparison: {
-                type: "object",
-                description: "Pattern comparison options for pattern-driven evaluation (v0.1.0)",
-                properties: {
-                    enabled: {
-                        type: "boolean",
-                        default: true,
-                        description: "Enable pattern comparison (default: true)",
-                    },
-                    minSimilarity: {
-                        type: "number",
-                        minimum: 0,
-                        maximum: 1,
-                        default: 0.7,
-                        description: "Minimum similarity threshold (default: 0.7)",
-                    },
-                    maxPatterns: {
-                        type: "number",
-                        minimum: 1,
-                        maximum: 20,
-                        default: 5,
-                        description: "Maximum patterns to compare (default: 5)",
-                    },
-                },
-            },
-            context: {
-                type: "object",
-                description: "Evaluation context (v0.1.0)",
-                properties: {
-                    projectId: {
-                        type: "string",
-                        format: "uuid",
-                        description: "Project ID (UUID)",
-                    },
-                    brandPaletteId: {
-                        type: "string",
-                        format: "uuid",
-                        description: "Brand palette ID (UUID)",
-                    },
-                    targetIndustry: {
-                        type: "string",
-                        maxLength: 100,
-                        description: "Target industry",
-                    },
-                    targetAudience: {
-                        type: "string",
-                        maxLength: 100,
-                        description: "Target audience",
-                    },
-                },
-            },
-            use_playwright: {
-                type: "boolean",
-                default: false,
-                description: "Use Playwright for runtime aXe accessibility testing (default: false, uses JSDOM)",
-            },
-            responsive_evaluation: {
-                type: "object",
-                description: "Responsive quality evaluation using Playwright (v0.1.0). " +
-                    "Measures touch targets, readability, overflow, and responsive images across viewports.",
-                properties: {
-                    enabled: {
-                        type: "boolean",
-                        default: false,
-                        description: "Enable responsive evaluation (default: false)",
-                    },
-                    url: {
-                        type: "string",
-                        format: "uri",
-                        description: "URL to evaluate (required when enabled)",
-                    },
-                    viewports: {
-                        type: "array",
-                        description: "Viewports to evaluate (default: desktop/tablet/mobile)",
-                        items: {
-                            type: "object",
-                            properties: {
-                                name: { type: "string" },
-                                width: { type: "number", minimum: 320, maximum: 3840 },
-                                height: { type: "number", minimum: 480, maximum: 2160 },
-                            },
-                        },
-                    },
-                    checks: {
-                        type: "object",
-                        description: "Quality checks to run",
-                        properties: {
-                            touchTargets: { type: "boolean", default: true },
-                            readability: { type: "boolean", default: true },
-                            overflow: { type: "boolean", default: true },
-                            images: { type: "boolean", default: true },
-                        },
-                    },
-                    timeout: {
-                        type: "number",
-                        minimum: 5000,
-                        maximum: 120000,
-                        default: 30000,
-                        description: "Timeout in ms (default: 30000)",
-                    },
-                },
-            },
-            summary: {
-                type: "boolean",
-                default: true,
-                description: "Lightweight mode: exclude detailed info and return summary only (v0.1.0 MCP-RESP-01, v0.1.0 default true). " +
-                    "When true (default): recommendations max 3, contextualRecommendations max 3, patternAnalysis arrays max 3, " +
-                    "axeAccessibility.violations max 5, clicheDetection.patterns max 3. Set to false for full details.",
-            },
-        },
-    },
-};
-//# sourceMappingURL=evaluate.tool.js.map