@reftrixmcp/mcp-server 0.1.7

package/dist/services/vision/vision.errors.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Vision Analysis Error Types
+ *
+ * Phase 5 REFACTOR: Vision AI分析サービスのエラー型を統一
+ *
+ * エラーコード:
+ * - OLLAMA_UNAVAILABLE: Ollamaサービスに接続できない
+ * - TIMEOUT: リクエストがタイムアウト
+ * - INVALID_RESPONSE: レスポンスが無効（JSONパースエラー等）
+ * - VALIDATION_FAILED: Zodバリデーションエラー
+ * - INPUT_VALIDATION: 入力バリデーションエラー（Base64不正、サイズ超過等）
+ * - CACHE_ERROR: キャッシュ操作エラー
+ *
+ * 参照:
+ * - apps/mcp-server/src/services/vision/mood.analyzer.ts
+ * - apps/mcp-server/src/services/vision/brandtone.analyzer.ts
+ * - apps/mcp-server/src/services/vision/ollama-vision-client.ts
+ */
+/**
+ * Vision分析エラーコード
+ */
+export type VisionErrorCode = "OLLAMA_UNAVAILABLE" | "TIMEOUT" | "INVALID_RESPONSE" | "VALIDATION_FAILED" | "INPUT_VALIDATION" | "CACHE_ERROR";
+/**
+ * Vision分析処理の標準エラー
+ *
+ * @example
+ * ```typescript
+ * throw new VisionAnalysisError(
+ *   'Ollama service is unavailable',
+ *   'OLLAMA_UNAVAILABLE',
+ *   true // リトライ可能
+ * );
+ * ```
+ */
+export declare class VisionAnalysisError extends Error {
+    /**
+     * エラーコード
+     */
+    readonly code: VisionErrorCode;
+    /**
+     * リトライ可能かどうか
+     *
+     * true: 一時的なエラー（タイムアウト、接続エラー）
+     * false: 永続的なエラー（バリデーションエラー、無効なレスポンス）
+     */
+    readonly isRetryable: boolean;
+    /**
+     * 追加のコンテキスト情報
+     */
+    readonly context: Record<string, unknown> | undefined;
+    /**
+     * VisionAnalysisErrorのコンストラクタ
+     *
+     * @param message - エラーメッセージ
+     * @param code - エラーコード
+     * @param isRetryable - リトライ可能かどうか（デフォルト: false）
+     * @param context - 追加のコンテキスト情報
+     */
+    constructor(message: string, code: VisionErrorCode, isRetryable?: boolean, context?: Record<string, unknown>);
+    /**
+     * エラーをJSON形式で出力
+     */
+    toJSON(): {
+        name: string;
+        message: string;
+        code: VisionErrorCode;
+        isRetryable: boolean;
+        context: Record<string, unknown> | undefined;
+        stack: string | undefined;
+    };
+}
+/**
+ * キャッシュ操作エラー
+ */
+export declare class CacheError extends Error {
+    /**
+     * エラーコード
+     */
+    readonly code: "CACHE_ERROR";
+    /**
+     * 操作種別
+     */
+    readonly operation: "get" | "set" | "delete" | "clear";
+    /**
+     * CacheErrorのコンストラクタ
+     *
+     * @param message - エラーメッセージ
+     * @param operation - 操作種別
+     */
+    constructor(message: string, operation: "get" | "set" | "delete" | "clear");
+}
+/**
+ * VisionAnalysisError かどうかをチェック
+ */
+export declare function isVisionAnalysisError(error: unknown): error is VisionAnalysisError;
+/**
+ * リトライ可能なエラーかどうかをチェック
+ */
+export declare function isRetryableError(error: unknown): boolean;
+/**
+ * エラーコードからメッセージを生成
+ */
+export declare function getErrorMessage(code: VisionErrorCode): string;
+//# sourceMappingURL=vision.errors.d.ts.map

