@reftrixmcp/mcp-server 0.1.7

package/dist/tools/quality/schemas.js

@@ -0,0 +1,950 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.qualityGetJobStatusSuccessOutputSchema = exports.qualityGetJobStatusMetadataSchema = exports.qualityGetJobStatusDataSchema = exports.batchQualityResultSummarySchema = exports.batchQualityResultItemSchema = exports.qualityGetJobStatusInputSchema = exports.qualityJobStateSchema = exports.batchQualityEvaluateOutputSchema = exports.batchQualityEvaluateErrorOutputSchema = exports.batchQualityEvaluateSuccessOutputSchema = exports.deprecationWarningSchema = exports.batchQualityEvaluateDataSchema = exports.batchQualityJobStatusSchema = exports.batchQualityEvaluateInputSchema = exports.batchEvaluateItemSchema = exports.suggestImprovementsOutputSchema = exports.suggestImprovementsErrorOutputSchema = exports.suggestImprovementsSuccessOutputSchema = exports.suggestImprovementsDataSchema = exports.improvementSummarySchema = exports.improvementSchema = exports.suggestImprovementsInputSchema = exports.qualityMcpTools = exports.QUALITY_MCP_ERROR_CODES = exports.qualityEvaluateSuggestImprovementsSuccessOutputSchema = exports.qualityEvaluateOutputSchema = exports.qualityEvaluateErrorOutputSchema = exports.qualityEvaluateSuccessOutputSchema = exports.qualityEvaluateErrorSchema = exports.qualityEvaluateDataSchema = exports.axeAccessibilityResultSchema = exports.axeViolationSchema = exports.recommendationSchema = exports.clicheDetectionSchema = exports.contextualRecommendationSchema = exports.patternAnalysisSchema = exports.usedBenchmarkSchema = exports.similarMotionSchema = exports.similarSectionSchema = exports.axisScoreSchema = exports.qualityEvaluateInputSchema = exports.responsiveEvaluationSchema = exports.evaluationContextSchema = exports.patternComparisonSchema = exports.qualityEvaluateActionSchema = exports.weightsSchema = exports.improvementCategorySchema = exports.recommendationCategorySchema = exports.recommendationPrioritySchema = exports.gradeSchema = void 0;
+exports.qualityGetJobStatusOutputSchema = exports.qualityGetJobStatusErrorOutputSchema = void 0;
+exports.scoreToGrade = scoreToGrade;
+exports.calculateWeightedScore = calculateWeightedScore;
+/**
+ * quality.* MCP Tools Zod Schema Definitions
+ * Webデザイン品質評価ツールの入力/出力バリデーションスキーマ
+ *
+ * @module @reftrixmcp/mcp-server/tools/quality/schemas
+ *
+ * 対応ツール:
+ * - quality.evaluate: Webデザインの品質を3軸で評価
+ *
+ * 評価軸:
+ * - originality (独自性): AIクリシェの回避度、オリジナリティ
+ * - craftsmanship (技巧): 実装品質、コード構造、アクセシビリティ
+ * - contextuality (文脈適合性): 業界・ターゲット適合度
+ */
+const zod_1 = require("zod");
+// ============================================================================
+// Enum Schemas
+// ============================================================================
+/**
+ * 評価グレード
+ * A: 90-100, B: 80-89, C: 70-79, D: 60-69, F: 0-59
+ */
+exports.gradeSchema = zod_1.z.enum(["A", "B", "C", "D", "F"]);
+/**
+ * 推奨事項の優先度
+ */
+exports.recommendationPrioritySchema = zod_1.z.enum(["high", "medium", "low"]);
+/**
+ * 推奨事項のカテゴリ
+ */
+exports.recommendationCategorySchema = zod_1.z.enum([
+    "originality",
+    "craftsmanship",
+    "contextuality",
+    "accessibility",
+    "performance",
+    "general",
+]);
+/**
+ * 改善提案のカテゴリ
+ * (recommendationCategorySchemaと同一値だが、suggest_improvements専用に定義)
+ */
+exports.improvementCategorySchema = zod_1.z.enum([
+    "originality",
+    "craftsmanship",
+    "contextuality",
+    "accessibility",
+    "performance",
+    "general",
+]);
+// ============================================================================
+// quality.evaluate Input Schemas
+// ============================================================================
+/**
+ * 重み付け設定スキーマ
+ * 合計が1.0になる必要がある
+ */
+exports.weightsSchema = zod_1.z
+    .object({
+    originality: zod_1.z
+        .number()
+        .min(0, { message: "originality weightは0以上1以下である必要があります" })
+        .max(1, { message: "originality weightは0以上1以下である必要があります" })
+        .default(0.35),
+    craftsmanship: zod_1.z
+        .number()
+        .min(0, { message: "craftsmanship weightは0以上1以下である必要があります" })
+        .max(1, { message: "craftsmanship weightは0以上1以下である必要があります" })
+        .default(0.4),
+    contextuality: zod_1.z
+        .number()
+        .min(0, { message: "contextuality weightは0以上1以下である必要があります" })
+        .max(1, { message: "contextuality weightは0以上1以下である必要があります" })
+        .default(0.25),
+})
+    .refine((data) => {
+    const sum = data.originality + data.craftsmanship + data.contextuality;
+    // 浮動小数点誤差を考慮して0.99-1.01の範囲を許容
+    return sum >= 0.99 && sum <= 1.01;
+}, {
+    message: "重みの合計は1.0である必要があります",
+});
+/**
+ * quality.evaluate アクションタイプ
+ *
+ * - evaluate: 品質評価（デフォルト）
+ * - suggest_improvements: 評価結果に基づく改善提案生成
+ */
+exports.qualityEvaluateActionSchema = zod_1.z.enum(["evaluate", "suggest_improvements"]);
+/**
+ * パターン比較オプションスキーマ
+ * パターン駆動評価のためのオプション設定
+ */
+exports.patternComparisonSchema = zod_1.z.object({
+    /** パターン比較を有効にするか (default: true) */
+    enabled: zod_1.z.boolean().default(true),
+    /** 最小類似度しきい値 (0-1, default: 0.7) */
+    minSimilarity: zod_1.z
+        .number()
+        .min(0, { message: "minSimilarityは0以上1以下である必要があります" })
+        .max(1, { message: "minSimilarityは0以上1以下である必要があります" })
+        .default(0.7),
+    /** 取得するパターンの最大数 (1-20, default: 5) */
+    maxPatterns: zod_1.z
+        .number()
+        .int()
+        .min(1, { message: "maxPatternsは1以上20以下である必要があります" })
+        .max(20, { message: "maxPatternsは1以上20以下である必要があります" })
+        .default(5),
+});
+/**
+ * 評価コンテキストスキーマ
+ * 評価時のコンテキスト情報
+ */
+exports.evaluationContextSchema = zod_1.z.object({
+    /** プロジェクトID (UUID) */
+    projectId: zod_1.z.string().uuid({ message: "有効なUUID形式のprojectIdを指定してください" }).optional(),
+    /** ブランドパレットID (UUID) */
+    brandPaletteId: zod_1.z
+        .string()
+        .uuid({ message: "有効なUUID形式のbrandPaletteIdを指定してください" })
+        .optional(),
+    /** ターゲット業界 */
+    targetIndustry: zod_1.z.string().max(100).optional(),
+    /** ターゲットオーディエンス */
+    targetAudience: zod_1.z.string().max(100).optional(),
+});
+/**
+ * レスポンシブ評価オプションスキーマ
+ * Playwright実測定によるレスポンシブ品質評価
+ */
+exports.responsiveEvaluationSchema = zod_1.z.object({
+    /** レスポンシブ評価を有効にするか (default: false) */
+    enabled: zod_1.z.boolean().default(false),
+    /** 評価対象URL（pageId使用時は必須） */
+    url: zod_1.z.string().url({ message: "有効なURLを指定してください" }).optional(),
+    /** 評価対象のビューポート */
+    viewports: zod_1.z
+        .array(zod_1.z.object({
+        name: zod_1.z.string(),
+        width: zod_1.z.number().int().min(320).max(3840),
+        height: zod_1.z.number().int().min(480).max(2160),
+    }))
+        .optional(),
+    /** 実行するチェック項目 */
+    checks: zod_1.z
+        .object({
+        /** タッチターゲットサイズ検証 (WCAG 2.5.5: 44x44px) */
+        touchTargets: zod_1.z.boolean().default(true),
+        /** モバイル読みやすさ評価 */
+        readability: zod_1.z.boolean().default(true),
+        /** コンテンツオーバーフロー検出 */
+        overflow: zod_1.z.boolean().default(true),
+        /** レスポンシブ画像チェック */
+        images: zod_1.z.boolean().default(true),
+    })
+        .optional(),
+    /** タイムアウト (ms, default: 30000) */
+    timeout: zod_1.z
+        .number()
+        .int()
+        .min(5000, { message: "timeoutは5000ms以上にしてください" })
+        .max(120000, { message: "timeoutは120000ms以下にしてください" })
+        .default(30000),
+});
+/**
+ * quality.evaluate 入力スキーマ（統合）
+ *
+ * actionパラメータに応じて異なるオプションを受け付ける:
+ * - action: "evaluate" (デフォルト): weights, targetIndustry, targetAudience, includeRecommendations, strict
+ * - action: "suggest_improvements": categories, minPriority, maxSuggestions, includeCodeExamples
+ *
+ * 後方互換性: 既存のaction未指定の呼び出しは自動的にaction: "evaluate"として扱われます。
+ *
+ * v0.1.0: パターン駆動評価サポート追加
+ * - patternComparison: DBパターンとの比較オプション
+ * - context: プロジェクト/ブランド/デザインシステムコンテキスト
+ * - responsive_evaluation: Playwright実測定によるレスポンシブ品質評価
+ */
+exports.qualityEvaluateInputSchema = zod_1.z
+    .object({
+    // 共通フィールド
+    action: exports.qualityEvaluateActionSchema.optional().default("evaluate"),
+    pageId: zod_1.z.string().uuid({ message: "有効なUUID形式のpageIdを指定してください" }).optional(),
+    html: zod_1.z
+        .string()
+        .min(1, { message: "HTMLコンテンツは1文字以上必要です" })
+        .max(10_000_000, { message: "HTMLコンテンツは10MB以下にしてください" })
+        .optional(),
+    // action: "evaluate" 用オプション
+    weights: exports.weightsSchema.optional(),
+    targetIndustry: zod_1.z
+        .string()
+        .max(100, { message: "targetIndustryは100文字以下にしてください" })
+        .optional(),
+    targetAudience: zod_1.z
+        .string()
+        .max(100, { message: "targetAudienceは100文字以下にしてください" })
+        .optional(),
+    includeRecommendations: zod_1.z.boolean().default(true),
+    strict: zod_1.z.boolean().default(false),
+    // パターン駆動評価オプション (v0.1.0新規)
+    patternComparison: exports.patternComparisonSchema.optional(),
+    context: exports.evaluationContextSchema.optional(),
+    // アクセシビリティ検証オプション (v0.1.0新規)
+    /** Playwrightを使用したランタイムaXe検証を有効化（デフォルト: false = JSDOM版を使用） */
+    use_playwright: zod_1.z.boolean().default(false),
+    // レスポンス軽量化オプション (v0.1.0新規 MCP-RESP-01, v0.1.0 デフォルトtrue)
+    /**
+     * 軽量モード: 詳細情報を除外してサマリーのみ返却
+     *
+     * summary: true の場合 (v0.1.0よりデフォルト):
+     * - recommendations: 最大3件に制限（高優先度のみ）
+     * - contextualRecommendations: 最大3件に制限
+     * - patternAnalysis.similarSections: 最大3件に制限
+     * - patternAnalysis.similarMotions: 最大3件に制限
+     * - patternAnalysis.benchmarksUsed: 最大3件に制限
+     * - axeAccessibility.violations: 最大5件に制限
+     * - clicheDetection.patterns: 最大3件に制限
+     *
+     * 詳細情報が必要な場合は summary: false を明示的に指定してください。
+     */
+    summary: zod_1.z.boolean().default(true),
+    // レスポンシブ品質評価オプション (v0.1.0新規)
+    /**
+     * Playwright実測定によるレスポンシブ品質評価
+     *
+     * responsive_evaluation.enabled: true の場合:
+     * - Playwrightで複数ビューポートを実際に開いて計測
+     * - タッチターゲット、読みやすさ、オーバーフロー、画像の4チェック
+     * - craftsmanship スコアにレスポンシブデザイン品質を反映
+     * - urlまたはpageId（+url）が必要
+     */
+    responsive_evaluation: exports.responsiveEvaluationSchema.optional(),
+    // DB永続化オプション (v0.1.0新規 MCP-QUALITY-02)
+    /**
+     * 評価結果をデータベースに保存
+     *
+     * save_to_db: true の場合:
+     * - QualityEvaluation テーブルに評価結果を保存
+     * - overall_score, grade, subscores, pattern_references を記録
+     * - pageId が指定されている場合のみ有効（HTMLのみの場合はスキップ）
+     * - 保存失敗時は警告ログを出力するが、評価結果は正常に返却（graceful degradation）
+     */
+    save_to_db: zod_1.z
+        .boolean()
+        .default(false)
+        .describe("Save evaluation results to database (QualityEvaluation table). " +
+        "When true, saves overall score, grade, subscores, and pattern references."),
+    // action: "suggest_improvements" 用オプション
+    categories: zod_1.z.array(exports.improvementCategorySchema).optional(),
+    minPriority: exports.recommendationPrioritySchema.optional(),
+    maxSuggestions: zod_1.z.number().int().min(1).max(50).default(10),
+    includeCodeExamples: zod_1.z.boolean().default(true),
+})
+    .refine((data) => {
+    const hasPageId = data.pageId !== undefined;
+    const hasHtml = data.html !== undefined;
+    return hasPageId || hasHtml;
+}, {
+    message: "pageIdまたはhtmlのいずれかを指定してください",
+})
+    .refine((data) => {
+    const hasPageId = data.pageId !== undefined;
+    const hasHtml = data.html !== undefined;
+    return !(hasPageId && hasHtml);
+}, {
+    message: "pageIdとhtmlを同時に指定することはできません",
+});
+// ============================================================================
+// quality.evaluate Output Schemas
+// ============================================================================
+/**
+ * 軸別スコアスキーマ
+ */
+exports.axisScoreSchema = zod_1.z.object({
+    score: zod_1.z.number().min(0).max(100),
+    grade: exports.gradeSchema,
+    details: zod_1.z.array(zod_1.z.string()).optional(),
+});
+// ============================================================================
+// Pattern Analysis Schemas (v0.1.0)
+// ============================================================================
+/**
+ * 類似セクションパターンスキーマ
+ */
+exports.similarSectionSchema = zod_1.z.object({
+    /** パターンID (UUID) */
+    id: zod_1.z.string().uuid(),
+    /** セクションタイプ (hero, feature, cta等) */
+    type: zod_1.z.string(),
+    /** 類似度スコア (0-1) */
+    similarity: zod_1.z.number().min(0).max(1),
+    /** 元のWebページURL */
+    sourceUrl: zod_1.z.string().url().optional(),
+    /** 元のWebページID */
+    webPageId: zod_1.z.string().uuid().optional(),
+});
+/**
+ * 類似モーションパターンスキーマ
+ */
+exports.similarMotionSchema = zod_1.z.object({
+    /** パターンID (UUID) */
+    id: zod_1.z.string().uuid(),
+    /** モーションタイプ (animation, transition等) */
+    type: zod_1.z.string(),
+    /** カテゴリ (scroll, hover等) */
+    category: zod_1.z.string().optional(),
+    /** 類似度スコア (0-1) */
+    similarity: zod_1.z.number().min(0).max(1),
+    /** 元のWebページID */
+    webPageId: zod_1.z.string().uuid().optional(),
+});
+/**
+ * 使用ベンチマークスキーマ
+ */
+exports.usedBenchmarkSchema = zod_1.z.object({
+    /** ベンチマークID (UUID) */
+    id: zod_1.z.string().uuid(),
+    /** ベンチマーク名 */
+    name: zod_1.z.string(),
+    /** タイプ (industry, general等) */
+    type: zod_1.z.string(),
+    /** 評価時のスコア */
+    score: zod_1.z.number().min(0).max(100),
+    /** 類似度 (0-1) */
+    similarity: zod_1.z.number().min(0).max(1).optional(),
+});
+/**
+ * パターン分析結果スキーマ
+ */
+exports.patternAnalysisSchema = zod_1.z.object({
+    /** 類似セクションパターン */
+    similarSections: zod_1.z.array(exports.similarSectionSchema),
+    /** 類似モーションパターン */
+    similarMotions: zod_1.z.array(exports.similarMotionSchema),
+    /** 使用したベンチマーク */
+    benchmarksUsed: zod_1.z.array(exports.usedBenchmarkSchema),
+    /** ユニークネススコア (0-100) */
+    uniquenessScore: zod_1.z.number().min(0).max(100),
+    /** パターン類似度平均 (0-1) */
+    patternSimilarityAvg: zod_1.z.number().min(0).max(1),
+    /** パターン駆動評価が有効だったか */
+    patternDrivenEnabled: zod_1.z.boolean(),
+    /** フォールバック使用フラグ */
+    fallbackUsed: zod_1.z.boolean(),
+    /** フォールバック理由 */
+    fallbackReason: zod_1.z.string().optional(),
+});
+/**
+ * コンテキスト付き推奨事項スキーマ
+ */
+exports.contextualRecommendationSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    category: exports.recommendationCategorySchema,
+    priority: exports.recommendationPrioritySchema,
+    title: zod_1.z.string(),
+    description: zod_1.z.string(),
+    impact: zod_1.z.number().min(0).max(100).optional(),
+    /** 参照パターンID (存在する場合) */
+    referencePatternId: zod_1.z.string().uuid().optional(),
+    /** 参照パターンのソースURL */
+    referenceUrl: zod_1.z.string().url().optional(),
+    /** 参照パターンからの学び */
+    patternInsight: zod_1.z.string().optional(),
+});
+/**
+ * AIクリシェ検出結果スキーマ
+ */
+exports.clicheDetectionSchema = zod_1.z.object({
+    detected: zod_1.z.boolean(),
+    count: zod_1.z.number().int().nonnegative(),
+    patterns: zod_1.z.array(zod_1.z.object({
+        type: zod_1.z.string(),
+        description: zod_1.z.string(),
+        severity: zod_1.z.enum(["high", "medium", "low"]),
+        location: zod_1.z.string().optional(),
+    })),
+});
+/**
+ * 推奨事項スキーマ
+ */
+exports.recommendationSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    category: exports.recommendationCategorySchema,
+    priority: exports.recommendationPrioritySchema,
+    title: zod_1.z.string(),
+    description: zod_1.z.string(),
+    impact: zod_1.z.number().min(0).max(100).optional(),
+});
+/**
+ * aXe違反スキーマ
+ * WCAG 2.1 AA準拠チェックで検出された違反
+ */
+exports.axeViolationSchema = zod_1.z.object({
+    /** ルールID (e.g., 'image-alt', 'button-name') */
+    id: zod_1.z.string(),
+    /** インパクトレベル */
+    impact: zod_1.z.enum(["minor", "moderate", "serious", "critical"]),
+    /** 違反の説明 */
+    description: zod_1.z.string(),
+    /** 修正方法のヘルプテキスト */
+    help: zod_1.z.string(),
+    /** 詳細なヘルプURL */
+    helpUrl: zod_1.z.string().url(),
+    /** 影響を受けるノード数 */
+    nodes: zod_1.z.number().int().nonnegative(),
+});
+/**
+ * aXeアクセシビリティ結果スキーマ
+ * aXe-core によるWCAG 2.1 AA準拠チェック結果
+ */
+exports.axeAccessibilityResultSchema = zod_1.z.object({
+    /** 検出された違反のリスト */
+    violations: zod_1.z.array(exports.axeViolationSchema),
+    /** 合格したルール数 */
+    passes: zod_1.z.number().int().nonnegative(),
+    /** アクセシビリティスコア (0-100) */
+    score: zod_1.z.number().min(0).max(100),
+    /** WCAGレベル (A, AA, AAA) */
+    wcagLevel: zod_1.z.enum(["A", "AA", "AAA"]),
+});
+/**
+ * 評価データスキーマ (v0.1.0 拡張、v0.1.0 aXe統合)
+ */
+exports.qualityEvaluateDataSchema = zod_1.z.object({
+    pageId: zod_1.z.string().uuid().optional(),
+    overall: zod_1.z.number().min(0).max(100),
+    grade: exports.gradeSchema,
+    originality: exports.axisScoreSchema,
+    craftsmanship: exports.axisScoreSchema,
+    contextuality: exports.axisScoreSchema,
+    clicheDetection: exports.clicheDetectionSchema.optional(),
+    /** 推奨事項（後方互換性のため通常のrecommendationSchemaも許容） */
+    recommendations: zod_1.z.array(exports.recommendationSchema).optional(),
+    /** コンテキスト付き推奨事項（v0.1.0新規、パターン参照付き） */
+    contextualRecommendations: zod_1.z.array(exports.contextualRecommendationSchema).optional(),
+    /** パターン分析結果（v0.1.0新規） */
+    patternAnalysis: exports.patternAnalysisSchema.optional(),
+    /** aXeアクセシビリティ結果（v0.1.0新規、WCAG 2.1 AA準拠チェック） */
+    axeAccessibility: exports.axeAccessibilityResultSchema.optional(),
+    /** レスポンシブデザイン品質評価結果（v0.1.0新規、Playwright実測定） */
+    responsiveDesign: zod_1.z
+        .object({
+        /** 総合レスポンシブスコア (0-100) */
+        overallScore: zod_1.z.number().min(0).max(100),
+        /** 評価時間 (ms) */
+        evaluationTimeMs: zod_1.z.number().nonnegative(),
+        /** ビューポート別結果サマリー */
+        viewportSummaries: zod_1.z.array(zod_1.z.object({
+            viewport: zod_1.z.string(),
+            touchTargetScore: zod_1.z.number().min(0).max(100),
+            readabilityScore: zod_1.z.number().min(0).max(100),
+            overflowOk: zod_1.z.boolean(),
+            responsiveImageScore: zod_1.z.number().min(0).max(100),
+        })),
+    })
+        .optional(),
+    evaluatedAt: zod_1.z.string().datetime(),
+    weights: exports.weightsSchema.optional(),
+    targetIndustry: zod_1.z.string().optional(),
+    targetAudience: zod_1.z.string().optional(),
+    /** 評価コンテキスト（v0.1.0新規） */
+    evaluationContext: exports.evaluationContextSchema.optional(),
+});
+/**
+ * エラー情報スキーマ
+ */
+exports.qualityEvaluateErrorSchema = zod_1.z.object({
+    code: zod_1.z.string(),
+    message: zod_1.z.string(),
+    details: zod_1.z.unknown().optional(),
+});
+/**
+ * quality.evaluate 成功レスポンススキーマ
+ */
+exports.qualityEvaluateSuccessOutputSchema = zod_1.z.object({
+    success: zod_1.z.literal(true),
+    data: exports.qualityEvaluateDataSchema,
+});
+/**
+ * quality.evaluate 失敗レスポンススキーマ
+ */
+exports.qualityEvaluateErrorOutputSchema = zod_1.z.object({
+    success: zod_1.z.literal(false),
+    error: exports.qualityEvaluateErrorSchema,
+});
+/**
+ * quality.evaluate 出力スキーマ（統合）
+ */
+exports.qualityEvaluateOutputSchema = zod_1.z.discriminatedUnion("success", [
+    exports.qualityEvaluateSuccessOutputSchema,
+    exports.qualityEvaluateErrorOutputSchema,
+]);
+/**
+ * action: "suggest_improvements" 成功レスポンススキーマ
+ * (quality.evaluate統合後の出力形式)
+ */
+exports.qualityEvaluateSuggestImprovementsSuccessOutputSchema = zod_1.z.object({
+    success: zod_1.z.literal(true),
+    action: zod_1.z.literal("suggest_improvements"),
+    data: zod_1.z.object({
+        improvements: zod_1.z.array(zod_1.z.object({
+            id: zod_1.z.string(),
+            category: exports.improvementCategorySchema,
+            priority: exports.recommendationPrioritySchema,
+            title: zod_1.z.string(),
+            description: zod_1.z.string(),
+            originalCode: zod_1.z.string().optional(),
+            suggestedCode: zod_1.z.string(),
+            impact: zod_1.z.number().min(0).max(100).optional(),
+        })),
+        summary: zod_1.z.object({
+            totalImprovements: zod_1.z.number().int().nonnegative(),
+            estimatedScoreGain: zod_1.z.number().min(0).max(100),
+            categoryCounts: zod_1.z.object({
+                originality: zod_1.z.number().int().nonnegative().optional(),
+                craftsmanship: zod_1.z.number().int().nonnegative().optional(),
+                contextuality: zod_1.z.number().int().nonnegative().optional(),
+                accessibility: zod_1.z.number().int().nonnegative().optional(),
+                performance: zod_1.z.number().int().nonnegative().optional(),
+                general: zod_1.z.number().int().nonnegative().optional(),
+            }),
+        }),
+        generatedAt: zod_1.z.string().datetime(),
+        evaluationId: zod_1.z.string().uuid().optional(),
+    }),
+});
+// ============================================================================
+// Error Codes
+// ============================================================================
+/**
+ * quality.* ツール用エラーコード
+ */
+exports.QUALITY_MCP_ERROR_CODES = {
+    /** バリデーションエラー */
+    VALIDATION_ERROR: "VALIDATION_ERROR",
+    /** ページが見つからない */
+    PAGE_NOT_FOUND: "PAGE_NOT_FOUND",
+    /** 無効なHTML */
+    INVALID_HTML: "INVALID_HTML",
+    /** 無効な重み */
+    INVALID_WEIGHTS: "INVALID_WEIGHTS",
+    /** 評価エラー */
+    EVALUATION_ERROR: "EVALUATION_ERROR",
+    /** データベースエラー */
+    DB_ERROR: "DB_ERROR",
+    /** 内部エラー */
+    INTERNAL_ERROR: "INTERNAL_ERROR",
+    /** サービス利用不可 */
+    SERVICE_UNAVAILABLE: "SERVICE_UNAVAILABLE",
+    /** 評価が見つからない */
+    EVALUATION_NOT_FOUND: "EVALUATION_NOT_FOUND",
+    /** 改善提案生成エラー */
+    SUGGESTION_GENERATION_ERROR: "SUGGESTION_GENERATION_ERROR",
+};
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * スコアからグレードを計算
+ */
+function scoreToGrade(score) {
+    if (score >= 90)
+        return "A";
+    if (score >= 80)
+        return "B";
+    if (score >= 70)
+        return "C";
+    if (score >= 60)
+        return "D";
+    return "F";
+}
+/**
+ * 重み付きスコア計算
+ */
+function calculateWeightedScore(originality, craftsmanship, contextuality, weights) {
+    const weighted = originality * weights.originality +
+        craftsmanship * weights.craftsmanship +
+        contextuality * weights.contextuality;
+    return Math.round(weighted * 100) / 100;
+}
+// ============================================================================
+// MCP Tool Definitions
+// ============================================================================
+/**
+ * MCP Tool definitions for quality.* tools
+ * MCPプロトコル準拠のツール定義
+ */
+exports.qualityMcpTools = {
+    "quality.evaluate": {
+        name: "quality.evaluate",
+        description: "Webデザインの品質を3軸（独自性・技巧・文脈適合性）で評価し、AIクリシェ検出を行います",
+        inputSchema: exports.qualityEvaluateInputSchema,
+    },
+};
+// ============================================================================
+// quality.suggest_improvements Schemas
+// ============================================================================
+/**
+ * quality.suggest_improvements 入力スキーマ
+ */
+exports.suggestImprovementsInputSchema = zod_1.z
+    .object({
+    evaluationId: zod_1.z
+        .string()
+        .uuid({ message: "有効なUUID形式のevaluationIdを指定してください" })
+        .optional(),
+    html: zod_1.z
+        .string()
+        .min(1, { message: "HTMLコンテンツは1文字以上必要です" })
+        .max(10_000_000, { message: "HTMLコンテンツは10MB以下にしてください" })
+        .optional(),
+    categories: zod_1.z.array(exports.improvementCategorySchema).optional(),
+    minPriority: exports.recommendationPrioritySchema.optional(),
+    maxSuggestions: zod_1.z.number().int().min(1).max(50).default(10),
+    includeCodeExamples: zod_1.z.boolean().default(true),
+})
+    .refine((data) => {
+    const hasEvaluationId = data.evaluationId !== undefined;
+    const hasHtml = data.html !== undefined;
+    return hasEvaluationId || hasHtml;
+}, {
+    message: "evaluationIdまたはhtmlのいずれかを指定してください",
+})
+    .refine((data) => {
+    const hasEvaluationId = data.evaluationId !== undefined;
+    const hasHtml = data.html !== undefined;
+    return !(hasEvaluationId && hasHtml);
+}, {
+    message: "evaluationIdとhtmlを同時に指定することはできません",
+});
+/**
+ * 改善提案スキーマ
+ */
+exports.improvementSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    category: exports.improvementCategorySchema,
+    priority: exports.recommendationPrioritySchema,
+    title: zod_1.z.string(),
+    description: zod_1.z.string(),
+    originalCode: zod_1.z.string().optional(),
+    suggestedCode: zod_1.z.string(),
+    impact: zod_1.z.number().min(0).max(100).optional(),
+});
+/**
+ * 改善サマリースキーマ
+ */
+exports.improvementSummarySchema = zod_1.z.object({
+    totalImprovements: zod_1.z.number().int().nonnegative(),
+    estimatedScoreGain: zod_1.z.number().min(0).max(100),
+    categoryCounts: zod_1.z.object({
+        originality: zod_1.z.number().int().nonnegative().optional(),
+        craftsmanship: zod_1.z.number().int().nonnegative().optional(),
+        contextuality: zod_1.z.number().int().nonnegative().optional(),
+        accessibility: zod_1.z.number().int().nonnegative().optional(),
+        performance: zod_1.z.number().int().nonnegative().optional(),
+        general: zod_1.z.number().int().nonnegative().optional(),
+    }),
+});
+/**
+ * suggest_improvements データスキーマ
+ */
+exports.suggestImprovementsDataSchema = zod_1.z.object({
+    improvements: zod_1.z.array(exports.improvementSchema),
+    summary: exports.improvementSummarySchema,
+    generatedAt: zod_1.z.string().datetime(),
+    evaluationId: zod_1.z.string().uuid().optional(),
+});
+/**
+ * suggest_improvements 成功レスポンス
+ */
+exports.suggestImprovementsSuccessOutputSchema = zod_1.z.object({
+    success: zod_1.z.literal(true),
+    data: exports.suggestImprovementsDataSchema,
+});
+/**
+ * suggest_improvements 失敗レスポンス
+ */
+exports.suggestImprovementsErrorOutputSchema = zod_1.z.object({
+    success: zod_1.z.literal(false),
+    error: exports.qualityEvaluateErrorSchema,
+});
+/**
+ * suggest_improvements 出力スキーマ（統合）
+ */
+exports.suggestImprovementsOutputSchema = zod_1.z.discriminatedUnion("success", [
+    exports.suggestImprovementsSuccessOutputSchema,
+    exports.suggestImprovementsErrorOutputSchema,
+]);
+// ============================================================================
+// Additional Error Codes
+// ============================================================================
+// QUALITY_MCP_ERROR_CODESに追加
+// ============================================================================
+// quality.batch_evaluate Schemas
+// ============================================================================
+/**
+ * バッチ評価アイテムスキーマ
+ */
+exports.batchEvaluateItemSchema = zod_1.z
+    .object({
+    pageId: zod_1.z.string().uuid({ message: "有効なUUID形式のpageIdを指定してください" }).optional(),
+    html: zod_1.z
+        .string()
+        .min(1, { message: "HTMLコンテンツは1文字以上必要です" })
+        .max(10_000_000, { message: "HTMLコンテンツは10MB以下にしてください" })
+        .optional(),
+})
+    .refine((data) => {
+    const hasPageId = data.pageId !== undefined;
+    const hasHtml = data.html !== undefined;
+    return hasPageId || hasHtml;
+}, {
+    message: "pageIdまたはhtmlのいずれかを指定してください",
+})
+    .refine((data) => {
+    const hasPageId = data.pageId !== undefined;
+    const hasHtml = data.html !== undefined;
+    return !(hasPageId && hasHtml);
+}, {
+    message: "pageIdとhtmlを同時に指定することはできません",
+});
+/**
+ * バッチ評価入力スキーマ
+ */
+exports.batchQualityEvaluateInputSchema = zod_1.z.object({
+    items: zod_1.z
+        .array(exports.batchEvaluateItemSchema)
+        .min(1, { message: "少なくとも1つのアイテムを指定してください" })
+        .max(100, { message: "最大100件まで指定できます" }),
+    batch_size: zod_1.z
+        .number()
+        .int()
+        .min(1, { message: "batch_sizeは1以上50以下にしてください" })
+        .max(50, { message: "batch_sizeは1以上50以下にしてください" })
+        .default(10),
+    on_error: zod_1.z.enum(["skip", "abort"]).default("skip"),
+    weights: exports.weightsSchema.optional(),
+    strict: zod_1.z.boolean().default(false),
+});
+/**
+ * バッチジョブステータス
+ */
+exports.batchQualityJobStatusSchema = zod_1.z.object({
+    job_id: zod_1.z.string().uuid(),
+    status: zod_1.z.enum(["pending", "processing", "completed", "failed", "cancelled"]),
+    total_items: zod_1.z.number().int().nonnegative(),
+    processed_items: zod_1.z.number().int().nonnegative(),
+    success_items: zod_1.z.number().int().nonnegative(),
+    failed_items: zod_1.z.number().int().nonnegative(),
+    progress_percent: zod_1.z.number().min(0).max(100),
+    created_at: zod_1.z.string().datetime(),
+    completed_at: zod_1.z.string().datetime().optional(),
+    results: zod_1.z.array(exports.qualityEvaluateDataSchema).optional(),
+    errors: zod_1.z
+        .array(zod_1.z.object({
+        index: zod_1.z.number().int().nonnegative(),
+        error: exports.qualityEvaluateErrorSchema,
+    }))
+        .optional(),
+});
+/**
+ * バッチ評価成功レスポンスデータ
+ */
+exports.batchQualityEvaluateDataSchema = zod_1.z.object({
+    job_id: zod_1.z.string().uuid(),
+    status: zod_1.z.enum(["pending", "processing", "completed", "failed", "cancelled"]),
+    total_items: zod_1.z.number().int().nonnegative(),
+    batch_size: zod_1.z.number().int().positive(),
+    on_error: zod_1.z.enum(["skip", "abort"]),
+    created_at: zod_1.z.string().datetime(),
+    message: zod_1.z.string(),
+});
+/**
+ * 非推奨警告スキーマ（quality.batch_evaluate用）
+ */
+exports.deprecationWarningSchema = zod_1.z.object({
+    deprecated_tool: zod_1.z.string(),
+    replacement: zod_1.z.string(),
+    removal_version: zod_1.z.string(),
+    migration_guide: zod_1.z.string(),
+    message: zod_1.z.string(),
+});
+/**
+ * バッチ評価成功レスポンス
+ */
+exports.batchQualityEvaluateSuccessOutputSchema = zod_1.z.object({
+    success: zod_1.z.literal(true),
+    data: exports.batchQualityEvaluateDataSchema,
+    deprecation_warning: exports.deprecationWarningSchema.optional(),
+});
+/**
+ * バッチ評価失敗レスポンス
+ */
+exports.batchQualityEvaluateErrorOutputSchema = zod_1.z.object({
+    success: zod_1.z.literal(false),
+    error: exports.qualityEvaluateErrorSchema,
+});
+/**
+ * バッチ評価出力スキーマ（統合）
+ */
+exports.batchQualityEvaluateOutputSchema = zod_1.z.discriminatedUnion("success", [
+    exports.batchQualityEvaluateSuccessOutputSchema,
+    exports.batchQualityEvaluateErrorOutputSchema,
+]);
+// ============================================================================
+// quality.getJobStatus Schemas
+// ============================================================================
+/**
+ * ジョブステート（BullMQ互換）
+ */
+exports.qualityJobStateSchema = zod_1.z.enum([
+    "waiting", // キュー待ち
+    "active", // 処理中
+    "completed", // 完了
+    "failed", // 失敗
+    "delayed", // 遅延
+    "unknown", // 不明
+]);
+/**
+ * quality.getJobStatus 入力スキーマ
+ */
+exports.qualityGetJobStatusInputSchema = zod_1.z.object({
+    /**
+     * ジョブID（quality.batch_evaluate で返されたjob_id）
+     * MCP命名規約に沿ってsnake_case
+     */
+    job_id: zod_1.z.string().uuid({ message: "有効なUUID形式のjob_idを指定してください" }),
+});
+/**
+ * バッチ評価結果アイテムスキーマ
+ */
+exports.batchQualityResultItemSchema = zod_1.z.object({
+    /** アイテムインデックス */
+    index: zod_1.z.number().int().nonnegative(),
+    /** 成功フラグ */
+    success: zod_1.z.boolean(),
+    /** 評価結果（成功時のみ） */
+    data: exports.qualityEvaluateDataSchema.optional(),
+    /** エラー情報（失敗時のみ） */
+    error: zod_1.z
+        .object({
+        code: zod_1.z.string(),
+        message: zod_1.z.string(),
+    })
+        .optional(),
+});
+/**
+ * バッチ評価結果サマリースキーマ
+ */
+exports.batchQualityResultSummarySchema = zod_1.z.object({
+    /** ジョブID */
+    jobId: zod_1.z.string().uuid(),
+    /** 全体の成功フラグ */
+    success: zod_1.z.boolean(),
+    /** 総アイテム数 */
+    totalItems: zod_1.z.number().int().nonnegative(),
+    /** 処理済みアイテム数 */
+    processedItems: zod_1.z.number().int().nonnegative(),
+    /** 成功アイテム数 */
+    successItems: zod_1.z.number().int().nonnegative(),
+    /** 失敗アイテム数 */
+    failedItems: zod_1.z.number().int().nonnegative(),
+    /** 個別結果（オプション） */
+    results: zod_1.z.array(exports.batchQualityResultItemSchema).optional(),
+    /** 処理時間（ms） */
+    processingTimeMs: zod_1.z.number().nonnegative().optional(),
+    /** 完了日時 */
+    completedAt: zod_1.z.string().datetime().optional(),
+    /** エラーメッセージ（全体失敗時のみ） */
+    error: zod_1.z.string().optional(),
+});
+/**
+ * quality.getJobStatus 出力データスキーマ
+ */
+exports.qualityGetJobStatusDataSchema = zod_1.z.object({
+    /** ジョブID */
+    jobId: zod_1.z.string().uuid(),
+    /** ジョブステート */
+    status: exports.qualityJobStateSchema,
+    /** 進捗（0-100） */
+    progress: zod_1.z.number().min(0).max(100),
+    /** 総アイテム数 */
+    totalItems: zod_1.z.number().int().nonnegative(),
+    /** 処理済みアイテム数 */
+    processedItems: zod_1.z.number().int().nonnegative(),
+    /** 成功アイテム数 */
+    successItems: zod_1.z.number().int().nonnegative(),
+    /** 失敗アイテム数 */
+    failedItems: zod_1.z.number().int().nonnegative(),
+    /** 結果（completed時のみ） */
+    result: exports.batchQualityResultSummarySchema.optional(),
+    /** エラー理由（failed時のみ） */
+    failedReason: zod_1.z.string().optional(),
+    /** タイムスタンプ */
+    timestamps: zod_1.z.object({
+        created: zod_1.z.number().optional(),
+        started: zod_1.z.number().optional(),
+        completed: zod_1.z.number().optional(),
+        failed: zod_1.z.number().optional(),
+    }),
+});
+/**
+ * quality.getJobStatus メタデータスキーマ
+ */
+exports.qualityGetJobStatusMetadataSchema = zod_1.z.object({
+    /** リクエストID */
+    request_id: zod_1.z.string().optional(),
+    /** Redis使用フラグ */
+    redis_used: zod_1.z.boolean().optional(),
+    /** LRUストア使用フラグ（フォールバック時） */
+    lru_fallback: zod_1.z.boolean().optional(),
+});
+/**
+ * quality.getJobStatus 成功レスポンススキーマ
+ */
+exports.qualityGetJobStatusSuccessOutputSchema = zod_1.z.object({
+    success: zod_1.z.literal(true),
+    data: exports.qualityGetJobStatusDataSchema,
+    metadata: exports.qualityGetJobStatusMetadataSchema.optional(),
+});
+/**
+ * quality.getJobStatus エラーレスポンススキーマ
+ */
+exports.qualityGetJobStatusErrorOutputSchema = zod_1.z.object({
+    success: zod_1.z.literal(false),
+    error: zod_1.z.object({
+        code: zod_1.z.string(),
+        message: zod_1.z.string(),
+        details: zod_1.z.unknown().optional(),
+    }),
+    metadata: exports.qualityGetJobStatusMetadataSchema.optional(),
+});
+/**
+ * quality.getJobStatus 出力スキーマ（統合）
+ */
+exports.qualityGetJobStatusOutputSchema = zod_1.z.discriminatedUnion("success", [
+    exports.qualityGetJobStatusSuccessOutputSchema,
+    exports.qualityGetJobStatusErrorOutputSchema,
+]);
+//# sourceMappingURL=schemas.js.map