@reftrixmcp/mcp-server 0.1.7 → 0.2.0

package/dist/tools/quality/schemas.js

@@ -1,950 +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.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