package/dist/services/vision/vision.errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision.errors.d.ts","sourceRoot":"","sources":["../../../src/services/vision/vision.errors.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;GAiBG;AAMH;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,oBAAoB,GACpB,SAAS,GACT,kBAAkB,GAClB,mBAAmB,GACnB,kBAAkB,GAClB,aAAa,CAAC;AAMlB;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAE/B;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAEtD;;;;;;;OAOG;gBAED,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,eAAe,EACrB,WAAW,GAAE,OAAe,EAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAYnC;;OAEG;IACH,MAAM,IAAI;QACR,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,eAAe,CAAC;QACtB,WAAW,EAAE,OAAO,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;QAC7C,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;KAC3B;CAUF;AAMD;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAG,aAAa,CAAU;IAEvC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IAEvD;;;;;OAKG;gBACS,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO;CAO3E;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAElF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKxD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAU7D"}

package/dist/services/vision/vision.errors.js

@@ -0,0 +1,133 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheError = exports.VisionAnalysisError = void 0;
+exports.isVisionAnalysisError = isVisionAnalysisError;
+exports.isRetryableError = isRetryableError;
+exports.getErrorMessage = getErrorMessage;
+// =============================================================================
+// VisionAnalysisError クラス
+// =============================================================================
+/**
+ * Vision分析処理の標準エラー
+ *
+ * @example
+ * ```typescript
+ * throw new VisionAnalysisError(
+ *   'Ollama service is unavailable',
+ *   'OLLAMA_UNAVAILABLE',
+ *   true // リトライ可能
+ * );
+ * ```
+ */
+class VisionAnalysisError extends Error {
+    /**
+     * エラーコード
+     */
+    code;
+    /**
+     * リトライ可能かどうか
+     *
+     * true: 一時的なエラー（タイムアウト、接続エラー）
+     * false: 永続的なエラー（バリデーションエラー、無効なレスポンス）
+     */
+    isRetryable;
+    /**
+     * 追加のコンテキスト情報
+     */
+    context;
+    /**
+     * VisionAnalysisErrorのコンストラクタ
+     *
+     * @param message - エラーメッセージ
+     * @param code - エラーコード
+     * @param isRetryable - リトライ可能かどうか（デフォルト: false）
+     * @param context - 追加のコンテキスト情報
+     */
+    constructor(message, code, isRetryable = false, context) {
+        super(message);
+        this.name = "VisionAnalysisError";
+        this.code = code;
+        this.isRetryable = isRetryable;
+        this.context = context;
+        // ES5互換性のためにprototypeを設定
+        Object.setPrototypeOf(this, VisionAnalysisError.prototype);
+    }
+    /**
+     * エラーをJSON形式で出力
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            isRetryable: this.isRetryable,
+            context: this.context,
+            stack: this.stack,
+        };
+    }
+}
+exports.VisionAnalysisError = VisionAnalysisError;
+// =============================================================================
+// CacheError クラス
+// =============================================================================
+/**
+ * キャッシュ操作エラー
+ */
+class CacheError extends Error {
+    /**
+     * エラーコード
+     */
+    code = "CACHE_ERROR";
+    /**
+     * 操作種別
+     */
+    operation;
+    /**
+     * CacheErrorのコンストラクタ
+     *
+     * @param message - エラーメッセージ
+     * @param operation - 操作種別
+     */
+    constructor(message, operation) {
+        super(message);
+        this.name = "CacheError";
+        this.operation = operation;
+        Object.setPrototypeOf(this, CacheError.prototype);
+    }
+}
+exports.CacheError = CacheError;
+// =============================================================================
+// ユーティリティ関数
+// =============================================================================
+/**
+ * VisionAnalysisError かどうかをチェック
+ */
+function isVisionAnalysisError(error) {
+    return error instanceof VisionAnalysisError;
+}
+/**
+ * リトライ可能なエラーかどうかをチェック
+ */
+function isRetryableError(error) {
+    if (isVisionAnalysisError(error)) {
+        return error.isRetryable;
+    }
+    return false;
+}
+/**
+ * エラーコードからメッセージを生成
+ */
+function getErrorMessage(code) {
+    const messages = {
+        OLLAMA_UNAVAILABLE: "Ollama service is not available",
+        TIMEOUT: "Request timed out",
+        INVALID_RESPONSE: "Invalid response from Ollama",
+        VALIDATION_FAILED: "Response validation failed",
+        INPUT_VALIDATION: "Input validation failed",
+        CACHE_ERROR: "Cache operation failed",
+    };
+    return messages[code];
+}
+//# sourceMappingURL=vision.errors.js.map

package/dist/services/vision/vision.errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision.errors.js","sourceRoot":"","sources":["../../../src/services/vision/vision.errors.ts"],"names":[],"mappings":";AAAA,6DAA6D;AAC7D,yCAAyC;;;AA6JzC,sDAEC;AAKD,4CAKC;AAKD,0CAUC;AApJD,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF;;;;;;;;;;;GAWG;AACH,MAAa,mBAAoB,SAAQ,KAAK;IAC5C;;OAEG;IACM,IAAI,CAAkB;IAE/B;;;;;OAKG;IACM,WAAW,CAAU;IAE9B;;OAEG;IACM,OAAO,CAAsC;IAEtD;;;;;;;OAOG;IACH,YACE,OAAe,EACf,IAAqB,EACrB,cAAuB,KAAK,EAC5B,OAAiC;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,yBAAyB;QACzB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,MAAM;QAQJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;CACF;AA/DD,kDA+DC;AAED,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF;;GAEG;AACH,MAAa,UAAW,SAAQ,KAAK;IACnC;;OAEG;IACM,IAAI,GAAG,aAAsB,CAAC;IAEvC;;OAEG;IACM,SAAS,CAAqC;IAEvD;;;;;OAKG;IACH,YAAY,OAAe,EAAE,SAA6C;QACxE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAE3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAxBD,gCAwBC;AAED,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF;;GAEG;AACH,SAAgB,qBAAqB,CAAC,KAAc;IAClD,OAAO,KAAK,YAAY,mBAAmB,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,KAAc;IAC7C,IAAI,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC,WAAW,CAAC;IAC3B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,IAAqB;IACnD,MAAM,QAAQ,GAAoC;QAChD,kBAAkB,EAAE,iCAAiC;QACrD,OAAO,EAAE,mBAAmB;QAC5B,gBAAgB,EAAE,8BAA8B;QAChD,iBAAiB,EAAE,4BAA4B;QAC/C,gBAAgB,EAAE,yBAAyB;QAC3C,WAAW,EAAE,wBAAwB;KACtC,CAAC;IACF,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}

