@reftrixmcp/mcp-server 0.1.7

package/dist/services/preference-rerank.helper.d.ts

@@ -0,0 +1,128 @@
+import type { IPrismaClient } from "./preference-profile.service";
+/**
+ * デフォルトのリランキング重み（嗜好スコアの寄与率）
+ * Default reranking weight (contribution of preference score)
+ */
+export declare const DEFAULT_RERANK_ALPHA = 0.3;
+/**
+ * リランキング適用に必要な最低インタラクション数
+ * Minimum number of interactions required to apply reranking
+ */
+export declare const MIN_INTERACTIONS_FOR_RERANK = 5;
+/**
+ * リランキング対象のドメイン
+ * Reranking target domain
+ */
+export type EmbeddingDomain = "layout" | "motion" | "background" | "narrative" | "responsive";
+/**
+ * リランキングオプション
+ * Reranking options
+ */
+export interface RerankOptions {
+    /** 嗜好重み（0-1、デフォルト0.3） / Preference weight (0-1, default 0.3) */
+    alpha?: number;
+    /** 最低confidence閾値（デフォルト0.8） / Minimum confidence threshold (default 0.8) */
+    minConfidence?: number;
+    /** embeddingドメイン（DB取得用） / Embedding domain (for DB fetch) */
+    domain?: EmbeddingDomain;
+}
+/**
+ * リランキング可能なアイテム
+ * Rerankable item
+ */
+export interface RerankableItem {
+    /** アイテムID / Item ID */
+    id: string;
+    /** 既存の検索スコア（0-1） / Existing search score (0-1) */
+    similarity: number;
+    /** 結果のembeddingベクトル（768D） / Result embedding vector (768D) */
+    embedding?: number[];
+    /** その他のフィールドを透過 / Pass through other fields */
+    [key: string]: unknown;
+}
+/**
+ * リランキング結果
+ * Reranking result
+ */
+export interface RerankResult<T extends RerankableItem> {
+    /** リランキング後のアイテム配列 / Items after reranking */
+    items: T[];
+    /** リランキングが適用されたか / Whether reranking was applied */
+    reranked: boolean;
+    /** 適用されなかった場合の理由 / Reason if not applied */
+    reason?: string;
+}
+/**
+ * コサイン類似度を計算
+ * Calculate cosine similarity
+ *
+ * 2つのベクトル間のコサイン類似度を計算する純粋関数。
+ * ベクトルの長さが異なる場合やゼロベクトルの場合は0を返す。
+ *
+ * A pure function that calculates cosine similarity between two vectors.
+ * Returns 0 if vectors have different lengths or are zero vectors.
+ *
+ * @param a - ベクトルA / Vector A
+ * @param b - ベクトルB / Vector B
+ * @returns コサイン類似度（-1 ~ 1） / Cosine similarity (-1 to 1)
+ */
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+/**
+ * 嗜好プロファイルのembeddingとインタラクション数を取得
+ * Get preference profile embedding and interaction count
+ *
+ * preference_profiles テーブルから preference_embedding と interaction_count を取得する。
+ * embedding は PostgreSQL の vector 型から number[] に変換される。
+ *
+ * Fetches preference_embedding and interaction_count from the preference_profiles table.
+ * The embedding is converted from PostgreSQL vector type to number[].
+ *
+ * @param profileId - プロファイルID（UUID） / Profile ID (UUID)
+ * @param prisma - PrismaClientインスタンス / PrismaClient instance
+ * @returns embedding（null可）とインタラクション数 / embedding (nullable) and interaction count
+ */
+export declare function getPreferenceEmbedding(profileId: string, prisma: IPrismaClient): Promise<{
+    embedding: number[] | null;
+    interactionCount: number;
+}>;
+/**
+ * 嗜好プロファイルに基づいて検索結果をリランキング
+ * Rerank search results based on preference profile
+ *
+ * final_score = (1 - alpha) * item.similarity + alpha * prefSimilarity
+ *
+ * 以下の場合はリランキングを適用せず、元の結果をそのまま返す:
+ * - プロファイルが見つからない
+ * - preference_embedding が NULL
+ * - interaction_count が MIN_INTERACTIONS_FOR_RERANK 未満
+ * - アイテムにembeddingが含まれていない
+ *
+ * Returns original results without reranking in the following cases:
+ * - Profile not found
+ * - preference_embedding is NULL
+ * - interaction_count is below MIN_INTERACTIONS_FOR_RERANK
+ * - Items do not contain embeddings
+ *
+ * @param results - 検索結果配列 / Search result array
+ * @param profileId - プロファイルID（UUID） / Profile ID (UUID)
+ * @param prisma - PrismaClientインスタンス / PrismaClient instance
+ * @param options - リランキングオプション / Reranking options
+ * @returns リランキング結果 / Reranking result
+ */
+export declare function rerankWithPreference<T extends RerankableItem>(results: T[], profileId: string, prisma: IPrismaClient, options?: RerankOptions): Promise<RerankResult<T>>;
+/**
+ * 検索結果にpreference rerankingを適用する統合ヘルパー
+ * Integrated helper to apply preference reranking to search results
+ *
+ * @param results - 検索結果配列 / Search result array
+ * @param profileId - プロファイルID（undefinedの場合はスキップ） / Profile ID (skip if undefined)
+ * @param prismaFactory - PrismaClientファクトリ / PrismaClient factory
+ * @param domain - embeddingドメイン / Embedding domain
+ * @param toolName - ログ用ツール名 / Tool name for logging
+ * @returns リランキング済み結果（または元の結果） / Reranked results (or original)
+ */
+export declare function applyPreferenceReranking<T extends {
+    id: string;
+    similarity: number;
+}>(results: T[], profileId: string | undefined, prismaFactory: (() => IPrismaClient) | null, domain: EmbeddingDomain, toolName: string): Promise<T[]>;
+//# sourceMappingURL=preference-rerank.helper.d.ts.map

