@reftrixmcp/mcp-server 0.1.7

package/dist/services/web-page.service.js

@@ -0,0 +1,211 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.webPageService = void 0;
+exports.createWebPageService = createWebPageService;
+/**
+ * WebPageService
+ * WebPageテーブルへのアクセスを提供するサービス
+ *
+ * motion.detectツールのgetPageById要件を満たす
+ *
+ * @module services/web-page.service
+ */
+const database_1 = require("@reftrixmcp/database");
+const logger_1 = require("../utils/logger");
+// =====================================================
+// WebPageService 実装
+// =====================================================
+/**
+ * WebPageサービス
+ * Prismaを使用してWebPageテーブルにアクセス
+ */
+class WebPageService {
+    /**
+     * IDでWebPageを取得
+     *
+     * @param id - WebPage UUID
+     * @returns WebPage情報（htmlContent含む）またはnull
+     */
+    async getPageById(id) {
+        try {
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.info("[WebPageService] getPageById", { id });
+            }
+            const page = await database_1.prisma.webPage.findUnique({
+                where: { id },
+                select: {
+                    id: true,
+                    htmlContent: true,
+                    // CSS is not stored separately in WebPage, so we don't include it
+                },
+            });
+            if (!page) {
+                if ((0, logger_1.isDevelopment)()) {
+                    logger_1.logger.warn("[WebPageService] Page not found", { id });
+                }
+                return null;
+            }
+            if (!page.htmlContent) {
+                if ((0, logger_1.isDevelopment)()) {
+                    logger_1.logger.warn("[WebPageService] Page has no HTML content", { id });
+                }
+                return null;
+            }
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.info("[WebPageService] Page found", {
+                    id: page.id,
+                    htmlLength: page.htmlContent.length,
+                });
+            }
+            return {
+                id: page.id,
+                htmlContent: page.htmlContent,
+                // cssContent is undefined as WebPage doesn't store CSS separately
+            };
+        }
+        catch (error) {
+            logger_1.logger.error("[WebPageService] Error getting page by ID", {
+                id,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
+    }
+    /**
+     * URLでWebPageを検索
+     *
+     * @param url - 検索するURL（完全一致）
+     * @returns WebPage基本情報またはnull
+     */
+    async findByUrl(url) {
+        try {
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.info("[WebPageService] findByUrl", { url });
+            }
+            const page = await database_1.prisma.webPage.findUnique({
+                where: { url },
+                select: {
+                    id: true,
+                    url: true,
+                },
+            });
+            if (!page) {
+                if ((0, logger_1.isDevelopment)()) {
+                    logger_1.logger.debug("[WebPageService] Page not found by URL", { url });
+                }
+                return null;
+            }
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.info("[WebPageService] Page found by URL", {
+                    id: page.id,
+                    url: page.url,
+                });
+            }
+            return {
+                id: page.id,
+                url: page.url,
+            };
+        }
+        catch (error) {
+            logger_1.logger.error("[WebPageService] Error finding page by URL", {
+                url,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
+    }
+    /**
+     * URLでWebPageを検索し、存在しなければ新規作成
+     *
+     * motion.detect URL modeでWebPageレコードを自動作成するために使用。
+     * HTMLコンテンツは後から更新可能（最小限のレコードのみ作成）。
+     *
+     * @param url - WebPageのURL
+     * @param options - 作成オプション
+     * @returns WebPage情報と作成フラグ
+     */
+    async findOrCreateByUrl(url, options) {
+        const sourceType = options?.sourceType ?? "user_provided";
+        const usageScope = options?.usageScope ?? "inspiration_only";
+        try {
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.info("[WebPageService] findOrCreateByUrl", { url, sourceType, usageScope });
+            }
+            // まず既存のレコードを検索
+            const existing = await this.findByUrl(url);
+            if (existing) {
+                if ((0, logger_1.isDevelopment)()) {
+                    logger_1.logger.info("[WebPageService] Using existing WebPage", {
+                        id: existing.id,
+                        url: existing.url,
+                    });
+                }
+                return {
+                    id: existing.id,
+                    url: existing.url,
+                    created: false,
+                };
+            }
+            // 存在しなければ新規作成（最小限の情報のみ）
+            const created = await database_1.prisma.webPage.create({
+                data: {
+                    url,
+                    sourceType,
+                    usageScope,
+                    // htmlContentは後から更新可能
+                    // titleは後から更新可能
+                },
+                select: {
+                    id: true,
+                    url: true,
+                },
+            });
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.info("[WebPageService] Created new WebPage", {
+                    id: created.id,
+                    url: created.url,
+                    sourceType,
+                    usageScope,
+                });
+            }
+            return {
+                id: created.id,
+                url: created.url,
+                created: true,
+            };
+        }
+        catch (error) {
+            logger_1.logger.error("[WebPageService] Error in findOrCreateByUrl", {
+                url,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
+    }
+}
+// =====================================================
+// シングルトンインスタンス
+// =====================================================
+/**
+ * WebPageServiceシングルトンインスタンス
+ */
+exports.webPageService = new WebPageService();
+// =====================================================
+// ファクトリー関数
+// =====================================================
+/**
+ * WebPageサービスファクトリー
+ * DIパターン用のファクトリー関数
+ */
+function createWebPageService() {
+    return exports.webPageService;
+}
+// =====================================================
+// 開発環境ログ
+// =====================================================
+if ((0, logger_1.isDevelopment)()) {
+    logger_1.logger.debug("[WebPageService] Module loaded");
+}
+//# sourceMappingURL=web-page.service.js.map

package/dist/services/web-page.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-page.service.js","sourceRoot":"","sources":["../../src/services/web-page.service.ts"],"names":[],"mappings":"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"}

package/dist/services/worker-constants.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Worker Constants - 共通定数定義
+ *
+ * ワーカー関連の複数サービスで共有される定数を一元管理する。
+ * 重複定義を排除し、値の不整合を防止する。
+ *
+ * 使用箇所:
+ * - queue-cleanup.service.ts: orphaned active job の completed/failed 判定
+ * - worker-stall-recovery.service.ts: orphaned job のカテゴリ分類
+ * - page-analyze-worker.ts: PHASE_PROGRESS.EMBEDDING_START
+ *
+ * @module services/worker-constants
+ */
+/**
+ * DB保存済みとみなすprogressの閾値（%）
+ *
+ * page-analyze-workerのPHASE_PROGRESSに基づく:
+ * - EMBEDDING_START: 90
+ * - EMBEDDING_COMPLETE: 100
+ * progress >= 90%ならLayout/Motion/QualityのDB保存は完了している可能性が高い
+ *
+ * 使用箇所:
+ * - queue-cleanup.service.ts: orphaned active job の completed/failed 判定（progress >= 90 → completed）
+ * - worker-stall-recovery.service.ts: orphaned job のカテゴリ分類（db_saved_but_stuck）
+ * - page-analyze-worker.ts: PHASE_PROGRESS.EMBEDDING_START
+ */
+export declare const DB_SAVED_PROGRESS_THRESHOLD = 90;
+/**
+ * Orphaned job判定のための追加マージン（ms）
+ *
+ * lockDuration + STALL_MARGIN_MS を超えたactive jobをorphanedとみなす。
+ * BullMQのstall detectionにはstalledInterval（通常lockDuration/4=10分）の遅延が
+ * あるため、十分なマージンを設ける。lockDuration=2400s (40分) に対して
+ * 4分のマージンでstalledInterval検出遅延を吸収する。
+ *
+ * 使用箇所:
+ * - worker-stall-recovery.service.ts: orphaned active job 判定
+ */
+export declare const STALL_MARGIN_MS = 240000;
+//# sourceMappingURL=worker-constants.d.ts.map

package/dist/services/worker-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-constants.d.ts","sourceRoot":"","sources":["../../src/services/worker-constants.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AAMH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAM9C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,SAAU,CAAC"}

package/dist/services/worker-constants.js

@@ -0,0 +1,51 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STALL_MARGIN_MS = exports.DB_SAVED_PROGRESS_THRESHOLD = void 0;
+/**
+ * Worker Constants - 共通定数定義
+ *
+ * ワーカー関連の複数サービスで共有される定数を一元管理する。
+ * 重複定義を排除し、値の不整合を防止する。
+ *
+ * 使用箇所:
+ * - queue-cleanup.service.ts: orphaned active job の completed/failed 判定
+ * - worker-stall-recovery.service.ts: orphaned job のカテゴリ分類
+ * - page-analyze-worker.ts: PHASE_PROGRESS.EMBEDDING_START
+ *
+ * @module services/worker-constants
+ */
+// ============================================================================
+// Progress Thresholds
+// ============================================================================
+/**
+ * DB保存済みとみなすprogressの閾値（%）
+ *
+ * page-analyze-workerのPHASE_PROGRESSに基づく:
+ * - EMBEDDING_START: 90
+ * - EMBEDDING_COMPLETE: 100
+ * progress >= 90%ならLayout/Motion/QualityのDB保存は完了している可能性が高い
+ *
+ * 使用箇所:
+ * - queue-cleanup.service.ts: orphaned active job の completed/failed 判定（progress >= 90 → completed）
+ * - worker-stall-recovery.service.ts: orphaned job のカテゴリ分類（db_saved_but_stuck）
+ * - page-analyze-worker.ts: PHASE_PROGRESS.EMBEDDING_START
+ */
+exports.DB_SAVED_PROGRESS_THRESHOLD = 90;
+// ============================================================================
+// Timing Constants
+// ============================================================================
+/**
+ * Orphaned job判定のための追加マージン（ms）
+ *
+ * lockDuration + STALL_MARGIN_MS を超えたactive jobをorphanedとみなす。
+ * BullMQのstall detectionにはstalledInterval（通常lockDuration/4=10分）の遅延が
+ * あるため、十分なマージンを設ける。lockDuration=2400s (40分) に対して
+ * 4分のマージンでstalledInterval検出遅延を吸収する。
+ *
+ * 使用箇所:
+ * - worker-stall-recovery.service.ts: orphaned active job 判定
+ */
+exports.STALL_MARGIN_MS = 240_000; // 4分のマージン
+//# sourceMappingURL=worker-constants.js.map

package/dist/services/worker-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-constants.js","sourceRoot":"","sources":["../../src/services/worker-constants.ts"],"names":[],"mappings":";AAAA,6DAA6D;AAC7D,yCAAyC;;;AAEzC;;;;;;;;;;;;GAYG;AAEH,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E;;;;;;;;;;;;GAYG;AACU,QAAA,2BAA2B,GAAG,EAAE,CAAC;AAE9C,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;;;;;;GAUG;AACU,QAAA,eAAe,GAAG,OAAO,CAAC,CAAC,UAAU"}

package/dist/services/worker-db-save.service.d.ts

@@ -0,0 +1,311 @@
+import { type QualityServiceResult, type JSAnimationFullResult } from "../tools/page/handlers/types";
+/**
+ * レイアウト分析結果からのセクション（defaultAnalyzeLayout戻り値）
+ */
+export interface LayoutSection {
+    id: string;
+    type: string;
+    positionIndex: number;
+    heading?: string;
+    confidence: number;
+    htmlSnippet?: string;
+    /** CSSスニペット（style/link/inline styles） / CSS snippet (style/link/inline styles) */
+    cssSnippet?: string;
+    /** 外部CSSコンテンツ / External CSS content */
+    externalCssContent?: string;
+    /** 外部CSSメタ情報 / External CSS metadata */
+    externalCssMeta?: {
+        fetchedCount: number;
+        failedCount: number;
+        totalSize: number;
+        urls: Array<{
+            url: string;
+            size?: number;
+            success?: boolean;
+        }>;
+        fetchedAt: string;
+    };
+    /** CSSフレームワーク / CSS framework (tailwind, bootstrap, etc.) */
+    cssFramework?: string;
+    /** CSSフレームワーク検出メタデータ / CSS framework detection metadata */
+    cssFrameworkMeta?: {
+        confidence: number;
+        evidence: string[];
+    };
+    position?: {
+        startY: number;
+        endY: number;
+        height: number;
+    };
+    visionFeatures?: unknown;
+    visualFeatures?: unknown;
+}
+/**
+ * モーション分析結果からのパターン（defaultDetectMotion戻り値）
+ * exactOptionalPropertyTypes対応: undefinedを明示
+ */
+export interface MotionPatternInput {
+    id?: string | undefined;
+    name: string;
+    type: string;
+    category: string;
+    trigger: string;
+    duration?: number | undefined;
+    easing?: string | undefined;
+    properties?: string[] | undefined;
+    propertiesDetailed?: Array<{
+        property: string;
+        from?: string;
+        to?: string;
+    }> | undefined;
+    rawCss?: string | undefined;
+    performance?: {
+        level?: string | undefined;
+        usesTransform?: boolean | undefined;
+        usesOpacity?: boolean | undefined;
+    } | undefined;
+    accessibility?: {
+        respectsReducedMotion?: boolean | undefined;
+    } | undefined;
+}
+/**
+ * 品質評価結果の入力型。
+ * QualityServiceResult を直接使用して型の二重定義を回避。
+ */
+export type QualityEvaluationInput = QualityServiceResult;
+/**
+ * 品質評価保存オプション
+ * exactOptionalPropertyTypes対応: undefinedを明示
+ */
+export interface QualityEvaluationSaveOptions {
+    strict?: boolean | undefined;
+    targetIndustry?: string | undefined;
+    targetAudience?: string | undefined;
+}
+/**
+ * Prismaクライアントインターフェース（QualityEvaluation保存用）
+ */
+export interface QualityEvaluationPrismaClient {
+    qualityEvaluation: {
+        deleteMany: (args: {
+            where: {
+                targetType: string;
+                targetId: string;
+            };
+        }) => Promise<{
+            count: number;
+        }>;
+        create: (args: {
+            data: Record<string, unknown>;
+        }) => Promise<{
+            id: string;
+        }>;
+    };
+}
+/**
+ * 品質ベンチマーク入力型
+ * quality_benchmarksテーブルへの保存用データ
+ * exactOptionalPropertyTypes対応: undefinedを明示
+ */
+export interface QualityBenchmarkInput {
+    /** セクションタイプ (hero, feature, cta, full_page 等) */
+    sectionType: string;
+    /** 総合スコア (0-100) */
+    overallScore: number;
+    /** グレード (A, B, C, D, F) */
+    grade: string;
+    /** 3軸スコア (JSON) */
+    axisScores: {
+        originality: number;
+        craftsmanship: number;
+        contextuality: number;
+    };
+    /** ソースURL */
+    sourceUrl: string;
+    /** ソースタイプ (page_analyze, award_gallery, user_provided, curated) */
+    sourceType: string;
+    /** セクションパターンID（セクション単位の場合） */
+    sectionPatternId?: string | undefined;
+    /** 特徴量リスト */
+    characteristics?: string[] | undefined;
+    /** HTMLスニペット */
+    htmlSnippet?: string | undefined;
+    /** プレビュー画像URL */
+    previewUrl?: string | undefined;
+    /** 業界 */
+    industry?: string | undefined;
+    /** ターゲットオーディエンス */
+    audience?: string | undefined;
+}
+/**
+ * Prismaクライアントインターフェース（QualityBenchmark保存用）
+ */
+export interface QualityBenchmarkPrismaClient {
+    qualityBenchmark: {
+        deleteMany: (args: {
+            where: {
+                webPageId: string;
+            };
+        }) => Promise<{
+            count: number;
+        }>;
+        createMany: (args: {
+            data: unknown[];
+        }) => Promise<{
+            count: number;
+        }>;
+    };
+}
+/**
+ * 保存結果
+ */
+export interface SaveResult {
+    success: boolean;
+    count: number;
+    ids: string[];
+    /** originalId → DB UUIDv7 のマッピング（Embedding生成で使用） */
+    idMapping: Map<string, string>;
+    error?: string | undefined;
+}
+/**
+ * Prismaクライアントインターフェース（SectionPattern保存用）
+ */
+export interface SectionPatternPrismaClient {
+    sectionPattern: {
+        deleteMany: (args: {
+            where: {
+                webPageId: string;
+            };
+        }) => Promise<{
+            count: number;
+        }>;
+        createMany: (args: {
+            data: unknown[];
+        }) => Promise<{
+            count: number;
+        }>;
+    };
+}
+/**
+ * Prismaクライアントインターフェース（MotionPattern保存用）
+ */
+export interface MotionPatternPrismaClient {
+    motionPattern: {
+        deleteMany: (args: {
+            where: {
+                webPageId: string;
+                type?: {
+                    not: string;
+                };
+            };
+        }) => Promise<{
+            count: number;
+        }>;
+        createMany: (args: {
+            data: unknown[];
+        }) => Promise<{
+            count: number;
+        }>;
+    };
+    $transaction: <T>(fn: (tx: Pick<MotionPatternPrismaClient, "motionPattern">) => Promise<T>) => Promise<T>;
+}
+/**
+ * Prismaクライアントインターフェース（JSAnimationPattern保存用）
+ */
+export interface JsAnimationPatternPrismaClient {
+    jSAnimationPattern: {
+        deleteMany: (args: {
+            where: {
+                webPageId: string;
+            };
+        }) => Promise<{
+            count: number;
+        }>;
+        createMany: (args: {
+            data: unknown[];
+        }) => Promise<{
+            count: number;
+        }>;
+    };
+    $transaction: <T>(fn: (tx: Pick<JsAnimationPatternPrismaClient, "jSAnimationPattern">) => Promise<T>) => Promise<T>;
+}
+/**
+ * SectionPatternをDBに保存
+ *
+ * @param prisma - Prismaクライアント
+ * @param webPageId - WebPage ID
+ * @param sections - レイアウト分析結果のセクション配列
+ * @param sourceUrl - 元URL
+ * @returns 保存結果
+ */
+export declare function saveSectionPatterns(prisma: SectionPatternPrismaClient, webPageId: string, sections: LayoutSection[]): Promise<SaveResult>;
+/**
+ * MotionPatternをDBに保存
+ *
+ * @param prisma - Prismaクライアント
+ * @param webPageId - WebPage ID
+ * @param patterns - モーション分析結果のパターン配列
+ * @param sourceUrl - 元URL
+ * @returns 保存結果
+ */
+export declare function saveMotionPatterns(prisma: MotionPatternPrismaClient, webPageId: string, patterns: MotionPatternInput[], sourceUrl: string): Promise<SaveResult>;
+/**
+ * QualityEvaluationをDBに保存
+ *
+ * @param prisma - Prismaクライアント
+ * @param webPageId - WebPage ID (targetId)
+ * @param qualityResult - 品質評価結果
+ * @param options - 評価時のオプション（strict, targetIndustry, targetAudience）
+ * @returns 保存結果
+ */
+export declare function saveQualityEvaluation(prisma: QualityEvaluationPrismaClient, webPageId: string, qualityResult: QualityEvaluationInput, options?: QualityEvaluationSaveOptions): Promise<SaveResult>;
+/**
+ * buildQualityBenchmarkInputs のオプション
+ * exactOptionalPropertyTypes対応: undefinedを明示
+ */
+export interface BuildQualityBenchmarkOptions {
+    targetIndustry?: string | undefined;
+    targetAudience?: string | undefined;
+}
+/**
+ * QualityServiceResult から QualityBenchmarkInput[] を生成
+ *
+ * ページ全体の品質評価結果をquality_benchmarksテーブル保存用の形式に変換する。
+ * success=false または overallScore=0 の場合は空配列を返す（保存スキップ）。
+ *
+ * @param qualityResult - 品質評価サービスの結果
+ * @param sourceUrl - 分析対象のURL
+ * @param options - 業界/オーディエンス等の追加オプション
+ * @returns QualityBenchmarkInput配列（通常1要素: full_page）
+ */
+export declare function buildQualityBenchmarkInputs(qualityResult: QualityServiceResult, sourceUrl: string, options?: BuildQualityBenchmarkOptions): QualityBenchmarkInput[];
+/**
+ * QualityBenchmarkをDBに保存
+ *
+ * ページ全体（web_page_id設定）とセクション単位（section_pattern_id設定）の
+ * 両方の品質評価結果をquality_benchmarksテーブルに保存する。
+ *
+ * パターン: クリーンスレート（deleteMany → createMany）
+ *
+ * @param prisma - Prismaクライアント
+ * @param webPageId - WebPage ID
+ * @param benchmarks - 品質ベンチマーク入力データ配列
+ * @returns 保存結果
+ */
+export declare function saveQualityBenchmarks(prisma: QualityBenchmarkPrismaClient, webPageId: string, benchmarks: QualityBenchmarkInput[]): Promise<SaveResult>;
+/**
+ * JSAnimationPatternをDBに保存
+ *
+ * motion.detect結果のjs_animations（CDPアニメーション + Web Animations API）を
+ * js_animation_patternsテーブルに保存する。
+ *
+ * パターン: クリーンスレート（deleteMany → createMany）
+ *
+ * @param prisma - Prismaクライアント
+ * @param webPageId - WebPage ID
+ * @param jsAnimations - JSアニメーション検出結果（JSAnimationFullResult）
+ * @param sourceUrl - 元URL
+ * @returns 保存結果
+ */
+export declare function saveJsAnimationPatterns(prisma: JsAnimationPatternPrismaClient, webPageId: string, jsAnimations: JSAnimationFullResult, sourceUrl: string): Promise<SaveResult>;
+//# sourceMappingURL=worker-db-save.service.d.ts.map

package/dist/services/worker-db-save.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-db-save.service.d.ts","sourceRoot":"","sources":["../../src/services/worker-db-save.service.ts"],"names":[],"mappings":"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"}