package/dist/services/vision/vision.prompts.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Valid theme types for analysis
+ */
+export declare const VALID_THEMES: readonly ["light", "dark", "mixed"];
+export type ThemeType = (typeof VALID_THEMES)[number];
+/**
+ * カラーコンテキスト（プロンプト生成用）
+ */
+export interface ColorContextForPrompt {
+    dominantColors: string[];
+    theme: "light" | "dark";
+    contentDensity: number;
+}
+/**
+ * Mood分析のベースプロンプト
+ */
+export declare function getMoodAnalysisPrompt(): string;
+/**
+ * カラーコンテキスト付きMood分析プロンプト
+ */
+export declare function getMoodAnalysisWithContextPrompt(colorContext: ColorContextForPrompt): string;
+/**
+ * BrandTone分析のベースプロンプト
+ */
+export declare function getBrandToneAnalysisPrompt(): string;
+/**
+ * カラーコンテキスト付きBrandTone分析プロンプト
+ */
+export declare function getBrandToneAnalysisWithContextPrompt(colorContext: ColorContextForPrompt): string;
+/**
+ * Theme分析のベースプロンプト
+ *
+ * 問題背景:
+ * - E&A Financial (#0A1628 ダークブルー) が "Light/Mixed" と誤認識された
+ * - 原因: テーマ判定基準が曖昧だった
+ *
+ * 解決策:
+ * - 明確な輝度閾値を指定（DARK < 30%, LIGHT > 70%）
+ * - 背景色のHEXコードを要求
+ * - JSON形式で構造化された出力
+ */
+export declare function getThemeAnalysisPrompt(): string;
+/**
+ * カラーコンテキスト付きTheme分析プロンプト
+ */
+export declare function getThemeAnalysisWithContextPrompt(colorContext: ColorContextForPrompt): string;
+//# sourceMappingURL=vision.prompts.d.ts.map