package/dist/services/preference-rerank.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preference-rerank.helper.d.ts","sourceRoot":"","sources":["../../src/services/preference-rerank.helper.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAMlE;;;GAGG;AACH,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAM7C;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,CAAC;AAmD9F;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,+CAA+C;IAC/C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,cAAc;IACpD,6CAA6C;IAC7C,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,oDAAoD;IACpD,QAAQ,EAAE,OAAO,CAAC;IAClB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA4BD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAwBjE;AAsCD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAAC,CAgCnE;AAqDD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,SAAS,cAAc,EACjE,OAAO,EAAE,CAAC,EAAE,EACZ,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAmH1B;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,wBAAwB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EACzF,OAAO,EAAE,CAAC,EAAE,EACZ,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,aAAa,EAAE,CAAC,MAAM,aAAa,CAAC,GAAG,IAAI,EAC3C,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,CAAC,EAAE,CAAC,CAkCd"}

package/dist/services/preference-rerank.helper.js

@@ -0,0 +1,397 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MIN_INTERACTIONS_FOR_RERANK = exports.DEFAULT_RERANK_ALPHA = void 0;
+exports.cosineSimilarity = cosineSimilarity;
+exports.getPreferenceEmbedding = getPreferenceEmbedding;
+exports.rerankWithPreference = rerankWithPreference;
+exports.applyPreferenceReranking = applyPreferenceReranking;
+/**
+ * preference-rerank.helper.ts
+ * 嗜好プロファイルに基づく検索結果リランキングヘルパー
+ *
+ * 機能:
+ * - 検索結果をユーザーの嗜好プロファイル（preference_embedding）で再ランキング
+ * - cosine similarity によるスコア調整
+ * - confidence不足時のグレースフルフォールバック（元の順序を維持）
+ *
+ * preference-rerank.helper.ts
+ * Search result reranking helper based on user preference profiles
+ *
+ * Features:
+ * - Rerank search results using user preference profile (preference_embedding)
+ * - Score adjustment via cosine similarity
+ * - Graceful fallback when confidence is insufficient (preserve original order)
+ *
+ * @module services/preference-rerank.helper
+ */
+const logger_1 = require("../utils/logger");
+const schemas_1 = require("../tools/preference/schemas");
+// =====================================================
+// 定数 / Constants
+// =====================================================
+/**
+ * デフォルトのリランキング重み（嗜好スコアの寄与率）
+ * Default reranking weight (contribution of preference score)
+ */
+exports.DEFAULT_RERANK_ALPHA = 0.3;
+/**
+ * リランキング適用に必要な最低インタラクション数
+ * Minimum number of interactions required to apply reranking
+ */
+exports.MIN_INTERACTIONS_FOR_RERANK = 5;
+/**
+ * ドメインごとのembeddingテーブル設定
+ * Embedding table config per domain
+ *
+ * テーブル名・カラム名はすべてハードコード定数であり、
+ * ユーザー入力由来ではないためSQLインジェクションリスクなし。
+ *
+ * Table/column names are all hardcoded constants (not from user input),
+ * so there is no SQL injection risk.
+ */
+const DOMAIN_EMBEDDING_CONFIG = {
+    layout: {
+        table: "section_embeddings",
+        fkColumn: "section_pattern_id",
+        embeddingExpr: "COALESCE(combined_embedding, text_embedding)",
+    },
+    motion: {
+        table: "motion_embeddings",
+        fkColumn: "motion_pattern_id",
+        embeddingExpr: "embedding",
+    },
+    background: {
+        table: "background_design_embeddings",
+        fkColumn: "background_design_id",
+        embeddingExpr: "embedding",
+    },
+    narrative: {
+        table: "design_narrative_embeddings",
+        fkColumn: "design_narrative_id",
+        embeddingExpr: "embedding",
+    },
+    responsive: {
+        table: "responsive_analysis_embeddings",
+        // responsive searchは rae.id（embedding行PK）をitem.idとして返すため、
+        // FKではなくPKで検索する
+        // responsive search returns rae.id (embedding row PK) as item.id,
+        // so search by PK instead of FK
+        fkColumn: "id",
+        embeddingExpr: "embedding",
+    },
+};
+// =====================================================
+// 純粋関数 / Pure Functions
+// =====================================================
+/**
+ * コサイン類似度を計算
+ * Calculate cosine similarity
+ *
+ * 2つのベクトル間のコサイン類似度を計算する純粋関数。
+ * ベクトルの長さが異なる場合やゼロベクトルの場合は0を返す。
+ *
+ * A pure function that calculates cosine similarity between two vectors.
+ * Returns 0 if vectors have different lengths or are zero vectors.
+ *
+ * @param a - ベクトルA / Vector A
+ * @param b - ベクトルB / Vector B
+ * @returns コサイン類似度（-1 ~ 1） / Cosine similarity (-1 to 1)
+ */
+function cosineSimilarity(a, b) {
+    if (a.length !== b.length || a.length === 0) {
+        return 0;
+    }
+    let dotProduct = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        const aVal = a[i];
+        const bVal = b[i];
+        dotProduct += aVal * bVal;
+        normA += aVal * aVal;
+        normB += bVal * bVal;
+    }
+    const denominator = Math.sqrt(normA) * Math.sqrt(normB);
+    if (denominator === 0) {
+        return 0;
+    }
+    return dotProduct / denominator;
+}
+/**
+ * pgvector文字列をnumber[]にパース
+ * Parse pgvector string to number[]
+ *
+ * PostgreSQLのvector型を `::text` で取得した場合の文字列形式 "[0.1,0.2,...]" をパースする。
+ * Parses the string format "[0.1,0.2,...]" returned when fetching PostgreSQL vector type via `::text`.
+ *
+ * @param vectorStr - pgvector文字列 / pgvector string
+ * @returns パースされたnumber配列 / Parsed number array
+ */
+function parseVectorString(vectorStr) {
+    const values = vectorStr
+        .slice(1, -1) // "[" と "]" を除去 / Remove "[" and "]"
+        .split(",")
+        .map(Number);
+    // NaN/Infinity防御 / NaN/Infinity defense
+    for (const val of values) {
+        if (!Number.isFinite(val)) {
+            logger_1.logger.warn("[PreferenceRerank] Non-finite value detected in vector string, returning empty", {
+                vectorStrLength: vectorStr.length,
+            });
+            return [];
+        }
+    }
+    return values;
+}
+// =====================================================
+// データアクセス / Data Access
+// =====================================================
+/**
+ * 嗜好プロファイルのembeddingとインタラクション数を取得
+ * Get preference profile embedding and interaction count
+ *
+ * preference_profiles テーブルから preference_embedding と interaction_count を取得する。
+ * embedding は PostgreSQL の vector 型から number[] に変換される。
+ *
+ * Fetches preference_embedding and interaction_count from the preference_profiles table.
+ * The embedding is converted from PostgreSQL vector type to number[].
+ *
+ * @param profileId - プロファイルID（UUID） / Profile ID (UUID)
+ * @param prisma - PrismaClientインスタンス / PrismaClient instance
+ * @returns embedding（null可）とインタラクション数 / embedding (nullable) and interaction count
+ */
+async function getPreferenceEmbedding(profileId, prisma) {
+    try {
+        const rows = await prisma.$queryRawUnsafe(`SELECT preference_embedding::text AS preference_embedding, interaction_count
+       FROM preference_profiles
+       WHERE id = $1::uuid`, profileId);
+        const row = rows[0];
+        if (!row) {
+            return { embedding: null, interactionCount: 0 };
+        }
+        const interactionCount = Number(row.interaction_count);
+        if (!row.preference_embedding) {
+            return { embedding: null, interactionCount };
+        }
+        const embedding = parseVectorString(row.preference_embedding);
+        return { embedding, interactionCount };
+    }
+    catch (error) {
+        // 全環境でログ出力（isDevelopmentガードなし）
+        // Log in all environments (no isDevelopment guard)
+        logger_1.logger.warn("[PreferenceRerank] Failed to get preference embedding", {
+            profileId: (0, schemas_1.truncateId)(profileId),
+            error: error instanceof Error ? error.message : "Unknown error",
+        });
+        return { embedding: null, interactionCount: 0 };
+    }
+}
+/**
+ * ドメインのembeddingテーブルからアイテムのembeddingを一括取得
+ * Batch-fetch item embeddings from domain embedding table
+ *
+ * @param itemIds - アイテムID配列 / Item ID array
+ * @param domain - embeddingドメイン / Embedding domain
+ * @param prisma - PrismaClientインスタンス / PrismaClient instance
+ * @returns アイテムID → embedding のMap / Map of item ID to embedding
+ */
+async function fetchItemEmbeddings(itemIds, domain, prisma) {
+    const config = DOMAIN_EMBEDDING_CONFIG[domain];
+    const map = new Map();
+    if (itemIds.length === 0) {
+        return map;
+    }
+    try {
+        // テーブル名・カラム名はハードコード定数のためSQLインジェクションリスクなし
+        // Table/column names are hardcoded constants, no SQL injection risk
+        const query = `SELECT ${config.fkColumn}::text AS item_id, (${config.embeddingExpr})::text AS embedding
+       FROM ${config.table}
+       WHERE ${config.fkColumn} = ANY($1::uuid[])
+       AND ${config.embeddingExpr} IS NOT NULL`;
+        const rows = await prisma.$queryRawUnsafe(query, itemIds);
+        for (const row of rows) {
+            if (row.embedding) {
+                map.set(row.item_id, parseVectorString(row.embedding));
+            }
+        }
+    }
+    catch (error) {
+        logger_1.logger.warn("[PreferenceRerank] Failed to fetch item embeddings", {
+            domain,
+            itemCount: itemIds.length,
+            error: error instanceof Error ? error.message : "Unknown error",
+        });
+    }
+    return map;
+}
+// =====================================================
+// リランキング / Reranking
+// =====================================================
+/**
+ * 嗜好プロファイルに基づいて検索結果をリランキング
+ * Rerank search results based on preference profile
+ *
+ * final_score = (1 - alpha) * item.similarity + alpha * prefSimilarity
+ *
+ * 以下の場合はリランキングを適用せず、元の結果をそのまま返す:
+ * - プロファイルが見つからない
+ * - preference_embedding が NULL
+ * - interaction_count が MIN_INTERACTIONS_FOR_RERANK 未満
+ * - アイテムにembeddingが含まれていない
+ *
+ * Returns original results without reranking in the following cases:
+ * - Profile not found
+ * - preference_embedding is NULL
+ * - interaction_count is below MIN_INTERACTIONS_FOR_RERANK
+ * - Items do not contain embeddings
+ *
+ * @param results - 検索結果配列 / Search result array
+ * @param profileId - プロファイルID（UUID） / Profile ID (UUID)
+ * @param prisma - PrismaClientインスタンス / PrismaClient instance
+ * @param options - リランキングオプション / Reranking options
+ * @returns リランキング結果 / Reranking result
+ */
+async function rerankWithPreference(results, profileId, prisma, options) {
+    const alpha = options?.alpha ?? exports.DEFAULT_RERANK_ALPHA;
+    // 空の結果の場合は早期リターン
+    // Early return for empty results
+    if (results.length === 0) {
+        return { items: results, reranked: false, reason: "検索結果が空です / No search results" };
+    }
+    // 嗜好プロファイルのembeddingを取得
+    // Get preference profile embedding
+    const { embedding: preferenceEmbedding, interactionCount } = await getPreferenceEmbedding(profileId, prisma);
+    // preference_embedding が NULL の場合
+    // When preference_embedding is NULL
+    if (!preferenceEmbedding) {
+        return {
+            items: results,
+            reranked: false,
+            reason: "嗜好embeddingが未生成です（フィードバックが記録されていません） / Preference embedding not yet generated (no feedback recorded)",
+        };
+    }
+    // interaction_count が閾値未満の場合
+    // When interaction_count is below threshold
+    if (interactionCount < exports.MIN_INTERACTIONS_FOR_RERANK) {
+        return {
+            items: results,
+            reranked: false,
+            reason: `インタラクション数が不足しています（${interactionCount}/${exports.MIN_INTERACTIONS_FOR_RERANK}） / Insufficient interactions (${interactionCount}/${exports.MIN_INTERACTIONS_FOR_RERANK})`,
+        };
+    }
+    // アイテムのembeddingを準備（インラインまたはDB取得）
+    // Prepare item embeddings (inline or DB fetch)
+    let itemEmbeddingMap = null;
+    const itemsWithEmbedding = results.filter((item) => item.embedding && Array.isArray(item.embedding) && item.embedding.length > 0);
+    if (itemsWithEmbedding.length === 0 && options?.domain) {
+        // アイテムにembeddingがない場合、ドメインのDBテーブルから一括取得
+        // When items lack embeddings, batch-fetch from domain embedding table
+        const itemIds = results.map((item) => item.id);
+        itemEmbeddingMap = await fetchItemEmbeddings(itemIds, options.domain, prisma);
+        if (itemEmbeddingMap.size === 0) {
+            return {
+                items: results,
+                reranked: false,
+                reason: "DB上にembeddingが見つかりません / No embeddings found in DB",
+            };
+        }
+    }
+    else if (itemsWithEmbedding.length === 0) {
+        return {
+            items: results,
+            reranked: false,
+            reason: "検索結果にembeddingが含まれていません / Search results do not contain embeddings",
+        };
+    }
+    // リランキングスコアを計算
+    // Calculate reranking scores
+    const scored = results.map((item) => {
+        // インラインembeddingまたはDB取得embeddingを使用
+        // Use inline embedding or DB-fetched embedding
+        const itemEmbedding = item.embedding && Array.isArray(item.embedding) && item.embedding.length > 0
+            ? item.embedding
+            : (itemEmbeddingMap?.get(item.id) ?? null);
+        if (!itemEmbedding) {
+            // embedding がないアイテムは元のスコアを維持
+            // Items without embedding keep their original score
+            return { item, finalScore: item.similarity };
+        }
+        const prefSimilarity = cosineSimilarity(itemEmbedding, preferenceEmbedding);
+        const finalScore = (1 - alpha) * item.similarity + alpha * prefSimilarity;
+        return { item, finalScore };
+    });
+    // final_score降順でソート
+    // Sort by final_score descending
+    scored.sort((a, b) => b.finalScore - a.finalScore);
+    // 元のアイテムのフィールドをすべて透過（similarity を更新）
+    // Pass through all original item fields (update similarity)
+    const rerankedItems = scored.map(({ item, finalScore }) => ({
+        ...item,
+        similarity: finalScore,
+    }));
+    // 全環境でログ出力（isDevelopmentガードなし）
+    // Log in all environments (no isDevelopment guard)
+    logger_1.logger.info("[PreferenceRerank] Reranking applied", {
+        profileId: (0, schemas_1.truncateId)(profileId),
+        alpha,
+        interactionCount,
+        totalItems: results.length,
+        itemsWithEmbedding: itemsWithEmbedding.length,
+        itemsFromDb: itemEmbeddingMap?.size ?? 0,
+        domain: options?.domain ?? "none",
+    });
+    return {
+        items: rerankedItems,
+        reranked: true,
+    };
+}
+// =====================================================
+// 統合ヘルパー / Integrated Helper
+// =====================================================
+/**
+ * 検索結果にpreference rerankingを適用する統合ヘルパー
+ * Integrated helper to apply preference reranking to search results
+ *
+ * @param results - 検索結果配列 / Search result array
+ * @param profileId - プロファイルID（undefinedの場合はスキップ） / Profile ID (skip if undefined)
+ * @param prismaFactory - PrismaClientファクトリ / PrismaClient factory
+ * @param domain - embeddingドメイン / Embedding domain
+ * @param toolName - ログ用ツール名 / Tool name for logging
+ * @returns リランキング済み結果（または元の結果） / Reranked results (or original)
+ */
+async function applyPreferenceReranking(results, profileId, prismaFactory, domain, toolName) {
+    if (!profileId || results.length === 0 || !prismaFactory) {
+        return results;
+    }
+    try {
+        const prisma = prismaFactory();
+        const rerankableItems = results.map((item) => ({
+            ...item,
+            id: item.id,
+            similarity: item.similarity,
+        }));
+        const rerankResult = await rerankWithPreference(rerankableItems, profileId, prisma, { domain });
+        if (rerankResult.reranked) {
+            logger_1.logger.info(`[MCP Tool] ${toolName} preference reranking applied`, {
+                profileId: (0, schemas_1.truncateId)(profileId),
+                resultCount: results.length,
+            });
+            return rerankResult.items;
+        }
+        logger_1.logger.info(`[MCP Tool] ${toolName} preference reranking skipped`, {
+            profileId: (0, schemas_1.truncateId)(profileId),
+            reason: rerankResult.reason,
+        });
+        return results;
+    }
+    catch (error) {
+        logger_1.logger.warn(`[MCP Tool] ${toolName} preference reranking failed`, {
+            profileId: (0, schemas_1.truncateId)(profileId),
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return results;
+    }
+}
+//# sourceMappingURL=preference-rerank.helper.js.map

package/dist/services/preference-rerank.helper.js.map

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