@reftrixmcp/mcp-server 0.1.7

package/dist/services/visual-extractor/visual-feature-merger.service.js

@@ -0,0 +1,482 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createVisualFeatureMerger = createVisualFeatureMerger;
+const logger_1 = require("../../utils/logger");
+// =============================================================================
+// Confidence Constants
+// =============================================================================
+/**
+ * Minimum confidence for deterministic results
+ */
+const DETERMINISTIC_CONFIDENCE_MIN = 0.9;
+/**
+ * Maximum confidence for deterministic results
+ */
+const DETERMINISTIC_CONFIDENCE_MAX = 1.0;
+/**
+ * Minimum confidence for Vision AI results
+ */
+const VISION_AI_CONFIDENCE_MIN = 0.6;
+/**
+ * Maximum confidence for Vision AI results
+ */
+const VISION_AI_CONFIDENCE_MAX = 0.8;
+/**
+ * Confidence threshold below which warnings are logged
+ */
+const LOW_CONFIDENCE_THRESHOLD = 0.5;
+/**
+ * Default fallback mood value
+ */
+const FALLBACK_MOOD = "neutral";
+/**
+ * Default fallback brand tone value
+ */
+const FALLBACK_BRAND_TONE = "neutral";
+/**
+ * Fallback confidence score (lower than normal Vision AI confidence)
+ */
+const FALLBACK_CONFIDENCE = 0.3;
+// =============================================================================
+// Service Implementation
+// =============================================================================
+/**
+ * Internal implementation of VisualFeatureMergerService
+ */
+class VisualFeatureMergerServiceImpl {
+    /**
+     * Merge deterministic extraction and Vision AI analysis results
+     */
+    async merge(deterministicInput, visionAIInput, options = {}) {
+        const { applyFallbacks = false, forceVisionUnavailable = false } = options;
+        const warnings = [];
+        // Validate that at least one input is provided
+        if (deterministicInput === null && visionAIInput === null) {
+            throw new Error("At least one input source must be provided");
+        }
+        // Determine availability
+        const deterministicAvailable = this.hasDeterministicData(deterministicInput);
+        const visionAiAvailable = forceVisionUnavailable ? false : this.hasVisionAIData(visionAIInput);
+        // Track partial deterministic extraction
+        if (deterministicInput !== null) {
+            const missingFields = [];
+            if (deterministicInput.colors === undefined)
+                missingFields.push("colors");
+            if (deterministicInput.theme === undefined)
+                missingFields.push("theme");
+            if (deterministicInput.density === undefined)
+                missingFields.push("density");
+            const availableCount = 3 - missingFields.length;
+            if (availableCount > 0 && availableCount < 3) {
+                warnings.push({
+                    code: "DETERMINISTIC_EXTRACTION_PARTIAL",
+                    message: `Only ${availableCount}/3 deterministic extraction fields available`,
+                    details: {
+                        hasColors: deterministicInput.colors !== undefined,
+                        hasTheme: deterministicInput.theme !== undefined,
+                        hasDensity: deterministicInput.density !== undefined,
+                        missingFields,
+                    },
+                });
+            }
+        }
+        // Add Vision AI unavailable warning if applicable
+        if (!visionAiAvailable && !forceVisionUnavailable && visionAIInput === null) {
+            warnings.push({
+                code: "VISION_AI_UNAVAILABLE",
+                message: "Vision AI analysis was not available. Mood and brandTone may use fallback values.",
+            });
+        }
+        // Merge each component
+        const colors = this.mergeColors(deterministicInput?.colors);
+        const theme = this.mergeTheme(deterministicInput?.theme);
+        const density = this.mergeDensity(deterministicInput?.density);
+        // Merge mood with fallback support
+        const moodResult = this.mergeMoodWithFallback(visionAIInput?.mood, applyFallbacks, warnings);
+        // Merge brandTone with fallback support
+        const brandToneResult = this.mergeBrandToneWithFallback(visionAIInput?.brandTone, applyFallbacks, warnings);
+        // Calculate overall confidence
+        const overallConfidence = this.calculateOverallConfidence(colors, theme, density, moodResult, brandToneResult, deterministicAvailable, visionAiAvailable);
+        // Calculate completeness score
+        const completeness = this.calculateCompleteness(colors, theme, density, moodResult, brandToneResult);
+        // Log warning for low overall confidence
+        if (overallConfidence < LOW_CONFIDENCE_THRESHOLD) {
+            const warningMsg = `Overall confidence is low (${overallConfidence.toFixed(2)})`;
+            warnings.push({
+                code: "LOW_CONFIDENCE",
+                message: warningMsg,
+                details: {
+                    overallConfidence,
+                    threshold: LOW_CONFIDENCE_THRESHOLD,
+                },
+            });
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.warn(`[VisualFeatureMerger] ${warningMsg}`, {
+                    overallConfidence,
+                    deterministicAvailable,
+                    visionAiAvailable,
+                });
+            }
+        }
+        // Build metadata
+        const metadata = {
+            mergedAt: new Date().toISOString(),
+            deterministicAvailable,
+            visionAiAvailable,
+            overallConfidence,
+            completeness,
+            warnings,
+        };
+        if ((0, logger_1.isDevelopment)()) {
+            logger_1.logger.info("[VisualFeatureMerger] Merge completed", {
+                deterministicAvailable,
+                visionAiAvailable,
+                overallConfidence: overallConfidence.toFixed(3),
+                completeness: completeness.toFixed(3),
+                hasColors: colors !== null,
+                hasTheme: theme !== null,
+                hasDensity: density !== null,
+                hasMood: moodResult !== null,
+                hasBrandTone: brandToneResult !== null,
+                moodSource: moodResult?.source,
+                brandToneSource: brandToneResult?.source,
+                warningCount: warnings.length,
+            });
+        }
+        return {
+            colors,
+            theme,
+            density,
+            mood: moodResult,
+            brandTone: brandToneResult,
+            metadata,
+        };
+    }
+    /**
+     * Check if deterministic input has any data
+     */
+    hasDeterministicData(input) {
+        if (input === null)
+            return false;
+        return input.colors !== undefined || input.theme !== undefined || input.density !== undefined;
+    }
+    /**
+     * Check if Vision AI input has any data
+     */
+    hasVisionAIData(input) {
+        if (input === null)
+            return false;
+        return input.mood !== undefined || input.brandTone !== undefined;
+    }
+    /**
+     * Merge color extraction result
+     */
+    mergeColors(colors) {
+        if (colors === undefined) {
+            return null;
+        }
+        return {
+            dominant: colors.dominantColors,
+            accent: colors.accentColors,
+            palette: colors.colorPalette.map((p) => ({
+                color: p.color,
+                percentage: p.percentage,
+            })),
+            source: "deterministic",
+            confidence: this.calculateDeterministicConfidence(),
+        };
+    }
+    /**
+     * Merge theme detection result
+     */
+    mergeTheme(theme) {
+        if (theme === undefined) {
+            return null;
+        }
+        return {
+            type: theme.theme,
+            backgroundColor: theme.backgroundColor,
+            textColor: theme.textColor,
+            contrastRatio: theme.contrastRatio,
+            source: "deterministic",
+            confidence: this.calculateDeterministicConfidence(theme.confidence),
+        };
+    }
+    /**
+     * Merge density calculation result
+     */
+    mergeDensity(density) {
+        if (density === undefined) {
+            return null;
+        }
+        return {
+            contentDensity: density.contentDensity,
+            whitespaceRatio: density.whitespaceRatio,
+            visualBalance: density.visualBalance,
+            source: "deterministic",
+            confidence: this.calculateDeterministicConfidence(),
+        };
+    }
+    /**
+     * Merge mood analysis result with fallback support
+     *
+     * If mood is undefined or has low confidence, apply fallback value.
+     */
+    mergeMoodWithFallback(mood, applyFallbacks, warnings) {
+        // Check if mood data is valid
+        const hasValidMood = mood !== undefined && mood.primaryMood !== undefined;
+        const hasLowConfidence = mood !== undefined && mood.confidence < LOW_CONFIDENCE_THRESHOLD;
+        // If valid mood, use it (even with low confidence, but add warning)
+        if (hasValidMood) {
+            // Add warning for low confidence
+            if (hasLowConfidence) {
+                warnings.push({
+                    code: "LOW_CONFIDENCE",
+                    message: `Mood analysis has low confidence (${mood.confidence.toFixed(2)})`,
+                    field: "mood",
+                    details: {
+                        confidence: mood.confidence,
+                        threshold: LOW_CONFIDENCE_THRESHOLD,
+                    },
+                });
+                if ((0, logger_1.isDevelopment)()) {
+                    logger_1.logger.warn(`[VisualFeatureMerger] Low confidence mood: ${mood.confidence.toFixed(2)}`, {
+                        primaryMood: mood.primaryMood,
+                        confidence: mood.confidence,
+                    });
+                }
+            }
+            return {
+                primary: mood.primaryMood,
+                secondary: mood.secondaryMood,
+                source: "vision-ai",
+                confidence: this.calculateVisionAIConfidence(mood.confidence),
+            };
+        }
+        // Apply fallback if enabled (only when no valid mood)
+        if (applyFallbacks) {
+            warnings.push({
+                code: "MOOD_FALLBACK_USED",
+                message: `Mood analysis empty. Using fallback value: ${FALLBACK_MOOD}`,
+                field: "mood",
+                details: {
+                    originalConfidence: mood?.confidence,
+                    fallbackValue: FALLBACK_MOOD,
+                },
+            });
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.warn(`[VisualFeatureMerger] Mood fallback used: empty result`, {
+                    fallbackValue: FALLBACK_MOOD,
+                });
+            }
+            return {
+                primary: FALLBACK_MOOD,
+                secondary: undefined,
+                source: "fallback",
+                confidence: FALLBACK_CONFIDENCE,
+            };
+        }
+        // No fallback, return null
+        return null;
+    }
+    /**
+     * Merge brand tone analysis result with fallback support
+     *
+     * If brandTone is undefined or has low confidence, apply fallback value.
+     */
+    mergeBrandToneWithFallback(brandTone, applyFallbacks, warnings) {
+        // Check if brandTone data is valid
+        const hasValidBrandTone = brandTone !== undefined && brandTone.primaryTone !== undefined;
+        const hasLowConfidence = brandTone !== undefined && brandTone.confidence < LOW_CONFIDENCE_THRESHOLD;
+        // If valid brandTone, use it (even with low confidence, but add warning)
+        if (hasValidBrandTone) {
+            // Add warning for low confidence
+            if (hasLowConfidence) {
+                warnings.push({
+                    code: "LOW_CONFIDENCE",
+                    message: `Brand tone analysis has low confidence (${brandTone.confidence.toFixed(2)})`,
+                    field: "brandTone",
+                    details: {
+                        confidence: brandTone.confidence,
+                        threshold: LOW_CONFIDENCE_THRESHOLD,
+                    },
+                });
+                if ((0, logger_1.isDevelopment)()) {
+                    logger_1.logger.warn(`[VisualFeatureMerger] Low confidence brandTone: ${brandTone.confidence.toFixed(2)}`, {
+                        primaryTone: brandTone.primaryTone,
+                        confidence: brandTone.confidence,
+                    });
+                }
+            }
+            return {
+                primary: brandTone.primaryTone,
+                secondary: brandTone.secondaryTone,
+                source: "vision-ai",
+                confidence: this.calculateVisionAIConfidence(brandTone.confidence),
+            };
+        }
+        // Apply fallback if enabled (only when no valid brandTone)
+        if (applyFallbacks) {
+            warnings.push({
+                code: "BRAND_TONE_FALLBACK_USED",
+                message: `Brand tone analysis empty. Using fallback value: ${FALLBACK_BRAND_TONE}`,
+                field: "brandTone",
+                details: {
+                    originalConfidence: brandTone?.confidence,
+                    fallbackValue: FALLBACK_BRAND_TONE,
+                },
+            });
+            if ((0, logger_1.isDevelopment)()) {
+                logger_1.logger.warn(`[VisualFeatureMerger] BrandTone fallback used: empty result`, {
+                    fallbackValue: FALLBACK_BRAND_TONE,
+                });
+            }
+            return {
+                primary: FALLBACK_BRAND_TONE,
+                secondary: undefined,
+                source: "fallback",
+                confidence: FALLBACK_CONFIDENCE,
+            };
+        }
+        // No fallback, return null
+        return null;
+    }
+    /**
+     * Calculate confidence for deterministic results (0.9-1.0)
+     *
+     * Uses the source confidence as a base and maps it to the deterministic range.
+     */
+    calculateDeterministicConfidence(sourceConfidence) {
+        if (sourceConfidence === undefined) {
+            // Default to high confidence for deterministic results
+            return 0.95;
+        }
+        // Map source confidence (0-1) to deterministic range (0.9-1.0)
+        const range = DETERMINISTIC_CONFIDENCE_MAX - DETERMINISTIC_CONFIDENCE_MIN;
+        return DETERMINISTIC_CONFIDENCE_MIN + sourceConfidence * range;
+    }
+    /**
+     * Calculate confidence for Vision AI results (0.6-0.8)
+     *
+     * Clamps the source confidence to the Vision AI confidence range.
+     */
+    calculateVisionAIConfidence(sourceConfidence) {
+        // Map source confidence (0-1) to Vision AI range (0.6-0.8)
+        const range = VISION_AI_CONFIDENCE_MAX - VISION_AI_CONFIDENCE_MIN;
+        const mappedConfidence = VISION_AI_CONFIDENCE_MIN + sourceConfidence * range;
+        // Clamp to the valid range
+        return Math.max(VISION_AI_CONFIDENCE_MIN, Math.min(VISION_AI_CONFIDENCE_MAX, mappedConfidence));
+    }
+    /**
+     * Calculate overall confidence based on available components
+     */
+    calculateOverallConfidence(colors, theme, density, mood, brandTone, deterministicAvailable, visionAiAvailable) {
+        const confidences = [];
+        const weights = [];
+        // Deterministic components have higher weight
+        if (colors !== null) {
+            confidences.push(colors.confidence);
+            weights.push(1.2); // Higher weight for deterministic
+        }
+        if (theme !== null) {
+            confidences.push(theme.confidence);
+            weights.push(1.2);
+        }
+        if (density !== null) {
+            confidences.push(density.confidence);
+            weights.push(1.2);
+        }
+        // Vision AI components have standard weight
+        // Fallback sources get reduced weight
+        if (mood !== null) {
+            const weight = mood.source === "fallback" ? 0.5 : 1.0;
+            confidences.push(mood.confidence);
+            weights.push(weight);
+        }
+        if (brandTone !== null) {
+            const weight = brandTone.source === "fallback" ? 0.5 : 1.0;
+            confidences.push(brandTone.confidence);
+            weights.push(weight);
+        }
+        if (confidences.length === 0) {
+            return 0;
+        }
+        // Weighted average
+        let totalWeight = 0;
+        let weightedSum = 0;
+        for (let i = 0; i < confidences.length; i++) {
+            weightedSum += confidences[i] * weights[i];
+            totalWeight += weights[i];
+        }
+        let overallConfidence = weightedSum / totalWeight;
+        // Apply penalty if only one source is available
+        if (!deterministicAvailable || !visionAiAvailable) {
+            overallConfidence *= 0.9; // 10% penalty for partial data
+        }
+        return Math.min(1.0, overallConfidence);
+    }
+    /**
+     * Calculate completeness score based on available fields
+     *
+     * Required fields: colors, theme, density, mood, brandTone
+     * - Valid data = 1.0 for that field
+     * - Fallback data = 0.5 for that field
+     * - Null/missing = 0.0 for that field
+     *
+     * @returns Completeness score (0-1)
+     */
+    calculateCompleteness(colors, theme, density, mood, brandTone) {
+        const TOTAL_FIELDS = 5;
+        let score = 0;
+        // Deterministic fields (full score if present)
+        if (colors !== null)
+            score += 1.0;
+        if (theme !== null)
+            score += 1.0;
+        if (density !== null)
+            score += 1.0;
+        // Vision AI fields (reduced score for fallback)
+        if (mood !== null) {
+            score += mood.source === "fallback" ? 0.5 : 1.0;
+        }
+        if (brandTone !== null) {
+            score += brandTone.source === "fallback" ? 0.5 : 1.0;
+        }
+        return score / TOTAL_FIELDS;
+    }
+}
+// =============================================================================
+// Factory Function
+// =============================================================================
+/**
+ * Create a new VisualFeatureMergerService instance
+ *
+ * @returns VisualFeatureMergerService instance
+ *
+ * @example
+ * ```typescript
+ * const merger = createVisualFeatureMerger();
+ *
+ * // With Vision AI data
+ * const result = await merger.merge(
+ *   { colors, theme, density },
+ *   { mood, brandTone }
+ * );
+ *
+ * // Without Vision AI data (uses fallbacks)
+ * const resultWithFallbacks = await merger.merge(
+ *   { colors, theme, density },
+ *   null
+ * );
+ *
+ * // Check completeness
+ * console.log(result.metadata.completeness); // 0.85
+ * console.log(result.metadata.warnings); // []
+ * ```
+ */
+function createVisualFeatureMerger() {
+    return new VisualFeatureMergerServiceImpl();
+}
+//# sourceMappingURL=visual-feature-merger.service.js.map