package/dist/services/vision/vision.prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision.prompts.d.ts","sourceRoot":"","sources":["../../../src/services/vision/vision.prompts.ts"],"names":[],"mappings":"AAiCA;;GAEG;AACH,eAAO,MAAM,YAAY,qCAAsC,CAAC;AAChE,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAMtD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;CACxB;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAoB9C;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,YAAY,EAAE,qBAAqB,GAAG,MAAM,CAyB5F;AAMD;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAgCnD;AAED;;GAEG;AACH,wBAAgB,qCAAqC,CAAC,YAAY,EAAE,qBAAqB,GAAG,MAAM,CAqCjG;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAuC/C;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,YAAY,EAAE,qBAAqB,GAAG,MAAM,CA2C7F"}

package/dist/services/vision/vision.prompts.js

@@ -0,0 +1,272 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VALID_THEMES = void 0;
+exports.getMoodAnalysisPrompt = getMoodAnalysisPrompt;
+exports.getMoodAnalysisWithContextPrompt = getMoodAnalysisWithContextPrompt;
+exports.getBrandToneAnalysisPrompt = getBrandToneAnalysisPrompt;
+exports.getBrandToneAnalysisWithContextPrompt = getBrandToneAnalysisWithContextPrompt;
+exports.getThemeAnalysisPrompt = getThemeAnalysisPrompt;
+exports.getThemeAnalysisWithContextPrompt = getThemeAnalysisWithContextPrompt;
+/**
+ * Vision AI Prompts - Ollama Vision APIのプロンプトテンプレート
+ *
+ * Phase 5 REFACTOR: MoodAnalyzerとBrandToneAnalyzerのプロンプトを統合管理
+ *
+ * プロンプト設計原則:
+ * 1. 有効な値をリストアップして選択を制限
+ * 2. JSONフォーマットを明示（構造を示す）
+ * 3. 必須フィールドとオプショナルフィールドを区別
+ * 4. confidenceスコアの基準を明確化
+ *
+ * 参照:
+ * - apps/mcp-server/src/services/vision/mood.analyzer.ts
+ * - apps/mcp-server/src/services/vision/brandtone.analyzer.ts
+ */
+const mood_analyzer_js_1 = require("./mood.analyzer.js");
+const brandtone_analyzer_js_1 = require("./brandtone.analyzer.js");
+// =============================================================================
+// Theme Analysis Types
+// =============================================================================
+/**
+ * Valid theme types for analysis
+ */
+exports.VALID_THEMES = ["light", "dark", "mixed"];
+// =============================================================================
+// Mood分析プロンプト
+// =============================================================================
+/**
+ * Mood分析のベースプロンプト
+ */
+function getMoodAnalysisPrompt() {
+    return `Analyze this screenshot and identify the mood/atmosphere.
+
+Valid moods: ${mood_analyzer_js_1.VALID_MOODS.join(", ")}.
+
+Return JSON:
+{
+  "primaryMood": "<mood>",
+  "secondaryMood": "<mood>",
+  "confidence": <0.0-1.0>,
+  "indicators": ["<indicator1>", "<indicator2>"],
+  "colorContextUsed": false
+}
+
+Guidelines:
+- primaryMood: The dominant mood/atmosphere (REQUIRED)
+- secondaryMood: A secondary mood if present (OPTIONAL)
+- confidence: How confident you are in this analysis (0.6-1.0 for valid results)
+- indicators: Visual elements that support your analysis (2-5 items)
+- colorContextUsed: Set to false for this prompt`;
+}
+/**
+ * カラーコンテキスト付きMood分析プロンプト
+ */
+function getMoodAnalysisWithContextPrompt(colorContext) {
+    return `Analyze this screenshot and identify the mood/atmosphere.
+Consider the following color context:
+- Dominant colors: ${colorContext.dominantColors.join(", ")}
+- Theme: ${colorContext.theme}
+- Content density: ${colorContext.contentDensity}
+
+Valid moods: ${mood_analyzer_js_1.VALID_MOODS.join(", ")}.
+
+Return JSON:
+{
+  "primaryMood": "<mood>",
+  "secondaryMood": "<mood>",
+  "confidence": <0.0-1.0>,
+  "indicators": ["<indicator1>", "<indicator2>"],
+  "colorContextUsed": true
+}
+
+Guidelines:
+- Use the color context to inform your mood analysis
+- primaryMood: The dominant mood/atmosphere (REQUIRED)
+- secondaryMood: A secondary mood if present (OPTIONAL)
+- confidence: How confident you are in this analysis (0.6-1.0 for valid results)
+- indicators: Visual elements that support your analysis (2-5 items)
+- colorContextUsed: Set to true as color context was provided`;
+}
+// =============================================================================
+// BrandTone分析プロンプト
+// =============================================================================
+/**
+ * BrandTone分析のベースプロンプト
+ */
+function getBrandToneAnalysisPrompt() {
+    return `Analyze this screenshot and identify the brand tone/atmosphere.
+
+Valid brand tones: ${brandtone_analyzer_js_1.VALID_BRAND_TONES.join(", ")}.
+Professionalism levels: ${brandtone_analyzer_js_1.PROFESSIONALISM_LEVELS.join(", ")}.
+Warmth levels: ${brandtone_analyzer_js_1.WARMTH_LEVELS.join(", ")}.
+Modernity levels: ${brandtone_analyzer_js_1.MODERNITY_LEVELS.join(", ")}.
+Energy levels: ${brandtone_analyzer_js_1.ENERGY_LEVELS.join(", ")}.
+Target audiences: ${brandtone_analyzer_js_1.TARGET_AUDIENCES.join(", ")}.
+
+Return JSON:
+{
+  "primaryTone": "<tone>",
+  "secondaryTone": "<tone>",
+  "confidence": <0.0-1.0>,
+  "professionalism": "<level>",
+  "warmth": "<level>",
+  "modernity": "<level>",
+  "energy": "<level>",
+  "targetAudience": "<audience>",
+  "indicators": ["<indicator1>", "<indicator2>"],
+  "colorContextUsed": false
+}
+
+Guidelines:
+- primaryTone: The dominant brand tone (REQUIRED)
+- secondaryTone: A secondary brand tone if present (OPTIONAL)
+- confidence: How confident you are in this analysis (0.6-1.0 for valid results)
+- professionalism/warmth/modernity/energy: Evaluate each attribute
+- targetAudience: Who this design is targeting
+- indicators: Visual elements that support your analysis (2-5 items)
+- colorContextUsed: Set to false for this prompt`;
+}
+/**
+ * カラーコンテキスト付きBrandTone分析プロンプト
+ */
+function getBrandToneAnalysisWithContextPrompt(colorContext) {
+    return `Analyze this screenshot and identify the brand tone/atmosphere.
+Consider the following color context:
+- Dominant colors: ${colorContext.dominantColors.join(", ")}
+- Theme: ${colorContext.theme}
+- Content density: ${colorContext.contentDensity}
+
+Valid brand tones: ${brandtone_analyzer_js_1.VALID_BRAND_TONES.join(", ")}.
+Professionalism levels: ${brandtone_analyzer_js_1.PROFESSIONALISM_LEVELS.join(", ")}.
+Warmth levels: ${brandtone_analyzer_js_1.WARMTH_LEVELS.join(", ")}.
+Modernity levels: ${brandtone_analyzer_js_1.MODERNITY_LEVELS.join(", ")}.
+Energy levels: ${brandtone_analyzer_js_1.ENERGY_LEVELS.join(", ")}.
+Target audiences: ${brandtone_analyzer_js_1.TARGET_AUDIENCES.join(", ")}.
+
+Return JSON:
+{
+  "primaryTone": "<tone>",
+  "secondaryTone": "<tone>",
+  "confidence": <0.0-1.0>,
+  "professionalism": "<level>",
+  "warmth": "<level>",
+  "modernity": "<level>",
+  "energy": "<level>",
+  "targetAudience": "<audience>",
+  "indicators": ["<indicator1>", "<indicator2>"],
+  "colorContextUsed": true
+}
+
+Guidelines:
+- Use the color context to inform your brand tone analysis
+- primaryTone: The dominant brand tone (REQUIRED)
+- secondaryTone: A secondary brand tone if present (OPTIONAL)
+- confidence: How confident you are in this analysis (0.6-1.0 for valid results)
+- professionalism/warmth/modernity/energy: Evaluate each attribute
+- targetAudience: Who this design is targeting
+- indicators: Visual elements that support your analysis (2-5 items)
+- colorContextUsed: Set to true as color context was provided`;
+}
+// =============================================================================
+// Theme分析プロンプト
+// =============================================================================
+/**
+ * Theme分析のベースプロンプト
+ *
+ * 問題背景:
+ * - E&A Financial (#0A1628 ダークブルー) が "Light/Mixed" と誤認識された
+ * - 原因: テーマ判定基準が曖昧だった
+ *
+ * 解決策:
+ * - 明確な輝度閾値を指定（DARK < 30%, LIGHT > 70%）
+ * - 背景色のHEXコードを要求
+ * - JSON形式で構造化された出力
+ */
+function getThemeAnalysisPrompt() {
+    const validThemes = exports.VALID_THEMES.join(", ");
+    return `Analyze this web page screenshot and determine the visual theme.
+
+**Theme Detection (CRITICAL - Follow these rules strictly):**
+
+1. Examine the BACKGROUND COLOR of the main content area (not just the header/footer)
+2. Determine if the overall theme is DARK, LIGHT, or MIXED using these criteria:
+
+   - DARK Theme: Background luminance < 30% (e.g., #0A1628, #1A1A2E, #000000)
+     Examples: Dark navy, black, deep purple backgrounds
+
+   - LIGHT Theme: Background luminance > 70% (e.g., #FFFFFF, #F5F5F5, #FAFAFA)
+     Examples: White, off-white, light gray backgrounds
+
+   - MIXED Theme: 30% <= luminance <= 70% OR page has distinct dark AND light sections
+
+3. Extract the PRIMARY BACKGROUND COLOR in HEX format (#RRGGBB)
+
+Valid themes: ${validThemes}.
+
+Return JSON:
+{
+  "theme": "<theme>",
+  "themeConfidence": <0.0-1.0>,
+  "primaryBackgroundColor": "#RRGGBB",
+  "visualFeatures": ["<feature1>", "<feature2>"],
+  "reasoning": "<brief explanation of why this theme was detected>"
+}
+
+Guidelines:
+- theme: The detected theme (REQUIRED, must be one of: ${validThemes})
+- themeConfidence: How confident you are (0.6-1.0 for valid results)
+- primaryBackgroundColor: The dominant background color in HEX format (REQUIRED)
+- visualFeatures: Visual elements that support your analysis (2-5 items)
+- reasoning: Brief explanation including the luminance assessment
+
+IMPORTANT: Dark backgrounds like #0A1628 (dark navy blue) should ALWAYS be classified as "dark", NOT "light" or "mixed".`;
+}
+/**
+ * カラーコンテキスト付きTheme分析プロンプト
+ */
+function getThemeAnalysisWithContextPrompt(colorContext) {
+    const validThemes = exports.VALID_THEMES.join(", ");
+    return `Analyze this web page screenshot and determine the visual theme.
+
+Consider the following color context:
+- Dominant colors: ${colorContext.dominantColors.join(", ")}
+- Pre-detected theme hint: ${colorContext.theme}
+- Content density: ${colorContext.contentDensity}
+
+**Theme Detection (CRITICAL - Follow these rules strictly):**
+
+1. Examine the BACKGROUND COLOR of the main content area
+2. Determine if the overall theme is DARK, LIGHT, or MIXED:
+
+   - DARK Theme: Background luminance < 30% (e.g., #0A1628, #1A1A2E, #000000)
+   - LIGHT Theme: Background luminance > 70% (e.g., #FFFFFF, #F5F5F5, #FAFAFA)
+   - MIXED Theme: 30% <= luminance <= 70% OR distinct dark AND light sections
+
+3. Use the color context to validate your analysis
+4. Extract the PRIMARY BACKGROUND COLOR in HEX format (#RRGGBB)
+
+Valid themes: ${validThemes}.
+
+Return JSON:
+{
+  "theme": "<theme>",
+  "themeConfidence": <0.0-1.0>,
+  "primaryBackgroundColor": "#RRGGBB",
+  "visualFeatures": ["<feature1>", "<feature2>"],
+  "reasoning": "<brief explanation>",
+  "colorContextUsed": true
+}
+
+Guidelines:
+- theme: The detected theme (REQUIRED, must be one of: ${validThemes})
+- themeConfidence: How confident you are (0.6-1.0 for valid results)
+- primaryBackgroundColor: The dominant background color in HEX format (REQUIRED)
+- visualFeatures: Visual elements that support your analysis (2-5 items)
+- reasoning: Brief explanation including the luminance assessment
+- colorContextUsed: Set to true as color context was provided
+
+IMPORTANT: Dark backgrounds like #0A1628 (dark navy blue) should ALWAYS be classified as "dark", NOT "light" or "mixed".`;
+}
+//# sourceMappingURL=vision.prompts.js.map

