@reftrixmcp/mcp-server 0.1.7

package/dist/services/query-analyzer.d.ts

@@ -0,0 +1,107 @@
+/**
+ * クエリメトリクスの型定義
+ */
+export interface QueryMetrics {
+    queryPattern: string;
+    executionTimeMs: number;
+    timestamp: Date;
+    rowsExamined?: number;
+    indexUsed?: string;
+}
+/**
+ * クエリ統計情報の型定義
+ */
+export interface QueryStats {
+    pattern: string;
+    count: number;
+    avgTimeMs: number;
+    p50Ms: number;
+    p95Ms: number;
+    p99Ms: number;
+    minTimeMs: number;
+    maxTimeMs: number;
+}
+/**
+ * 時間帯別統計情報の型定義
+ */
+export interface HourlyStats {
+    hour: number;
+    queryCount: number;
+    avgResponseTime: number;
+}
+/**
+ * 最適化提案の型定義
+ */
+export interface OptimizationSuggestion {
+    type: "index" | "rewrite" | "caching";
+    pattern: string;
+    suggestion: string;
+    expectedImprovement: string;
+    priority: "low" | "medium" | "high";
+}
+/**
+ * クエリ分析サービスクラス
+ */
+export declare class QueryAnalyzer {
+    private metrics;
+    private slowQueryThreshold;
+    private maxMetricsHistory;
+    constructor(options?: {
+        slowQueryThresholdMs?: number;
+        maxMetricsHistory?: number;
+    });
+    /**
+     * クエリ実行を記録
+     * @param pattern クエリパターン
+     * @param executionTimeMs 実行時間（ミリ秒）
+     * @param metadata 追加メタデータ
+     */
+    recordQuery(pattern: string, executionTimeMs: number, metadata?: Partial<Pick<QueryMetrics, "rowsExamined" | "indexUsed">>): void;
+    /**
+     * スロークエリを取得
+     * @param thresholdMs オプションの閾値（デフォルト: 100ms）
+     * @returns スロークエリのリスト
+     */
+    getSlowQueries(thresholdMs?: number): QueryMetrics[];
+    /**
+     * クエリパターン別の統計を取得
+     * @returns クエリパターン別統計のリスト
+     */
+    getStatsByPattern(): QueryStats[];
+    /**
+     * 時間帯別統計を取得（UTC時間）
+     * @returns 時間帯別統計のリスト
+     */
+    getHourlyStats(): HourlyStats[];
+    /**
+     * パーセンタイル値を計算
+     * @param sortedTimes ソート済み実行時間配列
+     * @param percentile パーセンタイル（0-100）
+     * @returns パーセンタイル値
+     */
+    getPercentile(sortedTimes: number[], percentile: number): number;
+    /**
+     * 最適化提案を生成
+     * @returns 最適化提案のリスト
+     */
+    getOptimizationSuggestions(): OptimizationSuggestion[];
+    /**
+     * メトリクスをクリア
+     */
+    clear(): void;
+    /**
+     * メトリクス件数を取得
+     * @returns メトリクス件数
+     */
+    getMetricsCount(): number;
+    /**
+     * 全メトリクスを取得
+     * @returns 全メトリクス
+     */
+    getAllMetrics(): QueryMetrics[];
+}
+/**
+ * シングルトンインスタンス
+ */
+export declare const queryAnalyzer: QueryAnalyzer;
+//# sourceMappingURL=query-analyzer.d.ts.map

package/dist/services/query-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-analyzer.d.ts","sourceRoot":"","sources":["../../src/services/query-analyzer.ts"],"names":[],"mappings":"AAoBA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,IAAI,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACrC;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,iBAAiB,CAAS;gBAEtB,OAAO,CAAC,EAAE;QAAE,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAE;IAUnF;;;;;OAKG;IACH,WAAW,CACT,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,EACvB,QAAQ,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,GAAG,WAAW,CAAC,CAAC,GACnE,IAAI;IAwBP;;;;OAIG;IACH,cAAc,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE;IAYpD;;;OAGG;IACH,iBAAiB,IAAI,UAAU,EAAE;IAkCjC;;;OAGG;IACH,cAAc,IAAI,WAAW,EAAE;IAiC/B;;;;;OAKG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAQhE;;;OAGG;IACH,0BAA0B,IAAI,sBAAsB,EAAE;IAkDtD;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;;OAGG;IACH,eAAe,IAAI,MAAM;IAIzB;;;OAGG;IACH,aAAa,IAAI,YAAY,EAAE;CAGhC;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/services/query-analyzer.js