package/dist/services/visual-extractor/visual-feature-merger.service.js.map

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

package/dist/services/web-page.service.d.ts

@@ -0,0 +1,80 @@
+/**
+ * WebPage取得結果（motion.detect互換）
+ */
+export interface WebPageResult {
+    id: string;
+    htmlContent: string;
+    cssContent?: string;
+}
+/**
+ * WebPage基本情報（URL検索用）
+ */
+export interface WebPageMinimal {
+    id: string;
+    url: string;
+}
+/**
+ * findOrCreateByUrl結果
+ */
+export interface FindOrCreateResult {
+    id: string;
+    url: string;
+    /** trueなら新規作成、falseなら既存レコードを使用 */
+    created: boolean;
+}
+/**
+ * WebPageサービスインターフェース
+ */
+export interface IWebPageService {
+    getPageById(id: string): Promise<WebPageResult | null>;
+    findByUrl(url: string): Promise<WebPageMinimal | null>;
+    findOrCreateByUrl(url: string, options?: {
+        sourceType?: string;
+        usageScope?: string;
+    }): Promise<FindOrCreateResult>;
+}
+/**
+ * WebPageサービス
+ * Prismaを使用してWebPageテーブルにアクセス
+ */
+declare class WebPageService implements IWebPageService {
+    /**
+     * IDでWebPageを取得
+     *
+     * @param id - WebPage UUID
+     * @returns WebPage情報（htmlContent含む）またはnull
+     */
+    getPageById(id: string): Promise<WebPageResult | null>;
+    /**
+     * URLでWebPageを検索
+     *
+     * @param url - 検索するURL（完全一致）
+     * @returns WebPage基本情報またはnull
+     */
+    findByUrl(url: string): Promise<WebPageMinimal | null>;
+    /**
+     * URLでWebPageを検索し、存在しなければ新規作成
+     *
+     * motion.detect URL modeでWebPageレコードを自動作成するために使用。
+     * HTMLコンテンツは後から更新可能（最小限のレコードのみ作成）。
+     *
+     * @param url - WebPageのURL
+     * @param options - 作成オプション
+     * @returns WebPage情報と作成フラグ
+     */
+    findOrCreateByUrl(url: string, options?: {
+        sourceType?: string;
+        usageScope?: string;
+    }): Promise<FindOrCreateResult>;
+}
+/**
+ * WebPageServiceシングルトンインスタンス
+ */
+export declare const webPageService: WebPageService;
+/**
+ * WebPageサービスファクトリー
+ * DIパターン用のファクトリー関数
+ */
+export declare function createWebPageService(): IWebPageService;
+export {};
+//# sourceMappingURL=web-page.service.d.ts.map

package/dist/services/web-page.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-page.service.d.ts","sourceRoot":"","sources":["../../src/services/web-page.service.ts"],"names":[],"mappings":"AAmBA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IACvD,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACvD,iBAAiB,CACf,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GACrD,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAChC;AAMD;;;GAGG;AACH,cAAM,cAAe,YAAW,eAAe;IAC7C;;;;;OAKG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAkD5D;;;;;OAKG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAyC5D;;;;;;;;;OASG;IACG,iBAAiB,CACrB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GACrD,OAAO,CAAC,kBAAkB,CAAC;CA8D/B;AAMD;;GAEG;AACH,eAAO,MAAM,cAAc,gBAAuB,CAAC;AAMnD;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,eAAe,CAEtD"}