package/dist/services/vision/vision.prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision.prompts.js","sourceRoot":"","sources":["../../../src/services/vision/vision.prompts.ts"],"names":[],"mappings":";AAAA,6DAA6D;AAC7D,yCAAyC;;;AA0DzC,sDAoBC;AAKD,4EAyBC;AASD,gEAgCC;AAKD,sFAqCC;AAkBD,wDAuCC;AAKD,8EA2CC;AAtSD;;;;;;;;;;;;;;GAcG;AAEH,yDAAiD;AACjD,mEAOiC;AAEjC,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF;;GAEG;AACU,QAAA,YAAY,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AAgBhE,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;GAEG;AACH,SAAgB,qBAAqB;IACnC,OAAO;;eAEM,8BAAW,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;iDAgBY,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,SAAgB,gCAAgC,CAAC,YAAmC;IAClF,OAAO;;qBAEY,YAAY,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;WAChD,YAAY,CAAC,KAAK;qBACR,YAAY,CAAC,cAAc;;eAEjC,8BAAW,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;8DAiByB,CAAC;AAC/D,CAAC;AAED,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;GAEG;AACH,SAAgB,0BAA0B;IACxC,OAAO;;qBAEY,yCAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;0BACvB,8CAAsB,CAAC,IAAI,CAAC,IAAI,CAAC;iBAC1C,qCAAa,CAAC,IAAI,CAAC,IAAI,CAAC;oBACrB,wCAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;iBAC9B,qCAAa,CAAC,IAAI,CAAC,IAAI,CAAC;oBACrB,wCAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;iDAuBE,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,SAAgB,qCAAqC,CAAC,YAAmC;IACvF,OAAO;;qBAEY,YAAY,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;WAChD,YAAY,CAAC,KAAK;qBACR,YAAY,CAAC,cAAc;;qBAE3B,yCAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;0BACvB,8CAAsB,CAAC,IAAI,CAAC,IAAI,CAAC;iBAC1C,qCAAa,CAAC,IAAI,CAAC,IAAI,CAAC;oBACrB,wCAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;iBAC9B,qCAAa,CAAC,IAAI,CAAC,IAAI,CAAC;oBACrB,wCAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;8DAwBe,CAAC;AAC/D,CAAC;AAED,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF;;;;;;;;;;;GAWG;AACH,SAAgB,sBAAsB;IACpC,MAAM,WAAW,GAAG,oBAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE5C,OAAO;;;;;;;;;;;;;;;;;gBAiBO,WAAW;;;;;;;;;;;;yDAY8B,WAAW;;;;;;yHAMqD,CAAC;AAC1H,CAAC;AAED;;GAEG;AACH,SAAgB,iCAAiC,CAAC,YAAmC;IACnF,MAAM,WAAW,GAAG,oBAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE5C,OAAO;;;qBAGY,YAAY,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;6BAC9B,YAAY,CAAC,KAAK;qBAC1B,YAAY,CAAC,cAAc;;;;;;;;;;;;;;gBAchC,WAAW;;;;;;;;;;;;;yDAa8B,WAAW;;;;;;;yHAOqD,CAAC;AAC1H,CAAC"}