@@ -0,0 +1,222 @@
+"use strict";
+// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
+// SPDX-License-Identifier: AGPL-3.0-only
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.queryAnalyzer = exports.QueryAnalyzer = void 0;
+/**
+ * Query Analyzer Service
+ * クエリ分析・パフォーマンス監視サービス
+ *
+ * 目的:
+ * - クエリ実行時間の計測
+ * - スロークエリの検出（100ms超）
+ * - 統計収集（P50/P95/P99レイテンシ計算）
+ * - クエリパターン別統計
+ * - 時間帯別負荷分析
+ * - 最適化提案
+ */
+const logger_1 = require("../utils/logger");
+const logger = new logger_1.Logger("QueryAnalyzer");
+/**
+ * クエリ分析サービスクラス
+ */
+class QueryAnalyzer {
+    metrics = [];
+    slowQueryThreshold;
+    maxMetricsHistory;
+    constructor(options) {
+        this.slowQueryThreshold = options?.slowQueryThresholdMs ?? 100;
+        this.maxMetricsHistory = options?.maxMetricsHistory ?? 10000;
+        logger.debug("Initialized", {
+            slowQueryThreshold: this.slowQueryThreshold,
+            maxMetricsHistory: this.maxMetricsHistory,
+        });
+    }
+    /**
+     * クエリ実行を記録
+     * @param pattern クエリパターン
+     * @param executionTimeMs 実行時間（ミリ秒）
+     * @param metadata 追加メタデータ
+     */
+    recordQuery(pattern, executionTimeMs, metadata) {
+        const metric = {
+            queryPattern: pattern,
+            executionTimeMs,
+            timestamp: new Date(),
+            ...metadata,
+        };
+        this.metrics.push(metric);
+        // 履歴サイズを制限
+        if (this.metrics.length > this.maxMetricsHistory) {
+            this.metrics.shift();
+        }
+        const isSlow = executionTimeMs > this.slowQueryThreshold;
+        logger.debug("Query recorded", {
+            pattern,
+            executionTimeMs,
+            isSlow,
+            ...metadata,
+        });
+    }
+    /**
+     * スロークエリを取得
+     * @param thresholdMs オプションの閾値（デフォルト: 100ms）
+     * @returns スロークエリのリスト
+     */
+    getSlowQueries(thresholdMs) {
+        const threshold = thresholdMs ?? this.slowQueryThreshold;
+        const slowQueries = this.metrics.filter((m) => m.executionTimeMs > threshold);
+        logger.debug("Slow queries", {
+            threshold,
+            count: slowQueries.length,
+        });
+        return slowQueries;
+    }
+    /**
+     * クエリパターン別の統計を取得
+     * @returns クエリパターン別統計のリスト
+     */
+    getStatsByPattern() {
+        const patternMap = new Map();
+        for (const metric of this.metrics) {
+            const existing = patternMap.get(metric.queryPattern) ?? [];
+            existing.push(metric.executionTimeMs);
+            patternMap.set(metric.queryPattern, existing);
+        }
+        const stats = [];
+        for (const [pattern, times] of patternMap) {
+            const sorted = [...times].sort((a, b) => a - b);
+            const sum = times.reduce((acc, val) => acc + val, 0);
+            stats.push({
+                pattern,
+                count: times.length,
+                avgTimeMs: sum / times.length,
+                p50Ms: this.getPercentile(sorted, 50),
+                p95Ms: this.getPercentile(sorted, 95),
+                p99Ms: this.getPercentile(sorted, 99),
+                minTimeMs: sorted[0] ?? 0,
+                maxTimeMs: sorted[sorted.length - 1] ?? 0,
+            });
+        }
+        logger.debug("Stats by pattern", {
+            patternCount: stats.length,
+        });
+        return stats;
+    }
+    /**
+     * 時間帯別統計を取得（UTC時間）
+     * @returns 時間帯別統計のリスト
+     */
+    getHourlyStats() {
+        const hourlyMap = new Map();
+        for (const metric of this.metrics) {
+            // UTC時間を使用してタイムゾーン非依存にする
+            const hour = metric.timestamp.getUTCHours();
+            const existing = hourlyMap.get(hour) ?? [];
+            existing.push(metric.executionTimeMs);
+            hourlyMap.set(hour, existing);
+        }
+        const stats = [];
+        for (const [hour, times] of hourlyMap) {
+            const sum = times.reduce((acc, val) => acc + val, 0);
+            stats.push({
+                hour,
+                queryCount: times.length,
+                avgResponseTime: sum / times.length,
+            });
+        }
+        // 時間順にソート
+        stats.sort((a, b) => a.hour - b.hour);
+        logger.debug("Hourly stats", {
+            hourCount: stats.length,
+        });
+        return stats;
+    }
+    /**
+     * パーセンタイル値を計算
+     * @param sortedTimes ソート済み実行時間配列
+     * @param percentile パーセンタイル（0-100）
+     * @returns パーセンタイル値
+     */
+    getPercentile(sortedTimes, percentile) {
+        if (sortedTimes.length === 0)
+            return 0;
+        const index = Math.floor((sortedTimes.length * percentile) / 100);
+        const clampedIndex = Math.min(index, sortedTimes.length - 1);
+        return sortedTimes[clampedIndex] ?? 0;
+    }
+    /**
+     * 最適化提案を生成
+     * @returns 最適化提案のリスト
+     */
+    getOptimizationSuggestions() {
+        const suggestions = [];
+        const stats = this.getStatsByPattern();
+        for (const stat of stats) {
+            // P95が100msを超えるパターンにはインデックス提案
+            if (stat.p95Ms > 100) {
+                suggestions.push({
+                    type: "index",
+                    pattern: stat.pattern,
+                    suggestion: `Consider adding an index for pattern: ${stat.pattern}. P95 is ${stat.p95Ms.toFixed(2)}ms.`,
+                    expectedImprovement: "Reduce P95 latency by 50-70%",
+                    priority: stat.p95Ms > 200 ? "high" : "medium",
+                });
+            }
+            // P99が500msを超えるパターンにはクエリ書き換え提案
+            if (stat.p99Ms > 500) {
+                suggestions.push({
+                    type: "rewrite",
+                    pattern: stat.pattern,
+                    suggestion: `Consider rewriting query for pattern: ${stat.pattern}. P99 is ${stat.p99Ms.toFixed(2)}ms.`,
+                    expectedImprovement: "Reduce P99 latency by 30-50%",
+                    priority: "high",
+                });
+            }
+            // 頻繁に呼ばれるパターンにはキャッシング提案
+            if (stat.count > 100 && stat.avgTimeMs > 50) {
+                suggestions.push({
+                    type: "caching",
+                    pattern: stat.pattern,
+                    suggestion: `Consider caching results for pattern: ${stat.pattern}. Called ${stat.count} times with avg ${stat.avgTimeMs.toFixed(2)}ms.`,
+                    expectedImprovement: "Reduce load by 80-90%",
+                    priority: stat.count > 500 ? "high" : "medium",
+                });
+            }
+        }
+        // 優先度順にソート
+        const priorityOrder = { high: 0, medium: 1, low: 2 };
+        suggestions.sort((a, b) => priorityOrder[a.priority] - priorityOrder[b.priority]);
+        logger.debug("Optimization suggestions", {
+            count: suggestions.length,
+        });
+        return suggestions;
+    }
+    /**
+     * メトリクスをクリア
+     */
+    clear() {
+        this.metrics = [];
+        logger.debug("Metrics cleared");
+    }
+    /**
+     * メトリクス件数を取得
+     * @returns メトリクス件数
+     */
+    getMetricsCount() {
+        return this.metrics.length;
+    }
+    /**
+     * 全メトリクスを取得
+     * @returns 全メトリクス
+     */
+    getAllMetrics() {
+        return [...this.metrics];
+    }
+}
+exports.QueryAnalyzer = QueryAnalyzer;
+/**
+ * シングルトンインスタンス
+ */
+exports.queryAnalyzer = new QueryAnalyzer();
+//# sourceMappingURL=query-analyzer.js.map

