@reftrixmcp/mcp-server 0.1.7

package/dist/tools/layout/to-code.tool.js

@@ -0,0 +1,317 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.layoutGenerateCodeHandler = exports.layoutToCodeToolDefinition = exports.layoutGenerateCodeToolDefinition = void 0;
+exports.setLayoutToCodeServiceFactory = setLayoutToCodeServiceFactory;
+exports.resetLayoutToCodeServiceFactory = resetLayoutToCodeServiceFactory;
+exports.layoutToCodeHandler = layoutToCodeHandler;
+/**
+ * layout.to_code MCPツール
+ * セクションパターンからReact/Vue/HTMLコードを生成します
+ *
+ * 機能:
+ * - セクションパターンIDからコード生成
+ * - React/Vue/HTML出力対応
+ * - TypeScript/JavaScript選択
+ * - Tailwind CSS/Vanilla CSS選択
+ * - カスタムコンポーネント名設定
+ * - ブランドパレット適用
+ *
+ * @module tools/layout/to-code.tool
+ */
+const zod_1 = require("zod");
+const logger_1 = require("../../utils/logger");
+const schemas_1 = require("./schemas");
+const error_codes_1 = require("../common/error-codes");
+// =====================================================
+// サービスファクトリー（DI）
+// =====================================================
+let serviceFactory = null;
+/**
+ * サービスファクトリーを設定
+ */
+function setLayoutToCodeServiceFactory(factory) {
+    serviceFactory = factory;
+}
+/**
+ * サービスファクトリーをリセット
+ */
+function resetLayoutToCodeServiceFactory() {
+    serviceFactory = null;
+}
+// =====================================================
+// エラー生成ヘルパー
+// =====================================================
+/**
+ * エラーからエラーコードを判定
+ */
+function determineErrorCode(error) {
+    const message = typeof error === "string" ? error : error.message;
+    const lowerMessage = message.toLowerCase();
+    // コード生成エラー
+    if (lowerMessage.includes("generation") ||
+        lowerMessage.includes("template") ||
+        lowerMessage.includes("parsing")) {
+        return schemas_1.LAYOUT_MCP_ERROR_CODES.CODE_GENERATION_FAILED;
+    }
+    // データベースエラー
+    if (lowerMessage.includes("database") ||
+        lowerMessage.includes("prisma") ||
+        lowerMessage.includes("connection")) {
+        return schemas_1.LAYOUT_MCP_ERROR_CODES.INTERNAL_ERROR;
+    }
+    // パターン見つからない
+    if (lowerMessage.includes("not found") || lowerMessage.includes("pattern")) {
+        return schemas_1.LAYOUT_MCP_ERROR_CODES.PATTERN_NOT_FOUND;
+    }
+    // その他は内部エラー
+    return schemas_1.LAYOUT_MCP_ERROR_CODES.INTERNAL_ERROR;
+}
+// =====================================================
+// オプション正規化
+// =====================================================
+/**
+ * 入力オプションをCodeGeneratorOptionsに正規化
+ */
+function normalizeOptions(options) {
+    const result = {
+        framework: options?.framework ?? "react",
+        typescript: options?.typescript ?? true,
+        tailwind: options?.tailwind ?? true,
+    };
+    // オプショナルフィールドは定義されている場合のみ追加
+    if (options?.componentName !== undefined) {
+        result.componentName = options.componentName;
+    }
+    if (options?.paletteId !== undefined) {
+        result.paletteId = options.paletteId;
+    }
+    if (options?.splitComponents !== undefined) {
+        result.splitComponents = options.splitComponents;
+    }
+    // responsiveはデフォルトtrue（未指定時もtrue）
+    result.responsive = options?.responsive ?? true;
+    return result;
+}
+// =====================================================
+// メインハンドラー
+// =====================================================
+/**
+ * layout.to_code ツールハンドラー
+ *
+ * @param input - 入力パラメータ
+ * @returns 生成されたコード（Response Objectパターン）
+ *
+ * @example
+ * ```typescript
+ * const result = await layoutToCodeHandler({
+ *   patternId: '11111111-1111-1111-1111-111111111111',
+ *   options: {
+ *     framework: 'react',
+ *     typescript: true,
+ *     tailwind: true,
+ *   },
+ * });
+ *
+ * if (result.success) {
+ *   console.log(result.data.code);
+ * } else {
+ *   console.error(result.error.message);
+ * }
+ * ```
+ */
+async function layoutToCodeHandler(input) {
+    // 開発環境でのログ出力
+    if ((0, logger_1.isDevelopment)()) {
+        logger_1.logger.info("[MCP Tool] layout.to_code called", {
+            patternId: input?.patternId,
+        });
+    }
+    // 入力バリデーション
+    let validated;
+    try {
+        validated = schemas_1.layoutToCodeInputSchema.parse(input);
+    }
+    catch (error) {
+        if (error instanceof zod_1.ZodError) {
+            const errorMessage = error.errors.map((e) => `${e.path.join(".")}: ${e.message}`).join(", ");
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.error("[MCP Tool] layout.to_code validation error", {
+                    errors: error.errors,
+                });
+            }
+            return (0, error_codes_1.createErrorResponse)(schemas_1.LAYOUT_MCP_ERROR_CODES.VALIDATION_ERROR, `Validation error: ${errorMessage}`);
+        }
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return (0, error_codes_1.createErrorResponse)(schemas_1.LAYOUT_MCP_ERROR_CODES.INTERNAL_ERROR, errorMessage);
+    }
+    // サービスファクトリーチェック
+    if (!serviceFactory) {
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.error("[MCP Tool] layout.to_code service factory not set");
+        }
+        return (0, error_codes_1.createErrorResponse)("SERVICE_UNAVAILABLE", "Code generation service is not available");
+    }
+    const service = serviceFactory();
+    try {
+        // セクションパターン取得
+        const pattern = await service.getSectionPatternById(validated.patternId);
+        if (!pattern) {
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.warn("[MCP Tool] layout.to_code pattern not found", {
+                    patternId: validated.patternId,
+                });
+            }
+            return (0, error_codes_1.createErrorResponse)(schemas_1.LAYOUT_MCP_ERROR_CODES.PATTERN_NOT_FOUND, `Pattern not found: ${validated.patternId}`);
+        }
+        // オプション正規化
+        const options = normalizeOptions(validated.options);
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.debug("[MCP Tool] layout.to_code generating code", {
+                patternId: validated.patternId,
+                sectionType: pattern.sectionType,
+                framework: options.framework,
+                typescript: options.typescript,
+                tailwind: options.tailwind,
+            });
+        }
+        // コード生成
+        let generatedCode;
+        try {
+            generatedCode = await service.generateCode(pattern, options);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.error("[MCP Tool] layout.to_code generation error", {
+                    error: errorMessage,
+                });
+            }
+            return (0, error_codes_1.createErrorResponse)(schemas_1.LAYOUT_MCP_ERROR_CODES.CODE_GENERATION_FAILED, `Code generation failed: ${errorMessage}`);
+        }
+        // 結果を構築
+        const data = {
+            code: generatedCode.code,
+            framework: options.framework,
+            componentName: generatedCode.componentName,
+            filename: generatedCode.filename,
+            dependencies: generatedCode.dependencies,
+            inspirationUrls: [pattern.webPage.url],
+            usageScope: pattern.webPage.usageScope,
+        };
+        // データバリデーション
+        schemas_1.layoutToCodeDataSchema.parse(data);
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[MCP Tool] layout.to_code completed", {
+                patternId: validated.patternId,
+                framework: options.framework,
+                componentName: generatedCode.componentName,
+                codeLength: generatedCode.code.length,
+            });
+        }
+        return (0, error_codes_1.createSuccessResponse)(data);
+    }
+    catch (error) {
+        // その他のエラーは変換
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const errorCode = determineErrorCode(error instanceof Error ? error : errorMessage);
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.error("[MCP Tool] layout.to_code error", {
+                code: errorCode,
+                error: errorMessage,
+            });
+        }
+        return (0, error_codes_1.createErrorResponse)(errorCode, errorMessage);
+    }
+}
+// =====================================================
+// ツール定義
+// =====================================================
+/**
+ * layout.generate_code MCPツール定義
+ * MCP Protocol用のツール定義オブジェクト
+ *
+ * v0.1.0: layout.to_code から layout.generate_code にリネーム
+ * 後方互換性のため layoutToCodeToolDefinition も引き続きエクスポート
+ */
+exports.layoutGenerateCodeToolDefinition = {
+    name: "layout.generate_code",
+    description: "セクションパターンからReact/Vue/HTMLコードを生成します。" +
+        "パターンIDを指定して、選択したフレームワーク（React, Vue, HTML）でコードを出力できます。" +
+        "TypeScript/JavaScript、Tailwind CSS/Vanilla CSSの選択も可能です。",
+    annotations: {
+        title: "Layout Generate Code",
+        readOnlyHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    inputSchema: {
+        type: "object",
+        properties: {
+            patternId: {
+                type: "string",
+                format: "uuid",
+                description: "セクションパターンID（UUID形式、必須）",
+            },
+            options: {
+                type: "object",
+                description: "コード生成オプション",
+                properties: {
+                    framework: {
+                        type: "string",
+                        enum: ["react", "vue", "html"],
+                        description: "出力フレームワーク（デフォルト: react）",
+                        default: "react",
+                    },
+                    typescript: {
+                        type: "boolean",
+                        description: "TypeScript出力するか（デフォルト: true）",
+                        default: true,
+                    },
+                    tailwind: {
+                        type: "boolean",
+                        description: "Tailwind CSSを使用するか（デフォルト: true）",
+                        default: true,
+                    },
+                    componentName: {
+                        type: "string",
+                        description: "カスタムコンポーネント名（PascalCase形式）",
+                        pattern: "^[A-Z][a-zA-Z0-9]*$",
+                    },
+                    paletteId: {
+                        type: "string",
+                        format: "uuid",
+                        description: "適用するブランドパレットID（UUID形式）",
+                    },
+                    responsive: {
+                        type: "boolean",
+                        description: "レスポンシブブレークポイント自動生成（デフォルト: true）。" +
+                            "大きなwidth/padding/font-size/flex-directionをモバイルファーストのレスポンシブクラスに変換します。",
+                        default: true,
+                    },
+                },
+            },
+        },
+        required: ["patternId"],
+    },
+};
+/**
+ * @deprecated v0.1.0 で layout.generate_code にリネームされました。
+ * 後方互換性のためのエイリアス。新規コードでは layoutGenerateCodeToolDefinition を使用してください。
+ */
+exports.layoutToCodeToolDefinition = exports.layoutGenerateCodeToolDefinition;
+/**
+ * layout.generate_code ツールハンドラー
+ *
+ * v0.1.0: layoutToCodeHandler から layoutGenerateCodeHandler にリネーム
+ * 後方互換性のため layoutToCodeHandler も引き続きエクスポート
+ */
+exports.layoutGenerateCodeHandler = layoutToCodeHandler;
+// =====================================================
+// 開発環境ログ
+// =====================================================
+if ((0, logger_1.isDevelopment)()) {
+    logger_1.logger.debug("[layout.generate_code] Tool module loaded");
+}
+//# sourceMappingURL=to-code.tool.js.map

package/dist/tools/layout/to-code.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-code.tool.js","sourceRoot":"","sources":["../../../src/tools/layout/to-code.tool.ts"],"names":[],"mappings":"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"}

package/dist/tools/motion/analyze-frames.handler.d.ts

@@ -0,0 +1,157 @@
+import { type AnalyzeFramesInput, type AnalyzeFramesOutput, type AnalysisResults, type TimelineEntry, type AnalysisType } from "./analyze-frames.schema";
+/**
+ * フレーム解析サービスの入力型
+ */
+export interface FrameAnalysisServiceInput {
+    frame_dir: string;
+    frame_pattern: string;
+    analysis_types: AnalysisType[];
+    frame_paths: string[];
+    options: {
+        diff_threshold: number;
+        max_frames: number;
+        parallel: boolean;
+        output_diff_images: boolean;
+    };
+}
+/**
+ * フレーム解析サービスの出力型
+ */
+export interface FrameAnalysisServiceOutput {
+    frame_count: number;
+    analysis_results: AnalysisResults;
+    timeline: TimelineEntry[];
+    processing_time_ms: number;
+}
+/**
+ * フレーム解析サービスインターフェース
+ * DIパターンでテスト時にモックを注入可能
+ */
+export interface IFrameAnalysisService {
+    analyzeFrames(input: FrameAnalysisServiceInput): Promise<FrameAnalysisServiceOutput>;
+    compareFrames?(frame1Path: string, frame2Path: string, options?: {
+        threshold?: number;
+    }): Promise<{
+        from_index: number;
+        to_index: number;
+        change_ratio: number;
+        changed_pixels: number;
+        total_pixels: number;
+        change_regions: Array<{
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        }>;
+        has_change: boolean;
+    }>;
+    detectLayoutShift?(frame1Path: string, frame2Path: string, options?: {
+        threshold?: number;
+    }): Promise<{
+        frame_index: number;
+        shift_start_ms: number;
+        impact_score: number;
+        affected_regions: Array<{
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        }>;
+        estimated_cause: "image_load" | "font_swap" | "dynamic_content" | "unknown";
+        shift_direction: "horizontal" | "vertical" | "both";
+        shift_distance: number;
+    }>;
+    detectColorChange?(framePaths: string[], options?: {
+        threshold?: number;
+    }): Promise<{
+        events: Array<{
+            start_frame: number;
+            end_frame: number;
+            change_type: "fade_in" | "fade_out" | "color_transition" | "brightness_change";
+            affected_region: {
+                x: number;
+                y: number;
+                width: number;
+                height: number;
+            };
+            from_color: string;
+            to_color: string;
+            estimated_duration_ms: number;
+        }>;
+    }>;
+}
+/**
+ * サービスファクトリ型
+ */
+type FrameAnalysisServiceFactory = () => IFrameAnalysisService;
+/**
+ * サービスファクトリを設定
+ * テスト時にモックサービスを注入するために使用
+ */
+export declare function setFrameAnalysisServiceFactory(factory: FrameAnalysisServiceFactory): void;
+/**
+ * サービスファクトリをリセット
+ * テスト後にクリーンアップするために使用
+ */
+export declare function resetFrameAnalysisServiceFactory(): void;
+/**
+ * motion.analyze_frames ハンドラー
+ *
+ * フレーム画像を解析し、モーション/アニメーションパターンを検出します。
+ *
+ * @param input - 解析入力パラメータ
+ * @returns 解析結果
+ */
+export declare function motionAnalyzeFramesHandler(input: unknown): Promise<AnalyzeFramesOutput>;
+/**
+ * motion.analyze_frames ツール定義
+ * MCPサーバーに登録するためのツール定義オブジェクト
+ */
+export declare const motionAnalyzeFramesToolDefinition: {
+    name: "motion.analyze_frames";
+    description: "フレーム画像（PNG/JPEG連番）を解析し、モーション/アニメーションパターンを検出します。\n\n対応する解析タイプ:\n- frame_diff: フレーム間のピクセルレベル変化を検出\n- layout_shift: 予期しないレイアウト変化（CLS問題）を検出\n- color_change: フェードイン/アウトなどの色・透明度変化を検出\n- motion_vector: 移動方向と速度を推定\n- element_visibility: 新規要素の出現や既存要素の消失を検出\n\n入力: motion.detect の enable_frame_capture で生成されたフレーム画像ディレクトリ\n出力: 解析結果（変化率、レイアウトシフトスコア、タイムライン等）";
+    inputSchema: import("zod").ZodObject<{
+        frame_dir: import("zod").ZodEffects<import("zod").ZodString, string, string>;
+        frame_pattern: import("zod").ZodDefault<import("zod").ZodString>;
+        analysis_types: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodEnum<["frame_diff", "layout_shift", "color_change", "motion_vector", "element_visibility"]>, "many">>;
+        options: import("zod").ZodOptional<import("zod").ZodObject<{
+            diff_threshold: import("zod").ZodDefault<import("zod").ZodNumber>;
+            max_frames: import("zod").ZodDefault<import("zod").ZodNumber>;
+            parallel: import("zod").ZodDefault<import("zod").ZodBoolean>;
+            output_diff_images: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        }, "strip", import("zod").ZodTypeAny, {
+            diff_threshold: number;
+            output_diff_images: boolean;
+            parallel: boolean;
+            max_frames: number;
+        }, {
+            diff_threshold?: number | undefined;
+            output_diff_images?: boolean | undefined;
+            parallel?: boolean | undefined;
+            max_frames?: number | undefined;
+        }>>;
+    }, "strip", import("zod").ZodTypeAny, {
+        frame_dir: string;
+        frame_pattern: string;
+        analysis_types: ("layout_shift" | "motion_vector" | "frame_diff" | "color_change" | "element_visibility")[];
+        options?: {
+            diff_threshold: number;
+            output_diff_images: boolean;
+            parallel: boolean;
+            max_frames: number;
+        } | undefined;
+    }, {
+        frame_dir: string;
+        options?: {
+            diff_threshold?: number | undefined;
+            output_diff_images?: boolean | undefined;
+            parallel?: boolean | undefined;
+            max_frames?: number | undefined;
+        } | undefined;
+        frame_pattern?: string | undefined;
+        analysis_types?: ("layout_shift" | "motion_vector" | "frame_diff" | "color_change" | "element_visibility")[] | undefined;
+    }>;
+    handler: typeof motionAnalyzeFramesHandler;
+};
+export type { AnalyzeFramesInput, AnalyzeFramesOutput };
+//# sourceMappingURL=analyze-frames.handler.d.ts.map

package/dist/tools/motion/analyze-frames.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-frames.handler.d.ts","sourceRoot":"","sources":["../../../src/tools/motion/analyze-frames.handler.ts"],"names":[],"mappings":"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"}