package/dist/services/vision/vram-utils.d.ts

@@ -0,0 +1,22 @@
+/**
+ * GPU VRAM 情報
+ */
+export interface VramInfo {
+    /** VRAM 使用量（MB） */
+    usedMb: number;
+    /** VRAM 総量（MB） */
+    totalMb: number;
+    /** VRAM 空き容量（MB） */
+    freeMb: number;
+    /** GPU 使用率（%） */
+    gpuUtilizationPercent: number;
+}
+/**
+ * nvidia-smi で GPU VRAM 情報を取得
+ *
+ * SEC: execFile 使用（コマンドインジェクション防止）
+ *
+ * @returns VRAM 情報。GPU 非搭載 / nvidia-smi 未対応時は null
+ */
+export declare function queryVram(): Promise<VramInfo | null>;
+//# sourceMappingURL=vram-utils.d.ts.map

package/dist/services/vision/vram-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vram-utils.d.ts","sourceRoot":"","sources":["../../../src/services/vision/vram-utils.ts"],"names":[],"mappings":"AAsBA;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAoC1D"}

package/dist/services/vision/vram-utils.js

@@ -0,0 +1,57 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.queryVram = queryVram;
+/**
+ * VRAM ユーティリティ — nvidia-smi による GPU VRAM 情報取得
+ *
+ * GpuResourceManager と OllamaReadinessProbe の両方で使用される
+ * 共通の VRAM クエリロジック。
+ *
+ * SEC: execFile 使用（コマンドインジェクション防止）
+ *
+ * @module services/vision/vram-utils
+ */
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const execFileAsync = (0, util_1.promisify)(child_process_1.execFile);
+/** nvidia-smi コマンドタイムアウト (ms) */
+const NVIDIA_SMI_TIMEOUT_MS = 5000;
+/**
+ * nvidia-smi で GPU VRAM 情報を取得
+ *
+ * SEC: execFile 使用（コマンドインジェクション防止）
+ *
+ * @returns VRAM 情報。GPU 非搭載 / nvidia-smi 未対応時は null
+ */
+async function queryVram() {
+    try {
+        const { stdout } = await execFileAsync("nvidia-smi", [
+            "--query-gpu=memory.used,memory.total,memory.free,utilization.gpu",
+            "--format=csv,noheader,nounits",
+        ], {
+            timeout: NVIDIA_SMI_TIMEOUT_MS,
+        });
+        const line = stdout.trim().split("\n")[0];
+        if (!line) {
+            return null;
+        }
+        const parts = line.split(",").map((s) => s.trim());
+        if (parts.length < 4) {
+            return null;
+        }
+        const usedMb = parseInt(parts[0], 10);
+        const totalMb = parseInt(parts[1], 10);
+        const freeMb = parseInt(parts[2], 10);
+        const gpuUtilizationPercent = parseInt(parts[3], 10);
+        if (isNaN(usedMb) || isNaN(totalMb) || isNaN(freeMb) || isNaN(gpuUtilizationPercent)) {
+            return null;
+        }
+        return { usedMb, totalMb, freeMb, gpuUtilizationPercent };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=vram-utils.js.map

package/dist/services/vision/vram-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vram-utils.js","sourceRoot":"","sources":["../../../src/services/vision/vram-utils.ts"],"names":[],"mappings":";AAAA,6DAA6D;AAC7D,yCAAyC;;AA0CzC,8BAoCC;AA5ED;;;;;;;;;GASG;AAEH,iDAAyC;AACzC,+BAAiC;AAEjC,MAAM,aAAa,GAAG,IAAA,gBAAS,EAAC,wBAAQ,CAAC,CAAC;AAE1C,iCAAiC;AACjC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAgBnC;;;;;;GAMG;AACI,KAAK,UAAU,SAAS;IAC7B,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CACpC,YAAY,EACZ;YACE,kEAAkE;YAClE,+BAA+B;SAChC,EACD;YACE,OAAO,EAAE,qBAAqB;SAC/B,CACF,CAAC;QAEF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACnD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;QACvC,MAAM,qBAAqB,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;QAEtD,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,CAAC,EAAE,CAAC;YACrF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}