package/dist/services/query-analyzer.js.map

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

package/dist/services/query-context-analyzer.d.ts

@@ -0,0 +1,85 @@
+/**
+ * 推論された業界タイプ
+ */
+export type InferredIndustry = "technology" | "ecommerce" | "healthcare" | "finance" | "education" | "media" | "travel" | "food" | "real_estate" | "automotive" | null;
+/**
+ * 推論されたスタイルタイプ
+ */
+export type InferredStyle = "minimal" | "bold" | "corporate" | "playful" | "elegant" | "modern" | "vintage" | "tech" | null;
+/**
+ * 推論結果
+ */
+export interface InferredContext {
+    /** 推論された業界 */
+    industry: InferredIndustry;
+    /** 推論されたスタイル */
+    style: InferredStyle;
+    /** 推論の信頼度（0-1） */
+    confidence: number;
+    /** 検出されたキーワード */
+    detectedKeywords: string[];
+}
+/**
+ * クエリからコンテキストを自動推論するサービス
+ */
+export declare class QueryContextAnalyzer {
+    /**
+     * クエリからコンテキストを推論
+     *
+     * @param query - 検索クエリ
+     * @returns 推論結果
+     */
+    inferContext(query: string): InferredContext;
+    /**
+     * クエリを正規化
+     */
+    private normalizeQuery;
+    /**
+     * 業界を推論
+     */
+    private inferIndustry;
+    /**
+     * スタイルを推論
+     */
+    private inferStyle;
+    /**
+     * 信頼度を計算
+     *
+     * 信頼度スコアのガイドライン:
+     * - 業界のみ推論: 0.5-0.7
+     * - スタイルのみ推論: 0.5-0.7
+     * - 両方推論: 0.7-0.95
+     * - 何も推論できない: 0.0
+     */
+    private calculateConfidence;
+}
+/**
+ * コンテキストブースト計算用インターフェース
+ */
+export interface ContextBoostInput {
+    /** 推論されたコンテキスト */
+    context: InferredContext;
+    /** 結果アイテムのメタデータ */
+    resultMetadata: {
+        heading?: string | undefined;
+        description?: string | undefined;
+        url?: string | undefined;
+        sectionType?: string | undefined;
+    };
+}
+/**
+ * コンテキストに基づいてブーストスコアを計算
+ *
+ * @param input - ブースト計算入力
+ * @returns ブーストスコア（0-0.15）
+ */
+export declare function calculateContextBoost(input: ContextBoostInput): number;
+/**
+ * QueryContextAnalyzer インスタンスを取得
+ */
+export declare function getQueryContextAnalyzer(): QueryContextAnalyzer;
+/**
+ * QueryContextAnalyzer インスタンスをリセット（テスト用）
+ */
+export declare function resetQueryContextAnalyzer(): void;
+//# sourceMappingURL=query-context-analyzer.d.ts.map

package/dist/services/query-context-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-context-analyzer.d.ts","sourceRoot":"","sources":["../../src/services/query-context-analyzer.ts"],"names":[],"mappings":"AAsBA;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,SAAS,GACT,WAAW,GACX,OAAO,GACP,QAAQ,GACR,MAAM,GACN,aAAa,GACb,YAAY,GACZ,IAAI,CAAC;AAET;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,MAAM,GACN,WAAW,GACX,SAAS,GACT,SAAS,GACT,QAAQ,GACR,SAAS,GACT,MAAM,GACN,IAAI,CAAC;AAET;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,cAAc;IACd,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,gBAAgB;IAChB,KAAK,EAAE,aAAa,CAAC;IACrB,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB;IACjB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AA2gBD;;GAEG;AACH,qBAAa,oBAAoB;IAC/B;;;;;OAKG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe;IAiC5C;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAgCrB;;OAEG;IACH,OAAO,CAAC,UAAU;IAgClB;;;;;;;;OAQG;IACH,OAAO,CAAC,mBAAmB;CA4B5B;AAMD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kBAAkB;IAClB,OAAO,EAAE,eAAe,CAAC;IACzB,mBAAmB;IACnB,cAAc,EAAE;QACd,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC7B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACjC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACzB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAClC,CAAC;CACH;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CA4CtE;AAQD;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,oBAAoB,CAK9D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}